heor-agent-mcp 0.1.0

package/dist/providers/direct/proxyClient.d.ts

@@ -0,0 +1,15 @@
+import type { LiteratureResult } from "../types.js";
+/**
+ * Validate that a proxy URL is safe to use (localhost only).
+ * Returns validated URL or null if invalid.
+ * Logs a warning to stderr if an invalid URL was provided.
+ */
+export declare function validateProxyUrl(rawUrl: string | undefined): string | null;
+export declare function getProxyUrl(): string | null;
+/**
+ * Fetch literature results through the local proxy.
+ * Expected proxy endpoint: {PROXY_URL}/{source}?query=X&max=N
+ * Expected proxy response: { results: LiteratureResult[] } OR LiteratureResult[]
+ */
+export declare function fetchViaProxy(source: string, query: string, maxResults: number): Promise<LiteratureResult[]>;
+//# sourceMappingURL=proxyClient.d.ts.map

package/dist/providers/direct/proxyClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxyClient.d.ts","sourceRoot":"","sources":["../../../src/providers/direct/proxyClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAmC1E;AAED,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAE3C;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAiC7B"}

package/dist/providers/direct/proxyClient.js

@@ -0,0 +1,76 @@
+/**
+ * Validate that a proxy URL is safe to use (localhost only).
+ * Returns validated URL or null if invalid.
+ * Logs a warning to stderr if an invalid URL was provided.
+ */
+export function validateProxyUrl(rawUrl) {
+    if (!rawUrl)
+        return null;
+    let parsed;
+    try {
+        parsed = new URL(rawUrl);
+    }
+    catch {
+        console.error(`[HEOR] Invalid HEOR_PROXY_URL (not a valid URL): ${rawUrl}. Proxy disabled.`);
+        return null;
+    }
+    // Must be http (localhost doesn't need https)
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        console.error(`[HEOR] HEOR_PROXY_URL must use http:// or https://, got ${parsed.protocol}. Proxy disabled.`);
+        return null;
+    }
+    // MUST be localhost — reject anything else to prevent query exfiltration
+    const hostname = parsed.hostname.toLowerCase();
+    const allowedHosts = ["localhost", "127.0.0.1", "::1", "[::1]"];
+    if (!allowedHosts.includes(hostname)) {
+        console.error(`[HEOR] SECURITY: HEOR_PROXY_URL must be localhost/127.0.0.1 only. ` +
+            `Got: ${hostname}. Proxy disabled to prevent query exfiltration. ` +
+            `If you need a remote proxy, wrap it with an SSH tunnel to localhost.`);
+        return null;
+    }
+    // Strip trailing slash for consistent URL building
+    return rawUrl.replace(/\/+$/, "");
+}
+export function getProxyUrl() {
+    return validateProxyUrl(process.env.HEOR_PROXY_URL);
+}
+/**
+ * Fetch literature results through the local proxy.
+ * Expected proxy endpoint: {PROXY_URL}/{source}?query=X&max=N
+ * Expected proxy response: { results: LiteratureResult[] } OR LiteratureResult[]
+ */
+export async function fetchViaProxy(source, query, maxResults) {
+    const proxyUrl = getProxyUrl();
+    if (!proxyUrl)
+        return [];
+    try {
+        const url = `${proxyUrl}/${source}?query=${encodeURIComponent(query)}&max=${maxResults}`;
+        const res = await fetch(url, {
+            headers: { Accept: "application/json" },
+            // Short timeout — local proxy should be fast
+            signal: AbortSignal.timeout(30000),
+        });
+        if (!res.ok)
+            return [];
+        const data = (await res.json());
+        // Accept both formats: { results: [...] } or [...]
+        const results = Array.isArray(data)
+            ? data
+            : data.results;
+        if (!Array.isArray(results))
+            return [];
+        // Basic validation of each result
+        return results.filter((r) => {
+            if (typeof r !== "object" || r === null)
+                return false;
+            const obj = r;
+            return (typeof obj.id === "string" &&
+                typeof obj.title === "string" &&
+                typeof obj.source === "string");
+        });
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=proxyClient.js.map

package/dist/providers/direct/proxyClient.js.map

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

package/dist/providers/direct/pssru.d.ts

@@ -0,0 +1,3 @@
+import type { LiteratureResult } from "../types.js";
+export declare function fetchPssru(query: string, maxResults: number): Promise<LiteratureResult[]>;
+//# sourceMappingURL=pssru.d.ts.map

package/dist/providers/direct/pssru.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pssru.d.ts","sourceRoot":"","sources":["../../../src/providers/direct/pssru.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgC/F"}

package/dist/providers/direct/pssru.js

@@ -0,0 +1,33 @@
+// PSSRU Unit Costs: annual publication, no API. Return structured reference links.
+export async function fetchPssru(query, maxResults) {
+    const currentYear = new Date().getFullYear();
+    const latestVolume = currentYear - 1; // published retrospectively
+    const entries = [
+        {
+            title: `PSSRU Unit Costs of Health & Social Care ${latestVolume} — ${query}`,
+            abstract: `The definitive UK reference for HEOR cost inputs. Covers: staff costs (consultant, GP, nurse, allied health), hospital services (inpatient/day-case/outpatient per diem), community and primary care, mental health, social care, hotel costs, and capital costs. For query "${query}", consult the latest volume (typically released November). Used by NICE for cost-per-QALY models. Hourly rates, per-contact costs, and per-episode costs are provided with uncertainty ranges.`,
+            url: "https://www.pssru.ac.uk/unitcostsreport/",
+        },
+        {
+            title: `PSSRU Historic Unit Costs Archive — ${query}`,
+            abstract: `Historic PSSRU volumes (2001-present). Useful for retrospective cost-effectiveness analyses, model validation, and cost inflation calculations. Published annually by University of Kent.`,
+            url: "https://www.pssru.ac.uk/research-archive/",
+        },
+        {
+            title: `NICE Reference Case Cost Inputs — use PSSRU + NHS National Cost Collection`,
+            abstract: `For a NICE STA/MTA submission, unit costs should be sourced from: (1) PSSRU Unit Costs for staff/care time, (2) NHS National Cost Collection (formerly Reference Costs) for healthcare resource groups (HRGs), (3) BNF for drug costs. All inflated to current price year using HCHS pay & prices index.`,
+            url: "https://www.nice.org.uk/process/pmg36/chapter/economic-evaluation",
+        },
+    ];
+    return entries.slice(0, maxResults).map((e, i) => ({
+        id: `pssru_${i}`,
+        source: "pssru",
+        title: e.title,
+        authors: ["Personal Social Services Research Unit (PSSRU), University of Kent"],
+        date: String(latestVolume),
+        study_type: "cost_reference",
+        abstract: e.abstract,
+        url: e.url,
+    }));
+}
+//# sourceMappingURL=pssru.js.map

package/dist/providers/direct/pssru.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pssru.js","sourceRoot":"","sources":["../../../src/providers/direct/pssru.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAa,EAAE,UAAkB;IAChE,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,MAAM,YAAY,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,4BAA4B;IAElE,MAAM,OAAO,GAAG;QACd;YACE,KAAK,EAAE,4CAA4C,YAAY,MAAM,KAAK,EAAE;YAC5E,QAAQ,EAAE,gRAAgR,KAAK,iMAAiM;YAChe,GAAG,EAAE,0CAA0C;SAChD;QACD;YACE,KAAK,EAAE,uCAAuC,KAAK,EAAE;YACrD,QAAQ,EAAE,2LAA2L;YACrM,GAAG,EAAE,2CAA2C;SACjD;QACD;YACE,KAAK,EAAE,4EAA4E;YACnF,QAAQ,EAAE,0SAA0S;YACpT,GAAG,EAAE,mEAAmE;SACzE;KACF,CAAC;IAEF,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACjD,EAAE,EAAE,SAAS,CAAC,EAAE;QAChB,MAAM,EAAE,OAAgB;QACxB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,CAAC,oEAAoE,CAAC;QAC/E,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC;QAC1B,UAAU,EAAE,gBAAgB;QAC5B,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,GAAG,EAAE,CAAC,CAAC,GAAG;KACX,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/providers/direct/pubmed.d.ts

@@ -0,0 +1,3 @@
+import type { LiteratureResult } from "../types.js";
+export declare function fetchPubMed(query: string, maxResults: number): Promise<LiteratureResult[]>;
+//# sourceMappingURL=pubmed.d.ts.map

package/dist/providers/direct/pubmed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pubmed.d.ts","sourceRoot":"","sources":["../../../src/providers/direct/pubmed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA6BpD,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsD7B"}

package/dist/providers/direct/pubmed.js

@@ -0,0 +1,73 @@
+const BASE = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils";
+function parseAbstractsFromXml(xml) {
+    const abstracts = new Map();
+    // Split by <PubmedArticle> to process each article
+    const articles = xml.split(/<PubmedArticle>/);
+    for (const article of articles) {
+        const pmidMatch = article.match(/<PMID[^>]*>(\d+)<\/PMID>/);
+        if (!pmidMatch)
+            continue;
+        const pmid = pmidMatch[1];
+        // Get all AbstractText elements and concatenate them
+        const abstractParts = [];
+        const regex = /<AbstractText[^>]*>([\s\S]*?)<\/AbstractText>/g;
+        let match;
+        while ((match = regex.exec(article)) !== null) {
+            // Strip any nested XML tags
+            const text = match[1].replace(/<[^>]+>/g, "").trim();
+            if (text)
+                abstractParts.push(text);
+        }
+        if (abstractParts.length > 0) {
+            abstracts.set(pmid, abstractParts.join(" "));
+        }
+    }
+    return abstracts;
+}
+export async function fetchPubMed(query, maxResults) {
+    try {
+        const searchUrl = `${BASE}/esearch.fcgi?db=pubmed&term=${encodeURIComponent(query)}&retmax=${maxResults}&retmode=json`;
+        const searchRes = await fetch(searchUrl);
+        if (!searchRes.ok)
+            return [];
+        const searchData = (await searchRes.json());
+        const ids = searchData.esearchresult.idlist;
+        if (ids.length === 0)
+            return [];
+        const summaryUrl = `${BASE}/esummary.fcgi?db=pubmed&id=${ids.join(",")}&retmode=json`;
+        const summaryRes = await fetch(summaryUrl);
+        if (!summaryRes.ok)
+            return [];
+        const summaryData = (await summaryRes.json());
+        // Fetch abstracts via efetch; if it fails, proceed with empty abstracts
+        let abstracts = new Map();
+        try {
+            const efetchUrl = `${BASE}/efetch.fcgi?db=pubmed&id=${ids.join(",")}&rettype=abstract&retmode=xml`;
+            const efetchRes = await fetch(efetchUrl);
+            if (efetchRes.ok) {
+                const efetchXml = await efetchRes.text();
+                abstracts = parseAbstractsFromXml(efetchXml);
+            }
+        }
+        catch {
+            // proceed with empty abstracts
+        }
+        return summaryData.result.uids.map((uid) => {
+            const doc = summaryData.result[uid];
+            return {
+                id: `pubmed_${uid}`,
+                source: "pubmed",
+                title: doc.title ?? "",
+                authors: (doc.authors ?? []).map((a) => a.name),
+                date: doc.pubdate ?? "",
+                study_type: "unknown",
+                abstract: abstracts.get(uid) ?? "",
+                url: `https://pubmed.ncbi.nlm.nih.gov/${uid}/`,
+            };
+        });
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=pubmed.js.map

package/dist/providers/direct/pubmed.js.map

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

package/dist/providers/direct/purpleBook.d.ts

@@ -0,0 +1,3 @@
+import type { LiteratureResult } from "../types.js";
+export declare function fetchPurpleBook(query: string, maxResults: number): Promise<LiteratureResult[]>;
+//# sourceMappingURL=purpleBook.d.ts.map

package/dist/providers/direct/purpleBook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purpleBook.d.ts","sourceRoot":"","sources":["../../../src/providers/direct/purpleBook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAuBpD,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAmCpG"}

package/dist/providers/direct/purpleBook.js

@@ -0,0 +1,52 @@
+// openFDA drug label endpoint with biologics filter
+const BASE = "https://api.fda.gov/drug/label.json";
+export async function fetchPurpleBook(query, maxResults) {
+    try {
+        // Filter for biologics (BLA applications)
+        const searchQuery = `(openfda.application_number:BLA*+AND+(openfda.brand_name:"${query}"+openfda.generic_name:"${query}"))`;
+        const url = `${BASE}?search=${encodeURIComponent(searchQuery)}&limit=${Math.min(maxResults, 100)}`;
+        const res = await fetch(url);
+        if (!res.ok)
+            return getPurpleBookFallback(query, maxResults);
+        const data = (await res.json());
+        if (!data.results || data.results.length === 0)
+            return getPurpleBookFallback(query, maxResults);
+        return data.results.slice(0, maxResults).map((r, i) => {
+            const brand = r.openfda?.brand_name?.[0] ?? "Unknown";
+            const generic = r.openfda?.generic_name?.[0] ?? "";
+            const manuf = r.openfda?.manufacturer_name?.[0] ?? "Unknown";
+            const appNum = r.openfda?.application_number?.[0] ?? "N/A";
+            return {
+                id: `purple_book_${r.id ?? i}`,
+                source: "purple_book",
+                title: `${brand} (${generic}) — ${appNum}`,
+                authors: [manuf],
+                date: r.effective_time ?? "",
+                study_type: "regulatory",
+                abstract: [
+                    `BLA Application: ${appNum}`,
+                    `Manufacturer: ${manuf}`,
+                    `Brand: ${brand} | Generic: ${generic}`,
+                    r.indications_and_usage?.[0] ? `Indications: ${r.indications_and_usage[0].slice(0, 300)}` : null,
+                ].filter(Boolean).join(" | "),
+                url: `https://purplebooksearch.fda.gov/search?query=${encodeURIComponent(brand)}`,
+            };
+        });
+    }
+    catch {
+        return getPurpleBookFallback(query, maxResults);
+    }
+}
+function getPurpleBookFallback(query, maxResults) {
+    return [{
+            id: "purple_book_search",
+            source: "purple_book",
+            title: `FDA Purple Book Search: ${query}`,
+            authors: ["U.S. Food and Drug Administration"],
+            date: new Date().getFullYear().toString(),
+            study_type: "registry",
+            abstract: `Search the FDA Purple Book for licensed biological products including biosimilars and reference products for "${query}". Covers FDA-licensed allergenic, cellular, gene therapy, hematologic, and vaccine products.`,
+            url: `https://purplebooksearch.fda.gov/search?query=${encodeURIComponent(query)}`,
+        }].slice(0, maxResults);
+}
+//# sourceMappingURL=purpleBook.js.map

package/dist/providers/direct/purpleBook.js.map

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

package/dist/providers/direct/tlv.d.ts

@@ -0,0 +1,3 @@
+import type { LiteratureResult } from "../types.js";
+export declare function fetchTlv(query: string, maxResults: number): Promise<LiteratureResult[]>;
+//# sourceMappingURL=tlv.d.ts.map

package/dist/providers/direct/tlv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tlv.d.ts","sourceRoot":"","sources":["../../../src/providers/direct/tlv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA6B7F"}

package/dist/providers/direct/tlv.js

@@ -0,0 +1,30 @@
+export async function fetchTlv(query, maxResults) {
+    const entries = [
+        {
+            title: `TLV Sweden Decisions: ${query}`,
+            abstract: `TLV (Tandvårds- och läkemedelsförmånsverket — Dental and Pharmaceutical Benefits Agency) makes reimbursement decisions for drugs in Sweden's pharmaceutical benefits scheme (LFN). Each decision includes clinical assessment, health economic evaluation, and reimbursement conditions. Search "${query}" to find TLV decisions relevant to the drug or indication. Key for Swedish market access and Nordic HTA benchmarking.`,
+            url: `https://www.tlv.se/in-english/search.html?query=${encodeURIComponent(query)}`,
+        },
+        {
+            title: `TLV General Guidelines for Economic Evaluations`,
+            abstract: `TLV's guidelines for health economic evaluations submitted in support of reimbursement applications. Covers cost-effectiveness analysis, willingness-to-pay threshold (approximately SEK 500K/QALY for severe conditions), QALY methodology, perspective (societal), discount rate (3%), and uncertainty analysis requirements. Required reading for Swedish HTA submissions.`,
+            url: "https://www.tlv.se/in-english/medicines/general-guidelines-for-economic-evaluations.html",
+        },
+        {
+            title: `TLV Value-Based Pricing Framework`,
+            abstract: `Sweden operates a value-based pricing system administered by TLV. Drug prices are set based on demonstrated cost-effectiveness relative to severity of disease. TLV applies an ethical platform considering severity, need, and equity alongside economic evidence. Overview of the Swedish pharmaceutical reimbursement framework and value assessment principles.`,
+            url: "https://www.tlv.se/in-english/about-us.html",
+        },
+    ];
+    return entries.slice(0, maxResults).map((e, i) => ({
+        id: `tlv_${i}`,
+        source: "tlv",
+        title: e.title,
+        authors: ["Tandvårds- och läkemedelsförmånsverket (TLV) — Dental and Pharmaceutical Benefits Agency, Sweden"],
+        date: new Date().getFullYear().toString(),
+        study_type: "hta_report",
+        abstract: e.abstract,
+        url: e.url,
+    }));
+}
+//# sourceMappingURL=tlv.js.map

package/dist/providers/direct/tlv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tlv.js","sourceRoot":"","sources":["../../../src/providers/direct/tlv.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAa,EAAE,UAAkB;IAC9D,MAAM,OAAO,GAAG;QACd;YACE,KAAK,EAAE,yBAAyB,KAAK,EAAE;YACvC,QAAQ,EAAE,oSAAoS,KAAK,wHAAwH;YAC3a,GAAG,EAAE,mDAAmD,kBAAkB,CAAC,KAAK,CAAC,EAAE;SACpF;QACD;YACE,KAAK,EAAE,iDAAiD;YACxD,QAAQ,EAAE,+WAA+W;YACzX,GAAG,EAAE,0FAA0F;SAChG;QACD;YACE,KAAK,EAAE,mCAAmC;YAC1C,QAAQ,EAAE,qWAAqW;YAC/W,GAAG,EAAE,6CAA6C;SACnD;KACF,CAAC;IAEF,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACjD,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,MAAM,EAAE,KAAc;QACtB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,CAAC,kGAAkG,CAAC;QAC7G,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;QACzC,UAAU,EAAE,YAAY;QACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,GAAG,EAAE,CAAC,CAAC,GAAG;KACX,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/providers/direct/whoGho.d.ts

@@ -0,0 +1,3 @@
+import type { LiteratureResult } from "../types.js";
+export declare function fetchWhoGho(query: string, maxResults: number): Promise<LiteratureResult[]>;
+//# sourceMappingURL=whoGho.d.ts.map

package/dist/providers/direct/whoGho.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoGho.d.ts","sourceRoot":"","sources":["../../../src/providers/direct/whoGho.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAsCpD,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA4B7B"}

package/dist/providers/direct/whoGho.js

@@ -0,0 +1,51 @@
+const BASE = "https://ghoapi.who.int/api";
+// Map common HEOR search terms to GHO indicator codes
+const INDICATOR_MAP = {
+    mortality: "WHOSIS_000001", // Life expectancy at birth
+    "life expectancy": "WHOSIS_000001",
+    diabetes: "NCD_BMI_30A", // Prevalence of obesity (BMI≥30)
+    obesity: "NCD_BMI_30A",
+    cardiovascular: "NCDMORT3070", // NCD mortality 30-70
+    cancer: "NCDMORT3070",
+    tobacco: "M_Est_smk_curr_std", // Tobacco use prevalence
+    alcohol: "SA_0000001688", // Alcohol consumption per capita
+    "health expenditure": "GHED_CHE_pc_PPP_SHA2011", // Health expenditure per capita
+};
+function findIndicator(query) {
+    const q = query.toLowerCase();
+    for (const [keyword, code] of Object.entries(INDICATOR_MAP)) {
+        if (q.includes(keyword))
+            return code;
+    }
+    return "WHOSIS_000001"; // Default: life expectancy
+}
+export async function fetchWhoGho(query, maxResults) {
+    try {
+        const indicator = findIndicator(query);
+        const url = `${BASE}/${indicator}?$filter=TimeDim ge '2018'&$top=${maxResults}&$orderby=TimeDim desc`;
+        const res = await fetch(url, {
+            headers: { Accept: "application/json" },
+        });
+        if (!res.ok)
+            return [];
+        const data = (await res.json());
+        const values = data.value ?? [];
+        return values
+            .filter((v) => v.NumericValue !== null)
+            .slice(0, maxResults)
+            .map((v, i) => ({
+            id: `who_gho_${indicator}_${v.SpatialDim}_${v.TimeDim}_${i}`,
+            source: "who_gho",
+            title: `${indicator}: ${v.SpatialDim} (${v.TimeDim})`,
+            authors: ["World Health Organization"],
+            date: v.TimeDim ?? "",
+            study_type: "registry",
+            abstract: `Value: ${v.NumericValue}${v.Dim1 ? ` | Dimension: ${v.Dim1}` : ""} | Country: ${v.SpatialDim} | Year: ${v.TimeDim}`,
+            url: `https://www.who.int/data/gho/data/indicators/indicator-details/GHO/${indicator}`,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=whoGho.js.map

package/dist/providers/direct/whoGho.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoGho.js","sourceRoot":"","sources":["../../../src/providers/direct/whoGho.ts"],"names":[],"mappings":"AAEA,MAAM,IAAI,GAAG,4BAA4B,CAAC;AAe1C,sDAAsD;AACtD,MAAM,aAAa,GAA2B;IAC5C,SAAS,EAAE,eAAe,EAAE,2BAA2B;IACvD,iBAAiB,EAAE,eAAe;IAClC,QAAQ,EAAE,aAAa,EAAE,iCAAiC;IAC1D,OAAO,EAAE,aAAa;IACtB,cAAc,EAAE,aAAa,EAAE,sBAAsB;IACrD,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE,oBAAoB,EAAE,yBAAyB;IACxD,OAAO,EAAE,eAAe,EAAE,iCAAiC;IAC3D,oBAAoB,EAAE,yBAAyB,EAAE,gCAAgC;CAClF,CAAC;AAEF,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;IACvC,CAAC;IACD,OAAO,eAAe,CAAC,CAAC,2BAA2B;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAa,EACb,UAAkB;IAElB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,SAAS,mCAAmC,UAAU,wBAAwB,CAAC;QACtG,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SACxC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,CAAC;QAEvB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAgB,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAEhC,OAAO,MAAM;aACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC;aACtC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;aACpB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACd,EAAE,EAAE,WAAW,SAAS,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE;YAC5D,MAAM,EAAE,SAAkB;YAC1B,KAAK,EAAE,GAAG,SAAS,KAAK,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,OAAO,GAAG;YACrD,OAAO,EAAE,CAAC,2BAA2B,CAAC;YACtC,IAAI,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;YACrB,UAAU,EAAE,UAAU;YACtB,QAAQ,EAAE,UAAU,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,UAAU,YAAY,CAAC,CAAC,OAAO,EAAE;YAC9H,GAAG,EAAE,sEAAsE,SAAS,EAAE;SACvF,CAAC,CAAC,CAAC;IACR,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/providers/direct/worldBank.d.ts

@@ -0,0 +1,3 @@
+import type { LiteratureResult } from "../types.js";
+export declare function fetchWorldBank(query: string, maxResults: number): Promise<LiteratureResult[]>;
+//# sourceMappingURL=worldBank.d.ts.map

package/dist/providers/direct/worldBank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worldBank.d.ts","sourceRoot":"","sources":["../../../src/providers/direct/worldBank.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA+BpD,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA8B7B"}

package/dist/providers/direct/worldBank.js

@@ -0,0 +1,54 @@
+const BASE = "https://api.worldbank.org/v2";
+// Map HEOR-relevant terms to World Bank indicator codes
+const INDICATOR_MAP = {
+    gdp: "NY.GDP.PCAP.PP.CD", // GDP per capita PPP
+    population: "SP.POP.TOTL", // Total population
+    "life expectancy": "SP.DYN.LE00.IN", // Life expectancy at birth
+    "health expenditure": "SH.XPD.CHEX.PP.CD", // Health expenditure per capita PPP
+    mortality: "SP.DYN.CDRT.IN", // Crude death rate
+    "birth rate": "SP.DYN.CBRT.IN",
+    elderly: "SP.POP.65UP.TO.ZS", // Population 65+
+    "infant mortality": "SP.DYN.IMRT.IN",
+};
+function findIndicator(query) {
+    const q = query.toLowerCase();
+    for (const [keyword, code] of Object.entries(INDICATOR_MAP)) {
+        if (q.includes(keyword))
+            return code;
+    }
+    return "NY.GDP.PCAP.PP.CD"; // Default: GDP per capita PPP
+}
+export async function fetchWorldBank(query, maxResults) {
+    try {
+        const indicator = findIndicator(query);
+        // Get most recent data for all countries
+        const url = `${BASE}/country/all/indicator/${indicator}?format=json&date=2018:2025&per_page=${maxResults}&mrnev=1`;
+        const res = await fetch(url);
+        if (!res.ok)
+            return [];
+        const json = await res.json();
+        // World Bank returns [metadata, data] array
+        if (!Array.isArray(json) || json.length < 2)
+            return [];
+        const data = json[1];
+        if (!data)
+            return [];
+        return data
+            .filter((v) => v.value !== null)
+            .slice(0, maxResults)
+            .map((v, i) => ({
+            id: `world_bank_${indicator}_${v.country.id}_${v.date}_${i}`,
+            source: "world_bank",
+            title: `${v.indicator.value}: ${v.country.value} (${v.date})`,
+            authors: ["World Bank"],
+            date: v.date ?? "",
+            study_type: "registry",
+            abstract: `${v.indicator.value}: ${v.value} | Country: ${v.country.value} (${v.country.id}) | Year: ${v.date}`,
+            url: `https://data.worldbank.org/indicator/${indicator}`,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=worldBank.js.map

package/dist/providers/direct/worldBank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worldBank.js","sourceRoot":"","sources":["../../../src/providers/direct/worldBank.ts"],"names":[],"mappings":"AAEA,MAAM,IAAI,GAAG,8BAA8B,CAAC;AAS5C,wDAAwD;AACxD,MAAM,aAAa,GAA2B;IAC5C,GAAG,EAAE,mBAAmB,EAAE,qBAAqB;IAC/C,UAAU,EAAE,aAAa,EAAE,mBAAmB;IAC9C,iBAAiB,EAAE,gBAAgB,EAAE,2BAA2B;IAChE,oBAAoB,EAAE,mBAAmB,EAAE,oCAAoC;IAC/E,SAAS,EAAE,gBAAgB,EAAE,mBAAmB;IAChD,YAAY,EAAE,gBAAgB;IAC9B,OAAO,EAAE,mBAAmB,EAAE,iBAAiB;IAC/C,kBAAkB,EAAE,gBAAgB;CACrC,CAAC;AAEF,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;IACvC,CAAC;IACD,OAAO,mBAAmB,CAAC,CAAC,8BAA8B;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAa,EACb,UAAkB;IAElB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACvC,yCAAyC;QACzC,MAAM,GAAG,GAAG,GAAG,IAAI,0BAA0B,SAAS,wCAAwC,UAAU,UAAU,CAAC;QACnH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,CAAC;QAEvB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,4CAA4C;QAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAqB,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QAErB,OAAO,IAAI;aACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC;aAC/B,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;aACpB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACd,EAAE,EAAE,cAAc,SAAS,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE;YAC5D,MAAM,EAAE,YAAqB;YAC7B,KAAK,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG;YAC7D,OAAO,EAAE,CAAC,YAAY,CAAC;YACvB,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;YAClB,UAAU,EAAE,UAAU;YACtB,QAAQ,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,eAAe,CAAC,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,IAAI,EAAE;YAC9G,GAAG,EAAE,wCAAwC,SAAS,EAAE;SACzD,CAAC,CAAC,CAAC;IACR,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/providers/factory.d.ts

@@ -0,0 +1,3 @@
+import type { IProvider } from "./types.js";
+export declare function createProvider(): IProvider;
+//# sourceMappingURL=factory.d.ts.map

package/dist/providers/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/providers/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,wBAAgB,cAAc,IAAI,SAAS,CAI1C"}

package/dist/providers/factory.js

@@ -0,0 +1,8 @@
+import { DirectProvider } from "./direct/index.js";
+import { HostedProvider } from "./hosted/index.js";
+export function createProvider() {
+    return process.env.HEOR_API_KEY
+        ? new HostedProvider(process.env.HEOR_API_KEY)
+        : new DirectProvider();
+}
+//# sourceMappingURL=factory.js.map

package/dist/providers/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/providers/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY;QAC7B,CAAC,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAC9C,CAAC,CAAC,IAAI,cAAc,EAAE,CAAC;AAC3B,CAAC"}

package/dist/providers/hosted/index.d.ts

@@ -0,0 +1,9 @@
+import type { IProvider, LiteratureSearchParams, CEModelParams, DossierParams, ToolResult } from "../types.js";
+export declare class HostedProvider implements IProvider {
+    private apiKey;
+    constructor(apiKey: string);
+    searchLiterature(_params: LiteratureSearchParams): Promise<ToolResult>;
+    buildCEModel(_params: CEModelParams): Promise<ToolResult>;
+    prepDossier(_params: DossierParams): Promise<ToolResult>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/hosted/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/hosted/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE/G,qBAAa,cAAe,YAAW,SAAS;IAClC,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE5B,gBAAgB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC;IAItE,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAIzD,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;CAG/D"}

package/dist/providers/hosted/index.js

@@ -0,0 +1,16 @@
+export class HostedProvider {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    async searchLiterature(_params) {
+        throw new Error("HostedProvider not yet implemented — coming in Phase 2");
+    }
+    async buildCEModel(_params) {
+        throw new Error("HostedProvider not yet implemented — coming in Phase 2");
+    }
+    async prepDossier(_params) {
+        throw new Error("HostedProvider not yet implemented — coming in Phase 2");
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/hosted/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/hosted/index.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,cAAc;IACL;IAApB,YAAoB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAEtC,KAAK,CAAC,gBAAgB,CAAC,OAA+B;QACpD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAsB;QACvC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAsB;QACtC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;CACF"}