@oneshot-agent/mcp-server 0.39.1 → 0.41.0

package/dist/tools/lookup-manifest.generated.js

@@ -111,6 +111,29 @@ export const LOOKUP_MANIFEST = [
             "limit": 1
         }
     },
+    {
+        "name": "compound_properties",
+        "path": "lookup/compound-properties",
+        "title": "Compound Properties",
+        "description": "Give the computed molecular descriptors of a chemical compound by its compound identifier (CID) or its InChIKey: the IUPAC name, molecular formula, InChIKey, molecular weight in g/mol, exact mass in Da, XLogP, topological polar surface area in square angstroms, the counts of hydrogen bond donors and acceptors, rotatable bonds and heavy atoms, the formal charge and the complexity score, with a link to the compound page. These are values the source computes from the structure, not measurements. Use it to characterise a compound in a literature review, a screening library or a regulatory file. Give exactly one of `cid` and `inchikey`. `compound` is null when the source knows no compound with that identifier. Synonyms, depositor records, and any synthesis or preparation data are not returned.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "cid": {
+                    "type": "integer",
+                    "description": "The compound identifier (CID), for example 2244. From 1 to 999999999."
+                },
+                "inchikey": {
+                    "type": "string",
+                    "description": "The standard InChIKey of the compound, for example BSYNRYMUTXBXSQ-UHFFFAOYSA-N. Exactly 27 characters. An InChIKey is 14 capitals, a hyphen, 10 capitals, a hyphen and one capital."
+                }
+            },
+            "required": []
+        },
+        "example": {
+            "cid": 2244
+        }
+    },
     {
         "name": "compound_resolve",
         "path": "resolve/compound",
@@ -269,6 +292,42 @@ export const LOOKUP_MANIFEST = [
             "variant": "FWD"
         }
     },
+    {
+        "name": "product_device_clearances",
+        "path": "lookup/product-device-clearances",
+        "title": "Device Clearances",
+        "description": "Look up medical devices cleared by the US Food and Drug Administration through premarket notification (510(k)). Supply at least one clearance number, applicant, device name or product code. Names are matched as word phrases; multiple filters must all match. Returns the total matches and clearance records, newest decision first, with device classifications and decision and received dates. Contact names and street addresses are excluded. No match returns an empty list. The source refreshes weekly.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "k_number": {
+                    "type": "string",
+                    "description": "The clearance number, for example K253582"
+                },
+                "applicant": {
+                    "type": "string",
+                    "description": "The company that applied, matched as words. 2 to 100 characters."
+                },
+                "device_name": {
+                    "type": "string",
+                    "description": "The device name, matched as words. 2 to 100 characters."
+                },
+                "product_code": {
+                    "type": "string",
+                    "description": "The FDA product code"
+                },
+                "limit": {
+                    "type": "integer",
+                    "description": "The most clearance records to return. From 1 to 25. Defaults to `10`."
+                }
+            },
+            "required": []
+        },
+        "example": {
+            "applicant": "Apple Inc",
+            "limit": 2
+        }
+    },
     {
         "name": "place_disasters",
         "path": "lookup/place-disasters",
@@ -1003,6 +1062,47 @@ export const LOOKUP_MANIFEST = [
             "limit": 10
         }
     },
+    {
+        "name": "protein_domains",
+        "path": "lookup/protein-domains",
+        "title": "Protein Domains",
+        "description": "InterPro entries from InterPro at EMBL-EBI, under CC0 1.0. Returns integrated InterPro entries only, never member-database signatures. Covers canonical UniProtKB sequences; isoform accessions are refused. Filter by entry type or omit types for all entries. An empty types list keeps no entries. Entries are sorted by their first location’s start, then identifier. Locations span the first through last fragment; discontinuous marks multiple fragments or a fragment whose dc-status is not CONTINUOUS. Releases arrive about every eight weeks; no per-entry date is supplied, so changes are recorded as observations. Returns the first page only (up to 200 entries), with truncated true when another page exists. No match completes with an empty entries list and null protein_length.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "accession": {
+                    "type": "string",
+                    "description": "The canonical UniProt accession identifying the protein, for example P04637; isoforms are not accepted"
+                },
+                "types": {
+                    "type": "array",
+                    "items": {
+                        "type": "string",
+                        "enum": [
+                            "family",
+                            "domain",
+                            "homologous_superfamily",
+                            "repeat",
+                            "conserved_site",
+                            "active_site",
+                            "binding_site",
+                            "ptm"
+                        ]
+                    },
+                    "description": "Keep only these entry types; omitted means all types"
+                }
+            },
+            "required": [
+                "accession"
+            ]
+        },
+        "example": {
+            "accession": "P04637",
+            "types": [
+                "conserved_site"
+            ]
+        }
+    },
     {
         "name": "protein_function",
         "path": "lookup/protein-function",
@@ -1029,6 +1129,27 @@ export const LOOKUP_MANIFEST = [
             "include_sequence": false
         }
     },
+    {
+        "name": "protein_sequence",
+        "path": "lookup/protein-sequence",
+        "title": "Protein Sequence",
+        "description": "Protein sequences from UniProt under CC BY 4.0, attributed to the UniProt Consortium. Medical or genetic information is for research and education only. The sequence is the reference sequence UniProtKB holds for a protein, never an individual’s sequence. Covers reviewed and unreviewed entries; an accession with an isoform suffix (P04637-2) returns that isoform’s sequence. Returns the one-letter sequence, length, molecular weight in daltons, CRC64 and MD5 checksums, gene, organism and the isoforms the entry lists. sequence_version and last_sequence_update describe the entry, also for an isoform. UniProt releases updates every eight weeks. Absent values are null. A merged, demerged or deleted accession returns no protein and the source’s inactive reason with any replacement accessions. No match, including an isoform the entry does not list, returns null for both.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "accession": {
+                    "type": "string",
+                    "description": "The UniProt accession, for example P04637, or an isoform accession, for example P04637-2"
+                }
+            },
+            "required": [
+                "accession"
+            ]
+        },
+        "example": {
+            "accession": "P00001"
+        }
+    },
     {
         "name": "protein_structure",
         "path": "lookup/protein-structure",
@@ -1357,6 +1478,48 @@ export const ROUTE_MANIFEST = [
             "profile_id": "prof_01HX"
         }
     },
+    {
+        "name": "physical_mail_approve",
+        "method": "POST",
+        "path": "/v1/tools/physical-mail/approve",
+        "paid": false,
+        "readOnly": false,
+        "title": "Approve a Mail Quote",
+        "description": "Approve the exact mailpiece and price of a quote. Repeat the input_hash and total_usdc the quote returned: a changed piece or price is refused. Nothing is charged yet. Returns approval_id, which oneshot_physical_mail_send needs with the quote_id.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "quote_id": {
+                    "type": "string",
+                    "description": "Quote id from oneshot_physical_mail_preview"
+                },
+                "input_hash": {
+                    "type": "string",
+                    "description": "input_hash the quote returned (64 hex characters)"
+                },
+                "total_usdc": {
+                    "type": "string",
+                    "description": "total_usdc the quote returned, as a decimal string"
+                },
+                "approved": {
+                    "type": "boolean",
+                    "description": "Must be true: an explicit approval of this piece at this price"
+                }
+            },
+            "required": [
+                "quote_id",
+                "input_hash",
+                "total_usdc",
+                "approved"
+            ]
+        },
+        "example": {
+            "quote_id": "00000000-0000-4000-8000-000000000000",
+            "input_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+            "total_usdc": "1.85",
+            "approved": true
+        }
+    },
     {
         "name": "benchmark",
         "method": "POST",
@@ -1467,6 +1630,30 @@ export const ROUTE_MANIFEST = [
             "state": "IL"
         }
     },
+    {
+        "name": "physical_mail_cancel",
+        "method": "POST",
+        "path": "/v1/tools/physical-mail/orders/{order_id}/cancel",
+        "paid": false,
+        "readOnly": false,
+        "title": "Cancel a Mail Order",
+        "description": "Ask to cancel a mail order. Accepted (202) as a request: cancellation is not guaranteed once the mail has been submitted for printing; read the order to see whether it was canceled and refunded. Free.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "order_id": {
+                    "type": "string",
+                    "description": "Order id from oneshot_physical_mail_send"
+                }
+            },
+            "required": [
+                "order_id"
+            ]
+        },
+        "example": {
+            "order_id": "00000000-0000-4000-8000-000000000000"
+        }
+    },
     {
         "name": "watch_update",
         "method": "PATCH",
@@ -1655,6 +1842,54 @@ export const ROUTE_MANIFEST = [
             "domain": "mail.example.com"
         }
     },
+    {
+        "name": "physical_mail_order",
+        "method": "GET",
+        "path": "/v1/tools/physical-mail/orders/{order_id}",
+        "paid": false,
+        "readOnly": true,
+        "title": "Get a Mail Order",
+        "description": "Read a mail order: order_status, payment_status, fulfillment_status, events, cancel_before and the signed receipt. Free. Delivery events are postal observations, never evidence the mail was read.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "order_id": {
+                    "type": "string",
+                    "description": "Order id from oneshot_physical_mail_send or oneshot_physical_mail_recover"
+                }
+            },
+            "required": [
+                "order_id"
+            ]
+        },
+        "example": {
+            "order_id": "00000000-0000-4000-8000-000000000000"
+        }
+    },
+    {
+        "name": "physical_mail_quote",
+        "method": "GET",
+        "path": "/v1/tools/physical-mail/quotes/{quote_id}",
+        "paid": false,
+        "readOnly": true,
+        "title": "Get a Mail Quote",
+        "description": "Read a quote from oneshot_physical_mail_preview: its status (rendering or ready), input_hash, total_usdc, proof url, expires_at and approval_id once approved. Free. Poll it while status is rendering.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "quote_id": {
+                    "type": "string",
+                    "description": "Quote id from oneshot_physical_mail_preview"
+                }
+            },
+            "required": [
+                "quote_id"
+            ]
+        },
+        "example": {
+            "quote_id": "00000000-0000-4000-8000-000000000000"
+        }
+    },
     {
         "name": "voice_inbound_get",
         "method": "GET",
@@ -1733,6 +1968,83 @@ export const ROUTE_MANIFEST = [
         },
         "example": {}
     },
+    {
+        "name": "physical_mail_preview",
+        "method": "POST",
+        "path": "/v1/tools/physical-mail/preview",
+        "paid": false,
+        "readOnly": false,
+        "title": "Preview and Quote a Mailpiece",
+        "description": "Quote a letter or postcard and render an uncharged test proof. Nothing is printed or charged. Returns quote_id, input_hash, total_usdc (the price of this piece; see Pricing), the proof url and expires_at. Upload the artwork first with oneshot_physical_mail_upload; its asset ids go in artwork.file (letter) or artwork.front and artwork.back (postcard). Next: oneshot_physical_mail_approve with the returned quote_id, input_hash and total_usdc.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "to": {
+                    "type": "object",
+                    "description": "Recipient address: { name, address_line1, address_line2?, address_city, address_state (two letters), address_zip (5 or 9 digits), address_country? (\"US\") }"
+                },
+                "from": {
+                    "type": "object",
+                    "description": "Return address, same shape as to"
+                },
+                "artwork": {
+                    "type": "object",
+                    "description": "Letter: { kind: \"letter\", file: <asset id of a PDF>, color?: boolean, double_sided?: boolean }. Postcard: { kind: \"postcard\", front: <asset id>, back: <asset id> }"
+                }
+            },
+            "required": [
+                "to",
+                "from",
+                "artwork"
+            ]
+        },
+        "example": {
+            "to": {
+                "name": "Jane Doe",
+                "address_line1": "185 Berry St",
+                "address_city": "San Francisco",
+                "address_state": "CA",
+                "address_zip": "94107"
+            },
+            "from": {
+                "name": "Acme Inc",
+                "address_line1": "1 Main St",
+                "address_city": "Austin",
+                "address_state": "TX",
+                "address_zip": "78701"
+            },
+            "artwork": {
+                "kind": "letter",
+                "file": "00000000-0000-4000-8000-000000000000",
+                "color": false,
+                "double_sided": false
+            }
+        }
+    },
+    {
+        "name": "physical_mail_recover",
+        "method": "GET",
+        "path": "/v1/tools/physical-mail/orders/recover",
+        "paid": false,
+        "readOnly": true,
+        "title": "Recover a Mail Order",
+        "description": "Find the order a send created, by the idempotency key given to oneshot_physical_mail_send. Use it after a timeout or lost response instead of sending again. Free. Answers 404 when no send with that key reached the API.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "key": {
+                    "type": "string",
+                    "description": "The idempotency key of the send (1-255 characters: letters, digits, _ . : -)"
+                }
+            },
+            "required": [
+                "key"
+            ]
+        },
+        "example": {
+            "key": "thank-you-2026-q3-jane-doe"
+        }
+    },
     {
         "name": "company_sanctions",
         "method": "POST",
@@ -1802,62 +2114,55 @@ export const ROUTE_MANIFEST = [
         }
     },
     {
-        "name": "solve",
+        "name": "physical_mail_validate_address",
         "method": "POST",
-        "path": "/v1/tools/solve",
-        "paid": true,
+        "path": "/v1/tools/physical-mail/validate-address",
+        "paid": false,
         "readOnly": true,
-        "title": "Solve",
-        "description": "Plan vehicle routes within capacity and time windows. Returns the best route found, constraint checks and conflicts.",
+        "title": "Validate a Mailing Address",
+        "description": "Check that a U.S. postal address is deliverable before quoting mail to it. Returns deliverable, a deliverability code and the standardised address. Free; changes nothing.",
         "inputSchema": {
             "type": "object",
             "properties": {
-                "problem": {
+                "name": {
                     "type": "string",
-                    "enum": [
-                        "routing"
-                    ]
+                    "description": "Recipient name (1-100 characters)"
                 },
-                "time_limit_s": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 300,
-                    "default": 30
+                "address_line1": {
+                    "type": "string",
+                    "description": "Street address (1-200 characters)"
                 },
-                "routing": {
-                    "type": "object",
-                    "description": "Vehicles, stops, objective and optional travel matrix."
+                "address_line2": {
+                    "type": "string",
+                    "description": "Apartment, suite or unit (optional)"
+                },
+                "address_city": {
+                    "type": "string"
+                },
+                "address_state": {
+                    "type": "string",
+                    "description": "Two-letter state code, e.g. CA"
+                },
+                "address_zip": {
+                    "type": "string",
+                    "description": "ZIP code, 5 digits or ZIP+4"
                 }
             },
             "required": [
-                "problem",
-                "routing"
+                "name",
+                "address_line1",
+                "address_city",
+                "address_state",
+                "address_zip"
             ]
         },
         "example": {
-            "problem": "routing",
-            "routing": {
-                "objective": "distance",
-                "vehicles": [
-                    {
-                        "id": "van",
-                        "capacity": 10,
-                        "start": {
-                            "lat": 48,
-                            "lng": 16
-                        }
-                    }
-                ],
-                "stops": [
-                    {
-                        "id": "stop",
-                        "location": {
-                            "lat": 48.01,
-                            "lng": 16.01
-                        }
-                    }
-                ]
-            }
+            "name": "Jane Doe",
+            "address_line1": "185 Berry St",
+            "address_line2": "Suite 6100",
+            "address_city": "San Francisco",
+            "address_state": "CA",
+            "address_zip": "94107"
         }
     },
     {

package/dist/tools/nyne.js

@@ -1,25 +1,22 @@
+import { PERSON_IDENTITY_PROPERTIES, personIdentity } from "./enrichment.js";
 export const personDossierTool = {
     name: "oneshot_person_dossier",
-    description: "Get a person’s profile, known social accounts, articles, posts and written summary. Takes 2-5 minutes. Paid tool. Phone lookup is off by default. include_phone=true buys a lookup for up to one person at the add-on listed on the pricing page; no phone hit is guaranteed.",
+    description: "Get a person’s profile, known social accounts, articles, posts and written summary, from whatever you know: name (+ company), email, phone or a profile URL. Takes 2-5 minutes. Paid tool. Phone lookup is off by default. include_phone=true buys a lookup for up to one person at the add-on listed on the pricing page; no phone hit is guaranteed.",
     inputSchema: {
         type: "object",
         properties: {
             include_phone: { type: "boolean", default: false, description: "Phone lookup is off by default. include_phone=true buys a lookup for up to one person at the add-on listed on the pricing page; no phone hit is guaranteed." },
-            email: { type: "string", description: "Person's email address" },
-            social_media_url: { type: "string", description: "LinkedIn, Twitter, or other social profile URL" },
-            name: { type: "string", description: "Person's full name" },
-            company: { type: "string", description: "Company name (helps disambiguate)" },
+            ...PERSON_IDENTITY_PROPERTIES,
         },
     },
 };
 export const personSocialAccountsTool = {
     name: "oneshot_person_social_accounts",
-    description: "Discover all social media profiles for a person across platforms (LinkedIn, Twitter, GitHub, YouTube, etc). Paid tool.",
+    description: "Discover all social media profiles for a person across platforms (LinkedIn, Twitter, GitHub, YouTube, etc), from a name (+ company), email, phone or a known profile URL. Paid tool.",
     inputSchema: {
         type: "object",
         properties: {
-            email: { type: "string", description: "Person's email address" },
-            social_media_url: { type: "string", description: "Known social profile URL to start from" },
+            ...PERSON_IDENTITY_PROPERTIES,
         },
     },
 };
@@ -39,38 +36,34 @@ export const personArticlesTool = {
 };
 export const personPostsTool = {
     name: "oneshot_person_posts",
-    description: "Get a person's recent social media posts with likes, replies, and shares. Paid tool.",
+    description: "Get a person's recent social media posts with likes, replies, and shares. Give a profile URL, or a name (+ company) / email to resolve one. Paid tool.",
     inputSchema: {
         type: "object",
         properties: {
-            social_media_url: { type: "string", description: "Social profile URL (Twitter, LinkedIn, etc)" },
+            ...PERSON_IDENTITY_PROPERTIES,
         },
-        required: ["social_media_url"],
     },
 };
 export const personInterestsTool = {
     name: "oneshot_person_interests",
-    description: "Figure out what someone cares about — sports, politics, tech, entertainment, etc. Paid tool.",
+    description: "Figure out what someone cares about — sports, politics, tech, entertainment, etc. Give a name (+ company), email, phone or profile URL. Paid tool.",
     inputSchema: {
         type: "object",
         properties: {
-            email: { type: "string", description: "Person's email address" },
-            phone: { type: "string", description: "Person's phone number" },
-            social_media_url: { type: "string", description: "Social profile URL" },
+            ...PERSON_IDENTITY_PROPERTIES,
         },
     },
 };
 export const personFollowersTool = {
     name: "oneshot_person_followers",
-    description: "See who someone follows, who follows them, and who they reply to. Paid tool.",
+    description: "See who someone follows, who follows them, and who they reply to. Give an X profile URL, or a name (+ company) / email to resolve one. Paid tool.",
     inputSchema: {
         type: "object",
         properties: {
-            social_media_url: { type: "string", description: "Social profile or post URL (Twitter/X or Instagram)" },
+            ...PERSON_IDENTITY_PROPERTIES,
             type: { type: "string", enum: ["replies", "followers", "following", "followers,following"], description: "Interaction type (default: followers,following)" },
             max_results: { type: "number", description: "Max results 1-1000 (default: 100)" },
         },
-        required: ["social_media_url"],
     },
 };
 /** Deep person research fans out across several providers. The SDK now defaults personDossier to the same 300 s (#1913); this keeps the MCP value explicit. */
@@ -78,18 +71,12 @@ export const PERSON_DOSSIER_TIMEOUT_SEC = 300;
 export async function handlePersonDossier(agent, args) {
     return agent.personDossier({
         includePhone: args.include_phone,
-        email: args.email,
-        social_media_url: args.social_media_url,
-        name: args.name,
-        company: args.company,
+        ...personIdentity(args),
         timeout: PERSON_DOSSIER_TIMEOUT_SEC,
     });
 }
 export async function handlePersonSocialAccounts(agent, args) {
-    return agent.personSocialAccounts({
-        email: args.email,
-        social_media_url: args.social_media_url,
-    });
+    return agent.personSocialAccounts(personIdentity(args));
 }
 export async function handlePersonArticles(agent, args) {
     return agent.personArticles({
@@ -100,20 +87,14 @@ export async function handlePersonArticles(agent, args) {
     });
 }
 export async function handlePersonPosts(agent, args) {
-    return agent.personPosts({
-        social_media_url: args.social_media_url,
-    });
+    return agent.personPosts(personIdentity(args));
 }
 export async function handlePersonInterests(agent, args) {
-    return agent.personInterests({
-        email: args.email,
-        phone: args.phone,
-        social_media_url: args.social_media_url,
-    });
+    return agent.personInterests(personIdentity(args));
 }
 export async function handlePersonFollowers(agent, args) {
     return agent.personFollowers({
-        social_media_url: args.social_media_url,
+        ...personIdentity(args),
         type: args.type,
         max_results: args.max_results,
     });

package/dist/tools/physical-mail.d.ts

@@ -0,0 +1,34 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
+/**
+ * The two Physical Mail steps that a generated route tool cannot carry (#1883): the send,
+ * which needs an idempotency key header beside the quote id and the approval id, and the
+ * artwork upload, whose body is a raw PDF, PNG or JPEG. Both go through the SDK's
+ * `physicalMail` (libs/agent-sdk/src/physical-mail.ts). The other seven routes (validate,
+ * preview, quote, approve, recover, order, cancel) are generated from the declaration.
+ */
+/** The route's own limit (`uploadArtwork` in services/physical-mail/service.ts): 20 MB. */
+export declare const PHYSICAL_MAIL_ASSET_LIMIT_BYTES: number;
+export declare const PHYSICAL_MAIL_ASSET_TYPES: readonly ["application/pdf", "image/png", "image/jpeg"];
+type AssetType = (typeof PHYSICAL_MAIL_ASSET_TYPES)[number];
+export declare const physicalMailSendTool: Tool;
+export declare function handlePhysicalMailSend(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").MailOrder>;
+export declare const physicalMailUploadTool: Tool;
+/** Decodes the base64 `content`, refusing anything that is not base64 or that would exceed the route's limit before any bytes are sent. */
+export declare function decodeArtwork(args: Record<string, unknown>): {
+    data: Uint8Array;
+    mime: AssetType;
+};
+/**
+ * The decoded size of structurally valid base64 (standard or URL-safe alphabet, padding optional), or null.
+ * `Buffer.from(text, "base64")` tolerates a length one past a quartet, missing, short and excess padding
+ * (`AAAAA`, `AAA==`, `AAAA==`), so counting characters and subtracting the `=`s would undercount such
+ * input; the bound has to come from a shape the decoder cannot read differently.
+ */
+export declare function base64Size(text: string): number | null;
+export declare function handlePhysicalMailUpload(agent: OneShot, args: Record<string, unknown>): Promise<{
+    asset_id: string;
+    content_hash: string;
+    mime_type: string;
+}>;
+export {};