@oneshot-agent/mcp-server 0.19.0 → 0.21.0

package/README.md

@@ -10,7 +10,7 @@ npm install -g @oneshot-agent/mcp-server
 
 ## Configuration
 
-The server supports two auth methods: **CDP Wallet** (recommended, no private keys in config) or a raw private key.
+The server supports three auth methods: **CDP Wallet** (recommended, no private keys in config), a raw private key, or an **access token** (credits-only session, no key at all — see Remote below).
 
 ### Environment Variables
 
@@ -20,6 +20,7 @@ The server supports two auth methods: **CDP Wallet** (recommended, no private ke
 | `CDP_API_KEY_SECRET` | Option A | Coinbase CDP API key secret |
 | `CDP_WALLET_SECRET` | Option A | Coinbase CDP wallet secret |
 | `ONESHOT_WALLET_PRIVATE_KEY` | Option B | Raw private key for signing payments |
+| `ONESHOT_ACCESS_TOKEN` | Option C | Agent access token (`oneshot_…`): credits-only session, cannot be combined with `ONESHOT_BUDGET_*` |
 | `ONESHOT_BUDGET_DAILY` | No | Max USDC the agent may spend per UTC day (spend budget, enforced server-side) |
 | `ONESHOT_BUDGET_PER_TRANSACTION` | No | Max USDC for any single call |
 | `ONESHOT_BUDGET_ALERT_AT` | No | Fraction of the daily budget that triggers a warning (default 0.8) |
@@ -92,6 +93,30 @@ Get CDP credentials at [Coinbase Agentic Wallet](https://docs.cdp.coinbase.com/a
 
 Read tools (inbox, SMS inbox, notifications, balance, browser profiles) return private, per-agent data. The server wraps the OneShot TypeScript SDK, which automatically signs a short-lived **EIP-712 read proof** (`x-agent-proof`) on each read so the API can verify you control the `X-Agent-ID` wallet. No configuration needed — this ships via `@oneshot-agent/sdk >= 0.25.0` (the bundled dependency). Read-proof verification is rolling out in log-only mode server-side, so older callers keep working until enforcement is enabled.
 
+## Remote (hosted)
+
+Clients that run in someone else's cloud — Grok Bot, hosted runners — cannot spawn this
+server and must not hold a wallet key. For them OneShot hosts the same 53 tools over
+Streamable HTTP at **`https://win.oneshotagent.com/mcp`**, authenticated with an
+**agent access token** and billed to the agent's credit balance:
+
+```json
+{
+  "mcpServers": {
+    "oneshot": {
+      "url": "https://win.oneshotagent.com/mcp",
+      "headers": { "Authorization": "Bearer ${env:ONESHOT_ACCESS_TOKEN}" }
+    }
+  }
+}
+```
+
+Mint a token from a wallet session with `agent.createAccessToken()` (`@oneshot-agent/sdk`
+≥ 0.33.0). Setup and billing details: https://docs.oneshotagent.com/sdk/remote-mcp
+
+The same token also works with this local server (≥ 0.20.0): set `ONESHOT_ACCESS_TOKEN`
+instead of the wallet variables for a credits-only session on your own machine.
+
 ## Available Tools
 
 ### Communication
@@ -168,6 +193,9 @@ Read tools (inbox, SMS inbox, notifications, balance, browser profiles) return p
 | `oneshot_compute_tasks` | List tasks planned/executed under a goal |
 | `oneshot_compute_cancel` | Cancel a goal and refund remaining budget |
 | `oneshot_compute_respond` | Respond to a human-in-the-loop task |
+| `oneshot_compute_pause` | Pause a recurring goal — plan and progress are kept |
+| `oneshot_compute_resume` | Resume a paused recurring goal |
+| `oneshot_compute_fund` | Top up a recurring goal's USDC budget |
 
 ### Domains
 
@@ -207,8 +235,9 @@ Use oneshot_email:
 - subject: "Hello from AI"
 - body: "<h1>Hello!</h1><p>This email was sent by an AI agent.</p>"
 - from_name: "Jane Doe"      (optional display name → "Jane Doe <jane@domain>")
-- from_mailbox: "jane"       (optional local-part, defaults to "agent")
-- from_domain: "acme.com"    (optional, defaults to "oneshotagent.com")
+- from_mailbox: "jane"       (optional local-part, defaults to "agent"; requires from_domain)
+- from_domain: "acme.com"    (optional, must be a domain you own; omit both from_domain and
+                              from_mailbox to rotate across your warmed domains)
 - mailbox_mode: "mailbox"    (optional, 'relay' (default) | 'mailbox' — dedicated per-address
                               mailbox; only when first provisioning a new from_domain)
 ```

package/dist/index.js

@@ -7,6 +7,7 @@ import { tools, handleToolCall } from "./tools/index.js";
 import { budgetConfigFromEnv } from "./budget-env.js";
 const CDP_KEY_ID = process.env.CDP_API_KEY_ID;
 const PRIVATE_KEY = process.env.ONESHOT_WALLET_PRIVATE_KEY;
+const ACCESS_TOKEN = process.env.ONESHOT_ACCESS_TOKEN;
 async function initAgent() {
     let budget;
     try {
@@ -19,6 +20,19 @@ async function initAgent() {
     }
     if (budget.budgets)
         console.error(`Spend budget: ${JSON.stringify(budget.budgets)}`);
+    if (ACCESS_TOKEN) {
+        // Option C: agent access token — credits-only, no key on this machine.
+        // Budgets are read-only for a token (a cap the token could raise is not
+        // a cap), so ONESHOT_BUDGET_* alongside it is a misconfiguration, not
+        // something to silently drop.
+        if (budget.budgets || budget.alerts) {
+            console.error("Error: ONESHOT_BUDGET_* cannot be combined with ONESHOT_ACCESS_TOKEN — budgets are read-only\n" +
+                "       for access-token sessions. Set them from a wallet session (SDK budgets config or the API).");
+            process.exit(1);
+        }
+        console.error("Using access token (credits-only session)");
+        return OneShot.create({ accessToken: ACCESS_TOKEN });
+    }
     if (CDP_KEY_ID) {
         // Preferred: Coinbase CDP Server Wallet (no private key exposure)
         console.error("Using Coinbase CDP wallet");
@@ -28,8 +42,8 @@ async function initAgent() {
         // Fallback: raw private key
         return new OneShot({ privateKey: PRIVATE_KEY, ...budget });
     }
-    console.error("Error: Set CDP_API_KEY_ID + CDP_API_KEY_SECRET + CDP_WALLET_SECRET (recommended)\n" +
-        "       or ONESHOT_WALLET_PRIVATE_KEY");
+    console.error("Error: Set CDP_API_KEY_ID + CDP_API_KEY_SECRET + CDP_WALLET_SECRET (recommended),\n" +
+        "       ONESHOT_WALLET_PRIVATE_KEY, or ONESHOT_ACCESS_TOKEN (credits-only session)");
     process.exit(1);
 }
 // Start server
@@ -38,7 +52,7 @@ async function main() {
     // Create MCP server
     const server = new Server({
         name: "oneshot-mcp",
-        version: "0.19.0", // keep in sync with package.json; guarded by version.test.ts
+        version: "0.21.0", // keep in sync with package.json; guarded by version.test.ts
     }, {
         capabilities: {
             tools: {},

package/dist/tools/analytics.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const spendBreakdownTool: Tool;
 export declare const rocsTool: Tool;
 export declare const receiptsListTool: Tool;

package/dist/tools/browser.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const browserTool: Tool;
 export declare const browserCreateProfileTool: Tool;
 export declare const browserListProfilesTool: Tool;

package/dist/tools/build.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const buildTool: Tool;
 export declare const updateBuildTool: Tool;
 export declare function handleBuild(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").BuildResult>;

package/dist/tools/commerce.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const commerceSearchTool: Tool;
 export declare const commerceBuyTool: Tool;
 export declare function handleCommerceSearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").CommerceSearchResult>;

package/dist/tools/company.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const companySearchTool: Tool;
 export declare const enrichCompanyTool: Tool;
 export declare function handleCompanySearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").CompanySearchResult>;

package/dist/tools/compute.d.ts

@@ -1,10 +1,13 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const computeTool: Tool;
 export declare const computeStatusTool: Tool;
 export declare const computeTasksTool: Tool;
 export declare const computeCancelTool: Tool;
 export declare const computeRespondTool: Tool;
+export declare const computePauseTool: Tool;
+export declare const computeResumeTool: Tool;
+export declare const computeFundTool: Tool;
 export declare function handleCompute(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").ComputeGoalResult>;
 export declare function handleComputeStatus(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").ComputeGoalStatus>;
 export declare function handleComputeTasks(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").ComputeTask[]>;
@@ -19,3 +22,20 @@ export declare function handleComputeRespond(agent: OneShot, args: Record<string
     task_status: string;
     orchestrator_action: string;
 }>;
+export declare function handleComputePause(agent: OneShot, args: Record<string, unknown>): Promise<{
+    goal_id: string;
+    status: string;
+    run_count: number;
+}>;
+export declare function handleComputeResume(agent: OneShot, args: Record<string, unknown>): Promise<{
+    goal_id: string;
+    status: string;
+    next_run_at: string;
+    run_count: number;
+}>;
+export declare function handleComputeFund(agent: OneShot, args: Record<string, unknown>): Promise<{
+    goal_id: string;
+    topped_up: number;
+    total_budget: string;
+    remaining: string;
+}>;

package/dist/tools/compute.js

@@ -86,6 +86,41 @@ export const computeRespondTool = {
         required: ["goal_id", "task_id"],
     },
 };
+export const computePauseTool = {
+    name: "oneshot_compute_pause",
+    description: "Pause a recurring compute goal. Its plan and progress are kept — the goal stops taking scheduled runs until resumed. Only recurring (scheduled) goals can be paused. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            goal_id: { type: "string", description: "Compute goal id" },
+            reason: { type: "string", description: "Optional pause reason" },
+        },
+        required: ["goal_id"],
+    },
+};
+export const computeResumeTool = {
+    name: "oneshot_compute_resume",
+    description: "Resume a paused recurring compute goal. Picks up on the existing plan at the next scheduled run — nothing is lost. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            goal_id: { type: "string", description: "Compute goal id" },
+        },
+        required: ["goal_id"],
+    },
+};
+export const computeFundTool = {
+    name: "oneshot_compute_fund",
+    description: "Top up the USDC budget of a recurring compute goal that is running low or has hit its cap. Quote-to-pay: moves USDC into the goal. Paid tool.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            goal_id: { type: "string", description: "Compute goal id" },
+            amount: { type: "number", description: "Amount of USDC to add to the goal's budget" },
+        },
+        required: ["goal_id", "amount"],
+    },
+};
 export async function handleCompute(agent, args) {
     return agent.compute({
         objective: args.objective,
@@ -113,3 +148,12 @@ export async function handleComputeRespond(agent, args) {
         approved: args.approved,
     });
 }
+export async function handleComputePause(agent, args) {
+    return agent.pauseComputeGoal(args.goal_id, args.reason);
+}
+export async function handleComputeResume(agent, args) {
+    return agent.resumeComputeGoal(args.goal_id);
+}
+export async function handleComputeFund(agent, args) {
+    return agent.fundComputeGoal(args.goal_id, args.amount);
+}

package/dist/tools/domains.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const listDomainsTool: Tool;
 export declare const pauseDomainTool: Tool;
 export declare const resumeDomainTool: Tool;

package/dist/tools/email.d.ts

@@ -1,4 +1,4 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const emailTool: Tool;
 export declare function handleEmail(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").EmailResult>;

package/dist/tools/email.js

@@ -22,11 +22,11 @@ export const emailTool = {
             },
             from_domain: {
                 type: "string",
-                description: "Custom sender domain (optional, defaults to oneshotagent.com)",
+                description: "Domain to send from (must be one you own). Omit both from_domain and from_mailbox to rotate across your warmed domains — the chosen address comes back on the quote.",
             },
             from_mailbox: {
                 type: "string",
-                description: "Sender mailbox / local-part (optional, defaults to 'agent', i.e. agent@from_domain). You can use any local-part — a new address is auto-provisioned on first use (starts unwarmed, warms over time). The FIRST send from any address — including the default 'agent@' — adds a one-time mailbox_provisioning_fee to the quote; it's free only once that address is already provisioned (active). See the domains list for each domain's default_from and existing addresses.",
+                description: "Sender mailbox / local-part (optional, defaults to 'agent', i.e. agent@from_domain). Requires from_domain to be set — pinning from_mailbox alone is rejected, since there is no domain to attach it to. You can use any local-part — a new address is auto-provisioned on first use (starts unwarmed, warms over time). The FIRST send from any address — including the default 'agent@' — adds a one-time mailbox_provisioning_fee to the quote; it's free only once that address is already provisioned (active). See the domains list for each domain's default_from and existing addresses.",
             },
             from_name: {
                 type: "string",

package/dist/tools/enrichment.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const enrichProfileTool: Tool;
 export declare const findEmailTool: Tool;
 export declare const verifyEmailTool: Tool;

package/dist/tools/gov.d.ts

@@ -1,4 +1,4 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const govSolicitationsTool: Tool;
 export declare function handleGovSolicitations(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").GovSolicitationsResult>;

package/dist/tools/inbox.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const inboxListTool: Tool;
 export declare const inboxGetTool: Tool;
 export declare function handleInboxList(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").InboxListResult>;

package/dist/tools/index.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const tools: Tool[];
 export declare function handleToolCall(agent: OneShot, toolName: string, args: Record<string, unknown>): Promise<{
     content: {
@@ -14,3 +14,10 @@ export declare function handleToolCall(agent: OneShot, toolName: string, args: R
     }[];
     isError?: undefined;
 }>;
+/**
+ * Typed SDK errors become a JSON body the model can act on instead of a
+ * prose string. Matched on `name`, never `instanceof`: the hosted server runs
+ * the workspace SDK while this registry's types come from the published one,
+ * so the classes are different objects at runtime.
+ */
+export declare function structuredToolError(error: unknown): Record<string, unknown> | undefined;

package/dist/tools/index.js

@@ -17,7 +17,7 @@ import { deepResearchPersonTool, socialProfilesTool, articleSearchTool, personNe
 import { companySearchTool, enrichCompanyTool, handleCompanySearch, handleEnrichCompany } from "./company.js";
 import { localSearchTool, localResolveTool, handleLocalSearch, handleLocalResolve } from "./local.js";
 import { govSolicitationsTool, handleGovSolicitations } from "./gov.js";
-import { computeTool, computeStatusTool, computeTasksTool, computeCancelTool, computeRespondTool, handleCompute, handleComputeStatus, handleComputeTasks, handleComputeCancel, handleComputeRespond } from "./compute.js";
+import { computeTool, computeStatusTool, computeTasksTool, computeCancelTool, computeRespondTool, computePauseTool, computeResumeTool, computeFundTool, handleCompute, handleComputeStatus, handleComputeTasks, handleComputeCancel, handleComputeRespond, handleComputePause, handleComputeResume, handleComputeFund } from "./compute.js";
 import { listDomainsTool, pauseDomainTool, resumeDomainTool, handleListDomains, handlePauseDomain, handleResumeDomain } from "./domains.js";
 import { spendBreakdownTool, rocsTool, rocsByGoalTool, receiptsListTool, tagReceiptValueTool, handleSpendBreakdown, handleRocs, handleRocsByGoal, handleReceiptsList, handleTagReceiptValue } from "./analytics.js";
 // All available tools
@@ -58,6 +58,9 @@ export const tools = [
     computeTasksTool,
     computeCancelTool,
     computeRespondTool,
+    computePauseTool,
+    computeResumeTool,
+    computeFundTool,
     // Build
     buildTool,
     updateBuildTool,
@@ -122,6 +125,9 @@ const handlers = {
     "oneshot_compute_tasks": handleComputeTasks,
     "oneshot_compute_cancel": handleComputeCancel,
     "oneshot_compute_respond": handleComputeRespond,
+    "oneshot_compute_pause": handleComputePause,
+    "oneshot_compute_resume": handleComputeResume,
+    "oneshot_compute_fund": handleComputeFund,
     // Build
     "oneshot_build": handleBuild,
     "oneshot_update_build": handleUpdateBuild,
@@ -164,9 +170,45 @@ export async function handleToolCall(agent, toolName, args) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
+        const structured = structuredToolError(error);
         return {
-            content: [{ type: "text", text: `Error: ${message}` }],
+            content: [{ type: "text", text: structured ? JSON.stringify(structured, null, 2) : `Error: ${message}` }],
             isError: true,
         };
     }
 }
+/**
+ * Typed SDK errors become a JSON body the model can act on instead of a
+ * prose string. Matched on `name`, never `instanceof`: the hosted server runs
+ * the workspace SDK while this registry's types come from the published one,
+ * so the classes are different objects at runtime.
+ */
+export function structuredToolError(error) {
+    const e = error;
+    if (!e || typeof e !== "object")
+        return undefined;
+    switch (e.name) {
+        case "BudgetExceededError":
+            return {
+                error: "budget_exceeded",
+                message: e.message,
+                reason: e.reason,
+                cap: e.cap,
+                spent: e.spent,
+                charge: e.charge,
+                resets_at: e.resetsAt,
+            };
+        case "InsufficientCreditsError":
+            return {
+                error: "insufficient_credits",
+                message: e.message,
+                required_usdc: e.required,
+                credits_balance: e.balance,
+                shortfall_usdc: e.shortfall,
+            };
+        case "PaymentError":
+            return { error: "payment_failed", message: e.message, reason: e.reason };
+        default:
+            return undefined;
+    }
+}

package/dist/tools/local.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const localSearchTool: Tool;
 export declare const localResolveTool: Tool;
 export declare function handleLocalSearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").LocalSearchResult>;

package/dist/tools/notifications.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const notificationsTool: Tool;
 export declare const markReadTool: Tool;
 export declare function handleNotifications(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").NotificationsResult>;

package/dist/tools/nyne.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const deepResearchPersonTool: Tool;
 export declare const socialProfilesTool: Tool;
 export declare const articleSearchTool: Tool;

package/dist/tools/people.d.ts

@@ -1,4 +1,4 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const peopleSearchTool: Tool;
 export declare function handlePeopleSearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PeopleSearchResult>;

package/dist/tools/research.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const researchTool: Tool;
 /**
  * Wait budget per depth. The SDK's default is 120s, but deep research runs

package/dist/tools/search.d.ts

@@ -1,4 +1,4 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const webSearchTool: Tool;
 export declare function handleWebSearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").WebSearchResult>;

package/dist/tools/sms-inbox.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const smsInboxListTool: Tool;
 export declare const smsInboxGetTool: Tool;
 export declare function handleSmsInboxList(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").SmsInboxResult>;

package/dist/tools/sms.d.ts

@@ -1,4 +1,4 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const smsTool: Tool;
 export declare function handleSms(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").SmsSendResult>;

package/dist/tools/voice.d.ts

@@ -1,4 +1,4 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const voiceTool: Tool;
 export declare function handleVoice(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").VoiceCallResult>;

package/dist/tools/wallet.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const getBalanceTool: Tool;
 export declare function handleGetBalance(agent: OneShot, _args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").UnifiedBalance>;
 export declare const budgetStatusTool: Tool;

package/dist/tools/wallet.js

@@ -15,7 +15,8 @@ export const budgetStatusTool = {
     description: "Read-only: today's spend versus the agent's configured spend budget — daily cap, per-call cap, " +
         "spent_today_usdc, remaining_usdc, pct_used and resets_at (next UTC midnight). Use it to plan " +
         "remaining work; paid calls are rejected with budget_exceeded once the cap is reached. The budget " +
-        "itself is set by the operator via ONESHOT_BUDGET_* env vars and cannot be changed from here. Free.",
+        "itself is set by the operator (ONESHOT_BUDGET_* env vars on a local server, the SDK or API for the " +
+        "hosted endpoint) and cannot be changed from here. Free.",
     inputSchema: {
         type: "object",
         properties: {},

package/dist/tools/web-read.d.ts

@@ -1,4 +1,4 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const webReadTool: Tool;
 export declare function handleWebRead(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").WebReadResult>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oneshot-agent/mcp-server",
-  "version": "0.19.0",
-  "description": "MCP server for OneShot - 50 tools for AI agents",
+  "version": "0.21.0",
+  "description": "MCP server for OneShot - 53 tools for AI agents",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -25,7 +25,7 @@
   "dependencies": {
     "@coinbase/cdp-sdk": "1.45.0",
     "@modelcontextprotocol/sdk": "1.27.1",
-    "@oneshot-agent/sdk": "^0.31.0",
+    "@oneshot-agent/sdk": "^0.33.0",
     "zod": "3.25.76"
   },
   "devDependencies": {