@oneshot-agent/mcp-server 0.48.0 → 0.49.0

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

@@ -21,6 +21,10 @@ export const LOOKUP_MANIFEST = [
                 "limit": {
                     "type": "integer",
                     "description": "Most banks to return. From 1 to 10. Defaults to `5`."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": []
@@ -99,6 +103,10 @@ export const LOOKUP_MANIFEST = [
                 "limit": {
                     "type": "integer",
                     "description": "Most filings to return, newest first. From 1 to 50. Defaults to `10`."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": [
@@ -230,6 +238,10 @@ export const LOOKUP_MANIFEST = [
                 "limit": {
                     "type": "integer",
                     "description": "Most complaints to return, newest first. From 1 to 25. Defaults to `10`."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": [
@@ -271,6 +283,10 @@ export const LOOKUP_MANIFEST = [
                 "limit": {
                     "type": "integer",
                     "description": "Most licences to return. From 1 to 20. Defaults to `5`."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": [
@@ -379,6 +395,36 @@ export const LOOKUP_MANIFEST = [
             "variant": "FWD"
         }
     },
+    {
+        "name": "record_customs_rulings_find",
+        "path": "find/record-customs-rulings",
+        "title": "Customs Rulings",
+        "description": "Searches rulings published by US Customs and Border Protection, closest match first, with ruling numbers you can cite, dates, tariff numbers and revocation status. A ruling binds only the goods it describes. The rate itself comes from Duty Rate. New rulings are added daily as issued. Each answer includes the ruling date and a link to the ruling page. The optional tariff_number prefix filters the returned page. Fewer than limit rulings may remain; total is the source match count before filtering.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "query": {
+                    "type": "string",
+                    "description": "Search words, for example bluetooth speaker. 2 to 200 characters."
+                },
+                "tariff_number": {
+                    "type": "string",
+                    "description": "Keep rulings with a tariff number starting with this prefix, for example 8518, 8518.22 or 8518.22.0000"
+                },
+                "limit": {
+                    "type": "integer",
+                    "description": "The most rulings to fetch before the optional tariff filter. From 1 to 20. Defaults to `10`."
+                }
+            },
+            "required": [
+                "query"
+            ]
+        },
+        "example": {
+            "query": "bluetooth speaker",
+            "limit": 1
+        }
+    },
     {
         "name": "product_device_clearances",
         "path": "lookup/product-device-clearances",
@@ -647,6 +693,10 @@ export const LOOKUP_MANIFEST = [
                 "limit": {
                     "type": "integer",
                     "description": "How many facilities to return. From 1 to 25. Defaults to `10`."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": [
@@ -686,6 +736,10 @@ export const LOOKUP_MANIFEST = [
                 "limit": {
                     "type": "integer",
                     "description": "The most establishments to return. From 1 to 10. Defaults to `3`."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": []
@@ -729,6 +783,10 @@ export const LOOKUP_MANIFEST = [
                 "limit": {
                     "type": "integer",
                     "description": "Most awards to return, largest first. From 1 to 25. Defaults to `10`."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": [
@@ -1226,6 +1284,10 @@ export const LOOKUP_MANIFEST = [
                 "limit": {
                     "type": "integer",
                     "description": "Most inspections to return per establishment. From 1 to 20. Defaults to `5`."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": []
@@ -1266,6 +1328,10 @@ export const LOOKUP_MANIFEST = [
                 "limit": {
                     "type": "integer",
                     "description": "Most providers to return from a name search. From 1 to 20. Defaults to `5`."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": []
@@ -1301,6 +1367,10 @@ export const LOOKUP_MANIFEST = [
                 "limit": {
                     "type": "integer",
                     "description": "Most providers to return. From 1 to 20. Defaults to `5`."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": []
@@ -1335,6 +1405,49 @@ export const LOOKUP_MANIFEST = [
             "limit": 2
         }
     },
+    {
+        "name": "market_interest_rates",
+        "path": "lookup/market-interest-rates",
+        "title": "Interest Rates",
+        "description": "Daily US overnight reference rates published by the Federal Reserve Bank of New York, in percent per year: SOFR, EFFR (with the FOMC target range), OBFR, TGCR, BGCR and the SOFR averages and index. Returns observations newest first for a date range or the most recent published days. OneShot is not affiliated with the New York Fed. The New York Fed does not sanction, endorse, or recommend any products or services offered by OneShot. The rate data is subject to the Terms of Use posted at newyorkfed.org; every answer carries the notice those terms require with any republication, in notice, and it must stay with the data when the answer is shown or passed on. Available rates are the secured overnight financing rate (sofr), the effective federal funds rate (effr, with the FOMC target range), the overnight bank funding rate (obfr), the tri-party general collateral rate (tgcr), the broad general collateral rate (bgcr) and the 30-, 90- and 180-day SOFR averages with the SOFR index (sofr_averages). Returns one observation per business day, newest first, either for a date range (at most 366 days, not in the future) or the last 1 to 30 published days. Each observation carries the rate, its 1st, 25th, 75th and 99th percentiles and the underlying volume in billions of US dollars where the source publishes them; fields that do not apply to a rate are null. revised is true when the source marks the day as revised. A range with no business days returns an empty list. Overnight rates (sofr, effr, obfr, tgcr, bgcr) are dated the business day they apply to and published the next US business day; sofr_averages is dated the day it is published and compounds SOFR through the previous business day. Source: Federal Reserve Bank of New York.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "rate": {
+                    "type": "string",
+                    "enum": [
+                        "sofr",
+                        "effr",
+                        "obfr",
+                        "tgcr",
+                        "bgcr",
+                        "sofr_averages"
+                    ],
+                    "description": "Rate code: sofr, effr, obfr, tgcr, bgcr or sofr_averages"
+                },
+                "start_date": {
+                    "type": "string",
+                    "description": "First date, YYYY-MM-DD; give both start_date and end_date or neither. YYYY-MM-DD."
+                },
+                "end_date": {
+                    "type": "string",
+                    "description": "Last date, YYYY-MM-DD, inclusive; at most 366 days after start_date and not in the future. YYYY-MM-DD."
+                },
+                "last": {
+                    "type": "integer",
+                    "description": "Number of most recent published days, 1 to 30, used when no dates are given. From 1 to 30. Defaults to `5`."
+                }
+            },
+            "required": [
+                "rate"
+            ]
+        },
+        "example": {
+            "rate": "sofr",
+            "start_date": "2026-10-15",
+            "end_date": "2026-10-16"
+        }
+    },
     {
         "name": "company_legal_identifier",
         "path": "lookup/company-legal-identifier",
@@ -1354,6 +1467,10 @@ export const LOOKUP_MANIFEST = [
                 "limit": {
                     "type": "integer",
                     "description": "Most entities to return. From 1 to 10. Defaults to `5`."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": []
@@ -1392,6 +1509,10 @@ export const LOOKUP_MANIFEST = [
                 "limit": {
                     "type": "integer",
                     "description": "Most licences to return. From 1 to 25. Defaults to `10`."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": [
@@ -1422,6 +1543,10 @@ export const LOOKUP_MANIFEST = [
                 "limit": {
                     "type": "integer",
                     "description": "Most filings to return, newest posted first. From 1 to 25. Defaults to `10`."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": [
@@ -1434,6 +1559,62 @@ export const LOOKUP_MANIFEST = [
             "limit": 1
         }
     },
+    {
+        "name": "market_medicare_drug_spending",
+        "path": "lookup/market-medicare-drug-spending",
+        "title": "Medicare Drug Spending",
+        "description": "Returns Medicare Part D programme spending before rebates, by calendar year, from the US Centers for Medicare & Medicaid Services. Overall is the total across manufacturers; manufacturers can be included separately. Figures include spending, dosage units, claims, beneficiaries and average spending. The series updates annually and supplies the latest five calendar years. Provide brand_name, generic_name, or both. Both exact-match filters apply when both are supplied. Reads one source page of up to 50 rows, including manufacturer rows before filtering; broad matches may be incomplete. Empty source values become null. No match completes with drugs: [].",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "brand_name": {
+                    "type": "string",
+                    "description": "Exact brand name, for example Eliquis. 2 to 100 characters."
+                },
+                "generic_name": {
+                    "type": "string",
+                    "description": "Exact generic name, for example Apixaban. 2 to 100 characters."
+                },
+                "manufacturers": {
+                    "type": "boolean",
+                    "description": "Include per-manufacturer rows in addition to Overall totals. Defaults to `false`."
+                }
+            },
+            "required": []
+        },
+        "example": {
+            "brand_name": "Eliquis"
+        }
+    },
+    {
+        "name": "market_medicare_fees",
+        "path": "lookup/market-medicare-fees",
+        "title": "Medicare Fee Schedule",
+        "description": "Returns the status indicator, relative value units, conversion factors and national payment amounts, before the locality adjustment, on Medicare's physician payment schedule for a procedure code and modifier. Non-facility is an office, where the practice bears the overhead; facility is a hospital or other facility paid separately for it. Codes and amounts only; procedure descriptions are licensed and not returned. Without a modifier, the rows with no modifier are returned; with one, only that modifier's rows (for example 26 for the professional component and TC for the technical component). From 2026 each code has one rate per conversion factor: one for qualifying alternative payment model participants and one for all other clinicians, in that order. Earlier years have one rate. A practice expense the source marks not applicable gives null practice expense, total and payment for that setting, never zero. When the Medicare Administrative Contractor sets the amount (status C, or L for a local code), both national payments are null. The relative value units are returned as the source lists them. The source is the US Centers for Medicare & Medicaid Services indicators table of the physician payment schedule for the year; locality adjustments are not applied. No match, including a code not on the schedule for the year, completes with rates: [] and a null status.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "code": {
+                    "type": "string",
+                    "description": "Five-character procedure code, for example 99213 or G0439. five letters or digits."
+                },
+                "modifier": {
+                    "type": "string",
+                    "description": "Two-character modifier, for example 26 or TC; without it, rows with no modifier are returned. two letters or digits."
+                },
+                "year": {
+                    "type": "integer",
+                    "description": "Calendar year of the schedule; defaults to the newest published year. From 2025 to 2026. Defaults to `2026`."
+                }
+            },
+            "required": [
+                "code"
+            ]
+        },
+        "example": {
+            "code": "99213"
+        }
+    },
     {
         "name": "company_medicare_ownership",
         "path": "lookup/company-medicare-ownership",
@@ -1465,6 +1646,10 @@ export const LOOKUP_MANIFEST = [
                 "limit": {
                     "type": "integer",
                     "description": "Most facilities to return. From 1 to 10. Defaults to `3`."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": [
@@ -1491,6 +1676,10 @@ export const LOOKUP_MANIFEST = [
                 "mc_number": {
                     "type": "string",
                     "description": "The carrier's motor carrier (MC) number, for example MC-1515. mc_number must be 1 to 8 digits, with an optional MC or MC- in front."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": []
@@ -1649,6 +1838,40 @@ export const LOOKUP_MANIFEST = [
             "include_sequence": false
         }
     },
+    {
+        "name": "protein_interactions",
+        "path": "lookup/protein-interactions",
+        "title": "Protein Interactions",
+        "description": "Returns a protein's interaction partners from the STRING network (CC BY 4.0, STRING consortium): the query protein and each partner with a combined confidence score (0 to 1) and per-channel scores. Scores combine experimental, curated and predicted (text-mining, co-expression) evidence, so a high score is not proof of physical binding. The data is for research, not medical advice. Evidence channels: experiments, curated databases, text mining, co-expression, genomic neighborhood, gene fusion and phylogenetic co-occurrence, each scored 0 to 1. identifier is a gene symbol (TP53) or a UniProt accession (P04637); taxon_id is human (9606) by default. Partners come in the source's order, highest combined score first, up to limit; min_score is the lowest combined score kept. An identifier the source cannot map in that organism returns no protein and an empty partner list. Only the source's own combined and channel scores are returned, never records from the databases it incorporates.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "identifier": {
+                    "type": "string",
+                    "description": "A gene symbol or a UniProt accession, for example TP53 or P04637. Letters, digits, \".\", \"_\" and \"-\" only, 1 to 40."
+                },
+                "taxon_id": {
+                    "type": "integer",
+                    "description": "The organism as an NCBI Taxonomy ID; 9606 is human, 10090 is mouse. From 1 to 999999999. Defaults to `9606`."
+                },
+                "limit": {
+                    "type": "integer",
+                    "description": "Maximum partners returned. From 1 to 50. Defaults to `10`."
+                },
+                "min_score": {
+                    "type": "number",
+                    "description": "Lowest combined confidence score kept. From 0.15 to 1. Defaults to `0.4`."
+                }
+            },
+            "required": [
+                "identifier"
+            ]
+        },
+        "example": {
+            "identifier": "TP53",
+            "limit": 1
+        }
+    },
     {
         "name": "protein_resolve",
         "path": "resolve/protein",
@@ -1739,6 +1962,51 @@ export const LOOKUP_MANIFEST = [
             "limit": 2
         }
     },
+    {
+        "name": "record_publications_find",
+        "path": "find/record-publications",
+        "title": "Publications",
+        "description": "Searches PubMed, the US National Library of Medicine's index of biomedical papers, newest or most relevant first: title, journal, dates, first three authors, DOI, PubMed Central id, publication types and link. Only citation fields are returned, never an abstract or full text. The answer lists what a public index holds: it is for research and is not medical advice. `total` is how many papers matched in all, including any beyond `limit`, and is 0 when none did. `query_translation` shows how the source expanded the search (MeSH terms, plurals, the year range). Field tags such as `[Title]` or `[MeSH Terms]` and `AND`, `OR` and `NOT` are passed to the source as written. Give `from_year`, `to_year` or both to keep papers published in those years; one alone is open on the other side. `sort` is `newest` (by publication date, the default) or `relevance`. Each paper also gives its author count. Registered studies are in `record_clinical_trials_find`; the papers NCBI links to one gene are in `gene_publications`.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "query": {
+                    "type": "string",
+                    "description": "PubMed search text, for example semaglutide AND kidney; field tags such as [Title] or [MeSH Terms] and AND/OR/NOT are allowed. 2 to 300 characters."
+                },
+                "from_year": {
+                    "type": "integer",
+                    "description": "Only papers published in this year or later, no later than the current year. At least 1800."
+                },
+                "to_year": {
+                    "type": "integer",
+                    "description": "Only papers published in this year or earlier, no later than the current year. At least 1800."
+                },
+                "sort": {
+                    "type": "string",
+                    "enum": [
+                        "newest",
+                        "relevance"
+                    ],
+                    "description": "newest (by publication date) or relevance. Defaults to `\"newest\"`."
+                },
+                "limit": {
+                    "type": "integer",
+                    "description": "The most papers to return. From 1 to 20. Defaults to `10`."
+                }
+            },
+            "required": [
+                "query"
+            ]
+        },
+        "example": {
+            "query": "semaglutide AND kidney",
+            "from_year": 2024,
+            "to_year": 2026,
+            "sort": "relevance",
+            "limit": 3
+        }
+    },
     {
         "name": "company_financials",
         "path": "lookup/company-financials",
@@ -1776,6 +2044,10 @@ export const LOOKUP_MANIFEST = [
                 "limit": {
                     "type": "integer",
                     "description": "Most periods to return, newest first. From 1 to 20. Defaults to `5`."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": [
@@ -1789,6 +2061,37 @@ export const LOOKUP_MANIFEST = [
             "limit": 2
         }
     },
+    {
+        "name": "market_truck_rates",
+        "path": "lookup/market-truck-rates",
+        "title": "Truck Rates",
+        "description": "Returns reported weekly rates for refrigerated produce loads, not a quote, from the US Department of Agriculture. Origins are shipping districts. Each lane includes weekly low, high, midpoint and rate per mile, plus truck availability: 1 means surplus, 3 adequate supply and 5 shortage, with intermediate values 2 and 4. Origin and optional destination match uppercase substrings. Omit destination to return several lanes. Reads one page of weeks × 40 rows, capped at 1000, newest first; keeps up to weeks rows per lane from that page. History is available from the first call. Lane details use the newest row. Empty numeric fields are null. No match returns an empty lanes list.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "origin": {
+                    "type": "string",
+                    "description": "Shipping district substring, for example Salinas or Florida. 2 to 80 characters."
+                },
+                "destination": {
+                    "type": "string",
+                    "description": "Destination city substring, for example Chicago. 2 to 80 characters."
+                },
+                "weeks": {
+                    "type": "integer",
+                    "description": "Most recent weeks per lane. From 1 to 26. Defaults to `4`."
+                }
+            },
+            "required": [
+                "origin"
+            ]
+        },
+        "example": {
+            "origin": "Salinas",
+            "destination": "Chicago",
+            "weeks": 1
+        }
+    },
     {
         "name": "variant_clinical_significance",
         "path": "lookup/variant-clinical-significance",
@@ -1812,6 +2115,29 @@ export const LOOKUP_MANIFEST = [
             "rsid": "rs80357906"
         }
     },
+    {
+        "name": "variant_frequency",
+        "path": "lookup/variant-frequency",
+        "title": "Variant Frequency",
+        "description": "Reports aggregate allele counts and frequencies from the Genome Aggregation Database (gnomAD), Broad Institute, showing what a public reference population contains, by genetic ancestry group. For research; not medical advice. An rsID matching several variants needs the variant_id. Supply one variant identifier, never a person’s genome, sequencing data or a VCF file. Uses gnomAD v4 (GRCh38), exomes and genomes. Data refresh per versioned release; no observation date is supplied. Primary exome and genome data are CC0 1.0. Never try to reidentify participants. Only ancestry groups are returned; sex splits, reference-panel subsets and other annotations are excluded. An absent data type is null. Allele frequency is allele count divided by allele number, or null when the denominator is zero.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "variant_id": {
+                    "type": "string",
+                    "description": "gnomAD variant ID on GRCh38, for example 1-55051215-G-GA; supply only variant_id or rsid"
+                },
+                "rsid": {
+                    "type": "string",
+                    "description": "dbSNP identifier, for example rs527413419; supply only rsid or variant_id"
+                }
+            },
+            "required": []
+        },
+        "example": {
+            "variant_id": "1-55051215-G-GA"
+        }
+    },
     {
         "name": "variant_resolve",
         "path": "resolve/variant",
@@ -1880,6 +2206,10 @@ export const LOOKUP_MANIFEST = [
                 "vat_number": {
                     "type": "string",
                     "description": "The VAT number, 2 to 14 letters and digits once spaces, dots and dashes are removed; a leading country code equal to country is removed. 2 to 40 characters. letters, digits, spaces, dots and dashes only."
+                },
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Look the record up again instead of using OneShot's stored copy from an earlier lookup, and refresh that copy. Off by default: a record stored within its freshness window is returned as is, with cached: true and its fetched_at."
                 }
             },
             "required": [
@@ -3117,6 +3447,10 @@ export const ROUTE_MANIFEST = [
         "inputSchema": {
             "type": "object",
             "properties": {
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Refresh the source lists before screening"
+                },
                 "name": {
                     "type": "string",
                     "description": "The company name to check, 2 to 200 characters, free text. Word order and punctuation do not matter"
@@ -3151,6 +3485,10 @@ export const ROUTE_MANIFEST = [
         "inputSchema": {
             "type": "object",
             "properties": {
+                "fresh": {
+                    "type": "boolean",
+                    "description": "Refresh the source lists before screening"
+                },
                 "name": {
                     "type": "string",
                     "description": "The person name to check, 2 to 200 characters, free text. Word order, accents and punctuation do not matter"

package/dist/tools/nyne.js

@@ -1,28 +1,30 @@
-import { PERSON_IDENTITY_PROPERTIES, personIdentity } from "./enrichment.js";
+import { FRESH_PROPERTY, 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, 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.",
+    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. A record looked up recently may come from OneShot's store of earlier lookups; the result says so with cached and fetched_at, and fresh=true asks again.",
     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." },
             ...PERSON_IDENTITY_PROPERTIES,
+            ...FRESH_PROPERTY,
         },
     },
 };
 export const personSocialAccountsTool = {
     name: "oneshot_person_social_accounts",
-    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.",
+    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. A record looked up recently may come from OneShot's store of earlier lookups; the result says so with cached and fetched_at, and fresh=true asks again.",
     inputSchema: {
         type: "object",
         properties: {
             ...PERSON_IDENTITY_PROPERTIES,
+            ...FRESH_PROPERTY,
         },
     },
 };
 export const personArticlesTool = {
     name: "oneshot_person_articles",
-    description: "Find articles, publications, and interviews about a person. Requires name and company. Paid tool.",
+    description: "Find articles, publications, and interviews about a person. Requires name and company. Paid tool. A record looked up recently may come from OneShot's store of earlier lookups; the result says so with cached and fetched_at, and fresh=true asks again.",
     inputSchema: {
         type: "object",
         properties: {
@@ -30,39 +32,43 @@ export const personArticlesTool = {
             company: { type: "string", description: "Company name or domain" },
             sort: { type: "string", enum: ["recent", "popular"], description: "Sort order (default: recent)" },
             limit: { type: "number", description: "Max results 1-20 (default: 5)" },
+            ...FRESH_PROPERTY,
         },
         required: ["name", "company"],
     },
 };
 export const personPostsTool = {
     name: "oneshot_person_posts",
-    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.",
+    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. A record looked up recently may come from OneShot's store of earlier lookups; the result says so with cached and fetched_at, and fresh=true asks again.",
     inputSchema: {
         type: "object",
         properties: {
             ...PERSON_IDENTITY_PROPERTIES,
+            ...FRESH_PROPERTY,
         },
     },
 };
 export const personInterestsTool = {
     name: "oneshot_person_interests",
-    description: "Figure out what someone cares about — sports, politics, tech, entertainment, etc. Give a name (+ company), email, phone or profile URL. 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. A record looked up recently may come from OneShot's store of earlier lookups; the result says so with cached and fetched_at, and fresh=true asks again.",
     inputSchema: {
         type: "object",
         properties: {
             ...PERSON_IDENTITY_PROPERTIES,
+            ...FRESH_PROPERTY,
         },
     },
 };
 export const personFollowersTool = {
     name: "oneshot_person_followers",
-    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.",
+    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. A record looked up recently may come from OneShot's store of earlier lookups; the result says so with cached and fetched_at, and fresh=true asks again.",
     inputSchema: {
         type: "object",
         properties: {
             ...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)" },
+            ...FRESH_PROPERTY,
         },
     },
 };
@@ -72,11 +78,12 @@ export async function handlePersonDossier(agent, args) {
     return agent.personDossier({
         includePhone: args.include_phone,
         ...personIdentity(args),
+        fresh: args.fresh,
         timeout: PERSON_DOSSIER_TIMEOUT_SEC,
     });
 }
 export async function handlePersonSocialAccounts(agent, args) {
-    return agent.personSocialAccounts(personIdentity(args));
+    return agent.personSocialAccounts({ ...personIdentity(args), fresh: args.fresh });
 }
 export async function handlePersonArticles(agent, args) {
     return agent.personArticles({
@@ -84,18 +91,20 @@ export async function handlePersonArticles(agent, args) {
         company: args.company,
         sort: args.sort,
         limit: args.limit,
+        fresh: args.fresh,
     });
 }
 export async function handlePersonPosts(agent, args) {
-    return agent.personPosts(personIdentity(args));
+    return agent.personPosts({ ...personIdentity(args), fresh: args.fresh });
 }
 export async function handlePersonInterests(agent, args) {
-    return agent.personInterests(personIdentity(args));
+    return agent.personInterests({ ...personIdentity(args), fresh: args.fresh });
 }
 export async function handlePersonFollowers(agent, args) {
     return agent.personFollowers({
         ...personIdentity(args),
         type: args.type,
         max_results: args.max_results,
+        fresh: args.fresh,
     });
 }