Merge pull request #167 from kernel/release-please--branches--main--changes--next

release: 0.100.0

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.99.0"
+  ".": "0.100.0"
 }

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.100.0](https://github.com/kernel/kernel-python-sdk/compare/v0.99.0...v0.100.0) (2026-09-04)
+
+
+### Features
+
+* Fix vault provider errors and remove test card mode ([043d252](https://github.com/kernel/kernel-python-sdk/commit/043d2521509d4e44a4b3e43694db3a77bd6fe546))
+
 ## [0.99.0](https://github.com/kernel/kernel-python-sdk/compare/v0.98.0...v0.99.0) (2026-09-04)
 
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kernel"
-version = "0.99.0"
+version = "0.100.0"
 description = "The official Python library for the kernel API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/kernel/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "kernel"
-__version__ = "0.99.0"  # x-release-please-version
+__version__ = "0.100.0"  # x-release-please-version

src/kernel/resources/vaults/items.py

@@ -131,8 +131,7 @@ def update(
         Update a card specification before or between authorizations
 
         Args:
-          spec: AgentCard reusable card. Each checkout creates an approval-gated authorization
-              for spec.merchant / spec.amount. The card stays ready after each authorization.
+          spec: Live payment card. Test-mode card creation is not supported.
 
           extra_headers: Send extra headers
 
@@ -296,7 +295,9 @@ def perform_operation(
         """
         Retrieve the item first and invoke only an operation listed in
         `available_operations`, following its natural-language description. Operations
-        may call an external provider and can return the item's updated state.
+        may call an external provider and can return the item's updated state. If the
+        provider rate limits spend-request creation, returns HTTP 429 with code
+        `spend_request_rate_limited`; stop and back off before retrying.
 
         Args:
           extra_headers: Send extra headers
@@ -375,8 +376,7 @@ def upsert(
         Create or retrieve an identical vault item by immutable key
 
         Args:
-          spec: AgentCard reusable card. Each checkout creates an approval-gated authorization
-              for spec.merchant / spec.amount. The card stays ready after each authorization.
+          spec: Live payment card. Test-mode card creation is not supported.
 
           extra_headers: Send extra headers
 
@@ -523,8 +523,7 @@ async def update(
         Update a card specification before or between authorizations
 
         Args:
-          spec: AgentCard reusable card. Each checkout creates an approval-gated authorization
-              for spec.merchant / spec.amount. The card stays ready after each authorization.
+          spec: Live payment card. Test-mode card creation is not supported.
 
           extra_headers: Send extra headers
 
@@ -688,7 +687,9 @@ async def perform_operation(
         """
         Retrieve the item first and invoke only an operation listed in
         `available_operations`, following its natural-language description. Operations
-        may call an external provider and can return the item's updated state.
+        may call an external provider and can return the item's updated state. If the
+        provider rate limits spend-request creation, returns HTTP 429 with code
+        `spend_request_rate_limited`; stop and back off before retrying.
 
         Args:
           extra_headers: Send extra headers
@@ -769,8 +770,7 @@ async def upsert(
         Create or retrieve an identical vault item by immutable key
 
         Args:
-          spec: AgentCard reusable card. Each checkout creates an approval-gated authorization
-              for spec.merchant / spec.amount. The card stays ready after each authorization.
+          spec: Live payment card. Test-mode card creation is not supported.
 
           extra_headers: Send extra headers
 

src/kernel/types/vaults/card_vault_item_spec.py

@@ -56,6 +56,8 @@ class LinkCardVaultItemSpecTotal(BaseModel):
 
 
 class LinkCardVaultItemSpec(BaseModel):
+    """Live payment card. Test-mode card creation is not supported."""
+
     amount: int
     """Integer amount in minor currency units."""
 
@@ -76,12 +78,6 @@ class LinkCardVaultItemSpec(BaseModel):
 
     provider: Literal["link"]
 
-    test: bool
-    """
-    Whether Link should return test credentials instead of a live payment
-    credential.
-    """
-
     wallet: str
     """Wallet item key used to mint this card."""
 
@@ -95,9 +91,9 @@ class LinkCardVaultItemSpec(BaseModel):
 
 
 class AgentCardCardVaultItemSpec(BaseModel):
-    """AgentCard reusable card.
+    """AgentCard reusable live payment card.
 
-    Each checkout creates an approval-gated authorization for spec.merchant / spec.amount. The card stays ready after each authorization.
+    Test-mode card creation is not supported. Each checkout creates an approval-gated authorization for spec.merchant / spec.amount. The card stays ready after each authorization.
     """
 
     amount: int

src/kernel/types/vaults/card_vault_item_spec_param.py

@@ -55,6 +55,8 @@ class LinkCardVaultItemSpecTotal(TypedDict, total=False):
 
 
 class LinkCardVaultItemSpec(TypedDict, total=False):
+    """Live payment card. Test-mode card creation is not supported."""
+
     amount: Required[int]
     """Integer amount in minor currency units."""
 
@@ -75,12 +77,6 @@ class LinkCardVaultItemSpec(TypedDict, total=False):
 
     provider: Required[Literal["link"]]
 
-    test: Required[bool]
-    """
-    Whether Link should return test credentials instead of a live payment
-    credential.
-    """
-
     wallet: Required[str]
     """Wallet item key used to mint this card."""
 
@@ -94,9 +90,9 @@ class LinkCardVaultItemSpec(TypedDict, total=False):
 
 
 class AgentCardCardVaultItemSpec(TypedDict, total=False):
-    """AgentCard reusable card.
+    """AgentCard reusable live payment card.
 
-    Each checkout creates an approval-gated authorization for spec.merchant / spec.amount. The card stays ready after each authorization.
+    Test-mode card creation is not supported. Each checkout creates an approval-gated authorization for spec.merchant / spec.amount. The card stays ready after each authorization.
     """
 
     amount: Required[int]

src/kernel/types/vaults/item_update_params.py

@@ -13,8 +13,4 @@ class ItemUpdateParams(TypedDict, total=False):
     id_or_name: Required[str]
 
     spec: Required[CardVaultItemSpecParam]
-    """AgentCard reusable card.
-
-    Each checkout creates an approval-gated authorization for spec.merchant /
-    spec.amount. The card stays ready after each authorization.
-    """
+    """Live payment card. Test-mode card creation is not supported."""

src/kernel/types/vaults/item_upsert_params.py

@@ -29,11 +29,7 @@ class CardVaultItemRequest(TypedDict, total=False):
     id_or_name: Required[str]
 
     spec: Required[CardVaultItemSpecParam]
-    """AgentCard reusable card.
-
-    Each checkout creates an approval-gated authorization for spec.merchant /
-    spec.amount. The card stays ready after each authorization.
-    """
+    """Live payment card. Test-mode card creation is not supported."""
 
     type: Required[Literal["card"]]
 

src/kernel/types/vaults/vault_item.py

@@ -120,11 +120,7 @@ class CardVaultItem(BaseModel):
     """Immutable item key assigned when the item is created."""
 
     spec: CardVaultItemSpec
-    """AgentCard reusable card.
-
-    Each checkout creates an approval-gated authorization for spec.merchant /
-    spec.amount. The card stays ready after each authorization.
-    """
+    """Live payment card. Test-mode card creation is not supported."""
 
     state: CardVaultItemState