@cliwant/mcp-sam-gov 0.2.1 → 1.0.0

package/dist/treasury.d.ts

@@ -0,0 +1,143 @@
+/**
+ * US Treasury — Fiscal Data API wrappers (keyless).
+ *
+ * First non-SAM macro/fiscal source (ADR-0002). Fully PUBLIC, KEYLESS — the
+ * Treasury Fiscal Data service (https://fiscaldata.treasury.gov) needs no API
+ * key and documents no numeric rate limit. Base:
+ *   https://api.fiscaldata.treasury.gov/services/api/fiscal_service/
+ *
+ * Three clean layers (seed the future common DataSource port, R2):
+ *   fetch — `getTreasury(path, query)` builds the URL + envelope, reusing
+ *           errors.ts retry/timeout/taxonomy.
+ *   map   — per-dataset PURE mappers Row → domain object, coercing string
+ *           amounts through the shared `num()`.
+ *   meta  — `treasuryMeta(...)` hands `{ totalAvailable, returned, pagination }`
+ *           to `withMeta`; meta.ts's `buildMeta` DERIVES complete/truncated.
+ *
+ * HONESTY TRAPS (live-verified 2026-07-10 — see ADR-0002 Review outcome v2):
+ *   F1/F9 — `meta.count` / `meta['total-count']` / `meta['total-pages']` are
+ *           JSON NUMBERS (not strings). `totalAvailable = meta['total-count']`
+ *           directly; never `num()` them.
+ *   F2    — VALUE fields are inconsistently typed across datasets (debt/rate
+ *           amounts are strings; even `rates_of_exchange.exchange_rate`, whose
+ *           dataType metadata says NUMBER, arrives as a string on the wire).
+ *           Row value fields are typed `string | number | null` and ALWAYS go
+ *           through `num()`.
+ *   F3    — `num(x)` returns null (NEVER 0) for absent values. The literal
+ *           string "null" is common (early history + MTS parent/summary rows);
+ *           returning 0 would be a data-absence-as-zero masquerade.
+ *   F4    — `mts_table_1` mixes child line-items (real amounts) with
+ *           fiscal-year PARENT/SUMMARY rows whose amounts are all "null".
+ *           `monthlyStatement` excludes them by default via the LIVE-VERIFIED
+ *           server-side filter `current_month_gross_outly_amt:gt:0` (3039 →
+ *           2769 rows; the 270 dropped rows are exactly the `parent_id="null"`
+ *           header rows).
+ *   F5    — `queryDataset` accepts only an ENUM of 5 confirmed paths (no free
+ *           path) — removes the SSRF surface for this slice.
+ */
+import { num } from "./coerce.js";
+import { type MetaBundle } from "./meta.js";
+export { num };
+/**
+ * Test-only: reset the resilience circuit breaker between OFFLINE fixtures (the
+ * breaker is module-level process state; a fresh instance isolates cases). Not a
+ * runtime API — mirrors the `_reset*Cache` convention in the fault suite.
+ */
+export declare function _resetTreasuryBreakerForTests(): void;
+export declare const TREASURY_DATASETS: {
+    readonly debt_to_penny: "/v2/accounting/od/debt_to_penny";
+    readonly avg_interest_rates: "/v2/accounting/od/avg_interest_rates";
+    readonly mts_table_1: "/v1/accounting/mts/mts_table_1";
+    readonly rates_of_exchange: "/v1/accounting/od/rates_of_exchange";
+    readonly debt_outstanding: "/v2/accounting/od/debt_outstanding";
+};
+export type TreasuryDatasetKey = keyof typeof TREASURY_DATASETS;
+export type TreasuryValue = string | number | null;
+export type TreasuryRow = Record<string, TreasuryValue>;
+export type TreasuryEnvelopeMeta = {
+    /** rows in THIS page — a JSON number (F1). */
+    count: number;
+    /** the truthful grand total for the query — a JSON number (F1). */
+    "total-count": number;
+    /** a JSON number (F1). */
+    "total-pages": number;
+    labels?: Record<string, string>;
+    dataTypes?: Record<string, string>;
+    dataFormats?: Record<string, string>;
+};
+export type TreasuryEnvelope<Row = TreasuryRow> = {
+    data: Row[];
+    meta: TreasuryEnvelopeMeta;
+    links?: {
+        self?: string;
+        first?: string;
+        prev?: string | null;
+        next?: string | null;
+        last?: string;
+    };
+};
+/**
+ * Generic escape hatch over the 5 confirmed datasets (covers debt_outstanding +
+ * rates_of_exchange without a dedicated tool). Rows are passed through RAW
+ * (value fields as strings exactly as upstream provides) — the `_meta` note
+ * warns that the literal string "null" means "no value", never zero.
+ */
+export declare function queryDataset(args: {
+    dataset: TreasuryDatasetKey;
+    fields?: string;
+    filter?: string;
+    sort?: string;
+    pageSize?: number;
+    pageNumber?: number;
+}): Promise<MetaBundle>;
+/**
+ * Daily total US public debt ("Debt to the Penny"). `latest` (default true) ⇒
+ * the single most-recent day; else the `startDate/endDate` range, newest first.
+ * Amounts are USD, coerced via num() (null, never 0, for absent).
+ */
+export declare function debtToPenny(args: {
+    latest?: boolean;
+    startDate?: string;
+    endDate?: string;
+    pageSize?: number;
+    pageNumber?: number;
+}): Promise<MetaBundle>;
+/**
+ * Monthly Treasury Statement (MTS) table 1 — federal receipts, outlays, and the
+ * deficit/surplus by month. `startDate/endDate` (ISO) filter record_date;
+ * default is the trailing ~12 months.
+ *
+ * F4 — SUMMARY-ROW EXCLUSION (live-verified 2026-07-10): mts_table_1 interleaves
+ * child line-items (real amounts) with fiscal-year PARENT/SUMMARY header rows
+ * whose `parent_id` is the string "null" and whose amount fields are all the
+ * string "null". `excludeSummaryRows` (default true) appends the server-side
+ * filter `current_month_gross_outly_amt:gt:0`, which drops EXACTLY those parent
+ * rows (total-count 3039 → 2769; the 270 dropped rows == the parent_id="null"
+ * set). Because the exclusion is server-side, `total-count` (and hence
+ * `_meta.totalAvailable` / pagination) reflect the child rows only — no
+ * client-side filtering that would desync `returned` from the envelope count.
+ */
+export declare function monthlyStatement(args: {
+    startDate?: string;
+    endDate?: string;
+    excludeSummaryRows?: boolean;
+    pageSize?: number;
+    pageNumber?: number;
+}): Promise<MetaBundle>;
+/**
+ * Average interest rate the Treasury pays by security type/description.
+ * `latest` (default true) returns the most-recent month's full breakdown across
+ * security types (pinned to the latest record_date, memoized — a slow-changing
+ * reference read); else the `startDate/endDate` range. Optional `securityType`
+ * narrows by `security_type_desc` (e.g. "Marketable", "Non-marketable").
+ * `avg_interest_rate_amt` is a PERCENT, coerced via num() (null, never 0).
+ */
+export declare function avgInterestRates(args: {
+    securityType?: string;
+    latest?: boolean;
+    startDate?: string;
+    endDate?: string;
+    pageSize?: number;
+    pageNumber?: number;
+}): Promise<MetaBundle>;
+//# sourceMappingURL=treasury.d.ts.map

package/dist/treasury.d.ts.map

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

package/dist/treasury.js

@@ -0,0 +1,436 @@
+/**
+ * US Treasury — Fiscal Data API wrappers (keyless).
+ *
+ * First non-SAM macro/fiscal source (ADR-0002). Fully PUBLIC, KEYLESS — the
+ * Treasury Fiscal Data service (https://fiscaldata.treasury.gov) needs no API
+ * key and documents no numeric rate limit. Base:
+ *   https://api.fiscaldata.treasury.gov/services/api/fiscal_service/
+ *
+ * Three clean layers (seed the future common DataSource port, R2):
+ *   fetch — `getTreasury(path, query)` builds the URL + envelope, reusing
+ *           errors.ts retry/timeout/taxonomy.
+ *   map   — per-dataset PURE mappers Row → domain object, coercing string
+ *           amounts through the shared `num()`.
+ *   meta  — `treasuryMeta(...)` hands `{ totalAvailable, returned, pagination }`
+ *           to `withMeta`; meta.ts's `buildMeta` DERIVES complete/truncated.
+ *
+ * HONESTY TRAPS (live-verified 2026-07-10 — see ADR-0002 Review outcome v2):
+ *   F1/F9 — `meta.count` / `meta['total-count']` / `meta['total-pages']` are
+ *           JSON NUMBERS (not strings). `totalAvailable = meta['total-count']`
+ *           directly; never `num()` them.
+ *   F2    — VALUE fields are inconsistently typed across datasets (debt/rate
+ *           amounts are strings; even `rates_of_exchange.exchange_rate`, whose
+ *           dataType metadata says NUMBER, arrives as a string on the wire).
+ *           Row value fields are typed `string | number | null` and ALWAYS go
+ *           through `num()`.
+ *   F3    — `num(x)` returns null (NEVER 0) for absent values. The literal
+ *           string "null" is common (early history + MTS parent/summary rows);
+ *           returning 0 would be a data-absence-as-zero masquerade.
+ *   F4    — `mts_table_1` mixes child line-items (real amounts) with
+ *           fiscal-year PARENT/SUMMARY rows whose amounts are all "null".
+ *           `monthlyStatement` excludes them by default via the LIVE-VERIFIED
+ *           server-side filter `current_month_gross_outly_amt:gt:0` (3039 →
+ *           2769 rows; the 270 dropped rows are exactly the `parent_id="null"`
+ *           header rows).
+ *   F5    — `queryDataset` accepts only an ENUM of 5 confirmed paths (no free
+ *           path) — removes the SSRF surface for this slice.
+ */
+import { getJson, driftError, throughPathChain, CircuitBreaker, } from "./datasource.js";
+import { snapshotPath } from "./snapshot.js";
+import { num, str } from "./coerce.js";
+import { memoize } from "./cache.js";
+import { withMeta } from "./meta.js";
+// Re-export the shared honesty coercion (single audited copy now lives in
+// ./coerce.js — ADR-0005 v2 FIX-C) so existing importers and the fault suite's
+// num-parity guard keep resolving `num` from this module.
+export { num };
+const BASE = "https://api.fiscaldata.treasury.gov/services/api/fiscal_service";
+// ─── Resilience wiring (ADR-0045 Phase 2 pilot — INERT by default) ─────────
+// The Treasury live host, and a per-host circuit breaker keyed on the FIXED set
+// {this host} (bounded — m3-regression). The breaker is CONSULTED only by
+// `throughPathChain` for a ≥2-path chain; when no snapshot is configured the
+// chain is single-path (live only) and the breaker is a pure no-op. See
+// datasource.ts §"RESILIENCE PORT".
+const TREASURY_HOST = "api.fiscaldata.treasury.gov";
+let treasuryBreaker = new CircuitBreaker([TREASURY_HOST]);
+/**
+ * Test-only: reset the resilience circuit breaker between OFFLINE fixtures (the
+ * breaker is module-level process state; a fresh instance isolates cases). Not a
+ * runtime API — mirrors the `_reset*Cache` convention in the fault suite.
+ */
+export function _resetTreasuryBreakerForTests() {
+    treasuryBreaker = new CircuitBreaker([TREASURY_HOST]);
+}
+// ─── Confirmed dataset paths (F5 allowlist enum) ──────────────────
+// Live-verified 2026-07-10: path + total-count + key fields (ADR-0002 §Context).
+export const TREASURY_DATASETS = {
+    debt_to_penny: "/v2/accounting/od/debt_to_penny",
+    avg_interest_rates: "/v2/accounting/od/avg_interest_rates",
+    mts_table_1: "/v1/accounting/mts/mts_table_1",
+    rates_of_exchange: "/v1/accounting/od/rates_of_exchange",
+    debt_outstanding: "/v2/accounting/od/debt_outstanding",
+};
+// ─── HONESTY-CRITICAL coercions (F1/F2/F3) ────────────────────────
+// `num`/`str` are the shared, audited null-never-0 coercions in ./coerce.js
+// (imported above, `num` re-exported). F3: `num` returns null (NEVER 0) for
+// absent values — the literal string "null" (early history + MTS parent rows),
+// ""/whitespace (Number("") is 0!), and "(-)"/"-" all become null.
+// ─── fetch layer ──────────────────────────────────────────────────
+/**
+ * GET one Treasury Fiscal Data page. Reuses errors.ts (retry/backoff/timeout +
+ * the 429/5xx/404/400 taxonomy: an invalid `fields`/`filter` column ⇒ upstream
+ * 400 ⇒ `invalid_input`, surfaced as an error, never a silent drop). Throws a
+ * `schema_drift` ToolErrorCarrier if the envelope's `total-count` is not a
+ * number (so a future upstream retype can't silently corrupt `_meta`).
+ */
+async function getTreasury(path, query, snapshotKey) {
+    const params = new URLSearchParams();
+    if (query.fields)
+        params.set("fields", query.fields);
+    if (query.filter)
+        params.set("filter", query.filter);
+    if (query.sort)
+        params.set("sort", query.sort);
+    params.set("page[size]", String(query.pageSize));
+    params.set("page[number]", String(query.pageNumber));
+    const url = `${BASE}${path}?${params.toString()}`;
+    const label = "treasury:" + path;
+    // ★ADR-0045 Phase 2 pilot — route the fetch through `throughPathChain` INSTEAD
+    // of a bare getJson. The LIVE path is byte-identical to the prior hand-rolled
+    // fetch (init === { signal }, no headers/redirect — the same getJson call).
+    const livePath = {
+        host: TREASURY_HOST,
+        provenance: { dataPath: "live" },
+        run: () => getJson(url, { label }),
+    };
+    // The snapshot fallback is added ONLY when (a) this call declares a canned
+    // snapshot key AND (b) SAMGOV_SNAPSHOT_BASE_URL is configured (else
+    // snapshotPath returns null). ★When either is absent the chain is SINGLE-ENTRY
+    // (live only) ⇒ throughPathChain fast-paths (no breaker consult, no overhead)
+    // ⇒ behavior byte-identical to before this ADR (the INERT guarantee).
+    const snap = snapshotKey
+        ? snapshotPath(snapshotKey)
+        : null;
+    const paths = snap ? [livePath, snap] : [livePath];
+    const { body: env, provenance } = await throughPathChain(paths, treasuryBreaker);
+    // Drift guard applies to BOTH paths (a malformed snapshot fails as loudly as a
+    // malformed live body) — schema_drift is non-retryable, so it does not fall
+    // through nor trip the breaker.
+    if (!env ||
+        typeof env.meta !== "object" ||
+        env.meta === null ||
+        typeof env.meta["total-count"] !== "number" ||
+        !Array.isArray(env.data)) {
+        throw driftError(label, `treasury:${path} returned an unexpected envelope shape (meta['total-count'] must be a number and data an array).`);
+    }
+    return { env, provenance };
+}
+// ─── meta layer ───────────────────────────────────────────────────
+const STRING_COERCION_NOTE = "Treasury value/amount fields arrive as strings (or, for some datasets, numbers) and are coerced via num(): the literal string \"null\" and empty values become null (NOT 0) — a null amount means 'no value reported', never zero.";
+/**
+ * Build the partial `_meta`. Passes `totalAvailable` (= the numeric
+ * `total-count`, NEVER data.length/count/page-size) + offset-pagination, and
+ * lets meta.ts's `buildMeta` DERIVE `complete`/`truncated` from those signals
+ * (do NOT recompute here).
+ */
+function treasuryMeta(opts) {
+    const totalAvailable = opts.env.meta["total-count"];
+    const returned = opts.env.data.length;
+    const offset = (opts.pageNumber - 1) * opts.pageSize;
+    const hasMore = offset + returned < totalAvailable;
+    const meta = {
+        source: `api.fiscaldata.treasury.gov (keyless) ${opts.path}`,
+        keylessMode: true,
+        returned,
+        totalAvailable,
+        pagination: {
+            offset,
+            limit: opts.pageSize,
+            hasMore,
+            nextOffset: hasMore ? offset + returned : null,
+        },
+        filtersApplied: opts.filtersApplied ?? [],
+        filtersDropped: [],
+        fieldsUnavailable: opts.fieldsUnavailable ?? [],
+        notes: opts.notes,
+    };
+    // P5 threading (ADR-0045 B2): surface dataPath/asOf ONLY when NON-live, so a
+    // live response omits the keys and stays byte-identical. No `??` default.
+    if (opts.provenance && opts.provenance.dataPath !== "live") {
+        meta.dataPath = opts.provenance.dataPath;
+        if (opts.provenance.asOf !== undefined)
+            meta.asOf = opts.provenance.asOf;
+    }
+    return meta;
+}
+/** Build `record_date` gte/lte filter clauses from optional ISO dates. */
+function dateFilters(startDate, endDate) {
+    const f = [];
+    if (startDate)
+        f.push(`record_date:gte:${startDate}`);
+    if (endDate)
+        f.push(`record_date:lte:${endDate}`);
+    return f;
+}
+/** UTC "today minus N months" as YYYY-MM-DD, for trailing-window defaults. */
+function isoMonthsAgo(months) {
+    const d = new Date();
+    d.setUTCMonth(d.getUTCMonth() - months);
+    return d.toISOString().slice(0, 10);
+}
+/**
+ * The most recent `record_date` for a dataset (memoized 5-min — slow-changing
+ * reference read). Used to pin the "latest" period for the per-date-breakdown
+ * datasets (avg_interest_rates) where a single-row page would bleed across
+ * months.
+ */
+async function latestRecordDate(path) {
+    return memoize(`treasury:latestdate:${path}`, async () => {
+        const { env } = await getTreasury(path, {
+            fields: "record_date",
+            sort: "-record_date",
+            pageSize: 1,
+            pageNumber: 1,
+        });
+        return str(env.data[0]?.record_date);
+    });
+}
+// ─── Tool: queryDataset (escape hatch, F5 enum-only) ──────────────
+/**
+ * Generic escape hatch over the 5 confirmed datasets (covers debt_outstanding +
+ * rates_of_exchange without a dedicated tool). Rows are passed through RAW
+ * (value fields as strings exactly as upstream provides) — the `_meta` note
+ * warns that the literal string "null" means "no value", never zero.
+ */
+export async function queryDataset(args) {
+    const path = TREASURY_DATASETS[args.dataset];
+    const pageSize = args.pageSize ?? 100;
+    const pageNumber = args.pageNumber ?? 1;
+    const { env, provenance } = await getTreasury(path, {
+        fields: args.fields,
+        filter: args.filter,
+        sort: args.sort,
+        pageSize,
+        pageNumber,
+    });
+    const filtersApplied = [];
+    if (args.filter)
+        filtersApplied.push("filter");
+    if (args.fields)
+        filtersApplied.push("fields");
+    return withMeta({ dataset: args.dataset, path, rows: env.data }, treasuryMeta({
+        env,
+        path,
+        pageNumber,
+        pageSize,
+        filtersApplied,
+        provenance,
+        notes: [
+            "Raw pass-through: value/amount fields are the upstream strings (or numbers) verbatim — the literal string \"null\" or an empty value means 'no value reported', NOT zero. Parse client-side.",
+        ],
+    }));
+}
+// ─── Tool: debtToPenny ────────────────────────────────────────────
+const DEBT_TO_PENNY_FIELDS = "record_date,tot_pub_debt_out_amt,debt_held_public_amt,intragov_hold_amt";
+/**
+ * Daily total US public debt ("Debt to the Penny"). `latest` (default true) ⇒
+ * the single most-recent day; else the `startDate/endDate` range, newest first.
+ * Amounts are USD, coerced via num() (null, never 0, for absent).
+ */
+export async function debtToPenny(args) {
+    const path = TREASURY_DATASETS.debt_to_penny;
+    const latest = args.latest ?? true;
+    const pageNumber = args.pageNumber ?? 1;
+    const pageSize = latest ? 1 : args.pageSize ?? 100;
+    const filter = latest
+        ? undefined
+        : dateFilters(args.startDate, args.endDate).join(",") || undefined;
+    // ★Snapshot fallback ONLY for the canned "latest" read (a single, well-defined
+    // most-recent-day snapshot the builder can pre-fetch). Range/paginated reads
+    // pass no key ⇒ live only. Even for latest, the snapshot is INERT unless
+    // SAMGOV_SNAPSHOT_BASE_URL is configured (snapshotPath returns null).
+    const snapshotKey = latest ? "treasury_debt_to_penny_latest" : undefined;
+    const { env, provenance } = await getTreasury(path, {
+        fields: DEBT_TO_PENNY_FIELDS,
+        filter,
+        sort: "-record_date",
+        pageSize,
+        pageNumber,
+    }, snapshotKey);
+    const data = {
+        records: env.data.map((r) => ({
+            recordDate: str(r.record_date),
+            totalPublicDebtOutstanding: num(r.tot_pub_debt_out_amt),
+            debtHeldByPublic: num(r.debt_held_public_amt),
+            intragovernmentalHoldings: num(r.intragov_hold_amt),
+        })),
+    };
+    const filtersApplied = [];
+    if (!latest && (args.startDate || args.endDate))
+        filtersApplied.push("recordDate");
+    return withMeta(data, treasuryMeta({
+        env,
+        path,
+        pageNumber,
+        pageSize,
+        filtersApplied,
+        provenance,
+        notes: [
+            latest
+                ? "latest=true returns only the single most-recent day (page[size]=1)."
+                : "Range mode: rows filtered by record_date, sorted newest-first.",
+            STRING_COERCION_NOTE,
+        ],
+    }));
+}
+// ─── Tool: monthlyStatement (MTS table 1) — F4 summary-row exclusion ──
+const MTS_FIELDS = "record_date,classification_desc,parent_id,line_code_nbr,current_month_gross_rcpt_amt,current_month_gross_outly_amt,current_month_dfct_sur_amt";
+/**
+ * Monthly Treasury Statement (MTS) table 1 — federal receipts, outlays, and the
+ * deficit/surplus by month. `startDate/endDate` (ISO) filter record_date;
+ * default is the trailing ~12 months.
+ *
+ * F4 — SUMMARY-ROW EXCLUSION (live-verified 2026-07-10): mts_table_1 interleaves
+ * child line-items (real amounts) with fiscal-year PARENT/SUMMARY header rows
+ * whose `parent_id` is the string "null" and whose amount fields are all the
+ * string "null". `excludeSummaryRows` (default true) appends the server-side
+ * filter `current_month_gross_outly_amt:gt:0`, which drops EXACTLY those parent
+ * rows (total-count 3039 → 2769; the 270 dropped rows == the parent_id="null"
+ * set). Because the exclusion is server-side, `total-count` (and hence
+ * `_meta.totalAvailable` / pagination) reflect the child rows only — no
+ * client-side filtering that would desync `returned` from the envelope count.
+ */
+export async function monthlyStatement(args) {
+    const path = TREASURY_DATASETS.mts_table_1;
+    const excludeSummary = args.excludeSummaryRows ?? true;
+    const pageNumber = args.pageNumber ?? 1;
+    const pageSize = args.pageSize ?? 100;
+    // Default to the trailing ~12 months when no explicit window is given.
+    const startDate = args.startDate ?? (args.endDate ? undefined : isoMonthsAgo(12));
+    const filters = dateFilters(startDate, args.endDate);
+    if (excludeSummary)
+        filters.push("current_month_gross_outly_amt:gt:0");
+    const filter = filters.length ? filters.join(",") : undefined;
+    const { env, provenance } = await getTreasury(path, {
+        fields: MTS_FIELDS,
+        filter,
+        sort: "-record_date,line_code_nbr",
+        pageSize,
+        pageNumber,
+    });
+    const data = {
+        records: env.data.map((r) => ({
+            recordDate: str(r.record_date),
+            classification: str(r.classification_desc),
+            grossReceipts: num(r.current_month_gross_rcpt_amt),
+            grossOutlays: num(r.current_month_gross_outly_amt),
+            deficitSurplus: num(r.current_month_dfct_sur_amt),
+        })),
+    };
+    const filtersApplied = [];
+    if (startDate || args.endDate)
+        filtersApplied.push("recordDate");
+    if (excludeSummary)
+        filtersApplied.push("excludeSummaryRows");
+    const notes = [
+        excludeSummary
+            ? "Summary/parent rows excluded (default): the server-side filter current_month_gross_outly_amt:gt:0 drops the fiscal-year header rows (parent_id=\"null\", all amounts \"null\"). totalAvailable reflects child line-item rows only. Pass excludeSummaryRows=false to include them."
+            : "excludeSummaryRows=false: fiscal-year parent/summary rows (parent_id=\"null\") ARE included; their amount fields are all null — do NOT read those null-amount rows as data.",
+        STRING_COERCION_NOTE,
+    ];
+    return withMeta(data, treasuryMeta({
+        env,
+        path,
+        pageNumber,
+        pageSize,
+        filtersApplied,
+        notes,
+        provenance,
+    }));
+}
+// ─── Tool: avgInterestRates ───────────────────────────────────────
+const AVG_INTEREST_FIELDS = "record_date,security_type_desc,security_desc,avg_interest_rate_amt";
+/**
+ * Average interest rate the Treasury pays by security type/description.
+ * `latest` (default true) returns the most-recent month's full breakdown across
+ * security types (pinned to the latest record_date, memoized — a slow-changing
+ * reference read); else the `startDate/endDate` range. Optional `securityType`
+ * narrows by `security_type_desc` (e.g. "Marketable", "Non-marketable").
+ * `avg_interest_rate_amt` is a PERCENT, coerced via num() (null, never 0).
+ */
+export async function avgInterestRates(args) {
+    const latest = args.latest ?? true;
+    if (latest) {
+        const key = `treasury:avg_interest_rates:latest:${args.securityType ?? "*"}`;
+        return memoize(key, () => avgInterestRatesLatest(args.securityType));
+    }
+    return avgInterestRatesQuery({
+        securityType: args.securityType,
+        startDate: args.startDate,
+        endDate: args.endDate,
+        pageSize: args.pageSize ?? 100,
+        pageNumber: args.pageNumber ?? 1,
+        latest: false,
+    });
+}
+async function avgInterestRatesLatest(securityType) {
+    const path = TREASURY_DATASETS.avg_interest_rates;
+    const maxDate = await latestRecordDate(path);
+    return avgInterestRatesQuery({
+        securityType,
+        startDate: maxDate ?? undefined,
+        endDate: maxDate ?? undefined,
+        pageSize: 100,
+        pageNumber: 1,
+        latest: true,
+        latestDate: maxDate,
+    });
+}
+async function avgInterestRatesQuery(opts) {
+    const path = TREASURY_DATASETS.avg_interest_rates;
+    const filters = dateFilters(opts.startDate, opts.endDate);
+    if (opts.securityType) {
+        filters.push(`security_type_desc:eq:${opts.securityType}`);
+    }
+    const filter = filters.length ? filters.join(",") : undefined;
+    const { env, provenance } = await getTreasury(path, {
+        fields: AVG_INTEREST_FIELDS,
+        filter,
+        sort: "-record_date,security_type_desc",
+        pageSize: opts.pageSize,
+        pageNumber: opts.pageNumber,
+    });
+    const data = {
+        records: env.data.map((r) => ({
+            recordDate: str(r.record_date),
+            securityType: str(r.security_type_desc),
+            securityDescription: str(r.security_desc),
+            avgInterestRatePercent: num(r.avg_interest_rate_amt),
+        })),
+    };
+    const filtersApplied = [];
+    if (opts.startDate || opts.endDate)
+        filtersApplied.push("recordDate");
+    if (opts.securityType)
+        filtersApplied.push("securityType");
+    const notes = [];
+    if (opts.latest) {
+        notes.push(opts.latestDate
+            ? `latest=true: pinned to the most-recent record_date (${opts.latestDate}); served from a 5-minute TTL cache.`
+            : "latest=true: could not resolve the most-recent record_date (upstream returned no rows).");
+    }
+    else {
+        notes.push("Range mode: rows filtered by record_date, sorted newest-first.");
+    }
+    notes.push(STRING_COERCION_NOTE);
+    return withMeta(data, treasuryMeta({
+        env,
+        path,
+        pageNumber: opts.pageNumber,
+        pageSize: opts.pageSize,
+        filtersApplied,
+        notes,
+        provenance,
+    }));
+}
+//# sourceMappingURL=treasury.js.map

package/dist/treasury.js.map

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