@oneshot-agent/mcp-server 0.35.0 → 0.36.0

package/README.md

@@ -102,7 +102,7 @@ Read tools (inbox, SMS inbox, notifications, balance, browser profiles) return p
 ## 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 81 tools over
+server and must not hold a wallet key. For them, OneShot hosts the same 117 tools over
 Streamable HTTP at **`https://win.oneshotagent.com/mcp`**, authenticated with an
 **agent access token** and billed to the agent's credit balance:
 
@@ -175,9 +175,9 @@ Soul Hunt is a separate service (`api.soulhunt.ai`) from the main OneShot API; t
 | `oneshot_verify_email` | Verify email deliverability |
 | `oneshot_company_search` | Search for companies by industry, size, location, etc. |
 | `oneshot_enrich_company` | Enrich a company from domain, name, LinkedIn, or ticker |
-| `oneshot_local_search` | Discover local businesses (restaurants, contractors, practices) by category × location |
-| `oneshot_local_resolve` | Business name + address → website domain, phone, status, confidence |
-| `oneshot_gov_solicitations` | Federal Sources Sought / Presolicitation notices by NAICS with the contracting officer's contact |
+| `oneshot_business_find` | Discover local businesses (restaurants, contractors, practices) by category × location |
+| `oneshot_business_resolve` | Business name + address → website domain, phone, status, confidence |
+| `oneshot_record_solicitations_find` | Federal Sources Sought / Presolicitation notices by NAICS with the contracting officer's contact |
 
 ### Person Intelligence
 
@@ -216,7 +216,7 @@ Soul Hunt is a separate service (`api.soulhunt.ai`) from the main OneShot API; t
 
 | Tool | Description |
 |------|-------------|
-| `oneshot_compute` | Create an autonomous goal (objective + budget); the orchestrator plans and executes |
+| `oneshot_compute` | Create an autonomous goal (objective + budget); OneShot plans and runs the steps |
 | `oneshot_compute_status` | Get a compute goal's status and budget |
 | `oneshot_compute_tasks` | List tasks planned/executed under a goal |
 | `oneshot_compute_cancel` | Cancel a goal and refund remaining budget |

package/dist/index.js

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

package/dist/tools/annotations.js

@@ -1,3 +1,4 @@
+import { LOOKUP_MANIFEST, ROUTE_MANIFEST } from "./lookup-manifest.generated.js";
 /** Retrieval only. */
 const read = (title, openWorld) => ({ title, readOnlyHint: true, destructiveHint: false, openWorldHint: openWorld });
 /** Changes something. `destructive` only for delete / overwrite / revoke. */
@@ -37,9 +38,9 @@ export const TOOL_ANNOTATIONS = {
     oneshot_person_interactions: read("Find a person's interactions", OPEN),
     oneshot_company_search: read("Find companies", OPEN),
     oneshot_enrich_company: read("Look up a company", OPEN),
-    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),
+    oneshot_business_find: read("Find local businesses", OPEN),
+    oneshot_business_resolve: read("Look up a local business", OPEN),
+    oneshot_record_solicitations_find: read("Find government contracts", OPEN),
     oneshot_commerce_search: read("Search products", OPEN),
     oneshot_commerce_buy: write("Buy a product", OPEN),
     oneshot_compute: write("Start a goal", OPEN),
@@ -87,4 +88,15 @@ export const TOOL_ANNOTATIONS = {
     oneshot_approval_list: read("List approvals", OWN),
     oneshot_approval_cancel: write("Cancel an approval", OWN, DESTRUCTIVE),
     oneshot_action_policy: read("Show approval rules", OWN),
+    // The lookup tools come from the generated manifest: paid retrieval over public or third-party data (#1445).
+    ...Object.fromEntries(LOOKUP_MANIFEST.map((entry) => [`oneshot_${entry.name}`, read(entry.title, OPEN)])),
+    // The declared routes come from the same manifest (#1580). A read of the agent's own data is closed-world; a paid
+    // read (Changes, Benchmark) reaches recorded third-party data; a write changes something, and a DELETE removes it.
+    ...Object.fromEntries(ROUTE_MANIFEST.map((entry) => {
+        const own = !entry.paid;
+        return [
+            `oneshot_${entry.name}`,
+            entry.readOnly ? read(entry.title, own ? OWN : OPEN) : write(entry.title, own ? OWN : OPEN, entry.method === "DELETE"),
+        ];
+    })),
 };

package/dist/tools/browser.js

@@ -27,7 +27,7 @@ export const browserTool = {
             },
             max_steps: {
                 type: "number",
-                description: "Step-derived budget allowance (25-100, default: 50)",
+                description: "Maximum browser steps (25-100, default 50). More steps cost more.",
             },
         },
         required: ["task"],

package/dist/tools/compute.d.ts

@@ -12,9 +12,10 @@ export declare function handleCompute(agent: OneShot, args: Record<string, unkno
 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<{
-    goal_id: string;
+    goal_id?: string;
     status: string;
-    remaining_budget: string;
+    remaining_budget?: string;
+    message?: string;
 }>;
 export declare function handleComputeRespond(agent: OneShot, args: Record<string, unknown>): Promise<{
     task_id: string;

package/dist/tools/compute.js

@@ -1,12 +1,12 @@
 export const computeTool = {
     name: "oneshot_compute",
-    description: "Create an autonomous compute goal: hand the orchestrator a natural-language objective and a budget, and it plans and executes multi-step work across OneShot tools. Returns a goal id to poll. Paid tool (quote-to-pay against the budget).",
+    description: "Create an autonomous compute goal: give OneShot an objective and a budget; it plans and runs the steps across OneShot tools. Returns a goal id to poll. Paid tool (quote-to-pay against the budget).",
     inputSchema: {
         type: "object",
         properties: {
             objective: {
                 type: "string",
-                description: "Natural-language objective for the orchestrator to accomplish",
+                description: "Natural-language objective for OneShot to accomplish",
             },
             budget_usdc: {
                 type: "number",
@@ -60,7 +60,7 @@ export const computeStatusTool = {
 };
 export const computeTasksTool = {
     name: "oneshot_compute_tasks",
-    description: "List the tasks the orchestrator has planned/executed under a compute goal. Each task lists the `outputs` it produced by key; pass one as `output_key` to read that output's content instead of the task list. Free.",
+    description: "List the tasks OneShot has planned and run under a compute goal. Each task lists the `outputs` it produced by key; pass one as `output_key` to read that output's content instead of the task list. Free.",
     inputSchema: {
         type: "object",
         properties: {
@@ -121,7 +121,7 @@ export const computeResumeTool = {
 };
 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.",
+    description: "Top up the USDC budget of a compute goal that is running low or has hit its cap. A recurring goal can be funded while it runs or is paused; a goal (one-off or recurring) that ended because it ran out of budget (end_reason budget_exhausted) is revived by funding it: it goes back to active with its tasks, workspace and history. Goals that ended any other way, or whose deadline has passed, cannot be funded. Quote-to-pay: moves USDC into the goal. Paid tool.",
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/domains.js

@@ -1,6 +1,6 @@
 export const listDomainsTool = {
     name: "oneshot_list_domains",
-    description: "List the agent's sending domains. Each has default_from (canonical default sender, e.g. agent@domain — billed like any address on its first send), mailbox_mode (relay|mailbox), addresses[] (mailboxes already provisioned — {address, status, warmup_state}; empty means none yet), pool_status (rotation eligibility: active|paused|removed), warmup_state (reputation health: warming|warmed|degraded), pause_reason (warming|low_reputation|manual|null), warmup_score, and daily send limits. mailbox_mode is a property of the domain, fixed when it was set up: on a 'mailbox' domain EVERY address not already active in addresses[] bills the one-time mailbox_provisioning_fee on its first send, the canonical default_from included — omitting mailbox_mode when you quote does not make the send relay. 'relay' domains never charge it. A domain can be paused AND warming — reputation pauses auto-recover once warmed; manual pauses need a resume. Free.",
+    description: "List the agent's sending domains. Each has default_from (canonical default sender, e.g. agent@domain — billed like any address on its first send), mailbox_mode (relay|mailbox), addresses[] (mailboxes already provisioned — {address, status, warmup_state}; empty means none yet), pool_status (rotation eligibility: active|paused|removed), warmup_state (reputation health: warming|warmed|degraded), pause_reason (warming|low_reputation|manual|null), warmup_score, and daily send limits. mailbox_mode is a property of the domain, fixed when it was set up: on a 'mailbox' domain EVERY address not already active in addresses[] bills the one-time mailbox_provisioning_fee on its first send, the canonical default_from included. 'relay' domains never charge it. A domain can be paused AND warming — reputation pauses auto-recover once warmed; manual pauses need a resume. Free.",
     inputSchema: { type: "object", properties: {} },
 };
 export const pauseDomainTool = {

package/dist/tools/email.js

@@ -1,7 +1,7 @@
 export const emailTool = {
     name: "oneshot_email",
     description: "Send an email. Supports HTML body, attachments, and threaded replies (set reply_to_email_id to an inbound email id from oneshot_inbox_list/oneshot_inbox_get). Paid tool — quote provided before payment.\n\n" +
-        "Sending requires a domain the agent owns. A fresh account has none — call oneshot_list_domains first to see what's already owned. If there is no usable domain, pass from_domain with a new domain to register it. A call with a new from_domain only quotes — nothing is charged — and returns status 'confirmation_required' with the exact cost (registrar price + a service fee, plus a mailbox fee if mailbox_mode is 'mailbox') and a quote_id. Tell the user that exact computed number, never a guessed or approximate one, and only once they say to proceed, call this again with the same arguments and confirm_new_domain set to that quote_id: that registers the domain, charges exactly the quoted total (the stored quote is used, there is no re-quote), and sends the email in one call. The workspace balance must cover it, or the call fails with insufficient_credits.",
+        "Sending requires a domain the agent owns. A fresh account has none — call oneshot_list_domains first to see what's already owned. If there is no usable domain, pass from_domain with a new domain to register it. A call with a new from_domain only quotes — nothing is charged — and returns status 'confirmation_required' with the exact cost (domain registration plus fees) and a quote_id. Tell the user that exact computed number, never a guessed or approximate one, and only once they say to proceed, call this again with the same arguments and confirm_new_domain set to that quote_id: that registers the domain, charges exactly the quoted total, and sends the email in one call. The workspace balance must cover it, or the call fails with insufficient_credits.",
     inputSchema: {
         type: "object",
         properties: {
@@ -36,7 +36,7 @@ export const emailTool = {
             mailbox_mode: {
                 type: "string",
                 enum: ["relay", "mailbox"],
-                description: "How this domain sends (optional). 'relay' = header send, no per-address mailbox, no mailbox fee. 'mailbox' = a real dedicated mailbox per address (better deliverability + per-address warmup); each new address adds a one-time mailbox_provisioning_fee to the quote. Only honored while a domain is unprovisioned (brand new, or owned with provisioning_status 'unprovisioned') — an already-provisioned domain keeps the mode it was created with, which means OMITTING this does not make a send relay and does not avoid the fee. On a domain already in mailbox mode every address that isn't active yet bills the fee on its first send, the default agent@ included; from_mailbox does not change that. Use oneshot_list_domains to see each domain's mailbox_mode before quoting.",
+                description: "How this domain sends (optional). 'relay' = no dedicated mailbox, no mailbox fee. 'mailbox' = a real dedicated mailbox per address (better deliverability + per-address warmup); each new address adds a one-time mailbox_provisioning_fee to the quote. Only honored while a domain is unprovisioned (brand new, or owned with provisioning_status 'unprovisioned') — an already-provisioned domain keeps the mode it was created with, which means OMITTING this does not make a send relay and does not avoid the fee. On a domain already in mailbox mode every address that isn't active yet bills the fee on its first send, the default agent@ included; from_mailbox does not change that. Use oneshot_list_domains to see each domain's mailbox_mode before quoting.",
             },
             attachments: {
                 type: "array",

package/dist/tools/gov.d.ts

@@ -1,4 +1,4 @@
 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>;
+export declare const recordSolicitationsFindTool: Tool;
+export declare function handleRecordSolicitationsFind(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").RecordSolicitationsFindResult>;

package/dist/tools/gov.js

@@ -1,5 +1,5 @@
-export const govSolicitationsTool = {
-    name: "oneshot_gov_solicitations",
+export const recordSolicitationsFindTool = {
+    name: "oneshot_record_solicitations_find",
     description: "Federal contract opportunities (SAM.gov) by NAICS code — Sources Sought and Presolicitation notices with the contracting officer's published name and email, agency, response deadline, set-aside, and description. Use for government buyers instead of people_search. Flat price per search. Paid tool.",
     inputSchema: {
         type: "object",
@@ -19,8 +19,8 @@ export const govSolicitationsTool = {
         required: ["naics"],
     },
 };
-export async function handleGovSolicitations(agent, args) {
-    return agent.govSolicitations({
+export async function handleRecordSolicitationsFind(agent, args) {
+    return agent.recordSolicitationsFind({
         naics: args.naics,
         notice_types: args.notice_types,
         since_days: args.since_days,

package/dist/tools/index.js

@@ -17,13 +17,14 @@ import { webSearchTool, handleWebSearch } from "./search.js";
 import { webReadTool, handleWebRead } from "./web-read.js";
 import { deepResearchPersonTool, socialProfilesTool, articleSearchTool, personNewsfeedTool, personInterestsTool, personInteractionsTool, handleDeepResearchPerson, handleSocialProfiles, handleArticleSearch, handlePersonNewsfeed, handlePersonInterests, handlePersonInteractions } from "./nyne.js";
 import { companySearchTool, enrichCompanyTool, handleCompanySearch, handleEnrichCompany } from "./company.js";
-import { localSearchTool, localResolveTool, handleLocalSearch, handleLocalResolve } from "./local.js";
-import { govSolicitationsTool, handleGovSolicitations } from "./gov.js";
+import { businessFindTool, businessResolveTool, handleBusinessFind, handleBusinessResolve } from "./local.js";
+import { recordSolicitationsFindTool, handleRecordSolicitationsFind } from "./gov.js";
 import { linkedinConnectTool, linkedinAccountsTool, linkedinSyncTool, linkedinConversationsTool, linkedinMessagesTool, linkedinReplyTool, linkedinViewProfileTool, linkedinReactTool, linkedinInviteTool, linkedinWithdrawInvitationTool, linkedinMessageTool, linkedinInvitationTool, linkedinInvitationsTool, handleLinkedinConnect, handleLinkedinAccounts, handleLinkedinSync, handleLinkedinConversations, handleLinkedinMessages, handleLinkedinReply, handleLinkedinViewProfile, handleLinkedinReact, handleLinkedinInvite, handleLinkedinWithdrawInvitation, handleLinkedinMessage, handleLinkedinInvitation, handleLinkedinInvitations, } from "./linkedin.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 { huntListTool, huntStatusTool, huntPredictTool, huntCollectionTool, huntLeaderboardTool, handleHuntList, handleHuntStatus, handleHuntPredict, handleHuntCollection, handleHuntLeaderboard } from "./hunt.js";
 import { TOOL_ANNOTATIONS } from "./annotations.js";
+import { lookupToolDefinitions, lookupHandlers, routeToolDefinitions, routeHandlers } from "./lookup.js";
 import { spendBreakdownTool, rocsTool, rocsByGoalTool, receiptsListTool, tagReceiptValueTool, handleSpendBreakdown, handleRocs, handleRocsByGoal, handleReceiptsList, handleTagReceiptValue } from "./analytics.js";
 const toolDefinitions = [
     emailTool,
@@ -52,9 +53,9 @@ const toolDefinitions = [
     personInteractionsTool,
     companySearchTool,
     enrichCompanyTool,
-    localSearchTool,
-    localResolveTool,
-    govSolicitationsTool,
+    businessFindTool,
+    businessResolveTool,
+    recordSolicitationsFindTool,
     commerceSearchTool,
     commerceBuyTool,
     computeTool,
@@ -104,6 +105,8 @@ const toolDefinitions = [
     approvalListTool,
     approvalCancelTool,
     actionPolicyGetTool,
+    ...lookupToolDefinitions,
+    ...routeToolDefinitions,
 ];
 // Every tool carries a human title and the three MCP hints clients rely on
 // (ChatGPT confirms any tool that is not read-only). See annotations.ts.
@@ -140,9 +143,9 @@ const handlers = {
     "oneshot_person_interactions": handlePersonInteractions,
     "oneshot_company_search": handleCompanySearch,
     "oneshot_enrich_company": handleEnrichCompany,
-    "oneshot_local_search": handleLocalSearch,
-    "oneshot_local_resolve": handleLocalResolve,
-    "oneshot_gov_solicitations": handleGovSolicitations,
+    "oneshot_business_find": handleBusinessFind,
+    "oneshot_business_resolve": handleBusinessResolve,
+    "oneshot_record_solicitations_find": handleRecordSolicitationsFind,
     "oneshot_commerce_search": handleCommerceSearch,
     "oneshot_commerce_buy": handleCommerceBuy,
     "oneshot_compute": handleCompute,
@@ -195,6 +198,8 @@ const handlers = {
     "oneshot_approval_list": handleApprovalList,
     "oneshot_approval_cancel": handleApprovalCancel,
     "oneshot_action_policy": handleActionPolicyGet,
+    ...lookupHandlers,
+    ...routeHandlers,
 };
 export async function handleToolCall(agent, toolName, args) {
     const handler = handlers[toolName];

package/dist/tools/linkedin.js

@@ -37,7 +37,7 @@ export const linkedinSyncTool = {
         type: "object",
         properties: {
             account_id: { type: "string", description: "Connected LinkedIn account id (required)" },
-            mode: { type: "string", enum: ["continue", "restart", "history"], description: "continue = resume the paused cursor (default); restart = discard paused cursors; history = also re-request the provider's history back-fill" },
+            mode: { type: "string", enum: ["continue", "restart", "history"], description: "continue = resume the paused cursor (default); restart = discard paused cursors; history = also re-import older messages" },
             max_pages: { type: "number", description: "Pages of 250 messages this run may fetch (1-10, default 10)" },
             memo: { type: "string", description: "Why this sync is running (audit trail)" },
         },
@@ -73,14 +73,14 @@ export const linkedinMessagesTool = {
             changed_since: { type: "string", description: "ISO time: only messages updated after this" },
             cursor: { type: "string", description: "next_cursor from the previous page" },
             limit: { type: "number", description: "1-100, default 50" },
-            include_deleted: { type: "boolean", description: "Include messages deleted upstream (default false)" },
+            include_deleted: { type: "boolean", description: "Include messages deleted on LinkedIn (default false)" },
         },
         required: ["account_id"],
     },
 };
 export const linkedinReplyTool = {
     name: "oneshot_linkedin_reply",
-    description: "Send a reply in an existing LinkedIn conversation through a connected account that granted 'reply'. The human's account sends it; a message LinkedIn accepted cannot be recalled. Per-account daily cap (default 50) shared by every caller; sends are paced. An Idempotency-Key is generated automatically so a retry never double-sends. Outcome (sent / failed / ambiguous-under-reconciliation) is in the returned job result. Paid tool (flat price per message).",
+    description: "Send a reply in an existing LinkedIn conversation through a connected account that granted 'reply'. The human's account sends it; a message LinkedIn accepted cannot be recalled. Per-account daily cap (default 50) shared by every caller; sends are paced. An Idempotency-Key is generated automatically so a retry never double-sends. Outcome (sent, failed or unconfirmed) is in the job result. Paid tool (flat price per message).",
     inputSchema: {
         type: "object",
         properties: {
@@ -100,8 +100,9 @@ export const linkedinViewProfileTool = {
         type: "object",
         properties: {
             account_id: { type: "string", description: "Connected LinkedIn account id (required)" },
-            identifier: { type: "string", description: "Public identifier, provider id, or a linkedin.com/in/<slug> URL (required)" },
+            identifier: { type: "string", description: "Profile slug, profile id or linkedin.com/in/<slug> URL (required)" },
             notify: { type: "boolean", description: "Default false. true = the profile owner sees the view." },
+            sections: { type: "array", items: { type: "string", enum: ["experience"] }, description: "Optional extra sections. 'experience' adds profile.experience (company, title, start, end, current, location) and profile.experience_complete (false = LinkedIn held the section back or an entry was dropped, so an empty list is not proof of no jobs). Omitted: both are null." },
             memo: { type: "string", description: "Why (audit trail)" },
             idempotency_key: { type: "string", description: "Optional caller-supplied key; reuse it to safely retry the same view without paying or notifying twice" },
         },
@@ -183,6 +184,7 @@ export async function handleLinkedinViewProfile(agent, args) {
         accountId: args.account_id,
         identifier: args.identifier,
         notify: args.notify,
+        sections: args.sections,
         memo: args.memo,
         idempotencyKey: args.idempotency_key,
     });

package/dist/tools/local.d.ts

@@ -1,6 +1,6 @@
 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>;
-export declare function handleLocalResolve(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").LocalResolveResult>;
+export declare const businessFindTool: Tool;
+export declare const businessResolveTool: Tool;
+export declare function handleBusinessFind(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").BusinessFindResult>;
+export declare function handleBusinessResolve(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").BusinessResolveResult>;

package/dist/tools/local.js

@@ -1,5 +1,5 @@
-export const localSearchTool = {
-    name: "oneshot_local_search",
+export const businessFindTool = {
+    name: "oneshot_business_find",
     description: "Discover local main-street businesses (restaurants, contractors, dental practices, auto shops) by category or keywords in a location. Use this instead of people_search for independent local businesses. Flat price per search. Paid tool.",
     inputSchema: {
         type: "object",
@@ -18,8 +18,8 @@ export const localSearchTool = {
         anyOf: [{ required: ["category"] }, { required: ["keywords"] }],
     },
 };
-export const localResolveTool = {
-    name: "oneshot_local_resolve",
+export const businessResolveTool = {
+    name: "oneshot_business_resolve",
     description: "Resolve a local business name plus one locating field (address, city, postal code, or phone) to its website domain, phone, category, and operating status with a match confidence. A miss returns found=false, not an error. Paid tool.",
     inputSchema: {
         type: "object",
@@ -35,8 +35,8 @@ export const localResolveTool = {
         anyOf: [{ required: ["address"] }, { required: ["city"] }, { required: ["postal_code"] }, { required: ["phone"] }],
     },
 };
-export async function handleLocalSearch(agent, args) {
-    return agent.localSearch({
+export async function handleBusinessFind(agent, args) {
+    return agent.businessFind({
         category: args.category,
         keywords: args.keywords,
         location: args.location,
@@ -48,8 +48,8 @@ export async function handleLocalSearch(agent, args) {
         limit: args.limit,
     });
 }
-export async function handleLocalResolve(agent, args) {
-    return agent.localResolve({
+export async function handleBusinessResolve(agent, args) {
+    return agent.businessResolve({
         name: args.name,
         address: args.address,
         city: args.city,

package/dist/tools/lookup-manifest.generated.d.ts

@@ -0,0 +1,34 @@
+export interface LookupManifestEntry {
+    /** The lookup tool's name; the MCP tool is `oneshot_<name>`. */
+    name: string;
+    /** What is passed to `agent.tool()`. */
+    path: string;
+    title: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, object>;
+        required: string[];
+    };
+    example: Record<string, unknown>;
+}
+export declare const LOOKUP_MANIFEST: readonly LookupManifestEntry[];
+/** A declared route with no hand-written MCP tool (#1580): `oneshot_<name>`, called by `agent.route(method, path, input)`. */
+export interface RouteManifestEntry {
+    name: string;
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    /** The route path; `{param}` is an input that is put into the path. */
+    path: string;
+    /** A paid route: quote-to-pay, then the call. Otherwise a signed free call. */
+    paid: boolean;
+    readOnly: boolean;
+    title: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, object>;
+        required: string[];
+    };
+    example: Record<string, unknown>;
+}
+export declare const ROUTE_MANIFEST: readonly RouteManifestEntry[];