@oneshot-agent/mcp-server 0.30.0 → 0.32.0

package/dist/index.js

@@ -46,23 +46,19 @@ async function initAgent() {
         "       ONESHOT_WALLET_PRIVATE_KEY, or ONESHOT_ACCESS_TOKEN (credits-only session)");
     process.exit(1);
 }
-// Start server
 async function main() {
     const agent = await initAgent();
-    // Create MCP server
     const server = new Server({
         name: "oneshot-mcp",
-        version: "0.30.0", // keep in sync with package.json; guarded by version.test.ts
+        version: "0.32.0", // keep in sync with package.json; guarded by version.test.ts
     }, {
         capabilities: {
             tools: {},
         },
     });
-    // List available tools
     server.setRequestHandler(ListToolsRequestSchema, async () => {
         return { tools };
     });
-    // Handle tool calls
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
         return handleToolCall(agent, name, args || {});

package/dist/tools/annotations.js

@@ -6,22 +6,18 @@ const OPEN = true;
 const OWN = false;
 const DESTRUCTIVE = true;
 export const TOOL_ANNOTATIONS = {
-    // Communication
     oneshot_email: write("Send email", OPEN),
     oneshot_voice: write("Place a phone call", OPEN),
     oneshot_sms: write("Send a text message", OPEN),
-    // Inbox
     oneshot_inbox_list: read("List received emails", OWN),
     oneshot_inbox_get: read("Read a received email", OWN),
     oneshot_sms_inbox_list: read("List received texts", OWN),
     oneshot_sms_inbox_get: read("Read a received text", OWN),
-    // Inbound voice
     oneshot_voice_number_provision: write("Get a phone number", OPEN),
     oneshot_voice_numbers: read("List phone numbers", OWN),
-    oneshot_voice_inbound_set: write("Set up call answering", OWN, DESTRUCTIVE), // replaces the number's answering settings
-    oneshot_voice_inbound_disable: write("Stop answering calls", OWN),
+    oneshot_voice_inbound_set: write("Set up call answering", OPEN, DESTRUCTIVE), // replaces the number's answering settings; outside callers reach it via the carrier
+    oneshot_voice_inbound_disable: write("Stop answering calls", OPEN),
     oneshot_voice_inbound_calls: read("List answered calls", OWN),
-    // Research & enrichment
     oneshot_research: read("Deep research", OPEN),
     oneshot_people_search: read("Find people", OPEN),
     oneshot_enrich_profile: read("Look up a person's profile", OPEN),
@@ -39,10 +35,8 @@ export const TOOL_ANNOTATIONS = {
     oneshot_local_search: read("Find local businesses", OPEN),
     oneshot_local_resolve: read("Look up a local business", OPEN),
     oneshot_gov_solicitations: read("Find government contracts", OPEN),
-    // Commerce
     oneshot_commerce_search: read("Search products", OPEN),
     oneshot_commerce_buy: write("Buy a product", OPEN),
-    // Compute orchestration
     oneshot_compute: write("Start a goal", OPEN),
     oneshot_compute_status: read("Check a goal", OWN),
     oneshot_compute_tasks: read("List a goal's tasks", OWN),
@@ -51,17 +45,13 @@ export const TOOL_ANNOTATIONS = {
     oneshot_compute_pause: write("Pause a goal", OWN),
     oneshot_compute_resume: write("Resume a goal", OWN),
     oneshot_compute_fund: write("Add budget to a goal", OWN),
-    // Build
     oneshot_build: write("Build a website", OPEN),
     oneshot_update_build: write("Update a website", OPEN, DESTRUCTIVE), // overwrites the live site
-    // Browser
     oneshot_browser: write("Browse and act on a website", OPEN),
     oneshot_browser_create_profile: write("Create a browser profile", OWN),
     oneshot_browser_list_profiles: read("List browser profiles", OWN),
     oneshot_browser_delete_profile: write("Delete a browser profile", OWN, DESTRUCTIVE),
-    // Web read
     oneshot_web_read: read("Read a web page", OPEN),
-    // LinkedIn
     oneshot_linkedin_connect: write("Connect LinkedIn", OPEN),
     oneshot_linkedin_accounts: read("List LinkedIn accounts", OWN),
     oneshot_linkedin_sync: write("Sync LinkedIn messages", OPEN), // paid; imports history into the account
@@ -72,22 +62,18 @@ export const TOOL_ANNOTATIONS = {
     oneshot_linkedin_withdraw_invitation: write("Withdraw a LinkedIn invitation", OPEN, DESTRUCTIVE),
     oneshot_linkedin_view_profile: write("View a LinkedIn profile", OPEN), // notify=true is visible to the person
     oneshot_linkedin_react: write("React to a LinkedIn post", OPEN),
-    // Domains
     oneshot_list_domains: read("List sending domains", OWN),
     oneshot_pause_domain: write("Pause a sending domain", OWN),
     oneshot_resume_domain: write("Resume a sending domain", OWN),
-    // Analytics
     oneshot_spend_breakdown: read("Show spending", OWN),
     oneshot_return_on_spend: read("Show return on spend", OWN),
     oneshot_return_on_spend_by_goal: read("Show return on spend by goal", OWN),
     oneshot_receipts_list: read("List receipts", OWN),
     oneshot_tag_receipt_value: write("Tag a receipt's value", OWN),
-    // Account
     oneshot_notifications: read("List notifications", OWN),
     oneshot_mark_notification_read: write("Mark a notification read", OWN),
     oneshot_get_balance: read("Check balance", OWN),
     oneshot_budget_status: read("Check budget", OWN),
-    // Approvals
     oneshot_approval_create: write("Ask a person to approve", OPEN),
     oneshot_approval_get: read("Check an approval", OWN),
     oneshot_approval_list: read("List approvals", OWN),

package/dist/tools/approvals.js

@@ -1,6 +1,5 @@
-// Approvals: ask a named human, read decisions, and read (never loosen) the
-// action policy. Setting the policy is deliberately not exposed here — an
-// agent that could edit its own policy would make the policy meaningless.
+// Setting the action policy is deliberately not exposed here — an agent that
+// could loosen its own policy would make the policy meaningless.
 export const approvalCreateTool = {
     name: "oneshot_approval_create",
     description: "Ask a named human to approve or deny something before you do it. They get a one-tap link by email or SMS. " +

package/dist/tools/build.js

@@ -1,12 +1,12 @@
 export const buildTool = {
     name: "oneshot_build",
-    description: "Build and deploy production websites - SaaS landing pages, portfolios, agency sites, restaurant pages, event sites, and more. Creates fully-functional sites with real hosting. Paid tool — quote provided before payment.",
+    description: "Build and deploy production websites - SaaS landing pages, portfolios, agency sites, restaurant pages, event sites, and more, single-page or multi-page (pages). Creates fully-functional sites with real hosting. Paid tool — quote provided before payment.",
     inputSchema: {
         type: "object",
         properties: {
             type: {
                 type: "string",
-                enum: ["saas", "portfolio", "agency", "personal", "product", "funnel", "restaurant", "event", "app", "social"],
+                enum: ["saas", "portfolio", "agency", "personal", "product", "funnel", "restaurant", "event"],
                 description: "Build type (default: saas)",
             },
             product: {
@@ -40,6 +40,21 @@ export const buildTool = {
                 items: { type: "string" },
                 description: "Specific sections to include (e.g., ['hero', 'features', 'pricing', 'testimonials'])",
             },
+            pages: {
+                type: "array",
+                maxItems: 8,
+                description: "Extra pages beyond the home page, each priced separately (e.g., [{ path: '/pricing', name: 'Pricing' }, { path: '/about', name: 'About', purpose: 'Team and story' }])",
+                items: {
+                    type: "object",
+                    properties: {
+                        path: { type: "string", description: "Route: lowercase words and hyphens, e.g. /pricing or /blog/launch" },
+                        name: { type: "string", description: "Nav label" },
+                        purpose: { type: "string", description: "What the page is for" },
+                        sections: { type: "array", items: { type: "string" }, description: "Sections for this page" },
+                    },
+                    required: ["path", "name"],
+                },
+            },
             lead_capture: {
                 type: "object",
                 properties: {
@@ -98,7 +113,7 @@ export const buildTool = {
 };
 export const updateBuildTool = {
     name: "oneshot_update_build",
-    description: "Update an existing website with new content or configuration. Requires the build_id from a previous build. Updates reuse existing hosting infrastructure at a discounted rate.",
+    description: "Change an existing website. With `changes` (plain-language edits, e.g. 'make the hero darker and add an FAQ page'), the site's existing code is edited and redeployed to the same URL at a flat price. With `product` and no `changes`, the site is regenerated from scratch at a discounted rate. Requires the build_id from a previous build.",
     inputSchema: {
         type: "object",
         properties: {
@@ -106,6 +121,10 @@ export const updateBuildTool = {
                 type: "string",
                 description: "Existing build ID to update (from previous build result)",
             },
+            changes: {
+                type: "string",
+                description: "Plain-language edits to apply to the existing site (keeps everything else). Max 5000 chars.",
+            },
             product: {
                 type: "object",
                 properties: {
@@ -130,7 +149,7 @@ export const updateBuildTool = {
             },
             type: {
                 type: "string",
-                enum: ["saas", "portfolio", "agency", "personal", "product", "funnel", "restaurant", "event", "app", "social"],
+                enum: ["saas", "portfolio", "agency", "personal", "product", "funnel", "restaurant", "event"],
                 description: "Build type (optional, keeps existing if not specified)",
             },
             source_url: {
@@ -142,6 +161,21 @@ export const updateBuildTool = {
                 items: { type: "string" },
                 description: "Specific sections to include",
             },
+            pages: {
+                type: "array",
+                maxItems: 8,
+                description: "Extra pages beyond the home page, each priced separately (e.g., [{ path: '/pricing', name: 'Pricing' }, { path: '/about', name: 'About', purpose: 'Team and story' }])",
+                items: {
+                    type: "object",
+                    properties: {
+                        path: { type: "string", description: "Route: lowercase words and hyphens, e.g. /pricing or /blog/launch" },
+                        name: { type: "string", description: "Nav label" },
+                        purpose: { type: "string", description: "What the page is for" },
+                        sections: { type: "array", items: { type: "string" }, description: "Sections for this page" },
+                    },
+                    required: ["path", "name"],
+                },
+            },
             lead_capture: {
                 type: "object",
                 properties: {
@@ -169,7 +203,7 @@ export const updateBuildTool = {
                 description: "Custom domain",
             },
         },
-        required: ["build_id", "product"],
+        required: ["build_id"],
     },
 };
 export async function handleBuild(agent, args) {
@@ -184,6 +218,7 @@ export async function handleBuild(agent, args) {
         },
         source_url: args.source_url,
         sections: args.sections,
+        pages: args.pages,
         lead_capture: args.lead_capture,
         brand: args.brand,
         images: args.images,
@@ -192,7 +227,13 @@ export async function handleBuild(agent, args) {
     });
 }
 export async function handleUpdateBuild(agent, args) {
+    if (typeof args.changes === "string" && args.changes.trim()) {
+        return agent.refineBuild({ build_id: args.build_id, changes: args.changes });
+    }
     const product = args.product;
+    if (!product) {
+        throw new Error("oneshot_update_build needs either changes (to edit the site) or product (to regenerate it)");
+    }
     return agent.updateBuild({
         build_id: args.build_id,
         product: {
@@ -204,6 +245,7 @@ export async function handleUpdateBuild(agent, args) {
         type: args.type,
         source_url: args.source_url,
         sections: args.sections,
+        pages: args.pages,
         lead_capture: args.lead_capture,
         brand: args.brand,
         images: args.images,

package/dist/tools/index.js

@@ -24,24 +24,19 @@ import { computeTool, computeStatusTool, computeTasksTool, computeCancelTool, co
 import { listDomainsTool, pauseDomainTool, resumeDomainTool, handleListDomains, handlePauseDomain, handleResumeDomain } from "./domains.js";
 import { TOOL_ANNOTATIONS } from "./annotations.js";
 import { spendBreakdownTool, rocsTool, rocsByGoalTool, receiptsListTool, tagReceiptValueTool, handleSpendBreakdown, handleRocs, handleRocsByGoal, handleReceiptsList, handleTagReceiptValue } from "./analytics.js";
-// All available tools, before annotations
 const toolDefinitions = [
-    // Communication
     emailTool,
     voiceTool,
     smsTool,
-    // Inbox
     inboxListTool,
     inboxGetTool,
     smsInboxListTool,
     smsInboxGetTool,
-    // Inbound voice
     voiceNumberProvisionTool,
     voiceNumbersTool,
     voiceInboundSetTool,
     voiceInboundDisableTool,
     voiceInboundCallsTool,
-    // Research & Enrichment
     researchTool,
     peopleSearchTool,
     enrichProfileTool,
@@ -59,10 +54,8 @@ const toolDefinitions = [
     localSearchTool,
     localResolveTool,
     govSolicitationsTool,
-    // Commerce
     commerceSearchTool,
     commerceBuyTool,
-    // Compute orchestration
     computeTool,
     computeStatusTool,
     computeTasksTool,
@@ -71,17 +64,13 @@ const toolDefinitions = [
     computePauseTool,
     computeResumeTool,
     computeFundTool,
-    // Build
     buildTool,
     updateBuildTool,
-    // Browser
     browserTool,
     browserCreateProfileTool,
     browserListProfilesTool,
     browserDeleteProfileTool,
-    // Web Read
     webReadTool,
-    // LinkedIn (human-connected account)
     linkedinConnectTool,
     linkedinAccountsTool,
     linkedinSyncTool,
@@ -91,22 +80,18 @@ const toolDefinitions = [
     linkedinInviteTool, linkedinWithdrawInvitationTool,
     linkedinViewProfileTool,
     linkedinReactTool,
-    // Domains
     listDomainsTool,
     pauseDomainTool,
     resumeDomainTool,
-    // Analytics
     spendBreakdownTool,
     rocsTool,
     rocsByGoalTool,
     receiptsListTool,
     tagReceiptValueTool,
-    // Account
     notificationsTool,
     markReadTool,
     getBalanceTool,
     budgetStatusTool,
-    // Approvals
     approvalCreateTool,
     approvalGetTool,
     approvalListTool,
@@ -121,24 +106,19 @@ export const tools = toolDefinitions.map((tool) => {
         throw new Error(`Tool ${tool.name} has no annotations — add it to tools/annotations.ts`);
     return { ...tool, title: hints.title, annotations: { ...hints } };
 });
-// Tool handlers map
 const handlers = {
-    // Communication
     "oneshot_email": handleEmail,
     "oneshot_voice": handleVoice,
     "oneshot_sms": handleSms,
-    // Inbox
     "oneshot_inbox_list": handleInboxList,
     "oneshot_inbox_get": handleInboxGet,
     "oneshot_sms_inbox_list": handleSmsInboxList,
     "oneshot_sms_inbox_get": handleSmsInboxGet,
-    // Inbound voice
     "oneshot_voice_number_provision": handleVoiceNumberProvision,
     "oneshot_voice_numbers": handleVoiceNumbers,
     "oneshot_voice_inbound_set": handleVoiceInboundSet,
     "oneshot_voice_inbound_disable": handleVoiceInboundDisable,
     "oneshot_voice_inbound_calls": handleVoiceInboundCalls,
-    // Research & Enrichment
     "oneshot_research": handleResearch,
     "oneshot_people_search": handlePeopleSearch,
     "oneshot_enrich_profile": handleEnrichProfile,
@@ -156,10 +136,8 @@ const handlers = {
     "oneshot_local_search": handleLocalSearch,
     "oneshot_local_resolve": handleLocalResolve,
     "oneshot_gov_solicitations": handleGovSolicitations,
-    // Commerce
     "oneshot_commerce_search": handleCommerceSearch,
     "oneshot_commerce_buy": handleCommerceBuy,
-    // Compute orchestration
     "oneshot_compute": handleCompute,
     "oneshot_compute_status": handleComputeStatus,
     "oneshot_compute_tasks": handleComputeTasks,
@@ -168,17 +146,13 @@ const handlers = {
     "oneshot_compute_pause": handleComputePause,
     "oneshot_compute_resume": handleComputeResume,
     "oneshot_compute_fund": handleComputeFund,
-    // Build
     "oneshot_build": handleBuild,
     "oneshot_update_build": handleUpdateBuild,
-    // Browser
     "oneshot_browser": handleBrowser,
     "oneshot_browser_create_profile": handleBrowserCreateProfile,
     "oneshot_browser_list_profiles": handleBrowserListProfiles,
     "oneshot_browser_delete_profile": handleBrowserDeleteProfile,
-    // Web Read
     "oneshot_web_read": handleWebRead,
-    // LinkedIn (human-connected account)
     "oneshot_linkedin_connect": handleLinkedinConnect,
     "oneshot_linkedin_accounts": handleLinkedinAccounts,
     "oneshot_linkedin_sync": handleLinkedinSync,
@@ -189,22 +163,18 @@ const handlers = {
     "oneshot_linkedin_withdraw_invitation": handleLinkedinWithdrawInvitation,
     "oneshot_linkedin_view_profile": handleLinkedinViewProfile,
     "oneshot_linkedin_react": handleLinkedinReact,
-    // Domains
     "oneshot_list_domains": handleListDomains,
     "oneshot_pause_domain": handlePauseDomain,
     "oneshot_resume_domain": handleResumeDomain,
-    // Analytics
     "oneshot_spend_breakdown": handleSpendBreakdown,
     "oneshot_return_on_spend": handleRocs,
     "oneshot_return_on_spend_by_goal": handleRocsByGoal,
     "oneshot_receipts_list": handleReceiptsList,
     "oneshot_tag_receipt_value": handleTagReceiptValue,
-    // Account
     "oneshot_notifications": handleNotifications,
     "oneshot_mark_notification_read": handleMarkRead,
     "oneshot_get_balance": handleGetBalance,
     "oneshot_budget_status": handleBudgetStatus,
-    // Approvals
     "oneshot_approval_create": handleApprovalCreate,
     "oneshot_approval_get": handleApprovalGet,
     "oneshot_approval_list": handleApprovalList,

package/dist/tools/linkedin.js

@@ -1,10 +1,8 @@
 /**
  * LinkedIn messaging through a human-connected account (issue #756).
- *
- * The human connects their own LinkedIn account via a hosted login link and
- * grants specific actions (read, reply, view_profile, react, invite). Reconnect and
- * revoke are deliberately NOT exposed as MCP tools — a human decides those
- * from the application that owns the account.
+ * The human grants specific actions (read, reply, view_profile, react, invite)
+ * via a hosted login link; reconnect/revoke are deliberately NOT exposed here —
+ * a human decides those from the application that owns the account.
  */
 const GRANT_ACTIONS = ["read", "reply", "view_profile", "react", "invite", "comment"];
 export const linkedinConnectTool = {

package/dist/tools/nyne.js

@@ -72,7 +72,6 @@ export const personInteractionsTool = {
         required: ["social_media_url"],
     },
 };
-// Handlers
 /** Deep person research fans out across several providers; the SDK's 120s default was too short. */
 export const DEEP_RESEARCH_PERSON_TIMEOUT_SEC = 300;
 export async function handleDeepResearchPerson(agent, args) {

package/dist/tools/research.d.ts

@@ -2,10 +2,9 @@ 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
- * 2–5 minutes (as the tool description says), so every deep call used to end
- * in JobTimeoutError while the job kept running. Results are pushed the
- * moment they exist, so a generous ceiling costs nothing on fast jobs.
+ * The SDK's 120s default is too short for deep research (runs 2-5min);
+ * results are pushed the moment they exist, so a generous ceiling costs
+ * nothing on fast jobs.
  */
 export declare const RESEARCH_TIMEOUT_SEC: Record<"quick" | "deep", number>;
 export declare function handleResearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").ResearchResult>;

package/dist/tools/research.js

@@ -27,10 +27,9 @@ export const researchTool = {
     },
 };
 /**
- * Wait budget per depth. The SDK's default is 120s, but deep research runs
- * 2–5 minutes (as the tool description says), so every deep call used to end
- * in JobTimeoutError while the job kept running. Results are pushed the
- * moment they exist, so a generous ceiling costs nothing on fast jobs.
+ * The SDK's 120s default is too short for deep research (runs 2-5min);
+ * results are pushed the moment they exist, so a generous ceiling costs
+ * nothing on fast jobs.
  */
 export const RESEARCH_TIMEOUT_SEC = { quick: 180, deep: 600 };
 export async function handleResearch(agent, args) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneshot-agent/mcp-server",
-  "version": "0.30.0",
+  "version": "0.32.0",
   "description": "MCP server for OneShot - 73 tools for AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -25,7 +25,7 @@
   "dependencies": {
     "@coinbase/cdp-sdk": "1.45.0",
     "@modelcontextprotocol/sdk": "1.27.1",
-    "@oneshot-agent/sdk": "^0.44.0",
+    "@oneshot-agent/sdk": "^0.46.0",
     "zod": "3.25.76"
   },
   "devDependencies": {