@warmio/contracts 3.0.4 → 3.0.5

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 (35) hide show
  1. package/dist/api/endpoints.d.ts +2 -0
  2. package/dist/api/endpoints.d.ts.map +1 -1
  3. package/dist/api/endpoints.js +5 -0
  4. package/dist/api/endpoints.js.map +1 -1
  5. package/dist/financial-context-artifact-protocol.d.ts +21 -11
  6. package/dist/financial-context-artifact-protocol.d.ts.map +1 -1
  7. package/dist/financial-context-artifact-protocol.js +37 -12
  8. package/dist/financial-context-artifact-protocol.js.map +1 -1
  9. package/dist/generated/private-mcp-tool-descriptors.d.ts +4 -1
  10. package/dist/generated/private-mcp-tool-descriptors.d.ts.map +1 -1
  11. package/dist/generated/private-mcp-tool-descriptors.js +5 -1
  12. package/dist/generated/private-mcp-tool-descriptors.js.map +1 -1
  13. package/dist/generated/warm-app-api-manifest.d.ts +6 -3
  14. package/dist/generated/warm-app-api-manifest.d.ts.map +1 -1
  15. package/dist/generated/warm-app-api-manifest.js +7 -3
  16. package/dist/generated/warm-app-api-manifest.js.map +1 -1
  17. package/dist/mcp/index.d.ts +2 -0
  18. package/dist/mcp/index.d.ts.map +1 -1
  19. package/dist/mcp/index.js +2 -0
  20. package/dist/mcp/index.js.map +1 -1
  21. package/dist/mcp/public-output.d.ts +705 -0
  22. package/dist/mcp/public-output.d.ts.map +1 -0
  23. package/dist/mcp/public-output.js +47 -0
  24. package/dist/mcp/public-output.js.map +1 -0
  25. package/dist/mcp/public-tools.d.ts +690 -0
  26. package/dist/mcp/public-tools.d.ts.map +1 -0
  27. package/dist/mcp/public-tools.js +44 -0
  28. package/dist/mcp/public-tools.js.map +1 -0
  29. package/dist/mcp/tools.d.ts +12 -7
  30. package/dist/mcp/tools.d.ts.map +1 -1
  31. package/dist/schemas/financial-context.d.ts +25 -16
  32. package/dist/schemas/financial-context.d.ts.map +1 -1
  33. package/dist/schemas/financial-context.js +9 -2
  34. package/dist/schemas/financial-context.js.map +1 -1
  35. package/package.json +4 -4
@@ -0,0 +1,690 @@
1
+ import { z } from 'zod';
2
+ import { type JsonSchema7Type } from 'zod-to-json-schema';
3
+ export declare const publicMcpToolPermissionContract: {
4
+ readonly status: 'contract_only';
5
+ readonly enforcementOwner: 'provider';
6
+ readonly byTool: {
7
+ readonly get_financial_context: 'financial_context:read';
8
+ readonly get_transactions: 'transactions:read';
9
+ };
10
+ };
11
+ export type PublicMcpToolName = keyof typeof publicMcpToolPermissionContract.byTool;
12
+ export type PublicMcpToolPermission = (typeof publicMcpToolPermissionContract.byTool)[PublicMcpToolName];
13
+ type JsonSchema7Document = JsonSchema7Type & {
14
+ $schema?: string | undefined;
15
+ definitions?: {
16
+ [key: string]: JsonSchema7Type;
17
+ } | undefined;
18
+ };
19
+ export declare const publicMcpToolDefinitions: readonly [{
20
+ readonly name: "get_financial_context";
21
+ readonly description: "Read-only financial context summary. Returns version, updated_at, currency, status.position, and transaction-index totals and months. Account details and transaction items are omitted; use get_transactions for transaction items. The point-in-time position is a balance snapshot, separate from transaction and behavior windows.";
22
+ readonly annotations: {
23
+ readonly readOnlyHint: true;
24
+ readonly destructiveHint: false;
25
+ readonly openWorldHint: false;
26
+ };
27
+ readonly inputShape: {};
28
+ readonly outputSchema: z.ZodObject<Pick<{
29
+ version: z.ZodEnum<["v1"]>;
30
+ updated_at: z.ZodString;
31
+ currency: z.ZodEnum<["USD"]>;
32
+ status: z.ZodObject<{
33
+ position: z.ZodNullable<z.ZodObject<{
34
+ date: z.ZodNullable<z.ZodString>;
35
+ net_worth: z.ZodNullable<z.ZodNumber>;
36
+ cash: z.ZodNullable<z.ZodNumber>;
37
+ debt: z.ZodNullable<z.ZodNumber>;
38
+ investments: z.ZodNullable<z.ZodNumber>;
39
+ other_assets: z.ZodNullable<z.ZodNumber>;
40
+ total_assets: z.ZodNullable<z.ZodNumber>;
41
+ }, "strict", z.ZodTypeAny, {
42
+ date: string | null;
43
+ net_worth: number | null;
44
+ cash: number | null;
45
+ debt: number | null;
46
+ investments: number | null;
47
+ other_assets: number | null;
48
+ total_assets: number | null;
49
+ }, {
50
+ date: string | null;
51
+ net_worth: number | null;
52
+ cash: number | null;
53
+ debt: number | null;
54
+ investments: number | null;
55
+ other_assets: number | null;
56
+ total_assets: number | null;
57
+ }>>;
58
+ accounts: z.ZodArray<z.ZodObject<{
59
+ id: z.ZodString;
60
+ name: z.ZodString;
61
+ source: z.ZodNullable<z.ZodEnum<["plaid", "manual", "csv_import"]>>;
62
+ type: z.ZodEnum<["depository", "credit", "loan", "investment", "brokerage", "other"]>;
63
+ subtype: z.ZodNullable<z.ZodString>;
64
+ group: z.ZodNullable<z.ZodEnum<["cash", "debt", "investments", "other"]>>;
65
+ institution: z.ZodNullable<z.ZodString>;
66
+ mask: z.ZodNullable<z.ZodString>;
67
+ balance: z.ZodNullable<z.ZodNumber>;
68
+ available: z.ZodNullable<z.ZodNumber>;
69
+ currency: z.ZodNullable<z.ZodString>;
70
+ updated_at: z.ZodNullable<z.ZodString>;
71
+ }, "strict", z.ZodTypeAny, {
72
+ id: string;
73
+ name: string;
74
+ source: "csv_import" | "manual" | "plaid" | null;
75
+ type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
76
+ subtype: string | null;
77
+ group: "cash" | "debt" | "investments" | "other" | null;
78
+ institution: string | null;
79
+ mask: string | null;
80
+ balance: number | null;
81
+ available: number | null;
82
+ currency: string | null;
83
+ updated_at: string | null;
84
+ }, {
85
+ id: string;
86
+ name: string;
87
+ source: "csv_import" | "manual" | "plaid" | null;
88
+ type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
89
+ subtype: string | null;
90
+ group: "cash" | "debt" | "investments" | "other" | null;
91
+ institution: string | null;
92
+ mask: string | null;
93
+ balance: number | null;
94
+ available: number | null;
95
+ currency: string | null;
96
+ updated_at: string | null;
97
+ }>, "many">;
98
+ }, "strict", z.ZodTypeAny, {
99
+ position: {
100
+ date: string | null;
101
+ net_worth: number | null;
102
+ cash: number | null;
103
+ debt: number | null;
104
+ investments: number | null;
105
+ other_assets: number | null;
106
+ total_assets: number | null;
107
+ } | null;
108
+ accounts: {
109
+ id: string;
110
+ name: string;
111
+ source: "csv_import" | "manual" | "plaid" | null;
112
+ type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
113
+ subtype: string | null;
114
+ group: "cash" | "debt" | "investments" | "other" | null;
115
+ institution: string | null;
116
+ mask: string | null;
117
+ balance: number | null;
118
+ available: number | null;
119
+ currency: string | null;
120
+ updated_at: string | null;
121
+ }[];
122
+ }, {
123
+ position: {
124
+ date: string | null;
125
+ net_worth: number | null;
126
+ cash: number | null;
127
+ debt: number | null;
128
+ investments: number | null;
129
+ other_assets: number | null;
130
+ total_assets: number | null;
131
+ } | null;
132
+ accounts: {
133
+ id: string;
134
+ name: string;
135
+ source: "csv_import" | "manual" | "plaid" | null;
136
+ type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
137
+ subtype: string | null;
138
+ group: "cash" | "debt" | "investments" | "other" | null;
139
+ institution: string | null;
140
+ mask: string | null;
141
+ balance: number | null;
142
+ available: number | null;
143
+ currency: string | null;
144
+ updated_at: string | null;
145
+ }[];
146
+ }>;
147
+ transactions: z.ZodObject<{
148
+ total: z.ZodNumber;
149
+ months: z.ZodArray<z.ZodObject<{
150
+ month: z.ZodString;
151
+ count: z.ZodNumber;
152
+ }, "strict", z.ZodTypeAny, {
153
+ month: string;
154
+ count: number;
155
+ }, {
156
+ month: string;
157
+ count: number;
158
+ }>, "many">;
159
+ }, "strict", z.ZodTypeAny, {
160
+ total: number;
161
+ months: {
162
+ month: string;
163
+ count: number;
164
+ }[];
165
+ }, {
166
+ total: number;
167
+ months: {
168
+ month: string;
169
+ count: number;
170
+ }[];
171
+ }>;
172
+ recurring: z.ZodArray<z.ZodObject<{
173
+ id: z.ZodString;
174
+ account_id: z.ZodNullable<z.ZodString>;
175
+ direction: z.ZodNullable<z.ZodEnum<["inflow", "outflow"]>>;
176
+ frequency: z.ZodNullable<z.ZodEnum<["WEEKLY", "BIWEEKLY", "MONTHLY", "QUARTERLY", "SEMI_ANNUALLY", "ANNUALLY"]>>;
177
+ status: z.ZodNullable<z.ZodEnum<["active", "inactive", "dismissed"]>>;
178
+ merchant: z.ZodNullable<z.ZodString>;
179
+ amount: z.ZodNullable<z.ZodNumber>;
180
+ next_date: z.ZodNullable<z.ZodString>;
181
+ excluded_from_subscriptions: z.ZodOptional<z.ZodBoolean>;
182
+ }, "strict", z.ZodTypeAny, {
183
+ id: string;
184
+ account_id: string | null;
185
+ direction: "inflow" | "outflow" | null;
186
+ frequency: "ANNUALLY" | "BIWEEKLY" | "MONTHLY" | "QUARTERLY" | "SEMI_ANNUALLY" | "WEEKLY" | null;
187
+ status: "active" | "dismissed" | "inactive" | null;
188
+ merchant: string | null;
189
+ amount: number | null;
190
+ next_date: string | null;
191
+ excluded_from_subscriptions?: boolean | undefined;
192
+ }, {
193
+ id: string;
194
+ account_id: string | null;
195
+ direction: "inflow" | "outflow" | null;
196
+ frequency: "ANNUALLY" | "BIWEEKLY" | "MONTHLY" | "QUARTERLY" | "SEMI_ANNUALLY" | "WEEKLY" | null;
197
+ status: "active" | "dismissed" | "inactive" | null;
198
+ merchant: string | null;
199
+ amount: number | null;
200
+ next_date: string | null;
201
+ excluded_from_subscriptions?: boolean | undefined;
202
+ }>, "many">;
203
+ budgets: z.ZodArray<z.ZodObject<{
204
+ id: z.ZodString;
205
+ name: z.ZodString;
206
+ type: z.ZodEnum<["category", "merchant"]>;
207
+ period: z.ZodEnum<["weekly", "biweekly", "monthly"]>;
208
+ status: z.ZodEnum<["under", "warning", "over"]>;
209
+ amount: z.ZodNumber;
210
+ spent: z.ZodNumber;
211
+ remaining: z.ZodNumber;
212
+ used_percent: z.ZodNumber;
213
+ }, "strict", z.ZodTypeAny, {
214
+ id: string;
215
+ name: string;
216
+ type: "category" | "merchant";
217
+ period: "biweekly" | "monthly" | "weekly";
218
+ status: "over" | "under" | "warning";
219
+ amount: number;
220
+ spent: number;
221
+ remaining: number;
222
+ used_percent: number;
223
+ }, {
224
+ id: string;
225
+ name: string;
226
+ type: "category" | "merchant";
227
+ period: "biweekly" | "monthly" | "weekly";
228
+ status: "over" | "under" | "warning";
229
+ amount: number;
230
+ spent: number;
231
+ remaining: number;
232
+ used_percent: number;
233
+ }>, "many">;
234
+ goals: z.ZodArray<z.ZodObject<{
235
+ id: z.ZodString;
236
+ name: z.ZodString;
237
+ category: z.ZodString;
238
+ status: z.ZodEnum<["not_started", "in_progress", "on_track", "behind", "completed"]>;
239
+ target: z.ZodNumber;
240
+ current: z.ZodNumber;
241
+ progress_percent: z.ZodNumber;
242
+ target_date: z.ZodNullable<z.ZodString>;
243
+ }, "strict", z.ZodTypeAny, {
244
+ id: string;
245
+ name: string;
246
+ category: string;
247
+ status: "behind" | "completed" | "in_progress" | "not_started" | "on_track";
248
+ target: number;
249
+ current: number;
250
+ progress_percent: number;
251
+ target_date: string | null;
252
+ }, {
253
+ id: string;
254
+ name: string;
255
+ category: string;
256
+ status: "behind" | "completed" | "in_progress" | "not_started" | "on_track";
257
+ target: number;
258
+ current: number;
259
+ progress_percent: number;
260
+ target_date: string | null;
261
+ }>, "many">;
262
+ snapshots: z.ZodArray<z.ZodObject<{
263
+ date: z.ZodString;
264
+ net_worth: z.ZodNullable<z.ZodNumber>;
265
+ cash: z.ZodNullable<z.ZodNumber>;
266
+ debt: z.ZodNullable<z.ZodNumber>;
267
+ income: z.ZodNullable<z.ZodNumber>;
268
+ expenses: z.ZodNullable<z.ZodNumber>;
269
+ cash_flow: z.ZodNullable<z.ZodNumber>;
270
+ savings_rate: z.ZodNullable<z.ZodNumber>;
271
+ investments: z.ZodNullable<z.ZodNumber>;
272
+ assets: z.ZodNullable<z.ZodNumber>;
273
+ health_score: z.ZodNullable<z.ZodNumber>;
274
+ health_score_model_version: z.ZodNullable<z.ZodLiteral<3>>;
275
+ }, "strict", z.ZodTypeAny, {
276
+ date: string;
277
+ net_worth: number | null;
278
+ cash: number | null;
279
+ debt: number | null;
280
+ income: number | null;
281
+ expenses: number | null;
282
+ cash_flow: number | null;
283
+ savings_rate: number | null;
284
+ investments: number | null;
285
+ assets: number | null;
286
+ health_score: number | null;
287
+ health_score_model_version: 3 | null;
288
+ }, {
289
+ date: string;
290
+ net_worth: number | null;
291
+ cash: number | null;
292
+ debt: number | null;
293
+ income: number | null;
294
+ expenses: number | null;
295
+ cash_flow: number | null;
296
+ savings_rate: number | null;
297
+ investments: number | null;
298
+ assets: number | null;
299
+ health_score: number | null;
300
+ health_score_model_version: 3 | null;
301
+ }>, "many">;
302
+ liabilities: z.ZodArray<z.ZodObject<{
303
+ account_id: z.ZodNullable<z.ZodString>;
304
+ type: z.ZodNullable<z.ZodEnum<["credit", "student", "mortgage", "other"]>>;
305
+ balance: z.ZodNullable<z.ZodNumber>;
306
+ minimum_payment: z.ZodNullable<z.ZodNumber>;
307
+ due_date: z.ZodNullable<z.ZodString>;
308
+ interest_rate: z.ZodNullable<z.ZodNumber>;
309
+ rate_type: z.ZodNullable<z.ZodEnum<["fixed", "variable"]>>;
310
+ overdue: z.ZodNullable<z.ZodBoolean>;
311
+ }, "strict", z.ZodTypeAny, {
312
+ account_id: string | null;
313
+ type: "credit" | "mortgage" | "other" | "student" | null;
314
+ balance: number | null;
315
+ minimum_payment: number | null;
316
+ due_date: string | null;
317
+ interest_rate: number | null;
318
+ rate_type: "fixed" | "variable" | null;
319
+ overdue: boolean | null;
320
+ }, {
321
+ account_id: string | null;
322
+ type: "credit" | "mortgage" | "other" | "student" | null;
323
+ balance: number | null;
324
+ minimum_payment: number | null;
325
+ due_date: string | null;
326
+ interest_rate: number | null;
327
+ rate_type: "fixed" | "variable" | null;
328
+ overdue: boolean | null;
329
+ }>, "many">;
330
+ holdings: z.ZodArray<z.ZodObject<{
331
+ account_id: z.ZodNullable<z.ZodString>;
332
+ symbol: z.ZodNullable<z.ZodString>;
333
+ name: z.ZodNullable<z.ZodString>;
334
+ type: z.ZodNullable<z.ZodEnum<["cash", "derivative", "equity", "etf", "fixed_income", "mutual_fund", "other"]>>;
335
+ quantity: z.ZodNullable<z.ZodNumber>;
336
+ value: z.ZodNullable<z.ZodNumber>;
337
+ cost_basis: z.ZodNullable<z.ZodNumber>;
338
+ }, "strict", z.ZodTypeAny, {
339
+ account_id: string | null;
340
+ symbol: string | null;
341
+ name: string | null;
342
+ type: "cash" | "derivative" | "equity" | "etf" | "fixed_income" | "mutual_fund" | "other" | null;
343
+ quantity: number | null;
344
+ value: number | null;
345
+ cost_basis: number | null;
346
+ }, {
347
+ account_id: string | null;
348
+ symbol: string | null;
349
+ name: string | null;
350
+ type: "cash" | "derivative" | "equity" | "etf" | "fixed_income" | "mutual_fund" | "other" | null;
351
+ quantity: number | null;
352
+ value: number | null;
353
+ cost_basis: number | null;
354
+ }>, "many">;
355
+ health: z.ZodNullable<z.ZodObject<{
356
+ score: z.ZodNumber;
357
+ model_version: z.ZodLiteral<3>;
358
+ record_count: z.ZodNumber;
359
+ label: z.ZodEnum<["Needs Attention", "Good", "Strong"]>;
360
+ level: z.ZodEnum<["strong", "good", "fair", "poor", "critical"]>;
361
+ summary: z.ZodString;
362
+ data_completeness: z.ZodNumber;
363
+ pillars: z.ZodNullable<z.ZodObject<{
364
+ spend: z.ZodNullable<z.ZodNumber>;
365
+ save: z.ZodNullable<z.ZodNumber>;
366
+ borrow: z.ZodNullable<z.ZodNumber>;
367
+ build: z.ZodNullable<z.ZodNumber>;
368
+ }, "strict", z.ZodTypeAny, {
369
+ spend: number | null;
370
+ save: number | null;
371
+ borrow: number | null;
372
+ build: number | null;
373
+ }, {
374
+ spend: number | null;
375
+ save: number | null;
376
+ borrow: number | null;
377
+ build: number | null;
378
+ }>>;
379
+ }, "strict", z.ZodTypeAny, {
380
+ score: number;
381
+ model_version: 3;
382
+ record_count: number;
383
+ label: "Good" | "Needs Attention" | "Strong";
384
+ level: "critical" | "fair" | "good" | "poor" | "strong";
385
+ summary: string;
386
+ data_completeness: number;
387
+ pillars: {
388
+ spend: number | null;
389
+ save: number | null;
390
+ borrow: number | null;
391
+ build: number | null;
392
+ } | null;
393
+ }, {
394
+ score: number;
395
+ model_version: 3;
396
+ record_count: number;
397
+ label: "Good" | "Needs Attention" | "Strong";
398
+ level: "critical" | "fair" | "good" | "poor" | "strong";
399
+ summary: string;
400
+ data_completeness: number;
401
+ pillars: {
402
+ spend: number | null;
403
+ save: number | null;
404
+ borrow: number | null;
405
+ build: number | null;
406
+ } | null;
407
+ }>>;
408
+ }, "currency" | "transactions" | "updated_at" | "version"> & {
409
+ status: z.ZodObject<Pick<{
410
+ position: z.ZodNullable<z.ZodObject<{
411
+ date: z.ZodNullable<z.ZodString>;
412
+ net_worth: z.ZodNullable<z.ZodNumber>;
413
+ cash: z.ZodNullable<z.ZodNumber>;
414
+ debt: z.ZodNullable<z.ZodNumber>;
415
+ investments: z.ZodNullable<z.ZodNumber>;
416
+ other_assets: z.ZodNullable<z.ZodNumber>;
417
+ total_assets: z.ZodNullable<z.ZodNumber>;
418
+ }, "strict", z.ZodTypeAny, {
419
+ date: string | null;
420
+ net_worth: number | null;
421
+ cash: number | null;
422
+ debt: number | null;
423
+ investments: number | null;
424
+ other_assets: number | null;
425
+ total_assets: number | null;
426
+ }, {
427
+ date: string | null;
428
+ net_worth: number | null;
429
+ cash: number | null;
430
+ debt: number | null;
431
+ investments: number | null;
432
+ other_assets: number | null;
433
+ total_assets: number | null;
434
+ }>>;
435
+ accounts: z.ZodArray<z.ZodObject<{
436
+ id: z.ZodString;
437
+ name: z.ZodString;
438
+ source: z.ZodNullable<z.ZodEnum<["plaid", "manual", "csv_import"]>>;
439
+ type: z.ZodEnum<["depository", "credit", "loan", "investment", "brokerage", "other"]>;
440
+ subtype: z.ZodNullable<z.ZodString>;
441
+ group: z.ZodNullable<z.ZodEnum<["cash", "debt", "investments", "other"]>>;
442
+ institution: z.ZodNullable<z.ZodString>;
443
+ mask: z.ZodNullable<z.ZodString>;
444
+ balance: z.ZodNullable<z.ZodNumber>;
445
+ available: z.ZodNullable<z.ZodNumber>;
446
+ currency: z.ZodNullable<z.ZodString>;
447
+ updated_at: z.ZodNullable<z.ZodString>;
448
+ }, "strict", z.ZodTypeAny, {
449
+ id: string;
450
+ name: string;
451
+ source: "csv_import" | "manual" | "plaid" | null;
452
+ type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
453
+ subtype: string | null;
454
+ group: "cash" | "debt" | "investments" | "other" | null;
455
+ institution: string | null;
456
+ mask: string | null;
457
+ balance: number | null;
458
+ available: number | null;
459
+ currency: string | null;
460
+ updated_at: string | null;
461
+ }, {
462
+ id: string;
463
+ name: string;
464
+ source: "csv_import" | "manual" | "plaid" | null;
465
+ type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
466
+ subtype: string | null;
467
+ group: "cash" | "debt" | "investments" | "other" | null;
468
+ institution: string | null;
469
+ mask: string | null;
470
+ balance: number | null;
471
+ available: number | null;
472
+ currency: string | null;
473
+ updated_at: string | null;
474
+ }>, "many">;
475
+ }, "position">, "strict", z.ZodTypeAny, {
476
+ position: {
477
+ date: string | null;
478
+ net_worth: number | null;
479
+ cash: number | null;
480
+ debt: number | null;
481
+ investments: number | null;
482
+ other_assets: number | null;
483
+ total_assets: number | null;
484
+ } | null;
485
+ }, {
486
+ position: {
487
+ date: string | null;
488
+ net_worth: number | null;
489
+ cash: number | null;
490
+ debt: number | null;
491
+ investments: number | null;
492
+ other_assets: number | null;
493
+ total_assets: number | null;
494
+ } | null;
495
+ }>;
496
+ }, "strict", z.ZodTypeAny, {
497
+ version: "v1";
498
+ updated_at: string;
499
+ currency: "USD";
500
+ transactions: {
501
+ total: number;
502
+ months: {
503
+ month: string;
504
+ count: number;
505
+ }[];
506
+ };
507
+ status: {
508
+ position: {
509
+ date: string | null;
510
+ net_worth: number | null;
511
+ cash: number | null;
512
+ debt: number | null;
513
+ investments: number | null;
514
+ other_assets: number | null;
515
+ total_assets: number | null;
516
+ } | null;
517
+ };
518
+ }, {
519
+ version: "v1";
520
+ updated_at: string;
521
+ currency: "USD";
522
+ transactions: {
523
+ total: number;
524
+ months: {
525
+ month: string;
526
+ count: number;
527
+ }[];
528
+ };
529
+ status: {
530
+ position: {
531
+ date: string | null;
532
+ net_worth: number | null;
533
+ cash: number | null;
534
+ debt: number | null;
535
+ investments: number | null;
536
+ other_assets: number | null;
537
+ total_assets: number | null;
538
+ } | null;
539
+ };
540
+ }>;
541
+ }, {
542
+ readonly name: "get_transactions";
543
+ readonly description: "Read-only transaction pages from the financial context. Pass `period: \"latest\"` for the fixed 10-day window or `period: \"YYYY-MM\"` for a month page. Transaction items include date, amount, category, subcategory, pending, and currency; IDs, account details, merchants, and names are omitted. The latest window is not caller-configurable. Months outside the covered range return an error.";
544
+ readonly annotations: {
545
+ readonly readOnlyHint: true;
546
+ readonly destructiveHint: false;
547
+ readonly openWorldHint: false;
548
+ };
549
+ readonly inputShape: {
550
+ period: z.ZodUnion<[z.ZodLiteral<"latest">, z.ZodString]>;
551
+ };
552
+ readonly outputSchema: z.ZodUnion<[z.ZodObject<{
553
+ month: z.ZodString;
554
+ start_date: z.ZodString;
555
+ end_date: z.ZodString;
556
+ count: z.ZodNumber;
557
+ } & {
558
+ items: z.ZodArray<z.ZodObject<Pick<{
559
+ id: z.ZodString;
560
+ account_id: z.ZodNullable<z.ZodString>;
561
+ date: z.ZodNullable<z.ZodString>;
562
+ amount: z.ZodNumber;
563
+ merchant: z.ZodNullable<z.ZodString>;
564
+ name: z.ZodNullable<z.ZodString>;
565
+ category: z.ZodNullable<z.ZodString>;
566
+ subcategory: z.ZodNullable<z.ZodString>;
567
+ pending: z.ZodNullable<z.ZodBoolean>;
568
+ currency: z.ZodNullable<z.ZodString>;
569
+ }, "amount" | "category" | "currency" | "date" | "pending" | "subcategory">, "strict", z.ZodTypeAny, {
570
+ date: string | null;
571
+ amount: number;
572
+ category: string | null;
573
+ subcategory: string | null;
574
+ pending: boolean | null;
575
+ currency: string | null;
576
+ }, {
577
+ date: string | null;
578
+ amount: number;
579
+ category: string | null;
580
+ subcategory: string | null;
581
+ pending: boolean | null;
582
+ currency: string | null;
583
+ }>, "many">;
584
+ }, "strict", z.ZodTypeAny, {
585
+ month: string;
586
+ start_date: string;
587
+ end_date: string;
588
+ count: number;
589
+ items: {
590
+ date: string | null;
591
+ amount: number;
592
+ category: string | null;
593
+ subcategory: string | null;
594
+ pending: boolean | null;
595
+ currency: string | null;
596
+ }[];
597
+ }, {
598
+ month: string;
599
+ start_date: string;
600
+ end_date: string;
601
+ count: number;
602
+ items: {
603
+ date: string | null;
604
+ amount: number;
605
+ category: string | null;
606
+ subcategory: string | null;
607
+ pending: boolean | null;
608
+ currency: string | null;
609
+ }[];
610
+ }>, z.ZodObject<{
611
+ since: z.ZodString;
612
+ window_days: z.ZodLiteral<10>;
613
+ count: z.ZodNumber;
614
+ } & {
615
+ items: z.ZodArray<z.ZodObject<Pick<{
616
+ id: z.ZodString;
617
+ account_id: z.ZodNullable<z.ZodString>;
618
+ date: z.ZodNullable<z.ZodString>;
619
+ amount: z.ZodNumber;
620
+ merchant: z.ZodNullable<z.ZodString>;
621
+ name: z.ZodNullable<z.ZodString>;
622
+ category: z.ZodNullable<z.ZodString>;
623
+ subcategory: z.ZodNullable<z.ZodString>;
624
+ pending: z.ZodNullable<z.ZodBoolean>;
625
+ currency: z.ZodNullable<z.ZodString>;
626
+ }, "amount" | "category" | "currency" | "date" | "pending" | "subcategory">, "strict", z.ZodTypeAny, {
627
+ date: string | null;
628
+ amount: number;
629
+ category: string | null;
630
+ subcategory: string | null;
631
+ pending: boolean | null;
632
+ currency: string | null;
633
+ }, {
634
+ date: string | null;
635
+ amount: number;
636
+ category: string | null;
637
+ subcategory: string | null;
638
+ pending: boolean | null;
639
+ currency: string | null;
640
+ }>, "many">;
641
+ }, "strict", z.ZodTypeAny, {
642
+ since: string;
643
+ window_days: 10;
644
+ count: number;
645
+ items: {
646
+ date: string | null;
647
+ amount: number;
648
+ category: string | null;
649
+ subcategory: string | null;
650
+ pending: boolean | null;
651
+ currency: string | null;
652
+ }[];
653
+ }, {
654
+ since: string;
655
+ window_days: 10;
656
+ count: number;
657
+ items: {
658
+ date: string | null;
659
+ amount: number;
660
+ category: string | null;
661
+ subcategory: string | null;
662
+ pending: boolean | null;
663
+ currency: string | null;
664
+ }[];
665
+ }>]>;
666
+ }];
667
+ export declare const publicMcpToolDescriptors: ({
668
+ name: "get_financial_context";
669
+ description: "Read-only financial context summary. Returns version, updated_at, currency, status.position, and transaction-index totals and months. Account details and transaction items are omitted; use get_transactions for transaction items. The point-in-time position is a balance snapshot, separate from transaction and behavior windows.";
670
+ annotations: {
671
+ readonly readOnlyHint: true;
672
+ readonly destructiveHint: false;
673
+ readonly openWorldHint: false;
674
+ };
675
+ input_schema: JsonSchema7Document;
676
+ output_schema: JsonSchema7Document;
677
+ } | {
678
+ name: "get_transactions";
679
+ description: "Read-only transaction pages from the financial context. Pass `period: \"latest\"` for the fixed 10-day window or `period: \"YYYY-MM\"` for a month page. Transaction items include date, amount, category, subcategory, pending, and currency; IDs, account details, merchants, and names are omitted. The latest window is not caller-configurable. Months outside the covered range return an error.";
680
+ annotations: {
681
+ readonly readOnlyHint: true;
682
+ readonly destructiveHint: false;
683
+ readonly openWorldHint: false;
684
+ };
685
+ input_schema: JsonSchema7Document;
686
+ output_schema: JsonSchema7Document;
687
+ })[];
688
+ export type PublicMcpToolDescriptor = (typeof publicMcpToolDescriptors)[number];
689
+ export {};
690
+ //# sourceMappingURL=public-tools.d.ts.map