finoptima 1.1.0 → 1.2.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "finoptima",
-  "version": "1.1.0",
-  "description": "FINOPTIMA — EcoChain AI Finance Agent via MCP. Portfolio optimization, AMM liquidity, trading, swaps. Secured by EcoAuth 2FA.",
+  "version": "1.2.0",
+  "description": "FINOPTIMA — EcoChain AI Finance Agent via MCP. Portfolio optimization, AMM liquidity, AI trading strategies, swaps. Secured by EcoAuth 2FA.",
   "main": "index.js",
   "bin": {
     "finoptima": "index.js"

package/tools/index.js

@@ -12,6 +12,11 @@
 const apiClient = require('../lib/api-client');
 const { withLogging } = require('../lib/logger');
 
+// [DEC-2026-046] AI Trading Platform tools
+const { strategyTools } = require('./strategy-tools');
+const { intentTools } = require('./intent-tools');
+const { performanceTools } = require('./performance-tools');
+
 // Helper: get user ID from env (set at startup from API key lookup)
 function uid() {
   return process.env.ECOCHAIN_USER_ID || 'me';
@@ -395,5 +400,17 @@ module.exports = {
   swapTools,
   liquidityTools,
   sendTools,
-  allTools: [...readTools, ...tradeTools, ...swapTools, ...liquidityTools, ...sendTools]
+  strategyTools,
+  intentTools,
+  performanceTools,
+  allTools: [
+    ...readTools,
+    ...tradeTools,
+    ...swapTools,
+    ...liquidityTools,
+    ...sendTools,
+    ...strategyTools,
+    ...intentTools,
+    ...performanceTools
+  ]
 };

package/tools/intent-tools.js

@@ -0,0 +1,58 @@
+/**
+ * MCP Intent Tools (DEC-2026-046)
+ * 2 tools for AI agent intent management (scope: trade)
+ */
+
+const apiClient = require('../lib/api-client');
+const { withLogging } = require('../lib/logger');
+
+const intentTools = [
+  {
+    name: 'create_intent',
+    description: 'Create a trading intent with policy validation. Returns canonical_display (human-readable JSON) and intent_hash (SHA256) for approval verification. Auto-approved if amount < 0.01 BTC, otherwise awaits manual approval (30min TTL).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        strategy_id: { type: 'string', description: 'Optional: link to a strategy' },
+        action: { type: 'string', description: 'Trading action', enum: ['execute_swap', 'add_liquidity', 'remove_liquidity', 'place_order'] },
+        params: {
+          type: 'object',
+          description: 'Action parameters. Swap: {token_in, token_out, amount_in, max_slippage_bps}. Liquidity: {pool_id, amount_a, amount_b}. Order: {pair_id, side, type, amount, price}.'
+        },
+        reasoning: { type: 'string', description: 'Why this trade (shown to user for approval)' }
+      },
+      required: ['action', 'params']
+    },
+    handler: withLogging('create_intent', async ({ strategy_id, action, params, reasoning }) => {
+      const body = { action, params };
+      if (strategy_id) body.strategy_id = strategy_id;
+      if (reasoning) body.reasoning = reasoning;
+      const data = await apiClient.post('/intents', body);
+      return JSON.stringify(data, null, 2);
+    })
+  },
+  {
+    name: 'list_intents',
+    description: 'List trading intents with optional filters. Shows status, canonical display, policy result, and execution result.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        status: { type: 'string', description: 'Filter by status', enum: ['pending', 'awaiting_approval', 'approved', 'rejected', 'executing', 'executed', 'failed', 'expired', 'canceled'] },
+        strategy_id: { type: 'string', description: 'Filter by strategy' },
+        limit: { type: 'number', description: 'Max results (default 50)' }
+      },
+      required: []
+    },
+    handler: withLogging('list_intents', async ({ status, strategy_id, limit }) => {
+      const params = new URLSearchParams();
+      if (status) params.set('status', status);
+      if (strategy_id) params.set('strategy_id', strategy_id);
+      if (limit) params.set('limit', limit.toString());
+      const qs = params.toString();
+      const data = await apiClient.get(`/intents${qs ? '?' + qs : ''}`);
+      return JSON.stringify(data, null, 2);
+    })
+  }
+];
+
+module.exports = { intentTools };

package/tools/performance-tools.js

@@ -0,0 +1,30 @@
+/**
+ * MCP Performance Tools (DEC-2026-046)
+ * 1 tool for AI agent performance monitoring (scope: read)
+ */
+
+const apiClient = require('../lib/api-client');
+const { withLogging } = require('../lib/logger');
+
+const performanceTools = [
+  {
+    name: 'get_strategy_performance',
+    description: 'Get performance metrics for a trading strategy: total return, max drawdown, vs HODL benchmark, fees paid/earned, and PnL snapshots time-series.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        strategy_id: { type: 'string', description: 'Strategy UUID' }
+      },
+      required: ['strategy_id']
+    },
+    handler: withLogging('get_strategy_performance', async ({ strategy_id }) => {
+      const [metrics, snapshots] = await Promise.all([
+        apiClient.get(`/performance/strategy/${strategy_id}`),
+        apiClient.get(`/performance/strategy/${strategy_id}/snapshots?limit=50`)
+      ]);
+      return JSON.stringify({ metrics, snapshots }, null, 2);
+    })
+  }
+];
+
+module.exports = { performanceTools };

package/tools/strategy-tools.js

@@ -0,0 +1,102 @@
+/**
+ * MCP Strategy Tools (DEC-2026-046)
+ * 5 tools for AI agent strategy management (scope: strategy)
+ */
+
+const apiClient = require('../lib/api-client');
+const { withLogging } = require('../lib/logger');
+
+function uid() {
+  return process.env.ECOCHAIN_USER_ID || 'me';
+}
+
+const strategyTools = [
+  {
+    name: 'list_strategies',
+    description: 'List all trading strategies for the user. Returns strategy name, type (lp_yield/dca/btc_hedge), status, mode, and PnL summary.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        status: { type: 'string', description: 'Filter by status', enum: ['draft', 'active', 'paused', 'stopped', 'error'] }
+      },
+      required: []
+    },
+    handler: withLogging('list_strategies', async ({ status }) => {
+      const params = status ? `?status=${status}` : '';
+      const data = await apiClient.get(`/strategies${params}`);
+      return JSON.stringify(data, null, 2);
+    })
+  },
+  {
+    name: 'get_strategy',
+    description: 'Get detailed info about a trading strategy: parameters, rules, latest PnL snapshot, and recent intents.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        strategy_id: { type: 'string', description: 'Strategy UUID' }
+      },
+      required: ['strategy_id']
+    },
+    handler: withLogging('get_strategy', async ({ strategy_id }) => {
+      const data = await apiClient.get(`/strategies/${strategy_id}`);
+      return JSON.stringify(data, null, 2);
+    })
+  },
+  {
+    name: 'create_strategy',
+    description: 'Create a new trading strategy (starts as draft). Types: lp_yield (LP optimization), dca (Dollar Cost Average), btc_hedge (BTC downside protection). Mode: auto (execute automatically) or watch (manual approval for all intents).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'Strategy name (e.g. "Daily BTC DCA")' },
+        type: { type: 'string', description: 'Strategy type', enum: ['lp_yield', 'dca', 'btc_hedge'] },
+        parameters: {
+          type: 'object',
+          description: 'Strategy parameters. DCA: {token_to_buy, spend_token, amount_per_interval, interval_hours, total_budget}. BTC Hedge: {btc_drop_threshold_percent, conversion_step_percent, cooldown_hours}. LP Yield: {pool_id, min_apr_threshold, rebalance_on_il_percent}.'
+        },
+        mode: { type: 'string', description: 'Execution mode', enum: ['auto', 'watch'] },
+        description: { type: 'string', description: 'Optional description' }
+      },
+      required: ['name', 'type', 'parameters']
+    },
+    handler: withLogging('create_strategy', async ({ name, type, parameters, mode, description }) => {
+      const body = { name, type, parameters };
+      if (mode) body.mode = mode;
+      if (description) body.description = description;
+      const data = await apiClient.post('/strategies', body);
+      return JSON.stringify(data, null, 2);
+    })
+  },
+  {
+    name: 'activate_strategy',
+    description: 'Activate a draft or paused strategy. Creates default policy rules if none exist and takes a start-of-day PnL snapshot.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        strategy_id: { type: 'string', description: 'Strategy UUID to activate' }
+      },
+      required: ['strategy_id']
+    },
+    handler: withLogging('activate_strategy', async ({ strategy_id }) => {
+      const data = await apiClient.post(`/strategies/${strategy_id}/activate`);
+      return JSON.stringify(data, null, 2);
+    })
+  },
+  {
+    name: 'pause_strategy',
+    description: 'Pause an active strategy. Cancels all pending/awaiting/approved intents. Can be resumed later with activate.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        strategy_id: { type: 'string', description: 'Strategy UUID to pause' }
+      },
+      required: ['strategy_id']
+    },
+    handler: withLogging('pause_strategy', async ({ strategy_id }) => {
+      const data = await apiClient.post(`/strategies/${strategy_id}/pause`);
+      return JSON.stringify(data, null, 2);
+    })
+  }
+];
+
+module.exports = { strategyTools };