@dizzlkheinz/ynab-mcpb 0.12.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 (435) hide show
  1. package/.chunkhound.json +11 -0
  2. package/.code/agents/0427d95e-edca-431f-a214-5e53264e29c4/error.txt +8 -0
  3. package/.code/agents/0d675174-d1e1-41c3-9975-4c2e275819a9/error.txt +3 -0
  4. package/.code/agents/0d8c5afd-4787-422b-abf8-2e5943fc7e67/error.txt +3 -0
  5. package/.code/agents/0ec34a70-ed5d-4b9e-bee4-bb0e4cccbc4b/error.txt +1 -0
  6. package/.code/agents/0ef51a21-1ab1-49d7-9561-0eaa43875ebc/error.txt +12 -0
  7. package/.code/agents/15db95d7-abad-4b4d-9c3b-8446089cb61d/error.txt +1 -0
  8. package/.code/agents/19ab9acb-f675-4ff0-902a-09a5476f8149/error.txt +1 -0
  9. package/.code/agents/1ef7e12d-f6ff-4897-8a9b-152d523d898e/error.txt +5 -0
  10. package/.code/agents/2465/exec-call_lroN9KKzJVWC7t5423DK1nT9.txt +1453 -0
  11. package/.code/agents/28edb6fe-95a9-41a0-ae69-aa0100d26c0c/error.txt +8 -0
  12. package/.code/agents/2ae40cf5-b4bf-42e2-92bf-7ea350a7755e/error.txt +9 -0
  13. package/.code/agents/2bfc4e1f-ac4b-45a5-b6df-bf89d4dbb54c/error.txt +1 -0
  14. package/.code/agents/2e2e1134-eff0-49be-ba25-8e2c3468a564/error.txt +5 -0
  15. package/.code/agents/3/exec-call_203OC4TNVkLxW7z2HCVEQ1cM.txt +81 -0
  16. package/.code/agents/3/exec-call_SS5T0XSiXB4LSNzUKTl75wkh.txt +610 -0
  17. package/.code/agents/3322c003-ce5e-48e3-a342-f5049c5bf9a2/error.txt +1 -0
  18. package/.code/agents/391e9b08-1ebc-468c-9bcd-6d0cc3193b37/error.txt +1 -0
  19. package/.code/agents/3ab0aa84-b7bb-4054-afa3-40b8fd7d3be0/error.txt +1 -0
  20. package/.code/agents/3bed368d-50fe-477e-aee3-a6707eaa1ab9/error.txt +3 -0
  21. package/.code/agents/3e40b925-db12-442f-8d7a-a25fc69a6672/error.txt +8 -0
  22. package/.code/agents/414d5776-cf58-41f3-9328-a6daed503a50/error.txt +5 -0
  23. package/.code/agents/42687751-4565-4610-b240-67835b17d861/error.txt +1 -0
  24. package/.code/agents/46b98876-1a39-43c9-9e2f-507ca6d47335/error.txt +9 -0
  25. package/.code/agents/4a7d9491-b26f-43dd-850d-2ecdc49b5d1b/error.txt +1 -0
  26. package/.code/agents/4e60f00a-1b3e-447f-87f3-7faf9deddec3/error.txt +13 -0
  27. package/.code/agents/5138fc1c-4d49-4b74-a7da-ccdb3a8e44e7/error.txt +14 -0
  28. package/.code/agents/521cff39-a7a3-42e5-a557-134f0f7daaa0/error.txt +5 -0
  29. package/.code/agents/53302dc5-3857-4413-9a47-9e0f64a51dc4/error.txt +5 -0
  30. package/.code/agents/567c7c2e-6a6f-4761-a08d-d36deeb2e0ac/error.txt +5 -0
  31. package/.code/agents/57b00845-80dc-47c9-953c-3028d16275d6/error.txt +3 -0
  32. package/.code/agents/593d9005-c2a5-48fd-8813-ece0d3f2de96/error.txt +1 -0
  33. package/.code/agents/5a112e66-0e1a-42f9-877c-53af56ea3551/error.txt +1 -0
  34. package/.code/agents/5b05e8ed-7788-4738-b7ee-9faa8180f992/error.txt +5 -0
  35. package/.code/agents/5f888d6f-d7ca-4ac8-be23-9ea1bf753951/error.txt +5 -0
  36. package/.code/agents/607db3ab-e4b0-435b-b497-93e9aa525549/error.txt +8 -0
  37. package/.code/agents/67dcb2a2-900f-4c78-b3fc-80b5213e0ddf/error.txt +8 -0
  38. package/.code/agents/69ad848c-4e98-49b3-b16c-0094ac2d1759/error.txt +5 -0
  39. package/.code/agents/6c9cfc5f-0d0b-445c-b121-9f60082c4f70/error.txt +1 -0
  40. package/.code/agents/6f6f8f77-4ab0-4f6e-9f30-40e8be0bd8f5/error.txt +1 -0
  41. package/.code/agents/72a7cde4-fa8a-4024-9038-27faa550539b/error.txt +1 -0
  42. package/.code/agents/7b48335c-8247-43aa-9949-5f820ba8e199/error.txt +1 -0
  43. package/.code/agents/80944249-bea9-4ac5-87de-a666c4df306e/error.txt +1 -0
  44. package/.code/agents/826099df-1b66-4186-a915-7eb59f9db19d/error.txt +5 -0
  45. package/.code/agents/8291d158-18a8-4a92-b799-4e9a4d9cce88/error.txt +1 -0
  46. package/.code/agents/82fb71a3-20fb-4341-804a-a2fc900f95bc/error.txt +1 -0
  47. package/.code/agents/855790ea-54ee-43e4-8209-a66994e37590/error.txt +1 -0
  48. package/.code/agents/88ce3a2e-04f2-42be-9062-bf97aa798da0/error.txt +3 -0
  49. package/.code/agents/9a17e398-b6ed-4218-bb55-bc64a8d38ce8/error.txt +8 -0
  50. package/.code/agents/9a4f4bfc-a2a6-4f40-a896-9335b41a7ed1/error.txt +1 -0
  51. package/.code/agents/9b633e55-ef84-47d6-94bb-fd3dd172ad97/error.txt +1 -0
  52. package/.code/agents/9b81f3ab-c72b-4a81-9a8f-28a49ddba84a/error.txt +8 -0
  53. package/.code/agents/a35daf29-b2d1-4aef-9b42-dad63a76bd47/error.txt +3 -0
  54. package/.code/agents/a81990cc-69ee-44d2-b907-17403c9bc5d7/error.txt +5 -0
  55. package/.code/agents/ab56260a-4a83-4ad4-9410-f88a23d6520a/error.txt +1 -0
  56. package/.code/agents/ad722c31-2d1d-45f7-bae2-3f02ca455b60/error.txt +1 -0
  57. package/.code/agents/b62e8690-3324-4b97-9309-731bee79416b/error.txt +5 -0
  58. package/.code/agents/baf60a3a-752b-4ad8-99d6-df32423ed2eb/error.txt +1 -0
  59. package/.code/agents/be049042-7dcb-4ac8-9beb-c8f1aea67742/error.txt +14 -0
  60. package/.code/agents/bed1dcb4-bfce-4a9f-8594-0f994962aafd/error.txt +1 -0
  61. package/.code/agents/c324a6cf-e935-4ede-9529-b3ebc18e8d6b/error.txt +5 -0
  62. package/.code/agents/c37c06ff-dfe3-43f2-9bbc-3ec73ec8f41d/error.txt +5 -0
  63. package/.code/agents/c8cd6671-433a-456b-9f88-e51cb2df6bfc/error.txt +11 -0
  64. package/.code/agents/ca2ccb67-2f24-428e-b27d-9365beadd140/error.txt +1 -0
  65. package/.code/agents/cf08c0c8-e7f0-423e-93ba-547e8e818340/error.txt +8 -0
  66. package/.code/agents/d579c74f-874b-40a4-9d56-ced1eb6a701d/error.txt +1 -0
  67. package/.code/agents/df412c98-7378-4deb-8e1e-76c416931181/error.txt +3 -0
  68. package/.code/agents/e5134eb3-2af4-45b0-8998-051cb4afdb45/error.txt +3 -0
  69. package/.code/agents/e6308471-aa45-4e9e-9496-2e9404164d97/error.txt +8 -0
  70. package/.code/agents/e7bd8bc7-23fb-4f46-98dc-b0dcf11b75a1/error.txt +1 -0
  71. package/.code/agents/e92bec35-378d-4fe1-8ac0-6e1bb3c86911/error.txt +5 -0
  72. package/.code/agents/ed918fbf-2dc4-4aa2-bfc5-04b65d9471ea/error.txt +1 -0
  73. package/.code/agents/ef1d756f-b272-48fc-8729-f05c494674f7/error.txt +1 -0
  74. package/.code/agents/ef359853-0249-4e41-a804-c0fc459fe456/error.txt +1 -0
  75. package/.code/agents/effc7b4a-4b90-40a0-8c86-a7a99d2d5fd2/error.txt +1 -0
  76. package/.code/agents/fa15f8d5-8359-4a8b-83a3-2f2056b3ff40/error.txt +3 -0
  77. package/.code/agents/fbef4193-eadf-4c8a-83ff-4878a6310f25/error.txt +8 -0
  78. package/.code/agents/fd0a4b4a-fda4-4964-a6d6-2b8a2da387c6/error.txt +1 -0
  79. package/.dxtignore +57 -0
  80. package/.env.example +44 -0
  81. package/.gemini/settings.json +8 -0
  82. package/.github/ISSUE_TEMPLATE/bug_report.md +41 -0
  83. package/.github/ISSUE_TEMPLATE/config.yml +5 -0
  84. package/.github/ISSUE_TEMPLATE/feature_request.md +24 -0
  85. package/.github/ISSUE_TEMPLATE/release_checklist.md +31 -0
  86. package/.github/pull_request_template.md +41 -0
  87. package/.github/workflows/ci-tests.yml +41 -0
  88. package/.github/workflows/claude-code-review.yml +57 -0
  89. package/.github/workflows/claude.yml +50 -0
  90. package/.github/workflows/full-integration.yml +22 -0
  91. package/.github/workflows/pr-description-check.yml +88 -0
  92. package/.github/workflows/publish.yml +33 -0
  93. package/.github/workflows/release.yml +89 -0
  94. package/.mcpbignore +58 -0
  95. package/.prettierignore +10 -0
  96. package/.prettierrc.json +10 -0
  97. package/ADOS-2-Module-1-Complete-Manual.md +757 -0
  98. package/AGENTS.md +36 -0
  99. package/CHANGELOG.md +187 -0
  100. package/CLAUDE.md +414 -0
  101. package/CODEREVIEW_RESPONSE.md +128 -0
  102. package/LICENSE +17 -0
  103. package/NUL +1 -0
  104. package/README.md +222 -0
  105. package/SCHEMA_IMPROVEMENT_SUMMARY.md +120 -0
  106. package/TESTING_NOTES.md +217 -0
  107. package/WARP.md +245 -0
  108. package/accountactivity-merged.csv +149 -0
  109. package/bin/ynab-mcp-server.cjs +4 -0
  110. package/bin/ynab-mcp-server.js +8 -0
  111. package/bundle-analysis.html +13110 -0
  112. package/dist/bundle/index.cjs +124 -0
  113. package/dist/index.d.ts +2 -0
  114. package/dist/index.js +85 -0
  115. package/dist/server/YNABMCPServer.d.ts +264 -0
  116. package/dist/server/YNABMCPServer.js +845 -0
  117. package/dist/server/budgetResolver.d.ts +15 -0
  118. package/dist/server/budgetResolver.js +99 -0
  119. package/dist/server/cacheManager.d.ts +74 -0
  120. package/dist/server/cacheManager.js +306 -0
  121. package/dist/server/config.d.ts +3 -0
  122. package/dist/server/config.js +19 -0
  123. package/dist/server/deltaCache.d.ts +61 -0
  124. package/dist/server/deltaCache.js +206 -0
  125. package/dist/server/deltaCache.merge.d.ts +9 -0
  126. package/dist/server/deltaCache.merge.js +111 -0
  127. package/dist/server/diagnostics.d.ts +90 -0
  128. package/dist/server/diagnostics.js +163 -0
  129. package/dist/server/errorHandler.d.ts +69 -0
  130. package/dist/server/errorHandler.js +524 -0
  131. package/dist/server/prompts.d.ts +31 -0
  132. package/dist/server/prompts.js +205 -0
  133. package/dist/server/rateLimiter.d.ts +27 -0
  134. package/dist/server/rateLimiter.js +82 -0
  135. package/dist/server/requestLogger.d.ts +62 -0
  136. package/dist/server/requestLogger.js +190 -0
  137. package/dist/server/resources.d.ts +39 -0
  138. package/dist/server/resources.js +85 -0
  139. package/dist/server/responseFormatter.d.ts +14 -0
  140. package/dist/server/responseFormatter.js +42 -0
  141. package/dist/server/securityMiddleware.d.ts +87 -0
  142. package/dist/server/securityMiddleware.js +117 -0
  143. package/dist/server/serverKnowledgeStore.d.ts +11 -0
  144. package/dist/server/serverKnowledgeStore.js +42 -0
  145. package/dist/server/toolRegistry.d.ts +85 -0
  146. package/dist/server/toolRegistry.js +272 -0
  147. package/dist/tools/__tests__/deltaTestUtils.d.ts +18 -0
  148. package/dist/tools/__tests__/deltaTestUtils.js +26 -0
  149. package/dist/tools/accountTools.d.ts +37 -0
  150. package/dist/tools/accountTools.js +175 -0
  151. package/dist/tools/budgetTools.d.ts +10 -0
  152. package/dist/tools/budgetTools.js +68 -0
  153. package/dist/tools/categoryTools.d.ts +27 -0
  154. package/dist/tools/categoryTools.js +232 -0
  155. package/dist/tools/compareTransactions/formatter.d.ts +71 -0
  156. package/dist/tools/compareTransactions/formatter.js +97 -0
  157. package/dist/tools/compareTransactions/index.d.ts +30 -0
  158. package/dist/tools/compareTransactions/index.js +160 -0
  159. package/dist/tools/compareTransactions/matcher.d.ts +12 -0
  160. package/dist/tools/compareTransactions/matcher.js +140 -0
  161. package/dist/tools/compareTransactions/parser.d.ts +14 -0
  162. package/dist/tools/compareTransactions/parser.js +430 -0
  163. package/dist/tools/compareTransactions/types.d.ts +27 -0
  164. package/dist/tools/compareTransactions/types.js +1 -0
  165. package/dist/tools/compareTransactions.d.ts +1 -0
  166. package/dist/tools/compareTransactions.js +1 -0
  167. package/dist/tools/deltaFetcher.d.ts +22 -0
  168. package/dist/tools/deltaFetcher.js +137 -0
  169. package/dist/tools/deltaSupport.d.ts +20 -0
  170. package/dist/tools/deltaSupport.js +176 -0
  171. package/dist/tools/exportTransactions.d.ts +17 -0
  172. package/dist/tools/exportTransactions.js +191 -0
  173. package/dist/tools/monthTools.d.ts +16 -0
  174. package/dist/tools/monthTools.js +107 -0
  175. package/dist/tools/payeeTools.d.ts +17 -0
  176. package/dist/tools/payeeTools.js +82 -0
  177. package/dist/tools/reconcileAdapter.d.ts +25 -0
  178. package/dist/tools/reconcileAdapter.js +167 -0
  179. package/dist/tools/reconciliation/analyzer.d.ts +3 -0
  180. package/dist/tools/reconciliation/analyzer.js +567 -0
  181. package/dist/tools/reconciliation/executor.d.ts +94 -0
  182. package/dist/tools/reconciliation/executor.js +611 -0
  183. package/dist/tools/reconciliation/index.d.ts +54 -0
  184. package/dist/tools/reconciliation/index.js +249 -0
  185. package/dist/tools/reconciliation/matcher.d.ts +3 -0
  186. package/dist/tools/reconciliation/matcher.js +160 -0
  187. package/dist/tools/reconciliation/payeeNormalizer.d.ts +6 -0
  188. package/dist/tools/reconciliation/payeeNormalizer.js +77 -0
  189. package/dist/tools/reconciliation/recommendationEngine.d.ts +2 -0
  190. package/dist/tools/reconciliation/recommendationEngine.js +273 -0
  191. package/dist/tools/reconciliation/reportFormatter.d.ts +13 -0
  192. package/dist/tools/reconciliation/reportFormatter.js +214 -0
  193. package/dist/tools/reconciliation/types.d.ts +172 -0
  194. package/dist/tools/reconciliation/types.js +7 -0
  195. package/dist/tools/schemas/outputs/accountOutputs.d.ts +58 -0
  196. package/dist/tools/schemas/outputs/accountOutputs.js +24 -0
  197. package/dist/tools/schemas/outputs/budgetOutputs.d.ts +48 -0
  198. package/dist/tools/schemas/outputs/budgetOutputs.js +15 -0
  199. package/dist/tools/schemas/outputs/categoryOutputs.d.ts +93 -0
  200. package/dist/tools/schemas/outputs/categoryOutputs.js +37 -0
  201. package/dist/tools/schemas/outputs/comparisonOutputs.d.ts +269 -0
  202. package/dist/tools/schemas/outputs/comparisonOutputs.js +181 -0
  203. package/dist/tools/schemas/outputs/index.d.ts +14 -0
  204. package/dist/tools/schemas/outputs/index.js +14 -0
  205. package/dist/tools/schemas/outputs/monthOutputs.d.ts +122 -0
  206. package/dist/tools/schemas/outputs/monthOutputs.js +51 -0
  207. package/dist/tools/schemas/outputs/payeeOutputs.d.ts +34 -0
  208. package/dist/tools/schemas/outputs/payeeOutputs.js +16 -0
  209. package/dist/tools/schemas/outputs/reconciliationOutputs.d.ts +1275 -0
  210. package/dist/tools/schemas/outputs/reconciliationOutputs.js +377 -0
  211. package/dist/tools/schemas/outputs/transactionMutationOutputs.d.ts +717 -0
  212. package/dist/tools/schemas/outputs/transactionMutationOutputs.js +260 -0
  213. package/dist/tools/schemas/outputs/transactionOutputs.d.ts +98 -0
  214. package/dist/tools/schemas/outputs/transactionOutputs.js +49 -0
  215. package/dist/tools/schemas/outputs/utilityOutputs.d.ts +219 -0
  216. package/dist/tools/schemas/outputs/utilityOutputs.js +120 -0
  217. package/dist/tools/schemas/shared/commonOutputs.d.ts +24 -0
  218. package/dist/tools/schemas/shared/commonOutputs.js +27 -0
  219. package/dist/tools/toolCategories.d.ts +32 -0
  220. package/dist/tools/toolCategories.js +32 -0
  221. package/dist/tools/transactionTools.d.ts +315 -0
  222. package/dist/tools/transactionTools.js +1722 -0
  223. package/dist/tools/utilityTools.d.ts +10 -0
  224. package/dist/tools/utilityTools.js +56 -0
  225. package/dist/types/index.d.ts +20 -0
  226. package/dist/types/index.js +16 -0
  227. package/dist/types/toolAnnotations.d.ts +7 -0
  228. package/dist/types/toolAnnotations.js +1 -0
  229. package/dist/utils/amountUtils.d.ts +3 -0
  230. package/dist/utils/amountUtils.js +10 -0
  231. package/dist/utils/dateUtils.d.ts +9 -0
  232. package/dist/utils/dateUtils.js +43 -0
  233. package/dist/utils/money.d.ts +21 -0
  234. package/dist/utils/money.js +51 -0
  235. package/docs/README.md +72 -0
  236. package/docs/assets/examples/reconciliation-with-recommendations.json +68 -0
  237. package/docs/assets/schemas/reconciliation-v2.json +338 -0
  238. package/docs/getting-started/CONFIGURATION.md +175 -0
  239. package/docs/getting-started/INSTALLATION.md +333 -0
  240. package/docs/getting-started/QUICKSTART.md +282 -0
  241. package/docs/guides/ARCHITECTURE.md +650 -0
  242. package/docs/guides/DEPLOYMENT.md +189 -0
  243. package/docs/guides/INTEGRATION_TESTING.md +730 -0
  244. package/docs/guides/TESTING.md +591 -0
  245. package/docs/reconciliation-flow.md +83 -0
  246. package/docs/reference/API.md +1450 -0
  247. package/docs/reference/EXAMPLES.md +946 -0
  248. package/docs/reference/TOOLS.md +348 -0
  249. package/docs/reference/TROUBLESHOOTING.md +481 -0
  250. package/esbuild.config.mjs +68 -0
  251. package/eslint.config.js +49 -0
  252. package/fix-types.sh +17 -0
  253. package/meta.json +12550 -0
  254. package/package.json +105 -0
  255. package/package.json.tmp +105 -0
  256. package/scripts/analyze-bundle.mjs +41 -0
  257. package/scripts/create-pr-description.js +203 -0
  258. package/scripts/generate-mcpb.ps1 +96 -0
  259. package/scripts/run-domain-integration-tests.js +33 -0
  260. package/scripts/run-generate-mcpb.js +29 -0
  261. package/scripts/run-throttled-integration-tests.js +116 -0
  262. package/scripts/test-delta-params.mjs +140 -0
  263. package/scripts/test-recommendations.ts +53 -0
  264. package/scripts/tmpTransaction.ts +48 -0
  265. package/scripts/validate-env.js +122 -0
  266. package/scripts/verify-build.js +105 -0
  267. package/scripts/watch-and-restart.ps1 +50 -0
  268. package/src/__tests__/comprehensive.integration.test.ts +1196 -0
  269. package/src/__tests__/delta.performance.test.ts +80 -0
  270. package/src/__tests__/performance.test.ts +725 -0
  271. package/src/__tests__/setup.ts +449 -0
  272. package/src/__tests__/testRunner.ts +444 -0
  273. package/src/__tests__/testUtils.ts +563 -0
  274. package/src/__tests__/workflows.e2e.test.ts +1675 -0
  275. package/src/index.ts +124 -0
  276. package/src/server/.gitkeep +1 -0
  277. package/src/server/YNABMCPServer.ts +1188 -0
  278. package/src/server/__tests__/YNABMCPServer.integration.test.ts +903 -0
  279. package/src/server/__tests__/YNABMCPServer.test.ts +894 -0
  280. package/src/server/__tests__/budgetResolver.test.ts +425 -0
  281. package/src/server/__tests__/cacheManager.test.ts +880 -0
  282. package/src/server/__tests__/config.test.ts +166 -0
  283. package/src/server/__tests__/deltaCache.merge.test.ts +724 -0
  284. package/src/server/__tests__/deltaCache.swr.test.ts +168 -0
  285. package/src/server/__tests__/deltaCache.test.ts +774 -0
  286. package/src/server/__tests__/diagnostics.test.ts +823 -0
  287. package/src/server/__tests__/errorHandler.integration.test.ts +466 -0
  288. package/src/server/__tests__/errorHandler.test.ts +416 -0
  289. package/src/server/__tests__/prompts.test.ts +354 -0
  290. package/src/server/__tests__/rateLimiter.test.ts +314 -0
  291. package/src/server/__tests__/requestLogger.test.ts +408 -0
  292. package/src/server/__tests__/resources.test.ts +299 -0
  293. package/src/server/__tests__/security.integration.test.ts +426 -0
  294. package/src/server/__tests__/securityMiddleware.test.ts +449 -0
  295. package/src/server/__tests__/server-startup.integration.test.ts +477 -0
  296. package/src/server/__tests__/serverKnowledgeStore.test.ts +174 -0
  297. package/src/server/__tests__/toolRegistry.test.ts +855 -0
  298. package/src/server/budgetResolver.ts +235 -0
  299. package/src/server/cacheManager.ts +503 -0
  300. package/src/server/config.ts +41 -0
  301. package/src/server/deltaCache.merge.ts +149 -0
  302. package/src/server/deltaCache.ts +341 -0
  303. package/src/server/diagnostics.ts +338 -0
  304. package/src/server/errorHandler.ts +756 -0
  305. package/src/server/prompts.ts +291 -0
  306. package/src/server/rateLimiter.ts +156 -0
  307. package/src/server/requestLogger.ts +344 -0
  308. package/src/server/resources.ts +168 -0
  309. package/src/server/responseFormatter.ts +51 -0
  310. package/src/server/securityMiddleware.ts +236 -0
  311. package/src/server/serverKnowledgeStore.ts +91 -0
  312. package/src/server/toolRegistry.ts +489 -0
  313. package/src/tools/.gitkeep +1 -0
  314. package/src/tools/__tests__/accountTools.delta.integration.test.ts +128 -0
  315. package/src/tools/__tests__/accountTools.integration.test.ts +117 -0
  316. package/src/tools/__tests__/accountTools.test.ts +653 -0
  317. package/src/tools/__tests__/budgetTools.delta.integration.test.ts +90 -0
  318. package/src/tools/__tests__/budgetTools.integration.test.ts +134 -0
  319. package/src/tools/__tests__/budgetTools.test.ts +423 -0
  320. package/src/tools/__tests__/categoryTools.delta.integration.test.ts +80 -0
  321. package/src/tools/__tests__/categoryTools.integration.test.ts +295 -0
  322. package/src/tools/__tests__/categoryTools.test.ts +622 -0
  323. package/src/tools/__tests__/compareTransactions/formatter.test.ts +486 -0
  324. package/src/tools/__tests__/compareTransactions/index.test.ts +383 -0
  325. package/src/tools/__tests__/compareTransactions/matcher.test.ts +410 -0
  326. package/src/tools/__tests__/compareTransactions/parser.test.ts +764 -0
  327. package/src/tools/__tests__/compareTransactions.test.ts +342 -0
  328. package/src/tools/__tests__/compareTransactions.window.test.ts +147 -0
  329. package/src/tools/__tests__/deltaFetcher.scheduled.integration.test.ts +76 -0
  330. package/src/tools/__tests__/deltaFetcher.test.ts +270 -0
  331. package/src/tools/__tests__/deltaSupport.test.ts +188 -0
  332. package/src/tools/__tests__/deltaTestUtils.ts +46 -0
  333. package/src/tools/__tests__/exportTransactions.test.ts +213 -0
  334. package/src/tools/__tests__/monthTools.delta.integration.test.ts +80 -0
  335. package/src/tools/__tests__/monthTools.integration.test.ts +174 -0
  336. package/src/tools/__tests__/monthTools.test.ts +523 -0
  337. package/src/tools/__tests__/payeeTools.delta.integration.test.ts +80 -0
  338. package/src/tools/__tests__/payeeTools.integration.test.ts +150 -0
  339. package/src/tools/__tests__/payeeTools.test.ts +445 -0
  340. package/src/tools/__tests__/transactionTools.integration.test.ts +762 -0
  341. package/src/tools/__tests__/transactionTools.test.ts +3521 -0
  342. package/src/tools/__tests__/utilityTools.integration.test.ts +128 -0
  343. package/src/tools/__tests__/utilityTools.test.ts +205 -0
  344. package/src/tools/accountTools.ts +283 -0
  345. package/src/tools/budgetTools.ts +112 -0
  346. package/src/tools/categoryTools.ts +366 -0
  347. package/src/tools/compareTransactions/formatter.ts +163 -0
  348. package/src/tools/compareTransactions/index.ts +228 -0
  349. package/src/tools/compareTransactions/matcher.ts +240 -0
  350. package/src/tools/compareTransactions/parser.ts +557 -0
  351. package/src/tools/compareTransactions/types.ts +60 -0
  352. package/src/tools/compareTransactions.ts +3 -0
  353. package/src/tools/deltaFetcher.ts +278 -0
  354. package/src/tools/deltaSupport.ts +293 -0
  355. package/src/tools/exportTransactions.ts +273 -0
  356. package/src/tools/monthTools.ts +164 -0
  357. package/src/tools/payeeTools.ts +140 -0
  358. package/src/tools/reconcileAdapter.ts +312 -0
  359. package/src/tools/reconciliation/__tests__/adapter.causes.test.ts +122 -0
  360. package/src/tools/reconciliation/__tests__/adapter.test.ts +234 -0
  361. package/src/tools/reconciliation/__tests__/analyzer.test.ts +406 -0
  362. package/src/tools/reconciliation/__tests__/executor.integration.test.ts +366 -0
  363. package/src/tools/reconciliation/__tests__/executor.test.ts +779 -0
  364. package/src/tools/reconciliation/__tests__/matcher.test.ts +650 -0
  365. package/src/tools/reconciliation/__tests__/payeeNormalizer.test.ts +278 -0
  366. package/src/tools/reconciliation/__tests__/recommendationEngine.integration.test.ts +658 -0
  367. package/src/tools/reconciliation/__tests__/recommendationEngine.test.ts +1000 -0
  368. package/src/tools/reconciliation/__tests__/reconciliation.delta.integration.test.ts +151 -0
  369. package/src/tools/reconciliation/__tests__/reportFormatter.test.ts +573 -0
  370. package/src/tools/reconciliation/__tests__/scenarios/adapterCurrency.scenario.test.ts +78 -0
  371. package/src/tools/reconciliation/__tests__/scenarios/extremes.scenario.test.ts +47 -0
  372. package/src/tools/reconciliation/__tests__/scenarios/repeatAmount.scenario.test.ts +61 -0
  373. package/src/tools/reconciliation/__tests__/schemaUrl.test.ts +49 -0
  374. package/src/tools/reconciliation/analyzer.ts +824 -0
  375. package/src/tools/reconciliation/executor.ts +880 -0
  376. package/src/tools/reconciliation/index.ts +400 -0
  377. package/src/tools/reconciliation/matcher.ts +269 -0
  378. package/src/tools/reconciliation/payeeNormalizer.ts +167 -0
  379. package/src/tools/reconciliation/recommendationEngine.ts +506 -0
  380. package/src/tools/reconciliation/reportFormatter.ts +363 -0
  381. package/src/tools/reconciliation/types.ts +314 -0
  382. package/src/tools/schemas/outputs/__tests__/accountOutputs.test.ts +424 -0
  383. package/src/tools/schemas/outputs/__tests__/budgetOutputs.test.ts +310 -0
  384. package/src/tools/schemas/outputs/__tests__/categoryOutputs.test.ts +448 -0
  385. package/src/tools/schemas/outputs/__tests__/comparisonOutputs.test.ts +519 -0
  386. package/src/tools/schemas/outputs/__tests__/dateValidation.test.ts +155 -0
  387. package/src/tools/schemas/outputs/__tests__/discrepancyDirection.test.ts +288 -0
  388. package/src/tools/schemas/outputs/__tests__/monthOutputs.test.ts +478 -0
  389. package/src/tools/schemas/outputs/__tests__/payeeOutputs.test.ts +370 -0
  390. package/src/tools/schemas/outputs/__tests__/reconciliationOutputs.test.ts +401 -0
  391. package/src/tools/schemas/outputs/__tests__/transactionMutationSchemas.test.ts +213 -0
  392. package/src/tools/schemas/outputs/__tests__/transactionOutputs.test.ts +474 -0
  393. package/src/tools/schemas/outputs/__tests__/utilityOutputs.test.ts +333 -0
  394. package/src/tools/schemas/outputs/accountOutputs.ts +137 -0
  395. package/src/tools/schemas/outputs/budgetOutputs.ts +86 -0
  396. package/src/tools/schemas/outputs/categoryOutputs.ts +194 -0
  397. package/src/tools/schemas/outputs/comparisonOutputs.ts +600 -0
  398. package/src/tools/schemas/outputs/index.ts +270 -0
  399. package/src/tools/schemas/outputs/monthOutputs.ts +243 -0
  400. package/src/tools/schemas/outputs/payeeOutputs.ts +105 -0
  401. package/src/tools/schemas/outputs/reconciliationOutputs.ts +796 -0
  402. package/src/tools/schemas/outputs/transactionMutationOutputs.ts +758 -0
  403. package/src/tools/schemas/outputs/transactionOutputs.ts +243 -0
  404. package/src/tools/schemas/outputs/utilityOutputs.ts +411 -0
  405. package/src/tools/schemas/shared/commonOutputs.ts +140 -0
  406. package/src/tools/toolCategories.ts +140 -0
  407. package/src/tools/transactionTools.ts +2509 -0
  408. package/src/tools/utilityTools.ts +90 -0
  409. package/src/types/.gitkeep +1 -0
  410. package/src/types/__tests__/index.test.ts +52 -0
  411. package/src/types/index.ts +67 -0
  412. package/src/types/integration-tests.d.ts +35 -0
  413. package/src/types/toolAnnotations.ts +44 -0
  414. package/src/utils/__tests__/dateUtils.test.ts +170 -0
  415. package/src/utils/__tests__/money.test.ts +189 -0
  416. package/src/utils/amountUtils.ts +32 -0
  417. package/src/utils/dateUtils.ts +108 -0
  418. package/src/utils/money.ts +123 -0
  419. package/test-csv-sample.csv +28 -0
  420. package/test-exports/sample_bank_statement.csv +7 -0
  421. package/test-exports/ynab_account_e9ddc2a6_minimal_1items_2025-11-19_09-04-53.json +23 -0
  422. package/test-exports/ynab_account_e9ddc2a6_minimal_1items_2025-11-19_10-37-42.json +23 -0
  423. package/test-exports/ynab_account_e9ddc2a6_minimal_4items_2025-11-19_09-02-09.json +44 -0
  424. package/test-exports/ynab_account_e9ddc2a6_minimal_6items_2025-11-19_10-37-52.json +58 -0
  425. package/test-exports/ynab_since_2025-11-01_account_4c18e9f0_minimal_14items_2025-11-16_10-07-10.json +115 -0
  426. package/test-reconcile-autodetect.js +40 -0
  427. package/test-reconcile-tool.js +152 -0
  428. package/test-reconcile-with-csv.cjs +89 -0
  429. package/test-statement.csv +8 -0
  430. package/test_debug.js +47 -0
  431. package/test_simple.mjs +16 -0
  432. package/tsconfig.json +31 -0
  433. package/tsconfig.prod.json +18 -0
  434. package/vitest-reporters/split-json-reporter.ts +211 -0
  435. package/vitest.config.ts +96 -0
@@ -0,0 +1,260 @@
1
+ import { z } from 'zod';
2
+ import { TransactionSchema } from './transactionOutputs.js';
3
+ import { AccountSchema } from './accountOutputs.js';
4
+ import { CategorySchema } from './categoryOutputs.js';
5
+ export const SubtransactionSchema = z.object({
6
+ id: z.string(),
7
+ transaction_id: z.string(),
8
+ amount: z.number(),
9
+ memo: z.string().optional(),
10
+ payee_id: z.string().optional(),
11
+ payee_name: z.string().optional(),
12
+ category_id: z.string().optional(),
13
+ category_name: z.string().optional(),
14
+ transfer_account_id: z.string().optional(),
15
+ transfer_transaction_id: z.string().optional(),
16
+ deleted: z.boolean(),
17
+ });
18
+ export const TransactionWithBalanceSchema = TransactionSchema.extend({
19
+ account_balance: z.number().optional(),
20
+ account_cleared_balance: z.number().optional(),
21
+ subtransactions: z.array(SubtransactionSchema).optional(),
22
+ });
23
+ export const ReceiptItemSchema = z.object({
24
+ name: z.string(),
25
+ quantity: z.number().optional(),
26
+ amount: z.number(),
27
+ memo: z.string().optional(),
28
+ });
29
+ export const ReceiptCategoryBreakdownSchema = z.object({
30
+ category_id: z.string(),
31
+ category_name: z.string().optional(),
32
+ items: z.array(ReceiptItemSchema),
33
+ subtotal: z.number(),
34
+ tax: z.number(),
35
+ total: z.number(),
36
+ });
37
+ export const ReceiptSummarySchema = z.object({
38
+ subtotal: z.number(),
39
+ tax: z.number(),
40
+ total: z.number(),
41
+ categories: z.array(ReceiptCategoryBreakdownSchema),
42
+ });
43
+ export const BulkOperationSummarySchema = z.object({
44
+ total_requested: z.number(),
45
+ created: z.number().optional(),
46
+ updated: z.number().optional(),
47
+ duplicates: z.number().optional(),
48
+ failed: z.number(),
49
+ });
50
+ export const BulkResultSchema = z
51
+ .object({
52
+ request_index: z.number(),
53
+ status: z.enum(['created', 'duplicate', 'updated', 'failed']),
54
+ transaction_id: z.string().optional(),
55
+ correlation_key: z.string(),
56
+ error_code: z.string().optional(),
57
+ error: z.string().optional(),
58
+ })
59
+ .passthrough();
60
+ export const TransactionDiffFieldsSchema = z.object({
61
+ amount: z.number().optional(),
62
+ date: z
63
+ .string()
64
+ .regex(/^\d{4}-\d{2}-\d{2}$/)
65
+ .optional(),
66
+ memo: z.string().optional(),
67
+ payee_id: z.string().nullable().optional(),
68
+ payee_name: z.string().nullable().optional(),
69
+ category_id: z.string().nullable().optional(),
70
+ cleared: z.enum(['cleared', 'uncleared', 'reconciled']).optional(),
71
+ approved: z.boolean().optional(),
72
+ flag_color: z.enum(['red', 'orange', 'yellow', 'green', 'blue', 'purple']).nullable().optional(),
73
+ });
74
+ export const DryRunPreviewItemSchema = z.object({
75
+ transaction_id: z.string(),
76
+ before: z.union([z.literal('unavailable'), TransactionDiffFieldsSchema]),
77
+ after: TransactionDiffFieldsSchema,
78
+ });
79
+ export const DryRunWarningSchema = z.object({
80
+ code: z.string(),
81
+ count: z.number(),
82
+ message: z.string(),
83
+ sample_ids: z.array(z.string()).optional(),
84
+ });
85
+ export const CreateTransactionOutputSchema = z.union([
86
+ z.object({
87
+ dry_run: z.literal(true),
88
+ action: z.literal('create_transaction'),
89
+ request: z.record(z.string(), z.unknown()),
90
+ }),
91
+ z.object({
92
+ transaction: TransactionWithBalanceSchema,
93
+ }),
94
+ ]);
95
+ export const CreateTransactionPreviewSchema = z.object({
96
+ request_index: z.number(),
97
+ account_id: z.string(),
98
+ date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
99
+ amount: z.number(),
100
+ memo: z.string().optional(),
101
+ payee_id: z.string().optional(),
102
+ payee_name: z.string().optional(),
103
+ category_id: z.string().optional(),
104
+ import_id: z.string().optional(),
105
+ });
106
+ export const CreateTransactionsOutputSchema = z.union([
107
+ z
108
+ .object({
109
+ dry_run: z.literal(true),
110
+ action: z.literal('create_transactions'),
111
+ validation: z.literal('passed'),
112
+ summary: z.object({
113
+ total_transactions: z.number(),
114
+ total_amount: z.number(),
115
+ accounts_affected: z.array(z.string()),
116
+ date_range: z
117
+ .object({
118
+ earliest: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
119
+ latest: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
120
+ })
121
+ .optional(),
122
+ categories_affected: z.array(z.string()),
123
+ }),
124
+ transactions_preview: z.array(CreateTransactionPreviewSchema),
125
+ note: z.string(),
126
+ })
127
+ .strict(),
128
+ z
129
+ .object({
130
+ success: z.boolean(),
131
+ server_knowledge: z.number().optional(),
132
+ summary: BulkOperationSummarySchema,
133
+ results: z.array(BulkResultSchema),
134
+ transactions: z.array(TransactionSchema).optional(),
135
+ duplicate_import_ids: z.array(z.string()).optional(),
136
+ message: z.string().optional(),
137
+ mode: z.enum(['full', 'summary', 'ids_only']).optional(),
138
+ })
139
+ .passthrough(),
140
+ ]);
141
+ export const UpdateTransactionOutputSchema = z.union([
142
+ z.object({
143
+ dry_run: z.literal(true),
144
+ action: z.literal('update_transaction'),
145
+ request: z.record(z.string(), z.unknown()),
146
+ }),
147
+ z.object({
148
+ transaction: TransactionWithBalanceSchema,
149
+ updated_balance: z.number(),
150
+ updated_cleared_balance: z.number(),
151
+ }),
152
+ ]);
153
+ export const UpdateTransactionsOutputSchema = z.union([
154
+ z
155
+ .object({
156
+ dry_run: z.literal(true),
157
+ action: z.literal('update_transactions'),
158
+ validation: z.literal('passed'),
159
+ summary: z.object({
160
+ total_transactions: z.number(),
161
+ accounts_affected: z.number(),
162
+ fields_to_update: z.array(z.string()),
163
+ }),
164
+ transactions_preview: z.array(DryRunPreviewItemSchema),
165
+ warnings: z.array(DryRunWarningSchema).optional(),
166
+ note: z.string(),
167
+ })
168
+ .strict(),
169
+ z
170
+ .object({
171
+ success: z.boolean(),
172
+ server_knowledge: z.number().optional(),
173
+ summary: BulkOperationSummarySchema,
174
+ results: z.array(BulkResultSchema),
175
+ transactions: z.array(TransactionSchema).optional(),
176
+ message: z.string().optional(),
177
+ mode: z.enum(['full', 'summary', 'ids_only']).optional(),
178
+ })
179
+ .passthrough(),
180
+ ]);
181
+ export const DeleteTransactionOutputSchema = z.union([
182
+ z.object({
183
+ dry_run: z.literal(true),
184
+ action: z.literal('delete_transaction'),
185
+ request: z.record(z.string(), z.unknown()),
186
+ }),
187
+ z.object({
188
+ message: z.string(),
189
+ transaction: z.object({
190
+ id: z.string(),
191
+ deleted: z.boolean(),
192
+ }),
193
+ updated_balance: z.number(),
194
+ updated_cleared_balance: z.number(),
195
+ }),
196
+ ]);
197
+ export const TransactionDryRunPreviewSchema = z.object({
198
+ account_id: z.string(),
199
+ date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
200
+ amount: z.number(),
201
+ memo: z.string().optional().nullable(),
202
+ cleared: z.enum(['cleared', 'uncleared', 'reconciled']).optional(),
203
+ approved: z.boolean().optional(),
204
+ flag_color: z.enum(['red', 'orange', 'yellow', 'green', 'blue', 'purple']).optional().nullable(),
205
+ payee_id: z.string().optional().nullable(),
206
+ payee_name: z.string().optional().nullable(),
207
+ category_id: z.string().optional().nullable(),
208
+ import_id: z.string().optional().nullable(),
209
+ });
210
+ export const SubtransactionPreviewSchema = SubtransactionSchema.omit({
211
+ id: true,
212
+ transaction_id: true,
213
+ deleted: true,
214
+ });
215
+ export const CreateReceiptSplitTransactionOutputSchema = z.union([
216
+ z.object({
217
+ dry_run: z.literal(true),
218
+ action: z.literal('create_receipt_split_transaction'),
219
+ transaction_preview: TransactionDryRunPreviewSchema,
220
+ receipt_summary: ReceiptSummarySchema,
221
+ subtransactions: z.array(SubtransactionPreviewSchema),
222
+ }),
223
+ z.object({
224
+ transaction: TransactionWithBalanceSchema,
225
+ receipt_summary: ReceiptSummarySchema,
226
+ }),
227
+ ]);
228
+ export const CreateAccountDryRunRequestSchema = z.object({
229
+ budget_id: z.string(),
230
+ name: z.string(),
231
+ type: z.string(),
232
+ balance: z.number(),
233
+ });
234
+ export const CreateAccountOutputSchema = z.union([
235
+ z.object({
236
+ dry_run: z.literal(true),
237
+ action: z.literal('create_account'),
238
+ request: CreateAccountDryRunRequestSchema,
239
+ }),
240
+ z.object({
241
+ account: AccountSchema,
242
+ }),
243
+ ]);
244
+ export const UpdateCategoryDryRunRequestSchema = z.object({
245
+ budget_id: z.string(),
246
+ category_id: z.string(),
247
+ budgeted: z.number(),
248
+ month: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
249
+ });
250
+ export const UpdateCategoryOutputSchema = z.union([
251
+ z.object({
252
+ dry_run: z.literal(true),
253
+ action: z.literal('update_category'),
254
+ request: UpdateCategoryDryRunRequestSchema,
255
+ }),
256
+ z.object({
257
+ category: CategorySchema,
258
+ updated_month: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
259
+ }),
260
+ ]);
@@ -0,0 +1,98 @@
1
+ import { z } from 'zod/v4';
2
+ export declare const TransactionSchema: z.ZodObject<{
3
+ id: z.ZodString;
4
+ date: z.ZodString;
5
+ amount: z.ZodNumber;
6
+ memo: z.ZodOptional<z.ZodString>;
7
+ cleared: z.ZodString;
8
+ approved: z.ZodBoolean;
9
+ flag_color: z.ZodOptional<z.ZodString>;
10
+ account_id: z.ZodString;
11
+ payee_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
12
+ category_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
13
+ transfer_account_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
14
+ transfer_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
15
+ matched_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
16
+ import_id: z.ZodOptional<z.ZodString>;
17
+ deleted: z.ZodBoolean;
18
+ account_name: z.ZodOptional<z.ZodString>;
19
+ payee_name: z.ZodOptional<z.ZodString>;
20
+ category_name: z.ZodOptional<z.ZodString>;
21
+ }, z.core.$strip>;
22
+ export declare const TransactionPreviewSchema: z.ZodObject<{
23
+ id: z.ZodString;
24
+ date: z.ZodString;
25
+ amount: z.ZodNumber;
26
+ memo: z.ZodOptional<z.ZodString>;
27
+ payee_name: z.ZodOptional<z.ZodString>;
28
+ category_name: z.ZodOptional<z.ZodString>;
29
+ }, z.core.$strip>;
30
+ export declare const ListTransactionsOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
31
+ cached: z.ZodOptional<z.ZodBoolean>;
32
+ cache_info: z.ZodOptional<z.ZodString>;
33
+ usedDelta: z.ZodOptional<z.ZodBoolean>;
34
+ total_count: z.ZodNumber;
35
+ transactions: z.ZodArray<z.ZodObject<{
36
+ id: z.ZodString;
37
+ date: z.ZodString;
38
+ amount: z.ZodNumber;
39
+ memo: z.ZodOptional<z.ZodString>;
40
+ cleared: z.ZodString;
41
+ approved: z.ZodBoolean;
42
+ flag_color: z.ZodOptional<z.ZodString>;
43
+ account_id: z.ZodString;
44
+ payee_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
45
+ category_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
46
+ transfer_account_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
47
+ transfer_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
48
+ matched_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
49
+ import_id: z.ZodOptional<z.ZodString>;
50
+ deleted: z.ZodBoolean;
51
+ account_name: z.ZodOptional<z.ZodString>;
52
+ payee_name: z.ZodOptional<z.ZodString>;
53
+ category_name: z.ZodOptional<z.ZodString>;
54
+ }, z.core.$strip>>;
55
+ }, z.core.$strip>, z.ZodObject<{
56
+ message: z.ZodString;
57
+ suggestion: z.ZodString;
58
+ showing: z.ZodString;
59
+ total_count: z.ZodNumber;
60
+ estimated_size_kb: z.ZodNumber;
61
+ preview_transactions: z.ZodArray<z.ZodObject<{
62
+ id: z.ZodString;
63
+ date: z.ZodString;
64
+ amount: z.ZodNumber;
65
+ memo: z.ZodOptional<z.ZodString>;
66
+ payee_name: z.ZodOptional<z.ZodString>;
67
+ category_name: z.ZodOptional<z.ZodString>;
68
+ }, z.core.$strip>>;
69
+ }, z.core.$strip>]>;
70
+ export declare const GetTransactionOutputSchema: z.ZodObject<{
71
+ cached: z.ZodOptional<z.ZodBoolean>;
72
+ cache_info: z.ZodOptional<z.ZodString>;
73
+ usedDelta: z.ZodOptional<z.ZodBoolean>;
74
+ transaction: z.ZodObject<{
75
+ id: z.ZodString;
76
+ date: z.ZodString;
77
+ amount: z.ZodNumber;
78
+ memo: z.ZodOptional<z.ZodString>;
79
+ cleared: z.ZodString;
80
+ approved: z.ZodBoolean;
81
+ flag_color: z.ZodOptional<z.ZodString>;
82
+ account_id: z.ZodString;
83
+ payee_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
84
+ category_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
85
+ transfer_account_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
86
+ transfer_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
87
+ matched_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
88
+ import_id: z.ZodOptional<z.ZodString>;
89
+ deleted: z.ZodBoolean;
90
+ account_name: z.ZodOptional<z.ZodString>;
91
+ payee_name: z.ZodOptional<z.ZodString>;
92
+ category_name: z.ZodOptional<z.ZodString>;
93
+ }, z.core.$strip>;
94
+ }, z.core.$strip>;
95
+ export type Transaction = z.infer<typeof TransactionSchema>;
96
+ export type TransactionPreview = z.infer<typeof TransactionPreviewSchema>;
97
+ export type ListTransactionsOutput = z.infer<typeof ListTransactionsOutputSchema>;
98
+ export type GetTransactionOutput = z.infer<typeof GetTransactionOutputSchema>;
@@ -0,0 +1,49 @@
1
+ import { z } from 'zod/v4';
2
+ import { CacheMetadataSchema } from '../shared/commonOutputs.js';
3
+ export const TransactionSchema = z.object({
4
+ id: z.string().describe('Transaction ID'),
5
+ date: z.string().describe('Transaction date'),
6
+ amount: z.number().describe('Transaction amount in dollars'),
7
+ memo: z.string().optional().describe('Transaction memo'),
8
+ cleared: z.string().describe('Cleared status'),
9
+ approved: z.boolean().describe('Approved flag'),
10
+ flag_color: z.string().optional().describe('Flag color'),
11
+ account_id: z.string().describe('Account ID'),
12
+ payee_id: z.string().nullish().describe('Payee ID'),
13
+ category_id: z.string().nullish().describe('Category ID'),
14
+ transfer_account_id: z.string().nullish().describe('Transfer account ID'),
15
+ transfer_transaction_id: z.string().nullish().describe('Transfer transaction ID'),
16
+ matched_transaction_id: z.string().nullish().describe('Matched transaction ID'),
17
+ import_id: z.string().optional().describe('Import ID'),
18
+ deleted: z.boolean().describe('Deleted flag'),
19
+ account_name: z.string().optional().describe('Account name'),
20
+ payee_name: z.string().optional().describe('Payee name'),
21
+ category_name: z.string().optional().describe('Category name'),
22
+ });
23
+ export const TransactionPreviewSchema = z.object({
24
+ id: z.string().describe('Transaction ID'),
25
+ date: z.string().describe('Transaction date'),
26
+ amount: z.number().describe('Transaction amount in dollars'),
27
+ memo: z.string().optional().describe('Transaction memo'),
28
+ payee_name: z.string().optional().describe('Payee name'),
29
+ category_name: z.string().optional().describe('Category name'),
30
+ });
31
+ const ListTransactionsNormalSchema = CacheMetadataSchema.extend({
32
+ total_count: z.number().int().describe('Total transaction count'),
33
+ transactions: z.array(TransactionSchema).describe('List of transactions'),
34
+ });
35
+ const ListTransactionsPreviewSchema = z.object({
36
+ message: z.string().describe('Large result set message'),
37
+ suggestion: z.string().describe('Suggestion to narrow results'),
38
+ showing: z.string().describe('Human-readable summary of transactions shown'),
39
+ total_count: z.number().int().describe('Total transaction count'),
40
+ estimated_size_kb: z.number().describe('Estimated response size in KB'),
41
+ preview_transactions: z.array(TransactionPreviewSchema).describe('Preview transactions'),
42
+ });
43
+ export const ListTransactionsOutputSchema = z.union([
44
+ ListTransactionsNormalSchema,
45
+ ListTransactionsPreviewSchema,
46
+ ]);
47
+ export const GetTransactionOutputSchema = CacheMetadataSchema.extend({
48
+ transaction: TransactionSchema.describe('Transaction details'),
49
+ });
@@ -0,0 +1,219 @@
1
+ import { z } from 'zod/v4';
2
+ export declare const UserSchema: z.ZodObject<{
3
+ id: z.ZodString;
4
+ }, z.core.$strip>;
5
+ export declare const GetUserOutputSchema: z.ZodObject<{
6
+ user: z.ZodObject<{
7
+ id: z.ZodString;
8
+ }, z.core.$strip>;
9
+ }, z.core.$strip>;
10
+ export type GetUserOutput = z.infer<typeof GetUserOutputSchema>;
11
+ export declare const ConversionSchema: z.ZodObject<{
12
+ original_amount: z.ZodNumber;
13
+ converted_amount: z.ZodNumber;
14
+ to_milliunits: z.ZodBoolean;
15
+ description: z.ZodString;
16
+ }, z.core.$strip>;
17
+ export declare const ConvertAmountOutputSchema: z.ZodObject<{
18
+ conversion: z.ZodObject<{
19
+ original_amount: z.ZodNumber;
20
+ converted_amount: z.ZodNumber;
21
+ to_milliunits: z.ZodBoolean;
22
+ description: z.ZodString;
23
+ }, z.core.$strip>;
24
+ }, z.core.$strip>;
25
+ export type ConvertAmountOutput = z.infer<typeof ConvertAmountOutputSchema>;
26
+ export declare const GetDefaultBudgetOutputSchema: z.ZodObject<{
27
+ default_budget_id: z.ZodNullable<z.ZodString>;
28
+ has_default: z.ZodBoolean;
29
+ message: z.ZodString;
30
+ }, z.core.$strip>;
31
+ export type GetDefaultBudgetOutput = z.infer<typeof GetDefaultBudgetOutputSchema>;
32
+ export declare const SetDefaultBudgetOutputSchema: z.ZodObject<{
33
+ success: z.ZodBoolean;
34
+ message: z.ZodString;
35
+ default_budget_id: z.ZodString;
36
+ cache_warm_started: z.ZodBoolean;
37
+ }, z.core.$strip>;
38
+ export type SetDefaultBudgetOutput = z.infer<typeof SetDefaultBudgetOutputSchema>;
39
+ export declare const ClearCacheOutputSchema: z.ZodObject<{
40
+ success: z.ZodBoolean;
41
+ }, z.core.$strip>;
42
+ export type ClearCacheOutput = z.infer<typeof ClearCacheOutputSchema>;
43
+ export declare const SetOutputFormatOutputSchema: z.ZodObject<{
44
+ success: z.ZodBoolean;
45
+ message: z.ZodString;
46
+ options: z.ZodObject<{
47
+ defaultMinify: z.ZodOptional<z.ZodBoolean>;
48
+ prettySpaces: z.ZodOptional<z.ZodNumber>;
49
+ }, z.core.$strip>;
50
+ }, z.core.$strip>;
51
+ export type SetOutputFormatOutput = z.infer<typeof SetOutputFormatOutputSchema>;
52
+ export declare const ServerInfoSchema: z.ZodObject<{
53
+ name: z.ZodString;
54
+ version: z.ZodString;
55
+ node_version: z.ZodString;
56
+ platform: z.ZodString;
57
+ arch: z.ZodString;
58
+ pid: z.ZodNumber;
59
+ uptime_ms: z.ZodNumber;
60
+ uptime_readable: z.ZodString;
61
+ env: z.ZodRecord<z.ZodString, z.ZodUnknown>;
62
+ }, z.core.$strip>;
63
+ export declare const MemoryInfoSchema: z.ZodObject<{
64
+ rss_mb: z.ZodNumber;
65
+ heap_used_mb: z.ZodNumber;
66
+ heap_total_mb: z.ZodNumber;
67
+ external_mb: z.ZodNumber;
68
+ array_buffers_mb: z.ZodNumber;
69
+ description: z.ZodRecord<z.ZodString, z.ZodString>;
70
+ }, z.core.$strip>;
71
+ export declare const EnvironmentInfoSchema: z.ZodObject<{
72
+ token_present: z.ZodBoolean;
73
+ token_length: z.ZodNumber;
74
+ token_preview: z.ZodNullable<z.ZodString>;
75
+ ynab_env_keys_present: z.ZodArray<z.ZodString>;
76
+ working_directory: z.ZodString;
77
+ }, z.core.$strip>;
78
+ export declare const CacheInfoSchema: z.ZodObject<{
79
+ entries: z.ZodNumber;
80
+ estimated_size_kb: z.ZodNumber;
81
+ keys: z.ZodArray<z.ZodString>;
82
+ hits: z.ZodOptional<z.ZodNumber>;
83
+ misses: z.ZodOptional<z.ZodNumber>;
84
+ evictions: z.ZodOptional<z.ZodNumber>;
85
+ lastCleanup: z.ZodOptional<z.ZodNullable<z.ZodString>>;
86
+ maxEntries: z.ZodOptional<z.ZodNumber>;
87
+ hitRate: z.ZodOptional<z.ZodString>;
88
+ performance_summary: z.ZodOptional<z.ZodString>;
89
+ }, z.core.$strip>;
90
+ export declare const DeltaInfoSchema: z.ZodObject<{
91
+ enabled: z.ZodBoolean;
92
+ knowledge_entries: z.ZodNumber;
93
+ knowledge_stats: z.ZodRecord<z.ZodString, z.ZodUnknown>;
94
+ feature_flag: z.ZodString;
95
+ delta_hits: z.ZodNumber;
96
+ delta_misses: z.ZodNumber;
97
+ delta_hit_rate: z.ZodNumber;
98
+ merge_operations: z.ZodNumber;
99
+ knowledge_gap_events: z.ZodNumber;
100
+ }, z.core.$strip>;
101
+ export declare const DiagnosticInfoOutputSchema: z.ZodObject<{
102
+ timestamp: z.ZodString;
103
+ server: z.ZodOptional<z.ZodObject<{
104
+ name: z.ZodString;
105
+ version: z.ZodString;
106
+ node_version: z.ZodString;
107
+ platform: z.ZodString;
108
+ arch: z.ZodString;
109
+ pid: z.ZodNumber;
110
+ uptime_ms: z.ZodNumber;
111
+ uptime_readable: z.ZodString;
112
+ env: z.ZodRecord<z.ZodString, z.ZodUnknown>;
113
+ }, z.core.$strip>>;
114
+ memory: z.ZodOptional<z.ZodObject<{
115
+ rss_mb: z.ZodNumber;
116
+ heap_used_mb: z.ZodNumber;
117
+ heap_total_mb: z.ZodNumber;
118
+ external_mb: z.ZodNumber;
119
+ array_buffers_mb: z.ZodNumber;
120
+ description: z.ZodRecord<z.ZodString, z.ZodString>;
121
+ }, z.core.$strip>>;
122
+ environment: z.ZodOptional<z.ZodObject<{
123
+ token_present: z.ZodBoolean;
124
+ token_length: z.ZodNumber;
125
+ token_preview: z.ZodNullable<z.ZodString>;
126
+ ynab_env_keys_present: z.ZodArray<z.ZodString>;
127
+ working_directory: z.ZodString;
128
+ }, z.core.$strip>>;
129
+ cache: z.ZodOptional<z.ZodObject<{
130
+ entries: z.ZodNumber;
131
+ estimated_size_kb: z.ZodNumber;
132
+ keys: z.ZodArray<z.ZodString>;
133
+ hits: z.ZodOptional<z.ZodNumber>;
134
+ misses: z.ZodOptional<z.ZodNumber>;
135
+ evictions: z.ZodOptional<z.ZodNumber>;
136
+ lastCleanup: z.ZodOptional<z.ZodNullable<z.ZodString>>;
137
+ maxEntries: z.ZodOptional<z.ZodNumber>;
138
+ hitRate: z.ZodOptional<z.ZodString>;
139
+ performance_summary: z.ZodOptional<z.ZodString>;
140
+ }, z.core.$strip>>;
141
+ delta: z.ZodOptional<z.ZodObject<{
142
+ enabled: z.ZodBoolean;
143
+ knowledge_entries: z.ZodNumber;
144
+ knowledge_stats: z.ZodRecord<z.ZodString, z.ZodUnknown>;
145
+ feature_flag: z.ZodString;
146
+ delta_hits: z.ZodNumber;
147
+ delta_misses: z.ZodNumber;
148
+ delta_hit_rate: z.ZodNumber;
149
+ merge_operations: z.ZodNumber;
150
+ knowledge_gap_events: z.ZodNumber;
151
+ }, z.core.$strip>>;
152
+ }, z.core.$strip>;
153
+ export type DiagnosticInfoOutput = z.infer<typeof DiagnosticInfoOutputSchema>;
154
+ export declare const DateFormatSchema: z.ZodObject<{
155
+ format: z.ZodString;
156
+ }, z.core.$strip>;
157
+ export declare const CurrencyFormatSchema: z.ZodObject<{
158
+ iso_code: z.ZodString;
159
+ example_format: z.ZodString;
160
+ decimal_digits: z.ZodNumber;
161
+ decimal_separator: z.ZodOptional<z.ZodString>;
162
+ symbol_first: z.ZodOptional<z.ZodBoolean>;
163
+ group_separator: z.ZodOptional<z.ZodString>;
164
+ currency_symbol: z.ZodOptional<z.ZodString>;
165
+ display_symbol: z.ZodOptional<z.ZodBoolean>;
166
+ }, z.core.$strip>;
167
+ export declare const BudgetDetailSchema: z.ZodObject<{
168
+ id: z.ZodString;
169
+ name: z.ZodString;
170
+ last_modified_on: z.ZodOptional<z.ZodString>;
171
+ first_month: z.ZodOptional<z.ZodString>;
172
+ last_month: z.ZodOptional<z.ZodString>;
173
+ date_format: z.ZodOptional<z.ZodObject<{
174
+ format: z.ZodString;
175
+ }, z.core.$strip>>;
176
+ currency_format: z.ZodOptional<z.ZodObject<{
177
+ iso_code: z.ZodString;
178
+ example_format: z.ZodString;
179
+ decimal_digits: z.ZodNumber;
180
+ decimal_separator: z.ZodOptional<z.ZodString>;
181
+ symbol_first: z.ZodOptional<z.ZodBoolean>;
182
+ group_separator: z.ZodOptional<z.ZodString>;
183
+ currency_symbol: z.ZodOptional<z.ZodString>;
184
+ display_symbol: z.ZodOptional<z.ZodBoolean>;
185
+ }, z.core.$strip>>;
186
+ accounts_count: z.ZodNumber;
187
+ categories_count: z.ZodNumber;
188
+ payees_count: z.ZodNumber;
189
+ months_count: z.ZodNumber;
190
+ message: z.ZodString;
191
+ }, z.core.$strip>;
192
+ export declare const GetBudgetOutputSchema: z.ZodObject<{
193
+ budget: z.ZodObject<{
194
+ id: z.ZodString;
195
+ name: z.ZodString;
196
+ last_modified_on: z.ZodOptional<z.ZodString>;
197
+ first_month: z.ZodOptional<z.ZodString>;
198
+ last_month: z.ZodOptional<z.ZodString>;
199
+ date_format: z.ZodOptional<z.ZodObject<{
200
+ format: z.ZodString;
201
+ }, z.core.$strip>>;
202
+ currency_format: z.ZodOptional<z.ZodObject<{
203
+ iso_code: z.ZodString;
204
+ example_format: z.ZodString;
205
+ decimal_digits: z.ZodNumber;
206
+ decimal_separator: z.ZodOptional<z.ZodString>;
207
+ symbol_first: z.ZodOptional<z.ZodBoolean>;
208
+ group_separator: z.ZodOptional<z.ZodString>;
209
+ currency_symbol: z.ZodOptional<z.ZodString>;
210
+ display_symbol: z.ZodOptional<z.ZodBoolean>;
211
+ }, z.core.$strip>>;
212
+ accounts_count: z.ZodNumber;
213
+ categories_count: z.ZodNumber;
214
+ payees_count: z.ZodNumber;
215
+ months_count: z.ZodNumber;
216
+ message: z.ZodString;
217
+ }, z.core.$strip>;
218
+ }, z.core.$strip>;
219
+ export type GetBudgetOutput = z.infer<typeof GetBudgetOutputSchema>;