@onkernel/sdk 0.131.0 → 0.133.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/client.d.mts.map +1 -1
  3. package/client.d.ts.map +1 -1
  4. package/client.js +1 -0
  5. package/client.js.map +1 -1
  6. package/client.mjs +1 -0
  7. package/client.mjs.map +1 -1
  8. package/package.json +1 -1
  9. package/resources/api-keys.d.mts +5 -0
  10. package/resources/api-keys.d.mts.map +1 -1
  11. package/resources/api-keys.d.ts +5 -0
  12. package/resources/api-keys.d.ts.map +1 -1
  13. package/resources/vaults/index.d.mts +1 -1
  14. package/resources/vaults/index.d.mts.map +1 -1
  15. package/resources/vaults/index.d.ts +1 -1
  16. package/resources/vaults/index.d.ts.map +1 -1
  17. package/resources/vaults/index.js.map +1 -1
  18. package/resources/vaults/index.mjs.map +1 -1
  19. package/resources/vaults/items.d.mts +530 -64
  20. package/resources/vaults/items.d.mts.map +1 -1
  21. package/resources/vaults/items.d.ts +530 -64
  22. package/resources/vaults/items.d.ts.map +1 -1
  23. package/resources/vaults/items.js +10 -2
  24. package/resources/vaults/items.js.map +1 -1
  25. package/resources/vaults/items.mjs +10 -2
  26. package/resources/vaults/items.mjs.map +1 -1
  27. package/resources/vaults/vaults.d.mts +2 -2
  28. package/resources/vaults/vaults.d.mts.map +1 -1
  29. package/resources/vaults/vaults.d.ts +2 -2
  30. package/resources/vaults/vaults.d.ts.map +1 -1
  31. package/resources/vaults/vaults.js.map +1 -1
  32. package/resources/vaults/vaults.mjs.map +1 -1
  33. package/src/client.ts +1 -0
  34. package/src/resources/api-keys.ts +6 -0
  35. package/src/resources/vaults/index.ts +8 -0
  36. package/src/resources/vaults/items.ts +677 -60
  37. package/src/resources/vaults/vaults.ts +16 -0
  38. package/src/version.ts +1 -1
  39. package/version.d.mts +1 -1
  40. package/version.d.ts +1 -1
  41. package/version.js +1 -1
  42. package/version.mjs +1 -1
@@ -129,6 +129,12 @@ export declare class Items extends APIResource {
129
129
  * `failed` or `unknown`. Fill never submits the page, so it is safe to retry after
130
130
  * a failure, an `unknown` outcome, or a transport error.
131
131
  *
132
+ * Connected Kernel wallets may advertise add_payment_method, which returns a
133
+ * single-use hosted card_enrollment link for a card, and remove_payment_method,
134
+ * which removes one card without affecting the others. Both operations require
135
+ * vaults:write in addition to vaults:use on the vault for scoped API keys, and
136
+ * return 403 without both permissions.
137
+ *
132
138
  * @example
133
139
  * ```ts
134
140
  * const vaultItemOperationResponse =
@@ -149,8 +155,10 @@ export declare class Items extends APIResource {
149
155
  * Provider-specific authorization requirements and retry behavior are described in
150
156
  * the item's request schema. Do not use credential items to store, collect, or
151
157
  * fill credit card data, including card numbers (PANs), security codes (CVV/CVC),
152
- * or expiration dates. Use wallet and card item types for credit cards and payment
153
- * checkout instead.
158
+ * or expiration dates. Use wallet, payment_request and card item types for credit
159
+ * cards and payment checkout instead. Where enabled, Link and Kernel purchases can
160
+ * be payment_request items parented by their wallet; card items remain supported
161
+ * for them and for AgentCard reusable cards.
154
162
  *
155
163
  * @example
156
164
  * ```ts
@@ -163,6 +171,28 @@ export declare class Items extends APIResource {
163
171
  */
164
172
  upsert(key: string, params: ItemUpsertParams, options?: RequestOptions): APIPromise<VaultItem>;
165
173
  }
174
+ /**
175
+ * Start hosted enrollment of a card in a connected Kernel wallet, including its
176
+ * first card, only when the wallet advertises add_payment_method. Returns a new
177
+ * payment method in pending_enrollment with a single-use card_enrollment URL for
178
+ * the cardholder. Card details go directly to the card vault and are never
179
+ * accepted by this API. Each call creates a separate link that expires after 30
180
+ * minutes; a failed or expired enrollment does not affect the wallet's other
181
+ * payment methods. Scoped API keys require vaults:write in addition to vaults:use
182
+ * on this vault; otherwise the operation returns 403.
183
+ */
184
+ export interface AddPaymentMethodVaultItemOperationRequest {
185
+ type: 'add_payment_method';
186
+ }
187
+ /**
188
+ * The payment method created in pending_enrollment. Deliver action.url to the
189
+ * cardholder; it is a single-use capability and must not be logged. Observe
190
+ * completion through the wallet's payment_methods expansion.
191
+ */
192
+ export interface AddPaymentMethodVaultItemOperationResult {
193
+ payment_method: VaultPaymentMethod;
194
+ type: 'add_payment_method';
195
+ }
166
196
  /**
167
197
  * The in-flight or most recent checkout authorization. Present while a checkout is
168
198
  * pending approval and after it settles.
@@ -594,7 +624,7 @@ export declare namespace CredentialAccountVaultItem {
594
624
  */
595
625
  interface AvailableOperation {
596
626
  description: string;
597
- type: 'authorize' | 'restart_verification' | 'confirm_transaction' | 'collect' | 'prepare_checkout' | 'fill' | 'arm_passkey' | 'register_passkey' | 'disarm_passkey' | '1pw_create_access_request' | '1pw_access_request_status' | '1pw_fill' | '1pw_recover' | '1pw_update_access_token' | 'webmcp_invoke';
627
+ type: 'authorize' | 'restart_verification' | 'confirm_transaction' | 'collect' | 'prepare_checkout' | 'fill' | 'arm_passkey' | 'register_passkey' | 'disarm_passkey' | '1pw_create_access_request' | '1pw_access_request_status' | '1pw_fill' | '1pw_recover' | '1pw_update_access_token' | 'webmcp_invoke' | 'add_payment_method' | 'remove_payment_method';
598
628
  }
599
629
  }
600
630
  export interface CredentialAccountVaultItemRequest {
@@ -915,7 +945,7 @@ export declare namespace CredentialVaultItem {
915
945
  */
916
946
  interface AvailableOperation {
917
947
  description: string;
918
- type: 'authorize' | 'restart_verification' | 'confirm_transaction' | 'collect' | 'prepare_checkout' | 'fill' | 'arm_passkey' | 'register_passkey' | 'disarm_passkey' | '1pw_create_access_request' | '1pw_access_request_status' | '1pw_fill' | '1pw_recover' | '1pw_update_access_token' | 'webmcp_invoke';
948
+ type: 'authorize' | 'restart_verification' | 'confirm_transaction' | 'collect' | 'prepare_checkout' | 'fill' | 'arm_passkey' | 'register_passkey' | 'disarm_passkey' | '1pw_create_access_request' | '1pw_access_request_status' | '1pw_fill' | '1pw_recover' | '1pw_update_access_token' | 'webmcp_invoke' | 'add_payment_method' | 'remove_payment_method';
919
949
  }
920
950
  interface OnePasswordAccessApprovalAction {
921
951
  /**
@@ -938,22 +968,22 @@ export declare namespace CredentialVaultItem {
938
968
  * path fails, collect a Kernel-hosted credential item instead. Never automatically
939
969
  * retry an uncertain 1Password request. After an uncertain fill, inspect the page
940
970
  * to see the result of the fill. Do not use credential items for credit card data.
941
- * Use wallet and card item types instead. Kernel credentials declare fields and
942
- * may enter pending_collection. 1Password credentials either reference a connected
943
- * credential_account or store a supplied access token and integration key
944
- * encrypted on the item. They store no login values or selectors. Managed auth
945
- * credentials reference a managed auth connection in the same project that already
946
- * has a saved credential, and read it at fill time; they store no values.
947
- * Repeating the original creation request returns the current item without
971
+ * Use wallet, payment_request and card item types instead. Kernel credentials
972
+ * declare fields and may enter pending_collection. 1Password credentials either
973
+ * reference a connected credential_account or store a supplied access token and
974
+ * integration key encrypted on the item. They store no login values or selectors.
975
+ * Managed auth credentials reference a managed auth connection in the same project
976
+ * that already has a saved credential, and read it at fill time; they store no
977
+ * values. Repeating the original creation request returns the current item without
948
978
  * overwriting later state. A different request at the same key returns 409.
949
979
  */
950
980
  export interface CredentialVaultItemRequest {
951
981
  /**
952
982
  * Credential fields are for login and other non-payment credentials. Do not store,
953
- * collect, or fill credit card data in credential items. Use wallet and card item
954
- * types for credit cards and payment checkout instead. Field order is preserved in
955
- * the user-facing collection form, so list fields in the same top-to-bottom order
956
- * as the website.
983
+ * collect, or fill credit card data in credential items. Use wallet,
984
+ * payment_request and card item types for credit cards and payment checkout
985
+ * instead. Field order is preserved in the user-facing collection form, so list
986
+ * fields in the same top-to-bottom order as the website.
957
987
  */
958
988
  spec: CredentialVaultItemSpecInput;
959
989
  type: 'credential';
@@ -965,10 +995,10 @@ export interface CredentialVaultItemRequest {
965
995
  export type CredentialVaultItemSpec = KernelCredentialVaultItemSpec | OnePasswordCredentialVaultItemSpec | ManagedAuthCredentialVaultItemSpec;
966
996
  /**
967
997
  * Credential fields are for login and other non-payment credentials. Do not store,
968
- * collect, or fill credit card data in credential items. Use wallet and card item
969
- * types for credit cards and payment checkout instead. Field order is preserved in
970
- * the user-facing collection form, so list fields in the same top-to-bottom order
971
- * as the website.
998
+ * collect, or fill credit card data in credential items. Use wallet,
999
+ * payment_request and card item types for credit cards and payment checkout
1000
+ * instead. Field order is preserved in the user-facing collection form, so list
1001
+ * fields in the same top-to-bottom order as the website.
972
1002
  */
973
1003
  export type CredentialVaultItemSpecInput = KernelCredentialVaultItemSpecInput | OnePasswordCredentialVaultItemSpecInput | ManagedAuthCredentialVaultItemSpecInput;
974
1004
  export interface CredentialVaultItemSpecUpdate {
@@ -1140,7 +1170,22 @@ export interface KernelCardState {
1140
1170
  * Informational registrable domain. Fill is locked to merchant_url's exact origin.
1141
1171
  */
1142
1172
  domains?: Array<string>;
1173
+ /**
1174
+ * Whether payment_method_id can still fund this purchase. unavailable means the
1175
+ * method is being removed or awaits recovery, so authorization, fill and
1176
+ * confirmation are refused until it recovers. removed means the method was removed
1177
+ * from its wallet, so this purchase can no longer be paid; create a new purchase
1178
+ * with another method. Neither changes status, which still reports what already
1179
+ * happened to this purchase.
1180
+ */
1181
+ funding_status?: 'available' | 'unavailable' | 'removed';
1143
1182
  masks?: KernelCardState.Masks;
1183
+ /**
1184
+ * Wallet-scoped ID of the payment method funding this purchase. It is bound when
1185
+ * the purchase is created and never changes; purchases created before payment
1186
+ * methods could be selected report the wallet's default card, card.
1187
+ */
1188
+ payment_method_id?: string;
1144
1189
  status_reason?: string;
1145
1190
  }
1146
1191
  export declare namespace KernelCardState {
@@ -1207,6 +1252,14 @@ export interface KernelCardVaultItemSpec {
1207
1252
  * one-time code is issued for the merchant's country.
1208
1253
  */
1209
1254
  merchant_country?: string;
1255
+ /**
1256
+ * Wallet-scoped payment method ID from the wallet's payment_methods expansion.
1257
+ * Omission selects the wallet's default card, ID card, for compatibility with
1258
+ * existing requests; it never falls back to another method, and a wallet without a
1259
+ * default card requires the ID. The purchase is bound to the method's enrolled
1260
+ * card and network token, so later operations cannot switch funding.
1261
+ */
1262
+ payment_method_id?: string;
1210
1263
  }
1211
1264
  export interface KernelCredentialVaultItemSpec {
1212
1265
  /**
@@ -1223,10 +1276,10 @@ export interface KernelCredentialVaultItemSpec {
1223
1276
  }
1224
1277
  /**
1225
1278
  * Credential fields are for login and other non-payment credentials. Do not store,
1226
- * collect, or fill credit card data in credential items. Use wallet and card item
1227
- * types for credit cards and payment checkout instead. Field order is preserved in
1228
- * the user-facing collection form, so list fields in the same top-to-bottom order
1229
- * as the website.
1279
+ * collect, or fill credit card data in credential items. Use wallet,
1280
+ * payment_request and card item types for credit cards and payment checkout
1281
+ * instead. Field order is preserved in the user-facing collection form, so list
1282
+ * fields in the same top-to-bottom order as the website.
1230
1283
  */
1231
1284
  export interface KernelCredentialVaultItemSpecInput {
1232
1285
  /**
@@ -1257,31 +1310,89 @@ export interface KernelCredentialVaultItemState {
1257
1310
  */
1258
1311
  status: 'pending_collection' | 'ready';
1259
1312
  }
1313
+ /**
1314
+ * One live purchase funded by the Kernel wallet payment method named by
1315
+ * payment_method_id. The method must be active and eligible when the request is
1316
+ * created. The purchase is bound to that method; later operations cannot switch
1317
+ * funding, and removing the method makes the purchase unusable rather than moving
1318
+ * it to another card. Approval, issuance, fill and the alias fallback behave as
1319
+ * described for KernelCardVaultItemSpec.
1320
+ */
1321
+ export interface KernelPaymentRequestVaultItemSpec {
1322
+ /**
1323
+ * Integer amount in minor currency units (at most 1000000), bound to the one-time
1324
+ * code.
1325
+ */
1326
+ amount: number;
1327
+ /**
1328
+ * ISO 4217 code. Supported: aud, brl, cad, chf, czk, dkk, eur, gbp, hkd, inr, jpy,
1329
+ * krw, mxn, nok, nzd, pln, sek, sgd, usd, zar.
1330
+ */
1331
+ currency: string;
1332
+ merchant_name: string;
1333
+ /**
1334
+ * Merchant checkout URL. Fill is allowed only on this URL's origin.
1335
+ */
1336
+ merchant_url: string;
1337
+ /**
1338
+ * Payment method ID from the wallet's payment_methods expansion.
1339
+ */
1340
+ payment_method_id: string;
1341
+ provider: 'kernel';
1342
+ /**
1343
+ * Key of the Kernel wallet item that owns the payment method.
1344
+ */
1345
+ wallet: string;
1346
+ /**
1347
+ * Actual merchant category when known. Omit rather than invent a category.
1348
+ */
1349
+ merchant_category?: string;
1350
+ /**
1351
+ * Actual merchant MCC when known. Omit rather than invent a code. 0000 is not
1352
+ * accepted.
1353
+ */
1354
+ merchant_category_code?: string;
1355
+ /**
1356
+ * The merchant's ISO 3166-1 alpha-2 country code. Required for Visa cards, whose
1357
+ * one-time code is issued for the merchant's country.
1358
+ */
1359
+ merchant_country?: string;
1360
+ }
1260
1361
  export interface KernelWalletState {
1261
1362
  provider: 'kernel';
1262
1363
  /**
1263
- * pending_authorization asks the cardholder to use the card_enrollment action.
1264
- * connected means the card is stored; it can pay once payment_methods reports
1265
- * capabilities.single_use_card.eligible. reconnect_required asks the cardholder to
1266
- * use a new card_enrollment action after an uncertain enrollment was safely
1267
- * removed. degraded means the enrollment outcome is unknown and the wallet must be
1268
- * deleted before adding another card.
1364
+ * connected means the wallet is usable. It holds zero or more cards as payment
1365
+ * methods, listed by the payment_methods expansion, and each can pay once it
1366
+ * reports capabilities.single_use_card.eligible. A wallet with no cards, before
1367
+ * its first card or after its last is removed, is still connected. Where the
1368
+ * wallet advertises add_payment_method and remove_payment_method, use them to
1369
+ * manage cards. Otherwise the wallet enrolls one default card when created; until
1370
+ * that card is enrolled the wallet reports pending_authorization with the card's
1371
+ * card_enrollment action, or degraded when the card's enrollment outcome is
1372
+ * unknown and the wallet must be deleted before adding another card.
1373
+ * reconnect_required appears only on a wallet created before cards were payment
1374
+ * methods and not yet upgraded. Reads preserve its stored state until the operator
1375
+ * upgrade; payment and deletion requests are refused until then.
1269
1376
  */
1270
1377
  status: 'pending_authorization' | 'connected' | 'reconnect_required' | 'degraded';
1271
1378
  status_reason?: string;
1272
1379
  }
1273
1380
  /**
1274
- * One card stored with Kernel-managed credentials. Creation returns a
1275
- * card*enrollment action: the cardholder enters the card and their email on a
1276
- * Kernel-hosted page, and the wallet connects once the card is stored. Kernel then
1277
- * enrolls it for an agentic network token when the issuer supports it. The card
1278
- * number never reaches Kernel. The connected wallet's payment_methods expansion
1279
- * lists the card; capabilities.single_use_card.eligible is false, with a
1280
- * network_token*\* reason, until the card has a network token, and authorize
1281
- * returns 400 for such a card unless Kernel supports checkout delivery without a
1282
- * network token for that card. In that case, fill types the checkout details. Visa
1283
- * purchases require the cardholder to complete a spend_approval action before
1284
- * Kernel issues a one-time code; Mastercard purchases need no hosted approval.
1381
+ * Cards stored with Kernel-managed credentials, each a payment method of the
1382
+ * wallet. Each card is enrolled through a card*enrollment action: the cardholder
1383
+ * enters the card and their email on a Kernel-hosted page. Where the wallet
1384
+ * advertises add_payment_method, creation returns an empty connected wallet and
1385
+ * each card is enrolled with that operation. Otherwise creation returns the
1386
+ * wallet's default card's card_enrollment action, and the wallet connects once
1387
+ * that card is stored. Kernel then enrolls each card for an agentic network token
1388
+ * when the issuer supports it. The card number never reaches Kernel. The connected
1389
+ * wallet's payment_methods expansion lists the cards;
1390
+ * capabilities.single_use_card.eligible is false, with a network_token*\* reason,
1391
+ * until the card has a network token, and authorize returns 400 for such a card
1392
+ * unless Kernel supports checkout delivery without a network token for that card.
1393
+ * In that case, fill types the checkout details. Visa purchases require the
1394
+ * cardholder to complete a spend_approval action before Kernel issues a one-time
1395
+ * code; Mastercard purchases need no hosted approval.
1285
1396
  */
1286
1397
  export interface KernelWalletVaultItemSpec {
1287
1398
  provider: 'kernel';
@@ -1660,8 +1771,9 @@ export interface OnePasswordCredentialVaultItemState {
1660
1771
  provider: '1password';
1661
1772
  status: 'pending_authorization' | 'ready' | 'declined' | 'failed';
1662
1773
  /**
1663
- * Non-secret broker state. Granted credential references stay encrypted
1664
- * server-side and can only be used by the fill operation.
1774
+ * Non-secret broker state. Granted credential references are returned in resolved
1775
+ * only for credentials with a customer-supplied access token; otherwise they stay
1776
+ * encrypted server-side and can only be used by the fill operation.
1665
1777
  */
1666
1778
  access_request?: OnePasswordCredentialVaultItemState.AccessRequest;
1667
1779
  /**
@@ -1673,8 +1785,9 @@ export interface OnePasswordCredentialVaultItemState {
1673
1785
  }
1674
1786
  export declare namespace OnePasswordCredentialVaultItemState {
1675
1787
  /**
1676
- * Non-secret broker state. Granted credential references stay encrypted
1677
- * server-side and can only be used by the fill operation.
1788
+ * Non-secret broker state. Granted credential references are returned in resolved
1789
+ * only for credentials with a customer-supplied access token; otherwise they stay
1790
+ * encrypted server-side and can only be used by the fill operation.
1678
1791
  */
1679
1792
  interface AccessRequest {
1680
1793
  id: string;
@@ -1710,6 +1823,13 @@ export declare namespace OnePasswordCredentialVaultItemState {
1710
1823
  * may omit entries; no entry IDs are invented.
1711
1824
  */
1712
1825
  request?: AccessRequest.Request;
1826
+ /**
1827
+ * Granted logins in the shape 1Password's getAccessRequestStatus returns. Present
1828
+ * only for ready credentials with a customer-supplied access token, on single-item
1829
+ * responses to callers that can use the vault. Each reference works only with that
1830
+ * credential's access token and integration key.
1831
+ */
1832
+ resolved?: Array<AccessRequest.Resolved>;
1713
1833
  }
1714
1834
  namespace AccessRequest {
1715
1835
  interface Entry {
@@ -1747,14 +1867,25 @@ export declare namespace OnePasswordCredentialVaultItemState {
1747
1867
  }
1748
1868
  }
1749
1869
  }
1870
+ interface Resolved {
1871
+ /**
1872
+ * 1Password credential reference. Pass it unchanged as resourcePath to the
1873
+ * extension's fillCredential or to the 1Password SDK.
1874
+ */
1875
+ reference: string;
1876
+ /**
1877
+ * The requested entry this login satisfies, when known.
1878
+ */
1879
+ entryId?: string;
1880
+ }
1750
1881
  }
1751
1882
  }
1752
1883
  /**
1753
1884
  * Fill and submit an approved 1Password login in the selected browser page. The
1754
1885
  * page must share the selected entry's login origin. Supply entry_id when more
1755
- * than one approved entry matches the page origin. The extension selects fields;
1756
- * callers cannot supply selectors or secret values. Submission does not confirm
1757
- * website authentication.
1886
+ * than one approved entry matches the page origin, and target_id when more than
1887
+ * one open page has page_url. The extension selects fields; callers cannot supply
1888
+ * selectors or secret values. Submission does not confirm website authentication.
1758
1889
  */
1759
1890
  export interface OnePasswordFillVaultItemOperationRequest {
1760
1891
  /**
@@ -1763,7 +1894,7 @@ export interface OnePasswordFillVaultItemOperationRequest {
1763
1894
  browser_id: string;
1764
1895
  /**
1765
1896
  * Exact current top-level page URL. Must match exactly one open page in the
1766
- * browser.
1897
+ * browser unless target_id is supplied.
1767
1898
  */
1768
1899
  page_url: string;
1769
1900
  type: '1pw_fill';
@@ -1772,6 +1903,13 @@ export interface OnePasswordFillVaultItemOperationRequest {
1772
1903
  * page's origin.
1773
1904
  */
1774
1905
  entry_id?: string;
1906
+ /**
1907
+ * CDP target ID of the page to fill, such as tab.target_id from
1908
+ * playwright.execute. Use it when several open pages have page_url. The page's
1909
+ * current URL must equal page_url. Kernel brings the page to the front of its
1910
+ * window before filling.
1911
+ */
1912
+ target_id?: string;
1775
1913
  timeout_ms?: number;
1776
1914
  }
1777
1915
  /**
@@ -1837,6 +1975,204 @@ export interface PasskeyVaultItemOperationResult {
1837
1975
  */
1838
1976
  rp_id?: string;
1839
1977
  }
1978
+ /**
1979
+ * One purchase from a Link or Kernel wallet, parented by that wallet. It has the
1980
+ * same lifecycle, operations and fill behavior as a Link or Kernel card item.
1981
+ * AgentCard reusable cards remain card items.
1982
+ */
1983
+ export interface PaymentRequestVaultItem {
1984
+ id: string;
1985
+ available_expansions: Array<PaymentRequestVaultItem.AvailableExpansion>;
1986
+ available_operations: Array<PaymentRequestVaultItem.AvailableOperation>;
1987
+ created_at: string;
1988
+ /**
1989
+ * Immutable item key assigned when the item is created.
1990
+ */
1991
+ key: string;
1992
+ /**
1993
+ * Live Link card request. Test-mode card creation is not supported. The spec can
1994
+ * be changed with PATCH until the card is authorized at a checkout. Authorize it
1995
+ * with the browser at final checkout: Kernel inspects the checkout through WebMCP
1996
+ * and internally chooses a merchant-bound Link Pay Token when supported or a
1997
+ * virtual card otherwise. Callers never receive or choose how the credential is
1998
+ * delivered.
1999
+ */
2000
+ spec: PaymentRequestVaultItemSpec;
2001
+ /**
2002
+ * Issued Link cards retain encrypted card material for the fill operation. Link
2003
+ * cards do not expose aliases or support egress substitution.
2004
+ */
2005
+ state: PaymentRequestVaultItemState;
2006
+ type: 'payment_request';
2007
+ updated_at: string;
2008
+ action?: VaultItemAction;
2009
+ expires_at?: string;
2010
+ }
2011
+ export declare namespace PaymentRequestVaultItem {
2012
+ /**
2013
+ * Live data that can currently be requested by passing its type to the item GET
2014
+ * expand parameter.
2015
+ */
2016
+ interface AvailableExpansion {
2017
+ description: string;
2018
+ type: 'payment_methods' | 'link_user_info' | 'link_shipping_addresses';
2019
+ }
2020
+ /**
2021
+ * An operation that is currently valid for this item. Read the description before
2022
+ * invoking it through the item operations endpoint.
2023
+ */
2024
+ interface AvailableOperation {
2025
+ description: string;
2026
+ type: 'authorize' | 'restart_verification' | 'confirm_transaction' | 'collect' | 'prepare_checkout' | 'fill' | 'arm_passkey' | 'register_passkey' | 'disarm_passkey' | '1pw_create_access_request' | '1pw_access_request_status' | '1pw_fill' | '1pw_recover' | '1pw_update_access_token' | 'webmcp_invoke' | 'add_payment_method' | 'remove_payment_method';
2027
+ }
2028
+ }
2029
+ /**
2030
+ * Live Link card request. Test-mode card creation is not supported. The spec can
2031
+ * be changed with PATCH until the card is authorized at a checkout. Authorize it
2032
+ * with the browser at final checkout: Kernel inspects the checkout through WebMCP
2033
+ * and internally chooses a merchant-bound Link Pay Token when supported or a
2034
+ * virtual card otherwise. Callers never receive or choose how the credential is
2035
+ * delivered.
2036
+ */
2037
+ export type PaymentRequestVaultItemSpec = PaymentRequestVaultItemSpec.LinkCardVaultItemSpec | KernelPaymentRequestVaultItemSpec;
2038
+ export declare namespace PaymentRequestVaultItemSpec {
2039
+ /**
2040
+ * Live Link card request. Test-mode card creation is not supported. The spec can
2041
+ * be changed with PATCH until the card is authorized at a checkout. Authorize it
2042
+ * with the browser at final checkout: Kernel inspects the checkout through WebMCP
2043
+ * and internally chooses a merchant-bound Link Pay Token when supported or a
2044
+ * virtual card otherwise. Callers never receive or choose how the credential is
2045
+ * delivered.
2046
+ */
2047
+ interface LinkCardVaultItemSpec {
2048
+ /**
2049
+ * Integer amount in minor currency units, at most 50000. With recurring, the
2050
+ * spending limit per period, not a lifetime total.
2051
+ */
2052
+ amount: number;
2053
+ context: string;
2054
+ currency: string;
2055
+ merchant_name: string;
2056
+ merchant_url: string;
2057
+ /**
2058
+ * Payment-method ID returned by the referenced wallet's payment-method listing.
2059
+ * The provider decides whether the selected funding method can satisfy the card
2060
+ * request.
2061
+ */
2062
+ payment_method_id: string;
2063
+ provider: 'link';
2064
+ /**
2065
+ * Connected Link wallet item key.
2066
+ */
2067
+ wallet: string;
2068
+ line_items?: Array<LinkCardVaultItemSpec.LineItem>;
2069
+ metadata?: {
2070
+ [key: string]: string;
2071
+ };
2072
+ /**
2073
+ * Recurring terms for a subscription or other repeated purchase. The amount
2074
+ * becomes the spending limit for each period of interval_count intervals, for
2075
+ * example every 2 weeks. The merchant schedules charges. The card stays ready
2076
+ * after each charge until it expires or is deleted; do not create a new card each
2077
+ * period. Deleting the card, its wallet or its vault first cancels the credential
2078
+ * with Link, so later charges decline; if Link cannot be reached, deletion returns
2079
+ * 409 provider_revocation_pending and should be retried. Deletion does not cancel
2080
+ * the subscription with the merchant. Recurring terms cannot be changed once the
2081
+ * card is authorized.
2082
+ */
2083
+ recurring?: LinkCardVaultItemSpec.Recurring;
2084
+ totals?: Array<LinkCardVaultItemSpec.Total>;
2085
+ }
2086
+ namespace LinkCardVaultItemSpec {
2087
+ interface LineItem {
2088
+ name: string;
2089
+ description?: string;
2090
+ image_url?: string;
2091
+ product_url?: string;
2092
+ quantity?: number;
2093
+ sku?: string;
2094
+ totals?: Array<LineItem.Total>;
2095
+ /**
2096
+ * Unit amount in minor currency units.
2097
+ */
2098
+ unit_amount?: number;
2099
+ url?: string;
2100
+ }
2101
+ namespace LineItem {
2102
+ interface Total {
2103
+ /**
2104
+ * Total amount in minor currency units.
2105
+ */
2106
+ amount: number;
2107
+ display_text: string;
2108
+ type: string;
2109
+ }
2110
+ }
2111
+ /**
2112
+ * Recurring terms for a subscription or other repeated purchase. The amount
2113
+ * becomes the spending limit for each period of interval_count intervals, for
2114
+ * example every 2 weeks. The merchant schedules charges. The card stays ready
2115
+ * after each charge until it expires or is deleted; do not create a new card each
2116
+ * period. Deleting the card, its wallet or its vault first cancels the credential
2117
+ * with Link, so later charges decline; if Link cannot be reached, deletion returns
2118
+ * 409 provider_revocation_pending and should be retried. Deletion does not cancel
2119
+ * the subscription with the merchant. Recurring terms cannot be changed once the
2120
+ * card is authorized.
2121
+ */
2122
+ interface Recurring {
2123
+ interval: 'day' | 'week' | 'month' | 'year';
2124
+ /**
2125
+ * Number of intervals per period. Link defaults it to 1.
2126
+ */
2127
+ interval_count?: number;
2128
+ }
2129
+ interface Total {
2130
+ /**
2131
+ * Total amount in minor currency units.
2132
+ */
2133
+ amount: number;
2134
+ display_text: string;
2135
+ type: string;
2136
+ }
2137
+ }
2138
+ }
2139
+ /**
2140
+ * Issued Link cards retain encrypted card material for the fill operation. Link
2141
+ * cards do not expose aliases or support egress substitution.
2142
+ */
2143
+ export type PaymentRequestVaultItemState = PaymentRequestVaultItemState.LinkCardState | KernelCardState;
2144
+ export declare namespace PaymentRequestVaultItemState {
2145
+ /**
2146
+ * Issued Link cards retain encrypted card material for the fill operation. Link
2147
+ * cards do not expose aliases or support egress substitution.
2148
+ */
2149
+ interface LinkCardState {
2150
+ provider: 'link';
2151
+ /**
2152
+ * recovery_required means an original provider operation has an unresolved outcome
2153
+ * and the card cannot be used. Reads keep observing a known provider request and
2154
+ * may clear the recovery. To continue, delete this card and create a new one;
2155
+ * deleting cancels the original request when its ID is known and keeps the
2156
+ * recovery evidence. The user may see an approval request for the original card
2157
+ * and should approve only the new one.
2158
+ */
2159
+ status: 'requested' | 'pending_authorization' | 'ready' | 'consumed' | 'expired' | 'declined' | 'recovery_required';
2160
+ domains?: Array<string>;
2161
+ masks?: LinkCardState.Masks;
2162
+ status_reason?: string;
2163
+ }
2164
+ namespace LinkCardState {
2165
+ interface Masks {
2166
+ brand?: string;
2167
+ last4?: string;
2168
+ /**
2169
+ * Last four digits of the network token presented to the merchant.
2170
+ */
2171
+ token_last4?: string;
2172
+ [k: string]: string | undefined;
2173
+ }
2174
+ }
2175
+ }
1840
2176
  /**
1841
2177
  * Prepare an unused AgentCard card for a supported checkout. Deliver the returned
1842
2178
  * approval URL and keep the approval page open. Poll the item until
@@ -1882,6 +2218,29 @@ export interface RegisterPasskeyVaultItemOperationRequest {
1882
2218
  */
1883
2219
  field?: string;
1884
2220
  }
2221
+ /**
2222
+ * Remove one payment method from a Kernel wallet, only when the wallet advertises
2223
+ * remove_payment_method. Removal deletes the stored card and blocks new purchases,
2224
+ * fills and confirmations funded by it without affecting the wallet's other
2225
+ * payment methods; the wallet stays connected even with no payment methods left. A
2226
+ * purchase funded by the method with an unresolved outcome blocks removal with 409
2227
+ * purchase_unresolved. If the provider outcome is uncertain the method stays in
2228
+ * removal_pending and keeps refusing payments; retry the removal later. Removal is
2229
+ * not proof that a payment did not occur. Scoped API keys require vaults:write in
2230
+ * addition to vaults:use on this vault; otherwise the operation returns 403.
2231
+ */
2232
+ export interface RemovePaymentMethodVaultItemOperationRequest {
2233
+ /**
2234
+ * ID from the wallet's payment_methods expansion.
2235
+ */
2236
+ payment_method_id: string;
2237
+ type: 'remove_payment_method';
2238
+ }
2239
+ export interface RemovePaymentMethodVaultItemOperationResult {
2240
+ payment_method_id: string;
2241
+ status: 'removed';
2242
+ type: 'remove_payment_method';
2243
+ }
1885
2244
  /**
1886
2245
  * Explicitly prepare a fresh local verification session for the same Kernel Visa
1887
2246
  * purchase and connected wallet, only when restart_verification is advertised.
@@ -2001,7 +2360,12 @@ export interface VaultFillFieldResult {
2001
2360
  */
2002
2361
  error_code?: 'target_changed' | 'element_not_found' | 'ambiguous_selector' | 'element_not_editable' | 'option_not_found' | 'timeout' | 'execution_failed';
2003
2362
  }
2004
- export type VaultItem = VaultItem.WalletVaultItem | VaultItem.CardVaultItem | CredentialAccountVaultItem | CredentialVaultItem;
2363
+ /**
2364
+ * One purchase from a Link or Kernel wallet, parented by that wallet. It has the
2365
+ * same lifecycle, operations and fill behavior as a Link or Kernel card item.
2366
+ * AgentCard reusable cards remain card items.
2367
+ */
2368
+ export type VaultItem = VaultItem.WalletVaultItem | VaultItem.CardVaultItem | PaymentRequestVaultItem | CredentialAccountVaultItem | CredentialVaultItem;
2005
2369
  export declare namespace VaultItem {
2006
2370
  interface WalletVaultItem {
2007
2371
  id: string;
@@ -2058,7 +2422,7 @@ export declare namespace VaultItem {
2058
2422
  */
2059
2423
  interface AvailableOperation {
2060
2424
  description: string;
2061
- type: 'authorize' | 'restart_verification' | 'confirm_transaction' | 'collect' | 'prepare_checkout' | 'fill' | 'arm_passkey' | 'register_passkey' | 'disarm_passkey' | '1pw_create_access_request' | '1pw_access_request_status' | '1pw_fill' | '1pw_recover' | '1pw_update_access_token' | 'webmcp_invoke';
2425
+ type: 'authorize' | 'restart_verification' | 'confirm_transaction' | 'collect' | 'prepare_checkout' | 'fill' | 'arm_passkey' | 'register_passkey' | 'disarm_passkey' | '1pw_create_access_request' | '1pw_access_request_status' | '1pw_fill' | '1pw_recover' | '1pw_update_access_token' | 'webmcp_invoke' | 'add_payment_method' | 'remove_payment_method';
2062
2426
  }
2063
2427
  /**
2064
2428
  * Live, non-persisted data requested through the item GET expand parameter.
@@ -2122,7 +2486,7 @@ export declare namespace VaultItem {
2122
2486
  */
2123
2487
  interface AvailableOperation {
2124
2488
  description: string;
2125
- type: 'authorize' | 'restart_verification' | 'confirm_transaction' | 'collect' | 'prepare_checkout' | 'fill' | 'arm_passkey' | 'register_passkey' | 'disarm_passkey' | '1pw_create_access_request' | '1pw_access_request_status' | '1pw_fill' | '1pw_recover' | '1pw_update_access_token' | 'webmcp_invoke';
2489
+ type: 'authorize' | 'restart_verification' | 'confirm_transaction' | 'collect' | 'prepare_checkout' | 'fill' | 'arm_passkey' | 'register_passkey' | 'disarm_passkey' | '1pw_create_access_request' | '1pw_access_request_status' | '1pw_fill' | '1pw_recover' | '1pw_update_access_token' | 'webmcp_invoke' | 'add_payment_method' | 'remove_payment_method';
2126
2490
  }
2127
2491
  }
2128
2492
  }
@@ -2174,9 +2538,10 @@ export interface VaultItemEvent {
2174
2538
  /**
2175
2539
  * Authorization and preparation return the existing item shape. Fill and passkey
2176
2540
  * operations return value-free results; WebMCP invocation returns the tool's
2177
- * output. None persist transient outcomes on the item.
2541
+ * output. None persist transient outcomes on the item. Payment-method operations
2542
+ * return the affected wallet payment method.
2178
2543
  */
2179
- export type VaultItemOperationResponse = VaultItemOperationResponse.WalletVaultItem | VaultItemOperationResponse.CardVaultItem | CredentialAccountVaultItem | CredentialVaultItem | FillVaultItemOperationResult | PasskeyVaultItemOperationResult | OnePasswordFillVaultItemOperationResult | WebmcpInvokeVaultItemOperationResult;
2544
+ export type VaultItemOperationResponse = VaultItemOperationResponse.WalletVaultItem | VaultItemOperationResponse.CardVaultItem | PaymentRequestVaultItem | CredentialAccountVaultItem | CredentialVaultItem | FillVaultItemOperationResult | PasskeyVaultItemOperationResult | OnePasswordFillVaultItemOperationResult | WebmcpInvokeVaultItemOperationResult | AddPaymentMethodVaultItemOperationResult | RemovePaymentMethodVaultItemOperationResult;
2180
2545
  export declare namespace VaultItemOperationResponse {
2181
2546
  interface WalletVaultItem {
2182
2547
  id: string;
@@ -2233,7 +2598,7 @@ export declare namespace VaultItemOperationResponse {
2233
2598
  */
2234
2599
  interface AvailableOperation {
2235
2600
  description: string;
2236
- type: 'authorize' | 'restart_verification' | 'confirm_transaction' | 'collect' | 'prepare_checkout' | 'fill' | 'arm_passkey' | 'register_passkey' | 'disarm_passkey' | '1pw_create_access_request' | '1pw_access_request_status' | '1pw_fill' | '1pw_recover' | '1pw_update_access_token' | 'webmcp_invoke';
2601
+ type: 'authorize' | 'restart_verification' | 'confirm_transaction' | 'collect' | 'prepare_checkout' | 'fill' | 'arm_passkey' | 'register_passkey' | 'disarm_passkey' | '1pw_create_access_request' | '1pw_access_request_status' | '1pw_fill' | '1pw_recover' | '1pw_update_access_token' | 'webmcp_invoke' | 'add_payment_method' | 'remove_payment_method';
2237
2602
  }
2238
2603
  /**
2239
2604
  * Live, non-persisted data requested through the item GET expand parameter.
@@ -2297,7 +2662,7 @@ export declare namespace VaultItemOperationResponse {
2297
2662
  */
2298
2663
  interface AvailableOperation {
2299
2664
  description: string;
2300
- type: 'authorize' | 'restart_verification' | 'confirm_transaction' | 'collect' | 'prepare_checkout' | 'fill' | 'arm_passkey' | 'register_passkey' | 'disarm_passkey' | '1pw_create_access_request' | '1pw_access_request_status' | '1pw_fill' | '1pw_recover' | '1pw_update_access_token' | 'webmcp_invoke';
2665
+ type: 'authorize' | 'restart_verification' | 'confirm_transaction' | 'collect' | 'prepare_checkout' | 'fill' | 'arm_passkey' | 'register_passkey' | 'disarm_passkey' | '1pw_create_access_request' | '1pw_access_request_status' | '1pw_fill' | '1pw_recover' | '1pw_update_access_token' | 'webmcp_invoke' | 'add_payment_method' | 'remove_payment_method';
2301
2666
  }
2302
2667
  }
2303
2668
  }
@@ -2309,6 +2674,11 @@ export interface VaultPaymentMethod {
2309
2674
  */
2310
2675
  capabilities: VaultPaymentMethod.Capabilities;
2311
2676
  display: VaultPaymentMethod.Display;
2677
+ /**
2678
+ * For Kernel wallets, true for the default card, ID card, which a Kernel card item
2679
+ * that omits payment_method_id selects. Wallets created with payment methods
2680
+ * enabled have no default card.
2681
+ */
2312
2682
  is_default: boolean;
2313
2683
  /**
2314
2684
  * Provider that issued this payment-method ID.
@@ -2318,6 +2688,23 @@ export interface VaultPaymentMethod {
2318
2688
  * Provider-neutral payment-method type normalized to lowercase.
2319
2689
  */
2320
2690
  type: string;
2691
+ action?: VaultPaymentMethod.Action;
2692
+ /**
2693
+ * Expiry of a pending enrollment link.
2694
+ */
2695
+ expires_at?: string;
2696
+ /**
2697
+ * Kernel wallets only. pending_enrollment means a card_enrollment link is open;
2698
+ * active means the card is stored and can pay when
2699
+ * capabilities.single_use_card.eligible is true; removal_pending means removal
2700
+ * started but the provider outcome is unknown, so retry remove_payment_method;
2701
+ * recovery_required means either an enrollment outcome is unknown (remove the
2702
+ * method), or the stored card cannot be read (contact support; removal is refused
2703
+ * with 409). Consult status_reason to distinguish these cases. Absent for other
2704
+ * providers.
2705
+ */
2706
+ status?: 'pending_enrollment' | 'active' | 'removal_pending' | 'recovery_required';
2707
+ status_reason?: string;
2321
2708
  }
2322
2709
  export declare namespace VaultPaymentMethod {
2323
2710
  /**
@@ -2338,6 +2725,16 @@ export declare namespace VaultPaymentMethod {
2338
2725
  label?: string;
2339
2726
  last4?: string;
2340
2727
  }
2728
+ interface Action {
2729
+ name: 'card_enrollment';
2730
+ url: string;
2731
+ /**
2732
+ * Secret bearer capability for embedded card capture with @onkernel/vault-react.
2733
+ * Present only for Kernel wallets; never for AgentCard. Treat it like the
2734
+ * enrollment URL and do not log or persist it in browser storage.
2735
+ */
2736
+ capture_token?: string;
2737
+ }
2341
2738
  }
2342
2739
  export interface VaultWebmcpBinding {
2343
2740
  /**
@@ -2554,7 +2951,7 @@ export interface ItemRetrieveParams {
2554
2951
  */
2555
2952
  wait?: number;
2556
2953
  }
2557
- export type ItemUpdateParams = ItemUpdateParams.CardVaultItemUpdateRequest | ItemUpdateParams.CredentialVaultItemUpdateRequest;
2954
+ export type ItemUpdateParams = ItemUpdateParams.CardVaultItemUpdateRequest | ItemUpdateParams.PaymentRequestVaultItemUpdateRequest | ItemUpdateParams.CredentialVaultItemUpdateRequest;
2558
2955
  export declare namespace ItemUpdateParams {
2559
2956
  interface CardVaultItemUpdateRequest {
2560
2957
  /**
@@ -2575,6 +2972,25 @@ export declare namespace ItemUpdateParams {
2575
2972
  */
2576
2973
  type?: 'card';
2577
2974
  }
2975
+ interface PaymentRequestVaultItemUpdateRequest {
2976
+ /**
2977
+ * Path param
2978
+ */
2979
+ id_or_name: string;
2980
+ /**
2981
+ * Body param: Live Link card request. Test-mode card creation is not supported.
2982
+ * The spec can be changed with PATCH until the card is authorized at a checkout.
2983
+ * Authorize it with the browser at final checkout: Kernel inspects the checkout
2984
+ * through WebMCP and internally chooses a merchant-bound Link Pay Token when
2985
+ * supported or a virtual card otherwise. Callers never receive or choose how the
2986
+ * credential is delivered.
2987
+ */
2988
+ spec: PaymentRequestVaultItemSpec;
2989
+ /**
2990
+ * Body param
2991
+ */
2992
+ type: 'payment_request';
2993
+ }
2578
2994
  interface CredentialVaultItemUpdateRequest {
2579
2995
  /**
2580
2996
  * Path param
@@ -2618,7 +3034,7 @@ export interface ItemEventsParams {
2618
3034
  */
2619
3035
  wait?: number;
2620
3036
  }
2621
- export type ItemPerformOperationParams = ItemPerformOperationParams.AuthorizeVaultItemOperationRequest | ItemPerformOperationParams.RestartVerificationVaultItemOperationRequest | ItemPerformOperationParams.ConfirmTransactionVaultItemOperationRequest | ItemPerformOperationParams.CollectVaultItemOperationRequest | ItemPerformOperationParams.PrepareCheckoutVaultItemOperationRequest | ItemPerformOperationParams.FillVaultItemOperationRequest | ItemPerformOperationParams.ArmPasskeyVaultItemOperationRequest | ItemPerformOperationParams.RegisterPasskeyVaultItemOperationRequest | ItemPerformOperationParams.DisarmPasskeyVaultItemOperationRequest | ItemPerformOperationParams.OnePasswordRequestAccessVaultItemOperationRequest | ItemPerformOperationParams.OnePasswordPollAccessVaultItemOperationRequest | ItemPerformOperationParams.OnePasswordFillVaultItemOperationRequest | ItemPerformOperationParams.OnePasswordRecoverVaultItemOperationRequest | ItemPerformOperationParams.OnePasswordUpdateAccessTokenVaultItemOperationRequest | ItemPerformOperationParams.WebmcpInvokeVaultItemOperationRequest;
3037
+ export type ItemPerformOperationParams = ItemPerformOperationParams.AuthorizeVaultItemOperationRequest | ItemPerformOperationParams.RestartVerificationVaultItemOperationRequest | ItemPerformOperationParams.ConfirmTransactionVaultItemOperationRequest | ItemPerformOperationParams.CollectVaultItemOperationRequest | ItemPerformOperationParams.PrepareCheckoutVaultItemOperationRequest | ItemPerformOperationParams.FillVaultItemOperationRequest | ItemPerformOperationParams.ArmPasskeyVaultItemOperationRequest | ItemPerformOperationParams.RegisterPasskeyVaultItemOperationRequest | ItemPerformOperationParams.DisarmPasskeyVaultItemOperationRequest | ItemPerformOperationParams.OnePasswordRequestAccessVaultItemOperationRequest | ItemPerformOperationParams.OnePasswordPollAccessVaultItemOperationRequest | ItemPerformOperationParams.OnePasswordFillVaultItemOperationRequest | ItemPerformOperationParams.OnePasswordRecoverVaultItemOperationRequest | ItemPerformOperationParams.OnePasswordUpdateAccessTokenVaultItemOperationRequest | ItemPerformOperationParams.WebmcpInvokeVaultItemOperationRequest | ItemPerformOperationParams.AddPaymentMethodVaultItemOperationRequest | ItemPerformOperationParams.RemovePaymentMethodVaultItemOperationRequest;
2622
3038
  export declare namespace ItemPerformOperationParams {
2623
3039
  interface AuthorizeVaultItemOperationRequest {
2624
3040
  /**
@@ -2851,7 +3267,7 @@ export declare namespace ItemPerformOperationParams {
2851
3267
  browser_id: string;
2852
3268
  /**
2853
3269
  * Body param: Exact current top-level page URL. Must match exactly one open page
2854
- * in the browser.
3270
+ * in the browser unless target_id is supplied.
2855
3271
  */
2856
3272
  page_url: string;
2857
3273
  /**
@@ -2863,6 +3279,13 @@ export declare namespace ItemPerformOperationParams {
2863
3279
  * entries have the page's origin.
2864
3280
  */
2865
3281
  entry_id?: string;
3282
+ /**
3283
+ * Body param: CDP target ID of the page to fill, such as tab.target_id from
3284
+ * playwright.execute. Use it when several open pages have page_url. The page's
3285
+ * current URL must equal page_url. Kernel brings the page to the front of its
3286
+ * window before filling.
3287
+ */
3288
+ target_id?: string;
2866
3289
  /**
2867
3290
  * Body param
2868
3291
  */
@@ -2936,8 +3359,32 @@ export declare namespace ItemPerformOperationParams {
2936
3359
  */
2937
3360
  timeout_sec?: number;
2938
3361
  }
3362
+ interface AddPaymentMethodVaultItemOperationRequest {
3363
+ /**
3364
+ * Path param
3365
+ */
3366
+ id_or_name: string;
3367
+ /**
3368
+ * Body param
3369
+ */
3370
+ type: 'add_payment_method';
3371
+ }
3372
+ interface RemovePaymentMethodVaultItemOperationRequest {
3373
+ /**
3374
+ * Path param
3375
+ */
3376
+ id_or_name: string;
3377
+ /**
3378
+ * Body param: ID from the wallet's payment_methods expansion.
3379
+ */
3380
+ payment_method_id: string;
3381
+ /**
3382
+ * Body param
3383
+ */
3384
+ type: 'remove_payment_method';
3385
+ }
2939
3386
  }
2940
- export type ItemUpsertParams = ItemUpsertParams.WalletVaultItemRequest | ItemUpsertParams.CardVaultItemRequest | ItemUpsertParams.CredentialAccountVaultItemRequest | ItemUpsertParams.CredentialVaultItemRequest;
3387
+ export type ItemUpsertParams = ItemUpsertParams.WalletVaultItemRequest | ItemUpsertParams.CardVaultItemRequest | ItemUpsertParams.PaymentRequestVaultItemRequest | ItemUpsertParams.CredentialAccountVaultItemRequest | ItemUpsertParams.CredentialVaultItemRequest;
2941
3388
  export declare namespace ItemUpsertParams {
2942
3389
  interface WalletVaultItemRequest {
2943
3390
  /**
@@ -3116,6 +3563,25 @@ export declare namespace ItemUpsertParams {
3116
3563
  */
3117
3564
  type: 'card';
3118
3565
  }
3566
+ interface PaymentRequestVaultItemRequest {
3567
+ /**
3568
+ * Path param
3569
+ */
3570
+ id_or_name: string;
3571
+ /**
3572
+ * Body param: Live Link card request. Test-mode card creation is not supported.
3573
+ * The spec can be changed with PATCH until the card is authorized at a checkout.
3574
+ * Authorize it with the browser at final checkout: Kernel inspects the checkout
3575
+ * through WebMCP and internally chooses a merchant-bound Link Pay Token when
3576
+ * supported or a virtual card otherwise. Callers never receive or choose how the
3577
+ * credential is delivered.
3578
+ */
3579
+ spec: PaymentRequestVaultItemSpec;
3580
+ /**
3581
+ * Body param
3582
+ */
3583
+ type: 'payment_request';
3584
+ }
3119
3585
  interface CredentialAccountVaultItemRequest {
3120
3586
  /**
3121
3587
  * Path param
@@ -3137,10 +3603,10 @@ export declare namespace ItemUpsertParams {
3137
3603
  id_or_name: string;
3138
3604
  /**
3139
3605
  * Body param: Credential fields are for login and other non-payment credentials.
3140
- * Do not store, collect, or fill credit card data in credential items. Use wallet
3141
- * and card item types for credit cards and payment checkout instead. Field order
3142
- * is preserved in the user-facing collection form, so list fields in the same
3143
- * top-to-bottom order as the website.
3606
+ * Do not store, collect, or fill credit card data in credential items. Use wallet,
3607
+ * payment_request and card item types for credit cards and payment checkout
3608
+ * instead. Field order is preserved in the user-facing collection form, so list
3609
+ * fields in the same top-to-bottom order as the website.
3144
3610
  */
3145
3611
  spec: CredentialVaultItemSpecInput;
3146
3612
  /**
@@ -3150,6 +3616,6 @@ export declare namespace ItemUpsertParams {
3150
3616
  }
3151
3617
  }
3152
3618
  export declare namespace Items {
3153
- export { type AgentcardCheckoutAuthorization as AgentcardCheckoutAuthorization, type AgentcardCheckoutPreparation as AgentcardCheckoutPreparation, type AgentcardPreparedProcessor as AgentcardPreparedProcessor, type ArmPasskeyVaultItemOperationRequest as ArmPasskeyVaultItemOperationRequest, type AuthorizeVaultItemOperationRequest as AuthorizeVaultItemOperationRequest, type CardVaultItemSpec as CardVaultItemSpec, type CardVaultItemState as CardVaultItemState, type CollectVaultItemOperationRequest as CollectVaultItemOperationRequest, type ConfirmTransactionVaultItemOperationRequest as ConfirmTransactionVaultItemOperationRequest, type CredentialAccountVaultItem as CredentialAccountVaultItem, type CredentialAccountVaultItemRequest as CredentialAccountVaultItemRequest, type CredentialCollectionAction as CredentialCollectionAction, type CredentialVaultFieldDefinition as CredentialVaultFieldDefinition, type CredentialVaultFieldDefinitionInput as CredentialVaultFieldDefinitionInput, type CredentialVaultFieldInput as CredentialVaultFieldInput, type CredentialVaultFieldState as CredentialVaultFieldState, type CredentialVaultFieldType as CredentialVaultFieldType, type CredentialVaultFieldUpdate as CredentialVaultFieldUpdate, type CredentialVaultItem as CredentialVaultItem, type CredentialVaultItemRequest as CredentialVaultItemRequest, type CredentialVaultItemSpec as CredentialVaultItemSpec, type CredentialVaultItemSpecInput as CredentialVaultItemSpecInput, type CredentialVaultItemSpecUpdate as CredentialVaultItemSpecUpdate, type CredentialVaultItemState as CredentialVaultItemState, type CredentialVaultItemUpdateRequest as CredentialVaultItemUpdateRequest, type DisarmPasskeyVaultItemOperationRequest as DisarmPasskeyVaultItemOperationRequest, type FillVaultItemOperationRequest as FillVaultItemOperationRequest, type FillVaultItemOperationResult as FillVaultItemOperationResult, type KernelCardState as KernelCardState, type KernelCardVaultItemSpec as KernelCardVaultItemSpec, type KernelCredentialVaultItemSpec as KernelCredentialVaultItemSpec, type KernelCredentialVaultItemSpecInput as KernelCredentialVaultItemSpecInput, type KernelCredentialVaultItemState as KernelCredentialVaultItemState, type KernelWalletState as KernelWalletState, type KernelWalletVaultItemSpec as KernelWalletVaultItemSpec, type LinkShippingAddress as LinkShippingAddress, type LinkUserInfo as LinkUserInfo, type ManagedAuthCredentialVaultField as ManagedAuthCredentialVaultField, type ManagedAuthCredentialVaultItemSpec as ManagedAuthCredentialVaultItemSpec, type ManagedAuthCredentialVaultItemSpecInput as ManagedAuthCredentialVaultItemSpecInput, type ManagedAuthCredentialVaultItemState as ManagedAuthCredentialVaultItemState, type OnePasswordCredentialAccountSpec as OnePasswordCredentialAccountSpec, type OnePasswordCredentialAccountState as OnePasswordCredentialAccountState, type OnePasswordCredentialVaultItemSpec as OnePasswordCredentialVaultItemSpec, type OnePasswordCredentialVaultItemSpecInput as OnePasswordCredentialVaultItemSpecInput, type OnePasswordCredentialVaultItemState as OnePasswordCredentialVaultItemState, type OnePasswordFillVaultItemOperationRequest as OnePasswordFillVaultItemOperationRequest, type OnePasswordFillVaultItemOperationResult as OnePasswordFillVaultItemOperationResult, type OnePasswordOAuthAction as OnePasswordOAuthAction, type OnePasswordRecoverVaultItemOperationRequest as OnePasswordRecoverVaultItemOperationRequest, type OnePasswordRequestAccessVaultItemOperationRequest as OnePasswordRequestAccessVaultItemOperationRequest, type PasskeyVaultItemOperationResult as PasskeyVaultItemOperationResult, type PrepareCheckoutVaultItemOperationRequest as PrepareCheckoutVaultItemOperationRequest, type RegisterPasskeyVaultItemOperationRequest as RegisterPasskeyVaultItemOperationRequest, type RestartVerificationVaultItemOperationRequest as RestartVerificationVaultItemOperationRequest, type VaultCardAliases as VaultCardAliases, type VaultCardFillField as VaultCardFillField, type VaultCheckoutContext as VaultCheckoutContext, type VaultFillField as VaultFillField, type VaultFillFieldResult as VaultFillFieldResult, type VaultItem as VaultItem, type VaultItemAction as VaultItemAction, type VaultItemEvent as VaultItemEvent, type VaultItemOperationResponse as VaultItemOperationResponse, type VaultPaymentMethod as VaultPaymentMethod, type VaultWebmcpBinding as VaultWebmcpBinding, type WalletVaultItemSpec as WalletVaultItemSpec, type WalletVaultItemState as WalletVaultItemState, type WebmcpInvokeVaultItemOperationRequest as WebmcpInvokeVaultItemOperationRequest, type WebmcpInvokeVaultItemOperationResult as WebmcpInvokeVaultItemOperationResult, type ItemListResponse as ItemListResponse, type ItemEventsResponse as ItemEventsResponse, type ItemRetrieveParams as ItemRetrieveParams, type ItemUpdateParams as ItemUpdateParams, type ItemDeleteParams as ItemDeleteParams, type ItemEventsParams as ItemEventsParams, type ItemPerformOperationParams as ItemPerformOperationParams, type ItemUpsertParams as ItemUpsertParams, };
3619
+ export { type AddPaymentMethodVaultItemOperationRequest as AddPaymentMethodVaultItemOperationRequest, type AddPaymentMethodVaultItemOperationResult as AddPaymentMethodVaultItemOperationResult, type AgentcardCheckoutAuthorization as AgentcardCheckoutAuthorization, type AgentcardCheckoutPreparation as AgentcardCheckoutPreparation, type AgentcardPreparedProcessor as AgentcardPreparedProcessor, type ArmPasskeyVaultItemOperationRequest as ArmPasskeyVaultItemOperationRequest, type AuthorizeVaultItemOperationRequest as AuthorizeVaultItemOperationRequest, type CardVaultItemSpec as CardVaultItemSpec, type CardVaultItemState as CardVaultItemState, type CollectVaultItemOperationRequest as CollectVaultItemOperationRequest, type ConfirmTransactionVaultItemOperationRequest as ConfirmTransactionVaultItemOperationRequest, type CredentialAccountVaultItem as CredentialAccountVaultItem, type CredentialAccountVaultItemRequest as CredentialAccountVaultItemRequest, type CredentialCollectionAction as CredentialCollectionAction, type CredentialVaultFieldDefinition as CredentialVaultFieldDefinition, type CredentialVaultFieldDefinitionInput as CredentialVaultFieldDefinitionInput, type CredentialVaultFieldInput as CredentialVaultFieldInput, type CredentialVaultFieldState as CredentialVaultFieldState, type CredentialVaultFieldType as CredentialVaultFieldType, type CredentialVaultFieldUpdate as CredentialVaultFieldUpdate, type CredentialVaultItem as CredentialVaultItem, type CredentialVaultItemRequest as CredentialVaultItemRequest, type CredentialVaultItemSpec as CredentialVaultItemSpec, type CredentialVaultItemSpecInput as CredentialVaultItemSpecInput, type CredentialVaultItemSpecUpdate as CredentialVaultItemSpecUpdate, type CredentialVaultItemState as CredentialVaultItemState, type CredentialVaultItemUpdateRequest as CredentialVaultItemUpdateRequest, type DisarmPasskeyVaultItemOperationRequest as DisarmPasskeyVaultItemOperationRequest, type FillVaultItemOperationRequest as FillVaultItemOperationRequest, type FillVaultItemOperationResult as FillVaultItemOperationResult, type KernelCardState as KernelCardState, type KernelCardVaultItemSpec as KernelCardVaultItemSpec, type KernelCredentialVaultItemSpec as KernelCredentialVaultItemSpec, type KernelCredentialVaultItemSpecInput as KernelCredentialVaultItemSpecInput, type KernelCredentialVaultItemState as KernelCredentialVaultItemState, type KernelPaymentRequestVaultItemSpec as KernelPaymentRequestVaultItemSpec, type KernelWalletState as KernelWalletState, type KernelWalletVaultItemSpec as KernelWalletVaultItemSpec, type LinkShippingAddress as LinkShippingAddress, type LinkUserInfo as LinkUserInfo, type ManagedAuthCredentialVaultField as ManagedAuthCredentialVaultField, type ManagedAuthCredentialVaultItemSpec as ManagedAuthCredentialVaultItemSpec, type ManagedAuthCredentialVaultItemSpecInput as ManagedAuthCredentialVaultItemSpecInput, type ManagedAuthCredentialVaultItemState as ManagedAuthCredentialVaultItemState, type OnePasswordCredentialAccountSpec as OnePasswordCredentialAccountSpec, type OnePasswordCredentialAccountState as OnePasswordCredentialAccountState, type OnePasswordCredentialVaultItemSpec as OnePasswordCredentialVaultItemSpec, type OnePasswordCredentialVaultItemSpecInput as OnePasswordCredentialVaultItemSpecInput, type OnePasswordCredentialVaultItemState as OnePasswordCredentialVaultItemState, type OnePasswordFillVaultItemOperationRequest as OnePasswordFillVaultItemOperationRequest, type OnePasswordFillVaultItemOperationResult as OnePasswordFillVaultItemOperationResult, type OnePasswordOAuthAction as OnePasswordOAuthAction, type OnePasswordRecoverVaultItemOperationRequest as OnePasswordRecoverVaultItemOperationRequest, type OnePasswordRequestAccessVaultItemOperationRequest as OnePasswordRequestAccessVaultItemOperationRequest, type PasskeyVaultItemOperationResult as PasskeyVaultItemOperationResult, type PaymentRequestVaultItem as PaymentRequestVaultItem, type PaymentRequestVaultItemSpec as PaymentRequestVaultItemSpec, type PaymentRequestVaultItemState as PaymentRequestVaultItemState, type PrepareCheckoutVaultItemOperationRequest as PrepareCheckoutVaultItemOperationRequest, type RegisterPasskeyVaultItemOperationRequest as RegisterPasskeyVaultItemOperationRequest, type RemovePaymentMethodVaultItemOperationRequest as RemovePaymentMethodVaultItemOperationRequest, type RemovePaymentMethodVaultItemOperationResult as RemovePaymentMethodVaultItemOperationResult, type RestartVerificationVaultItemOperationRequest as RestartVerificationVaultItemOperationRequest, type VaultCardAliases as VaultCardAliases, type VaultCardFillField as VaultCardFillField, type VaultCheckoutContext as VaultCheckoutContext, type VaultFillField as VaultFillField, type VaultFillFieldResult as VaultFillFieldResult, type VaultItem as VaultItem, type VaultItemAction as VaultItemAction, type VaultItemEvent as VaultItemEvent, type VaultItemOperationResponse as VaultItemOperationResponse, type VaultPaymentMethod as VaultPaymentMethod, type VaultWebmcpBinding as VaultWebmcpBinding, type WalletVaultItemSpec as WalletVaultItemSpec, type WalletVaultItemState as WalletVaultItemState, type WebmcpInvokeVaultItemOperationRequest as WebmcpInvokeVaultItemOperationRequest, type WebmcpInvokeVaultItemOperationResult as WebmcpInvokeVaultItemOperationResult, type ItemListResponse as ItemListResponse, type ItemEventsResponse as ItemEventsResponse, type ItemRetrieveParams as ItemRetrieveParams, type ItemUpdateParams as ItemUpdateParams, type ItemDeleteParams as ItemDeleteParams, type ItemEventsParams as ItemEventsParams, type ItemPerformOperationParams as ItemPerformOperationParams, type ItemUpsertParams as ItemUpsertParams, };
3154
3620
  }
3155
3621
  //# sourceMappingURL=items.d.ts.map