@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/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: "Terminal branch only.",
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: { type: "array", items: { type: "object", additionalProperties: true } },
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
- "Bulk-fix compliance issues in a report (e.g., apply the same " +
1061
- "business purpose to all flagged expenses).",
1062
- inputSchema: {
1063
- type: "object",
1064
- properties: {
1065
- reportId: { type: "string" },
1066
- action: {
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: "Trip date (YYYY-MM-DD). Defaults to today.",
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: "Income date (YYYY-MM-DD). Defaults to today.",
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 License Manager. If the handoff says owner " +
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, await client.execute("batch_fix", args));
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.25" },
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.25" },
4424
+ { name: "expensebot-auth", version: "0.6.26" },
3722
4425
  { capabilities: { tools: {} }, instructions: SERVER_INSTRUCTIONS }
3723
4426
  );
3724
4427