@expensebot/mcp-server-auth 0.6.21 → 0.6.23
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.
- package/README.md +6 -6
- package/package.json +3 -2
- package/scripts/sync-check.js +150 -0
- package/server.json +37 -0
- package/src/client.js +1 -1
- package/src/index.js +1161 -129
- package/src/test.js +286 -4
package/src/index.js
CHANGED
|
@@ -49,6 +49,8 @@ const SERVER_INSTRUCTIONS = [
|
|
|
49
49
|
"For a requested multi-step workflow, be concise: show the grounded preview, ask one clear yes/no confirmation when required, then complete every approved step. Prefer group_expenses for group-and-report requests even when the expenses already have that group. Do not add unsolicited tax, audit, substantiation, or client-AP advice, and do not second-guess an approved scope unless a tool reports an ambiguity, conflict, or failure. A request to create, share, or bill from a report is NOT a request for compliance, tax, deductibility, report-detail, business-purpose, attendee, or reimbursement analysis: never call those tools as a preflight or follow-up unless the user explicitly asks for that analysis. 'Without personal expenses' is only a report filter. isReimbursable is ExpenseBot workflow state, not a judgment about whether an expense may be billed to a client.",
|
|
50
50
|
"For exact corrections across several expenses, use correct_expenses only after search_expenses has returned the exact expenseId values. Show its automatic preview, ask one yes/no question, then return its verified terminal result without adding advice. Use only attendee names the user explicitly supplied. For broad, ambiguous, mixed, or more than 100-row cleanup, link to Review Expenses instead.",
|
|
51
51
|
"Across every tool, treat returned counts, totals, currencies, statuses, and completion evidence as authoritative. Never recompute them from detail rows or reinterpret a successful result. After an approved write completes, report the outcome and relevant links without reopening the user's approved scope or adding unrequested advice. Ask another question only when the tool reports an ambiguity, conflict, failure, or required external side effect.",
|
|
52
|
+
"When structuredContent is present, use it as the authoritative machine-readable result and use text only as the compatibility narrative. Respect explicit branch and pagination fields such as success, found, status, state, hasMore, nextCursor, and truncated. Never invent fields absent from the returned branch or merge stale values from an earlier call.",
|
|
53
|
+
"For grouping workflows, call the destination a group in user-facing prose, even though ExpenseBot stores it in its Tag column; do not rename it a tag unless explaining the spreadsheet schema. Search and preview totals are provisional. After a confirmed group_expenses or create_report result, use only that terminal result's exact count, total, and currency, even when it differs from an earlier preview by rounding. A Bill Client URL is a reviewed handoff only: it does not mean an invoice was created, sent, or confirmed.",
|
|
52
54
|
"Across every answer, answer the user's requested task first and stop when it is complete. Do not infer intent, risk, tax treatment, reimbursement eligibility, business purpose, attendees, client expectations, or currency preferences from merchants, locations, dates, or amounts. Offer analysis, warnings, or follow-up work only when the user asks for it or an authoritative tool result says action is required.",
|
|
53
55
|
"A successful terminal write result supersedes intermediate search and preview observations. The final answer must follow the terminal result's responseGuidance and must not repeat exploratory candidates, excluded near-matches, or concerns that the terminal tool did not report. When a terminal result contains finalAnswer, return it verbatim and add nothing else. After a Bill Client handoff, do not offer report sharing or currency advice unless the user explicitly requested it.",
|
|
54
56
|
"Report provenance is literal: say a report was created only when the terminal result explicitly says creationStatus=created_this_call. Reports returned by list_reports are pre-existing; describe them as found, existing, or opened, never created or generated. If no new report was created, say so plainly and do not imply otherwise.",
|
|
@@ -56,7 +58,7 @@ const SERVER_INSTRUCTIONS = [
|
|
|
56
58
|
"After another expense submission, show the returned spreadsheetUrl and reviewExpensesUrl.",
|
|
57
59
|
"For income writes, show spreadsheetUrl and reviewIncomeUrl.",
|
|
58
60
|
"For Gmail scan progress or completion, call get_scan_status. Report its authoritative status and live phase; on completion show spreadsheetUrl and reviewExpensesUrl, and when action is needed show gmailScanUrl.",
|
|
59
|
-
"For product, setup, billing, Gmail, report, workflow, or troubleshooting questions, call search_knowledge instead of guessing.
|
|
61
|
+
"For product, setup, billing, Gmail, report, workflow, or troubleshooting questions, call search_knowledge instead of guessing. Set fullAnswer:true on the first call when the user asks for complete, detailed, or step-by-step instructions; use the default excerpt mode only for discovery or quick answers.",
|
|
60
62
|
].join("\n");
|
|
61
63
|
|
|
62
64
|
if (onboardingMode) {
|
|
@@ -69,6 +71,32 @@ if (onboardingMode) {
|
|
|
69
71
|
|
|
70
72
|
// ── Shared schemas ─────────────────────────────────────────────────────
|
|
71
73
|
//
|
|
74
|
+
const OPENAI_FILE_REFERENCE_SCHEMA = {
|
|
75
|
+
type: "object",
|
|
76
|
+
description:
|
|
77
|
+
"Attached file reference supplied by ChatGPT. The server downloads the file securely.",
|
|
78
|
+
properties: {
|
|
79
|
+
download_url: {
|
|
80
|
+
type: "string",
|
|
81
|
+
format: "uri",
|
|
82
|
+
description: "Temporary HTTPS URL supplied by ChatGPT for downloading the attachment.",
|
|
83
|
+
},
|
|
84
|
+
file_id: {
|
|
85
|
+
type: "string",
|
|
86
|
+
description: "Attachment identifier supplied by ChatGPT.",
|
|
87
|
+
},
|
|
88
|
+
mime_type: {
|
|
89
|
+
type: "string",
|
|
90
|
+
description: "Attachment MIME type supplied by ChatGPT.",
|
|
91
|
+
},
|
|
92
|
+
file_name: {
|
|
93
|
+
type: "string",
|
|
94
|
+
description: "Original attachment filename supplied by ChatGPT.",
|
|
95
|
+
},
|
|
96
|
+
},
|
|
97
|
+
required: ["download_url", "file_id"],
|
|
98
|
+
};
|
|
99
|
+
|
|
72
100
|
// dateRange is a discriminated union — historically every analytics tool
|
|
73
101
|
// inlined the same flat object with all fields optional. OpenAI's app-review
|
|
74
102
|
// scanner flagged that as "Unclear Arguments: dateRange has multiple required
|
|
@@ -166,11 +194,570 @@ const CLIENT_EMAIL_SCHEMA = {
|
|
|
166
194
|
"Client account email. Accountants may use this only for an accepted ExpenseBot client.",
|
|
167
195
|
};
|
|
168
196
|
|
|
197
|
+
|
|
198
|
+
// ── Tranche 1 output schemas (2026-09-09) — read-only tools ───────────────
|
|
199
|
+
// Same HONESTY RULE as the block above: `required` lists only fields present on
|
|
200
|
+
// EVERY successful response (verified against mcpActionExecutor.js). Conditional
|
|
201
|
+
// fields are described but never required; additionalProperties stays true.
|
|
202
|
+
// Helper-delegated payloads (buildX/loadX) keep `required` at the envelope only.
|
|
203
|
+
// Error responses never receive structuredContent, so these describe success.
|
|
204
|
+
|
|
205
|
+
// Shared by get_pnl / get_spending_summary / get_income_summary /
|
|
206
|
+
// get_deep_analytics / get_per_tag_pnl. These enqueue an async job and return a
|
|
207
|
+
// pending handle, OR (simple queries) resolve inline; poll_analytics returns the
|
|
208
|
+
// terminal data. Two branches, discriminated by `type`/`status`.
|
|
209
|
+
const ANALYTICS_QUERY_OUTPUT_SCHEMA = {
|
|
210
|
+
type: "object",
|
|
211
|
+
required: [],
|
|
212
|
+
additionalProperties: true,
|
|
213
|
+
description:
|
|
214
|
+
"Two branches. Async: type='analytics_pending' with jobId — poll poll_analytics until complete. Inline: message + data with the computed analytics (data may be null when there is no spreadsheet or no data yet). success is present only on the async branch.",
|
|
215
|
+
properties: {
|
|
216
|
+
success: { type: "boolean", description: "Async branch only." },
|
|
217
|
+
type: {
|
|
218
|
+
type: "string",
|
|
219
|
+
description: 'Async branch only: "analytics_pending" — poll pollEndpoint or call poll_analytics with jobId.',
|
|
220
|
+
},
|
|
221
|
+
jobId: { type: "string", description: "Async branch only." },
|
|
222
|
+
pollEndpoint: { type: "string", description: "Async branch only." },
|
|
223
|
+
pollInterval: { type: "number", description: "Async branch only: milliseconds." },
|
|
224
|
+
estimatedTime: { type: "number", description: "Async branch only: seconds." },
|
|
225
|
+
message: { type: "string", description: "Human-readable narrative (both branches)." },
|
|
226
|
+
response: { type: "string", description: "Chat alias of message." },
|
|
227
|
+
data: {
|
|
228
|
+
type: ["object", "null"],
|
|
229
|
+
additionalProperties: true,
|
|
230
|
+
description: "Inline branch: computed analytics, or null when no spreadsheet / no data.",
|
|
231
|
+
},
|
|
232
|
+
},
|
|
233
|
+
};
|
|
234
|
+
|
|
235
|
+
const GET_MILEAGE_SUMMARY_OUTPUT_SCHEMA = {
|
|
236
|
+
type: "object",
|
|
237
|
+
required: [],
|
|
238
|
+
additionalProperties: true,
|
|
239
|
+
description:
|
|
240
|
+
"Success returns message + data with the computed summary; success is not emitted on the inline analytics path.",
|
|
241
|
+
properties: {
|
|
242
|
+
success: { type: "boolean", description: "Present only on the error branch (out of scope) / async path." },
|
|
243
|
+
message: { type: "string" },
|
|
244
|
+
data: { type: ["object", "null"], additionalProperties: true },
|
|
245
|
+
},
|
|
246
|
+
};
|
|
247
|
+
|
|
248
|
+
const GET_SUBSCRIPTION_AUDIT_OUTPUT_SCHEMA = {
|
|
249
|
+
type: "object",
|
|
250
|
+
required: [],
|
|
251
|
+
additionalProperties: true,
|
|
252
|
+
description:
|
|
253
|
+
"Success returns message + data with the computed summary; success is not emitted on the inline analytics path.",
|
|
254
|
+
properties: {
|
|
255
|
+
success: { type: "boolean", description: "Present only on the error branch (out of scope) / async path." },
|
|
256
|
+
message: { type: "string" },
|
|
257
|
+
data: { type: ["object", "null"], additionalProperties: true },
|
|
258
|
+
},
|
|
259
|
+
};
|
|
260
|
+
|
|
261
|
+
const GET_TRIP_SUGGESTIONS_OUTPUT_SCHEMA = {
|
|
262
|
+
type: "object",
|
|
263
|
+
required: ["success"],
|
|
264
|
+
additionalProperties: true,
|
|
265
|
+
properties: {
|
|
266
|
+
success: { type: "boolean" },
|
|
267
|
+
count: { type: "integer" },
|
|
268
|
+
message: { type: "string" },
|
|
269
|
+
proposals: {
|
|
270
|
+
type: "array",
|
|
271
|
+
description: "Read-only trip proposals; accepting one continues through group_expenses.",
|
|
272
|
+
items: { type: "object", additionalProperties: true },
|
|
273
|
+
},
|
|
274
|
+
},
|
|
275
|
+
};
|
|
276
|
+
|
|
277
|
+
const LIST_CATEGORIES_OUTPUT_SCHEMA = {
|
|
278
|
+
type: "object",
|
|
279
|
+
required: ["success", "categories"],
|
|
280
|
+
additionalProperties: true,
|
|
281
|
+
properties: {
|
|
282
|
+
success: { type: "boolean" },
|
|
283
|
+
categories: { type: "array", items: { type: "string" }, description: "Expense categories for the user." },
|
|
284
|
+
billingAccounts: { type: "array", items: { type: "string" }, description: "Billing/card accounts, when configured." },
|
|
285
|
+
},
|
|
286
|
+
};
|
|
287
|
+
|
|
288
|
+
const LIST_INCOME_CATEGORIES_OUTPUT_SCHEMA = {
|
|
289
|
+
type: "object",
|
|
290
|
+
required: ["success", "categories"],
|
|
291
|
+
additionalProperties: true,
|
|
292
|
+
properties: {
|
|
293
|
+
success: { type: "boolean" },
|
|
294
|
+
categories: { type: "array", items: { type: "string" } },
|
|
295
|
+
legacy: { type: "array", items: { type: "string" }, description: "Deprecated income categories still accepted on read." },
|
|
296
|
+
notes: { type: "string" },
|
|
297
|
+
},
|
|
298
|
+
};
|
|
299
|
+
|
|
300
|
+
const LIST_TAGS_OUTPUT_SCHEMA = {
|
|
301
|
+
type: "object",
|
|
302
|
+
required: ["success", "tags"],
|
|
303
|
+
additionalProperties: true,
|
|
304
|
+
properties: {
|
|
305
|
+
success: { type: "boolean" },
|
|
306
|
+
tags: {
|
|
307
|
+
type: "array",
|
|
308
|
+
description: "Client / project / trip groups (Column K values).",
|
|
309
|
+
items: { type: "object", additionalProperties: true },
|
|
310
|
+
},
|
|
311
|
+
},
|
|
312
|
+
};
|
|
313
|
+
|
|
314
|
+
const LIST_REPORTS_OUTPUT_SCHEMA = {
|
|
315
|
+
type: "object",
|
|
316
|
+
required: ["success", "creationStatus"],
|
|
317
|
+
additionalProperties: true,
|
|
318
|
+
properties: {
|
|
319
|
+
success: { type: "boolean" },
|
|
320
|
+
creationStatus: {
|
|
321
|
+
type: "string",
|
|
322
|
+
description: 'Provenance of the listing, e.g. "existing_only".',
|
|
323
|
+
},
|
|
324
|
+
reports: {
|
|
325
|
+
type: "array",
|
|
326
|
+
description: "Present when the user has reports.",
|
|
327
|
+
items: { type: "object", additionalProperties: true },
|
|
328
|
+
},
|
|
329
|
+
page: { type: "integer" },
|
|
330
|
+
limit: { type: "integer" },
|
|
331
|
+
filter: { type: "string" },
|
|
332
|
+
responseGuidance: { type: "string" },
|
|
333
|
+
},
|
|
334
|
+
};
|
|
335
|
+
|
|
336
|
+
const GET_REPORT_DETAILS_OUTPUT_SCHEMA = {
|
|
337
|
+
type: "object",
|
|
338
|
+
required: ["success", "report"],
|
|
339
|
+
additionalProperties: true,
|
|
340
|
+
properties: {
|
|
341
|
+
success: { type: "boolean" },
|
|
342
|
+
report: { type: "object", additionalProperties: true, description: "The full stored report record." },
|
|
343
|
+
},
|
|
344
|
+
};
|
|
345
|
+
|
|
346
|
+
const GET_RECENT_ACTIVITY_OUTPUT_SCHEMA = {
|
|
347
|
+
type: "object",
|
|
348
|
+
required: ["success", "count", "actions"],
|
|
349
|
+
additionalProperties: true,
|
|
350
|
+
properties: {
|
|
351
|
+
success: { type: "boolean" },
|
|
352
|
+
count: { type: "integer" },
|
|
353
|
+
actions: {
|
|
354
|
+
type: "array",
|
|
355
|
+
items: {
|
|
356
|
+
type: "object",
|
|
357
|
+
additionalProperties: true,
|
|
358
|
+
properties: {
|
|
359
|
+
actionId: { type: "string" },
|
|
360
|
+
success: { type: "boolean" },
|
|
361
|
+
durationMs: { type: "number" },
|
|
362
|
+
timestamp: { type: "string" },
|
|
363
|
+
},
|
|
364
|
+
},
|
|
365
|
+
},
|
|
366
|
+
},
|
|
367
|
+
};
|
|
368
|
+
|
|
369
|
+
const GET_CLIENT_INVOICE_OUTPUT_SCHEMA = {
|
|
370
|
+
type: "object",
|
|
371
|
+
required: ["success"],
|
|
372
|
+
additionalProperties: true,
|
|
373
|
+
properties: {
|
|
374
|
+
success: { type: "boolean" },
|
|
375
|
+
message: { type: "string" },
|
|
376
|
+
invoice: {
|
|
377
|
+
type: "object",
|
|
378
|
+
description: "The invoice record. Absent only on the error branch (not-found), which never carries structuredContent.",
|
|
379
|
+
additionalProperties: true,
|
|
380
|
+
properties: {
|
|
381
|
+
invoiceId: { type: "string", description: "Durable invoice identity." },
|
|
382
|
+
invoiceNumber: { type: ["string", "null"] },
|
|
383
|
+
clientName: { type: ["string", "null"] },
|
|
384
|
+
clientTag: { type: ["string", "null"] },
|
|
385
|
+
status: { type: "string", description: 'Stored status, e.g. "open", "paid", "void".' },
|
|
386
|
+
displayStatus: {
|
|
387
|
+
type: "string",
|
|
388
|
+
enum: ["open", "overdue", "paid", "void", "superseded", "needs_review"],
|
|
389
|
+
description: "Derived: overdue is computed from status + dueDate, not stored.",
|
|
390
|
+
},
|
|
391
|
+
issueDate: { type: ["string", "null"] },
|
|
392
|
+
dueDate: { type: ["string", "null"] },
|
|
393
|
+
currency: { type: "string" },
|
|
394
|
+
subtotal: { type: "number" },
|
|
395
|
+
taxAmount: { type: "number" },
|
|
396
|
+
grandTotal: { type: "number" },
|
|
397
|
+
advanceApplied: { type: "number" },
|
|
398
|
+
balanceDue: { type: "number" },
|
|
399
|
+
paidDate: { type: ["string", "null"], description: "null until paid." },
|
|
400
|
+
paidAmount: { type: ["number", "null"], description: "null until paid." },
|
|
401
|
+
deliveryStatus: { type: "string" },
|
|
402
|
+
documentUrl: { type: ["string", "null"] },
|
|
403
|
+
pdfUrl: { type: ["string", "null"] },
|
|
404
|
+
reportUrl: { type: ["string", "null"] },
|
|
405
|
+
billClientUrl: { type: ["string", "null"] },
|
|
406
|
+
},
|
|
407
|
+
},
|
|
408
|
+
},
|
|
409
|
+
};
|
|
410
|
+
|
|
411
|
+
const LIST_CLIENT_INVOICES_OUTPUT_SCHEMA = {
|
|
412
|
+
type: "object",
|
|
413
|
+
required: ["success", "invoices"],
|
|
414
|
+
additionalProperties: true,
|
|
415
|
+
properties: {
|
|
416
|
+
success: { type: "boolean" },
|
|
417
|
+
invoices: {
|
|
418
|
+
type: "array",
|
|
419
|
+
items: {
|
|
420
|
+
type: "object",
|
|
421
|
+
additionalProperties: true,
|
|
422
|
+
properties: {
|
|
423
|
+
invoiceId: { type: "string" },
|
|
424
|
+
invoiceNumber: { type: ["string", "null"] },
|
|
425
|
+
clientName: { type: ["string", "null"] },
|
|
426
|
+
status: { type: "string" },
|
|
427
|
+
displayStatus: {
|
|
428
|
+
type: "string",
|
|
429
|
+
enum: ["open", "overdue", "paid", "void", "superseded", "needs_review"],
|
|
430
|
+
},
|
|
431
|
+
total: { type: "number" },
|
|
432
|
+
grandTotal: { type: "number" },
|
|
433
|
+
advanceApplied: { type: "number" },
|
|
434
|
+
currency: { type: "string" },
|
|
435
|
+
issueDate: { type: ["string", "null"] },
|
|
436
|
+
},
|
|
437
|
+
},
|
|
438
|
+
},
|
|
439
|
+
},
|
|
440
|
+
};
|
|
441
|
+
|
|
442
|
+
const GET_EXPENSE_BY_ID_OUTPUT_SCHEMA = {
|
|
443
|
+
type: "object",
|
|
444
|
+
required: ["success"],
|
|
445
|
+
additionalProperties: true,
|
|
446
|
+
properties: {
|
|
447
|
+
success: { type: "boolean" },
|
|
448
|
+
rowNumber: { type: "integer", description: "Resolved sheet row for the expense." },
|
|
449
|
+
expense: { type: "object", additionalProperties: true, description: "The expense record." },
|
|
450
|
+
reviewExpenseUrl: { type: "string" },
|
|
451
|
+
},
|
|
452
|
+
};
|
|
453
|
+
|
|
454
|
+
// Helper-delegated payloads: builders own the shape, so the honest contract is
|
|
455
|
+
// the envelope plus the one always-present collection where verified.
|
|
456
|
+
const GET_EXPENSE_SPLITS_OUTPUT_SCHEMA = {
|
|
457
|
+
type: "object",
|
|
458
|
+
required: ["success"],
|
|
459
|
+
additionalProperties: true,
|
|
460
|
+
properties: {
|
|
461
|
+
success: { type: "boolean" },
|
|
462
|
+
message: { type: "string" },
|
|
463
|
+
splits: { type: "array", items: { type: "object", additionalProperties: true } },
|
|
464
|
+
data: { type: "object", additionalProperties: true },
|
|
465
|
+
},
|
|
466
|
+
};
|
|
467
|
+
|
|
468
|
+
const GET_MONTHLY_BOOKS_REVIEW_OUTPUT_SCHEMA = {
|
|
469
|
+
type: "object",
|
|
470
|
+
required: ["success"],
|
|
471
|
+
additionalProperties: true,
|
|
472
|
+
properties: {
|
|
473
|
+
success: { type: "boolean" },
|
|
474
|
+
message: { type: "string" },
|
|
475
|
+
data: { type: "object", additionalProperties: true },
|
|
476
|
+
},
|
|
477
|
+
};
|
|
478
|
+
|
|
479
|
+
const GET_CREDITS_REFUNDS_OUTPUT_SCHEMA = {
|
|
480
|
+
type: "object",
|
|
481
|
+
required: ["success"],
|
|
482
|
+
additionalProperties: true,
|
|
483
|
+
properties: {
|
|
484
|
+
success: { type: "boolean" },
|
|
485
|
+
message: { type: "string" },
|
|
486
|
+
credits: { type: "array", items: { type: "object", additionalProperties: true } },
|
|
487
|
+
refunds: { type: "array", items: { type: "object", additionalProperties: true } },
|
|
488
|
+
data: { type: "object", additionalProperties: true },
|
|
489
|
+
},
|
|
490
|
+
};
|
|
491
|
+
|
|
492
|
+
const GET_CLIENT_ADVANCE_BALANCES_OUTPUT_SCHEMA = {
|
|
493
|
+
type: "object",
|
|
494
|
+
required: ["success"],
|
|
495
|
+
additionalProperties: true,
|
|
496
|
+
properties: {
|
|
497
|
+
success: { type: "boolean" },
|
|
498
|
+
message: { type: "string" },
|
|
499
|
+
homeCurrency: { type: "string" },
|
|
500
|
+
balances: { type: "array", items: { type: "object", additionalProperties: true } },
|
|
501
|
+
data: { type: "object", additionalProperties: true },
|
|
502
|
+
},
|
|
503
|
+
};
|
|
504
|
+
|
|
505
|
+
const GET_ACCOUNTING_INTEGRATION_STATUS_OUTPUT_SCHEMA = {
|
|
506
|
+
type: "object",
|
|
507
|
+
required: ["success"],
|
|
508
|
+
additionalProperties: true,
|
|
509
|
+
properties: {
|
|
510
|
+
success: { type: "boolean" },
|
|
511
|
+
message: { type: "string" },
|
|
512
|
+
data: { type: "object", additionalProperties: true, description: "Per-provider connection and rollout state." },
|
|
513
|
+
},
|
|
514
|
+
};
|
|
515
|
+
|
|
516
|
+
const GET_ACCOUNTING_PUSH_STATUS_OUTPUT_SCHEMA = {
|
|
517
|
+
type: "object",
|
|
518
|
+
required: ["success"],
|
|
519
|
+
additionalProperties: true,
|
|
520
|
+
properties: {
|
|
521
|
+
success: { type: "boolean" },
|
|
522
|
+
message: { type: "string" },
|
|
523
|
+
data: { type: "object", additionalProperties: true },
|
|
524
|
+
},
|
|
525
|
+
};
|
|
526
|
+
|
|
527
|
+
|
|
528
|
+
// ── Tranche 2 output schemas (2026-09-09) — checks, what-ifs, status, commerce ─
|
|
529
|
+
// Honest-loose (see tranche 1 header). Advisory/read tools. `required` holds
|
|
530
|
+
// only fields the executor emits on every success path; the what-if/check tools
|
|
531
|
+
// delegate their payload to scenario/handler builders, so those keep `required`
|
|
532
|
+
// at the envelope. Error responses never receive structuredContent.
|
|
533
|
+
|
|
534
|
+
// Shared by whatif_afford / whatif_client / whatif_tax_setaside:
|
|
535
|
+
// result = { success:true, message: scenario.template || evidence[0].value, data: scenario }
|
|
536
|
+
const WHATIF_OUTPUT_SCHEMA = {
|
|
537
|
+
type: "object",
|
|
538
|
+
required: ["success"],
|
|
539
|
+
additionalProperties: true,
|
|
540
|
+
properties: {
|
|
541
|
+
success: { type: "boolean" },
|
|
542
|
+
message: { type: "string", description: "Scenario narrative; may be absent if the scenario carried no template or evidence." },
|
|
543
|
+
data: { type: "object", additionalProperties: true, description: "The full what-if scenario: assumptions, evidence, and computed outcome." },
|
|
544
|
+
},
|
|
545
|
+
};
|
|
546
|
+
|
|
547
|
+
// Shared by check_compliance / check_feature / check_tax_deductibility (registry
|
|
548
|
+
// handlers). Success returns success:true plus a message and handler-specific
|
|
549
|
+
// fields; keep required at the envelope.
|
|
550
|
+
const CHECK_OUTPUT_SCHEMA = {
|
|
551
|
+
type: "object",
|
|
552
|
+
required: ["success"],
|
|
553
|
+
additionalProperties: true,
|
|
554
|
+
properties: {
|
|
555
|
+
success: { type: "boolean" },
|
|
556
|
+
message: { type: "string" },
|
|
557
|
+
data: { type: "object", additionalProperties: true },
|
|
558
|
+
},
|
|
559
|
+
};
|
|
560
|
+
|
|
561
|
+
const GET_SCAN_STATUS_OUTPUT_SCHEMA = {
|
|
562
|
+
type: "object",
|
|
563
|
+
required: ["success"],
|
|
564
|
+
additionalProperties: true,
|
|
565
|
+
description:
|
|
566
|
+
"Authoritative live scan state. Fields may sit at the top level or under data depending on the branch; nothing beyond success is guaranteed, so treat each as optional.",
|
|
567
|
+
properties: {
|
|
568
|
+
success: { type: "boolean" },
|
|
569
|
+
message: { type: "string" },
|
|
570
|
+
status: { type: ["string", "null"], description: "Scan lifecycle state." },
|
|
571
|
+
scanInProgress: { type: "boolean" },
|
|
572
|
+
lock: {
|
|
573
|
+
type: "object",
|
|
574
|
+
additionalProperties: true,
|
|
575
|
+
description: "Scan-lock state (active, startedAt, ageSeconds, dispatchComplete, pendingProcessingCount).",
|
|
576
|
+
},
|
|
577
|
+
latestScan: {
|
|
578
|
+
type: ["object", "null"],
|
|
579
|
+
additionalProperties: true,
|
|
580
|
+
description: "Most recent scan outcome (success, emailsFound, emailsTagged, timestamp).",
|
|
581
|
+
},
|
|
582
|
+
spreadsheetUrl: { type: ["string", "null"] },
|
|
583
|
+
reviewExpensesUrl: { type: ["string", "null"] },
|
|
584
|
+
gmailScanUrl: { type: ["string", "null"] },
|
|
585
|
+
data: { type: "object", additionalProperties: true },
|
|
586
|
+
},
|
|
587
|
+
};
|
|
588
|
+
|
|
169
589
|
// ── Tool Definitions ───────────────────────────────────────────────────
|
|
170
590
|
|
|
591
|
+
// Output contracts for the first, highest-guess-cost tranche. `required`
|
|
592
|
+
// contains only fields present on every successful response. Conditional
|
|
593
|
+
// fields remain optional and additionalProperties stays true: an incomplete
|
|
594
|
+
// contract is preferable to a confident lie about a live response shape.
|
|
595
|
+
const SEARCH_EXPENSES_OUTPUT_SCHEMA = {
|
|
596
|
+
type: "object",
|
|
597
|
+
required: ["expenses", "count", "total"],
|
|
598
|
+
additionalProperties: true,
|
|
599
|
+
properties: {
|
|
600
|
+
message: { type: "string" },
|
|
601
|
+
expenses: {
|
|
602
|
+
type: "array",
|
|
603
|
+
description: "Matching expense rows, newest first, paginated.",
|
|
604
|
+
items: {
|
|
605
|
+
type: "object",
|
|
606
|
+
required: ["expenseId", "date", "amount", "tag", "updateEligible"],
|
|
607
|
+
additionalProperties: true,
|
|
608
|
+
properties: {
|
|
609
|
+
expenseId: {
|
|
610
|
+
type: "string",
|
|
611
|
+
description:
|
|
612
|
+
"Durable Receipt ID (Column Q). The only identity accepted by update_expense.",
|
|
613
|
+
},
|
|
614
|
+
merchant: { type: "string" },
|
|
615
|
+
date: { type: "string" },
|
|
616
|
+
dateIso: { type: "string", description: "Canonical YYYY-MM-DD when available." },
|
|
617
|
+
category: { type: "string" },
|
|
618
|
+
amount: { type: "number", description: "Functional/home-currency amount." },
|
|
619
|
+
currency: { type: "string", description: "Home currency code when available." },
|
|
620
|
+
originalAmount: { type: "number" },
|
|
621
|
+
originalCurrency: { type: "string" },
|
|
622
|
+
tag: { type: "string", description: "Column K group (client/project/trip)." },
|
|
623
|
+
location: { type: "string" },
|
|
624
|
+
matchedFields: { type: "array", items: { type: "string" } },
|
|
625
|
+
matchReason: { type: "string" },
|
|
626
|
+
updateEligible: { type: "boolean" },
|
|
627
|
+
},
|
|
628
|
+
},
|
|
629
|
+
},
|
|
630
|
+
total: { type: "number", description: "Sum of the matched set in home currency." },
|
|
631
|
+
count: { type: "integer", description: "Rows matched by the filters." },
|
|
632
|
+
totalMatched: { type: "integer", description: "Present for free-text searches." },
|
|
633
|
+
queryApplied: { type: "string" },
|
|
634
|
+
hasMore: { type: "boolean" },
|
|
635
|
+
nextCursor: {
|
|
636
|
+
type: ["string", "null"],
|
|
637
|
+
description: "Opaque signed continuation; reuse with identical filters.",
|
|
638
|
+
},
|
|
639
|
+
pageInfo: { type: "object", additionalProperties: true },
|
|
640
|
+
},
|
|
641
|
+
};
|
|
642
|
+
|
|
643
|
+
const SEARCH_KNOWLEDGE_OUTPUT_SCHEMA = {
|
|
644
|
+
type: "object",
|
|
645
|
+
required: ["success", "results"],
|
|
646
|
+
additionalProperties: true,
|
|
647
|
+
properties: {
|
|
648
|
+
success: { type: "boolean" },
|
|
649
|
+
results: {
|
|
650
|
+
type: "array",
|
|
651
|
+
items: {
|
|
652
|
+
type: "object",
|
|
653
|
+
required: ["id", "question", "answer"],
|
|
654
|
+
additionalProperties: true,
|
|
655
|
+
properties: {
|
|
656
|
+
id: { type: "string" },
|
|
657
|
+
question: { type: "string" },
|
|
658
|
+
answer: { type: "string" },
|
|
659
|
+
truncated: { type: "boolean" },
|
|
660
|
+
type: { type: "string" },
|
|
661
|
+
relevance: { type: "number" },
|
|
662
|
+
},
|
|
663
|
+
},
|
|
664
|
+
},
|
|
665
|
+
},
|
|
666
|
+
};
|
|
667
|
+
|
|
668
|
+
const GET_LAST_RECEIPT_RESULT_OUTPUT_SCHEMA = {
|
|
669
|
+
type: "object",
|
|
670
|
+
required: ["success", "found", "message"],
|
|
671
|
+
additionalProperties: true,
|
|
672
|
+
description:
|
|
673
|
+
"found:false means processing is still pending; found:true is a terminal result.",
|
|
674
|
+
properties: {
|
|
675
|
+
success: { type: "boolean", const: true },
|
|
676
|
+
found: { type: "boolean" },
|
|
677
|
+
state: {
|
|
678
|
+
type: "string",
|
|
679
|
+
const: "processing",
|
|
680
|
+
description: "Present on pending polls for a specific submission.",
|
|
681
|
+
},
|
|
682
|
+
message: { type: "string" },
|
|
683
|
+
verdict: {
|
|
684
|
+
type: "string",
|
|
685
|
+
enum: ["added", "duplicate", "skipped", "errored", "mixed", "unknown"],
|
|
686
|
+
description: "Terminal branch only.",
|
|
687
|
+
},
|
|
688
|
+
counts: {
|
|
689
|
+
type: "object",
|
|
690
|
+
additionalProperties: true,
|
|
691
|
+
required: ["submitted", "added", "duplicates", "skipped", "errors"],
|
|
692
|
+
properties: {
|
|
693
|
+
submitted: { type: "integer", minimum: 0 },
|
|
694
|
+
added: { type: "integer", minimum: 0 },
|
|
695
|
+
duplicates: { type: "integer", minimum: 0 },
|
|
696
|
+
skipped: { type: "integer", minimum: 0 },
|
|
697
|
+
errors: { type: "integer", minimum: 0 },
|
|
698
|
+
},
|
|
699
|
+
},
|
|
700
|
+
receipts: { type: "array", items: { type: "object", additionalProperties: true } },
|
|
701
|
+
submissionId: { type: ["string", "null"] },
|
|
702
|
+
spreadsheetUrl: { type: ["string", "null"] },
|
|
703
|
+
reviewExpensesUrl: { type: "string" },
|
|
704
|
+
data: { type: "object", additionalProperties: true },
|
|
705
|
+
timestamp: { type: ["string", "null"], format: "date-time" },
|
|
706
|
+
},
|
|
707
|
+
allOf: [
|
|
708
|
+
{
|
|
709
|
+
if: { properties: { found: { const: true } }, required: ["found"] },
|
|
710
|
+
then: {
|
|
711
|
+
required: [
|
|
712
|
+
"verdict",
|
|
713
|
+
"counts",
|
|
714
|
+
"receipts",
|
|
715
|
+
"submissionId",
|
|
716
|
+
"spreadsheetUrl",
|
|
717
|
+
"reviewExpensesUrl",
|
|
718
|
+
"data",
|
|
719
|
+
"timestamp",
|
|
720
|
+
],
|
|
721
|
+
},
|
|
722
|
+
},
|
|
723
|
+
],
|
|
724
|
+
};
|
|
725
|
+
|
|
726
|
+
const GET_SPREADSHEET_URL_OUTPUT_SCHEMA = {
|
|
727
|
+
type: "object",
|
|
728
|
+
required: [
|
|
729
|
+
"success",
|
|
730
|
+
"spreadsheetId",
|
|
731
|
+
"spreadsheetUrl",
|
|
732
|
+
"reviewExpensesUrl",
|
|
733
|
+
"reviewIncomeUrl",
|
|
734
|
+
"gmailScanUrl",
|
|
735
|
+
"gmailActionNeededUrl",
|
|
736
|
+
"reportsUrl",
|
|
737
|
+
"dashboardUrl",
|
|
738
|
+
"data",
|
|
739
|
+
"message",
|
|
740
|
+
],
|
|
741
|
+
additionalProperties: true,
|
|
742
|
+
properties: {
|
|
743
|
+
success: { type: "boolean", const: true },
|
|
744
|
+
spreadsheetId: { type: "string", minLength: 1 },
|
|
745
|
+
spreadsheetUrl: { type: "string" },
|
|
746
|
+
reviewExpensesUrl: { type: "string" },
|
|
747
|
+
reviewIncomeUrl: { type: "string" },
|
|
748
|
+
gmailScanUrl: { type: "string" },
|
|
749
|
+
gmailActionNeededUrl: { type: "string" },
|
|
750
|
+
reportsUrl: { type: "string" },
|
|
751
|
+
dashboardUrl: { type: "string" },
|
|
752
|
+
data: { type: "object", additionalProperties: true },
|
|
753
|
+
message: { type: "string" },
|
|
754
|
+
},
|
|
755
|
+
};
|
|
756
|
+
|
|
171
757
|
const TOOLS = [
|
|
172
758
|
{
|
|
173
759
|
name: "search_expenses",
|
|
760
|
+
outputSchema: SEARCH_EXPENSES_OUTPUT_SCHEMA,
|
|
174
761
|
description:
|
|
175
762
|
"Search and filter the user's expenses. Returns matching expense rows " +
|
|
176
763
|
"from their spreadsheet. Filter by category, merchant, date range, " +
|
|
@@ -233,6 +820,7 @@ const TOOLS = [
|
|
|
233
820
|
},
|
|
234
821
|
{
|
|
235
822
|
name: "get_spending_summary",
|
|
823
|
+
outputSchema: ANALYTICS_QUERY_OUTPUT_SCHEMA,
|
|
236
824
|
description:
|
|
237
825
|
"Summarize the user's recorded expenses with totals and breakdowns by " +
|
|
238
826
|
"category, merchant, month, tag, source, or payment method. Supports " +
|
|
@@ -248,7 +836,11 @@ const TOOLS = [
|
|
|
248
836
|
description:
|
|
249
837
|
"Natural language question (e.g., 'how much did I spend in March', 'top merchants this quarter')",
|
|
250
838
|
},
|
|
251
|
-
categories: {
|
|
839
|
+
categories: {
|
|
840
|
+
type: "array",
|
|
841
|
+
items: { type: "string" },
|
|
842
|
+
description: "Optional configured expense categories to include in the summary.",
|
|
843
|
+
},
|
|
252
844
|
dateRange: DATE_RANGE_SCHEMA,
|
|
253
845
|
groupBy: { type: "string", enum: ["category", "merchant", "month", "tag", "source", "paymentMethod"] },
|
|
254
846
|
metric: { type: "string", enum: ["total", "count", "average"] },
|
|
@@ -257,6 +849,7 @@ const TOOLS = [
|
|
|
257
849
|
},
|
|
258
850
|
{
|
|
259
851
|
name: "get_deep_analytics",
|
|
852
|
+
outputSchema: ANALYTICS_QUERY_OUTPUT_SCHEMA,
|
|
260
853
|
description:
|
|
261
854
|
"Run deeper, multi-step analytics on the user's expenses. Use for " +
|
|
262
855
|
"explanatory questions like 'why did my spending increase' or " +
|
|
@@ -292,8 +885,9 @@ const TOOLS = [
|
|
|
292
885
|
"not already assigned to another ordinary report. Can optionally share " +
|
|
293
886
|
"with recipients. If no unreported matches remain, create no duplicate " +
|
|
294
887
|
"report and explain that the expenses are already in Reports. Terminal " +
|
|
295
|
-
"results also include accountingHandoffUrls
|
|
296
|
-
"the existing file-export workflow.
|
|
888
|
+
"results also include role-appropriate accountingHandoffUrls from the " +
|
|
889
|
+
"server capability matrix and the existing reviewed file-export workflow. " +
|
|
890
|
+
"Use only the exact " +
|
|
297
891
|
"destination the user requested; the link opens the reviewed app flow " +
|
|
298
892
|
"and does not mean an export occurred. Complete " +
|
|
299
893
|
"the requested report directly; do not call " +
|
|
@@ -304,7 +898,11 @@ const TOOLS = [
|
|
|
304
898
|
properties: {
|
|
305
899
|
dateRange: DATE_RANGE_SCHEMA,
|
|
306
900
|
title: { type: "string", description: "Custom report title" },
|
|
307
|
-
categories: {
|
|
901
|
+
categories: {
|
|
902
|
+
type: "array",
|
|
903
|
+
items: { type: "string" },
|
|
904
|
+
description: "Optional configured expense categories to include in the report.",
|
|
905
|
+
},
|
|
308
906
|
tags: {
|
|
309
907
|
type: "array",
|
|
310
908
|
items: { type: "string" },
|
|
@@ -331,11 +929,19 @@ const TOOLS = [
|
|
|
331
929
|
items: { type: "string", format: "email" },
|
|
332
930
|
description: "Email addresses to share the report with",
|
|
333
931
|
},
|
|
932
|
+
recipientRole: {
|
|
933
|
+
type: "string",
|
|
934
|
+
enum: ["reviewer", "accountant"],
|
|
935
|
+
default: "reviewer",
|
|
936
|
+
description:
|
|
937
|
+
"Access for every shareWith recipient. Use reviewer for one-report review, comments, approval, or change requests. Use accountant only when the user explicitly wants ongoing report management and accounting-software access.",
|
|
938
|
+
},
|
|
334
939
|
},
|
|
335
940
|
},
|
|
336
941
|
},
|
|
337
942
|
{
|
|
338
943
|
name: "list_reports",
|
|
944
|
+
outputSchema: LIST_REPORTS_OUTPUT_SCHEMA,
|
|
339
945
|
description:
|
|
340
946
|
"List the user's expense reports with pagination. Filter by status " +
|
|
341
947
|
"(All, Draft, Submitted, Shared). Each exact report includes its app, " +
|
|
@@ -346,14 +952,43 @@ const TOOLS = [
|
|
|
346
952
|
type: "object",
|
|
347
953
|
properties: {
|
|
348
954
|
clientEmail: CLIENT_EMAIL_SCHEMA,
|
|
349
|
-
page: {
|
|
350
|
-
|
|
351
|
-
|
|
955
|
+
page: {
|
|
956
|
+
type: "integer",
|
|
957
|
+
default: 1,
|
|
958
|
+
description: "One-based results page to return.",
|
|
959
|
+
},
|
|
960
|
+
limit: {
|
|
961
|
+
type: "integer",
|
|
962
|
+
default: 20,
|
|
963
|
+
description: "Maximum reports to return on this page.",
|
|
964
|
+
},
|
|
965
|
+
filter: {
|
|
966
|
+
type: "string",
|
|
967
|
+
enum: ["All", "Draft", "Submitted", "Shared"],
|
|
968
|
+
default: "All",
|
|
969
|
+
description: "Optional report-status filter; All returns every authorized status.",
|
|
970
|
+
},
|
|
971
|
+
},
|
|
972
|
+
},
|
|
973
|
+
},
|
|
974
|
+
{
|
|
975
|
+
name: "request_accounting_integration",
|
|
976
|
+
description:
|
|
977
|
+
"Request support for an accounting package only after checking ExpenseBot's reviewed direct and import-file destinations and finding no matching package. Do not use this for a listed or Beta destination, a general compatibility question, or without the exact package name. This is a confirmation-gated write: after the user approves, it creates one deduplicated request bound to the authenticated ExpenseBot account and emails ExpenseBot's internal team. It does not create an integration or make the requested package immediately available. On accepted or previously recorded requests, tell the user ExpenseBot will email them within one week with an update.",
|
|
978
|
+
inputSchema: {
|
|
979
|
+
type: "object",
|
|
980
|
+
properties: {
|
|
981
|
+
packageName: {
|
|
982
|
+
type: "string",
|
|
983
|
+
description: "Exact accounting package requested by the user.",
|
|
984
|
+
},
|
|
352
985
|
},
|
|
986
|
+
required: ["packageName"],
|
|
353
987
|
},
|
|
354
988
|
},
|
|
355
989
|
{
|
|
356
990
|
name: "get_report_details",
|
|
991
|
+
outputSchema: GET_REPORT_DETAILS_OUTPUT_SCHEMA,
|
|
357
992
|
description:
|
|
358
993
|
"Get full details of a specific expense report including all expenses, " +
|
|
359
994
|
"totals, and compliance status. Use only when the user explicitly asks " +
|
|
@@ -377,8 +1012,7 @@ const TOOLS = [
|
|
|
377
1012
|
{
|
|
378
1013
|
name: "share_report",
|
|
379
1014
|
description:
|
|
380
|
-
"Share
|
|
381
|
-
"or approval.",
|
|
1015
|
+
"Share one existing expense report after confirmation. Default to reviewer: they can open and edit that report's Google Sheet, inspect receipts, comment, approve, or request changes, but cannot act for the owner or use accounting integrations. Use accountant only when the user explicitly asks for ongoing accounting access; it creates the established accountant relationship and broader report-management workflow.",
|
|
382
1016
|
inputSchema: {
|
|
383
1017
|
type: "object",
|
|
384
1018
|
properties: {
|
|
@@ -387,12 +1021,20 @@ const TOOLS = [
|
|
|
387
1021
|
type: "array",
|
|
388
1022
|
items: { type: "string", format: "email" },
|
|
389
1023
|
},
|
|
1024
|
+
recipientRole: {
|
|
1025
|
+
type: "string",
|
|
1026
|
+
enum: ["reviewer", "accountant"],
|
|
1027
|
+
default: "reviewer",
|
|
1028
|
+
description:
|
|
1029
|
+
"Use reviewer for report-only approval. Use accountant only for explicit ongoing accountant access.",
|
|
1030
|
+
},
|
|
390
1031
|
},
|
|
391
1032
|
required: ["reportId", "recipients"],
|
|
392
1033
|
},
|
|
393
1034
|
},
|
|
394
1035
|
{
|
|
395
1036
|
name: "check_compliance",
|
|
1037
|
+
outputSchema: CHECK_OUTPUT_SCHEMA,
|
|
396
1038
|
description:
|
|
397
1039
|
"Use only when the user explicitly asks to check an existing report for " +
|
|
398
1040
|
"compliance issues such as missing business purpose or policy violations. " +
|
|
@@ -432,6 +1074,7 @@ const TOOLS = [
|
|
|
432
1074
|
},
|
|
433
1075
|
{
|
|
434
1076
|
name: "check_tax_deductibility",
|
|
1077
|
+
outputSchema: CHECK_OUTPUT_SCHEMA,
|
|
435
1078
|
description:
|
|
436
1079
|
"Look up whether a specific expense type or purchase is tax-DEDUCTIBLE " +
|
|
437
1080
|
"(business write-off rules) based on the user's country/jurisdiction. " +
|
|
@@ -457,12 +1100,16 @@ const TOOLS = [
|
|
|
457
1100
|
},
|
|
458
1101
|
{
|
|
459
1102
|
name: "search_knowledge",
|
|
1103
|
+
outputSchema: SEARCH_KNOWLEDGE_OUTPUT_SCHEMA,
|
|
460
1104
|
description:
|
|
461
1105
|
"Search ExpenseBot's complete product and help knowledge base. Use this " +
|
|
462
1106
|
"before guessing when the user asks how a feature works, what ExpenseBot " +
|
|
463
1107
|
"supports, or needs setup, billing, Gmail, scan, report, workflow, or " +
|
|
464
|
-
"troubleshooting instructions.
|
|
465
|
-
"
|
|
1108
|
+
"troubleshooting instructions. Set fullAnswer:true on the first call when " +
|
|
1109
|
+
"the user asks for complete, detailed, or step-by-step instructions. Use " +
|
|
1110
|
+
"the default excerpt mode for discovery and quick answers; if an excerpt " +
|
|
1111
|
+
"is truncated, call again with fullAnswer:true before presenting complete " +
|
|
1112
|
+
"instructions. Each result has a stable id.",
|
|
466
1113
|
inputSchema: {
|
|
467
1114
|
type: "object",
|
|
468
1115
|
properties: {
|
|
@@ -478,7 +1125,7 @@ const TOOLS = [
|
|
|
478
1125
|
type: "boolean",
|
|
479
1126
|
default: false,
|
|
480
1127
|
description:
|
|
481
|
-
"Set true
|
|
1128
|
+
"Set true on the first call for complete, detailed, or step-by-step instructions. Leave false for discovery or quick-answer excerpts.",
|
|
482
1129
|
},
|
|
483
1130
|
},
|
|
484
1131
|
required: ["query"],
|
|
@@ -504,9 +1151,9 @@ const TOOLS = [
|
|
|
504
1151
|
"call this tool ONCE with uploadRefs for all of them — that processes " +
|
|
505
1152
|
"the whole set as a single batch, like the ExpenseBot web app. Do not " +
|
|
506
1153
|
"call this tool once per file.\n\n" +
|
|
507
|
-
"
|
|
508
|
-
"
|
|
509
|
-
"
|
|
1154
|
+
"Use the photo parameter for one image or PDF attached in ChatGPT. MCP " +
|
|
1155
|
+
"clients that cannot supply file references may use photoBase64 for one " +
|
|
1156
|
+
"small image; use the upload flow for large files or batches.\n\n" +
|
|
510
1157
|
"Optional note and tag values use the same receipt metadata path as " +
|
|
511
1158
|
"ExpenseBot's camera, file uploader, and forwarded-email intake. The " +
|
|
512
1159
|
"note is stored in the Notes column (L); the tag is stored in the Tag " +
|
|
@@ -588,11 +1235,16 @@ const TOOLS = [
|
|
|
588
1235
|
"is more than one file.",
|
|
589
1236
|
},
|
|
590
1237
|
photo: {
|
|
1238
|
+
...OPENAI_FILE_REFERENCE_SCHEMA,
|
|
1239
|
+
description:
|
|
1240
|
+
"Single attached receipt image or PDF supplied by ChatGPT. For multiple " +
|
|
1241
|
+
"files or large files, use filesToUpload and uploadRefs instead.",
|
|
1242
|
+
},
|
|
1243
|
+
photoBase64: {
|
|
591
1244
|
type: "string",
|
|
592
1245
|
description:
|
|
593
|
-
"
|
|
594
|
-
"
|
|
595
|
-
"dropped in transit; use uploadRef instead.",
|
|
1246
|
+
"Legacy fallback for MCP clients that send one small image as complete " +
|
|
1247
|
+
"base64 data. ChatGPT should use photo or uploadRefs instead.",
|
|
596
1248
|
},
|
|
597
1249
|
filename: {
|
|
598
1250
|
type: "string",
|
|
@@ -624,8 +1276,9 @@ const TOOLS = [
|
|
|
624
1276
|
"through the same path as the web receipt uploader.",
|
|
625
1277
|
},
|
|
626
1278
|
},
|
|
627
|
-
//
|
|
628
|
-
//
|
|
1279
|
+
// None is individually required: the server accepts uploadRef, photo,
|
|
1280
|
+
// or the legacy photoBase64 fallback and returns a clear error when it
|
|
1281
|
+
// gets none.
|
|
629
1282
|
// Keeping photo in `required` would reintroduce the original failure --
|
|
630
1283
|
// the client rejecting the call locally when a model omits base64, so
|
|
631
1284
|
// nothing ever reaches the server and no diagnostic is recorded.
|
|
@@ -634,6 +1287,7 @@ const TOOLS = [
|
|
|
634
1287
|
},
|
|
635
1288
|
{
|
|
636
1289
|
name: "get_last_receipt_result",
|
|
1290
|
+
outputSchema: GET_LAST_RECEIPT_RESULT_OUTPUT_SCHEMA,
|
|
637
1291
|
description:
|
|
638
1292
|
"Check the authoritative final outcome of a receipt image/PDF batch submitted " +
|
|
639
1293
|
"with submit_receipt. After submit_receipt returns submissionId, call this " +
|
|
@@ -642,6 +1296,7 @@ const TOOLS = [
|
|
|
642
1296
|
"batches allow longer. A pending result is normal and must not trigger a " +
|
|
643
1297
|
"duplicate resubmission. Returns added, duplicate, skipped, or " +
|
|
644
1298
|
"errored verdicts with exact counts and up to 10 processed receipt summaries. " +
|
|
1299
|
+
"found:false is pending and has no terminal verdict; found:true is terminal. " +
|
|
645
1300
|
"On completion, tell the user what happened and show spreadsheetUrl plus " +
|
|
646
1301
|
"reviewExpensesUrl. This is for uploaded receipts; use get_scan_status for " +
|
|
647
1302
|
"Gmail scans. Read-only.",
|
|
@@ -861,7 +1516,10 @@ const TOOLS = [
|
|
|
861
1516
|
type: "string",
|
|
862
1517
|
description: "Tag for client/project attribution (optional)",
|
|
863
1518
|
},
|
|
864
|
-
notes: {
|
|
1519
|
+
notes: {
|
|
1520
|
+
type: "string",
|
|
1521
|
+
description: "Optional user-supplied context stored with the mileage entry.",
|
|
1522
|
+
},
|
|
865
1523
|
},
|
|
866
1524
|
required: ["distance", "purpose"],
|
|
867
1525
|
},
|
|
@@ -926,10 +1584,16 @@ const TOOLS = [
|
|
|
926
1584
|
type: "object",
|
|
927
1585
|
properties: {
|
|
928
1586
|
photo: {
|
|
1587
|
+
...OPENAI_FILE_REFERENCE_SCHEMA,
|
|
1588
|
+
description:
|
|
1589
|
+
"Attached image or PDF supplied by ChatGPT for step 1. The server downloads and " +
|
|
1590
|
+
"parses the attachment securely.",
|
|
1591
|
+
},
|
|
1592
|
+
photoBase64: {
|
|
929
1593
|
type: "string",
|
|
930
1594
|
description:
|
|
931
|
-
"
|
|
932
|
-
"
|
|
1595
|
+
"Legacy fallback for MCP clients that send complete image/PDF bytes as base64. " +
|
|
1596
|
+
"ChatGPT should use photo.",
|
|
933
1597
|
},
|
|
934
1598
|
mimeType: {
|
|
935
1599
|
type: "string",
|
|
@@ -988,7 +1652,12 @@ const TOOLS = [
|
|
|
988
1652
|
type: "object",
|
|
989
1653
|
properties: {
|
|
990
1654
|
index: { type: "integer", description: "Preview row index" },
|
|
991
|
-
fields: {
|
|
1655
|
+
fields: {
|
|
1656
|
+
type: "object",
|
|
1657
|
+
additionalProperties: true,
|
|
1658
|
+
description:
|
|
1659
|
+
"Only the user-approved income fields to replace on this staged row: date, source, amount, currency, category, paymentMethod, description, notes, reference, fees, taxCollected, or tag.",
|
|
1660
|
+
},
|
|
992
1661
|
},
|
|
993
1662
|
required: ["index", "fields"],
|
|
994
1663
|
},
|
|
@@ -1023,10 +1692,16 @@ const TOOLS = [
|
|
|
1023
1692
|
type: "object",
|
|
1024
1693
|
properties: {
|
|
1025
1694
|
csvContent: {
|
|
1695
|
+
...OPENAI_FILE_REFERENCE_SCHEMA,
|
|
1696
|
+
description:
|
|
1697
|
+
"Attached CSV/TSV/text file supplied by ChatGPT for step 1. The server downloads " +
|
|
1698
|
+
"and decodes the attachment securely.",
|
|
1699
|
+
},
|
|
1700
|
+
csvText: {
|
|
1026
1701
|
type: "string",
|
|
1027
1702
|
description:
|
|
1028
|
-
"
|
|
1029
|
-
"
|
|
1703
|
+
"Legacy fallback for MCP clients that send raw CSV/TSV/text content inline. " +
|
|
1704
|
+
"ChatGPT should use csvContent.",
|
|
1030
1705
|
},
|
|
1031
1706
|
paymentMethod: {
|
|
1032
1707
|
type: "string",
|
|
@@ -1073,7 +1748,12 @@ const TOOLS = [
|
|
|
1073
1748
|
type: "object",
|
|
1074
1749
|
properties: {
|
|
1075
1750
|
index: { type: "integer", description: "Preview row index" },
|
|
1076
|
-
fields: {
|
|
1751
|
+
fields: {
|
|
1752
|
+
type: "object",
|
|
1753
|
+
additionalProperties: true,
|
|
1754
|
+
description:
|
|
1755
|
+
"Only the user-approved income fields to replace on this staged row: date, source, amount, currency, category, paymentMethod, description, notes, reference, fees, taxCollected, or tag.",
|
|
1756
|
+
},
|
|
1077
1757
|
},
|
|
1078
1758
|
required: ["index", "fields"],
|
|
1079
1759
|
},
|
|
@@ -1090,20 +1770,23 @@ const TOOLS = [
|
|
|
1090
1770
|
},
|
|
1091
1771
|
{
|
|
1092
1772
|
name: "get_accounting_integration_status",
|
|
1773
|
+
outputSchema: GET_ACCOUNTING_INTEGRATION_STATUS_OUTPUT_SCHEMA,
|
|
1093
1774
|
description:
|
|
1094
|
-
"Check whether an accounting destination is connected and
|
|
1095
|
-
"
|
|
1096
|
-
"state, and
|
|
1775
|
+
"Check whether an accounting destination is connected and read-only setup state for the " +
|
|
1776
|
+
"owner. Returns the selected organization/company/business, stored connection state, rollout " +
|
|
1777
|
+
"state, and the single setup link for connecting or reconnecting the destination. When an existing ExpenseBot report is available, " +
|
|
1097
1778
|
"pass reportId so the link opens that exact report's provider setup control instead of the " +
|
|
1098
|
-
"general Reports setup. This is read-only and never posts accounting data. " +
|
|
1099
|
-
"
|
|
1779
|
+
"general Reports setup. This is read-only and never posts accounting data. Agent-driven posting " +
|
|
1780
|
+
"is currently available only for Zoho Books (zoho_books); QuickBooks Online (quickbooks), Xero " +
|
|
1781
|
+
"(xero), Wave (wave), and FreeAgent (freeagent, beta) are accepted here for connection/setup " +
|
|
1782
|
+
"status only and report writesAuthorized=false until their canonical planning path is shared.",
|
|
1100
1783
|
inputSchema: {
|
|
1101
1784
|
type: "object",
|
|
1102
1785
|
properties: {
|
|
1103
1786
|
provider: {
|
|
1104
1787
|
type: "string",
|
|
1105
|
-
enum: ["zoho_books"],
|
|
1106
|
-
description: "Accounting destination provider.",
|
|
1788
|
+
enum: ["zoho_books", "quickbooks", "xero", "wave", "freeagent"],
|
|
1789
|
+
description: "Accounting destination provider. QuickBooks Online, Xero, Wave, FreeAgent (beta), or Zoho Books.",
|
|
1107
1790
|
},
|
|
1108
1791
|
reportId: {
|
|
1109
1792
|
type: "string",
|
|
@@ -1121,19 +1804,23 @@ const TOOLS = [
|
|
|
1121
1804
|
"Review and then post an ExpenseBot report to the owner's accounting destination. " +
|
|
1122
1805
|
"STEP 1: call with provider, reportId, and optional mode/mappings, without confirm. The " +
|
|
1123
1806
|
"server reads the live report and destination, applies Omit/Personal/split/date/currency " +
|
|
1124
|
-
"rules, checks bank-feed matches, and returns the complete proposal plus proposalId. " +
|
|
1807
|
+
"rules, checks Zoho bank-feed matches, and returns the complete proposal plus proposalId. " +
|
|
1125
1808
|
"NOTHING is posted in step 1. Show the complete proposal and ask for approval. STEP 2: " +
|
|
1126
1809
|
"call with only provider, proposalId, and confirm:true. The server posts only the frozen, " +
|
|
1127
1810
|
"account-bound proposal, revalidates live state, and rejects changed reports or mappings. " +
|
|
1128
1811
|
"Never add mapping fields to the confirmation call. Owner accounts only; acting for a " +
|
|
1129
|
-
"client is not supported.
|
|
1812
|
+
"client is not supported. Agent-driven posting is currently available only for Zoho Books " +
|
|
1813
|
+
"(zoho_books); QuickBooks Online, Xero, Wave, and FreeAgent are intentionally not accepted " +
|
|
1814
|
+
"by this tool yet because their previews cannot freeze/revalidate the canonical provider " +
|
|
1815
|
+
"plan that shareReport executes. Use those providers' web flows until they satisfy the " +
|
|
1816
|
+
"full push contract.",
|
|
1130
1817
|
inputSchema: {
|
|
1131
1818
|
type: "object",
|
|
1132
1819
|
properties: {
|
|
1133
1820
|
provider: {
|
|
1134
1821
|
type: "string",
|
|
1135
1822
|
enum: ["zoho_books"],
|
|
1136
|
-
description: "Accounting destination provider.",
|
|
1823
|
+
description: "Accounting destination provider. Agent-driven posting is currently available only for Zoho Books.",
|
|
1137
1824
|
},
|
|
1138
1825
|
reportId: {
|
|
1139
1826
|
type: "string",
|
|
@@ -1142,7 +1829,7 @@ const TOOLS = [
|
|
|
1142
1829
|
mode: {
|
|
1143
1830
|
type: "string",
|
|
1144
1831
|
enum: ["auto", "expense", "bill"],
|
|
1145
|
-
description: "Step 1 only: automatic document treatment, paid expenses, or bills.",
|
|
1832
|
+
description: "Step 1 only (Zoho Books): automatic document treatment, paid expenses, or bills.",
|
|
1146
1833
|
},
|
|
1147
1834
|
accountMappings: {
|
|
1148
1835
|
type: "object",
|
|
@@ -1159,8 +1846,14 @@ const TOOLS = [
|
|
|
1159
1846
|
additionalProperties: {
|
|
1160
1847
|
type: "object",
|
|
1161
1848
|
properties: {
|
|
1162
|
-
tagId: {
|
|
1163
|
-
|
|
1849
|
+
tagId: {
|
|
1850
|
+
type: "string",
|
|
1851
|
+
description: "Live accounting-provider reporting-tag ID returned in the step-1 proposal.",
|
|
1852
|
+
},
|
|
1853
|
+
optionId: {
|
|
1854
|
+
type: "string",
|
|
1855
|
+
description: "Live option ID belonging to tagId, returned in the step-1 proposal.",
|
|
1856
|
+
},
|
|
1164
1857
|
},
|
|
1165
1858
|
required: ["tagId", "optionId"],
|
|
1166
1859
|
},
|
|
@@ -1184,21 +1877,33 @@ const TOOLS = [
|
|
|
1184
1877
|
},
|
|
1185
1878
|
{
|
|
1186
1879
|
name: "get_accounting_push_status",
|
|
1880
|
+
outputSchema: GET_ACCOUNTING_PUSH_STATUS_OUTPUT_SCHEMA,
|
|
1187
1881
|
description:
|
|
1188
|
-
"Read the
|
|
1882
|
+
"Read the authoritative posting and reconciliation status for one ExpenseBot report at an " +
|
|
1189
1883
|
"accounting destination. Use after a timeout or uncertain response before considering any " +
|
|
1190
|
-
"retry.
|
|
1884
|
+
"retry. Returns status, submission time, posting mode, posted receipt count, any public error, " +
|
|
1885
|
+
"and whether reconciliation is required. Never re-post a completed report or a report marked " +
|
|
1886
|
+
"needs_reconciliation; show that state to the owner instead. This tool is read-only and " +
|
|
1887
|
+
"owner-account only.",
|
|
1191
1888
|
inputSchema: {
|
|
1192
1889
|
type: "object",
|
|
1193
1890
|
properties: {
|
|
1194
|
-
provider: {
|
|
1195
|
-
|
|
1891
|
+
provider: {
|
|
1892
|
+
type: "string",
|
|
1893
|
+
enum: ["zoho_books", "quickbooks", "xero", "wave", "freeagent"],
|
|
1894
|
+
description: "Accounting destination provider used for the prior posting attempt.",
|
|
1895
|
+
},
|
|
1896
|
+
reportId: {
|
|
1897
|
+
type: "string",
|
|
1898
|
+
description: "Exact ExpenseBot report ID from the prior proposal or posting attempt.",
|
|
1899
|
+
},
|
|
1196
1900
|
},
|
|
1197
1901
|
required: ["provider", "reportId"],
|
|
1198
1902
|
},
|
|
1199
1903
|
},
|
|
1200
1904
|
{
|
|
1201
1905
|
name: "list_categories",
|
|
1906
|
+
outputSchema: LIST_CATEGORIES_OUTPUT_SCHEMA,
|
|
1202
1907
|
description:
|
|
1203
1908
|
"List the user's configured expense categories and billing accounts. " +
|
|
1204
1909
|
"Use this BEFORE calling tools that need a category (add_cash_expense, " +
|
|
@@ -1208,6 +1913,7 @@ const TOOLS = [
|
|
|
1208
1913
|
},
|
|
1209
1914
|
{
|
|
1210
1915
|
name: "list_tags",
|
|
1916
|
+
outputSchema: LIST_TAGS_OUTPUT_SCHEMA,
|
|
1211
1917
|
description:
|
|
1212
1918
|
"List the user's configured groups. ExpenseBot stores clients, projects, " +
|
|
1213
1919
|
"project codes, properties, and trips as tags (for example 'Client: " +
|
|
@@ -1224,6 +1930,7 @@ const TOOLS = [
|
|
|
1224
1930
|
// surface them in completions when users ask income/profit questions.
|
|
1225
1931
|
{
|
|
1226
1932
|
name: "get_income_summary",
|
|
1933
|
+
outputSchema: ANALYTICS_QUERY_OUTPUT_SCHEMA,
|
|
1227
1934
|
description:
|
|
1228
1935
|
"Get income totals, breakdowns, and analytics from the Income tab. " +
|
|
1229
1936
|
"Covers Schedule C / T2125 income, Schedule B drill-in (interest, " +
|
|
@@ -1262,6 +1969,7 @@ const TOOLS = [
|
|
|
1262
1969
|
},
|
|
1263
1970
|
{
|
|
1264
1971
|
name: "get_pnl",
|
|
1972
|
+
outputSchema: ANALYTICS_QUERY_OUTPUT_SCHEMA,
|
|
1265
1973
|
description:
|
|
1266
1974
|
"Compute Profit & Loss (P&L / net income / margin) by combining the " +
|
|
1267
1975
|
"Income tab with expense tabs. Examples: 'am I profitable this " +
|
|
@@ -1286,6 +1994,7 @@ const TOOLS = [
|
|
|
1286
1994
|
},
|
|
1287
1995
|
{
|
|
1288
1996
|
name: "get_per_tag_pnl",
|
|
1997
|
+
outputSchema: ANALYTICS_QUERY_OUTPUT_SCHEMA,
|
|
1289
1998
|
description:
|
|
1290
1999
|
"Per-tag P&L — revenue, cost, profit, and margin grouped by tag " +
|
|
1291
2000
|
"(per-client, per-property, per-event, per-realtor-deal). Requires " +
|
|
@@ -1315,6 +2024,7 @@ const TOOLS = [
|
|
|
1315
2024
|
},
|
|
1316
2025
|
{
|
|
1317
2026
|
name: "list_income_categories",
|
|
2027
|
+
outputSchema: LIST_INCOME_CATEGORIES_OUTPUT_SCHEMA,
|
|
1318
2028
|
description:
|
|
1319
2029
|
"List ExpenseBot's fixed income tax categories. Unlike Expense Accounts, " +
|
|
1320
2030
|
"these are not user-configured. Use this BEFORE calling add_income so " +
|
|
@@ -1323,6 +2033,7 @@ const TOOLS = [
|
|
|
1323
2033
|
},
|
|
1324
2034
|
{
|
|
1325
2035
|
name: "get_recent_activity",
|
|
2036
|
+
outputSchema: GET_RECENT_ACTIVITY_OUTPUT_SCHEMA,
|
|
1326
2037
|
description:
|
|
1327
2038
|
"Show what the user (or their AI assistants) has recently done in " +
|
|
1328
2039
|
"ExpenseBot via this MCP server: which tools were called, when, with " +
|
|
@@ -1410,6 +2121,7 @@ const TOOLS = [
|
|
|
1410
2121
|
// questions instead of the generic get_spending_summary.
|
|
1411
2122
|
{
|
|
1412
2123
|
name: "get_mileage_summary",
|
|
2124
|
+
outputSchema: GET_MILEAGE_SUMMARY_OUTPUT_SCHEMA,
|
|
1413
2125
|
description:
|
|
1414
2126
|
"Mileage analytics — totals, breakdowns by month / client / " +
|
|
1415
2127
|
"purpose / category, plus deduction framing (cents-per-mile or " +
|
|
@@ -1438,6 +2150,7 @@ const TOOLS = [
|
|
|
1438
2150
|
},
|
|
1439
2151
|
{
|
|
1440
2152
|
name: "get_subscription_audit",
|
|
2153
|
+
outputSchema: GET_SUBSCRIPTION_AUDIT_OUTPUT_SCHEMA,
|
|
1441
2154
|
description:
|
|
1442
2155
|
"Subscription audit — wraps the Subscription Auditor engine to " +
|
|
1443
2156
|
"find recurring charges, duplicates, price increases, and " +
|
|
@@ -1467,6 +2180,7 @@ const TOOLS = [
|
|
|
1467
2180
|
// ── Read-only mutation helpers + onboarding (v0.7.0) ─────────────────
|
|
1468
2181
|
{
|
|
1469
2182
|
name: "get_expense_by_id",
|
|
2183
|
+
outputSchema: GET_EXPENSE_BY_ID_OUTPUT_SCHEMA,
|
|
1470
2184
|
description:
|
|
1471
2185
|
"Fetch a single expense row by its sheet row number or by its " +
|
|
1472
2186
|
"ExpenseBot expenseId (the exact Receipt ID in Column Q). Returns the row's " +
|
|
@@ -1505,6 +2219,7 @@ const TOOLS = [
|
|
|
1505
2219
|
},
|
|
1506
2220
|
{
|
|
1507
2221
|
name: "get_spreadsheet_url",
|
|
2222
|
+
outputSchema: GET_SPREADSHEET_URL_OUTPUT_SCHEMA,
|
|
1508
2223
|
description:
|
|
1509
2224
|
"Return the user's master ExpenseBot Google Sheet plus authenticated " +
|
|
1510
2225
|
"ExpenseBot workspace links, each with a label and a description of when " +
|
|
@@ -1521,6 +2236,15 @@ const TOOLS = [
|
|
|
1521
2236
|
"or General Settings link. Category, G/L, and account-code requests use " +
|
|
1522
2237
|
"Category management; client, project, and trip groups use Group " +
|
|
1523
2238
|
"management; questions about what counts as Personal use Personal rules. " +
|
|
2239
|
+
"For client billing setup, use the returned clientBillingHandoffs instead " +
|
|
2240
|
+
"of giving a generic dashboard tour: manageClients creates or manages the " +
|
|
2241
|
+
"client list, tagReadyExpenses opens Review Expenses filtered to blank or " +
|
|
2242
|
+
"default-Business rows, and createClientReport opens report creation by " +
|
|
2243
|
+
"group after expenses have been assigned. Choose the one next step that " +
|
|
2244
|
+
"matches the user's current state. If the user names a client and an exact " +
|
|
2245
|
+
"expense scope and asks the assistant to do the work, use search_expenses " +
|
|
2246
|
+
"and group_expenses instead; show its grounded preview and require explicit " +
|
|
2247
|
+
"confirmation before changing any rows. " +
|
|
1524
2248
|
"When the user asks to choose receipt images from Google Photos, use the " +
|
|
1525
2249
|
"returned Google Photos link; it opens the existing authenticated picker " +
|
|
1526
2250
|
"and handles any required Google consent in ExpenseBot. When they ask " +
|
|
@@ -1557,6 +2281,7 @@ const TOOLS = [
|
|
|
1557
2281
|
},
|
|
1558
2282
|
{
|
|
1559
2283
|
name: "check_feature",
|
|
2284
|
+
outputSchema: CHECK_OUTPUT_SCHEMA,
|
|
1560
2285
|
description:
|
|
1561
2286
|
"Check whether ExpenseBot supports a specific feature ('does ExpenseBot " +
|
|
1562
2287
|
"support X', 'can it integrate with Y'). Searches the public knowledge " +
|
|
@@ -1602,6 +2327,7 @@ const TOOLS = [
|
|
|
1602
2327
|
// "estimates — confirm with your tax professional" in their response.
|
|
1603
2328
|
{
|
|
1604
2329
|
name: "whatif_afford",
|
|
2330
|
+
outputSchema: WHATIF_OUTPUT_SCHEMA,
|
|
1605
2331
|
description:
|
|
1606
2332
|
"Can I afford $X/month? Recomputes the user's Safe Monthly Draw " +
|
|
1607
2333
|
"(how much they can safely pay themselves) with an added recurring " +
|
|
@@ -1624,6 +2350,7 @@ const TOOLS = [
|
|
|
1624
2350
|
},
|
|
1625
2351
|
{
|
|
1626
2352
|
name: "whatif_client",
|
|
2353
|
+
outputSchema: WHATIF_OUTPUT_SCHEMA,
|
|
1627
2354
|
description:
|
|
1628
2355
|
"What if a client pays late or leaves? mode='late30' shifts that " +
|
|
1629
2356
|
"client's OPEN invoice amounts out of the near-term expectation " +
|
|
@@ -1652,6 +2379,7 @@ const TOOLS = [
|
|
|
1652
2379
|
},
|
|
1653
2380
|
{
|
|
1654
2381
|
name: "whatif_tax_setaside",
|
|
2382
|
+
outputSchema: WHATIF_OUTPUT_SCHEMA,
|
|
1655
2383
|
description:
|
|
1656
2384
|
"What should I set aside for taxes? Surfaces the same monthly tax " +
|
|
1657
2385
|
"set-aside estimate already computed for Safe Monthly Draw — wiring, " +
|
|
@@ -1697,6 +2425,7 @@ const TOOLS = [
|
|
|
1697
2425
|
},
|
|
1698
2426
|
{
|
|
1699
2427
|
name: "get_scan_status",
|
|
2428
|
+
outputSchema: GET_SCAN_STATUS_OUTPUT_SCHEMA,
|
|
1700
2429
|
description:
|
|
1701
2430
|
"Check the authoritative status of the user's Gmail receipt scans. " +
|
|
1702
2431
|
"Returns the active scan lock, the same live phase and item progress " +
|
|
@@ -1710,20 +2439,22 @@ const TOOLS = [
|
|
|
1710
2439
|
},
|
|
1711
2440
|
{
|
|
1712
2441
|
name: "list_client_invoices",
|
|
2442
|
+
outputSchema: LIST_CLIENT_INVOICES_OUTPUT_SCHEMA,
|
|
1713
2443
|
description:
|
|
1714
2444
|
"List the user's issued client invoices (accounts receivable) — who owes " +
|
|
1715
2445
|
"them money, how much, and when it is due. Examples: 'which invoices are " +
|
|
1716
2446
|
"outstanding', 'what does Acme still owe me', 'any overdue invoices', " +
|
|
1717
|
-
"'how much am I waiting to get paid'. status accepts '
|
|
1718
|
-
"'
|
|
2447
|
+
"'how much am I waiting to get paid'. status accepts 'active' (default), " +
|
|
2448
|
+
"'open', 'overdue', 'needs_review', 'paid', 'void', 'superseded', or 'all'. " +
|
|
2449
|
+
"Returns invoice numbers, status, totals by currency, delivery state, and private document links. Read-only.",
|
|
1719
2450
|
inputSchema: {
|
|
1720
2451
|
type: "object",
|
|
1721
2452
|
properties: {
|
|
1722
2453
|
clientEmail: CLIENT_EMAIL_SCHEMA,
|
|
1723
2454
|
status: {
|
|
1724
2455
|
type: "string",
|
|
1725
|
-
enum: ["open", "paid", "all"],
|
|
1726
|
-
description: "Filter by invoice status (default
|
|
2456
|
+
enum: ["active", "open", "overdue", "needs_review", "paid", "void", "superseded", "all"],
|
|
2457
|
+
description: "Filter by invoice status (default active/outstanding).",
|
|
1727
2458
|
},
|
|
1728
2459
|
clientName: {
|
|
1729
2460
|
type: "string",
|
|
@@ -1736,8 +2467,157 @@ const TOOLS = [
|
|
|
1736
2467
|
},
|
|
1737
2468
|
},
|
|
1738
2469
|
},
|
|
2470
|
+
{
|
|
2471
|
+
name: "get_client_invoice",
|
|
2472
|
+
outputSchema: GET_CLIENT_INVOICE_OUTPUT_SCHEMA,
|
|
2473
|
+
description:
|
|
2474
|
+
"Get the full financial and delivery summary for one issued client invoice, " +
|
|
2475
|
+
"including subtotal, markup, tax, advance applied, balance due, dates, status, " +
|
|
2476
|
+
"source report, and private Google Doc/PDF/DOCX links when available. Provide " +
|
|
2477
|
+
"invoiceId or invoiceNumber — one is required; invoiceNumber is accepted only " +
|
|
2478
|
+
"when it is unique. Read-only.",
|
|
2479
|
+
inputSchema: {
|
|
2480
|
+
type: "object",
|
|
2481
|
+
properties: {
|
|
2482
|
+
clientEmail: CLIENT_EMAIL_SCHEMA,
|
|
2483
|
+
invoiceId: {
|
|
2484
|
+
type: "string",
|
|
2485
|
+
description: "Stable invoice ID from list_client_invoices. Required unless invoiceNumber is supplied.",
|
|
2486
|
+
},
|
|
2487
|
+
invoiceNumber: {
|
|
2488
|
+
type: "string",
|
|
2489
|
+
description: "Human invoice number when invoiceId is unavailable; it must identify one unique invoice.",
|
|
2490
|
+
},
|
|
2491
|
+
},
|
|
2492
|
+
},
|
|
2493
|
+
},
|
|
2494
|
+
{
|
|
2495
|
+
name: "prepare_client_invoice",
|
|
2496
|
+
description:
|
|
2497
|
+
"Prepare a client invoice from a saved ExpenseBot report without creating it. " +
|
|
2498
|
+
"Reads canonical report rows, allocates a unique invoice number, verifies the " +
|
|
2499
|
+
"client ledger identity and advance, and returns exact totals plus a short-lived " +
|
|
2500
|
+
"preparationId. Call this first, show the preview to the user, then call " +
|
|
2501
|
+
"create_client_invoice after explicit confirmation. It reserves the invoice number " +
|
|
2502
|
+
"and preview for 30 minutes but creates no invoice, document, Income row, email, or payment.",
|
|
2503
|
+
inputSchema: {
|
|
2504
|
+
type: "object",
|
|
2505
|
+
properties: {
|
|
2506
|
+
reportId: { type: "string", description: "Saved ExpenseBot report ID to invoice." },
|
|
2507
|
+
clientName: { type: "string", description: "Full client or business name shown on the invoice." },
|
|
2508
|
+
issueDate: { type: "string", format: "date", description: "Calendar-valid invoice date in YYYY-MM-DD format." },
|
|
2509
|
+
receiptIds: { type: "array", items: { type: "string" }, description: "Optional exact report receipt IDs. Defaults to every current report expense." },
|
|
2510
|
+
invoiceNumber: { type: "string", description: "Optional custom invoice number. ExpenseBot allocates one when omitted." },
|
|
2511
|
+
paymentTerms: {
|
|
2512
|
+
type: "string",
|
|
2513
|
+
enum: ["due_on_receipt", "net7", "net14", "net15", "net30", "net45", "net60"],
|
|
2514
|
+
description: "Invoice due terms. Defaults to the client's billing profile or net30.",
|
|
2515
|
+
},
|
|
2516
|
+
clientAddress: {
|
|
2517
|
+
type: "string",
|
|
2518
|
+
description: "Optional billing address printed in the invoice's Bill To section.",
|
|
2519
|
+
},
|
|
2520
|
+
billToEmail: { type: "string", description: "Optional client email printed on the invoice. This does not send email." },
|
|
2521
|
+
markupPct: { type: "number", minimum: 0, maximum: 100, description: "Markup applied only to rebilled expense rows." },
|
|
2522
|
+
taxPct: {
|
|
2523
|
+
type: "number",
|
|
2524
|
+
minimum: 0,
|
|
2525
|
+
maximum: 100,
|
|
2526
|
+
description: "Tax percentage applied after markup and custom line items; use 0 for no tax.",
|
|
2527
|
+
},
|
|
2528
|
+
taxLabel: { type: "string", description: "Tax label such as HST, GST, or VAT." },
|
|
2529
|
+
advanceApplied: { type: "number", minimum: 0, description: "Verified client advance to apply against this invoice." },
|
|
2530
|
+
customLineItems: {
|
|
2531
|
+
type: "array",
|
|
2532
|
+
maxItems: 25,
|
|
2533
|
+
items: {
|
|
2534
|
+
type: "object",
|
|
2535
|
+
properties: {
|
|
2536
|
+
description: {
|
|
2537
|
+
type: "string",
|
|
2538
|
+
description: "User-approved fee or service description shown on the invoice.",
|
|
2539
|
+
},
|
|
2540
|
+
amount: {
|
|
2541
|
+
type: "number",
|
|
2542
|
+
exclusiveMinimum: 0,
|
|
2543
|
+
description: "Positive amount for this fee or service line in the invoice currency.",
|
|
2544
|
+
},
|
|
2545
|
+
},
|
|
2546
|
+
required: ["description", "amount"],
|
|
2547
|
+
},
|
|
2548
|
+
description: "Optional fee/service lines. They are taxed but never marked up.",
|
|
2549
|
+
},
|
|
2550
|
+
mentionSupportingReceipts: {
|
|
2551
|
+
type: "boolean",
|
|
2552
|
+
description: "When true, note on the invoice that supporting receipts are available.",
|
|
2553
|
+
},
|
|
2554
|
+
},
|
|
2555
|
+
required: ["reportId", "clientName", "issueDate"],
|
|
2556
|
+
},
|
|
2557
|
+
},
|
|
2558
|
+
{
|
|
2559
|
+
name: "create_client_invoice",
|
|
2560
|
+
description:
|
|
2561
|
+
"Create the exact invoice previously returned by prepare_client_invoice. This is " +
|
|
2562
|
+
"a confirmed write: it revalidates the report snapshot and client identity, creates " +
|
|
2563
|
+
"a private editable Google Doc plus private PDF and DOCX copies, records the issued " +
|
|
2564
|
+
"invoice, and supersedes an older active invoice for the same report. It does not " +
|
|
2565
|
+
"send email or create an Income row. If tax is positive, confirmTax must be true.",
|
|
2566
|
+
inputSchema: {
|
|
2567
|
+
type: "object",
|
|
2568
|
+
properties: {
|
|
2569
|
+
preparationId: { type: "string", description: "Short-lived ID returned by prepare_client_invoice." },
|
|
2570
|
+
reportId: { type: "string", description: "In in-app chat, the saved report ID to prepare and confirm." },
|
|
2571
|
+
clientName: { type: "string", description: "In in-app chat, the full client name shown on the invoice." },
|
|
2572
|
+
issueDate: { type: "string", format: "date", description: "In in-app chat, a calendar-valid YYYY-MM-DD invoice date." },
|
|
2573
|
+
receiptIds: { type: "array", items: { type: "string" } },
|
|
2574
|
+
invoiceNumber: { type: "string" },
|
|
2575
|
+
paymentTerms: { type: "string", enum: ["due_on_receipt", "net7", "net14", "net15", "net30", "net45", "net60"] },
|
|
2576
|
+
clientAddress: { type: "string" },
|
|
2577
|
+
billToEmail: { type: "string" },
|
|
2578
|
+
markupPct: { type: "number", minimum: 0, maximum: 100 },
|
|
2579
|
+
taxPct: { type: "number", minimum: 0, maximum: 100 },
|
|
2580
|
+
taxLabel: { type: "string" },
|
|
2581
|
+
advanceApplied: { type: "number", minimum: 0 },
|
|
2582
|
+
customLineItems: {
|
|
2583
|
+
type: "array",
|
|
2584
|
+
maxItems: 25,
|
|
2585
|
+
items: {
|
|
2586
|
+
type: "object",
|
|
2587
|
+
properties: {
|
|
2588
|
+
description: { type: "string" },
|
|
2589
|
+
amount: { type: "number", exclusiveMinimum: 0 },
|
|
2590
|
+
},
|
|
2591
|
+
required: ["description", "amount"],
|
|
2592
|
+
},
|
|
2593
|
+
},
|
|
2594
|
+
mentionSupportingReceipts: { type: "boolean" },
|
|
2595
|
+
confirmTax: { type: "boolean", description: "True only after the user confirms the displayed tax label and rate." },
|
|
2596
|
+
operationId: { type: "string", description: "Optional retry key. Reuse it after an uncertain response." },
|
|
2597
|
+
},
|
|
2598
|
+
},
|
|
2599
|
+
},
|
|
2600
|
+
{
|
|
2601
|
+
name: "mark_client_invoice_paid",
|
|
2602
|
+
description:
|
|
2603
|
+
"Mark an issued client invoice as paid after explicit confirmation. Requires " +
|
|
2604
|
+
"a strict calendar-valid paidDate in YYYY-MM-DD format. This updates the " +
|
|
2605
|
+
"accounts-receivable invoice record only; it never creates or moves an Income " +
|
|
2606
|
+
"row. Record the actual payment separately or link an existing Income row.",
|
|
2607
|
+
inputSchema: {
|
|
2608
|
+
type: "object",
|
|
2609
|
+
properties: {
|
|
2610
|
+
invoiceId: { type: "string", description: "Stable invoice ID from list_client_invoices." },
|
|
2611
|
+
paidDate: { type: "string", format: "date", description: "Calendar-valid payment date in YYYY-MM-DD format." },
|
|
2612
|
+
paidAmount: { type: "number", minimum: 0, description: "Optional amount received." },
|
|
2613
|
+
paidVia: { type: "string", description: "Optional payment method or source, such as bank transfer or check." },
|
|
2614
|
+
},
|
|
2615
|
+
required: ["invoiceId", "paidDate"],
|
|
2616
|
+
},
|
|
2617
|
+
},
|
|
1739
2618
|
{
|
|
1740
2619
|
name: "get_expense_splits",
|
|
2620
|
+
outputSchema: GET_EXPENSE_SPLITS_OUTPUT_SCHEMA,
|
|
1741
2621
|
description:
|
|
1742
2622
|
"Show how an expense was split across categories, clients, properties, or " +
|
|
1743
2623
|
"business vs personal portions. Returns the single parent payment with its " +
|
|
@@ -1755,15 +2635,18 @@ const TOOLS = [
|
|
|
1755
2635
|
},
|
|
1756
2636
|
dateRange: {
|
|
1757
2637
|
description:
|
|
1758
|
-
"Optional window to search for split expenses.
|
|
2638
|
+
"Optional open-ended or closed window to search for split expenses. Supply startDate, endDate, or both; supplied bounds are inclusive YYYY-MM-DD dates.",
|
|
1759
2639
|
type: "object",
|
|
2640
|
+
additionalProperties: false,
|
|
1760
2641
|
properties: {
|
|
1761
2642
|
startDate: {
|
|
1762
2643
|
type: "string",
|
|
2644
|
+
format: "date",
|
|
1763
2645
|
description: "Inclusive start date in YYYY-MM-DD format.",
|
|
1764
2646
|
},
|
|
1765
2647
|
endDate: {
|
|
1766
2648
|
type: "string",
|
|
2649
|
+
format: "date",
|
|
1767
2650
|
description: "Inclusive end date in YYYY-MM-DD format.",
|
|
1768
2651
|
},
|
|
1769
2652
|
},
|
|
@@ -1782,6 +2665,7 @@ const TOOLS = [
|
|
|
1782
2665
|
},
|
|
1783
2666
|
{
|
|
1784
2667
|
name: "get_monthly_books_review",
|
|
2668
|
+
outputSchema: GET_MONTHLY_BOOKS_REVIEW_OUTPUT_SCHEMA,
|
|
1785
2669
|
description:
|
|
1786
2670
|
"Month-end summary of the user's books for one calendar month: income " +
|
|
1787
2671
|
"recorded, money spent, net, top spending categories and merchants, plus " +
|
|
@@ -1805,6 +2689,7 @@ const TOOLS = [
|
|
|
1805
2689
|
},
|
|
1806
2690
|
{
|
|
1807
2691
|
name: "get_credits_refunds",
|
|
2692
|
+
outputSchema: GET_CREDITS_REFUNDS_OUTPUT_SCHEMA,
|
|
1808
2693
|
description:
|
|
1809
2694
|
"List card refunds, cashback/rewards, and statement credits that " +
|
|
1810
2695
|
"ExpenseBot has already recorded — either as negative expenses or matched " +
|
|
@@ -1818,15 +2703,18 @@ const TOOLS = [
|
|
|
1818
2703
|
clientEmail: CLIENT_EMAIL_SCHEMA,
|
|
1819
2704
|
dateRange: {
|
|
1820
2705
|
description:
|
|
1821
|
-
"Optional window to narrow results.
|
|
2706
|
+
"Optional open-ended or closed window to narrow results. Supply startDate, endDate, or both; supplied bounds are inclusive YYYY-MM-DD dates.",
|
|
1822
2707
|
type: "object",
|
|
2708
|
+
additionalProperties: false,
|
|
1823
2709
|
properties: {
|
|
1824
2710
|
startDate: {
|
|
1825
2711
|
type: "string",
|
|
2712
|
+
format: "date",
|
|
1826
2713
|
description: "Inclusive start date in YYYY-MM-DD format.",
|
|
1827
2714
|
},
|
|
1828
2715
|
endDate: {
|
|
1829
2716
|
type: "string",
|
|
2717
|
+
format: "date",
|
|
1830
2718
|
description: "Inclusive end date in YYYY-MM-DD format.",
|
|
1831
2719
|
},
|
|
1832
2720
|
},
|
|
@@ -1840,9 +2728,10 @@ const TOOLS = [
|
|
|
1840
2728
|
},
|
|
1841
2729
|
{
|
|
1842
2730
|
name: "get_client_advance_balances",
|
|
2731
|
+
outputSchema: GET_CLIENT_ADVANCE_BALANCES_OUTPUT_SCHEMA,
|
|
1843
2732
|
description:
|
|
1844
|
-
"Read the same per-client advance balances shown in ExpenseBot's
|
|
1845
|
-
"
|
|
2733
|
+
"Read the same per-client advance balances shown in ExpenseBot's Client " +
|
|
2734
|
+
"advances section. Use for questions like 'how much of Acme's advance " +
|
|
1846
2735
|
"remains?', 'which client floats are still open?', or 'do I owe a client " +
|
|
1847
2736
|
"a refund?'. A negative ledger balance means money remains to refund; a " +
|
|
1848
2737
|
"positive balance means the client owes the user. Returns the existing " +
|
|
@@ -1855,17 +2744,25 @@ const TOOLS = [
|
|
|
1855
2744
|
clientName: {
|
|
1856
2745
|
type: "string",
|
|
1857
2746
|
description:
|
|
1858
|
-
"Optional client name or canonical Client tag. Omit to list
|
|
1859
|
-
},
|
|
1860
|
-
days: {
|
|
1861
|
-
type: "integer",
|
|
1862
|
-
minimum: 30,
|
|
1863
|
-
maximum: 3650,
|
|
1864
|
-
description: "Lookback window in days (default 365).",
|
|
2747
|
+
"Optional client name or canonical Client tag. Omit to list every open balance backed by a recorded client advance.",
|
|
1865
2748
|
},
|
|
1866
2749
|
},
|
|
1867
2750
|
},
|
|
1868
2751
|
},
|
|
2752
|
+
{
|
|
2753
|
+
name: "get_trip_suggestions",
|
|
2754
|
+
outputSchema: GET_TRIP_SUGGESTIONS_OUTPUT_SCHEMA,
|
|
2755
|
+
description:
|
|
2756
|
+
"Show ExpenseBot's current high-confidence Trip Intelligence proposals from Review Expenses. Read-only: never groups, tags, creates reports, or writes to the spreadsheet. Each proposal returns strict YYYY-MM-DD dates, evidence, locations, and the exact Receipt IDs with expected current tags. Do not infer a client/project from geography. When nextAction is present, use exactly its group_expenses params with confirm:false, show the canonical preview, then ask for explicit confirmation before any write. Never send confirm:true from this read result alone. In accountant clientEmail mode this tool can read accepted clients but may return no executable nextAction; hand off to Review Expenses or the owner's own assistant connection to apply.",
|
|
2757
|
+
inputSchema: {
|
|
2758
|
+
type: "object",
|
|
2759
|
+
additionalProperties: false,
|
|
2760
|
+
properties: {
|
|
2761
|
+
clientEmail: CLIENT_EMAIL_SCHEMA,
|
|
2762
|
+
limit: { type: "integer", minimum: 1, maximum: 5, description: "Maximum high-confidence proposals to return (default 3)." },
|
|
2763
|
+
},
|
|
2764
|
+
},
|
|
2765
|
+
},
|
|
1869
2766
|
{
|
|
1870
2767
|
name: "group_expenses",
|
|
1871
2768
|
description:
|
|
@@ -1880,6 +2777,7 @@ const TOOLS = [
|
|
|
1880
2777
|
"When the request includes a report, set createReport:true on that confirmed group_expenses call and use its report result; do not run a separate broader create_report query. " +
|
|
1881
2778
|
"For 'without personal expenses', set excludePersonal:true; ExpenseBot removes Personal-tagged and Personal-category rows before preview so their Personal marker is never overwritten. " +
|
|
1882
2779
|
"The confirmed operation returns exact report and Bill Client links. Expenses already assigned to another ordinary report are excluded; if none remain, no duplicate report is created and the result links to Reports instead. Keep the user-facing response concise and do not add unsolicited tax or substantiation advice. Do not call check_compliance, get_report_details, or tax/deductibility tools before or after this workflow unless the user explicitly asks for that separate analysis. " +
|
|
2780
|
+
"In user-facing prose call the destination a group, not a tag. Treat preview totals as provisional; after confirmation use only the terminal result's exact count, total, and currency without reconciling it against the preview. A returned Bill Client URL opens the reviewed billing handoff and does not mean an invoice was created, sent, or confirmed. " +
|
|
1883
2781
|
"Sharing remains a separate share_report action with recipient confirmation.",
|
|
1884
2782
|
inputSchema: {
|
|
1885
2783
|
type: "object",
|
|
@@ -1888,8 +2786,13 @@ const TOOLS = [
|
|
|
1888
2786
|
group: {
|
|
1889
2787
|
type: "object",
|
|
1890
2788
|
additionalProperties: false,
|
|
2789
|
+
description: "The user-named destination group to apply to every eligible selected expense.",
|
|
1891
2790
|
properties: {
|
|
1892
|
-
kind: {
|
|
2791
|
+
kind: {
|
|
2792
|
+
type: "string",
|
|
2793
|
+
enum: ["client", "project", "trip", "job", "group"],
|
|
2794
|
+
description: "How to label the destination in user-facing confirmation text.",
|
|
2795
|
+
},
|
|
1893
2796
|
name: { type: "string", description: "The group name in the user's own words." },
|
|
1894
2797
|
},
|
|
1895
2798
|
required: ["kind", "name"],
|
|
@@ -1897,11 +2800,13 @@ const TOOLS = [
|
|
|
1897
2800
|
selection: {
|
|
1898
2801
|
type: "object",
|
|
1899
2802
|
additionalProperties: false,
|
|
2803
|
+
description: "Exact expenses returned by search_expenses and approved for this bounded operation.",
|
|
1900
2804
|
properties: {
|
|
1901
2805
|
items: {
|
|
1902
2806
|
type: "array",
|
|
1903
2807
|
minItems: 1,
|
|
1904
2808
|
maxItems: 500,
|
|
2809
|
+
description: "One exact receipt identity per selected expense; never broaden this list after preview.",
|
|
1905
2810
|
items: {
|
|
1906
2811
|
type: "object",
|
|
1907
2812
|
additionalProperties: false,
|
|
@@ -1910,7 +2815,13 @@ const TOOLS = [
|
|
|
1910
2815
|
expected: {
|
|
1911
2816
|
type: "object",
|
|
1912
2817
|
additionalProperties: false,
|
|
1913
|
-
|
|
2818
|
+
description: "Optional current state copied from search results for conflict detection.",
|
|
2819
|
+
properties: {
|
|
2820
|
+
tag: {
|
|
2821
|
+
type: "string",
|
|
2822
|
+
description: "Current group/tag value observed before preview; an empty string means ungrouped.",
|
|
2823
|
+
},
|
|
2824
|
+
},
|
|
1914
2825
|
},
|
|
1915
2826
|
},
|
|
1916
2827
|
required: ["receiptId"],
|
|
@@ -1927,7 +2838,10 @@ const TOOLS = [
|
|
|
1927
2838
|
confirm: { type: "boolean", description: "Omit/false for preview; true only after explicit approval." },
|
|
1928
2839
|
approveNewGroup: { type: "boolean", description: "True only when the preview says a new group is required." },
|
|
1929
2840
|
createReport: { type: "boolean", description: "Create a report from the exact eligible grouped expenses." },
|
|
1930
|
-
reportTitle: {
|
|
2841
|
+
reportTitle: {
|
|
2842
|
+
type: "string",
|
|
2843
|
+
description: "Optional title when createReport is true; otherwise ExpenseBot derives one from the group.",
|
|
2844
|
+
},
|
|
1931
2845
|
excludePersonal: {
|
|
1932
2846
|
type: "boolean",
|
|
1933
2847
|
description: "Exclude Personal-tagged and Personal-category expenses from both grouping and the exact report.",
|
|
@@ -2011,14 +2925,22 @@ const TOOLS = [
|
|
|
2011
2925
|
type: {
|
|
2012
2926
|
type: "string",
|
|
2013
2927
|
enum: ["category", "businessPurpose", "attendees"],
|
|
2928
|
+
description: "The one correction kind to apply to every exact selected expense.",
|
|
2929
|
+
},
|
|
2930
|
+
category: {
|
|
2931
|
+
type: "string",
|
|
2932
|
+
description: "Configured expense category to apply when type is category.",
|
|
2933
|
+
},
|
|
2934
|
+
businessPurpose: {
|
|
2935
|
+
type: "string",
|
|
2936
|
+
description: "User-supplied business purpose to apply when type is businessPurpose.",
|
|
2014
2937
|
},
|
|
2015
|
-
category: { type: "string" },
|
|
2016
|
-
businessPurpose: { type: "string" },
|
|
2017
2938
|
attendees: {
|
|
2018
2939
|
type: "array",
|
|
2019
2940
|
minItems: 1,
|
|
2020
2941
|
maxItems: 25,
|
|
2021
2942
|
items: { type: "string" },
|
|
2943
|
+
description: "Attendee names explicitly supplied by the user when type is attendees; never infer names.",
|
|
2022
2944
|
},
|
|
2023
2945
|
attendeeMode: {
|
|
2024
2946
|
type: "string",
|
|
@@ -2032,11 +2954,13 @@ const TOOLS = [
|
|
|
2032
2954
|
selection: {
|
|
2033
2955
|
type: "object",
|
|
2034
2956
|
additionalProperties: false,
|
|
2957
|
+
description: "Exact expenses returned by search_expenses and approved for this bounded correction.",
|
|
2035
2958
|
properties: {
|
|
2036
2959
|
items: {
|
|
2037
2960
|
type: "array",
|
|
2038
2961
|
minItems: 1,
|
|
2039
2962
|
maxItems: 100,
|
|
2963
|
+
description: "One exact receipt identity per selected expense; never broaden this list after preview.",
|
|
2040
2964
|
items: {
|
|
2041
2965
|
type: "object",
|
|
2042
2966
|
additionalProperties: false,
|
|
@@ -2052,8 +2976,14 @@ const TOOLS = [
|
|
|
2052
2976
|
description:
|
|
2053
2977
|
"Optional optimistic-concurrency values copied from the search result.",
|
|
2054
2978
|
properties: {
|
|
2055
|
-
category: {
|
|
2056
|
-
|
|
2979
|
+
category: {
|
|
2980
|
+
type: "string",
|
|
2981
|
+
description: "Current category observed before preview for conflict detection.",
|
|
2982
|
+
},
|
|
2983
|
+
notes: {
|
|
2984
|
+
type: "string",
|
|
2985
|
+
description: "Current structured Notes value observed before preview for conflict detection.",
|
|
2986
|
+
},
|
|
2057
2987
|
},
|
|
2058
2988
|
},
|
|
2059
2989
|
},
|
|
@@ -2138,13 +3068,14 @@ async function handleTool(name, args) {
|
|
|
2138
3068
|
};
|
|
2139
3069
|
|
|
2140
3070
|
case "search_expenses":
|
|
2141
|
-
return
|
|
3071
|
+
return formatResultWithSchema(
|
|
3072
|
+
"search_expenses",
|
|
2142
3073
|
await client.execute("query_expenses", args)
|
|
2143
3074
|
);
|
|
2144
3075
|
|
|
2145
3076
|
case "get_spending_summary": {
|
|
2146
3077
|
const { clientEmail: _clientEmail, ...businessArgs } = args;
|
|
2147
|
-
return
|
|
3078
|
+
return formatResultWithSchema(name,
|
|
2148
3079
|
await client.execute("query_analytics", {
|
|
2149
3080
|
...args,
|
|
2150
3081
|
message: args.query || JSON.stringify(businessArgs),
|
|
@@ -2153,7 +3084,7 @@ async function handleTool(name, args) {
|
|
|
2153
3084
|
}
|
|
2154
3085
|
|
|
2155
3086
|
case "get_deep_analytics":
|
|
2156
|
-
return
|
|
3087
|
+
return formatResultWithSchema(name,
|
|
2157
3088
|
await client.execute("query_analytics", {
|
|
2158
3089
|
...args,
|
|
2159
3090
|
message: args.query,
|
|
@@ -2162,19 +3093,24 @@ async function handleTool(name, args) {
|
|
|
2162
3093
|
);
|
|
2163
3094
|
|
|
2164
3095
|
case "create_report":
|
|
2165
|
-
return
|
|
3096
|
+
return formatResultWithSchema(name, await client.execute("create_report", args));
|
|
2166
3097
|
|
|
2167
3098
|
case "list_reports":
|
|
2168
|
-
return
|
|
3099
|
+
return formatResultWithSchema(name, await client.execute("list_reports", args));
|
|
3100
|
+
|
|
3101
|
+
case "request_accounting_integration":
|
|
3102
|
+
return formatResultWithSchema(name,
|
|
3103
|
+
await client.execute("request_accounting_integration", args)
|
|
3104
|
+
);
|
|
2169
3105
|
|
|
2170
3106
|
case "get_report_details":
|
|
2171
|
-
return
|
|
3107
|
+
return formatResultWithSchema(name, await client.execute("get_report_details", args));
|
|
2172
3108
|
|
|
2173
3109
|
case "share_report":
|
|
2174
|
-
return
|
|
3110
|
+
return formatResultWithSchema(name, await client.execute("share_report", args));
|
|
2175
3111
|
|
|
2176
3112
|
case "check_compliance":
|
|
2177
|
-
return
|
|
3113
|
+
return formatResultWithSchema(name,
|
|
2178
3114
|
await client.execute("help_compliance", {
|
|
2179
3115
|
reportId: args.reportId,
|
|
2180
3116
|
userRequest: args.userRequest,
|
|
@@ -2182,10 +3118,10 @@ async function handleTool(name, args) {
|
|
|
2182
3118
|
);
|
|
2183
3119
|
|
|
2184
3120
|
case "fix_compliance":
|
|
2185
|
-
return
|
|
3121
|
+
return formatResultWithSchema(name, await client.execute("batch_fix", args));
|
|
2186
3122
|
|
|
2187
3123
|
case "check_tax_deductibility":
|
|
2188
|
-
return
|
|
3124
|
+
return formatResultWithSchema(name,
|
|
2189
3125
|
await client.execute("tax_query", {
|
|
2190
3126
|
message: args.query,
|
|
2191
3127
|
category: args.category,
|
|
@@ -2194,17 +3130,28 @@ async function handleTool(name, args) {
|
|
|
2194
3130
|
);
|
|
2195
3131
|
|
|
2196
3132
|
case "search_knowledge":
|
|
2197
|
-
// Works in both modes
|
|
3133
|
+
// Works in both modes. The public MCP endpoint returns the same contract
|
|
3134
|
+
// as the authenticated action; the legacy /api/discover response does not.
|
|
2198
3135
|
if (onboardingMode) {
|
|
2199
3136
|
try {
|
|
2200
|
-
const url = new URL(
|
|
2201
|
-
|
|
2202
|
-
|
|
3137
|
+
const url = new URL(
|
|
3138
|
+
"/api/mcp/public/execute",
|
|
3139
|
+
process.env.EXPENSEBOT_API_BASE || "https://www.expensebot.ai"
|
|
3140
|
+
);
|
|
2203
3141
|
const res = await fetch(url.toString(), {
|
|
2204
|
-
|
|
3142
|
+
method: "POST",
|
|
3143
|
+
headers: {
|
|
3144
|
+
"Content-Type": "application/json",
|
|
3145
|
+
"User-Agent": "expensebot-mcp-auth/onboarding",
|
|
3146
|
+
},
|
|
3147
|
+
body: JSON.stringify({
|
|
3148
|
+
actionId: "search_knowledge",
|
|
3149
|
+
params: args,
|
|
3150
|
+
}),
|
|
2205
3151
|
});
|
|
3152
|
+
if (!res.ok) throw new Error(`API error ${res.status}`);
|
|
2206
3153
|
const data = await res.json();
|
|
2207
|
-
return
|
|
3154
|
+
return formatResultWithSchema("search_knowledge", data);
|
|
2208
3155
|
} catch (err) {
|
|
2209
3156
|
return {
|
|
2210
3157
|
content: [{ type: "text", text: `Search failed: ${err.message}` }],
|
|
@@ -2212,17 +3159,23 @@ async function handleTool(name, args) {
|
|
|
2212
3159
|
};
|
|
2213
3160
|
}
|
|
2214
3161
|
}
|
|
2215
|
-
return
|
|
3162
|
+
return formatResultWithSchema(
|
|
3163
|
+
"search_knowledge",
|
|
2216
3164
|
await client.execute("search_knowledge", args)
|
|
2217
3165
|
);
|
|
2218
3166
|
|
|
2219
3167
|
case "submit_receipt":
|
|
2220
|
-
return
|
|
2221
|
-
await client.execute("submit_receipt",
|
|
3168
|
+
return formatResultWithSchema(name,
|
|
3169
|
+
await client.execute("submit_receipt", {
|
|
3170
|
+
...args,
|
|
3171
|
+
photo: args.photo ?? args.photoBase64,
|
|
3172
|
+
photoBase64: undefined,
|
|
3173
|
+
})
|
|
2222
3174
|
);
|
|
2223
3175
|
|
|
2224
3176
|
case "get_last_receipt_result":
|
|
2225
|
-
return
|
|
3177
|
+
return formatResultWithSchema(
|
|
3178
|
+
"get_last_receipt_result",
|
|
2226
3179
|
await client.execute("get_last_receipt_result", {
|
|
2227
3180
|
submissionId: args.submissionId,
|
|
2228
3181
|
withinSeconds: args.withinSeconds,
|
|
@@ -2230,20 +3183,23 @@ async function handleTool(name, args) {
|
|
|
2230
3183
|
);
|
|
2231
3184
|
|
|
2232
3185
|
case "get_spreadsheet_url":
|
|
2233
|
-
return
|
|
3186
|
+
return formatResultWithSchema(
|
|
3187
|
+
"get_spreadsheet_url",
|
|
3188
|
+
await client.execute("get_spreadsheet_url", {})
|
|
3189
|
+
);
|
|
2234
3190
|
|
|
2235
3191
|
case "add_cash_expense":
|
|
2236
|
-
return
|
|
3192
|
+
return formatResultWithSchema(name,
|
|
2237
3193
|
await client.execute("add_cash_expense", args)
|
|
2238
3194
|
);
|
|
2239
3195
|
|
|
2240
3196
|
case "parse_expense":
|
|
2241
|
-
return
|
|
3197
|
+
return formatResultWithSchema(name,
|
|
2242
3198
|
await client.execute("parse_expense", { text: args.text })
|
|
2243
3199
|
);
|
|
2244
3200
|
|
|
2245
3201
|
case "process_gmail_receipts":
|
|
2246
|
-
return
|
|
3202
|
+
return formatResultWithSchema(name,
|
|
2247
3203
|
await client.execute("process_gmail_receipts", {
|
|
2248
3204
|
emailIds: args.emailIds,
|
|
2249
3205
|
accountEmail: args.accountEmail,
|
|
@@ -2251,7 +3207,7 @@ async function handleTool(name, args) {
|
|
|
2251
3207
|
);
|
|
2252
3208
|
|
|
2253
3209
|
case "scan_gmail":
|
|
2254
|
-
return
|
|
3210
|
+
return formatResultWithSchema(name,
|
|
2255
3211
|
await client.execute("scan_gmail", {
|
|
2256
3212
|
lookbackDays: args.lookbackDays,
|
|
2257
3213
|
startDate: args.startDate,
|
|
@@ -2261,35 +3217,47 @@ async function handleTool(name, args) {
|
|
|
2261
3217
|
);
|
|
2262
3218
|
|
|
2263
3219
|
case "add_mileage_entry":
|
|
2264
|
-
return
|
|
3220
|
+
return formatResultWithSchema(name, await client.execute("add_mileage_entry", args));
|
|
2265
3221
|
|
|
2266
3222
|
case "add_income":
|
|
2267
|
-
return
|
|
3223
|
+
return formatResultWithSchema(name, await client.execute("add_income", args));
|
|
2268
3224
|
|
|
2269
3225
|
// Two-phase income import (v-next) — pass-through; the backend owns the
|
|
2270
3226
|
// parse -> durable preview -> confirm -> chunked canonical write contract.
|
|
2271
3227
|
case "add_income_from_file":
|
|
2272
|
-
return
|
|
3228
|
+
return formatResultWithSchema(name,
|
|
3229
|
+
await client.execute("add_income_from_file", {
|
|
3230
|
+
...args,
|
|
3231
|
+
photo: args.photo ?? args.photoBase64,
|
|
3232
|
+
photoBase64: undefined,
|
|
3233
|
+
})
|
|
3234
|
+
);
|
|
2273
3235
|
|
|
2274
3236
|
case "add_income_from_csv":
|
|
2275
|
-
return
|
|
3237
|
+
return formatResultWithSchema(name,
|
|
3238
|
+
await client.execute("add_income_from_csv", {
|
|
3239
|
+
...args,
|
|
3240
|
+
csvContent: args.csvContent ?? args.csvText,
|
|
3241
|
+
csvText: undefined,
|
|
3242
|
+
})
|
|
3243
|
+
);
|
|
2276
3244
|
|
|
2277
3245
|
case "get_accounting_integration_status":
|
|
2278
|
-
return
|
|
3246
|
+
return formatResultWithSchema(name,
|
|
2279
3247
|
await client.execute("get_accounting_integration_status", args)
|
|
2280
3248
|
);
|
|
2281
3249
|
|
|
2282
3250
|
case "send_report_to_accounting":
|
|
2283
|
-
return
|
|
3251
|
+
return formatResultWithSchema(name, await client.execute("send_report_to_accounting", args));
|
|
2284
3252
|
|
|
2285
3253
|
case "get_accounting_push_status":
|
|
2286
|
-
return
|
|
3254
|
+
return formatResultWithSchema(name, await client.execute("get_accounting_push_status", args));
|
|
2287
3255
|
|
|
2288
3256
|
case "list_categories":
|
|
2289
|
-
return
|
|
3257
|
+
return formatResultWithSchema(name, await client.execute("list_categories", {}));
|
|
2290
3258
|
|
|
2291
3259
|
case "list_tags":
|
|
2292
|
-
return
|
|
3260
|
+
return formatResultWithSchema(name, await client.execute("list_tags", {}));
|
|
2293
3261
|
|
|
2294
3262
|
// ── Income & P&L analytics (v0.6.0) — proxy to query_analytics ──
|
|
2295
3263
|
case "get_income_summary": {
|
|
@@ -2301,7 +3269,7 @@ async function handleTool(name, args) {
|
|
|
2301
3269
|
if (args.groupBy) {
|
|
2302
3270
|
q = `${q} grouped by ${args.groupBy}`;
|
|
2303
3271
|
}
|
|
2304
|
-
return
|
|
3272
|
+
return formatResultWithSchema(name,
|
|
2305
3273
|
await client.execute("query_analytics", {
|
|
2306
3274
|
...args,
|
|
2307
3275
|
message: q,
|
|
@@ -2311,7 +3279,7 @@ async function handleTool(name, args) {
|
|
|
2311
3279
|
}
|
|
2312
3280
|
|
|
2313
3281
|
case "get_pnl":
|
|
2314
|
-
return
|
|
3282
|
+
return formatResultWithSchema(name,
|
|
2315
3283
|
await client.execute("query_analytics", {
|
|
2316
3284
|
...args,
|
|
2317
3285
|
message: args.query || "P&L summary",
|
|
@@ -2324,7 +3292,7 @@ async function handleTool(name, args) {
|
|
|
2324
3292
|
if (args.tagPrefix) {
|
|
2325
3293
|
q = `${q} (limit to tag prefix '${args.tagPrefix}')`;
|
|
2326
3294
|
}
|
|
2327
|
-
return
|
|
3295
|
+
return formatResultWithSchema(name,
|
|
2328
3296
|
await client.execute("query_analytics", {
|
|
2329
3297
|
...args,
|
|
2330
3298
|
message: q,
|
|
@@ -2334,12 +3302,12 @@ async function handleTool(name, args) {
|
|
|
2334
3302
|
}
|
|
2335
3303
|
|
|
2336
3304
|
case "list_income_categories":
|
|
2337
|
-
return
|
|
3305
|
+
return formatResultWithSchema(name,
|
|
2338
3306
|
await client.execute("list_income_categories", {})
|
|
2339
3307
|
);
|
|
2340
3308
|
|
|
2341
3309
|
case "get_recent_activity":
|
|
2342
|
-
return
|
|
3310
|
+
return formatResultWithSchema(name,
|
|
2343
3311
|
await client.execute("get_recent_activity", {
|
|
2344
3312
|
limit: args.limit || 20,
|
|
2345
3313
|
sinceDays: args.sinceDays || 7,
|
|
@@ -2348,7 +3316,7 @@ async function handleTool(name, args) {
|
|
|
2348
3316
|
);
|
|
2349
3317
|
|
|
2350
3318
|
case "trace_document":
|
|
2351
|
-
return
|
|
3319
|
+
return formatResultWithSchema(name,
|
|
2352
3320
|
await client.execute("trace_document", {
|
|
2353
3321
|
query: args.query,
|
|
2354
3322
|
receiptId: args.receiptId,
|
|
@@ -2366,7 +3334,7 @@ async function handleTool(name, args) {
|
|
|
2366
3334
|
case "get_mileage_summary": {
|
|
2367
3335
|
let q = args.query || "mileage summary";
|
|
2368
3336
|
if (args.groupBy) q = `${q} grouped by ${args.groupBy}`;
|
|
2369
|
-
return
|
|
3337
|
+
return formatResultWithSchema(name,
|
|
2370
3338
|
await client.execute("query_analytics", {
|
|
2371
3339
|
...args,
|
|
2372
3340
|
message: q,
|
|
@@ -2380,7 +3348,7 @@ async function handleTool(name, args) {
|
|
|
2380
3348
|
if (args.focus && args.focus !== "all") {
|
|
2381
3349
|
q = `${q} (focus: ${args.focus})`;
|
|
2382
3350
|
}
|
|
2383
|
-
return
|
|
3351
|
+
return formatResultWithSchema(name,
|
|
2384
3352
|
await client.execute("query_analytics", {
|
|
2385
3353
|
...args,
|
|
2386
3354
|
message: q,
|
|
@@ -2391,7 +3359,7 @@ async function handleTool(name, args) {
|
|
|
2391
3359
|
|
|
2392
3360
|
// ── Read-only mutation helpers (v0.7.0) ──
|
|
2393
3361
|
case "get_expense_by_id":
|
|
2394
|
-
return
|
|
3362
|
+
return formatResultWithSchema(name,
|
|
2395
3363
|
await client.execute("get_expense_by_id", {
|
|
2396
3364
|
rowNumber: args.rowNumber,
|
|
2397
3365
|
expenseId: args.expenseId,
|
|
@@ -2399,7 +3367,7 @@ async function handleTool(name, args) {
|
|
|
2399
3367
|
);
|
|
2400
3368
|
|
|
2401
3369
|
case "export_report":
|
|
2402
|
-
return
|
|
3370
|
+
return formatResultWithSchema(name,
|
|
2403
3371
|
await client.execute("export_report", { reportId: args.reportId })
|
|
2404
3372
|
);
|
|
2405
3373
|
|
|
@@ -2423,7 +3391,7 @@ async function handleTool(name, args) {
|
|
|
2423
3391
|
],
|
|
2424
3392
|
};
|
|
2425
3393
|
}
|
|
2426
|
-
return
|
|
3394
|
+
return formatResultWithSchema(name, await client.execute("get_pricing", {}));
|
|
2427
3395
|
}
|
|
2428
3396
|
|
|
2429
3397
|
case "check_feature": {
|
|
@@ -2437,7 +3405,7 @@ async function handleTool(name, args) {
|
|
|
2437
3405
|
headers: { "User-Agent": "expensebot-mcp-auth/0.6.0" },
|
|
2438
3406
|
});
|
|
2439
3407
|
const data = await res.json();
|
|
2440
|
-
return
|
|
3408
|
+
return formatResultWithSchema(name, data);
|
|
2441
3409
|
} catch (err) {
|
|
2442
3410
|
return {
|
|
2443
3411
|
content: [{ type: "text", text: `Feature check failed: ${err.message}` }],
|
|
@@ -2445,7 +3413,7 @@ async function handleTool(name, args) {
|
|
|
2445
3413
|
};
|
|
2446
3414
|
}
|
|
2447
3415
|
}
|
|
2448
|
-
return
|
|
3416
|
+
return formatResultWithSchema(name,
|
|
2449
3417
|
await client.execute("check_feature", { feature: args.feature })
|
|
2450
3418
|
);
|
|
2451
3419
|
}
|
|
@@ -2472,20 +3440,20 @@ async function handleTool(name, args) {
|
|
|
2472
3440
|
|
|
2473
3441
|
// ── Pulse CFO Slice 4 — What-If ──
|
|
2474
3442
|
case "whatif_afford":
|
|
2475
|
-
return
|
|
3443
|
+
return formatResultWithSchema(name,
|
|
2476
3444
|
await client.execute("whatif_afford", { deltaMonthly: args.deltaMonthly })
|
|
2477
3445
|
);
|
|
2478
3446
|
|
|
2479
3447
|
case "whatif_client":
|
|
2480
|
-
return
|
|
3448
|
+
return formatResultWithSchema(name,
|
|
2481
3449
|
await client.execute("whatif_client", { clientName: args.clientName, mode: args.mode })
|
|
2482
3450
|
);
|
|
2483
3451
|
|
|
2484
3452
|
case "whatif_tax_setaside":
|
|
2485
|
-
return
|
|
3453
|
+
return formatResultWithSchema(name, await client.execute("whatif_tax_setaside", {}));
|
|
2486
3454
|
|
|
2487
3455
|
case "scan_gmail_years":
|
|
2488
|
-
return
|
|
3456
|
+
return formatResultWithSchema(name,
|
|
2489
3457
|
await client.execute("scan_gmail_years", {
|
|
2490
3458
|
years: args.years,
|
|
2491
3459
|
accountEmail: args.accountEmail,
|
|
@@ -2494,10 +3462,10 @@ async function handleTool(name, args) {
|
|
|
2494
3462
|
);
|
|
2495
3463
|
|
|
2496
3464
|
case "get_scan_status":
|
|
2497
|
-
return
|
|
3465
|
+
return formatResultWithSchema(name, await client.execute("get_scan_status", {}));
|
|
2498
3466
|
|
|
2499
3467
|
case "list_client_invoices":
|
|
2500
|
-
return
|
|
3468
|
+
return formatResultWithSchema(name,
|
|
2501
3469
|
await client.execute("list_client_invoices", {
|
|
2502
3470
|
clientEmail: args.clientEmail,
|
|
2503
3471
|
status: args.status,
|
|
@@ -2506,8 +3474,44 @@ async function handleTool(name, args) {
|
|
|
2506
3474
|
})
|
|
2507
3475
|
);
|
|
2508
3476
|
|
|
3477
|
+
case "get_client_invoice":
|
|
3478
|
+
return formatResultWithSchema(name,
|
|
3479
|
+
await client.execute("get_client_invoice", {
|
|
3480
|
+
clientEmail: args.clientEmail,
|
|
3481
|
+
invoiceId: args.invoiceId,
|
|
3482
|
+
invoiceNumber: args.invoiceNumber,
|
|
3483
|
+
})
|
|
3484
|
+
);
|
|
3485
|
+
|
|
3486
|
+
case "prepare_client_invoice":
|
|
3487
|
+
return formatResultWithSchema(name,
|
|
3488
|
+
await client.execute("prepare_client_invoice", {
|
|
3489
|
+
...args,
|
|
3490
|
+
})
|
|
3491
|
+
);
|
|
3492
|
+
|
|
3493
|
+
case "create_client_invoice":
|
|
3494
|
+
return formatResultWithSchema(name,
|
|
3495
|
+
await client.execute("create_client_invoice", {
|
|
3496
|
+
clientEmail: args.clientEmail,
|
|
3497
|
+
preparationId: args.preparationId,
|
|
3498
|
+
confirmTax: args.confirmTax,
|
|
3499
|
+
operationId: args.operationId,
|
|
3500
|
+
})
|
|
3501
|
+
);
|
|
3502
|
+
|
|
3503
|
+
case "mark_client_invoice_paid":
|
|
3504
|
+
return formatResultWithSchema(name,
|
|
3505
|
+
await client.execute("mark_client_invoice_paid", {
|
|
3506
|
+
invoiceId: args.invoiceId,
|
|
3507
|
+
paidDate: args.paidDate,
|
|
3508
|
+
paidAmount: args.paidAmount,
|
|
3509
|
+
paidVia: args.paidVia,
|
|
3510
|
+
})
|
|
3511
|
+
);
|
|
3512
|
+
|
|
2509
3513
|
case "get_expense_splits":
|
|
2510
|
-
return
|
|
3514
|
+
return formatResultWithSchema(name,
|
|
2511
3515
|
await client.execute("get_expense_splits", {
|
|
2512
3516
|
clientEmail: args.clientEmail,
|
|
2513
3517
|
receiptId: args.receiptId,
|
|
@@ -2518,7 +3522,7 @@ async function handleTool(name, args) {
|
|
|
2518
3522
|
);
|
|
2519
3523
|
|
|
2520
3524
|
case "get_monthly_books_review":
|
|
2521
|
-
return
|
|
3525
|
+
return formatResultWithSchema(name,
|
|
2522
3526
|
await client.execute("get_monthly_books_review", {
|
|
2523
3527
|
clientEmail: args.clientEmail,
|
|
2524
3528
|
period: args.period,
|
|
@@ -2526,7 +3530,7 @@ async function handleTool(name, args) {
|
|
|
2526
3530
|
);
|
|
2527
3531
|
|
|
2528
3532
|
case "get_credits_refunds":
|
|
2529
|
-
return
|
|
3533
|
+
return formatResultWithSchema(name,
|
|
2530
3534
|
await client.execute("get_credits_refunds", {
|
|
2531
3535
|
clientEmail: args.clientEmail,
|
|
2532
3536
|
dateRange: args.dateRange,
|
|
@@ -2535,16 +3539,15 @@ async function handleTool(name, args) {
|
|
|
2535
3539
|
);
|
|
2536
3540
|
|
|
2537
3541
|
case "get_client_advance_balances":
|
|
2538
|
-
return
|
|
3542
|
+
return formatResultWithSchema(name,
|
|
2539
3543
|
await client.execute("get_client_advance_balances", {
|
|
2540
3544
|
clientEmail: args.clientEmail,
|
|
2541
3545
|
clientName: args.clientName,
|
|
2542
|
-
days: args.days,
|
|
2543
3546
|
})
|
|
2544
3547
|
);
|
|
2545
3548
|
|
|
2546
3549
|
case "group_expenses":
|
|
2547
|
-
return
|
|
3550
|
+
return formatResultWithSchema(name,
|
|
2548
3551
|
await client.execute("group_expenses", {
|
|
2549
3552
|
group: args.group,
|
|
2550
3553
|
selection: args.selection,
|
|
@@ -2561,8 +3564,16 @@ async function handleTool(name, args) {
|
|
|
2561
3564
|
})
|
|
2562
3565
|
);
|
|
2563
3566
|
|
|
3567
|
+
case "get_trip_suggestions":
|
|
3568
|
+
return formatResultWithSchema(name,
|
|
3569
|
+
await client.execute("get_trip_suggestions", {
|
|
3570
|
+
clientEmail: args.clientEmail,
|
|
3571
|
+
limit: args.limit,
|
|
3572
|
+
})
|
|
3573
|
+
);
|
|
3574
|
+
|
|
2564
3575
|
case "correct_expenses":
|
|
2565
|
-
return
|
|
3576
|
+
return formatResultWithSchema(name,
|
|
2566
3577
|
await client.execute("correct_expenses", {
|
|
2567
3578
|
change: args.change,
|
|
2568
3579
|
selection: args.selection,
|
|
@@ -2574,7 +3585,7 @@ async function handleTool(name, args) {
|
|
|
2574
3585
|
);
|
|
2575
3586
|
|
|
2576
3587
|
case "update_expense":
|
|
2577
|
-
return
|
|
3588
|
+
return formatResultWithSchema(name,
|
|
2578
3589
|
await client.execute("update_expense", {
|
|
2579
3590
|
expenseId: args.expenseId,
|
|
2580
3591
|
fields: args.fields,
|
|
@@ -2678,9 +3689,30 @@ function formatResult(result) {
|
|
|
2678
3689
|
|
|
2679
3690
|
// ── MCP Server Setup ───────────────────────────────────────────────────
|
|
2680
3691
|
|
|
3692
|
+
const OUTPUT_SCHEMA_BY_TOOL = new Map(
|
|
3693
|
+
TOOLS.filter((tool) => tool.outputSchema).map((tool) => [
|
|
3694
|
+
tool.name,
|
|
3695
|
+
tool.outputSchema,
|
|
3696
|
+
])
|
|
3697
|
+
);
|
|
3698
|
+
|
|
3699
|
+
function formatResultWithSchema(toolName, result) {
|
|
3700
|
+
const formatted = formatResult(result);
|
|
3701
|
+
if (
|
|
3702
|
+
!formatted.isError &&
|
|
3703
|
+
OUTPUT_SCHEMA_BY_TOOL.has(toolName) &&
|
|
3704
|
+
result &&
|
|
3705
|
+
typeof result === "object" &&
|
|
3706
|
+
!Array.isArray(result)
|
|
3707
|
+
) {
|
|
3708
|
+
formatted.structuredContent = result;
|
|
3709
|
+
}
|
|
3710
|
+
return formatted;
|
|
3711
|
+
}
|
|
3712
|
+
|
|
2681
3713
|
async function main() {
|
|
2682
3714
|
const server = new Server(
|
|
2683
|
-
{ name: "expensebot-auth", version: "0.6.
|
|
3715
|
+
{ name: "expensebot-auth", version: "0.6.23" },
|
|
2684
3716
|
{ capabilities: { tools: {} }, instructions: SERVER_INSTRUCTIONS }
|
|
2685
3717
|
);
|
|
2686
3718
|
|