@conto_finance/sdk 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -839,6 +839,311 @@ declare function verifyPurchaseWebhook(input: {
     data: PurchaseEvent;
 };
 
+/**
+ * Shared budgets: one limit that several agents draw on, set in Spending controls.
+ *
+ * `conto.spending` uses an agent key. `admin.spending` is for the budget holder and uses an
+ * organization API key. Exact amounts are decimal strings. These APIs never give agents authority
+ * to raise ceilings.
+ */
+/**
+ * File bytes. `new Blob()`, `new File()` and `new Response()` accept them on every supported
+ * TypeScript, with or without the DOM lib.
+ */
+type DownloadBytes = ReturnType<Uint8Array['slice']> & {
+    readonly buffer: ArrayBuffer;
+};
+type SpendingRequester = {
+    download(path: string): Promise<DownloadBytes>;
+    request<T>(method: string, path: string, body?: Record<string, unknown> | FormData): Promise<T>;
+};
+interface BudgetSnapshot {
+    id: string;
+    name: string;
+    scope: string;
+    currency: string;
+    period: 'ONCE' | 'MONTHLY';
+    periodStart: string;
+    periodEnd: string;
+    authorizationStartsAt?: string;
+    authorizationEndsAt?: string;
+    amount: string;
+    held: string;
+    settled: string;
+    refunded: string;
+    available: string;
+    status: string;
+    isActive: boolean;
+    version: number;
+    requiresTask: boolean;
+    taskRequestId: string | null;
+    participantIds?: string[];
+}
+interface TaskInput {
+    purpose: string;
+    amount: string;
+    currency: string;
+    expiresAt: string;
+    permittedMerchants?: string[];
+    permittedSourceIds?: string[];
+}
+interface TaskSnapshot {
+    id: string;
+    purpose: string;
+    status: string;
+    amount: string;
+    currency: string;
+    expiresAt: string;
+    budgetId: string | null;
+    agentId: string;
+    participantIds: string[];
+    permittedMerchants: string[];
+    permittedSourceIds: string[];
+}
+/** A purchase against shared budgets. These are separate from Commerce `conto.purchases`. */
+interface PurchaseSnapshot {
+    id: string;
+    agentId: string;
+    executionReference: string;
+    sourceType: string;
+    sourceId: string;
+    merchant: string;
+    purpose: string;
+    currency: string;
+    authorizedAmount: string;
+    heldAmount: string;
+    settledAmount: string;
+    refundedAmount: string;
+    status: string;
+    enforcementMode: string;
+    verification: string;
+    nextActions: string[];
+    taskRequestId: string | null;
+    department: string | null;
+    project: string | null;
+    accountingCode: string | null;
+    createdAt: string;
+}
+interface PurchaseDetail extends PurchaseSnapshot {
+    events: Array<{
+        id: string;
+        kind: string;
+        createdAt: string;
+        evidenceRef: string;
+        heldAmount: string;
+        settledAmount: string;
+        refundedAmount: string;
+    }>;
+    evidence: Array<{
+        id: string;
+        filename: string;
+        matchStatus: string;
+        createdAt: string;
+    }>;
+}
+interface PreviewInput {
+    amount: string;
+    currency: string;
+    sourceId: string;
+    merchant: string;
+    purpose?: string;
+    taskRequestId?: string;
+    purchaseKey?: string;
+}
+interface BudgetInput {
+    name: string;
+    scope: 'WORKSPACE' | 'AGENT' | 'AGENTS';
+    participantIds?: string[];
+    amount: string;
+    currency: string;
+    period: 'ONCE' | 'MONTHLY';
+    periodStart: string;
+    periodEnd: string;
+    requiresTask?: boolean;
+}
+declare class SpendingClient {
+    private client;
+    constructor(client: SpendingRequester);
+    /**
+     * CSV of this agent's purchases against budgets in its own organization. Fails with `reasonCode`
+     * `EXPORT_TOO_LARGE` above 10,000 purchases.
+     */
+    exportPurchases(): Promise<DownloadBytes>;
+    downloadEvidence(purchaseId: string, evidenceId: string): Promise<DownloadBytes>;
+    /** The budgets that cover this agent, with what is held, settled and available. */
+    budgets(): Promise<{
+        snapshotAt: string;
+        timezone: string;
+        budgets: BudgetSnapshot[];
+        buyerConnection?: {
+            revoked: boolean;
+            participantId: string;
+        };
+    }>;
+    tasks(cursor?: string): Promise<{
+        tasks: TaskSnapshot[];
+        nextCursor: string | null;
+    }>;
+    /**
+     * Ask the budget holder to approve a task budget. Once it is approved, pass its id as
+     * `context.taskRequestId` on `payments.request()` from a managed wallet, or as `taskRequestId` on
+     * `connectedCards.draw()`. A task's budget applies only to a payment or draw that names the task,
+     * and it stops nothing on other paths.
+     */
+    requestTask(input: TaskInput): Promise<{
+        id: string;
+        status: string;
+        nextActions: string[];
+    }>;
+    /** This agent's purchases against budgets in its own organization. Empty when none has applied. */
+    purchases(cursor?: string): Promise<{
+        purchases: PurchaseSnapshot[];
+        nextCursor: string | null;
+    }>;
+    purchase(purchaseId: string): Promise<PurchaseDetail>;
+    /**
+     * Check a purchase against shared budgets before requesting the payment. It holds nothing and
+     * approves nothing. `sourceId` must be a managed wallet linked to this agent, and `currency` must
+     * be that wallet's stablecoin, such as `USDC` on Base, `USDC.e` on Tempo or `pathUSD` on Tempo
+     * Testnet. A purchase the budgets would refuse throws a `ContoError`.
+     */
+    preview(input: PreviewInput): Promise<{
+        budgetCheck: string;
+        configured: boolean;
+        authorizationGranted: false;
+        scope: "SHARED_BUDGET_ONLY";
+        snapshotAt: string;
+        nextActions: string[];
+    }>;
+    /**
+     * Attach a PDF, PNG or JPEG of at most 2 MiB, with up to 10 files per purchase. Set the Blob's
+     * `type` to `application/pdf`, `image/png` or `image/jpeg`. A Blob with no type, or with a type
+     * that does not match the file's first bytes, fails with `reasonCode` `INVALID_FILE`.
+     */
+    attachEvidence(purchaseId: string, file: Blob, filename: string): Promise<{
+        id: string;
+        matchStatus: string;
+    }>;
+}
+declare class AdminSpendingClient {
+    private client;
+    constructor(client: SpendingRequester);
+    /**
+     * CSV of the organization's purchases against shared budgets. Fails with `reasonCode`
+     * `EXPORT_TOO_LARGE` above 10,000 purchases.
+     */
+    exportPurchases(): Promise<DownloadBytes>;
+    /**
+     * Attach a PDF, PNG or JPEG of at most 2 MiB, with up to 10 files per purchase. Set the Blob's
+     * `type` to `application/pdf`, `image/png` or `image/jpeg`. A Blob with no type, or with a type
+     * that does not match the file's first bytes, fails with `reasonCode` `INVALID_FILE`.
+     */
+    attachEvidence(purchaseId: string, file: Blob, filename: string): Promise<{
+        id: string;
+        matchStatus: string;
+    }>;
+    downloadEvidence(purchaseId: string, evidenceId: string): Promise<DownloadBytes>;
+    budgets(): Promise<{
+        snapshotAt: string;
+        timezone: string;
+        budgets: BudgetSnapshot[];
+        buyerConnection?: {
+            revoked: boolean;
+            participantId: string;
+        };
+    }>;
+    /**
+     * Create a shared budget. Needs an organization API key with `policies:write`.
+     *
+     * While a budget exists, it stops x402, MPP, external wallet payments, agent-to-agent payments,
+     * payment grants, checkout relay, hosted Stripe Link, guarded browser checkout
+     * (`runGuardedCheckout()`), card overlays and checkout checkpoints, including
+     * `checkout.getLinkCard()`, for every agent it covers. A paused, expired or not yet started budget
+     * still stops them. Until its start date, while paused, and after its end date, it also refuses
+     * the managed wallet payments and connected card draws it covers, for those agents. A start date
+     * cannot be changed.
+     * `deleteBudget()` ends a budget. Fails with `reasonCode`
+     * `ENROLLMENT_RECONCILIATION_REQUIRED` while the organization or a participating agent has an
+     * open commitment.
+     */
+    createBudget(input: BudgetInput): Promise<{
+        id: string;
+        version: number;
+    }>;
+    /**
+     * Change a budget's amount or active state, or move its end date to a later time in the future.
+     * Needs the budget's current `version`. A task budget can only change its active state. Pausing
+     * stops new purchases on it, and does not lift what it stops on other payment paths.
+     */
+    updateBudget(budgetId: string, input: {
+        version: number;
+        amount?: string;
+        isActive?: boolean;
+        periodEnd?: string;
+    }): Promise<{
+        id: string;
+        version: number;
+    }>;
+    /**
+     * End a budget, so it stops applying on every path. Needs the budget's current `version`. Fails
+     * with `reasonCode` `BUDGET_HAS_HOLDS` while a purchase holds spend against it, and `TASK_BUDGET`
+     * for a task's budget, which ends by closing the task. A linked buyer with no budget left fails
+     * with `reasonCode` `LINKED_BUDGET_REQUIRED`.
+     */
+    deleteBudget(budgetId: string, input: {
+        version: number;
+    }): Promise<{
+        id: string;
+        deleted: true;
+    }>;
+    tasks(cursor?: string): Promise<{
+        tasks: TaskSnapshot[];
+        nextCursor: string | null;
+    }>;
+    /** Approve, reject or close a task. Needs an organization API key with `policies:write`. */
+    decideTask(taskId: string, input: {
+        decision: 'APPROVE' | 'REJECT' | 'CLOSE';
+        amount?: string;
+        participantIds?: string[];
+    }): Promise<{
+        id: string;
+        status: string;
+    }>;
+    purchases(cursor?: string): Promise<{
+        purchases: PurchaseSnapshot[];
+        nextCursor: string | null;
+    }>;
+    purchase(purchaseId: string): Promise<PurchaseDetail>;
+    /** Record what happened to a purchase. Needs an API key with the `spending:reconcile` scope. */
+    reconcile(purchaseId: string, input: {
+        eventKey: string;
+        kind: 'RELEASED' | 'SETTLED' | 'REFUNDED' | 'UNKNOWN';
+        settledAmount?: string;
+        refundedAmount?: string;
+        final?: boolean;
+        evidenceRef: string;
+    }): Promise<PurchaseSnapshot | null>;
+    accounting(purchaseId: string, input: {
+        department: string | null;
+        project: string | null;
+        accountingCode: string | null;
+    }): Promise<{
+        id: string;
+        department: string | null;
+        project: string | null;
+        accountingCode: string | null;
+    }>;
+    /** Record the amount, currency and merchant on a file. Conto does not take them from the file. */
+    reviewEvidence(purchaseId: string, evidenceId: string, input: {
+        amount: string;
+        currency: string;
+        merchant: string;
+    }): Promise<{
+        id: string;
+        matchStatus: string;
+    }>;
+}
+
 interface ApiErrorMetadata {
     code: string;
     status: number;
@@ -851,6 +1156,8 @@ interface ApiErrorMetadata {
         message: string;
     }>;
     reasons?: string[];
+    reasonCode?: string;
+    nextActions?: string[];
 }
 
 /**
@@ -894,6 +1201,9 @@ declare class ContoAdminError extends Error {
     readonly requestId?: string;
     readonly retryAfter?: number;
     readonly retryGuidance?: string;
+    readonly reasonCode?: string;
+    readonly nextActions?: string[];
+    readonly fieldErrors?: ApiErrorMetadata['fieldErrors'];
     constructor(message: string, metadata: ApiErrorMetadata);
 }
 interface PaginationParams {
@@ -1506,6 +1816,7 @@ declare class ContoAdmin {
     #private;
     private baseUrl;
     private timeout;
+    spending: AdminSpendingClient;
     agents: AgentsClient;
     wallets: WalletsClient;
     cards: AdminCardsClient;
@@ -1523,11 +1834,16 @@ declare class ContoAdmin {
         signal?: AbortSignal;
         lastEventId?: string;
     }): Promise<Response>;
+    /**
+     * Download a file from the Conto API as bytes. It retries like a read, and
+     * failures throw ContoAdminError as request() does.
+     */
+    download(path: string): Promise<DownloadBytes>;
     /**
      * Make an authenticated request to the Conto API. Reads retry. A write retries
      * only when `idempotent` says the API deduplicates it, as purchase creation does.
      */
-    request<T>(method: string, path: string, body?: Record<string, unknown>, options?: {
+    request<T>(method: string, path: string, body?: Record<string, unknown> | FormData, options?: {
         idempotent?: boolean;
     }): Promise<T>;
 }
@@ -1858,6 +2174,13 @@ interface PaymentRequestInput {
             currency?: string;
             dueDate?: string;
         };
+        /** An approved shared budget task, from `conto.spending.requestTask()`. */
+        taskRequestId?: string;
+        /**
+         * A stable id for this purchase against shared budgets. A key cannot be used again, even after
+         * its purchase is released, so use a new key for a new attempt.
+         */
+        purchaseKey?: string;
     };
     /** Specific wallet ID to use (optional) */
     walletId?: string;
@@ -2023,7 +2346,8 @@ interface ExternalWalletApprovalInput {
     recipientName?: string;
     purpose?: string;
     category?: string;
-    context?: PaymentRequestInput['context'];
+    /** A self-custody wallet cannot pay against a shared task, so the task fields are refused. */
+    context?: Omit<NonNullable<PaymentRequestInput['context']>, 'taskRequestId' | 'purchaseKey'>;
 }
 interface ExternalWalletApprovalResult {
     approved: boolean;
@@ -2326,6 +2650,10 @@ interface ConnectedCardDrawInput {
     /** Only USD is supported. Defaults to USD. */
     currency?: 'USD';
     merchant: ConnectedCardDrawMerchant;
+    /** Why the agent wants this purchase, up to 500 characters. Shown to the person reviewing it. */
+    purpose?: string;
+    /** An approved task, for a budget that requires one. Naming a task grants nothing. */
+    taskRequestId?: string;
 }
 /**
  * Live single-use card material returned by {@link ConnectedCardsClient.draw}.
@@ -2355,6 +2683,8 @@ interface ConnectedCardDrawResult {
     replayed: boolean;
     decision: 'APPROVED' | 'DENIED' | 'REQUIRES_APPROVAL';
     reasons: string[];
+    /** Present when a budget refused the draw, for example `TASK_REQUIRED`. */
+    reasonCodes?: string[];
     /** Present when the draw outcome is ambiguous and needs reconciliation. */
     reconciliationRequired?: boolean;
     /**
@@ -2454,6 +2784,8 @@ interface TestCardDrawResult {
     replayed: boolean;
     decision: 'APPROVED' | 'DENIED' | 'REQUIRES_APPROVAL';
     reasons: string[];
+    /** Present when a budget refused the draw, for example `TASK_REQUIRED`. */
+    reasonCodes?: string[];
     reconciliationRequired?: boolean;
     /** Present only on the response that issues it. A replay never returns it again. */
     testCredential?: TestCardCredential;
@@ -2585,7 +2917,10 @@ interface ConfirmCheckoutCheckpointInput {
     currency?: 'USD';
     /** Observed final items. Supplied items are checked even when the total is unchanged. */
     lineItems?: CommerceLineItemInput[];
-    /** Observed final charges. Supplied charges are checked even when the total is unchanged. */
+    /**
+     * Observed final charges, such as subtotal, tax and shipping. Conto checks that the final
+     * total matches. The other rows may differ from the ones passed to begin().
+     */
     totals?: CommerceTotalInput[];
     /** Page where the payment is submitted: the merchant's site or the payment method's. */
     pageUrl?: string;
@@ -2643,6 +2978,33 @@ interface WaitForCheckoutApprovalOptions {
     signal?: AbortSignal;
 }
 
+/**
+ * The Link card request is waiting for the person. Conto has already approved
+ * the purchase, and Link has created the request.
+ */
+interface LinkApprovalEvent {
+    /** The checkpoint Conto approved. */
+    checkpoint: CheckoutCheckpoint;
+    /** The Link spend request id, such as lsrq_... */
+    linkRequestId: string;
+    /**
+     * The Stripe Link page where the person can approve on the web while signed
+     * in to Link, so they do not need the Link app. Only an HTTPS link.com address
+     * is passed. Absent when Link gave none or it did not pass that check. The
+     * person can still approve in the Link app.
+     */
+    approvalUrl?: string;
+    /** When Link stops accepting approval, as an ISO 8601 time, when Link reports it. */
+    approvalExpiresAt?: string;
+}
+/**
+ * Called once when the Link card request is waiting for the person, after
+ * Conto approved the purchase and before the SDK starts waiting. Show
+ * approvalUrl to the person. The SDK does not wait for it to finish, and an
+ * error it throws or rejects with does not affect the purchase. A retry that
+ * resumes a waiting request calls it again with the same URL.
+ */
+type LinkApprovalCallback = (event: LinkApprovalEvent) => void | Promise<void>;
 /**
  * A Link card for one purchase: the checkpoint begin input plus the Link
  * wallet that runs in your environment. The checkout method is always LINK.
@@ -2654,6 +3016,8 @@ interface GetLinkCardInput extends Omit<BeginCheckoutCheckpointInput, 'checkoutM
     ownerApprovalTimeoutMs?: number;
     /** How long to wait for the person to approve in Link. Defaults to 10 minutes. */
     linkApprovalTimeoutMs?: number;
+    /** Called once with the Link approval page when the person needs to approve in Link. */
+    onLinkApproval?: LinkApprovalCallback;
     signal?: AbortSignal;
 }
 /** A new Link card for a changed final total. */
@@ -2667,6 +3031,8 @@ interface ReplaceLinkCardInput {
     totals?: CommerceTotalInput[];
     ownerApprovalTimeoutMs?: number;
     linkApprovalTimeoutMs?: number;
+    /** Called once with the Link approval page when the person needs to approve in Link. */
+    onLinkApproval?: LinkApprovalCallback;
     signal?: AbortSignal;
 }
 interface LinkCardResult {
@@ -3307,6 +3673,8 @@ declare class ContoError extends Error {
     readonly actionUrl?: string;
     readonly fieldErrors?: ApiErrorMetadata['fieldErrors'];
     readonly reasons?: string[];
+    readonly reasonCode?: string;
+    readonly nextActions?: string[];
     readonly diagnostics?: SetupDiagnostics;
     constructor(message: string, metadata: ApiErrorMetadata, diagnostics?: unknown);
 }
@@ -3380,6 +3748,13 @@ declare class CheckoutApprovalTimeoutError extends ContoError {
 declare class LinkCardError extends ContoError {
     readonly checkpoint: CheckoutCheckpoint;
     readonly linkRequestId?: string;
+    /**
+     * The Stripe Link page where the person could approve the request, set when
+     * the SDK stopped while the request was waiting for them. It works only while
+     * the request is still open in Link. When holdReleased is true, Conto has
+     * already cancelled the request.
+     */
+    readonly approvalUrl?: string;
     /** True when Conto cancelled the checkpoint and released the held spend. */
     readonly holdReleased: boolean;
     constructor(input: {
@@ -3387,6 +3762,7 @@ declare class LinkCardError extends ContoError {
         code: string;
         checkpoint: CheckoutCheckpoint;
         linkRequestId?: string;
+        approvalUrl?: string;
         holdReleased: boolean;
         retryGuidance?: string;
     });
@@ -3419,6 +3795,7 @@ declare class Conto {
     private timeout;
     /** Lightweight checkpoints before the payment method opens and before payment. */
     checkout: CheckoutClient;
+    spending: SpendingClient;
     payments: PaymentsClient;
     cards: CardsClient;
     connectedCards: ConnectedCardsClient;
@@ -3516,8 +3893,13 @@ declare class Conto {
         signal?: AbortSignal;
         lastEventId?: string;
     }): Promise<Response>;
+    /**
+     * Download a file from the Conto API as bytes. It retries like a read, and
+     * failures throw ContoError as request() does.
+     */
+    download(path: string): Promise<DownloadBytes>;
     /** Make an authenticated request to the Conto API */
-    request<T>(method: string, path: string, body?: Record<string, unknown>, options?: ContoRequestOptions): Promise<T>;
+    request<T>(method: string, path: string, body?: Record<string, unknown> | FormData, options?: ContoRequestOptions): Promise<T>;
 }
 /** Agent client for the cooperative external-card policy overlay. */
 declare class CardsClient {
@@ -3854,7 +4236,10 @@ declare class CheckoutClient {
      * 1. Conto runs checkpoint 1 and holds the spend. When a rule requires the
      *    owner's approval, this waits for it.
      * 2. Only then does the wallet ask Link for a card for exactly the approved
-     *    amount at this merchant. The person approves it in Link.
+     *    amount at this merchant. Conto records the Link request at once, so the
+     *    hold stays while the card may be usable. The person approves it in
+     *    Link. Pass onLinkApproval to get Link's approval page, so they can
+     *    approve on the web without the Link app.
      * 3. The card is returned. It never reaches Conto.
      *
      * Then fill in the card, call confirm(result.checkpoint, { amountMinor,
@@ -3867,7 +4252,9 @@ declare class CheckoutClient {
      * held spend and throws a LinkCardError. When Conto cannot cancel an open Link
      * request, it keeps the hold and throws LINK_CARD_NOT_CANCELLED with the
      * request id. Retrying with the same input resumes the same checkpoint and
-     * Link request.
+     * Link request while Conto's approval is open. Once the stage is OUTCOME_UNKNOWN,
+     * a retry throws CHECKOUT_CHECKPOINT_NOT_APPROVED: cancel the Link request, then
+     * the checkpoint.
      */
     getLinkCard(input: GetLinkCardInput): Promise<LinkCardResult>;
     /**
@@ -3879,5 +4266,5 @@ declare class CheckoutClient {
     replaceLinkCard(previous: LinkCardResult, input: ReplaceLinkCardInput): Promise<LinkCardResult>;
 }
 
-export { AdminPurchasingClient, BrowserActionFinalizationPendingError, BrowserCheckoutTargetVerificationError, CardsClient, CheckoutApprovalDeniedError, CheckoutApprovalExpiredError, CheckoutApprovalPendingError, CheckoutApprovalTimeoutError, CheckoutCheckpointClosedError, CheckoutClient, ConnectedCardsClient, Conto, ContoAdmin, ContoAdminError, ContoError, ControlledExternalCardPaymentTool, ExternalCardConfirmationPendingError, Conto as Giro, ContoError as GiroError, LinkCardCredential, LinkCardDeniedError, LinkCardError, LinkCardExpiredError, LinkCardTimeoutError, LinkWallet, LinkWalletUnavailableError, OrganizationPurchasesClient, OrganizationRecurringPurchasesClient, PurchasesClient, RecurringPurchasesClient, TestCardsClient, canonicalizeBrowserCheckoutTarget, createVerifiedBrowserCheckoutDriver, Conto as default, fingerprintBrowserCheckoutTarget, isFinalPurchaseStatus, parseServerSentEvents, verifyPurchaseWebhook };
-export type { AdminExternalCardOverlayEnforcement, Agent, AgentCheckoutAction, AgentCheckoutActionKind, AgentExternalCard, AgentSetupResult, AgentStatus, AgentType, AgentWalletLink, ApprovedExternalCardExecution, AssignExternalCardInput, AssignedPolicy, AuthorizeCheckoutActionResult, BeginCheckoutCheckpointInput, BeginCommerceExecutionInput, BrowserActionClaimResult, BrowserActionDispatchObservationInput, BrowserActionFinalizeResult, BrowserCheckoutAction, BrowserCheckoutTargetResolver, BrowserCheckoutTargetSnapshot, BrowserCheckoutTargetVerificationCode, CancellationOutcome, CanonicalBrowserCheckoutTargetSnapshot, ChainType, CheckoutActionAuthorization, CheckoutCheckpoint, CheckoutCheckpointApproval, CheckoutCheckpointMethod, CheckoutCheckpointNextAction, CheckoutCheckpointStage, CheckoutOutcome, CheckoutPaymentReference, CommerceCheckoutMethod, CommerceContextRequirement, CommerceExecution, CommerceExecutionAdapterKind, CommerceExecutionArtifactKind, CommerceExecutionChannel, CommerceExecutionConstraint, CommerceExecutionConstraintCoverage, CommerceExecutionConstraintCoverageLevel, CommerceExecutionDeliveryMode, CommerceExecutionEvidence, CommerceExecutionProvider, CommerceExecutionResult, CommerceExecutionSourceKind, CommerceExecutionStatus, CommerceFactConfidence, CommerceFactProvenanceInput, CommerceFactSource, CommerceFulfillmentInput, CommerceLineItemInput, CommerceProposalFactKey, CommerceProposalMissingFact, CommerceProposalResolution, CommerceProposalState, CommerceSettlementRail, CommerceTotalInput, CommerceTotalType, ComparePolicyVersionsResponse, ConfirmCheckoutCheckpointInput, ConnectedCardBrief, ConnectedCardCredential, ConnectedCardDrawInput, ConnectedCardDrawMerchant, ConnectedCardDrawResult, ConnectedCardDrawable, ConnectedCardListResult, ConnectedCardMandate, ConnectedCardMandateMerchant, ConnectedCardOutcomeReport, ConnectedCardOutcomeReportResult, ConnectedCardReference, ContoAdminConfig, ContoConfig, ContoRequestOptions, ControlledExternalCardPaymentResult, CreateAgentInput, CreatePolicyInput, CreatePolicyRuleInput, CreatePurchaseInput, CreateSdkKeyInput, CreateSdkKeyResult, CreateWalletInput, CustodyType, CustomerCustodyMode, CustomerWalletControlModel, CustomerWalletKeyAccess, DelegationType, ExecuteCommerceExecutionResult, ExternalCard, ExternalCardApprovalInput, ExternalCardApprovalResult, ExternalCardConfirmationInput, ExternalCardConfirmationResult, ExternalCardExecutionClaimResult, ExternalCardExecutionResult, ExternalCardExecutor, ExternalCardOverlayEnforcement, ExternalCardRequestStatusResult, ExternalWalletApprovalInput, ExternalWalletApprovalResult, ExternalWalletConfirmationInput, ExternalWalletConfirmationResult, FreezeAgentInput, GetLinkCardInput, ContoConfig as GiroConfig, GuardCheckoutResult, GuardedBrowserDispatchResult, GuardedCheckoutInput, LinkCardResult, LinkWalletInput, ListAgentsParams, ListAgentsResponse, ListPoliciesParams, ListPoliciesResponse, ListPolicyVersionsResponse, ListWalletsParams, ListWalletsResponse, MppBudgetResult, MppPreAuthorizeInput, MppPreAuthorizeResult, MppRecordInput, MppRecordResult, NormalizeCommerceProposalInput, OrganizationMember, PaginatedResponse, PaginationParams, PauseExternalCardAssignmentResult, PaymentExecuteResult, PaymentRequestInput, PaymentRequestResult, PaymentStatusResult, Policy, PolicyRule, PolicyType, PolicyVersionChangeType, PolicyVersionDetail, PolicyVersionDiff, PolicyVersionFieldChange, PolicyVersionSnapshot, PolicyVersionSnapshotRule, PolicyVersionSummary, PrivilegedBrowserCheckoutDriver, ProtocolBudgetResult, ProtocolPreAuthorizeResult, ProtocolRecordGrant, ProtocolRecordGrantResult, ProtocolServiceSummary, ProtocolServicesResult, ProveWalletOwnershipInput, ProvisionWalletResult, Purchase, PurchaseAction, PurchaseActionAuthority, PurchaseActionKind, PurchaseAllowance, PurchaseBuyer, PurchaseBuyerCompanyCard, PurchaseBuyerCompanyCardLimits, PurchaseBuyerKitchenContext, PurchaseCompanyCard, PurchaseDelegation, PurchaseEvent, PurchaseEventPage, PurchaseEvidence, PurchaseGrocery, PurchaseGroceryItem, PurchaseGroceryList, PurchaseHostedLink, PurchaseItem, PurchaseKitchenContext, PurchaseKitchenInventoryItem, PurchaseKitchenListItem, PurchaseKitchenPreferences, PurchaseKitchenRecipe, PurchaseKitchenUsual, PurchaseList, PurchaseMoney, PurchasePaymentMethod, PurchasePhase, PurchaseRequest, PurchaseResponseAck, PurchaseStatus, PurchasingCapabilities, PurchasingSettings, RecurringPurchase, RecurringPurchaseCycleResult, RecurringPurchaseCycleStatus, RefreshBalanceResult, RegisterExternalCardInput, ReplaceLinkCardInput, ReportCheckoutOutcomeInput, RollbackPolicyVersionResponse, RuleAction, RuleOperator, RuleType, RunGuardedCheckoutResult, SdkKey, SdkKeyType, SetupCapabilityState, SetupCardDiagnostics, SetupDiagnosticAction, SetupDiagnosticIssue, SetupDiagnosticIssueCode, SetupDiagnostics, SetupWalletDiagnostics, TestCardCredential, TestCardDrawResult, TestCardDrawable, TestCardListResult, TestCardReceipt, TestCheckoutInput, TestCheckoutResult, TestMerchant, TestMerchantProduct, UnfreezeAgentInput, UpdateAgentInput, UpdateExternalCardAssignmentInput, UpdatePolicyInput, UpdatePolicyRuleInput, UpdateWalletInput, VerifiedBrowserCheckoutTarget, WaitForCheckoutApprovalOptions, Wallet, WalletChainBalanceSnapshot, WalletOwnershipChallenge, WalletOwnershipProof, WalletStatus, WalletType, WatchPurchaseOptions, X402Authorization, X402BudgetResult, X402PayInput, X402PayResult, X402PaymentRequirements, X402PreAuthorizeInput, X402PreAuthorizeResult, X402RecordInput, X402RecordResult };
+export { AdminPurchasingClient, AdminSpendingClient, BrowserActionFinalizationPendingError, BrowserCheckoutTargetVerificationError, CardsClient, CheckoutApprovalDeniedError, CheckoutApprovalExpiredError, CheckoutApprovalPendingError, CheckoutApprovalTimeoutError, CheckoutCheckpointClosedError, CheckoutClient, ConnectedCardsClient, Conto, ContoAdmin, ContoAdminError, ContoError, ControlledExternalCardPaymentTool, ExternalCardConfirmationPendingError, Conto as Giro, ContoError as GiroError, LinkCardCredential, LinkCardDeniedError, LinkCardError, LinkCardExpiredError, LinkCardTimeoutError, LinkWallet, LinkWalletUnavailableError, OrganizationPurchasesClient, OrganizationRecurringPurchasesClient, PurchasesClient, RecurringPurchasesClient, SpendingClient, TestCardsClient, canonicalizeBrowserCheckoutTarget, createVerifiedBrowserCheckoutDriver, Conto as default, fingerprintBrowserCheckoutTarget, isFinalPurchaseStatus, parseServerSentEvents, verifyPurchaseWebhook };
+export type { AdminExternalCardOverlayEnforcement, Agent, AgentCheckoutAction, AgentCheckoutActionKind, AgentExternalCard, AgentSetupResult, AgentStatus, AgentType, AgentWalletLink, ApprovedExternalCardExecution, AssignExternalCardInput, AssignedPolicy, AuthorizeCheckoutActionResult, BeginCheckoutCheckpointInput, BeginCommerceExecutionInput, BrowserActionClaimResult, BrowserActionDispatchObservationInput, BrowserActionFinalizeResult, BrowserCheckoutAction, BrowserCheckoutTargetResolver, BrowserCheckoutTargetSnapshot, BrowserCheckoutTargetVerificationCode, BudgetInput, BudgetSnapshot, CancellationOutcome, CanonicalBrowserCheckoutTargetSnapshot, ChainType, CheckoutActionAuthorization, CheckoutCheckpoint, CheckoutCheckpointApproval, CheckoutCheckpointMethod, CheckoutCheckpointNextAction, CheckoutCheckpointStage, CheckoutOutcome, CheckoutPaymentReference, CommerceCheckoutMethod, CommerceContextRequirement, CommerceExecution, CommerceExecutionAdapterKind, CommerceExecutionArtifactKind, CommerceExecutionChannel, CommerceExecutionConstraint, CommerceExecutionConstraintCoverage, CommerceExecutionConstraintCoverageLevel, CommerceExecutionDeliveryMode, CommerceExecutionEvidence, CommerceExecutionProvider, CommerceExecutionResult, CommerceExecutionSourceKind, CommerceExecutionStatus, CommerceFactConfidence, CommerceFactProvenanceInput, CommerceFactSource, CommerceFulfillmentInput, CommerceLineItemInput, CommerceProposalFactKey, CommerceProposalMissingFact, CommerceProposalResolution, CommerceProposalState, CommerceSettlementRail, CommerceTotalInput, CommerceTotalType, ComparePolicyVersionsResponse, ConfirmCheckoutCheckpointInput, ConnectedCardBrief, ConnectedCardCredential, ConnectedCardDrawInput, ConnectedCardDrawMerchant, ConnectedCardDrawResult, ConnectedCardDrawable, ConnectedCardListResult, ConnectedCardMandate, ConnectedCardMandateMerchant, ConnectedCardOutcomeReport, ConnectedCardOutcomeReportResult, ConnectedCardReference, ContoAdminConfig, ContoConfig, ContoRequestOptions, ControlledExternalCardPaymentResult, CreateAgentInput, CreatePolicyInput, CreatePolicyRuleInput, CreatePurchaseInput, CreateSdkKeyInput, CreateSdkKeyResult, CreateWalletInput, CustodyType, CustomerCustodyMode, CustomerWalletControlModel, CustomerWalletKeyAccess, DelegationType, DownloadBytes, ExecuteCommerceExecutionResult, ExternalCard, ExternalCardApprovalInput, ExternalCardApprovalResult, ExternalCardConfirmationInput, ExternalCardConfirmationResult, ExternalCardExecutionClaimResult, ExternalCardExecutionResult, ExternalCardExecutor, ExternalCardOverlayEnforcement, ExternalCardRequestStatusResult, ExternalWalletApprovalInput, ExternalWalletApprovalResult, ExternalWalletConfirmationInput, ExternalWalletConfirmationResult, FreezeAgentInput, GetLinkCardInput, ContoConfig as GiroConfig, GuardCheckoutResult, GuardedBrowserDispatchResult, GuardedCheckoutInput, LinkApprovalCallback, LinkApprovalEvent, LinkCardResult, LinkWalletInput, ListAgentsParams, ListAgentsResponse, ListPoliciesParams, ListPoliciesResponse, ListPolicyVersionsResponse, ListWalletsParams, ListWalletsResponse, MppBudgetResult, MppPreAuthorizeInput, MppPreAuthorizeResult, MppRecordInput, MppRecordResult, NormalizeCommerceProposalInput, OrganizationMember, PaginatedResponse, PaginationParams, PauseExternalCardAssignmentResult, PaymentExecuteResult, PaymentRequestInput, PaymentRequestResult, PaymentStatusResult, Policy, PolicyRule, PolicyType, PolicyVersionChangeType, PolicyVersionDetail, PolicyVersionDiff, PolicyVersionFieldChange, PolicyVersionSnapshot, PolicyVersionSnapshotRule, PolicyVersionSummary, PreviewInput, PrivilegedBrowserCheckoutDriver, ProtocolBudgetResult, ProtocolPreAuthorizeResult, ProtocolRecordGrant, ProtocolRecordGrantResult, ProtocolServiceSummary, ProtocolServicesResult, ProveWalletOwnershipInput, ProvisionWalletResult, Purchase, PurchaseAction, PurchaseActionAuthority, PurchaseActionKind, PurchaseAllowance, PurchaseBuyer, PurchaseBuyerCompanyCard, PurchaseBuyerCompanyCardLimits, PurchaseBuyerKitchenContext, PurchaseCompanyCard, PurchaseDelegation, PurchaseDetail, PurchaseEvent, PurchaseEventPage, PurchaseEvidence, PurchaseGrocery, PurchaseGroceryItem, PurchaseGroceryList, PurchaseHostedLink, PurchaseItem, PurchaseKitchenContext, PurchaseKitchenInventoryItem, PurchaseKitchenListItem, PurchaseKitchenPreferences, PurchaseKitchenRecipe, PurchaseKitchenUsual, PurchaseList, PurchaseMoney, PurchasePaymentMethod, PurchasePhase, PurchaseRequest, PurchaseResponseAck, PurchaseSnapshot, PurchaseStatus, PurchasingCapabilities, PurchasingSettings, RecurringPurchase, RecurringPurchaseCycleResult, RecurringPurchaseCycleStatus, RefreshBalanceResult, RegisterExternalCardInput, ReplaceLinkCardInput, ReportCheckoutOutcomeInput, RollbackPolicyVersionResponse, RuleAction, RuleOperator, RuleType, RunGuardedCheckoutResult, SdkKey, SdkKeyType, SetupCapabilityState, SetupCardDiagnostics, SetupDiagnosticAction, SetupDiagnosticIssue, SetupDiagnosticIssueCode, SetupDiagnostics, SetupWalletDiagnostics, SpendingRequester, TaskInput, TaskSnapshot, TestCardCredential, TestCardDrawResult, TestCardDrawable, TestCardListResult, TestCardReceipt, TestCheckoutInput, TestCheckoutResult, TestMerchant, TestMerchantProduct, UnfreezeAgentInput, UpdateAgentInput, UpdateExternalCardAssignmentInput, UpdatePolicyInput, UpdatePolicyRuleInput, UpdateWalletInput, VerifiedBrowserCheckoutTarget, WaitForCheckoutApprovalOptions, Wallet, WalletChainBalanceSnapshot, WalletOwnershipChallenge, WalletOwnershipProof, WalletStatus, WalletType, WatchPurchaseOptions, X402Authorization, X402BudgetResult, X402PayInput, X402PayResult, X402PaymentRequirements, X402PreAuthorizeInput, X402PreAuthorizeResult, X402RecordInput, X402RecordResult };