@warmio/contracts 2.0.0 → 3.0.2

package/dist/mcp/tools.d.ts

@@ -1,8 +1,8 @@
-import { z, type ZodRawShape } from 'zod';
-import type { PrivateMcpMode } from './distribution.js';
+import { z } from 'zod';
+import { type JsonSchema7Type } from 'zod-to-json-schema';
 export declare const emptyMcpInputShape: {};
 export declare const getTransactionsMcpInputShape: {
-    period: z.ZodString;
+    period: z.ZodUnion<[z.ZodLiteral<"latest">, z.ZodString]>;
 };
 export declare const searchOperationsMcpInputShape: {
     query: z.ZodOptional<z.ZodString>;
@@ -35,7 +35,7 @@ export declare const invokeOperationMcpInputShape: {
     approval_id: z.ZodOptional<z.ZodString>;
 };
 export declare const getTransactionsMcpInputSchema: z.ZodObject<{
-    period: z.ZodString;
+    period: z.ZodUnion<[z.ZodLiteral<"latest">, z.ZodString]>;
 }, "strict", z.ZodTypeAny, {
     period: string;
 }, {
@@ -43,40 +43,1041 @@ export declare const getTransactionsMcpInputSchema: z.ZodObject<{
 }>;
 export declare function normalizeGetTransactionsMcpInput(input: z.infer<typeof getTransactionsMcpInputSchema>): {
     readonly latest: true;
-    readonly month?: undefined;
+    readonly month?: never;
 } | {
-    readonly latest?: undefined;
+    readonly latest?: never;
     readonly month: string;
 };
-type McpToolDefinition = {
+type JsonSchema7Document = JsonSchema7Type & {
+    $schema?: string | undefined;
+    definitions?: {
+        [key: string]: JsonSchema7Type;
+    } | undefined;
+};
+export declare const privateMcpToolDefinitions: readonly [{
+    readonly name: "get_financial_context";
+    readonly description: "Read-only compact FinancialContext JSON. Includes status.position, status.accounts, transaction index total/months, recurring, budgets, goals, snapshots, liabilities, holdings, and health. The status.position field is a point-in-time (as-of-date) balance snapshot, separate from transaction and behavior windows. A null position means no position snapshot is available. Transaction items are not inline; use get_transactions for items.";
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly inputShape: {};
+    readonly outputSchema: z.ZodObject<{
+        version: z.ZodEnum<["v1"]>;
+        updated_at: z.ZodString;
+        currency: z.ZodEnum<["USD"]>;
+        status: z.ZodObject<{
+            position: z.ZodNullable<z.ZodObject<{
+                date: z.ZodNullable<z.ZodString>;
+                net_worth: z.ZodNullable<z.ZodNumber>;
+                cash: z.ZodNullable<z.ZodNumber>;
+                debt: z.ZodNullable<z.ZodNumber>;
+                investments: z.ZodNullable<z.ZodNumber>;
+                other_assets: z.ZodNullable<z.ZodNumber>;
+                total_assets: z.ZodNullable<z.ZodNumber>;
+            }, "strict", z.ZodTypeAny, {
+                date: string | null;
+                net_worth: number | null;
+                cash: number | null;
+                debt: number | null;
+                investments: number | null;
+                other_assets: number | null;
+                total_assets: number | null;
+            }, {
+                date: string | null;
+                net_worth: number | null;
+                cash: number | null;
+                debt: number | null;
+                investments: number | null;
+                other_assets: number | null;
+                total_assets: number | null;
+            }>>;
+            accounts: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                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"]>>;
+                institution: z.ZodNullable<z.ZodString>;
+                mask: z.ZodNullable<z.ZodString>;
+                balance: z.ZodNullable<z.ZodNumber>;
+                available: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodNullable<z.ZodString>;
+                updated_at: z.ZodNullable<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                id: string;
+                name: string;
+                source: "csv_import" | "manual" | "plaid" | null;
+                type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
+                subtype: string | null;
+                group: "cash" | "debt" | "investments" | null;
+                institution: string | null;
+                mask: string | null;
+                balance: number | null;
+                available: number | null;
+                currency: string | null;
+                updated_at: string | null;
+            }, {
+                id: string;
+                name: string;
+                source: "csv_import" | "manual" | "plaid" | null;
+                type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
+                subtype: string | null;
+                group: "cash" | "debt" | "investments" | null;
+                institution: string | null;
+                mask: string | null;
+                balance: number | null;
+                available: number | null;
+                currency: string | null;
+                updated_at: string | null;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            position: {
+                date: string | null;
+                net_worth: number | null;
+                cash: number | null;
+                debt: number | null;
+                investments: number | null;
+                other_assets: number | null;
+                total_assets: number | null;
+            } | null;
+            accounts: {
+                id: string;
+                name: string;
+                source: "csv_import" | "manual" | "plaid" | null;
+                type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
+                subtype: string | null;
+                group: "cash" | "debt" | "investments" | null;
+                institution: string | null;
+                mask: string | null;
+                balance: number | null;
+                available: number | null;
+                currency: string | null;
+                updated_at: string | null;
+            }[];
+        }, {
+            position: {
+                date: string | null;
+                net_worth: number | null;
+                cash: number | null;
+                debt: number | null;
+                investments: number | null;
+                other_assets: number | null;
+                total_assets: number | null;
+            } | null;
+            accounts: {
+                id: string;
+                name: string;
+                source: "csv_import" | "manual" | "plaid" | null;
+                type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
+                subtype: string | null;
+                group: "cash" | "debt" | "investments" | null;
+                institution: string | null;
+                mask: string | null;
+                balance: number | null;
+                available: number | null;
+                currency: string | null;
+                updated_at: string | null;
+            }[];
+        }>;
+        transactions: z.ZodObject<{
+            total: z.ZodNumber;
+            months: z.ZodArray<z.ZodObject<{
+                month: z.ZodString;
+                count: z.ZodNumber;
+            }, "strict", z.ZodTypeAny, {
+                month: string;
+                count: number;
+            }, {
+                month: string;
+                count: number;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            total: number;
+            months: {
+                month: string;
+                count: number;
+            }[];
+        }, {
+            total: number;
+            months: {
+                month: string;
+                count: number;
+            }[];
+        }>;
+        recurring: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            account_id: z.ZodNullable<z.ZodString>;
+            direction: z.ZodNullable<z.ZodEnum<["inflow", "outflow"]>>;
+            frequency: z.ZodNullable<z.ZodEnum<["WEEKLY", "BIWEEKLY", "MONTHLY", "QUARTERLY", "SEMI_ANNUALLY", "ANNUALLY"]>>;
+            status: z.ZodNullable<z.ZodEnum<["active", "inactive", "dismissed"]>>;
+            merchant: z.ZodNullable<z.ZodString>;
+            amount: z.ZodNullable<z.ZodNumber>;
+            next_date: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            account_id: string | null;
+            direction: "inflow" | "outflow" | null;
+            frequency: "ANNUALLY" | "BIWEEKLY" | "MONTHLY" | "QUARTERLY" | "SEMI_ANNUALLY" | "WEEKLY" | null;
+            status: "active" | "dismissed" | "inactive" | null;
+            merchant: string | null;
+            amount: number | null;
+            next_date: string | null;
+        }, {
+            id: string;
+            account_id: string | null;
+            direction: "inflow" | "outflow" | null;
+            frequency: "ANNUALLY" | "BIWEEKLY" | "MONTHLY" | "QUARTERLY" | "SEMI_ANNUALLY" | "WEEKLY" | null;
+            status: "active" | "dismissed" | "inactive" | null;
+            merchant: string | null;
+            amount: number | null;
+            next_date: string | null;
+        }>, "many">;
+        budgets: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodEnum<["category", "merchant"]>;
+            period: z.ZodEnum<["weekly", "biweekly", "monthly"]>;
+            status: z.ZodEnum<["under", "warning", "over"]>;
+            amount: z.ZodNumber;
+            spent: z.ZodNumber;
+            remaining: z.ZodNumber;
+            used_percent: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            name: string;
+            type: "category" | "merchant";
+            period: "biweekly" | "monthly" | "weekly";
+            status: "over" | "under" | "warning";
+            amount: number;
+            spent: number;
+            remaining: number;
+            used_percent: number;
+        }, {
+            id: string;
+            name: string;
+            type: "category" | "merchant";
+            period: "biweekly" | "monthly" | "weekly";
+            status: "over" | "under" | "warning";
+            amount: number;
+            spent: number;
+            remaining: number;
+            used_percent: number;
+        }>, "many">;
+        goals: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            category: z.ZodString;
+            status: z.ZodEnum<["not_started", "in_progress", "on_track", "behind", "completed"]>;
+            target: z.ZodNumber;
+            current: z.ZodNumber;
+            progress_percent: z.ZodNumber;
+            target_date: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            name: string;
+            category: string;
+            status: "behind" | "completed" | "in_progress" | "not_started" | "on_track";
+            target: number;
+            current: number;
+            progress_percent: number;
+            target_date: string | null;
+        }, {
+            id: string;
+            name: string;
+            category: string;
+            status: "behind" | "completed" | "in_progress" | "not_started" | "on_track";
+            target: number;
+            current: number;
+            progress_percent: number;
+            target_date: string | null;
+        }>, "many">;
+        snapshots: z.ZodArray<z.ZodObject<{
+            date: z.ZodString;
+            net_worth: z.ZodNullable<z.ZodNumber>;
+            cash: z.ZodNullable<z.ZodNumber>;
+            debt: z.ZodNullable<z.ZodNumber>;
+            income: z.ZodNullable<z.ZodNumber>;
+            expenses: z.ZodNullable<z.ZodNumber>;
+            cash_flow: z.ZodNullable<z.ZodNumber>;
+            savings_rate: z.ZodNullable<z.ZodNumber>;
+            investments: z.ZodNullable<z.ZodNumber>;
+            assets: z.ZodNullable<z.ZodNumber>;
+            health_score: z.ZodNullable<z.ZodNumber>;
+            health_score_model_version: z.ZodNullable<z.ZodLiteral<2>>;
+        }, "strict", z.ZodTypeAny, {
+            date: string;
+            net_worth: number | null;
+            cash: number | null;
+            debt: number | null;
+            income: number | null;
+            expenses: number | null;
+            cash_flow: number | null;
+            savings_rate: number | null;
+            investments: number | null;
+            assets: number | null;
+            health_score: number | null;
+            health_score_model_version: 2 | null;
+        }, {
+            date: string;
+            net_worth: number | null;
+            cash: number | null;
+            debt: number | null;
+            income: number | null;
+            expenses: number | null;
+            cash_flow: number | null;
+            savings_rate: number | null;
+            investments: number | null;
+            assets: number | null;
+            health_score: number | null;
+            health_score_model_version: 2 | null;
+        }>, "many">;
+        liabilities: z.ZodArray<z.ZodObject<{
+            account_id: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["credit", "student", "mortgage", "other"]>>;
+            balance: z.ZodNullable<z.ZodNumber>;
+            minimum_payment: z.ZodNullable<z.ZodNumber>;
+            due_date: z.ZodNullable<z.ZodString>;
+            interest_rate: z.ZodNullable<z.ZodNumber>;
+            rate_type: z.ZodNullable<z.ZodEnum<["fixed", "variable"]>>;
+            overdue: z.ZodNullable<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            account_id: string | null;
+            type: "credit" | "mortgage" | "other" | "student" | null;
+            balance: number | null;
+            minimum_payment: number | null;
+            due_date: string | null;
+            interest_rate: number | null;
+            rate_type: "fixed" | "variable" | null;
+            overdue: boolean | null;
+        }, {
+            account_id: string | null;
+            type: "credit" | "mortgage" | "other" | "student" | null;
+            balance: number | null;
+            minimum_payment: number | null;
+            due_date: string | null;
+            interest_rate: number | null;
+            rate_type: "fixed" | "variable" | null;
+            overdue: boolean | null;
+        }>, "many">;
+        holdings: z.ZodArray<z.ZodObject<{
+            account_id: z.ZodNullable<z.ZodString>;
+            symbol: z.ZodNullable<z.ZodString>;
+            name: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["cash", "derivative", "equity", "etf", "fixed_income", "mutual_fund", "other"]>>;
+            quantity: z.ZodNullable<z.ZodNumber>;
+            value: z.ZodNullable<z.ZodNumber>;
+            cost_basis: z.ZodNullable<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            account_id: string | null;
+            symbol: string | null;
+            name: string | null;
+            type: "cash" | "derivative" | "equity" | "etf" | "fixed_income" | "mutual_fund" | "other" | null;
+            quantity: number | null;
+            value: number | null;
+            cost_basis: number | null;
+        }, {
+            account_id: string | null;
+            symbol: string | null;
+            name: string | null;
+            type: "cash" | "derivative" | "equity" | "etf" | "fixed_income" | "mutual_fund" | "other" | null;
+            quantity: number | null;
+            value: number | null;
+            cost_basis: number | null;
+        }>, "many">;
+        health: z.ZodNullable<z.ZodObject<{
+            score: z.ZodNumber;
+            model_version: z.ZodLiteral<2>;
+            record_count: z.ZodNumber;
+            label: z.ZodEnum<["Needs Attention", "Good", "Strong"]>;
+            level: z.ZodEnum<["strong", "good", "fair", "poor", "critical"]>;
+            summary: z.ZodString;
+            data_completeness: z.ZodNumber;
+            pillars: z.ZodNullable<z.ZodObject<{
+                spend: z.ZodNullable<z.ZodNumber>;
+                save: z.ZodNullable<z.ZodNumber>;
+                borrow: z.ZodNullable<z.ZodNumber>;
+                build: z.ZodNullable<z.ZodNumber>;
+            }, "strict", z.ZodTypeAny, {
+                spend: number | null;
+                save: number | null;
+                borrow: number | null;
+                build: number | null;
+            }, {
+                spend: number | null;
+                save: number | null;
+                borrow: number | null;
+                build: number | null;
+            }>>;
+        }, "strict", z.ZodTypeAny, {
+            score: number;
+            model_version: 2;
+            record_count: number;
+            label: "Good" | "Needs Attention" | "Strong";
+            level: "critical" | "fair" | "good" | "poor" | "strong";
+            summary: string;
+            data_completeness: number;
+            pillars: {
+                spend: number | null;
+                save: number | null;
+                borrow: number | null;
+                build: number | null;
+            } | null;
+        }, {
+            score: number;
+            model_version: 2;
+            record_count: number;
+            label: "Good" | "Needs Attention" | "Strong";
+            level: "critical" | "fair" | "good" | "poor" | "strong";
+            summary: string;
+            data_completeness: number;
+            pillars: {
+                spend: number | null;
+                save: number | null;
+                borrow: number | null;
+                build: number | null;
+            } | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        version: "v1";
+        updated_at: string;
+        currency: "USD";
+        status: {
+            position: {
+                date: string | null;
+                net_worth: number | null;
+                cash: number | null;
+                debt: number | null;
+                investments: number | null;
+                other_assets: number | null;
+                total_assets: number | null;
+            } | null;
+            accounts: {
+                id: string;
+                name: string;
+                source: "csv_import" | "manual" | "plaid" | null;
+                type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
+                subtype: string | null;
+                group: "cash" | "debt" | "investments" | null;
+                institution: string | null;
+                mask: string | null;
+                balance: number | null;
+                available: number | null;
+                currency: string | null;
+                updated_at: string | null;
+            }[];
+        };
+        transactions: {
+            total: number;
+            months: {
+                month: string;
+                count: number;
+            }[];
+        };
+        recurring: {
+            id: string;
+            account_id: string | null;
+            direction: "inflow" | "outflow" | null;
+            frequency: "ANNUALLY" | "BIWEEKLY" | "MONTHLY" | "QUARTERLY" | "SEMI_ANNUALLY" | "WEEKLY" | null;
+            status: "active" | "dismissed" | "inactive" | null;
+            merchant: string | null;
+            amount: number | null;
+            next_date: string | null;
+        }[];
+        budgets: {
+            id: string;
+            name: string;
+            type: "category" | "merchant";
+            period: "biweekly" | "monthly" | "weekly";
+            status: "over" | "under" | "warning";
+            amount: number;
+            spent: number;
+            remaining: number;
+            used_percent: number;
+        }[];
+        goals: {
+            id: string;
+            name: string;
+            category: string;
+            status: "behind" | "completed" | "in_progress" | "not_started" | "on_track";
+            target: number;
+            current: number;
+            progress_percent: number;
+            target_date: string | null;
+        }[];
+        snapshots: {
+            date: string;
+            net_worth: number | null;
+            cash: number | null;
+            debt: number | null;
+            income: number | null;
+            expenses: number | null;
+            cash_flow: number | null;
+            savings_rate: number | null;
+            investments: number | null;
+            assets: number | null;
+            health_score: number | null;
+            health_score_model_version: 2 | null;
+        }[];
+        liabilities: {
+            account_id: string | null;
+            type: "credit" | "mortgage" | "other" | "student" | null;
+            balance: number | null;
+            minimum_payment: number | null;
+            due_date: string | null;
+            interest_rate: number | null;
+            rate_type: "fixed" | "variable" | null;
+            overdue: boolean | null;
+        }[];
+        holdings: {
+            account_id: string | null;
+            symbol: string | null;
+            name: string | null;
+            type: "cash" | "derivative" | "equity" | "etf" | "fixed_income" | "mutual_fund" | "other" | null;
+            quantity: number | null;
+            value: number | null;
+            cost_basis: number | null;
+        }[];
+        health: {
+            score: number;
+            model_version: 2;
+            record_count: number;
+            label: "Good" | "Needs Attention" | "Strong";
+            level: "critical" | "fair" | "good" | "poor" | "strong";
+            summary: string;
+            data_completeness: number;
+            pillars: {
+                spend: number | null;
+                save: number | null;
+                borrow: number | null;
+                build: number | null;
+            } | null;
+        } | null;
+    }, {
+        version: "v1";
+        updated_at: string;
+        currency: "USD";
+        status: {
+            position: {
+                date: string | null;
+                net_worth: number | null;
+                cash: number | null;
+                debt: number | null;
+                investments: number | null;
+                other_assets: number | null;
+                total_assets: number | null;
+            } | null;
+            accounts: {
+                id: string;
+                name: string;
+                source: "csv_import" | "manual" | "plaid" | null;
+                type: "brokerage" | "credit" | "depository" | "investment" | "loan" | "other";
+                subtype: string | null;
+                group: "cash" | "debt" | "investments" | null;
+                institution: string | null;
+                mask: string | null;
+                balance: number | null;
+                available: number | null;
+                currency: string | null;
+                updated_at: string | null;
+            }[];
+        };
+        transactions: {
+            total: number;
+            months: {
+                month: string;
+                count: number;
+            }[];
+        };
+        recurring: {
+            id: string;
+            account_id: string | null;
+            direction: "inflow" | "outflow" | null;
+            frequency: "ANNUALLY" | "BIWEEKLY" | "MONTHLY" | "QUARTERLY" | "SEMI_ANNUALLY" | "WEEKLY" | null;
+            status: "active" | "dismissed" | "inactive" | null;
+            merchant: string | null;
+            amount: number | null;
+            next_date: string | null;
+        }[];
+        budgets: {
+            id: string;
+            name: string;
+            type: "category" | "merchant";
+            period: "biweekly" | "monthly" | "weekly";
+            status: "over" | "under" | "warning";
+            amount: number;
+            spent: number;
+            remaining: number;
+            used_percent: number;
+        }[];
+        goals: {
+            id: string;
+            name: string;
+            category: string;
+            status: "behind" | "completed" | "in_progress" | "not_started" | "on_track";
+            target: number;
+            current: number;
+            progress_percent: number;
+            target_date: string | null;
+        }[];
+        snapshots: {
+            date: string;
+            net_worth: number | null;
+            cash: number | null;
+            debt: number | null;
+            income: number | null;
+            expenses: number | null;
+            cash_flow: number | null;
+            savings_rate: number | null;
+            investments: number | null;
+            assets: number | null;
+            health_score: number | null;
+            health_score_model_version: 2 | null;
+        }[];
+        liabilities: {
+            account_id: string | null;
+            type: "credit" | "mortgage" | "other" | "student" | null;
+            balance: number | null;
+            minimum_payment: number | null;
+            due_date: string | null;
+            interest_rate: number | null;
+            rate_type: "fixed" | "variable" | null;
+            overdue: boolean | null;
+        }[];
+        holdings: {
+            account_id: string | null;
+            symbol: string | null;
+            name: string | null;
+            type: "cash" | "derivative" | "equity" | "etf" | "fixed_income" | "mutual_fund" | "other" | null;
+            quantity: number | null;
+            value: number | null;
+            cost_basis: number | null;
+        }[];
+        health: {
+            score: number;
+            model_version: 2;
+            record_count: number;
+            label: "Good" | "Needs Attention" | "Strong";
+            level: "critical" | "fair" | "good" | "poor" | "strong";
+            summary: string;
+            data_completeness: number;
+            pillars: {
+                spend: number | null;
+                save: number | null;
+                borrow: number | null;
+                build: number | null;
+            } | null;
+        } | null;
+    }>;
+}, {
+    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 annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly inputShape: {
+        period: z.ZodUnion<[z.ZodLiteral<"latest">, z.ZodString]>;
+    };
+    readonly outputSchema: z.ZodUnion<[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;
+        }[];
+    }>, 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">;
+    }, "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;
+        }[];
+    }, {
+        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;
+        }[];
+    }>]>;
+}, {
+    readonly name: "search_operations";
+    readonly description: "Search the supported Warm operation catalog. Use this first to find the smallest matching operation.";
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly inputShape: {
+        query: z.ZodOptional<z.ZodString>;
+    };
+    readonly outputSchema: z.ZodObject<{
+        operations: z.ZodArray<z.ZodObject<Omit<{
+            confirmation_required: z.ZodBoolean;
+            description: z.ZodString;
+            method: z.ZodEnum<["DELETE", "GET", "PATCH", "POST", "PUT"]>;
+            operation_id: z.ZodString;
+            path: z.ZodString;
+            path_parameter_kind: z.ZodNullable<z.ZodEnum<["opaque", "uuid"]>>;
+            risk: z.ZodArray<z.ZodEnum<["read", "write", "destructive", "external_effect"]>, "many">;
+            summary: z.ZodString;
+        }, "path_parameter_kind">, "strict", z.ZodTypeAny, {
+            confirmation_required: boolean;
+            description: string;
+            method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+            operation_id: string;
+            path: string;
+            risk: ("destructive" | "external_effect" | "read" | "write")[];
+            summary: string;
+        }, {
+            confirmation_required: boolean;
+            description: string;
+            method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+            operation_id: string;
+            path: string;
+            risk: ("destructive" | "external_effect" | "read" | "write")[];
+            summary: string;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        operations: {
+            confirmation_required: boolean;
+            description: string;
+            method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+            operation_id: string;
+            path: string;
+            risk: ("destructive" | "external_effect" | "read" | "write")[];
+            summary: string;
+        }[];
+    }, {
+        operations: {
+            confirmation_required: boolean;
+            description: string;
+            method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+            operation_id: string;
+            path: string;
+            risk: ("destructive" | "external_effect" | "read" | "write")[];
+            summary: string;
+        }[];
+    }>;
+}, {
+    readonly name: "describe_operation";
+    readonly description: "Describe one operation, including its input schema and risk. For write operations, pass the exact intended input to receive an approval with its ID, status, URL, and expiry.";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly inputShape: {
+        operation_id: z.ZodString;
+        input: z.ZodOptional<z.ZodObject<{
+            body: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strict", z.ZodTypeAny, {
+            body?: Record<string, unknown> | undefined;
+            params?: Record<string, string> | undefined;
+        }, {
+            body?: Record<string, unknown> | undefined;
+            params?: Record<string, string> | undefined;
+        }>>;
+    };
+    readonly outputSchema: z.ZodObject<{
+        approval: z.ZodOptional<z.ZodObject<{
+            approval_url: z.ZodString;
+            expires_at: z.ZodString;
+            id: z.ZodString;
+            status: z.ZodLiteral<"pending">;
+        }, "strict", z.ZodTypeAny, {
+            approval_url: string;
+            expires_at: string;
+            id: string;
+            status: "pending";
+        }, {
+            approval_url: string;
+            expires_at: string;
+            id: string;
+            status: "pending";
+        }>>;
+        operation: z.ZodObject<Omit<{
+            confirmation_required: z.ZodBoolean;
+            description: z.ZodString;
+            method: z.ZodEnum<["DELETE", "GET", "PATCH", "POST", "PUT"]>;
+            operation_id: z.ZodString;
+            path: z.ZodString;
+            path_parameter_kind: z.ZodNullable<z.ZodEnum<["opaque", "uuid"]>>;
+            risk: z.ZodArray<z.ZodEnum<["read", "write", "destructive", "external_effect"]>, "many">;
+            summary: z.ZodString;
+        }, "path_parameter_kind"> & {
+            input_schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, "strict", z.ZodTypeAny, {
+            confirmation_required: boolean;
+            description: string;
+            method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+            operation_id: string;
+            path: string;
+            risk: ("destructive" | "external_effect" | "read" | "write")[];
+            summary: string;
+            input_schema: Record<string, unknown>;
+        }, {
+            confirmation_required: boolean;
+            description: string;
+            method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+            operation_id: string;
+            path: string;
+            risk: ("destructive" | "external_effect" | "read" | "write")[];
+            summary: string;
+            input_schema: Record<string, unknown>;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        approval?: {
+            approval_url: string;
+            expires_at: string;
+            id: string;
+            status: "pending";
+        } | undefined;
+        operation: {
+            confirmation_required: boolean;
+            description: string;
+            method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+            operation_id: string;
+            path: string;
+            risk: ("destructive" | "external_effect" | "read" | "write")[];
+            summary: string;
+            input_schema: Record<string, unknown>;
+        };
+    }, {
+        approval?: {
+            approval_url: string;
+            expires_at: string;
+            id: string;
+            status: "pending";
+        } | undefined;
+        operation: {
+            confirmation_required: boolean;
+            description: string;
+            method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+            operation_id: string;
+            path: string;
+            risk: ("destructive" | "external_effect" | "read" | "write")[];
+            summary: string;
+            input_schema: Record<string, unknown>;
+        };
+    }>;
+}, {
+    readonly name: "invoke_operation";
+    readonly description: "Invoke one previously discovered Warm operation. Every write operation requires the approval_id returned for the exact same input by describe_operation.";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly inputShape: {
+        operation_id: z.ZodString;
+        input: z.ZodOptional<z.ZodObject<{
+            body: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strict", z.ZodTypeAny, {
+            body?: Record<string, unknown> | undefined;
+            params?: Record<string, string> | undefined;
+        }, {
+            body?: Record<string, unknown> | undefined;
+            params?: Record<string, string> | undefined;
+        }>>;
+        approval_id: z.ZodOptional<z.ZodString>;
+    };
+    readonly outputSchema: z.ZodObject<{
+        body: z.ZodUnknown;
+        headers: z.ZodRecord<z.ZodString, z.ZodString>;
+        operation_id: z.ZodString;
+        status: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        body?: unknown;
+        headers: Record<string, string>;
+        operation_id: string;
+        status: number;
+    }, {
+        body?: unknown;
+        headers: Record<string, string>;
+        operation_id: string;
+        status: number;
+    }>;
+}];
+export declare const privateMcpToolDescriptors: ({
+    name: "get_financial_context";
+    description: "Read-only compact FinancialContext JSON. Includes status.position, status.accounts, transaction index total/months, recurring, budgets, goals, snapshots, liabilities, holdings, and health. The status.position field is a point-in-time (as-of-date) balance snapshot, separate from transaction and behavior windows. A null position means no position snapshot is available. Transaction items are not inline; use get_transactions for items.";
     annotations: {
-        destructiveHint: boolean;
-        openWorldHint: boolean;
-        readOnlyHint: boolean;
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
     };
-    description: string;
-    inputShape: ZodRawShape;
-    mode: PrivateMcpMode;
-    name: string;
-    outputSchema: z.ZodTypeAny;
-};
-export declare const privateMcpToolDefinitions: readonly [McpToolDefinition, McpToolDefinition, McpToolDefinition, McpToolDefinition, McpToolDefinition, McpToolDefinition];
-export declare const privateMcpToolDescriptors: {
+    input_schema: JsonSchema7Document;
+    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.";
+    annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    input_schema: JsonSchema7Document;
+    output_schema: JsonSchema7Document;
+} | {
+    name: "search_operations";
+    description: "Search the supported Warm operation catalog. Use this first to find the smallest matching operation.";
     annotations: {
-        destructiveHint: boolean;
-        openWorldHint: boolean;
-        readOnlyHint: boolean;
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
     };
-    description: string;
-    mode: PrivateMcpMode;
-    name: string;
-    input_schema: {
-        $schema?: string | undefined;
+    input_schema: JsonSchema7Document;
+    output_schema: JsonSchema7Document;
+} | {
+    name: "describe_operation";
+    description: "Describe one operation, including its input schema and risk. For write operations, pass the exact intended input to receive an approval with its ID, status, URL, and expiry.";
+    annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
     };
-    output_schema: {
-        $schema?: string | undefined;
+    input_schema: JsonSchema7Document;
+    output_schema: JsonSchema7Document;
+} | {
+    name: "invoke_operation";
+    description: "Invoke one previously discovered Warm operation. Every write operation requires the approval_id returned for the exact same input by describe_operation.";
+    annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly openWorldHint: false;
     };
-}[];
+    input_schema: JsonSchema7Document;
+    output_schema: JsonSchema7Document;
+})[];
 export type PrivateMcpToolDescriptor = (typeof privateMcpToolDescriptors)[number];
 export {};
 //# sourceMappingURL=tools.d.ts.map