@sammorrowdrums/mcpi-ext 0.2.0 → 0.2.1

package/dist/tool-cli/rpc-server.js

@@ -0,0 +1,220 @@
+import http from "node:http";
+import { resolvePort } from "./constants.js";
+/**
+ * JSON-RPC 2.0 server that exposes MCP tool discovery and execution.
+ *
+ * Methods:
+ * - listServers → server names + tool counts + random examples
+ * - listTools(server) → tool names + descriptions
+ * - describeTool(server, tool) → full schema
+ * - callTool(server, tool, arguments) → execute and return result
+ */
+export class ToolCliRpcServer {
+    mcpManager;
+    server = null;
+    port;
+    constructor(mcpManager, port) {
+        this.mcpManager = mcpManager;
+        this.port = port ?? resolvePort();
+    }
+    /** Start the HTTP server. Resolves once listening. */
+    async start(log) {
+        if (this.server)
+            return;
+        const MAX_BODY_SIZE = 1024 * 1024; // 1 MB
+        const server = http.createServer((req, res) => {
+            if (req.method !== "POST") {
+                res.writeHead(405, { "Content-Type": "application/json" });
+                res.end(JSON.stringify(rpcError(null, -32600, "Only POST accepted")));
+                return;
+            }
+            let body = "";
+            let aborted = false;
+            req.on("error", () => {
+                aborted = true;
+            });
+            req.on("data", (chunk) => {
+                if (aborted)
+                    return;
+                body += chunk.toString();
+                if (body.length > MAX_BODY_SIZE) {
+                    aborted = true;
+                    res.writeHead(413, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify(rpcError(null, -32600, "Request too large")));
+                    req.destroy();
+                }
+            });
+            req.on("end", () => {
+                if (aborted)
+                    return;
+                void this.handleBody(body)
+                    .then((response) => {
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify(response));
+                })
+                    .catch(() => {
+                    try {
+                        res.writeHead(500, { "Content-Type": "application/json" });
+                        res.end(JSON.stringify(rpcError(null, -32603, "Internal error")));
+                    }
+                    catch {
+                        res.end();
+                    }
+                });
+            });
+        });
+        return new Promise((resolve, reject) => {
+            server.once("error", (err) => {
+                this.server = null;
+                reject(err);
+            });
+            server.listen(this.port, "127.0.0.1", () => {
+                this.server = server;
+                log?.(`[tool-cli] RPC server listening on 127.0.0.1:${this.port}`);
+                resolve();
+            });
+        });
+    }
+    /** Stop the HTTP server. */
+    async stop() {
+        const server = this.server;
+        if (!server)
+            return;
+        this.server = null;
+        return new Promise((resolve) => {
+            server.close(() => resolve());
+        });
+    }
+    /** Returns the port the server is listening on (resolved after start for port 0). */
+    getPort() {
+        if (this.server) {
+            const addr = this.server.address();
+            if (addr && typeof addr === "object")
+                return addr.port;
+        }
+        return this.port;
+    }
+    async handleBody(body) {
+        let parsed;
+        try {
+            parsed = JSON.parse(body);
+        }
+        catch {
+            return rpcError(null, -32700, "Parse error");
+        }
+        if (parsed.jsonrpc !== "2.0" || !parsed.method) {
+            return rpcError(parsed.id ?? null, -32600, "Invalid Request");
+        }
+        try {
+            const result = await this.dispatch(parsed.method, parsed.params ?? {});
+            return { jsonrpc: "2.0", result, id: parsed.id ?? null };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const code = err instanceof RpcMethodError ? err.code : -32603;
+            return rpcError(parsed.id ?? null, code, message);
+        }
+    }
+    async dispatch(method, params) {
+        switch (method) {
+            case "listServers":
+                return this.listServers();
+            case "listTools":
+                return this.listTools(params);
+            case "describeTool":
+                return this.describeTool(params);
+            case "callTool":
+                return this.callTool(params);
+            default:
+                throw new RpcMethodError(-32601, `Method not found: ${method}`);
+        }
+    }
+    listServers() {
+        const serverNames = this.mcpManager.getConnectedServers();
+        const servers = serverNames.map((name) => {
+            const tools = this.mcpManager.getToolsForServer(name);
+            return {
+                name,
+                toolCount: tools.length,
+                examples: pickRandomExamples(tools, 3),
+            };
+        });
+        return { servers };
+    }
+    listTools(params) {
+        const server = requireString(params, "server");
+        this.assertServerExists(server);
+        const tools = this.mcpManager.getToolsForServer(server);
+        return {
+            server,
+            tools: tools.map((t) => ({
+                name: t.name,
+                description: t.description ?? "(no description)",
+                hasStructuredOutput: t.outputSchema != null,
+            })),
+        };
+    }
+    describeTool(params) {
+        const server = requireString(params, "server");
+        const toolName = requireString(params, "tool");
+        this.assertServerExists(server);
+        const tool = this.mcpManager.getToolsForServer(server).find((t) => t.name === toolName);
+        if (!tool) {
+            throw new RpcMethodError(-32602, `Tool "${toolName}" not found on server "${server}"`);
+        }
+        return {
+            name: tool.name,
+            description: tool.description ?? "(no description)",
+            inputSchema: tool.inputSchema,
+            outputSchema: tool.outputSchema,
+            annotations: tool.annotations,
+        };
+    }
+    async callTool(params) {
+        const server = requireString(params, "server");
+        const toolName = requireString(params, "tool");
+        this.assertServerExists(server);
+        const client = this.mcpManager.getClient(server);
+        if (!client) {
+            throw new RpcMethodError(-32603, `No client for server "${server}"`);
+        }
+        const toolArgs = params.arguments ?? {};
+        const result = await client.callTool({ name: toolName, arguments: toolArgs });
+        return {
+            content: result.content,
+            isError: result.isError === true ? true : undefined,
+            structuredContent: result.structuredContent,
+        };
+    }
+    assertServerExists(server) {
+        if (!this.mcpManager.getConnectedServers().includes(server)) {
+            throw new RpcMethodError(-32602, `Server "${server}" not found. Connected: ${this.mcpManager.getConnectedServers().join(", ") || "(none)"}`);
+        }
+    }
+}
+class RpcMethodError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "RpcMethodError";
+    }
+}
+function rpcError(id, code, message) {
+    return { jsonrpc: "2.0", error: { code, message }, id };
+}
+function requireString(params, key) {
+    const val = params[key];
+    if (typeof val !== "string" || val.length === 0) {
+        throw new RpcMethodError(-32602, `Missing or invalid parameter: "${key}" (string required)`);
+    }
+    return val;
+}
+/** Pick up to `n` random tool names from a list. */
+function pickRandomExamples(tools, n) {
+    if (tools.length <= n)
+        return tools.map((t) => t.name);
+    const shuffled = [...tools].sort(() => Math.random() - 0.5);
+    return shuffled.slice(0, n).map((t) => t.name);
+}
+//# sourceMappingURL=rpc-server.js.map

package/dist/tool-cli/rpc-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-server.js","sourceRoot":"","sources":["../../src/tool-cli/rpc-server.ts"],"names":[],"mappings":"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"}

package/dist/tool-cli/rpc-server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rpc-server.test.d.ts.map

package/dist/tool-cli/rpc-server.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-server.test.d.ts","sourceRoot":"","sources":["../../src/tool-cli/rpc-server.test.ts"],"names":[],"mappings":""}

package/dist/tool-cli/rpc-server.test.js

@@ -0,0 +1,154 @@
+import { describe, it, expect, beforeAll, afterAll } from "vitest";
+import { ToolCliRpcServer } from "./rpc-server.js";
+/** Minimal mock of McpClientManager for RPC server testing. */
+function createMockManager() {
+    const tools = [
+        {
+            name: "get_weather",
+            description: "Get current weather for a city",
+            inputSchema: {
+                type: "object",
+                properties: { city: { type: "string", description: "City name" } },
+                required: ["city"],
+            },
+            annotations: { readOnlyHint: true },
+            serverName: "weather",
+        },
+        {
+            name: "set_alarm",
+            description: "Set a weather alarm",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    city: { type: "string" },
+                    threshold: { type: "number" },
+                },
+                required: ["city", "threshold"],
+            },
+            annotations: { readOnlyHint: false, destructiveHint: false },
+            serverName: "weather",
+        },
+        {
+            name: "search_docs",
+            description: "Search documentation",
+            inputSchema: {
+                type: "object",
+                properties: { query: { type: "string", description: "Search query" } },
+                required: ["query"],
+            },
+            outputSchema: {
+                type: "object",
+                properties: { results: { type: "array" } },
+            },
+            annotations: { readOnlyHint: true },
+            serverName: "docs",
+        },
+    ];
+    return {
+        getConnectedServers: () => ["weather", "docs"],
+        getToolsForServer: (name) => tools.filter((t) => t.serverName === name),
+        getTools: () => tools,
+        getClient: (name) => {
+            if (name === "weather" || name === "docs") {
+                return {
+                    callTool: async (params) => ({
+                        content: [{ type: "text", text: `Called ${params.name}` }],
+                    }),
+                };
+            }
+            return undefined;
+        },
+    };
+}
+// Use port 0 so the OS assigns a free port — avoids collisions when src + dist tests run together
+describe("ToolCliRpcServer", () => {
+    let server;
+    let port;
+    beforeAll(async () => {
+        const manager = createMockManager();
+        server = new ToolCliRpcServer(manager, 0);
+        await server.start();
+        port = server.getPort();
+    });
+    afterAll(async () => {
+        await server.stop();
+    });
+    async function rpc(method, params = {}) {
+        const res = await fetch(`http://127.0.0.1:${port}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ jsonrpc: "2.0", method, params, id: 1 }),
+        });
+        return res.json();
+    }
+    it("lists connected servers with tool counts", async () => {
+        const resp = (await rpc("listServers"));
+        const { servers } = resp.result;
+        expect(servers).toHaveLength(2);
+        const weather = servers.find((s) => s.name === "weather");
+        expect(weather).toBeDefined();
+        expect(weather?.toolCount).toBe(2);
+        expect(weather?.examples.length).toBeGreaterThan(0);
+        const docs = servers.find((s) => s.name === "docs");
+        expect(docs).toBeDefined();
+        expect(docs?.toolCount).toBe(1);
+    });
+    it("lists tools for a specific server", async () => {
+        const resp = (await rpc("listTools", { server: "weather" }));
+        expect(resp.result.server).toBe("weather");
+        expect(resp.result.tools).toHaveLength(2);
+        expect(resp.result.tools[0].name).toBe("get_weather");
+        expect(resp.result.tools[1].name).toBe("set_alarm");
+    });
+    it("describes a tool with full schema", async () => {
+        const resp = (await rpc("describeTool", { server: "weather", tool: "get_weather" }));
+        expect(resp.result.name).toBe("get_weather");
+        expect(resp.result.description).toBe("Get current weather for a city");
+        expect(resp.result.inputSchema).toHaveProperty("properties");
+        expect(resp.result.annotations).toEqual({ readOnlyHint: true });
+    });
+    it("calls a tool and returns result", async () => {
+        const resp = (await rpc("callTool", {
+            server: "weather",
+            tool: "get_weather",
+            arguments: { city: "London" },
+        }));
+        expect(resp.result.content).toHaveLength(1);
+        expect(resp.result.content[0].text).toBe("Called get_weather");
+    });
+    it("returns error for unknown server", async () => {
+        const resp = (await rpc("listTools", { server: "nonexistent" }));
+        expect(resp.error).toBeDefined();
+        expect(resp.error.code).toBe(-32602);
+        expect(resp.error.message).toContain("not found");
+    });
+    it("returns error for unknown tool", async () => {
+        const resp = (await rpc("describeTool", { server: "weather", tool: "nonexistent" }));
+        expect(resp.error).toBeDefined();
+        expect(resp.error.message).toContain("not found");
+    });
+    it("returns error for unknown method", async () => {
+        const resp = (await rpc("unknownMethod"));
+        expect(resp.error).toBeDefined();
+        expect(resp.error.code).toBe(-32601);
+    });
+    it("returns error for missing required params", async () => {
+        const resp = (await rpc("listTools", {}));
+        expect(resp.error).toBeDefined();
+        expect(resp.error.code).toBe(-32602);
+    });
+    it("rejects non-POST requests", async () => {
+        const res = await fetch(`http://127.0.0.1:${port}`, { method: "GET" });
+        expect(res.status).toBe(405);
+    });
+    it("handles malformed JSON gracefully", async () => {
+        const res = await fetch(`http://127.0.0.1:${port}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: "not json at all",
+        });
+        const json = (await res.json());
+        expect(json.error.code).toBe(-32700);
+    });
+});
+//# sourceMappingURL=rpc-server.test.js.map

package/dist/tool-cli/rpc-server.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-server.test.js","sourceRoot":"","sources":["../../src/tool-cli/rpc-server.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sammorrowdrums/mcpi-ext",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@sammorrowdrums/tool-cli": "^0.3.0",
@@ -30,6 +30,7 @@
     "format:check": "prettier --check .",
     "lint": "eslint .",
     "lint:fix": "eslint --fix .",
+    "prepublishOnly": "npm run build",
     "start": "node dist/index.js",
     "test": "vitest --run"
   },
@@ -37,6 +38,9 @@
     "node": ">=22.13.0"
   },
   "description": "MCP extension for mcpi — tiered progressive tool discovery",
+  "files": [
+    "dist"
+  ],
   "license": "MIT",
   "main": "./dist/index.js",
   "type": "module",

package/.dockerignore

@@ -1,6 +0,0 @@
-node_modules
-dist
-.git
-.gitignore
-*.md
-.pi

package/.github/dependabot.yml

@@ -1,25 +0,0 @@
-version: 2
-
-updates:
-  - package-ecosystem: npm
-    directory: /
-    schedule:
-      interval: weekly
-    open-pull-requests-limit: 10
-    groups:
-      dev-dependencies:
-        dependency-type: development
-        update-types:
-          - minor
-          - patch
-      production-dependencies:
-        dependency-type: production
-        update-types:
-          - minor
-          - patch
-
-  - package-ecosystem: github-actions
-    directory: /
-    schedule:
-      interval: weekly
-    open-pull-requests-limit: 5

package/.github/workflows/ci.yml

@@ -1,50 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-concurrency:
-  group: ci-${{ github.ref }}
-  cancel-in-progress: true
-
-permissions:
-  contents: read
-  models: read
-
-jobs:
-  ci:
-    name: Lint, Build & Test
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-
-      - uses: jdx/mise-action@v4
-
-      - name: Install dependencies
-        run: npm install
-
-      - name: Lint
-        run: mise run lint
-
-      - name: Lint Dockerfile
-        uses: hadolint/hadolint-action@v3.3.0
-        with:
-          dockerfile: Dockerfile
-
-      - name: Check formatting
-        run: mise run format:check
-
-      - name: Type-check
-        run: mise run check
-
-      - name: Build
-        run: mise run build
-
-      - name: Test
-        run: mise run test
-
-      - name: MCP integration smoke test
-        run: mise run test:integration

package/.hadolint.yaml

@@ -1,6 +0,0 @@
-# hadolint configuration
-# DL3008: Pin versions in apt-get — not practical for a dev/e2e image
-# SC1091: Can't follow sourced file (/etc/os-release) — false positive
-ignored:
-  - DL3008
-  - SC1091

package/.prettierignore

@@ -1,4 +0,0 @@
-dist/
-node_modules/
-aube-lock.yaml
-*.tsbuildinfo

package/.prettierrc

@@ -1,7 +0,0 @@
-{
-  "semi": true,
-  "singleQuote": false,
-  "trailingComma": "all",
-  "printWidth": 100,
-  "tabWidth": 2
-}

package/AGENTS.md

@@ -1,118 +0,0 @@
-# AGENTS.md
-
-## Tooling
-
-This project uses **mise** for tool version management and **npm** for package management. If you are an AI agent or new contributor, read this first.
-
-### mise (tool version manager)
-
-- **What:** [mise](https://mise.jdx.dev/) manages tool versions (node) and project tasks. Think asdf + direnv + make in one tool.
-- **Why:** Reproducible dev environments. `mise.toml` pins exact tool versions so every contributor and CI run uses the same stack.
-- **Install:** `curl https://mise.run | sh` then activate: `eval "$(~/.local/bin/mise activate bash)"`
-- **Usage:**
-  - `mise install` — install all tools from `mise.toml`
-  - `mise run <task>` — run a project task (build, test, dev, check, start)
-  - `mise use <tool>@<version>` — add/update a tool version
-
-### mcpi (coding agent)
-
-- **What:** [mcpi](https://github.com/SamMorrowDrums/mcpi) is an extensible terminal coding agent (fork of pi). This project builds extensions for it.
-- **Extension pattern:** Export a default function receiving `ExtensionAPI`, register tools/commands/hooks.
-- **Load extension:** `mcpi --extension ./dist/index.js`
-
-## Dev Loop
-
-```sh
-mise install         # one-time: install node
-npm install          # install npm dependencies
-mise run build       # compile TypeScript
-mise run test        # run tests
-mise run dev         # watch mode for development
-mise run check       # type-check only
-mise run lint        # lint TypeScript files
-mise run format      # auto-format code with Prettier
-mise run format:check # check formatting (CI mode)
-```
-
-## Project Structure
-
-```
-src/
-  index.ts             Extension entry point (lifecycle hooks, wiring)
-  mcp/                 MCP client management (connections, tool discovery)
-  skills/              Skill registry, discovery, gating, tool proxies
-  tool-cli/            tool-cli RPC server, client, CLI binary, prompt
-  test-servers/        Test MCP servers (weather, echo)
-dist/                  Compiled output (gitignored)
-scripts/               Integration and smoke test scripts
-mise.toml              Tool versions and tasks
-package.json           Dependencies and npm scripts
-tsconfig.json          TypeScript configuration
-```
-
-## Architecture
-
-### Tiered MCP Tool Access
-
-The extension provides three tiers for exposing MCP tools to the agent:
-
-| Tier          | Mechanism                                                          | When Used                                        |
-| ------------- | ------------------------------------------------------------------ | ------------------------------------------------ |
-| 1 — Skills    | `deferred: true` + `tool_call` gate → tools unlocked by load_skill | MCP server ships skills                          |
-| 2 — tool-cli  | CLI progressive discovery via shell                                | Ad-hoc exploration, no skills                    |
-| 3 — Code Mode | search+execute, no HITL                                            | Read-only tools with structured output (planned) |
-
-### tool-cli Architecture
-
-tool-cli is a thin CLI binary that communicates with the extension via JSON-RPC 2.0 over HTTP. The agent uses it as a standard shell command, composable with pipes, grep, jq, loops, etc.
-
-```
-Agent (mcpi)
-  │
-  │  shell exec
-  ▼
-tool-cli <server> <tool> '{"args"}'
-  │
-  │  HTTP JSON-RPC (localhost:7179)
-  ▼
-ToolCliRpcServer (in extension process)
-  │
-  │  MCP protocol (stdio/HTTP)
-  ▼
-MCP Server(s)
-```
-
-**Key design points:**
-
-- **No auth (temporary)** — the RPC server binds to `127.0.0.1` only, limiting access to the local machine. This is acceptable for development but not a finished security posture — any local process can call the server and execute MCP tools. Future work should add a shared secret or token (e.g. passed via environment variable to the CLI) so only the intended agent process can make calls.
-- **Interception point for HITL** — the RPC server's `callTool` method is the single choke point for all tool execution. Future work can check tool annotations (`readOnlyHint`, `destructiveHint`) here and gate non-read-only calls through user confirmation before forwarding to the MCP server.
-- **Progressive discovery** — the agent discovers servers → tools → schemas incrementally, paying only the tokens it needs.
-- **Shell-native** — plain text output composes with grep, jq, xargs, pipes, loops. The agent can chain tool calls using standard bash idioms.
-
-## Code Quality
-
-- **ESLint** — flat config with `typescript-eslint` (strict + stylistic) and Prettier compat
-- **Prettier** — auto-formatting (double quotes, semicolons, trailing commas, 100 char width)
-- **CI** — GitHub Actions runs lint → format:check → type-check → build → test on every PR
-- **Dependabot** — automated dependency updates (npm + GitHub Actions)
-
-Run `mise run lint` and `mise run format` before committing. CI will reject PRs that fail any check.
-
-**Before pushing**, always run:
-
-```sh
-mise run lint        # lint must pass
-mise run test        # tests must pass
-mise run format:check # formatting must pass
-```
-
-## Decision Log
-
-We maintain a [DECISIONS.md](DECISIONS.md) file recording key architectural and design decisions. Keep it up to date when making significant choices — add a new numbered entry with date, context, decision, and rationale.
-
-## Conventions
-
-- ESM (`"type": "module"`)
-- Target: ES2022, module: Node16
-- Strict TypeScript
-- Tests with vitest (co-located `*.test.ts` files)