Merge remote-tracking branch 'origin/main' into stlc/promote-next

Author: kernel-internal[bot]

src/kernel/resources/vaults/items.py

@@ -409,8 +409,10 @@ def perform_operation(
         device approval before native Square Pay. Keep the returned approval page open,
         poll until ready_to_submit, then submit before preparation.expires_at. Unused
         preparations expire automatically and cannot be reused. If spend-request
-        creation is rate limited, returns HTTP 429 with code
-        `spend_request_rate_limited`; stop and back off before retrying.
+        creation is rejected with a non-retryable provider error, the card item is
+        deleted and the provider's error code and message are returned. Rate limits
+        return HTTP 429 and retain the card item; stop, back off, and retry the same
+        authorize operation.
 
         Fill returns a value-free execution result. Validation failures before writing
         return 400 (invalid request or targets), 403 (access or destination denied), 404
@@ -454,8 +456,10 @@ def perform_operation(
         device approval before native Square Pay. Keep the returned approval page open,
         poll until ready_to_submit, then submit before preparation.expires_at. Unused
         preparations expire automatically and cannot be reused. If spend-request
-        creation is rate limited, returns HTTP 429 with code
-        `spend_request_rate_limited`; stop and back off before retrying.
+        creation is rejected with a non-retryable provider error, the card item is
+        deleted and the provider's error code and message are returned. Rate limits
+        return HTTP 429 and retain the card item; stop, back off, and retry the same
+        authorize operation.
 
         Fill returns a value-free execution result. Validation failures before writing
         return 400 (invalid request or targets), 403 (access or destination denied), 404
@@ -500,8 +504,10 @@ def perform_operation(
         device approval before native Square Pay. Keep the returned approval page open,
         poll until ready_to_submit, then submit before preparation.expires_at. Unused
         preparations expire automatically and cannot be reused. If spend-request
-        creation is rate limited, returns HTTP 429 with code
-        `spend_request_rate_limited`; stop and back off before retrying.
+        creation is rejected with a non-retryable provider error, the card item is
+        deleted and the provider's error code and message are returned. Rate limits
+        return HTTP 429 and retain the card item; stop, back off, and retry the same
+        authorize operation.
 
         Fill returns a value-free execution result. Validation failures before writing
         return 400 (invalid request or targets), 403 (access or destination denied), 404
@@ -555,8 +561,10 @@ def perform_operation(
         device approval before native Square Pay. Keep the returned approval page open,
         poll until ready_to_submit, then submit before preparation.expires_at. Unused
         preparations expire automatically and cannot be reused. If spend-request
-        creation is rate limited, returns HTTP 429 with code
-        `spend_request_rate_limited`; stop and back off before retrying.
+        creation is rejected with a non-retryable provider error, the card item is
+        deleted and the provider's error code and message are returned. Rate limits
+        return HTTP 429 and retain the card item; stop, back off, and retry the same
+        authorize operation.
 
         Fill returns a value-free execution result. Validation failures before writing
         return 400 (invalid request or targets), 403 (access or destination denied), 404
@@ -1172,8 +1180,10 @@ async def perform_operation(
         device approval before native Square Pay. Keep the returned approval page open,
         poll until ready_to_submit, then submit before preparation.expires_at. Unused
         preparations expire automatically and cannot be reused. If spend-request
-        creation is rate limited, returns HTTP 429 with code
-        `spend_request_rate_limited`; stop and back off before retrying.
+        creation is rejected with a non-retryable provider error, the card item is
+        deleted and the provider's error code and message are returned. Rate limits
+        return HTTP 429 and retain the card item; stop, back off, and retry the same
+        authorize operation.
 
         Fill returns a value-free execution result. Validation failures before writing
         return 400 (invalid request or targets), 403 (access or destination denied), 404
@@ -1217,8 +1227,10 @@ async def perform_operation(
         device approval before native Square Pay. Keep the returned approval page open,
         poll until ready_to_submit, then submit before preparation.expires_at. Unused
         preparations expire automatically and cannot be reused. If spend-request
-        creation is rate limited, returns HTTP 429 with code
-        `spend_request_rate_limited`; stop and back off before retrying.
+        creation is rejected with a non-retryable provider error, the card item is
+        deleted and the provider's error code and message are returned. Rate limits
+        return HTTP 429 and retain the card item; stop, back off, and retry the same
+        authorize operation.
 
         Fill returns a value-free execution result. Validation failures before writing
         return 400 (invalid request or targets), 403 (access or destination denied), 404
@@ -1263,8 +1275,10 @@ async def perform_operation(
         device approval before native Square Pay. Keep the returned approval page open,
         poll until ready_to_submit, then submit before preparation.expires_at. Unused
         preparations expire automatically and cannot be reused. If spend-request
-        creation is rate limited, returns HTTP 429 with code
-        `spend_request_rate_limited`; stop and back off before retrying.
+        creation is rejected with a non-retryable provider error, the card item is
+        deleted and the provider's error code and message are returned. Rate limits
+        return HTTP 429 and retain the card item; stop, back off, and retry the same
+        authorize operation.
 
         Fill returns a value-free execution result. Validation failures before writing
         return 400 (invalid request or targets), 403 (access or destination denied), 404
@@ -1318,8 +1332,10 @@ async def perform_operation(
         device approval before native Square Pay. Keep the returned approval page open,
         poll until ready_to_submit, then submit before preparation.expires_at. Unused
         preparations expire automatically and cannot be reused. If spend-request
-        creation is rate limited, returns HTTP 429 with code
-        `spend_request_rate_limited`; stop and back off before retrying.
+        creation is rejected with a non-retryable provider error, the card item is
+        deleted and the provider's error code and message are returned. Rate limits
+        return HTTP 429 and retain the card item; stop, back off, and retry the same
+        authorize operation.
 
         Fill returns a value-free execution result. Validation failures before writing
         return 400 (invalid request or targets), 403 (access or destination denied), 404

src/kernel/types/vaults/card_vault_item_spec.py

@@ -59,7 +59,10 @@ class LinkCardVaultItemSpec(BaseModel):
     """Live payment card. Test-mode card creation is not supported."""
 
     amount: int
-    """Integer amount in minor currency units."""
+    """Integer amount in minor currency units.
+
+    Link permits at most 50000 per spend request.
+    """
 
     context: str
 

src/kernel/types/vaults/card_vault_item_spec_param.py

@@ -58,7 +58,10 @@ class LinkCardVaultItemSpec(TypedDict, total=False):
     """Live payment card. Test-mode card creation is not supported."""
 
     amount: Required[int]
-    """Integer amount in minor currency units."""
+    """Integer amount in minor currency units.
+
+    Link permits at most 50000 per spend request.
+    """
 
     context: Required[str]