data-analyst-mcp 0.0.0-stage → 0.3.1

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.
Files changed (640) hide show
  1. package/README.md +261 -2
  2. package/dist/adapters/_acf_tidy.d.ts +18 -0
  3. package/dist/adapters/_acf_tidy.js +432 -0
  4. package/dist/adapters/_acf_tidy.js.map +1 -0
  5. package/dist/adapters/_actuaries_read.d.ts +38 -0
  6. package/dist/adapters/_actuaries_read.js +728 -0
  7. package/dist/adapters/_actuaries_read.js.map +1 -0
  8. package/dist/adapters/_census_micro.d.ts +70 -0
  9. package/dist/adapters/_census_micro.js +622 -0
  10. package/dist/adapters/_census_micro.js.map +1 -0
  11. package/dist/adapters/_census_util.d.ts +40 -0
  12. package/dist/adapters/_census_util.js +275 -0
  13. package/dist/adapters/_census_util.js.map +1 -0
  14. package/dist/adapters/_dol_states.d.ts +6 -0
  15. package/dist/adapters/_dol_states.js +58 -0
  16. package/dist/adapters/_dol_states.js.map +1 -0
  17. package/dist/adapters/_govinfo_entities.d.ts +4 -0
  18. package/dist/adapters/_govinfo_entities.js +6 -0
  19. package/dist/adapters/_govinfo_entities.js.map +1 -0
  20. package/dist/adapters/_govinfo_json.d.ts +13 -0
  21. package/dist/adapters/_govinfo_json.js +107 -0
  22. package/dist/adapters/_govinfo_json.js.map +1 -0
  23. package/dist/adapters/_govinfo_py.d.ts +22 -0
  24. package/dist/adapters/_govinfo_py.js +272 -0
  25. package/dist/adapters/_govinfo_py.js.map +1 -0
  26. package/dist/adapters/_govinfo_xml.d.ts +22 -0
  27. package/dist/adapters/_govinfo_xml.js +233 -0
  28. package/dist/adapters/_govinfo_xml.js.map +1 -0
  29. package/dist/adapters/_hud_excel.d.ts +2 -0
  30. package/dist/adapters/_hud_excel.js +166 -0
  31. package/dist/adapters/_hud_excel.js.map +1 -0
  32. package/dist/adapters/_omb_grid.d.ts +17 -0
  33. package/dist/adapters/_omb_grid.js +132 -0
  34. package/dist/adapters/_omb_grid.js.map +1 -0
  35. package/dist/adapters/_omb_util.d.ts +40 -0
  36. package/dist/adapters/_omb_util.js +192 -0
  37. package/dist/adapters/_omb_util.js.map +1 -0
  38. package/dist/adapters/_usaspending_state.d.ts +6 -0
  39. package/dist/adapters/_usaspending_state.js +54 -0
  40. package/dist/adapters/_usaspending_state.js.map +1 -0
  41. package/dist/adapters/_usda-fna_book.d.ts +59 -0
  42. package/dist/adapters/_usda-fna_book.js +869 -0
  43. package/dist/adapters/_usda-fna_book.js.map +1 -0
  44. package/dist/adapters/_usda-fna_pdf.d.ts +20 -0
  45. package/dist/adapters/_usda-fna_pdf.js +361 -0
  46. package/dist/adapters/_usda-fna_pdf.js.map +1 -0
  47. package/dist/adapters/_usda-outlook_read.d.ts +70 -0
  48. package/dist/adapters/_usda-outlook_read.js +362 -0
  49. package/dist/adapters/_usda-outlook_read.js.map +1 -0
  50. package/dist/adapters/acf.d.ts +3 -0
  51. package/dist/adapters/acf.js +187 -0
  52. package/dist/adapters/acf.js.map +1 -0
  53. package/dist/adapters/actuaries.d.ts +3 -0
  54. package/dist/adapters/actuaries.js +293 -0
  55. package/dist/adapters/actuaries.js.map +1 -0
  56. package/dist/adapters/bts.d.ts +3 -0
  57. package/dist/adapters/bts.js +26 -0
  58. package/dist/adapters/bts.js.map +1 -0
  59. package/dist/adapters/census-geocoder.d.ts +10 -0
  60. package/dist/adapters/census-geocoder.js +47 -0
  61. package/dist/adapters/census-geocoder.js.map +1 -0
  62. package/dist/adapters/census.d.ts +17 -0
  63. package/dist/adapters/census.js +983 -0
  64. package/dist/adapters/census.js.map +1 -0
  65. package/dist/adapters/cfpb.d.ts +7 -0
  66. package/dist/adapters/cfpb.js +348 -0
  67. package/dist/adapters/cfpb.js.map +1 -0
  68. package/dist/adapters/clinical-trials.d.ts +3 -0
  69. package/dist/adapters/clinical-trials.js +135 -0
  70. package/dist/adapters/clinical-trials.js.map +1 -0
  71. package/dist/adapters/cms.d.ts +3 -0
  72. package/dist/adapters/cms.js +292 -0
  73. package/dist/adapters/cms.js.map +1 -0
  74. package/dist/adapters/college-scorecard.d.ts +3 -0
  75. package/dist/adapters/college-scorecard.js +122 -0
  76. package/dist/adapters/college-scorecard.js.map +1 -0
  77. package/dist/adapters/congress.d.ts +33 -0
  78. package/dist/adapters/congress.js +589 -0
  79. package/dist/adapters/congress.js.map +1 -0
  80. package/dist/adapters/dhs-ohss.d.ts +13 -0
  81. package/dist/adapters/dhs-ohss.js +598 -0
  82. package/dist/adapters/dhs-ohss.js.map +1 -0
  83. package/dist/adapters/doj-news.d.ts +7 -0
  84. package/dist/adapters/doj-news.js +286 -0
  85. package/dist/adapters/doj-news.js.map +1 -0
  86. package/dist/adapters/dol.d.ts +4 -0
  87. package/dist/adapters/dol.js +634 -0
  88. package/dist/adapters/dol.js.map +1 -0
  89. package/dist/adapters/eia.d.ts +15 -0
  90. package/dist/adapters/eia.js +456 -0
  91. package/dist/adapters/eia.js.map +1 -0
  92. package/dist/adapters/epa-aqs.d.ts +3 -0
  93. package/dist/adapters/epa-aqs.js +357 -0
  94. package/dist/adapters/epa-aqs.js.map +1 -0
  95. package/dist/adapters/epa.d.ts +3 -0
  96. package/dist/adapters/epa.js +298 -0
  97. package/dist/adapters/epa.js.map +1 -0
  98. package/dist/adapters/fbi.d.ts +3 -0
  99. package/dist/adapters/fbi.js +192 -0
  100. package/dist/adapters/fbi.js.map +1 -0
  101. package/dist/adapters/fda.d.ts +5 -0
  102. package/dist/adapters/fda.js +184 -0
  103. package/dist/adapters/fda.js.map +1 -0
  104. package/dist/adapters/fdic.d.ts +4 -0
  105. package/dist/adapters/fdic.js +95 -0
  106. package/dist/adapters/fdic.js.map +1 -0
  107. package/dist/adapters/fec.d.ts +3 -0
  108. package/dist/adapters/fec.js +142 -0
  109. package/dist/adapters/fec.js.map +1 -0
  110. package/dist/adapters/fed-board.d.ts +12 -0
  111. package/dist/adapters/fed-board.js +581 -0
  112. package/dist/adapters/fed-board.js.map +1 -0
  113. package/dist/adapters/federal-register.d.ts +11 -0
  114. package/dist/adapters/federal-register.js +43 -0
  115. package/dist/adapters/federal-register.js.map +1 -0
  116. package/dist/adapters/fhfa.d.ts +3 -0
  117. package/dist/adapters/fhfa.js +253 -0
  118. package/dist/adapters/fhfa.js.map +1 -0
  119. package/dist/adapters/fsa.d.ts +9 -0
  120. package/dist/adapters/fsa.js +335 -0
  121. package/dist/adapters/fsa.js.map +1 -0
  122. package/dist/adapters/govinfo.d.ts +30 -0
  123. package/dist/adapters/govinfo.js +636 -0
  124. package/dist/adapters/govinfo.js.map +1 -0
  125. package/dist/adapters/gsa-calc.d.ts +10 -0
  126. package/dist/adapters/gsa-calc.js +318 -0
  127. package/dist/adapters/gsa-calc.js.map +1 -0
  128. package/dist/adapters/hud.d.ts +3 -0
  129. package/dist/adapters/hud.js +200 -0
  130. package/dist/adapters/hud.js.map +1 -0
  131. package/dist/adapters/index.d.ts +3 -0
  132. package/dist/adapters/index.js +25 -0
  133. package/dist/adapters/index.js.map +1 -0
  134. package/dist/adapters/irs-soi.d.ts +6 -0
  135. package/dist/adapters/irs-soi.js +576 -0
  136. package/dist/adapters/irs-soi.js.map +1 -0
  137. package/dist/adapters/naep.d.ts +15 -0
  138. package/dist/adapters/naep.js +341 -0
  139. package/dist/adapters/naep.js.map +1 -0
  140. package/dist/adapters/nhtsa.d.ts +10 -0
  141. package/dist/adapters/nhtsa.js +239 -0
  142. package/dist/adapters/nhtsa.js.map +1 -0
  143. package/dist/adapters/nih.d.ts +5 -0
  144. package/dist/adapters/nih.js +196 -0
  145. package/dist/adapters/nih.js.map +1 -0
  146. package/dist/adapters/noaa.d.ts +3 -0
  147. package/dist/adapters/noaa.js +148 -0
  148. package/dist/adapters/noaa.js.map +1 -0
  149. package/dist/adapters/nrel.d.ts +3 -0
  150. package/dist/adapters/nrel.js +186 -0
  151. package/dist/adapters/nrel.js.map +1 -0
  152. package/dist/adapters/nws.d.ts +3 -0
  153. package/dist/adapters/nws.js +119 -0
  154. package/dist/adapters/nws.js.map +1 -0
  155. package/dist/adapters/omb.d.ts +15 -0
  156. package/dist/adapters/omb.js +517 -0
  157. package/dist/adapters/omb.js.map +1 -0
  158. package/dist/adapters/open-payments.d.ts +5 -0
  159. package/dist/adapters/open-payments.js +149 -0
  160. package/dist/adapters/open-payments.js.map +1 -0
  161. package/dist/adapters/pbgc.d.ts +13 -0
  162. package/dist/adapters/pbgc.js +283 -0
  163. package/dist/adapters/pbgc.js.map +1 -0
  164. package/dist/adapters/philfed.d.ts +12 -0
  165. package/dist/adapters/philfed.js +59 -0
  166. package/dist/adapters/philfed.js.map +1 -0
  167. package/dist/adapters/regulations.d.ts +6 -0
  168. package/dist/adapters/regulations.js +58 -0
  169. package/dist/adapters/regulations.js.map +1 -0
  170. package/dist/adapters/sec.d.ts +13 -0
  171. package/dist/adapters/sec.js +504 -0
  172. package/dist/adapters/sec.js.map +1 -0
  173. package/dist/adapters/senate-lobbying.d.ts +3 -0
  174. package/dist/adapters/senate-lobbying.js +181 -0
  175. package/dist/adapters/senate-lobbying.js.map +1 -0
  176. package/dist/adapters/snapqc.d.ts +32 -0
  177. package/dist/adapters/snapqc.js +701 -0
  178. package/dist/adapters/snapqc.js.map +1 -0
  179. package/dist/adapters/treasury-yields.d.ts +3 -0
  180. package/dist/adapters/treasury-yields.js +170 -0
  181. package/dist/adapters/treasury-yields.js.map +1 -0
  182. package/dist/adapters/usaspending.d.ts +3 -0
  183. package/dist/adapters/usaspending.js +340 -0
  184. package/dist/adapters/usaspending.js.map +1 -0
  185. package/dist/adapters/usda-fna.d.ts +7 -0
  186. package/dist/adapters/usda-fna.js +707 -0
  187. package/dist/adapters/usda-fna.js.map +1 -0
  188. package/dist/adapters/usda-fooddata.d.ts +3 -0
  189. package/dist/adapters/usda-fooddata.js +101 -0
  190. package/dist/adapters/usda-fooddata.js.map +1 -0
  191. package/dist/adapters/usda-nass.d.ts +3 -0
  192. package/dist/adapters/usda-nass.js +108 -0
  193. package/dist/adapters/usda-nass.js.map +1 -0
  194. package/dist/adapters/usda-outlook.d.ts +12 -0
  195. package/dist/adapters/usda-outlook.js +696 -0
  196. package/dist/adapters/usda-outlook.js.map +1 -0
  197. package/dist/adapters/usgs.d.ts +9 -0
  198. package/dist/adapters/usgs.js +265 -0
  199. package/dist/adapters/usgs.js.map +1 -0
  200. package/dist/adapters/usitc.d.ts +18 -0
  201. package/dist/adapters/usitc.js +170 -0
  202. package/dist/adapters/usitc.js.map +1 -0
  203. package/dist/adapters/uspto.d.ts +3 -0
  204. package/dist/adapters/uspto.js +47 -0
  205. package/dist/adapters/uspto.js.map +1 -0
  206. package/dist/adapters/world-bank.d.ts +3 -0
  207. package/dist/adapters/world-bank.js +163 -0
  208. package/dist/adapters/world-bank.js.map +1 -0
  209. package/dist/analysis/cite.d.ts +31 -0
  210. package/dist/analysis/cite.js +229 -0
  211. package/dist/analysis/cite.js.map +1 -0
  212. package/dist/analysis/combine.d.ts +27 -0
  213. package/dist/analysis/combine.js +198 -0
  214. package/dist/analysis/combine.js.map +1 -0
  215. package/dist/analysis/compute.d.ts +62 -0
  216. package/dist/analysis/compute.js +583 -0
  217. package/dist/analysis/compute.js.map +1 -0
  218. package/dist/analysis/expr.d.ts +69 -0
  219. package/dist/analysis/expr.js +780 -0
  220. package/dist/analysis/expr.js.map +1 -0
  221. package/dist/analysis/factfmt.d.ts +16 -0
  222. package/dist/analysis/factfmt.js +187 -0
  223. package/dist/analysis/factfmt.js.map +1 -0
  224. package/dist/analysis/facts.d.ts +63 -0
  225. package/dist/analysis/facts.js +355 -0
  226. package/dist/analysis/facts.js.map +1 -0
  227. package/dist/analysis/handoff.d.ts +58 -0
  228. package/dist/analysis/handoff.js +208 -0
  229. package/dist/analysis/handoff.js.map +1 -0
  230. package/dist/analysis/pyfmt.d.ts +16 -0
  231. package/dist/analysis/pyfmt.js +156 -0
  232. package/dist/analysis/pyfmt.js.map +1 -0
  233. package/dist/analysis/rerun.d.ts +13 -0
  234. package/dist/analysis/rerun.js +125 -0
  235. package/dist/analysis/rerun.js.map +1 -0
  236. package/dist/analysis/table.d.ts +18 -0
  237. package/dist/analysis/table.js +109 -0
  238. package/dist/analysis/table.js.map +1 -0
  239. package/dist/analysis/tools.d.ts +67 -0
  240. package/dist/analysis/tools.js +217 -0
  241. package/dist/analysis/tools.js.map +1 -0
  242. package/dist/analysis/write_table.d.ts +13 -0
  243. package/dist/analysis/write_table.js +59 -0
  244. package/dist/analysis/write_table.js.map +1 -0
  245. package/dist/bin/cli.d.ts +10 -0
  246. package/dist/bin/cli.js +177 -0
  247. package/dist/bin/cli.js.map +1 -0
  248. package/dist/core/cache.d.ts +14 -0
  249. package/dist/core/cache.js +90 -0
  250. package/dist/core/cache.js.map +1 -0
  251. package/dist/core/context.d.ts +12 -0
  252. package/dist/core/context.js +15 -0
  253. package/dist/core/context.js.map +1 -0
  254. package/dist/core/env.d.ts +14 -0
  255. package/dist/core/env.js +52 -0
  256. package/dist/core/env.js.map +1 -0
  257. package/dist/core/generic-rest.d.ts +61 -0
  258. package/dist/core/generic-rest.js +639 -0
  259. package/dist/core/generic-rest.js.map +1 -0
  260. package/dist/core/http.d.ts +120 -0
  261. package/dist/core/http.js +514 -0
  262. package/dist/core/http.js.map +1 -0
  263. package/dist/core/keys.d.ts +43 -0
  264. package/dist/core/keys.js +174 -0
  265. package/dist/core/keys.js.map +1 -0
  266. package/dist/core/manual.d.ts +41 -0
  267. package/dist/core/manual.js +218 -0
  268. package/dist/core/manual.js.map +1 -0
  269. package/dist/core/package.d.ts +58 -0
  270. package/dist/core/package.js +228 -0
  271. package/dist/core/package.js.map +1 -0
  272. package/dist/core/packs.d.ts +139 -0
  273. package/dist/core/packs.js +173 -0
  274. package/dist/core/packs.js.map +1 -0
  275. package/dist/core/policy.d.ts +69 -0
  276. package/dist/core/policy.js +189 -0
  277. package/dist/core/policy.js.map +1 -0
  278. package/dist/core/py.d.ts +40 -0
  279. package/dist/core/py.js +171 -0
  280. package/dist/core/py.js.map +1 -0
  281. package/dist/core/routing.d.ts +10 -0
  282. package/dist/core/routing.js +39 -0
  283. package/dist/core/routing.js.map +1 -0
  284. package/dist/core/tabular.d.ts +21 -0
  285. package/dist/core/tabular.js +229 -0
  286. package/dist/core/tabular.js.map +1 -0
  287. package/dist/deep/_bea_api.d.ts +102 -0
  288. package/dist/deep/_bea_api.js +457 -0
  289. package/dist/deep/_bea_api.js.map +1 -0
  290. package/dist/deep/_bea_fetch.d.ts +151 -0
  291. package/dist/deep/_bea_fetch.js +1274 -0
  292. package/dist/deep/_bea_fetch.js.map +1 -0
  293. package/dist/deep/_bea_util.d.ts +14 -0
  294. package/dist/deep/_bea_util.js +156 -0
  295. package/dist/deep/_bea_util.js.map +1 -0
  296. package/dist/deep/_bls_api.d.ts +84 -0
  297. package/dist/deep/_bls_api.js +231 -0
  298. package/dist/deep/_bls_api.js.map +1 -0
  299. package/dist/deep/_bls_ids.d.ts +43 -0
  300. package/dist/deep/_bls_ids.js +188 -0
  301. package/dist/deep/_bls_ids.js.map +1 -0
  302. package/dist/deep/_bls_lib.d.ts +61 -0
  303. package/dist/deep/_bls_lib.js +442 -0
  304. package/dist/deep/_bls_lib.js.map +1 -0
  305. package/dist/deep/_fred_api.d.ts +148 -0
  306. package/dist/deep/_fred_api.js +545 -0
  307. package/dist/deep/_fred_api.js.map +1 -0
  308. package/dist/deep/_fred_pack.d.ts +162 -0
  309. package/dist/deep/_fred_pack.js +1027 -0
  310. package/dist/deep/_fred_pack.js.map +1 -0
  311. package/dist/deep/_fred_py.d.ts +40 -0
  312. package/dist/deep/_fred_py.js +199 -0
  313. package/dist/deep/_fred_py.js.map +1 -0
  314. package/dist/deep/_ipums_bundle.d.ts +29 -0
  315. package/dist/deep/_ipums_bundle.js +194 -0
  316. package/dist/deep/_ipums_bundle.js.map +1 -0
  317. package/dist/deep/_ipums_ddi.d.ts +23 -0
  318. package/dist/deep/_ipums_ddi.js +162 -0
  319. package/dist/deep/_ipums_ddi.js.map +1 -0
  320. package/dist/deep/_opm_io.d.ts +26 -0
  321. package/dist/deep/_opm_io.js +383 -0
  322. package/dist/deep/_opm_io.js.map +1 -0
  323. package/dist/deep/_opm_parquet.d.ts +31 -0
  324. package/dist/deep/_opm_parquet.js +744 -0
  325. package/dist/deep/_opm_parquet.js.map +1 -0
  326. package/dist/deep/_opm_py.d.ts +6 -0
  327. package/dist/deep/_opm_py.js +74 -0
  328. package/dist/deep/_opm_py.js.map +1 -0
  329. package/dist/deep/_treasury_api.d.ts +48 -0
  330. package/dist/deep/_treasury_api.js +221 -0
  331. package/dist/deep/_treasury_api.js.map +1 -0
  332. package/dist/deep/_treasury_context.d.ts +34 -0
  333. package/dist/deep/_treasury_context.js +142 -0
  334. package/dist/deep/_treasury_context.js.map +1 -0
  335. package/dist/deep/_treasury_lib.d.ts +109 -0
  336. package/dist/deep/_treasury_lib.js +686 -0
  337. package/dist/deep/_treasury_lib.js.map +1 -0
  338. package/dist/deep/bea.d.ts +3 -0
  339. package/dist/deep/bea.js +248 -0
  340. package/dist/deep/bea.js.map +1 -0
  341. package/dist/deep/bls.d.ts +3 -0
  342. package/dist/deep/bls.js +220 -0
  343. package/dist/deep/bls.js.map +1 -0
  344. package/dist/deep/fred.d.ts +3 -0
  345. package/dist/deep/fred.js +325 -0
  346. package/dist/deep/fred.js.map +1 -0
  347. package/dist/deep/ipums.d.ts +59 -0
  348. package/dist/deep/ipums.js +744 -0
  349. package/dist/deep/ipums.js.map +1 -0
  350. package/dist/deep/opm.d.ts +56 -0
  351. package/dist/deep/opm.js +1033 -0
  352. package/dist/deep/opm.js.map +1 -0
  353. package/dist/deep/treasury.d.ts +3 -0
  354. package/dist/deep/treasury.js +218 -0
  355. package/dist/deep/treasury.js.map +1 -0
  356. package/dist/envelope.d.ts +47 -0
  357. package/dist/envelope.js +88 -0
  358. package/dist/envelope.js.map +1 -0
  359. package/dist/index.d.ts +277 -0
  360. package/dist/index.js +106 -0
  361. package/dist/index.js.map +1 -0
  362. package/dist/remote/app.d.ts +21 -0
  363. package/dist/remote/app.js +218 -0
  364. package/dist/remote/app.js.map +1 -0
  365. package/dist/remote/oauth.d.ts +14 -0
  366. package/dist/remote/oauth.js +90 -0
  367. package/dist/remote/oauth.js.map +1 -0
  368. package/dist/remote/pages.d.ts +8 -0
  369. package/dist/remote/pages.js +56 -0
  370. package/dist/remote/pages.js.map +1 -0
  371. package/dist/remote/sign.d.ts +4 -0
  372. package/dist/remote/sign.js +40 -0
  373. package/dist/remote/sign.js.map +1 -0
  374. package/dist/remote/store.d.ts +31 -0
  375. package/dist/remote/store.js +129 -0
  376. package/dist/remote/store.js.map +1 -0
  377. package/dist/report/audit_answer.d.ts +94 -0
  378. package/dist/report/audit_answer.js +1349 -0
  379. package/dist/report/audit_answer.js.map +1 -0
  380. package/dist/report/audit_report.d.ts +23 -0
  381. package/dist/report/audit_report.js +637 -0
  382. package/dist/report/audit_report.js.map +1 -0
  383. package/dist/report/build_report.d.ts +27 -0
  384. package/dist/report/build_report.js +1168 -0
  385. package/dist/report/build_report.js.map +1 -0
  386. package/dist/report/method_audit.d.ts +47 -0
  387. package/dist/report/method_audit.js +716 -0
  388. package/dist/report/method_audit.js.map +1 -0
  389. package/dist/report/policyset.d.ts +50 -0
  390. package/dist/report/policyset.js +421 -0
  391. package/dist/report/policyset.js.map +1 -0
  392. package/dist/report/py.d.ts +58 -0
  393. package/dist/report/py.js +311 -0
  394. package/dist/report/py.js.map +1 -0
  395. package/dist/report/scan_secrets.d.ts +24 -0
  396. package/dist/report/scan_secrets.js +265 -0
  397. package/dist/report/scan_secrets.js.map +1 -0
  398. package/dist/report/style_check.d.ts +29 -0
  399. package/dist/report/style_check.js +173 -0
  400. package/dist/report/style_check.js.map +1 -0
  401. package/dist/report/tools.d.ts +87 -0
  402. package/dist/report/tools.js +167 -0
  403. package/dist/report/tools.js.map +1 -0
  404. package/dist/server.d.ts +5 -0
  405. package/dist/server.js +247 -0
  406. package/dist/server.js.map +1 -0
  407. package/dist/session.d.ts +47 -0
  408. package/dist/session.js +107 -0
  409. package/dist/session.js.map +1 -0
  410. package/dist/toolkit.d.ts +21 -0
  411. package/dist/toolkit.js +2 -0
  412. package/dist/toolkit.js.map +1 -0
  413. package/dist/tools.d.ts +299 -0
  414. package/dist/tools.js +491 -0
  415. package/dist/tools.js.map +1 -0
  416. package/guide/WORKFLOW.md +134 -0
  417. package/guide/assets/disclaimer.txt +1 -0
  418. package/guide/assets/download_data.ps1 +162 -0
  419. package/guide/assets/download_data.sh +143 -0
  420. package/guide/assets/report_template.html +597 -0
  421. package/guide/references/report_patterns.md +199 -0
  422. package/guide/references/routing.md +171 -0
  423. package/guide/references/style_guide.md +398 -0
  424. package/package.json +54 -4
  425. package/packs/acf/endpoints.json +114 -0
  426. package/packs/acf/policy.json +104 -0
  427. package/packs/acf/source.md +138 -0
  428. package/packs/actuaries/endpoints.json +82 -0
  429. package/packs/actuaries/policy.json +109 -0
  430. package/packs/actuaries/source.md +137 -0
  431. package/packs/bea/assets/download_bea.ps1 +182 -0
  432. package/packs/bea/assets/download_bea.sh +144 -0
  433. package/packs/bea/docs/bea_api.md +461 -0
  434. package/packs/bea/docs/datasets.md +157 -0
  435. package/packs/bea/docs/report_patterns.md +112 -0
  436. package/packs/bea/policy.json +170 -0
  437. package/packs/bea/source.md +152 -0
  438. package/packs/bls/assets/download_bls.ps1 +152 -0
  439. package/packs/bls/assets/download_bls.sh +167 -0
  440. package/packs/bls/docs/analysis_patterns.md +108 -0
  441. package/packs/bls/docs/bls_api.md +73 -0
  442. package/packs/bls/docs/series_ids.md +149 -0
  443. package/packs/bls/policy.json +238 -0
  444. package/packs/bls/series_ids.json +1375 -0
  445. package/packs/bls/source.md +156 -0
  446. package/packs/bts/endpoints.json +347 -0
  447. package/packs/bts/policy.json +94 -0
  448. package/packs/bts/source.md +97 -0
  449. package/packs/cdc/endpoints.json +197 -0
  450. package/packs/cdc/policy.json +83 -0
  451. package/packs/cdc/source.md +74 -0
  452. package/packs/census/endpoints.json +99 -0
  453. package/packs/census/policy.json +238 -0
  454. package/packs/census/source.md +304 -0
  455. package/packs/census-geocoder/endpoints.json +70 -0
  456. package/packs/census-geocoder/policy.json +80 -0
  457. package/packs/census-geocoder/source.md +53 -0
  458. package/packs/cfpb/endpoints.json +327 -0
  459. package/packs/cfpb/policy.json +119 -0
  460. package/packs/cfpb/source.md +96 -0
  461. package/packs/clinical-trials/endpoints.json +167 -0
  462. package/packs/clinical-trials/policy.json +84 -0
  463. package/packs/clinical-trials/source.md +82 -0
  464. package/packs/cms/endpoints.json +69 -0
  465. package/packs/cms/policy.json +96 -0
  466. package/packs/cms/source.md +112 -0
  467. package/packs/college-scorecard/endpoints.json +253 -0
  468. package/packs/college-scorecard/policy.json +106 -0
  469. package/packs/college-scorecard/source.md +92 -0
  470. package/packs/congress/endpoints.json +1701 -0
  471. package/packs/congress/policy.json +117 -0
  472. package/packs/congress/source.md +190 -0
  473. package/packs/dhs-ohss/endpoints.json +66 -0
  474. package/packs/dhs-ohss/policy.json +107 -0
  475. package/packs/dhs-ohss/source.md +120 -0
  476. package/packs/doj-news/endpoints.json +59 -0
  477. package/packs/doj-news/policy.json +96 -0
  478. package/packs/doj-news/source.md +99 -0
  479. package/packs/dol/endpoints.json +818 -0
  480. package/packs/dol/policy.json +135 -0
  481. package/packs/dol/source.md +181 -0
  482. package/packs/eia/endpoints.json +718 -0
  483. package/packs/eia/policy.json +112 -0
  484. package/packs/eia/source.md +112 -0
  485. package/packs/epa/endpoints.json +292 -0
  486. package/packs/epa/policy.json +99 -0
  487. package/packs/epa/source.md +99 -0
  488. package/packs/epa-aqs/endpoints.json +174 -0
  489. package/packs/epa-aqs/policy.json +96 -0
  490. package/packs/epa-aqs/source.md +97 -0
  491. package/packs/fbi/endpoints.json +1842 -0
  492. package/packs/fbi/policy.json +118 -0
  493. package/packs/fbi/source.md +108 -0
  494. package/packs/fda/endpoints.json +238 -0
  495. package/packs/fda/policy.json +121 -0
  496. package/packs/fda/source.md +117 -0
  497. package/packs/fdic/endpoints.json +417 -0
  498. package/packs/fdic/policy.json +83 -0
  499. package/packs/fdic/source.md +92 -0
  500. package/packs/fec/endpoints.json +708 -0
  501. package/packs/fec/policy.json +93 -0
  502. package/packs/fec/source.md +90 -0
  503. package/packs/fed-board/endpoints.json +89 -0
  504. package/packs/fed-board/policy.json +136 -0
  505. package/packs/fed-board/source.md +118 -0
  506. package/packs/federal-register/endpoints.json +143 -0
  507. package/packs/federal-register/policy.json +86 -0
  508. package/packs/federal-register/source.md +98 -0
  509. package/packs/fema/endpoints.json +646 -0
  510. package/packs/fema/policy.json +103 -0
  511. package/packs/fema/source.md +103 -0
  512. package/packs/fhfa/endpoints.json +105 -0
  513. package/packs/fhfa/policy.json +109 -0
  514. package/packs/fhfa/source.md +108 -0
  515. package/packs/fred/assets/download_fred.ps1 +122 -0
  516. package/packs/fred/assets/download_fred.sh +123 -0
  517. package/packs/fred/docs/analysis_patterns.md +124 -0
  518. package/packs/fred/docs/fred_api.md +94 -0
  519. package/packs/fred/docs/series.md +188 -0
  520. package/packs/fred/policy.json +253 -0
  521. package/packs/fred/source.md +142 -0
  522. package/packs/fsa/endpoints.json +150 -0
  523. package/packs/fsa/policy.json +99 -0
  524. package/packs/fsa/source.md +102 -0
  525. package/packs/govinfo/endpoints.json +520 -0
  526. package/packs/govinfo/policy.json +116 -0
  527. package/packs/govinfo/source.md +241 -0
  528. package/packs/gsa-calc/endpoints.json +93 -0
  529. package/packs/gsa-calc/policy.json +97 -0
  530. package/packs/gsa-calc/source.md +108 -0
  531. package/packs/hud/endpoints.json +147 -0
  532. package/packs/hud/policy.json +84 -0
  533. package/packs/hud/source.md +97 -0
  534. package/packs/ipums/assets/download_ipums.ps1 +215 -0
  535. package/packs/ipums/assets/download_ipums.sh +192 -0
  536. package/packs/ipums/docs/ipums_api.md +67 -0
  537. package/packs/ipums/docs/report_patterns.md +117 -0
  538. package/packs/ipums/docs/variables.md +284 -0
  539. package/packs/ipums/lib/fetch_text.json +112 -0
  540. package/packs/ipums/policy.json +215 -0
  541. package/packs/ipums/source.md +169 -0
  542. package/packs/irs-soi/endpoints.json +114 -0
  543. package/packs/irs-soi/policy.json +107 -0
  544. package/packs/irs-soi/source.md +124 -0
  545. package/packs/medicaid/endpoints.json +412 -0
  546. package/packs/medicaid/policy.json +108 -0
  547. package/packs/medicaid/source.md +136 -0
  548. package/packs/naep/endpoints.json +217 -0
  549. package/packs/naep/policy.json +100 -0
  550. package/packs/naep/source.md +120 -0
  551. package/packs/nhtsa/endpoints.json +132 -0
  552. package/packs/nhtsa/policy.json +93 -0
  553. package/packs/nhtsa/source.md +109 -0
  554. package/packs/nih/endpoints.json +453 -0
  555. package/packs/nih/policy.json +86 -0
  556. package/packs/nih/source.md +108 -0
  557. package/packs/noaa/endpoints.json +432 -0
  558. package/packs/noaa/policy.json +95 -0
  559. package/packs/noaa/source.md +88 -0
  560. package/packs/nrel/endpoints.json +328 -0
  561. package/packs/nrel/policy.json +96 -0
  562. package/packs/nrel/source.md +91 -0
  563. package/packs/nws/endpoints.json +272 -0
  564. package/packs/nws/policy.json +82 -0
  565. package/packs/nws/source.md +81 -0
  566. package/packs/nyfed/endpoints.json +80 -0
  567. package/packs/nyfed/policy.json +92 -0
  568. package/packs/nyfed/source.md +89 -0
  569. package/packs/omb/endpoints.json +460 -0
  570. package/packs/omb/policy.json +106 -0
  571. package/packs/omb/source.md +130 -0
  572. package/packs/open-payments/endpoints.json +298 -0
  573. package/packs/open-payments/policy.json +101 -0
  574. package/packs/open-payments/source.md +99 -0
  575. package/packs/opm/assets/download_opm.ps1 +125 -0
  576. package/packs/opm/assets/download_opm.sh +85 -0
  577. package/packs/opm/docs/fields.md +184 -0
  578. package/packs/opm/docs/opm_api.md +71 -0
  579. package/packs/opm/docs/report_patterns.md +83 -0
  580. package/packs/opm/lib/data_dictionary.csv +73 -0
  581. package/packs/opm/policy.json +142 -0
  582. package/packs/opm/source.md +137 -0
  583. package/packs/pbgc/endpoints.json +483 -0
  584. package/packs/pbgc/policy.json +94 -0
  585. package/packs/pbgc/source.md +95 -0
  586. package/packs/philfed/endpoints.json +85 -0
  587. package/packs/philfed/policy.json +94 -0
  588. package/packs/philfed/source.md +125 -0
  589. package/packs/port.json +287 -0
  590. package/packs/regulations/endpoints.json +288 -0
  591. package/packs/regulations/policy.json +86 -0
  592. package/packs/regulations/source.md +84 -0
  593. package/packs/sec/endpoints.json +237 -0
  594. package/packs/sec/policy.json +86 -0
  595. package/packs/sec/source.md +101 -0
  596. package/packs/senate-lobbying/endpoints.json +554 -0
  597. package/packs/senate-lobbying/policy.json +99 -0
  598. package/packs/senate-lobbying/source.md +100 -0
  599. package/packs/snapqc/endpoints.json +1426 -0
  600. package/packs/snapqc/policy.json +92 -0
  601. package/packs/snapqc/source.md +96 -0
  602. package/packs/treasury/catalog.json +2267 -0
  603. package/packs/treasury/docs/api_guide.md +245 -0
  604. package/packs/treasury/docs/datasets.md +56 -0
  605. package/packs/treasury/docs/report_patterns.md +126 -0
  606. package/packs/treasury/policy.json +159 -0
  607. package/packs/treasury/source.md +170 -0
  608. package/packs/treasury-yields/endpoints.json +226 -0
  609. package/packs/treasury-yields/policy.json +86 -0
  610. package/packs/treasury-yields/source.md +80 -0
  611. package/packs/usaspending/endpoints.json +1316 -0
  612. package/packs/usaspending/policy.json +109 -0
  613. package/packs/usaspending/source.md +103 -0
  614. package/packs/usda-fna/endpoints.json +427 -0
  615. package/packs/usda-fna/policy.json +133 -0
  616. package/packs/usda-fna/source.md +217 -0
  617. package/packs/usda-fooddata/endpoints.json +181 -0
  618. package/packs/usda-fooddata/policy.json +94 -0
  619. package/packs/usda-fooddata/source.md +105 -0
  620. package/packs/usda-nass/endpoints.json +324 -0
  621. package/packs/usda-nass/policy.json +95 -0
  622. package/packs/usda-nass/source.md +85 -0
  623. package/packs/usda-outlook/endpoints.json +86 -0
  624. package/packs/usda-outlook/policy.json +109 -0
  625. package/packs/usda-outlook/source.md +144 -0
  626. package/packs/usgs/endpoints.json +313 -0
  627. package/packs/usgs/policy.json +95 -0
  628. package/packs/usgs/source.md +96 -0
  629. package/packs/usitc/endpoints.json +74 -0
  630. package/packs/usitc/policy.json +111 -0
  631. package/packs/usitc/source.md +90 -0
  632. package/packs/uspto/endpoints.json +141 -0
  633. package/packs/uspto/policy.json +95 -0
  634. package/packs/uspto/source.md +101 -0
  635. package/packs/va/endpoints.json +414 -0
  636. package/packs/va/policy.json +101 -0
  637. package/packs/va/source.md +129 -0
  638. package/packs/world-bank/endpoints.json +122 -0
  639. package/packs/world-bank/policy.json +101 -0
  640. package/packs/world-bank/source.md +93 -0
@@ -0,0 +1,167 @@
1
+ /** The report tools. server.ts registers every entry of TOOLS. */
2
+ import fs from "node:fs";
3
+ import path from "node:path";
4
+ import { z } from "zod";
5
+ import { fail } from "../envelope.js";
6
+ import * as AA from "./audit_answer.js";
7
+ import * as AR from "./audit_report.js";
8
+ import { build, BuildError } from "./build_report.js";
9
+ import { NOTES } from "./method_audit.js";
10
+ import { SourceError } from "./policyset.js";
11
+ import { scanWorkspace } from "./scan_secrets.js";
12
+ import { styleCheck } from "./style_check.js";
13
+ const checks = (results) => results.map(([check, ok, message]) => ({ check, status: ok ? "PASS" : "FAIL", message }));
14
+ function readReport(s) {
15
+ const p = path.join(s.workspace, "report.json");
16
+ if (!fs.existsSync(p)) {
17
+ throw fail("not_found", "report.json is not in the workspace", "Call build_report with the report object first.");
18
+ }
19
+ try {
20
+ return JSON.parse(fs.readFileSync(p, "utf8").replace(/^/, ""));
21
+ }
22
+ catch (e) {
23
+ throw fail("invalid_request", `report.json is not valid JSON: ${e.message}`, "Call build_report with a valid report object.");
24
+ }
25
+ }
26
+ async function guarded(fn) {
27
+ try {
28
+ return await fn();
29
+ }
30
+ catch (e) {
31
+ if (e instanceof BuildError || e instanceof SourceError) {
32
+ throw fail("invalid_request", e.message, "Fix report.json, the facts or the workspace as the message says, then call the tool again.");
33
+ }
34
+ if (e instanceof SyntaxError) {
35
+ throw fail("invalid_request", `a workspace JSON file is not valid: ${e.message}`, "Rewrite the file the message names (record_decisions, facts) and call the tool again.");
36
+ }
37
+ throw e;
38
+ }
39
+ }
40
+ export async function auditAnswerTool(s, a) {
41
+ if (typeof a.answer !== "string" || !a.answer.trim()) {
42
+ throw fail("invalid_request", "answer is empty", "Pass the reply exactly as you will send it to the user.");
43
+ }
44
+ const p = path.join(s.workspace, "answer.md");
45
+ fs.writeFileSync(p, a.answer.endsWith("\n") ? a.answer : a.answer + "\n", "utf8");
46
+ return guarded(async () => {
47
+ NOTES.length = 0;
48
+ const results = await AA.audit(s.workspace, !!a.online, !!a.rerun);
49
+ const out = AA.printed(results, AA.CHECKS, a.answer, NOTES);
50
+ return { status: "ok", summary: out.verdict, passed: out.passed, checks: checks(results), report: out.lines.join("\n"),
51
+ files: [p], notes: [...NOTES],
52
+ next: out.passed ? "Send the answer exactly as audited (with every disclosure line it carries)."
53
+ : "Fix every FAIL (each message says what to do), then call audit_answer again with the revised reply. Never send an answer that failed." };
54
+ });
55
+ }
56
+ export async function buildReportTool(s, a) {
57
+ if (!a.report || typeof a.report !== "object" || Array.isArray(a.report)) {
58
+ throw fail("invalid_request", "report must be a report.json object", "Pass the report as an object (title, sections, exhibits, ...).");
59
+ }
60
+ const p = path.join(s.workspace, "report.json");
61
+ fs.writeFileSync(p, JSON.stringify(a.report, null, 2), "utf8");
62
+ return guarded(() => {
63
+ const r = build(p);
64
+ return { status: "ok", summary: { mode: r.mode, sources: r.sources, exhibits: r.exhibits, facts_cited: r.facts_cited,
65
+ bytes: r.bytes, external_refs: r.external_refs, package_members: r.package.members, left_out: r.package.left_out,
66
+ notices: r.notices }, files: [r.report, r.package.file, p], notes: r.notes,
67
+ next: "Call audit_report (rerun: true) before handing the report to the user; fix every FAIL and rebuild." };
68
+ });
69
+ }
70
+ export async function auditReportTool(s, a) {
71
+ readReport(s);
72
+ return guarded(async () => {
73
+ NOTES.length = 0;
74
+ const results = await AR.audit(path.join(s.workspace, "report.json"), undefined, !!a.online, !!a.rerun);
75
+ const out = AA.printed(results, AR.CHECKS, "", NOTES);
76
+ return { status: "ok", summary: out.verdict, passed: out.passed, checks: checks(results), report: out.lines.join("\n"),
77
+ files: [path.join(s.workspace, "report.html")], notes: [...NOTES],
78
+ next: out.passed ? "Hand the report and replication_package.zip to the user."
79
+ : "Fix every FAIL, call build_report again, then audit_report again." };
80
+ });
81
+ }
82
+ export function styleCheckTool(s, a) {
83
+ const R = a.report && typeof a.report === "object" ? a.report : readReport(s);
84
+ const r = styleCheck(R, a.min);
85
+ return { status: "ok", summary: r.summary, passed: r.pass, score: r.score, target: r.target, sentences: r.sentences,
86
+ compliant: r.compliant, issues: r.issues, files: [], notes: [] };
87
+ }
88
+ export function scanSecretsTool(s, a) {
89
+ const r = scanWorkspace(s.workspace, a.sources);
90
+ return { status: "ok", summary: r.message, passed: r.ok, files_scanned: r.files, hits: r.hits, files: [], notes: [] };
91
+ }
92
+ export const TOOLS = [
93
+ {
94
+ name: "audit_answer",
95
+ title: "Audit a quick answer",
96
+ description: "The release gate for a quick answer: call it with the reply exactly as you will send it, after the facts, " +
97
+ "decisions, references (cite) and exhibits/benchmark.csv are in the workspace. It saves the reply as answer.md and " +
98
+ "checks that every number in it is a registered fact as its format prints it (or a credited published figure, or in " +
99
+ "decisions.json audit_allow), that directions, years, rows and names match those facts, that dollar comparisons " +
100
+ "across years state nominal or real, the method record (questions, literature, disclosures, references opened, " +
101
+ "assumptions, sensitivity, data needs, benchmark), provenance, links (online: true requests them) and secrets; " +
102
+ "rerun: true replays every exhibit recipe and fact. Returns every check with PASS/FAIL and its message, and " +
103
+ "\"AUDIT PASSED\" only when nothing fails. Send the answer only after it passes.",
104
+ inputSchema: {
105
+ answer: z.string().describe("The reply as it will be sent (Markdown)"),
106
+ online: z.boolean().optional().describe("Also request every external link"),
107
+ rerun: z.boolean().optional().describe("Replay every exhibit recipe and recompute every fact"),
108
+ },
109
+ annotations: { readOnlyHint: false, idempotentHint: true, openWorldHint: true },
110
+ handler: auditAnswerTool,
111
+ },
112
+ {
113
+ name: "build_report",
114
+ title: "Build the report",
115
+ description: "Build a self-contained HTML report or paper (report.html) and replication_package.zip from a report.json " +
116
+ "object (mode report: an exhibit chartbook; mode paper: prose-led). Facts are cited as {{name}} or {{name|fmt}}, " +
117
+ "references as [@id], footnotes as [^n]; exhibits name a CSV in exhibits/ and a chart {type, x, y, series, ...}. " +
118
+ "Each source's notices, Data Vintage block and redistribution rules are applied (microdata and withheld rows never " +
119
+ "enter the ZIP). Returns the report.html and ZIP paths; call audit_report next.",
120
+ inputSchema: {
121
+ report: z.record(z.string(), z.any()).describe("The report.json object (title, mode, sources, at_a_glance, sections, exhibits, methods, ...)"),
122
+ },
123
+ annotations: { readOnlyHint: false, idempotentHint: true, openWorldHint: false },
124
+ handler: buildReportTool,
125
+ },
126
+ {
127
+ name: "audit_report",
128
+ title: "Audit the report",
129
+ description: "The release gate for a report built with build_report: facts, hand-typed numbers, exhibits, links (online: " +
130
+ "true requests them), the page (up to date, disclaimer, nothing external, no raw markup), vintage, each source's " +
131
+ "notices and audit hooks, clearances, secrets, style, chartbook structure, the method record, benchmarks and the " +
132
+ "replication package; rerun: true replays every exhibit recipe and fact. Returns every check with PASS/FAIL and its " +
133
+ "message, and \"AUDIT PASSED\" only when nothing fails.",
134
+ inputSchema: {
135
+ online: z.boolean().optional().describe("Also request every external link"),
136
+ rerun: z.boolean().optional().describe("Replay every exhibit recipe and recompute every fact"),
137
+ },
138
+ annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
139
+ handler: auditReportTool,
140
+ },
141
+ {
142
+ name: "style_check",
143
+ title: "Check the report's style",
144
+ description: "Lint the prose of report.json (or the report object given) against the house style guide: percent in " +
145
+ "words, no first person, small numbers spelled out, plain words, sentence length. Returns the score (percent of " +
146
+ "sentences with no issue; target 90) and every sentence with its issues. Nothing is written into the report.",
147
+ inputSchema: {
148
+ report: z.record(z.string(), z.any()).optional().describe("A report.json object; default: the workspace's report.json"),
149
+ min: z.number().optional().describe("The target score (default 90)"),
150
+ },
151
+ annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
152
+ handler: styleCheckTool,
153
+ },
154
+ {
155
+ name: "scan_secrets",
156
+ title: "Scan for keys",
157
+ description: "Check every workspace file (and every member of a ZIP) for an API key or credential: the value of any key " +
158
+ "this server can find, key-shaped assignments and URL parameters, and for sources that echo keys any 32-hex token. " +
159
+ "Lists file names and line numbers only, never values. Both audits run it too.",
160
+ inputSchema: {
161
+ sources: z.array(z.string()).optional().describe("Source ids used (default: the data/<id>/ folders)"),
162
+ },
163
+ annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
164
+ handler: scanSecretsTool,
165
+ },
166
+ ];
167
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/report/tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import { Session } from "./session.js";
3
+ export declare const VERSION = "0.3.1";
4
+ export declare const INSTRUCTIONS = "Live U.S. government data, fetched from the agency at call time; every result is cited.\nNever answer a U.S. government data question from memory, and never estimate, simulate or \"illustrate\" a number:\nif no source can answer, say so.\n\nWorkflow: find_sources(question) -> source_brief(id) -> ask the user -> record_decisions -> request_schema(id,\nnames) -> fetch(id, spec) -> compute -> facts -> audit_answer (send only after AUDIT PASSED). guide() has the\nfull method (framing, literature, accuracy checklist, combining sources, the answer, reports). When a question\nspans agencies, source_brief's paired_with names the usual cross-checks: fetch both and compare.\n\nAsk before you fetch. source_brief returns questions_to_ask: the choices that change a headline number. Ask\nthe ones the request leaves open in ONE round (at most 4 questions, each with exactly one \"Don't know \u2014 decide\nfor me\" option, your recommended option first), with your question tool when you have one. A blocking question\n(what the user means: which program, place, population) that is skipped is asked once more. Record every\nquestion with record_decisions; fetch refuses until they are settled (gate_blocked says what is missing).\n\nErrors carry a code and a fix: follow the fix, never repeat a call unchanged, never present a failure as data.\nKeys are never asked for in chat: key_missing gives the user a command or page to store a key themselves.\n\nCitations: cite page_url and the citation text with its retrieval date; copy every notice word for word.\nRead the playbook's traps before interpreting a number; surface revisions, preliminary values, sampling error\nand definition changes unprompted.";
5
+ export declare function createServer(session?: Session): McpServer;
package/dist/server.js ADDED
@@ -0,0 +1,247 @@
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.1";
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
+ "(sensitivity: the parameter of its exhibits/sensitivity.csv row, only when that differs from the assumption's parameter)"),
173
+ data_needs: z.array(z.record(z.string(), z.any())).optional()
174
+ .describe("[{id, data, improves: [...], effect, how_to_get, from_user}]"),
175
+ data_needs_note: z.string().optional().describe("Why no data would help, with data_needs: []"),
176
+ audit_allow: z.array(z.object({ value: z.string(), reason: z.string() })).optional()
177
+ .describe("Numbers in the answer that are not statistics (a bill number, a count of sources)"),
178
+ dollar_basis_ok: z.object({ reason: z.string() }).optional(),
179
+ rounding_ties_ok: z.array(z.object({ fact: z.string(), reason: z.string() })).optional(),
180
+ },
181
+ annotations: { readOnlyHint: false, idempotentHint: true, openWorldHint: false },
182
+ }, wrap(s, T.recordDecisions));
183
+ server.registerTool("check_key", {
184
+ title: "Check key",
185
+ description: "Whether a source's API key is set up (never shows the key) and, if not, what the user does.",
186
+ inputSchema: { source: z.string() },
187
+ annotations: READ,
188
+ }, wrap(s, T.checkKey));
189
+ server.registerTool("fetch", {
190
+ title: "Fetch data",
191
+ description: "Download data from the agency into this session's workspace (CSV per request, data dictionary, " +
192
+ "README with the citation and terms, request.json with every URL made). Returns a summary (rows, columns, a " +
193
+ "few rows), the files, the citation and notes; status partial when a row cap was hit. Refuses (gate_blocked) " +
194
+ "until source_brief, request_schema and record_decisions are done for this source.",
195
+ inputSchema: { source: z.string(), spec: specSchema, force: z.boolean().optional().describe("Fetch again even if the workspace has this exact request") },
196
+ annotations: NET,
197
+ }, wrap(s, T.fetchData));
198
+ server.registerTool("manual_bundle", {
199
+ title: "Manual download bundle",
200
+ description: "When this server cannot get the data (no key stored here, a host that refuses scripts, a network " +
201
+ "block): write one bundle for one or more sources with download scripts (.sh and .ps1, every request built in, any " +
202
+ "key asked with hidden input on the user's own computer) and INSTRUCTIONS.md. Then ingest the files the user downloads.",
203
+ inputSchema: { sources: z.array(z.object({ source: z.string(), spec: specSchema })).min(1),
204
+ reason: z.string().optional().describe("Why the user downloads by hand (shown in INSTRUCTIONS.md)") },
205
+ annotations: { readOnlyHint: false, openWorldHint: false },
206
+ }, wrap(s, T.manualBundle));
207
+ server.registerTool("ingest", {
208
+ title: "Ingest downloaded files",
209
+ description: "Package files the user downloaded (from manual_bundle, a keyless_file, or the agency's site) like a " +
210
+ "fetch: CSVs, data dictionary, README and provenance. The same gate as fetch applies.",
211
+ inputSchema: { source: z.string(), spec: specSchema,
212
+ files: z.array(z.string()).min(1).describe("Paths of the downloaded files or their folder") },
213
+ annotations: { readOnlyHint: false, openWorldHint: false },
214
+ }, wrap(s, T.ingest));
215
+ server.registerTool("read_file", {
216
+ title: "Read workspace file",
217
+ description: "A text file from this session's workspace (a fetched CSV, README, request.json), up to 100 KB.",
218
+ inputSchema: { path: z.string().describe("Relative to the workspace, or a path a fetch result listed"),
219
+ max_bytes: z.number().optional() },
220
+ annotations: READ,
221
+ }, wrap(s, T.readFile));
222
+ for (const t of [...ANALYSIS_TOOLS, ...REPORT_TOOLS]) {
223
+ server.registerTool(t.name, { title: t.title, description: t.description, inputSchema: t.inputSchema,
224
+ annotations: t.annotations ?? { readOnlyHint: false, openWorldHint: false } }, wrap(s, t.handler));
225
+ }
226
+ server.registerPrompt("analyze", {
227
+ title: "Analyze with U.S. government data",
228
+ description: "Start a data question with the full method (asks the critical questions before fetching).",
229
+ argsSchema: { question: z.string().describe("The question to answer") },
230
+ }, ({ question }) => ({
231
+ messages: [{ role: "user", content: { type: "text",
232
+ text: `${fs.readFileSync(path.join(GUIDE_DIR, "WORKFLOW.md"), "utf8")}\n\n---\n\nQuestion: ${question}` } }],
233
+ }));
234
+ server.registerResource("source", new ResourceTemplate("source://{id}", {
235
+ list: () => ({ resources: packIds().map((id) => ({ uri: `source://${id}`, name: `${id} playbook`, mimeType: "text/markdown" })) }),
236
+ }), { title: "Source playbook", description: "A source pack's source.md", mimeType: "text/markdown" }, (uri, { id }) => {
237
+ const pid = String(id);
238
+ if (!packIds().includes(pid))
239
+ throw new Error(`unknown source ${pid}`);
240
+ return { contents: [{ uri: uri.href, mimeType: "text/markdown", text: fs.readFileSync(path.join(PACKS_DIR, pid, "source.md"), "utf8") }] };
241
+ });
242
+ server.registerResource("guide", "guide://workflow", { title: "Method guide", mimeType: "text/markdown" }, (uri) => ({
243
+ contents: [{ uri: uri.href, mimeType: "text/markdown", text: fs.readFileSync(path.join(GUIDE_DIR, "WORKFLOW.md"), "utf8") }],
244
+ }));
245
+ return server;
246
+ }
247
+ //# sourceMappingURL=server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
@@ -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
+ }
@@ -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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"}