@warmio/contracts 1.1.0 → 1.2.0

package/dist/manifest.d.ts

@@ -1,4 +1,1437 @@
-export { apiAuthSchemes, apiEndpointManifest, apiKeyPrefixesByAudience, apiRateLimits, API_ORIGIN, DEVELOPERS_PATH, DISCOVERY_ORIGIN, OPENAPI_PATH, PUBLIC_DISCOVERY_MCP_PATH, PUBLIC_DOCS_ORIGIN, VERIFY_PATH, automationOperationDescriptors, } from './api/index.js';
+export { apiAudienceRegistry, apiAuthSchemes, apiEndpointManifest, apiKeyPrefixesByAudience, apiRateLimits, API_ORIGIN, DEVELOPERS_PATH, DISCOVERY_ORIGIN, OPENAPI_PATH, PUBLIC_DISCOVERY_MCP_PATH, PUBLIC_DOCS_ORIGIN, PUBLIC_LLMS_TXT_PATH, VERIFY_PATH, automationOperationDescriptors, } from './api/index.js';
 export { privateMcpToolDescriptors, type PrivateMcpToolDescriptor, } from './generated/private-mcp-tool-descriptors.js';
 export { WARM_MCP_CLIENTS, WARM_MCP_CREDENTIALS, WARM_MCP_INSTALL_COMMAND, WARM_MCP_INSTALLER_COMMANDS, WARM_MCP_MANIFEST, WARM_MCP_MINIMUM_NODE_VERSION, WARM_MCP_MODES, WARM_MCP_PACKAGE_NAME, WARM_MCP_PACKAGE_SPEC, WARM_MCP_PROJECT_CONFIGS, WARM_MCP_SERVER_COMMANDS, WARM_MCP_SERVER_CONFIGS, type PrivateMcpMode, type WarmMcpClientId, type WarmMcpConfigPath, } from './mcp/distribution.js';
+export { protectedCrawlerPaths } from './generated/protected-crawler-paths.js';
+/** Complete serializable release value used for provenance and downstream drift checks. */
+export declare const contractReleaseManifest: {
+    readonly api: {
+        readonly audiences: {
+            readonly automation: {
+                readonly auth: {
+                    readonly bearer_prefix: 'warm_auto_';
+                    readonly challenge: 'Bearer';
+                    readonly description: 'Automation routes require an automation API key.';
+                    readonly methods: readonly ['Bearer'];
+                };
+                readonly expires_in_days: 90;
+                readonly mcp_mode: 'automation';
+                readonly rate_limit_per_hour: 500;
+                readonly scopes: readonly ['financial:read', 'automation:invoke'];
+            };
+            readonly context: {
+                readonly auth: {
+                    readonly bearer_prefix: 'warm_ctx_';
+                    readonly challenge: 'Bearer';
+                    readonly description: 'Read/export routes accept a Warm API key or signed-in access token.';
+                    readonly methods: readonly ['Bearer'];
+                };
+                readonly expires_in_days: null;
+                readonly mcp_mode: 'context';
+                readonly rate_limit_per_hour: 200;
+                readonly scopes: readonly ['financial:read'];
+            };
+        };
+        readonly endpoints: readonly [{
+            readonly audience: 'context';
+            readonly method: 'GET';
+            readonly operation_id: 'verifyApiAccess';
+            readonly path: "/api/verify";
+            readonly summary: 'Verify API credentials';
+        }, {
+            readonly audience: 'context';
+            readonly method: 'GET';
+            readonly operation_id: 'getDatasetExport';
+            readonly path: '/api/export';
+            readonly summary: 'Get a typed dataset export';
+        }, {
+            readonly audience: 'context';
+            readonly method: 'GET';
+            readonly operation_id: 'getFinancialContext';
+            readonly path: '/api/financial-context';
+            readonly summary: 'Get compact financial context';
+        }, {
+            readonly audience: 'context';
+            readonly method: 'GET';
+            readonly operation_id: 'getFinancialContextTransactions';
+            readonly path: '/api/financial-context/transactions';
+            readonly summary: 'Get financial-context transactions';
+        }, {
+            readonly audience: 'context';
+            readonly method: 'GET';
+            readonly operation_id: 'getFinancialContextMeta';
+            readonly path: '/api/financial-context/meta';
+            readonly summary: 'Get financial-context metadata';
+        }, {
+            readonly audience: 'automation';
+            readonly method: 'POST';
+            readonly operation_id: 'searchOperations';
+            readonly path: '/api/automation/operations/search';
+            readonly summary: 'Search supported automation operations';
+        }, {
+            readonly audience: 'automation';
+            readonly method: 'POST';
+            readonly operation_id: 'describeOperation';
+            readonly path: '/api/automation/operations/describe';
+            readonly summary: 'Describe one supported operation';
+        }, {
+            readonly audience: 'automation';
+            readonly method: 'POST';
+            readonly operation_id: 'invokeOperation';
+            readonly path: '/api/automation/operations/invoke';
+            readonly summary: 'Invoke one supported operation';
+        }];
+        readonly origins: {
+            readonly api: "https://app.warm.io";
+            readonly discovery: "https://warm.io";
+            readonly publicDocs: "https://warm.io";
+        };
+        readonly paths: {
+            readonly developers: "/developers";
+            readonly llms: "/llms.txt";
+            readonly openapi: "/openapi.yaml";
+            readonly publicDiscoveryMcp: "/mcp";
+            readonly verify: "/api/verify";
+        };
+    };
+    readonly mcp: {
+        readonly distribution: {
+            readonly clients: readonly [{
+                readonly id: 'claude-code';
+                readonly name: 'Claude Code';
+                readonly format: 'json';
+                readonly alwaysInclude: true;
+                readonly configPaths: {
+                    readonly darwin: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.claude.json'];
+                    };
+                    readonly linux: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.claude.json'];
+                    };
+                    readonly win32: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.claude.json'];
+                    };
+                };
+            }, {
+                readonly id: 'claude-desktop';
+                readonly name: 'Claude Desktop';
+                readonly format: 'json';
+                readonly configPaths: {
+                    readonly darwin: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['Library', 'Application Support', 'Claude', 'claude_desktop_config.json'];
+                    };
+                    readonly linux: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.config', 'claude', 'claude_desktop_config.json'];
+                    };
+                    readonly win32: {
+                        readonly root: 'appData';
+                        readonly segments: readonly ['Claude', 'claude_desktop_config.json'];
+                    };
+                };
+            }, {
+                readonly id: 'cursor';
+                readonly name: 'Cursor';
+                readonly format: 'json';
+                readonly configPaths: {
+                    readonly darwin: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.cursor', 'mcp.json'];
+                    };
+                    readonly linux: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.cursor', 'mcp.json'];
+                    };
+                    readonly win32: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.cursor', 'mcp.json'];
+                    };
+                };
+            }, {
+                readonly id: 'windsurf';
+                readonly name: 'Windsurf';
+                readonly format: 'json';
+                readonly configPaths: {
+                    readonly darwin: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.codeium', 'windsurf', 'mcp_config.json'];
+                    };
+                    readonly linux: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.codeium', 'windsurf', 'mcp_config.json'];
+                    };
+                    readonly win32: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.codeium', 'windsurf', 'mcp_config.json'];
+                    };
+                };
+            }, {
+                readonly id: 'opencode';
+                readonly name: 'OpenCode';
+                readonly format: 'json';
+                readonly configPaths: {
+                    readonly darwin: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.config', 'opencode', 'opencode.json'];
+                    };
+                    readonly linux: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.config', 'opencode', 'opencode.json'];
+                    };
+                    readonly win32: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.config', 'opencode', 'opencode.json'];
+                    };
+                };
+            }, {
+                readonly id: 'codex-cli';
+                readonly name: 'Codex CLI';
+                readonly format: 'toml';
+                readonly configPaths: {
+                    readonly darwin: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.codex', 'config.toml'];
+                    };
+                    readonly linux: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.codex', 'config.toml'];
+                    };
+                    readonly win32: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.codex', 'config.toml'];
+                    };
+                };
+            }, {
+                readonly id: 'antigravity';
+                readonly name: 'Antigravity';
+                readonly format: 'json';
+                readonly configPaths: {
+                    readonly darwin: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.gemini', 'antigravity', 'mcp_config.json'];
+                    };
+                    readonly linux: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.gemini', 'antigravity', 'mcp_config.json'];
+                    };
+                    readonly win32: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.gemini', 'antigravity', 'mcp_config.json'];
+                    };
+                };
+            }, {
+                readonly id: 'gemini-cli';
+                readonly name: 'Gemini CLI';
+                readonly format: 'json';
+                readonly configPaths: {
+                    readonly darwin: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.gemini', 'settings.json'];
+                    };
+                    readonly linux: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.gemini', 'settings.json'];
+                    };
+                    readonly win32: {
+                        readonly root: 'home';
+                        readonly segments: readonly ['.gemini', 'settings.json'];
+                    };
+                };
+            }];
+            readonly credentials: {
+                readonly automation: {
+                    readonly apiKeyEnv: 'WARM_AUTOMATION_API_KEY';
+                    readonly apiKeyFileEnv: 'WARM_AUTOMATION_API_KEY_FILE';
+                    readonly defaultFileName: 'automation_api_key';
+                };
+                readonly context: {
+                    readonly apiKeyEnv: 'WARM_CONTEXT_API_KEY';
+                    readonly apiKeyFileEnv: 'WARM_CONTEXT_API_KEY_FILE';
+                    readonly defaultFileName: 'context_api_key';
+                };
+            };
+            readonly installCommand: "npx -y @warmio/mcp@latest";
+            readonly installerCommands: {
+                readonly automation: "npx -y @warmio/mcp@latest install --mode automation";
+                readonly context: "npx -y @warmio/mcp@latest install --mode context";
+            };
+            readonly minimumNodeVersion: ">=18";
+            readonly modes: ["automation" | "context", ...("automation" | "context")[]];
+            readonly packageName: "@warmio/mcp";
+            readonly packageSpec: "@warmio/mcp@latest";
+            readonly projectConfigs: readonly [".mcp.json", ".cursor/mcp.json", ".vscode/mcp.json"];
+            readonly serverCommands: {
+                readonly automation: "npx -y @warmio/mcp@latest mcp --mode automation";
+                readonly context: "npx -y @warmio/mcp@latest mcp --mode context";
+            };
+            readonly serverConfigs: {
+                readonly automation: {
+                    readonly serverName: 'warm-automation';
+                    readonly command: 'npx';
+                    readonly args: readonly ["-y", "@warmio/mcp@latest", "mcp", "--mode", "automation"];
+                };
+                readonly context: {
+                    readonly serverName: 'warm';
+                    readonly command: 'npx';
+                    readonly args: readonly ["-y", "@warmio/mcp@latest", "mcp", "--mode", "context"];
+                };
+            };
+        };
+        readonly tools: readonly [{
+            readonly mode: "context";
+            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. Transaction items are not inline; use get_transactions for items.";
+            readonly annotations: {
+                readonly readOnlyHint: true;
+                readonly destructiveHint: false;
+                readonly openWorldHint: false;
+            };
+            readonly input_schema: {
+                readonly type: "object";
+                readonly properties: {};
+                readonly additionalProperties: false;
+                readonly $schema: "https://json-schema.org/draft-07/schema#";
+            };
+            readonly output_schema: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly version: {
+                        readonly type: "string";
+                        readonly enum: readonly ["v1"];
+                    };
+                    readonly updated_at: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly currency: {
+                        readonly type: "string";
+                        readonly enum: readonly ["USD"];
+                    };
+                    readonly status: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly position: {
+                                readonly anyOf: readonly [{
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly date: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "string";
+                                                readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                        };
+                                        readonly net_worth: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "number";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                        };
+                                        readonly cash: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "number";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                        };
+                                        readonly debt: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "number";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                        };
+                                        readonly investments: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "number";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                        };
+                                        readonly other_assets: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "number";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                        };
+                                        readonly total_assets: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "number";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                        };
+                                    };
+                                    readonly required: readonly ["date", "net_worth", "cash", "debt", "investments", "other_assets", "total_assets"];
+                                    readonly additionalProperties: false;
+                                }, {
+                                    readonly type: "null";
+                                }];
+                            };
+                            readonly accounts: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly id: {
+                                            readonly type: "string";
+                                        };
+                                        readonly name: {
+                                            readonly type: "string";
+                                        };
+                                        readonly source: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "string";
+                                                readonly enum: readonly ["plaid", "manual", "csv_import"];
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                        };
+                                        readonly type: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["depository", "credit", "loan", "investment", "brokerage", "other"];
+                                        };
+                                        readonly subtype: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly group: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "string";
+                                                readonly enum: readonly ["cash", "debt", "investments"];
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                        };
+                                        readonly institution: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly mask: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly balance: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "number";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                        };
+                                        readonly available: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "number";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                        };
+                                        readonly currency: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly updated_at: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "string";
+                                                readonly format: "date-time";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                        };
+                                    };
+                                    readonly required: readonly ["id", "name", "source", "type", "subtype", "group", "institution", "mask", "balance", "available", "currency", "updated_at"];
+                                    readonly additionalProperties: false;
+                                };
+                            };
+                        };
+                        readonly required: readonly ["position", "accounts"];
+                        readonly additionalProperties: false;
+                    };
+                    readonly transactions: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly total: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                            };
+                            readonly months: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly month: {
+                                            readonly type: "string";
+                                            readonly pattern: "^\\d{4}-(0[1-9]|1[0-2])$";
+                                        };
+                                        readonly count: {
+                                            readonly type: "integer";
+                                            readonly minimum: 0;
+                                        };
+                                    };
+                                    readonly required: readonly ["month", "count"];
+                                    readonly additionalProperties: false;
+                                };
+                            };
+                        };
+                        readonly required: readonly ["total", "months"];
+                        readonly additionalProperties: false;
+                    };
+                    readonly recurring: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly id: {
+                                    readonly type: "string";
+                                };
+                                readonly account_id: {
+                                    readonly type: readonly ["string", "null"];
+                                };
+                                readonly direction: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly enum: readonly ["inflow", "outflow"];
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly frequency: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly enum: readonly ["WEEKLY", "BIWEEKLY", "MONTHLY", "QUARTERLY", "SEMI_ANNUALLY", "ANNUALLY"];
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly status: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly enum: readonly ["active", "inactive", "dismissed"];
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly merchant: {
+                                    readonly type: readonly ["string", "null"];
+                                };
+                                readonly amount: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly next_date: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                            };
+                            readonly required: readonly ["id", "account_id", "direction", "frequency", "status", "merchant", "amount", "next_date"];
+                            readonly additionalProperties: false;
+                        };
+                    };
+                    readonly budgets: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly id: {
+                                    readonly type: "string";
+                                };
+                                readonly name: {
+                                    readonly type: "string";
+                                };
+                                readonly type: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["category", "merchant"];
+                                };
+                                readonly period: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["weekly", "biweekly", "monthly"];
+                                };
+                                readonly status: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["under", "warning", "over"];
+                                };
+                                readonly amount: {
+                                    readonly type: "number";
+                                };
+                                readonly spent: {
+                                    readonly type: "number";
+                                };
+                                readonly remaining: {
+                                    readonly type: "number";
+                                };
+                                readonly used_percent: {
+                                    readonly type: "number";
+                                };
+                            };
+                            readonly required: readonly ["id", "name", "type", "period", "status", "amount", "spent", "remaining", "used_percent"];
+                            readonly additionalProperties: false;
+                        };
+                    };
+                    readonly goals: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly id: {
+                                    readonly type: "string";
+                                };
+                                readonly name: {
+                                    readonly type: "string";
+                                };
+                                readonly category: {
+                                    readonly type: "string";
+                                };
+                                readonly status: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["not_started", "in_progress", "on_track", "behind", "completed"];
+                                };
+                                readonly target: {
+                                    readonly type: "number";
+                                };
+                                readonly current: {
+                                    readonly type: "number";
+                                };
+                                readonly progress_percent: {
+                                    readonly type: "number";
+                                };
+                                readonly target_date: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                            };
+                            readonly required: readonly ["id", "name", "category", "status", "target", "current", "progress_percent", "target_date"];
+                            readonly additionalProperties: false;
+                        };
+                    };
+                    readonly snapshots: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly date: {
+                                    readonly type: "string";
+                                    readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                                };
+                                readonly net_worth: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly cash: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly debt: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly income: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly expenses: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly cash_flow: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly savings_rate: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly investments: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly assets: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly health_score: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                            };
+                            readonly required: readonly ["date", "net_worth", "cash", "debt", "income", "expenses", "cash_flow", "savings_rate", "investments", "assets", "health_score"];
+                            readonly additionalProperties: false;
+                        };
+                    };
+                    readonly liabilities: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly account_id: {
+                                    readonly type: readonly ["string", "null"];
+                                };
+                                readonly type: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly enum: readonly ["credit", "student", "mortgage", "other"];
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly balance: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly minimum_payment: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly due_date: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly interest_rate: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly rate_type: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly enum: readonly ["fixed", "variable"];
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly overdue: {
+                                    readonly type: readonly ["boolean", "null"];
+                                };
+                            };
+                            readonly required: readonly ["account_id", "type", "balance", "minimum_payment", "due_date", "interest_rate", "rate_type", "overdue"];
+                            readonly additionalProperties: false;
+                        };
+                    };
+                    readonly holdings: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly account_id: {
+                                    readonly type: readonly ["string", "null"];
+                                };
+                                readonly symbol: {
+                                    readonly type: readonly ["string", "null"];
+                                };
+                                readonly name: {
+                                    readonly type: readonly ["string", "null"];
+                                };
+                                readonly type: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly enum: readonly ["cash", "derivative", "equity", "etf", "fixed_income", "mutual_fund", "other"];
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly quantity: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly value: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly cost_basis: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                            };
+                            readonly required: readonly ["account_id", "symbol", "name", "type", "quantity", "value", "cost_basis"];
+                            readonly additionalProperties: false;
+                        };
+                    };
+                    readonly health: {
+                        readonly anyOf: readonly [{
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly score: {
+                                    readonly type: "number";
+                                };
+                                readonly label: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["Needs Attention", "Good", "Strong"];
+                                };
+                                readonly level: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["strong", "good", "fair", "poor", "critical"];
+                                };
+                                readonly summary: {
+                                    readonly type: "string";
+                                };
+                                readonly data_completeness: {
+                                    readonly type: "number";
+                                };
+                                readonly pillars: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "object";
+                                        readonly properties: {
+                                            readonly spend: {
+                                                readonly anyOf: readonly [{
+                                                    readonly type: "number";
+                                                }, {
+                                                    readonly type: "null";
+                                                }];
+                                            };
+                                            readonly save: {
+                                                readonly anyOf: readonly [{
+                                                    readonly type: "number";
+                                                }, {
+                                                    readonly type: "null";
+                                                }];
+                                            };
+                                            readonly borrow: {
+                                                readonly anyOf: readonly [{
+                                                    readonly type: "number";
+                                                }, {
+                                                    readonly type: "null";
+                                                }];
+                                            };
+                                            readonly build: {
+                                                readonly anyOf: readonly [{
+                                                    readonly type: "number";
+                                                }, {
+                                                    readonly type: "null";
+                                                }];
+                                            };
+                                        };
+                                        readonly required: readonly ["spend", "save", "borrow", "build"];
+                                        readonly additionalProperties: false;
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                            };
+                            readonly required: readonly ["score", "label", "level", "summary", "data_completeness", "pillars"];
+                            readonly additionalProperties: false;
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                };
+                readonly required: readonly ["version", "updated_at", "currency", "status", "transactions", "recurring", "budgets", "goals", "snapshots", "liabilities", "holdings", "health"];
+                readonly additionalProperties: false;
+                readonly $schema: "https://json-schema.org/draft-07/schema#";
+            };
+        }, {
+            readonly mode: "context";
+            readonly name: "get_transactions";
+            readonly description: "Read-only transactions from the FinancialContext artifact. Pass exactly one selector: `month` in YYYY-MM format for a month page, or `latest: true` for the fixed latest window. A bare call with no arguments defaults to `latest: true`. The latest window is fixed at 10 days and is not caller-configurable. `month` and `latest` are mutually exclusive. Months outside the covered range return an error.";
+            readonly annotations: {
+                readonly readOnlyHint: true;
+                readonly destructiveHint: false;
+                readonly openWorldHint: false;
+            };
+            readonly input_schema: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly month: {
+                        readonly type: "string";
+                        readonly pattern: "^\\d{4}-\\d{2}$";
+                        readonly description: "Transaction month in YYYY-MM format. Mutually exclusive with latest. Months outside the covered range return an error.";
+                    };
+                    readonly latest: {
+                        readonly type: "boolean";
+                        readonly const: true;
+                        readonly description: "When true, return the fixed 10-day latest window. Mutually exclusive with month. A bare call with no arguments defaults to latest: true.";
+                    };
+                };
+                readonly additionalProperties: false;
+                readonly $schema: "https://json-schema.org/draft-07/schema#";
+            };
+            readonly output_schema: {
+                readonly anyOf: readonly [{
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly month: {
+                            readonly type: "string";
+                            readonly pattern: "^\\d{4}-(0[1-9]|1[0-2])$";
+                        };
+                        readonly start_date: {
+                            readonly type: "string";
+                            readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                        };
+                        readonly end_date: {
+                            readonly type: "string";
+                            readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                        };
+                        readonly count: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly items: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                                readonly properties: {
+                                    readonly id: {
+                                        readonly type: "string";
+                                    };
+                                    readonly account_id: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly date: {
+                                        readonly anyOf: readonly [{
+                                            readonly type: "string";
+                                            readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                                        }, {
+                                            readonly type: "null";
+                                        }];
+                                    };
+                                    readonly amount: {
+                                        readonly type: "number";
+                                    };
+                                    readonly merchant: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly name: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly category: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly subcategory: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly pending: {
+                                        readonly type: readonly ["boolean", "null"];
+                                    };
+                                    readonly currency: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                };
+                                readonly required: readonly ["id", "account_id", "date", "amount", "merchant", "name", "category", "subcategory", "pending", "currency"];
+                                readonly additionalProperties: false;
+                            };
+                        };
+                    };
+                    readonly required: readonly ["month", "start_date", "end_date", "count", "items"];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly since: {
+                            readonly type: "string";
+                            readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                        };
+                        readonly window_days: {
+                            readonly type: "number";
+                            readonly const: 10;
+                        };
+                        readonly count: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly items: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                                readonly properties: {
+                                    readonly id: {
+                                        readonly type: "string";
+                                    };
+                                    readonly account_id: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly date: {
+                                        readonly anyOf: readonly [{
+                                            readonly type: "string";
+                                            readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                                        }, {
+                                            readonly type: "null";
+                                        }];
+                                    };
+                                    readonly amount: {
+                                        readonly type: "number";
+                                    };
+                                    readonly merchant: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly name: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly category: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly subcategory: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly pending: {
+                                        readonly type: readonly ["boolean", "null"];
+                                    };
+                                    readonly currency: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                };
+                                readonly required: readonly ["id", "account_id", "date", "amount", "merchant", "name", "category", "subcategory", "pending", "currency"];
+                                readonly additionalProperties: false;
+                            };
+                        };
+                    };
+                    readonly required: readonly ["since", "window_days", "count", "items"];
+                    readonly additionalProperties: false;
+                }];
+                readonly $schema: "https://json-schema.org/draft-07/schema#";
+            };
+        }, {
+            readonly mode: "context";
+            readonly name: "verify_key";
+            readonly description: "Read-only API key validation for the configured Warm account.";
+            readonly annotations: {
+                readonly readOnlyHint: true;
+                readonly destructiveHint: false;
+                readonly openWorldHint: false;
+            };
+            readonly input_schema: {
+                readonly type: "object";
+                readonly properties: {};
+                readonly additionalProperties: false;
+                readonly $schema: "https://json-schema.org/draft-07/schema#";
+            };
+            readonly output_schema: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly audience: {
+                        readonly type: "string";
+                        readonly enum: readonly ["automation", "context", "oauth"];
+                    };
+                    readonly status: {
+                        readonly type: "string";
+                    };
+                    readonly valid: {
+                        readonly type: "boolean";
+                    };
+                };
+                readonly required: readonly ["status", "valid"];
+                readonly additionalProperties: false;
+                readonly $schema: "https://json-schema.org/draft-07/schema#";
+            };
+        }, {
+            readonly mode: "automation";
+            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 input_schema: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly query: {
+                        readonly type: "string";
+                        readonly maxLength: 200;
+                        readonly description: "Words describing the action or data you need.";
+                    };
+                };
+                readonly additionalProperties: false;
+                readonly $schema: "https://json-schema.org/draft-07/schema#";
+            };
+            readonly output_schema: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly operations: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly confirmation_required: {
+                                    readonly type: "boolean";
+                                };
+                                readonly description: {
+                                    readonly type: "string";
+                                };
+                                readonly method: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["DELETE", "GET", "PATCH", "POST", "PUT"];
+                                };
+                                readonly operation_id: {
+                                    readonly type: "string";
+                                };
+                                readonly path: {
+                                    readonly type: "string";
+                                };
+                                readonly risk: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "string";
+                                        readonly enum: readonly ["read", "write", "destructive", "external_effect"];
+                                    };
+                                };
+                                readonly summary: {
+                                    readonly type: "string";
+                                };
+                            };
+                            readonly required: readonly ["confirmation_required", "description", "method", "operation_id", "path", "risk", "summary"];
+                            readonly additionalProperties: false;
+                        };
+                    };
+                };
+                readonly required: readonly ["operations"];
+                readonly additionalProperties: false;
+                readonly $schema: "https://json-schema.org/draft-07/schema#";
+            };
+        }, {
+            readonly mode: "automation";
+            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 input_schema: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly operation_id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly input: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly body: {
+                                readonly type: "object";
+                                readonly additionalProperties: {};
+                            };
+                            readonly params: {
+                                readonly type: "object";
+                                readonly additionalProperties: {
+                                    readonly type: "string";
+                                };
+                            };
+                        };
+                        readonly additionalProperties: false;
+                        readonly description: "Exact intended input. Required to obtain approval for a write operation.";
+                    };
+                };
+                readonly required: readonly ["operation_id"];
+                readonly additionalProperties: false;
+                readonly $schema: "https://json-schema.org/draft-07/schema#";
+            };
+            readonly output_schema: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly approval: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly approval_url: {
+                                readonly type: "string";
+                                readonly format: "uri";
+                            };
+                            readonly expires_at: {
+                                readonly type: "string";
+                                readonly format: "date-time";
+                            };
+                            readonly id: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly status: {
+                                readonly type: "string";
+                                readonly const: "pending";
+                            };
+                        };
+                        readonly required: readonly ["approval_url", "expires_at", "id", "status"];
+                        readonly additionalProperties: false;
+                    };
+                    readonly operation: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly confirmation_required: {
+                                readonly type: "boolean";
+                            };
+                            readonly description: {
+                                readonly type: "string";
+                            };
+                            readonly method: {
+                                readonly type: "string";
+                                readonly enum: readonly ["DELETE", "GET", "PATCH", "POST", "PUT"];
+                            };
+                            readonly operation_id: {
+                                readonly type: "string";
+                            };
+                            readonly path: {
+                                readonly type: "string";
+                            };
+                            readonly risk: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["read", "write", "destructive", "external_effect"];
+                                };
+                            };
+                            readonly summary: {
+                                readonly type: "string";
+                            };
+                            readonly input_schema: {
+                                readonly type: "object";
+                                readonly additionalProperties: {};
+                            };
+                        };
+                        readonly required: readonly ["confirmation_required", "description", "method", "operation_id", "path", "risk", "summary", "input_schema"];
+                        readonly additionalProperties: false;
+                    };
+                };
+                readonly required: readonly ["operation"];
+                readonly additionalProperties: false;
+                readonly $schema: "https://json-schema.org/draft-07/schema#";
+            };
+        }, {
+            readonly mode: "automation";
+            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 input_schema: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly operation_id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly input: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly body: {
+                                readonly type: "object";
+                                readonly additionalProperties: {};
+                            };
+                            readonly params: {
+                                readonly type: "object";
+                                readonly additionalProperties: {
+                                    readonly type: "string";
+                                };
+                            };
+                        };
+                        readonly additionalProperties: false;
+                        readonly description: "Exact intended input. Required to obtain approval for a write operation.";
+                    };
+                    readonly approval_id: {
+                        readonly type: "string";
+                        readonly format: "uuid";
+                        readonly description: "Approval ID returned by describe_operation for the exact write input.";
+                    };
+                };
+                readonly required: readonly ["operation_id"];
+                readonly additionalProperties: false;
+                readonly $schema: "https://json-schema.org/draft-07/schema#";
+            };
+            readonly output_schema: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly body: {};
+                    readonly headers: {
+                        readonly type: "object";
+                        readonly additionalProperties: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly operation_id: {
+                        readonly type: "string";
+                    };
+                    readonly status: {
+                        readonly type: "integer";
+                    };
+                };
+                readonly required: readonly ["headers", "operation_id", "status"];
+                readonly additionalProperties: false;
+                readonly $schema: "https://json-schema.org/draft-07/schema#";
+            };
+        }];
+    };
+    readonly product: {
+        readonly capabilities: readonly {
+            id: import("./product.js").ProductCapabilityId;
+            label: string;
+            tiers: readonly import("./product.js").PublicProductTier[];
+        }[];
+        readonly tiers: readonly ["plus", "pro"];
+    };
+    readonly protectedCrawlerPaths: readonly ["/dashboard", "/transactions", "/accounts", "/assets", "/subscriptions", "/spending", "/income", "/cash-flow", "/budgets", "/benefits", "/goals", "/planning", "/alerts", "/tag-rules", "/more", "/settings", "/feedback", "/billing", "/logs", "/join", "/welcome", "/welcome/connect", "/welcome/complete", "/welcome/sync", "/dashboard-1", "/dashboard-2", "/dashboard-3", "/insights", "/ksink", "/snapshots"];
+    readonly publicDiscovery: {
+        readonly protocolVersion: '2025-06-18';
+        readonly serverInfo: {
+            readonly name: 'warm-public-tools';
+            readonly title: 'Warm Public Discovery Tools';
+            readonly version: '1.0.0';
+        };
+        readonly paths: {
+            readonly developers: "/developers";
+            readonly endpoint: "/mcp";
+            readonly openapi: "/openapi.yaml";
+            readonly verify: "/api/verify";
+        };
+        readonly tools: readonly [{
+            readonly annotations: {
+                readonly readOnlyHint: true;
+            };
+            readonly description: 'Return Warm API discovery URLs and the current API catalog document.';
+            readonly inputSchema: {
+                type: string;
+                properties: {};
+                additionalProperties: boolean;
+            };
+            readonly name: 'warm-get-api-catalog';
+            readonly outputSchema: {
+                readonly type: 'object';
+                readonly properties: {
+                    readonly apiCatalogUrl: {
+                        readonly type: 'string';
+                    };
+                    readonly payload: {
+                        readonly type: 'object';
+                    };
+                };
+                readonly required: readonly ['apiCatalogUrl', 'payload'];
+                readonly additionalProperties: false;
+            };
+            readonly title: 'Warm API Catalog';
+        }, {
+            readonly annotations: {
+                readonly readOnlyHint: true;
+            };
+            readonly description: 'Return the Warm OpenAPI document URL and companion documentation URLs.';
+            readonly inputSchema: {
+                type: string;
+                properties: {};
+                additionalProperties: boolean;
+            };
+            readonly name: 'warm-get-openapi';
+            readonly outputSchema: {
+                readonly type: 'object';
+                readonly properties: {
+                    readonly apiCatalogUrl: {
+                        readonly type: 'string';
+                    };
+                    readonly documentationUrl: {
+                        readonly type: 'string';
+                    };
+                    readonly openapiUrl: {
+                        readonly type: 'string';
+                    };
+                };
+                readonly required: readonly ['apiCatalogUrl', 'documentationUrl', 'openapiUrl'];
+                readonly additionalProperties: false;
+            };
+            readonly title: 'Warm OpenAPI';
+        }, {
+            readonly annotations: {
+                readonly readOnlyHint: true;
+            };
+            readonly description: 'Fetch the current Warm public API verification payload from /api/verify.';
+            readonly inputSchema: {
+                type: string;
+                properties: {};
+                additionalProperties: boolean;
+            };
+            readonly name: 'warm-get-service-status';
+            readonly outputSchema: {
+                readonly type: 'object';
+                readonly properties: {
+                    readonly ok: {
+                        readonly type: 'boolean';
+                    };
+                    readonly payload: {};
+                    readonly error: {
+                        readonly type: 'object';
+                        readonly properties: {
+                            readonly code: {
+                                readonly type: 'string';
+                                readonly enum: readonly ['VERIFY_TIMEOUT', 'VERIFY_NON_JSON', 'VERIFY_UNAVAILABLE'];
+                            };
+                            readonly message: {
+                                readonly type: 'string';
+                            };
+                        };
+                        readonly required: readonly ['code', 'message'];
+                        readonly additionalProperties: false;
+                    };
+                    readonly status: {
+                        readonly type: 'number';
+                        readonly minimum: 0;
+                    };
+                    readonly statusUrl: {
+                        readonly type: 'string';
+                    };
+                };
+                readonly required: readonly ['ok', 'status', 'statusUrl'];
+                readonly additionalProperties: false;
+            };
+            readonly title: 'Warm API Verification';
+        }];
+    };
+};
+/** Canonical key-sorted JSON derived from the executed manifest values. */
+export declare const contractReleaseManifestCanonicalJson: string;
 //# sourceMappingURL=manifest.d.ts.map