@oneshot-agent/sdk 0.32.0 → 0.33.0

package/README.md

@@ -182,7 +182,12 @@ mainnet only.
 
 ```typescript
 interface OneShotConfig {
-  privateKey: string;    // Required
+  privateKey?: string;   // Option A: raw key
+  cdp?: boolean;         // Option B: Coinbase CDP server wallet
+  walletProvider?: WalletProvider; // Option C: bring your own signer
+  accessToken?: string;  // Option D: credits-only session, no key (see Access tokens)
+  address?: string;      // With accessToken in the sync constructor; create() resolves it
+  defaultHeaders?: Record<string, string>; // Sent on every request
   baseUrl?: string;      // Override API URL
   rpcUrl?: string;       // Override RPC URL
   debug?: boolean;       // Enable logging
@@ -257,6 +262,31 @@ Every request identifies you by your wallet address (`X-Agent-ID`). Paid tools a
 
 This is fully automatic — you don't do anything beyond providing your `privateKey`. **Requires SDK ≥ 0.25.0.** Older SDKs (or raw HTTP callers) will keep working until the API enables enforcement, after which they must send a valid `x-agent-proof`; upgrade to stay ahead of it.
 
+### Access tokens (credits-only sessions)
+
+Some code can't hold your wallet key — a hosted MCP client such as Grok Bot, a cloud
+runner, a third-party agent platform. For those, mint an **access token** from a wallet
+session and hand it over instead:
+
+```typescript
+// From a wallet session (once):
+const { token } = await agent.createAccessToken({ name: 'grok-bot' });
+
+// In the hosted environment:
+const hosted = await OneShot.create({ accessToken: token }); // resolves the wallet address
+await hosted.webSearch({ query: '…' });                        // billed to the agent's credits
+```
+
+An access-token session identifies the agent with the token (no `x-agent-proof`), **pays
+every call from the agent's prepaid credit balance**, and never signs x402. When credits
+can't cover a call it throws `InsufficientCreditsError` (`required`, `balance`,
+`shortfall`) — top up and retry. Budgets set on the agent still apply, with credit-funded
+spend counted; they are **read-only** from a token session (`agent.budgets()` works,
+passing `budgets` to the constructor throws). A token cannot mint, list, or revoke
+tokens; do that from the wallet session (`listAccessTokens()`, `revokeAccessToken(id)`).
+`accessToken` is exclusive with `privateKey` / `cdp` / `walletProvider` and with
+`currency: 'ETH'`. **Requires SDK ≥ 0.33.0.**
+
 ## Tool Options
 
 All methods accept these common options:
@@ -605,7 +635,7 @@ The signal **cannot** cancel:
 ## Links
 
 - [Documentation](https://docs.oneshotagent.com)
-- [MCP Server](https://www.npmjs.com/package/@oneshot-agent/mcp-server) — Claude Desktop, Cursor, Claude Code
+- [MCP Server](https://www.npmjs.com/package/@oneshot-agent/mcp-server) — Claude Desktop, Cursor, Claude Code (local), or the hosted endpoint at `https://win.oneshotagent.com/mcp` with an access token
 - [Python SDK (LangChain)](https://pypi.org/project/langchain-oneshot/) — 26 tools as LangChain BaseTool
 - [Python SDK (Core)](https://pypi.org/project/oneshot-python/) — HTTP client with x402 payments
 - [Pricing](https://docs.oneshotagent.com/pricing)

package/dist/errors.d.ts

@@ -103,4 +103,18 @@ export declare class BudgetSyncError extends OneShotError {
     readonly responseBody?: string | undefined;
     constructor(message: string, status?: number | undefined, responseBody?: string | undefined);
 }
+/**
+ * An access-token session's credit balance cannot cover the call (HTTP 402
+ * `insufficient_credits`). Access-token sessions pay from credits only and
+ * never sign x402, so this is the end of the road for the call: top up the
+ * agent's credits (or use a wallet session) and retry. `required` is the
+ * gross price of the call and `balance` the current credit balance, in USDC,
+ * when the server reported them.
+ */
+export declare class InsufficientCreditsError extends OneShotError {
+    readonly required?: number | undefined;
+    readonly balance?: number | undefined;
+    readonly shortfall?: number | undefined;
+    constructor(message: string, required?: number | undefined, balance?: number | undefined, shortfall?: number | 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":"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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

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.BudgetSyncError = exports.BudgetExceededError = exports.EmergencyNumberError = exports.ContentBlockedError = exports.ValidationError = exports.RequestTimeoutError = exports.JobTimeoutError = exports.JobError = exports.PaymentError = exports.ToolError = exports.OneShotError = void 0;
+exports.InsufficientCreditsError = exports.BudgetSyncError = exports.BudgetExceededError = exports.EmergencyNumberError = exports.ContentBlockedError = exports.ValidationError = exports.RequestTimeoutError = exports.JobTimeoutError = exports.JobError = exports.PaymentError = exports.ToolError = exports.OneShotError = void 0;
 class OneShotError extends Error {
     constructor(message) {
         super(message);
@@ -147,4 +147,22 @@ class BudgetSyncError extends OneShotError {
     }
 }
 exports.BudgetSyncError = BudgetSyncError;
+/**
+ * An access-token session's credit balance cannot cover the call (HTTP 402
+ * `insufficient_credits`). Access-token sessions pay from credits only and
+ * never sign x402, so this is the end of the road for the call: top up the
+ * agent's credits (or use a wallet session) and retry. `required` is the
+ * gross price of the call and `balance` the current credit balance, in USDC,
+ * when the server reported them.
+ */
+class InsufficientCreditsError extends OneShotError {
+    constructor(message, required, balance, shortfall) {
+        super(message);
+        this.required = required;
+        this.balance = balance;
+        this.shortfall = shortfall;
+        this.name = 'InsufficientCreditsError';
+    }
+}
+exports.InsufficientCreditsError = InsufficientCreditsError;
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -4,11 +4,12 @@ import type { WalletProvider } from './wallet-provider';
 export type { WalletProvider, TypedDataDomain, TypedDataField, TransactionRequest, TransactionResponse } from './wallet-provider';
 export { EthersWalletProvider } from './providers/ethers';
 export { CdpWalletProvider } from './providers/cdp';
+export { ReadOnlyWalletProvider } from './providers/read-only';
 export { getSwapQuote, executeSwap } from './swap';
 export type { SwapQuote, SwapResult, UniswapAddresses } from './swap';
 export * from './errors';
 export * from './types';
-import type { StatusUpdateFn, OneShotConfig, ToolOptions, EmailToolOptions, ResearchToolOptions, PeopleSearchOptions, EnrichProfileOptions, FindEmailOptions, VerifyEmailOptions, CompanySearchOptions, CompanySearchResult, EnrichCompanyOptions, EnrichCompanyResult, LocalSearchOptions, LocalSearchResult, LocalResolveOptions, LocalResolveResult, GovSolicitationsOptions, GovSolicitationsResult, 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';
+import type { StatusUpdateFn, OneShotConfig, ToolOptions, EmailToolOptions, ResearchToolOptions, PeopleSearchOptions, EnrichProfileOptions, FindEmailOptions, VerifyEmailOptions, CompanySearchOptions, CompanySearchResult, EnrichCompanyOptions, EnrichCompanyResult, LocalSearchOptions, LocalSearchResult, LocalResolveOptions, LocalResolveResult, GovSolicitationsOptions, GovSolicitationsResult, 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, AccessTokenCreated, AccessTokenInfo } from './types';
 export declare class OneShot {
     readonly physicalMail: PhysicalMail;
     private readonly provider;
@@ -20,6 +21,9 @@ export declare class OneShot {
     private readonly _slippage;
     private readonly _budgets?;
     private readonly _alertEmail?;
+    /** Set in access-token mode; the session pays from credits and never signs. */
+    private readonly _accessToken?;
+    private readonly _defaultHeaders;
     /**
      * 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
@@ -90,6 +94,8 @@ export declare class OneShot {
      * Federal contract opportunities (SAM.gov) by NAICS code — Sources Sought
      * and Presolicitation notices with the contracting officer's published
      * contact. Flat price per search; zero notices is a completed result.
+     * `data_as_of` on the result is the snapshot behind the rows (SAM.gov's
+     * daily extract publish time, or "now" when the live API served).
      */
     govSolicitations(options: GovSolicitationsOptions): Promise<GovSolicitationsResult>;
     findEmail(options: FindEmailOptions): Promise<FindEmailResult>;
@@ -501,6 +507,8 @@ export declare class OneShot {
     private log;
     private validate;
     private headers;
+    /** True for access-token sessions: credits-only, never signs. */
+    get isAccessTokenSession(): boolean;
     /** Auth headers plus Content-Type for JSON-body requests. */
     private jsonHeaders;
     /**
@@ -548,6 +556,30 @@ export declare class OneShot {
      * ```
      */
     budgets(): Promise<AgentBudgetStatus>;
+    private assertWalletSession;
+    /**
+     * Mint an access token for this agent: a revocable, credits-only credential
+     * for code that runs where the wallet key cannot be (hosted MCP clients,
+     * cloud runners). The plaintext is returned once and never stored.
+     *
+     * @example
+     * ```typescript
+     * const { token } = await agent.createAccessToken({ name: 'grok-bot' });
+     * // hand `token` to the hosted client; it uses OneShot.create({ accessToken: token })
+     * ```
+     */
+    createAccessToken(opts?: {
+        name?: string;
+    }): Promise<AccessTokenCreated>;
+    /** List this agent's access tokens (prefix, label, last use, spend today — never the token). */
+    listAccessTokens(opts?: {
+        activeOnly?: boolean;
+    }): Promise<AccessTokenInfo[]>;
+    /** Revoke an access token. Sessions using it fail with 401 from the next request. */
+    revokeAccessToken(id: string): Promise<{
+        id: string;
+        revoked_at: string;
+    }>;
     /** Local fast-fail guard: throw when a quote total exceeds the caller's cap. */
     private assertWithinMaxCost;
     /**
@@ -586,6 +618,22 @@ export declare class OneShot {
      * `ToolError` shape.
      */
     private failFromResponse;
+    /**
+     * Map a 402 `insufficient_credits` body (access-token sessions) onto a typed
+     * error. Any other 402 falls through to the payment-rejection / quote parse.
+     */
+    private parseInsufficientCredits;
+    /**
+     * Access-token sessions never sign. When a paid call answers 402 the SDK
+     * either got the server's `insufficient_credits` verdict (throw it) or a
+     * quote (re-POST with `x-quote-id` and no payment: the server executes
+     * when the quote's credits cover it, otherwise answers `insufficient_credits`
+     * with the balance and shortfall, which failFromResponse turns into the
+     * typed error). Server-decided on purpose — the SDK holds no ledger.
+     */
+    private retryAsCreditsSession;
+    /** GET /v1/agents/me with the token, for OneShot.create({ accessToken }) without an address. */
+    private static resolveTokenAddress;
     /**
      * 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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -36,11 +36,12 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OneShot = exports.executeSwap = exports.getSwapQuote = exports.CdpWalletProvider = exports.EthersWalletProvider = void 0;
+exports.OneShot = exports.executeSwap = exports.getSwapQuote = exports.ReadOnlyWalletProvider = exports.CdpWalletProvider = exports.EthersWalletProvider = void 0;
 const physical_mail_1 = require("./physical-mail");
 __exportStar(require("./physical-mail"), exports);
 const deadline_1 = require("./deadline");
 const errors_1 = require("./errors");
+const read_only_1 = require("./providers/read-only");
 const ethers_1 = require("ethers");
 const ethers_2 = require("./providers/ethers");
 const errors_2 = require("./errors");
@@ -48,12 +49,14 @@ var ethers_3 = require("./providers/ethers");
 Object.defineProperty(exports, "EthersWalletProvider", { enumerable: true, get: function () { return ethers_3.EthersWalletProvider; } });
 var cdp_1 = require("./providers/cdp");
 Object.defineProperty(exports, "CdpWalletProvider", { enumerable: true, get: function () { return cdp_1.CdpWalletProvider; } });
+var read_only_2 = require("./providers/read-only");
+Object.defineProperty(exports, "ReadOnlyWalletProvider", { enumerable: true, get: function () { return read_only_2.ReadOnlyWalletProvider; } });
 var swap_1 = require("./swap");
 Object.defineProperty(exports, "getSwapQuote", { enumerable: true, get: function () { return swap_1.getSwapQuote; } });
 Object.defineProperty(exports, "executeSwap", { enumerable: true, get: function () { return swap_1.executeSwap; } });
 __exportStar(require("./errors"), exports);
 // Keep in sync with package.json `version`. Guarded by version.test.ts.
-const SDK_VERSION = '0.32.0';
+const SDK_VERSION = '0.33.0';
 /** HTTP poll cadence while push is unconfirmed: fast first checks, settling at 2s. */
 const HTTP_POLL_BACKOFF_MS = [300, 600, 1000, 2000];
 /** HTTP poll cadence once the WebSocket has delivered for this request. */
@@ -160,6 +163,14 @@ class OneShot {
      * ```
      */
     static async create(config) {
+        if (config.accessToken) {
+            if (config.address)
+                return new OneShot(config);
+            // The API keys job status and the WebSocket on X-Agent-ID, so the
+            // session needs its wallet address even though it never signs with it.
+            const address = await OneShot.resolveTokenAddress(config);
+            return new OneShot({ ...config, address });
+        }
         if (config.walletProvider) {
             return new OneShot(config, config.walletProvider);
         }
@@ -204,8 +215,38 @@ class OneShot {
         this._swapBufferMultiplier = validateSwapBufferMultiplier(config.swapBufferMultiplier);
         this._budgets = validateBudgetConfig(config.budgets);
         this._alertEmail = config.alerts?.email;
+        this._defaultHeaders = { ...(config.defaultHeaders ?? {}) };
         this.rpcProvider = new ethers_1.ethers.JsonRpcProvider(config.rpcUrl ?? RPC_URL);
-        if (walletProvider) {
+        if (config.accessToken) {
+            // Option D: access-token session. Exclusive with every wallet option,
+            // and budgets are read-only (a delegated credential that could raise its
+            // own cap would make the cap meaningless) — set them from a wallet.
+            if (!/^oneshot_[0-9a-f]{64}$/.test(config.accessToken)) {
+                throw new errors_2.ValidationError('accessToken must be oneshot_<64 lowercase hex characters>', 'accessToken');
+            }
+            if (config.privateKey || config.cdp || config.walletProvider || walletProvider) {
+                throw new errors_2.ValidationError('accessToken cannot be combined with privateKey, cdp, or walletProvider', 'accessToken');
+            }
+            if (config.budgets || config.alerts) {
+                throw new errors_2.ValidationError('budgets and alerts are read-only for access-token sessions; set them from a wallet session or the API', 'budgets');
+            }
+            if (this._currency === 'ETH') {
+                throw new errors_2.ValidationError('ETH currency mode is not available to access-token sessions (they pay from credits)', 'currency');
+            }
+            if (!config.address) {
+                throw new errors_2.ValidationError('address is required with accessToken in the constructor; use OneShot.create() to resolve it', 'address');
+            }
+            let address;
+            try {
+                address = ethers_1.ethers.getAddress(config.address);
+            }
+            catch {
+                throw new errors_2.ValidationError('address must be a valid Ethereum address', 'address');
+            }
+            this._accessToken = config.accessToken;
+            this.provider = new read_only_1.ReadOnlyWalletProvider(address);
+        }
+        else if (walletProvider) {
             this.provider = walletProvider;
         }
         else if (config.privateKey) {
@@ -406,6 +447,8 @@ class OneShot {
      * Federal contract opportunities (SAM.gov) by NAICS code — Sources Sought
      * and Presolicitation notices with the contracting officer's published
      * contact. Flat price per search; zero notices is a completed result.
+     * `data_as_of` on the result is the snapshot behind the rows (SAM.gov's
+     * daily extract publish time, or "now" when the live API served).
      */
     async govSolicitations(options) {
         if (!options.naics || options.naics.length === 0) {
@@ -1244,6 +1287,13 @@ class OneShot {
         const quoteData = await quoteResp.json();
         this.log(`Compute fund quote: $${quoteData.payment_request.amount} to top up ${goalId}`);
         this.assertWithinBudget(quoteData.payment_request.amount);
+        if (this._accessToken) {
+            const fundResp = await this.retryAsCreditsSession(quoteData, path, payload, quoteData.context.quote_id);
+            if (!fundResp.ok)
+                await this.failFromResponse('Failed to fund compute goal', fundResp);
+            const json = await fundResp.json();
+            return json.data;
+        }
         const paymentInfo = {
             protocol: 'x402',
             network: `eip155:${quoteData.payment_request.chain_id}`,
@@ -1436,10 +1486,16 @@ class OneShot {
     }
     headers() {
         return {
+            ...this._defaultHeaders,
             'X-Agent-ID': this.provider.address,
-            'X-OneShot-SDK-Version': SDK_VERSION
+            'X-OneShot-SDK-Version': SDK_VERSION,
+            ...(this._accessToken ? { Authorization: `Bearer ${this._accessToken}` } : {}),
         };
     }
+    /** True for access-token sessions: credits-only, never signs. */
+    get isAccessTokenSession() {
+        return this._accessToken !== undefined;
+    }
     /** Auth headers plus Content-Type for JSON-body requests. */
     jsonHeaders() {
         return { 'Content-Type': 'application/json', ...this.headers() };
@@ -1455,6 +1511,10 @@ class OneShot {
      */
     async signedReadHeaders(scope = 'read') {
         const base = this.headers();
+        // The bearer token already binds the request to the agent (and is
+        // revocable); the API accepts it in place of the signed proof.
+        if (this._accessToken)
+            return base;
         try {
             const agent = this.provider.address;
             const issuedAt = Math.floor(Date.now() / 1000);
@@ -1580,6 +1640,61 @@ class OneShot {
         const body = await response.json();
         return (body.data ?? body);
     }
+    // ---------------------------------------------------------------------------
+    // Access tokens (wallet sessions only)
+    // ---------------------------------------------------------------------------
+    assertWalletSession(action) {
+        if (this._accessToken) {
+            throw new errors_2.ValidationError(`Access tokens cannot ${action}; use a wallet session`, 'accessToken');
+        }
+    }
+    /**
+     * Mint an access token for this agent: a revocable, credits-only credential
+     * for code that runs where the wallet key cannot be (hosted MCP clients,
+     * cloud runners). The plaintext is returned once and never stored.
+     *
+     * @example
+     * ```typescript
+     * const { token } = await agent.createAccessToken({ name: 'grok-bot' });
+     * // hand `token` to the hosted client; it uses OneShot.create({ accessToken: token })
+     * ```
+     */
+    async createAccessToken(opts = {}) {
+        this.assertWalletSession('mint access tokens');
+        const response = await fetch(`${this.baseUrl}/v1/agents/me/access-tokens`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', ...(await this.signedReadHeaders('write')) },
+            body: JSON.stringify(opts.name !== undefined ? { name: opts.name } : {}),
+        });
+        if (!response.ok)
+            throw new errors_2.ToolError('Failed to create access token', response.status, await response.text());
+        const body = await response.json();
+        return body.data;
+    }
+    /** List this agent's access tokens (prefix, label, last use, spend today — never the token). */
+    async listAccessTokens(opts = {}) {
+        this.assertWalletSession('list access tokens');
+        const response = await fetch(`${this.baseUrl}/v1/agents/me/access-tokens${opts.activeOnly ? '?active=true' : ''}`, {
+            headers: await this.signedReadHeaders(),
+        });
+        if (!response.ok)
+            throw new errors_2.ToolError('Failed to list access tokens', response.status, await response.text());
+        const body = await response.json();
+        return body.data.tokens;
+    }
+    /** Revoke an access token. Sessions using it fail with 401 from the next request. */
+    async revokeAccessToken(id) {
+        this.assertWalletSession('revoke access tokens');
+        this.validate(id, 'id');
+        const response = await fetch(`${this.baseUrl}/v1/agents/me/access-tokens/${encodeURIComponent(id)}`, {
+            method: 'DELETE',
+            headers: await this.signedReadHeaders('write'),
+        });
+        if (!response.ok)
+            throw new errors_2.ToolError('Failed to revoke access token', response.status, await response.text());
+        const body = await response.json();
+        return body.data;
+    }
     /** Local fast-fail guard: throw when a quote total exceeds the caller's cap. */
     assertWithinMaxCost(total, maxCost) {
         if (maxCost && parseFloat(total) > maxCost) {
@@ -1623,6 +1738,9 @@ class OneShot {
      */
     async failFromResponse(message, response) {
         const text = await response.text();
+        const credits = response.status === 402 ? this.parseInsufficientCredits(text) : undefined;
+        if (credits)
+            throw credits;
         const rejection = response.status === 402 ? this.parsePaymentRejection(text) : undefined;
         if (rejection)
             throw rejection;
@@ -1631,6 +1749,75 @@ class OneShot {
             throw budget;
         throw new errors_2.ToolError(message, response.status, text);
     }
+    /**
+     * Map a 402 `insufficient_credits` body (access-token sessions) onto a typed
+     * error. Any other 402 falls through to the payment-rejection / quote parse.
+     */
+    parseInsufficientCredits(text) {
+        let body;
+        try {
+            body = typeof text === 'string' ? JSON.parse(text) : text;
+        }
+        catch {
+            return undefined;
+        }
+        if (!body || body.error !== 'insufficient_credits')
+            return undefined;
+        const num = (v) => (typeof v === 'string' || typeof v === 'number') && Number.isFinite(parseFloat(String(v))) ? parseFloat(String(v)) : undefined;
+        return new errors_1.InsufficientCreditsError(body.message ?? 'Credit balance does not cover this call', num(body.required_usdc), num(body.credits_balance), num(body.shortfall_usdc));
+    }
+    /**
+     * Access-token sessions never sign. When a paid call answers 402 the SDK
+     * either got the server's `insufficient_credits` verdict (throw it) or a
+     * quote (re-POST with `x-quote-id` and no payment: the server executes
+     * when the quote's credits cover it, otherwise answers `insufficient_credits`
+     * with the balance and shortfall, which failFromResponse turns into the
+     * typed error). Server-decided on purpose — the SDK holds no ledger.
+     */
+    async retryAsCreditsSession(body, endpoint, payload, quoteId, signal, timeoutMs, extraHeaders) {
+        const credits = body ? this.parseInsufficientCredits(body) : undefined;
+        if (credits)
+            throw credits;
+        const qid = quoteId ?? body?.context?.quote_id;
+        if (!qid) {
+            const amount = body?.payment_request?.amount;
+            throw new errors_1.InsufficientCreditsError(`Credits do not cover ${amount ? `$${amount}` : 'this call'}; top up credits or use a wallet session`, amount ? parseFloat(amount) : undefined);
+        }
+        this.log(`Access-token session: retrying quote ${qid} against credits`);
+        const retry = await this.makeRequest(endpoint, payload, undefined, qid, signal, timeoutMs, extraHeaders);
+        if (retry.status === 402)
+            await this.failFromResponse('Credits do not cover this call', retry);
+        return retry;
+    }
+    /** GET /v1/agents/me with the token, for OneShot.create({ accessToken }) without an address. */
+    static async resolveTokenAddress(config) {
+        const TOKEN_RESOLVE_TIMEOUT_MS = 10000;
+        const baseUrl = config.baseUrl ?? BASE_URL;
+        let response;
+        try {
+            response = await fetch(`${baseUrl}/v1/agents/me`, {
+                headers: {
+                    ...(config.defaultHeaders ?? {}),
+                    Authorization: `Bearer ${config.accessToken}`,
+                    'X-OneShot-SDK-Version': SDK_VERSION,
+                },
+                // Bounded: with no signal, Node's fetch can wait minutes on a hung
+                // connection and OneShot.create() would hang with it.
+                signal: AbortSignal.timeout(TOKEN_RESOLVE_TIMEOUT_MS),
+            });
+        }
+        catch (err) {
+            throw new errors_2.ToolError(`Could not resolve the access token's agent (network): ${err}`, 0, String(err));
+        }
+        if (!response.ok) {
+            throw new errors_2.ToolError('Could not resolve the access token\'s agent', response.status, await response.text());
+        }
+        const json = await response.json();
+        const address = json.data?.wallet_address;
+        if (!address)
+            throw new errors_2.ToolError('GET /v1/agents/me returned no wallet_address', response.status, JSON.stringify(json));
+        return address;
+    }
     /**
      * 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
@@ -1802,23 +1989,30 @@ class OneShot {
             const { accepted, resource, extensions } = this.parsePaymentRequired(paymentRequiredHeader);
             // Fallback: parse legacy body format for amount display
             const data = await response.json();
-            const paymentInfo = {
-                protocol: 'x402',
-                network: accepted.network,
-                payTo: accepted.payTo,
-                amount: this.chargeAmount(accepted, data.payment_request?.amount),
-                currency: 'USD',
-                facilitator_url: this.baseUrl,
-                token: { address: accepted.asset, symbol: 'USDC', decimals: 6 }
-            };
-            this.log(`Payment required: ${paymentInfo.amount} USDC`);
-            this.assertWithinBudget(paymentInfo.amount);
-            this.checkAbortBeforePayment(signal);
-            context.phase = 'payment';
-            const signed = await this.signPaymentAuthorization(paymentInfo, accepted, resource, extensions);
-            this.checkAbortBeforePayment(signal);
-            context.phase = 'submission';
-            response = await this.makePaidRequest(signed, endpoint, payload, quoteId, signal, undefined, extraHeaders);
+            if (this._accessToken) {
+                // Credits-only session: never sign. Let the server settle it.
+                this.checkAbortBeforePayment(signal);
+                response = await this.retryAsCreditsSession(data, endpoint, payload, quoteId, signal, undefined, extraHeaders);
+            }
+            else {
+                const paymentInfo = {
+                    protocol: 'x402',
+                    network: accepted.network,
+                    payTo: accepted.payTo,
+                    amount: this.chargeAmount(accepted, data.payment_request?.amount),
+                    currency: 'USD',
+                    facilitator_url: this.baseUrl,
+                    token: { address: accepted.asset, symbol: 'USDC', decimals: 6 }
+                };
+                this.log(`Payment required: ${paymentInfo.amount} USDC`);
+                this.assertWithinBudget(paymentInfo.amount);
+                this.checkAbortBeforePayment(signal);
+                context.phase = 'payment';
+                const signed = await this.signPaymentAuthorization(paymentInfo, accepted, resource, extensions);
+                this.checkAbortBeforePayment(signal);
+                context.phase = 'submission';
+                response = await this.makePaidRequest(signed, endpoint, payload, quoteId, signal, undefined, extraHeaders);
+            }
         }
         if (!response.ok) {
             await this.failFromResponse('Tool request failed', response);
@@ -1864,6 +2058,11 @@ class OneShot {
         cfg.onQuote(quoteData.context);
         this.assertWithinMaxCost(cfg.totalOf(quoteData.context), cfg.maxCost);
         this.assertWithinBudget(cfg.totalOf(quoteData.context));
+        if (this._accessToken) {
+            this.checkAbortBeforePayment(cfg.signal);
+            const execResp = await this.retryAsCreditsSession(quoteData, cfg.endpoint, cfg.payload, quoteData.context.quote_id, cfg.signal, cfg.execTimeoutMs);
+            return { context: quoteData.context, execResp };
+        }
         const paymentInfo = {
             protocol: 'x402',
             network: `eip155:${quoteData.payment_request.chain_id}`,
@@ -2485,6 +2684,11 @@ class OneShot {
                     },
                 } };
         }
+        // Belt and braces: every paid path branches to retryAsCreditsSession
+        // before reaching here in access-token mode.
+        if (this._accessToken) {
+            throw new errors_1.InsufficientCreditsError(`Credits do not cover $${paymentInfo.amount}; top up credits or use a wallet session`, parseFloat(paymentInfo.amount));
+        }
         // If paying with ETH, make sure USDC covers the charge (swapping a buffer if not) and reserve it
         const reservation = await this.ensureUsdcBalance(paymentInfo);
         const now = Math.floor(Date.now() / 1000);