@oneshot-agent/sdk 0.25.0 → 0.27.0

package/README.md

@@ -162,9 +162,68 @@ interface OneShotConfig {
   rpcUrl?: string;       // Override RPC URL
   debug?: boolean;       // Enable logging
   logger?: (msg: string) => void;
+  budgets?: {            // Spend budget (see below)
+    daily?: number;
+    perTransaction?: number;
+    alertAt?: number;
+    pauseAt?: number;
+  };
+  alerts?: { email?: string };
 }
 ```
 
+## Spend Budgets
+
+Cap what the agent can spend, so a runaway loop can't drain the wallet overnight.
+
+```typescript
+const agent = await OneShot.create({
+  cdp: true,
+  budgets: {
+    daily: 50,           // max USDC per UTC day
+    perTransaction: 5,   // max USDC for any single call
+    alertAt: 0.8,        // warn at 80% of daily
+    pauseAt: 1.0,        // stop paying at 100%
+  },
+  alerts: { email: 'you@example.com' },
+});
+```
+
+Unlike `maxCost` (a per-call client-side check), budgets are **enforced server-side**
+against your receipt ledger. The config is synced once before your first paid call,
+so the daily figure is a true per-agent total — shared across every process, restart,
+and serverless invocation using the same wallet, not a per-instance counter.
+
+At `alertAt` you get a notification (in-app via `agent.notifications()`, plus email
+if you set one). At `pauseAt` paid calls are rejected with a `BudgetExceededError`
+until the window resets at the next UTC midnight:
+
+```typescript
+try {
+  await agent.research({ topic: '...' });
+} catch (err) {
+  if (err instanceof BudgetExceededError) {
+    console.log(`${err.reason} budget hit — $${err.spent} spent, resumes ${err.resetsAt}`);
+  }
+}
+```
+
+Check utilization any time:
+
+```typescript
+const b = await agent.budgets();
+// { daily_usdc: 50, spent_today_usdc: '41.20', pct_used: 0.824, resets_at: '...' }
+```
+
+Omit `budgets` entirely to leave whatever is stored server-side untouched — agents
+without a budget are unlimited, which is the default.
+
+The sync **fails closed**: if the budget can't be confirmed with the server (network
+error, 5xx, rate limit, rejected config) the paid call throws `BudgetSyncError` and is
+not made — proceeding would silently drop the guardrail you asked for. It retries on
+the next paid call. An invalid config (`daily: -1`, `alertAt: 2`) throws `ValidationError`
+at construction.
+
 ## Authentication
 
 Every request identifies you by your wallet address (`X-Agent-ID`). Paid tools additionally settle a signed [x402](https://x402.org) USDC payment.

package/dist/errors.d.ts

@@ -6,6 +6,37 @@ export declare class ToolError extends OneShotError {
     readonly responseBody: string;
     constructor(message: string, statusCode: number, responseBody: string);
 }
+/**
+ * The facilitator rejected the payment signed for this request.
+ *
+ * Distinct from the ordinary 402 that opens the quote-pay handshake: this is a
+ * 402 arriving on the PAID retry, meaning the signature was refused. `reason`
+ * is the facilitator's machine-readable code (`insufficient_funds`,
+ * `invalid_exact_evm_payload_authorization_value`, …) and `expected`/`received`
+ * name the amounts when the two disagree — the case that produced a silent,
+ * bodiless 402 before the server started reporting it.
+ */
+export declare class PaymentError extends OneShotError {
+    readonly reason: string;
+    readonly expected?: {
+        amount?: string;
+        asset?: string;
+        network?: string;
+        payTo?: string;
+    } | undefined;
+    readonly received?: {
+        amount?: string;
+    } | undefined;
+    readonly quoteId?: string | undefined;
+    constructor(message: string, reason: string, expected?: {
+        amount?: string;
+        asset?: string;
+        network?: string;
+        payTo?: string;
+    } | undefined, received?: {
+        amount?: string;
+    } | undefined, quoteId?: string | undefined);
+}
 export declare class JobError extends OneShotError {
     readonly jobId: string;
     readonly jobError: string;
@@ -29,4 +60,37 @@ export declare class EmergencyNumberError extends OneShotError {
     readonly blockedNumber: string;
     constructor(message: string, blockedNumber: string);
 }
+/**
+ * The agent's own spend budget stopped this call (HTTP 403 `budget_exceeded`).
+ *
+ * Distinct from PaymentError: nothing was signed and nothing was charged. A
+ * retry cannot succeed until the daily window resets (`resetsAt`) or the budget
+ * is raised — which is why the server answers 403 rather than 402.
+ *
+ * `reason` is 'daily' when cumulative UTC-day spend would cross the budget, or
+ * 'per_transaction' when this single call is larger than the per-call cap.
+ */
+export declare class BudgetExceededError extends OneShotError {
+    readonly reason: 'daily' | 'per_transaction';
+    readonly cap?: number | undefined;
+    readonly spent?: number | undefined;
+    readonly charge?: number | undefined;
+    readonly resetsAt?: string | undefined;
+    constructor(message: string, reason: 'daily' | 'per_transaction', cap?: number | undefined, spent?: number | undefined, charge?: number | undefined, resetsAt?: string | undefined);
+}
+/**
+ * The SDK could not confirm the configured spend budget with the server
+ * before a paid call, so the call was NOT made.
+ *
+ * Budgets are enforced server-side; if the sync fails (network error, 5xx,
+ * rate limit, or a rejected config) the only honest options are to proceed
+ * without the guardrail the developer asked for, or to stop. We stop. The
+ * sync is retried on the next paid call. `status` is the HTTP status when the
+ * server answered, undefined on a network failure.
+ */
+export declare class BudgetSyncError extends OneShotError {
+    readonly status?: number | undefined;
+    readonly responseBody?: string | undefined;
+    constructor(message: string, status?: number | undefined, responseBody?: string | undefined);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAMA,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,SAAU,SAAQ,YAAY;aAGvB,UAAU,EAAE,MAAM;aAClB,YAAY,EAAE,MAAM;gBAFpC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM;CAKvC;AAED,qBAAa,QAAS,SAAQ,YAAY;aAGtB,KAAK,EAAE,MAAM;aACb,QAAQ,EAAE,MAAM;aAKhB,IAAI,CAAC,EAAE,MAAM;gBAP7B,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAKhB,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAED,qBAAa,eAAgB,SAAQ,YAAY;aAE7B,KAAK,EAAE,MAAM;aACb,SAAS,EAAE,MAAM;gBADjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM;CAKpC;AAED,qBAAa,eAAgB,SAAQ,YAAY;aACF,KAAK,EAAE,MAAM;gBAA9C,OAAO,EAAE,MAAM,EAAkB,KAAK,EAAE,MAAM;CAI3D;AAED,qBAAa,mBAAoB,SAAQ,YAAY;aAGjC,UAAU,EAAE,MAAM,EAAE;gBADpC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAAE;CAKvC;AAED,qBAAa,oBAAqB,SAAQ,YAAY;aAGlC,aAAa,EAAE,MAAM;gBADrC,OAAO,EAAE,MAAM,EACC,aAAa,EAAE,MAAM;CAKxC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAMA,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,SAAU,SAAQ,YAAY;aAGvB,UAAU,EAAE,MAAM;aAClB,YAAY,EAAE,MAAM;gBAFpC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM;CAKvC;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAa,SAAQ,YAAY;aAG1B,MAAM,EAAE,MAAM;aACd,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;aAChF,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;aAC9B,OAAO,CAAC,EAAE,MAAM;gBAJhC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,YAAA,EAChF,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,YAAA,EAC9B,OAAO,CAAC,EAAE,MAAM,YAAA;CAKnC;AAED,qBAAa,QAAS,SAAQ,YAAY;aAGtB,KAAK,EAAE,MAAM;aACb,QAAQ,EAAE,MAAM;aAKhB,IAAI,CAAC,EAAE,MAAM;gBAP7B,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAKhB,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAED,qBAAa,eAAgB,SAAQ,YAAY;aAE7B,KAAK,EAAE,MAAM;aACb,SAAS,EAAE,MAAM;gBADjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM;CAKpC;AAED,qBAAa,eAAgB,SAAQ,YAAY;aACF,KAAK,EAAE,MAAM;gBAA9C,OAAO,EAAE,MAAM,EAAkB,KAAK,EAAE,MAAM;CAI3D;AAED,qBAAa,mBAAoB,SAAQ,YAAY;aAGjC,UAAU,EAAE,MAAM,EAAE;gBADpC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAAE;CAKvC;AAED,qBAAa,oBAAqB,SAAQ,YAAY;aAGlC,aAAa,EAAE,MAAM;gBADrC,OAAO,EAAE,MAAM,EACC,aAAa,EAAE,MAAM;CAKxC;AAED;;;;;;;;;GASG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;aAGjC,MAAM,EAAE,OAAO,GAAG,iBAAiB;aACnC,GAAG,CAAC,EAAE,MAAM;aACZ,KAAK,CAAC,EAAE,MAAM;aACd,MAAM,CAAC,EAAE,MAAM;aACf,QAAQ,CAAC,EAAE,MAAM;gBALjC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,OAAO,GAAG,iBAAiB,EACnC,GAAG,CAAC,EAAE,MAAM,YAAA,EACZ,KAAK,CAAC,EAAE,MAAM,YAAA,EACd,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,QAAQ,CAAC,EAAE,MAAM,YAAA;CAKpC;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,YAAY;aACF,MAAM,CAAC,EAAE,MAAM;aAAkB,YAAY,CAAC,EAAE,MAAM;gBAAvF,OAAO,EAAE,MAAM,EAAkB,MAAM,CAAC,EAAE,MAAM,YAAA,EAAkB,YAAY,CAAC,EAAE,MAAM,YAAA;CAIpG"}

package/dist/errors.js

@@ -5,7 +5,7 @@
 // that drove the throw (statusCode/responseBody, jobId, field, categories, …)
 // so error handlers don't need to re-parse strings.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EmergencyNumberError = exports.ContentBlockedError = exports.ValidationError = exports.JobTimeoutError = exports.JobError = exports.ToolError = exports.OneShotError = void 0;
+exports.BudgetSyncError = exports.BudgetExceededError = exports.EmergencyNumberError = exports.ContentBlockedError = exports.ValidationError = exports.JobTimeoutError = exports.JobError = exports.PaymentError = exports.ToolError = exports.OneShotError = void 0;
 class OneShotError extends Error {
     constructor(message) {
         super(message);
@@ -23,6 +23,27 @@ class ToolError extends OneShotError {
     }
 }
 exports.ToolError = ToolError;
+/**
+ * The facilitator rejected the payment signed for this request.
+ *
+ * Distinct from the ordinary 402 that opens the quote-pay handshake: this is a
+ * 402 arriving on the PAID retry, meaning the signature was refused. `reason`
+ * is the facilitator's machine-readable code (`insufficient_funds`,
+ * `invalid_exact_evm_payload_authorization_value`, …) and `expected`/`received`
+ * name the amounts when the two disagree — the case that produced a silent,
+ * bodiless 402 before the server started reporting it.
+ */
+class PaymentError extends OneShotError {
+    constructor(message, reason, expected, received, quoteId) {
+        super(message);
+        this.reason = reason;
+        this.expected = expected;
+        this.received = received;
+        this.quoteId = quoteId;
+        this.name = 'PaymentError';
+    }
+}
+exports.PaymentError = PaymentError;
 class JobError extends OneShotError {
     constructor(message, jobId, jobError, 
     // Stable error-code taxonomy (issue #111): insufficient_funds, payment_failed,
@@ -71,4 +92,45 @@ class EmergencyNumberError extends OneShotError {
     }
 }
 exports.EmergencyNumberError = EmergencyNumberError;
+/**
+ * The agent's own spend budget stopped this call (HTTP 403 `budget_exceeded`).
+ *
+ * Distinct from PaymentError: nothing was signed and nothing was charged. A
+ * retry cannot succeed until the daily window resets (`resetsAt`) or the budget
+ * is raised — which is why the server answers 403 rather than 402.
+ *
+ * `reason` is 'daily' when cumulative UTC-day spend would cross the budget, or
+ * 'per_transaction' when this single call is larger than the per-call cap.
+ */
+class BudgetExceededError extends OneShotError {
+    constructor(message, reason, cap, spent, charge, resetsAt) {
+        super(message);
+        this.reason = reason;
+        this.cap = cap;
+        this.spent = spent;
+        this.charge = charge;
+        this.resetsAt = resetsAt;
+        this.name = 'BudgetExceededError';
+    }
+}
+exports.BudgetExceededError = BudgetExceededError;
+/**
+ * The SDK could not confirm the configured spend budget with the server
+ * before a paid call, so the call was NOT made.
+ *
+ * Budgets are enforced server-side; if the sync fails (network error, 5xx,
+ * rate limit, or a rejected config) the only honest options are to proceed
+ * without the guardrail the developer asked for, or to stop. We stop. The
+ * sync is retried on the next paid call. `status` is the HTTP status when the
+ * server answered, undefined on a network failure.
+ */
+class BudgetSyncError extends OneShotError {
+    constructor(message, status, responseBody) {
+        super(message);
+        this.status = status;
+        this.responseBody = responseBody;
+        this.name = 'BudgetSyncError';
+    }
+}
+exports.BudgetSyncError = BudgetSyncError;
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,0EAA0E;AAC1E,gFAAgF;AAChF,8EAA8E;AAC9E,oDAAoD;;;AAEpD,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAND,oCAMC;AAED,MAAa,SAAU,SAAQ,YAAY;IACzC,YACE,OAAe,EACC,UAAkB,EAClB,YAAoB;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,eAAU,GAAV,UAAU,CAAQ;QAClB,iBAAY,GAAZ,YAAY,CAAQ;QAGpC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AATD,8BASC;AAED,MAAa,QAAS,SAAQ,YAAY;IACxC,YACE,OAAe,EACC,KAAa,EACb,QAAgB;IAChC,+EAA+E;IAC/E,sEAAsE;IACtE,wEAAwE;IACxE,gEAAgE;IAChD,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QARC,UAAK,GAAL,KAAK,CAAQ;QACb,aAAQ,GAAR,QAAQ,CAAQ;QAKhB,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAdD,4BAcC;AAED,MAAa,eAAgB,SAAQ,YAAY;IAC/C,YACkB,KAAa,EACb,SAAiB;QAEjC,KAAK,CAAC,OAAO,KAAK,oBAAoB,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC;QAH3C,UAAK,GAAL,KAAK,CAAQ;QACb,cAAS,GAAT,SAAS,CAAQ;QAGjC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AARD,0CAQC;AAED,MAAa,eAAgB,SAAQ,YAAY;IAC/C,YAAY,OAAe,EAAkB,KAAa;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAQ;QAExD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED,MAAa,mBAAoB,SAAQ,YAAY;IACnD,YACE,OAAe,EACC,UAAoB;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,eAAU,GAAV,UAAU,CAAU;QAGpC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AARD,kDAQC;AAED,MAAa,oBAAqB,SAAQ,YAAY;IACpD,YACE,OAAe,EACC,aAAqB;QAErC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,kBAAa,GAAb,aAAa,CAAQ;QAGrC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AARD,oDAQC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -6,16 +6,7 @@ export { getSwapQuote, executeSwap } from './swap';
 export type { SwapQuote, SwapResult, UniswapAddresses } from './swap';
 export * from './errors';
 export * from './types';
-import type { OneShotConfig, ToolOptions, EmailToolOptions, ResearchToolOptions, PeopleSearchOptions, EnrichProfileOptions, FindEmailOptions, VerifyEmailOptions, CompanySearchOptions, CompanySearchResult, EnrichCompanyOptions, EnrichCompanyResult, DeepResearchPersonOptions, SocialProfilesOptions, ArticleSearchOptions, PersonNewsfeedOptions, PersonInterestsOptions, PersonInteractionsOptions, InboxListOptions, CommerceBuyOptions, CommerceSearchOptions, WebSearchOptions, WebSearchResult, WebReadOptions, WebReadResult, VoiceCallOptions, SmsOptions, SmsInboxOptions, PeopleSearchResult, ResearchResult, EmailResult, EnrichProfileResult, FindEmailResult, DeepResearchPersonResult, SocialProfilesResult, ArticleSearchResult, PersonNewsfeedResult, PersonInterestsResult, PersonInteractionsResult, VerifyEmailResult, InboxEmail, InboxListResult, CommerceBuyResult, CommerceSearchResult, VoiceCallResult, SmsSendResult, SmsInboxMessage, SmsInboxResult, NotificationsListOptions, NotificationsResult, BuildOptions, BuildResult, BrowserTaskOptions, BrowserProfile, BrowserResult, UpdateBuildOptions, SpendBreakdown, RoCSResult, RoCSByGoalResult, ReceiptsListResult, UnifiedBalance, ComputeOptions, ComputeGoalResult, ComputeGoalStatus, ComputeTask, ComputeBudgetStatus, DomainPoolListResult, DomainPoolStatusResult } from './types';
-/**
- * OneShot Agent SDK - Execute commercial transactions with automatic x402 payments.
- *
- * @example
- * ```typescript
- * const agent = new OneShot({ privateKey: process.env.AGENT_PRIVATE_KEY });
- * await agent.email({ to: 'user@example.com', subject: 'Hi', body: 'Hello' });
- * ```
- */
+import type { OneShotConfig, ToolOptions, EmailToolOptions, ResearchToolOptions, PeopleSearchOptions, EnrichProfileOptions, FindEmailOptions, VerifyEmailOptions, CompanySearchOptions, CompanySearchResult, EnrichCompanyOptions, EnrichCompanyResult, DeepResearchPersonOptions, SocialProfilesOptions, ArticleSearchOptions, PersonNewsfeedOptions, PersonInterestsOptions, PersonInteractionsOptions, InboxListOptions, CommerceBuyOptions, CommerceSearchOptions, WebSearchOptions, WebSearchResult, WebReadOptions, WebReadResult, VoiceCallOptions, SmsOptions, SmsInboxOptions, PeopleSearchResult, ResearchResult, EmailResult, EnrichProfileResult, FindEmailResult, DeepResearchPersonResult, SocialProfilesResult, ArticleSearchResult, PersonNewsfeedResult, PersonInterestsResult, PersonInteractionsResult, VerifyEmailResult, InboxEmail, InboxListResult, CommerceBuyResult, CommerceSearchResult, VoiceCallResult, SmsSendResult, SmsInboxMessage, SmsInboxResult, NotificationsListOptions, NotificationsResult, BuildOptions, BuildResult, BrowserTaskOptions, BrowserProfile, BrowserResult, UpdateBuildOptions, SpendBreakdown, RoCSResult, RoCSByGoalResult, ReceiptsListResult, UnifiedBalance, ComputeOptions, ComputeGoalResult, ComputeGoalStatus, ComputeTask, ComputeBudgetStatus, DomainPoolListResult, DomainPoolStatusResult, AgentBudgetConfig, AgentBudgetStatus } from './types';
 export declare class OneShot {
     private readonly provider;
     private readonly rpcProvider;
@@ -24,6 +15,14 @@ export declare class OneShot {
     private readonly logger;
     private readonly _currency;
     private readonly _slippage;
+    private readonly _budgets?;
+    private readonly _alertEmail?;
+    /**
+     * In-flight/settled budget sync. One PUT per instance: kept as a promise (not
+     * a boolean) so concurrent first calls await the same request instead of
+     * racing four PUTs on startup.
+     */
+    private _budgetSync?;
     /**
      * Async factory — required for CDP wallets (account creation is async).
      * Also works with privateKey and custom walletProvider.
@@ -48,6 +47,8 @@ export declare class OneShot {
     get chainId(): number;
     get currency(): 'USDC' | 'ETH';
     get slippage(): number;
+    /** The budget config this instance was constructed with, if any. */
+    get budgetConfig(): AgentBudgetConfig | undefined;
     tool<T = unknown>(toolName: string, options: ToolOptions & Record<string, unknown>): Promise<T>;
     email(options: EmailToolOptions): Promise<EmailResult>;
     /** List the caller's domain pool with warmup and rotation metadata. */
@@ -485,6 +486,38 @@ export declare class OneShot {
     /** Build a query string, skipping null/undefined values. Pass falsy-but-valid
      *  values (0, '') as undefined at the call site to match prior `if (x)` guards. */
     private buildQuery;
+    /**
+     * Push `config.budgets` to the server once, before the first paid call.
+     *
+     * Lazy rather than in the constructor because the PUT is signed (async) and
+     * the constructor is sync. Idempotent per instance via the cached promise,
+     * which is only kept once the sync SUCCEEDS.
+     *
+     * FAILS CLOSED. If the server can't confirm the budget — network error,
+     * 5xx, 429, or a rejected config — this throws BudgetSyncError and the paid
+     * call is not made. Proceeding would silently drop the guardrail the
+     * developer configured, which is exactly the "empty wallet at 3am" the
+     * budget exists to prevent. The marker is cleared so the next paid call
+     * retries.
+     */
+    private ensureBudgetsSynced;
+    /**
+     * Local fast-fail on the per-transaction cap, so an oversized call fails
+     * without a network round-trip. The server enforces the same cap (and the
+     * daily one, which needs the ledger) regardless of which client calls —
+     * this is the same SDK-checks/server-enforces split as maxCost.
+     */
+    private assertWithinBudget;
+    /**
+     * Current spend budget and today's utilization.
+     *
+     * @example
+     * ```typescript
+     * const b = await agent.budgets();
+     * console.log(`${b.spent_today_usdc} of ${b.daily_usdc} spent, resets ${b.resets_at}`);
+     * ```
+     */
+    budgets(): Promise<AgentBudgetStatus>;
     /** Local fast-fail guard: throw when a quote total exceeds the caller's cap. */
     private assertWithinMaxCost;
     /**
@@ -494,6 +527,43 @@ export declare class OneShot {
      * a server-side enforcement layer so non-SDK callers (MCP server, custom
      * integrations) can't ignore the cap.
      */
+    /**
+     * The amount to sign, in decimal USDC.
+     *
+     * A 402 advertises its price twice: the x402 v2 `PAYMENT-REQUIRED` header
+     * (`accepts[0].amount`, atomic units) and the legacy JSON body
+     * (`payment_request.amount`, decimal). The header is authoritative — it is
+     * what the server rebuilds its requirement from and what
+     * `findMatchingRequirements` compares the signature against.
+     *
+     * Preferring the body is how quote-based routes (email/send, sms, voice,
+     * build, commerce/buy, compute) silently failed: the body carried a
+     * hardcoded "0.00", so the SDK signed a zero-cost authorization against a
+     * real charge and the server answered with a bodiless 402. It stayed hidden
+     * for as long as credits covered those calls, since the credit path returns
+     * 202 without any payment handshake.
+     *
+     * Falls back to the body when the header is missing or unparseable.
+     */
+    /**
+     * Throw the most specific error a failed response supports.
+     *
+     * A 402 arriving on the PAID retry means the facilitator refused the
+     * signature — not the ordinary "here is your quote" 402. The API names the
+     * cause in that body (`payment_verification_failed` + reason + expected vs
+     * received amount); surface it as a `PaymentError` so callers can branch on
+     * `err.reason` instead of string-matching. Anything else keeps the existing
+     * `ToolError` shape.
+     */
+    private failFromResponse;
+    /**
+     * Map a 403 `budget_exceeded` body onto a typed error, so callers can catch
+     * "my own budget stopped this" separately from an auth failure or a payment
+     * rejection. Any other 403 falls through to ToolError.
+     */
+    private parseBudgetRejection;
+    private parsePaymentRejection;
+    private chargeAmount;
     private maxCostHeader;
     /**
      * Idempotency-Key header, sent on both legs (pre-402 and paid retry) so

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAYxD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAClI,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACnD,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AACtE,cAAc,UAAU,CAAC;AAqBzB,cAAc,SAAS,CAAC;AAExB,OAAO,KAAK,EAEgB,aAAa,EAAmB,WAAW,EACrE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAC1D,oBAAoB,EAAE,gBAAgB,EAAE,kBAAkB,EAC1D,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EACpF,yBAAyB,EAAE,qBAAqB,EAAE,oBAAoB,EACtE,qBAAqB,EAAE,sBAAsB,EAAE,yBAAyB,EACxE,gBAAgB,EAAmB,kBAAkB,EAAE,qBAAqB,EAC5E,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAChE,gBAAgB,EAAE,UAAU,EAAE,eAAe,EACR,kBAAkB,EAAE,cAAc,EACvE,WAAW,EAAE,mBAAmB,EAAE,eAAe,EAC/B,wBAAwB,EAAE,oBAAoB,EAChE,mBAAmB,EAAE,oBAAoB,EAAE,qBAAqB,EAChE,wBAAwB,EAAE,iBAAiB,EAAE,UAAU,EAAE,eAAe,EACzD,iBAAiB,EAAyB,oBAAoB,EACjE,eAAe,EAAY,aAAa,EAAE,eAAe,EACrE,cAAc,EAAgB,wBAAwB,EAAE,mBAAmB,EAClB,YAAY,EACzD,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAC3D,aAAa,EAAE,kBAAkB,EAAiB,cAAc,EAAE,UAAU,EAAE,gBAAgB,EACrF,kBAAkB,EAAE,cAAc,EAAmB,cAAc,EAC9D,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAC/D,mBAAmB,EACF,oBAAoB,EAAE,sBAAsB,EAC9D,MAAM,SAAS,CAAC;AAOjB;;;;;;;;GAQG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC;;;;;;;;;;;;OAYG;WACU,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAwB5D;;;OAGG;gBACS,MAAM,EAAE,aAAa,EAAE,cAAc,CAAC,EAAE,cAAc;IAoClE,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,KAAK,CAE7B;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAMK,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/F,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IA+E5D,uEAAuE;IACjE,WAAW,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAUlD,0DAA0D;IACpD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAYlE,8CAA8C;IACxC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAY7D,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAK/D,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIvE,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAO1E,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI/E,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAO1E,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAQ9D,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKpE,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAOzF,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAO7E,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAM1E,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAK7E,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAOhF,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAKzF,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBnE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAgB9C,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAsCpE,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAK7E,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAK9D,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAK9D;;;;;;;;;;;;OAYG;IACG,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IA2DhE;;;;;;;;;;;OAWG;IACG,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IA6DtD;;;;;;;;;;;;;;;OAeG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAsDxD;;;;;;;;;;;OAWG;IACG,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAoDlE;;;;;;;;OAQG;IACG,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAejE;;;;;;;;;;OAUG;IACG,mBAAmB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAYtD;;;;;;;OAOG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5D;;;;;;;;;;;;;;OAcG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IAQpE;;;;;;;;;;OAUG;IACG,YAAY,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAgB1E;;;;;;;;OAQG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAgB9D;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAezF;;;;;;;OAOG;IACG,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3D,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC;IAY5C,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BxD;;;;;;;;;;;;;;;;;;OAkBG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwClE;;;;;;;;OAQG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkBhE;;;;;;;;;;OAUG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAe7D;;;;;;;;OAQG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkBpE;;;;;;;;OAQG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;IAoBhI;;;;;;;;;;;OAWG;IACG,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,CAAC;IAqB9M;;;;;;;OAOG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBxH;;;;;;;;OAQG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAiB7H;;;;;;;;;;;OAWG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAgD/I;;;;;;;;;;;OAWG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAY5E;;;;;;;;OAQG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAY9D;;;;;;;;;;;;;;;;;OAiBG;IACG,YAAY,CAAC,OAAO,CAAC,EAAE;QAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoB/B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,eAAe,CACnB,GAAG,EAAE,MAAM,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EACzE,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1D,OAAO,CAAC,IAAI,CAAC;IAiChB;;;;;;;;;;;;;;;;OAgBG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgB3F,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,OAAO;IAOf,6DAA6D;IAC7D,OAAO,CAAC,WAAW;IAInB;;;;;;;;OAQG;YACW,iBAAiB;IA2B/B;uFACmF;IACnF,OAAO,CAAC,UAAU;IAQlB,gFAAgF;IAChF,OAAO,CAAC,mBAAmB;IAM3B;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAKrB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;YAKX,kBAAkB;IA2FhC;;;;;;OAMG;YACW,aAAa;YAuDb,OAAO;IA4CrB;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;IASxB;;;;;;;OAOG;YACW,cAAc;IA2C5B,OAAO,CAAC,gBAAgB;YAkIV,WAAW;IA6DzB,OAAO,CAAC,KAAK;YAiBC,WAAW;IA8CzB,OAAO,CAAC,uBAAuB;IAM/B;;;OAGG;YACW,iBAAiB;IAkB/B,gHAAgH;IAChH,OAAO,CAAC,oBAAoB;IAqC5B;;;;OAIG;YACW,uBAAuB;YAoBvB,wBAAwB;CA0FvC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}