@warmio/contracts 3.0.9 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/dist/api/endpoints.d.ts +21 -0
  2. package/dist/api/endpoints.d.ts.map +1 -1
  3. package/dist/api/endpoints.js +17 -0
  4. package/dist/api/endpoints.js.map +1 -1
  5. package/dist/financial-context-artifact-protocol.d.ts +36 -0
  6. package/dist/financial-context-artifact-protocol.d.ts.map +1 -1
  7. package/dist/generated/mcp-package-release-metadata.d.ts +1 -1
  8. package/dist/generated/mcp-package-release-metadata.d.ts.map +1 -1
  9. package/dist/generated/mcp-package-release-metadata.js +1 -1
  10. package/dist/generated/mcp-package-release-metadata.js.map +1 -1
  11. package/dist/generated/private-mcp-tool-descriptors.d.ts +27 -0
  12. package/dist/generated/private-mcp-tool-descriptors.d.ts.map +1 -1
  13. package/dist/generated/private-mcp-tool-descriptors.js +36 -0
  14. package/dist/generated/private-mcp-tool-descriptors.js.map +1 -1
  15. package/dist/generated/warm-app-api-manifest.d.ts +32 -5
  16. package/dist/generated/warm-app-api-manifest.d.ts.map +1 -1
  17. package/dist/generated/warm-app-api-manifest.js +41 -5
  18. package/dist/generated/warm-app-api-manifest.js.map +1 -1
  19. package/dist/index.d.ts +1 -0
  20. package/dist/index.d.ts.map +1 -1
  21. package/dist/index.js +1 -0
  22. package/dist/index.js.map +1 -1
  23. package/dist/mcp/card-benefits.d.ts +380 -0
  24. package/dist/mcp/card-benefits.d.ts.map +1 -0
  25. package/dist/mcp/card-benefits.js +109 -0
  26. package/dist/mcp/card-benefits.js.map +1 -0
  27. package/dist/mcp/findings.d.ts +1595 -0
  28. package/dist/mcp/findings.d.ts.map +1 -0
  29. package/dist/mcp/findings.js +172 -0
  30. package/dist/mcp/findings.js.map +1 -0
  31. package/dist/mcp/hosted-write-tools.d.ts +1335 -1
  32. package/dist/mcp/hosted-write-tools.d.ts.map +1 -1
  33. package/dist/mcp/hosted-write-tools.js +18 -0
  34. package/dist/mcp/hosted-write-tools.js.map +1 -1
  35. package/dist/mcp/index.d.ts +2 -0
  36. package/dist/mcp/index.d.ts.map +1 -1
  37. package/dist/mcp/index.js +2 -0
  38. package/dist/mcp/index.js.map +1 -1
  39. package/dist/mcp/public-output.d.ts +241 -3
  40. package/dist/mcp/public-output.d.ts.map +1 -1
  41. package/dist/mcp/public-output.js +35 -2
  42. package/dist/mcp/public-output.js.map +1 -1
  43. package/dist/mcp/public-tools.d.ts +196 -4
  44. package/dist/mcp/public-tools.d.ts.map +1 -1
  45. package/dist/mcp/public-tools.js +7 -3
  46. package/dist/mcp/public-tools.js.map +1 -1
  47. package/dist/mcp/tools.d.ts +68 -0
  48. package/dist/mcp/tools.d.ts.map +1 -1
  49. package/dist/schemas/financial-context.d.ts +26 -0
  50. package/dist/schemas/financial-context.d.ts.map +1 -1
  51. package/dist/schemas/financial-context.js +2 -0
  52. package/dist/schemas/financial-context.js.map +1 -1
  53. package/dist/scrub-text.d.ts +4 -0
  54. package/dist/scrub-text.d.ts.map +1 -0
  55. package/dist/scrub-text.js +18 -0
  56. package/dist/scrub-text.js.map +1 -0
  57. package/package.json +1 -1
@@ -545,7 +545,7 @@ export declare const publicMcpToolDefinitions: readonly [{
545
545
  }, {
546
546
  readonly name: "get_transactions";
547
547
  readonly title: "Get transactions";
548
- readonly description: "Read-only transaction pages from the financial context. Pass `period: \"latest\"` for the fixed 10-day window or `period: \"YYYY-MM\"` for a month page. Transaction items include date, amount, category, subcategory, pending, and currency; IDs, account details, merchants, and names are omitted. The latest window is not caller-configurable. Months outside the covered range return an error listing the covered months. Empty months inside the range are accepted.";
548
+ readonly description: "Read-only transaction pages from the financial context. Pass `period: \"latest\"` for the fixed 10-day window or `period: \"YYYY-MM\"` for a month page, or `periods` for two or three month pages. Transaction items include date, amount, category, subcategory, pending, and currency; IDs, account details, merchants, and names are omitted. When the account owner has turned off the personal info filter, items also include merchant, name, notes, and tags. The latest window is not caller-configurable. Months outside the covered range return an error listing the covered months. Empty months inside the range are accepted.";
549
549
  readonly annotations: {
550
550
  readonly readOnlyHint: true;
551
551
  readonly destructiveHint: false;
@@ -572,21 +572,30 @@ export declare const publicMcpToolDefinitions: readonly [{
572
572
  subcategory: z.ZodNullable<z.ZodString>;
573
573
  pending: z.ZodNullable<z.ZodBoolean>;
574
574
  currency: z.ZodNullable<z.ZodString>;
575
+ notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
576
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
575
577
  is_internal_transfer: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
576
578
  transfer_pair_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
577
579
  transfers_interpretation_version: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
578
580
  merchants_interpretation_version: z.ZodOptional<z.ZodLiteral<0>>;
579
- }, "amount" | "category" | "currency" | "date" | "is_internal_transfer" | "merchants_interpretation_version" | "pending" | "subcategory" | "transfer_pair_id" | "transfers_interpretation_version">, "strict", z.ZodTypeAny, {
581
+ }, "amount" | "category" | "currency" | "date" | "is_internal_transfer" | "merchants_interpretation_version" | "notes" | "pending" | "subcategory" | "tags" | "transfer_pair_id" | "transfers_interpretation_version"> & {
582
+ merchant: z.ZodOptional<z.ZodNullable<z.ZodString>>;
583
+ name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
584
+ }, "strict", z.ZodTypeAny, {
580
585
  date: string | null;
581
586
  amount: number;
582
587
  category: string | null;
583
588
  subcategory: string | null;
584
589
  pending: boolean | null;
585
590
  currency: string | null;
591
+ notes?: string | null | undefined;
592
+ tags?: string[] | undefined;
586
593
  is_internal_transfer?: boolean | null | undefined;
587
594
  transfer_pair_id?: string | null | undefined;
588
595
  transfers_interpretation_version?: 0 | 1 | undefined;
589
596
  merchants_interpretation_version?: 0 | undefined;
597
+ merchant?: string | null | undefined;
598
+ name?: string | null | undefined;
590
599
  }, {
591
600
  date: string | null;
592
601
  amount: number;
@@ -594,10 +603,14 @@ export declare const publicMcpToolDefinitions: readonly [{
594
603
  subcategory: string | null;
595
604
  pending: boolean | null;
596
605
  currency: string | null;
606
+ notes?: string | null | undefined;
607
+ tags?: string[] | undefined;
597
608
  is_internal_transfer?: boolean | null | undefined;
598
609
  transfer_pair_id?: string | null | undefined;
599
610
  transfers_interpretation_version?: 0 | 1 | undefined;
600
611
  merchants_interpretation_version?: 0 | undefined;
612
+ merchant?: string | null | undefined;
613
+ name?: string | null | undefined;
601
614
  }>, "many">;
602
615
  }, "strict", z.ZodTypeAny, {
603
616
  month: string;
@@ -611,10 +624,14 @@ export declare const publicMcpToolDefinitions: readonly [{
611
624
  subcategory: string | null;
612
625
  pending: boolean | null;
613
626
  currency: string | null;
627
+ notes?: string | null | undefined;
628
+ tags?: string[] | undefined;
614
629
  is_internal_transfer?: boolean | null | undefined;
615
630
  transfer_pair_id?: string | null | undefined;
616
631
  transfers_interpretation_version?: 0 | 1 | undefined;
617
632
  merchants_interpretation_version?: 0 | undefined;
633
+ merchant?: string | null | undefined;
634
+ name?: string | null | undefined;
618
635
  }[];
619
636
  }, {
620
637
  month: string;
@@ -628,10 +645,14 @@ export declare const publicMcpToolDefinitions: readonly [{
628
645
  subcategory: string | null;
629
646
  pending: boolean | null;
630
647
  currency: string | null;
648
+ notes?: string | null | undefined;
649
+ tags?: string[] | undefined;
631
650
  is_internal_transfer?: boolean | null | undefined;
632
651
  transfer_pair_id?: string | null | undefined;
633
652
  transfers_interpretation_version?: 0 | 1 | undefined;
634
653
  merchants_interpretation_version?: 0 | undefined;
654
+ merchant?: string | null | undefined;
655
+ name?: string | null | undefined;
635
656
  }[];
636
657
  }>, z.ZodObject<{
637
658
  since: z.ZodString;
@@ -649,21 +670,30 @@ export declare const publicMcpToolDefinitions: readonly [{
649
670
  subcategory: z.ZodNullable<z.ZodString>;
650
671
  pending: z.ZodNullable<z.ZodBoolean>;
651
672
  currency: z.ZodNullable<z.ZodString>;
673
+ notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
674
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
652
675
  is_internal_transfer: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
653
676
  transfer_pair_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
654
677
  transfers_interpretation_version: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
655
678
  merchants_interpretation_version: z.ZodOptional<z.ZodLiteral<0>>;
656
- }, "amount" | "category" | "currency" | "date" | "is_internal_transfer" | "merchants_interpretation_version" | "pending" | "subcategory" | "transfer_pair_id" | "transfers_interpretation_version">, "strict", z.ZodTypeAny, {
679
+ }, "amount" | "category" | "currency" | "date" | "is_internal_transfer" | "merchants_interpretation_version" | "notes" | "pending" | "subcategory" | "tags" | "transfer_pair_id" | "transfers_interpretation_version"> & {
680
+ merchant: z.ZodOptional<z.ZodNullable<z.ZodString>>;
681
+ name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
682
+ }, "strict", z.ZodTypeAny, {
657
683
  date: string | null;
658
684
  amount: number;
659
685
  category: string | null;
660
686
  subcategory: string | null;
661
687
  pending: boolean | null;
662
688
  currency: string | null;
689
+ notes?: string | null | undefined;
690
+ tags?: string[] | undefined;
663
691
  is_internal_transfer?: boolean | null | undefined;
664
692
  transfer_pair_id?: string | null | undefined;
665
693
  transfers_interpretation_version?: 0 | 1 | undefined;
666
694
  merchants_interpretation_version?: 0 | undefined;
695
+ merchant?: string | null | undefined;
696
+ name?: string | null | undefined;
667
697
  }, {
668
698
  date: string | null;
669
699
  amount: number;
@@ -671,10 +701,14 @@ export declare const publicMcpToolDefinitions: readonly [{
671
701
  subcategory: string | null;
672
702
  pending: boolean | null;
673
703
  currency: string | null;
704
+ notes?: string | null | undefined;
705
+ tags?: string[] | undefined;
674
706
  is_internal_transfer?: boolean | null | undefined;
675
707
  transfer_pair_id?: string | null | undefined;
676
708
  transfers_interpretation_version?: 0 | 1 | undefined;
677
709
  merchants_interpretation_version?: 0 | undefined;
710
+ merchant?: string | null | undefined;
711
+ name?: string | null | undefined;
678
712
  }>, "many">;
679
713
  }, "strict", z.ZodTypeAny, {
680
714
  since: string;
@@ -687,10 +721,14 @@ export declare const publicMcpToolDefinitions: readonly [{
687
721
  subcategory: string | null;
688
722
  pending: boolean | null;
689
723
  currency: string | null;
724
+ notes?: string | null | undefined;
725
+ tags?: string[] | undefined;
690
726
  is_internal_transfer?: boolean | null | undefined;
691
727
  transfer_pair_id?: string | null | undefined;
692
728
  transfers_interpretation_version?: 0 | 1 | undefined;
693
729
  merchants_interpretation_version?: 0 | undefined;
730
+ merchant?: string | null | undefined;
731
+ name?: string | null | undefined;
694
732
  }[];
695
733
  }, {
696
734
  since: string;
@@ -703,11 +741,165 @@ export declare const publicMcpToolDefinitions: readonly [{
703
741
  subcategory: string | null;
704
742
  pending: boolean | null;
705
743
  currency: string | null;
744
+ notes?: string | null | undefined;
745
+ tags?: string[] | undefined;
706
746
  is_internal_transfer?: boolean | null | undefined;
707
747
  transfer_pair_id?: string | null | undefined;
708
748
  transfers_interpretation_version?: 0 | 1 | undefined;
709
749
  merchants_interpretation_version?: 0 | undefined;
750
+ merchant?: string | null | undefined;
751
+ name?: string | null | undefined;
752
+ }[];
753
+ }>, z.ZodObject<{
754
+ periods: z.ZodArray<z.ZodObject<{
755
+ month: z.ZodString;
756
+ start_date: z.ZodString;
757
+ end_date: z.ZodString;
758
+ count: z.ZodNumber;
759
+ } & {
760
+ items: z.ZodArray<z.ZodObject<Pick<{
761
+ id: z.ZodString;
762
+ account_id: z.ZodNullable<z.ZodString>;
763
+ date: z.ZodNullable<z.ZodString>;
764
+ amount: z.ZodNumber;
765
+ merchant: z.ZodNullable<z.ZodString>;
766
+ name: z.ZodNullable<z.ZodString>;
767
+ category: z.ZodNullable<z.ZodString>;
768
+ subcategory: z.ZodNullable<z.ZodString>;
769
+ pending: z.ZodNullable<z.ZodBoolean>;
770
+ currency: z.ZodNullable<z.ZodString>;
771
+ notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
772
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
773
+ is_internal_transfer: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
774
+ transfer_pair_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
775
+ transfers_interpretation_version: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
776
+ merchants_interpretation_version: z.ZodOptional<z.ZodLiteral<0>>;
777
+ }, "amount" | "category" | "currency" | "date" | "is_internal_transfer" | "merchants_interpretation_version" | "notes" | "pending" | "subcategory" | "tags" | "transfer_pair_id" | "transfers_interpretation_version"> & {
778
+ merchant: z.ZodOptional<z.ZodNullable<z.ZodString>>;
779
+ name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
780
+ }, "strict", z.ZodTypeAny, {
781
+ date: string | null;
782
+ amount: number;
783
+ category: string | null;
784
+ subcategory: string | null;
785
+ pending: boolean | null;
786
+ currency: string | null;
787
+ notes?: string | null | undefined;
788
+ tags?: string[] | undefined;
789
+ is_internal_transfer?: boolean | null | undefined;
790
+ transfer_pair_id?: string | null | undefined;
791
+ transfers_interpretation_version?: 0 | 1 | undefined;
792
+ merchants_interpretation_version?: 0 | undefined;
793
+ merchant?: string | null | undefined;
794
+ name?: string | null | undefined;
795
+ }, {
796
+ date: string | null;
797
+ amount: number;
798
+ category: string | null;
799
+ subcategory: string | null;
800
+ pending: boolean | null;
801
+ currency: string | null;
802
+ notes?: string | null | undefined;
803
+ tags?: string[] | undefined;
804
+ is_internal_transfer?: boolean | null | undefined;
805
+ transfer_pair_id?: string | null | undefined;
806
+ transfers_interpretation_version?: 0 | 1 | undefined;
807
+ merchants_interpretation_version?: 0 | undefined;
808
+ merchant?: string | null | undefined;
809
+ name?: string | null | undefined;
810
+ }>, "many">;
811
+ }, "strict", z.ZodTypeAny, {
812
+ month: string;
813
+ start_date: string;
814
+ end_date: string;
815
+ count: number;
816
+ items: {
817
+ date: string | null;
818
+ amount: number;
819
+ category: string | null;
820
+ subcategory: string | null;
821
+ pending: boolean | null;
822
+ currency: string | null;
823
+ notes?: string | null | undefined;
824
+ tags?: string[] | undefined;
825
+ is_internal_transfer?: boolean | null | undefined;
826
+ transfer_pair_id?: string | null | undefined;
827
+ transfers_interpretation_version?: 0 | 1 | undefined;
828
+ merchants_interpretation_version?: 0 | undefined;
829
+ merchant?: string | null | undefined;
830
+ name?: string | null | undefined;
831
+ }[];
832
+ }, {
833
+ month: string;
834
+ start_date: string;
835
+ end_date: string;
836
+ count: number;
837
+ items: {
838
+ date: string | null;
839
+ amount: number;
840
+ category: string | null;
841
+ subcategory: string | null;
842
+ pending: boolean | null;
843
+ currency: string | null;
844
+ notes?: string | null | undefined;
845
+ tags?: string[] | undefined;
846
+ is_internal_transfer?: boolean | null | undefined;
847
+ transfer_pair_id?: string | null | undefined;
848
+ transfers_interpretation_version?: 0 | 1 | undefined;
849
+ merchants_interpretation_version?: 0 | undefined;
850
+ merchant?: string | null | undefined;
851
+ name?: string | null | undefined;
852
+ }[];
853
+ }>, "many">;
854
+ truncated: z.ZodOptional<z.ZodBoolean>;
855
+ }, "strict", z.ZodTypeAny, {
856
+ periods: {
857
+ month: string;
858
+ start_date: string;
859
+ end_date: string;
860
+ count: number;
861
+ items: {
862
+ date: string | null;
863
+ amount: number;
864
+ category: string | null;
865
+ subcategory: string | null;
866
+ pending: boolean | null;
867
+ currency: string | null;
868
+ notes?: string | null | undefined;
869
+ tags?: string[] | undefined;
870
+ is_internal_transfer?: boolean | null | undefined;
871
+ transfer_pair_id?: string | null | undefined;
872
+ transfers_interpretation_version?: 0 | 1 | undefined;
873
+ merchants_interpretation_version?: 0 | undefined;
874
+ merchant?: string | null | undefined;
875
+ name?: string | null | undefined;
876
+ }[];
877
+ }[];
878
+ truncated?: boolean | undefined;
879
+ }, {
880
+ periods: {
881
+ month: string;
882
+ start_date: string;
883
+ end_date: string;
884
+ count: number;
885
+ items: {
886
+ date: string | null;
887
+ amount: number;
888
+ category: string | null;
889
+ subcategory: string | null;
890
+ pending: boolean | null;
891
+ currency: string | null;
892
+ notes?: string | null | undefined;
893
+ tags?: string[] | undefined;
894
+ is_internal_transfer?: boolean | null | undefined;
895
+ transfer_pair_id?: string | null | undefined;
896
+ transfers_interpretation_version?: 0 | 1 | undefined;
897
+ merchants_interpretation_version?: 0 | undefined;
898
+ merchant?: string | null | undefined;
899
+ name?: string | null | undefined;
900
+ }[];
710
901
  }[];
902
+ truncated?: boolean | undefined;
711
903
  }>]>;
712
904
  }];
713
905
  export declare const publicMcpToolDescriptors: ({
@@ -724,7 +916,7 @@ export declare const publicMcpToolDescriptors: ({
724
916
  } | {
725
917
  name: "get_transactions";
726
918
  title: "Get transactions";
727
- description: "Read-only transaction pages from the financial context. Pass `period: \"latest\"` for the fixed 10-day window or `period: \"YYYY-MM\"` for a month page. Transaction items include date, amount, category, subcategory, pending, and currency; IDs, account details, merchants, and names are omitted. The latest window is not caller-configurable. Months outside the covered range return an error listing the covered months. Empty months inside the range are accepted.";
919
+ description: "Read-only transaction pages from the financial context. Pass `period: \"latest\"` for the fixed 10-day window or `period: \"YYYY-MM\"` for a month page, or `periods` for two or three month pages. Transaction items include date, amount, category, subcategory, pending, and currency; IDs, account details, merchants, and names are omitted. When the account owner has turned off the personal info filter, items also include merchant, name, notes, and tags. The latest window is not caller-configurable. Months outside the covered range return an error listing the covered months. Empty months inside the range are accepted.";
728
920
  annotations: {
729
921
  readonly readOnlyHint: true;
730
922
  readonly destructiveHint: false;
@@ -1 +1 @@
1
- {"version":3,"file":"public-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/public-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAoB,MAAM,KAAK,CAAC;AAC1C,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAQ3E,eAAO,MAAM,+BAA+B;aAC1C,MAAM,EAAE,eAAe;aACvB,gBAAgB,EAAE,UAAU;aAC5B,MAAM;iBACJ,qBAAqB,EAAE,wBAAwB;iBAC/C,gBAAgB,EAAE,mBAAmB;;CAE/B,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,+BAA+B,CAAC,MAAM,CAAC;AACpF,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,+BAA+B,CAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;AAerE,KAAK,mBAAmB,GAAG,eAAe,GAAG;IAC3C,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAA;KAAE,GAAG,SAAS,CAAC;CAC9D,CAAC;AAYF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBkB,CAAC;AAExD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;IAUpC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC"}
1
+ {"version":3,"file":"public-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/public-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAoB,MAAM,KAAK,CAAC;AAC1C,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAS3E,eAAO,MAAM,+BAA+B;aAC1C,MAAM,EAAE,eAAe;aACvB,gBAAgB,EAAE,UAAU;aAC5B,MAAM;iBACJ,qBAAqB,EAAE,wBAAwB;iBAC/C,gBAAgB,EAAE,mBAAmB;;CAE/B,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,+BAA+B,CAAC,MAAM,CAAC;AACpF,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,+BAA+B,CAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;AAerE,KAAK,mBAAmB,GAAG,eAAe,GAAG;IAC3C,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAA;KAAE,GAAG,SAAS,CAAC;CAC9D,CAAC;AAYF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBkB,CAAC;AAExD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;IAUpC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC"}
@@ -1,7 +1,7 @@
1
1
  import { z } from 'zod';
2
2
  import { zodToJsonSchema } from 'zod-to-json-schema';
3
3
  import { emptyMcpInputShape, getTransactionsMcpInputShape } from './tools.js';
4
- import { publicMcpFinancialContextSchema, publicMcpLatestTransactionsSchema, publicMcpTransactionMonthSchema, } from './public-output.js';
4
+ import { publicMcpFinancialContextSchema, publicMcpLatestTransactionsSchema, publicMcpTransactionMonthSchema, publicMcpTransactionPeriodsSchema, } from './public-output.js';
5
5
  export const publicMcpToolPermissionContract = {
6
6
  status: 'contract_only',
7
7
  enforcementOwner: 'provider',
@@ -30,10 +30,14 @@ export const publicMcpToolDefinitions = [
30
30
  tool({
31
31
  name: 'get_transactions',
32
32
  title: 'Get transactions',
33
- description: 'Read-only transaction pages from the financial context. Pass `period: "latest"` for the fixed 10-day window or `period: "YYYY-MM"` for a month page. Transaction items include date, amount, category, subcategory, pending, and currency; IDs, account details, merchants, and names are omitted. The latest window is not caller-configurable. Months outside the covered range return an error listing the covered months. Empty months inside the range are accepted.',
33
+ description: 'Read-only transaction pages from the financial context. Pass `period: "latest"` for the fixed 10-day window or `period: "YYYY-MM"` for a month page, or `periods` for two or three month pages. Transaction items include date, amount, category, subcategory, pending, and currency; IDs, account details, merchants, and names are omitted. When the account owner has turned off the personal info filter, items also include merchant, name, notes, and tags. The latest window is not caller-configurable. Months outside the covered range return an error listing the covered months. Empty months inside the range are accepted.',
34
34
  annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
35
35
  inputShape: getTransactionsMcpInputShape,
36
- outputSchema: z.union([publicMcpTransactionMonthSchema, publicMcpLatestTransactionsSchema]),
36
+ outputSchema: z.union([
37
+ publicMcpTransactionMonthSchema,
38
+ publicMcpLatestTransactionsSchema,
39
+ publicMcpTransactionPeriodsSchema,
40
+ ]),
37
41
  }),
38
42
  ];
39
43
  export const publicMcpToolDescriptors = publicMcpToolDefinitions.map(({ inputShape, outputSchema, ...toolDefinition }) => ({
@@ -1 +1 @@
1
- {"version":3,"file":"public-tools.js","sourceRoot":"","sources":["../../src/mcp/public-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAoB,MAAM,KAAK,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAwB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EACL,+BAA+B,EAC/B,iCAAiC,EACjC,+BAA+B,GAChC,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,MAAM,EAAE,eAAe;IACvB,gBAAgB,EAAE,UAAU;IAC5B,MAAM,EAAE;QACN,qBAAqB,EAAE,wBAAwB;QAC/C,gBAAgB,EAAE,mBAAmB;KACtC;CACO,CAAC;AAeX,MAAM,IAAI,GAAG,CACX,UAAsB,EACV,EAAE,CAAC,UAAU,CAAC;AAO5B,MAAM,mBAAmB,GAAG,CAAC,MAA2B,EAAuB,EAAE;IAC/E,MAAM,gBAAgB,GAAwB,EAAE,GAAG,MAAM,EAAE,CAAC;IAE5D,IAAI,gBAAgB,CAAC,OAAO,KAAK,yCAAyC,EAAE,CAAC;QAC3E,gBAAgB,CAAC,OAAO,GAAG,0CAA0C,CAAC;IACxE,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,CAAC;QACH,IAAI,EAAE,uBAAuB;QAC7B,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,kaAAka;QACpa,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;QACjF,UAAU,EAAE,kBAAkB;QAC9B,YAAY,EAAE,+BAA+B;KAC9C,CAAC;IACF,IAAI,CAAC;QACH,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,2cAA2c;QAC7c,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;QACjF,UAAU,EAAE,4BAA4B;QACxC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,+BAA+B,EAAE,iCAAiC,CAAC,CAAC;KAC5F,CAAC;CACmD,CAAC;AAExD,MAAM,CAAC,MAAM,wBAAwB,GAAG,wBAAwB,CAAC,GAAG,CAClE,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC;IACpD,GAAG,cAAc;IACjB,YAAY,EAAE,mBAAmB,CAC/B,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,EAAE;QAC7C,YAAY,EAAE,MAAM;KACrB,CAAC,CACH;IACD,aAAa,EAAE,mBAAmB,CAAC,eAAe,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;CAC5F,CAAC,CACH,CAAC"}
1
+ {"version":3,"file":"public-tools.js","sourceRoot":"","sources":["../../src/mcp/public-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAoB,MAAM,KAAK,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAwB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EACL,+BAA+B,EAC/B,iCAAiC,EACjC,+BAA+B,EAC/B,iCAAiC,GAClC,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,MAAM,EAAE,eAAe;IACvB,gBAAgB,EAAE,UAAU;IAC5B,MAAM,EAAE;QACN,qBAAqB,EAAE,wBAAwB;QAC/C,gBAAgB,EAAE,mBAAmB;KACtC;CACO,CAAC;AAeX,MAAM,IAAI,GAAG,CACX,UAAsB,EACV,EAAE,CAAC,UAAU,CAAC;AAO5B,MAAM,mBAAmB,GAAG,CAAC,MAA2B,EAAuB,EAAE;IAC/E,MAAM,gBAAgB,GAAwB,EAAE,GAAG,MAAM,EAAE,CAAC;IAE5D,IAAI,gBAAgB,CAAC,OAAO,KAAK,yCAAyC,EAAE,CAAC;QAC3E,gBAAgB,CAAC,OAAO,GAAG,0CAA0C,CAAC;IACxE,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,CAAC;QACH,IAAI,EAAE,uBAAuB;QAC7B,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,kaAAka;QACpa,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;QACjF,UAAU,EAAE,kBAAkB;QAC9B,YAAY,EAAE,+BAA+B;KAC9C,CAAC;IACF,IAAI,CAAC;QACH,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,0mBAA0mB;QAC5mB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;QACjF,UAAU,EAAE,4BAA4B;QACxC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC;YACpB,+BAA+B;YAC/B,iCAAiC;YACjC,iCAAiC;SAClC,CAAC;KACH,CAAC;CACmD,CAAC;AAExD,MAAM,CAAC,MAAM,wBAAwB,GAAG,wBAAwB,CAAC,GAAG,CAClE,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC;IACpD,GAAG,cAAc;IACjB,YAAY,EAAE,mBAAmB,CAC/B,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,EAAE;QAC7C,YAAY,EAAE,MAAM;KACrB,CAAC,CACH;IACD,aAAa,EAAE,mBAAmB,CAAC,eAAe,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;CAC5F,CAAC,CACH,CAAC"}