grantsignal-mcp 1.3.0 → 1.4.0

package/dist/agency-aliases.d.ts

@@ -0,0 +1,44 @@
+/**
+ * GrantSignal MCP Server — Agency Alias Resolution
+ *
+ * Comprehensive alias map for NYC, NYS, and federal agency names.
+ * Resolves acronyms, misspellings, abbreviations, and informal names
+ * to canonical forms used across GrantSignal data sources.
+ */
+export interface AgencyInfo {
+    canonical: string;
+    fullName: string;
+    checkbookName?: string;
+    code?: string;
+    searchTerms: string[];
+    level: "nyc" | "nys" | "federal";
+}
+export declare const PROGRAM_ACRONYMS: Record<string, string>;
+export interface ResolvedAgency {
+    canonical: string;
+    fullName: string;
+    checkbookName?: string;
+    code?: string;
+    searchTerms: string[];
+    level: "nyc" | "nys" | "federal";
+    resolved: boolean;
+    original: string;
+}
+/**
+ * Resolve an agency input string to its canonical form.
+ *
+ * Checks exact match first, then tries substring matching against all
+ * search terms. Falls back to the original input if no match found.
+ *
+ * @returns ResolvedAgency with `resolved: true` if input was mapped to canonical
+ */
+export declare function resolveAgency(input: string): ResolvedAgency;
+/**
+ * Get the best filter value to pass to a Supabase RPC.
+ *
+ * @param prefer - 'checkbook' returns the exact Checkbook agency_name (best for spending/budget RPCs)
+ *                 'code' returns the 3-digit agency code
+ *                 'canonical' (default) returns the acronym
+ */
+export declare function getAgencyFilterValue(resolved: ResolvedAgency, prefer?: 'checkbook' | 'code' | 'canonical' | boolean): string;
+//# sourceMappingURL=agency-aliases.d.ts.map

package/dist/agency-aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agency-aliases.d.ts","sourceRoot":"","sources":["../src/agency-aliases.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;CAClC;AA+MD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoBnD,CAAC;AA2BF,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CA+C3D;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,EACxB,MAAM,GAAE,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,OAAqB,GACjE,MAAM,CAcR"}

package/dist/agency-aliases.js

@@ -0,0 +1,324 @@
+/**
+ * GrantSignal MCP Server — Agency Alias Resolution
+ *
+ * Comprehensive alias map for NYC, NYS, and federal agency names.
+ * Resolves acronyms, misspellings, abbreviations, and informal names
+ * to canonical forms used across GrantSignal data sources.
+ */
+// ── NYC Agencies (~25) ──────────────────────────────────────
+const NYC_AGENCIES = [
+    {
+        canonical: "DFTA", fullName: "Department for the Aging", code: "125", level: "nyc",
+        searchTerms: ["dfta", "deta", "aging", "dept for the aging", "department for the aging", "senior services", "seniors", "older adults"],
+    },
+    {
+        canonical: "DYCD", fullName: "Department of Youth and Community Development", code: "260", level: "nyc",
+        searchTerms: ["dycd", "youth", "community development", "dept of youth", "department of youth and community development", "after school", "afterschool", "compass", "beacon"],
+    },
+    {
+        canonical: "DOHMH", fullName: "Department of Health and Mental Hygiene", code: "816", level: "nyc",
+        searchTerms: ["dohmh", "health", "mental hygiene", "dept of health", "department of health", "public health", "mental health"],
+    },
+    {
+        canonical: "ACS", fullName: "Administration for Children's Services", code: "068", level: "nyc",
+        searchTerms: ["acs", "children's services", "child welfare", "child services", "administration for children", "foster care", "child protective"],
+    },
+    {
+        canonical: "DHS", fullName: "Department of Homeless Services", code: "069", level: "nyc",
+        searchTerms: ["dhs", "homeless services", "dept of homeless", "department of homeless services", "shelter", "homelessness"],
+    },
+    {
+        canonical: "HRA", fullName: "Human Resources Administration", code: "071", level: "nyc",
+        searchTerms: ["hra", "dss", "human resources administration", "dept of social services", "department of social services", "social services", "welfare", "public assistance", "snap", "food stamps", "cash assistance"],
+    },
+    {
+        canonical: "DOE", fullName: "Department of Education (NYC)", checkbookName: "Department of Education", code: "040", level: "nyc",
+        searchTerms: ["doe", "doe nyc", "nyc doe", "nyc education", "nyc dept of education", "nyc department of education", "department of education", "dept of education", "public schools nyc", "board of education nyc"],
+    },
+    {
+        canonical: "NYPD", fullName: "New York City Police Department", checkbookName: "Police Department", code: "056", level: "nyc",
+        searchTerms: ["nypd", "police", "nyc police", "new york city police", "law enforcement nyc", "police department"],
+    },
+    {
+        canonical: "FDNY", fullName: "Fire Department of the City of New York", checkbookName: "Fire Department", code: "057", level: "nyc",
+        searchTerms: ["fdny", "fire department", "fire dept", "nyc fire"],
+    },
+    {
+        canonical: "HPD", fullName: "Department of Housing Preservation and Development", code: "806", level: "nyc",
+        searchTerms: ["hpd", "housing preservation", "housing development", "dept of housing", "department of housing", "affordable housing nyc", "housing nyc"],
+    },
+    {
+        canonical: "DOT", fullName: "Department of Transportation (NYC)", code: "841", level: "nyc",
+        searchTerms: ["dot nyc", "nyc dot", "nyc transportation", "dept of transportation nyc", "streets", "traffic nyc"],
+    },
+    {
+        canonical: "DPR", fullName: "Department of Parks and Recreation", code: "846", level: "nyc",
+        searchTerms: ["dpr", "parks", "parks and recreation", "dept of parks", "department of parks", "nyc parks", "recreation"],
+    },
+    {
+        canonical: "DCLA", fullName: "Department of Cultural Affairs", code: "126", level: "nyc",
+        searchTerms: ["dcla", "cultural affairs", "dept of cultural affairs", "department of cultural affairs", "arts", "culture", "cultural funding"],
+    },
+    {
+        canonical: "SBS", fullName: "Department of Small Business Services", code: "801", level: "nyc",
+        searchTerms: ["sbs", "small business", "small business services", "dept of small business", "department of small business services", "mwbe", "workforce1"],
+    },
+    {
+        canonical: "DEP", fullName: "Department of Environmental Protection", code: "826", level: "nyc",
+        searchTerms: ["dep", "environmental protection", "dept of environmental protection", "water", "sewer", "environment nyc"],
+    },
+    {
+        canonical: "DSNY", fullName: "Department of Sanitation", code: "827", level: "nyc",
+        searchTerms: ["dsny", "sanitation", "dept of sanitation", "department of sanitation", "garbage", "recycling", "waste", "cleanup"],
+    },
+    {
+        canonical: "DOB", fullName: "Department of Buildings", code: "810", level: "nyc",
+        searchTerms: ["dob", "buildings", "dept of buildings", "department of buildings", "building permits", "construction permits"],
+    },
+    {
+        canonical: "MOCJ", fullName: "Mayor's Office of Criminal Justice", code: "098", level: "nyc",
+        searchTerms: ["mocj", "criminal justice", "mayor's office of criminal justice", "public safety"],
+    },
+    {
+        canonical: "NYCHA", fullName: "New York City Housing Authority", level: "nyc",
+        searchTerms: ["nycha", "housing authority", "public housing", "section 8 nyc"],
+    },
+    {
+        canonical: "H+H", fullName: "NYC Health + Hospitals", level: "nyc",
+        searchTerms: ["h+h", "hhc", "health and hospitals", "health + hospitals", "nyc health hospitals", "public hospitals", "bellevue", "elmhurst hospital", "kings county hospital"],
+    },
+    {
+        canonical: "NYCEDC", fullName: "NYC Economic Development Corporation", level: "nyc",
+        searchTerms: ["nycedc", "edc", "economic development", "economic development corporation"],
+    },
+    {
+        canonical: "MOIA", fullName: "Mayor's Office of Immigrant Affairs", level: "nyc",
+        searchTerms: ["moia", "immigrant affairs", "immigration", "immigrant services"],
+    },
+    {
+        canonical: "MOPD", fullName: "Mayor's Office for People with Disabilities", level: "nyc",
+        searchTerms: ["mopd", "disabilities", "people with disabilities", "disability services"],
+    },
+    {
+        canonical: "DVS", fullName: "Department of Veterans' Services", level: "nyc",
+        searchTerms: ["dvs", "veterans", "veteran services", "dept of veterans"],
+    },
+    {
+        canonical: "OATH", fullName: "Office of Administrative Trials and Hearings", level: "nyc",
+        searchTerms: ["oath", "administrative trials", "hearings"],
+    },
+];
+// ── NYS Agencies (~10) ──────────────────────────────────────
+const NYS_AGENCIES = [
+    {
+        canonical: "NYSED", fullName: "New York State Education Department", level: "nys",
+        searchTerms: ["nysed", "nys education", "state education", "education department nys", "board of regents"],
+    },
+    {
+        canonical: "NYSDOH", fullName: "New York State Department of Health", level: "nys",
+        searchTerms: ["nysdoh", "nys health", "state health", "nys dept of health", "nys department of health"],
+    },
+    {
+        canonical: "OTDA", fullName: "Office of Temporary and Disability Assistance", level: "nys",
+        searchTerms: ["otda", "temporary assistance", "disability assistance", "nys welfare", "tanf nys"],
+    },
+    {
+        canonical: "OCFS", fullName: "Office of Children and Family Services", level: "nys",
+        searchTerms: ["ocfs", "children and family", "nys children", "nys family services", "child care nys"],
+    },
+    {
+        canonical: "OMH", fullName: "Office of Mental Health", level: "nys",
+        searchTerms: ["omh", "nys mental health", "state mental health", "office of mental health"],
+    },
+    {
+        canonical: "OASAS", fullName: "Office of Addiction Services and Supports", level: "nys",
+        searchTerms: ["oasas", "addiction services", "substance abuse nys", "nys addiction", "drug treatment nys"],
+    },
+    {
+        canonical: "NYSERDA", fullName: "New York State Energy Research and Development Authority", level: "nys",
+        searchTerms: ["nyserda", "energy research", "nys energy", "clean energy nys", "energy efficiency nys"],
+    },
+    {
+        canonical: "ESD", fullName: "Empire State Development", level: "nys",
+        searchTerms: ["esd", "empire state development", "nys economic development", "excelsior", "nys incentives"],
+    },
+    {
+        canonical: "DOS", fullName: "Department of State (NYS)", level: "nys",
+        searchTerms: ["nys dos", "department of state nys", "nys dept of state", "nys charities"],
+    },
+    {
+        canonical: "DEC", fullName: "Department of Environmental Conservation", level: "nys",
+        searchTerms: ["dec", "nys dec", "environmental conservation", "nys environment", "nys dept of environmental conservation"],
+    },
+];
+// ── Federal Agencies (~12) ──────────────────────────────────
+const FEDERAL_AGENCIES = [
+    {
+        canonical: "HHS", fullName: "Department of Health and Human Services", level: "federal",
+        searchTerms: ["hhs", "health and human services", "dept of health and human services", "department of health and human services"],
+    },
+    {
+        canonical: "DOE-FED", fullName: "Department of Education (Federal)", level: "federal",
+        searchTerms: ["doe federal", "federal doe", "us doe", "federal education", "ed.gov", "us department of education"],
+    },
+    {
+        canonical: "EPA", fullName: "Environmental Protection Agency", level: "federal",
+        searchTerms: ["epa", "environmental protection agency", "environment federal"],
+    },
+    {
+        canonical: "USDA", fullName: "U.S. Department of Agriculture", level: "federal",
+        searchTerms: ["usda", "agriculture", "dept of agriculture", "department of agriculture", "farm bill", "rural development"],
+    },
+    {
+        canonical: "NIH", fullName: "National Institutes of Health", level: "federal",
+        searchTerms: ["nih", "national institutes of health", "biomedical research", "medical research federal"],
+    },
+    {
+        canonical: "NSF", fullName: "National Science Foundation", level: "federal",
+        searchTerms: ["nsf", "national science foundation", "science funding", "research funding federal"],
+    },
+    {
+        canonical: "DOJ", fullName: "Department of Justice", level: "federal",
+        searchTerms: ["doj", "dept of justice", "department of justice", "justice department", "federal law enforcement", "ojp", "bja"],
+    },
+    {
+        canonical: "DOL", fullName: "Department of Labor", level: "federal",
+        searchTerms: ["dol", "dept of labor", "department of labor", "labor department", "workforce", "wioa", "employment federal"],
+    },
+    {
+        canonical: "HUD", fullName: "Department of Housing and Urban Development", level: "federal",
+        searchTerms: ["hud", "housing and urban development", "dept of housing", "department of housing and urban development", "cdbg", "section 8", "affordable housing federal"],
+    },
+    {
+        canonical: "DOT", fullName: "Department of Transportation (Federal)", level: "federal",
+        searchTerms: ["dot federal", "federal dot", "dept of transportation", "department of transportation", "fhwa", "fta", "federal transit"],
+    },
+    {
+        canonical: "FEMA", fullName: "Federal Emergency Management Agency", level: "federal",
+        searchTerms: ["fema", "emergency management", "disaster relief", "federal emergency"],
+    },
+    {
+        canonical: "SBA", fullName: "Small Business Administration", level: "federal",
+        searchTerms: ["sba", "small business administration", "small business federal"],
+    },
+];
+// ── Common Program Acronyms (reference, not agencies) ───────
+export const PROGRAM_ACRONYMS = {
+    NORC: "Naturally Occurring Retirement Community",
+    NDA: "Neighborhood Development Area",
+    COMPASS: "Comprehensive After School System of NYC",
+    SYEP: "Summer Youth Employment Program",
+    SNAP: "Supplemental Nutrition Assistance Program",
+    LIHTC: "Low-Income Housing Tax Credit",
+    CDBG: "Community Development Block Grant",
+    MWBE: "Minority and Women-owned Business Enterprise",
+    "M/WBE": "Minority and Women-owned Business Enterprise",
+    SCRIE: "Senior Citizen Rent Increase Exemption",
+    DRIE: "Disability Rent Increase Exemption",
+    ELL: "English Language Learner",
+    ARPA: "American Rescue Plan Act",
+    WIOA: "Workforce Innovation and Opportunity Act",
+    TANF: "Temporary Assistance for Needy Families",
+    SSVF: "Supportive Services for Veteran Families",
+    VASH: "Veterans Affairs Supportive Housing",
+    "CASA": "Court Appointed Special Advocates",
+    DoVE: "Domestic Violence Empowerment",
+};
+// ── Merged Agency List ──────────────────────────────────────
+const ALL_AGENCIES = [
+    ...NYC_AGENCIES,
+    ...NYS_AGENCIES,
+    ...FEDERAL_AGENCIES,
+];
+// Build lookup index: lowercase search term → AgencyInfo
+const ALIAS_INDEX = new Map();
+for (const agency of ALL_AGENCIES) {
+    // Index by canonical (lowercase)
+    ALIAS_INDEX.set(agency.canonical.toLowerCase(), agency);
+    // Index by all search terms
+    for (const term of agency.searchTerms) {
+        ALIAS_INDEX.set(term.toLowerCase(), agency);
+    }
+    // Index by code if present
+    if (agency.code) {
+        ALIAS_INDEX.set(agency.code, agency);
+    }
+}
+/**
+ * Resolve an agency input string to its canonical form.
+ *
+ * Checks exact match first, then tries substring matching against all
+ * search terms. Falls back to the original input if no match found.
+ *
+ * @returns ResolvedAgency with `resolved: true` if input was mapped to canonical
+ */
+export function resolveAgency(input) {
+    const trimmed = input.trim();
+    const lower = trimmed.toLowerCase();
+    // 1. Exact match against index
+    const exact = ALIAS_INDEX.get(lower);
+    if (exact) {
+        return {
+            ...exact,
+            resolved: exact.canonical.toLowerCase() !== lower,
+            original: trimmed,
+        };
+    }
+    // 2. Check if input is a numeric agency code
+    if (/^\d{2,3}$/.test(trimmed)) {
+        const byCode = ALIAS_INDEX.get(trimmed);
+        if (byCode) {
+            return { ...byCode, resolved: true, original: trimmed };
+        }
+    }
+    // 3. Substring match: find agencies where any search term contains the input
+    //    or the input contains any search term (for longer inputs like full names)
+    const candidates = [];
+    for (const agency of ALL_AGENCIES) {
+        for (const term of agency.searchTerms) {
+            if (term.includes(lower) || lower.includes(term)) {
+                candidates.push(agency);
+                break;
+            }
+        }
+    }
+    if (candidates.length === 1) {
+        return { ...candidates[0], resolved: true, original: trimmed };
+    }
+    // 4. No match — return unresolved (pass through to ILIKE)
+    return {
+        canonical: trimmed,
+        fullName: trimmed,
+        searchTerms: [lower],
+        level: "nyc", // default, doesn't matter for unresolved
+        resolved: false,
+        original: trimmed,
+    };
+}
+/**
+ * Get the best filter value to pass to a Supabase RPC.
+ *
+ * @param prefer - 'checkbook' returns the exact Checkbook agency_name (best for spending/budget RPCs)
+ *                 'code' returns the 3-digit agency code
+ *                 'canonical' (default) returns the acronym
+ */
+export function getAgencyFilterValue(resolved, prefer = 'canonical') {
+    // Backward compat: true = 'code', false = 'canonical'
+    if (prefer === true)
+        prefer = 'code';
+    if (prefer === false)
+        prefer = 'canonical';
+    if (prefer === 'checkbook') {
+        // Return exact Checkbook name for best matching in spending/budget RPCs
+        if (resolved.checkbookName)
+            return resolved.checkbookName;
+        // Fall back to fullName (works for most agencies where fullName matches Checkbook)
+        if (resolved.resolved && resolved.fullName)
+            return resolved.fullName;
+        return resolved.original;
+    }
+    if (prefer === 'code' && resolved.code)
+        return resolved.code;
+    return resolved.resolved ? resolved.canonical : resolved.original;
+}
+//# sourceMappingURL=agency-aliases.js.map

package/dist/agency-aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agency-aliases.js","sourceRoot":"","sources":["../src/agency-aliases.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,+DAA+D;AAE/D,MAAM,YAAY,GAAiB;IACjC;QACE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,0BAA0B,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QAClF,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,SAAS,EAAE,cAAc,CAAC;KACvI;IACD;QACE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,+CAA+C,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QACvG,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,+CAA+C,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,CAAC;KAC9K;IACD;QACE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,yCAAyC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QAClG,WAAW,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,eAAe,EAAE,eAAe,CAAC;KAC/H;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,wCAAwC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QAC/F,WAAW,EAAE,CAAC,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,aAAa,EAAE,kBAAkB,CAAC;KACjJ;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,iCAAiC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QACxF,WAAW,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iCAAiC,EAAE,SAAS,EAAE,cAAc,CAAC;KAC5H;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,gCAAgC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QACvF,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,gCAAgC,EAAE,yBAAyB,EAAE,+BAA+B,EAAE,iBAAiB,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,CAAC;KACvN;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,+BAA+B,EAAE,aAAa,EAAE,yBAAyB,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QAChI,WAAW,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,wBAAwB,CAAC;KACpN;IACD;QACE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,iCAAiC,EAAE,aAAa,EAAE,mBAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QAC7H,WAAW,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,mBAAmB,CAAC;KAClH;IACD;QACE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,yCAAyC,EAAE,aAAa,EAAE,iBAAiB,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QACnI,WAAW,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,CAAC;KAClE;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,oDAAoD,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QAC3G,WAAW,EAAE,CAAC,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,aAAa,CAAC;KACzJ;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,oCAAoC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QAC3F,WAAW,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,SAAS,EAAE,aAAa,CAAC;KAClH;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,oCAAoC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QAC3F,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,qBAAqB,EAAE,WAAW,EAAE,YAAY,CAAC;KACzH;IACD;QACE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,gCAAgC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QACxF,WAAW,EAAE,CAAC,MAAM,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,gCAAgC,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,CAAC;KAC/I;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,uCAAuC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QAC9F,WAAW,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,uCAAuC,EAAE,MAAM,EAAE,YAAY,CAAC;KAC3J;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,wCAAwC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QAC/F,WAAW,EAAE,CAAC,KAAK,EAAE,0BAA0B,EAAE,kCAAkC,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC;KAC1H;IACD;QACE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,0BAA0B,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QAClF,WAAW,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC;KAClI;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,yBAAyB,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QAChF,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,sBAAsB,CAAC;KAC9H;IACD;QACE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,oCAAoC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QAC5F,WAAW,EAAE,CAAC,MAAM,EAAE,kBAAkB,EAAE,oCAAoC,EAAE,eAAe,CAAC;KACjG;IACD;QACE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,iCAAiC,EAAE,KAAK,EAAE,KAAK;QAC7E,WAAW,EAAE,CAAC,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,CAAC;KAC/E;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,wBAAwB,EAAE,KAAK,EAAE,KAAK;QAClE,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,UAAU,EAAE,mBAAmB,EAAE,uBAAuB,CAAC;KAChL;IACD;QACE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,sCAAsC,EAAE,KAAK,EAAE,KAAK;QACnF,WAAW,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,sBAAsB,EAAE,kCAAkC,CAAC;KAC3F;IACD;QACE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,qCAAqC,EAAE,KAAK,EAAE,KAAK;QAChF,WAAW,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,aAAa,EAAE,oBAAoB,CAAC;KAChF;IACD;QACE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,6CAA6C,EAAE,KAAK,EAAE,KAAK;QACxF,WAAW,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,0BAA0B,EAAE,qBAAqB,CAAC;KACzF;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,kCAAkC,EAAE,KAAK,EAAE,KAAK;QAC5E,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,CAAC;KACzE;IACD;QACE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,8CAA8C,EAAE,KAAK,EAAE,KAAK;QACzF,WAAW,EAAE,CAAC,MAAM,EAAE,uBAAuB,EAAE,UAAU,CAAC;KAC3D;CACF,CAAC;AAEF,+DAA+D;AAE/D,MAAM,YAAY,GAAiB;IACjC;QACE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,qCAAqC,EAAE,KAAK,EAAE,KAAK;QACjF,WAAW,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,kBAAkB,CAAC;KAC3G;IACD;QACE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,qCAAqC,EAAE,KAAK,EAAE,KAAK;QAClF,WAAW,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,0BAA0B,CAAC;KACxG;IACD;QACE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,+CAA+C,EAAE,KAAK,EAAE,KAAK;QAC1F,WAAW,EAAE,CAAC,MAAM,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,aAAa,EAAE,UAAU,CAAC;KAClG;IACD;QACE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,wCAAwC,EAAE,KAAK,EAAE,KAAK;QACnF,WAAW,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,cAAc,EAAE,qBAAqB,EAAE,gBAAgB,CAAC;KACtG;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,yBAAyB,EAAE,KAAK,EAAE,KAAK;QACnE,WAAW,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,yBAAyB,CAAC;KAC5F;IACD;QACE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,2CAA2C,EAAE,KAAK,EAAE,KAAK;QACvF,WAAW,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,eAAe,EAAE,oBAAoB,CAAC;KAC3G;IACD;QACE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,0DAA0D,EAAE,KAAK,EAAE,KAAK;QACxG,WAAW,EAAE,CAAC,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,CAAC;KACvG;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,0BAA0B,EAAE,KAAK,EAAE,KAAK;QACpE,WAAW,EAAE,CAAC,KAAK,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,WAAW,EAAE,gBAAgB,CAAC;KAC5G;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,2BAA2B,EAAE,KAAK,EAAE,KAAK;QACrE,WAAW,EAAE,CAAC,SAAS,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,eAAe,CAAC;KAC1F;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,0CAA0C,EAAE,KAAK,EAAE,KAAK;QACpF,WAAW,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,wCAAwC,CAAC;KAC3H;CACF,CAAC;AAEF,+DAA+D;AAE/D,MAAM,gBAAgB,GAAiB;IACrC;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,yCAAyC,EAAE,KAAK,EAAE,SAAS;QACvF,WAAW,EAAE,CAAC,KAAK,EAAE,2BAA2B,EAAE,mCAAmC,EAAE,yCAAyC,CAAC;KAClI;IACD;QACE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,mCAAmC,EAAE,KAAK,EAAE,SAAS;QACrF,WAAW,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,mBAAmB,EAAE,QAAQ,EAAE,4BAA4B,CAAC;KACnH;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,iCAAiC,EAAE,KAAK,EAAE,SAAS;QAC/E,WAAW,EAAE,CAAC,KAAK,EAAE,iCAAiC,EAAE,qBAAqB,CAAC;KAC/E;IACD;QACE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,gCAAgC,EAAE,KAAK,EAAE,SAAS;QAC/E,WAAW,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,WAAW,EAAE,mBAAmB,CAAC;KAC3H;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,+BAA+B,EAAE,KAAK,EAAE,SAAS;QAC7E,WAAW,EAAE,CAAC,KAAK,EAAE,+BAA+B,EAAE,qBAAqB,EAAE,0BAA0B,CAAC;KACzG;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,6BAA6B,EAAE,KAAK,EAAE,SAAS;QAC3E,WAAW,EAAE,CAAC,KAAK,EAAE,6BAA6B,EAAE,iBAAiB,EAAE,0BAA0B,CAAC;KACnG;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,uBAAuB,EAAE,KAAK,EAAE,SAAS;QACrE,WAAW,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,KAAK,EAAE,KAAK,CAAC;KAChI;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,qBAAqB,EAAE,KAAK,EAAE,SAAS;QACnE,WAAW,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,EAAE,oBAAoB,CAAC;KAC5H;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,6CAA6C,EAAE,KAAK,EAAE,SAAS;QAC3F,WAAW,EAAE,CAAC,KAAK,EAAE,+BAA+B,EAAE,iBAAiB,EAAE,6CAA6C,EAAE,MAAM,EAAE,WAAW,EAAE,4BAA4B,CAAC;KAC3K;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,wCAAwC,EAAE,KAAK,EAAE,SAAS;QACtF,WAAW,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,CAAC;KACxI;IACD;QACE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,qCAAqC,EAAE,KAAK,EAAE,SAAS;QACpF,WAAW,EAAE,CAAC,MAAM,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,mBAAmB,CAAC;KACtF;IACD;QACE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,+BAA+B,EAAE,KAAK,EAAE,SAAS;QAC7E,WAAW,EAAE,CAAC,KAAK,EAAE,+BAA+B,EAAE,wBAAwB,CAAC;KAChF;CACF,CAAC;AAEF,+DAA+D;AAE/D,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,IAAI,EAAE,0CAA0C;IAChD,GAAG,EAAE,+BAA+B;IACpC,OAAO,EAAE,0CAA0C;IACnD,IAAI,EAAE,iCAAiC;IACvC,IAAI,EAAE,2CAA2C;IACjD,KAAK,EAAE,+BAA+B;IACtC,IAAI,EAAE,mCAAmC;IACzC,IAAI,EAAE,8CAA8C;IACpD,OAAO,EAAE,8CAA8C;IACvD,KAAK,EAAE,wCAAwC;IAC/C,IAAI,EAAE,oCAAoC;IAC1C,GAAG,EAAE,0BAA0B;IAC/B,IAAI,EAAE,0BAA0B;IAChC,IAAI,EAAE,0CAA0C;IAChD,IAAI,EAAE,yCAAyC;IAC/C,IAAI,EAAE,0CAA0C;IAChD,IAAI,EAAE,qCAAqC;IAC3C,MAAM,EAAE,mCAAmC;IAC3C,IAAI,EAAE,+BAA+B;CACtC,CAAC;AAEF,+DAA+D;AAE/D,MAAM,YAAY,GAAiB;IACjC,GAAG,YAAY;IACf,GAAG,YAAY;IACf,GAAG,gBAAgB;CACpB,CAAC;AAEF,yDAAyD;AACzD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAsB,CAAC;AAClD,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;IAClC,iCAAiC;IACjC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;IACxD,4BAA4B;IAC5B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACtC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,2BAA2B;IAC3B,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAeD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEpC,+BAA+B;IAC/B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO;YACL,GAAG,KAAK;YACR,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,KAAK;YACjD,QAAQ,EAAE,OAAO;SAClB,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,+EAA+E;IAC/E,MAAM,UAAU,GAAiB,EAAE,CAAC;IACpC,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjD,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACxB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACjE,CAAC;IAED,0DAA0D;IAC1D,OAAO;QACL,SAAS,EAAE,OAAO;QAClB,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,CAAC,KAAK,CAAC;QACpB,KAAK,EAAE,KAAc,EAAG,yCAAyC;QACjE,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,OAAO;KAClB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAwB,EACxB,SAAuD,WAAW;IAElE,sDAAsD;IACtD,IAAI,MAAM,KAAK,IAAI;QAAE,MAAM,GAAG,MAAM,CAAC;IACrC,IAAI,MAAM,KAAK,KAAK;QAAE,MAAM,GAAG,WAAW,CAAC;IAE3C,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,wEAAwE;QACxE,IAAI,QAAQ,CAAC,aAAa;YAAE,OAAO,QAAQ,CAAC,aAAa,CAAC;QAC1D,mFAAmF;QACnF,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ;YAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC;QACrE,OAAO,QAAQ,CAAC,QAAQ,CAAC;IAC3B,CAAC;IACD,IAAI,MAAM,KAAK,MAAM,IAAI,QAAQ,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC,IAAI,CAAC;IAC7D,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;AACpE,CAAC"}

package/dist/formatters.d.ts

@@ -0,0 +1,59 @@
+/**
+ * GrantSignal MCP Server — Output Formatting Utilities
+ *
+ * Shared helpers for consistent MCP tool output formatting.
+ * Used by all 33+ tools to standardize responses.
+ */
+/** Truncate a string to maxLen characters, appending "..." if truncated. */
+export declare function truncate(text: string | null | undefined, maxLen?: number): string;
+/** Format a number as USD currency string. Returns "" if null/undefined. */
+export declare function usd(amount: number | string | null | undefined): string;
+/** Format a number with commas. Returns "N/A" if null/undefined. */
+export declare function num(value: number | string | null | undefined): string;
+/** Safely extract YYYY-MM-DD from a date string. Returns null if invalid. */
+export declare function safeDate(dateStr: string | number | null | undefined): string | null;
+/** Safely extract 4-digit year from a date string. Returns null if invalid. */
+export declare function safeYear(dateStr: string | number | null | undefined): number | null;
+export interface McpTextResponse {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/** Build a standard success response. */
+export declare function textResponse(text: string): McpTextResponse;
+/** Build an error response (bad input, missing params, not-found for detail lookups). */
+export declare function errorResponse(message: string): McpTextResponse;
+/**
+ * Build an empty-state response (search returned 0 results).
+ * NEVER uses isError — empty results are valid, not errors.
+ */
+export declare function emptyResponse(queryEcho: string, suggestion?: string): McpTextResponse;
+/**
+ * Build a human-readable query echo from tool args.
+ * Filters out null/empty/default values and the `limit` param.
+ */
+export declare function buildQueryEcho(args: Record<string, any>): string;
+export interface MetadataOptions {
+    showing?: number;
+    total?: number;
+    source?: string;
+    filteredOut?: number;
+    filterReason?: string;
+    method?: string;
+}
+/** Build a metadata footer line for the --- separator section. */
+export declare function buildMetadata(opts: MetadataOptions): string;
+/**
+ * Build the "Explore Further" section with cross-tool suggestions.
+ * Pass null/undefined entries — they're filtered out.
+ */
+export declare function buildExploreFurther(suggestions: Array<string | null | undefined>): string;
+/**
+ * Build a note when agency input was resolved to canonical form.
+ * Returns empty string if no resolution happened.
+ */
+export declare function agencyResolvedNote(resolved: boolean, original: string, canonical: string, fullName: string): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,GAAE,MAAY,GAAG,MAAM,CAKtF;AAID,4EAA4E;AAC5E,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAKtE;AAED,oEAAoE;AACpE,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAKrE;AAID,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAInF;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAInF;AAID,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,yCAAyC;AACzC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAE1D;AAED,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAE9D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe,CAUrF;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAYhE;AAID,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAwB3D;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAIzF;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnH"}

package/dist/formatters.js

@@ -0,0 +1,140 @@
+/**
+ * GrantSignal MCP Server — Output Formatting Utilities
+ *
+ * Shared helpers for consistent MCP tool output formatting.
+ * Used by all 33+ tools to standardize responses.
+ */
+// ── Truncation ──────────────────────────────────────────────
+/** Truncate a string to maxLen characters, appending "..." if truncated. */
+export function truncate(text, maxLen = 300) {
+    if (!text)
+        return "";
+    const s = String(text);
+    if (s.length <= maxLen)
+        return s;
+    return s.substring(0, maxLen).trimEnd() + "...";
+}
+// ── Currency / Number Formatting ────────────────────────────
+/** Format a number as USD currency string. Returns "" if null/undefined. */
+export function usd(amount) {
+    if (amount == null || amount === "")
+        return "";
+    const n = typeof amount === "string" ? parseFloat(amount) : amount;
+    if (isNaN(n))
+        return "";
+    return `$${n.toLocaleString("en-US", { maximumFractionDigits: 0 })}`;
+}
+/** Format a number with commas. Returns "N/A" if null/undefined. */
+export function num(value) {
+    if (value == null || value === "")
+        return "N/A";
+    const n = typeof value === "string" ? parseFloat(value) : value;
+    if (isNaN(n))
+        return "N/A";
+    return n.toLocaleString("en-US");
+}
+// ── Safe Date Extraction ────────────────────────────────────
+/** Safely extract YYYY-MM-DD from a date string. Returns null if invalid. */
+export function safeDate(dateStr) {
+    if (!dateStr || typeof dateStr !== "string")
+        return null;
+    if (dateStr.length >= 10)
+        return dateStr.substring(0, 10);
+    return dateStr;
+}
+/** Safely extract 4-digit year from a date string. Returns null if invalid. */
+export function safeYear(dateStr) {
+    if (!dateStr || typeof dateStr !== "string" || dateStr.length < 4)
+        return null;
+    const year = parseInt(dateStr.substring(0, 4), 10);
+    return isNaN(year) ? null : year;
+}
+/** Build a standard success response. */
+export function textResponse(text) {
+    return { content: [{ type: "text", text }] };
+}
+/** Build an error response (bad input, missing params, not-found for detail lookups). */
+export function errorResponse(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+/**
+ * Build an empty-state response (search returned 0 results).
+ * NEVER uses isError — empty results are valid, not errors.
+ */
+export function emptyResponse(queryEcho, suggestion) {
+    const parts = [
+        "No results found.",
+        "",
+        `> **Search:** ${queryEcho}`,
+    ];
+    if (suggestion) {
+        parts.push("", `**Suggestion:** ${suggestion}`);
+    }
+    return textResponse(parts.join("\n"));
+}
+// ── Query Echo Builder ──────────────────────────────────────
+/**
+ * Build a human-readable query echo from tool args.
+ * Filters out null/empty/default values and the `limit` param.
+ */
+export function buildQueryEcho(args) {
+    const parts = [];
+    for (const [key, value] of Object.entries(args)) {
+        if (value == null || value === "" || value === false)
+            continue;
+        if (key === "limit" || key === "includeHistorical" || key === "includeExpired")
+            continue;
+        if (Array.isArray(value) && value.length === 0)
+            continue;
+        // Convert camelCase to readable label
+        const displayKey = key.replace(/([A-Z])/g, " $1").toLowerCase().trim();
+        const displayVal = Array.isArray(value) ? value.join(", ") : String(value);
+        parts.push(`${displayKey}: "${displayVal}"`);
+    }
+    return parts.length > 0 ? parts.join(" | ") : "(no filters)";
+}
+/** Build a metadata footer line for the --- separator section. */
+export function buildMetadata(opts) {
+    const parts = [];
+    if (opts.showing != null && opts.total != null && opts.total > opts.showing) {
+        parts.push(`Showing ${opts.showing} of ${num(opts.total)} results`);
+    }
+    else if (opts.showing != null) {
+        parts.push(`${opts.showing} result(s)`);
+    }
+    if (opts.filteredOut && opts.filteredOut > 0) {
+        parts.push(`${opts.filteredOut} ${opts.filterReason || "results"} filtered out`);
+    }
+    if (opts.source) {
+        parts.push(`Source: ${opts.source}`);
+    }
+    if (opts.method === "keyword_scored") {
+        parts.push("Scoring: keyword-based (AI unavailable)");
+    }
+    else if (opts.method === "ai_scored") {
+        parts.push("Scoring: AI-powered (Claude Haiku)");
+    }
+    return parts.join(" | ");
+}
+// ── "Explore Further" Suggestions ───────────────────────────
+/**
+ * Build the "Explore Further" section with cross-tool suggestions.
+ * Pass null/undefined entries — they're filtered out.
+ */
+export function buildExploreFurther(suggestions) {
+    const valid = suggestions.filter(Boolean);
+    if (valid.length === 0)
+        return "";
+    return "\n## Explore Further\n" + valid.map(s => `- ${s}`).join("\n");
+}
+// ── Agency Resolution Note ──────────────────────────────────
+/**
+ * Build a note when agency input was resolved to canonical form.
+ * Returns empty string if no resolution happened.
+ */
+export function agencyResolvedNote(resolved, original, canonical, fullName) {
+    if (!resolved)
+        return "";
+    return `> *Interpreted "${original}" as ${canonical} (${fullName})*\n`;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

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