@expensebot/mcp-server-auth 0.6.25 → 0.6.26
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 +23 -1
- package/package.json +1 -1
- package/server.json +2 -2
- package/src/client.js +1 -1
- package/src/index.js +831 -128
- package/src/test.js +110 -4
package/src/index.js
CHANGED
|
@@ -586,6 +586,769 @@ const GET_SCAN_STATUS_OUTPUT_SCHEMA = {
|
|
|
586
586
|
},
|
|
587
587
|
};
|
|
588
588
|
|
|
589
|
+
// ── Tranche 3 output schemas (2026-09-09) — workflow and write tools ─────
|
|
590
|
+
// Successful writes may already have happened when a client validates the
|
|
591
|
+
// response. Keep required fields to proven invariants, and expose each
|
|
592
|
+
// preview/upload/queued/terminal discriminator so clients never infer a retry.
|
|
593
|
+
|
|
594
|
+
const CREATE_REPORT_OUTPUT_SCHEMA = {
|
|
595
|
+
type: "object",
|
|
596
|
+
required: ["success"],
|
|
597
|
+
additionalProperties: true,
|
|
598
|
+
properties: {
|
|
599
|
+
success: { type: "boolean" },
|
|
600
|
+
creationStatus: { type: "string" },
|
|
601
|
+
reportId: { type: "string" },
|
|
602
|
+
reportUrl: { type: "string" },
|
|
603
|
+
billClientUrl: { type: "string" },
|
|
604
|
+
accountingHandoffUrls: { type: "object", additionalProperties: true },
|
|
605
|
+
accountingSetupUrl: { type: "string" },
|
|
606
|
+
finalAnswer: { type: "string" },
|
|
607
|
+
responseGuidance: { type: "string" },
|
|
608
|
+
nextActions: { type: "array", items: { type: "object", additionalProperties: true } },
|
|
609
|
+
data: {
|
|
610
|
+
type: "object",
|
|
611
|
+
additionalProperties: true,
|
|
612
|
+
properties: {
|
|
613
|
+
creationStatus: { type: "string" },
|
|
614
|
+
reportId: { type: "string" },
|
|
615
|
+
title: { type: "string" },
|
|
616
|
+
receiptCount: { type: "integer", minimum: 0 },
|
|
617
|
+
functionalTotal: { type: "number" },
|
|
618
|
+
homeCurrency: { type: "string" },
|
|
619
|
+
appliedFilters: { type: "object", additionalProperties: true },
|
|
620
|
+
personalExcludedCount: { type: "integer", minimum: 0 },
|
|
621
|
+
link: { type: "string" },
|
|
622
|
+
appReportUrl: { type: "string" },
|
|
623
|
+
billClientUrl: { type: "string" },
|
|
624
|
+
},
|
|
625
|
+
},
|
|
626
|
+
},
|
|
627
|
+
};
|
|
628
|
+
|
|
629
|
+
const REQUEST_ACCOUNTING_INTEGRATION_OUTPUT_SCHEMA = {
|
|
630
|
+
type: "object",
|
|
631
|
+
required: ["success", "duplicate", "packageName", "message"],
|
|
632
|
+
additionalProperties: true,
|
|
633
|
+
properties: {
|
|
634
|
+
success: { type: "boolean" },
|
|
635
|
+
duplicate: { type: "boolean" },
|
|
636
|
+
packageName: { type: "string" },
|
|
637
|
+
message: { type: "string" },
|
|
638
|
+
},
|
|
639
|
+
};
|
|
640
|
+
|
|
641
|
+
const SHARE_REPORT_OUTPUT_SCHEMA = {
|
|
642
|
+
type: "object",
|
|
643
|
+
required: ["success", "message", "sharedWith", "recipientRole"],
|
|
644
|
+
additionalProperties: true,
|
|
645
|
+
properties: {
|
|
646
|
+
success: { type: "boolean" },
|
|
647
|
+
message: { type: "string" },
|
|
648
|
+
sharedWith: { type: "array", items: { type: "string", format: "email" } },
|
|
649
|
+
recipientRole: { type: "string" },
|
|
650
|
+
finalAnswer: { type: "string" },
|
|
651
|
+
responseGuidance: { type: "string" },
|
|
652
|
+
},
|
|
653
|
+
};
|
|
654
|
+
|
|
655
|
+
const SUBMIT_RECEIPT_OUTPUT_SCHEMA = {
|
|
656
|
+
type: "object",
|
|
657
|
+
required: ["success"],
|
|
658
|
+
additionalProperties: true,
|
|
659
|
+
properties: {
|
|
660
|
+
success: { type: "boolean" },
|
|
661
|
+
status: { type: "string" },
|
|
662
|
+
statusCode: { type: "integer" },
|
|
663
|
+
message: { type: "string" },
|
|
664
|
+
submissionId: { type: "string" },
|
|
665
|
+
fileCount: { type: "integer", minimum: 0 },
|
|
666
|
+
files: { type: "array", items: { type: "object", additionalProperties: true } },
|
|
667
|
+
spreadsheetUrl: { type: ["string", "null"] },
|
|
668
|
+
reviewExpensesUrl: { type: "string" },
|
|
669
|
+
data: {
|
|
670
|
+
type: "object",
|
|
671
|
+
additionalProperties: true,
|
|
672
|
+
properties: {
|
|
673
|
+
signedUrl: { type: "string" },
|
|
674
|
+
uploadRef: { type: "string" },
|
|
675
|
+
requiredHeaders: { type: "object", additionalProperties: { type: "string" } },
|
|
676
|
+
expiresInSeconds: { type: "integer", minimum: 1 },
|
|
677
|
+
files: {
|
|
678
|
+
type: "array",
|
|
679
|
+
items: {
|
|
680
|
+
type: "object",
|
|
681
|
+
additionalProperties: true,
|
|
682
|
+
properties: {
|
|
683
|
+
id: { type: "string" },
|
|
684
|
+
filename: { type: "string" },
|
|
685
|
+
mimeType: { type: "string" },
|
|
686
|
+
signedUrl: { type: "string" },
|
|
687
|
+
uploadRef: { type: "string" },
|
|
688
|
+
requiredHeaders: { type: "object", additionalProperties: { type: "string" } },
|
|
689
|
+
},
|
|
690
|
+
},
|
|
691
|
+
},
|
|
692
|
+
submissionId: { type: "string" },
|
|
693
|
+
spreadsheetUrl: { type: ["string", "null"] },
|
|
694
|
+
reviewExpensesUrl: { type: "string" },
|
|
695
|
+
},
|
|
696
|
+
},
|
|
697
|
+
},
|
|
698
|
+
allOf: [
|
|
699
|
+
{
|
|
700
|
+
if: { properties: { status: { const: "upload_required" } }, required: ["status"] },
|
|
701
|
+
then: { required: ["data"] },
|
|
702
|
+
},
|
|
703
|
+
],
|
|
704
|
+
};
|
|
705
|
+
|
|
706
|
+
const ADD_CASH_EXPENSE_OUTPUT_SCHEMA = {
|
|
707
|
+
type: "object",
|
|
708
|
+
required: ["success", "message"],
|
|
709
|
+
additionalProperties: true,
|
|
710
|
+
properties: {
|
|
711
|
+
success: { type: "boolean" },
|
|
712
|
+
message: { type: "string" },
|
|
713
|
+
rowNumber: { type: "integer", minimum: 1 },
|
|
714
|
+
recordId: { type: "string" },
|
|
715
|
+
expense: {
|
|
716
|
+
type: "object",
|
|
717
|
+
additionalProperties: true,
|
|
718
|
+
properties: {
|
|
719
|
+
recordId: { type: "string" },
|
|
720
|
+
rowNumber: { type: "integer", minimum: 1 },
|
|
721
|
+
date: { type: "string", format: "date" },
|
|
722
|
+
merchant: { type: "string" },
|
|
723
|
+
category: { type: "string" },
|
|
724
|
+
total: { type: "number" },
|
|
725
|
+
receivedAmount: { type: "number" },
|
|
726
|
+
currency: { type: "string" },
|
|
727
|
+
tag: { type: "string" },
|
|
728
|
+
isClientAdvance: { type: "boolean" },
|
|
729
|
+
},
|
|
730
|
+
},
|
|
731
|
+
spreadsheetUrl: { type: ["string", "null"] },
|
|
732
|
+
reviewExpensesUrl: { type: "string" },
|
|
733
|
+
data: { type: "object", additionalProperties: true },
|
|
734
|
+
finalAnswer: { type: "string" },
|
|
735
|
+
responseGuidance: { type: "string" },
|
|
736
|
+
},
|
|
737
|
+
};
|
|
738
|
+
|
|
739
|
+
const PARSE_EXPENSE_OUTPUT_SCHEMA = {
|
|
740
|
+
type: "object",
|
|
741
|
+
required: ["success", "expenses", "validationErrors", "categoryNames"],
|
|
742
|
+
additionalProperties: true,
|
|
743
|
+
properties: {
|
|
744
|
+
success: { type: "boolean" },
|
|
745
|
+
expenses: {
|
|
746
|
+
type: "array",
|
|
747
|
+
items: {
|
|
748
|
+
type: "object",
|
|
749
|
+
additionalProperties: true,
|
|
750
|
+
properties: {
|
|
751
|
+
date: { type: "string", format: "date" },
|
|
752
|
+
merchant: { type: "string" },
|
|
753
|
+
category: { type: "string" },
|
|
754
|
+
amount: { type: "number" },
|
|
755
|
+
currency: { type: "string" },
|
|
756
|
+
},
|
|
757
|
+
},
|
|
758
|
+
},
|
|
759
|
+
validationErrors: { type: "array", items: {} },
|
|
760
|
+
categoryNames: { type: "array", items: { type: "string" } },
|
|
761
|
+
},
|
|
762
|
+
};
|
|
763
|
+
|
|
764
|
+
const PROCESS_GMAIL_RECEIPTS_OUTPUT_SCHEMA = {
|
|
765
|
+
type: "object",
|
|
766
|
+
required: ["success", "message"],
|
|
767
|
+
additionalProperties: true,
|
|
768
|
+
properties: {
|
|
769
|
+
success: { type: "boolean" },
|
|
770
|
+
message: { type: "string" },
|
|
771
|
+
error: { type: "string" },
|
|
772
|
+
emailCount: { type: "integer", minimum: 0 },
|
|
773
|
+
processedItems: { type: "array", items: { type: "object", additionalProperties: true } },
|
|
774
|
+
submissionId: { type: "string" },
|
|
775
|
+
processInfo: {
|
|
776
|
+
type: "object",
|
|
777
|
+
additionalProperties: true,
|
|
778
|
+
properties: {
|
|
779
|
+
processingCompleted: { type: "boolean" },
|
|
780
|
+
sessionId: { type: "string" },
|
|
781
|
+
status: { type: "string" },
|
|
782
|
+
},
|
|
783
|
+
},
|
|
784
|
+
spreadsheetUrl: { type: ["string", "null"] },
|
|
785
|
+
reviewExpensesUrl: { type: "string" },
|
|
786
|
+
data: { type: "object", additionalProperties: true },
|
|
787
|
+
},
|
|
788
|
+
};
|
|
789
|
+
|
|
790
|
+
const SCAN_GMAIL_OUTPUT_SCHEMA = {
|
|
791
|
+
type: "object",
|
|
792
|
+
required: ["success"],
|
|
793
|
+
additionalProperties: true,
|
|
794
|
+
properties: {
|
|
795
|
+
success: { type: "boolean" },
|
|
796
|
+
message: { type: "string" },
|
|
797
|
+
status: { type: "string" },
|
|
798
|
+
orchestrated: { type: "boolean" },
|
|
799
|
+
sessionId: { type: "string" },
|
|
800
|
+
submissionId: { type: "string" },
|
|
801
|
+
scanInProgress: { type: "boolean" },
|
|
802
|
+
spreadsheetUrl: { type: ["string", "null"] },
|
|
803
|
+
reviewExpensesUrl: { type: ["string", "null"] },
|
|
804
|
+
data: { type: "object", additionalProperties: true },
|
|
805
|
+
_metadata: { type: "object", additionalProperties: true },
|
|
806
|
+
},
|
|
807
|
+
};
|
|
808
|
+
|
|
809
|
+
const ADD_MILEAGE_ENTRY_OUTPUT_SCHEMA = {
|
|
810
|
+
type: "object",
|
|
811
|
+
required: ["success", "message"],
|
|
812
|
+
additionalProperties: true,
|
|
813
|
+
properties: {
|
|
814
|
+
success: { type: "boolean" },
|
|
815
|
+
message: { type: "string" },
|
|
816
|
+
rowNumber: { type: "integer", minimum: 1 },
|
|
817
|
+
settings: {
|
|
818
|
+
type: "object",
|
|
819
|
+
additionalProperties: true,
|
|
820
|
+
properties: {
|
|
821
|
+
unit: { type: "string" },
|
|
822
|
+
allowancePerUnit: { type: "number" },
|
|
823
|
+
},
|
|
824
|
+
},
|
|
825
|
+
spreadsheetUrl: { type: ["string", "null"] },
|
|
826
|
+
reviewExpensesUrl: { type: "string" },
|
|
827
|
+
data: { type: "object", additionalProperties: true },
|
|
828
|
+
finalAnswer: { type: "string" },
|
|
829
|
+
responseGuidance: { type: "string" },
|
|
830
|
+
},
|
|
831
|
+
};
|
|
832
|
+
|
|
833
|
+
const ADD_INCOME_OUTPUT_SCHEMA = {
|
|
834
|
+
type: "object",
|
|
835
|
+
required: ["success", "message"],
|
|
836
|
+
additionalProperties: true,
|
|
837
|
+
properties: {
|
|
838
|
+
success: { type: "boolean" },
|
|
839
|
+
message: { type: "string" },
|
|
840
|
+
deduped: { type: "boolean" },
|
|
841
|
+
rowNumber: { type: "integer", minimum: 1 },
|
|
842
|
+
tabCreated: { type: "boolean" },
|
|
843
|
+
recordId: { type: "string" },
|
|
844
|
+
matchedRow: {
|
|
845
|
+
type: "object",
|
|
846
|
+
additionalProperties: true,
|
|
847
|
+
properties: {
|
|
848
|
+
rowNumber: { type: "integer", minimum: 1 },
|
|
849
|
+
amount: { type: "number" },
|
|
850
|
+
date: { type: "string", format: "date" },
|
|
851
|
+
currency: { type: "string" },
|
|
852
|
+
},
|
|
853
|
+
},
|
|
854
|
+
destinations: { type: "object", additionalProperties: true },
|
|
855
|
+
data: { type: "object", additionalProperties: true },
|
|
856
|
+
finalAnswer: { type: "string" },
|
|
857
|
+
responseGuidance: { type: "string" },
|
|
858
|
+
},
|
|
859
|
+
};
|
|
860
|
+
|
|
861
|
+
const INCOME_IMPORT_OUTPUT_SCHEMA = {
|
|
862
|
+
type: "object",
|
|
863
|
+
required: ["success", "message"],
|
|
864
|
+
additionalProperties: true,
|
|
865
|
+
properties: {
|
|
866
|
+
success: { type: "boolean" },
|
|
867
|
+
message: { type: "string" },
|
|
868
|
+
preview: { type: "boolean" },
|
|
869
|
+
confirmed: { type: "boolean" },
|
|
870
|
+
tooLargeForChat: { type: "boolean" },
|
|
871
|
+
previewId: { type: "string" },
|
|
872
|
+
expiresAt: { type: "string", format: "date-time" },
|
|
873
|
+
expiresInMinutes: { type: "integer", minimum: 1 },
|
|
874
|
+
entryCount: { type: "integer", minimum: 0 },
|
|
875
|
+
maxChatEntries: { type: "integer", minimum: 1 },
|
|
876
|
+
totalsByCurrency: { type: "object", additionalProperties: { type: "number" } },
|
|
877
|
+
refundRowCount: { type: "integer", minimum: 0 },
|
|
878
|
+
duplicateCount: { type: "integer", minimum: 0 },
|
|
879
|
+
duplicates: { type: "array", items: { type: "object", additionalProperties: true } },
|
|
880
|
+
rejectedRows: { type: "array", items: { type: "object", additionalProperties: true } },
|
|
881
|
+
warnings: { type: "array", items: { type: "string" } },
|
|
882
|
+
entries: {
|
|
883
|
+
type: "array",
|
|
884
|
+
items: {
|
|
885
|
+
type: "object",
|
|
886
|
+
additionalProperties: true,
|
|
887
|
+
properties: {
|
|
888
|
+
index: { type: "integer", minimum: 0 },
|
|
889
|
+
date: { type: "string", format: "date" },
|
|
890
|
+
payer: { type: "string" },
|
|
891
|
+
amount: { type: "number" },
|
|
892
|
+
currency: { type: "string" },
|
|
893
|
+
duplicate: { type: "boolean" },
|
|
894
|
+
},
|
|
895
|
+
},
|
|
896
|
+
},
|
|
897
|
+
projectionTruncated: { type: "boolean" },
|
|
898
|
+
reviewImportUrl: { type: "string" },
|
|
899
|
+
confirmationContract: { type: "string" },
|
|
900
|
+
written: { type: "integer", minimum: 0 },
|
|
901
|
+
deduped: { type: "integer", minimum: 0 },
|
|
902
|
+
failed: { type: "integer", minimum: 0 },
|
|
903
|
+
unattempted: { type: "integer", minimum: 0 },
|
|
904
|
+
total: { type: "integer", minimum: 0 },
|
|
905
|
+
spreadsheetUrl: { type: ["string", "null"] },
|
|
906
|
+
reviewIncomeUrl: { type: "string" },
|
|
907
|
+
finalAnswer: { type: "string" },
|
|
908
|
+
responseGuidance: { type: "string" },
|
|
909
|
+
idempotentReplay: { type: "boolean" },
|
|
910
|
+
},
|
|
911
|
+
allOf: [
|
|
912
|
+
{
|
|
913
|
+
if: { properties: { preview: { const: true } }, required: ["preview"] },
|
|
914
|
+
then: { required: ["previewId", "expiresAt", "entryCount", "entries", "confirmationContract"] },
|
|
915
|
+
},
|
|
916
|
+
{
|
|
917
|
+
if: { properties: { confirmed: { const: true } }, required: ["confirmed"] },
|
|
918
|
+
then: { required: ["previewId", "written", "deduped", "failed", "unattempted", "total"] },
|
|
919
|
+
},
|
|
920
|
+
],
|
|
921
|
+
};
|
|
922
|
+
|
|
923
|
+
const SEND_REPORT_TO_ACCOUNTING_OUTPUT_SCHEMA = {
|
|
924
|
+
type: "object",
|
|
925
|
+
required: ["success", "phase", "provider", "proposalId"],
|
|
926
|
+
additionalProperties: true,
|
|
927
|
+
properties: {
|
|
928
|
+
success: { type: "boolean" },
|
|
929
|
+
phase: { type: "string", enum: ["preview", "completed"] },
|
|
930
|
+
provider: { type: "string" },
|
|
931
|
+
proposalId: { type: "string" },
|
|
932
|
+
expiresAt: { type: "string", format: "date-time" },
|
|
933
|
+
organization: { type: "object", additionalProperties: true },
|
|
934
|
+
counts: { type: "object", additionalProperties: true },
|
|
935
|
+
units: { type: "array", items: { type: "object", additionalProperties: true } },
|
|
936
|
+
confirmationRequired: { type: "boolean" },
|
|
937
|
+
confirmationQuestion: { type: "string" },
|
|
938
|
+
confirmationContract: { type: "string" },
|
|
939
|
+
reportId: { type: "string" },
|
|
940
|
+
created: { type: "integer", minimum: 0 },
|
|
941
|
+
matchedExisting: { type: "integer", minimum: 0 },
|
|
942
|
+
skippedAlreadyPushed: { type: "integer", minimum: 0 },
|
|
943
|
+
omittedExpenses: { type: "integer", minimum: 0 },
|
|
944
|
+
reconciliationRequired: { type: "boolean" },
|
|
945
|
+
finalAnswer: { type: "string" },
|
|
946
|
+
responseGuidance: { type: "string" },
|
|
947
|
+
idempotentReplay: { type: "boolean" },
|
|
948
|
+
},
|
|
949
|
+
allOf: [
|
|
950
|
+
{
|
|
951
|
+
if: { properties: { phase: { const: "preview" } }, required: ["phase"] },
|
|
952
|
+
then: { required: ["expiresAt", "confirmationRequired", "confirmationQuestion", "confirmationContract"] },
|
|
953
|
+
},
|
|
954
|
+
{
|
|
955
|
+
if: { properties: { phase: { const: "completed" } }, required: ["phase"] },
|
|
956
|
+
then: { required: ["reportId", "finalAnswer", "responseGuidance"] },
|
|
957
|
+
},
|
|
958
|
+
],
|
|
959
|
+
};
|
|
960
|
+
|
|
961
|
+
const TRACE_DOCUMENT_OUTPUT_SCHEMA = {
|
|
962
|
+
type: "object",
|
|
963
|
+
required: ["success", "type", "message", "data"],
|
|
964
|
+
additionalProperties: true,
|
|
965
|
+
properties: {
|
|
966
|
+
success: { type: "boolean" },
|
|
967
|
+
type: { type: "string", const: "lineage_trace" },
|
|
968
|
+
message: { type: "string" },
|
|
969
|
+
data: {
|
|
970
|
+
type: "object",
|
|
971
|
+
additionalProperties: true,
|
|
972
|
+
properties: {
|
|
973
|
+
searchLabel: { type: "string" },
|
|
974
|
+
summary: { type: "object", additionalProperties: true },
|
|
975
|
+
events: { type: "array", items: { type: "object", additionalProperties: true } },
|
|
976
|
+
filters: { type: "object", additionalProperties: true },
|
|
977
|
+
},
|
|
978
|
+
},
|
|
979
|
+
},
|
|
980
|
+
};
|
|
981
|
+
|
|
982
|
+
const EXPORT_REPORT_OUTPUT_SCHEMA = {
|
|
983
|
+
type: "object",
|
|
984
|
+
required: ["success", "report", "urls", "expiresAt", "availableInReport", "notes"],
|
|
985
|
+
additionalProperties: true,
|
|
986
|
+
properties: {
|
|
987
|
+
success: { type: "boolean" },
|
|
988
|
+
report: {
|
|
989
|
+
type: "object",
|
|
990
|
+
required: ["title", "spreadsheetId"],
|
|
991
|
+
additionalProperties: true,
|
|
992
|
+
properties: {
|
|
993
|
+
id: { type: "string" },
|
|
994
|
+
title: { type: "string" },
|
|
995
|
+
status: { type: "string" },
|
|
996
|
+
spreadsheetId: { type: "string" },
|
|
997
|
+
},
|
|
998
|
+
},
|
|
999
|
+
urls: {
|
|
1000
|
+
type: "object",
|
|
1001
|
+
required: ["view", "pdf", "report"],
|
|
1002
|
+
additionalProperties: true,
|
|
1003
|
+
properties: {
|
|
1004
|
+
view: { type: "string" },
|
|
1005
|
+
pdf: { type: "string" },
|
|
1006
|
+
report: { type: "string" },
|
|
1007
|
+
},
|
|
1008
|
+
},
|
|
1009
|
+
expiresAt: { type: "string", format: "date-time" },
|
|
1010
|
+
availableInReport: { type: "array", items: { type: "string" } },
|
|
1011
|
+
notes: { type: "string" },
|
|
1012
|
+
},
|
|
1013
|
+
};
|
|
1014
|
+
|
|
1015
|
+
const SCAN_GMAIL_YEARS_OUTPUT_SCHEMA = {
|
|
1016
|
+
type: "object",
|
|
1017
|
+
required: ["success", "message"],
|
|
1018
|
+
additionalProperties: true,
|
|
1019
|
+
properties: {
|
|
1020
|
+
success: { type: "boolean" },
|
|
1021
|
+
message: { type: "string" },
|
|
1022
|
+
preview: { type: "boolean" },
|
|
1023
|
+
account: { type: "string" },
|
|
1024
|
+
startedYear: { type: ["integer", "null"] },
|
|
1025
|
+
eligible: { type: "array", items: { type: "integer" } },
|
|
1026
|
+
queuedYears: { type: "array", items: { type: "integer" } },
|
|
1027
|
+
alreadyScanned: { type: "array", items: { type: "integer" } },
|
|
1028
|
+
alreadyQueued: { type: "array", items: { type: "integer" } },
|
|
1029
|
+
scanning: { type: "array", items: { type: "integer" } },
|
|
1030
|
+
notEligible: {
|
|
1031
|
+
type: "array",
|
|
1032
|
+
items: {
|
|
1033
|
+
type: "object",
|
|
1034
|
+
required: ["year", "reason"],
|
|
1035
|
+
additionalProperties: true,
|
|
1036
|
+
properties: {
|
|
1037
|
+
year: { type: "integer" },
|
|
1038
|
+
reason: { type: "string" },
|
|
1039
|
+
code: { type: "string" },
|
|
1040
|
+
},
|
|
1041
|
+
},
|
|
1042
|
+
},
|
|
1043
|
+
archiveThroughYear: { type: "integer" },
|
|
1044
|
+
gmailUrl: { type: "string" },
|
|
1045
|
+
},
|
|
1046
|
+
allOf: [
|
|
1047
|
+
{
|
|
1048
|
+
if: { properties: { preview: { const: true } }, required: ["preview"] },
|
|
1049
|
+
then: { required: ["account", "eligible", "alreadyScanned", "notEligible"] },
|
|
1050
|
+
},
|
|
1051
|
+
],
|
|
1052
|
+
};
|
|
1053
|
+
|
|
1054
|
+
const PREPARE_CLIENT_INVOICE_OUTPUT_SCHEMA = {
|
|
1055
|
+
type: "object",
|
|
1056
|
+
required: ["success", "preparationId", "expiresAt", "preview"],
|
|
1057
|
+
additionalProperties: true,
|
|
1058
|
+
properties: {
|
|
1059
|
+
success: { type: "boolean" },
|
|
1060
|
+
preparationId: { type: "string" },
|
|
1061
|
+
expiresAt: { type: "string", format: "date-time" },
|
|
1062
|
+
preview: {
|
|
1063
|
+
type: "object",
|
|
1064
|
+
additionalProperties: true,
|
|
1065
|
+
properties: {
|
|
1066
|
+
reportId: { type: "string" },
|
|
1067
|
+
reportTitle: { type: "string" },
|
|
1068
|
+
invoiceNumber: { type: "string" },
|
|
1069
|
+
issueDate: { type: "string", format: "date" },
|
|
1070
|
+
dueDate: { type: "string", format: "date" },
|
|
1071
|
+
paymentTerms: { type: "string" },
|
|
1072
|
+
clientName: { type: "string" },
|
|
1073
|
+
clientTag: { type: "string" },
|
|
1074
|
+
currency: { type: "string" },
|
|
1075
|
+
expenseCount: { type: "integer", minimum: 0 },
|
|
1076
|
+
customLineCount: { type: "integer", minimum: 0 },
|
|
1077
|
+
subtotal: { type: "number" },
|
|
1078
|
+
markupPct: { type: "number" },
|
|
1079
|
+
markupAmount: { type: "number" },
|
|
1080
|
+
taxPct: { type: "number" },
|
|
1081
|
+
taxLabel: { type: "string" },
|
|
1082
|
+
taxAmount: { type: "number" },
|
|
1083
|
+
grandTotal: { type: "number" },
|
|
1084
|
+
advanceApplied: { type: "number" },
|
|
1085
|
+
balanceDue: { type: "number" },
|
|
1086
|
+
taxConfirmationRequired: { type: "boolean" },
|
|
1087
|
+
hasTaxRegistration: { type: "boolean" },
|
|
1088
|
+
},
|
|
1089
|
+
},
|
|
1090
|
+
},
|
|
1091
|
+
};
|
|
1092
|
+
|
|
1093
|
+
const CREATE_CLIENT_INVOICE_OUTPUT_SCHEMA = {
|
|
1094
|
+
type: "object",
|
|
1095
|
+
required: ["success"],
|
|
1096
|
+
additionalProperties: true,
|
|
1097
|
+
properties: {
|
|
1098
|
+
success: { type: "boolean" },
|
|
1099
|
+
recovered: { type: "boolean" },
|
|
1100
|
+
invoiceId: { type: ["string", "null"] },
|
|
1101
|
+
invoiceNumber: { type: ["string", "null"] },
|
|
1102
|
+
clientName: { type: ["string", "null"] },
|
|
1103
|
+
status: { type: "string" },
|
|
1104
|
+
total: { type: "number" },
|
|
1105
|
+
grandTotal: { type: "number" },
|
|
1106
|
+
advanceApplied: { type: "number" },
|
|
1107
|
+
currency: { type: "string" },
|
|
1108
|
+
issueDate: { type: ["string", "null"], format: "date" },
|
|
1109
|
+
dueDate: { type: ["string", "null"], format: "date" },
|
|
1110
|
+
documentUrl: { type: ["string", "null"] },
|
|
1111
|
+
pdfUrl: { type: ["string", "null"] },
|
|
1112
|
+
docxUrl: { type: ["string", "null"] },
|
|
1113
|
+
sourceReportId: { type: ["string", "null"] },
|
|
1114
|
+
artifactWarning: { type: "string" },
|
|
1115
|
+
},
|
|
1116
|
+
};
|
|
1117
|
+
|
|
1118
|
+
const MARK_CLIENT_INVOICE_PAID_OUTPUT_SCHEMA = {
|
|
1119
|
+
type: "object",
|
|
1120
|
+
required: ["success", "invoiceId", "status", "paidDate", "paidAmount", "paidVia", "incomeRowCreated", "message"],
|
|
1121
|
+
additionalProperties: true,
|
|
1122
|
+
properties: {
|
|
1123
|
+
success: { type: "boolean" },
|
|
1124
|
+
invoiceId: { type: "string" },
|
|
1125
|
+
invoiceNumber: { type: ["string", "null"] },
|
|
1126
|
+
status: { type: "string", const: "paid" },
|
|
1127
|
+
paidDate: { type: "string", format: "date" },
|
|
1128
|
+
paidAmount: { type: ["number", "null"] },
|
|
1129
|
+
paidVia: { type: "string" },
|
|
1130
|
+
incomeRowCreated: { type: "boolean", const: false },
|
|
1131
|
+
message: { type: "string" },
|
|
1132
|
+
},
|
|
1133
|
+
};
|
|
1134
|
+
|
|
1135
|
+
const GROUP_EXPENSES_OUTPUT_SCHEMA = {
|
|
1136
|
+
type: "object",
|
|
1137
|
+
required: ["success", "status"],
|
|
1138
|
+
additionalProperties: true,
|
|
1139
|
+
properties: {
|
|
1140
|
+
success: { type: "boolean" },
|
|
1141
|
+
status: { type: "string" },
|
|
1142
|
+
operationId: { type: "string" },
|
|
1143
|
+
group: { type: "object", additionalProperties: true },
|
|
1144
|
+
candidates: { type: "array", items: { type: "object", additionalProperties: true } },
|
|
1145
|
+
suggestedTag: { type: "string" },
|
|
1146
|
+
preview: { type: "object", additionalProperties: true },
|
|
1147
|
+
manifest: { type: "object", additionalProperties: true },
|
|
1148
|
+
requiresConfirmation: { type: "boolean" },
|
|
1149
|
+
requiresNewGroupApproval: { type: "boolean" },
|
|
1150
|
+
confirmation: { type: "object", additionalProperties: true },
|
|
1151
|
+
exclusions: { type: "object", additionalProperties: true },
|
|
1152
|
+
reviewExpensesUrl: { type: "string" },
|
|
1153
|
+
reportsUrl: { type: "string" },
|
|
1154
|
+
report: { type: "object", additionalProperties: true },
|
|
1155
|
+
undo: { type: "object", additionalProperties: true },
|
|
1156
|
+
creationStatus: { type: "string" },
|
|
1157
|
+
message: { type: "string" },
|
|
1158
|
+
finalAnswer: { type: "string" },
|
|
1159
|
+
responseGuidance: { type: "string" },
|
|
1160
|
+
},
|
|
1161
|
+
};
|
|
1162
|
+
|
|
1163
|
+
const UPDATE_EXPENSE_OUTPUT_SCHEMA = {
|
|
1164
|
+
type: "object",
|
|
1165
|
+
required: ["success", "message", "data"],
|
|
1166
|
+
additionalProperties: true,
|
|
1167
|
+
properties: {
|
|
1168
|
+
success: { type: "boolean" },
|
|
1169
|
+
message: { type: "string" },
|
|
1170
|
+
data: {
|
|
1171
|
+
type: "object",
|
|
1172
|
+
required: ["applied", "expenseId", "diff", "unmapped"],
|
|
1173
|
+
additionalProperties: true,
|
|
1174
|
+
properties: {
|
|
1175
|
+
applied: { type: "boolean" },
|
|
1176
|
+
preview: { type: "boolean" },
|
|
1177
|
+
dryRun: { type: "boolean" },
|
|
1178
|
+
expenseId: { type: "string" },
|
|
1179
|
+
diff: {
|
|
1180
|
+
type: "array",
|
|
1181
|
+
items: {
|
|
1182
|
+
type: "object",
|
|
1183
|
+
required: ["field", "from", "to"],
|
|
1184
|
+
additionalProperties: true,
|
|
1185
|
+
properties: {
|
|
1186
|
+
field: { type: "string" },
|
|
1187
|
+
column: { type: "string" },
|
|
1188
|
+
columnLetter: { type: "string" },
|
|
1189
|
+
from: {},
|
|
1190
|
+
to: {},
|
|
1191
|
+
},
|
|
1192
|
+
},
|
|
1193
|
+
},
|
|
1194
|
+
unmapped: { type: "array", items: { type: "string" } },
|
|
1195
|
+
reviewExpenseUrl: { type: "string" },
|
|
1196
|
+
},
|
|
1197
|
+
},
|
|
1198
|
+
finalAnswer: { type: "string" },
|
|
1199
|
+
responseGuidance: { type: "string" },
|
|
1200
|
+
},
|
|
1201
|
+
};
|
|
1202
|
+
|
|
1203
|
+
const CORRECT_EXPENSES_OUTPUT_SCHEMA = {
|
|
1204
|
+
type: "object",
|
|
1205
|
+
required: ["success", "status"],
|
|
1206
|
+
additionalProperties: true,
|
|
1207
|
+
properties: {
|
|
1208
|
+
success: { type: "boolean" },
|
|
1209
|
+
status: { type: "string" },
|
|
1210
|
+
operationId: { type: "string" },
|
|
1211
|
+
change: { type: "object", additionalProperties: true },
|
|
1212
|
+
preview: { type: "object", additionalProperties: true },
|
|
1213
|
+
manifest: { type: "object", additionalProperties: true },
|
|
1214
|
+
requiresConfirmation: { type: "boolean" },
|
|
1215
|
+
confirmation: { type: "object", additionalProperties: true },
|
|
1216
|
+
message: { type: "string" },
|
|
1217
|
+
finalAnswer: { type: "string" },
|
|
1218
|
+
reviewExpensesUrl: { type: "string" },
|
|
1219
|
+
responseGuidance: { type: "string" },
|
|
1220
|
+
undo: { type: "object", additionalProperties: true },
|
|
1221
|
+
},
|
|
1222
|
+
};
|
|
1223
|
+
|
|
1224
|
+
// `fix_compliance` is a compatibility entry point for the reviewed expense
|
|
1225
|
+
// correction workflow. Keep one input contract so the alias cannot drift back
|
|
1226
|
+
// to the legacy row-based batch writer.
|
|
1227
|
+
const REVIEWED_EXPENSE_CORRECTION_INPUT_SCHEMA = {
|
|
1228
|
+
type: "object",
|
|
1229
|
+
additionalProperties: false,
|
|
1230
|
+
properties: {
|
|
1231
|
+
change: {
|
|
1232
|
+
type: "object",
|
|
1233
|
+
additionalProperties: false,
|
|
1234
|
+
description:
|
|
1235
|
+
"Exactly one correction. The selected type determines which matching value field is required.",
|
|
1236
|
+
properties: {
|
|
1237
|
+
type: {
|
|
1238
|
+
type: "string",
|
|
1239
|
+
enum: ["category", "businessPurpose", "attendees"],
|
|
1240
|
+
description:
|
|
1241
|
+
"The one correction kind to apply to every exact selected expense.",
|
|
1242
|
+
},
|
|
1243
|
+
category: {
|
|
1244
|
+
type: "string",
|
|
1245
|
+
description:
|
|
1246
|
+
"Configured expense category to apply when type is category.",
|
|
1247
|
+
},
|
|
1248
|
+
businessPurpose: {
|
|
1249
|
+
type: "string",
|
|
1250
|
+
description:
|
|
1251
|
+
"User-supplied business purpose to apply when type is businessPurpose.",
|
|
1252
|
+
},
|
|
1253
|
+
attendees: {
|
|
1254
|
+
type: "array",
|
|
1255
|
+
minItems: 1,
|
|
1256
|
+
maxItems: 25,
|
|
1257
|
+
items: { type: "string" },
|
|
1258
|
+
description:
|
|
1259
|
+
"Attendee names explicitly supplied by the user when type is attendees; never infer names.",
|
|
1260
|
+
},
|
|
1261
|
+
attendeeMode: {
|
|
1262
|
+
type: "string",
|
|
1263
|
+
enum: ["add", "replace"],
|
|
1264
|
+
description:
|
|
1265
|
+
"Use add unless the user explicitly asks to replace existing attendees.",
|
|
1266
|
+
},
|
|
1267
|
+
},
|
|
1268
|
+
required: ["type"],
|
|
1269
|
+
oneOf: [
|
|
1270
|
+
{
|
|
1271
|
+
properties: { type: { const: "category" } },
|
|
1272
|
+
required: ["category"],
|
|
1273
|
+
},
|
|
1274
|
+
{
|
|
1275
|
+
properties: { type: { const: "businessPurpose" } },
|
|
1276
|
+
required: ["businessPurpose"],
|
|
1277
|
+
},
|
|
1278
|
+
{
|
|
1279
|
+
properties: { type: { const: "attendees" } },
|
|
1280
|
+
required: ["attendees"],
|
|
1281
|
+
},
|
|
1282
|
+
],
|
|
1283
|
+
},
|
|
1284
|
+
selection: {
|
|
1285
|
+
type: "object",
|
|
1286
|
+
additionalProperties: false,
|
|
1287
|
+
description:
|
|
1288
|
+
"Exact expenses returned by search_expenses and approved for this bounded correction.",
|
|
1289
|
+
properties: {
|
|
1290
|
+
items: {
|
|
1291
|
+
type: "array",
|
|
1292
|
+
minItems: 1,
|
|
1293
|
+
maxItems: 100,
|
|
1294
|
+
description:
|
|
1295
|
+
"One exact receipt identity per selected expense; never broaden this list after preview.",
|
|
1296
|
+
items: {
|
|
1297
|
+
type: "object",
|
|
1298
|
+
additionalProperties: false,
|
|
1299
|
+
properties: {
|
|
1300
|
+
receiptId: {
|
|
1301
|
+
type: "string",
|
|
1302
|
+
description:
|
|
1303
|
+
"Exact full expenseId/Column-Q receipt identity from search_expenses.",
|
|
1304
|
+
},
|
|
1305
|
+
expected: {
|
|
1306
|
+
type: "object",
|
|
1307
|
+
additionalProperties: false,
|
|
1308
|
+
description:
|
|
1309
|
+
"Optional optimistic-concurrency values copied from the search result.",
|
|
1310
|
+
properties: {
|
|
1311
|
+
category: {
|
|
1312
|
+
type: "string",
|
|
1313
|
+
description:
|
|
1314
|
+
"Current category observed before preview for conflict detection.",
|
|
1315
|
+
},
|
|
1316
|
+
notes: {
|
|
1317
|
+
type: "string",
|
|
1318
|
+
description:
|
|
1319
|
+
"Current structured Notes value observed before preview for conflict detection.",
|
|
1320
|
+
},
|
|
1321
|
+
},
|
|
1322
|
+
},
|
|
1323
|
+
},
|
|
1324
|
+
required: ["receiptId"],
|
|
1325
|
+
},
|
|
1326
|
+
},
|
|
1327
|
+
},
|
|
1328
|
+
required: ["items"],
|
|
1329
|
+
},
|
|
1330
|
+
operationId: {
|
|
1331
|
+
type: "string",
|
|
1332
|
+
pattern: "^expense-bulk:[a-zA-Z0-9_-]{8,100}$",
|
|
1333
|
+
description:
|
|
1334
|
+
"Stable idempotency key generated once for preview and reused unchanged.",
|
|
1335
|
+
},
|
|
1336
|
+
confirm: {
|
|
1337
|
+
type: "boolean",
|
|
1338
|
+
description: "Omit/false for preview; true only after explicit approval.",
|
|
1339
|
+
},
|
|
1340
|
+
status: {
|
|
1341
|
+
type: "boolean",
|
|
1342
|
+
description: "Read operation status using operationId.",
|
|
1343
|
+
},
|
|
1344
|
+
undo: {
|
|
1345
|
+
type: "boolean",
|
|
1346
|
+
description: "Undo a completed correction within its Undo window.",
|
|
1347
|
+
},
|
|
1348
|
+
},
|
|
1349
|
+
required: ["operationId"],
|
|
1350
|
+
};
|
|
1351
|
+
|
|
589
1352
|
// ── Tool Definitions ───────────────────────────────────────────────────
|
|
590
1353
|
|
|
591
1354
|
// Output contracts for the first, highest-guess-cost tranche. `required`
|
|
@@ -682,8 +1445,10 @@ const GET_LAST_RECEIPT_RESULT_OUTPUT_SCHEMA = {
|
|
|
682
1445
|
message: { type: "string" },
|
|
683
1446
|
verdict: {
|
|
684
1447
|
type: "string",
|
|
685
|
-
enum: ["added", "duplicate", "skipped", "errored", "mixed", "unknown"],
|
|
686
|
-
description:
|
|
1448
|
+
enum: ["added", "duplicate", "skipped", "errored", "mixed", "unknown", "held_for_review"],
|
|
1449
|
+
description:
|
|
1450
|
+
"Terminal branch only. held_for_review: every file was held for review, so none was added. " +
|
|
1451
|
+
"mixed also covers any batch that includes held files.",
|
|
687
1452
|
},
|
|
688
1453
|
counts: {
|
|
689
1454
|
type: "object",
|
|
@@ -695,9 +1460,18 @@ const GET_LAST_RECEIPT_RESULT_OUTPUT_SCHEMA = {
|
|
|
695
1460
|
duplicates: { type: "integer", minimum: 0 },
|
|
696
1461
|
skipped: { type: "integer", minimum: 0 },
|
|
697
1462
|
errors: { type: "integer", minimum: 0 },
|
|
1463
|
+
heldForReview: {
|
|
1464
|
+
type: "integer",
|
|
1465
|
+
minimum: 0,
|
|
1466
|
+
description: "Files held for review and not added. Present only when at least one.",
|
|
1467
|
+
},
|
|
698
1468
|
},
|
|
699
1469
|
},
|
|
700
|
-
receipts: {
|
|
1470
|
+
receipts: {
|
|
1471
|
+
type: "array",
|
|
1472
|
+
description: "Processed receipt summaries. Held files are not listed here; see data.outcomes.",
|
|
1473
|
+
items: { type: "object", additionalProperties: true },
|
|
1474
|
+
},
|
|
701
1475
|
submissionId: { type: ["string", "null"] },
|
|
702
1476
|
spreadsheetUrl: { type: ["string", "null"] },
|
|
703
1477
|
reviewExpensesUrl: { type: "string" },
|
|
@@ -871,6 +1645,7 @@ const TOOLS = [
|
|
|
871
1645
|
},
|
|
872
1646
|
{
|
|
873
1647
|
name: "create_report",
|
|
1648
|
+
outputSchema: CREATE_REPORT_OUTPUT_SCHEMA,
|
|
874
1649
|
description:
|
|
875
1650
|
"Create an expense report from a clear date, client, project, trip, " +
|
|
876
1651
|
"category, or merchant request. Tags are ExpenseBot's grouping layer " +
|
|
@@ -973,6 +1748,7 @@ const TOOLS = [
|
|
|
973
1748
|
},
|
|
974
1749
|
{
|
|
975
1750
|
name: "request_accounting_integration",
|
|
1751
|
+
outputSchema: REQUEST_ACCOUNTING_INTEGRATION_OUTPUT_SCHEMA,
|
|
976
1752
|
description:
|
|
977
1753
|
"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
1754
|
inputSchema: {
|
|
@@ -1011,6 +1787,7 @@ const TOOLS = [
|
|
|
1011
1787
|
},
|
|
1012
1788
|
{
|
|
1013
1789
|
name: "share_report",
|
|
1790
|
+
outputSchema: SHARE_REPORT_OUTPUT_SCHEMA,
|
|
1014
1791
|
description:
|
|
1015
1792
|
"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.",
|
|
1016
1793
|
inputSchema: {
|
|
@@ -1056,21 +1833,15 @@ const TOOLS = [
|
|
|
1056
1833
|
},
|
|
1057
1834
|
{
|
|
1058
1835
|
name: "fix_compliance",
|
|
1836
|
+
outputSchema: CORRECT_EXPENSES_OUTPUT_SCHEMA,
|
|
1059
1837
|
description:
|
|
1060
|
-
"
|
|
1061
|
-
"
|
|
1062
|
-
|
|
1063
|
-
|
|
1064
|
-
|
|
1065
|
-
|
|
1066
|
-
|
|
1067
|
-
type: "string",
|
|
1068
|
-
enum: ["add_purpose", "set_category", "add_tag"],
|
|
1069
|
-
},
|
|
1070
|
-
value: { type: "string", description: "The value to apply" },
|
|
1071
|
-
},
|
|
1072
|
-
required: ["reportId", "action", "value"],
|
|
1073
|
-
},
|
|
1838
|
+
"Safely correct compliance issues on an exact bounded set of recorded expenses. " +
|
|
1839
|
+
"Use only after the user explicitly asks to fix issues found by check_compliance. " +
|
|
1840
|
+
"Use search_expenses to obtain each full expenseId, then pass those exact identities; never select every report row or infer a business purpose, category, or attendee. " +
|
|
1841
|
+
"This compatibility tool uses the same reviewed workflow as correct_expenses: the first call always prepares a grounded preview and makes no change, even if confirm:true arrives early. " +
|
|
1842
|
+
"Show the exact proposed changes and ask once for approval. Only after explicit approval repeat the same operationId, selection, and change with confirm:true. " +
|
|
1843
|
+
"The confirmed result reports applied/conflicted/failed counts and supports status and Undo. For tags/groups use group_expenses; for unsupported or more than 100-row cleanup open https://www.expensebot.ai/review-expenses?source=mcp.",
|
|
1844
|
+
inputSchema: REVIEWED_EXPENSE_CORRECTION_INPUT_SCHEMA,
|
|
1074
1845
|
},
|
|
1075
1846
|
{
|
|
1076
1847
|
name: "check_tax_deductibility",
|
|
@@ -1133,6 +1904,7 @@ const TOOLS = [
|
|
|
1133
1904
|
},
|
|
1134
1905
|
{
|
|
1135
1906
|
name: "submit_receipt",
|
|
1907
|
+
outputSchema: SUBMIT_RECEIPT_OUTPUT_SCHEMA,
|
|
1136
1908
|
_meta: { "openai/fileParams": ["photo"] },
|
|
1137
1909
|
description:
|
|
1138
1910
|
"Submit a photo or PDF of a receipt for processing. Covers requests " +
|
|
@@ -1294,8 +2066,9 @@ const TOOLS = [
|
|
|
1294
2066
|
"tool with that exact ID using the polling interval and time allowance in " +
|
|
1295
2067
|
"the submit_receipt response. A small batch allows at least 5 minutes; larger " +
|
|
1296
2068
|
"batches allow longer. A pending result is normal and must not trigger a " +
|
|
1297
|
-
"duplicate resubmission. Returns added, duplicate, skipped, or " +
|
|
2069
|
+
"duplicate resubmission. Returns added, duplicate, skipped, held_for_review, or " +
|
|
1298
2070
|
"errored verdicts with exact counts and up to 10 processed receipt summaries. " +
|
|
2071
|
+
"A held_for_review file (withheld for missing details or a possible duplicate) was not added; relay the next step in the message. " +
|
|
1299
2072
|
"found:false is pending and has no terminal verdict; found:true is terminal. " +
|
|
1300
2073
|
"On completion, tell the user what happened and show spreadsheetUrl plus " +
|
|
1301
2074
|
"reviewExpensesUrl. This is for uploaded receipts; use get_scan_status for " +
|
|
@@ -1321,6 +2094,7 @@ const TOOLS = [
|
|
|
1321
2094
|
},
|
|
1322
2095
|
{
|
|
1323
2096
|
name: "add_cash_expense",
|
|
2097
|
+
outputSchema: ADD_CASH_EXPENSE_OUTPUT_SCHEMA,
|
|
1324
2098
|
description:
|
|
1325
2099
|
"Add an expense without a receipt, or record money a client provided in advance for expenses. " +
|
|
1326
2100
|
"Writes directly to the user's expense spreadsheet after confirmation. For an ordinary expense, " +
|
|
@@ -1376,6 +2150,7 @@ const TOOLS = [
|
|
|
1376
2150
|
},
|
|
1377
2151
|
{
|
|
1378
2152
|
name: "parse_expense",
|
|
2153
|
+
outputSchema: PARSE_EXPENSE_OUTPUT_SCHEMA,
|
|
1379
2154
|
description:
|
|
1380
2155
|
"Parse a natural language expense description into structured fields. " +
|
|
1381
2156
|
"Does NOT add the expense — just returns the parsed fields for review. " +
|
|
@@ -1394,6 +2169,7 @@ const TOOLS = [
|
|
|
1394
2169
|
},
|
|
1395
2170
|
{
|
|
1396
2171
|
name: "process_gmail_receipts",
|
|
2172
|
+
outputSchema: PROCESS_GMAIL_RECEIPTS_OUTPUT_SCHEMA,
|
|
1397
2173
|
description:
|
|
1398
2174
|
"Process specific Gmail emails as receipts. Pass Gmail message IDs " +
|
|
1399
2175
|
"and they'll be converted to PDF, extracted by AI, and added to the " +
|
|
@@ -1418,6 +2194,7 @@ const TOOLS = [
|
|
|
1418
2194
|
},
|
|
1419
2195
|
{
|
|
1420
2196
|
name: "scan_gmail",
|
|
2197
|
+
outputSchema: SCAN_GMAIL_OUTPUT_SCHEMA,
|
|
1421
2198
|
description:
|
|
1422
2199
|
"Trigger a background Gmail scan to discover and process receipt " +
|
|
1423
2200
|
"emails from the last ~60 days (default). Runs asynchronously — " +
|
|
@@ -1470,6 +2247,7 @@ const TOOLS = [
|
|
|
1470
2247
|
},
|
|
1471
2248
|
{
|
|
1472
2249
|
name: "add_mileage_entry",
|
|
2250
|
+
outputSchema: ADD_MILEAGE_ENTRY_OUTPUT_SCHEMA,
|
|
1473
2251
|
description:
|
|
1474
2252
|
"Log a business mileage trip in ExpenseBot. Useful for realtors, " +
|
|
1475
2253
|
"consultants, contractors, and anyone who drives for work. Requires " +
|
|
@@ -1493,7 +2271,9 @@ const TOOLS = [
|
|
|
1493
2271
|
date: {
|
|
1494
2272
|
type: "string",
|
|
1495
2273
|
format: "date",
|
|
1496
|
-
description:
|
|
2274
|
+
description:
|
|
2275
|
+
"Trip date (YYYY-MM-DD). Required. Use the date the user gives; for \"today\" send " +
|
|
2276
|
+
"today's calendar date in their timezone. If no date was given, ask.",
|
|
1497
2277
|
},
|
|
1498
2278
|
roundTrip: {
|
|
1499
2279
|
type: "boolean",
|
|
@@ -1521,11 +2301,12 @@ const TOOLS = [
|
|
|
1521
2301
|
description: "Optional user-supplied context stored with the mileage entry.",
|
|
1522
2302
|
},
|
|
1523
2303
|
},
|
|
1524
|
-
required: ["distance", "purpose"],
|
|
2304
|
+
required: ["distance", "purpose", "date"],
|
|
1525
2305
|
},
|
|
1526
2306
|
},
|
|
1527
2307
|
{
|
|
1528
2308
|
name: "add_income",
|
|
2309
|
+
outputSchema: ADD_INCOME_OUTPUT_SCHEMA,
|
|
1529
2310
|
description:
|
|
1530
2311
|
"Log exactly one user-confirmed income payment manually (cash, check, Stripe payout, etc.). " +
|
|
1531
2312
|
"Never loop this tool over a statement, export, table, or multi-row list. For two or more " +
|
|
@@ -1550,7 +2331,9 @@ const TOOLS = [
|
|
|
1550
2331
|
date: {
|
|
1551
2332
|
type: "string",
|
|
1552
2333
|
format: "date",
|
|
1553
|
-
description:
|
|
2334
|
+
description:
|
|
2335
|
+
"Income date (YYYY-MM-DD). Required. Use the date the user gives; for \"today\" send " +
|
|
2336
|
+
"today's calendar date in their timezone. If no date was given, ask.",
|
|
1554
2337
|
},
|
|
1555
2338
|
currency: { type: "string", description: "Currency code (default: home currency)" },
|
|
1556
2339
|
description: { type: "string", description: "What the income was for" },
|
|
@@ -1561,11 +2344,12 @@ const TOOLS = [
|
|
|
1561
2344
|
tag: { type: "string", description: "Tag for client/project attribution" },
|
|
1562
2345
|
notes: { type: "string" },
|
|
1563
2346
|
},
|
|
1564
|
-
required: ["amount", "source", "paymentMethod"],
|
|
2347
|
+
required: ["amount", "source", "paymentMethod", "date"],
|
|
1565
2348
|
},
|
|
1566
2349
|
},
|
|
1567
2350
|
{
|
|
1568
2351
|
name: "add_income_from_file",
|
|
2352
|
+
outputSchema: INCOME_IMPORT_OUTPUT_SCHEMA,
|
|
1569
2353
|
_meta: { "openai/fileParams": ["photo"] },
|
|
1570
2354
|
description:
|
|
1571
2355
|
"Import income from an attached screenshot, image (JPEG, PNG, WebP, HEIC/HEIF), or PDF " +
|
|
@@ -1677,6 +2461,7 @@ const TOOLS = [
|
|
|
1677
2461
|
},
|
|
1678
2462
|
{
|
|
1679
2463
|
name: "add_income_from_csv",
|
|
2464
|
+
outputSchema: INCOME_IMPORT_OUTPUT_SCHEMA,
|
|
1680
2465
|
_meta: { "openai/fileParams": ["csvContent"] },
|
|
1681
2466
|
description:
|
|
1682
2467
|
"Import income from a CSV/TSV/text export (Stripe, PayPal, Square, Cash App, Venmo, " +
|
|
@@ -1803,6 +2588,7 @@ const TOOLS = [
|
|
|
1803
2588
|
},
|
|
1804
2589
|
{
|
|
1805
2590
|
name: "send_report_to_accounting",
|
|
2591
|
+
outputSchema: SEND_REPORT_TO_ACCOUNTING_OUTPUT_SCHEMA,
|
|
1806
2592
|
description:
|
|
1807
2593
|
"Review and then post an ExpenseBot report to the owner's accounting destination. " +
|
|
1808
2594
|
"STEP 1: call with provider, reportId, and optional mode/mappings, without confirm. The " +
|
|
@@ -2069,6 +2855,7 @@ const TOOLS = [
|
|
|
2069
2855
|
},
|
|
2070
2856
|
{
|
|
2071
2857
|
name: "trace_document",
|
|
2858
|
+
outputSchema: TRACE_DOCUMENT_OUTPUT_SCHEMA,
|
|
2072
2859
|
description:
|
|
2073
2860
|
"Trace what happened to a specific receipt, invoice, forwarded email, Gmail receipt, or PDF in ExpenseBot processing. " +
|
|
2074
2861
|
"Use when the user asks where a document went, why it did not show up, whether it was skipped, routed to income, deduped, or removed as a duplicate. " +
|
|
@@ -2206,6 +2993,7 @@ const TOOLS = [
|
|
|
2206
2993
|
},
|
|
2207
2994
|
{
|
|
2208
2995
|
name: "export_report",
|
|
2996
|
+
outputSchema: EXPORT_REPORT_OUTPUT_SCHEMA,
|
|
2209
2997
|
description:
|
|
2210
2998
|
"Get a short-lived direct PDF download for one exact authorized expense " +
|
|
2211
2999
|
"report, plus the exact highlighted in-app report link. Use the in-app " +
|
|
@@ -2266,7 +3054,7 @@ const TOOLS = [
|
|
|
2266
3054
|
"anything is saved. " +
|
|
2267
3055
|
"Team setup requests use the returned role-aware Team setup handoff: " +
|
|
2268
3056
|
"eligible solo business owners open Add teammates, while existing team " +
|
|
2269
|
-
"owners and co-admins open
|
|
3057
|
+
"owners and co-admins open Team Management. If the handoff says owner " +
|
|
2270
3058
|
"access is required, explain that instead of presenting a broken link. " +
|
|
2271
3059
|
"Complex or visually reviewed report requests " +
|
|
2272
3060
|
"use the returned Create report link. Read-only; this tool does " +
|
|
@@ -2393,6 +3181,7 @@ const TOOLS = [
|
|
|
2393
3181
|
},
|
|
2394
3182
|
{
|
|
2395
3183
|
name: "scan_gmail_years",
|
|
3184
|
+
outputSchema: SCAN_GMAIL_YEARS_OUTPUT_SCHEMA,
|
|
2396
3185
|
description:
|
|
2397
3186
|
"Scan one or more COMPLETED PRIOR years of the user's Gmail for " +
|
|
2398
3187
|
"receipts (e.g. years:[2023] or years:[2020,2021,2022]). Long-running " +
|
|
@@ -2496,6 +3285,7 @@ const TOOLS = [
|
|
|
2496
3285
|
},
|
|
2497
3286
|
{
|
|
2498
3287
|
name: "prepare_client_invoice",
|
|
3288
|
+
outputSchema: PREPARE_CLIENT_INVOICE_OUTPUT_SCHEMA,
|
|
2499
3289
|
description:
|
|
2500
3290
|
"Prepare a client invoice from a saved ExpenseBot report without creating it. " +
|
|
2501
3291
|
"Reads canonical report rows, allocates a unique invoice number, verifies the " +
|
|
@@ -2560,6 +3350,7 @@ const TOOLS = [
|
|
|
2560
3350
|
},
|
|
2561
3351
|
{
|
|
2562
3352
|
name: "create_client_invoice",
|
|
3353
|
+
outputSchema: CREATE_CLIENT_INVOICE_OUTPUT_SCHEMA,
|
|
2563
3354
|
description:
|
|
2564
3355
|
"Create the exact invoice previously returned by prepare_client_invoice. This is " +
|
|
2565
3356
|
"a confirmed write: it revalidates the report snapshot and client identity, creates " +
|
|
@@ -2602,6 +3393,7 @@ const TOOLS = [
|
|
|
2602
3393
|
},
|
|
2603
3394
|
{
|
|
2604
3395
|
name: "mark_client_invoice_paid",
|
|
3396
|
+
outputSchema: MARK_CLIENT_INVOICE_PAID_OUTPUT_SCHEMA,
|
|
2605
3397
|
description:
|
|
2606
3398
|
"Mark an issued client invoice as paid after explicit confirmation. Requires " +
|
|
2607
3399
|
"a strict calendar-valid paidDate in YYYY-MM-DD format. This updates the " +
|
|
@@ -2768,6 +3560,7 @@ const TOOLS = [
|
|
|
2768
3560
|
},
|
|
2769
3561
|
{
|
|
2770
3562
|
name: "group_expenses",
|
|
3563
|
+
outputSchema: GROUP_EXPENSES_OUTPUT_SCHEMA,
|
|
2771
3564
|
description:
|
|
2772
3565
|
"Group an exact set of recorded expenses for a client, project, trip, job, or other user-named purpose. " +
|
|
2773
3566
|
"Examples: 'group my Mexico meals for client Rob', 'put these Vegas expenses under the Vegas project', " +
|
|
@@ -2867,6 +3660,7 @@ const TOOLS = [
|
|
|
2867
3660
|
},
|
|
2868
3661
|
{
|
|
2869
3662
|
name: "update_expense",
|
|
3663
|
+
outputSchema: UPDATE_EXPENSE_OUTPUT_SCHEMA,
|
|
2870
3664
|
description:
|
|
2871
3665
|
"Update a single existing expense row's category, tag, merchant, or " +
|
|
2872
3666
|
"business purpose (e.g. 'recategorize expense X to Meals' or 'tag it " +
|
|
@@ -2908,6 +3702,7 @@ const TOOLS = [
|
|
|
2908
3702
|
},
|
|
2909
3703
|
{
|
|
2910
3704
|
name: "correct_expenses",
|
|
3705
|
+
outputSchema: CORRECT_EXPENSES_OUTPUT_SCHEMA,
|
|
2911
3706
|
description:
|
|
2912
3707
|
"Safely correct the category, business purpose, or explicit attendees on an exact bounded set of recorded expenses. " +
|
|
2913
3708
|
"Examples: 'categorize these as Travel', 'add Client kickoff dinner as the business purpose for these meals', or " +
|
|
@@ -2918,108 +3713,7 @@ const TOOLS = [
|
|
|
2918
3713
|
"Business purpose and attendees preserve the structured Notes field, including card, description, inbox, and other typed segments. Formula Notes and changes that exceed the Notes limit are skipped safely. " +
|
|
2919
3714
|
"The confirmed result reports applied/conflicted/failed counts and supports Undo. This tool does not omit duplicates, change amounts or dates, infer business context, or run broad Calendar matching. " +
|
|
2920
3715
|
"For unsupported or more than 100-row cleanup, send the user to https://www.expensebot.ai/review-expenses?source=mcp.",
|
|
2921
|
-
inputSchema:
|
|
2922
|
-
type: "object",
|
|
2923
|
-
additionalProperties: false,
|
|
2924
|
-
properties: {
|
|
2925
|
-
change: {
|
|
2926
|
-
type: "object",
|
|
2927
|
-
additionalProperties: false,
|
|
2928
|
-
description:
|
|
2929
|
-
"Exactly one correction. The selected type determines which matching value field is required.",
|
|
2930
|
-
properties: {
|
|
2931
|
-
type: {
|
|
2932
|
-
type: "string",
|
|
2933
|
-
enum: ["category", "businessPurpose", "attendees"],
|
|
2934
|
-
description: "The one correction kind to apply to every exact selected expense.",
|
|
2935
|
-
},
|
|
2936
|
-
category: {
|
|
2937
|
-
type: "string",
|
|
2938
|
-
description: "Configured expense category to apply when type is category.",
|
|
2939
|
-
},
|
|
2940
|
-
businessPurpose: {
|
|
2941
|
-
type: "string",
|
|
2942
|
-
description: "User-supplied business purpose to apply when type is businessPurpose.",
|
|
2943
|
-
},
|
|
2944
|
-
attendees: {
|
|
2945
|
-
type: "array",
|
|
2946
|
-
minItems: 1,
|
|
2947
|
-
maxItems: 25,
|
|
2948
|
-
items: { type: "string" },
|
|
2949
|
-
description: "Attendee names explicitly supplied by the user when type is attendees; never infer names.",
|
|
2950
|
-
},
|
|
2951
|
-
attendeeMode: {
|
|
2952
|
-
type: "string",
|
|
2953
|
-
enum: ["add", "replace"],
|
|
2954
|
-
description:
|
|
2955
|
-
"Use add unless the user explicitly asks to replace existing attendees.",
|
|
2956
|
-
},
|
|
2957
|
-
},
|
|
2958
|
-
required: ["type"],
|
|
2959
|
-
},
|
|
2960
|
-
selection: {
|
|
2961
|
-
type: "object",
|
|
2962
|
-
additionalProperties: false,
|
|
2963
|
-
description: "Exact expenses returned by search_expenses and approved for this bounded correction.",
|
|
2964
|
-
properties: {
|
|
2965
|
-
items: {
|
|
2966
|
-
type: "array",
|
|
2967
|
-
minItems: 1,
|
|
2968
|
-
maxItems: 100,
|
|
2969
|
-
description: "One exact receipt identity per selected expense; never broaden this list after preview.",
|
|
2970
|
-
items: {
|
|
2971
|
-
type: "object",
|
|
2972
|
-
additionalProperties: false,
|
|
2973
|
-
properties: {
|
|
2974
|
-
receiptId: {
|
|
2975
|
-
type: "string",
|
|
2976
|
-
description:
|
|
2977
|
-
"Exact full expenseId/Column-Q receipt identity from search_expenses.",
|
|
2978
|
-
},
|
|
2979
|
-
expected: {
|
|
2980
|
-
type: "object",
|
|
2981
|
-
additionalProperties: false,
|
|
2982
|
-
description:
|
|
2983
|
-
"Optional optimistic-concurrency values copied from the search result.",
|
|
2984
|
-
properties: {
|
|
2985
|
-
category: {
|
|
2986
|
-
type: "string",
|
|
2987
|
-
description: "Current category observed before preview for conflict detection.",
|
|
2988
|
-
},
|
|
2989
|
-
notes: {
|
|
2990
|
-
type: "string",
|
|
2991
|
-
description: "Current structured Notes value observed before preview for conflict detection.",
|
|
2992
|
-
},
|
|
2993
|
-
},
|
|
2994
|
-
},
|
|
2995
|
-
},
|
|
2996
|
-
required: ["receiptId"],
|
|
2997
|
-
},
|
|
2998
|
-
},
|
|
2999
|
-
},
|
|
3000
|
-
required: ["items"],
|
|
3001
|
-
},
|
|
3002
|
-
operationId: {
|
|
3003
|
-
type: "string",
|
|
3004
|
-
pattern: "^expense-bulk:[a-zA-Z0-9_-]{8,100}$",
|
|
3005
|
-
description:
|
|
3006
|
-
"Stable idempotency key generated once for preview and reused unchanged.",
|
|
3007
|
-
},
|
|
3008
|
-
confirm: {
|
|
3009
|
-
type: "boolean",
|
|
3010
|
-
description: "Omit/false for preview; true only after explicit approval.",
|
|
3011
|
-
},
|
|
3012
|
-
status: {
|
|
3013
|
-
type: "boolean",
|
|
3014
|
-
description: "Read operation status using operationId.",
|
|
3015
|
-
},
|
|
3016
|
-
undo: {
|
|
3017
|
-
type: "boolean",
|
|
3018
|
-
description: "Undo a completed correction within its Undo window.",
|
|
3019
|
-
},
|
|
3020
|
-
},
|
|
3021
|
-
required: ["operationId"],
|
|
3022
|
-
},
|
|
3716
|
+
inputSchema: REVIEWED_EXPENSE_CORRECTION_INPUT_SCHEMA,
|
|
3023
3717
|
},
|
|
3024
3718
|
];
|
|
3025
3719
|
|
|
@@ -3124,7 +3818,16 @@ async function handleTool(name, args) {
|
|
|
3124
3818
|
);
|
|
3125
3819
|
|
|
3126
3820
|
case "fix_compliance":
|
|
3127
|
-
return formatResultWithSchema(name,
|
|
3821
|
+
return formatResultWithSchema(name,
|
|
3822
|
+
await client.execute("correct_expenses", {
|
|
3823
|
+
change: args.change,
|
|
3824
|
+
selection: args.selection,
|
|
3825
|
+
operationId: args.operationId,
|
|
3826
|
+
confirm: args.confirm,
|
|
3827
|
+
status: args.status,
|
|
3828
|
+
undo: args.undo,
|
|
3829
|
+
})
|
|
3830
|
+
);
|
|
3128
3831
|
|
|
3129
3832
|
case "check_tax_deductibility":
|
|
3130
3833
|
return formatResultWithSchema(name,
|
|
@@ -3408,7 +4111,7 @@ async function handleTool(name, args) {
|
|
|
3408
4111
|
url.searchParams.set("query", args?.feature || "");
|
|
3409
4112
|
url.searchParams.set("utm_source", "mcp-onboarding");
|
|
3410
4113
|
const res = await fetch(url.toString(), {
|
|
3411
|
-
headers: { "User-Agent": "expensebot-mcp-auth/0.6.
|
|
4114
|
+
headers: { "User-Agent": "expensebot-mcp-auth/0.6.26" },
|
|
3412
4115
|
});
|
|
3413
4116
|
const data = await res.json();
|
|
3414
4117
|
return formatResultWithSchema(name, data);
|
|
@@ -3718,7 +4421,7 @@ function formatResultWithSchema(toolName, result) {
|
|
|
3718
4421
|
|
|
3719
4422
|
async function main() {
|
|
3720
4423
|
const server = new Server(
|
|
3721
|
-
{ name: "expensebot-auth", version: "0.6.
|
|
4424
|
+
{ name: "expensebot-auth", version: "0.6.26" },
|
|
3722
4425
|
{ capabilities: { tools: {} }, instructions: SERVER_INSTRUCTIONS }
|
|
3723
4426
|
);
|
|
3724
4427
|
|