@dizzlkheinz/ynab-mcpb 0.18.3 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (346) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/CLAUDE.md +87 -8
  3. package/bin/ynab-mcp-server.cjs +2 -2
  4. package/bin/ynab-mcp-server.js +3 -3
  5. package/biome.json +39 -0
  6. package/dist/bundle/index.cjs +67 -67
  7. package/dist/index.d.ts +1 -1
  8. package/dist/index.js +27 -27
  9. package/dist/server/YNABMCPServer.d.ts +3 -4
  10. package/dist/server/YNABMCPServer.js +111 -116
  11. package/dist/server/budgetResolver.d.ts +6 -5
  12. package/dist/server/budgetResolver.js +46 -36
  13. package/dist/server/cacheKeys.js +6 -6
  14. package/dist/server/cacheManager.js +14 -11
  15. package/dist/server/completions.d.ts +2 -2
  16. package/dist/server/completions.js +20 -15
  17. package/dist/server/config.d.ts +10 -5
  18. package/dist/server/config.js +24 -7
  19. package/dist/server/deltaCache.d.ts +2 -2
  20. package/dist/server/deltaCache.js +22 -16
  21. package/dist/server/deltaCache.merge.d.ts +2 -2
  22. package/dist/server/diagnostics.d.ts +4 -4
  23. package/dist/server/diagnostics.js +38 -32
  24. package/dist/server/errorHandler.d.ts +5 -12
  25. package/dist/server/errorHandler.js +219 -217
  26. package/dist/server/prompts.d.ts +2 -2
  27. package/dist/server/prompts.js +45 -45
  28. package/dist/server/rateLimiter.js +4 -4
  29. package/dist/server/requestLogger.d.ts +1 -1
  30. package/dist/server/requestLogger.js +40 -35
  31. package/dist/server/resources.d.ts +3 -3
  32. package/dist/server/resources.js +55 -52
  33. package/dist/server/responseFormatter.js +6 -6
  34. package/dist/server/securityMiddleware.d.ts +2 -2
  35. package/dist/server/securityMiddleware.js +22 -20
  36. package/dist/server/serverKnowledgeStore.js +1 -1
  37. package/dist/server/toolRegistry.d.ts +3 -3
  38. package/dist/server/toolRegistry.js +47 -40
  39. package/dist/tools/__tests__/deltaTestUtils.d.ts +3 -3
  40. package/dist/tools/__tests__/deltaTestUtils.js +2 -2
  41. package/dist/tools/accountTools.d.ts +9 -8
  42. package/dist/tools/accountTools.js +47 -47
  43. package/dist/tools/adapters.d.ts +13 -8
  44. package/dist/tools/adapters.js +21 -11
  45. package/dist/tools/budgetTools.d.ts +8 -7
  46. package/dist/tools/budgetTools.js +22 -22
  47. package/dist/tools/categoryTools.d.ts +9 -8
  48. package/dist/tools/categoryTools.js +68 -59
  49. package/dist/tools/compareTransactions/formatter.d.ts +3 -3
  50. package/dist/tools/compareTransactions/formatter.js +9 -9
  51. package/dist/tools/compareTransactions/index.d.ts +6 -6
  52. package/dist/tools/compareTransactions/index.js +58 -43
  53. package/dist/tools/compareTransactions/matcher.d.ts +1 -1
  54. package/dist/tools/compareTransactions/matcher.js +28 -15
  55. package/dist/tools/compareTransactions/parser.d.ts +2 -2
  56. package/dist/tools/compareTransactions/parser.js +144 -138
  57. package/dist/tools/compareTransactions/types.d.ts +4 -4
  58. package/dist/tools/compareTransactions.d.ts +1 -1
  59. package/dist/tools/compareTransactions.js +1 -1
  60. package/dist/tools/deltaFetcher.d.ts +2 -2
  61. package/dist/tools/deltaFetcher.js +16 -15
  62. package/dist/tools/deltaSupport.d.ts +4 -4
  63. package/dist/tools/deltaSupport.js +35 -41
  64. package/dist/tools/exportTransactions.d.ts +5 -4
  65. package/dist/tools/exportTransactions.js +61 -59
  66. package/dist/tools/monthTools.d.ts +7 -6
  67. package/dist/tools/monthTools.js +31 -29
  68. package/dist/tools/payeeTools.d.ts +7 -6
  69. package/dist/tools/payeeTools.js +28 -28
  70. package/dist/tools/reconcileAdapter.d.ts +2 -2
  71. package/dist/tools/reconcileAdapter.js +21 -11
  72. package/dist/tools/reconciliation/analyzer.d.ts +4 -4
  73. package/dist/tools/reconciliation/analyzer.js +136 -57
  74. package/dist/tools/reconciliation/csvParser.d.ts +3 -3
  75. package/dist/tools/reconciliation/csvParser.js +128 -104
  76. package/dist/tools/reconciliation/executor.d.ts +4 -4
  77. package/dist/tools/reconciliation/executor.js +148 -109
  78. package/dist/tools/reconciliation/index.d.ts +10 -10
  79. package/dist/tools/reconciliation/index.js +96 -83
  80. package/dist/tools/reconciliation/matcher.d.ts +3 -3
  81. package/dist/tools/reconciliation/matcher.js +17 -16
  82. package/dist/tools/reconciliation/payeeNormalizer.js +19 -8
  83. package/dist/tools/reconciliation/recommendationEngine.d.ts +1 -1
  84. package/dist/tools/reconciliation/recommendationEngine.js +40 -40
  85. package/dist/tools/reconciliation/reportFormatter.d.ts +2 -2
  86. package/dist/tools/reconciliation/reportFormatter.js +79 -54
  87. package/dist/tools/reconciliation/signDetector.d.ts +1 -1
  88. package/dist/tools/reconciliation/types.d.ts +19 -16
  89. package/dist/tools/reconciliation/ynabAdapter.d.ts +2 -2
  90. package/dist/tools/schemas/common.d.ts +1 -1
  91. package/dist/tools/schemas/common.js +1 -1
  92. package/dist/tools/schemas/outputs/accountOutputs.d.ts +1 -1
  93. package/dist/tools/schemas/outputs/accountOutputs.js +24 -18
  94. package/dist/tools/schemas/outputs/budgetOutputs.d.ts +1 -1
  95. package/dist/tools/schemas/outputs/budgetOutputs.js +14 -11
  96. package/dist/tools/schemas/outputs/categoryOutputs.d.ts +1 -1
  97. package/dist/tools/schemas/outputs/categoryOutputs.js +49 -29
  98. package/dist/tools/schemas/outputs/comparisonOutputs.d.ts +1 -1
  99. package/dist/tools/schemas/outputs/comparisonOutputs.js +12 -12
  100. package/dist/tools/schemas/outputs/index.d.ts +14 -14
  101. package/dist/tools/schemas/outputs/index.js +14 -14
  102. package/dist/tools/schemas/outputs/monthOutputs.d.ts +1 -1
  103. package/dist/tools/schemas/outputs/monthOutputs.js +56 -41
  104. package/dist/tools/schemas/outputs/payeeOutputs.d.ts +1 -1
  105. package/dist/tools/schemas/outputs/payeeOutputs.js +10 -10
  106. package/dist/tools/schemas/outputs/reconciliationOutputs.d.ts +2 -2
  107. package/dist/tools/schemas/outputs/reconciliationOutputs.js +45 -45
  108. package/dist/tools/schemas/outputs/transactionMutationOutputs.d.ts +1 -1
  109. package/dist/tools/schemas/outputs/transactionMutationOutputs.js +28 -22
  110. package/dist/tools/schemas/outputs/transactionOutputs.d.ts +1 -1
  111. package/dist/tools/schemas/outputs/transactionOutputs.js +43 -35
  112. package/dist/tools/schemas/outputs/utilityOutputs.d.ts +1 -1
  113. package/dist/tools/schemas/outputs/utilityOutputs.js +5 -3
  114. package/dist/tools/schemas/shared/commonOutputs.d.ts +1 -1
  115. package/dist/tools/schemas/shared/commonOutputs.js +15 -9
  116. package/dist/tools/transactionReadTools.d.ts +11 -0
  117. package/dist/tools/transactionReadTools.js +202 -0
  118. package/dist/tools/transactionSchemas.d.ts +309 -0
  119. package/dist/tools/transactionSchemas.js +235 -0
  120. package/dist/tools/transactionTools.d.ts +6 -302
  121. package/dist/tools/transactionTools.js +7 -2054
  122. package/dist/tools/transactionUtils.d.ts +31 -0
  123. package/dist/tools/transactionUtils.js +364 -0
  124. package/dist/tools/transactionWriteTools.d.ts +20 -0
  125. package/dist/tools/transactionWriteTools.js +1342 -0
  126. package/dist/tools/utilityTools.d.ts +5 -4
  127. package/dist/tools/utilityTools.js +11 -11
  128. package/dist/types/index.d.ts +7 -7
  129. package/dist/types/index.js +6 -6
  130. package/dist/types/reconciliation.d.ts +1 -1
  131. package/dist/types/toolRegistration.d.ts +14 -12
  132. package/dist/utils/amountUtils.js +1 -1
  133. package/dist/utils/dateUtils.js +4 -4
  134. package/dist/utils/errors.d.ts +3 -3
  135. package/dist/utils/errors.js +4 -4
  136. package/dist/utils/money.d.ts +2 -2
  137. package/dist/utils/money.js +8 -8
  138. package/dist/utils/validationError.d.ts +1 -1
  139. package/dist/utils/validationError.js +1 -1
  140. package/docs/assets/examples/reconciliation-with-recommendations.json +66 -66
  141. package/docs/assets/schemas/reconciliation-v2.json +360 -336
  142. package/docs/plans/2025-12-25-transaction-tools-refactor-design.md +211 -0
  143. package/docs/plans/2025-12-25-transaction-tools-refactor.md +905 -0
  144. package/esbuild.config.mjs +53 -50
  145. package/meta.json +12548 -12548
  146. package/package.json +98 -109
  147. package/scripts/analyze-bundle.mjs +33 -30
  148. package/scripts/create-pr-description.js +169 -120
  149. package/scripts/run-all-tests.js +205 -0
  150. package/scripts/run-domain-integration-tests.js +28 -18
  151. package/scripts/run-generate-mcpb.js +19 -17
  152. package/scripts/run-throttled-integration-tests.js +92 -83
  153. package/scripts/test-delta-params.mjs +149 -120
  154. package/scripts/test-recommendations.ts +36 -32
  155. package/scripts/tmpTransaction.ts +80 -43
  156. package/scripts/validate-env.js +98 -91
  157. package/scripts/verify-build.js +78 -76
  158. package/src/__tests__/comprehensive.integration.test.ts +1281 -1154
  159. package/src/__tests__/performance.test.ts +723 -671
  160. package/src/__tests__/setup.ts +442 -395
  161. package/src/__tests__/smoke.e2e.test.ts +41 -39
  162. package/src/__tests__/testRunner.ts +314 -295
  163. package/src/__tests__/testUtils.ts +456 -364
  164. package/src/__tests__/tools/reconciliation/csvParser.integration.test.ts +109 -107
  165. package/src/__tests__/tools/reconciliation/real-world.integration.test.ts +41 -41
  166. package/src/index.ts +68 -59
  167. package/src/server/CLAUDE.md +480 -0
  168. package/src/server/YNABMCPServer.ts +821 -794
  169. package/src/server/__tests__/YNABMCPServer.integration.test.ts +929 -893
  170. package/src/server/__tests__/YNABMCPServer.test.ts +903 -899
  171. package/src/server/__tests__/budgetResolver.test.ts +466 -423
  172. package/src/server/__tests__/cacheManager.test.ts +891 -874
  173. package/src/server/__tests__/completions.integration.test.ts +115 -106
  174. package/src/server/__tests__/completions.test.ts +334 -313
  175. package/src/server/__tests__/config.test.ts +98 -86
  176. package/src/server/__tests__/deltaCache.merge.test.ts +774 -703
  177. package/src/server/__tests__/deltaCache.swr.test.ts +198 -153
  178. package/src/server/__tests__/deltaCache.test.ts +946 -759
  179. package/src/server/__tests__/diagnostics.test.ts +825 -792
  180. package/src/server/__tests__/errorHandler.integration.test.ts +512 -462
  181. package/src/server/__tests__/errorHandler.test.ts +402 -397
  182. package/src/server/__tests__/prompts.test.ts +424 -347
  183. package/src/server/__tests__/rateLimiter.test.ts +313 -309
  184. package/src/server/__tests__/requestLogger.test.ts +443 -403
  185. package/src/server/__tests__/resources.template.test.ts +196 -185
  186. package/src/server/__tests__/resources.test.ts +294 -288
  187. package/src/server/__tests__/security.integration.test.ts +487 -421
  188. package/src/server/__tests__/securityMiddleware.test.ts +519 -444
  189. package/src/server/__tests__/server-startup.integration.test.ts +509 -490
  190. package/src/server/__tests__/serverKnowledgeStore.test.ts +174 -173
  191. package/src/server/__tests__/toolRegistration.test.ts +239 -210
  192. package/src/server/__tests__/toolRegistry.test.ts +907 -845
  193. package/src/server/budgetResolver.ts +221 -181
  194. package/src/server/cacheKeys.ts +6 -6
  195. package/src/server/cacheManager.ts +498 -484
  196. package/src/server/completions.ts +267 -243
  197. package/src/server/config.ts +35 -14
  198. package/src/server/deltaCache.merge.ts +146 -128
  199. package/src/server/deltaCache.ts +352 -309
  200. package/src/server/diagnostics.ts +257 -242
  201. package/src/server/errorHandler.ts +747 -744
  202. package/src/server/prompts.ts +181 -176
  203. package/src/server/rateLimiter.ts +131 -129
  204. package/src/server/requestLogger.ts +350 -322
  205. package/src/server/resources.ts +442 -374
  206. package/src/server/responseFormatter.ts +41 -37
  207. package/src/server/securityMiddleware.ts +223 -205
  208. package/src/server/serverKnowledgeStore.ts +67 -67
  209. package/src/server/toolRegistry.ts +508 -474
  210. package/src/tools/CLAUDE.md +604 -0
  211. package/src/tools/__tests__/accountTools.delta.integration.test.ts +128 -111
  212. package/src/tools/__tests__/accountTools.integration.test.ts +129 -111
  213. package/src/tools/__tests__/accountTools.test.ts +685 -638
  214. package/src/tools/__tests__/adapters.test.ts +142 -108
  215. package/src/tools/__tests__/budgetTools.delta.integration.test.ts +73 -73
  216. package/src/tools/__tests__/budgetTools.integration.test.ts +132 -124
  217. package/src/tools/__tests__/budgetTools.test.ts +442 -413
  218. package/src/tools/__tests__/categoryTools.delta.integration.test.ts +76 -68
  219. package/src/tools/__tests__/categoryTools.integration.test.ts +314 -288
  220. package/src/tools/__tests__/categoryTools.test.ts +656 -625
  221. package/src/tools/__tests__/compareTransactions/formatter.test.ts +535 -462
  222. package/src/tools/__tests__/compareTransactions/index.test.ts +378 -358
  223. package/src/tools/__tests__/compareTransactions/matcher.test.ts +497 -398
  224. package/src/tools/__tests__/compareTransactions/parser.test.ts +765 -747
  225. package/src/tools/__tests__/compareTransactions.test.ts +352 -332
  226. package/src/tools/__tests__/compareTransactions.window.test.ts +150 -146
  227. package/src/tools/__tests__/deltaFetcher.scheduled.integration.test.ts +69 -65
  228. package/src/tools/__tests__/deltaFetcher.test.ts +325 -265
  229. package/src/tools/__tests__/deltaSupport.test.ts +211 -184
  230. package/src/tools/__tests__/deltaTestUtils.ts +37 -33
  231. package/src/tools/__tests__/exportTransactions.test.ts +205 -200
  232. package/src/tools/__tests__/monthTools.delta.integration.test.ts +68 -68
  233. package/src/tools/__tests__/monthTools.integration.test.ts +178 -166
  234. package/src/tools/__tests__/monthTools.test.ts +561 -512
  235. package/src/tools/__tests__/payeeTools.delta.integration.test.ts +68 -68
  236. package/src/tools/__tests__/payeeTools.integration.test.ts +158 -142
  237. package/src/tools/__tests__/payeeTools.test.ts +486 -434
  238. package/src/tools/__tests__/transactionSchemas.test.ts +1204 -0
  239. package/src/tools/__tests__/transactionTools.integration.test.ts +875 -825
  240. package/src/tools/__tests__/transactionTools.test.ts +4923 -4366
  241. package/src/tools/__tests__/transactionUtils.test.ts +1016 -0
  242. package/src/tools/__tests__/utilityTools.integration.test.ts +32 -32
  243. package/src/tools/__tests__/utilityTools.test.ts +68 -58
  244. package/src/tools/accountTools.ts +293 -271
  245. package/src/tools/adapters.ts +120 -63
  246. package/src/tools/budgetTools.ts +121 -116
  247. package/src/tools/categoryTools.ts +379 -339
  248. package/src/tools/compareTransactions/formatter.ts +131 -119
  249. package/src/tools/compareTransactions/index.ts +249 -214
  250. package/src/tools/compareTransactions/matcher.ts +259 -209
  251. package/src/tools/compareTransactions/parser.ts +517 -487
  252. package/src/tools/compareTransactions/types.ts +38 -38
  253. package/src/tools/compareTransactions.ts +1 -1
  254. package/src/tools/deltaFetcher.ts +281 -260
  255. package/src/tools/deltaSupport.ts +264 -259
  256. package/src/tools/exportTransactions.ts +230 -218
  257. package/src/tools/monthTools.ts +180 -165
  258. package/src/tools/payeeTools.ts +152 -140
  259. package/src/tools/reconcileAdapter.ts +297 -246
  260. package/src/tools/reconciliation/CLAUDE.md +506 -0
  261. package/src/tools/reconciliation/__tests__/adapter.causes.test.ts +135 -112
  262. package/src/tools/reconciliation/__tests__/adapter.test.ts +249 -227
  263. package/src/tools/reconciliation/__tests__/analyzer.test.ts +408 -335
  264. package/src/tools/reconciliation/__tests__/csvParser.test.ts +71 -69
  265. package/src/tools/reconciliation/__tests__/executor.integration.test.ts +348 -323
  266. package/src/tools/reconciliation/__tests__/executor.progress.test.ts +503 -457
  267. package/src/tools/reconciliation/__tests__/executor.test.ts +898 -831
  268. package/src/tools/reconciliation/__tests__/matcher.test.ts +667 -663
  269. package/src/tools/reconciliation/__tests__/payeeNormalizer.test.ts +296 -276
  270. package/src/tools/reconciliation/__tests__/recommendationEngine.integration.test.ts +692 -624
  271. package/src/tools/reconciliation/__tests__/recommendationEngine.test.ts +1008 -986
  272. package/src/tools/reconciliation/__tests__/reconciliation.delta.integration.test.ts +187 -146
  273. package/src/tools/reconciliation/__tests__/reportFormatter.test.ts +583 -530
  274. package/src/tools/reconciliation/__tests__/scenarios/adapterCurrency.scenario.test.ts +75 -71
  275. package/src/tools/reconciliation/__tests__/scenarios/extremes.scenario.test.ts +70 -58
  276. package/src/tools/reconciliation/__tests__/scenarios/repeatAmount.scenario.test.ts +102 -88
  277. package/src/tools/reconciliation/__tests__/schemaUrl.test.ts +58 -43
  278. package/src/tools/reconciliation/__tests__/signDetector.test.ts +209 -206
  279. package/src/tools/reconciliation/__tests__/ynabAdapter.test.ts +66 -60
  280. package/src/tools/reconciliation/analyzer.ts +582 -406
  281. package/src/tools/reconciliation/csvParser.ts +656 -609
  282. package/src/tools/reconciliation/executor.ts +1290 -1128
  283. package/src/tools/reconciliation/index.ts +580 -528
  284. package/src/tools/reconciliation/matcher.ts +256 -240
  285. package/src/tools/reconciliation/payeeNormalizer.ts +92 -78
  286. package/src/tools/reconciliation/recommendationEngine.ts +357 -345
  287. package/src/tools/reconciliation/reportFormatter.ts +349 -276
  288. package/src/tools/reconciliation/signDetector.ts +89 -83
  289. package/src/tools/reconciliation/types.ts +164 -153
  290. package/src/tools/reconciliation/ynabAdapter.ts +17 -15
  291. package/src/tools/schemas/CLAUDE.md +546 -0
  292. package/src/tools/schemas/common.ts +1 -1
  293. package/src/tools/schemas/outputs/__tests__/accountOutputs.test.ts +410 -409
  294. package/src/tools/schemas/outputs/__tests__/budgetOutputs.test.ts +305 -299
  295. package/src/tools/schemas/outputs/__tests__/categoryOutputs.test.ts +431 -430
  296. package/src/tools/schemas/outputs/__tests__/comparisonOutputs.test.ts +510 -495
  297. package/src/tools/schemas/outputs/__tests__/dateValidation.test.ts +179 -153
  298. package/src/tools/schemas/outputs/__tests__/discrepancyDirection.test.ts +293 -254
  299. package/src/tools/schemas/outputs/__tests__/monthOutputs.test.ts +457 -457
  300. package/src/tools/schemas/outputs/__tests__/payeeOutputs.test.ts +362 -356
  301. package/src/tools/schemas/outputs/__tests__/reconciliationOutputs.test.ts +402 -399
  302. package/src/tools/schemas/outputs/__tests__/transactionMutationSchemas.test.ts +225 -211
  303. package/src/tools/schemas/outputs/__tests__/transactionOutputs.test.ts +457 -454
  304. package/src/tools/schemas/outputs/__tests__/utilityOutputs.test.ts +316 -315
  305. package/src/tools/schemas/outputs/accountOutputs.ts +40 -34
  306. package/src/tools/schemas/outputs/budgetOutputs.ts +24 -19
  307. package/src/tools/schemas/outputs/categoryOutputs.ts +76 -56
  308. package/src/tools/schemas/outputs/comparisonOutputs.ts +192 -169
  309. package/src/tools/schemas/outputs/index.ts +163 -163
  310. package/src/tools/schemas/outputs/monthOutputs.ts +95 -80
  311. package/src/tools/schemas/outputs/payeeOutputs.ts +18 -18
  312. package/src/tools/schemas/outputs/reconciliationOutputs.ts +386 -373
  313. package/src/tools/schemas/outputs/transactionMutationOutputs.ts +259 -231
  314. package/src/tools/schemas/outputs/transactionOutputs.ts +81 -71
  315. package/src/tools/schemas/outputs/utilityOutputs.ts +90 -84
  316. package/src/tools/schemas/shared/commonOutputs.ts +27 -19
  317. package/src/tools/toolCategories.ts +114 -114
  318. package/src/tools/transactionReadTools.ts +327 -0
  319. package/src/tools/transactionSchemas.ts +484 -0
  320. package/src/tools/transactionTools.ts +107 -2990
  321. package/src/tools/transactionUtils.ts +621 -0
  322. package/src/tools/transactionWriteTools.ts +2110 -0
  323. package/src/tools/utilityTools.ts +46 -41
  324. package/src/types/CLAUDE.md +477 -0
  325. package/src/types/__tests__/index.test.ts +51 -51
  326. package/src/types/index.ts +43 -39
  327. package/src/types/integration-tests.d.ts +26 -26
  328. package/src/types/reconciliation.ts +29 -29
  329. package/src/types/toolAnnotations.ts +30 -30
  330. package/src/types/toolRegistration.ts +43 -32
  331. package/src/utils/CLAUDE.md +508 -0
  332. package/src/utils/__tests__/dateUtils.test.ts +174 -168
  333. package/src/utils/__tests__/money.test.ts +193 -187
  334. package/src/utils/amountUtils.ts +5 -5
  335. package/src/utils/baseError.ts +5 -5
  336. package/src/utils/dateUtils.ts +29 -26
  337. package/src/utils/errors.ts +14 -14
  338. package/src/utils/money.ts +66 -52
  339. package/src/utils/validationError.ts +1 -1
  340. package/tsconfig.json +29 -29
  341. package/tsconfig.prod.json +16 -16
  342. package/vitest-reporters/split-json-reporter.ts +247 -204
  343. package/vitest.config.ts +99 -95
  344. package/.prettierignore +0 -10
  345. package/.prettierrc.json +0 -10
  346. package/eslint.config.js +0 -49
@@ -1,4 +1,4 @@
1
- import { z } from 'zod';
1
+ import { z } from "zod";
2
2
  export const MoneyValueSchema = z.object({
3
3
  amount: z.number().finite(),
4
4
  currency: z.string(),
@@ -7,20 +7,20 @@ export const MoneyValueSchema = z.object({
7
7
  });
8
8
  export const IsoDateWithCalendarValidationSchema = z
9
9
  .string()
10
- .regex(/^\d{4}-\d{2}-\d{2}$/, 'Date must be in ISO format (YYYY-MM-DD)')
10
+ .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in ISO format (YYYY-MM-DD)")
11
11
  .refine((dateStr) => {
12
12
  const parsed = Date.parse(dateStr);
13
- if (isNaN(parsed)) {
13
+ if (Number.isNaN(parsed)) {
14
14
  return false;
15
15
  }
16
16
  const date = new Date(parsed);
17
17
  const year = date.getUTCFullYear();
18
- const month = String(date.getUTCMonth() + 1).padStart(2, '0');
19
- const day = String(date.getUTCDate()).padStart(2, '0');
18
+ const month = String(date.getUTCMonth() + 1).padStart(2, "0");
19
+ const day = String(date.getUTCDate()).padStart(2, "0");
20
20
  const reconstructed = `${year}-${month}-${day}`;
21
21
  return reconstructed === dateStr;
22
22
  }, {
23
- message: 'Invalid calendar date (e.g., month must be 01-12, day must be valid for the month)',
23
+ message: "Invalid calendar date (e.g., month must be 01-12, day must be valid for the month)",
24
24
  });
25
25
  export const BankTransactionSchema = z.object({
26
26
  id: z.string().uuid(),
@@ -37,7 +37,7 @@ export const YNABTransactionSimpleSchema = z.object({
37
37
  amount: z.number(),
38
38
  payee_name: z.string().nullable(),
39
39
  category_name: z.string().nullable(),
40
- cleared: z.enum(['cleared', 'uncleared', 'reconciled']),
40
+ cleared: z.enum(["cleared", "uncleared", "reconciled"]),
41
41
  approved: z.boolean(),
42
42
  memo: z.string().nullable().optional(),
43
43
  amount_money: MoneyValueSchema,
@@ -50,19 +50,19 @@ export const MatchCandidateSchema = z.object({
50
50
  });
51
51
  export function deriveConfidenceFromScore(score) {
52
52
  if (score >= 90)
53
- return 'high';
53
+ return "high";
54
54
  if (score >= 60)
55
- return 'medium';
55
+ return "medium";
56
56
  if (score >= 1)
57
- return 'low';
58
- return 'none';
57
+ return "low";
58
+ return "none";
59
59
  }
60
60
  export const TransactionMatchSchema = z
61
61
  .object({
62
62
  bank_transaction: BankTransactionSchema,
63
63
  ynab_transaction: YNABTransactionSimpleSchema.optional(),
64
64
  candidates: z.array(MatchCandidateSchema).optional(),
65
- confidence: z.enum(['high', 'medium', 'low', 'none']),
65
+ confidence: z.enum(["high", "medium", "low", "none"]),
66
66
  confidence_score: z.number().min(0).max(100),
67
67
  match_reason: z.string(),
68
68
  top_confidence: z.number().optional(),
@@ -73,8 +73,8 @@ export const TransactionMatchSchema = z
73
73
  const expectedConfidence = deriveConfidenceFromScore(data.confidence_score);
74
74
  return data.confidence === expectedConfidence;
75
75
  }, {
76
- message: 'Confidence mismatch: confidence enum does not match confidence_score',
77
- path: ['confidence'],
76
+ message: "Confidence mismatch: confidence enum does not match confidence_score",
77
+ path: ["confidence"],
78
78
  });
79
79
  export const BalanceInfoSchema = z.object({
80
80
  current_cleared: MoneyValueSchema,
@@ -99,17 +99,17 @@ export const ReconciliationSummarySchema = z.object({
99
99
  });
100
100
  export const ReconciliationInsightSchema = z.object({
101
101
  id: z.string(),
102
- type: z.enum(['repeat_amount', 'near_match', 'anomaly']),
103
- severity: z.enum(['info', 'warning', 'critical']),
102
+ type: z.enum(["repeat_amount", "near_match", "anomaly"]),
103
+ severity: z.enum(["info", "warning", "critical"]),
104
104
  title: z.string(),
105
105
  description: z.string(),
106
106
  evidence: z.record(z.string(), z.unknown()).optional(),
107
107
  });
108
- export const ActionableRecommendationSchema = z.discriminatedUnion('action_type', [
108
+ export const ActionableRecommendationSchema = z.discriminatedUnion("action_type", [
109
109
  z.object({
110
110
  id: z.string(),
111
- action_type: z.literal('create_transaction'),
112
- priority: z.enum(['high', 'medium', 'low']),
111
+ action_type: z.literal("create_transaction"),
112
+ priority: z.enum(["high", "medium", "low"]),
113
113
  confidence: z.number().min(0).max(1),
114
114
  message: z.string(),
115
115
  reason: z.string(),
@@ -123,15 +123,15 @@ export const ActionableRecommendationSchema = z.discriminatedUnion('action_type'
123
123
  amount: z.number(),
124
124
  payee_name: z.string(),
125
125
  memo: z.string().optional(),
126
- cleared: z.enum(['cleared', 'uncleared']),
126
+ cleared: z.enum(["cleared", "uncleared"]),
127
127
  approved: z.boolean(),
128
128
  category_id: z.string().optional(),
129
129
  }),
130
130
  }),
131
131
  z.object({
132
132
  id: z.string(),
133
- action_type: z.literal('update_cleared'),
134
- priority: z.enum(['high', 'medium', 'low']),
133
+ action_type: z.literal("update_cleared"),
134
+ priority: z.enum(["high", "medium", "low"]),
135
135
  confidence: z.number().min(0).max(1),
136
136
  message: z.string(),
137
137
  reason: z.string(),
@@ -141,13 +141,13 @@ export const ActionableRecommendationSchema = z.discriminatedUnion('action_type'
141
141
  metadata: z.record(z.string(), z.unknown()).optional(),
142
142
  parameters: z.object({
143
143
  transaction_id: z.string(),
144
- cleared: z.enum(['cleared', 'uncleared', 'reconciled']),
144
+ cleared: z.enum(["cleared", "uncleared", "reconciled"]),
145
145
  }),
146
146
  }),
147
147
  z.object({
148
148
  id: z.string(),
149
- action_type: z.literal('review_duplicate'),
150
- priority: z.enum(['high', 'medium', 'low']),
149
+ action_type: z.literal("review_duplicate"),
150
+ priority: z.enum(["high", "medium", "low"]),
151
151
  confidence: z.number().min(0).max(1),
152
152
  message: z.string(),
153
153
  reason: z.string(),
@@ -163,8 +163,8 @@ export const ActionableRecommendationSchema = z.discriminatedUnion('action_type'
163
163
  }),
164
164
  z.object({
165
165
  id: z.string(),
166
- action_type: z.literal('manual_review'),
167
- priority: z.enum(['high', 'medium', 'low']),
166
+ action_type: z.literal("manual_review"),
167
+ priority: z.enum(["high", "medium", "low"]),
168
168
  confidence: z.number().min(0).max(1),
169
169
  message: z.string(),
170
170
  reason: z.string(),
@@ -189,7 +189,7 @@ export const CreatedTransactionSchema = z
189
189
  date: z.string(),
190
190
  amount: z.number(),
191
191
  memo: z.string().nullable().optional(),
192
- cleared: z.enum(['cleared', 'uncleared', 'reconciled']).optional(),
192
+ cleared: z.enum(["cleared", "uncleared", "reconciled"]).optional(),
193
193
  approved: z.boolean().optional(),
194
194
  payee_name: z.string().nullable().optional(),
195
195
  category_name: z.string().nullable().optional(),
@@ -202,36 +202,36 @@ export const TransactionCreationPayloadSchema = z.object({
202
202
  amount: z.number(),
203
203
  payee_name: z.string().optional(),
204
204
  memo: z.string().optional(),
205
- cleared: z.enum(['cleared', 'uncleared']).optional(),
205
+ cleared: z.enum(["cleared", "uncleared"]).optional(),
206
206
  approved: z.boolean().optional(),
207
207
  import_id: z.string().optional(),
208
208
  });
209
209
  export const TransactionUpdatePayloadSchema = z.object({
210
210
  transaction_id: z.string(),
211
211
  new_date: z.string().optional(),
212
- cleared: z.enum(['cleared', 'uncleared', 'reconciled']).optional(),
212
+ cleared: z.enum(["cleared", "uncleared", "reconciled"]).optional(),
213
213
  });
214
214
  export const DuplicateDetectionPayloadSchema = z.object({
215
215
  transaction_id: z.string().nullable(),
216
216
  import_id: z.string().optional(),
217
217
  });
218
- export const ExecutionActionRecordSchema = z.discriminatedUnion('type', [
218
+ export const ExecutionActionRecordSchema = z.discriminatedUnion("type", [
219
219
  z.object({
220
- type: z.literal('create_transaction'),
220
+ type: z.literal("create_transaction"),
221
221
  transaction: CreatedTransactionSchema.nullable(),
222
222
  reason: z.string(),
223
223
  bulk_chunk_index: z.number().optional(),
224
224
  correlation_key: z.string().optional(),
225
225
  }),
226
226
  z.object({
227
- type: z.literal('create_transaction_failed'),
227
+ type: z.literal("create_transaction_failed"),
228
228
  transaction: TransactionCreationPayloadSchema,
229
229
  reason: z.string(),
230
230
  bulk_chunk_index: z.number().optional(),
231
231
  correlation_key: z.string().optional(),
232
232
  }),
233
233
  z.object({
234
- type: z.literal('create_transaction_duplicate'),
234
+ type: z.literal("create_transaction_duplicate"),
235
235
  transaction: DuplicateDetectionPayloadSchema,
236
236
  reason: z.string(),
237
237
  bulk_chunk_index: z.number(),
@@ -239,7 +239,7 @@ export const ExecutionActionRecordSchema = z.discriminatedUnion('type', [
239
239
  duplicate: z.literal(true),
240
240
  }),
241
241
  z.object({
242
- type: z.literal('update_transaction'),
242
+ type: z.literal("update_transaction"),
243
243
  transaction: z.union([
244
244
  CreatedTransactionSchema.nullable(),
245
245
  TransactionUpdatePayloadSchema,
@@ -247,12 +247,12 @@ export const ExecutionActionRecordSchema = z.discriminatedUnion('type', [
247
247
  reason: z.string(),
248
248
  }),
249
249
  z.object({
250
- type: z.literal('balance_checkpoint'),
250
+ type: z.literal("balance_checkpoint"),
251
251
  transaction: z.null(),
252
252
  reason: z.string(),
253
253
  }),
254
254
  z.object({
255
- type: z.literal('bulk_create_fallback'),
255
+ type: z.literal("bulk_create_fallback"),
256
256
  transaction: z.null(),
257
257
  reason: z.string(),
258
258
  bulk_chunk_index: z.number(),
@@ -281,7 +281,7 @@ export const BulkOperationDetailsSchema = z
281
281
  sequential_attempts: z.number().optional(),
282
282
  })
283
283
  .refine((data) => data.failed_transactions === data.transaction_failures, {
284
- message: 'failed_transactions must equal transaction_failures',
284
+ message: "failed_transactions must equal transaction_failures",
285
285
  });
286
286
  export const ExecutionResultSchema = z.object({
287
287
  summary: ExecutionSummarySchema,
@@ -329,7 +329,7 @@ const StructuredReconciliationDataBaseSchema = z.object({
329
329
  }),
330
330
  summary: ReconciliationSummarySchema,
331
331
  balance: BalanceInfoSchema.extend({
332
- discrepancy_direction: z.enum(['balanced', 'ynab_higher', 'bank_higher']),
332
+ discrepancy_direction: z.enum(["balanced", "ynab_higher", "bank_higher"]),
333
333
  }),
334
334
  insights: z.array(ReconciliationInsightSchema),
335
335
  next_steps: z.array(z.string()),
@@ -357,21 +357,21 @@ export const ReconcileAccountOutputSchema = z
357
357
  }),
358
358
  ])
359
359
  .refine((data) => {
360
- if ('structured' in data && data.structured) {
360
+ if ("structured" in data && data.structured) {
361
361
  const discrepancyAmount = data.structured.balance.discrepancy.amount;
362
362
  const direction = data.structured.balance.discrepancy_direction;
363
363
  if (Math.abs(discrepancyAmount) < 0.01) {
364
- return direction === 'balanced';
364
+ return direction === "balanced";
365
365
  }
366
366
  if (discrepancyAmount > 0) {
367
- return direction === 'ynab_higher';
367
+ return direction === "ynab_higher";
368
368
  }
369
369
  if (discrepancyAmount < 0) {
370
- return direction === 'bank_higher';
370
+ return direction === "bank_higher";
371
371
  }
372
372
  }
373
373
  return true;
374
374
  }, {
375
- message: 'Discrepancy direction mismatch: direction must match the numeric discrepancy amount',
376
- path: ['balance', 'discrepancy_direction'],
375
+ message: "Discrepancy direction mismatch: direction must match the numeric discrepancy amount",
376
+ path: ["balance", "discrepancy_direction"],
377
377
  });
@@ -1,4 +1,4 @@
1
- import { z } from 'zod';
1
+ import { z } from "zod";
2
2
  export declare const SubtransactionSchema: z.ZodObject<{
3
3
  id: z.ZodString;
4
4
  transaction_id: z.ZodString;
@@ -1,7 +1,7 @@
1
- import { z } from 'zod';
2
- import { TransactionSchema } from './transactionOutputs.js';
3
- import { AccountSchema } from './accountOutputs.js';
4
- import { CategorySchema } from './categoryOutputs.js';
1
+ import { z } from "zod";
2
+ import { AccountSchema } from "./accountOutputs.js";
3
+ import { CategorySchema } from "./categoryOutputs.js";
4
+ import { TransactionSchema } from "./transactionOutputs.js";
5
5
  export const SubtransactionSchema = z.object({
6
6
  id: z.string(),
7
7
  transaction_id: z.string(),
@@ -50,7 +50,7 @@ export const BulkOperationSummarySchema = z.object({
50
50
  export const BulkResultSchema = z
51
51
  .object({
52
52
  request_index: z.number(),
53
- status: z.enum(['created', 'duplicate', 'updated', 'failed']),
53
+ status: z.enum(["created", "duplicate", "updated", "failed"]),
54
54
  transaction_id: z.string().optional(),
55
55
  correlation_key: z.string(),
56
56
  error_code: z.string().optional(),
@@ -67,13 +67,16 @@ export const TransactionDiffFieldsSchema = z.object({
67
67
  payee_id: z.string().nullable().optional(),
68
68
  payee_name: z.string().nullable().optional(),
69
69
  category_id: z.string().nullable().optional(),
70
- cleared: z.enum(['cleared', 'uncleared', 'reconciled']).optional(),
70
+ cleared: z.enum(["cleared", "uncleared", "reconciled"]).optional(),
71
71
  approved: z.boolean().optional(),
72
- flag_color: z.enum(['red', 'orange', 'yellow', 'green', 'blue', 'purple']).nullable().optional(),
72
+ flag_color: z
73
+ .enum(["red", "orange", "yellow", "green", "blue", "purple"])
74
+ .nullable()
75
+ .optional(),
73
76
  });
74
77
  export const DryRunPreviewItemSchema = z.object({
75
78
  transaction_id: z.string(),
76
- before: z.union([z.literal('unavailable'), TransactionDiffFieldsSchema]),
79
+ before: z.union([z.literal("unavailable"), TransactionDiffFieldsSchema]),
77
80
  after: TransactionDiffFieldsSchema,
78
81
  });
79
82
  export const DryRunWarningSchema = z.object({
@@ -85,7 +88,7 @@ export const DryRunWarningSchema = z.object({
85
88
  export const CreateTransactionOutputSchema = z.union([
86
89
  z.object({
87
90
  dry_run: z.literal(true),
88
- action: z.literal('create_transaction'),
91
+ action: z.literal("create_transaction"),
89
92
  request: z.record(z.string(), z.unknown()),
90
93
  }),
91
94
  z.object({
@@ -107,8 +110,8 @@ export const CreateTransactionsOutputSchema = z.union([
107
110
  z
108
111
  .object({
109
112
  dry_run: z.literal(true),
110
- action: z.literal('create_transactions'),
111
- validation: z.literal('passed'),
113
+ action: z.literal("create_transactions"),
114
+ validation: z.literal("passed"),
112
115
  summary: z.object({
113
116
  total_transactions: z.number(),
114
117
  total_amount: z.number(),
@@ -134,14 +137,14 @@ export const CreateTransactionsOutputSchema = z.union([
134
137
  transactions: z.array(TransactionSchema).optional(),
135
138
  duplicate_import_ids: z.array(z.string()).optional(),
136
139
  message: z.string().optional(),
137
- mode: z.enum(['full', 'summary', 'ids_only']).optional(),
140
+ mode: z.enum(["full", "summary", "ids_only"]).optional(),
138
141
  })
139
142
  .passthrough(),
140
143
  ]);
141
144
  export const UpdateTransactionOutputSchema = z.union([
142
145
  z.object({
143
146
  dry_run: z.literal(true),
144
- action: z.literal('update_transaction'),
147
+ action: z.literal("update_transaction"),
145
148
  request: z.record(z.string(), z.unknown()),
146
149
  }),
147
150
  z.object({
@@ -154,8 +157,8 @@ export const UpdateTransactionsOutputSchema = z.union([
154
157
  z
155
158
  .object({
156
159
  dry_run: z.literal(true),
157
- action: z.literal('update_transactions'),
158
- validation: z.literal('passed'),
160
+ action: z.literal("update_transactions"),
161
+ validation: z.literal("passed"),
159
162
  summary: z.object({
160
163
  total_transactions: z.number(),
161
164
  accounts_affected: z.number(),
@@ -174,14 +177,14 @@ export const UpdateTransactionsOutputSchema = z.union([
174
177
  results: z.array(BulkResultSchema),
175
178
  transactions: z.array(TransactionSchema).optional(),
176
179
  message: z.string().optional(),
177
- mode: z.enum(['full', 'summary', 'ids_only']).optional(),
180
+ mode: z.enum(["full", "summary", "ids_only"]).optional(),
178
181
  })
179
182
  .passthrough(),
180
183
  ]);
181
184
  export const DeleteTransactionOutputSchema = z.union([
182
185
  z.object({
183
186
  dry_run: z.literal(true),
184
- action: z.literal('delete_transaction'),
187
+ action: z.literal("delete_transaction"),
185
188
  request: z.record(z.string(), z.unknown()),
186
189
  }),
187
190
  z.object({
@@ -199,9 +202,12 @@ export const TransactionDryRunPreviewSchema = z.object({
199
202
  date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
200
203
  amount: z.number(),
201
204
  memo: z.string().optional().nullable(),
202
- cleared: z.enum(['cleared', 'uncleared', 'reconciled']).optional(),
205
+ cleared: z.enum(["cleared", "uncleared", "reconciled"]).optional(),
203
206
  approved: z.boolean().optional(),
204
- flag_color: z.enum(['red', 'orange', 'yellow', 'green', 'blue', 'purple']).optional().nullable(),
207
+ flag_color: z
208
+ .enum(["red", "orange", "yellow", "green", "blue", "purple"])
209
+ .optional()
210
+ .nullable(),
205
211
  payee_id: z.string().optional().nullable(),
206
212
  payee_name: z.string().optional().nullable(),
207
213
  category_id: z.string().optional().nullable(),
@@ -215,7 +221,7 @@ export const SubtransactionPreviewSchema = SubtransactionSchema.omit({
215
221
  export const CreateReceiptSplitTransactionOutputSchema = z.union([
216
222
  z.object({
217
223
  dry_run: z.literal(true),
218
- action: z.literal('create_receipt_split_transaction'),
224
+ action: z.literal("create_receipt_split_transaction"),
219
225
  transaction_preview: TransactionDryRunPreviewSchema,
220
226
  receipt_summary: ReceiptSummarySchema,
221
227
  subtransactions: z.array(SubtransactionPreviewSchema),
@@ -234,7 +240,7 @@ export const CreateAccountDryRunRequestSchema = z.object({
234
240
  export const CreateAccountOutputSchema = z.union([
235
241
  z.object({
236
242
  dry_run: z.literal(true),
237
- action: z.literal('create_account'),
243
+ action: z.literal("create_account"),
238
244
  request: CreateAccountDryRunRequestSchema,
239
245
  }),
240
246
  z.object({
@@ -250,7 +256,7 @@ export const UpdateCategoryDryRunRequestSchema = z.object({
250
256
  export const UpdateCategoryOutputSchema = z.union([
251
257
  z.object({
252
258
  dry_run: z.literal(true),
253
- action: z.literal('update_category'),
259
+ action: z.literal("update_category"),
254
260
  request: UpdateCategoryDryRunRequestSchema,
255
261
  }),
256
262
  z.object({
@@ -1,4 +1,4 @@
1
- import { z } from 'zod/v4';
1
+ import { z } from "zod/v4";
2
2
  export declare const TransactionSchema: z.ZodObject<{
3
3
  id: z.ZodString;
4
4
  date: z.ZodString;
@@ -1,49 +1,57 @@
1
- import { z } from 'zod/v4';
2
- import { CacheMetadataSchema } from '../shared/commonOutputs.js';
1
+ import { z } from "zod/v4";
2
+ import { CacheMetadataSchema } from "../shared/commonOutputs.js";
3
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'),
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
16
+ .string()
17
+ .nullish()
18
+ .describe("Transfer transaction ID"),
19
+ matched_transaction_id: z
20
+ .string()
21
+ .nullish()
22
+ .describe("Matched transaction ID"),
23
+ import_id: z.string().optional().describe("Import ID"),
24
+ deleted: z.boolean().describe("Deleted flag"),
25
+ account_name: z.string().optional().describe("Account name"),
26
+ payee_name: z.string().optional().describe("Payee name"),
27
+ category_name: z.string().optional().describe("Category name"),
22
28
  });
23
29
  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
+ id: z.string().describe("Transaction ID"),
31
+ date: z.string().describe("Transaction date"),
32
+ amount: z.number().describe("Transaction amount in dollars"),
33
+ memo: z.string().optional().describe("Transaction memo"),
34
+ payee_name: z.string().optional().describe("Payee name"),
35
+ category_name: z.string().optional().describe("Category name"),
30
36
  });
31
37
  const ListTransactionsNormalSchema = CacheMetadataSchema.extend({
32
- total_count: z.number().int().describe('Total transaction count'),
33
- transactions: z.array(TransactionSchema).describe('List of transactions'),
38
+ total_count: z.number().int().describe("Total transaction count"),
39
+ transactions: z.array(TransactionSchema).describe("List of transactions"),
34
40
  });
35
41
  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
+ message: z.string().describe("Large result set message"),
43
+ suggestion: z.string().describe("Suggestion to narrow results"),
44
+ showing: z.string().describe("Human-readable summary of transactions shown"),
45
+ total_count: z.number().int().describe("Total transaction count"),
46
+ estimated_size_kb: z.number().describe("Estimated response size in KB"),
47
+ preview_transactions: z
48
+ .array(TransactionPreviewSchema)
49
+ .describe("Preview transactions"),
42
50
  });
43
51
  export const ListTransactionsOutputSchema = z.union([
44
52
  ListTransactionsNormalSchema,
45
53
  ListTransactionsPreviewSchema,
46
54
  ]);
47
55
  export const GetTransactionOutputSchema = CacheMetadataSchema.extend({
48
- transaction: TransactionSchema.describe('Transaction details'),
56
+ transaction: TransactionSchema.describe("Transaction details"),
49
57
  });
@@ -1,4 +1,4 @@
1
- import { z } from 'zod/v4';
1
+ import { z } from "zod/v4";
2
2
  export declare const UserSchema: z.ZodObject<{
3
3
  id: z.ZodString;
4
4
  }, z.core.$strip>;
@@ -1,5 +1,5 @@
1
- import { z } from 'zod/v4';
2
- import { SuccessResponseSchema } from '../shared/commonOutputs.js';
1
+ import { z } from "zod/v4";
2
+ import { SuccessResponseSchema } from "../shared/commonOutputs.js";
3
3
  export const UserSchema = z.object({
4
4
  id: z.string(),
5
5
  });
@@ -15,7 +15,9 @@ export const SetDefaultBudgetOutputSchema = SuccessResponseSchema.extend({
15
15
  default_budget_id: z.string(),
16
16
  cache_warm_started: z.boolean(),
17
17
  });
18
- export const ClearCacheOutputSchema = SuccessResponseSchema.pick({ success: true });
18
+ export const ClearCacheOutputSchema = SuccessResponseSchema.pick({
19
+ success: true,
20
+ });
19
21
  export const SetOutputFormatOutputSchema = SuccessResponseSchema.extend({
20
22
  options: z.object({
21
23
  defaultMinify: z.boolean().optional(),
@@ -1,4 +1,4 @@
1
- import { z } from 'zod/v4';
1
+ import { z } from "zod/v4";
2
2
  export declare const CacheMetadataSchema: z.ZodObject<{
3
3
  cached: z.ZodOptional<z.ZodBoolean>;
4
4
  cache_info: z.ZodOptional<z.ZodString>;
@@ -1,6 +1,9 @@
1
- import { z } from 'zod/v4';
1
+ import { z } from "zod/v4";
2
2
  export const CacheMetadataSchema = z.object({
3
- cached: z.boolean().optional().describe('Indicates if data was served from cache'),
3
+ cached: z
4
+ .boolean()
5
+ .optional()
6
+ .describe("Indicates if data was served from cache"),
4
7
  cache_info: z
5
8
  .string()
6
9
  .optional()
@@ -8,20 +11,23 @@ export const CacheMetadataSchema = z.object({
8
11
  usedDelta: z
9
12
  .boolean()
10
13
  .optional()
11
- .describe('Indicates if delta merge optimization was applied for budgets'),
14
+ .describe("Indicates if delta merge optimization was applied for budgets"),
12
15
  });
13
16
  export const SuccessResponseSchema = z.object({
14
- success: z.boolean().describe('Indicates operation success'),
15
- message: z.string().describe('Human-readable success message'),
17
+ success: z.boolean().describe("Indicates operation success"),
18
+ message: z.string().describe("Human-readable success message"),
16
19
  });
17
20
  export const ConfirmationResponseSchema = SuccessResponseSchema.extend({
18
21
  details: z
19
22
  .record(z.string(), z.unknown())
20
23
  .optional()
21
- .describe('Additional confirmation details as key-value pairs'),
24
+ .describe("Additional confirmation details as key-value pairs"),
22
25
  });
23
26
  export const ErrorDetailsSchema = z.object({
24
- error: z.string().describe('Error message'),
25
- code: z.string().optional().describe('Error code for categorization'),
26
- details: z.string().optional().describe('Additional error context or details'),
27
+ error: z.string().describe("Error message"),
28
+ code: z.string().optional().describe("Error code for categorization"),
29
+ details: z
30
+ .string()
31
+ .optional()
32
+ .describe("Additional error context or details"),
27
33
  });
@@ -0,0 +1,11 @@
1
+ import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
2
+ import type * as ynab from "ynab";
3
+ import type { ErrorHandler } from "../server/errorHandler.js";
4
+ import type { ToolRegistry } from "../server/toolRegistry.js";
5
+ import type { ToolContext } from "../types/toolRegistration.js";
6
+ import type { DeltaFetcher } from "./deltaFetcher.js";
7
+ import type { GetTransactionParams, ListTransactionsParams } from "./transactionSchemas.js";
8
+ export declare function handleListTransactions(ynabAPI: ynab.API, deltaFetcher: DeltaFetcher, params: ListTransactionsParams): Promise<CallToolResult>;
9
+ export declare function handleListTransactions(ynabAPI: ynab.API, params: ListTransactionsParams): Promise<CallToolResult>;
10
+ export declare function handleGetTransaction(ynabAPI: ynab.API, params: GetTransactionParams, _errorHandler?: ErrorHandler): Promise<CallToolResult>;
11
+ export declare function registerTransactionReadTools(registry: ToolRegistry, context: ToolContext): void;