@warmio/contracts 1.0.0

package/dist/schemas/financial-context.d.ts

@@ -0,0 +1,1300 @@
+import { z } from 'zod';
+export declare const FINANCIAL_CONTEXT_VERSIONS: readonly ['v1'];
+export declare const FINANCIAL_CONTEXT_CURRENCIES: readonly ['USD'];
+export declare const FINANCIAL_CONTEXT_ACCOUNT_TYPES: readonly ['depository', 'credit', 'loan', 'investment', 'brokerage', 'other'];
+export declare const FINANCIAL_CONTEXT_ACCOUNT_GROUPS: readonly ['cash', 'debt', 'investments'];
+export declare const FINANCIAL_CONTEXT_RECURRING_DIRECTIONS: readonly ['inflow', 'outflow'];
+export declare const FINANCIAL_CONTEXT_RECURRING_STATUSES: readonly ['active', 'inactive', 'dismissed'];
+export declare const FINANCIAL_CONTEXT_BUDGET_TYPES: readonly ['category', 'merchant'];
+export declare const FINANCIAL_CONTEXT_BUDGET_PERIODS: readonly ['weekly', 'biweekly', 'monthly'];
+export declare const FINANCIAL_CONTEXT_BUDGET_STATUSES: readonly ['under', 'warning', 'over'];
+export declare const FINANCIAL_CONTEXT_GOAL_STATUSES: readonly ['not_started', 'in_progress', 'on_track', 'behind', 'completed'];
+export declare const FINANCIAL_CONTEXT_LIABILITY_TYPES: readonly ['credit', 'student', 'mortgage', 'other'];
+export declare const FINANCIAL_CONTEXT_RATE_TYPES: readonly ['fixed', 'variable'];
+export declare const FINANCIAL_CONTEXT_HOLDING_TYPES: readonly ['cash', 'derivative', 'equity', 'etf', 'fixed_income', 'mutual_fund', 'other'];
+export declare const FREQUENCIES: readonly ['WEEKLY', 'BIWEEKLY', 'MONTHLY', 'QUARTERLY', 'SEMI_ANNUALLY', 'ANNUALLY'];
+export declare const LATEST_FINANCIAL_CONTEXT_TRANSACTION_WINDOW_DAYS = 10;
+export declare const financialContextAccountSchema: 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;
+}>;
+export declare const financialContextTransactionSchema: 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;
+}>;
+export declare const financialContextPositionSchema: 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;
+}>;
+export declare const financialContextStatusSchema: 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;
+    }[];
+}>;
+export declare const financialContextTransactionIndexSchema: 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;
+    }[];
+}>;
+export declare const financialContextRecurringSchema: 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;
+}>;
+export declare const financialContextBudgetSchema: 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;
+}>;
+export declare const financialContextGoalSchema: 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;
+}>;
+export declare const financialContextSnapshotSchema: 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>;
+}, "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;
+}, {
+    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;
+}>;
+export declare const financialContextLiabilitySchema: 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;
+}>;
+export declare const financialContextHoldingSchema: 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;
+}>;
+export declare const financialContextHealthSchema: z.ZodObject<{
+    score: 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;
+    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;
+    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;
+}>;
+export declare const financialContextSchema: 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>;
+    }, "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;
+    }, {
+        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;
+    }>, "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;
+        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;
+        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;
+        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;
+    }[];
+    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;
+        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;
+    }[];
+    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;
+        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;
+}>;
+export declare const financialContextMetaSchema: z.ZodObject<{
+    version: z.ZodEnum<["v1"]>;
+    user_id: z.ZodString;
+    context_id: z.ZodString;
+    generated_at: z.ZodString;
+    updated_at: z.ZodString;
+    content_hash: z.ZodString;
+    byte_length: z.ZodNumber;
+    counts: z.ZodObject<{
+        accounts: z.ZodNumber;
+        transaction_months: z.ZodNumber;
+        transactions: z.ZodNumber;
+        snapshots: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        accounts: number;
+        transaction_months: number;
+        transactions: number;
+        snapshots: number;
+    }, {
+        accounts: number;
+        transaction_months: number;
+        transactions: number;
+        snapshots: number;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    version: "v1";
+    user_id: string;
+    context_id: string;
+    generated_at: string;
+    updated_at: string;
+    content_hash: string;
+    byte_length: number;
+    counts: {
+        accounts: number;
+        transaction_months: number;
+        transactions: number;
+        snapshots: number;
+    };
+}, {
+    version: "v1";
+    user_id: string;
+    context_id: string;
+    generated_at: string;
+    updated_at: string;
+    content_hash: string;
+    byte_length: number;
+    counts: {
+        accounts: number;
+        transaction_months: number;
+        transactions: number;
+        snapshots: number;
+    };
+}>;
+export declare const transactionMonthSchema: 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;
+    }[];
+}>;
+export declare const latestTransactionsSchema: 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;
+    }[];
+}>;
+export declare const financialContextTransactionsRequestSchema: z.ZodUnion<[z.ZodObject<{
+    month: z.ZodString;
+    latest: z.ZodOptional<z.ZodUndefined>;
+}, "strict", z.ZodTypeAny, {
+    month: string;
+    latest?: undefined;
+}, {
+    month: string;
+    latest?: undefined;
+}>, z.ZodObject<{
+    month: z.ZodOptional<z.ZodUndefined>;
+    latest: z.ZodLiteral<"1">;
+}, "strict", z.ZodTypeAny, {
+    month?: undefined;
+    latest: "1";
+}, {
+    month?: undefined;
+    latest: "1";
+}>]>;
+export declare const financialContextRebuildRequestSchema: z.ZodObject<{
+    user_id: z.ZodString;
+    reason: z.ZodOptional<z.ZodEnum<["data_arrival", "edit", "daily_sweep", "first_read"]>>;
+}, "strip", z.ZodTypeAny, {
+    user_id: string;
+    reason?: "daily_sweep" | "data_arrival" | "edit" | "first_read" | undefined;
+}, {
+    user_id: string;
+    reason?: "daily_sweep" | "data_arrival" | "edit" | "first_read" | undefined;
+}>;
+//# sourceMappingURL=financial-context.d.ts.map