@warmio/contracts 3.0.4 → 3.0.6

package/dist/mcp/public-tools.d.ts.map

@@ -0,0 +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;AAcrE,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBkB,CAAC;AAExD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;IAUpC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/mcp/public-tools.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { emptyMcpInputShape, getTransactionsMcpInputShape } from './tools.js';
+import { publicMcpFinancialContextSchema, publicMcpLatestTransactionsSchema, publicMcpTransactionMonthSchema, } from './public-output.js';
+export const publicMcpToolPermissionContract = {
+    status: 'contract_only',
+    enforcementOwner: 'provider',
+    byTool: {
+        get_financial_context: 'financial_context:read',
+        get_transactions: 'transactions:read',
+    },
+};
+const tool = (definition) => definition;
+const normalizeJsonSchema = (schema) => {
+    const normalizedSchema = { ...schema };
+    if (normalizedSchema.$schema === 'http://json-schema.org/draft-07/schema#') {
+        normalizedSchema.$schema = 'https://json-schema.org/draft-07/schema#';
+    }
+    return normalizedSchema;
+};
+export const publicMcpToolDefinitions = [
+    tool({
+        name: 'get_financial_context',
+        description: 'Read-only financial context summary. Returns version, updated_at, currency, status.position, and transaction-index totals and months. Account details and transaction items are omitted; use get_transactions for transaction items. The point-in-time position is a balance snapshot, separate from transaction and behavior windows.',
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        inputShape: emptyMcpInputShape,
+        outputSchema: publicMcpFinancialContextSchema,
+    }),
+    tool({
+        name: 'get_transactions',
+        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.',
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        inputShape: getTransactionsMcpInputShape,
+        outputSchema: z.union([publicMcpTransactionMonthSchema, publicMcpLatestTransactionsSchema]),
+    }),
+];
+export const publicMcpToolDescriptors = publicMcpToolDefinitions.map(({ inputShape, outputSchema, ...toolDefinition }) => ({
+    ...toolDefinition,
+    input_schema: normalizeJsonSchema(zodToJsonSchema(z.object(inputShape).strict(), {
+        $refStrategy: 'none',
+    })),
+    output_schema: normalizeJsonSchema(zodToJsonSchema(outputSchema, { $refStrategy: 'none' })),
+}));
+//# sourceMappingURL=public-tools.js.map

package/dist/mcp/public-tools.js.map

@@ -0,0 +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;AAcX,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,WAAW,EACT,wUAAwU;QAC1U,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,WAAW,EACT,oYAAoY;QACtY,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"}

package/dist/mcp/tools.d.ts

@@ -2,7 +2,8 @@ import { z } from 'zod';
 import { type JsonSchema7Type } from 'zod-to-json-schema';
 export declare const emptyMcpInputShape: {};
 export declare const getTransactionsMcpInputShape: {
-    period: z.ZodUnion<[z.ZodLiteral<"latest">, z.ZodString]>;
+    period: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"latest">, z.ZodString]>>;
+    periods: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
 };
 export declare const searchOperationsMcpInputShape: {
     query: z.ZodOptional<z.ZodString>;
@@ -34,20 +35,305 @@ export declare const invokeOperationMcpInputShape: {
     }>>;
     approval_id: z.ZodOptional<z.ZodString>;
 };
-export declare const getTransactionsMcpInputSchema: z.ZodObject<{
-    period: z.ZodUnion<[z.ZodLiteral<"latest">, z.ZodString]>;
+export declare const getTransactionsMcpInputSchema: z.ZodEffects<z.ZodObject<{
+    period: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"latest">, z.ZodString]>>;
+    periods: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
 }, "strict", z.ZodTypeAny, {
-    period: string;
+    period?: string | undefined;
+    periods?: string[] | undefined;
 }, {
-    period: string;
+    period?: string | undefined;
+    periods?: string[] | undefined;
+}>, {
+    period?: string | undefined;
+    periods?: string[] | undefined;
+}, {
+    period?: string | undefined;
+    periods?: string[] | undefined;
 }>;
 export declare function normalizeGetTransactionsMcpInput(input: z.infer<typeof getTransactionsMcpInputSchema>): {
+    readonly periods: string[];
+    readonly latest?: never;
+    readonly month?: never;
+} | {
+    readonly periods?: never;
     readonly latest: true;
     readonly month?: never;
 } | {
+    readonly periods?: never;
     readonly latest?: never;
     readonly month: string;
 };
+export declare const transactionMonthMcpOutputSchema: z.ZodObject<{
+    month: z.ZodString;
+    start_date: z.ZodString;
+    end_date: z.ZodString;
+    count: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        account_id: z.ZodNullable<z.ZodString>;
+        date: z.ZodNullable<z.ZodString>;
+        amount: z.ZodNumber;
+        merchant: z.ZodNullable<z.ZodString>;
+        name: z.ZodNullable<z.ZodString>;
+        category: z.ZodNullable<z.ZodString>;
+        subcategory: z.ZodNullable<z.ZodString>;
+        pending: z.ZodNullable<z.ZodBoolean>;
+        currency: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        account_id: string | null;
+        date: string | null;
+        amount: number;
+        merchant: string | null;
+        name: string | null;
+        category: string | null;
+        subcategory: string | null;
+        pending: boolean | null;
+        currency: string | null;
+    }, {
+        id: string;
+        account_id: string | null;
+        date: string | null;
+        amount: number;
+        merchant: string | null;
+        name: string | null;
+        category: string | null;
+        subcategory: string | null;
+        pending: boolean | null;
+        currency: string | null;
+    }>, "many">;
+} & {
+    truncated: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    month: string;
+    start_date: string;
+    end_date: string;
+    count: number;
+    items: {
+        id: string;
+        account_id: string | null;
+        date: string | null;
+        amount: number;
+        merchant: string | null;
+        name: string | null;
+        category: string | null;
+        subcategory: string | null;
+        pending: boolean | null;
+        currency: string | null;
+    }[];
+    truncated?: boolean | undefined;
+}, {
+    month: string;
+    start_date: string;
+    end_date: string;
+    count: number;
+    items: {
+        id: string;
+        account_id: string | null;
+        date: string | null;
+        amount: number;
+        merchant: string | null;
+        name: string | null;
+        category: string | null;
+        subcategory: string | null;
+        pending: boolean | null;
+        currency: string | null;
+    }[];
+    truncated?: boolean | undefined;
+}>;
+export declare const latestTransactionsMcpOutputSchema: z.ZodObject<{
+    since: z.ZodString;
+    window_days: z.ZodLiteral<10>;
+    count: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        account_id: z.ZodNullable<z.ZodString>;
+        date: z.ZodNullable<z.ZodString>;
+        amount: z.ZodNumber;
+        merchant: z.ZodNullable<z.ZodString>;
+        name: z.ZodNullable<z.ZodString>;
+        category: z.ZodNullable<z.ZodString>;
+        subcategory: z.ZodNullable<z.ZodString>;
+        pending: z.ZodNullable<z.ZodBoolean>;
+        currency: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        account_id: string | null;
+        date: string | null;
+        amount: number;
+        merchant: string | null;
+        name: string | null;
+        category: string | null;
+        subcategory: string | null;
+        pending: boolean | null;
+        currency: string | null;
+    }, {
+        id: string;
+        account_id: string | null;
+        date: string | null;
+        amount: number;
+        merchant: string | null;
+        name: string | null;
+        category: string | null;
+        subcategory: string | null;
+        pending: boolean | null;
+        currency: string | null;
+    }>, "many">;
+} & {
+    truncated: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    since: string;
+    window_days: 10;
+    count: number;
+    items: {
+        id: string;
+        account_id: string | null;
+        date: string | null;
+        amount: number;
+        merchant: string | null;
+        name: string | null;
+        category: string | null;
+        subcategory: string | null;
+        pending: boolean | null;
+        currency: string | null;
+    }[];
+    truncated?: boolean | undefined;
+}, {
+    since: string;
+    window_days: 10;
+    count: number;
+    items: {
+        id: string;
+        account_id: string | null;
+        date: string | null;
+        amount: number;
+        merchant: string | null;
+        name: string | null;
+        category: string | null;
+        subcategory: string | null;
+        pending: boolean | null;
+        currency: string | null;
+    }[];
+    truncated?: boolean | undefined;
+}>;
+export declare const transactionPeriodsMcpOutputSchema: z.ZodObject<{
+    periods: z.ZodArray<z.ZodObject<{
+        month: z.ZodString;
+        start_date: z.ZodString;
+        end_date: z.ZodString;
+        count: z.ZodNumber;
+        items: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            account_id: z.ZodNullable<z.ZodString>;
+            date: z.ZodNullable<z.ZodString>;
+            amount: z.ZodNumber;
+            merchant: z.ZodNullable<z.ZodString>;
+            name: z.ZodNullable<z.ZodString>;
+            category: z.ZodNullable<z.ZodString>;
+            subcategory: z.ZodNullable<z.ZodString>;
+            pending: z.ZodNullable<z.ZodBoolean>;
+            currency: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            account_id: string | null;
+            date: string | null;
+            amount: number;
+            merchant: string | null;
+            name: string | null;
+            category: string | null;
+            subcategory: string | null;
+            pending: boolean | null;
+            currency: string | null;
+        }, {
+            id: string;
+            account_id: string | null;
+            date: string | null;
+            amount: number;
+            merchant: string | null;
+            name: string | null;
+            category: string | null;
+            subcategory: string | null;
+            pending: boolean | null;
+            currency: string | null;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        month: string;
+        start_date: string;
+        end_date: string;
+        count: number;
+        items: {
+            id: string;
+            account_id: string | null;
+            date: string | null;
+            amount: number;
+            merchant: string | null;
+            name: string | null;
+            category: string | null;
+            subcategory: string | null;
+            pending: boolean | null;
+            currency: string | null;
+        }[];
+    }, {
+        month: string;
+        start_date: string;
+        end_date: string;
+        count: number;
+        items: {
+            id: string;
+            account_id: string | null;
+            date: string | null;
+            amount: number;
+            merchant: string | null;
+            name: string | null;
+            category: string | null;
+            subcategory: string | null;
+            pending: boolean | null;
+            currency: string | null;
+        }[];
+    }>, "many">;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    periods: {
+        month: string;
+        start_date: string;
+        end_date: string;
+        count: number;
+        items: {
+            id: string;
+            account_id: string | null;
+            date: string | null;
+            amount: number;
+            merchant: string | null;
+            name: string | null;
+            category: string | null;
+            subcategory: string | null;
+            pending: boolean | null;
+            currency: string | null;
+        }[];
+    }[];
+    truncated?: boolean | undefined;
+}, {
+    periods: {
+        month: string;
+        start_date: string;
+        end_date: string;
+        count: number;
+        items: {
+            id: string;
+            account_id: string | null;
+            date: string | null;
+            amount: number;
+            merchant: string | null;
+            name: string | null;
+            category: string | null;
+            subcategory: string | null;
+            pending: boolean | null;
+            currency: string | null;
+        }[];
+    }[];
+    truncated?: boolean | undefined;
+}>;
 type JsonSchema7Document = JsonSchema7Type & {
     $schema?: string | undefined;
     definitions?: {
@@ -99,7 +385,7 @@ export declare const privateMcpToolDefinitions: readonly [{
                 source: z.ZodNullable<z.ZodEnum<["plaid", "manual", "csv_import"]>>;
                 type: z.ZodEnum<["depository", "credit", "loan", "investment", "brokerage", "other"]>;
                 subtype: z.ZodNullable<z.ZodString>;
-                group: z.ZodNullable<z.ZodEnum<["cash", "debt", "investments"]>>;
+                group: z.ZodNullable<z.ZodEnum<["cash", "debt", "investments", "other"]>>;
                 institution: z.ZodNullable<z.ZodString>;
                 mask: z.ZodNullable<z.ZodString>;
                 balance: z.ZodNullable<z.ZodNumber>;
@@ -112,7 +398,7 @@ export declare const privateMcpToolDefinitions: readonly [{
                 source: "csv_import" | "manual" | "plaid" | null;
                 type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
                 subtype: string | null;
-                group: "cash" | "debt" | "investments" | null;
+                group: "cash" | "debt" | "investments" | "other" | null;
                 institution: string | null;
                 mask: string | null;
                 balance: number | null;
@@ -125,7 +411,7 @@ export declare const privateMcpToolDefinitions: readonly [{
                 source: "csv_import" | "manual" | "plaid" | null;
                 type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
                 subtype: string | null;
-                group: "cash" | "debt" | "investments" | null;
+                group: "cash" | "debt" | "investments" | "other" | null;
                 institution: string | null;
                 mask: string | null;
                 balance: number | null;
@@ -149,7 +435,7 @@ export declare const privateMcpToolDefinitions: readonly [{
                 source: "csv_import" | "manual" | "plaid" | null;
                 type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
                 subtype: string | null;
-                group: "cash" | "debt" | "investments" | null;
+                group: "cash" | "debt" | "investments" | "other" | null;
                 institution: string | null;
                 mask: string | null;
                 balance: number | null;
@@ -173,7 +459,7 @@ export declare const privateMcpToolDefinitions: readonly [{
                 source: "csv_import" | "manual" | "plaid" | null;
                 type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
                 subtype: string | null;
-                group: "cash" | "debt" | "investments" | null;
+                group: "cash" | "debt" | "investments" | "other" | null;
                 institution: string | null;
                 mask: string | null;
                 balance: number | null;
@@ -216,6 +502,7 @@ export declare const privateMcpToolDefinitions: readonly [{
             merchant: z.ZodNullable<z.ZodString>;
             amount: z.ZodNullable<z.ZodNumber>;
             next_date: z.ZodNullable<z.ZodString>;
+            excluded_from_subscriptions: z.ZodOptional<z.ZodBoolean>;
         }, "strict", z.ZodTypeAny, {
             id: string;
             account_id: string | null;
@@ -225,6 +512,7 @@ export declare const privateMcpToolDefinitions: readonly [{
             merchant: string | null;
             amount: number | null;
             next_date: string | null;
+            excluded_from_subscriptions?: boolean | undefined;
         }, {
             id: string;
             account_id: string | null;
@@ -234,6 +522,7 @@ export declare const privateMcpToolDefinitions: readonly [{
             merchant: string | null;
             amount: number | null;
             next_date: string | null;
+            excluded_from_subscriptions?: boolean | undefined;
         }>, "many">;
         budgets: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -460,7 +749,7 @@ export declare const privateMcpToolDefinitions: readonly [{
                 source: "csv_import" | "manual" | "plaid" | null;
                 type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
                 subtype: string | null;
-                group: "cash" | "debt" | "investments" | null;
+                group: "cash" | "debt" | "investments" | "other" | null;
                 institution: string | null;
                 mask: string | null;
                 balance: number | null;
@@ -485,6 +774,7 @@ export declare const privateMcpToolDefinitions: readonly [{
             merchant: string | null;
             amount: number | null;
             next_date: string | null;
+            excluded_from_subscriptions?: boolean | undefined;
         }[];
         budgets: {
             id: string;
@@ -575,7 +865,7 @@ export declare const privateMcpToolDefinitions: readonly [{
                 source: "csv_import" | "manual" | "plaid" | null;
                 type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
                 subtype: string | null;
-                group: "cash" | "debt" | "investments" | null;
+                group: "cash" | "debt" | "investments" | "other" | null;
                 institution: string | null;
                 mask: string | null;
                 balance: number | null;
@@ -600,6 +890,7 @@ export declare const privateMcpToolDefinitions: readonly [{
             merchant: string | null;
             amount: number | null;
             next_date: string | null;
+            excluded_from_subscriptions?: boolean | undefined;
         }[];
         budgets: {
             id: string;
@@ -673,14 +964,15 @@ export declare const privateMcpToolDefinitions: readonly [{
     }>;
 }, {
     readonly name: "get_transactions";
-    readonly description: "Read-only transactions from the FinancialContext artifact. Pass `period: \"latest\"` for the fixed 10-day latest window or `period: \"YYYY-MM\"` for a month page. The latest window is not caller-configurable. Months outside the covered range return an error.";
+    readonly description: "Read-only transactions from the FinancialContext artifact. Pass exactly one of `period` or `periods`. Use `period: \"latest\"` for the fixed 10-day window, `period: \"YYYY-MM\"` for one month, or `periods` for two or three distinct months. Multi-month output contains one month page per requested period in input order. The latest window is not caller-configurable. Months outside the covered range return an error.";
     readonly annotations: {
         readonly readOnlyHint: true;
         readonly destructiveHint: false;
         readonly openWorldHint: false;
     };
     readonly inputShape: {
-        period: z.ZodUnion<[z.ZodLiteral<"latest">, z.ZodString]>;
+        period: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"latest">, z.ZodString]>>;
+        periods: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
     };
     readonly outputSchema: z.ZodUnion<[z.ZodObject<{
         month: z.ZodString;
@@ -721,6 +1013,8 @@ export declare const privateMcpToolDefinitions: readonly [{
             pending: boolean | null;
             currency: string | null;
         }>, "many">;
+    } & {
+        truncated: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         month: string;
         start_date: string;
@@ -738,6 +1032,7 @@ export declare const privateMcpToolDefinitions: readonly [{
             pending: boolean | null;
             currency: string | null;
         }[];
+        truncated?: boolean | undefined;
     }, {
         month: string;
         start_date: string;
@@ -755,6 +1050,7 @@ export declare const privateMcpToolDefinitions: readonly [{
             pending: boolean | null;
             currency: string | null;
         }[];
+        truncated?: boolean | undefined;
     }>, z.ZodObject<{
         since: z.ZodString;
         window_days: z.ZodLiteral<10>;
@@ -793,6 +1089,8 @@ export declare const privateMcpToolDefinitions: readonly [{
             pending: boolean | null;
             currency: string | null;
         }>, "many">;
+    } & {
+        truncated: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         since: string;
         window_days: 10;
@@ -809,6 +1107,7 @@ export declare const privateMcpToolDefinitions: readonly [{
             pending: boolean | null;
             currency: string | null;
         }[];
+        truncated?: boolean | undefined;
     }, {
         since: string;
         window_days: 10;
@@ -825,6 +1124,123 @@ export declare const privateMcpToolDefinitions: readonly [{
             pending: boolean | null;
             currency: string | null;
         }[];
+        truncated?: boolean | undefined;
+    }>, z.ZodObject<{
+        periods: z.ZodArray<z.ZodObject<{
+            month: z.ZodString;
+            start_date: z.ZodString;
+            end_date: z.ZodString;
+            count: z.ZodNumber;
+            items: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                account_id: z.ZodNullable<z.ZodString>;
+                date: z.ZodNullable<z.ZodString>;
+                amount: z.ZodNumber;
+                merchant: z.ZodNullable<z.ZodString>;
+                name: z.ZodNullable<z.ZodString>;
+                category: z.ZodNullable<z.ZodString>;
+                subcategory: z.ZodNullable<z.ZodString>;
+                pending: z.ZodNullable<z.ZodBoolean>;
+                currency: z.ZodNullable<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                id: string;
+                account_id: string | null;
+                date: string | null;
+                amount: number;
+                merchant: string | null;
+                name: string | null;
+                category: string | null;
+                subcategory: string | null;
+                pending: boolean | null;
+                currency: string | null;
+            }, {
+                id: string;
+                account_id: string | null;
+                date: string | null;
+                amount: number;
+                merchant: string | null;
+                name: string | null;
+                category: string | null;
+                subcategory: string | null;
+                pending: boolean | null;
+                currency: string | null;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            month: string;
+            start_date: string;
+            end_date: string;
+            count: number;
+            items: {
+                id: string;
+                account_id: string | null;
+                date: string | null;
+                amount: number;
+                merchant: string | null;
+                name: string | null;
+                category: string | null;
+                subcategory: string | null;
+                pending: boolean | null;
+                currency: string | null;
+            }[];
+        }, {
+            month: string;
+            start_date: string;
+            end_date: string;
+            count: number;
+            items: {
+                id: string;
+                account_id: string | null;
+                date: string | null;
+                amount: number;
+                merchant: string | null;
+                name: string | null;
+                category: string | null;
+                subcategory: string | null;
+                pending: boolean | null;
+                currency: string | null;
+            }[];
+        }>, "many">;
+        truncated: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        periods: {
+            month: string;
+            start_date: string;
+            end_date: string;
+            count: number;
+            items: {
+                id: string;
+                account_id: string | null;
+                date: string | null;
+                amount: number;
+                merchant: string | null;
+                name: string | null;
+                category: string | null;
+                subcategory: string | null;
+                pending: boolean | null;
+                currency: string | null;
+            }[];
+        }[];
+        truncated?: boolean | undefined;
+    }, {
+        periods: {
+            month: string;
+            start_date: string;
+            end_date: string;
+            count: number;
+            items: {
+                id: string;
+                account_id: string | null;
+                date: string | null;
+                amount: number;
+                merchant: string | null;
+                name: string | null;
+                category: string | null;
+                subcategory: string | null;
+                pending: boolean | null;
+                currency: string | null;
+            }[];
+        }[];
+        truncated?: boolean | undefined;
     }>]>;
 }, {
     readonly name: "search_operations";
@@ -1039,7 +1455,7 @@ export declare const privateMcpToolDescriptors: ({
     output_schema: JsonSchema7Document;
 } | {
     name: "get_transactions";
-    description: "Read-only transactions from the FinancialContext artifact. Pass `period: \"latest\"` for the fixed 10-day latest window or `period: \"YYYY-MM\"` for a month page. The latest window is not caller-configurable. Months outside the covered range return an error.";
+    description: "Read-only transactions from the FinancialContext artifact. Pass exactly one of `period` or `periods`. Use `period: \"latest\"` for the fixed 10-day window, `period: \"YYYY-MM\"` for one month, or `periods` for two or three distinct months. Multi-month output contains one month page per requested period in input order. The latest window is not caller-configurable. Months outside the covered range return an error.";
     annotations: {
         readonly readOnlyHint: true;
         readonly destructiveHint: false;

package/dist/mcp/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAoB,MAAM,KAAK,CAAC;AAC1C,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAY3E,eAAO,MAAM,kBAAkB,IAA2B,CAAC;AAC3D,eAAO,MAAM,4BAA4B;;CAMlB,CAAC;AACxB,eAAO,MAAM,6BAA6B;;CAEnB,CAAC;AACxB,eAAO,MAAM,8BAA8B;;;;;;;;;;;;CAKpB,CAAC;AACxB,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;CAOlB,CAAC;AAExB,eAAO,MAAM,6BAA6B;;;;;;EAAkD,CAAC;AAE7F,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC;;;;;;EAKrD;AAsBD,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;AAWF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwCW,CAAC;AAElD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUrC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"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"}