@finchagentic/mcp 4.0.0 → 4.2.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@finchagentic/mcp",
-  "version": "4.0.0",
-  "description": "The runtime layer for Agentic AI. 121 MCP tools: persistent memory, autonomous agents, vault storage, scheduled workflows, DeFi on Base (base_mcp_*), Robinhood Chain tokenized stocks and arbitrary crypto with V3/V4 smart routing (rh_*), live market data, deep research, and Finch Terminal. Runs fully local \u2014 self-hosted vault + memory on your own disk, no account, your LLM does the thinking. Works in Claude Code, Cursor, Windsurf, and any MCP client.",
+  "version": "4.2.0",
+  "description": "The runtime layer for Agentic AI. Persistent memory, autonomous agents, and workflows that survive every session.",
   "main": "dist/index.js",
   "bin": {
     "finch": "dist/cli.js",
@@ -9,7 +9,7 @@
   },
   "preferGlobal": true,
   "scripts": {
-    "build": "tsc",
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc",
     "dev": "ts-node src/index.ts",
     "start": "node dist/index.js",
     "test": "vitest run",
@@ -23,35 +23,23 @@
   },
   "keywords": [
     "mcp",
-    "mcp-server",
     "model-context-protocol",
     "ai-agent",
-    "autonomous-agents",
+    "agentic",
     "persistent-memory",
-    "memory-layer",
+    "autonomous-agents",
+    "workflows",
     "vault",
-    "agentic",
-    "workflow-automation",
-    "claude-code",
-    "cursor",
-    "windsurf",
     "finch",
     "finchagentic",
-    "research",
-    "automation",
-    "defi",
-    "base-chain",
-    "tool-calling",
-    "finch-terminal",
-    "ai-terminal",
-    "knowledge-graph",
-    "semantic-search"
+    "claude-code",
+    "cursor"
   ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/finchagentic/mcp.git"
   },
-  "homepage": "https://github.com/finchagentic/mcp#readme",
+  "homepage": "https://docs.finch.com",
   "bugs": {
     "url": "https://github.com/finchagentic/mcp/issues"
   },

package/dist/tools/framework.js

@@ -1,150 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FRAMEWORK_TOOLS = void 0;
-exports.handleFrameworkTool = handleFrameworkTool;
-const convex_js_1 = require("../convex.js");
-exports.FRAMEWORK_TOOLS = [
-    {
-        name: "list_playbooks",
-        description: "List available Noel Framework playbooks - predefined multi-step workflows. " +
-            "Includes 4 system playbooks (Daily Market Scan, DCA Setup, Portfolio Rebalance Check, " +
-            "Research Sweep) plus any you've created. Each step is Sentinel-gated.",
-        inputSchema: { type: "object", properties: {}, required: [] },
-    },
-    {
-        name: "run_playbook",
-        description: "Execute a Noel Framework playbook. Each step runs through Sentinel before the " +
-            "matching tool executes it. Steps map directly to finch tools (market, vault, agent, " +
-            "memory, automation). Playbook halts immediately if Sentinel blocks a step.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                playbook_name: {
-                    type: "string",
-                    description: "Exact name of the playbook. Use list_playbooks to see available ones.",
-                },
-                task_description: {
-                    type: "string",
-                    description: "Optional context passed as overrideParams to the playbook run.",
-                },
-            },
-            required: ["playbook_name"],
-        },
-    },
-    {
-        name: "get_finch_ledger",
-        description: "Get the Noel Framework audit trail - every Sentinel gate decision " +
-            "(approved / blocked / warned), which checks ran, duration, and reason. " +
-            "Full transparency on what agents are and aren't allowed to do.",
-        inputSchema: { type: "object", properties: {}, required: [] },
-    },
-];
-async function handleFrameworkTool(name, args) {
-    const a = (args ?? {});
-    switch (name) {
-        // ── list_playbooks ──────────────────────────────────────────────────────
-        case "list_playbooks": {
-            const result = await (0, convex_js_1.callConvex)("/framework/playbooks", "GET", undefined, "list_playbooks");
-            const pbs = result.playbooks ?? [];
-            if (pbs.length === 0) {
-                return { content: [{ type: "text", text: "No playbooks found." }] };
-            }
-            const list = pbs
-                .map((p) => {
-                const steps = (() => {
-                    try {
-                        return JSON.parse(p.steps).length;
-                    }
-                    catch {
-                        return "?";
-                    }
-                })();
-                return `• **${p.name}**${p.isPublic ? " 🌐" : " 👤"} - ${steps} steps\n  ${p.description}\n  Used ${p.usageCount} times`;
-            })
-                .join("\n\n");
-            return { content: [{ type: "text", text: `**Available Playbooks**\n\n${list}` }] };
-        }
-        // ── run_playbook ────────────────────────────────────────────────────────
-        case "run_playbook": {
-            if (!a.playbook_name) {
-                return { content: [{ type: "text", text: "playbook_name is required" }], isError: true };
-            }
-            // Resolve playbook ID by name
-            const pbList = await (0, convex_js_1.callConvex)("/framework/playbooks", "GET", undefined, "run_playbook");
-            const playbook = (pbList.playbooks ?? []).find((p) => p.name.toLowerCase() === String(a.playbook_name).toLowerCase());
-            if (!playbook) {
-                return {
-                    content: [{
-                            type: "text",
-                            text: `Playbook "${a.playbook_name}" not found. Use list_playbooks to see available ones.`,
-                        }],
-                    isError: true,
-                };
-            }
-            const result = await (0, convex_js_1.callConvex)("/framework/playbook/run", "POST", {
-                playbookId: playbook._id,
-                overrideParams: a.task_description,
-            }, "run_playbook");
-            if (result.error) {
-                return { content: [{ type: "text", text: `Run failed: ${result.error}` }], isError: true };
-            }
-            if (result.blocked) {
-                return {
-                    content: [{
-                            type: "text",
-                            text: [
-                                `🛡️ **Sentinel blocked playbook at step ${result.step}**`,
-                                ``,
-                                `**Tool:** ${result.tool}`,
-                                `**Reason:** ${result.reason}`,
-                                ``,
-                                `This is a mechanical safety gate. The action violates the agent's permission boundary.`,
-                                `Completed steps before block: ${result.results?.length ?? 0}`,
-                            ].join("\n"),
-                        }],
-                };
-            }
-            const steps = result.results ?? [];
-            const succeeded = steps.filter(r => r.success).length;
-            const stepLines = steps.map((r) => `${r.success ? "✅" : "❌"} Step ${r.step} [${r.role}]: ${r.tool}${r.error ? ` - ${r.error}` : ""}`);
-            return {
-                content: [{
-                        type: "text",
-                        text: [
-                            `✅ **Playbook "${a.playbook_name}" completed**`,
-                            ``,
-                            `${succeeded}/${steps.length} steps successful`,
-                            `Run ID: \`${result.runId}\``,
-                            ``,
-                            ...stepLines,
-                        ].join("\n"),
-                    }],
-            };
-        }
-        // ── get_finch_ledger ─────────────────────────────────────────────────────
-        case "get_finch_ledger": {
-            const result = await (0, convex_js_1.callConvex)("/swarm/ledger", "GET", undefined, "get_finch_ledger");
-            const entries = result.entries ?? [];
-            if (entries.length === 0) {
-                return {
-                    content: [{
-                            type: "text",
-                            text: "No ledger entries yet. Run a playbook to see Sentinel decisions.",
-                        }],
-                };
-            }
-            const lines = entries.map((e) => {
-                const icon = e.decision === "approved" ? "✅" : e.decision === "blocked" ? "🚫" : "⚠️";
-                return `${icon} **${e.agentId}** → \`${e.action}\`\n  ${e.reason} (${e.durationMs}ms)`;
-            });
-            return {
-                content: [{
-                        type: "text",
-                        text: `**Noel Ledger** (last ${entries.length} decisions)\n\n${lines.join("\n\n")}`,
-                    }],
-            };
-        }
-        default:
-            return null;
-    }
-}