feat: Accept opaque AgentCard vaulted card IDs

Stainless-Generated-From: 77ed6712c80370958baad94c48aa88b305a33690

Author: kernel-internal[bot]

src/kernel/types/vaults/card_vault_item_spec.py

@@ -113,9 +113,10 @@ class AgentCardCardVaultItemSpec(BaseModel):
     """Wallet item key used to authorize checkouts."""
 
     card_id: Optional[str] = None
-    """AgentCard vaulted card to pay with.
+    """Opaque card ID returned by AgentCard for a card in the connected wallet.
 
-    Omitted, the cardholder picks on the approval screen.
+    Pass it through unchanged without assuming a prefix or format. Omitted, the
+    cardholder picks on the approval screen.
     """
 
 

src/kernel/types/vaults/card_vault_item_spec_param.py

@@ -112,9 +112,10 @@ class AgentCardCardVaultItemSpec(TypedDict, total=False):
     """Wallet item key used to authorize checkouts."""
 
     card_id: str
-    """AgentCard vaulted card to pay with.
+    """Opaque card ID returned by AgentCard for a card in the connected wallet.
 
-    Omitted, the cardholder picks on the approval screen.
+    Pass it through unchanged without assuming a prefix or format. Omitted, the
+    cardholder picks on the approval screen.
     """