feat: Fall back to aliases after network token enrollment failures

Stainless-Generated-From: d3a9e9fb937da5113420fae10c752748efc6bbf2

Author: kernel-internal[bot]

api.md

@@ -602,6 +602,8 @@ from kernel.types.vaults import (
     KernelCredentialVaultItemState,
     KernelWalletState,
     KernelWalletVaultItemSpec,
+    LinkShippingAddress,
+    LinkUserInfo,
     ManagedAuthCredentialVaultField,
     ManagedAuthCredentialVaultItemSpec,
     ManagedAuthCredentialVaultItemSpecInput,

src/kernel/resources/vaults/items.py

@@ -66,7 +66,7 @@ def retrieve(
         key: str,
         *,
         id_or_name: str,
-        expand: List[Literal["payment_methods"]] | Omit = omit,
+        expand: List[Literal["payment_methods", "link_user_info", "link_shipping_addresses"]] | Omit = omit,
         wait: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -746,7 +746,8 @@ def perform_operation(
               prefix or glob matching. When an item allows omitting it, the browser must have
               exactly one open page.
 
-          timeout_ms: Total operation deadline in milliseconds, not a per-field timeout.
+          timeout_ms: Ignored. Fill sets no operation deadline; typing pace adapts to the length of
+              the values instead. Accepted for compatibility.
 
           extra_headers: Send extra headers
 
@@ -1447,7 +1448,7 @@ async def retrieve(
         key: str,
         *,
         id_or_name: str,
-        expand: List[Literal["payment_methods"]] | Omit = omit,
+        expand: List[Literal["payment_methods", "link_user_info", "link_shipping_addresses"]] | Omit = omit,
         wait: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -2127,7 +2128,8 @@ async def perform_operation(
               prefix or glob matching. When an item allows omitting it, the browser must have
               exactly one open page.
 
-          timeout_ms: Total operation deadline in milliseconds, not a per-field timeout.
+          timeout_ms: Ignored. Fill sets no operation deadline; typing pace adapts to the length of
+              the values instead. Accepted for compatibility.
 
           extra_headers: Send extra headers
 

src/kernel/types/vaults/__init__.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from .vault_item import VaultItem as VaultItem
+from .link_user_info import LinkUserInfo as LinkUserInfo
 from .vault_item_event import VaultItemEvent as VaultItemEvent
 from .kernel_card_state import KernelCardState as KernelCardState
 from .vault_item_action import VaultItemAction as VaultItemAction
@@ -18,6 +19,7 @@
 from .vault_payment_method import VaultPaymentMethod as VaultPaymentMethod
 from .card_vault_item_state import CardVaultItemState as CardVaultItemState
 from .credential_vault_item import CredentialVaultItem as CredentialVaultItem
+from .link_shipping_address import LinkShippingAddress as LinkShippingAddress
 from .vault_fill_field_param import VaultFillFieldParam as VaultFillFieldParam
 from .wallet_vault_item_spec import WalletVaultItemSpec as WalletVaultItemSpec
 from .vault_fill_field_result import VaultFillFieldResult as VaultFillFieldResult

src/kernel/types/vaults/card_vault_item_spec.py

@@ -12,6 +12,7 @@
     "LinkCardVaultItemSpec",
     "LinkCardVaultItemSpecLineItem",
     "LinkCardVaultItemSpecLineItemTotal",
+    "LinkCardVaultItemSpecRecurring",
     "LinkCardVaultItemSpecTotal",
     "AgentCardCardVaultItemSpec",
 ]
@@ -47,6 +48,18 @@ class LinkCardVaultItemSpecLineItem(BaseModel):
     url: Optional[str] = None
 
 
+class LinkCardVaultItemSpecRecurring(BaseModel):
+    """Recurring terms for a subscription or other repeated purchase.
+
+    The amount becomes the spending limit for each period of interval_count intervals, for example every 2 weeks. The merchant schedules charges. The card stays ready after each charge until it expires or is deleted; do not create a new card each period. Deleting the card, its wallet or its vault first cancels the credential with Link, so later charges decline; if Link cannot be reached, deletion returns 409 provider_revocation_pending and should be retried. Deletion does not cancel the subscription with the merchant. Recurring terms cannot be changed once the card is authorized.
+    """
+
+    interval: Literal["day", "week", "month", "year"]
+
+    interval_count: Optional[int] = None
+    """Number of intervals per period. Link defaults it to 1."""
+
+
 class LinkCardVaultItemSpecTotal(BaseModel):
     amount: int
     """Total amount in minor currency units."""
@@ -63,7 +76,10 @@ class LinkCardVaultItemSpec(BaseModel):
     """
 
     amount: int
-    """Integer amount in minor currency units, at most 50000."""
+    """Integer amount in minor currency units, at most 50000.
+
+    With recurring, the spending limit per period, not a lifetime total.
+    """
 
     context: str
 
@@ -89,6 +105,19 @@ class LinkCardVaultItemSpec(BaseModel):
 
     metadata: Optional[Dict[str, str]] = None
 
+    recurring: Optional[LinkCardVaultItemSpecRecurring] = None
+    """Recurring terms for a subscription or other repeated purchase.
+
+    The amount becomes the spending limit for each period of interval_count
+    intervals, for example every 2 weeks. The merchant schedules charges. The card
+    stays ready after each charge until it expires or is deleted; do not create a
+    new card each period. Deleting the card, its wallet or its vault first cancels
+    the credential with Link, so later charges decline; if Link cannot be reached,
+    deletion returns 409 provider_revocation_pending and should be retried. Deletion
+    does not cancel the subscription with the merchant. Recurring terms cannot be
+    changed once the card is authorized.
+    """
+
     totals: Optional[List[LinkCardVaultItemSpecTotal]] = None
 
 

src/kernel/types/vaults/card_vault_item_spec_param.py

@@ -12,6 +12,7 @@
     "LinkCardVaultItemSpec",
     "LinkCardVaultItemSpecLineItem",
     "LinkCardVaultItemSpecLineItemTotal",
+    "LinkCardVaultItemSpecRecurring",
     "LinkCardVaultItemSpecTotal",
     "AgentCardCardVaultItemSpec",
 ]
@@ -47,6 +48,18 @@ class LinkCardVaultItemSpecLineItem(TypedDict, total=False):
     url: str
 
 
+class LinkCardVaultItemSpecRecurring(TypedDict, total=False):
+    """Recurring terms for a subscription or other repeated purchase.
+
+    The amount becomes the spending limit for each period of interval_count intervals, for example every 2 weeks. The merchant schedules charges. The card stays ready after each charge until it expires or is deleted; do not create a new card each period. Deleting the card, its wallet or its vault first cancels the credential with Link, so later charges decline; if Link cannot be reached, deletion returns 409 provider_revocation_pending and should be retried. Deletion does not cancel the subscription with the merchant. Recurring terms cannot be changed once the card is authorized.
+    """
+
+    interval: Required[Literal["day", "week", "month", "year"]]
+
+    interval_count: int
+    """Number of intervals per period. Link defaults it to 1."""
+
+
 class LinkCardVaultItemSpecTotal(TypedDict, total=False):
     amount: Required[int]
     """Total amount in minor currency units."""
@@ -63,7 +76,10 @@ class LinkCardVaultItemSpec(TypedDict, total=False):
     """
 
     amount: Required[int]
-    """Integer amount in minor currency units, at most 50000."""
+    """Integer amount in minor currency units, at most 50000.
+
+    With recurring, the spending limit per period, not a lifetime total.
+    """
 
     context: Required[str]
 
@@ -89,6 +105,19 @@ class LinkCardVaultItemSpec(TypedDict, total=False):
 
     metadata: Dict[str, str]
 
+    recurring: LinkCardVaultItemSpecRecurring
+    """Recurring terms for a subscription or other repeated purchase.
+
+    The amount becomes the spending limit for each period of interval_count
+    intervals, for example every 2 weeks. The merchant schedules charges. The card
+    stays ready after each charge until it expires or is deleted; do not create a
+    new card each period. Deleting the card, its wallet or its vault first cancels
+    the credential with Link, so later charges decline; if Link cannot be reached,
+    deletion returns 409 provider_revocation_pending and should be retried. Deletion
+    does not cancel the subscription with the merchant. Recurring terms cannot be
+    changed once the card is authorized.
+    """
+
     totals: Iterable[LinkCardVaultItemSpecTotal]
 
 

src/kernel/types/vaults/credential_account_vault_item.py

@@ -19,7 +19,7 @@ class AvailableExpansion(BaseModel):
 
     description: str
 
-    type: Literal["payment_methods"]
+    type: Literal["payment_methods", "link_user_info", "link_shipping_addresses"]
 
 
 class AvailableOperation(BaseModel):

src/kernel/types/vaults/credential_vault_item.py

@@ -26,7 +26,7 @@ class AvailableExpansion(BaseModel):
 
     description: str
 
-    type: Literal["payment_methods"]
+    type: Literal["payment_methods", "link_user_info", "link_shipping_addresses"]
 
 
 class AvailableOperation(BaseModel):

src/kernel/types/vaults/fill_vault_item_operation_request_param.py

@@ -57,4 +57,8 @@ class FillVaultItemOperationRequestParam(TypedDict, total=False):
     """
 
     timeout_ms: int
-    """Total operation deadline in milliseconds, not a per-field timeout."""
+    """Ignored.
+
+    Fill sets no operation deadline; typing pace adapts to the length of the values
+    instead. Accepted for compatibility.
+    """

src/kernel/types/vaults/item_perform_operation_params.py

@@ -121,7 +121,11 @@ class FillVaultItemOperationRequest(TypedDict, total=False):
     """
 
     timeout_ms: int
-    """Total operation deadline in milliseconds, not a per-field timeout."""
+    """Ignored.
+
+    Fill sets no operation deadline; typing pace adapts to the length of the values
+    instead. Accepted for compatibility.
+    """
 
 
 class OnePasswordRequestAccessVaultItemOperationRequest(TypedDict, total=False):

src/kernel/types/vaults/item_retrieve_params.py

@@ -11,7 +11,7 @@
 class ItemRetrieveParams(TypedDict, total=False):
     id_or_name: Required[str]
 
-    expand: List[Literal["payment_methods"]]
+    expand: List[Literal["payment_methods", "link_user_info", "link_shipping_addresses"]]
     """Live fields advertised by `available_expansions` to include in `expanded`."""
 
     wait: int