heor-agent-mcp 1.9.2 → 1.10.1

package/dist/providers/regulatory/ageRangeParser.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Best-effort parser for label population text.
+ *
+ * Extracts { age_min_years, age_max_years, weight_constraint_kg, sex_constraint }
+ * from verbatim label text like:
+ *   "pediatric patients aged 6 to 17 years weighing 45 kg or more"
+ *
+ * All fields are nullable — unparseable text returns all nulls.
+ * The caller always retains the verbatim population text.
+ */
+import type { PopulationParsed } from "./types.js";
+export declare function parseAgeRange(text: string): PopulationParsed;
+//# sourceMappingURL=ageRangeParser.d.ts.map

package/dist/providers/regulatory/ageRangeParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ageRangeParser.d.ts","sourceRoot":"","sources":["../../../src/providers/regulatory/ageRangeParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAqD5D"}

package/dist/providers/regulatory/ageRangeParser.js

@@ -0,0 +1,78 @@
+/**
+ * Best-effort parser for label population text.
+ *
+ * Extracts { age_min_years, age_max_years, weight_constraint_kg, sex_constraint }
+ * from verbatim label text like:
+ *   "pediatric patients aged 6 to 17 years weighing 45 kg or more"
+ *
+ * All fields are nullable — unparseable text returns all nulls.
+ * The caller always retains the verbatim population text.
+ */
+export function parseAgeRange(text) {
+    const result = {
+        age_min_years: null,
+        age_max_years: null,
+        weight_constraint_kg: null,
+        sex_constraint: null,
+    };
+    if (!text || typeof text !== "string")
+        return result;
+    const lower = text.toLowerCase();
+    // Sex constraint detection
+    if (/\b(females?|women|woman|premenopausal|postmenopausal)\b/.test(lower)) {
+        result.sex_constraint = "female_only";
+    }
+    else if (/\b(males?|men|man)\b/.test(lower)) {
+        result.sex_constraint = "male_only";
+    }
+    // Age range: "aged X to Y years" or "X to Y years"
+    const rangeMatch = text.match(/(?:aged?\s+)?(\d+)\s+to\s+(\d+)\s+years?/i);
+    if (rangeMatch) {
+        result.age_min_years = parseInt(rangeMatch[1], 10);
+        result.age_max_years = parseInt(rangeMatch[2], 10);
+        return _extractWeight(result, text);
+    }
+    // Minimum age patterns:
+    // "18 years of age or older"
+    // "6 years of age and older"
+    // "≥12 years" or ">= 12 years"
+    // "at least 12 years"
+    // "12 years and older"
+    const minAgePatterns = [
+        /(?:aged?\s+)?(\d+)\s+years?\s+(?:of\s+age\s+)?(?:and|or)\s+older/i,
+        /(?:aged?\s+)?(\d+)\s+years?\s+(?:of\s+age\s+)?(?:and|or)\s+above/i,
+        /(?:at\s+least\s+)?[≥>=]+\s*(\d+)\s+years?/i,
+        /patients?\s+(\d+)\s+years?\s+of\s+age\s+or\s+older/i,
+        /(?:adults?\s+)?\((\d+)\s+years?\s+and\s+older\)/i,
+        /(?:at\s+least\s+)(\d+)\s+years?\s+of\s+age/i,
+        /(?:aged?\s+)(\d+)\s+years?\s+(?:and\s+)?(?:and\s+)?older/i,
+        /\b(\d+)\s+years?\s+of\s+age\s+(?:and|or)\s+older/i,
+    ];
+    for (const pattern of minAgePatterns) {
+        const m = text.match(pattern);
+        if (m) {
+            result.age_min_years = parseInt(m[1], 10);
+            return _extractWeight(result, text);
+        }
+    }
+    return _extractWeight(result, text);
+}
+function _extractWeight(result, text) {
+    // Weight patterns: "weighing 45 kg or more", "at least 30 kg body weight",
+    //   "body weight ≥ 45 kg"
+    const weightPatterns = [
+        /weighing\s+(\d+(?:\.\d+)?)\s*kg/i,
+        /at\s+least\s+(\d+(?:\.\d+)?)\s*kg/i,
+        /[≥>=]+\s*(\d+(?:\.\d+)?)\s*kg/i,
+        /(\d+(?:\.\d+)?)\s*kg\s+or\s+(?:more|greater)/i,
+    ];
+    for (const pattern of weightPatterns) {
+        const m = text.match(pattern);
+        if (m) {
+            result.weight_constraint_kg = parseFloat(m[1]);
+            break;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=ageRangeParser.js.map

package/dist/providers/regulatory/ageRangeParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ageRangeParser.js","sourceRoot":"","sources":["../../../src/providers/regulatory/ageRangeParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,MAAM,GAAqB;QAC/B,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,IAAI;QACnB,oBAAoB,EAAE,IAAI;QAC1B,cAAc,EAAE,IAAI;KACrB,CAAC;IAEF,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAErD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAEjC,2BAA2B;IAC3B,IAAI,yDAAyD,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1E,MAAM,CAAC,cAAc,GAAG,aAAa,CAAC;IACxC,CAAC;SAAM,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,cAAc,GAAG,WAAW,CAAC;IACtC,CAAC;IAED,mDAAmD;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC3E,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,CAAC,aAAa,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,aAAa,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnD,OAAO,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,wBAAwB;IACxB,6BAA6B;IAC7B,6BAA6B;IAC7B,+BAA+B;IAC/B,sBAAsB;IACtB,uBAAuB;IACvB,MAAM,cAAc,GAAG;QACrB,mEAAmE;QACnE,mEAAmE;QACnE,4CAA4C;QAC5C,qDAAqD;QACrD,kDAAkD;QAClD,6CAA6C;QAC7C,2DAA2D;QAC3D,mDAAmD;KACpD,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,CAAC;YACN,MAAM,CAAC,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1C,OAAO,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,cAAc,CACrB,MAAwB,EACxB,IAAY;IAEZ,2EAA2E;IAC3E,0BAA0B;IAC1B,MAAM,cAAc,GAAG;QACrB,kCAAkC;QAClC,oCAAoC;QACpC,gCAAgC;QAChC,+CAA+C;KAChD,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,CAAC;YACN,MAAM,CAAC,oBAAoB,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/C,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/providers/regulatory/autoCheck.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Fan-out helper for auto-wiring regulatory.status_check into other tools.
+ *
+ * Design log #26. Used by evidence.unmet_need and hta_workflow Phase 3.6.
+ *
+ * Concurrency: up to 8 parallel calls (OpenFDA rate-limit guard).
+ * Cache: uses the shared 24h module-level cache inside regulatoryStatusCheck.ts.
+ * Never throws: each call is wrapped — one failure never aborts the batch.
+ *
+ * CRITICAL CYCLE-SAFETY: This module MUST NOT import from
+ * tools/evidenceUnmetNeed.ts or tools/htaWorkflow.ts (would create a cycle).
+ * Only imports from tools/regulatoryStatusCheck.ts (which owns no upstream deps).
+ */
+import type { RegulatoryStatusResult } from "./types.js";
+export interface AutoCheckRequest {
+    drug: string;
+    region: "us" | "eu" | "uk" | "global";
+    indication?: string;
+}
+export interface AutoCheckResult {
+    drug: string;
+    region: string;
+    result: RegulatoryStatusResult;
+}
+/**
+ * Fan-out helper for auto-wiring regulatory.status_check into other tools.
+ * Concurrency 8 to avoid OpenFDA rate-limit. Cache hits are free.
+ * Never throws — wraps each call so one failure doesn't kill the batch.
+ */
+export declare function autoCheckRegulatory(requests: AutoCheckRequest[]): Promise<AutoCheckResult[]>;
+//# sourceMappingURL=autoCheck.d.ts.map

package/dist/providers/regulatory/autoCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoCheck.d.ts","sourceRoot":"","sources":["../../../src/providers/regulatory/autoCheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAIzD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,QAAQ,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAwCD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,OAAO,CAAC,eAAe,EAAE,CAAC,CA6C5B"}

package/dist/providers/regulatory/autoCheck.js

@@ -0,0 +1,93 @@
+/**
+ * Fan-out helper for auto-wiring regulatory.status_check into other tools.
+ *
+ * Design log #26. Used by evidence.unmet_need and hta_workflow Phase 3.6.
+ *
+ * Concurrency: up to 8 parallel calls (OpenFDA rate-limit guard).
+ * Cache: uses the shared 24h module-level cache inside regulatoryStatusCheck.ts.
+ * Never throws: each call is wrapped — one failure never aborts the batch.
+ *
+ * CRITICAL CYCLE-SAFETY: This module MUST NOT import from
+ * tools/evidenceUnmetNeed.ts or tools/htaWorkflow.ts (would create a cycle).
+ * Only imports from tools/regulatoryStatusCheck.ts (which owns no upstream deps).
+ */
+import { handleRegulatoryStatusCheck } from "../../tools/regulatoryStatusCheck.js";
+// ── Constants ──────────────────────────────────────────────────────────────
+const MAX_AUTO_REGULATORY_CALLS_PER_REQUEST = 8;
+const CONCURRENCY_LIMIT = 8;
+// ── Helper: build a graceful api_error result on exception ────────────────
+function makeErrorResult(drug, region, message) {
+    return {
+        schema_version: "1.0",
+        drug,
+        drug_normalised_inn: drug.toLowerCase(),
+        drug_brand_names: [],
+        region,
+        current_status: "api_error",
+        approved_indications: [],
+        black_box_warnings: [],
+        rems_required: false,
+        contraindications: [],
+        recent_label_changes: {
+            count_12_months: 0,
+            last_revision_date: null,
+            last_revision_summary: null,
+        },
+        source_urls: [],
+        data_fetched_at: new Date().toISOString(),
+        data_age_hours: 0,
+        cache_hit: false,
+        api_error: {
+            source: "autoCheck",
+            message,
+            retry_after_seconds: 60,
+        },
+    };
+}
+// ── Fan-out with concurrency limit ─────────────────────────────────────────
+/**
+ * Fan-out helper for auto-wiring regulatory.status_check into other tools.
+ * Concurrency 8 to avoid OpenFDA rate-limit. Cache hits are free.
+ * Never throws — wraps each call so one failure doesn't kill the batch.
+ */
+export async function autoCheckRegulatory(requests) {
+    if (requests.length === 0)
+        return [];
+    // Cap at MAX to prevent fan-out explosion
+    const capped = requests.slice(0, MAX_AUTO_REGULATORY_CALLS_PER_REQUEST);
+    // Process in batches of CONCURRENCY_LIMIT
+    const results = [];
+    for (let i = 0; i < capped.length; i += CONCURRENCY_LIMIT) {
+        const batch = capped.slice(i, i + CONCURRENCY_LIMIT);
+        const batchResults = await Promise.all(batch.map(async (req) => {
+            try {
+                const toolResult = await handleRegulatoryStatusCheck({
+                    drug: req.drug,
+                    region: req.region,
+                    indication: req.indication,
+                });
+                // handleRegulatoryStatusCheck returns { content: string, audit }
+                const parsed = JSON.parse(typeof toolResult.content === "string"
+                    ? toolResult.content
+                    : JSON.stringify(toolResult.content));
+                return {
+                    drug: req.drug,
+                    region: req.region,
+                    result: parsed,
+                };
+            }
+            catch (e) {
+                // Never throw — return graceful api_error
+                const message = e instanceof Error ? e.message : String(e);
+                return {
+                    drug: req.drug,
+                    region: req.region,
+                    result: makeErrorResult(req.drug, req.region, message),
+                };
+            }
+        }));
+        results.push(...batchResults);
+    }
+    return results;
+}
+//# sourceMappingURL=autoCheck.js.map

package/dist/providers/regulatory/autoCheck.js.map

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

package/dist/providers/regulatory/cache.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 24h in-memory TTL cache for regulatory.status_check results.
+ *
+ * Design contract:
+ * - get() returns null on miss (expired or never set)
+ * - get() returns { value, cache_hit: true, data_age_hours } on hit
+ * - set() stores value with current timestamp
+ * - delete() removes key (used for force_refresh)
+ * - TTL configurable; default 24h
+ */
+interface CacheHit<T> {
+    value: T;
+    cache_hit: true;
+    data_age_hours: number;
+}
+export declare class RegulatoryCache<T = unknown> {
+    private readonly store;
+    private readonly ttlMs;
+    constructor(options?: {
+        ttlMs?: number;
+    });
+    /**
+     * Returns null on cache miss (expired or never set).
+     * Returns { value, cache_hit: true, data_age_hours } on hit.
+     */
+    get(key: string): CacheHit<T> | null;
+    /**
+     * Stores value with current timestamp.
+     */
+    set(key: string, value: T): void;
+    /**
+     * Removes key from cache (used by force_refresh logic).
+     */
+    delete(key: string): void;
+}
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/providers/regulatory/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/providers/regulatory/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,UAAU,QAAQ,CAAC,CAAC;IAClB,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAKxC;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAkBpC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAIhC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAG1B"}

package/dist/providers/regulatory/cache.js

@@ -0,0 +1,51 @@
+/**
+ * 24h in-memory TTL cache for regulatory.status_check results.
+ *
+ * Design contract:
+ * - get() returns null on miss (expired or never set)
+ * - get() returns { value, cache_hit: true, data_age_hours } on hit
+ * - set() stores value with current timestamp
+ * - delete() removes key (used for force_refresh)
+ * - TTL configurable; default 24h
+ */
+export class RegulatoryCache {
+    store = new Map();
+    ttlMs;
+    constructor(options) {
+        // Default 24h TTL
+        this.ttlMs = options?.ttlMs ?? 24 * 60 * 60 * 1000;
+    }
+    /**
+     * Returns null on cache miss (expired or never set).
+     * Returns { value, cache_hit: true, data_age_hours } on hit.
+     */
+    get(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return null;
+        const ageMs = Date.now() - entry.storedAt;
+        if (ageMs > this.ttlMs) {
+            // Expired — remove and return null
+            this.store.delete(key);
+            return null;
+        }
+        return {
+            value: entry.value,
+            cache_hit: true,
+            data_age_hours: ageMs / (1000 * 60 * 60),
+        };
+    }
+    /**
+     * Stores value with current timestamp.
+     */
+    set(key, value) {
+        this.store.set(key, { value, storedAt: Date.now() });
+    }
+    /**
+     * Removes key from cache (used by force_refresh logic).
+     */
+    delete(key) {
+        this.store.delete(key);
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/providers/regulatory/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/providers/regulatory/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,MAAM,OAAO,eAAe;IACT,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IACzC,KAAK,CAAS;IAE/B,YAAY,OAA4B;QACtC,kBAAkB;QAClB,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC1C,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACvB,mCAAmC;YACnC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,IAAI;YACf,cAAc,EAAE,KAAK,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC;SACzC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW,EAAE,KAAQ;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/providers/regulatory/dailymed.d.ts

@@ -0,0 +1,34 @@
+/**
+ * DailyMed v2 client — CROSS-CHECK / FALLBACK for US regulatory status.
+ *
+ * Phase 0 verified 2026-05-07:
+ *   Search: GET https://dailymed.nlm.nih.gov/dailymed/services/v2/spls.json?drug_name={X}
+ *   Returns: { data: [{spl_version, published_date, title, setid}], metadata }
+ *
+ * Used in v1 only to cross-check OpenFDA result freshness (compare
+ * published_date against OpenFDA's effective_time). Does NOT replace
+ * OpenFDA as the primary source.
+ *
+ * Design log #25.
+ */
+export interface DailyMedEntry {
+    setid: string;
+    spl_version: number;
+    published_date: string;
+    title: string;
+}
+/**
+ * Build the DailyMed search URL.
+ */
+export declare function buildDailyMedSearchUrl(drugName: string): string;
+/**
+ * Parse DailyMed search response into structured entries.
+ */
+export declare function parseDailyMedSearchResponse(response: unknown): DailyMedEntry[];
+/**
+ * Fetch DailyMed cross-check for a drug name.
+ * Returns null on any error (404, network failure, etc.) — DailyMed is
+ * non-critical; OpenFDA is the primary source.
+ */
+export declare function fetchDailyMedCrossCheck(drugName: string): Promise<DailyMedEntry[] | null>;
+//# sourceMappingURL=dailymed.d.ts.map

package/dist/providers/regulatory/dailymed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dailymed.d.ts","sourceRoot":"","sources":["../../../src/providers/regulatory/dailymed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAgBD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,OAAO,GAChB,aAAa,EAAE,CAYjB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,CAcjC"}

package/dist/providers/regulatory/dailymed.js

@@ -0,0 +1,60 @@
+/**
+ * DailyMed v2 client — CROSS-CHECK / FALLBACK for US regulatory status.
+ *
+ * Phase 0 verified 2026-05-07:
+ *   Search: GET https://dailymed.nlm.nih.gov/dailymed/services/v2/spls.json?drug_name={X}
+ *   Returns: { data: [{spl_version, published_date, title, setid}], metadata }
+ *
+ * Used in v1 only to cross-check OpenFDA result freshness (compare
+ * published_date against OpenFDA's effective_time). Does NOT replace
+ * OpenFDA as the primary source.
+ *
+ * Design log #25.
+ */
+const BASE_URL = "https://dailymed.nlm.nih.gov/dailymed/services/v2";
+/**
+ * Build the DailyMed search URL.
+ */
+export function buildDailyMedSearchUrl(drugName) {
+    const encoded = encodeURIComponent(drugName);
+    return `${BASE_URL}/spls.json?drug_name=${encoded}`;
+}
+/**
+ * Parse DailyMed search response into structured entries.
+ */
+export function parseDailyMedSearchResponse(response) {
+    if (!response || typeof response !== "object")
+        return [];
+    const resp = response;
+    const data = resp.data;
+    if (!Array.isArray(data))
+        return [];
+    return data.map((entry) => ({
+        setid: entry.setid ?? "",
+        spl_version: entry.spl_version ?? 0,
+        published_date: entry.published_date ?? "",
+        title: entry.title ?? "",
+    }));
+}
+/**
+ * Fetch DailyMed cross-check for a drug name.
+ * Returns null on any error (404, network failure, etc.) — DailyMed is
+ * non-critical; OpenFDA is the primary source.
+ */
+export async function fetchDailyMedCrossCheck(drugName) {
+    try {
+        const url = buildDailyMedSearchUrl(drugName);
+        const res = await fetch(url, { signal: AbortSignal.timeout(15_000) });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        const entries = parseDailyMedSearchResponse(data);
+        if (entries.length === 0)
+            return null;
+        return entries;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=dailymed.js.map

package/dist/providers/regulatory/dailymed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dailymed.js","sourceRoot":"","sources":["../../../src/providers/regulatory/dailymed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,QAAQ,GAAG,mDAAmD,CAAC;AAuBrE;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC7C,OAAO,GAAG,QAAQ,wBAAwB,OAAO,EAAE,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzD,MAAM,IAAI,GAAG,QAAkC,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;QACxB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,CAAC;QACnC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,EAAE;QAC1C,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;KACzB,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAY,CAAC;QAC3C,MAAM,OAAO,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEtC,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/providers/regulatory/drugNameNormaliser.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Drug name normaliser — INN / brand / biosimilar-suffix → canonical INN.
+ *
+ * Design log #25. Covers ~70 most-common HEOR-relevant molecules.
+ * Returns did_you_mean[] (Levenshtein-based top-3) when no match.
+ *
+ * Biosimilar suffix stripping: FDA 4-letter suffixes (e.g., -vfrm, -aooe, -adaz)
+ * are stripped to recover the INN stem.
+ */
+interface NormaliseResult {
+    inn: string | null;
+    did_you_mean?: string[];
+}
+/**
+ * Normalises a drug name to canonical INN.
+ *
+ * Lookup priority:
+ * 1. INN exact match (case-insensitive)
+ * 2. Brand name exact match
+ * 3. Strip biosimilar suffix → INN match
+ * 4. Not found → null + did_you_mean
+ */
+export declare function normaliseDrugName(drug: string): NormaliseResult;
+/**
+ * Returns all known brand names for a given INN.
+ */
+export declare function getBrandNames(inn: string): string[];
+export {};
+//# sourceMappingURL=drugNameNormaliser.d.ts.map

package/dist/providers/regulatory/drugNameNormaliser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drugNameNormaliser.d.ts","sourceRoot":"","sources":["../../../src/providers/regulatory/drugNameNormaliser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,UAAU,eAAe;IACvB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAuID;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAoC/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAKnD"}

package/dist/providers/regulatory/drugNameNormaliser.js

@@ -0,0 +1,186 @@
+/**
+ * Drug name normaliser — INN / brand / biosimilar-suffix → canonical INN.
+ *
+ * Design log #25. Covers ~70 most-common HEOR-relevant molecules.
+ * Returns did_you_mean[] (Levenshtein-based top-3) when no match.
+ *
+ * Biosimilar suffix stripping: FDA 4-letter suffixes (e.g., -vfrm, -aooe, -adaz)
+ * are stripped to recover the INN stem.
+ */
+// INN → [brand names] mapping (case-insensitive on lookup)
+const INN_TO_BRANDS = {
+    // CGRP antibodies
+    fremanezumab: ["ajovy"],
+    erenumab: ["aimovig"],
+    galcanezumab: ["emgality"],
+    eptinezumab: ["vyepti"],
+    // Alzheimer's
+    lecanemab: ["leqembi"],
+    donanemab: ["kisunla"],
+    aducanumab: ["aduhelm"],
+    // Diabetes / obesity
+    semaglutide: ["ozempic", "wegovy", "rybelsus"],
+    tirzepatide: ["mounjaro", "zepbound"],
+    dulaglutide: ["trulicity"],
+    liraglutide: ["victoza", "saxenda"],
+    dapagliflozin: ["farxiga", "forxiga"],
+    empagliflozin: ["jardiance"],
+    canagliflozin: ["invokana"],
+    // Oncology
+    pembrolizumab: ["keytruda"],
+    nivolumab: ["opdivo"],
+    atezolizumab: ["tecentriq"],
+    durvalumab: ["imfinzi"],
+    ipilimumab: ["yervoy"],
+    trastuzumab: ["herceptin"],
+    pertuzumab: ["perjeta"],
+    bevacizumab: ["avastin"],
+    rituximab: ["rituxan", "mabthera"],
+    cetuximab: ["erbitux"],
+    osimertinib: ["tagrisso"],
+    palbociclib: ["ibrance"],
+    ribociclib: ["kisqali"],
+    abemaciclib: ["verzenio"],
+    // Immunology / rheumatology
+    adalimumab: ["humira"],
+    etanercept: ["enbrel"],
+    infliximab: ["remicade"],
+    tocilizumab: ["actemra"],
+    sarilumab: ["kevzara"],
+    baricitinib: ["olumiant"],
+    tofacitinib: ["xeljanz"],
+    upadacitinib: ["rinvoq"],
+    secukinumab: ["cosentyx"],
+    ixekizumab: ["taltz"],
+    bimekizumab: ["bimzelx"],
+    risankizumab: ["skyrizi"],
+    guselkumab: ["tremfya"],
+    dupilumab: ["dupixent"],
+    tralokinumab: ["adbry"],
+    // Cardiology
+    evolocumab: ["repatha"],
+    alirocumab: ["praluent"],
+    inclisiran: ["leqvio"],
+    sacubitril: ["entresto"],
+    // Rare diseases
+    nusinersen: ["spinraza"],
+    risdiplam: ["evrysdi"],
+    onasemnogene: ["zolgensma"],
+    migalastat: ["galafold"],
+    ivacaftor: ["kalydeco"],
+    elexacaftor: ["trikafta"],
+    // Multiple sclerosis
+    natalizumab: ["tysabri"],
+    ocrelizumab: ["ocrevus"],
+    ofatumumab: ["kesimpta"],
+    ozanimod: ["zeposia"],
+    siponimod: ["mayzent"],
+    cladribine: ["mavenclad"],
+    // PV / migraine
+    lasmiditan: ["reyvow"],
+    rimegepant: ["nurtec"],
+    ubrogepant: ["ubrelvy"],
+    atogepant: ["qulipta"],
+    zavegepant: ["zavzpret"],
+};
+// Reverse map: brand → INN (built from INN_TO_BRANDS)
+const BRAND_TO_INN = new Map();
+for (const [inn, brands] of Object.entries(INN_TO_BRANDS)) {
+    for (const brand of brands) {
+        BRAND_TO_INN.set(brand.toLowerCase(), inn);
+    }
+}
+// Full INN list for Levenshtein "did you mean"
+const ALL_INNS = Object.keys(INN_TO_BRANDS);
+/**
+ * Strips FDA 4-letter biosimilar suffix (e.g., "fremanezumab-vfrm" → "fremanezumab").
+ * Returns the stem if the suffix matches /^-[a-z]{4}$/i, else returns the original.
+ */
+function stripBiosimilarSuffix(name) {
+    const match = name.match(/^(.+?)-([a-z]{4})$/i);
+    if (match) {
+        return match[1].toLowerCase();
+    }
+    return name.toLowerCase();
+}
+/**
+ * Levenshtein distance (simple DP implementation).
+ */
+function levenshtein(a, b) {
+    const m = a.length;
+    const n = b.length;
+    const dp = Array.from({ length: m + 1 }, (_, i) => Array.from({ length: n + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            if (a[i - 1] === b[j - 1]) {
+                dp[i][j] = dp[i - 1][j - 1];
+            }
+            else {
+                dp[i][j] = 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+            }
+        }
+    }
+    return dp[m][n];
+}
+/**
+ * Returns the top-3 closest INN names by Levenshtein distance.
+ */
+function findDidYouMean(query) {
+    const lower = query.toLowerCase();
+    return ALL_INNS
+        .map((inn) => ({ inn, dist: levenshtein(lower, inn) }))
+        .sort((a, b) => a.dist - b.dist)
+        .slice(0, 3)
+        .map((x) => x.inn);
+}
+/**
+ * Normalises a drug name to canonical INN.
+ *
+ * Lookup priority:
+ * 1. INN exact match (case-insensitive)
+ * 2. Brand name exact match
+ * 3. Strip biosimilar suffix → INN match
+ * 4. Not found → null + did_you_mean
+ */
+export function normaliseDrugName(drug) {
+    if (!drug || typeof drug !== "string") {
+        return { inn: null, did_you_mean: findDidYouMean("") };
+    }
+    const lower = drug.trim().toLowerCase();
+    if (!lower) {
+        return { inn: null, did_you_mean: findDidYouMean("") };
+    }
+    // 1. Direct INN match
+    if (lower in INN_TO_BRANDS) {
+        return { inn: lower };
+    }
+    // 2. Brand name match
+    const fromBrand = BRAND_TO_INN.get(lower);
+    if (fromBrand) {
+        return { inn: fromBrand };
+    }
+    // 3. Strip biosimilar suffix and retry
+    const stem = stripBiosimilarSuffix(drug);
+    if (stem !== lower) {
+        if (stem in INN_TO_BRANDS) {
+            return { inn: stem };
+        }
+        // Also check if stem is a brand
+        const stemFromBrand = BRAND_TO_INN.get(stem);
+        if (stemFromBrand) {
+            return { inn: stemFromBrand };
+        }
+    }
+    // 4. Not found
+    return { inn: null, did_you_mean: findDidYouMean(lower) };
+}
+/**
+ * Returns all known brand names for a given INN.
+ */
+export function getBrandNames(inn) {
+    const lower = inn.toLowerCase();
+    const brands = INN_TO_BRANDS[lower] ?? [];
+    // Capitalise first letter for display
+    return brands.map((b) => b.charAt(0).toUpperCase() + b.slice(1));
+}
+//# sourceMappingURL=drugNameNormaliser.js.map