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.
Files changed (640) hide show
  1. package/README.md +262 -3
  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 +710 -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 +21 -0
  396. package/dist/report/scan_secrets.js +234 -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 +246 -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 +56 -6
  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 +165 -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,86 @@
1
+ {
2
+ "base_url": "https://www.ers.usda.gov",
3
+ "timeout": 90,
4
+ "endpoints": {
5
+ "wasde": {
6
+ "path": "https://www.usda.gov/sites/default/files/documents/oce-wasde-report-data-{report}.csv",
7
+ "description": "World Agricultural Supply and Demand Estimates (WASDE), one monthly report (or a range of reports) as USDA's long-format CSV: one row per report table, commodity, region, attribute and marketing year, with Value, Unit and ProjEstFlag (Proj. = projection, Est. = estimate, blank = history). January 2021 report on. The pack filters the rows by the spec's commodity, region, attribute, report_title, market_year and proj_est.",
8
+ "params": {
9
+ "report": {"in": "spec", "desc": "report month YYYY-MM (2021-01 on), or \"latest\" (default: the newest report listed on USDA ESMIS whose CSV is posted)"},
10
+ "start_report": {"in": "spec", "desc": "first report month YYYY-MM of a range (with end_report; one CSV per month, at most 72): for month-to-month revisions"},
11
+ "end_report": {"in": "spec", "desc": "last report month YYYY-MM of a range (default: latest)"},
12
+ "commodity": {"in": "spec", "desc": "Commodity as published, case-insensitive, one or a list: Corn, Wheat, \"Oilseed, Soybean\", \"Meal, Soybean\", \"Oil, Soybean\", Cotton, Rice, \"Rice, milled\", Sorghum, Barley, Oats, Sugar, Beef, Pork, Broiler, Turkey, Eggs, Milk, Coarse Grains ... (names differ by table)"},
13
+ "region": {"in": "spec", "desc": "Region as published: United States, World, Foreign, a country (Brazil, China, European Union ...) or group (Major Exporters)"},
14
+ "attribute": {"in": "spec", "desc": "Attribute as published: Ending Stocks, Production, Exports, Imports, Beginning Stocks, Feed and Residual, Avg. Farm Price, Area Planted, Yield per Harvested Acre, Domestic, Total ..."},
15
+ "report_title": {"in": "spec", "desc": "ReportTitle (the report table), e.g. \"U.S. Feed Grain and Corn Supply and Use\", \"World Corn Supply and Use\"; the same item appears in several tables in different units"},
16
+ "market_year": {"in": "spec", "desc": "MarketYear as published: 2026/27 for crops, 2026 for livestock (calendar year)"},
17
+ "proj_est": {"in": "spec", "enum": ["proj", "est", "none"], "desc": "proj = projections (Proj.), est = estimates (Est.), none = rows with no flag (history and the reliability tables)"},
18
+ "include_reliability": {"in": "spec", "desc": "true keeps the 'Reliability of ... Projections' tables (past forecast errors); default false drops them"}
19
+ },
20
+ "records": "$csv",
21
+ "paging": {"type": "none"}
22
+ },
23
+ "farm_income": {
24
+ "path": "/data-products/farm-income-and-wealth-statistics/data-files-us-and-state-level-farm-income-and-wealth-statistics",
25
+ "description": "ERS Farm Income and Wealth Statistics, one release (default: the latest, scraped from the data-files page): U.S. and state farm income statement, cash receipts by commodity, government payments, production expenses, balance sheet (assets, debt, equity) and ratios, 1910 on (states 1949 on), current-year forecast. Nominal dollars ($1,000) with ChainType_GDP_Deflator; the pack streams the 111 MB CSV inside the release ZIP and keeps only the rows the spec asks for.",
26
+ "params": {
27
+ "release": {"in": "spec", "desc": "\"latest\" (default) or a release date: YYYY-MM-DD or YYYY-MM (2014-08 on; releases are in February, late August/early September and late November/early December)"},
28
+ "variable": {"in": "spec", "desc": "VariableDescriptionTotal as published, case-insensitive, one or a list: \"Net farm income\", \"Net cash income\", \"Cash receipts value, all commodities , all\" (sic), \"Value of government payments, total\", \"Dec. 31 value of farm equity, all, excl. operator dwelling\" ..."},
29
+ "key": {"in": "spec", "desc": "artificialKey, one or a list: FIAUSNTFI--P (U.S. net farm income), FIAUSNTCI--P (U.S. net cash income); the 3rd-4th letters are the state"},
30
+ "search": {"in": "spec", "desc": "case-insensitive text that VariableDescriptionTotal must contain (to discover variables: e.g. \"government payments\")"},
31
+ "state": {"in": "spec", "desc": "US or a two-letter state code, one or a list (default: all)"},
32
+ "year": {"in": "spec", "desc": "one calendar year"},
33
+ "start_year": {"in": "spec", "desc": "first calendar year"},
34
+ "end_year": {"in": "spec", "desc": "last calendar year"}
35
+ },
36
+ "records": "$zip:*.csv",
37
+ "paging": {"type": "none"}
38
+ },
39
+ "farm_income_summary": {
40
+ "path": "/data-products/farm-income-and-wealth-statistics/data-files-us-and-state-level-farm-income-and-wealth-statistics",
41
+ "description": "The 'U.S. farm sector financial indicators' table of the latest release (one small .xlsx, billion dollars, last eight years with the forecast year marked F, e.g. 2026F, plus percent changes): cash income statement, farm income statement, balance sheet, debt by lender, debt-to-equity and debt-to-asset ratios. One row per line item with section and unit.",
42
+ "params": {},
43
+ "records": "$xlsx",
44
+ "paging": {"type": "none"}
45
+ },
46
+ "farm_income_archive": {
47
+ "path": "/data-products/farm-income-and-wealth-statistics/data-files-us-and-state-level-farm-income-and-wealth-statistics",
48
+ "description": "ERS archive of past forecasts and estimates (U.S. only): every release's value of net farm income (nfi), net cash income (nci) and cash receipts (cr_all) for each year, first 15 releases per year, February 1977 release on. For forecast accuracy and revision paths.",
49
+ "params": {
50
+ "item": {"in": "spec", "enum": ["nfi", "nci", "cr_all"], "desc": "nfi = net farm income, nci = net cash income, cr_all = cash receipts, all commodities (default: all three)"},
51
+ "year": {"in": "spec", "desc": "one calendar year being forecast or estimated"},
52
+ "start_year": {"in": "spec", "desc": "first year"},
53
+ "end_year": {"in": "spec", "desc": "last year"}
54
+ },
55
+ "records": "$zip:archive.csv",
56
+ "paging": {"type": "none"}
57
+ },
58
+ "baseline": {
59
+ "path": "/data-products/agricultural-baseline-database",
60
+ "description": "USDA Agricultural Projections (the 10-year baseline of the Interagency Agricultural Projections Committee), one edition's ZIP: by default its machine-readable Projections<year>.csv (one row per commodity, attribute and year: supply and use, area, yield, prices for crops; production, use and prices for livestock and dairy), or one of its .xlsx tables (farm income, trade, macro assumptions ...).",
61
+ "params": {
62
+ "edition": {"in": "spec", "desc": "\"latest\" (default: the most recent full release), \"early\" (the most recent early release, before the report), or the last projection year, e.g. 2035 or 2034 (projections to that year; full release)"},
63
+ "member": {"in": "spec", "desc": "file in the ZIP, a glob (case-insensitive): default \"Projections*.csv\"; e.g. \"*Farm receipts*\" for Table 26 (farm income), \"*Feed Grains*\", \"*Macroeoconomic*\" (sic, as published)"},
64
+ "sheet": {"in": "spec", "desc": ".xlsx member: sheet name or 1-based number (default 1)"},
65
+ "header_row": {"in": "spec", "desc": ".xlsx member: 1-based row holding the column names (default: the first row with three or more filled cells)"},
66
+ "commodity": {"in": "spec", "desc": "CSV member: commodity as published, case-insensitive, one or a list (Corn, Wheat, Soybeans, Upland Cotton, Beef, Pork, Broilers ...)"},
67
+ "attribute": {"in": "spec", "desc": "CSV member: attribute as published (Ending stocks, Planted acres, Farm price ...)"},
68
+ "year": {"in": "spec", "desc": "CSV member: year as published (2030/31 for marketing years, 2030 for calendar years), one or a list"}
69
+ },
70
+ "records": "$zip:Projections*.csv",
71
+ "paging": {"type": "none"}
72
+ }
73
+ },
74
+ "catalog": {
75
+ "wasde": {"id": "wasde", "endpoint": "wasde", "name": "WASDE monthly supply and use projections",
76
+ "description": "World Agricultural Supply and Demand Estimates: U.S. and world supply, use, ending stocks, prices for grains, oilseeds, cotton, rice, sugar, livestock, poultry, dairy; monthly, 2021 on"},
77
+ "farm_income": {"id": "farm_income", "endpoint": "farm_income", "name": "ERS farm income and wealth statistics (U.S. and states)",
78
+ "description": "net farm income, net cash farm income, cash receipts by commodity, government payments, expenses, farm assets, debt, equity; annual 1910 on with the current-year forecast"},
79
+ "farm_income_summary": {"id": "farm_income_summary", "endpoint": "farm_income_summary", "name": "U.S. farm sector financial indicators (latest forecast table)",
80
+ "description": "one-page summary of the latest farm income forecast in billion dollars, with the forecast year marked F"},
81
+ "farm_income_archive": {"id": "farm_income_archive", "endpoint": "farm_income_archive", "name": "Archive of past farm income forecasts",
82
+ "description": "net farm income, net cash income and cash receipts as forecast and estimated in each release since 1977: forecast accuracy, revisions"},
83
+ "baseline": {"id": "baseline", "endpoint": "baseline", "name": "USDA Agricultural Projections (10-year baseline)",
84
+ "description": "long-term projections of U.S. crop and livestock supply, use, prices, farm income and trade, ten years ahead, under current law"}
85
+ }
86
+ }
@@ -0,0 +1,109 @@
1
+ {
2
+ "id": "usda-outlook",
3
+ "title": "USDA forecasts and projections (WASDE, ERS farm income forecasts, USDA Agricultural Baseline)",
4
+ "agency": "U.S. Department of Agriculture: World Agricultural Outlook Board (WAOB, Office of the Chief Economist) and Economic Research Service (ERS)",
5
+ "depth": "standard",
6
+ "domains": [
7
+ "agriculture",
8
+ "food",
9
+ "economy"
10
+ ],
11
+ "keywords": [
12
+ "wasde",
13
+ "world agricultural supply and demand estimates",
14
+ "supply and use",
15
+ "ending stocks",
16
+ "stocks-to-use",
17
+ "season-average farm price",
18
+ "marketing year",
19
+ "crop forecast",
20
+ "usda projection",
21
+ "farm income",
22
+ "net farm income",
23
+ "net cash farm income",
24
+ "cash receipts",
25
+ "farm sector balance sheet",
26
+ "farm debt",
27
+ "farm equity",
28
+ "government payments to farmers",
29
+ "farm income forecast",
30
+ "agricultural baseline",
31
+ "usda baseline",
32
+ "long-term agricultural projections",
33
+ "ten-year projections",
34
+ "interagency agricultural projections committee",
35
+ "corn",
36
+ "soybeans",
37
+ "wheat",
38
+ "cotton",
39
+ "rice",
40
+ "beef",
41
+ "pork",
42
+ "poultry",
43
+ "dairy"
44
+ ],
45
+ "questions": [
46
+ "latest USDA projection of U.S. corn ending stocks for the current marketing year",
47
+ "how the WASDE soybean export forecast changed from month to month",
48
+ "world wheat production forecast by country",
49
+ "USDA's 2026 net farm income forecast, nominal and inflation-adjusted",
50
+ "farm income by state",
51
+ "how accurate were past net farm income forecasts",
52
+ "USDA 10-year baseline projection of corn planted acres and prices"
53
+ ],
54
+ "homepage": "https://www.usda.gov/about-usda/general-information/staff-offices/office-chief-economist/commodity-markets/wasde-report",
55
+ "terms_url": "https://www.ers.usda.gov/about-ers/policies-and-standards",
56
+ "auth": {
57
+ "env": null,
58
+ "required": "none",
59
+ "placement": "none",
60
+ "param": null,
61
+ "prefix": "",
62
+ "home": null,
63
+ "signup_url": null,
64
+ "echoes_key": false,
65
+ "key_only": []
66
+ },
67
+ "limits": {
68
+ "rps": 1,
69
+ "burst": 3,
70
+ "max_rows": 50000
71
+ },
72
+ "routes": {
73
+ "api": {
74
+ "base": "https://www.ers.usda.gov",
75
+ "probe": "https://www.ers.usda.gov/data-products/agricultural-baseline-database",
76
+ "hosts": [
77
+ "www.usda.gov",
78
+ "esmis.nal.usda.gov",
79
+ "www.ers.usda.gov"
80
+ ]
81
+ },
82
+ "manual": {
83
+ "how": "Download the files in a browser and upload them unchanged. WASDE: the monthly CSV https://www.usda.gov/sites/default/files/documents/oce-wasde-report-data-YYYY-MM.csv (January 2021 on), or for older or missing months the consolidated CSV on the Historical WASDE Report Data page (https://www.usda.gov/oce/commodity-markets/wasde/historical-wasde-report-data). Farm income: the release ZIP ('September 3, 2026 release'), the 'U.S. farm sector financial indicators' .xlsx or the data archive ZIP on https://www.ers.usda.gov/data-products/farm-income-and-wealth-statistics/data-files-us-and-state-level-farm-income-and-wealth-statistics. Baseline: the ZIP under 'File Downloads' on https://www.ers.usda.gov/data-products/agricultural-baseline-database."
84
+ }
85
+ },
86
+ "cache": {
87
+ "mode": "run_only",
88
+ "ttl_hours": null,
89
+ "why": "Each WASDE month and each farm income release is a new vintage that revises the last; data/ is reused per run only."
90
+ },
91
+ "redistribution": {
92
+ "mode": "allowed",
93
+ "why": "WASDE, ERS farm income statistics and the USDA baseline are U.S. government works in the public domain (17 U.S.C. 105); USDA asks for attribution."
94
+ },
95
+ "notices": [],
96
+ "retention": null,
97
+ "citation": "U.S. Department of Agriculture, {dataset}, usda.gov / ers.usda.gov, retrieved {retrieved_long}.",
98
+ "audit_hooks": [],
99
+ "clarify": [
100
+ "Which vintage? WASDE is reissued monthly and ERS farm income forecasts three times a year (February, early September, early December); the default is the latest, and a comparison over time needs one vintage per release.",
101
+ "Nominal or inflation-adjusted dollars? ERS publishes nominal values plus a chain-type GDP price index (latest year = 100); the default is nominal.",
102
+ "Which marketing year (WASDE) or calendar year (farm income)? Marketing years differ by commodity (corn and soybeans September-August, wheat June-May, cotton and rice August-July)."
103
+ ],
104
+ "formats": [
105
+ "csv",
106
+ "xlsx",
107
+ "zip"
108
+ ]
109
+ }
@@ -0,0 +1,144 @@
1
+ # USDA forecasts and projections (WASDE, ERS farm income forecasts, USDA Agricultural Baseline)
2
+ Depth: standard. Key: none. USDA's own outlook numbers: the monthly World Agricultural Supply and Demand
3
+ Estimates (WASDE), the Economic Research Service (ERS) farm income and wealth forecasts and statistics, and the
4
+ 10-year USDA Agricultural Projections (the baseline). Published files only.
5
+
6
+ ## When to use
7
+ - What USDA projects for a commodity this marketing year: U.S. and world production, use, exports, ending stocks,
8
+ season-average farm price (WASDE); how a projection moved from month to month; country detail (world tables).
9
+ - Net farm income, net cash farm income, cash receipts by commodity, government payments, expenses, farm assets,
10
+ debt and equity, U.S. (1910 on) and by state (from 1924 to 2008 depending on the item; net farm income 1949 on), with
11
+ the current-year forecast; how past forecasts compared with the final estimates (farm_income_archive).
12
+ - USDA's 10-year supply, use and price projections and long-term farm income projections (baseline).
13
+ - Not here: survey estimates of acreage, yield, production, inventories, prices received and the Census of
14
+ Agriculture (usda-nass, Quick Stats); food composition (usda-fooddata); food and nutrition assistance programs
15
+ (not this pack); futures prices (not a government source). The ERS API (api.ers.usda.gov, needs an api.data.gov
16
+ key) serves the same farm income data and is not used here.
17
+
18
+ ## Endpoints and datasets
19
+ No key; all files verified live 2026-10-30. Filters are case-insensitive, exact after collapsing spaces, one
20
+ value or a list.
21
+
22
+ | Endpoint | Returns (one row per) | Key parameters | Units, frequency, coverage |
23
+ |---|---|---|---|
24
+ | `wasde` | report table x commodity x region x attribute x marketing year (USDA's long CSV, columns as published: WasdeNumber, ReportDate, ReportTitle, Attribute, ReliabilityProjection, Commodity, Region, MarketYear, ProjEstFlag, AnnualQuarterFlag, Value, Unit, ReleaseDate, ReleaseTime, ForecastYear, ForecastMonth) | `report` (YYYY-MM or `latest`) or `start_report`/`end_report` (a range, at most 72); filters `commodity`, `region`, `attribute`, `report_title`, `market_year`, `proj_est` (`proj`/`est`/`none`), `include_reliability` | Unit column per row (Million Bushels, Million Metric Tons, 480 Lb. Bales, $/bu ...); monthly, January 2021 report on (about 5,000 rows a month) |
25
+ | `farm_income` | year x state x variable of one ERS release, columns as published plus `release_date` and `estimate_type` (forecast/estimate) | `release` (`latest` or YYYY-MM-DD / YYYY-MM, 2014-08 on); one of `variable`, `key` (artificialKey), `search` is required; `state` (US or two-letter); `year` or `start_year`/`end_year` | `Amount` in `unit_desc` ($1,000 nominal; $1,000 per farm; Percent; Ratio), `ChainType_GDP_Deflator` (latest year = 100); annual, three releases a year |
26
+ | `farm_income_summary` | line item of the "U.S. farm sector financial indicators" table of the latest release: `section`, `item`, `unit`, one column per year (forecast year marked `2026F`), percent-change columns | none | billion dollars (or percent: see `unit`; the `Change ...` columns are always percent) |
27
+ | `farm_income_archive` | year x release x item: `year`, `release_year`, `release_month`, `release_number`, `item`, `amount` | `item` (`nfi` net farm income, `nci` net cash income, `cr_all` cash receipts), `year` or `start_year`/`end_year` | $1,000 nominal; U.S. only; every release from February 1977, first 15 releases per year |
28
+ | `baseline` | default: commodity x attribute x year of `Projections<year>.csv` (`year_type`, `year`, `value`, `unit`, `attribute`, `commodity`, `commodity_type`, `year_of_projection`); or the rows of one .xlsx table in the ZIP | `edition` (`latest` full release, `early`, or the last projection year e.g. 2034); `member` (glob, default `Projections*.csv`); CSV filters `commodity`, `attribute`, `year`; .xlsx `sheet`, `header_row` | units per row; one edition a year (early release in December, full report in February), current year plus 10 projection years |
29
+
30
+ Baseline 2035 ZIP members (full release): Projections2026.csv; U.S. Feed Grains, Wheat, Rice, Soybeans and
31
+ products, Upland Cotton, Sugar, Livestock, Dairy, Fruits Nuts and Vegetables projections; U.S. Farm receipts
32
+ expenses and income projections (Table 26); U.S. Agricultural trade long-term fiscal years projections; U.S.
33
+ Acreage and Conservation Reserve Program, U.S. Macroeoconomic (sic), Global GDP, Population and Real Exchange Rate
34
+ assumptions; the report PDF (not read). A wrong `member` fails with the list of members.
35
+
36
+ WASDE report tables (`report_title`): U.S. Feed Grain and Corn / Wheat / Wheat by Class / Rice / Sorghum, Barley,
37
+ and Oats / Soybeans and Products (Domestic Measure) / Cotton / Sugar / Meats / Egg / Milk Supply and Use, U.S.
38
+ Dairy Prices, U.S. Quarterly Animal Product Production, U.S. Quarterly Prices for Animal Products, World and U.S. Supply and Use for Grains /
39
+ Oilseeds / Cotton, World Wheat / Coarse Grain / Corn / Rice (Milled Basis) / Soybean / Soybean Meal / Soybean Oil /
40
+ Cotton Supply and Use, Mexico Sugar, and the "Reliability of ... Projections" tables.
41
+
42
+ ## Spec examples
43
+ ```json
44
+ {"description": "Latest WASDE U.S. corn balance sheet",
45
+ "requests": [
46
+ {"name": "corn_us", "endpoint": "wasde",
47
+ "params": {"report_title": "U.S. Feed Grain and Corn Supply and Use", "commodity": "Corn"}}]}
48
+ ```
49
+ ```json
50
+ {"description": "Month-to-month path of the 2026/27 U.S. corn ending stocks projection",
51
+ "requests": [
52
+ {"name": "corn_es_path", "endpoint": "wasde",
53
+ "params": {"start_report": "2026-05", "end_report": "latest", "report_title": "U.S. Feed Grain and Corn Supply and Use",
54
+ "commodity": "Corn", "attribute": "Ending Stocks", "market_year": "2026/27"}}]}
55
+ ```
56
+ ```json
57
+ {"description": "Net farm income forecast, U.S. and Iowa, latest release; the summary table; past forecasts; baseline corn",
58
+ "requests": [
59
+ {"name": "nfi", "endpoint": "farm_income",
60
+ "params": {"variable": ["Net farm income", "Net cash income"], "state": ["US", "IA"], "start_year": 2000}},
61
+ {"name": "summary", "endpoint": "farm_income_summary", "params": {}},
62
+ {"name": "nfi_vintages", "endpoint": "farm_income_archive", "params": {"item": "nfi", "start_year": 2015}},
63
+ {"name": "baseline_corn", "endpoint": "baseline", "params": {"commodity": "Corn"}},
64
+ {"name": "baseline_income", "endpoint": "baseline", "params": {"member": "*Farm receipts*"}}]}
65
+ ```
66
+ To discover farm income variable names, fetch with `"search": "government payments"` and `"state": "US"`, then
67
+ use the exact `VariableDescriptionTotal` (or `artificialKey`, e.g. FIAUSNTFI--P = U.S. net farm income, FIAUSNTCI--P = U.S. net cash income; "net cash farm income"
68
+ is published as "Net cash income").
69
+
70
+ ## Data format and traps
71
+ - **Projection, estimate, history (WASDE).** Each report covers three marketing years: the current one flagged
72
+ `Proj.` (projection), the one before `Est.` (estimate), and the one before that unflagged (history). The flags
73
+ appear as `(Proj.)`/`(Est.)` in the world-summary and wheat-by-class tables; `proj_est` matches both. Every
74
+ report revises the projection: the CSV holds only that month's value (the PDF/text report also prints the
75
+ previous month's column), so a revision is the difference between two reports (`start_report`/`end_report`).
76
+ Example (verified): 2026/27 U.S. corn ending stocks were 1,567 million bushels in September 2026 and 1,849 in
77
+ October 2026.
78
+ - **The same item appears in several tables, in different units.** U.S. corn ending stocks are in "U.S. Feed
79
+ Grain and Corn Supply and Use" (million bushels) and "World Corn Supply and Use" (million metric tons), and in
80
+ the reliability table (past forecast errors, in percent and years). Always set `report_title`; the fetch notes
81
+ warn when rows come from more than one table. The reliability tables are dropped unless
82
+ `include_reliability` is true. Commodity names differ by table: "Oilseed, Soybean" in the soybean tables,
83
+ "Rice, milled" or "Rice" or "Rice, Rough" for rice, "Coarse Grain" and "Coarse Grains" both occur.
84
+ - **Marketing years differ by commodity** (corn, sorghum and soybeans September-August; wheat, barley and oats
85
+ June-May; rice and cotton August-July; soybean oil and meal October-September); livestock, dairy and sugar
86
+ tables use calendar or fiscal years (`MarketYear` 2026). Quarterly livestock rows carry `AnnualQuarterFlag`
87
+ I-IV. Never compare a marketing-year value with a calendar-year one.
88
+ - **WASDE months.** The CSV series starts with the January 2021 report. There is no October 2025 report (lapse in
89
+ federal funding); the May and June 2026 reports were reissued as corrected v2 reports and have no CSV at the
90
+ usual name (HTTP 404, verified 2026-10-30): a range skips them with a note. `latest` takes the newest report
91
+ date on the ESMIS publication page; USDA posts the CSV the day after the release, so on release day the pack
92
+ falls back to the previous month and says so. Older months: the consolidated CSV (2010-2026) on the Historical
93
+ WASDE Report Data page (browser only; scripts get HTTP 403), uploaded and read with `ingest`; whether it holds the
94
+ reissued May/June 2026 values is unverified.
95
+ - **Farm income forecasts.** ERS releases three times a year (February, late August/early September, late
96
+ November/early December; next: December 2, 2026). A year is forecast in February of that year, updated in
97
+ September, December and the next February, and becomes an estimate in the September release of the next year
98
+ (ERS archive readme). The CSV has no F marker; the pack's `estimate_type` applies that rule to the release date
99
+ (September 2026 release: 2026 forecast, 2025 and earlier estimates). State rows exist only for estimate years
100
+ (none for 2026 in the September 2026 release). There was no December 2025 release (lapse in funding).
101
+ - **Nominal vs inflation-adjusted.** `Amount` is nominal, in thousands of dollars ($1,000) for most items:
102
+ 158353790 = $158.4 billion. Inflation-adjusted (real, latest-year dollars) = Amount x 100 /
103
+ ChainType_GDP_Deflator; ERS's own real figures use this index (2025 net farm income 162614960 x 100 / 97.089 =
104
+ $167.5 billion in 2026 dollars, so the 2026 forecast is $9.1 billion lower in real terms, as ERS reports). The
105
+ deflator is blank for early years. `farm_income_summary` and the archive are nominal only.
106
+ - **Release files.** The release CSV is cp1252 (unit_desc arrives padded with non-breaking spaces; the pack strips
107
+ them) and holds about 470,000 rows (111 MB): the pack streams it and keeps only the asked rows, so a filter is
108
+ required. Releases up to November 2017 are plain CSVs of about 93 MB (slow). Each release revises history back
109
+ several years, so do not mix years from different releases in one series without saying so.
110
+ - **Archive.** `farm_income_archive` is ERS's compendium of past releases (release_number 1 = first forecast,
111
+ 5 = first estimate, up to 15), U.S. only, three items; ERS calls it a research file, not an official record.
112
+ Before August 2014 release months are ERS's assumption (February, August, November).
113
+ - **Baseline is not a forecast.** The USDA Agricultural Projections are a conditional scenario under current law
114
+ and policy and specific macroeconomic, weather and trade assumptions, prepared by the Interagency Agricultural
115
+ Projections Committee; the first years start from the WASDE of the November before (the 2035 edition: November
116
+ 2025). Say "USDA projects under its baseline assumptions", never "USDA forecasts". The early release (December)
117
+ has fewer tables and can differ from the full release (February). `year_of_projection` is the edition year
118
+ (2026 for "projections to 2035"). The CSV is rounded relative to the .xlsx tables (ERS readme).
119
+ - **.xlsx tables.** Read as published, row by row; the header row is the first row with three or more filled cells
120
+ unless `header_row` is given; unit and section labels stay as rows ("Billion dollars", "Cash income
121
+ statement"). Floats are written in their shortest exact form (540.87533065185278 -> 540.875330651853).
122
+
123
+ ## Access
124
+ No key. Hosts: www.usda.gov (WASDE CSVs), esmis.nal.usda.gov (WASDE release dates), www.ers.usda.gov (farm
125
+ income, baseline). Limit used: one request per second. The usda.gov WASDE web pages answer scripts with HTTP 403
126
+ (Akamai bot filter) while the data files answer; the pack reads only the files, ESMIS and the ERS pages, and never
127
+ works around a 403. `fetch` downloads the files; the ERS file links change media ids and are read from the pages
128
+ each run.
129
+
130
+ Manual (a browser; `manual_bundle` writes the links to INSTRUCTIONS.md): WASDE, open
131
+ `https://www.usda.gov/sites/default/files/documents/oce-wasde-report-data-YYYY-MM.csv` for the month (or the
132
+ Historical WASDE Report Data page for the consolidated CSV); farm income, open the data-files page
133
+ (https://www.ers.usda.gov/data-products/farm-income-and-wealth-statistics/data-files-us-and-state-level-farm-income-and-wealth-statistics)
134
+ and download the release ZIP ("September 3, 2026 release"), the "U.S. farm sector financial indicators" .xlsx or
135
+ the data archive ZIP; baseline, open https://www.ers.usda.gov/data-products/agricultural-baseline-database and
136
+ download the ZIP under "Most Recent Full-Release". Upload the files unchanged (agency file names are accepted);
137
+ `ingest` applies the same filters as `fetch`.
138
+
139
+ ## Citation and terms
140
+ U.S. Department of Agriculture, <dataset> (World Agricultural Outlook Board, World Agricultural Supply and Demand
141
+ Estimates, report of <month>; or Economic Research Service, Farm Income and Wealth Statistics, release of <date>;
142
+ or USDA Agricultural Projections to <year>, Interagency Agricultural Projections Committee), usda.gov /
143
+ ers.usda.gov, retrieved <date>. Name the WASDE report month or the ERS release date: each is a vintage. Public
144
+ domain U.S. government works (17 U.S.C. 105); redistribution allowed with attribution.