@sammorrowdrums/mcpi-ext 0.1.0

package/dist/test-servers/weather-server.js

@@ -0,0 +1,139 @@
+/**
+ * Test MCP weather server — exposes a weather skill with gated tools.
+ *
+ * Registers:
+ * - skill://weather/SKILL.md — a skill resource with frontmatter
+ * - check_weather_for_city — current weather (gated by skill)
+ * - check_weekly_forecast_for_city — 7-day forecast (gated by skill)
+ * - echo — ungated baseline tool
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+const SKILL_CONTENT = `---
+name: weather
+description: Check current weather and weekly forecasts for any city
+allowed-tools:
+  - check_weather_for_city
+  - check_weekly_forecast_for_city
+---
+
+# Weather Forecasting Skill
+
+Use the weather tools to look up conditions for any city.
+
+- **check_weather_for_city** — returns current temperature, conditions, and humidity
+- **check_weekly_forecast_for_city** — returns a 7-day forecast summary
+
+Always confirm the city name with the user before calling.
+`;
+const WEATHER_DATA = {
+    london: { temp: 14, conditions: "Cloudy", humidity: 78 },
+    tokyo: { temp: 26, conditions: "Sunny", humidity: 55 },
+    "new york": { temp: 22, conditions: "Partly cloudy", humidity: 62 },
+    sydney: { temp: 19, conditions: "Clear", humidity: 45 },
+};
+const FORECAST_DATA = {
+    london: "Mon 13°C Rain | Tue 14°C Cloudy | Wed 15°C Cloudy | Thu 12°C Rain | Fri 14°C Sunny | Sat 16°C Sunny | Sun 15°C Cloudy",
+    tokyo: "Mon 27°C Sunny | Tue 28°C Sunny | Wed 25°C Rain | Thu 24°C Cloudy | Fri 26°C Sunny | Sat 27°C Sunny | Sun 26°C Partly cloudy",
+    "new york": "Mon 23°C Sunny | Tue 24°C Sunny | Wed 20°C Thunderstorms | Thu 18°C Cloudy | Fri 21°C Sunny | Sat 22°C Sunny | Sun 23°C Clear",
+    sydney: "Mon 18°C Clear | Tue 20°C Sunny | Wed 19°C Cloudy | Thu 17°C Rain | Fri 18°C Cloudy | Sat 21°C Sunny | Sun 20°C Clear",
+};
+export function createWeatherServer() {
+    const server = new McpServer({ name: "test-weather-server", version: "0.1.0" }, { capabilities: { resources: {} } });
+    // Skill resource
+    server.registerResource("weather-skill", "skill://weather/SKILL.md", {
+        description: "Weather forecasting skill instructions",
+        mimeType: "text/markdown",
+    }, async () => ({
+        contents: [
+            {
+                uri: "skill://weather/SKILL.md",
+                text: SKILL_CONTENT,
+                mimeType: "text/markdown",
+            },
+        ],
+    }));
+    // Tool: current weather (gated by skill)
+    server.registerTool("check_weather_for_city", {
+        description: "Get current weather conditions for a city",
+        inputSchema: { city: z.string().describe("City name, e.g. 'London'") },
+        outputSchema: {
+            temperature: z.number().describe("Temperature in Celsius"),
+            conditions: z.string().describe("Weather conditions description"),
+            humidity: z.number().describe("Humidity percentage"),
+            city: z.string().describe("City name"),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ city }) => {
+        const data = WEATHER_DATA[city.toLowerCase()];
+        if (!data) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No weather data available for "${city}". Try: London, Tokyo, New York, or Sydney.`,
+                    },
+                ],
+            };
+        }
+        const structuredContent = {
+            temperature: data.temp,
+            conditions: data.conditions,
+            humidity: data.humidity,
+            city,
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Weather in ${city}: ${data.conditions}, ${data.temp}°C, humidity ${data.humidity}%`,
+                },
+            ],
+            structuredContent,
+        };
+    });
+    // Tool: weekly forecast (gated by skill)
+    server.registerTool("check_weekly_forecast_for_city", {
+        description: "Get a 7-day weather forecast for a city",
+        inputSchema: { city: z.string().describe("City name, e.g. 'Tokyo'") },
+        outputSchema: {
+            city: z.string().describe("City name"),
+            forecast: z.string().describe("7-day forecast summary"),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ city }) => {
+        const forecast = FORECAST_DATA[city.toLowerCase()];
+        if (!forecast) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No forecast data available for "${city}". Try: London, Tokyo, New York, or Sydney.`,
+                    },
+                ],
+            };
+        }
+        const structuredContent = { city, forecast };
+        return {
+            content: [{ type: "text", text: `Forecast for ${city}: ${forecast}` }],
+            structuredContent,
+        };
+    });
+    // Ungated tool (always available, not behind a skill)
+    server.registerTool("echo", {
+        description: "Echoes back the input message",
+        inputSchema: { message: z.string() },
+        outputSchema: {
+            echo: z.string().describe("The echoed message"),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ message }) => {
+        const structuredContent = { echo: message };
+        return {
+            content: [{ type: "text", text: `Echo: ${message}` }],
+            structuredContent,
+        };
+    });
+    return server;
+}
+//# sourceMappingURL=weather-server.js.map

package/dist/test-servers/weather-server.js.map

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

package/dist/test-servers/weather-stdio.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=weather-stdio.d.ts.map

package/dist/test-servers/weather-stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weather-stdio.d.ts","sourceRoot":"","sources":["../../src/test-servers/weather-stdio.ts"],"names":[],"mappings":""}

package/dist/test-servers/weather-stdio.js

@@ -0,0 +1,11 @@
+/**
+ * stdio entrypoint for the test weather server.
+ * Run with: node dist/test-servers/weather-stdio.js
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createWeatherServer } from "./weather-server.js";
+const server = createWeatherServer();
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("Test weather server running on stdio");
+//# sourceMappingURL=weather-stdio.js.map

package/dist/test-servers/weather-stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weather-stdio.js","sourceRoot":"","sources":["../../src/test-servers/weather-stdio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,MAAM,GAAG,mBAAmB,EAAE,CAAC;AACrC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAChC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC"}

package/dist/tool-cli/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/tool-cli/cli.d.ts.map

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

package/dist/tool-cli/cli.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+import { writeFileSync } from "node:fs";
+import { rpcCall } from "./rpc-client.js";
+async function main() {
+    const rawArgs = process.argv.slice(2);
+    // Extract --out <file> flag (can appear anywhere)
+    let outFile;
+    const args = [];
+    for (let i = 0; i < rawArgs.length; i++) {
+        if (rawArgs[i] === "--out" && i + 1 < rawArgs.length) {
+            outFile = rawArgs[++i];
+        }
+        else {
+            args.push(rawArgs[i]);
+        }
+    }
+    try {
+        // No args or --help → list servers
+        if (args.length === 0 || (args.length === 1 && isHelp(args[0]))) {
+            await listServers();
+            return;
+        }
+        const server = args[0];
+        // <server> --help or just <server> → list tools
+        if (args.length === 1 || (args.length === 2 && isHelp(args[1]))) {
+            await listTools(server);
+            return;
+        }
+        const tool = args[1];
+        // <server> <tool> --help or just <server> <tool> → describe tool
+        if (args.length === 2 || (args.length === 3 && isHelp(args[2]))) {
+            await describeTool(server, tool);
+            return;
+        }
+        // <server> <tool> <json-args> → call tool
+        await callTool(server, tool, args[2], outFile);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (message.includes("ECONNREFUSED") || message.includes("fetch failed")) {
+            console.error("Error: tool-cli server not running. Is mcpi-ext loaded?");
+        }
+        else {
+            console.error(`Error: ${message}`);
+        }
+        process.exit(1);
+    }
+}
+async function listServers() {
+    const result = (await rpcCall("listServers"));
+    const { servers } = result;
+    if (servers.length === 0) {
+        console.log("No MCP servers connected.");
+        return;
+    }
+    console.log("Available servers:");
+    for (const s of servers) {
+        const examples = s.examples.length > 0 ? ` (e.g. ${s.examples.join(", ")})` : "";
+        console.log(`  ${s.name.padEnd(20)} ${s.toolCount} tool(s)${examples}`);
+    }
+    console.log("");
+    console.log("Use: tool-cli <server> to list tools");
+}
+async function listTools(server) {
+    const result = (await rpcCall("listTools", { server }));
+    if (result.tools.length === 0) {
+        console.log(`${server} — no tools`);
+        return;
+    }
+    console.log(`${server} — ${result.tools.length} tool(s):`);
+    for (const t of result.tools) {
+        const badge = t.hasStructuredOutput ? " [json]" : "";
+        console.log(`  ${t.name.padEnd(30)} ${t.description}${badge}`);
+    }
+    console.log("");
+    console.log("Use: tool-cli <server> <tool> for full schema");
+}
+async function describeTool(server, tool) {
+    const result = (await rpcCall("describeTool", { server, tool }));
+    console.log(`${result.name} — ${result.description}`);
+    console.log("");
+    console.log("Input schema:");
+    console.log(formatSchema(result.inputSchema));
+    if (result.outputSchema) {
+        console.log("");
+        console.log("Output schema (structured JSON output):");
+        console.log(formatSchema(result.outputSchema));
+    }
+    if (result.annotations && Object.keys(result.annotations).length > 0) {
+        console.log("");
+        console.log("Annotations:");
+        for (const [key, val] of Object.entries(result.annotations)) {
+            console.log(`  ${key}: ${JSON.stringify(val)}`);
+        }
+    }
+    console.log("");
+    console.log(`Use: tool-cli ${server} ${tool} '{"key":"value"}' to call`);
+}
+async function callTool(server, tool, argsJson, outFile) {
+    let toolArgs;
+    try {
+        toolArgs = JSON.parse(argsJson);
+    }
+    catch {
+        console.error(`Error: invalid JSON arguments: ${argsJson}`);
+        process.exit(1);
+    }
+    const result = (await rpcCall("callTool", { server, tool, arguments: toolArgs }));
+    if (result.isError) {
+        // Error content goes to stderr so stdout stays clean for piping
+        if (result.structuredContent) {
+            console.error(JSON.stringify(result.structuredContent, null, 2));
+        }
+        else if (result.content) {
+            for (const item of result.content) {
+                const entry = item;
+                if (entry.type === "text") {
+                    console.error(entry.text);
+                }
+                else {
+                    console.error(JSON.stringify(entry, null, 2));
+                }
+            }
+        }
+        process.exit(1);
+        return;
+    }
+    const output = formatOutput(result.structuredContent, result.content);
+    if (!output)
+        return;
+    if (outFile) {
+        writeFileSync(outFile, output, "utf-8");
+        console.log(`Written to: ${outFile}`);
+    }
+    else {
+        console.log(output);
+    }
+}
+/** Build the output string from structured or raw content. */
+function formatOutput(structuredContent, content) {
+    if (structuredContent) {
+        return JSON.stringify(structuredContent, null, 2);
+    }
+    if (content) {
+        const parts = [];
+        for (const item of content) {
+            const entry = item;
+            if (entry.type === "text") {
+                parts.push(entry.text);
+            }
+            else {
+                parts.push(JSON.stringify(entry, null, 2));
+            }
+        }
+        return parts.join("\n");
+    }
+    return "";
+}
+/** Format a JSON Schema as a compact, readable summary. */
+function formatSchema(schema) {
+    const props = schema.properties;
+    const required = schema.required ?? [];
+    if (!props || Object.keys(props).length === 0) {
+        return "  (no parameters)";
+    }
+    const lines = [];
+    for (const [name, prop] of Object.entries(props)) {
+        const type = prop.type ?? "unknown";
+        const req = required.includes(name) ? ", required" : "";
+        const desc = prop.description ? `: ${prop.description}` : "";
+        lines.push(`  ${name} (${type}${req})${desc}`);
+    }
+    return lines.join("\n");
+}
+function isHelp(arg) {
+    return arg === "--help" || arg === "-h";
+}
+void main();
+//# sourceMappingURL=cli.js.map

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

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

package/dist/tool-cli/constants.d.ts

@@ -0,0 +1,7 @@
+/** Default port for the tool-cli JSON-RPC server. */
+export declare const DEFAULT_PORT = 7179;
+/** Environment variable to override the default port. */
+export declare const PORT_ENV_VAR = "TOOL_CLI_PORT";
+/** Resolve the port from environment or default. */
+export declare function resolvePort(): number;
+//# sourceMappingURL=constants.d.ts.map

package/dist/tool-cli/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/tool-cli/constants.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,yDAAyD;AACzD,eAAO,MAAM,YAAY,kBAAkB,CAAC;AAE5C,oDAAoD;AACpD,wBAAgB,WAAW,IAAI,MAAM,CAOpC"}

package/dist/tool-cli/constants.js

@@ -0,0 +1,15 @@
+/** Default port for the tool-cli JSON-RPC server. */
+export const DEFAULT_PORT = 7179;
+/** Environment variable to override the default port. */
+export const PORT_ENV_VAR = "TOOL_CLI_PORT";
+/** Resolve the port from environment or default. */
+export function resolvePort() {
+    const envPort = process.env[PORT_ENV_VAR];
+    if (envPort) {
+        const parsed = parseInt(envPort, 10);
+        if (!isNaN(parsed) && parsed > 0 && parsed < 65536)
+            return parsed;
+    }
+    return DEFAULT_PORT;
+}
+//# sourceMappingURL=constants.js.map

package/dist/tool-cli/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/tool-cli/constants.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AAEjC,yDAAyD;AACzD,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC;AAE5C,oDAAoD;AACpD,MAAM,UAAU,WAAW;IACzB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1C,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,KAAK;YAAE,OAAO,MAAM,CAAC;IACpE,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/tool-cli/format.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Format system prompt section advising the agent when and how to use tool-cli.
+ *
+ * Only included when MCP servers are connected. Tells the agent about
+ * progressive discovery via tool-cli as an alternative to skill-based access.
+ */
+export declare function formatToolCliForPrompt(serverCount: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/tool-cli/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/tool-cli/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAiDlE"}

package/dist/tool-cli/format.js

@@ -0,0 +1,57 @@
+/**
+ * Format system prompt section advising the agent when and how to use tool-cli.
+ *
+ * Only included when MCP servers are connected. Tells the agent about
+ * progressive discovery via tool-cli as an alternative to skill-based access.
+ */
+export function formatToolCliForPrompt(serverCount) {
+    if (serverCount === 0)
+        return "";
+    return `
+
+<tool_cli>
+You have access to \`tool-cli\`, a CLI for discovering and calling MCP server tools progressively.
+
+Use tool-cli when:
+- No skill covers the task you need to do
+- You want to explore what tools are available on a server
+- You need ad-hoc access to an MCP tool without loading a full skill
+
+If a skill exists for the task, prefer the skill — it provides workflow instructions and curated tool access.
+
+Discovery (progressive — only fetch what you need):
+  tool-cli --help                            # List MCP servers with tool counts
+  tool-cli <server>                          # List all tools on a server
+  tool-cli <server> <tool>                   # Show full schema for a tool
+
+Calling tools:
+  tool-cli <server> <tool> '{"key":"value"}' # Call a tool with JSON arguments
+  tool-cli <server> <tool> '{}' --out /tmp/result.json  # Save large output to file
+
+tool-cli outputs plain text or JSON. When a tool provides structured output (typed JSON),
+tool-cli returns it directly as JSON — use \`jq\` to query fields.
+Chain calls, filter, and transform results using pipes and bash idioms:
+
+  # Search across tool results
+  tool-cli myserver search_docs '{"query":"auth"}' | grep -i "token"
+
+  # Query structured JSON output with jq
+  tool-cli myserver list_issues '{"repo":"owner/repo"}' | jq '.[].title'
+
+  # Chain tool calls — feed one result into another
+  tool-cli myserver list_items '{}' | jq -r '.[0].id' | xargs -I{} tool-cli myserver get_item '{"id":"{}"}'
+
+  # Process multiple items
+  for city in London Tokyo Paris; do
+    echo "=== $city ==="; tool-cli weather check_weather '{"city":"'$city'"}';
+  done
+
+  # Combine with standard tools
+  tool-cli myserver export_csv '{"table":"users"}' | sort -t, -k2 | head -20
+
+Prefer piping and chaining over multiple separate tool calls when processing collections or filtering results.
+Errors go to stderr with exit code 1 — use \`&&\` or \`set -e\` for safe chaining.
+${serverCount} MCP server(s) currently connected.
+</tool_cli>`;
+}
+//# sourceMappingURL=format.js.map

package/dist/tool-cli/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/tool-cli/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4CP,WAAW;YACD,CAAC;AACb,CAAC"}

package/dist/tool-cli/format.test.d.ts

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

package/dist/tool-cli/format.test.d.ts.map

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

package/dist/tool-cli/format.test.js

@@ -0,0 +1,30 @@
+import { describe, it, expect } from "vitest";
+import { formatToolCliForPrompt } from "./format.js";
+describe("formatToolCliForPrompt", () => {
+    it("returns empty string when no servers connected", () => {
+        expect(formatToolCliForPrompt(0)).toBe("");
+    });
+    it("includes tool-cli usage instructions when servers are connected", () => {
+        const result = formatToolCliForPrompt(2);
+        expect(result).toContain("tool-cli");
+        expect(result).toContain("<tool_cli>");
+        expect(result).toContain("</tool_cli>");
+        expect(result).toContain("--help");
+        expect(result).toContain("<server>");
+        expect(result).toContain("<tool>");
+        expect(result).toContain("2 MCP server(s) currently connected");
+    });
+    it("advises preferring skills over tool-cli", () => {
+        const result = formatToolCliForPrompt(1);
+        expect(result).toContain("prefer the skill");
+    });
+    it("includes shell chaining and piping examples", () => {
+        const result = formatToolCliForPrompt(1);
+        expect(result).toContain("grep");
+        expect(result).toContain("|");
+        expect(result).toContain("jq");
+        expect(result).toContain("xargs");
+        expect(result).toContain("Prefer piping and chaining");
+    });
+});
+//# sourceMappingURL=format.test.js.map

package/dist/tool-cli/format.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.test.js","sourceRoot":"","sources":["../../src/tool-cli/format.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,MAAM,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,qCAAqC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tool-cli/index.d.ts

@@ -0,0 +1,4 @@
+export { ToolCliRpcServer } from "./rpc-server.js";
+export { formatToolCliForPrompt } from "./format.js";
+export { DEFAULT_PORT, PORT_ENV_VAR, resolvePort } from "./constants.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tool-cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tool-cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tool-cli/index.js

@@ -0,0 +1,4 @@
+export { ToolCliRpcServer } from "./rpc-server.js";
+export { formatToolCliForPrompt } from "./format.js";
+export { DEFAULT_PORT, PORT_ENV_VAR, resolvePort } from "./constants.js";
+//# sourceMappingURL=index.js.map

package/dist/tool-cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tool-cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tool-cli/rpc-client.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Send a JSON-RPC 2.0 request to the tool-cli RPC server.
+ * Throws on network errors and JSON-RPC error responses.
+ */
+export declare function rpcCall(method: string, params?: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=rpc-client.d.ts.map

package/dist/tool-cli/rpc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-client.d.ts","sourceRoot":"","sources":["../../src/tool-cli/rpc-client.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,OAAO,CAAC,CAsBlB"}

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

@@ -0,0 +1,25 @@
+import { resolvePort } from "./constants.js";
+/**
+ * Send a JSON-RPC 2.0 request to the tool-cli RPC server.
+ * Throws on network errors and JSON-RPC error responses.
+ */
+export async function rpcCall(method, params = {}) {
+    const port = resolvePort();
+    const url = `http://127.0.0.1:${port}`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            jsonrpc: "2.0",
+            method,
+            params,
+            id: 1,
+        }),
+    });
+    const json = (await response.json());
+    if (json.error) {
+        throw new Error(json.error.message);
+    }
+    return json.result;
+}
+//# sourceMappingURL=rpc-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-client.js","sourceRoot":"","sources":["../../src/tool-cli/rpc-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAS7C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAc,EACd,SAAkC,EAAE;IAEpC,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,oBAAoB,IAAI,EAAE,CAAC;IAEvC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,OAAO,EAAE,KAAK;YACd,MAAM;YACN,MAAM;YACN,EAAE,EAAE,CAAC;SACN,CAAC;KACH,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;IAExD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC"}

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

@@ -0,0 +1,48 @@
+import type { McpClientManager } from "../mcp/index.js";
+interface ServerInfo {
+    name: string;
+    toolCount: number;
+    examples: string[];
+}
+interface ToolSummary {
+    name: string;
+    description: string;
+    hasStructuredOutput: boolean;
+}
+interface ToolDetails {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    annotations?: Record<string, unknown>;
+}
+export type { ServerInfo, ToolSummary, ToolDetails };
+/**
+ * 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 declare class ToolCliRpcServer {
+    private mcpManager;
+    private server;
+    private port;
+    constructor(mcpManager: McpClientManager, port?: number);
+    /** Start the HTTP server. Resolves once listening. */
+    start(log?: (msg: string) => void): Promise<void>;
+    /** Stop the HTTP server. */
+    stop(): Promise<void>;
+    /** Returns the port the server is listening on (resolved after start for port 0). */
+    getPort(): number;
+    private handleBody;
+    private dispatch;
+    private listServers;
+    private listTools;
+    private describeTool;
+    private callTool;
+    private assertServerExists;
+}
+//# sourceMappingURL=rpc-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-server.d.ts","sourceRoot":"","sources":["../../src/tool-cli/rpc-server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAW,MAAM,iBAAiB,CAAC;AAiBjE,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAErD;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,UAAU;IAJpB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,IAAI,CAAS;gBAGX,UAAU,EAAE,gBAAgB,EACpC,IAAI,CAAC,EAAE,MAAM;IAKf,sDAAsD;IAChD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA6DvD,4BAA4B;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,qFAAqF;IACrF,OAAO,IAAI,MAAM;YAQH,UAAU;YAsBV,QAAQ;IAetB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,YAAY;YAmBN,QAAQ;IAwBtB,OAAO,CAAC,kBAAkB;CAQ3B"}