@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,717 @@
1
+ import { z } from 'zod';
2
+ export declare const SubtransactionSchema: z.ZodObject<{
3
+ id: z.ZodString;
4
+ transaction_id: z.ZodString;
5
+ amount: z.ZodNumber;
6
+ memo: z.ZodOptional<z.ZodString>;
7
+ payee_id: z.ZodOptional<z.ZodString>;
8
+ payee_name: z.ZodOptional<z.ZodString>;
9
+ category_id: z.ZodOptional<z.ZodString>;
10
+ category_name: z.ZodOptional<z.ZodString>;
11
+ transfer_account_id: z.ZodOptional<z.ZodString>;
12
+ transfer_transaction_id: z.ZodOptional<z.ZodString>;
13
+ deleted: z.ZodBoolean;
14
+ }, z.core.$strip>;
15
+ export type Subtransaction = z.infer<typeof SubtransactionSchema>;
16
+ export declare const TransactionWithBalanceSchema: z.ZodObject<{
17
+ id: z.ZodString;
18
+ date: z.ZodString;
19
+ amount: z.ZodNumber;
20
+ memo: z.ZodOptional<z.ZodString>;
21
+ cleared: z.ZodString;
22
+ approved: z.ZodBoolean;
23
+ flag_color: z.ZodOptional<z.ZodString>;
24
+ account_id: z.ZodString;
25
+ payee_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
26
+ category_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
27
+ transfer_account_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
28
+ transfer_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
29
+ matched_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
30
+ import_id: z.ZodOptional<z.ZodString>;
31
+ deleted: z.ZodBoolean;
32
+ account_name: z.ZodOptional<z.ZodString>;
33
+ payee_name: z.ZodOptional<z.ZodString>;
34
+ category_name: z.ZodOptional<z.ZodString>;
35
+ account_balance: z.ZodOptional<z.ZodNumber>;
36
+ account_cleared_balance: z.ZodOptional<z.ZodNumber>;
37
+ subtransactions: z.ZodOptional<z.ZodArray<z.ZodObject<{
38
+ id: z.ZodString;
39
+ transaction_id: z.ZodString;
40
+ amount: z.ZodNumber;
41
+ memo: z.ZodOptional<z.ZodString>;
42
+ payee_id: z.ZodOptional<z.ZodString>;
43
+ payee_name: z.ZodOptional<z.ZodString>;
44
+ category_id: z.ZodOptional<z.ZodString>;
45
+ category_name: z.ZodOptional<z.ZodString>;
46
+ transfer_account_id: z.ZodOptional<z.ZodString>;
47
+ transfer_transaction_id: z.ZodOptional<z.ZodString>;
48
+ deleted: z.ZodBoolean;
49
+ }, z.core.$strip>>>;
50
+ }, z.core.$strip>;
51
+ export type TransactionWithBalance = z.infer<typeof TransactionWithBalanceSchema>;
52
+ export declare const ReceiptItemSchema: z.ZodObject<{
53
+ name: z.ZodString;
54
+ quantity: z.ZodOptional<z.ZodNumber>;
55
+ amount: z.ZodNumber;
56
+ memo: z.ZodOptional<z.ZodString>;
57
+ }, z.core.$strip>;
58
+ export type ReceiptItem = z.infer<typeof ReceiptItemSchema>;
59
+ export declare const ReceiptCategoryBreakdownSchema: z.ZodObject<{
60
+ category_id: z.ZodString;
61
+ category_name: z.ZodOptional<z.ZodString>;
62
+ items: z.ZodArray<z.ZodObject<{
63
+ name: z.ZodString;
64
+ quantity: z.ZodOptional<z.ZodNumber>;
65
+ amount: z.ZodNumber;
66
+ memo: z.ZodOptional<z.ZodString>;
67
+ }, z.core.$strip>>;
68
+ subtotal: z.ZodNumber;
69
+ tax: z.ZodNumber;
70
+ total: z.ZodNumber;
71
+ }, z.core.$strip>;
72
+ export type ReceiptCategoryBreakdown = z.infer<typeof ReceiptCategoryBreakdownSchema>;
73
+ export declare const ReceiptSummarySchema: z.ZodObject<{
74
+ subtotal: z.ZodNumber;
75
+ tax: z.ZodNumber;
76
+ total: z.ZodNumber;
77
+ categories: z.ZodArray<z.ZodObject<{
78
+ category_id: z.ZodString;
79
+ category_name: z.ZodOptional<z.ZodString>;
80
+ items: z.ZodArray<z.ZodObject<{
81
+ name: z.ZodString;
82
+ quantity: z.ZodOptional<z.ZodNumber>;
83
+ amount: z.ZodNumber;
84
+ memo: z.ZodOptional<z.ZodString>;
85
+ }, z.core.$strip>>;
86
+ subtotal: z.ZodNumber;
87
+ tax: z.ZodNumber;
88
+ total: z.ZodNumber;
89
+ }, z.core.$strip>>;
90
+ }, z.core.$strip>;
91
+ export type ReceiptSummary = z.infer<typeof ReceiptSummarySchema>;
92
+ export declare const BulkOperationSummarySchema: z.ZodObject<{
93
+ total_requested: z.ZodNumber;
94
+ created: z.ZodOptional<z.ZodNumber>;
95
+ updated: z.ZodOptional<z.ZodNumber>;
96
+ duplicates: z.ZodOptional<z.ZodNumber>;
97
+ failed: z.ZodNumber;
98
+ }, z.core.$strip>;
99
+ export type BulkOperationSummary = z.infer<typeof BulkOperationSummarySchema>;
100
+ export declare const BulkResultSchema: z.ZodObject<{
101
+ request_index: z.ZodNumber;
102
+ status: z.ZodEnum<{
103
+ created: "created";
104
+ duplicate: "duplicate";
105
+ failed: "failed";
106
+ updated: "updated";
107
+ }>;
108
+ transaction_id: z.ZodOptional<z.ZodString>;
109
+ correlation_key: z.ZodString;
110
+ error_code: z.ZodOptional<z.ZodString>;
111
+ error: z.ZodOptional<z.ZodString>;
112
+ }, z.core.$loose>;
113
+ export type BulkResult = z.infer<typeof BulkResultSchema>;
114
+ export declare const TransactionDiffFieldsSchema: z.ZodObject<{
115
+ amount: z.ZodOptional<z.ZodNumber>;
116
+ date: z.ZodOptional<z.ZodString>;
117
+ memo: z.ZodOptional<z.ZodString>;
118
+ payee_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
119
+ payee_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
120
+ category_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
121
+ cleared: z.ZodOptional<z.ZodEnum<{
122
+ cleared: "cleared";
123
+ uncleared: "uncleared";
124
+ reconciled: "reconciled";
125
+ }>>;
126
+ approved: z.ZodOptional<z.ZodBoolean>;
127
+ flag_color: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
128
+ red: "red";
129
+ orange: "orange";
130
+ yellow: "yellow";
131
+ green: "green";
132
+ blue: "blue";
133
+ purple: "purple";
134
+ }>>>;
135
+ }, z.core.$strip>;
136
+ export type TransactionDiffFields = z.infer<typeof TransactionDiffFieldsSchema>;
137
+ export declare const DryRunPreviewItemSchema: z.ZodObject<{
138
+ transaction_id: z.ZodString;
139
+ before: z.ZodUnion<readonly [z.ZodLiteral<"unavailable">, z.ZodObject<{
140
+ amount: z.ZodOptional<z.ZodNumber>;
141
+ date: z.ZodOptional<z.ZodString>;
142
+ memo: z.ZodOptional<z.ZodString>;
143
+ payee_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
144
+ payee_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
145
+ category_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
146
+ cleared: z.ZodOptional<z.ZodEnum<{
147
+ cleared: "cleared";
148
+ uncleared: "uncleared";
149
+ reconciled: "reconciled";
150
+ }>>;
151
+ approved: z.ZodOptional<z.ZodBoolean>;
152
+ flag_color: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
153
+ red: "red";
154
+ orange: "orange";
155
+ yellow: "yellow";
156
+ green: "green";
157
+ blue: "blue";
158
+ purple: "purple";
159
+ }>>>;
160
+ }, z.core.$strip>]>;
161
+ after: z.ZodObject<{
162
+ amount: z.ZodOptional<z.ZodNumber>;
163
+ date: z.ZodOptional<z.ZodString>;
164
+ memo: z.ZodOptional<z.ZodString>;
165
+ payee_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
166
+ payee_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
167
+ category_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
168
+ cleared: z.ZodOptional<z.ZodEnum<{
169
+ cleared: "cleared";
170
+ uncleared: "uncleared";
171
+ reconciled: "reconciled";
172
+ }>>;
173
+ approved: z.ZodOptional<z.ZodBoolean>;
174
+ flag_color: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
175
+ red: "red";
176
+ orange: "orange";
177
+ yellow: "yellow";
178
+ green: "green";
179
+ blue: "blue";
180
+ purple: "purple";
181
+ }>>>;
182
+ }, z.core.$strip>;
183
+ }, z.core.$strip>;
184
+ export type DryRunPreviewItem = z.infer<typeof DryRunPreviewItemSchema>;
185
+ export declare const DryRunWarningSchema: z.ZodObject<{
186
+ code: z.ZodString;
187
+ count: z.ZodNumber;
188
+ message: z.ZodString;
189
+ sample_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
190
+ }, z.core.$strip>;
191
+ export type DryRunWarning = z.infer<typeof DryRunWarningSchema>;
192
+ export declare const CreateTransactionOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
193
+ dry_run: z.ZodLiteral<true>;
194
+ action: z.ZodLiteral<"create_transaction">;
195
+ request: z.ZodRecord<z.ZodString, z.ZodUnknown>;
196
+ }, z.core.$strip>, z.ZodObject<{
197
+ transaction: z.ZodObject<{
198
+ id: z.ZodString;
199
+ date: z.ZodString;
200
+ amount: z.ZodNumber;
201
+ memo: z.ZodOptional<z.ZodString>;
202
+ cleared: z.ZodString;
203
+ approved: z.ZodBoolean;
204
+ flag_color: z.ZodOptional<z.ZodString>;
205
+ account_id: z.ZodString;
206
+ payee_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
207
+ category_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
208
+ transfer_account_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
209
+ transfer_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
210
+ matched_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
211
+ import_id: z.ZodOptional<z.ZodString>;
212
+ deleted: z.ZodBoolean;
213
+ account_name: z.ZodOptional<z.ZodString>;
214
+ payee_name: z.ZodOptional<z.ZodString>;
215
+ category_name: z.ZodOptional<z.ZodString>;
216
+ account_balance: z.ZodOptional<z.ZodNumber>;
217
+ account_cleared_balance: z.ZodOptional<z.ZodNumber>;
218
+ subtransactions: z.ZodOptional<z.ZodArray<z.ZodObject<{
219
+ id: z.ZodString;
220
+ transaction_id: z.ZodString;
221
+ amount: z.ZodNumber;
222
+ memo: z.ZodOptional<z.ZodString>;
223
+ payee_id: z.ZodOptional<z.ZodString>;
224
+ payee_name: z.ZodOptional<z.ZodString>;
225
+ category_id: z.ZodOptional<z.ZodString>;
226
+ category_name: z.ZodOptional<z.ZodString>;
227
+ transfer_account_id: z.ZodOptional<z.ZodString>;
228
+ transfer_transaction_id: z.ZodOptional<z.ZodString>;
229
+ deleted: z.ZodBoolean;
230
+ }, z.core.$strip>>>;
231
+ }, z.core.$strip>;
232
+ }, z.core.$strip>]>;
233
+ export type CreateTransactionOutput = z.infer<typeof CreateTransactionOutputSchema>;
234
+ export declare const CreateTransactionPreviewSchema: z.ZodObject<{
235
+ request_index: z.ZodNumber;
236
+ account_id: z.ZodString;
237
+ date: z.ZodString;
238
+ amount: z.ZodNumber;
239
+ memo: z.ZodOptional<z.ZodString>;
240
+ payee_id: z.ZodOptional<z.ZodString>;
241
+ payee_name: z.ZodOptional<z.ZodString>;
242
+ category_id: z.ZodOptional<z.ZodString>;
243
+ import_id: z.ZodOptional<z.ZodString>;
244
+ }, z.core.$strip>;
245
+ export type CreateTransactionPreview = z.infer<typeof CreateTransactionPreviewSchema>;
246
+ export declare const CreateTransactionsOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
247
+ dry_run: z.ZodLiteral<true>;
248
+ action: z.ZodLiteral<"create_transactions">;
249
+ validation: z.ZodLiteral<"passed">;
250
+ summary: z.ZodObject<{
251
+ total_transactions: z.ZodNumber;
252
+ total_amount: z.ZodNumber;
253
+ accounts_affected: z.ZodArray<z.ZodString>;
254
+ date_range: z.ZodOptional<z.ZodObject<{
255
+ earliest: z.ZodString;
256
+ latest: z.ZodString;
257
+ }, z.core.$strip>>;
258
+ categories_affected: z.ZodArray<z.ZodString>;
259
+ }, z.core.$strip>;
260
+ transactions_preview: z.ZodArray<z.ZodObject<{
261
+ request_index: z.ZodNumber;
262
+ account_id: z.ZodString;
263
+ date: z.ZodString;
264
+ amount: z.ZodNumber;
265
+ memo: z.ZodOptional<z.ZodString>;
266
+ payee_id: z.ZodOptional<z.ZodString>;
267
+ payee_name: z.ZodOptional<z.ZodString>;
268
+ category_id: z.ZodOptional<z.ZodString>;
269
+ import_id: z.ZodOptional<z.ZodString>;
270
+ }, z.core.$strip>>;
271
+ note: z.ZodString;
272
+ }, z.core.$strict>, z.ZodObject<{
273
+ success: z.ZodBoolean;
274
+ server_knowledge: z.ZodOptional<z.ZodNumber>;
275
+ summary: z.ZodObject<{
276
+ total_requested: z.ZodNumber;
277
+ created: z.ZodOptional<z.ZodNumber>;
278
+ updated: z.ZodOptional<z.ZodNumber>;
279
+ duplicates: z.ZodOptional<z.ZodNumber>;
280
+ failed: z.ZodNumber;
281
+ }, z.core.$strip>;
282
+ results: z.ZodArray<z.ZodObject<{
283
+ request_index: z.ZodNumber;
284
+ status: z.ZodEnum<{
285
+ created: "created";
286
+ duplicate: "duplicate";
287
+ failed: "failed";
288
+ updated: "updated";
289
+ }>;
290
+ transaction_id: z.ZodOptional<z.ZodString>;
291
+ correlation_key: z.ZodString;
292
+ error_code: z.ZodOptional<z.ZodString>;
293
+ error: z.ZodOptional<z.ZodString>;
294
+ }, z.core.$loose>>;
295
+ transactions: z.ZodOptional<z.ZodArray<z.ZodObject<{
296
+ id: z.ZodString;
297
+ date: z.ZodString;
298
+ amount: z.ZodNumber;
299
+ memo: z.ZodOptional<z.ZodString>;
300
+ cleared: z.ZodString;
301
+ approved: z.ZodBoolean;
302
+ flag_color: z.ZodOptional<z.ZodString>;
303
+ account_id: z.ZodString;
304
+ payee_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
305
+ category_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
306
+ transfer_account_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
307
+ transfer_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
308
+ matched_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
309
+ import_id: z.ZodOptional<z.ZodString>;
310
+ deleted: z.ZodBoolean;
311
+ account_name: z.ZodOptional<z.ZodString>;
312
+ payee_name: z.ZodOptional<z.ZodString>;
313
+ category_name: z.ZodOptional<z.ZodString>;
314
+ }, z.core.$strip>>>;
315
+ duplicate_import_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
316
+ message: z.ZodOptional<z.ZodString>;
317
+ mode: z.ZodOptional<z.ZodEnum<{
318
+ full: "full";
319
+ summary: "summary";
320
+ ids_only: "ids_only";
321
+ }>>;
322
+ }, z.core.$loose>]>;
323
+ export type CreateTransactionsOutput = z.infer<typeof CreateTransactionsOutputSchema>;
324
+ export declare const UpdateTransactionOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
325
+ dry_run: z.ZodLiteral<true>;
326
+ action: z.ZodLiteral<"update_transaction">;
327
+ request: z.ZodRecord<z.ZodString, z.ZodUnknown>;
328
+ }, z.core.$strip>, z.ZodObject<{
329
+ transaction: z.ZodObject<{
330
+ id: z.ZodString;
331
+ date: z.ZodString;
332
+ amount: z.ZodNumber;
333
+ memo: z.ZodOptional<z.ZodString>;
334
+ cleared: z.ZodString;
335
+ approved: z.ZodBoolean;
336
+ flag_color: z.ZodOptional<z.ZodString>;
337
+ account_id: z.ZodString;
338
+ payee_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
339
+ category_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
340
+ transfer_account_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
341
+ transfer_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
342
+ matched_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
343
+ import_id: z.ZodOptional<z.ZodString>;
344
+ deleted: z.ZodBoolean;
345
+ account_name: z.ZodOptional<z.ZodString>;
346
+ payee_name: z.ZodOptional<z.ZodString>;
347
+ category_name: z.ZodOptional<z.ZodString>;
348
+ account_balance: z.ZodOptional<z.ZodNumber>;
349
+ account_cleared_balance: z.ZodOptional<z.ZodNumber>;
350
+ subtransactions: z.ZodOptional<z.ZodArray<z.ZodObject<{
351
+ id: z.ZodString;
352
+ transaction_id: z.ZodString;
353
+ amount: z.ZodNumber;
354
+ memo: z.ZodOptional<z.ZodString>;
355
+ payee_id: z.ZodOptional<z.ZodString>;
356
+ payee_name: z.ZodOptional<z.ZodString>;
357
+ category_id: z.ZodOptional<z.ZodString>;
358
+ category_name: z.ZodOptional<z.ZodString>;
359
+ transfer_account_id: z.ZodOptional<z.ZodString>;
360
+ transfer_transaction_id: z.ZodOptional<z.ZodString>;
361
+ deleted: z.ZodBoolean;
362
+ }, z.core.$strip>>>;
363
+ }, z.core.$strip>;
364
+ updated_balance: z.ZodNumber;
365
+ updated_cleared_balance: z.ZodNumber;
366
+ }, z.core.$strip>]>;
367
+ export type UpdateTransactionOutput = z.infer<typeof UpdateTransactionOutputSchema>;
368
+ export declare const UpdateTransactionsOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
369
+ dry_run: z.ZodLiteral<true>;
370
+ action: z.ZodLiteral<"update_transactions">;
371
+ validation: z.ZodLiteral<"passed">;
372
+ summary: z.ZodObject<{
373
+ total_transactions: z.ZodNumber;
374
+ accounts_affected: z.ZodNumber;
375
+ fields_to_update: z.ZodArray<z.ZodString>;
376
+ }, z.core.$strip>;
377
+ transactions_preview: z.ZodArray<z.ZodObject<{
378
+ transaction_id: z.ZodString;
379
+ before: z.ZodUnion<readonly [z.ZodLiteral<"unavailable">, z.ZodObject<{
380
+ amount: z.ZodOptional<z.ZodNumber>;
381
+ date: z.ZodOptional<z.ZodString>;
382
+ memo: z.ZodOptional<z.ZodString>;
383
+ payee_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
384
+ payee_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
385
+ category_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
386
+ cleared: z.ZodOptional<z.ZodEnum<{
387
+ cleared: "cleared";
388
+ uncleared: "uncleared";
389
+ reconciled: "reconciled";
390
+ }>>;
391
+ approved: z.ZodOptional<z.ZodBoolean>;
392
+ flag_color: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
393
+ red: "red";
394
+ orange: "orange";
395
+ yellow: "yellow";
396
+ green: "green";
397
+ blue: "blue";
398
+ purple: "purple";
399
+ }>>>;
400
+ }, z.core.$strip>]>;
401
+ after: z.ZodObject<{
402
+ amount: z.ZodOptional<z.ZodNumber>;
403
+ date: z.ZodOptional<z.ZodString>;
404
+ memo: z.ZodOptional<z.ZodString>;
405
+ payee_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
406
+ payee_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
407
+ category_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
408
+ cleared: z.ZodOptional<z.ZodEnum<{
409
+ cleared: "cleared";
410
+ uncleared: "uncleared";
411
+ reconciled: "reconciled";
412
+ }>>;
413
+ approved: z.ZodOptional<z.ZodBoolean>;
414
+ flag_color: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
415
+ red: "red";
416
+ orange: "orange";
417
+ yellow: "yellow";
418
+ green: "green";
419
+ blue: "blue";
420
+ purple: "purple";
421
+ }>>>;
422
+ }, z.core.$strip>;
423
+ }, z.core.$strip>>;
424
+ warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
425
+ code: z.ZodString;
426
+ count: z.ZodNumber;
427
+ message: z.ZodString;
428
+ sample_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
429
+ }, z.core.$strip>>>;
430
+ note: z.ZodString;
431
+ }, z.core.$strict>, z.ZodObject<{
432
+ success: z.ZodBoolean;
433
+ server_knowledge: z.ZodOptional<z.ZodNumber>;
434
+ summary: z.ZodObject<{
435
+ total_requested: z.ZodNumber;
436
+ created: z.ZodOptional<z.ZodNumber>;
437
+ updated: z.ZodOptional<z.ZodNumber>;
438
+ duplicates: z.ZodOptional<z.ZodNumber>;
439
+ failed: z.ZodNumber;
440
+ }, z.core.$strip>;
441
+ results: z.ZodArray<z.ZodObject<{
442
+ request_index: z.ZodNumber;
443
+ status: z.ZodEnum<{
444
+ created: "created";
445
+ duplicate: "duplicate";
446
+ failed: "failed";
447
+ updated: "updated";
448
+ }>;
449
+ transaction_id: z.ZodOptional<z.ZodString>;
450
+ correlation_key: z.ZodString;
451
+ error_code: z.ZodOptional<z.ZodString>;
452
+ error: z.ZodOptional<z.ZodString>;
453
+ }, z.core.$loose>>;
454
+ transactions: z.ZodOptional<z.ZodArray<z.ZodObject<{
455
+ id: z.ZodString;
456
+ date: z.ZodString;
457
+ amount: z.ZodNumber;
458
+ memo: z.ZodOptional<z.ZodString>;
459
+ cleared: z.ZodString;
460
+ approved: z.ZodBoolean;
461
+ flag_color: z.ZodOptional<z.ZodString>;
462
+ account_id: z.ZodString;
463
+ payee_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
464
+ category_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
465
+ transfer_account_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
466
+ transfer_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
467
+ matched_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
468
+ import_id: z.ZodOptional<z.ZodString>;
469
+ deleted: z.ZodBoolean;
470
+ account_name: z.ZodOptional<z.ZodString>;
471
+ payee_name: z.ZodOptional<z.ZodString>;
472
+ category_name: z.ZodOptional<z.ZodString>;
473
+ }, z.core.$strip>>>;
474
+ message: z.ZodOptional<z.ZodString>;
475
+ mode: z.ZodOptional<z.ZodEnum<{
476
+ full: "full";
477
+ summary: "summary";
478
+ ids_only: "ids_only";
479
+ }>>;
480
+ }, z.core.$loose>]>;
481
+ export type UpdateTransactionsOutput = z.infer<typeof UpdateTransactionsOutputSchema>;
482
+ export declare const DeleteTransactionOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
483
+ dry_run: z.ZodLiteral<true>;
484
+ action: z.ZodLiteral<"delete_transaction">;
485
+ request: z.ZodRecord<z.ZodString, z.ZodUnknown>;
486
+ }, z.core.$strip>, z.ZodObject<{
487
+ message: z.ZodString;
488
+ transaction: z.ZodObject<{
489
+ id: z.ZodString;
490
+ deleted: z.ZodBoolean;
491
+ }, z.core.$strip>;
492
+ updated_balance: z.ZodNumber;
493
+ updated_cleared_balance: z.ZodNumber;
494
+ }, z.core.$strip>]>;
495
+ export type DeleteTransactionOutput = z.infer<typeof DeleteTransactionOutputSchema>;
496
+ export declare const TransactionDryRunPreviewSchema: z.ZodObject<{
497
+ account_id: z.ZodString;
498
+ date: z.ZodString;
499
+ amount: z.ZodNumber;
500
+ memo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
501
+ cleared: z.ZodOptional<z.ZodEnum<{
502
+ cleared: "cleared";
503
+ uncleared: "uncleared";
504
+ reconciled: "reconciled";
505
+ }>>;
506
+ approved: z.ZodOptional<z.ZodBoolean>;
507
+ flag_color: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
508
+ red: "red";
509
+ orange: "orange";
510
+ yellow: "yellow";
511
+ green: "green";
512
+ blue: "blue";
513
+ purple: "purple";
514
+ }>>>;
515
+ payee_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
516
+ payee_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
517
+ category_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
518
+ import_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
519
+ }, z.core.$strip>;
520
+ export type TransactionDryRunPreview = z.infer<typeof TransactionDryRunPreviewSchema>;
521
+ export declare const SubtransactionPreviewSchema: z.ZodObject<{
522
+ amount: z.ZodNumber;
523
+ memo: z.ZodOptional<z.ZodString>;
524
+ payee_id: z.ZodOptional<z.ZodString>;
525
+ category_id: z.ZodOptional<z.ZodString>;
526
+ transfer_account_id: z.ZodOptional<z.ZodString>;
527
+ transfer_transaction_id: z.ZodOptional<z.ZodString>;
528
+ payee_name: z.ZodOptional<z.ZodString>;
529
+ category_name: z.ZodOptional<z.ZodString>;
530
+ }, z.core.$strip>;
531
+ export type SubtransactionPreview = z.infer<typeof SubtransactionPreviewSchema>;
532
+ export declare const CreateReceiptSplitTransactionOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
533
+ dry_run: z.ZodLiteral<true>;
534
+ action: z.ZodLiteral<"create_receipt_split_transaction">;
535
+ transaction_preview: z.ZodObject<{
536
+ account_id: z.ZodString;
537
+ date: z.ZodString;
538
+ amount: z.ZodNumber;
539
+ memo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
540
+ cleared: z.ZodOptional<z.ZodEnum<{
541
+ cleared: "cleared";
542
+ uncleared: "uncleared";
543
+ reconciled: "reconciled";
544
+ }>>;
545
+ approved: z.ZodOptional<z.ZodBoolean>;
546
+ flag_color: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
547
+ red: "red";
548
+ orange: "orange";
549
+ yellow: "yellow";
550
+ green: "green";
551
+ blue: "blue";
552
+ purple: "purple";
553
+ }>>>;
554
+ payee_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
555
+ payee_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
556
+ category_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
557
+ import_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
558
+ }, z.core.$strip>;
559
+ receipt_summary: z.ZodObject<{
560
+ subtotal: z.ZodNumber;
561
+ tax: z.ZodNumber;
562
+ total: z.ZodNumber;
563
+ categories: z.ZodArray<z.ZodObject<{
564
+ category_id: z.ZodString;
565
+ category_name: z.ZodOptional<z.ZodString>;
566
+ items: z.ZodArray<z.ZodObject<{
567
+ name: z.ZodString;
568
+ quantity: z.ZodOptional<z.ZodNumber>;
569
+ amount: z.ZodNumber;
570
+ memo: z.ZodOptional<z.ZodString>;
571
+ }, z.core.$strip>>;
572
+ subtotal: z.ZodNumber;
573
+ tax: z.ZodNumber;
574
+ total: z.ZodNumber;
575
+ }, z.core.$strip>>;
576
+ }, z.core.$strip>;
577
+ subtransactions: z.ZodArray<z.ZodObject<{
578
+ amount: z.ZodNumber;
579
+ memo: z.ZodOptional<z.ZodString>;
580
+ payee_id: z.ZodOptional<z.ZodString>;
581
+ category_id: z.ZodOptional<z.ZodString>;
582
+ transfer_account_id: z.ZodOptional<z.ZodString>;
583
+ transfer_transaction_id: z.ZodOptional<z.ZodString>;
584
+ payee_name: z.ZodOptional<z.ZodString>;
585
+ category_name: z.ZodOptional<z.ZodString>;
586
+ }, z.core.$strip>>;
587
+ }, z.core.$strip>, z.ZodObject<{
588
+ transaction: z.ZodObject<{
589
+ id: z.ZodString;
590
+ date: z.ZodString;
591
+ amount: z.ZodNumber;
592
+ memo: z.ZodOptional<z.ZodString>;
593
+ cleared: z.ZodString;
594
+ approved: z.ZodBoolean;
595
+ flag_color: z.ZodOptional<z.ZodString>;
596
+ account_id: z.ZodString;
597
+ payee_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
598
+ category_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
599
+ transfer_account_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
600
+ transfer_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
601
+ matched_transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
602
+ import_id: z.ZodOptional<z.ZodString>;
603
+ deleted: z.ZodBoolean;
604
+ account_name: z.ZodOptional<z.ZodString>;
605
+ payee_name: z.ZodOptional<z.ZodString>;
606
+ category_name: z.ZodOptional<z.ZodString>;
607
+ account_balance: z.ZodOptional<z.ZodNumber>;
608
+ account_cleared_balance: z.ZodOptional<z.ZodNumber>;
609
+ subtransactions: z.ZodOptional<z.ZodArray<z.ZodObject<{
610
+ id: z.ZodString;
611
+ transaction_id: z.ZodString;
612
+ amount: z.ZodNumber;
613
+ memo: z.ZodOptional<z.ZodString>;
614
+ payee_id: z.ZodOptional<z.ZodString>;
615
+ payee_name: z.ZodOptional<z.ZodString>;
616
+ category_id: z.ZodOptional<z.ZodString>;
617
+ category_name: z.ZodOptional<z.ZodString>;
618
+ transfer_account_id: z.ZodOptional<z.ZodString>;
619
+ transfer_transaction_id: z.ZodOptional<z.ZodString>;
620
+ deleted: z.ZodBoolean;
621
+ }, z.core.$strip>>>;
622
+ }, z.core.$strip>;
623
+ receipt_summary: z.ZodObject<{
624
+ subtotal: z.ZodNumber;
625
+ tax: z.ZodNumber;
626
+ total: z.ZodNumber;
627
+ categories: z.ZodArray<z.ZodObject<{
628
+ category_id: z.ZodString;
629
+ category_name: z.ZodOptional<z.ZodString>;
630
+ items: z.ZodArray<z.ZodObject<{
631
+ name: z.ZodString;
632
+ quantity: z.ZodOptional<z.ZodNumber>;
633
+ amount: z.ZodNumber;
634
+ memo: z.ZodOptional<z.ZodString>;
635
+ }, z.core.$strip>>;
636
+ subtotal: z.ZodNumber;
637
+ tax: z.ZodNumber;
638
+ total: z.ZodNumber;
639
+ }, z.core.$strip>>;
640
+ }, z.core.$strip>;
641
+ }, z.core.$strip>]>;
642
+ export type CreateReceiptSplitTransactionOutput = z.infer<typeof CreateReceiptSplitTransactionOutputSchema>;
643
+ export declare const CreateAccountDryRunRequestSchema: z.ZodObject<{
644
+ budget_id: z.ZodString;
645
+ name: z.ZodString;
646
+ type: z.ZodString;
647
+ balance: z.ZodNumber;
648
+ }, z.core.$strip>;
649
+ export type CreateAccountDryRunRequest = z.infer<typeof CreateAccountDryRunRequestSchema>;
650
+ export declare const CreateAccountOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
651
+ dry_run: z.ZodLiteral<true>;
652
+ action: z.ZodLiteral<"create_account">;
653
+ request: z.ZodObject<{
654
+ budget_id: z.ZodString;
655
+ name: z.ZodString;
656
+ type: z.ZodString;
657
+ balance: z.ZodNumber;
658
+ }, z.core.$strip>;
659
+ }, z.core.$strip>, z.ZodObject<{
660
+ account: z.ZodObject<{
661
+ id: z.ZodString;
662
+ name: z.ZodString;
663
+ type: z.ZodString;
664
+ on_budget: z.ZodBoolean;
665
+ closed: z.ZodBoolean;
666
+ note: z.ZodOptional<z.ZodString>;
667
+ balance: z.ZodNumber;
668
+ cleared_balance: z.ZodNumber;
669
+ uncleared_balance: z.ZodNumber;
670
+ transfer_payee_id: z.ZodString;
671
+ direct_import_linked: z.ZodOptional<z.ZodBoolean>;
672
+ direct_import_in_error: z.ZodOptional<z.ZodBoolean>;
673
+ }, z.core.$strip>;
674
+ }, z.core.$strip>]>;
675
+ export type CreateAccountOutput = z.infer<typeof CreateAccountOutputSchema>;
676
+ export declare const UpdateCategoryDryRunRequestSchema: z.ZodObject<{
677
+ budget_id: z.ZodString;
678
+ category_id: z.ZodString;
679
+ budgeted: z.ZodNumber;
680
+ month: z.ZodString;
681
+ }, z.core.$strip>;
682
+ export type UpdateCategoryDryRunRequest = z.infer<typeof UpdateCategoryDryRunRequestSchema>;
683
+ export declare const UpdateCategoryOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
684
+ dry_run: z.ZodLiteral<true>;
685
+ action: z.ZodLiteral<"update_category">;
686
+ request: z.ZodObject<{
687
+ budget_id: z.ZodString;
688
+ category_id: z.ZodString;
689
+ budgeted: z.ZodNumber;
690
+ month: z.ZodString;
691
+ }, z.core.$strip>;
692
+ }, z.core.$strip>, z.ZodObject<{
693
+ category: z.ZodObject<{
694
+ id: z.ZodString;
695
+ category_group_id: z.ZodString;
696
+ category_group_name: z.ZodOptional<z.ZodString>;
697
+ name: z.ZodString;
698
+ hidden: z.ZodBoolean;
699
+ original_category_group_id: z.ZodOptional<z.ZodString>;
700
+ note: z.ZodOptional<z.ZodString>;
701
+ budgeted: z.ZodNumber;
702
+ activity: z.ZodNumber;
703
+ balance: z.ZodNumber;
704
+ goal_type: z.ZodOptional<z.ZodString>;
705
+ goal_creation_month: z.ZodOptional<z.ZodString>;
706
+ goal_target: z.ZodOptional<z.ZodNumber>;
707
+ goal_target_month: z.ZodOptional<z.ZodString>;
708
+ goal_percentage_complete: z.ZodOptional<z.ZodNumber>;
709
+ goal_months_to_budget: z.ZodOptional<z.ZodNumber>;
710
+ goal_under_funded: z.ZodOptional<z.ZodNumber>;
711
+ goal_overall_funded: z.ZodOptional<z.ZodNumber>;
712
+ goal_overall_left: z.ZodOptional<z.ZodNumber>;
713
+ deleted: z.ZodOptional<z.ZodBoolean>;
714
+ }, z.core.$strip>;
715
+ updated_month: z.ZodString;
716
+ }, z.core.$strip>]>;
717
+ export type UpdateCategoryOutput = z.infer<typeof UpdateCategoryOutputSchema>;