@conto_finance/sdk 0.8.1 → 0.8.2

package/README.md

@@ -250,12 +250,16 @@ await admin.spending.createBudget({
 });
 ```
 
+**Checkouts hold on a budget.** Checkout checkpoints, including `checkout.getLinkCard()`, and guarded
+browser checkout (`runGuardedCheckout()`) hold spend against each budget that covers the agent. Reported
+paid settles it, and closing unpaid gives it back. The agent runs the checkout, so Conto declines
+approval at the limit, and a payment made without asking Conto is not counted.
+
 **A budget stops other payment paths.** While it 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, a budget also refuses the
-managed wallet payments and connected card draws it covers, for those agents. A task's budget stops nothing on other paths. It applies only to a managed wallet payment or connected card draw that names the task, and it refuses that payment or draw while it is paused.
+payments, agent-to-agent payments, payment grants, checkout relay, hosted Stripe Link and card overlays,
+for every agent it covers. A paused or expired budget still stops them. While paused and after its end
+date, a budget also refuses the managed wallet payments, connected card draws and checkouts it covers,
+for those agents. A task's budget stops nothing on other paths. It applies only to a managed wallet payment or connected card draw that names the task, and it refuses that payment or draw while it is paused.
 `updateBudget()` can resume a paused budget or extend an
 expired one, and a start date cannot be changed. To end a budget, call `admin.spending.deleteBudget(id, { version })`. It fails with
 `reasonCode` `BUDGET_HAS_HOLDS` while a purchase holds spend against the budget. Try a budget first on one agent with a Tempo Testnet wallet.
@@ -294,7 +298,7 @@ expired one, and a start date cannot be changed. To end a budget, call `admin.sp
   purchases.
 - Most budget errors have `code` `POLICY_VIOLATION`, so read `reasonCode` on `ContoError` and
   `ContoAdminError`. Some also have `nextActions`, such as `SHARED_BUDGET_EXCEEDED` with
-  `REQUEST_BUDGET_INCREASE`. `checkout.begin()`, `getLinkCard()` and `replaceLinkCard()` have `code` `CHECKPOINT_BUDGET_NOT_SUPPORTED` and `reasonCode` `EXECUTION_PATH_NOT_CONNECTED`. `payments.execute()` has `code`
+  `REQUEST_BUDGET_INCREASE`. A refused `checkout.begin()`, `getLinkCard()` or `replaceLinkCard()` closes the checkpoint, so use a new `idempotencyKey`. `payments.execute()` has `code`
   `SHARED_BUDGET_BLOCKED` and no `reasonCode`.
 - A `VALIDATION_ERROR` on a spending call usually lists the fields in `fieldErrors`. It does not when
   the call got a field it does not accept, such as `periodStart` or `currency` on `updateBudget()`. A

package/dist/index.d.mts

@@ -1055,16 +1055,16 @@ declare class AdminSpendingClient {
     /**
      * Create a shared budget. Needs an organization API key with `policies:write`.
      *
+     * Checkout checkpoints, including `checkout.getLinkCard()`, and guarded browser checkout
+     * (`runGuardedCheckout()`) hold spend against each budget that covers the agent.
+     *
      * 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.
+     * payment grants, checkout relay, hosted Stripe Link and card overlays, for every agent it covers.
+     * A paused or expired budget still stops them. While paused and after its end date, it also
+     * refuses the managed wallet payments, connected card draws and checkouts it covers, for those
+     * agents. A start date cannot be changed.
+     * `deleteBudget()` ends a budget. Fails with `reasonCode` `BUDGET_HAS_HOLDS` while a purchase holds
+     * spend against it.
      */
     createBudget(input: BudgetInput): Promise<{
         id: string;

package/dist/index.d.ts

@@ -1055,16 +1055,16 @@ declare class AdminSpendingClient {
     /**
      * Create a shared budget. Needs an organization API key with `policies:write`.
      *
+     * Checkout checkpoints, including `checkout.getLinkCard()`, and guarded browser checkout
+     * (`runGuardedCheckout()`) hold spend against each budget that covers the agent.
+     *
      * 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.
+     * payment grants, checkout relay, hosted Stripe Link and card overlays, for every agent it covers.
+     * A paused or expired budget still stops them. While paused and after its end date, it also
+     * refuses the managed wallet payments, connected card draws and checkouts it covers, for those
+     * agents. A start date cannot be changed.
+     * `deleteBudget()` ends a budget. Fails with `reasonCode` `BUDGET_HAS_HOLDS` while a purchase holds
+     * spend against it.
      */
     createBudget(input: BudgetInput): Promise<{
         id: string;

package/dist/index.js

@@ -47,7 +47,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@conto_finance/sdk",
-      version: "0.8.1",
+      version: "0.8.2",
       description: "Conto SDK for AI agent payment authorization",
       main: "./dist/index.js",
       module: "./dist/index.mjs",
@@ -804,16 +804,16 @@ var AdminSpendingClient = class {
   /**
    * Create a shared budget. Needs an organization API key with `policies:write`.
    *
+   * Checkout checkpoints, including `checkout.getLinkCard()`, and guarded browser checkout
+   * (`runGuardedCheckout()`) hold spend against each budget that covers the agent.
+   *
    * 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.
+   * payment grants, checkout relay, hosted Stripe Link and card overlays, for every agent it covers.
+   * A paused or expired budget still stops them. While paused and after its end date, it also
+   * refuses the managed wallet payments, connected card draws and checkouts it covers, for those
+   * agents. A start date cannot be changed.
+   * `deleteBudget()` ends a budget. Fails with `reasonCode` `BUDGET_HAS_HOLDS` while a purchase holds
+   * spend against it.
    */
   createBudget(input) {
     return this.client.request("POST", "/api/spending/budgets", {
@@ -1110,12 +1110,18 @@ function responseErrorMessage(_data, status) {
 }
 var SHARED_REASON_CODES = /* @__PURE__ */ new Set([
   "AGENT_NOT_AUTHORIZED",
+  "AGENT_LIMIT_EXCEEDED",
   "AGENT_UNAVAILABLE",
+  "BUDGET_CHANGE_NOT_ALLOWED",
   "BUDGET_CURRENCY_UNSUPPORTED",
   "BUDGET_EXPIRED",
   "BUDGET_HAS_HOLDS",
+  "BUDGET_METHOD_NOT_ALLOWED",
   "BUDGET_PAUSED",
+  "BUDGET_SOURCE_NOT_ATTACHED",
   "BUYER_LINK_REVOKED",
+  "CATEGORY_NOT_AUTHORIZED",
+  "CATEGORY_UNKNOWN",
   "DUPLICATE_PURCHASE",
   "ENROLLMENT_RECONCILIATION_REQUIRED",
   "EVIDENCE_CONFLICT",
@@ -1124,6 +1130,7 @@ var SHARED_REASON_CODES = /* @__PURE__ */ new Set([
   "EXECUTION_PATH_NOT_CONNECTED",
   "EXPORT_TOO_LARGE",
   "INVALID_AMOUNT",
+  "INVALID_BUDGET",
   "INVALID_EXPIRY",
   "INVALID_FILE",
   "INVALID_PARTICIPANTS",
@@ -1132,6 +1139,7 @@ var SHARED_REASON_CODES = /* @__PURE__ */ new Set([
   "LEGACY_BUDGET_REQUEST",
   "LINKED_BUDGET_REQUIRED",
   "LINKED_TASK_UNSUPPORTED",
+  "MEMBER_LIMIT_EXCEEDED",
   "MERCHANT_NOT_AUTHORIZED",
   "NOT_FOUND",
   "PURCHASE_ALREADY_SUBMITTED",

package/dist/index.mjs

@@ -22,7 +22,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@conto_finance/sdk",
-      version: "0.8.1",
+      version: "0.8.2",
       description: "Conto SDK for AI agent payment authorization",
       main: "./dist/index.js",
       module: "./dist/index.mjs",
@@ -712,16 +712,16 @@ var AdminSpendingClient = class {
   /**
    * Create a shared budget. Needs an organization API key with `policies:write`.
    *
+   * Checkout checkpoints, including `checkout.getLinkCard()`, and guarded browser checkout
+   * (`runGuardedCheckout()`) hold spend against each budget that covers the agent.
+   *
    * 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.
+   * payment grants, checkout relay, hosted Stripe Link and card overlays, for every agent it covers.
+   * A paused or expired budget still stops them. While paused and after its end date, it also
+   * refuses the managed wallet payments, connected card draws and checkouts it covers, for those
+   * agents. A start date cannot be changed.
+   * `deleteBudget()` ends a budget. Fails with `reasonCode` `BUDGET_HAS_HOLDS` while a purchase holds
+   * spend against it.
    */
   createBudget(input) {
     return this.client.request("POST", "/api/spending/budgets", {
@@ -1018,12 +1018,18 @@ function responseErrorMessage(_data, status) {
 }
 var SHARED_REASON_CODES = /* @__PURE__ */ new Set([
   "AGENT_NOT_AUTHORIZED",
+  "AGENT_LIMIT_EXCEEDED",
   "AGENT_UNAVAILABLE",
+  "BUDGET_CHANGE_NOT_ALLOWED",
   "BUDGET_CURRENCY_UNSUPPORTED",
   "BUDGET_EXPIRED",
   "BUDGET_HAS_HOLDS",
+  "BUDGET_METHOD_NOT_ALLOWED",
   "BUDGET_PAUSED",
+  "BUDGET_SOURCE_NOT_ATTACHED",
   "BUYER_LINK_REVOKED",
+  "CATEGORY_NOT_AUTHORIZED",
+  "CATEGORY_UNKNOWN",
   "DUPLICATE_PURCHASE",
   "ENROLLMENT_RECONCILIATION_REQUIRED",
   "EVIDENCE_CONFLICT",
@@ -1032,6 +1038,7 @@ var SHARED_REASON_CODES = /* @__PURE__ */ new Set([
   "EXECUTION_PATH_NOT_CONNECTED",
   "EXPORT_TOO_LARGE",
   "INVALID_AMOUNT",
+  "INVALID_BUDGET",
   "INVALID_EXPIRY",
   "INVALID_FILE",
   "INVALID_PARTICIPANTS",
@@ -1040,6 +1047,7 @@ var SHARED_REASON_CODES = /* @__PURE__ */ new Set([
   "LEGACY_BUDGET_REQUEST",
   "LINKED_BUDGET_REQUIRED",
   "LINKED_TASK_UNSUPPORTED",
+  "MEMBER_LIMIT_EXCEEDED",
   "MERCHANT_NOT_AUTHORIZED",
   "NOT_FOUND",
   "PURCHASE_ALREADY_SUBMITTED",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@conto_finance/sdk",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "Conto SDK for AI agent payment authorization",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",