@warmio/contracts 3.0.5 → 3.0.7

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,370 @@ export declare const invokeOperationMcpInputShape: {
     }>>;
     approval_id: z.ZodOptional<z.ZodString>;
 };
-export declare const getTransactionsMcpInputSchema: z.ZodObject<{
+export declare const getTransactionsMcpInputSchema: z.ZodUnion<[z.ZodObject<{
     period: z.ZodUnion<[z.ZodLiteral<"latest">, z.ZodString]>;
 }, "strict", z.ZodTypeAny, {
     period: string;
 }, {
     period: string;
-}>;
+}>, z.ZodObject<{
+    periods: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+}, "strict", z.ZodTypeAny, {
+    periods: string[];
+}, {
+    periods: string[];
+}>]>;
 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>;
+        is_internal_transfer: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        transfer_pair_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        transfers_interpretation_version: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+        merchants_interpretation_version: z.ZodOptional<z.ZodLiteral<0>>;
+    }, "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;
+        is_internal_transfer?: boolean | null | undefined;
+        transfer_pair_id?: string | null | undefined;
+        transfers_interpretation_version?: 0 | 1 | undefined;
+        merchants_interpretation_version?: 0 | undefined;
+    }, {
+        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;
+        is_internal_transfer?: boolean | null | undefined;
+        transfer_pair_id?: string | null | undefined;
+        transfers_interpretation_version?: 0 | 1 | undefined;
+        merchants_interpretation_version?: 0 | undefined;
+    }>, "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;
+        is_internal_transfer?: boolean | null | undefined;
+        transfer_pair_id?: string | null | undefined;
+        transfers_interpretation_version?: 0 | 1 | undefined;
+        merchants_interpretation_version?: 0 | undefined;
+    }[];
+    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;
+        is_internal_transfer?: boolean | null | undefined;
+        transfer_pair_id?: string | null | undefined;
+        transfers_interpretation_version?: 0 | 1 | undefined;
+        merchants_interpretation_version?: 0 | undefined;
+    }[];
+    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>;
+        is_internal_transfer: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        transfer_pair_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        transfers_interpretation_version: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+        merchants_interpretation_version: z.ZodOptional<z.ZodLiteral<0>>;
+    }, "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;
+        is_internal_transfer?: boolean | null | undefined;
+        transfer_pair_id?: string | null | undefined;
+        transfers_interpretation_version?: 0 | 1 | undefined;
+        merchants_interpretation_version?: 0 | undefined;
+    }, {
+        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;
+        is_internal_transfer?: boolean | null | undefined;
+        transfer_pair_id?: string | null | undefined;
+        transfers_interpretation_version?: 0 | 1 | undefined;
+        merchants_interpretation_version?: 0 | undefined;
+    }>, "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;
+        is_internal_transfer?: boolean | null | undefined;
+        transfer_pair_id?: string | null | undefined;
+        transfers_interpretation_version?: 0 | 1 | undefined;
+        merchants_interpretation_version?: 0 | undefined;
+    }[];
+    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;
+        is_internal_transfer?: boolean | null | undefined;
+        transfer_pair_id?: string | null | undefined;
+        transfers_interpretation_version?: 0 | 1 | undefined;
+        merchants_interpretation_version?: 0 | undefined;
+    }[];
+    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>;
+            is_internal_transfer: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            transfer_pair_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            transfers_interpretation_version: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+            merchants_interpretation_version: z.ZodOptional<z.ZodLiteral<0>>;
+        }, "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;
+            is_internal_transfer?: boolean | null | undefined;
+            transfer_pair_id?: string | null | undefined;
+            transfers_interpretation_version?: 0 | 1 | undefined;
+            merchants_interpretation_version?: 0 | undefined;
+        }, {
+            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;
+            is_internal_transfer?: boolean | null | undefined;
+            transfer_pair_id?: string | null | undefined;
+            transfers_interpretation_version?: 0 | 1 | undefined;
+            merchants_interpretation_version?: 0 | undefined;
+        }>, "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;
+            is_internal_transfer?: boolean | null | undefined;
+            transfer_pair_id?: string | null | undefined;
+            transfers_interpretation_version?: 0 | 1 | undefined;
+            merchants_interpretation_version?: 0 | 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;
+            is_internal_transfer?: boolean | null | undefined;
+            transfer_pair_id?: string | null | undefined;
+            transfers_interpretation_version?: 0 | 1 | undefined;
+            merchants_interpretation_version?: 0 | undefined;
+        }[];
+    }>, "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;
+            is_internal_transfer?: boolean | null | undefined;
+            transfer_pair_id?: string | null | undefined;
+            transfers_interpretation_version?: 0 | 1 | undefined;
+            merchants_interpretation_version?: 0 | undefined;
+        }[];
+    }[];
+    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;
+            is_internal_transfer?: boolean | null | undefined;
+            transfer_pair_id?: string | null | undefined;
+            transfers_interpretation_version?: 0 | 1 | undefined;
+            merchants_interpretation_version?: 0 | undefined;
+        }[];
+    }[];
+    truncated?: boolean | undefined;
+}>;
 type JsonSchema7Document = JsonSchema7Type & {
     $schema?: string | undefined;
     definitions?: {
@@ -678,14 +1029,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;
@@ -703,6 +1055,10 @@ export declare const privateMcpToolDefinitions: readonly [{
             subcategory: z.ZodNullable<z.ZodString>;
             pending: z.ZodNullable<z.ZodBoolean>;
             currency: z.ZodNullable<z.ZodString>;
+            is_internal_transfer: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            transfer_pair_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            transfers_interpretation_version: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+            merchants_interpretation_version: z.ZodOptional<z.ZodLiteral<0>>;
         }, "strict", z.ZodTypeAny, {
             id: string;
             account_id: string | null;
@@ -714,6 +1070,10 @@ export declare const privateMcpToolDefinitions: readonly [{
             subcategory: string | null;
             pending: boolean | null;
             currency: string | null;
+            is_internal_transfer?: boolean | null | undefined;
+            transfer_pair_id?: string | null | undefined;
+            transfers_interpretation_version?: 0 | 1 | undefined;
+            merchants_interpretation_version?: 0 | undefined;
         }, {
             id: string;
             account_id: string | null;
@@ -725,7 +1085,13 @@ export declare const privateMcpToolDefinitions: readonly [{
             subcategory: string | null;
             pending: boolean | null;
             currency: string | null;
+            is_internal_transfer?: boolean | null | undefined;
+            transfer_pair_id?: string | null | undefined;
+            transfers_interpretation_version?: 0 | 1 | undefined;
+            merchants_interpretation_version?: 0 | undefined;
         }>, "many">;
+    } & {
+        truncated: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         month: string;
         start_date: string;
@@ -742,7 +1108,12 @@ export declare const privateMcpToolDefinitions: readonly [{
             subcategory: string | null;
             pending: boolean | null;
             currency: string | null;
+            is_internal_transfer?: boolean | null | undefined;
+            transfer_pair_id?: string | null | undefined;
+            transfers_interpretation_version?: 0 | 1 | undefined;
+            merchants_interpretation_version?: 0 | undefined;
         }[];
+        truncated?: boolean | undefined;
     }, {
         month: string;
         start_date: string;
@@ -759,7 +1130,12 @@ export declare const privateMcpToolDefinitions: readonly [{
             subcategory: string | null;
             pending: boolean | null;
             currency: string | null;
+            is_internal_transfer?: boolean | null | undefined;
+            transfer_pair_id?: string | null | undefined;
+            transfers_interpretation_version?: 0 | 1 | undefined;
+            merchants_interpretation_version?: 0 | undefined;
         }[];
+        truncated?: boolean | undefined;
     }>, z.ZodObject<{
         since: z.ZodString;
         window_days: z.ZodLiteral<10>;
@@ -775,6 +1151,10 @@ export declare const privateMcpToolDefinitions: readonly [{
             subcategory: z.ZodNullable<z.ZodString>;
             pending: z.ZodNullable<z.ZodBoolean>;
             currency: z.ZodNullable<z.ZodString>;
+            is_internal_transfer: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            transfer_pair_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            transfers_interpretation_version: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+            merchants_interpretation_version: z.ZodOptional<z.ZodLiteral<0>>;
         }, "strict", z.ZodTypeAny, {
             id: string;
             account_id: string | null;
@@ -786,6 +1166,10 @@ export declare const privateMcpToolDefinitions: readonly [{
             subcategory: string | null;
             pending: boolean | null;
             currency: string | null;
+            is_internal_transfer?: boolean | null | undefined;
+            transfer_pair_id?: string | null | undefined;
+            transfers_interpretation_version?: 0 | 1 | undefined;
+            merchants_interpretation_version?: 0 | undefined;
         }, {
             id: string;
             account_id: string | null;
@@ -797,7 +1181,13 @@ export declare const privateMcpToolDefinitions: readonly [{
             subcategory: string | null;
             pending: boolean | null;
             currency: string | null;
+            is_internal_transfer?: boolean | null | undefined;
+            transfer_pair_id?: string | null | undefined;
+            transfers_interpretation_version?: 0 | 1 | undefined;
+            merchants_interpretation_version?: 0 | undefined;
         }>, "many">;
+    } & {
+        truncated: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         since: string;
         window_days: 10;
@@ -813,7 +1203,12 @@ export declare const privateMcpToolDefinitions: readonly [{
             subcategory: string | null;
             pending: boolean | null;
             currency: string | null;
+            is_internal_transfer?: boolean | null | undefined;
+            transfer_pair_id?: string | null | undefined;
+            transfers_interpretation_version?: 0 | 1 | undefined;
+            merchants_interpretation_version?: 0 | undefined;
         }[];
+        truncated?: boolean | undefined;
     }, {
         since: string;
         window_days: 10;
@@ -829,7 +1224,156 @@ export declare const privateMcpToolDefinitions: readonly [{
             subcategory: string | null;
             pending: boolean | null;
             currency: string | null;
+            is_internal_transfer?: boolean | null | undefined;
+            transfer_pair_id?: string | null | undefined;
+            transfers_interpretation_version?: 0 | 1 | undefined;
+            merchants_interpretation_version?: 0 | undefined;
+        }[];
+        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>;
+                is_internal_transfer: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                transfer_pair_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                transfers_interpretation_version: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+                merchants_interpretation_version: z.ZodOptional<z.ZodLiteral<0>>;
+            }, "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;
+                is_internal_transfer?: boolean | null | undefined;
+                transfer_pair_id?: string | null | undefined;
+                transfers_interpretation_version?: 0 | 1 | undefined;
+                merchants_interpretation_version?: 0 | undefined;
+            }, {
+                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;
+                is_internal_transfer?: boolean | null | undefined;
+                transfer_pair_id?: string | null | undefined;
+                transfers_interpretation_version?: 0 | 1 | undefined;
+                merchants_interpretation_version?: 0 | undefined;
+            }>, "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;
+                is_internal_transfer?: boolean | null | undefined;
+                transfer_pair_id?: string | null | undefined;
+                transfers_interpretation_version?: 0 | 1 | undefined;
+                merchants_interpretation_version?: 0 | 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;
+                is_internal_transfer?: boolean | null | undefined;
+                transfer_pair_id?: string | null | undefined;
+                transfers_interpretation_version?: 0 | 1 | undefined;
+                merchants_interpretation_version?: 0 | undefined;
+            }[];
+        }>, "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;
+                is_internal_transfer?: boolean | null | undefined;
+                transfer_pair_id?: string | null | undefined;
+                transfers_interpretation_version?: 0 | 1 | undefined;
+                merchants_interpretation_version?: 0 | undefined;
+            }[];
+        }[];
+        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;
+                is_internal_transfer?: boolean | null | undefined;
+                transfer_pair_id?: string | null | undefined;
+                transfers_interpretation_version?: 0 | 1 | undefined;
+                merchants_interpretation_version?: 0 | undefined;
+            }[];
         }[];
+        truncated?: boolean | undefined;
     }>]>;
 }, {
     readonly name: "search_operations";
@@ -1044,7 +1588,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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"}