feat: Fix 1Password fill classification for repeat fills and unconfirmed submits

Stainless-Generated-From: 399a7000e4351b576352ac5a8772b7dc28a15682

Author: kernel-internal[bot]

src/kernel/types/vaults/credential_vault_item_request_param.py

@@ -15,7 +15,8 @@ class CredentialVaultItemRequestParam(TypedDict, total=False):
     If they choose 1Password, connect their account and request access to a login
     in their own non-shared vault; passkeys are not supported. If they decline
     or that path fails, collect a Kernel-hosted credential item instead. Never
-    automatically retry an uncertain 1Password request or fill.
+    automatically retry an uncertain 1Password request. After an uncertain fill,
+    inspect the page to see the result of the fill.
     Do not use credential items for credit card data. Use wallet and card item types instead.
     Kernel credentials declare fields and may enter pending_collection.
     1Password credentials either reference a connected credential_account or

src/kernel/types/vaults/one_password_fill_vault_item_operation_result.py

@@ -18,19 +18,20 @@ class OnePasswordFillVaultItemOperationResult(BaseModel):
     """Kernel's outcome of the extension call.
 
     fill_submitted means the extension reported submission, not website
-    authentication. fill_failed means the extension returned a known failure and may
-    include error_code. fill_unknown means submission may have happened without a
-    conclusive response; it has no error_code and must not be retried in the same
-    browser.
+    authentication. fill_failed means the extension returned a known failure and
+    includes error_code. fill_unknown means the form may have been filled or
+    submitted without a conclusive result; inspect the page to see the result of the
+    fill.
     """
 
     type: Literal["1pw_fill"]
 
     error_code: Optional[Literal["fillFailed", "autosubmitFailed", "noExistingCredentials", "authenticationFailed"]] = (
         None
     )
-    """Present only for a conclusive fill_failed response.
-
-    These are allowlisted 1Password extension codes, never raw errors, secrets, or
-    page content.
+    """
+    Present for fill_failed, and for fill_unknown when the extension reported
+    autosubmitFailed (it filled and submitted the form but could not confirm the
+    fill finished). These are allowlisted 1Password extension codes, never raw
+    errors, secrets, or page content.
     """