@conto_finance/sdk 0.5.5 → 0.6.0-beta.2

package/README.md

@@ -27,7 +27,10 @@ drop-in replacement for `ContoAdmin`.
 ## Verify the connection
 
 Requires Node.js 20.19+. Call `await conto.setup()` to inspect your agent, linked wallets,
-effective policies, and scopes without creating a payment.
+effective policies, and scopes without creating a payment. Its `diagnostics` field reports the
+environment, whether the key can request and execute payments, and issues that say whether the
+agent or an owner acts next. See
+[setup diagnostics](https://conto.finance/docs/sdk/installation#setup-diagnostics).
 
 ## Agent SDK Quick Start
 
@@ -57,6 +60,40 @@ if (request.status === 'APPROVED') {
 }
 ```
 
+## Checkout checkpoints
+
+Use `conto.checkout` when your agent runs its own checkout. Call Conto right before the payment
+method opens and again right before the payment is submitted. Conto checks the agent's rules at
+both points and holds the spend in between. Your checkout must stop whenever a call fails.
+
+Checkout checkpoints need SDK 0.6.0-beta.2 or later: `npm install @conto_finance/sdk@beta`.
+
+```typescript
+const checkpoint = await conto.checkout.begin({
+  idempotencyKey: order.id,
+  merchant: { id: 'acme-retail', name: 'ACME Retail', checkoutUrl: page.url() },
+  amountMinor: 7900,
+  purpose: 'Drip coffee maker the shopper chose',
+  lineItems: [{ name: 'Drip coffee maker', quantity: 1, unitAmountMinor: 7900 }],
+});
+// Open Link. The buyer signs in and the final total appears.
+
+const confirmed = await conto.checkout.confirm(checkpoint, {
+  amountMinor: finalTotal,
+  totals: finalTotals, // tax and shipping, if the total changed
+});
+// Submit the payment, then report what happened.
+
+await conto.checkout.reportOutcome(confirmed.id, { outcome: 'PAID', reference: orderNumber });
+```
+
+- If the final total differs from the approved one, `confirm()` starts a new checkpoint at the
+  final total, so the rules check the amount actually paid.
+- `reportOutcome()` accepts `PAID`, `NOT_PAID`, or `UNKNOWN`. Until an outcome arrives, the spend
+  stays counted. Cancel an unconfirmed checkpoint with `conto.checkout.cancel(id)`.
+- Conto records what your checkout reports and does not see the charge. For control at the
+  moment of payment, pay with a Conto-managed wallet or a card Conto authorizes.
+
 ## External-card Policy Overlay
 
 The admin client registers only a masked card alias and assigns cooperative

package/dist/index.d.mts

@@ -739,8 +739,11 @@ declare class AdminCardsClient {
     /** List overlay requests, including executions that need receipt reconciliation. */
     listRequests(input?: ListExternalCardRequestsInput): Promise<ListExternalCardRequestsResponse>;
     /**
-     * Resolve a claimed execution after checking the customer's processor or
-     * receipt. Resolving NOT_EXECUTED releases the reserved policy amount.
+     * @deprecated Resolution requires a signed-in user. SDK admin keys and
+     * organization API keys receive HTTP 403 INSUFFICIENT_PERMISSIONS from this
+     * endpoint. Have a signed-in organization owner or admin review the processor
+     * evidence and resolve the request through Conto's authenticated interface.
+     * Retained for source compatibility; this method does not bypass that restriction.
      */
     resolveRequest(requestId: string, input: ResolveExternalCardRequestInput): Promise<ResolveExternalCardRequestResult>;
     /** Pause the Conto-controlled path and revoke live overlay grants. */
@@ -989,6 +992,8 @@ interface ContoConfig {
     baseUrl?: string;
     /** Request timeout in milliseconds. Defaults to 30000 */
     timeout?: number;
+    /** Defaults for the configured live Link checkout pilot. These are IDs, never Link credentials. */
+    link?: LinkPaymentDefaults;
 }
 interface PaymentRequestInput {
     /** Amount in the wallet chain stablecoin */
@@ -1699,6 +1704,72 @@ interface CommerceFulfillmentInput {
     postalCode?: string;
     countryCode?: string;
 }
+type CheckoutCheckpointMethod = 'LINK' | 'CARD' | 'SHOP_PAY' | 'PAYPAL';
+type CheckoutCheckpointStage = 'APPROVED' | 'CONFIRMING' | 'CONFIRMED' | 'PAID' | 'NOT_PAID' | 'OUTCOME_UNKNOWN' | 'DENIED' | 'CANCELLED' | 'EXPIRED';
+type CheckoutCheckpointNextAction = 'CONFIRM_BEFORE_PAYING' | 'PAY_THEN_REPORT_OUTCOME' | 'REPORT_OUTCOME' | 'WAIT' | 'NONE';
+type CheckoutOutcome = 'PAID' | 'NOT_PAID' | 'UNKNOWN';
+/** First checkpoint: the purchase as the checkout shows it before the payment method opens. */
+interface BeginCheckoutCheckpointInput {
+    /** Stable key for this purchase. Reuse it to retry begin safely. */
+    idempotencyKey: string;
+    merchant: {
+        id: string;
+        name: string;
+        checkoutUrl: string;
+    };
+    /** Integer amount in minor units (cents). */
+    amountMinor: number;
+    currency?: 'USD';
+    purpose: string;
+    /** Optional semantic policy category, such as OFFICE_SUPPLIES. */
+    category?: string;
+    /** Defaults to LINK. */
+    checkoutMethod?: CheckoutCheckpointMethod;
+    lineItems: CommerceLineItemInput[];
+    /** Defaults to one Total entry equal to amountMinor. */
+    totals?: CommerceTotalInput[];
+}
+/** Second checkpoint: the final total shown right before the payment is submitted. */
+interface ConfirmCheckoutCheckpointInput {
+    amountMinor: number;
+    currency?: 'USD';
+    /** Final line items, needed only when the total changed. Defaults to the approved items. */
+    lineItems?: CommerceLineItemInput[];
+    /** Final totals, such as tax and shipping. Defaults to one Total entry. */
+    totals?: CommerceTotalInput[];
+    /** Page where the payment is submitted: the merchant's site or the payment method's. */
+    pageUrl?: string;
+}
+interface ReportCheckoutOutcomeInput {
+    outcome: CheckoutOutcome;
+    /** Merchant order or receipt number. Never a payment credential. */
+    reference?: string;
+}
+interface CheckoutCheckpoint {
+    id: string;
+    idempotencyKey: string;
+    agentId?: string;
+    checkoutMethod: CheckoutCheckpointMethod;
+    stage: CheckoutCheckpointStage;
+    nextAction: CheckoutCheckpointNextAction;
+    amountMinor: number;
+    currency: string;
+    purpose: string;
+    category?: string;
+    merchant: {
+        id: string;
+        name: string;
+        checkoutUrl?: string;
+    };
+    cart: {
+        lineItems: CommerceLineItemInput[];
+        totals: CommerceTotalInput[];
+    };
+    expiresAt: string;
+    outcomeReference?: string;
+    /** Outcomes are reported by your checkout. Conto does not verify settlement here. */
+    settlementVerified: false;
+}
 /** Exact Stripe Link purchase intent evaluated and bound by Conto policy. */
 interface BeginCommerceExecutionCommonInput {
     /** Stable key for this exact intent. Reuse it when reconciling or retrying begin. */
@@ -1740,6 +1811,13 @@ type BeginConnectedLinkExecutionInput = BeginCommerceExecutionCommonInput & {
     paymentMethodId: string;
 };
 type BeginCommerceExecutionInput = (BeginConnectedLinkExecutionInput & {
+    executionMethod: 'LINK_PAY_TOKEN';
+    /** A server-configured digital-goods profile and its checkout URL. */
+    counterparty: {
+        canonicalId: string;
+        checkoutUrl: string;
+    };
+}) | (BeginConnectedLinkExecutionInput & {
     /** Primary path: the server resolves the immutable Stripe seller profile. */
     executionMethod: 'STRIPE_PAYMENT_INTENT';
     counterparty: {
@@ -1783,6 +1861,66 @@ type BeginCommerceExecutionInput = (BeginConnectedLinkExecutionInput & {
         checkoutUrl: string;
     };
 });
+/** Configuration inspection only: no policy evaluation, credential retrieval, or purchase. */
+interface LinkSetupInput {
+    connectionId?: string;
+    paymentMethodId?: string;
+    merchantId?: string;
+}
+interface LinkSetupCheck {
+    code: string;
+    status: 'PASS' | 'BLOCKED' | 'WARNING';
+    actor: 'developer' | 'owner' | 'operator';
+    message: string;
+}
+interface LinkSetupResult {
+    version: 'conto.link-setup.v1';
+    mode: 'LIVE' | 'SIMULATED';
+    configurationStatus: 'CONFIGURED' | 'INCOMPLETE';
+    checks: LinkSetupCheck[];
+    missingScopes: string[];
+    checkout?: {
+        merchantId: string;
+        origin: string;
+        currency: 'USD';
+        maxAmountMinor: number;
+    };
+    paymentAuthorization: 'NOT_EVALUATED';
+    providerVerified: false;
+    settlementVerified: false;
+}
+/** Reusable owner-provisioned identifiers. Per-purchase values can override these defaults. */
+interface LinkPaymentDefaults {
+    connectionId: string;
+    paymentMethodId: string;
+}
+/** Exact purchase facts for a configured USD digital-goods checkout. */
+interface LinkPaymentInput {
+    /** Persist this key before calling pay; reuse it for this exact purchase across restarts. */
+    idempotencyKey: string;
+    connectionId?: string;
+    paymentMethodId?: string;
+    /** Canonical ID of a checkout profile already configured by the deployment operator. */
+    merchantId: string;
+    checkoutUrl: string;
+    amountMinor: number;
+    currency?: 'USD';
+    purpose: string;
+    category?: string;
+    lineItems: CommerceLineItemInput[];
+    /** Required when the final amount differs from the line-item sum. Include the exact total breakdown. */
+    totals?: CommerceTotalInput[];
+}
+type LinkPaymentNextAction = 'APPROVE_IN_LINK' | 'WAIT' | 'RESUME' | 'RECONCILE' | 'NONE';
+/** Safe payment state; submission and completion are not proof of settlement. */
+interface LinkPaymentResult extends CommerceExecutionResult {
+    executionId: string;
+    status: CommerceExecutionStatus;
+    nextAction: LinkPaymentNextAction;
+    /** Present only while Link approval is needed. Show it to the account owner. */
+    approvalUrl?: string;
+    checkout?: ExecuteCommerceExecutionResult['checkout'];
+}
 type CommerceExecutionStatus = 'DRAFT' | 'ACTION_REQUIRED' | 'AUTHORIZING' | 'AWAITING_APPROVAL' | 'READY' | 'PROCESSING' | 'SETTLED' | 'COMPLETED' | 'DENIED' | 'CANCELLED' | 'FAILED' | 'RETURNED' | 'EXPIRED' | 'NEEDS_RECONCILIATION';
 type CommerceExecutionProvider = 'STABLECOIN' | 'TOKENIZED_CARD' | 'STRIPE_LINK';
 type CommerceExecutionChannel = 'BROWSER' | 'MERCHANT_API' | 'CREDENTIAL_BROKER' | 'BANK_API' | 'WALLET_SIGNER';
@@ -2311,7 +2449,14 @@ declare class ContoError extends Error {
     readonly actionUrl?: string;
     readonly fieldErrors?: ApiErrorMetadata['fieldErrors'];
     readonly reasons?: string[];
-    constructor(message: string, metadata: ApiErrorMetadata);
+    readonly diagnostics?: SetupDiagnostics;
+    constructor(message: string, metadata: ApiErrorMetadata, diagnostics?: unknown);
+}
+/** Execution was attempted. Inspect this existing execution before any further payment action. */
+declare class LinkPaymentExecutionError extends ContoError {
+    readonly executionId: string;
+    readonly nextAction: "RECONCILE";
+    constructor(executionId: string, error: unknown);
 }
 /**
  * The customer executor returned a receipt, but Conto did not acknowledge the
@@ -2350,6 +2495,9 @@ declare class Conto {
     #private;
     private baseUrl;
     private timeout;
+    link: LinkClient;
+    /** Lightweight checkpoints before the payment method opens and before payment. */
+    checkout: CheckoutClient;
     payments: PaymentsClient;
     cards: CardsClient;
     connectedCards: ConnectedCardsClient;
@@ -2362,7 +2510,11 @@ declare class Conto {
      * explicitly bound to this agent. No Link token or payment artifact is
      * returned through the agent SDK.
      */
-    listStripeLinkPaymentMethods(connectionId: string): Promise<ListStripeLinkPaymentMethodsResult>;
+    listStripeLinkPaymentMethods(connectionId: string, options?: {
+        mode?: 'TEST' | 'LIVE';
+    }): Promise<ListStripeLinkPaymentMethodsResult>;
+    /** Read live Link configuration diagnostics without retrieving credentials or authorizing payment. */
+    getLinkSetup(input?: LinkSetupInput): Promise<LinkSetupResult>;
     /**
      * Normalize and durably revise a partial agent purchase proposal without
      * creating a payment side effect. Missing facts return as NEEDS_CONTEXT
@@ -2702,4 +2854,57 @@ declare class MppClient {
     }): Promise<ProtocolServicesResult>;
 }
 
-export { type AdminExternalCardOverlayEnforcement, type Agent, type AgentCheckoutAction, type AgentCheckoutActionKind, type AgentExternalCard, type AgentSetupResult, type AgentStatus, type AgentType, type AgentWalletLink, type ApprovedExternalCardExecution, type AssignExternalCardInput, type AssignedPolicy, type AuthorizeCheckoutActionResult, type BeginCommerceExecutionInput, type BrowserActionClaimResult, type BrowserActionDispatchObservationInput, BrowserActionFinalizationPendingError, type BrowserActionFinalizeResult, type BrowserCheckoutAction, type BrowserCheckoutTargetResolver, type BrowserCheckoutTargetSnapshot, type BrowserCheckoutTargetVerificationCode, BrowserCheckoutTargetVerificationError, type CanonicalBrowserCheckoutTargetSnapshot, CardsClient, type ChainType, type CheckoutActionAuthorization, type CommerceCheckoutMethod, type CommerceContextRequirement, type CommerceExecution, type CommerceExecutionAdapterKind, type CommerceExecutionArtifactKind, type CommerceExecutionChannel, type CommerceExecutionConstraint, type CommerceExecutionConstraintCoverage, type CommerceExecutionConstraintCoverageLevel, type CommerceExecutionDeliveryMode, type CommerceExecutionEvidence, type CommerceExecutionProvider, type CommerceExecutionResult, type CommerceExecutionSourceKind, type CommerceExecutionStatus, type CommerceFactConfidence, type CommerceFactProvenanceInput, type CommerceFactSource, type CommerceFulfillmentInput, type CommerceLineItemInput, type CommerceProposalFactKey, type CommerceProposalMissingFact, type CommerceProposalResolution, type CommerceProposalState, type CommerceSettlementRail, type CommerceTotalInput, type CommerceTotalType, type ComparePolicyVersionsResponse, type ConnectedCardBrief, type ConnectedCardCredential, type ConnectedCardDrawInput, type ConnectedCardDrawMerchant, type ConnectedCardDrawResult, type ConnectedCardDrawable, type ConnectedCardListResult, type ConnectedCardMandate, type ConnectedCardMandateMerchant, type ConnectedCardReference, ConnectedCardsClient, Conto, ContoAdmin, type ContoAdminConfig, ContoAdminError, type ContoConfig, ContoError, type ContoRequestOptions, type ControlledExternalCardPaymentResult, ControlledExternalCardPaymentTool, type CreateAgentInput, type CreatePolicyInput, type CreatePolicyRuleInput, type CreateSdkKeyInput, type CreateSdkKeyResult, type CreateWalletInput, type CustodyType, type CustomerCustodyMode, type CustomerWalletControlModel, type CustomerWalletKeyAccess, type DelegationType, type ExecuteCommerceExecutionResult, type ExternalCard, type ExternalCardApprovalInput, type ExternalCardApprovalResult, type ExternalCardConfirmationInput, ExternalCardConfirmationPendingError, type ExternalCardConfirmationResult, type ExternalCardExecutionClaimResult, type ExternalCardExecutionResult, type ExternalCardExecutor, type ExternalCardOverlayEnforcement, type ExternalCardRequestStatusResult, type ExternalWalletApprovalInput, type ExternalWalletApprovalResult, type ExternalWalletConfirmationInput, type ExternalWalletConfirmationResult, type FreezeAgentInput, Conto as Giro, type ContoConfig as GiroConfig, ContoError as GiroError, type GuardCheckoutResult, type GuardedBrowserDispatchResult, type GuardedCheckoutInput, type LinkWalletInput, type ListAgentsParams, type ListAgentsResponse, type ListPoliciesParams, type ListPoliciesResponse, type ListPolicyVersionsResponse, type ListStripeLinkPaymentMethodsResult, type ListWalletsParams, type ListWalletsResponse, type MppBudgetResult, type MppPreAuthorizeInput, type MppPreAuthorizeResult, type MppRecordInput, type MppRecordResult, type NormalizeCommerceProposalInput, type OrganizationMember, type PaginatedResponse, type PaginationParams, type PauseExternalCardAssignmentResult, type PaymentExecuteResult, type PaymentRequestInput, type PaymentRequestResult, type PaymentStatusResult, type Policy, type PolicyRule, type PolicyType, type PolicyVersionChangeType, type PolicyVersionDetail, type PolicyVersionDiff, type PolicyVersionFieldChange, type PolicyVersionSnapshot, type PolicyVersionSnapshotRule, type PolicyVersionSummary, type PrivilegedBrowserCheckoutDriver, type ProtocolBudgetResult, type ProtocolPreAuthorizeResult, type ProtocolRecordGrant, type ProtocolRecordGrantResult, type ProtocolServiceSummary, type ProtocolServicesResult, type ProvisionWalletResult, type RefreshBalanceResult, type RegisterExternalCardInput, type RollbackPolicyVersionResponse, type RuleAction, type RuleOperator, type RuleType, type RunGuardedCheckoutResult, type SdkKey, type SdkKeyType, type SetupCapabilityState, type SetupCardDiagnostics, type SetupDiagnosticAction, type SetupDiagnosticIssue, type SetupDiagnosticIssueCode, type SetupDiagnostics, type SetupWalletDiagnostics, type StripeLinkCheckoutReadiness, type StripeLinkCheckoutReadinessResult, type StripeLinkCheckoutReadinessStatus, type StripeLinkCheckoutVerification, type StripeLinkPaymentMethod, type TestCardCredential, type TestCardDrawResult, type TestCardDrawable, type TestCardListResult, type TestCardReceipt, TestCardsClient, type TestCheckoutInput, type TestCheckoutResult, type TestMerchant, type TestMerchantProduct, type UnfreezeAgentInput, type UpdateAgentInput, type UpdateExternalCardAssignmentInput, type UpdatePolicyInput, type UpdatePolicyRuleInput, type UpdateWalletInput, type VerifiedBrowserCheckoutTarget, type Wallet, type WalletChainBalanceSnapshot, type WalletStatus, type WalletType, type X402Authorization, type X402BudgetResult, type X402PayInput, type X402PayResult, type X402PaymentRequirements, type X402PreAuthorizeInput, type X402PreAuthorizeResult, type X402RecordInput, type X402RecordResult, canonicalizeBrowserCheckoutTarget, createVerifiedBrowserCheckoutDriver, Conto as default, fingerprintBrowserCheckoutTarget };
+/** Narrow transport contract used by the isolated, credential-free test client. */
+type LinkCommerceClient = Pick<Conto, 'getLinkSetup' | 'listStripeLinkPaymentMethods' | 'beginCommerceExecution' | 'getCommerceExecution' | 'refreshCommerceExecution' | 'executeCommerceExecution' | 'cancelCommerceExecution'>;
+/**
+ * Lightweight checkout checkpoints for any agent runtime. Call begin() before the
+ * payment method opens and confirm() right before the payment is submitted. Pay
+ * only after confirm() succeeds, then report the outcome. Conto decides and
+ * records each step; your checkout enforces the answer.
+ */
+declare class CheckoutClient {
+    #private;
+    constructor(client: Pick<Conto, 'request'>);
+    /** First checkpoint. A ContoError means Conto did not approve: stop the checkout. */
+    begin(input: BeginCheckoutCheckpointInput): Promise<CheckoutCheckpoint>;
+    /**
+     * Second checkpoint, right before the payment is submitted. If the total
+     * changed since begin() (tax or shipping, for example), this cancels the
+     * approved checkpoint and starts a new one at the final total, so the agent's
+     * rules see the amount actually being paid. Pay only if this resolves.
+     */
+    confirm(checkpoint: CheckoutCheckpoint, input: ConfirmCheckoutCheckpointInput): Promise<CheckoutCheckpoint>;
+    /** Report what happened after a confirmed checkpoint. Safe to repeat with the same outcome. */
+    reportOutcome(checkpointId: string, input: ReportCheckoutOutcomeInput): Promise<CheckoutCheckpoint>;
+    /** Cancel a checkpoint that was not confirmed and release its spend. */
+    cancel(checkpointId: string): Promise<CheckoutCheckpoint>;
+    get(checkpointId: string): Promise<CheckoutCheckpoint>;
+}
+declare class LinkClient {
+    #private;
+    constructor(client: LinkCommerceClient, defaults?: LinkPaymentDefaults);
+    /** Inspect the configured live path. This is not a payment authorization or provider connectivity test. */
+    setup(input?: LinkSetupInput): Promise<LinkSetupResult>;
+    /** Read masked LIVE funding sources; never selects a source or initiates payment. */
+    paymentMethods(connectionId?: string): Promise<ListStripeLinkPaymentMethodsResult>;
+    /**
+     * Begin one exact intent and execute only if already READY. Otherwise return
+     * the owner's approval action or existing state immediately, without polling.
+     */
+    pay(input: LinkPaymentInput): Promise<LinkPaymentResult>;
+    /**
+     * Continue the existing payment after approval. Reads before any mutation and
+     * never submits an execution already processing or requiring reconciliation.
+     */
+    resume(executionId: string): Promise<LinkPaymentResult>;
+    /** Observe and reconcile provider state. This method never submits a payment. */
+    status(executionId: string): Promise<LinkPaymentResult>;
+    /** Request cancellation of this existing Link payment; never retried automatically. */
+    cancel(executionId: string): Promise<LinkPaymentResult>;
+    private identifier;
+    private assertLinkExecution;
+    private executeIfReady;
+    private result;
+}
+
+export { type AdminExternalCardOverlayEnforcement, type Agent, type AgentCheckoutAction, type AgentCheckoutActionKind, type AgentExternalCard, type AgentSetupResult, type AgentStatus, type AgentType, type AgentWalletLink, type ApprovedExternalCardExecution, type AssignExternalCardInput, type AssignedPolicy, type AuthorizeCheckoutActionResult, type BeginCheckoutCheckpointInput, type BeginCommerceExecutionInput, type BrowserActionClaimResult, type BrowserActionDispatchObservationInput, BrowserActionFinalizationPendingError, type BrowserActionFinalizeResult, type BrowserCheckoutAction, type BrowserCheckoutTargetResolver, type BrowserCheckoutTargetSnapshot, type BrowserCheckoutTargetVerificationCode, BrowserCheckoutTargetVerificationError, type CanonicalBrowserCheckoutTargetSnapshot, CardsClient, type ChainType, type CheckoutActionAuthorization, type CheckoutCheckpoint, type CheckoutCheckpointMethod, type CheckoutCheckpointNextAction, type CheckoutCheckpointStage, CheckoutClient, type CheckoutOutcome, type CommerceCheckoutMethod, type CommerceContextRequirement, type CommerceExecution, type CommerceExecutionAdapterKind, type CommerceExecutionArtifactKind, type CommerceExecutionChannel, type CommerceExecutionConstraint, type CommerceExecutionConstraintCoverage, type CommerceExecutionConstraintCoverageLevel, type CommerceExecutionDeliveryMode, type CommerceExecutionEvidence, type CommerceExecutionProvider, type CommerceExecutionResult, type CommerceExecutionSourceKind, type CommerceExecutionStatus, type CommerceFactConfidence, type CommerceFactProvenanceInput, type CommerceFactSource, type CommerceFulfillmentInput, type CommerceLineItemInput, type CommerceProposalFactKey, type CommerceProposalMissingFact, type CommerceProposalResolution, type CommerceProposalState, type CommerceSettlementRail, type CommerceTotalInput, type CommerceTotalType, type ComparePolicyVersionsResponse, type ConfirmCheckoutCheckpointInput, type ConnectedCardBrief, type ConnectedCardCredential, type ConnectedCardDrawInput, type ConnectedCardDrawMerchant, type ConnectedCardDrawResult, type ConnectedCardDrawable, type ConnectedCardListResult, type ConnectedCardMandate, type ConnectedCardMandateMerchant, type ConnectedCardReference, ConnectedCardsClient, Conto, ContoAdmin, type ContoAdminConfig, ContoAdminError, type ContoConfig, ContoError, type ContoRequestOptions, type ControlledExternalCardPaymentResult, ControlledExternalCardPaymentTool, type CreateAgentInput, type CreatePolicyInput, type CreatePolicyRuleInput, type CreateSdkKeyInput, type CreateSdkKeyResult, type CreateWalletInput, type CustodyType, type CustomerCustodyMode, type CustomerWalletControlModel, type CustomerWalletKeyAccess, type DelegationType, type ExecuteCommerceExecutionResult, type ExternalCard, type ExternalCardApprovalInput, type ExternalCardApprovalResult, type ExternalCardConfirmationInput, ExternalCardConfirmationPendingError, type ExternalCardConfirmationResult, type ExternalCardExecutionClaimResult, type ExternalCardExecutionResult, type ExternalCardExecutor, type ExternalCardOverlayEnforcement, type ExternalCardRequestStatusResult, type ExternalWalletApprovalInput, type ExternalWalletApprovalResult, type ExternalWalletConfirmationInput, type ExternalWalletConfirmationResult, type FreezeAgentInput, Conto as Giro, type ContoConfig as GiroConfig, ContoError as GiroError, type GuardCheckoutResult, type GuardedBrowserDispatchResult, type GuardedCheckoutInput, LinkClient, type LinkCommerceClient, type LinkPaymentDefaults, LinkPaymentExecutionError, type LinkPaymentInput, type LinkPaymentNextAction, type LinkPaymentResult, type LinkSetupCheck, type LinkSetupInput, type LinkSetupResult, type LinkWalletInput, type ListAgentsParams, type ListAgentsResponse, type ListPoliciesParams, type ListPoliciesResponse, type ListPolicyVersionsResponse, type ListStripeLinkPaymentMethodsResult, type ListWalletsParams, type ListWalletsResponse, type MppBudgetResult, type MppPreAuthorizeInput, type MppPreAuthorizeResult, type MppRecordInput, type MppRecordResult, type NormalizeCommerceProposalInput, type OrganizationMember, type PaginatedResponse, type PaginationParams, type PauseExternalCardAssignmentResult, type PaymentExecuteResult, type PaymentRequestInput, type PaymentRequestResult, type PaymentStatusResult, type Policy, type PolicyRule, type PolicyType, type PolicyVersionChangeType, type PolicyVersionDetail, type PolicyVersionDiff, type PolicyVersionFieldChange, type PolicyVersionSnapshot, type PolicyVersionSnapshotRule, type PolicyVersionSummary, type PrivilegedBrowserCheckoutDriver, type ProtocolBudgetResult, type ProtocolPreAuthorizeResult, type ProtocolRecordGrant, type ProtocolRecordGrantResult, type ProtocolServiceSummary, type ProtocolServicesResult, type ProvisionWalletResult, type RefreshBalanceResult, type RegisterExternalCardInput, type ReportCheckoutOutcomeInput, type RollbackPolicyVersionResponse, type RuleAction, type RuleOperator, type RuleType, type RunGuardedCheckoutResult, type SdkKey, type SdkKeyType, type SetupCapabilityState, type SetupCardDiagnostics, type SetupDiagnosticAction, type SetupDiagnosticIssue, type SetupDiagnosticIssueCode, type SetupDiagnostics, type SetupWalletDiagnostics, type StripeLinkCheckoutReadiness, type StripeLinkCheckoutReadinessResult, type StripeLinkCheckoutReadinessStatus, type StripeLinkCheckoutVerification, type StripeLinkPaymentMethod, type TestCardCredential, type TestCardDrawResult, type TestCardDrawable, type TestCardListResult, type TestCardReceipt, TestCardsClient, type TestCheckoutInput, type TestCheckoutResult, type TestMerchant, type TestMerchantProduct, type UnfreezeAgentInput, type UpdateAgentInput, type UpdateExternalCardAssignmentInput, type UpdatePolicyInput, type UpdatePolicyRuleInput, type UpdateWalletInput, type VerifiedBrowserCheckoutTarget, type Wallet, type WalletChainBalanceSnapshot, type WalletStatus, type WalletType, type X402Authorization, type X402BudgetResult, type X402PayInput, type X402PayResult, type X402PaymentRequirements, type X402PreAuthorizeInput, type X402PreAuthorizeResult, type X402RecordInput, type X402RecordResult, canonicalizeBrowserCheckoutTarget, createVerifiedBrowserCheckoutDriver, Conto as default, fingerprintBrowserCheckoutTarget };

package/dist/index.d.ts

@@ -739,8 +739,11 @@ declare class AdminCardsClient {
     /** List overlay requests, including executions that need receipt reconciliation. */
     listRequests(input?: ListExternalCardRequestsInput): Promise<ListExternalCardRequestsResponse>;
     /**
-     * Resolve a claimed execution after checking the customer's processor or
-     * receipt. Resolving NOT_EXECUTED releases the reserved policy amount.
+     * @deprecated Resolution requires a signed-in user. SDK admin keys and
+     * organization API keys receive HTTP 403 INSUFFICIENT_PERMISSIONS from this
+     * endpoint. Have a signed-in organization owner or admin review the processor
+     * evidence and resolve the request through Conto's authenticated interface.
+     * Retained for source compatibility; this method does not bypass that restriction.
      */
     resolveRequest(requestId: string, input: ResolveExternalCardRequestInput): Promise<ResolveExternalCardRequestResult>;
     /** Pause the Conto-controlled path and revoke live overlay grants. */
@@ -989,6 +992,8 @@ interface ContoConfig {
     baseUrl?: string;
     /** Request timeout in milliseconds. Defaults to 30000 */
     timeout?: number;
+    /** Defaults for the configured live Link checkout pilot. These are IDs, never Link credentials. */
+    link?: LinkPaymentDefaults;
 }
 interface PaymentRequestInput {
     /** Amount in the wallet chain stablecoin */
@@ -1699,6 +1704,72 @@ interface CommerceFulfillmentInput {
     postalCode?: string;
     countryCode?: string;
 }
+type CheckoutCheckpointMethod = 'LINK' | 'CARD' | 'SHOP_PAY' | 'PAYPAL';
+type CheckoutCheckpointStage = 'APPROVED' | 'CONFIRMING' | 'CONFIRMED' | 'PAID' | 'NOT_PAID' | 'OUTCOME_UNKNOWN' | 'DENIED' | 'CANCELLED' | 'EXPIRED';
+type CheckoutCheckpointNextAction = 'CONFIRM_BEFORE_PAYING' | 'PAY_THEN_REPORT_OUTCOME' | 'REPORT_OUTCOME' | 'WAIT' | 'NONE';
+type CheckoutOutcome = 'PAID' | 'NOT_PAID' | 'UNKNOWN';
+/** First checkpoint: the purchase as the checkout shows it before the payment method opens. */
+interface BeginCheckoutCheckpointInput {
+    /** Stable key for this purchase. Reuse it to retry begin safely. */
+    idempotencyKey: string;
+    merchant: {
+        id: string;
+        name: string;
+        checkoutUrl: string;
+    };
+    /** Integer amount in minor units (cents). */
+    amountMinor: number;
+    currency?: 'USD';
+    purpose: string;
+    /** Optional semantic policy category, such as OFFICE_SUPPLIES. */
+    category?: string;
+    /** Defaults to LINK. */
+    checkoutMethod?: CheckoutCheckpointMethod;
+    lineItems: CommerceLineItemInput[];
+    /** Defaults to one Total entry equal to amountMinor. */
+    totals?: CommerceTotalInput[];
+}
+/** Second checkpoint: the final total shown right before the payment is submitted. */
+interface ConfirmCheckoutCheckpointInput {
+    amountMinor: number;
+    currency?: 'USD';
+    /** Final line items, needed only when the total changed. Defaults to the approved items. */
+    lineItems?: CommerceLineItemInput[];
+    /** Final totals, such as tax and shipping. Defaults to one Total entry. */
+    totals?: CommerceTotalInput[];
+    /** Page where the payment is submitted: the merchant's site or the payment method's. */
+    pageUrl?: string;
+}
+interface ReportCheckoutOutcomeInput {
+    outcome: CheckoutOutcome;
+    /** Merchant order or receipt number. Never a payment credential. */
+    reference?: string;
+}
+interface CheckoutCheckpoint {
+    id: string;
+    idempotencyKey: string;
+    agentId?: string;
+    checkoutMethod: CheckoutCheckpointMethod;
+    stage: CheckoutCheckpointStage;
+    nextAction: CheckoutCheckpointNextAction;
+    amountMinor: number;
+    currency: string;
+    purpose: string;
+    category?: string;
+    merchant: {
+        id: string;
+        name: string;
+        checkoutUrl?: string;
+    };
+    cart: {
+        lineItems: CommerceLineItemInput[];
+        totals: CommerceTotalInput[];
+    };
+    expiresAt: string;
+    outcomeReference?: string;
+    /** Outcomes are reported by your checkout. Conto does not verify settlement here. */
+    settlementVerified: false;
+}
 /** Exact Stripe Link purchase intent evaluated and bound by Conto policy. */
 interface BeginCommerceExecutionCommonInput {
     /** Stable key for this exact intent. Reuse it when reconciling or retrying begin. */
@@ -1740,6 +1811,13 @@ type BeginConnectedLinkExecutionInput = BeginCommerceExecutionCommonInput & {
     paymentMethodId: string;
 };
 type BeginCommerceExecutionInput = (BeginConnectedLinkExecutionInput & {
+    executionMethod: 'LINK_PAY_TOKEN';
+    /** A server-configured digital-goods profile and its checkout URL. */
+    counterparty: {
+        canonicalId: string;
+        checkoutUrl: string;
+    };
+}) | (BeginConnectedLinkExecutionInput & {
     /** Primary path: the server resolves the immutable Stripe seller profile. */
     executionMethod: 'STRIPE_PAYMENT_INTENT';
     counterparty: {
@@ -1783,6 +1861,66 @@ type BeginCommerceExecutionInput = (BeginConnectedLinkExecutionInput & {
         checkoutUrl: string;
     };
 });
+/** Configuration inspection only: no policy evaluation, credential retrieval, or purchase. */
+interface LinkSetupInput {
+    connectionId?: string;
+    paymentMethodId?: string;
+    merchantId?: string;
+}
+interface LinkSetupCheck {
+    code: string;
+    status: 'PASS' | 'BLOCKED' | 'WARNING';
+    actor: 'developer' | 'owner' | 'operator';
+    message: string;
+}
+interface LinkSetupResult {
+    version: 'conto.link-setup.v1';
+    mode: 'LIVE' | 'SIMULATED';
+    configurationStatus: 'CONFIGURED' | 'INCOMPLETE';
+    checks: LinkSetupCheck[];
+    missingScopes: string[];
+    checkout?: {
+        merchantId: string;
+        origin: string;
+        currency: 'USD';
+        maxAmountMinor: number;
+    };
+    paymentAuthorization: 'NOT_EVALUATED';
+    providerVerified: false;
+    settlementVerified: false;
+}
+/** Reusable owner-provisioned identifiers. Per-purchase values can override these defaults. */
+interface LinkPaymentDefaults {
+    connectionId: string;
+    paymentMethodId: string;
+}
+/** Exact purchase facts for a configured USD digital-goods checkout. */
+interface LinkPaymentInput {
+    /** Persist this key before calling pay; reuse it for this exact purchase across restarts. */
+    idempotencyKey: string;
+    connectionId?: string;
+    paymentMethodId?: string;
+    /** Canonical ID of a checkout profile already configured by the deployment operator. */
+    merchantId: string;
+    checkoutUrl: string;
+    amountMinor: number;
+    currency?: 'USD';
+    purpose: string;
+    category?: string;
+    lineItems: CommerceLineItemInput[];
+    /** Required when the final amount differs from the line-item sum. Include the exact total breakdown. */
+    totals?: CommerceTotalInput[];
+}
+type LinkPaymentNextAction = 'APPROVE_IN_LINK' | 'WAIT' | 'RESUME' | 'RECONCILE' | 'NONE';
+/** Safe payment state; submission and completion are not proof of settlement. */
+interface LinkPaymentResult extends CommerceExecutionResult {
+    executionId: string;
+    status: CommerceExecutionStatus;
+    nextAction: LinkPaymentNextAction;
+    /** Present only while Link approval is needed. Show it to the account owner. */
+    approvalUrl?: string;
+    checkout?: ExecuteCommerceExecutionResult['checkout'];
+}
 type CommerceExecutionStatus = 'DRAFT' | 'ACTION_REQUIRED' | 'AUTHORIZING' | 'AWAITING_APPROVAL' | 'READY' | 'PROCESSING' | 'SETTLED' | 'COMPLETED' | 'DENIED' | 'CANCELLED' | 'FAILED' | 'RETURNED' | 'EXPIRED' | 'NEEDS_RECONCILIATION';
 type CommerceExecutionProvider = 'STABLECOIN' | 'TOKENIZED_CARD' | 'STRIPE_LINK';
 type CommerceExecutionChannel = 'BROWSER' | 'MERCHANT_API' | 'CREDENTIAL_BROKER' | 'BANK_API' | 'WALLET_SIGNER';
@@ -2311,7 +2449,14 @@ declare class ContoError extends Error {
     readonly actionUrl?: string;
     readonly fieldErrors?: ApiErrorMetadata['fieldErrors'];
     readonly reasons?: string[];
-    constructor(message: string, metadata: ApiErrorMetadata);
+    readonly diagnostics?: SetupDiagnostics;
+    constructor(message: string, metadata: ApiErrorMetadata, diagnostics?: unknown);
+}
+/** Execution was attempted. Inspect this existing execution before any further payment action. */
+declare class LinkPaymentExecutionError extends ContoError {
+    readonly executionId: string;
+    readonly nextAction: "RECONCILE";
+    constructor(executionId: string, error: unknown);
 }
 /**
  * The customer executor returned a receipt, but Conto did not acknowledge the
@@ -2350,6 +2495,9 @@ declare class Conto {
     #private;
     private baseUrl;
     private timeout;
+    link: LinkClient;
+    /** Lightweight checkpoints before the payment method opens and before payment. */
+    checkout: CheckoutClient;
     payments: PaymentsClient;
     cards: CardsClient;
     connectedCards: ConnectedCardsClient;
@@ -2362,7 +2510,11 @@ declare class Conto {
      * explicitly bound to this agent. No Link token or payment artifact is
      * returned through the agent SDK.
      */
-    listStripeLinkPaymentMethods(connectionId: string): Promise<ListStripeLinkPaymentMethodsResult>;
+    listStripeLinkPaymentMethods(connectionId: string, options?: {
+        mode?: 'TEST' | 'LIVE';
+    }): Promise<ListStripeLinkPaymentMethodsResult>;
+    /** Read live Link configuration diagnostics without retrieving credentials or authorizing payment. */
+    getLinkSetup(input?: LinkSetupInput): Promise<LinkSetupResult>;
     /**
      * Normalize and durably revise a partial agent purchase proposal without
      * creating a payment side effect. Missing facts return as NEEDS_CONTEXT
@@ -2702,4 +2854,57 @@ declare class MppClient {
     }): Promise<ProtocolServicesResult>;
 }
 
-export { type AdminExternalCardOverlayEnforcement, type Agent, type AgentCheckoutAction, type AgentCheckoutActionKind, type AgentExternalCard, type AgentSetupResult, type AgentStatus, type AgentType, type AgentWalletLink, type ApprovedExternalCardExecution, type AssignExternalCardInput, type AssignedPolicy, type AuthorizeCheckoutActionResult, type BeginCommerceExecutionInput, type BrowserActionClaimResult, type BrowserActionDispatchObservationInput, BrowserActionFinalizationPendingError, type BrowserActionFinalizeResult, type BrowserCheckoutAction, type BrowserCheckoutTargetResolver, type BrowserCheckoutTargetSnapshot, type BrowserCheckoutTargetVerificationCode, BrowserCheckoutTargetVerificationError, type CanonicalBrowserCheckoutTargetSnapshot, CardsClient, type ChainType, type CheckoutActionAuthorization, type CommerceCheckoutMethod, type CommerceContextRequirement, type CommerceExecution, type CommerceExecutionAdapterKind, type CommerceExecutionArtifactKind, type CommerceExecutionChannel, type CommerceExecutionConstraint, type CommerceExecutionConstraintCoverage, type CommerceExecutionConstraintCoverageLevel, type CommerceExecutionDeliveryMode, type CommerceExecutionEvidence, type CommerceExecutionProvider, type CommerceExecutionResult, type CommerceExecutionSourceKind, type CommerceExecutionStatus, type CommerceFactConfidence, type CommerceFactProvenanceInput, type CommerceFactSource, type CommerceFulfillmentInput, type CommerceLineItemInput, type CommerceProposalFactKey, type CommerceProposalMissingFact, type CommerceProposalResolution, type CommerceProposalState, type CommerceSettlementRail, type CommerceTotalInput, type CommerceTotalType, type ComparePolicyVersionsResponse, type ConnectedCardBrief, type ConnectedCardCredential, type ConnectedCardDrawInput, type ConnectedCardDrawMerchant, type ConnectedCardDrawResult, type ConnectedCardDrawable, type ConnectedCardListResult, type ConnectedCardMandate, type ConnectedCardMandateMerchant, type ConnectedCardReference, ConnectedCardsClient, Conto, ContoAdmin, type ContoAdminConfig, ContoAdminError, type ContoConfig, ContoError, type ContoRequestOptions, type ControlledExternalCardPaymentResult, ControlledExternalCardPaymentTool, type CreateAgentInput, type CreatePolicyInput, type CreatePolicyRuleInput, type CreateSdkKeyInput, type CreateSdkKeyResult, type CreateWalletInput, type CustodyType, type CustomerCustodyMode, type CustomerWalletControlModel, type CustomerWalletKeyAccess, type DelegationType, type ExecuteCommerceExecutionResult, type ExternalCard, type ExternalCardApprovalInput, type ExternalCardApprovalResult, type ExternalCardConfirmationInput, ExternalCardConfirmationPendingError, type ExternalCardConfirmationResult, type ExternalCardExecutionClaimResult, type ExternalCardExecutionResult, type ExternalCardExecutor, type ExternalCardOverlayEnforcement, type ExternalCardRequestStatusResult, type ExternalWalletApprovalInput, type ExternalWalletApprovalResult, type ExternalWalletConfirmationInput, type ExternalWalletConfirmationResult, type FreezeAgentInput, Conto as Giro, type ContoConfig as GiroConfig, ContoError as GiroError, type GuardCheckoutResult, type GuardedBrowserDispatchResult, type GuardedCheckoutInput, type LinkWalletInput, type ListAgentsParams, type ListAgentsResponse, type ListPoliciesParams, type ListPoliciesResponse, type ListPolicyVersionsResponse, type ListStripeLinkPaymentMethodsResult, type ListWalletsParams, type ListWalletsResponse, type MppBudgetResult, type MppPreAuthorizeInput, type MppPreAuthorizeResult, type MppRecordInput, type MppRecordResult, type NormalizeCommerceProposalInput, type OrganizationMember, type PaginatedResponse, type PaginationParams, type PauseExternalCardAssignmentResult, type PaymentExecuteResult, type PaymentRequestInput, type PaymentRequestResult, type PaymentStatusResult, type Policy, type PolicyRule, type PolicyType, type PolicyVersionChangeType, type PolicyVersionDetail, type PolicyVersionDiff, type PolicyVersionFieldChange, type PolicyVersionSnapshot, type PolicyVersionSnapshotRule, type PolicyVersionSummary, type PrivilegedBrowserCheckoutDriver, type ProtocolBudgetResult, type ProtocolPreAuthorizeResult, type ProtocolRecordGrant, type ProtocolRecordGrantResult, type ProtocolServiceSummary, type ProtocolServicesResult, type ProvisionWalletResult, type RefreshBalanceResult, type RegisterExternalCardInput, type RollbackPolicyVersionResponse, type RuleAction, type RuleOperator, type RuleType, type RunGuardedCheckoutResult, type SdkKey, type SdkKeyType, type SetupCapabilityState, type SetupCardDiagnostics, type SetupDiagnosticAction, type SetupDiagnosticIssue, type SetupDiagnosticIssueCode, type SetupDiagnostics, type SetupWalletDiagnostics, type StripeLinkCheckoutReadiness, type StripeLinkCheckoutReadinessResult, type StripeLinkCheckoutReadinessStatus, type StripeLinkCheckoutVerification, type StripeLinkPaymentMethod, type TestCardCredential, type TestCardDrawResult, type TestCardDrawable, type TestCardListResult, type TestCardReceipt, TestCardsClient, type TestCheckoutInput, type TestCheckoutResult, type TestMerchant, type TestMerchantProduct, type UnfreezeAgentInput, type UpdateAgentInput, type UpdateExternalCardAssignmentInput, type UpdatePolicyInput, type UpdatePolicyRuleInput, type UpdateWalletInput, type VerifiedBrowserCheckoutTarget, type Wallet, type WalletChainBalanceSnapshot, type WalletStatus, type WalletType, type X402Authorization, type X402BudgetResult, type X402PayInput, type X402PayResult, type X402PaymentRequirements, type X402PreAuthorizeInput, type X402PreAuthorizeResult, type X402RecordInput, type X402RecordResult, canonicalizeBrowserCheckoutTarget, createVerifiedBrowserCheckoutDriver, Conto as default, fingerprintBrowserCheckoutTarget };
+/** Narrow transport contract used by the isolated, credential-free test client. */
+type LinkCommerceClient = Pick<Conto, 'getLinkSetup' | 'listStripeLinkPaymentMethods' | 'beginCommerceExecution' | 'getCommerceExecution' | 'refreshCommerceExecution' | 'executeCommerceExecution' | 'cancelCommerceExecution'>;
+/**
+ * Lightweight checkout checkpoints for any agent runtime. Call begin() before the
+ * payment method opens and confirm() right before the payment is submitted. Pay
+ * only after confirm() succeeds, then report the outcome. Conto decides and
+ * records each step; your checkout enforces the answer.
+ */
+declare class CheckoutClient {
+    #private;
+    constructor(client: Pick<Conto, 'request'>);
+    /** First checkpoint. A ContoError means Conto did not approve: stop the checkout. */
+    begin(input: BeginCheckoutCheckpointInput): Promise<CheckoutCheckpoint>;
+    /**
+     * Second checkpoint, right before the payment is submitted. If the total
+     * changed since begin() (tax or shipping, for example), this cancels the
+     * approved checkpoint and starts a new one at the final total, so the agent's
+     * rules see the amount actually being paid. Pay only if this resolves.
+     */
+    confirm(checkpoint: CheckoutCheckpoint, input: ConfirmCheckoutCheckpointInput): Promise<CheckoutCheckpoint>;
+    /** Report what happened after a confirmed checkpoint. Safe to repeat with the same outcome. */
+    reportOutcome(checkpointId: string, input: ReportCheckoutOutcomeInput): Promise<CheckoutCheckpoint>;
+    /** Cancel a checkpoint that was not confirmed and release its spend. */
+    cancel(checkpointId: string): Promise<CheckoutCheckpoint>;
+    get(checkpointId: string): Promise<CheckoutCheckpoint>;
+}
+declare class LinkClient {
+    #private;
+    constructor(client: LinkCommerceClient, defaults?: LinkPaymentDefaults);
+    /** Inspect the configured live path. This is not a payment authorization or provider connectivity test. */
+    setup(input?: LinkSetupInput): Promise<LinkSetupResult>;
+    /** Read masked LIVE funding sources; never selects a source or initiates payment. */
+    paymentMethods(connectionId?: string): Promise<ListStripeLinkPaymentMethodsResult>;
+    /**
+     * Begin one exact intent and execute only if already READY. Otherwise return
+     * the owner's approval action or existing state immediately, without polling.
+     */
+    pay(input: LinkPaymentInput): Promise<LinkPaymentResult>;
+    /**
+     * Continue the existing payment after approval. Reads before any mutation and
+     * never submits an execution already processing or requiring reconciliation.
+     */
+    resume(executionId: string): Promise<LinkPaymentResult>;
+    /** Observe and reconcile provider state. This method never submits a payment. */
+    status(executionId: string): Promise<LinkPaymentResult>;
+    /** Request cancellation of this existing Link payment; never retried automatically. */
+    cancel(executionId: string): Promise<LinkPaymentResult>;
+    private identifier;
+    private assertLinkExecution;
+    private executeIfReady;
+    private result;
+}
+
+export { type AdminExternalCardOverlayEnforcement, type Agent, type AgentCheckoutAction, type AgentCheckoutActionKind, type AgentExternalCard, type AgentSetupResult, type AgentStatus, type AgentType, type AgentWalletLink, type ApprovedExternalCardExecution, type AssignExternalCardInput, type AssignedPolicy, type AuthorizeCheckoutActionResult, type BeginCheckoutCheckpointInput, type BeginCommerceExecutionInput, type BrowserActionClaimResult, type BrowserActionDispatchObservationInput, BrowserActionFinalizationPendingError, type BrowserActionFinalizeResult, type BrowserCheckoutAction, type BrowserCheckoutTargetResolver, type BrowserCheckoutTargetSnapshot, type BrowserCheckoutTargetVerificationCode, BrowserCheckoutTargetVerificationError, type CanonicalBrowserCheckoutTargetSnapshot, CardsClient, type ChainType, type CheckoutActionAuthorization, type CheckoutCheckpoint, type CheckoutCheckpointMethod, type CheckoutCheckpointNextAction, type CheckoutCheckpointStage, CheckoutClient, type CheckoutOutcome, type CommerceCheckoutMethod, type CommerceContextRequirement, type CommerceExecution, type CommerceExecutionAdapterKind, type CommerceExecutionArtifactKind, type CommerceExecutionChannel, type CommerceExecutionConstraint, type CommerceExecutionConstraintCoverage, type CommerceExecutionConstraintCoverageLevel, type CommerceExecutionDeliveryMode, type CommerceExecutionEvidence, type CommerceExecutionProvider, type CommerceExecutionResult, type CommerceExecutionSourceKind, type CommerceExecutionStatus, type CommerceFactConfidence, type CommerceFactProvenanceInput, type CommerceFactSource, type CommerceFulfillmentInput, type CommerceLineItemInput, type CommerceProposalFactKey, type CommerceProposalMissingFact, type CommerceProposalResolution, type CommerceProposalState, type CommerceSettlementRail, type CommerceTotalInput, type CommerceTotalType, type ComparePolicyVersionsResponse, type ConfirmCheckoutCheckpointInput, type ConnectedCardBrief, type ConnectedCardCredential, type ConnectedCardDrawInput, type ConnectedCardDrawMerchant, type ConnectedCardDrawResult, type ConnectedCardDrawable, type ConnectedCardListResult, type ConnectedCardMandate, type ConnectedCardMandateMerchant, type ConnectedCardReference, ConnectedCardsClient, Conto, ContoAdmin, type ContoAdminConfig, ContoAdminError, type ContoConfig, ContoError, type ContoRequestOptions, type ControlledExternalCardPaymentResult, ControlledExternalCardPaymentTool, type CreateAgentInput, type CreatePolicyInput, type CreatePolicyRuleInput, type CreateSdkKeyInput, type CreateSdkKeyResult, type CreateWalletInput, type CustodyType, type CustomerCustodyMode, type CustomerWalletControlModel, type CustomerWalletKeyAccess, type DelegationType, type ExecuteCommerceExecutionResult, type ExternalCard, type ExternalCardApprovalInput, type ExternalCardApprovalResult, type ExternalCardConfirmationInput, ExternalCardConfirmationPendingError, type ExternalCardConfirmationResult, type ExternalCardExecutionClaimResult, type ExternalCardExecutionResult, type ExternalCardExecutor, type ExternalCardOverlayEnforcement, type ExternalCardRequestStatusResult, type ExternalWalletApprovalInput, type ExternalWalletApprovalResult, type ExternalWalletConfirmationInput, type ExternalWalletConfirmationResult, type FreezeAgentInput, Conto as Giro, type ContoConfig as GiroConfig, ContoError as GiroError, type GuardCheckoutResult, type GuardedBrowserDispatchResult, type GuardedCheckoutInput, LinkClient, type LinkCommerceClient, type LinkPaymentDefaults, LinkPaymentExecutionError, type LinkPaymentInput, type LinkPaymentNextAction, type LinkPaymentResult, type LinkSetupCheck, type LinkSetupInput, type LinkSetupResult, type LinkWalletInput, type ListAgentsParams, type ListAgentsResponse, type ListPoliciesParams, type ListPoliciesResponse, type ListPolicyVersionsResponse, type ListStripeLinkPaymentMethodsResult, type ListWalletsParams, type ListWalletsResponse, type MppBudgetResult, type MppPreAuthorizeInput, type MppPreAuthorizeResult, type MppRecordInput, type MppRecordResult, type NormalizeCommerceProposalInput, type OrganizationMember, type PaginatedResponse, type PaginationParams, type PauseExternalCardAssignmentResult, type PaymentExecuteResult, type PaymentRequestInput, type PaymentRequestResult, type PaymentStatusResult, type Policy, type PolicyRule, type PolicyType, type PolicyVersionChangeType, type PolicyVersionDetail, type PolicyVersionDiff, type PolicyVersionFieldChange, type PolicyVersionSnapshot, type PolicyVersionSnapshotRule, type PolicyVersionSummary, type PrivilegedBrowserCheckoutDriver, type ProtocolBudgetResult, type ProtocolPreAuthorizeResult, type ProtocolRecordGrant, type ProtocolRecordGrantResult, type ProtocolServiceSummary, type ProtocolServicesResult, type ProvisionWalletResult, type RefreshBalanceResult, type RegisterExternalCardInput, type ReportCheckoutOutcomeInput, type RollbackPolicyVersionResponse, type RuleAction, type RuleOperator, type RuleType, type RunGuardedCheckoutResult, type SdkKey, type SdkKeyType, type SetupCapabilityState, type SetupCardDiagnostics, type SetupDiagnosticAction, type SetupDiagnosticIssue, type SetupDiagnosticIssueCode, type SetupDiagnostics, type SetupWalletDiagnostics, type StripeLinkCheckoutReadiness, type StripeLinkCheckoutReadinessResult, type StripeLinkCheckoutReadinessStatus, type StripeLinkCheckoutVerification, type StripeLinkPaymentMethod, type TestCardCredential, type TestCardDrawResult, type TestCardDrawable, type TestCardListResult, type TestCardReceipt, TestCardsClient, type TestCheckoutInput, type TestCheckoutResult, type TestMerchant, type TestMerchantProduct, type UnfreezeAgentInput, type UpdateAgentInput, type UpdateExternalCardAssignmentInput, type UpdatePolicyInput, type UpdatePolicyRuleInput, type UpdateWalletInput, type VerifiedBrowserCheckoutTarget, type Wallet, type WalletChainBalanceSnapshot, type WalletStatus, type WalletType, type X402Authorization, type X402BudgetResult, type X402PayInput, type X402PayResult, type X402PaymentRequirements, type X402PreAuthorizeInput, type X402PreAuthorizeResult, type X402RecordInput, type X402RecordResult, canonicalizeBrowserCheckoutTarget, createVerifiedBrowserCheckoutDriver, Conto as default, fingerprintBrowserCheckoutTarget };