@oneshot-agent/mcp-server 0.35.0 → 0.37.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:
 
@@ -169,26 +169,26 @@ Soul Hunt is a separate service (`api.soulhunt.ai`) from the main OneShot API; t
 | Tool | Description |
 |------|-------------|
 | `oneshot_research` | Deep web research with sources |
-| `oneshot_people_search` | Search for people by title, company, etc. |
-| `oneshot_enrich_profile` | Enrich person profile from LinkedIn/email |
-| `oneshot_find_email` | Find someone's email address |
-| `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_person_find` | Search for people by title, company, etc. |
+| `oneshot_person_profile` | Enrich person profile from LinkedIn/email |
+| `oneshot_person_email` | Find someone's email address |
+| `oneshot_person_email_status` | Verify email deliverability |
+| `oneshot_company_find` | Search for companies by industry, size, location, etc. |
+| `oneshot_company_profile` | Enrich a company from domain, name, LinkedIn, or ticker |
+| `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
 
 | Tool | Description |
 |------|-------------|
-| `oneshot_deep_research_person` | Full dossier on a person |
-| `oneshot_social_profiles` | Find all social accounts for a person |
-| `oneshot_article_search` | Find articles about a person |
-| `oneshot_person_newsfeed` | Recent social posts with engagement |
+| `oneshot_person_dossier` | A person’s profile, known social accounts, articles, posts and written summary |
+| `oneshot_person_social_accounts` | Find all social accounts for a person |
+| `oneshot_person_articles` | Find articles about a person |
+| `oneshot_person_posts` | Recent social posts with engagement |
 | `oneshot_person_interests` | Analyze interests across categories |
-| `oneshot_person_interactions` | Map followers, following, replies |
+| `oneshot_person_followers` | Map followers, following, replies |
 
 ### Web
 
@@ -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 |
@@ -298,7 +298,7 @@ Use oneshot_research:
 ### Search for People
 
 ```
-Use oneshot_people_search:
+Use oneshot_person_find:
 - job_titles: ["CTO", "VP Engineering"]
 - companies: ["Stripe", "Square"]
 - location: ["San Francisco"]
@@ -308,7 +308,7 @@ Use oneshot_people_search:
 ### Find Someone's Email
 
 ```
-Use oneshot_find_email:
+Use oneshot_person_email:
 - first_name: "John"
 - last_name: "Smith"
 - company_domain: "example.com"
@@ -350,7 +350,7 @@ Send USDC to your agent's wallet address on Base. The server runs on Base Mainne
 
 ## LinkedIn connection recovery
 
-If the active account list is empty or an account is `deleted_upstream` or
+If the active account list is empty or an account is `connection_deleted` or
 `revoked`, ask the human to use `oneshot_linkedin_connect` and authorize fresh
 grants. An existing account with `reconnect_required` must be reconnected through
 the owning application. Reconnect and revoke are deliberately not agent tools.

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.37.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. */
@@ -24,22 +25,22 @@ export const TOOL_ANNOTATIONS = {
     oneshot_voice_inbound_disable: write("Stop answering calls", OPEN),
     oneshot_voice_inbound_calls: read("List answered calls", OWN),
     oneshot_research: read("Deep research", OPEN),
-    oneshot_people_search: read("Find people", OPEN),
-    oneshot_enrich_profile: read("Look up a person's profile", OPEN),
-    oneshot_find_email: read("Find a work email", OPEN),
-    oneshot_verify_email: read("Verify an email address", OPEN),
+    oneshot_person_find: read("Find people", OPEN),
+    oneshot_person_profile: read("Look up a person's profile", OPEN),
+    oneshot_person_email: read("Find a work email", OPEN),
+    oneshot_person_email_status: read("Verify an email address", OPEN),
     oneshot_web_search: read("Web search", OPEN),
-    oneshot_deep_research_person: read("Research a person", OPEN),
-    oneshot_social_profiles: read("Find social profiles", OPEN),
-    oneshot_article_search: read("Find articles about a person", OPEN),
-    oneshot_person_newsfeed: read("Get a person's recent posts", OPEN),
+    oneshot_person_dossier: read("Research a person", OPEN),
+    oneshot_person_social_accounts: read("Find social profiles", OPEN),
+    oneshot_person_articles: read("Find articles about a person", OPEN),
+    oneshot_person_posts: read("Get a person's recent posts", OPEN),
     oneshot_person_interests: read("Summarize a person's interests", OPEN),
-    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_person_followers: read("Find a person's interactions", OPEN),
+    oneshot_company_find: read("Find companies", OPEN),
+    oneshot_company_profile: read("Look up a company", 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/company.d.ts

@@ -1,6 +1,6 @@
 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>;
-export declare function handleEnrichCompany(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").EnrichCompanyResult>;
+export declare const companyFindTool: Tool;
+export declare const companyProfileTool: Tool;
+export declare function handleCompanyFind(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").CompanyFindResult>;
+export declare function handleCompanyProfile(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").CompanyProfileResult>;

package/dist/tools/company.js

@@ -1,5 +1,5 @@
-export const companySearchTool = {
-    name: "oneshot_company_search",
+export const companyFindTool = {
+    name: "oneshot_company_find",
     description: "Search for companies by name, domain, industry, location, size, funding stage, or tags. Paid tool.",
     inputSchema: {
         type: "object",
@@ -17,8 +17,8 @@ export const companySearchTool = {
         },
     },
 };
-export const enrichCompanyTool = {
-    name: "oneshot_enrich_company",
+export const companyProfileTool = {
+    name: "oneshot_company_profile",
     description: "Enrich a company from its domain, name, LinkedIn URL, or stock ticker. At least one identifier is required. Paid tool.",
     inputSchema: {
         type: "object",
@@ -30,8 +30,8 @@ export const enrichCompanyTool = {
         },
     },
 };
-export async function handleCompanySearch(agent, args) {
-    return agent.companySearch({
+export async function handleCompanyFind(agent, args) {
+    return agent.companyFind({
         name: args.name,
         domain: args.domain,
         industry: args.industry,
@@ -44,8 +44,8 @@ export async function handleCompanySearch(agent, args) {
         limit: args.limit,
     });
 }
-export async function handleEnrichCompany(agent, args) {
-    return agent.enrichCompany({
+export async function handleCompanyProfile(agent, args) {
+    return agent.companyProfile({
         domain: args.domain,
         name: args.name,
         linkedin_url: args.linkedin_url,

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/enrichment.d.ts

@@ -1,8 +1,8 @@
 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;
-export declare function handleEnrichProfile(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").EnrichProfileResult>;
-export declare function handleFindEmail(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").FindEmailResult>;
-export declare function handleVerifyEmail(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").VerifyEmailResult>;
+export declare const personProfileTool: Tool;
+export declare const personEmailTool: Tool;
+export declare const personEmailStatusTool: Tool;
+export declare function handlePersonProfile(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PersonProfileResult>;
+export declare function handlePersonEmail(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PersonEmailResult>;
+export declare function handlePersonEmailStatus(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PersonEmailStatusResult>;

package/dist/tools/enrichment.js

@@ -1,5 +1,5 @@
-export const enrichProfileTool = {
-    name: "oneshot_enrich_profile",
+export const personProfileTool = {
+    name: "oneshot_person_profile",
     description: "Enrich a person's profile from LinkedIn URL, email, or name. Returns job title, company, social links, etc. Paid tool.",
     inputSchema: {
         type: "object",
@@ -23,8 +23,8 @@ export const enrichProfileTool = {
         },
     },
 };
-export const findEmailTool = {
-    name: "oneshot_find_email",
+export const personEmailTool = {
+    name: "oneshot_person_email",
     description: "Find email address for a person at a company. Paid tool.",
     inputSchema: {
         type: "object",
@@ -49,8 +49,8 @@ export const findEmailTool = {
         required: ["company_domain"],
     },
 };
-export const verifyEmailTool = {
-    name: "oneshot_verify_email",
+export const personEmailStatusTool = {
+    name: "oneshot_person_email_status",
     description: "Verify if an email address is valid and deliverable. Paid tool.",
     inputSchema: {
         type: "object",
@@ -63,24 +63,24 @@ export const verifyEmailTool = {
         required: ["email"],
     },
 };
-export async function handleEnrichProfile(agent, args) {
-    return agent.enrichProfile({
+export async function handlePersonProfile(agent, args) {
+    return agent.personProfile({
         linkedin_url: args.linkedin_url,
         email: args.email,
         name: args.name,
         company_domain: args.company_domain,
     });
 }
-export async function handleFindEmail(agent, args) {
-    return agent.findEmail({
+export async function handlePersonEmail(agent, args) {
+    return agent.personEmail({
         full_name: args.full_name,
         first_name: args.first_name,
         last_name: args.last_name,
         company_domain: args.company_domain,
     });
 }
-export async function handleVerifyEmail(agent, args) {
-    return agent.verifyEmail({
+export async function handlePersonEmailStatus(agent, args) {
+    return agent.personEmailStatus({
         email: args.email,
     });
 }

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

@@ -3,9 +3,9 @@ import { voiceTool, handleVoice } from "./voice.js";
 import { voiceNumberProvisionTool, voiceNumbersTool, voiceInboundSetTool, voiceInboundDisableTool, voiceInboundCallsTool, handleVoiceNumberProvision, handleVoiceNumbers, handleVoiceInboundSet, handleVoiceInboundDisable, handleVoiceInboundCalls, } from "./voice-inbound.js";
 import { smsTool, handleSms } from "./sms.js";
 import { researchTool, handleResearch } from "./research.js";
-import { peopleSearchTool, handlePeopleSearch } from "./people.js";
+import { personFindTool, handlePersonFind } from "./people.js";
 import { commerceSearchTool, commerceBuyTool, handleCommerceSearch, handleCommerceBuy } from "./commerce.js";
-import { enrichProfileTool, findEmailTool, verifyEmailTool, handleEnrichProfile, handleFindEmail, handleVerifyEmail } from "./enrichment.js";
+import { personProfileTool, personEmailTool, personEmailStatusTool, handlePersonProfile, handlePersonEmail, handlePersonEmailStatus } from "./enrichment.js";
 import { inboxListTool, inboxGetTool, handleInboxList, handleInboxGet } from "./inbox.js";
 import { smsInboxListTool, smsInboxGetTool, handleSmsInboxList, handleSmsInboxGet } from "./sms-inbox.js";
 import { notificationsTool, markReadTool, handleNotifications, handleMarkRead } from "./notifications.js";
@@ -15,15 +15,16 @@ import { buildTool, updateBuildTool, handleBuild, handleUpdateBuild } from "./bu
 import { browserTool, browserCreateProfileTool, browserListProfilesTool, browserDeleteProfileTool, handleBrowser, handleBrowserCreateProfile, handleBrowserListProfiles, handleBrowserDeleteProfile } from "./browser.js";
 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 { personDossierTool, personSocialAccountsTool, personArticlesTool, personPostsTool, personInterestsTool, personFollowersTool, handlePersonDossier, handlePersonSocialAccounts, handlePersonArticles, handlePersonPosts, handlePersonInterests, handlePersonFollowers } from "./nyne.js";
+import { companyFindTool, companyProfileTool, handleCompanyFind, handleCompanyProfile } from "./company.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,
@@ -39,22 +40,22 @@ const toolDefinitions = [
     voiceInboundDisableTool,
     voiceInboundCallsTool,
     researchTool,
-    peopleSearchTool,
-    enrichProfileTool,
-    findEmailTool,
-    verifyEmailTool,
+    personFindTool,
+    personProfileTool,
+    personEmailTool,
+    personEmailStatusTool,
     webSearchTool,
-    deepResearchPersonTool,
-    socialProfilesTool,
-    articleSearchTool,
-    personNewsfeedTool,
+    personDossierTool,
+    personSocialAccountsTool,
+    personArticlesTool,
+    personPostsTool,
     personInterestsTool,
-    personInteractionsTool,
-    companySearchTool,
-    enrichCompanyTool,
-    localSearchTool,
-    localResolveTool,
-    govSolicitationsTool,
+    personFollowersTool,
+    companyFindTool,
+    companyProfileTool,
+    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.
@@ -127,22 +130,22 @@ const handlers = {
     "oneshot_voice_inbound_disable": handleVoiceInboundDisable,
     "oneshot_voice_inbound_calls": handleVoiceInboundCalls,
     "oneshot_research": handleResearch,
-    "oneshot_people_search": handlePeopleSearch,
-    "oneshot_enrich_profile": handleEnrichProfile,
-    "oneshot_find_email": handleFindEmail,
-    "oneshot_verify_email": handleVerifyEmail,
+    "oneshot_person_find": handlePersonFind,
+    "oneshot_person_profile": handlePersonProfile,
+    "oneshot_person_email": handlePersonEmail,
+    "oneshot_person_email_status": handlePersonEmailStatus,
     "oneshot_web_search": handleWebSearch,
-    "oneshot_deep_research_person": handleDeepResearchPerson,
-    "oneshot_social_profiles": handleSocialProfiles,
-    "oneshot_article_search": handleArticleSearch,
-    "oneshot_person_newsfeed": handlePersonNewsfeed,
+    "oneshot_person_dossier": handlePersonDossier,
+    "oneshot_person_social_accounts": handlePersonSocialAccounts,
+    "oneshot_person_articles": handlePersonArticles,
+    "oneshot_person_posts": handlePersonPosts,
     "oneshot_person_interests": handlePersonInterests,
-    "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_person_followers": handlePersonFollowers,
+    "oneshot_company_find": handleCompanyFind,
+    "oneshot_company_profile": handleCompanyProfile,
+    "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

@@ -7,7 +7,7 @@
 const GRANT_ACTIONS = ["read", "reply", "view_profile", "react", "invite", "comment"];
 export const linkedinConnectTool = {
     name: "oneshot_linkedin_connect",
-    description: "Create a hosted LinkedIn login link for a human to connect THEIR OWN LinkedIn account to this agent, granting specific actions (read, reply, view_profile, react, invite). Returns intent_id + url (show the url to the human; it expires in 30 minutes; never embed it in an iframe). Poll oneshot_linkedin_accounts with the intent_id afterwards. Free tool. If no active account exists, or status is deleted_upstream/revoked, ask the human to connect again with oneshot_linkedin_connect and choose grants anew. reconnect_required applies only to an existing connection; reconnect is managed by the owning application.",
+    description: "Create a hosted LinkedIn login link for a human to connect THEIR OWN LinkedIn account to this agent, granting specific actions (read, reply, view_profile, react, invite). Returns intent_id + url (show the url to the human; it expires in 30 minutes; never embed it in an iframe). Poll oneshot_linkedin_accounts with the intent_id afterwards. Free tool. If no active account exists, or status is connection_deleted/revoked, ask the human to connect again with oneshot_linkedin_connect and choose grants anew. reconnect_required applies only to an existing connection; reconnect is managed by the owning application.",
     inputSchema: {
         type: "object",
         properties: {
@@ -20,7 +20,7 @@ export const linkedinConnectTool = {
 };
 export const linkedinAccountsTool = {
     name: "oneshot_linkedin_accounts",
-    description: "List the LinkedIn accounts connected to this agent (status, granted actions, sync coverage), or, with intent_id, check a pending connection from oneshot_linkedin_connect (pending → completed with the account, or failed with a reason). Free tool. If no active account exists, or status is deleted_upstream/revoked, ask the human to connect again with oneshot_linkedin_connect and choose grants anew. reconnect_required applies only to an existing connection; reconnect is managed by the owning application.",
+    description: "List the LinkedIn accounts connected to this agent (status, granted actions, sync coverage), or, with intent_id, check a pending connection from oneshot_linkedin_connect (pending → completed with the account, or failed with a reason). Free tool. If no active account exists, or status is connection_deleted/revoked, ask the human to connect again with oneshot_linkedin_connect and choose grants anew. reconnect_required applies only to an existing connection; reconnect is managed by the owning application.",
     inputSchema: {
         type: "object",
         properties: {
@@ -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>;