@oneshot-agent/mcp-server 0.51.0 → 0.52.0

package/README.md

@@ -84,10 +84,10 @@ Every tool is named `oneshot_<name>`. Below are the names.
 | [Think](https://docs.oneshotagent.com/api-reference/research) | `research` `predict` `solve` |
 | [Web and buying](https://docs.oneshotagent.com/api-reference/web-search) | `web_search` `web_read` `browser` `product_find` `commerce_buy` |
 | [Physical mail](https://docs.oneshotagent.com/api-reference/physical-mail/overview) | `physical_mail_upload` `physical_mail_validate_address` `physical_mail_preview` `physical_mail_quote` `physical_mail_approve` `physical_mail_send` `physical_mail_recover` `physical_mail_order` `physical_mail_cancel` |
-| [Connected systems](https://docs.oneshotagent.com/api-reference/connections/overview) | `connections_list` `ledger_invoices` `ledger_invoice_lines` `ledger_bills` `ledger_reports` `ledger_bank_transactions` `crm_accounts` `crm_contacts` `crm_opportunities` `crm_tickets` `crm_activity` `tax_rates` `tax_calculate` `shipping_shipments` `shipping_tracking` `shipping_rates` `procurement_transactions` `procurement_bills` `procurement_suppliers` `meetings_list` `meetings_get` `field_service_clients` `field_service_jobs` `field_service_quotes` `field_service_invoices` |
+| [Connected systems](https://docs.oneshotagent.com/api-reference/connections/overview) | `connections_list` `ledger_invoices` `ledger_invoice_lines` `ledger_bills` `ledger_reports` `ledger_bank_transactions` `crm_accounts` `crm_contacts` `crm_opportunities` `crm_tickets` `crm_activity` `tax_rates` `tax_calculate` `shipping_shipments` `shipping_tracking` `shipping_rates` `procurement_transactions` `procurement_bills` `procurement_suppliers` `meetings_list` `meetings_get` `field_service_clients` `field_service_jobs` `field_service_quotes` `field_service_invoices` `client_work_clients` `client_work_items` `client_work_timesheets` |
 | [LinkedIn](https://docs.oneshotagent.com/api-reference/linkedin/overview) | `linkedin_connect` `linkedin_accounts` `linkedin_invite` `linkedin_message` `linkedin_reply` and more |
 | [Build](https://docs.oneshotagent.com/api-reference/build/create) | `build` `update_build` |
-| [Goals](https://docs.oneshotagent.com/api-reference/compute/create) | `compute` `compute_status` `compute_tasks` `compute_respond` `compute_pause` `compute_resume` `compute_fund` `compute_cancel` |
+| [Goals](https://docs.oneshotagent.com/api-reference/compute/create) | `compute` `compute_status` `compute_tasks` `compute_respond` `compute_pause` `compute_resume` `compute_fund` `compute_cancel`. `compute` adds `quote_text` for bound hires (public soul identity and service) and unmatched specialist questions, without prices. Starting proceeds without unmatched specialists. Otherwise, the usual goal result is returned. |
 | [Money and receipts](https://docs.oneshotagent.com/api-reference/analytics/overview) | `get_balance` `budget_status` `spend_breakdown` `return_on_spend` `receipts_list` `tag_receipt_value` |
 | Soul Hunt | `hunt_list` `hunt_status` `hunt_predict` `hunt_collection` `hunt_leaderboard` |
 
@@ -150,7 +150,7 @@ wallet. The server signs it for you. A read with no proof and no valid token is
 
 ## Tool discovery
 
-The MCP catalog contains 243 tools. `oneshot_discover_tools` is a free, read-only
+The MCP catalog contains 263 tools. `oneshot_discover_tools` is a free, read-only
 search over the tools your token can call. Call it with no arguments for category
 counts, `{ "query": "send a printed letter" }` to search, or `{ "category": "email" }`
 to browse. Results contain public tool names, purposes and required inputs.

package/dist/index.js

@@ -50,7 +50,7 @@ async function main() {
     const agent = await initAgent();
     const server = new Server({
         name: "oneshot-mcp",
-        version: "0.51.0", // keep in sync with package.json; guarded by version.test.ts
+        version: "0.52.0", // keep in sync with package.json; guarded by version.test.ts
     }, {
         capabilities: {
             tools: {},

package/dist/tools/annotations.js

@@ -12,7 +12,7 @@ const IRREVERSIBLE_ROUTES = new Set(["physical_mail_approve", "physical_mail_can
  */
 const OUTBOUND_ROUTES = new Set(["physical_mail_approve", "identity_start", "watch", "watch_update", "browser_connect_account"]);
 /** The connected-system reads (#2403): paid, but each reads the caller's own connected business system, so closed-world. */
-const CONNECTED_SYSTEM_READ = /^\/v1\/tools\/(ledger|crm|shipping|tax|procurement|meetings|mailbox|files|field_service)\//;
+const CONNECTED_SYSTEM_READ = /^\/v1\/tools\/(ledger|crm|shipping|tax|procurement|matters|meetings|mailbox|files|field_service|client_work|portfolio|practice)\//;
 const OPEN = true;
 const OWN = false;
 const DESTRUCTIVE = true;

package/dist/tools/compute.d.ts

@@ -1,5 +1,8 @@
 import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-import type { OneShot } from "@oneshot-agent/sdk";
+import type { OneShot, ComputeQuote } from "@oneshot-agent/sdk";
+export type { ComputeQuote } from "@oneshot-agent/sdk";
+/** Select public quote details explicitly so prices and private identity never enter tool text. */
+export declare function formatComputeQuote(quote: ComputeQuote): string;
 export declare const computeTool: Tool;
 export declare const computeStatusTool: Tool;
 export declare const computeTasksTool: Tool;
@@ -8,7 +11,26 @@ 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 handleCompute(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").ComputeGoalResult | {
+    quote_text: string;
+    requires?: Array<import("@oneshot-agent/sdk").ComputeRequirement | import("@oneshot-agent/sdk").ComputeToolRequirement>;
+    goal_id: string;
+    request_id: string;
+    receipt_id?: string;
+    status: string;
+    message: string;
+    memo?: string;
+    cost?: number;
+    goal: {
+        objective: string;
+        budget_usdc: string;
+        deadline?: string;
+        schedule_cron?: string;
+        budget_per_run?: number;
+        max_runs?: number;
+        next_run_at?: string;
+    };
+}>;
 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").ComputeOutputContent | import("@oneshot-agent/sdk").ComputeTask[]>;
 export declare function handleComputeCancel(agent: OneShot, args: Record<string, unknown>): Promise<{

package/dist/tools/compute.js

@@ -1,3 +1,9 @@
+/** Select public quote details explicitly so prices and private identity never enter tool text. */
+export function formatComputeQuote(quote) {
+    const hires = (quote.price?.hires ?? []).map(hire => `Hires ${hire.display_name} (${hire.soul_slug}) for ${hire.service_name} (${hire.service_slug})${hire.need ? `: ${hire.need}` : ''}.`);
+    const specialists = (quote.requirements ?? []).filter(req => req.kind === 'specialist').map(req => req.question?.trim() ? req.question : `No specialist matched${req.need ? ` for ${req.need}` : ''}. Start the goal to go ahead without one, using the platform's tools.`);
+    return [...hires, ...specialists].join('\n');
+}
 const KNOWN_GOAL_TOOL = { type: "string", description: 'A OneShot tool name, e.g. "email", "voice", "commerce_buy"' };
 const SCOPE_DRIVERS = { type: "object", additionalProperties: { anyOf: [{ type: "number" }, { type: "boolean" }, { type: "string" }] }, description: 'Request sizes, never prices: recipients, segments, max_duration_minutes, max_steps (e.g. {"max_steps":25}), include_phone and limit, or letter kind/pages/color/double_sided; Predict/Solve size and time_limit_s. Omitted fields use tool defaults.' };
 const SCOPE_USE = {
@@ -36,6 +42,11 @@ export const computeTool = {
                 type: "number",
                 description: "Spend ceiling in USDC. Server estimates if omitted.",
             },
+            purchase_limit_usdc: {
+                type: "number",
+                exclusiveMinimum: 0,
+                description: "The most the owner would pay for one purchase, all in. Only set a figure the owner gave you, never your own. It is added to the total and unused money comes back as credit; a live total above it waits for the owner's approval. Without it, the goal pauses at a purchase it can't afford.",
+            },
             params: {
                 type: "object",
                 description: "Additional parameters / constraints for the objective",
@@ -217,6 +228,7 @@ export const computeTool = {
                             required: ["name", "reason"],
                         },
                     },
+                    purchase_limit_usdc: { type: "number", exclusiveMinimum: 0, description: "The most per purchase, all in, as the owner gave it. The top-level field wins over this." },
                 },
                 required: ["unit", "per_unit", "overhead", "volume", "unpriced"],
             },
@@ -311,6 +323,7 @@ export const computeFundTool = {
     },
 };
 export async function handleCompute(agent, args) {
+    let quoteText = '';
     const options = {
         objective: args.objective,
         budget_usdc: args.budget_usdc,
@@ -322,10 +335,14 @@ export async function handleCompute(agent, args) {
         approvals: args.approvals,
         done_check: args.done_check,
         egress_allowlist: args.egress_allowlist,
+        onQuote: quote => { quoteText = formatComputeQuote(quote); },
     };
     if (args.scope !== undefined)
         options.scope = args.scope;
-    return agent.compute(options);
+    if (args.purchase_limit_usdc !== undefined)
+        options.purchase_limit_usdc = args.purchase_limit_usdc;
+    const result = await agent.compute(options);
+    return quoteText ? { ...result, quote_text: quoteText } : result;
 }
 export async function handleComputeStatus(agent, args) {
     return agent.getComputeGoal(args.goal_id);

package/dist/tools/connections.d.ts

@@ -3,7 +3,7 @@ import type { OneShot } from "@oneshot-agent/sdk";
 /**
  * The agent's connections (#2403). Hand-written because `GET /v1/connections` is not a declared route: the
  * connected-system read tools (`oneshot_ledger_*`, `oneshot_crm_*`, `oneshot_shipping_*`, `oneshot_tax_*`,
- * `oneshot_procurement_*`, `oneshot_meetings_*`, `oneshot_field_service_*`) are generated from their routes and each tells the model to call this one first.
+ * `oneshot_procurement_*`, `oneshot_meetings_*`, `oneshot_matters_*`, `oneshot_field_service_*`, `oneshot_client_work_*`, `oneshot_portfolio_*`, `oneshot_practice_*`) are generated from their routes and each tells the model to call this one first.
  * Connecting and revoking stay in the console.
  */
 export declare const connectionsListTool: Tool;

package/dist/tools/connections.js

@@ -1,12 +1,12 @@
 /**
  * The agent's connections (#2403). Hand-written because `GET /v1/connections` is not a declared route: the
  * connected-system read tools (`oneshot_ledger_*`, `oneshot_crm_*`, `oneshot_shipping_*`, `oneshot_tax_*`,
- * `oneshot_procurement_*`, `oneshot_meetings_*`, `oneshot_field_service_*`) are generated from their routes and each tells the model to call this one first.
+ * `oneshot_procurement_*`, `oneshot_meetings_*`, `oneshot_matters_*`, `oneshot_field_service_*`, `oneshot_client_work_*`, `oneshot_portfolio_*`, `oneshot_practice_*`) are generated from their routes and each tells the model to call this one first.
  * Connecting and revoking stay in the console.
  */
 export const connectionsListTool = {
     name: "oneshot_connections_list",
-    description: "List the agent's connections to business systems (accounting, CRM, shipping, tax, spend) and GitHub. " +
+    description: "List the agent's connections to business systems (accounting, CRM, shipping, tax, spend, practice management, wealth) and GitHub. " +
         "Returns each connection's id, name, kind, system, account_label and status (only an active one can be read). " +
         "Call it before any connected-system read: pick the connection by system and account_label and pass its id as connection_id. " +
         "Connections are added and revoked in the console. Free.",