@cliwant/mcp-sam-gov 1.4.0 → 1.5.0

package/dist/nws-weather.d.ts

@@ -0,0 +1,57 @@
+/**
+ * nws-weather.ts — National Weather Service active alerts (api.weather.gov, KEYLESS)
+ * — the DISASTER / CLIMATE-READINESS lane. Current watches, warnings, and advisories
+ * (event, severity, urgency, area, effective/expires window, instructions). Pairs
+ * directly with the FEMA tools (disaster declarations → public assistance → hazard
+ * mitigation → LIVE active weather) to complete a disaster-response-readiness view:
+ * where severe-weather events are active NOW, ahead of the declarations/contracts
+ * that follow.
+ *
+ * SOURCE: NWS api.weather.gov (a .gov host), keyless. Requires a descriptive
+ * User-Agent (NWS policy) — sent from a fixed constant; no token. Returns a GeoJSON
+ * FeatureCollection. This is REAL-TIME data (currently-active alerts) — freshness is
+ * disclosed and never implied to be a historical series.
+ *
+ * HONESTY: fixed host + redirect:"error" (SSRF); `state` is a 2-letter charclass (the
+ * server-side ?area= filter); event/severity are applied CLIENT-SIDE over the returned
+ * set; a non-FeatureCollection / non-array body ⇒ driftError; an outage/4xx/timeout
+ * THROWS. A genuine no-active-alerts result ⇒ an HONEST EMPTY (returned:0), never an
+ * error. totalAvailable = the EXACT count of matched active alerts. Every scalar via
+ * `str` (null-never-empty-string); dates preserved as ISO strings.
+ */
+import { type MetaBundle } from "./meta.js";
+export declare const NWS_HOST = "api.weather.gov";
+export type NwsAlert = {
+    id: string | null;
+    event: string | null;
+    headline: string | null;
+    severity: string | null;
+    urgency: string | null;
+    certainty: string | null;
+    category: string | null;
+    status: string | null;
+    messageType: string | null;
+    areaDesc: string | null;
+    effective: string | null;
+    onset: string | null;
+    expires: string | null;
+    ends: string | null;
+    senderName: string | null;
+    description: string | null;
+    instruction: string | null;
+    response: string | null;
+};
+/**
+ * List CURRENTLY-ACTIVE NWS weather alerts, optionally scoped by `state` (server-side
+ * ?area=) and filtered client-side by `event` (substring) and/or `severity` (exact).
+ * Honest `_meta` (exact match total + real-time freshness; a no-alerts result is an
+ * honest empty).
+ */
+export declare function activeAlerts(args: {
+    state?: string;
+    event?: string;
+    severity?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<MetaBundle>;
+//# sourceMappingURL=nws-weather.d.ts.map

package/dist/nws-weather.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nws-weather.d.ts","sourceRoot":"","sources":["../src/nws-weather.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,OAAO,EAAY,KAAK,UAAU,EAAqB,MAAM,WAAW,CAAC;AAEzE,eAAO,MAAM,QAAQ,oBAAoB,CAAC;AAa1C,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AA+CF;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,UAAU,CAAC,CAgDtB"}

package/dist/nws-weather.js

@@ -0,0 +1,131 @@
+/**
+ * nws-weather.ts — National Weather Service active alerts (api.weather.gov, KEYLESS)
+ * — the DISASTER / CLIMATE-READINESS lane. Current watches, warnings, and advisories
+ * (event, severity, urgency, area, effective/expires window, instructions). Pairs
+ * directly with the FEMA tools (disaster declarations → public assistance → hazard
+ * mitigation → LIVE active weather) to complete a disaster-response-readiness view:
+ * where severe-weather events are active NOW, ahead of the declarations/contracts
+ * that follow.
+ *
+ * SOURCE: NWS api.weather.gov (a .gov host), keyless. Requires a descriptive
+ * User-Agent (NWS policy) — sent from a fixed constant; no token. Returns a GeoJSON
+ * FeatureCollection. This is REAL-TIME data (currently-active alerts) — freshness is
+ * disclosed and never implied to be a historical series.
+ *
+ * HONESTY: fixed host + redirect:"error" (SSRF); `state` is a 2-letter charclass (the
+ * server-side ?area= filter); event/severity are applied CLIENT-SIDE over the returned
+ * set; a non-FeatureCollection / non-array body ⇒ driftError; an outage/4xx/timeout
+ * THROWS. A genuine no-active-alerts result ⇒ an HONEST EMPTY (returned:0), never an
+ * error. totalAvailable = the EXACT count of matched active alerts. Every scalar via
+ * `str` (null-never-empty-string); dates preserved as ISO strings.
+ */
+import { ToolErrorCarrier } from "./errors.js";
+import { getJson, driftError } from "./datasource.js";
+import { str } from "./coerce.js";
+import { withMeta } from "./meta.js";
+export const NWS_HOST = "api.weather.gov";
+const NWS_ACTIVE_URL = "https://api.weather.gov/alerts/active";
+const NWS_LABEL = "nws:/alerts/active";
+const NWS_TIMEOUT_MS = 15_000;
+// NWS asks every client to send a descriptive User-Agent (with contact). No token.
+const NWS_USER_AGENT = "cliwant-mcp-sam-gov (https://github.com/cliwant/mcp-sam-gov)";
+const STATE_RE = /^[A-Za-z]{2}$/;
+const PROVENANCE_NOTE = "Source: NWS api.weather.gov active-alerts feed (keyless; a descriptive User-Agent is sent per NWS policy).";
+const FRESHNESS_NOTE = "REAL-TIME: these are the alerts ACTIVE at request time (a live snapshot, not a historical archive). Read effective/onset/expires/ends for each alert's window; an expired alert is not returned. A no-active-alerts result is an HONEST empty (returned:0), never an error.";
+function mapAlert(feature) {
+    const p = (feature ?? {}).properties ?? {};
+    return {
+        id: str(p.id),
+        event: str(p.event),
+        headline: str(p.headline),
+        severity: str(p.severity),
+        urgency: str(p.urgency),
+        certainty: str(p.certainty),
+        category: str(p.category),
+        status: str(p.status),
+        messageType: str(p.messageType),
+        areaDesc: str(p.areaDesc),
+        effective: str(p.effective),
+        onset: str(p.onset),
+        expires: str(p.expires),
+        ends: str(p.ends),
+        senderName: str(p.senderName),
+        description: str(p.description),
+        instruction: str(p.instruction),
+        response: str(p.response),
+    };
+}
+async function loadActiveAlerts(state) {
+    const params = new URLSearchParams();
+    if (state !== undefined)
+        params.set("area", state.toUpperCase());
+    const url = params.toString() ? `${NWS_ACTIVE_URL}?${params.toString()}` : NWS_ACTIVE_URL;
+    const built = new URL(url);
+    if (built.hostname !== NWS_HOST || built.protocol !== "https:") {
+        throw driftError(NWS_LABEL, `Constructed NWS URL host ${JSON.stringify(built.hostname)} is not ${NWS_HOST} over https — refusing to fetch (SSRF safety).`);
+    }
+    const body = (await getJson(url, {
+        label: NWS_LABEL,
+        redirect: "error",
+        timeoutMs: NWS_TIMEOUT_MS,
+        headers: { "User-Agent": NWS_USER_AGENT, Accept: "application/geo+json" },
+    }));
+    if (body.type !== "FeatureCollection" || !Array.isArray(body.features)) {
+        throw driftError(NWS_LABEL, "NWS active-alerts body is not a GeoJSON FeatureCollection with a features[] array — schema drift, never a fake-empty result.");
+    }
+    return body.features.map(mapAlert);
+}
+// ─── Tool: nws_active_alerts ──────────────────────────────────────
+/**
+ * List CURRENTLY-ACTIVE NWS weather alerts, optionally scoped by `state` (server-side
+ * ?area=) and filtered client-side by `event` (substring) and/or `severity` (exact).
+ * Honest `_meta` (exact match total + real-time freshness; a no-alerts result is an
+ * honest empty).
+ */
+export async function activeAlerts(args) {
+    if (args.state !== undefined && !STATE_RE.test(args.state)) {
+        throw new ToolErrorCarrier({
+            kind: "invalid_input",
+            retryable: false,
+            message: `Invalid state ${JSON.stringify(args.state)} — expected a 2-letter US state/territory code (^[A-Za-z]{2}$), e.g. "CA".`,
+            upstreamEndpoint: NWS_LABEL,
+        });
+    }
+    const limit = args.limit ?? 50;
+    const offset = args.offset ?? 0;
+    const all = await loadActiveAlerts(args.state);
+    const filtersApplied = [];
+    if (args.state !== undefined)
+        filtersApplied.push("state");
+    const eventQ = args.event?.trim().toLowerCase();
+    const sevQ = args.severity?.trim().toLowerCase();
+    if (args.event !== undefined)
+        filtersApplied.push("event");
+    if (args.severity !== undefined)
+        filtersApplied.push("severity");
+    const matched = all.filter((a) => {
+        if (eventQ && !(a.event ?? "").toLowerCase().includes(eventQ))
+            return false;
+        if (sevQ && (a.severity ?? "").toLowerCase() !== sevQ)
+            return false;
+        return true;
+    });
+    const totalAvailable = matched.length;
+    const page = matched.slice(offset, offset + limit);
+    const returned = page.length;
+    const hasMore = offset + returned < totalAvailable;
+    const nextOffset = hasMore ? offset + returned : null;
+    return withMeta({ alerts: page }, {
+        source: "api.weather.gov active alerts (NWS, keyless)",
+        keylessMode: true,
+        returned,
+        totalAvailable,
+        truncated: hasMore,
+        filtersApplied,
+        filtersDropped: [],
+        fieldsUnavailable: [],
+        pagination: { offset, limit, hasMore, nextOffset },
+        notes: [PROVENANCE_NOTE, FRESHNESS_NOTE],
+    });
+}
+//# sourceMappingURL=nws-weather.js.map

package/dist/nws-weather.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nws-weather.js","sourceRoot":"","sources":["../src/nws-weather.ts"],"names":[],"mappings":"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"}

package/dist/openfda-drugsfda.d.ts

@@ -0,0 +1,72 @@
+/**
+ * openfda-drugsfda.ts — openFDA DRUG APPROVALS (Drugs@FDA, api.fda.gov) — the
+ * PHARMA REGULATORY-APPROVAL lane. FDA-approved drug applications (NDA/ANDA/BLA):
+ * the sponsor, the application number, each approved product (brand/generic name,
+ * dosage form, route, marketing status), and the submission/approval history.
+ * Answers "what drugs did sponsor X get approved, and which are still marketed" —
+ * pharma vendor product/approval intelligence.
+ *
+ * ★ SAME SOURCE + ENVELOPE + CRUX as openfda.ts / openfda-device.ts (ADR-0054/0056).
+ *   Same host (api.fda.gov), same envelope `{ meta:{ results:{ skip,limit,total }},
+ *   results:[…] }`, same ★no-match→HTTP-404-NOT_FOUND-as-honest-empty crux, same
+ *   optional query-key K-test, same fixed-host SSRF idiom, same structured-only (no
+ *   raw Lucene passthrough) search. REUSES openfda.ts's `fetchOpenfda`,
+ *   `readOpenfdaError`, `luceneQuote`, `openfdaApiKey`, `OPENFDA_HOST` verbatim.
+ *
+ *   GET https://api.fda.gov/drug/drugsfda.json?search=<lucene>&limit=&skip=[&api_key=]
+ *   → { meta:{ results:{ skip,limit,total }}, results:[ { application_number,
+ *       sponsor_name, products:[…], submissions:[…] } ] }.
+ *
+ * ★ HONESTY (mirrors the siblings exactly): [P1] totalAvailable = meta.results.total
+ *   EXACT (never results.length); skip/limit offset pagination. [★P2] 404 NOT_FOUND
+ *   ⇒ honest empty (never thrown); other 4xx ⇒ invalid_input surfacing openFDA's
+ *   message; 5xx/429 ⇒ THROW. [P3] every scalar via `str` (null-never-""); nested
+ *   products/submissions arrays default to [] and each field is str (never fabricated).
+ *   [P4] meta.results / results absent-or-mis-shaped ⇒ driftError. [K-test] the
+ *   OPTIONAL OPENFDA_API_KEY rides ONLY &api_key=; label/source name mode only.
+ *   [SSRF] fixed host; all VALUES Lucene-escaped + phrase-quoted via URLSearchParams.
+ */
+import { type MetaBundle } from "./meta.js";
+export type DrugsfdaProduct = {
+    brandName: string | null;
+    genericIngredients: {
+        name: string | null;
+        strength: string | null;
+    }[];
+    dosageForm: string | null;
+    route: string | null;
+    marketingStatus: string | null;
+};
+export type DrugsfdaSubmission = {
+    submissionType: string | null;
+    submissionNumber: string | null;
+    submissionStatus: string | null;
+    submissionStatusDate: string | null;
+    submissionClass: string | null;
+};
+export type DrugsfdaApplication = {
+    applicationNumber: string | null;
+    sponsorName: string | null;
+    products: DrugsfdaProduct[];
+    submissions: DrugsfdaSubmission[];
+};
+export type DrugsfdaFilters = {
+    sponsorName?: string;
+    brandName?: string;
+    activeIngredient?: string;
+    applicationNumber?: string;
+};
+export declare function buildDrugsfdaSearch(f: DrugsfdaFilters): string;
+export type DrugApprovalsArgs = DrugsfdaFilters & {
+    limit?: number;
+    skip?: number;
+};
+/**
+ * Search openFDA Drugs@FDA drug-approval applications with structured filters →
+ * curated application rows (sponsor, application number, approved products, submission
+ * history) + honest `_meta`. KEYLESS (OPTIONAL OPENFDA_API_KEY only raises the rate
+ * limit). totalAvailable = meta.results.total (EXACT); skip/limit pagination. A
+ * no-match query (openFDA HTTP 404 NOT_FOUND) ⇒ an honest empty, never a throw.
+ */
+export declare function drugApprovals(args: DrugApprovalsArgs): Promise<MetaBundle>;
+//# sourceMappingURL=openfda-drugsfda.d.ts.map

package/dist/openfda-drugsfda.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openfda-drugsfda.d.ts","sourceRoot":"","sources":["../src/openfda-drugsfda.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,OAAO,EAAY,KAAK,UAAU,EAAqB,MAAM,WAAW,CAAC;AA4BzE,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,CAAC;IACvE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC,CAAC;AAsCF,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAW9D;AAGD,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAmHhF"}

package/dist/openfda-drugsfda.js

@@ -0,0 +1,230 @@
+/**
+ * openfda-drugsfda.ts — openFDA DRUG APPROVALS (Drugs@FDA, api.fda.gov) — the
+ * PHARMA REGULATORY-APPROVAL lane. FDA-approved drug applications (NDA/ANDA/BLA):
+ * the sponsor, the application number, each approved product (brand/generic name,
+ * dosage form, route, marketing status), and the submission/approval history.
+ * Answers "what drugs did sponsor X get approved, and which are still marketed" —
+ * pharma vendor product/approval intelligence.
+ *
+ * ★ SAME SOURCE + ENVELOPE + CRUX as openfda.ts / openfda-device.ts (ADR-0054/0056).
+ *   Same host (api.fda.gov), same envelope `{ meta:{ results:{ skip,limit,total }},
+ *   results:[…] }`, same ★no-match→HTTP-404-NOT_FOUND-as-honest-empty crux, same
+ *   optional query-key K-test, same fixed-host SSRF idiom, same structured-only (no
+ *   raw Lucene passthrough) search. REUSES openfda.ts's `fetchOpenfda`,
+ *   `readOpenfdaError`, `luceneQuote`, `openfdaApiKey`, `OPENFDA_HOST` verbatim.
+ *
+ *   GET https://api.fda.gov/drug/drugsfda.json?search=<lucene>&limit=&skip=[&api_key=]
+ *   → { meta:{ results:{ skip,limit,total }}, results:[ { application_number,
+ *       sponsor_name, products:[…], submissions:[…] } ] }.
+ *
+ * ★ HONESTY (mirrors the siblings exactly): [P1] totalAvailable = meta.results.total
+ *   EXACT (never results.length); skip/limit offset pagination. [★P2] 404 NOT_FOUND
+ *   ⇒ honest empty (never thrown); other 4xx ⇒ invalid_input surfacing openFDA's
+ *   message; 5xx/429 ⇒ THROW. [P3] every scalar via `str` (null-never-""); nested
+ *   products/submissions arrays default to [] and each field is str (never fabricated).
+ *   [P4] meta.results / results absent-or-mis-shaped ⇒ driftError. [K-test] the
+ *   OPTIONAL OPENFDA_API_KEY rides ONLY &api_key=; label/source name mode only.
+ *   [SSRF] fixed host; all VALUES Lucene-escaped + phrase-quoted via URLSearchParams.
+ */
+import { ToolErrorCarrier, errorFromResponse } from "./errors.js";
+import { driftError } from "./datasource.js";
+import { str } from "./coerce.js";
+import { withMeta } from "./meta.js";
+import { OPENFDA_HOST, fetchOpenfda, readOpenfdaError, luceneQuote, openfdaApiKey, } from "./openfda.js";
+const DEFAULT_LIMIT = 25;
+const MAX_LIMIT = 100;
+/** host+path-only label (→ ToolError.upstreamEndpoint); NEVER carries the key. */
+const DRUGSFDA_LABEL = "openfda:/drug/drugsfda";
+// ─── Honesty notes ────────────────────────────────────────────────
+const NOT_DETERMINATION_NOTE = "openFDA Drugs@FDA records are FDA-published drug-application data; treat approval/marketing status as of the source's last publication. This is reference data, not a live regulatory determination.";
+const KEYLESS_NOTE = "Keyless: no OPENFDA_API_KEY is set. openFDA allows ~1000 requests/day without a key; a free key raises the rate limit (get one at https://open.fda.gov/apis/authentication/).";
+const KEYED_NOTE = "OPENFDA_API_KEY is set — it rides ONLY the &api_key= query parameter to api.fda.gov (openFDA has no header option), raising the rate limit. Its value is NEVER logged, echoed, or placed in this response.";
+const NO_FILTER_NOTE = "No structured filters were applied — this is an unscoped scan of the WHOLE Drugs@FDA collection. Add sponsorName / brandName / activeIngredient / applicationNumber to scope the result set.";
+const MARKETING_NOTE = "products[].marketingStatus is the FDA marketing category (e.g. 'Prescription', 'Over-the-counter', 'Discontinued', 'None (Tentative Approval)') — a 'Discontinued' product is NOT an approval revocation. submissions[] is the application's action history (ORIG approval + subsequent supplements).";
+/** Map ONE Drugs@FDA result row → the curated shape. Every scalar via `str`. */
+function mapApplication(row) {
+    const r = (row ?? {});
+    const products = Array.isArray(r.products) ? r.products : [];
+    const submissions = Array.isArray(r.submissions) ? r.submissions : [];
+    return {
+        applicationNumber: str(r.application_number),
+        sponsorName: str(r.sponsor_name),
+        products: products.map((p) => {
+            const pr = (p ?? {});
+            const ings = Array.isArray(pr.active_ingredients) ? pr.active_ingredients : [];
+            return {
+                brandName: str(pr.brand_name),
+                genericIngredients: ings.map((a) => {
+                    const ai = (a ?? {});
+                    return { name: str(ai.name), strength: str(ai.strength) };
+                }),
+                dosageForm: str(pr.dosage_form),
+                route: str(pr.route),
+                marketingStatus: str(pr.marketing_status),
+            };
+        }),
+        submissions: submissions.map((s) => {
+            const su = (s ?? {});
+            return {
+                submissionType: str(su.submission_type),
+                submissionNumber: str(su.submission_number),
+                submissionStatus: str(su.submission_status),
+                submissionStatusDate: str(su.submission_status_date),
+                submissionClass: str(su.submission_class_code_description),
+            };
+        }),
+    };
+}
+export function buildDrugsfdaSearch(f) {
+    const clauses = [];
+    if (f.sponsorName !== undefined)
+        clauses.push(`sponsor_name:${luceneQuote(f.sponsorName)}`);
+    if (f.brandName !== undefined)
+        clauses.push(`products.brand_name:${luceneQuote(f.brandName)}`);
+    if (f.activeIngredient !== undefined)
+        clauses.push(`products.active_ingredients.name:${luceneQuote(f.activeIngredient)}`);
+    if (f.applicationNumber !== undefined)
+        clauses.push(`application_number:${luceneQuote(f.applicationNumber)}`);
+    return clauses.join(" AND ");
+}
+/**
+ * Search openFDA Drugs@FDA drug-approval applications with structured filters →
+ * curated application rows (sponsor, application number, approved products, submission
+ * history) + honest `_meta`. KEYLESS (OPTIONAL OPENFDA_API_KEY only raises the rate
+ * limit). totalAvailable = meta.results.total (EXACT); skip/limit pagination. A
+ * no-match query (openFDA HTTP 404 NOT_FOUND) ⇒ an honest empty, never a throw.
+ */
+export async function drugApprovals(args) {
+    const limit = clampLimit(args.limit);
+    const skip = clampSkip(args.skip);
+    const filters = {
+        sponsorName: args.sponsorName,
+        brandName: args.brandName,
+        activeIngredient: args.activeIngredient,
+        applicationNumber: args.applicationNumber,
+    };
+    const search = buildDrugsfdaSearch(filters);
+    const filtersApplied = [];
+    if (args.sponsorName !== undefined)
+        filtersApplied.push("sponsorName");
+    if (args.brandName !== undefined)
+        filtersApplied.push("brandName");
+    if (args.activeIngredient !== undefined)
+        filtersApplied.push("activeIngredient");
+    if (args.applicationNumber !== undefined)
+        filtersApplied.push("applicationNumber");
+    const params = new URLSearchParams();
+    if (search !== "")
+        params.set("search", search);
+    params.set("limit", String(limit));
+    params.set("skip", String(skip));
+    const key = openfdaApiKey();
+    if (key !== undefined)
+        params.set("api_key", key); // OPTIONAL — &api_key= ONLY
+    const url = `https://${OPENFDA_HOST}/drug/drugsfda.json?${params.toString()}`;
+    const res = await fetchOpenfda(url, DRUGSFDA_LABEL);
+    if (res.status === 404) {
+        const { code, message } = await readOpenfdaError(res);
+        if (code === "NOT_FOUND") {
+            return emptyResult(limit, skip, filtersApplied, key !== undefined);
+        }
+        throw new ToolErrorCarrier({
+            ...errorFromResponse(res, DRUGSFDA_LABEL),
+            message: message
+                ? `openFDA returned HTTP 404 at ${DRUGSFDA_LABEL}: ${message}`
+                : `Resource not found at ${DRUGSFDA_LABEL} (HTTP 404).`,
+        });
+    }
+    if (res.status >= 400 && res.status < 500 && res.status !== 429) {
+        const { message } = await readOpenfdaError(res);
+        throw new ToolErrorCarrier({
+            kind: "invalid_input",
+            retryable: false,
+            message: message
+                ? `openFDA rejected the request (HTTP ${res.status}) at ${DRUGSFDA_LABEL}: ${message}`
+                : `Bad request (HTTP ${res.status}) at ${DRUGSFDA_LABEL}.`,
+            upstreamStatus: res.status,
+            upstreamEndpoint: DRUGSFDA_LABEL,
+        });
+    }
+    if (!res.ok) {
+        throw new ToolErrorCarrier(errorFromResponse(res, DRUGSFDA_LABEL));
+    }
+    let body;
+    try {
+        body = await res.json();
+    }
+    catch (e) {
+        if (e instanceof SyntaxError) {
+            throw driftError(DRUGSFDA_LABEL, `openFDA ${DRUGSFDA_LABEL} returned a non-JSON body at HTTP 200 — schema drift (never read as an empty result).`);
+        }
+        throw e;
+    }
+    const b = (body ?? {});
+    const meta = (b.meta ?? {});
+    const metaResults = meta.results;
+    if (metaResults === undefined || metaResults === null || typeof metaResults !== "object") {
+        throw driftError(DRUGSFDA_LABEL, `openFDA ${DRUGSFDA_LABEL} shape drift — meta.results (the skip/limit/total carrier) is missing.`);
+    }
+    if (!Array.isArray(b.results)) {
+        throw driftError(DRUGSFDA_LABEL, `openFDA ${DRUGSFDA_LABEL} shape drift — results must be an array.`);
+    }
+    const applications = b.results.map(mapApplication);
+    const returned = applications.length;
+    const rawTotal = metaResults.total;
+    const totalAvailable = typeof rawTotal === "number" && Number.isFinite(rawTotal) ? rawTotal : null;
+    const hasMore = totalAvailable !== null && skip + returned < totalAvailable;
+    const nextOffset = hasMore ? skip + returned : null;
+    const notes = [NOT_DETERMINATION_NOTE, MARKETING_NOTE, keyNote(key !== undefined)];
+    if (filtersApplied.length === 0)
+        notes.push(NO_FILTER_NOTE);
+    return withMeta({ applications }, {
+        source: `${OPENFDA_HOST} /drug/drugsfda (openFDA Drugs@FDA approvals; ${key !== undefined ? "OPENFDA_API_KEY rate-limit key applied" : "keyless"})`,
+        keylessMode: true,
+        returned,
+        totalAvailable,
+        filtersApplied,
+        filtersDropped: [],
+        fieldsUnavailable: [],
+        pagination: { offset: skip, limit, hasMore, nextOffset },
+        notes,
+    });
+}
+// ─── Small helpers ────────────────────────────────────────────────
+function keyNote(hasKey) {
+    return hasKey ? KEYED_NOTE : KEYLESS_NOTE;
+}
+function emptyResult(limit, skip, filtersApplied, hasKey) {
+    return withMeta({ applications: [] }, {
+        source: `${OPENFDA_HOST} /drug/drugsfda (openFDA Drugs@FDA approvals; ${hasKey ? "OPENFDA_API_KEY rate-limit key applied" : "keyless"})`,
+        keylessMode: true,
+        returned: 0,
+        totalAvailable: 0,
+        filtersApplied,
+        filtersDropped: [],
+        fieldsUnavailable: [],
+        pagination: { offset: skip, limit, hasMore: false, nextOffset: null },
+        notes: [
+            "No Drugs@FDA applications matched this query (openFDA returned HTTP 404 NOT_FOUND — the source's honest no-match). This is an exact empty, not an error.",
+            NOT_DETERMINATION_NOTE,
+            keyNote(hasKey),
+        ],
+    });
+}
+function clampLimit(v) {
+    if (typeof v !== "number" || !Number.isFinite(v))
+        return DEFAULT_LIMIT;
+    const n = Math.floor(v);
+    if (n < 1)
+        return 1;
+    if (n > MAX_LIMIT)
+        return MAX_LIMIT;
+    return n;
+}
+function clampSkip(v) {
+    if (typeof v !== "number" || !Number.isFinite(v))
+        return 0;
+    const n = Math.floor(v);
+    return n < 0 ? 0 : n;
+}
+//# sourceMappingURL=openfda-drugsfda.js.map

package/dist/openfda-drugsfda.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openfda-drugsfda.js","sourceRoot":"","sources":["../src/openfda-drugsfda.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAsC,MAAM,WAAW,CAAC;AACzE,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB,kFAAkF;AAClF,MAAM,cAAc,GAAG,wBAAwB,CAAC;AAEhD,qEAAqE;AACrE,MAAM,sBAAsB,GAC1B,sMAAsM,CAAC;AACzM,MAAM,YAAY,GAChB,+KAA+K,CAAC;AAClL,MAAM,UAAU,GACd,4MAA4M,CAAC;AAC/M,MAAM,cAAc,GAClB,8LAA8L,CAAC;AACjM,MAAM,cAAc,GAClB,uSAAuS,CAAC;AAwB1S,gFAAgF;AAChF,SAAS,cAAc,CAAC,GAAY;IAClC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAA4B,CAAC;IACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,OAAO;QACL,iBAAiB,EAAE,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC;QAC5C,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;QAChC,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3B,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAA4B,CAAC;YAChD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,OAAO;gBACL,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC;gBAC7B,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACjC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAA4B,CAAC;oBAChD,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5D,CAAC,CAAC;gBACF,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC;gBAC/B,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC;gBACpB,eAAe,EAAE,GAAG,CAAC,EAAE,CAAC,gBAAgB,CAAC;aAC1C,CAAC;QACJ,CAAC,CAAC;QACF,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACjC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAA4B,CAAC;YAChD,OAAO;gBACL,cAAc,EAAE,GAAG,CAAC,EAAE,CAAC,eAAe,CAAC;gBACvC,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,iBAAiB,CAAC;gBAC3C,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,iBAAiB,CAAC;gBAC3C,oBAAoB,EAAE,GAAG,CAAC,EAAE,CAAC,sBAAsB,CAAC;gBACpD,eAAe,EAAE,GAAG,CAAC,EAAE,CAAC,iCAAiC,CAAC;aAC3D,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC;AAUD,MAAM,UAAU,mBAAmB,CAAC,CAAkB;IACpD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS;QAC7B,OAAO,CAAC,IAAI,CAAC,gBAAgB,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC7D,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;QAC3B,OAAO,CAAC,IAAI,CAAC,uBAAuB,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAClE,IAAI,CAAC,CAAC,gBAAgB,KAAK,SAAS;QAClC,OAAO,CAAC,IAAI,CAAC,oCAAoC,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACtF,IAAI,CAAC,CAAC,iBAAiB,KAAK,SAAS;QACnC,OAAO,CAAC,IAAI,CAAC,sBAAsB,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;IACzE,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAQD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAuB;IACzD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAElC,MAAM,OAAO,GAAoB;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;KAC1C,CAAC;IACF,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACvE,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnE,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS;QAAE,cAAc,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACjF,IAAI,IAAI,CAAC,iBAAiB,KAAK,SAAS;QAAE,cAAc,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAEnF,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,IAAI,MAAM,KAAK,EAAE;QAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,4BAA4B;IAE/E,MAAM,GAAG,GAAG,WAAW,YAAY,uBAAuB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;IAE9E,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAEpD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACvB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YACzB,OAAO,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,IAAI,gBAAgB,CAAC;YACzB,GAAG,iBAAiB,CAAC,GAAG,EAAE,cAAc,CAAC;YACzC,OAAO,EAAE,OAAO;gBACd,CAAC,CAAC,gCAAgC,cAAc,KAAK,OAAO,EAAE;gBAC9D,CAAC,CAAC,yBAAyB,cAAc,cAAc;SAC1D,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAChE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,IAAI,gBAAgB,CAAC;YACzB,IAAI,EAAE,eAAe;YACrB,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,OAAO;gBACd,CAAC,CAAC,sCAAsC,GAAG,CAAC,MAAM,QAAQ,cAAc,KAAK,OAAO,EAAE;gBACtF,CAAC,CAAC,qBAAqB,GAAG,CAAC,MAAM,QAAQ,cAAc,GAAG;YAC5D,cAAc,EAAE,GAAG,CAAC,MAAM;YAC1B,gBAAgB,EAAE,cAAc;SACjC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,WAAW,EAAE,CAAC;YAC7B,MAAM,UAAU,CACd,cAAc,EACd,WAAW,cAAc,uFAAuF,CACjH,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAA0C,CAAC;IAChE,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAA0B,CAAC;IACrD,MAAM,WAAW,GAAG,IAAI,CAAC,OAA0C,CAAC;IACpE,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,IAAI,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACzF,MAAM,UAAU,CACd,cAAc,EACd,WAAW,cAAc,wEAAwE,CAClG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,UAAU,CACd,cAAc,EACd,WAAW,cAAc,0CAA0C,CACpE,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAI,CAAC,CAAC,OAAqB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC;IAErC,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC;IACnC,MAAM,cAAc,GAClB,OAAO,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9E,MAAM,OAAO,GAAG,cAAc,KAAK,IAAI,IAAI,IAAI,GAAG,QAAQ,GAAG,cAAc,CAAC;IAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAEpD,MAAM,KAAK,GAAa,CAAC,sBAAsB,EAAE,cAAc,EAAE,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC;IAC7F,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAE5D,OAAO,QAAQ,CACb,EAAE,YAAY,EAAE,EAChB;QACE,MAAM,EAAE,GAAG,YAAY,iDACrB,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC,SACjE,GAAG;QACH,WAAW,EAAE,IAAI;QACjB,QAAQ;QACR,cAAc;QACd,cAAc;QACd,cAAc,EAAE,EAAE;QAClB,iBAAiB,EAAE,EAAE;QACrB,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE;QACxD,KAAK;KAC0B,CAClC,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,SAAS,OAAO,CAAC,MAAe;IAC9B,OAAO,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC;AAC5C,CAAC;AAED,SAAS,WAAW,CAClB,KAAa,EACb,IAAY,EACZ,cAAwB,EACxB,MAAe;IAEf,OAAO,QAAQ,CACb,EAAE,YAAY,EAAE,EAA2B,EAAE,EAC7C;QACE,MAAM,EAAE,GAAG,YAAY,iDACrB,MAAM,CAAC,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC,SACtD,GAAG;QACH,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,CAAC;QACX,cAAc,EAAE,CAAC;QACjB,cAAc;QACd,cAAc,EAAE,EAAE;QAClB,iBAAiB,EAAE,EAAE;QACrB,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;QACrE,KAAK,EAAE;YACL,0JAA0J;YAC1J,sBAAsB;YACtB,OAAO,CAAC,MAAM,CAAC;SAChB;KAC8B,CAClC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,CAAU;IAC5B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,aAAa,CAAC;IACvE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACpB,IAAI,CAAC,GAAG,SAAS;QAAE,OAAO,SAAS,CAAC;IACpC,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,SAAS,CAAC,CAAU;IAC3B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3D,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC"}

package/dist/openfda.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openfda.d.ts","sourceRoot":"","sources":["../src/openfda.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAKH,OAAO,EAAY,KAAK,UAAU,EAAqB,MAAM,WAAW,CAAC;AAGzE,eAAO,MAAM,YAAY,gBAAgB,CAAC;AAG1C,eAAO,MAAM,kBAAkB,qCAAsC,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIlE,eAAO,MAAM,uBAAuB,+CAAgD,CAAC;AA2BrF,wFAAwF;AACxF,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAIlD;AAGD,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC,CAAC;AAqBF;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,iEAAiE;AACjE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAarD;AAGD;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyChF;AAED,+FAA+F;AAC/F,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAY1D;AAGD,MAAM,MAAM,sBAAsB,GAAG,cAAc,GAAG;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,UAAU,CAAC,CA8KrB"}
+{"version":3,"file":"openfda.d.ts","sourceRoot":"","sources":["../src/openfda.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAKH,OAAO,EAAY,KAAK,UAAU,EAAqB,MAAM,WAAW,CAAC;AAGzE,eAAO,MAAM,YAAY,gBAAgB,CAAC;AAG1C,eAAO,MAAM,kBAAkB,qCAAsC,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIlE,eAAO,MAAM,uBAAuB,+CAAgD,CAAC;AAmCrF,wFAAwF;AACxF,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAIlD;AAGD,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC,CAAC;AAqBF;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,iEAAiE;AACjE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAarD;AAGD;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyChF;AAED,+FAA+F;AAC/F,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAY1D;AAGD,MAAM,MAAM,sBAAsB,GAAG,cAAc,GAAG;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,UAAU,CAAC,CAuLrB"}

package/dist/openfda.js

@@ -81,6 +81,13 @@ const NOT_DETERMINATION_NOTE = "openFDA recall/enforcement records are FDA-publi
 const KEYLESS_NOTE = "Keyless: no OPENFDA_API_KEY is set. openFDA allows ~1000 requests/day without a key; a free key raises the rate limit (get one at https://open.fda.gov/apis/authentication/).";
 const KEYED_NOTE = "OPENFDA_API_KEY is set — it rides ONLY the &api_key= query parameter to api.fda.gov (openFDA has no header option), raising the rate limit. Its value is NEVER logged, echoed, or placed in this response.";
 const NO_FILTER_NOTE = "No structured filters were applied — this is an unscoped scan of the WHOLE recall/enforcement category. Add firm / product / reason / classification / status / state to scope the result set.";
+// dogfooding 2026-07-16: `category` defaults to 'drug'. A DEVICE- or FOOD-intent
+// caller who omits it silently searches the DRUG dataset (a separate openFDA index
+// with its own, much smaller total — e.g. "pacemaker" returns 1 drug recall vs 197
+// device recalls). The default is convenient but load-bearing, so when it is TAKEN
+// (not explicitly chosen) we say so and point to the alternatives. `category` is
+// also echoed in filtersApplied so the drug/device/food choice is never invisible.
+const CATEGORY_DEFAULT_NOTE = "category was NOT specified and DEFAULTED to 'drug' — this searched the DRUG recall dataset (/drug/enforcement) ONLY. For medical DEVICES pass category:'device'; for FOOD pass category:'food'. Each category is a SEPARATE openFDA dataset with its own total, so a device/food-intent query left on the default MISSES all of those recalls.";
 // ─── The OPTIONAL key seam (value NEVER leaked past the &api_key= param) ──
 /** Read OPENFDA_API_KEY from env; trim; return the value or undefined (unset/blank). */
 export function openfdaApiKey() {
@@ -265,6 +272,14 @@ export async function enforcement(args) {
         filtersApplied.push("status");
     if (args.state !== undefined)
         filtersApplied.push("state");
+    // NO_FILTER_NOTE gates on the STRUCTURED filters only — capture that BEFORE the
+    // always-present category selector is appended below.
+    const hasStructuredFilter = filtersApplied.length > 0;
+    // The category (drug|device|food) is the ENDPOINT selector — always applied and
+    // consequential — so echo it in filtersApplied to make the choice VISIBLE (a
+    // device query left on the drug default must not look identical to a device query).
+    const categoryDefaulted = args.category === undefined;
+    filtersApplied.push(`category:${category}`);
     const params = new URLSearchParams();
     if (search !== "")
         params.set("search", search);
@@ -283,7 +298,7 @@ export async function enforcement(args) {
         const { code, message } = await readOpenfdaError(res);
         if (code === "NOT_FOUND") {
             // Honest empty — NOT thrown, NOT not_found (the openFDA no-match idiom).
-            return emptyResult(category, limit, skip, filtersApplied, key !== undefined);
+            return emptyResult(category, limit, skip, filtersApplied, key !== undefined, categoryDefaulted);
         }
         // A non-NOT_FOUND 404 ⇒ the shared not_found taxonomy (never a fake-empty).
         throw new ToolErrorCarrier({
@@ -346,8 +361,10 @@ export async function enforcement(args) {
     const hasMore = totalAvailable !== null && skip + returned < totalAvailable;
     const nextOffset = hasMore ? skip + returned : null;
     const notes = [NOT_DETERMINATION_NOTE, keyNote(key !== undefined)];
-    if (filtersApplied.length === 0)
+    if (!hasStructuredFilter)
         notes.push(NO_FILTER_NOTE);
+    if (categoryDefaulted)
+        notes.push(CATEGORY_DEFAULT_NOTE);
     return withMeta({ recalls }, {
         // MODE only — never the key value (K-test).
         source: `${OPENFDA_HOST} /${category}/enforcement (openFDA recall enforcement; ${key !== undefined ? "OPENFDA_API_KEY rate-limit key applied" : "keyless"})`,
@@ -366,7 +383,17 @@ function keyNote(hasKey) {
     return hasKey ? KEYED_NOTE : KEYLESS_NOTE;
 }
 /** An honest empty result (★P2: a 404 NOT_FOUND no-match) — returned:0, total:0. */
-function emptyResult(category, limit, skip, filtersApplied, hasKey) {
+function emptyResult(category, limit, skip, filtersApplied, hasKey, categoryDefaulted) {
+    const notes = [
+        "No recall/enforcement records matched this query (openFDA returned HTTP 404 NOT_FOUND — the source's honest no-match). This is an exact empty, not an error.",
+        NOT_DETERMINATION_NOTE,
+        keyNote(hasKey),
+    ];
+    // A defaulted category on an EMPTY result is the most misleading case — a device
+    // analyst reads "0 recalls" as "clean" when they actually searched the wrong
+    // dataset. Surface the default + the alternatives.
+    if (categoryDefaulted)
+        notes.push(CATEGORY_DEFAULT_NOTE);
     return withMeta({ recalls: [] }, {
         source: `${OPENFDA_HOST} /${category}/enforcement (openFDA recall enforcement; ${hasKey ? "OPENFDA_API_KEY rate-limit key applied" : "keyless"})`,
         keylessMode: true,
@@ -376,11 +403,7 @@ function emptyResult(category, limit, skip, filtersApplied, hasKey) {
         filtersDropped: [],
         fieldsUnavailable: [],
         pagination: { offset: skip, limit, hasMore: false, nextOffset: null },
-        notes: [
-            "No recall/enforcement records matched this query (openFDA returned HTTP 404 NOT_FOUND — the source's honest no-match). This is an exact empty, not an error.",
-            NOT_DETERMINATION_NOTE,
-            keyNote(hasKey),
-        ],
+        notes,
     });
 }
 function clampLimit(v) {