data-analyst-mcp 0.0.0-stage → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +262 -3
- package/dist/adapters/_acf_tidy.d.ts +18 -0
- package/dist/adapters/_acf_tidy.js +432 -0
- package/dist/adapters/_acf_tidy.js.map +1 -0
- package/dist/adapters/_actuaries_read.d.ts +38 -0
- package/dist/adapters/_actuaries_read.js +728 -0
- package/dist/adapters/_actuaries_read.js.map +1 -0
- package/dist/adapters/_census_micro.d.ts +70 -0
- package/dist/adapters/_census_micro.js +622 -0
- package/dist/adapters/_census_micro.js.map +1 -0
- package/dist/adapters/_census_util.d.ts +40 -0
- package/dist/adapters/_census_util.js +275 -0
- package/dist/adapters/_census_util.js.map +1 -0
- package/dist/adapters/_dol_states.d.ts +6 -0
- package/dist/adapters/_dol_states.js +58 -0
- package/dist/adapters/_dol_states.js.map +1 -0
- package/dist/adapters/_govinfo_entities.d.ts +4 -0
- package/dist/adapters/_govinfo_entities.js +6 -0
- package/dist/adapters/_govinfo_entities.js.map +1 -0
- package/dist/adapters/_govinfo_json.d.ts +13 -0
- package/dist/adapters/_govinfo_json.js +107 -0
- package/dist/adapters/_govinfo_json.js.map +1 -0
- package/dist/adapters/_govinfo_py.d.ts +22 -0
- package/dist/adapters/_govinfo_py.js +272 -0
- package/dist/adapters/_govinfo_py.js.map +1 -0
- package/dist/adapters/_govinfo_xml.d.ts +22 -0
- package/dist/adapters/_govinfo_xml.js +233 -0
- package/dist/adapters/_govinfo_xml.js.map +1 -0
- package/dist/adapters/_hud_excel.d.ts +2 -0
- package/dist/adapters/_hud_excel.js +166 -0
- package/dist/adapters/_hud_excel.js.map +1 -0
- package/dist/adapters/_omb_grid.d.ts +17 -0
- package/dist/adapters/_omb_grid.js +132 -0
- package/dist/adapters/_omb_grid.js.map +1 -0
- package/dist/adapters/_omb_util.d.ts +40 -0
- package/dist/adapters/_omb_util.js +192 -0
- package/dist/adapters/_omb_util.js.map +1 -0
- package/dist/adapters/_usaspending_state.d.ts +6 -0
- package/dist/adapters/_usaspending_state.js +54 -0
- package/dist/adapters/_usaspending_state.js.map +1 -0
- package/dist/adapters/_usda-fna_book.d.ts +59 -0
- package/dist/adapters/_usda-fna_book.js +869 -0
- package/dist/adapters/_usda-fna_book.js.map +1 -0
- package/dist/adapters/_usda-fna_pdf.d.ts +20 -0
- package/dist/adapters/_usda-fna_pdf.js +361 -0
- package/dist/adapters/_usda-fna_pdf.js.map +1 -0
- package/dist/adapters/_usda-outlook_read.d.ts +70 -0
- package/dist/adapters/_usda-outlook_read.js +362 -0
- package/dist/adapters/_usda-outlook_read.js.map +1 -0
- package/dist/adapters/acf.d.ts +3 -0
- package/dist/adapters/acf.js +187 -0
- package/dist/adapters/acf.js.map +1 -0
- package/dist/adapters/actuaries.d.ts +3 -0
- package/dist/adapters/actuaries.js +293 -0
- package/dist/adapters/actuaries.js.map +1 -0
- package/dist/adapters/bts.d.ts +3 -0
- package/dist/adapters/bts.js +26 -0
- package/dist/adapters/bts.js.map +1 -0
- package/dist/adapters/census-geocoder.d.ts +10 -0
- package/dist/adapters/census-geocoder.js +47 -0
- package/dist/adapters/census-geocoder.js.map +1 -0
- package/dist/adapters/census.d.ts +17 -0
- package/dist/adapters/census.js +983 -0
- package/dist/adapters/census.js.map +1 -0
- package/dist/adapters/cfpb.d.ts +7 -0
- package/dist/adapters/cfpb.js +348 -0
- package/dist/adapters/cfpb.js.map +1 -0
- package/dist/adapters/clinical-trials.d.ts +3 -0
- package/dist/adapters/clinical-trials.js +135 -0
- package/dist/adapters/clinical-trials.js.map +1 -0
- package/dist/adapters/cms.d.ts +3 -0
- package/dist/adapters/cms.js +292 -0
- package/dist/adapters/cms.js.map +1 -0
- package/dist/adapters/college-scorecard.d.ts +3 -0
- package/dist/adapters/college-scorecard.js +122 -0
- package/dist/adapters/college-scorecard.js.map +1 -0
- package/dist/adapters/congress.d.ts +33 -0
- package/dist/adapters/congress.js +589 -0
- package/dist/adapters/congress.js.map +1 -0
- package/dist/adapters/dhs-ohss.d.ts +13 -0
- package/dist/adapters/dhs-ohss.js +598 -0
- package/dist/adapters/dhs-ohss.js.map +1 -0
- package/dist/adapters/doj-news.d.ts +7 -0
- package/dist/adapters/doj-news.js +286 -0
- package/dist/adapters/doj-news.js.map +1 -0
- package/dist/adapters/dol.d.ts +4 -0
- package/dist/adapters/dol.js +634 -0
- package/dist/adapters/dol.js.map +1 -0
- package/dist/adapters/eia.d.ts +15 -0
- package/dist/adapters/eia.js +456 -0
- package/dist/adapters/eia.js.map +1 -0
- package/dist/adapters/epa-aqs.d.ts +3 -0
- package/dist/adapters/epa-aqs.js +357 -0
- package/dist/adapters/epa-aqs.js.map +1 -0
- package/dist/adapters/epa.d.ts +3 -0
- package/dist/adapters/epa.js +298 -0
- package/dist/adapters/epa.js.map +1 -0
- package/dist/adapters/fbi.d.ts +3 -0
- package/dist/adapters/fbi.js +192 -0
- package/dist/adapters/fbi.js.map +1 -0
- package/dist/adapters/fda.d.ts +5 -0
- package/dist/adapters/fda.js +184 -0
- package/dist/adapters/fda.js.map +1 -0
- package/dist/adapters/fdic.d.ts +4 -0
- package/dist/adapters/fdic.js +95 -0
- package/dist/adapters/fdic.js.map +1 -0
- package/dist/adapters/fec.d.ts +3 -0
- package/dist/adapters/fec.js +142 -0
- package/dist/adapters/fec.js.map +1 -0
- package/dist/adapters/fed-board.d.ts +12 -0
- package/dist/adapters/fed-board.js +581 -0
- package/dist/adapters/fed-board.js.map +1 -0
- package/dist/adapters/federal-register.d.ts +11 -0
- package/dist/adapters/federal-register.js +43 -0
- package/dist/adapters/federal-register.js.map +1 -0
- package/dist/adapters/fhfa.d.ts +3 -0
- package/dist/adapters/fhfa.js +253 -0
- package/dist/adapters/fhfa.js.map +1 -0
- package/dist/adapters/fsa.d.ts +9 -0
- package/dist/adapters/fsa.js +335 -0
- package/dist/adapters/fsa.js.map +1 -0
- package/dist/adapters/govinfo.d.ts +30 -0
- package/dist/adapters/govinfo.js +636 -0
- package/dist/adapters/govinfo.js.map +1 -0
- package/dist/adapters/gsa-calc.d.ts +10 -0
- package/dist/adapters/gsa-calc.js +318 -0
- package/dist/adapters/gsa-calc.js.map +1 -0
- package/dist/adapters/hud.d.ts +3 -0
- package/dist/adapters/hud.js +200 -0
- package/dist/adapters/hud.js.map +1 -0
- package/dist/adapters/index.d.ts +3 -0
- package/dist/adapters/index.js +25 -0
- package/dist/adapters/index.js.map +1 -0
- package/dist/adapters/irs-soi.d.ts +6 -0
- package/dist/adapters/irs-soi.js +576 -0
- package/dist/adapters/irs-soi.js.map +1 -0
- package/dist/adapters/naep.d.ts +15 -0
- package/dist/adapters/naep.js +341 -0
- package/dist/adapters/naep.js.map +1 -0
- package/dist/adapters/nhtsa.d.ts +10 -0
- package/dist/adapters/nhtsa.js +239 -0
- package/dist/adapters/nhtsa.js.map +1 -0
- package/dist/adapters/nih.d.ts +5 -0
- package/dist/adapters/nih.js +196 -0
- package/dist/adapters/nih.js.map +1 -0
- package/dist/adapters/noaa.d.ts +3 -0
- package/dist/adapters/noaa.js +148 -0
- package/dist/adapters/noaa.js.map +1 -0
- package/dist/adapters/nrel.d.ts +3 -0
- package/dist/adapters/nrel.js +186 -0
- package/dist/adapters/nrel.js.map +1 -0
- package/dist/adapters/nws.d.ts +3 -0
- package/dist/adapters/nws.js +119 -0
- package/dist/adapters/nws.js.map +1 -0
- package/dist/adapters/omb.d.ts +15 -0
- package/dist/adapters/omb.js +517 -0
- package/dist/adapters/omb.js.map +1 -0
- package/dist/adapters/open-payments.d.ts +5 -0
- package/dist/adapters/open-payments.js +149 -0
- package/dist/adapters/open-payments.js.map +1 -0
- package/dist/adapters/pbgc.d.ts +13 -0
- package/dist/adapters/pbgc.js +283 -0
- package/dist/adapters/pbgc.js.map +1 -0
- package/dist/adapters/philfed.d.ts +12 -0
- package/dist/adapters/philfed.js +59 -0
- package/dist/adapters/philfed.js.map +1 -0
- package/dist/adapters/regulations.d.ts +6 -0
- package/dist/adapters/regulations.js +58 -0
- package/dist/adapters/regulations.js.map +1 -0
- package/dist/adapters/sec.d.ts +13 -0
- package/dist/adapters/sec.js +504 -0
- package/dist/adapters/sec.js.map +1 -0
- package/dist/adapters/senate-lobbying.d.ts +3 -0
- package/dist/adapters/senate-lobbying.js +181 -0
- package/dist/adapters/senate-lobbying.js.map +1 -0
- package/dist/adapters/snapqc.d.ts +32 -0
- package/dist/adapters/snapqc.js +701 -0
- package/dist/adapters/snapqc.js.map +1 -0
- package/dist/adapters/treasury-yields.d.ts +3 -0
- package/dist/adapters/treasury-yields.js +170 -0
- package/dist/adapters/treasury-yields.js.map +1 -0
- package/dist/adapters/usaspending.d.ts +3 -0
- package/dist/adapters/usaspending.js +340 -0
- package/dist/adapters/usaspending.js.map +1 -0
- package/dist/adapters/usda-fna.d.ts +7 -0
- package/dist/adapters/usda-fna.js +707 -0
- package/dist/adapters/usda-fna.js.map +1 -0
- package/dist/adapters/usda-fooddata.d.ts +3 -0
- package/dist/adapters/usda-fooddata.js +101 -0
- package/dist/adapters/usda-fooddata.js.map +1 -0
- package/dist/adapters/usda-nass.d.ts +3 -0
- package/dist/adapters/usda-nass.js +108 -0
- package/dist/adapters/usda-nass.js.map +1 -0
- package/dist/adapters/usda-outlook.d.ts +12 -0
- package/dist/adapters/usda-outlook.js +696 -0
- package/dist/adapters/usda-outlook.js.map +1 -0
- package/dist/adapters/usgs.d.ts +9 -0
- package/dist/adapters/usgs.js +265 -0
- package/dist/adapters/usgs.js.map +1 -0
- package/dist/adapters/usitc.d.ts +18 -0
- package/dist/adapters/usitc.js +170 -0
- package/dist/adapters/usitc.js.map +1 -0
- package/dist/adapters/uspto.d.ts +3 -0
- package/dist/adapters/uspto.js +47 -0
- package/dist/adapters/uspto.js.map +1 -0
- package/dist/adapters/world-bank.d.ts +3 -0
- package/dist/adapters/world-bank.js +163 -0
- package/dist/adapters/world-bank.js.map +1 -0
- package/dist/analysis/cite.d.ts +31 -0
- package/dist/analysis/cite.js +229 -0
- package/dist/analysis/cite.js.map +1 -0
- package/dist/analysis/combine.d.ts +27 -0
- package/dist/analysis/combine.js +198 -0
- package/dist/analysis/combine.js.map +1 -0
- package/dist/analysis/compute.d.ts +62 -0
- package/dist/analysis/compute.js +583 -0
- package/dist/analysis/compute.js.map +1 -0
- package/dist/analysis/expr.d.ts +69 -0
- package/dist/analysis/expr.js +780 -0
- package/dist/analysis/expr.js.map +1 -0
- package/dist/analysis/factfmt.d.ts +16 -0
- package/dist/analysis/factfmt.js +187 -0
- package/dist/analysis/factfmt.js.map +1 -0
- package/dist/analysis/facts.d.ts +63 -0
- package/dist/analysis/facts.js +355 -0
- package/dist/analysis/facts.js.map +1 -0
- package/dist/analysis/handoff.d.ts +58 -0
- package/dist/analysis/handoff.js +208 -0
- package/dist/analysis/handoff.js.map +1 -0
- package/dist/analysis/pyfmt.d.ts +16 -0
- package/dist/analysis/pyfmt.js +156 -0
- package/dist/analysis/pyfmt.js.map +1 -0
- package/dist/analysis/rerun.d.ts +13 -0
- package/dist/analysis/rerun.js +125 -0
- package/dist/analysis/rerun.js.map +1 -0
- package/dist/analysis/table.d.ts +18 -0
- package/dist/analysis/table.js +109 -0
- package/dist/analysis/table.js.map +1 -0
- package/dist/analysis/tools.d.ts +67 -0
- package/dist/analysis/tools.js +217 -0
- package/dist/analysis/tools.js.map +1 -0
- package/dist/analysis/write_table.d.ts +13 -0
- package/dist/analysis/write_table.js +59 -0
- package/dist/analysis/write_table.js.map +1 -0
- package/dist/bin/cli.d.ts +10 -0
- package/dist/bin/cli.js +177 -0
- package/dist/bin/cli.js.map +1 -0
- package/dist/core/cache.d.ts +14 -0
- package/dist/core/cache.js +90 -0
- package/dist/core/cache.js.map +1 -0
- package/dist/core/context.d.ts +12 -0
- package/dist/core/context.js +15 -0
- package/dist/core/context.js.map +1 -0
- package/dist/core/env.d.ts +14 -0
- package/dist/core/env.js +52 -0
- package/dist/core/env.js.map +1 -0
- package/dist/core/generic-rest.d.ts +61 -0
- package/dist/core/generic-rest.js +639 -0
- package/dist/core/generic-rest.js.map +1 -0
- package/dist/core/http.d.ts +120 -0
- package/dist/core/http.js +514 -0
- package/dist/core/http.js.map +1 -0
- package/dist/core/keys.d.ts +43 -0
- package/dist/core/keys.js +174 -0
- package/dist/core/keys.js.map +1 -0
- package/dist/core/manual.d.ts +41 -0
- package/dist/core/manual.js +218 -0
- package/dist/core/manual.js.map +1 -0
- package/dist/core/package.d.ts +58 -0
- package/dist/core/package.js +228 -0
- package/dist/core/package.js.map +1 -0
- package/dist/core/packs.d.ts +139 -0
- package/dist/core/packs.js +173 -0
- package/dist/core/packs.js.map +1 -0
- package/dist/core/policy.d.ts +69 -0
- package/dist/core/policy.js +189 -0
- package/dist/core/policy.js.map +1 -0
- package/dist/core/py.d.ts +40 -0
- package/dist/core/py.js +171 -0
- package/dist/core/py.js.map +1 -0
- package/dist/core/routing.d.ts +10 -0
- package/dist/core/routing.js +39 -0
- package/dist/core/routing.js.map +1 -0
- package/dist/core/tabular.d.ts +21 -0
- package/dist/core/tabular.js +229 -0
- package/dist/core/tabular.js.map +1 -0
- package/dist/deep/_bea_api.d.ts +102 -0
- package/dist/deep/_bea_api.js +457 -0
- package/dist/deep/_bea_api.js.map +1 -0
- package/dist/deep/_bea_fetch.d.ts +151 -0
- package/dist/deep/_bea_fetch.js +1274 -0
- package/dist/deep/_bea_fetch.js.map +1 -0
- package/dist/deep/_bea_util.d.ts +14 -0
- package/dist/deep/_bea_util.js +156 -0
- package/dist/deep/_bea_util.js.map +1 -0
- package/dist/deep/_bls_api.d.ts +84 -0
- package/dist/deep/_bls_api.js +231 -0
- package/dist/deep/_bls_api.js.map +1 -0
- package/dist/deep/_bls_ids.d.ts +43 -0
- package/dist/deep/_bls_ids.js +188 -0
- package/dist/deep/_bls_ids.js.map +1 -0
- package/dist/deep/_bls_lib.d.ts +61 -0
- package/dist/deep/_bls_lib.js +442 -0
- package/dist/deep/_bls_lib.js.map +1 -0
- package/dist/deep/_fred_api.d.ts +148 -0
- package/dist/deep/_fred_api.js +545 -0
- package/dist/deep/_fred_api.js.map +1 -0
- package/dist/deep/_fred_pack.d.ts +162 -0
- package/dist/deep/_fred_pack.js +1027 -0
- package/dist/deep/_fred_pack.js.map +1 -0
- package/dist/deep/_fred_py.d.ts +40 -0
- package/dist/deep/_fred_py.js +199 -0
- package/dist/deep/_fred_py.js.map +1 -0
- package/dist/deep/_ipums_bundle.d.ts +29 -0
- package/dist/deep/_ipums_bundle.js +194 -0
- package/dist/deep/_ipums_bundle.js.map +1 -0
- package/dist/deep/_ipums_ddi.d.ts +23 -0
- package/dist/deep/_ipums_ddi.js +162 -0
- package/dist/deep/_ipums_ddi.js.map +1 -0
- package/dist/deep/_opm_io.d.ts +26 -0
- package/dist/deep/_opm_io.js +383 -0
- package/dist/deep/_opm_io.js.map +1 -0
- package/dist/deep/_opm_parquet.d.ts +31 -0
- package/dist/deep/_opm_parquet.js +744 -0
- package/dist/deep/_opm_parquet.js.map +1 -0
- package/dist/deep/_opm_py.d.ts +6 -0
- package/dist/deep/_opm_py.js +74 -0
- package/dist/deep/_opm_py.js.map +1 -0
- package/dist/deep/_treasury_api.d.ts +48 -0
- package/dist/deep/_treasury_api.js +221 -0
- package/dist/deep/_treasury_api.js.map +1 -0
- package/dist/deep/_treasury_context.d.ts +34 -0
- package/dist/deep/_treasury_context.js +142 -0
- package/dist/deep/_treasury_context.js.map +1 -0
- package/dist/deep/_treasury_lib.d.ts +109 -0
- package/dist/deep/_treasury_lib.js +686 -0
- package/dist/deep/_treasury_lib.js.map +1 -0
- package/dist/deep/bea.d.ts +3 -0
- package/dist/deep/bea.js +248 -0
- package/dist/deep/bea.js.map +1 -0
- package/dist/deep/bls.d.ts +3 -0
- package/dist/deep/bls.js +220 -0
- package/dist/deep/bls.js.map +1 -0
- package/dist/deep/fred.d.ts +3 -0
- package/dist/deep/fred.js +325 -0
- package/dist/deep/fred.js.map +1 -0
- package/dist/deep/ipums.d.ts +59 -0
- package/dist/deep/ipums.js +744 -0
- package/dist/deep/ipums.js.map +1 -0
- package/dist/deep/opm.d.ts +56 -0
- package/dist/deep/opm.js +1033 -0
- package/dist/deep/opm.js.map +1 -0
- package/dist/deep/treasury.d.ts +3 -0
- package/dist/deep/treasury.js +218 -0
- package/dist/deep/treasury.js.map +1 -0
- package/dist/envelope.d.ts +47 -0
- package/dist/envelope.js +88 -0
- package/dist/envelope.js.map +1 -0
- package/dist/index.d.ts +277 -0
- package/dist/index.js +106 -0
- package/dist/index.js.map +1 -0
- package/dist/remote/app.d.ts +21 -0
- package/dist/remote/app.js +218 -0
- package/dist/remote/app.js.map +1 -0
- package/dist/remote/oauth.d.ts +14 -0
- package/dist/remote/oauth.js +90 -0
- package/dist/remote/oauth.js.map +1 -0
- package/dist/remote/pages.d.ts +8 -0
- package/dist/remote/pages.js +56 -0
- package/dist/remote/pages.js.map +1 -0
- package/dist/remote/sign.d.ts +4 -0
- package/dist/remote/sign.js +40 -0
- package/dist/remote/sign.js.map +1 -0
- package/dist/remote/store.d.ts +31 -0
- package/dist/remote/store.js +129 -0
- package/dist/remote/store.js.map +1 -0
- package/dist/report/audit_answer.d.ts +94 -0
- package/dist/report/audit_answer.js +1349 -0
- package/dist/report/audit_answer.js.map +1 -0
- package/dist/report/audit_report.d.ts +23 -0
- package/dist/report/audit_report.js +637 -0
- package/dist/report/audit_report.js.map +1 -0
- package/dist/report/build_report.d.ts +27 -0
- package/dist/report/build_report.js +1168 -0
- package/dist/report/build_report.js.map +1 -0
- package/dist/report/method_audit.d.ts +47 -0
- package/dist/report/method_audit.js +710 -0
- package/dist/report/method_audit.js.map +1 -0
- package/dist/report/policyset.d.ts +50 -0
- package/dist/report/policyset.js +421 -0
- package/dist/report/policyset.js.map +1 -0
- package/dist/report/py.d.ts +58 -0
- package/dist/report/py.js +311 -0
- package/dist/report/py.js.map +1 -0
- package/dist/report/scan_secrets.d.ts +21 -0
- package/dist/report/scan_secrets.js +234 -0
- package/dist/report/scan_secrets.js.map +1 -0
- package/dist/report/style_check.d.ts +29 -0
- package/dist/report/style_check.js +173 -0
- package/dist/report/style_check.js.map +1 -0
- package/dist/report/tools.d.ts +87 -0
- package/dist/report/tools.js +167 -0
- package/dist/report/tools.js.map +1 -0
- package/dist/server.d.ts +5 -0
- package/dist/server.js +246 -0
- package/dist/server.js.map +1 -0
- package/dist/session.d.ts +47 -0
- package/dist/session.js +107 -0
- package/dist/session.js.map +1 -0
- package/dist/toolkit.d.ts +21 -0
- package/dist/toolkit.js +2 -0
- package/dist/toolkit.js.map +1 -0
- package/dist/tools.d.ts +299 -0
- package/dist/tools.js +491 -0
- package/dist/tools.js.map +1 -0
- package/guide/WORKFLOW.md +134 -0
- package/guide/assets/disclaimer.txt +1 -0
- package/guide/assets/download_data.ps1 +162 -0
- package/guide/assets/download_data.sh +143 -0
- package/guide/assets/report_template.html +597 -0
- package/guide/references/report_patterns.md +199 -0
- package/guide/references/routing.md +171 -0
- package/guide/references/style_guide.md +398 -0
- package/package.json +56 -6
- package/packs/acf/endpoints.json +114 -0
- package/packs/acf/policy.json +104 -0
- package/packs/acf/source.md +138 -0
- package/packs/actuaries/endpoints.json +82 -0
- package/packs/actuaries/policy.json +109 -0
- package/packs/actuaries/source.md +137 -0
- package/packs/bea/assets/download_bea.ps1 +182 -0
- package/packs/bea/assets/download_bea.sh +144 -0
- package/packs/bea/docs/bea_api.md +461 -0
- package/packs/bea/docs/datasets.md +157 -0
- package/packs/bea/docs/report_patterns.md +112 -0
- package/packs/bea/policy.json +170 -0
- package/packs/bea/source.md +152 -0
- package/packs/bls/assets/download_bls.ps1 +152 -0
- package/packs/bls/assets/download_bls.sh +167 -0
- package/packs/bls/docs/analysis_patterns.md +108 -0
- package/packs/bls/docs/bls_api.md +73 -0
- package/packs/bls/docs/series_ids.md +149 -0
- package/packs/bls/policy.json +238 -0
- package/packs/bls/series_ids.json +1375 -0
- package/packs/bls/source.md +156 -0
- package/packs/bts/endpoints.json +347 -0
- package/packs/bts/policy.json +94 -0
- package/packs/bts/source.md +97 -0
- package/packs/cdc/endpoints.json +197 -0
- package/packs/cdc/policy.json +83 -0
- package/packs/cdc/source.md +74 -0
- package/packs/census/endpoints.json +99 -0
- package/packs/census/policy.json +238 -0
- package/packs/census/source.md +304 -0
- package/packs/census-geocoder/endpoints.json +70 -0
- package/packs/census-geocoder/policy.json +80 -0
- package/packs/census-geocoder/source.md +53 -0
- package/packs/cfpb/endpoints.json +327 -0
- package/packs/cfpb/policy.json +119 -0
- package/packs/cfpb/source.md +96 -0
- package/packs/clinical-trials/endpoints.json +167 -0
- package/packs/clinical-trials/policy.json +84 -0
- package/packs/clinical-trials/source.md +82 -0
- package/packs/cms/endpoints.json +69 -0
- package/packs/cms/policy.json +96 -0
- package/packs/cms/source.md +112 -0
- package/packs/college-scorecard/endpoints.json +253 -0
- package/packs/college-scorecard/policy.json +106 -0
- package/packs/college-scorecard/source.md +92 -0
- package/packs/congress/endpoints.json +1701 -0
- package/packs/congress/policy.json +117 -0
- package/packs/congress/source.md +190 -0
- package/packs/dhs-ohss/endpoints.json +66 -0
- package/packs/dhs-ohss/policy.json +107 -0
- package/packs/dhs-ohss/source.md +120 -0
- package/packs/doj-news/endpoints.json +59 -0
- package/packs/doj-news/policy.json +96 -0
- package/packs/doj-news/source.md +99 -0
- package/packs/dol/endpoints.json +818 -0
- package/packs/dol/policy.json +135 -0
- package/packs/dol/source.md +181 -0
- package/packs/eia/endpoints.json +718 -0
- package/packs/eia/policy.json +112 -0
- package/packs/eia/source.md +112 -0
- package/packs/epa/endpoints.json +292 -0
- package/packs/epa/policy.json +99 -0
- package/packs/epa/source.md +99 -0
- package/packs/epa-aqs/endpoints.json +174 -0
- package/packs/epa-aqs/policy.json +96 -0
- package/packs/epa-aqs/source.md +97 -0
- package/packs/fbi/endpoints.json +1842 -0
- package/packs/fbi/policy.json +118 -0
- package/packs/fbi/source.md +108 -0
- package/packs/fda/endpoints.json +238 -0
- package/packs/fda/policy.json +121 -0
- package/packs/fda/source.md +117 -0
- package/packs/fdic/endpoints.json +417 -0
- package/packs/fdic/policy.json +83 -0
- package/packs/fdic/source.md +92 -0
- package/packs/fec/endpoints.json +708 -0
- package/packs/fec/policy.json +93 -0
- package/packs/fec/source.md +90 -0
- package/packs/fed-board/endpoints.json +89 -0
- package/packs/fed-board/policy.json +136 -0
- package/packs/fed-board/source.md +118 -0
- package/packs/federal-register/endpoints.json +143 -0
- package/packs/federal-register/policy.json +86 -0
- package/packs/federal-register/source.md +98 -0
- package/packs/fema/endpoints.json +646 -0
- package/packs/fema/policy.json +103 -0
- package/packs/fema/source.md +103 -0
- package/packs/fhfa/endpoints.json +105 -0
- package/packs/fhfa/policy.json +109 -0
- package/packs/fhfa/source.md +108 -0
- package/packs/fred/assets/download_fred.ps1 +122 -0
- package/packs/fred/assets/download_fred.sh +123 -0
- package/packs/fred/docs/analysis_patterns.md +124 -0
- package/packs/fred/docs/fred_api.md +94 -0
- package/packs/fred/docs/series.md +188 -0
- package/packs/fred/policy.json +253 -0
- package/packs/fred/source.md +142 -0
- package/packs/fsa/endpoints.json +150 -0
- package/packs/fsa/policy.json +99 -0
- package/packs/fsa/source.md +102 -0
- package/packs/govinfo/endpoints.json +520 -0
- package/packs/govinfo/policy.json +116 -0
- package/packs/govinfo/source.md +241 -0
- package/packs/gsa-calc/endpoints.json +93 -0
- package/packs/gsa-calc/policy.json +97 -0
- package/packs/gsa-calc/source.md +108 -0
- package/packs/hud/endpoints.json +147 -0
- package/packs/hud/policy.json +84 -0
- package/packs/hud/source.md +97 -0
- package/packs/ipums/assets/download_ipums.ps1 +215 -0
- package/packs/ipums/assets/download_ipums.sh +192 -0
- package/packs/ipums/docs/ipums_api.md +67 -0
- package/packs/ipums/docs/report_patterns.md +117 -0
- package/packs/ipums/docs/variables.md +284 -0
- package/packs/ipums/lib/fetch_text.json +112 -0
- package/packs/ipums/policy.json +215 -0
- package/packs/ipums/source.md +169 -0
- package/packs/irs-soi/endpoints.json +114 -0
- package/packs/irs-soi/policy.json +107 -0
- package/packs/irs-soi/source.md +124 -0
- package/packs/medicaid/endpoints.json +412 -0
- package/packs/medicaid/policy.json +108 -0
- package/packs/medicaid/source.md +136 -0
- package/packs/naep/endpoints.json +217 -0
- package/packs/naep/policy.json +100 -0
- package/packs/naep/source.md +120 -0
- package/packs/nhtsa/endpoints.json +132 -0
- package/packs/nhtsa/policy.json +93 -0
- package/packs/nhtsa/source.md +109 -0
- package/packs/nih/endpoints.json +453 -0
- package/packs/nih/policy.json +86 -0
- package/packs/nih/source.md +108 -0
- package/packs/noaa/endpoints.json +432 -0
- package/packs/noaa/policy.json +95 -0
- package/packs/noaa/source.md +88 -0
- package/packs/nrel/endpoints.json +328 -0
- package/packs/nrel/policy.json +96 -0
- package/packs/nrel/source.md +91 -0
- package/packs/nws/endpoints.json +272 -0
- package/packs/nws/policy.json +82 -0
- package/packs/nws/source.md +81 -0
- package/packs/nyfed/endpoints.json +80 -0
- package/packs/nyfed/policy.json +92 -0
- package/packs/nyfed/source.md +89 -0
- package/packs/omb/endpoints.json +460 -0
- package/packs/omb/policy.json +106 -0
- package/packs/omb/source.md +130 -0
- package/packs/open-payments/endpoints.json +298 -0
- package/packs/open-payments/policy.json +101 -0
- package/packs/open-payments/source.md +99 -0
- package/packs/opm/assets/download_opm.ps1 +125 -0
- package/packs/opm/assets/download_opm.sh +85 -0
- package/packs/opm/docs/fields.md +184 -0
- package/packs/opm/docs/opm_api.md +71 -0
- package/packs/opm/docs/report_patterns.md +83 -0
- package/packs/opm/lib/data_dictionary.csv +73 -0
- package/packs/opm/policy.json +142 -0
- package/packs/opm/source.md +137 -0
- package/packs/pbgc/endpoints.json +483 -0
- package/packs/pbgc/policy.json +94 -0
- package/packs/pbgc/source.md +95 -0
- package/packs/philfed/endpoints.json +85 -0
- package/packs/philfed/policy.json +94 -0
- package/packs/philfed/source.md +125 -0
- package/packs/port.json +287 -0
- package/packs/regulations/endpoints.json +288 -0
- package/packs/regulations/policy.json +86 -0
- package/packs/regulations/source.md +84 -0
- package/packs/sec/endpoints.json +237 -0
- package/packs/sec/policy.json +86 -0
- package/packs/sec/source.md +101 -0
- package/packs/senate-lobbying/endpoints.json +554 -0
- package/packs/senate-lobbying/policy.json +99 -0
- package/packs/senate-lobbying/source.md +100 -0
- package/packs/snapqc/endpoints.json +1426 -0
- package/packs/snapqc/policy.json +92 -0
- package/packs/snapqc/source.md +96 -0
- package/packs/treasury/catalog.json +2267 -0
- package/packs/treasury/docs/api_guide.md +245 -0
- package/packs/treasury/docs/datasets.md +56 -0
- package/packs/treasury/docs/report_patterns.md +126 -0
- package/packs/treasury/policy.json +159 -0
- package/packs/treasury/source.md +165 -0
- package/packs/treasury-yields/endpoints.json +226 -0
- package/packs/treasury-yields/policy.json +86 -0
- package/packs/treasury-yields/source.md +80 -0
- package/packs/usaspending/endpoints.json +1316 -0
- package/packs/usaspending/policy.json +109 -0
- package/packs/usaspending/source.md +103 -0
- package/packs/usda-fna/endpoints.json +427 -0
- package/packs/usda-fna/policy.json +133 -0
- package/packs/usda-fna/source.md +217 -0
- package/packs/usda-fooddata/endpoints.json +181 -0
- package/packs/usda-fooddata/policy.json +94 -0
- package/packs/usda-fooddata/source.md +105 -0
- package/packs/usda-nass/endpoints.json +324 -0
- package/packs/usda-nass/policy.json +95 -0
- package/packs/usda-nass/source.md +85 -0
- package/packs/usda-outlook/endpoints.json +86 -0
- package/packs/usda-outlook/policy.json +109 -0
- package/packs/usda-outlook/source.md +144 -0
- package/packs/usgs/endpoints.json +313 -0
- package/packs/usgs/policy.json +95 -0
- package/packs/usgs/source.md +96 -0
- package/packs/usitc/endpoints.json +74 -0
- package/packs/usitc/policy.json +111 -0
- package/packs/usitc/source.md +90 -0
- package/packs/uspto/endpoints.json +141 -0
- package/packs/uspto/policy.json +95 -0
- package/packs/uspto/source.md +101 -0
- package/packs/va/endpoints.json +414 -0
- package/packs/va/policy.json +101 -0
- package/packs/va/source.md +129 -0
- package/packs/world-bank/endpoints.json +122 -0
- package/packs/world-bank/policy.json +101 -0
- package/packs/world-bank/source.md +93 -0
package/dist/server.js
ADDED
|
@@ -0,0 +1,246 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The MCP server: instructions, tools, the `analyze` prompt and the source/guide resources.
|
|
3
|
+
* Transport-free: bin/cli.ts connects it over stdio; http.ts (remote mode) over streamable HTTP.
|
|
4
|
+
*/
|
|
5
|
+
import fs from "node:fs";
|
|
6
|
+
import path from "node:path";
|
|
7
|
+
import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
8
|
+
import { z } from "zod";
|
|
9
|
+
import { GUIDE_DIR, PACKS_DIR } from "./core/env.js";
|
|
10
|
+
import { redact, withKeyProvider, withPackScope } from "./core/keys.js";
|
|
11
|
+
import { packIds } from "./core/packs.js";
|
|
12
|
+
import { toFailure } from "./envelope.js";
|
|
13
|
+
import { Session } from "./session.js";
|
|
14
|
+
import * as T from "./tools.js";
|
|
15
|
+
import { TOOLS as ANALYSIS_TOOLS } from "./analysis/tools.js";
|
|
16
|
+
import { TOOLS as REPORT_TOOLS } from "./report/tools.js";
|
|
17
|
+
export const VERSION = "0.3.0";
|
|
18
|
+
export const INSTRUCTIONS = `Live U.S. government data, fetched from the agency at call time; every result is cited.
|
|
19
|
+
Never answer a U.S. government data question from memory, and never estimate, simulate or "illustrate" a number:
|
|
20
|
+
if no source can answer, say so.
|
|
21
|
+
|
|
22
|
+
Workflow: find_sources(question) -> source_brief(id) -> ask the user -> record_decisions -> request_schema(id,
|
|
23
|
+
names) -> fetch(id, spec) -> compute -> facts -> audit_answer (send only after AUDIT PASSED). guide() has the
|
|
24
|
+
full method (framing, literature, accuracy checklist, combining sources, the answer, reports). When a question
|
|
25
|
+
spans agencies, source_brief's paired_with names the usual cross-checks: fetch both and compare.
|
|
26
|
+
|
|
27
|
+
Ask before you fetch. source_brief returns questions_to_ask: the choices that change a headline number. Ask
|
|
28
|
+
the ones the request leaves open in ONE round (at most 4 questions, each with exactly one "Don't know — decide
|
|
29
|
+
for me" option, your recommended option first), with your question tool when you have one. A blocking question
|
|
30
|
+
(what the user means: which program, place, population) that is skipped is asked once more. Record every
|
|
31
|
+
question with record_decisions; fetch refuses until they are settled (gate_blocked says what is missing).
|
|
32
|
+
|
|
33
|
+
Errors carry a code and a fix: follow the fix, never repeat a call unchanged, never present a failure as data.
|
|
34
|
+
Keys are never asked for in chat: key_missing gives the user a command or page to store a key themselves.
|
|
35
|
+
|
|
36
|
+
Citations: cite page_url and the citation text with its retrieval date; copy every notice word for word.
|
|
37
|
+
Read the playbook's traps before interpreting a number; surface revisions, preliminary values, sampling error
|
|
38
|
+
and definition changes unprompted.`;
|
|
39
|
+
/**
|
|
40
|
+
* Remote mode: workspace paths become relative paths, with a signed download URL each in `links`; a key error
|
|
41
|
+
* carries the user's keys page; a manual bundle carries the upload page.
|
|
42
|
+
*/
|
|
43
|
+
function remoteView(s, out) {
|
|
44
|
+
if (!s.linker || !out || typeof out !== "object")
|
|
45
|
+
return out;
|
|
46
|
+
const links = {};
|
|
47
|
+
const ws = s.workspace;
|
|
48
|
+
const walk = (v) => {
|
|
49
|
+
if (typeof v === "string" && v.startsWith(ws)) {
|
|
50
|
+
const rel = path.relative(ws, v).replaceAll("\\", "/");
|
|
51
|
+
if (fs.existsSync(v) && fs.statSync(v).isFile())
|
|
52
|
+
links[rel] = s.linker(v);
|
|
53
|
+
return rel;
|
|
54
|
+
}
|
|
55
|
+
if (Array.isArray(v))
|
|
56
|
+
return v.map(walk);
|
|
57
|
+
if (v && typeof v === "object")
|
|
58
|
+
return Object.fromEntries(Object.entries(v).map(([k, x]) => [k, walk(x)]));
|
|
59
|
+
return v;
|
|
60
|
+
};
|
|
61
|
+
const view = walk(out);
|
|
62
|
+
if (Object.keys(links).length) {
|
|
63
|
+
view.links = links;
|
|
64
|
+
view.links_note = "Give the user these links to download the files (each works for 24 hours, while this session lasts).";
|
|
65
|
+
}
|
|
66
|
+
if (view.status === "error" && (view.code === "key_missing" || view.code === "key_rejected")) {
|
|
67
|
+
view.keys_url = s.keysUrl;
|
|
68
|
+
view.fix = s.keysUrl
|
|
69
|
+
? `Give the user this link to store their own key (it opens a page on this server; never ask for the key in chat): ${s.keysUrl} . Then call the tool again.`
|
|
70
|
+
: "This server keeps only its operator's keys and has none for this source. Use a keyless source, or manual_bundle " +
|
|
71
|
+
"(the user downloads with their own key on their computer, then uploads).";
|
|
72
|
+
}
|
|
73
|
+
if (view.bundle && s.uploadUrl) {
|
|
74
|
+
view.upload_page = s.uploadUrl;
|
|
75
|
+
view.next = "Give the user the links to INSTRUCTIONS.md and the download script for their system, and the upload page. " +
|
|
76
|
+
"When they say the files are uploaded, call ingest with files: [\"uploads\"].";
|
|
77
|
+
}
|
|
78
|
+
return view;
|
|
79
|
+
}
|
|
80
|
+
function wrap(s, fn) {
|
|
81
|
+
return async (a) => {
|
|
82
|
+
const call = async () => {
|
|
83
|
+
let out;
|
|
84
|
+
let isError = false;
|
|
85
|
+
try {
|
|
86
|
+
out = s.keyProvider ? await withKeyProvider(s.keyProvider, () => fn(s, a)) : await fn(s, a);
|
|
87
|
+
}
|
|
88
|
+
catch (e) {
|
|
89
|
+
out = toFailure(e);
|
|
90
|
+
isError = true;
|
|
91
|
+
}
|
|
92
|
+
// redacted inside the pack scope too, so that pack's own patterns apply to its result text
|
|
93
|
+
return { content: [{ type: "text", text: redact(JSON.stringify(remoteView(s, out), null, 1)) }], isError };
|
|
94
|
+
};
|
|
95
|
+
// a pack's own redaction patterns (keys its API echoes) apply only inside calls for that pack
|
|
96
|
+
const pack = typeof a?.source === "string" ? a.source : "";
|
|
97
|
+
const r = pack ? await withPackScope(pack, call) : await call();
|
|
98
|
+
s.lastSeen = Date.now();
|
|
99
|
+
return r;
|
|
100
|
+
};
|
|
101
|
+
}
|
|
102
|
+
const READ = { readOnlyHint: true, openWorldHint: false };
|
|
103
|
+
const NET = { readOnlyHint: true, openWorldHint: true };
|
|
104
|
+
const questionSchema = z.object({
|
|
105
|
+
id: z.string().describe('The question id from source_brief (e.g. "cdc:1"), or your own id for a general question'),
|
|
106
|
+
question: z.string().optional(),
|
|
107
|
+
covers: z.array(z.string()).optional().describe("Other question ids this one settles"),
|
|
108
|
+
blocking: z.boolean().optional().describe("What the user means (program, place, population): no default exists"),
|
|
109
|
+
asked: z.boolean().optional(),
|
|
110
|
+
options: z.array(z.string()).optional(),
|
|
111
|
+
answer: z.string().optional().describe('The user\'s answer, or "dont_know"'),
|
|
112
|
+
how: z.enum(["answered", "dont_know", "skipped", "not_asked"]).optional(),
|
|
113
|
+
reason_code: z.enum(["no_user", "settled_by_request"]).optional(),
|
|
114
|
+
request: z.string().optional().describe("settled_by_request: the user's own words that settle it"),
|
|
115
|
+
resolution: z.string().optional().describe("What you chose, for a Don't know, a skip or no_user"),
|
|
116
|
+
assumption: z.string().optional(),
|
|
117
|
+
rationale: z.string().optional(),
|
|
118
|
+
followed_up: z.boolean().optional(),
|
|
119
|
+
});
|
|
120
|
+
const specSchema = z.record(z.string(), z.any()).describe('Most sources: {"description": "...", "requests": [{"name", "endpoint", "params", "max_rows"}]}. Deep sources ' +
|
|
121
|
+
"(bea, bls, fred, ipums, opm, treasury) have their own format: see source_brief and request_schema.");
|
|
122
|
+
export function createServer(session = new Session()) {
|
|
123
|
+
const server = new McpServer({ name: "data-analyst", version: VERSION }, { instructions: INSTRUCTIONS });
|
|
124
|
+
const s = session;
|
|
125
|
+
server.registerTool("guide", {
|
|
126
|
+
title: "Method guide",
|
|
127
|
+
description: "The analyst's method: framing the question, asking only critical questions, choosing sources, " +
|
|
128
|
+
"the accuracy checklist and combining sources. Call once at the start of a data question. Topics: workflow " +
|
|
129
|
+
"(default), routing (which sources answer which questions, usual pairings), style, report_patterns.",
|
|
130
|
+
inputSchema: { topic: z.enum(["workflow", "routing", "style", "report_patterns"]).optional() },
|
|
131
|
+
annotations: READ,
|
|
132
|
+
}, wrap(s, T.guide));
|
|
133
|
+
server.registerTool("find_sources", {
|
|
134
|
+
title: "Find sources",
|
|
135
|
+
description: "With a question: the source packs ranked for it (a hint: split the question into measures and " +
|
|
136
|
+
"give each its source). Without one: every source with its agency, key need and example questions.",
|
|
137
|
+
inputSchema: { question: z.string().optional() },
|
|
138
|
+
annotations: READ,
|
|
139
|
+
}, wrap(s, T.findSources));
|
|
140
|
+
server.registerTool("source_brief", {
|
|
141
|
+
title: "Source brief",
|
|
142
|
+
description: "One source's playbook (coverage, units, traps, citation), its questions_to_ask (the critical " +
|
|
143
|
+
"choices: ask the user those the request leaves open, then record_decisions), its key status, rules and " +
|
|
144
|
+
"request index. Required before fetch. With doc: one of its long reference docs instead.",
|
|
145
|
+
inputSchema: { source: z.string().describe("A source id from find_sources"), doc: z.string().optional() },
|
|
146
|
+
annotations: READ,
|
|
147
|
+
}, wrap(s, T.sourceBrief));
|
|
148
|
+
server.registerTool("request_schema", {
|
|
149
|
+
title: "Request schema",
|
|
150
|
+
description: "Full parameters of named requests (from source_brief's requests), and the spec format; or search " +
|
|
151
|
+
"the source's catalog of datasets and series. fetch requires the schema of every request it uses.",
|
|
152
|
+
inputSchema: { source: z.string(), names: z.array(z.string()).optional(), search: z.string().optional() },
|
|
153
|
+
annotations: READ,
|
|
154
|
+
}, wrap(s, T.requestSchema));
|
|
155
|
+
server.registerTool("record_decisions", {
|
|
156
|
+
title: "Record decisions",
|
|
157
|
+
description: "Record the method record in decisions.json (merged with what is there): how each critical question " +
|
|
158
|
+
"was settled (the user's answer, a Don't know with the resolution you chose, a skip, or why it was not asked; " +
|
|
159
|
+
"fetch checks the source's questions), and, for the audits, the literature searched, the references opened (cite " +
|
|
160
|
+
"first), the assumptions with their basis, the data that would improve the answer, and numbers allowed in the " +
|
|
161
|
+
"answer that are not statistics. Lists replace the earlier list of the same name.",
|
|
162
|
+
inputSchema: {
|
|
163
|
+
questions: z.array(questionSchema).optional(),
|
|
164
|
+
disclosures: z.record(z.string(), z.string()).optional()
|
|
165
|
+
.describe("One line per question decided without the user (or 'literature'), which the answer carries word for word"),
|
|
166
|
+
literature_search: z.array(z.record(z.string(), z.any())).optional()
|
|
167
|
+
.describe('[{query, date, tool, found: [ref ids], note}] or [{unavailable: true, reason_code: "no_search_tool" | "network_blocked", reason}]'),
|
|
168
|
+
references: z.array(z.record(z.string(), z.any())).optional()
|
|
169
|
+
.describe("[{id, citation, url, accessed, opened: true, used_for, quote}] (opened only after cite saved the page)"),
|
|
170
|
+
assumptions: z.array(z.record(z.string(), z.any())).optional()
|
|
171
|
+
.describe("[{parameter, value, basis: empirical|literature|precedent|user|judgment, evidence, why_not_empirical, sensitivity}]"),
|
|
172
|
+
data_needs: z.array(z.record(z.string(), z.any())).optional()
|
|
173
|
+
.describe("[{id, data, improves: [...], effect, how_to_get, from_user}]"),
|
|
174
|
+
data_needs_note: z.string().optional().describe("Why no data would help, with data_needs: []"),
|
|
175
|
+
audit_allow: z.array(z.object({ value: z.string(), reason: z.string() })).optional()
|
|
176
|
+
.describe("Numbers in the answer that are not statistics (a bill number, a count of sources)"),
|
|
177
|
+
dollar_basis_ok: z.object({ reason: z.string() }).optional(),
|
|
178
|
+
rounding_ties_ok: z.array(z.object({ fact: z.string(), reason: z.string() })).optional(),
|
|
179
|
+
},
|
|
180
|
+
annotations: { readOnlyHint: false, idempotentHint: true, openWorldHint: false },
|
|
181
|
+
}, wrap(s, T.recordDecisions));
|
|
182
|
+
server.registerTool("check_key", {
|
|
183
|
+
title: "Check key",
|
|
184
|
+
description: "Whether a source's API key is set up (never shows the key) and, if not, what the user does.",
|
|
185
|
+
inputSchema: { source: z.string() },
|
|
186
|
+
annotations: READ,
|
|
187
|
+
}, wrap(s, T.checkKey));
|
|
188
|
+
server.registerTool("fetch", {
|
|
189
|
+
title: "Fetch data",
|
|
190
|
+
description: "Download data from the agency into this session's workspace (CSV per request, data dictionary, " +
|
|
191
|
+
"README with the citation and terms, request.json with every URL made). Returns a summary (rows, columns, a " +
|
|
192
|
+
"few rows), the files, the citation and notes; status partial when a row cap was hit. Refuses (gate_blocked) " +
|
|
193
|
+
"until source_brief, request_schema and record_decisions are done for this source.",
|
|
194
|
+
inputSchema: { source: z.string(), spec: specSchema, force: z.boolean().optional().describe("Fetch again even if the workspace has this exact request") },
|
|
195
|
+
annotations: NET,
|
|
196
|
+
}, wrap(s, T.fetchData));
|
|
197
|
+
server.registerTool("manual_bundle", {
|
|
198
|
+
title: "Manual download bundle",
|
|
199
|
+
description: "When this server cannot get the data (no key stored here, a host that refuses scripts, a network " +
|
|
200
|
+
"block): write one bundle for one or more sources with download scripts (.sh and .ps1, every request built in, any " +
|
|
201
|
+
"key asked with hidden input on the user's own computer) and INSTRUCTIONS.md. Then ingest the files the user downloads.",
|
|
202
|
+
inputSchema: { sources: z.array(z.object({ source: z.string(), spec: specSchema })).min(1),
|
|
203
|
+
reason: z.string().optional().describe("Why the user downloads by hand (shown in INSTRUCTIONS.md)") },
|
|
204
|
+
annotations: { readOnlyHint: false, openWorldHint: false },
|
|
205
|
+
}, wrap(s, T.manualBundle));
|
|
206
|
+
server.registerTool("ingest", {
|
|
207
|
+
title: "Ingest downloaded files",
|
|
208
|
+
description: "Package files the user downloaded (from manual_bundle, a keyless_file, or the agency's site) like a " +
|
|
209
|
+
"fetch: CSVs, data dictionary, README and provenance. The same gate as fetch applies.",
|
|
210
|
+
inputSchema: { source: z.string(), spec: specSchema,
|
|
211
|
+
files: z.array(z.string()).min(1).describe("Paths of the downloaded files or their folder") },
|
|
212
|
+
annotations: { readOnlyHint: false, openWorldHint: false },
|
|
213
|
+
}, wrap(s, T.ingest));
|
|
214
|
+
server.registerTool("read_file", {
|
|
215
|
+
title: "Read workspace file",
|
|
216
|
+
description: "A text file from this session's workspace (a fetched CSV, README, request.json), up to 100 KB.",
|
|
217
|
+
inputSchema: { path: z.string().describe("Relative to the workspace, or a path a fetch result listed"),
|
|
218
|
+
max_bytes: z.number().optional() },
|
|
219
|
+
annotations: READ,
|
|
220
|
+
}, wrap(s, T.readFile));
|
|
221
|
+
for (const t of [...ANALYSIS_TOOLS, ...REPORT_TOOLS]) {
|
|
222
|
+
server.registerTool(t.name, { title: t.title, description: t.description, inputSchema: t.inputSchema,
|
|
223
|
+
annotations: t.annotations ?? { readOnlyHint: false, openWorldHint: false } }, wrap(s, t.handler));
|
|
224
|
+
}
|
|
225
|
+
server.registerPrompt("analyze", {
|
|
226
|
+
title: "Analyze with U.S. government data",
|
|
227
|
+
description: "Start a data question with the full method (asks the critical questions before fetching).",
|
|
228
|
+
argsSchema: { question: z.string().describe("The question to answer") },
|
|
229
|
+
}, ({ question }) => ({
|
|
230
|
+
messages: [{ role: "user", content: { type: "text",
|
|
231
|
+
text: `${fs.readFileSync(path.join(GUIDE_DIR, "WORKFLOW.md"), "utf8")}\n\n---\n\nQuestion: ${question}` } }],
|
|
232
|
+
}));
|
|
233
|
+
server.registerResource("source", new ResourceTemplate("source://{id}", {
|
|
234
|
+
list: () => ({ resources: packIds().map((id) => ({ uri: `source://${id}`, name: `${id} playbook`, mimeType: "text/markdown" })) }),
|
|
235
|
+
}), { title: "Source playbook", description: "A source pack's source.md", mimeType: "text/markdown" }, (uri, { id }) => {
|
|
236
|
+
const pid = String(id);
|
|
237
|
+
if (!packIds().includes(pid))
|
|
238
|
+
throw new Error(`unknown source ${pid}`);
|
|
239
|
+
return { contents: [{ uri: uri.href, mimeType: "text/markdown", text: fs.readFileSync(path.join(PACKS_DIR, pid, "source.md"), "utf8") }] };
|
|
240
|
+
});
|
|
241
|
+
server.registerResource("guide", "guide://workflow", { title: "Method guide", mimeType: "text/markdown" }, (uri) => ({
|
|
242
|
+
contents: [{ uri: uri.href, mimeType: "text/markdown", text: fs.readFileSync(path.join(GUIDE_DIR, "WORKFLOW.md"), "utf8") }],
|
|
243
|
+
}));
|
|
244
|
+
return server;
|
|
245
|
+
}
|
|
246
|
+
//# sourceMappingURL=server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,CAAC,MAAM,YAAY,CAAC;AAChC,OAAO,EAAE,KAAK,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,KAAK,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;mCAoBO,CAAC;AAIpC;;;GAGG;AACH,SAAS,UAAU,CAAC,CAAU,EAAE,GAAQ;IACtC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAC7D,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,MAAM,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC;IACvB,MAAM,IAAI,GAAG,CAAC,CAAM,EAAO,EAAE;QAC3B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACvD,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;gBAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAO,CAAC,CAAC,CAAC,CAAC;YAC3E,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3G,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,sGAAsG,CAAC;IAC3H,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,EAAE,CAAC;QAC7F,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO;YAClB,CAAC,CAAC,mHAAmH,CAAC,CAAC,OAAO,8BAA8B;YAC5J,CAAC,CAAC,kHAAkH;gBAClH,0EAA0E,CAAC;IACjF,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,SAAS,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,4GAA4G;YACtH,8EAA8E,CAAC;IACnF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,IAAI,CAAI,CAAU,EAAE,EAAc;IACzC,OAAO,KAAK,EAAE,CAAI,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACtB,IAAI,GAAY,CAAC;YACjB,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,CAAC;gBACH,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,eAAe,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9F,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBACnB,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YACD,2FAA2F;YAC3F,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;QACtH,CAAC,CAAC;QACF,8FAA8F;QAC9F,MAAM,IAAI,GAAG,OAAQ,CAAS,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;QAChE,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,IAAI,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAW,CAAC;AACnE,MAAM,GAAG,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAW,CAAC;AAEjE,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yFAAyF,CAAC;IAClH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACtF,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;IAChH,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC5E,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzE,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC,CAAC,QAAQ,EAAE;IACjE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;IAClG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IACjG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CACvD,+GAA+G;IAC/G,oGAAoG,CAAC,CAAC;AAExG,MAAM,UAAU,YAAY,CAAC,OAAO,GAAG,IAAI,OAAO,EAAE;IAClD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,CAAC;IACzG,MAAM,CAAC,GAAG,OAAO,CAAC;IAElB,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;QAC3B,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,gGAAgG;YAC3G,4GAA4G;YAC5G,oGAAoG;QACtG,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC9F,WAAW,EAAE,IAAI;KAClB,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAErB,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE;QAClC,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,gGAAgG;YAC3G,mGAAmG;QACrG,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;QAChD,WAAW,EAAE,IAAI;KAClB,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IAE3B,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE;QAClC,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,+FAA+F;YAC1G,yGAAyG;YACzG,yFAAyF;QAC3F,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;QACzG,WAAW,EAAE,IAAI;KAClB,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IAE3B,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE;QACpC,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,mGAAmG;YAC9G,kGAAkG;QACpG,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;QACzG,WAAW,EAAE,IAAI;KAClB,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IAE7B,MAAM,CAAC,YAAY,CAAC,kBAAkB,EAAE;QACtC,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,qGAAqG;YAChH,+GAA+G;YAC/G,kHAAkH;YAClH,+GAA+G;YAC/G,kFAAkF;QACpF,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;YAC7C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;iBACrD,QAAQ,CAAC,0GAA0G,CAAC;YACvH,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;iBACjE,QAAQ,CAAC,mIAAmI,CAAC;YAChJ,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;iBAC1D,QAAQ,CAAC,wGAAwG,CAAC;YACrH,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;iBAC3D,QAAQ,CAAC,qHAAqH,CAAC;YAClI,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;iBAC1D,QAAQ,CAAC,8DAA8D,CAAC;YAC3E,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;YAC9F,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;iBACjF,QAAQ,CAAC,mFAAmF,CAAC;YAChG,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;YAC5D,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;SACzF;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KACjF,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;IAE/B,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE;QAC/B,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,6FAA6F;QAC1G,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;QACnC,WAAW,EAAE,IAAI;KAClB,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAExB,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;QAC3B,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,iGAAiG;YAC5G,6GAA6G;YAC7G,8GAA8G;YAC9G,mFAAmF;QACrF,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC,EAAE;QACzJ,WAAW,EAAE,GAAG;KACjB,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAEzB,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE;QACnC,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,mGAAmG;YAC9G,oHAAoH;YACpH,wHAAwH;QAC1H,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACxF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC,EAAE;QACvG,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;KAC3D,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;IAE5B,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE;QAC5B,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,sGAAsG;YACjH,sFAAsF;QACxF,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU;YACjD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+CAA+C,CAAC,EAAE;QAC/F,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;KAC3D,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAEtB,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE;QAC/B,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,gGAAgG;QAC7G,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;YACpG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;QACpC,WAAW,EAAE,IAAI;KAClB,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAExB,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,EAAE,GAAG,YAAY,CAAC,EAAE,CAAC;QACrD,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW;YAClG,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACvG,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE;QAC/B,KAAK,EAAE,mCAAmC;QAC1C,WAAW,EAAE,2FAA2F;QACxG,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE;KACxE,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QACpB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM;oBAChD,IAAI,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,wBAAwB,QAAQ,EAAE,EAAE,EAAE,CAAC;KAC/G,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,gBAAgB,CAAC,eAAe,EAAE;QACtE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC,EAAE,CAAC;KACnI,CAAC,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,2BAA2B,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACrH,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QACvB,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;QACvE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;IAC7I,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACnH,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC;KAC7H,CAAC,CAAC,CAAC;IAEJ,OAAO,MAAM,CAAC;AAChB,CAAC"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
export type Question = {
|
|
2
|
+
id: string;
|
|
3
|
+
question?: string;
|
|
4
|
+
covers?: string[];
|
|
5
|
+
blocking?: boolean;
|
|
6
|
+
asked?: boolean;
|
|
7
|
+
options?: string[];
|
|
8
|
+
answer?: string;
|
|
9
|
+
how?: "answered" | "dont_know" | "skipped" | "not_asked";
|
|
10
|
+
reason_code?: "no_user" | "settled_by_request";
|
|
11
|
+
request?: string;
|
|
12
|
+
resolution?: string;
|
|
13
|
+
assumption?: string;
|
|
14
|
+
rationale?: string;
|
|
15
|
+
followed_up?: boolean;
|
|
16
|
+
};
|
|
17
|
+
export declare class Session {
|
|
18
|
+
readonly id: string;
|
|
19
|
+
readonly workspace: string;
|
|
20
|
+
briefed: Set<string>;
|
|
21
|
+
schemas: Map<string, Set<string>>;
|
|
22
|
+
/** Remote mode: the signed-in account whose stored keys this session uses (OAuth subject). */
|
|
23
|
+
account: string | null;
|
|
24
|
+
/** Remote mode: a download URL for a file in the workspace (null in local mode: paths are shown). */
|
|
25
|
+
linker: ((abs: string) => string) | null;
|
|
26
|
+
/** Remote mode: the page where the signed-in user stores their own keys (write-only). */
|
|
27
|
+
keysUrl: string | null;
|
|
28
|
+
/** Remote mode: the page where the user uploads files a manual bundle downloaded (into <workspace>/uploads). */
|
|
29
|
+
uploadUrl: string | null;
|
|
30
|
+
/** Remote mode: the signed-in user's stored keys (keys.ts withKeyProvider). */
|
|
31
|
+
keyProvider: ((env: string) => string | undefined) | null;
|
|
32
|
+
lastSeen: number;
|
|
33
|
+
constructor(id?: string, workspace?: string);
|
|
34
|
+
sawSchema(source: string, names: string[]): void;
|
|
35
|
+
get decisionsPath(): string;
|
|
36
|
+
decisions(): any;
|
|
37
|
+
/** Merge questions (by id) and other top-level fields into decisions.json. */
|
|
38
|
+
recordDecisions(update: {
|
|
39
|
+
questions?: Question[];
|
|
40
|
+
disclosures?: Record<string, string>;
|
|
41
|
+
[k: string]: unknown;
|
|
42
|
+
}): any;
|
|
43
|
+
/** Problems with how a question was settled (empty = settled). */
|
|
44
|
+
static questionProblems(q: Question): string[];
|
|
45
|
+
/** The source's critical-question ids not yet settled, with why. */
|
|
46
|
+
unsettled(source: string, clarify: string[]): string[];
|
|
47
|
+
}
|
package/dist/session.js
ADDED
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Per-session state: the workspace folder and the evidence the fetch gate checks.
|
|
3
|
+
*
|
|
4
|
+
* The gate (fetch refuses until each is true for the source, in this session):
|
|
5
|
+
* 1. source_brief(id) was returned (the model has the playbook and the questions to ask);
|
|
6
|
+
* 2. request_schema returned the schema of every endpoint the spec uses;
|
|
7
|
+
* 3. record_decisions covers each of the source's critical questions (`<id>:<n>`, from source_brief) with an
|
|
8
|
+
* answer, a "Don't know", a skip, or a reason it was not asked (settled_by_request with the user's words,
|
|
9
|
+
* or no_user when nobody can answer).
|
|
10
|
+
* decisions.json in the workspace is the method record, merged by question id.
|
|
11
|
+
*/
|
|
12
|
+
import crypto from "node:crypto";
|
|
13
|
+
import fs from "node:fs";
|
|
14
|
+
import path from "node:path";
|
|
15
|
+
import { workspaceRoot } from "./core/env.js";
|
|
16
|
+
export class Session {
|
|
17
|
+
id;
|
|
18
|
+
workspace;
|
|
19
|
+
briefed = new Set();
|
|
20
|
+
schemas = new Map();
|
|
21
|
+
/** Remote mode: the signed-in account whose stored keys this session uses (OAuth subject). */
|
|
22
|
+
account = null;
|
|
23
|
+
/** Remote mode: a download URL for a file in the workspace (null in local mode: paths are shown). */
|
|
24
|
+
linker = null;
|
|
25
|
+
/** Remote mode: the page where the signed-in user stores their own keys (write-only). */
|
|
26
|
+
keysUrl = null;
|
|
27
|
+
/** Remote mode: the page where the user uploads files a manual bundle downloaded (into <workspace>/uploads). */
|
|
28
|
+
uploadUrl = null;
|
|
29
|
+
/** Remote mode: the signed-in user's stored keys (keys.ts withKeyProvider). */
|
|
30
|
+
keyProvider = null;
|
|
31
|
+
lastSeen = Date.now();
|
|
32
|
+
constructor(id, workspace) {
|
|
33
|
+
this.id = id || `${new Date().toISOString().slice(0, 10)}-${crypto.randomBytes(4).toString("hex")}`;
|
|
34
|
+
this.workspace = path.resolve(workspace || path.join(workspaceRoot(), this.id));
|
|
35
|
+
fs.mkdirSync(this.workspace, { recursive: true });
|
|
36
|
+
}
|
|
37
|
+
sawSchema(source, names) {
|
|
38
|
+
if (!this.schemas.has(source))
|
|
39
|
+
this.schemas.set(source, new Set());
|
|
40
|
+
names.forEach((n) => this.schemas.get(source).add(n));
|
|
41
|
+
}
|
|
42
|
+
get decisionsPath() {
|
|
43
|
+
return path.join(this.workspace, "decisions.json");
|
|
44
|
+
}
|
|
45
|
+
decisions() {
|
|
46
|
+
try {
|
|
47
|
+
return JSON.parse(fs.readFileSync(this.decisionsPath, "utf8"));
|
|
48
|
+
}
|
|
49
|
+
catch {
|
|
50
|
+
return { questions: [] };
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
/** Merge questions (by id) and other top-level fields into decisions.json. */
|
|
54
|
+
recordDecisions(update) {
|
|
55
|
+
const d = this.decisions();
|
|
56
|
+
const byId = new Map((d.questions || []).map((q) => [q.id, q]));
|
|
57
|
+
for (const q0 of update.questions || []) {
|
|
58
|
+
// the method audit reads `asked` (default true): a question recorded as not asked says so explicitly
|
|
59
|
+
const q = q0.asked === undefined && q0.how ? { ...q0, asked: q0.how !== "not_asked" } : q0;
|
|
60
|
+
byId.set(q.id, { ...(byId.get(q.id) || {}), ...q });
|
|
61
|
+
}
|
|
62
|
+
d.questions = [...byId.values()];
|
|
63
|
+
if (update.disclosures)
|
|
64
|
+
d.disclosures = { ...(d.disclosures || {}), ...update.disclosures };
|
|
65
|
+
for (const [k, v] of Object.entries(update))
|
|
66
|
+
if (k !== "questions" && k !== "disclosures")
|
|
67
|
+
d[k] = v;
|
|
68
|
+
fs.writeFileSync(this.decisionsPath, JSON.stringify(d, null, 2));
|
|
69
|
+
return d;
|
|
70
|
+
}
|
|
71
|
+
/** Problems with how a question was settled (empty = settled). */
|
|
72
|
+
static questionProblems(q) {
|
|
73
|
+
const how = q.how || (q.answer && q.answer !== "dont_know" ? "answered" : q.answer === "dont_know" ? "dont_know" : undefined);
|
|
74
|
+
if (!how)
|
|
75
|
+
return [`${q.id}: no answer and no "how" (answered, dont_know, skipped or not_asked)`];
|
|
76
|
+
if (how === "answered" && !q.answer)
|
|
77
|
+
return [`${q.id}: how is "answered" but there is no answer`];
|
|
78
|
+
if (how === "not_asked") {
|
|
79
|
+
if (q.reason_code === "settled_by_request" && !q.request)
|
|
80
|
+
return [`${q.id}: settled_by_request needs "request", the user's own words`];
|
|
81
|
+
if (q.reason_code !== "settled_by_request" && q.reason_code !== "no_user") {
|
|
82
|
+
return [`${q.id}: a question not asked needs reason_code settled_by_request or no_user`];
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
if ((how === "dont_know" || how === "skipped" || q.reason_code === "no_user") && !q.resolution) {
|
|
86
|
+
return [`${q.id}: a "Don't know", skip or no_user question needs the resolution you chose`];
|
|
87
|
+
}
|
|
88
|
+
if (how === "skipped" && q.blocking && !q.followed_up)
|
|
89
|
+
return [`${q.id}: a skipped blocking question is asked once more first`];
|
|
90
|
+
return [];
|
|
91
|
+
}
|
|
92
|
+
/** The source's critical-question ids not yet settled, with why. */
|
|
93
|
+
unsettled(source, clarify) {
|
|
94
|
+
const qs = this.decisions().questions || [];
|
|
95
|
+
const out = [];
|
|
96
|
+
clarify.forEach((_, i) => {
|
|
97
|
+
const cid = `${source}:${i + 1}`;
|
|
98
|
+
const q = qs.find((x) => x.id === cid || (x.covers || []).includes(cid));
|
|
99
|
+
if (!q)
|
|
100
|
+
out.push(`${cid}: not recorded`);
|
|
101
|
+
else
|
|
102
|
+
out.push(...Session.questionProblems(q));
|
|
103
|
+
});
|
|
104
|
+
return out;
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
//# sourceMappingURL=session.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tool definitions that modules contribute without editing server.ts: src/analysis/tools.ts and
|
|
3
|
+
* src/report/tools.ts each export `TOOLS: ToolDef[]`, and server.ts registers every one with the same wrapper
|
|
4
|
+
* (redaction, remote links, the error envelope) as its own tools.
|
|
5
|
+
*/
|
|
6
|
+
import type { ZodRawShape } from "zod";
|
|
7
|
+
import type { Session } from "./session.js";
|
|
8
|
+
export type ToolDef = {
|
|
9
|
+
name: string;
|
|
10
|
+
title: string;
|
|
11
|
+
description: string;
|
|
12
|
+
inputSchema: ZodRawShape;
|
|
13
|
+
annotations?: {
|
|
14
|
+
readOnlyHint?: boolean;
|
|
15
|
+
idempotentHint?: boolean;
|
|
16
|
+
openWorldHint?: boolean;
|
|
17
|
+
destructiveHint?: boolean;
|
|
18
|
+
};
|
|
19
|
+
/** Throw ToolError (envelope.ts) for a failure with a code and a fix; return a JSON-able result. */
|
|
20
|
+
handler: (s: Session, args: any) => unknown | Promise<unknown>;
|
|
21
|
+
};
|
package/dist/toolkit.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"toolkit.js","sourceRoot":"","sources":["../src/toolkit.ts"],"names":[],"mappings":""}
|