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
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { OAuthServerProvider } from "@modelcontextprotocol/sdk/server/auth/provider.js";
|
|
2
|
+
/** The consent form posts this signed blob back to /oauth/consent, so the request cannot be altered. */
|
|
3
|
+
export type PendingAuth = {
|
|
4
|
+
k: "consent";
|
|
5
|
+
client: string;
|
|
6
|
+
redirect: string;
|
|
7
|
+
state?: string;
|
|
8
|
+
challenge: string;
|
|
9
|
+
scopes?: string[];
|
|
10
|
+
resource?: string;
|
|
11
|
+
};
|
|
12
|
+
/** Issue the authorization code and the redirect URL, after the user consented as `account`. */
|
|
13
|
+
export declare function grantCode(p: PendingAuth, account: string): string;
|
|
14
|
+
export declare const provider: OAuthServerProvider;
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The OAuth authorization server for remote mode (on when DATA_ANALYST_ACCOUNTS=1): what lets a claude.ai custom
|
|
3
|
+
* connector sign in, so each user's own API keys can be stored on this server and used for their tool calls.
|
|
4
|
+
*
|
|
5
|
+
* - dynamic client registration (claude.ai registers itself), PKCE authorization codes (S256, checked by the
|
|
6
|
+
* SDK's token handler), access tokens (1 hour) and rotating refresh tokens (30 days);
|
|
7
|
+
* - the consent page creates an account, or reconnects one with the account code shown when it was created;
|
|
8
|
+
* - an account is only a key ring: it has no profile, email or password.
|
|
9
|
+
*/
|
|
10
|
+
import crypto from "node:crypto";
|
|
11
|
+
import { InvalidGrantError, InvalidTokenError } from "@modelcontextprotocol/sdk/server/auth/errors.js";
|
|
12
|
+
import { consentPage } from "./pages.js";
|
|
13
|
+
import { sign } from "./sign.js";
|
|
14
|
+
import * as store from "./store.js";
|
|
15
|
+
const ACCESS_S = 3600;
|
|
16
|
+
const REFRESH_S = 30 * 86400;
|
|
17
|
+
const CODE_S = 600;
|
|
18
|
+
const token = () => crypto.randomBytes(32).toString("base64url");
|
|
19
|
+
const clientsStore = {
|
|
20
|
+
getClient: (id) => store.getClient(id),
|
|
21
|
+
registerClient: (c) => {
|
|
22
|
+
const full = { ...c, client_id: crypto.randomUUID(),
|
|
23
|
+
client_id_issued_at: Math.floor(Date.now() / 1000),
|
|
24
|
+
...(c.token_endpoint_auth_method && c.token_endpoint_auth_method !== "none" ? { client_secret: token() } : {}) };
|
|
25
|
+
store.putClient(full);
|
|
26
|
+
return full;
|
|
27
|
+
},
|
|
28
|
+
};
|
|
29
|
+
/** Issue the authorization code and the redirect URL, after the user consented as `account`. */
|
|
30
|
+
export function grantCode(p, account) {
|
|
31
|
+
const code = token();
|
|
32
|
+
store.putGrant(code, { kind: "code", client: p.client, account, exp: Date.now() / 1000 + CODE_S, challenge: p.challenge,
|
|
33
|
+
redirect: p.redirect, scopes: p.scopes, resource: p.resource });
|
|
34
|
+
const u = new URL(p.redirect);
|
|
35
|
+
u.searchParams.set("code", code);
|
|
36
|
+
if (p.state)
|
|
37
|
+
u.searchParams.set("state", p.state);
|
|
38
|
+
return u.toString();
|
|
39
|
+
}
|
|
40
|
+
function issue(client, account, scopes, resource) {
|
|
41
|
+
const access = token(), refresh = token();
|
|
42
|
+
const now = Date.now() / 1000;
|
|
43
|
+
store.putGrant(access, { kind: "access", client, account, exp: now + ACCESS_S, scopes, resource });
|
|
44
|
+
store.putGrant(refresh, { kind: "refresh", client, account, exp: now + REFRESH_S, scopes, resource });
|
|
45
|
+
return { access_token: access, token_type: "Bearer", expires_in: ACCESS_S, refresh_token: refresh,
|
|
46
|
+
...(scopes?.length ? { scope: scopes.join(" ") } : {}) };
|
|
47
|
+
}
|
|
48
|
+
export const provider = {
|
|
49
|
+
get clientsStore() {
|
|
50
|
+
return clientsStore;
|
|
51
|
+
},
|
|
52
|
+
async authorize(client, params, res) {
|
|
53
|
+
const pending = sign({ k: "consent", client: client.client_id, redirect: params.redirectUri, state: params.state,
|
|
54
|
+
challenge: params.codeChallenge, scopes: params.scopes, resource: params.resource?.toString() }, CODE_S);
|
|
55
|
+
res.status(200).type("html").send(consentPage(client.client_name || "An assistant", pending));
|
|
56
|
+
},
|
|
57
|
+
async challengeForAuthorizationCode(_client, code) {
|
|
58
|
+
const g = store.getGrant(code, "code");
|
|
59
|
+
if (!g)
|
|
60
|
+
throw new InvalidGrantError("unknown or expired authorization code");
|
|
61
|
+
return g.challenge;
|
|
62
|
+
},
|
|
63
|
+
async exchangeAuthorizationCode(client, code, _verifier, redirectUri) {
|
|
64
|
+
const g = store.getGrant(code, "code");
|
|
65
|
+
if (!g || g.client !== client.client_id)
|
|
66
|
+
throw new InvalidGrantError("unknown or expired authorization code");
|
|
67
|
+
if (redirectUri && g.redirect !== redirectUri)
|
|
68
|
+
throw new InvalidGrantError("redirect_uri does not match");
|
|
69
|
+
store.dropGrant(code);
|
|
70
|
+
return issue(client.client_id, g.account, g.scopes, g.resource);
|
|
71
|
+
},
|
|
72
|
+
async exchangeRefreshToken(client, refresh, scopes) {
|
|
73
|
+
const g = store.getGrant(refresh, "refresh");
|
|
74
|
+
if (!g || g.client !== client.client_id)
|
|
75
|
+
throw new InvalidGrantError("unknown or expired refresh token");
|
|
76
|
+
store.dropGrant(refresh);
|
|
77
|
+
return issue(client.client_id, g.account, scopes?.length ? scopes : g.scopes, g.resource);
|
|
78
|
+
},
|
|
79
|
+
async verifyAccessToken(t) {
|
|
80
|
+
const g = store.getGrant(t, "access");
|
|
81
|
+
if (!g || !store.accountExists(g.account))
|
|
82
|
+
throw new InvalidTokenError("invalid or expired access token");
|
|
83
|
+
return { token: t, clientId: g.client, scopes: g.scopes || [], expiresAt: Math.floor(g.exp),
|
|
84
|
+
...(g.resource ? { resource: new URL(g.resource) } : {}), extra: { account: g.account } };
|
|
85
|
+
},
|
|
86
|
+
async revokeToken(_client, req) {
|
|
87
|
+
store.dropGrant(req.token);
|
|
88
|
+
},
|
|
89
|
+
};
|
|
90
|
+
//# sourceMappingURL=oauth.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"oauth.js","sourceRoot":"","sources":["../../src/remote/oauth.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
export declare function consentPage(client: string, pending: string): string;
|
|
2
|
+
export declare function newAccountPage(code: string, next: string): string;
|
|
3
|
+
export declare function keysPage(vars: {
|
|
4
|
+
env: string;
|
|
5
|
+
sources: string[];
|
|
6
|
+
signup?: string | null;
|
|
7
|
+
}[], set: string[], action: string, saved?: string[]): string;
|
|
8
|
+
export declare function uploadPage(action: string, files: string[]): string;
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The few HTML pages remote mode serves: OAuth consent, the new-account code, the keys page and the upload page.
|
|
3
|
+
* Self-contained (no scripts from elsewhere), escaped, and never showing a stored key.
|
|
4
|
+
*/
|
|
5
|
+
const esc = (s) => String(s ?? "").replace(/[&<>"']/g, (c) => `&#${c.charCodeAt(0)};`);
|
|
6
|
+
function page(title, body) {
|
|
7
|
+
return `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
8
|
+
<title>${esc(title)}</title><style>
|
|
9
|
+
:root{color-scheme:light dark;--fg:#1d1d1f;--bg:#fafafa;--muted:#666;--line:#ddd;--accent:#2457c5}
|
|
10
|
+
@media (prefers-color-scheme:dark){:root{--fg:#eee;--bg:#161616;--muted:#aaa;--line:#333;--accent:#7aa2ff}}
|
|
11
|
+
body{font:16px/1.5 system-ui,sans-serif;color:var(--fg);background:var(--bg);max-width:42rem;margin:2rem auto;padding:0 1rem}
|
|
12
|
+
h1{font-size:1.4rem}label{display:block;margin:.6rem 0 .2rem;font-weight:600}input{width:100%;padding:.5rem;border:1px solid var(--line);
|
|
13
|
+
border-radius:6px;background:transparent;color:inherit;box-sizing:border-box}button{margin-top:1rem;padding:.6rem 1.2rem;border:0;
|
|
14
|
+
border-radius:6px;background:var(--accent);color:#fff;font-size:1rem;cursor:pointer}.muted{color:var(--muted);font-size:.9rem}
|
|
15
|
+
code{background:rgba(127,127,127,.15);padding:.1rem .3rem;border-radius:4px}.set{color:#2a8a3e}table{width:100%;border-collapse:collapse}
|
|
16
|
+
td{padding:.35rem .2rem;border-bottom:1px solid var(--line);vertical-align:top}</style></head><body>${body}</body></html>`;
|
|
17
|
+
}
|
|
18
|
+
export function consentPage(client, pending) {
|
|
19
|
+
return page("Connect data-analyst", `<h1>Connect ${esc(client)} to data-analyst</h1>
|
|
20
|
+
<p>data-analyst fetches official U.S. government data for your assistant. Connecting lets you store your own API keys
|
|
21
|
+
for the sources that need one (FRED, BEA, Census and others). Your keys stay on this server, encrypted; the assistant
|
|
22
|
+
never sees them.</p>
|
|
23
|
+
<form method="post" action="/oauth/consent"><input type="hidden" name="pending" value="${esc(pending)}">
|
|
24
|
+
<label for="code">Account code (only to reconnect an account you made before)</label>
|
|
25
|
+
<input id="code" name="account_code" autocomplete="off" placeholder="leave empty to create a new account">
|
|
26
|
+
<button type="submit">Connect</button></form>
|
|
27
|
+
<p class="muted">An account here is only a key ring: no email, no password, no profile.</p>`);
|
|
28
|
+
}
|
|
29
|
+
export function newAccountPage(code, next) {
|
|
30
|
+
return page("Your account code", `<h1>Save your account code</h1>
|
|
31
|
+
<p>This is the only time it is shown. Use it to reconnect this account (and its stored keys) later, for example from
|
|
32
|
+
another assistant or after removing the connector.</p><p><code style="font-size:1.2rem">${esc(code)}</code></p>
|
|
33
|
+
<p><a href="${esc(next)}">Continue to your assistant</a></p>`);
|
|
34
|
+
}
|
|
35
|
+
export function keysPage(vars, set, action, saved) {
|
|
36
|
+
const rows = vars.map((v) => `<tr><td><label for="${esc(v.env)}">${esc(v.env)}</label><span class="muted">${esc(v.sources.join(", "))}` +
|
|
37
|
+
(v.signup ? ` · <a href="${esc(v.signup)}" target="_blank" rel="noopener">get a free key</a>` : "") + `</span></td>
|
|
38
|
+
<td style="width:45%"><input id="${esc(v.env)}" name="${esc(v.env)}" type="password" autocomplete="off"
|
|
39
|
+
placeholder="${set.includes(v.env) ? "stored (type to replace)" : "not set"}"></td></tr>`).join("\n");
|
|
40
|
+
return page("Your API keys", `<h1>Your API keys</h1>
|
|
41
|
+
${saved ? `<p class="set">Saved. Stored now: ${saved.length ? esc(saved.join(", ")) : "none"}.</p>` : ""}
|
|
42
|
+
<p>Type a key to store or replace it, or a single space to remove it. Stored keys are encrypted and never shown again,
|
|
43
|
+
here or to the assistant.</p><form method="post" action="${esc(action)}"><table>${rows}</table>
|
|
44
|
+
<button type="submit">Save</button></form>`);
|
|
45
|
+
}
|
|
46
|
+
export function uploadPage(action, files) {
|
|
47
|
+
return page("Upload files", `<h1>Upload the downloaded files</h1>
|
|
48
|
+
<p>Choose every file the download script saved (or that you saved from the agency's site). They go into this
|
|
49
|
+
analysis session only.</p><input id="f" type="file" multiple><button id="b">Upload</button><p id="s" class="muted"></p>
|
|
50
|
+
${files.length ? `<p class="muted">Already here: ${esc(files.join(", "))}</p>` : ""}
|
|
51
|
+
<script>document.getElementById("b").onclick=async()=>{const s=document.getElementById("s"),fs=document.getElementById("f").files;
|
|
52
|
+
for(const f of fs){s.textContent="Uploading "+f.name+"…";const r=await fetch(${JSON.stringify(action)}+"&name="+encodeURIComponent(f.name),
|
|
53
|
+
{method:"PUT",body:f});if(!r.ok){s.textContent="Failed: "+f.name+" ("+r.status+")";return}}
|
|
54
|
+
s.textContent="Done: "+fs.length+" file(s). Tell your assistant they are uploaded.";};</script>`);
|
|
55
|
+
}
|
|
56
|
+
//# sourceMappingURL=pages.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../src/remote/pages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,GAAG,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEhG,SAAS,IAAI,CAAC,KAAa,EAAE,IAAY;IACvC,OAAO;SACA,GAAG,CAAC,KAAK,CAAC;;;;;;;;sGAQmF,IAAI,gBAAgB,CAAC;AAC3H,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,OAAe;IACzD,OAAO,IAAI,CAAC,sBAAsB,EAAE,eAAe,GAAG,CAAC,MAAM,CAAC;;;;yFAIyB,GAAG,CAAC,OAAO,CAAC;;;;4FAIT,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,IAAY;IACvD,OAAO,IAAI,CAAC,mBAAmB,EAAE;;0FAEuD,GAAG,CAAC,IAAI,CAAC;cACrF,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAkE,EAAE,GAAa,EACxG,MAAc,EAAE,KAAgB;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,uBAAuB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,+BAA+B,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE;QACrI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,qDAAqD,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG;mCACvE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;eACnD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,SAAS,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpG,OAAO,IAAI,CAAC,eAAe,EAAE;EAC7B,KAAK,CAAC,CAAC,CAAC,qCAAqC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE;;2DAE7C,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI;2CAC3C,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,KAAe;IACxD,OAAO,IAAI,CAAC,cAAc,EAAE;;;EAG5B,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,kCAAkC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;;+EAEJ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;;gGAEL,CAAC,CAAC;AAClG,CAAC"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
export declare function serverSecret(): Buffer;
|
|
2
|
+
export declare function sign(payload: Record<string, unknown>, ttlSeconds: number): string;
|
|
3
|
+
/** The payload of a valid, unexpired token of the given kind; null otherwise. */
|
|
4
|
+
export declare function verify<T = Record<string, any>>(token: string, kind: string): T | null;
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Signed, expiring capability tokens for links the server hands out (downloads, the upload page, the keys page).
|
|
3
|
+
* token = base64url(JSON payload) "." base64url(HMAC-SHA256). The secret is DATA_ANALYST_SECRET (required when
|
|
4
|
+
* accounts are on, so links and stored keys survive restarts), else a random per-process secret.
|
|
5
|
+
*/
|
|
6
|
+
import crypto from "node:crypto";
|
|
7
|
+
let secret = null;
|
|
8
|
+
export function serverSecret() {
|
|
9
|
+
if (!secret) {
|
|
10
|
+
const s = process.env.DATA_ANALYST_SECRET;
|
|
11
|
+
secret = s ? crypto.createHash("sha256").update(s).digest() : crypto.randomBytes(32);
|
|
12
|
+
}
|
|
13
|
+
return secret;
|
|
14
|
+
}
|
|
15
|
+
const b64 = (b) => Buffer.from(b).toString("base64url");
|
|
16
|
+
export function sign(payload, ttlSeconds) {
|
|
17
|
+
const body = b64(JSON.stringify({ ...payload, exp: Math.floor(Date.now() / 1000) + ttlSeconds }));
|
|
18
|
+
const mac = crypto.createHmac("sha256", serverSecret()).update(body).digest();
|
|
19
|
+
return `${body}.${b64(mac)}`;
|
|
20
|
+
}
|
|
21
|
+
/** The payload of a valid, unexpired token of the given kind; null otherwise. */
|
|
22
|
+
export function verify(token, kind) {
|
|
23
|
+
const [body, mac] = String(token || "").split(".");
|
|
24
|
+
if (!body || !mac)
|
|
25
|
+
return null;
|
|
26
|
+
const want = crypto.createHmac("sha256", serverSecret()).update(body).digest();
|
|
27
|
+
const got = Buffer.from(mac, "base64url");
|
|
28
|
+
if (got.length !== want.length || !crypto.timingSafeEqual(got, want))
|
|
29
|
+
return null;
|
|
30
|
+
try {
|
|
31
|
+
const p = JSON.parse(Buffer.from(body, "base64url").toString("utf8"));
|
|
32
|
+
if (p.k !== kind || typeof p.exp !== "number" || p.exp < Date.now() / 1000)
|
|
33
|
+
return null;
|
|
34
|
+
return p;
|
|
35
|
+
}
|
|
36
|
+
catch {
|
|
37
|
+
return null;
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
//# sourceMappingURL=sign.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sign.js","sourceRoot":"","sources":["../../src/remote/sign.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QAC1C,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,GAAG,GAAG,CAAC,CAAkB,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAEzE,MAAM,UAAU,IAAI,CAAC,OAAgC,EAAE,UAAkB;IACvE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC;IAClG,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9E,OAAO,GAAG,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/B,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,MAAM,CAA0B,KAAa,EAAE,IAAY;IACzE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IAC/E,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC1C,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAClF,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI;YAAE,OAAO,IAAI,CAAC;QACxF,OAAO,CAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
export declare function stateDir(): string;
|
|
2
|
+
export declare const hash: (s: string) => string;
|
|
3
|
+
export declare function createAccount(): {
|
|
4
|
+
id: string;
|
|
5
|
+
code: string;
|
|
6
|
+
};
|
|
7
|
+
/** The account a code belongs to (the code is shown to the user once, to reconnect later with the same keys). */
|
|
8
|
+
export declare function accountByCode(code: string): string | null;
|
|
9
|
+
export declare function accountExists(id: string): boolean;
|
|
10
|
+
/** Merge keys into the account (an empty value removes that variable). */
|
|
11
|
+
export declare function setKeys(account: string, keys: Record<string, string>): string[];
|
|
12
|
+
/** The names of the variables the account has stored (never the values). */
|
|
13
|
+
export declare function keyNames(account: string): string[];
|
|
14
|
+
/** A key lookup for one account (keys.ts withKeyProvider); every value it returns joins the redaction set. */
|
|
15
|
+
export declare function keyProvider(account: string): (env: string) => string | undefined;
|
|
16
|
+
export declare function getClient(id: string): any | undefined;
|
|
17
|
+
export declare function putClient(c: any): void;
|
|
18
|
+
type Grant = {
|
|
19
|
+
kind: "code" | "access" | "refresh";
|
|
20
|
+
client: string;
|
|
21
|
+
account: string;
|
|
22
|
+
exp: number;
|
|
23
|
+
challenge?: string;
|
|
24
|
+
redirect?: string;
|
|
25
|
+
scopes?: string[];
|
|
26
|
+
resource?: string;
|
|
27
|
+
};
|
|
28
|
+
export declare function putGrant(token: string, g: Grant): void;
|
|
29
|
+
export declare function getGrant(token: string, kind: Grant["kind"]): Grant | null;
|
|
30
|
+
export declare function dropGrant(token: string): void;
|
|
31
|
+
export {};
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Server state for remote mode: OAuth clients, authorization codes, tokens, and each account's API keys.
|
|
3
|
+
*
|
|
4
|
+
* Keys are encrypted at rest with AES-256-GCM under a key derived from DATA_ANALYST_SECRET (per account, a fresh
|
|
5
|
+
* IV per write). They are decrypted only in memory when a tool call needs one, and no tool, page or log ever
|
|
6
|
+
* returns them: the keys page shows only which variables are set. Tokens are stored as SHA-256 hashes.
|
|
7
|
+
* State lives in DATA_ANALYST_STATE_DIR (default <workspace root>/state), files 0600.
|
|
8
|
+
*/
|
|
9
|
+
import crypto from "node:crypto";
|
|
10
|
+
import fs from "node:fs";
|
|
11
|
+
import path from "node:path";
|
|
12
|
+
import { workspaceRoot } from "../core/env.js";
|
|
13
|
+
import { remember } from "../core/keys.js";
|
|
14
|
+
import { serverSecret } from "./sign.js";
|
|
15
|
+
export function stateDir() {
|
|
16
|
+
const d = process.env.DATA_ANALYST_STATE_DIR || path.join(workspaceRoot(), "state");
|
|
17
|
+
fs.mkdirSync(d, { recursive: true, mode: 0o700 });
|
|
18
|
+
return d;
|
|
19
|
+
}
|
|
20
|
+
function load(name, fallback) {
|
|
21
|
+
try {
|
|
22
|
+
return JSON.parse(fs.readFileSync(path.join(stateDir(), name), "utf8"));
|
|
23
|
+
}
|
|
24
|
+
catch {
|
|
25
|
+
return fallback;
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
function save(name, data) {
|
|
29
|
+
const p = path.join(stateDir(), name);
|
|
30
|
+
const tmp = `${p}.${process.pid}.tmp`;
|
|
31
|
+
fs.writeFileSync(tmp, JSON.stringify(data), { mode: 0o600 });
|
|
32
|
+
fs.renameSync(tmp, p);
|
|
33
|
+
}
|
|
34
|
+
export const hash = (s) => crypto.createHash("sha256").update(s).digest("hex");
|
|
35
|
+
// ---------------------------------------------------------------------- key encryption
|
|
36
|
+
function keyFor(account) {
|
|
37
|
+
return crypto.createHmac("sha256", serverSecret()).update(`keys:${account}`).digest();
|
|
38
|
+
}
|
|
39
|
+
function encrypt(account, data) {
|
|
40
|
+
const iv = crypto.randomBytes(12);
|
|
41
|
+
const c = crypto.createCipheriv("aes-256-gcm", keyFor(account), iv);
|
|
42
|
+
const enc = Buffer.concat([c.update(JSON.stringify(data), "utf8"), c.final()]);
|
|
43
|
+
return [iv, c.getAuthTag(), enc].map((b) => b.toString("base64")).join(".");
|
|
44
|
+
}
|
|
45
|
+
function decrypt(account, blob) {
|
|
46
|
+
const [iv, tag, enc] = blob.split(".").map((x) => Buffer.from(x, "base64"));
|
|
47
|
+
const d = crypto.createDecipheriv("aes-256-gcm", keyFor(account), iv);
|
|
48
|
+
d.setAuthTag(tag);
|
|
49
|
+
return JSON.parse(Buffer.concat([d.update(enc), d.final()]).toString("utf8"));
|
|
50
|
+
}
|
|
51
|
+
export function createAccount() {
|
|
52
|
+
const a = load("accounts.json", {});
|
|
53
|
+
const id = crypto.randomBytes(9).toString("base64url");
|
|
54
|
+
const code = crypto.randomBytes(12).toString("base64url");
|
|
55
|
+
a[id] = { created: Date.now(), code_hash: hash(code) };
|
|
56
|
+
save("accounts.json", a);
|
|
57
|
+
return { id, code };
|
|
58
|
+
}
|
|
59
|
+
/** The account a code belongs to (the code is shown to the user once, to reconnect later with the same keys). */
|
|
60
|
+
export function accountByCode(code) {
|
|
61
|
+
const h = hash(code.trim());
|
|
62
|
+
const a = load("accounts.json", {});
|
|
63
|
+
return Object.entries(a).find(([, v]) => v.code_hash === h)?.[0] ?? null;
|
|
64
|
+
}
|
|
65
|
+
export function accountExists(id) {
|
|
66
|
+
return !!load("accounts.json", {})[id];
|
|
67
|
+
}
|
|
68
|
+
/** Merge keys into the account (an empty value removes that variable). */
|
|
69
|
+
export function setKeys(account, keys) {
|
|
70
|
+
const a = load("accounts.json", {});
|
|
71
|
+
if (!a[account])
|
|
72
|
+
throw new Error("unknown account");
|
|
73
|
+
const cur = a[account].keys ? decrypt(account, a[account].keys) : {};
|
|
74
|
+
for (const [k, v] of Object.entries(keys)) {
|
|
75
|
+
if (!/^[A-Z][A-Z0-9_]{1,63}$/.test(k))
|
|
76
|
+
continue;
|
|
77
|
+
if (v.trim())
|
|
78
|
+
cur[k] = v.trim();
|
|
79
|
+
else
|
|
80
|
+
delete cur[k];
|
|
81
|
+
}
|
|
82
|
+
a[account].keys = encrypt(account, cur);
|
|
83
|
+
save("accounts.json", a);
|
|
84
|
+
return Object.keys(cur).sort();
|
|
85
|
+
}
|
|
86
|
+
/** The names of the variables the account has stored (never the values). */
|
|
87
|
+
export function keyNames(account) {
|
|
88
|
+
const a = load("accounts.json", {})[account];
|
|
89
|
+
return a?.keys ? Object.keys(decrypt(account, a.keys)).sort() : [];
|
|
90
|
+
}
|
|
91
|
+
/** A key lookup for one account (keys.ts withKeyProvider); every value it returns joins the redaction set. */
|
|
92
|
+
export function keyProvider(account) {
|
|
93
|
+
// read on every lookup: a key the user stores mid-session works on the next call
|
|
94
|
+
return (env) => {
|
|
95
|
+
const a = load("accounts.json", {})[account];
|
|
96
|
+
const v = a?.keys ? decrypt(account, a.keys)[env] : undefined;
|
|
97
|
+
if (v)
|
|
98
|
+
remember(v);
|
|
99
|
+
return v;
|
|
100
|
+
};
|
|
101
|
+
}
|
|
102
|
+
// ---------------------------------------------------------------------- OAuth clients, codes and tokens
|
|
103
|
+
export function getClient(id) {
|
|
104
|
+
return load("clients.json", {})[id];
|
|
105
|
+
}
|
|
106
|
+
export function putClient(c) {
|
|
107
|
+
const all = load("clients.json", {});
|
|
108
|
+
all[c.client_id] = c;
|
|
109
|
+
save("clients.json", all);
|
|
110
|
+
}
|
|
111
|
+
export function putGrant(token, g) {
|
|
112
|
+
const all = load("grants.json", {});
|
|
113
|
+
const now = Date.now() / 1000;
|
|
114
|
+
for (const [k, v] of Object.entries(all))
|
|
115
|
+
if (v.exp < now)
|
|
116
|
+
delete all[k];
|
|
117
|
+
all[hash(token)] = g;
|
|
118
|
+
save("grants.json", all);
|
|
119
|
+
}
|
|
120
|
+
export function getGrant(token, kind) {
|
|
121
|
+
const g = load("grants.json", {})[hash(token)];
|
|
122
|
+
return g && g.kind === kind && g.exp > Date.now() / 1000 ? g : null;
|
|
123
|
+
}
|
|
124
|
+
export function dropGrant(token) {
|
|
125
|
+
const all = load("grants.json", {});
|
|
126
|
+
delete all[hash(token)];
|
|
127
|
+
save("grants.json", all);
|
|
128
|
+
}
|
|
129
|
+
//# sourceMappingURL=store.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/remote/store.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
import type { Result } from "./method_audit.js";
|
|
2
|
+
export declare const CHECKS: string[];
|
|
3
|
+
type Facts = Record<string, any>;
|
|
4
|
+
export type Num = {
|
|
5
|
+
tok: string;
|
|
6
|
+
num: number;
|
|
7
|
+
unit: string;
|
|
8
|
+
scale: number;
|
|
9
|
+
tol: number;
|
|
10
|
+
dec?: number;
|
|
11
|
+
neg: boolean;
|
|
12
|
+
dollar: boolean;
|
|
13
|
+
plus?: boolean;
|
|
14
|
+
line?: string;
|
|
15
|
+
approx?: boolean;
|
|
16
|
+
unit_after?: boolean;
|
|
17
|
+
counts?: boolean;
|
|
18
|
+
table?: boolean;
|
|
19
|
+
};
|
|
20
|
+
type Disp = [number, string, number | null];
|
|
21
|
+
type Shown = [string, Disp, any];
|
|
22
|
+
/** Where the number tok stands in x as a whole number (not "0.6 percent" inside "30.6 percent"); -1 if not. */
|
|
23
|
+
export declare function at(x: string, tok: string): number;
|
|
24
|
+
/** The statistics in an answer: {tok, num, unit ("pct", "pp", "bp", "scaled" or ""), scale, tol}. Years, dates, table
|
|
25
|
+
* and line references, bill and law numbers, ordinals, list markers and "top 5" are skipped. */
|
|
26
|
+
export declare function answerNumbers(text: string): Num[];
|
|
27
|
+
/** A fact's value (with its sign) in the unit its format shows, that unit's kind and the format's digits. */
|
|
28
|
+
export declare function factDisplay(f: any): Disp | null;
|
|
29
|
+
/** Does answer number n show this fact? */
|
|
30
|
+
export declare function matches(n: Num, shown: number, kind: string, digits?: number | null): boolean;
|
|
31
|
+
export declare const DOWN_WORDS: RegExp;
|
|
32
|
+
export declare const UP_WORDS: RegExp;
|
|
33
|
+
/** An audit_allow entry and an answer number compare as written, unit included. */
|
|
34
|
+
export declare function allowKey(s0: unknown): string;
|
|
35
|
+
/** The label of a table cell's row; null outside tables, for a period or an unreadable row. */
|
|
36
|
+
export declare function rowLabel(n: Num): string | null;
|
|
37
|
+
/** A name as written and its short form: "Natural Resources Committee" -> natural resources. */
|
|
38
|
+
export declare function forms(v0: unknown): Set<string>;
|
|
39
|
+
type Ents = Map<string, [Set<string>, string]>;
|
|
40
|
+
/** Names the facts are keyed by, each form to [keys, the name]; periods and codes are not names. */
|
|
41
|
+
export declare function entities(facts: Facts): Ents;
|
|
42
|
+
/** The block's sentences, not cut after an abbreviation or initial (U.S., St., e.g.). */
|
|
43
|
+
export declare function sentences(block: string): string[];
|
|
44
|
+
/** Prose that names an entity right before a number gives that entity's figure; returns the other entity's name. */
|
|
45
|
+
export declare function misnamed(sents: string[], n: Num, fhits: any[], ents: Ents): string | null;
|
|
46
|
+
/** A clause about one row must cite that row's figure; returns the named row when it cites a sibling's. */
|
|
47
|
+
export declare function clauseOwner(sents: string[], n: Num, fhits: any[], facts: Facts): string | null;
|
|
48
|
+
/** A measure named by its acronym right before the number must be a fact of that measure; returns the acronym. */
|
|
49
|
+
export declare function measureNamed(sents: string[], n: Num, fhits: any[], facts: Facts): string | null;
|
|
50
|
+
/** A table's columns each hold one measure: a cell whose facts give another column's measure was moved across. */
|
|
51
|
+
export declare function columnMisfits(block: string, facts: Facts): string[];
|
|
52
|
+
/** "fell from $890.8 billion to $984.0 billion": a direction word whose own from-to numbers move the other way. */
|
|
53
|
+
export declare function fromToMisreads(text: string): string[];
|
|
54
|
+
/** A table cell matches a fact of its own row, when facts are registered by that row. */
|
|
55
|
+
export declare function rowOk(n: Num, fhits: any[], facts: Facts): boolean;
|
|
56
|
+
/** A period as year*100 + month (month 0 when only a year is given; a quarter is its first month). */
|
|
57
|
+
export declare function periodKey(x0: unknown): number | null;
|
|
58
|
+
/** The periods a fact is about, from its `where`; a vintage, release or retrieval date is not one. */
|
|
59
|
+
export declare function factPeriods(f: any): number[];
|
|
60
|
+
/** In a table keyed by periods, a cell whose matching facts all break its column's lag is a value moved. */
|
|
61
|
+
export declare function periodMisfits(block: string, shown: Shown[], facts: Facts): string[];
|
|
62
|
+
/** "for 2025 (men 20.2": a year that dates the number from just before it, as " in 2025" for wrongYear. */
|
|
63
|
+
export declare function yearBefore(before: string, after?: string): string;
|
|
64
|
+
/** "6.3 percent in 2019": when every fact the number matches is keyed to periods and none falls in that year. */
|
|
65
|
+
export declare function wrongYear(after: string, fhits: any[]): boolean;
|
|
66
|
+
/** The facts of the year the sentence gives for the number, when some match it; otherwise all of fhits. */
|
|
67
|
+
export declare function dated(sents: string[], n: Num, fhits: any[]): any[];
|
|
68
|
+
/** Sentences (and tables) that put dollar amounts of two or more different years side by side. */
|
|
69
|
+
export declare function dollarComparisons(text: string): string[];
|
|
70
|
+
/** FAIL when answer.md compares dollar amounts across years and nowhere says nominal or real. */
|
|
71
|
+
export declare function checkDollarBasis(text: string, D: any): Result;
|
|
72
|
+
/** [text to scan, text a label may sit in]: each paragraph; a table with its caption and notes. */
|
|
73
|
+
export declare function blocks(text: string): [string, string][];
|
|
74
|
+
/** Counts spelled out as a whole table cell ("| four |"): the facts tool writes 0-9 in words. */
|
|
75
|
+
export declare function tableWords(block: string): Num[];
|
|
76
|
+
/** Data rows of each markdown table in the answer (header and |---| rule not counted). */
|
|
77
|
+
export declare function tableSizes(text: string): Set<number>;
|
|
78
|
+
/** "four of the five" in prose over a five-row table summarizes that table: a count to register. */
|
|
79
|
+
export declare function subsetWords(block: string, sizes: Set<number>): Num[];
|
|
80
|
+
/** answer.md, the reply as it will be sent: every number in it is a registered fact as its format shows it (or a
|
|
81
|
+
* published benchmark figure, or in audit_allow); it carries every disclosure line; flagged facts are labelled; it
|
|
82
|
+
* reports the benchmark check. Returns [results, answer text]. */
|
|
83
|
+
export declare function checkAnswer(base: string, facts: Facts, D: any): [Result[], string];
|
|
84
|
+
/** Tables read by hand from an agency page: each row of published/<name>.csv names its page and date. */
|
|
85
|
+
export declare function checkPublished(base: string): [string, boolean, string, string[]][];
|
|
86
|
+
export declare function audit(out: string, online?: boolean, rerunIt?: boolean): Promise<Result[]>;
|
|
87
|
+
/** The lines audit_answer.py prints: one [PASS]/[FAIL] line per check, the failures (and the benchmark counts),
|
|
88
|
+
* notes on what the answer must disclose, then AUDIT PASSED or AUDIT FAILED (n problems). */
|
|
89
|
+
export declare function printed(results: Result[], checks: string[], answerText?: string, notes?: string[]): {
|
|
90
|
+
lines: string[];
|
|
91
|
+
verdict: string;
|
|
92
|
+
passed: boolean;
|
|
93
|
+
};
|
|
94
|
+
export {};
|