@warmio/mcp 9.0.0 → 9.1.1

package/dist/types.d.ts

@@ -1,7 +1,8 @@
-export declare const WARM_CONTEXT_TOOL_NAMES: readonly ["get_financial_context", "get_transactions", "verify_key"];
-export declare const WARM_AUTOMATION_TOOL_NAMES: readonly ["search_operations", "describe_operation", "invoke_operation"];
-export declare const WARM_TOOL_NAMES: readonly ["get_financial_context", "get_transactions", "verify_key", "search_operations", "describe_operation", "invoke_operation"];
-export type WarmToolName = (typeof WARM_TOOL_NAMES)[number];
+import { privateMcpToolDefinitions } from '@warmio/contracts/mcp';
+export declare const WARM_CONTEXT_TOOL_NAMES: string[];
+export declare const WARM_AUTOMATION_TOOL_NAMES: string[];
+export declare const WARM_TOOL_NAMES: string[];
+export type WarmToolName = (typeof privateMcpToolDefinitions)[number]['name'];
 export type { Account, AutomationInput, AutomationOperation, AutomationOperationDescription, Budget, DescribeOperationOutput, FinancialContext, FinancialContextMeta, GetTransactionsInput, GetTransactionsOutput, Goal, Health, Holding, InvokeOperationOutput, LatestTransactions, Liability, Position, Recurring, Snapshot, Status, Transaction, TransactionIndex, TransactionMonth, VerifyKeyOutput, WarmApiClient, WarmApiClientOptions, } from './warm-api-client.js';
 export type { PrivateMcpMode } from '@warmio/contracts/mcp';
 export type { WarmServerOptions } from './server.js';

package/dist/types.js

@@ -1,11 +1,8 @@
-export const WARM_CONTEXT_TOOL_NAMES = [
-    'get_financial_context',
-    'get_transactions',
-    'verify_key',
-];
-export const WARM_AUTOMATION_TOOL_NAMES = [
-    'search_operations',
-    'describe_operation',
-    'invoke_operation',
-];
-export const WARM_TOOL_NAMES = [...WARM_CONTEXT_TOOL_NAMES, ...WARM_AUTOMATION_TOOL_NAMES];
+import { privateMcpToolDefinitions } from '@warmio/contracts/mcp';
+export const WARM_CONTEXT_TOOL_NAMES = privateMcpToolDefinitions
+    .filter((tool) => tool.mode === 'context')
+    .map((tool) => tool.name);
+export const WARM_AUTOMATION_TOOL_NAMES = privateMcpToolDefinitions
+    .filter((tool) => tool.mode === 'automation')
+    .map((tool) => tool.name);
+export const WARM_TOOL_NAMES = privateMcpToolDefinitions.map((tool) => tool.name);

package/dist/warm-api-client.js

@@ -1,11 +1,20 @@
 import { getWarmApiKeyPath, readConfigFile } from './config-paths.js';
+import { API_ORIGIN, apiEndpointManifest, } from '@warmio/contracts/api';
 import { WARM_MCP_CREDENTIALS, WARM_MCP_INSTALLER_COMMANDS, } from '@warmio/contracts/mcp';
-const DEFAULT_API_URL = process.env.WARM_API_URL || 'https://app.warm.io';
+const DEFAULT_API_URL = process.env.WARM_API_URL || API_ORIGIN;
 const DEFAULT_REQUEST_TIMEOUT_MS = (() => {
     const raw = Number(process.env.WARM_API_TIMEOUT_MS || 10_000);
     return Number.isFinite(raw) && raw > 0 ? raw : 10_000;
 })();
 const cachedApiKeys = new Map();
+const endpointByOperationId = Object.fromEntries(apiEndpointManifest.map((endpoint) => [endpoint.operation_id, endpoint]));
+function getEndpointPath(operationId, audience) {
+    const endpoint = endpointByOperationId[operationId];
+    if (endpoint.audience !== audience) {
+        throw new Error(`API operation ${operationId} is not available to ${audience}.`);
+    }
+    return endpoint.path;
+}
 function getRequestSignal(timeoutMs) {
     if (typeof AbortSignal.timeout === 'function') {
         return AbortSignal.timeout(timeoutMs);
@@ -120,23 +129,29 @@ async function requestSuccessfulJson(request, options) {
     return response.body;
 }
 export function createWarmApiClient(options = {}) {
-    const getFinancialContext = async () => await requestSuccessfulJson({ endpoint: '/api/financial-context' }, options);
-    const getFinancialContextMeta = async () => await requestSuccessfulJson({ endpoint: '/api/financial-context/meta' }, options);
+    const getFinancialContext = async () => await requestSuccessfulJson({ endpoint: getEndpointPath('getFinancialContext', 'context') }, options);
+    const getFinancialContextMeta = async () => await requestSuccessfulJson({ endpoint: getEndpointPath('getFinancialContextMeta', 'context') }, options);
     const getTransactions = async (input) => {
         const rawInput = input;
         if (typeof rawInput.month === 'string' && rawInput.latest !== undefined) {
             throw new Error('`month` and `latest` are mutually exclusive.');
         }
         if (typeof rawInput.month === 'string') {
-            return await requestSuccessfulJson({ endpoint: '/api/financial-context/transactions', query: { month: rawInput.month } }, options);
+            return await requestSuccessfulJson({
+                endpoint: getEndpointPath('getFinancialContextTransactions', 'context'),
+                query: { month: rawInput.month },
+            }, options);
         }
         if (rawInput.latest === true) {
-            return await requestSuccessfulJson({ endpoint: '/api/financial-context/transactions', query: { latest: '1' } }, options);
+            return await requestSuccessfulJson({
+                endpoint: getEndpointPath('getFinancialContextTransactions', 'context'),
+                query: { latest: '1' },
+            }, options);
         }
         throw new Error('Call getTransactions with `month` in YYYY-MM format or `latest: true`.');
     };
     const verifyKey = async () => {
-        const response = await requestSuccessfulJson({ endpoint: '/api/verify' }, options);
+        const response = await requestSuccessfulJson({ endpoint: getEndpointPath('verifyApiAccess', 'context') }, options);
         return {
             audience: response.audience,
             status: response.status || (response.valid ? 'ok' : 'invalid'),
@@ -146,7 +161,8 @@ export function createWarmApiClient(options = {}) {
     const validateAudience = async () => {
         const result = await verifyKey();
         const expectedAudience = createWarmApiClientConfig(options).audience;
-        if (!result.valid || result.audience !== expectedAudience) {
+        const hasCompatibleAudience = result.audience === expectedAudience || result.audience === 'oauth';
+        if (!result.valid || !hasCompatibleAudience) {
             const article = expectedAudience === 'automation' ? 'an' : 'a';
             throw new Error(`This MCP mode requires ${article} ${expectedAudience} API key. Run "${WARM_MCP_INSTALLER_COMMANDS[expectedAudience]}" to configure a separate key.`);
         }
@@ -154,12 +170,12 @@ export function createWarmApiClient(options = {}) {
     };
     const searchOperations = async (query) => await requestSuccessfulJson({
         body: query ? { query } : {},
-        endpoint: '/api/automation/operations/search',
+        endpoint: getEndpointPath('searchOperations', 'automation'),
         method: 'POST',
     }, options);
     const describeOperation = async (operationId, input) => await requestSuccessfulJson({
         body: { operation_id: operationId, ...(input ? { input } : {}) },
-        endpoint: '/api/automation/operations/describe',
+        endpoint: getEndpointPath('describeOperation', 'automation'),
         method: 'POST',
     }, options);
     const invokeOperation = async (operationId, input, approvalId) => await requestSuccessfulJson({
@@ -168,7 +184,7 @@ export function createWarmApiClient(options = {}) {
             input: input ?? {},
             ...(approvalId ? { approval_id: approvalId } : {}),
         },
-        endpoint: '/api/automation/operations/invoke',
+        endpoint: getEndpointPath('invokeOperation', 'automation'),
         method: 'POST',
     }, options);
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmio/mcp",
-  "version": "9.0.0",
+  "version": "9.1.1",
   "mcpName": "io.github.jasonstockman/warmio",
   "description": "Warm CLI and compact context or automation MCP server",
   "type": "module",
@@ -60,7 +60,7 @@
     "url": "git+https://github.com/jasonstockman/warm-mcp.git"
   },
   "dependencies": {
-    "@warmio/contracts": "1.1.0",
+    "@warmio/contracts": "1.2.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "dotenv": "^17.2.3",
     "zod": "^3.25.76"