@cliwant/mcp-sam-gov 0.2.1 → 1.0.0

package/dist/grants.d.ts

@@ -19,7 +19,7 @@ export declare function searchGrants(args: {
     oppNum?: string;
     oppStatuses?: GrantStatus[];
     rows?: number;
-}): Promise<{
+}): Promise<import("./meta.js").MetaBundle<{
     totalRecords: number;
     grants: {
         id: string;
@@ -31,18 +31,40 @@ export declare function searchGrants(args: {
         closeDate: string | undefined;
         status: string | undefined;
         docType: string | undefined;
-        cfdaList: string | undefined;
+        cfdaList: string[];
     }[];
-}>;
+}>>;
 export declare function getGrant(args: {
     opportunityId: string;
 }): Promise<{
+    found: false;
+    opportunityId: string;
+    id?: undefined;
+    opportunityNumber?: undefined;
+    title?: undefined;
+    agency?: undefined;
+    description?: undefined;
+    postingDate?: undefined;
+    responseDate?: undefined;
+    archiveDate?: undefined;
+    awardCeiling?: undefined;
+    awardFloor?: undefined;
+    estimatedFunding?: undefined;
+    expectedNumberOfAwards?: undefined;
+    applicantTypes?: undefined;
+    fundingInstruments?: undefined;
+    fundingCategories?: undefined;
+    cfdaPrograms?: undefined;
+} | {
+    found: true;
     id: number;
     opportunityNumber: string;
     title: string;
     agency: {
         code: string | undefined;
-        name: string | undefined;
+        name: string | null;
+        department: string | null;
+        contactName: string | null;
     };
     description: string;
     postingDate: string | undefined;
@@ -59,5 +81,6 @@ export declare function getGrant(args: {
         number: string;
         title: string;
     }[];
+    opportunityId?: undefined;
 }>;
 //# sourceMappingURL=grants.d.ts.map

package/dist/grants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grants.d.ts","sourceRoot":"","sources":["../src/grants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoBH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE1E,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;;;;;;;;;;;;;;GA+CA;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;oBAoDpC,MAAM,EAAE;wBAGR,MAAM,EAAE;uBAGR,MAAM,EAAE;;;;;GAMjC"}
+{"version":3,"file":"grants.d.ts","sourceRoot":"","sources":["../src/grants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAyBH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE1E,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;;;;;;;;;;;;;;IAwIA;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA6FpC,MAAM,EAAE;wBAGR,MAAM,EAAE;uBAGR,MAAM,EAAE;;;;;;GAMjC"}

package/dist/grants.js

@@ -11,17 +11,17 @@
  *
  * Documented at https://grants.gov/web/grants/s2s/grantor/schemas/grants-search-2-soap.html
  */
+import { fetchWithRetry } from "./errors.js";
+import { driftError } from "./datasource.js";
+import { withMeta } from "./meta.js";
 const GRANTS = "https://api.grants.gov/v1/api";
 async function postJson(endpoint, body) {
-    const r = await fetch(`${GRANTS}/${endpoint}`, {
+    const r = await fetchWithRetry(`${GRANTS}/${endpoint}`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify(body),
         signal: AbortSignal.timeout(15_000),
-    });
-    if (!r.ok) {
-        throw new Error(`Grants.gov ${endpoint} returned ${r.status}`);
-    }
+    }, `grants.gov:${endpoint}`);
     return (await r.json());
 }
 export async function searchGrants(args) {
@@ -37,21 +37,98 @@ export async function searchGrants(args) {
     if (json.errorcode && json.errorcode !== 0) {
         throw new Error(`Grants.gov error: ${json.msg ?? "unknown"}`);
     }
-    return {
-        totalRecords: json.data?.hitCount ?? 0,
+    // F4 (P2 empty-vs-outage): a 200 that is NEITHER a recognized error envelope
+    // (handled above) NOR a `{data:{hitCount:number,…}}` shape is drift — a
+    // malformed / outage / interstitial body — and must NOT coalesce to
+    // `totalRecords:0` (an AUTHORITATIVE "no grants"). A GENUINE empty carries a
+    // numeric `data.hitCount:0` and stays an honest empty below. (Mirrors the
+    // govinfo/nih driftError precedent — a drift is a throw, never a fake-empty.)
+    const hitCount = json.data?.hitCount;
+    if (typeof hitCount !== "number") {
+        throw driftError("grants.gov", "Grants.gov search2 returned HTTP 200 but the body carries neither an error code nor a numeric data.hitCount — treating it as schema drift / an outage interstitial, NOT an empty result set.");
+    }
+    const totalRecords = hitCount;
+    const data = {
+        totalRecords,
         grants: (json.data?.oppHits ?? []).map((g) => ({
             id: g.id ?? "",
             opportunityNumber: g.number ?? "",
             title: g.title ?? "",
             agencyCode: g.agencyCode ?? "",
-            agencyName: g.agencyName ?? "",
+            // GRANT-2: prefer `agency` (the real agency name) over the empty `agencyName`.
+            agencyName: g.agency ?? g.agencyName ?? "",
             openDate: g.openDate,
             closeDate: g.closeDate,
             status: g.oppStatus,
             docType: g.docType,
-            cfdaList: g.cfdaList,
+            // E-2: always an array — normalize absent/legacy-string to []/[str]
+            // so consumers can rely on `cfdaList` being string[] unconditionally.
+            cfdaList: Array.isArray(g.cfdaList)
+                ? g.cfdaList
+                : g.cfdaList
+                    ? [g.cfdaList]
+                    : [],
         })),
     };
+    // Truthful `_meta` (spec §1.2 A4, §2.3). Grants.gov reports a real match
+    // total (`hitCount`), so `totalAvailable` is trustworthy. A4: Grants.gov
+    // silently IGNORES unknown agency codes / CFDA numbers (it returns the
+    // unfiltered set rather than erroring), and it does not echo back which
+    // filters it honored — so the AI cannot verify a filter took. We list the
+    // filters we SENT in `filtersApplied` and warn that unknown values are
+    // dropped silently, so the AI treats a suspiciously large result set with
+    // caution instead of asserting it is filtered.
+    const returned = data.grants.length;
+    const sent = [];
+    if (args.keyword)
+        sent.push("keyword");
+    if (args.cfda)
+        sent.push("cfda");
+    if (args.agency)
+        sent.push("agency");
+    if (args.oppNum)
+        sent.push("oppNum");
+    if (args.oppStatuses?.length)
+        sent.push("oppStatuses");
+    const notes = [];
+    if (args.agency || args.cfda) {
+        notes.push("Grants.gov silently ignores an unknown agency code or CFDA number (it returns the UNFILTERED result set instead of an error) and does not confirm which filters were honored — if the result count looks too broad, verify the agency/CFDA value.");
+    }
+    // VQ-1 (C82 dogfooding): Grants.gov OR-tokenizes multi-word keywords (matches ANY
+    // word) and does NOT support phrase quoting (a quoted "..." keyword returns 0). Live:
+    // "cybersecurity information technology" → 926 broad hits (State-Dept program
+    // statements top) vs 280 focused for "cybersecurity". The note is RESULT-AWARE
+    // (adversarial review F1/F2): "broad set ≠ no grants" only holds when there ARE
+    // results; a 0-result multi-word query needs the opposite advice. Quotes are stripped
+    // for the word count so a quote-wrapped phrase is still detected as multi-word.
+    const rawKw = args.keyword ?? "";
+    const looksQuoted = /^\s*["'][\s\S]*["']\s*$/.test(rawKw);
+    const kwWords = rawKw
+        .trim()
+        .replace(/^["']+|["']+$/g, "")
+        .trim()
+        // disclosure-split-ok: grants.gov OR-splits ONLY whitespace (and '+'), NOT punctuation — live-verified 2026-07; the shared DISCLOSURE_SPLIT_RE punctuation class must NOT be applied here (it would over-disclose). See ADR-0022.
+        .split(/\s+/)
+        .filter(Boolean);
+    if (kwWords.length > 1) {
+        if (totalRecords > 0) {
+            notes.push(`Grants.gov OR-matches multi-word keywords: it returns opportunities containing ANY of these ${kwWords.length} words, so this keyword may BROADEN results if any word is a common term ("information"/"technology"/"program" match many unrelated grants) — a broad, poorly-ranked set here does NOT mean "no relevant grants". For focused results pass ONE specific term (e.g. "cybersecurity"); Grants.gov does NOT support phrase quoting (a quoted "..." keyword returns 0). Narrow with cfda / agency / oppStatuses instead.`);
+        }
+        else {
+            notes.push(`This ${kwWords.length}-word keyword returned 0 results. Grants.gov OR-matches keywords and does NOT support phrase quoting${looksQuoted ? ' — your keyword appears quote-wrapped, so REMOVE the quotes (a quoted "..." keyword always returns 0)' : ' (a quoted "..." keyword returns 0)'}. A 0 here means even the OR of these words has no match — try each word separately, or narrow with cfda/agency/oppStatuses, to isolate.`);
+        }
+    }
+    return withMeta(data, {
+        source: "grants.gov/api (search2)",
+        keylessMode: true,
+        returned,
+        totalAvailable: totalRecords,
+        truncated: returned < totalRecords,
+        filtersApplied: sent,
+        filtersDropped: [],
+        fieldsUnavailable: [],
+        notes,
+    });
 }
 export async function getGrant(args) {
     const json = await postJson("fetchOpportunity", {
@@ -61,12 +138,38 @@ export async function getGrant(args) {
         throw new Error(`Grants.gov error: ${json.msg ?? "unknown"}`);
     }
     const d = json.data ?? {};
+    // NOT-FOUND: Grants.gov's fetchOpportunity returns errorcode:0 ("Webservice
+    // Succeeds") + a HOLLOW `data` object even for a NONEXISTENT opportunityId
+    // (LIVE-VERIFIED 2026-07-06: id 999999999 → errorcode 0 but data carries NO
+    // id / opportunityNumber / opportunityTitle / synopsis — only skeleton fields).
+    // Mapping that shell would fabricate a grant (id:0, title:"") for an opportunity
+    // that does NOT exist — an absence-as-present lie. `id` is the reliable signal:
+    // a real grant ALWAYS carries a numeric `id`, the hollow shell never does.
+    if (d.id === undefined || d.id === null) {
+        return { found: false, opportunityId: args.opportunityId };
+    }
     const s = d.synopsis ?? {};
+    const rawContact = s.agencyContactName ?? s.agencyName ?? null;
     return {
-        id: d.id ?? 0,
+        found: true,
+        id: d.id, // guaranteed present past the not-found guard above
         opportunityNumber: d.opportunityNumber ?? "",
         title: d.opportunityTitle ?? "",
-        agency: { code: s.agencyCode ?? d.owningAgencyCode, name: s.agencyName },
+        // GRANT-2: `name` is the REAL agency (subtier preferred, else the department),
+        // NOT synopsis.agencyName (which is the contact person). Fall back through both
+        // the synopsis and top-level `data` locations. `department` is the top-tier
+        // agency; `contactName` preserves the person the mislabeled old `name` held
+        // (newlines collapsed so it renders on one line).
+        agency: {
+            code: s.agencyCode ?? d.owningAgencyCode,
+            name: s.agencyDetails?.agencyName ??
+                d.agencyDetails?.agencyName ??
+                s.topAgencyDetails?.agencyName ??
+                d.topAgencyDetails?.agencyName ??
+                null,
+            department: s.topAgencyDetails?.agencyName ?? d.topAgencyDetails?.agencyName ?? null,
+            contactName: rawContact ? rawContact.replace(/\s*\n\s*/g, " — ") : null,
+        },
         description: s.synopsisDesc ?? d.synopsisDesc ?? "",
         postingDate: s.postingDate,
         responseDate: s.responseDate,

package/dist/grants.js.map

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

package/dist/gsa-csv.d.ts

@@ -0,0 +1,249 @@
+/**
+ * GSA daily-CSV keyless backbone (opt-in) — page-completing enrichment for the
+ * fields the keyless SAM HAL list endpoint nulls.
+ *
+ * Why this exists
+ * ----------------
+ * `sam_search_opportunities` (keyless HAL) returns a page of notices but nulls
+ * each row's naics / setAside / place-of-performance / responseDeadline / type
+ * (the list payload omits those VALUES even though the server-side filter
+ * honored them). Today the only fill path is `sam_get_opportunity` PER notice —
+ * N detail calls to complete an N-row page.
+ *
+ * The GSA "Contract Opportunities" daily bulk CSV carries all of those fields
+ * keyed by NoticeId (the 32-hex id that equals the HAL `_id`). So ONE cached
+ * index lookup completes a whole page, and it's a durability hedge if the
+ * undocumented HAL list drifts.
+ *
+ * Source — LIVE-VERIFIED 2026-07-03
+ * ---------------------------------
+ *   https://falextracts.s3.amazonaws.com/Contract Opportunities/datagov/ContractOpportunitiesFullCSV.csv
+ *   HEAD 200, 225,722,960 bytes (225.7 MB), `last-modified` daily,
+ *   `accept-ranges: bytes`, 47 columns. Key + HAL-nulled fields (0-indexed):
+ *   NoticeId@0 (32-hex == HAL _id), Title@1, Type@10, SetASideCode@14,
+ *   SetASide@15, ResponseDeadLine@16, NaicsCode@17, PopCity@20, PopState@21,
+ *   PopZip@22, PopCountry@23, Active@24, Description@46.
+ *
+ * Gold-standard verification (2026-07-03): for a live notice
+ * (a4be592da0304872a252980925b9458f) the CSV index's naics/PoP EQUAL what
+ * `sam_get_opportunity` (detail) returns — naics 238990, PoP WA / Hoodsport /
+ * 98548 all match; setAsideCode 'SBA' equals detail's mapped setAside 'SBA'.
+ *
+ * The non-negotiable design constraints
+ * -------------------------------------
+ *   1. OFF BY DEFAULT. No forced 225 MB download. Enabled only via env
+ *      (`SAM_GOV_CSV_CACHE` = a cache dir, or `SAM_GOV_ENABLE_CSV=1` to use a
+ *      default dir under the OS temp). Every EXISTING keyless HAL tool is
+ *      UNCHANGED.
+ *   2. BOUNDED RAM. Never hold the 225 MB in memory. Stream the download to a
+ *      cache FILE on disk. Build a COMPACT index of only the ~11 needed columns
+ *      (NOT Description@46), keyed by NoticeId (~24 MB for this snapshot's
+ *      ~78k rows, verified). Persist the compact index to the cache dir and
+ *      load THAT into a Map; refresh when > 24 h old or the CSV `last-modified`
+ *      changed.
+ *   3. STREAMING RFC-4180 parser, NO new npm dependency. Fields are quoted and
+ *      some (Title, addresses) embed commas; a state machine handles the
+ *      in-quote toggle, `""`→`"` escape, and newlines inside quotes. Since we
+ *      skip Description@46 (the worst offender) we only parse through column 24.
+ *   4. TRUTHFUL `_meta` (the product): honest source, freshness (CSV
+ *      last-modified + index build time), degraded on download/parse failure
+ *      (never a silent empty), and per-noticeId a notice ABSENT from the
+ *      current snapshot → `found:false` + nulls + an explicit "not in current
+ *      CSV snapshot" disclosure, NEVER faked. DISABLED → a structured note
+ *      explaining how to enable it (not an error, not fake data). A cold-cache
+ *      first call that triggers the download is slow → disclosed as "warming".
+ */
+/** The GSA daily bulk CSV (keyless). Space in the path is URL-encoded. */
+export declare const GSA_CSV_URL = "https://falextracts.s3.amazonaws.com/Contract%20Opportunities/datagov/ContractOpportunitiesFullCSV.csv";
+export declare const GSA_CSV_SOURCE = "gsa.gov daily bulk CSV (keyless)";
+/** Max noticeIds accepted per batch (completes a `sam_search_opportunities` page). */
+export declare const MAX_NOTICE_IDS = 100;
+/**
+ * Resolve the opt-in config from the environment.
+ *
+ * Enablement (in priority order):
+ *   - `SAM_GOV_CSV_FIXTURE` = path to a LOCAL CSV file → enabled, no network
+ *     (used by tests and for pinning a pre-downloaded file). The cache dir
+ *     defaults next to the fixture unless `SAM_GOV_CSV_CACHE` is also set.
+ *   - `SAM_GOV_CSV_CACHE` = a cache DIRECTORY path → enabled; downloads live.
+ *   - `SAM_GOV_ENABLE_CSV` truthy (`1`/`true`/`yes`) → enabled with a default
+ *     cache dir under the OS temp (`<tmp>/mcp-sam-gov-csv`).
+ *   - otherwise DISABLED (default) — the backbone never touches the network.
+ */
+export type CsvConfig = {
+    enabled: boolean;
+    cacheDir: string;
+    /** A local CSV to index instead of downloading (tests / pinned file). */
+    fixturePath: string | null;
+};
+export declare function resolveCsvConfig(env?: NodeJS.ProcessEnv): CsvConfig;
+/**
+ * Parse one LOGICAL CSV record's text into fields 0..maxCol (inclusive).
+ *
+ * A proper state machine (NOT `split(",")`): tracks an in-quote toggle, turns
+ * `""` into a single `"`, and treats commas/CR/quotes literally while inside a
+ * quoted field. It also reports whether parsing ended INSIDE an open quote —
+ * the record-assembler uses that to know a physical newline fell inside a
+ * quoted field and the logical record continues on the next line.
+ *
+ * CRITICAL — we must scan the WHOLE text to get quote parity right, even though
+ * we only KEEP fields up to `maxCol`. Once we're past `maxCol` we stop STORING
+ * fields (so the giant Description@46 is never materialized — bounded memory),
+ * but we KEEP walking the characters to maintain the in-quote toggle. Early-
+ * returning at `maxCol` would misjudge a newline that falls inside a LATER
+ * quoted field (e.g. an embedded newline in Description@46): the record would
+ * be wrongly treated as complete and the field's tail would corrupt the next
+ * record. (This was a real bug — the fix is: cap storage, never cap scanning.)
+ */
+export declare function parseRecordFields(text: string, maxCol?: number): {
+    fields: string[];
+    inQuotes: boolean;
+};
+/** The compact per-notice record we keep in the index (NOT Description). */
+export type NoticeFields = {
+    title: string;
+    type: string;
+    setAsideCode: string;
+    setAside: string;
+    responseDeadline: string;
+    naicsCode: string;
+    popCity: string;
+    popState: string;
+    popZip: string;
+    popCountry: string;
+    active: string;
+};
+/** TEST-ONLY: drop the process-lifetime memo so a test can re-point the env. */
+export declare function _resetIndexForTests(): void;
+/** A read-only view of a loaded index for enrichment consumers. */
+export type ReadyIndex = {
+    get(noticeId: string): NoticeFields | undefined;
+    csvLastModified: string | null;
+    indexBuiltAt: string;
+    rowCount: number;
+};
+/**
+ * NON-BLOCKING: return a ready CSV index if one is loaded + fresh, else null.
+ *
+ * Guarantees for the search hot-path:
+ *   - Disabled config → null (no work, no network) — caller skips enrichment.
+ *   - An in-memory index within its TTL → returned synchronously (no HEAD, no
+ *     download).
+ *   - No in-memory index (cold) → returns null IMMEDIATELY and, unless a
+ *     refresh is already in flight, kicks off a background `ensureIndex` (its
+ *     result is memoized into `loaded` for a subsequent call). The promise is
+ *     deliberately NOT awaited here and its rejection is swallowed so a failed
+ *     warm never surfaces on the search path.
+ *   - An in-memory index PAST its TTL → still returned (stale-but-usable) while
+ *     a background refresh is kicked off; the caller discloses the age via
+ *     freshness so a slightly-stale snapshot is honest, never a stall.
+ *
+ * This never throws — any misconfiguration or I/O error degrades to null.
+ */
+export declare function tryGetReadyIndex(cfg?: CsvConfig): ReadyIndex | null;
+/** One opportunity row as emitted by the keyless sam_search handler. */
+export type SearchOppRow = {
+    noticeId: string;
+    title?: string | null;
+    agency?: string | null;
+    solicitationNumber?: string | null;
+    responseDeadline?: string | null;
+    naics?: string | null;
+    setAside?: string | null;
+    uiLink?: string | null;
+    type?: string | null;
+    placeOfPerformance?: SamCsvPlaceOfPerformance | null;
+    [k: string]: unknown;
+};
+/** Place-of-performance shape composed from the CSV Pop* columns. */
+export type SamCsvPlaceOfPerformance = {
+    city: string | null;
+    state: string | null;
+    zip: string | null;
+    country: string | null;
+};
+export type EnrichmentOutcome = {
+    /** The page with null fields filled from the CSV where the notice was found. */
+    opportunities: SearchOppRow[];
+    /** Notices in the page that were present in the CSV snapshot. */
+    foundCount: number;
+    /** Notices in the page absent from the CSV snapshot (left un-enriched). */
+    missingCount: number;
+    /** Union of field names filled on ≥1 row (subset of naics/setAside/… ). */
+    fieldsFilled: Set<string>;
+    /** Snapshot freshness, mirrored into data + _meta by the caller. */
+    freshness: {
+        csvLastModified: string | null;
+        indexBuiltAt: string;
+        indexAgeHours: number | null;
+        rowCount: number;
+    };
+};
+/**
+ * Fill the keyless search page's null naics/setAside/placeOfPerformance (and
+ * responseDeadline/type when currently null) from the ready CSV index.
+ *
+ * Rules (honesty):
+ *   - Only a null field is filled — a value already present (e.g. keyed mode,
+ *     or a HAL row that carried the value) is NEVER overwritten.
+ *   - A field is filled only when the CSV cell is a real non-empty value (an
+ *     empty CSV cell stays null — absence ≠ empty).
+ *   - `type`/`placeOfPerformance` keys are ADDED only when a value is actually
+ *     filled from the CSV, so a not-in-snapshot row keeps the exact original
+ *     shape (no spurious null keys).
+ *   - A noticeId absent from the snapshot is left byte-identical + counted.
+ */
+export declare function enrichSearchOpportunities(opportunities: SearchOppRow[], index: ReadyIndex): EnrichmentOutcome;
+export type LookupResult = {
+    noticeId: string;
+    found: boolean;
+    naicsCode: string | null;
+    setAside: string | null;
+    setAsideCode: string | null;
+    popState: string | null;
+    popCity: string | null;
+    popZip: string | null;
+    popCountry: string | null;
+    responseDeadline: string | null;
+    type: string | null;
+    active: boolean | null;
+    title: string | null;
+};
+/**
+ * BATCH keyless enrichment: for each 32-hex noticeId return the HAL-nulled
+ * fields (naics / setAside / place-of-performance / responseDeadline / type /
+ * active / title) from the cached GSA CSV index — completing a whole
+ * `sam_search_opportunities` page in ONE call.
+ *
+ * Honesty contract (the product):
+ *   - DISABLED (default) → `data.enabled:false`, every row `found:false`+nulls,
+ *     and `_meta.notes` explains how to enable the backbone. NOT an error, NOT
+ *     fake data.
+ *   - a noticeId ABSENT from the current snapshot → `found:false` + nulls + a
+ *     disclosure that it is "not in the current CSV snapshot", NEVER faked.
+ *   - download/parse failure → `degraded` (a structured error is thrown and
+ *     surfaced by the server as a retryable envelope) — never a silent empty.
+ *   - `_meta.freshness` carries the CSV `last-modified` + the index build time
+ *     so the AI knows how stale the snapshot is; a cold-cache first call that
+ *     triggered the download is disclosed as "warming".
+ */
+export declare function lookupNoticeFields(args: {
+    noticeIds: string[];
+}, env?: NodeJS.ProcessEnv): Promise<import("./meta.js").MetaBundle<{
+    results: LookupResult[];
+    enabled: boolean;
+    freshness: null;
+}> | import("./meta.js").MetaBundle<{
+    results: LookupResult[];
+    enabled: boolean;
+    freshness: {
+        csvLastModified: string | null;
+        indexBuiltAt: string;
+        indexAgeHours: number | null;
+        rowCount: number;
+        warming: boolean;
+    };
+    foundCount: number;
+    missingCount: number;
+}>>;
+//# sourceMappingURL=gsa-csv.d.ts.map

package/dist/gsa-csv.d.ts.map

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