@clawmasons/mcp-agent 0.1.1 → 0.1.3

package/dist/acp-agent.d.ts

@@ -0,0 +1,39 @@
+/**
+ * ACP Agent — implements the ACP SDK `Agent` interface backed by a ToolCaller.
+ *
+ * Handles `initialize`, `newSession`, `prompt`, and `cancel` protocol messages.
+ * The `prompt` handler lists available MCP tools and returns them as a text
+ * response so the ACP client knows what tools the agent exposes.
+ */
+import type { AgentSideConnection, Agent } from "@agentclientprotocol/sdk";
+import type { InitializeRequest, InitializeResponse, NewSessionRequest, NewSessionResponse, PromptRequest, PromptResponse, CancelNotification } from "@agentclientprotocol/sdk";
+import type { ToolCaller } from "./tool-caller.js";
+export interface AcpAgentConfig {
+    /** ToolCaller for listing and calling MCP tools */
+    caller: ToolCaller;
+    /**
+     * Optional callback invoked during newSession to resolve credentials
+     * and connect to the MCP proxy. Called once per session.
+     */
+    onSessionSetup?: () => Promise<void>;
+}
+export declare class AcpAgent implements Agent {
+    private connection;
+    private caller;
+    private onSessionSetup?;
+    private sessionId;
+    constructor(connection: AgentSideConnection, config: AcpAgentConfig);
+    initialize(_params: InitializeRequest): Promise<InitializeResponse>;
+    newSession(_params: NewSessionRequest): Promise<NewSessionResponse>;
+    prompt(params: PromptRequest): Promise<PromptResponse>;
+    cancel(_params: CancelNotification): Promise<void>;
+    authenticate(): Promise<Record<string, never>>;
+}
+/**
+ * Create a factory function suitable for passing to `AgentSideConnection`.
+ *
+ * Usage:
+ *   new AgentSideConnection(createAcpAgentFactory(config), stream)
+ */
+export declare function createAcpAgentFactory(config: AcpAgentConfig): (conn: AgentSideConnection) => Agent;
+//# sourceMappingURL=acp-agent.d.ts.map

package/dist/acp-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-agent.d.ts","sourceRoot":"","sources":["../src/acp-agent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAE3E,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKnD,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,MAAM,EAAE,UAAU,CAAC;IACnB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAID,qBAAa,QAAS,YAAW,KAAK;IACpC,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,cAAc,CAAC,CAAsB;IAC7C,OAAO,CAAC,SAAS,CAAuB;gBAE5B,UAAU,EAAE,mBAAmB,EAAE,MAAM,EAAE,cAAc;IAM7D,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAanE,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgBnE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA4BtD,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAGrD;AAID;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,GACrB,CAAC,IAAI,EAAE,mBAAmB,KAAK,KAAK,CAEtC"}

package/dist/acp-agent.js

@@ -0,0 +1,87 @@
+/**
+ * ACP Agent — implements the ACP SDK `Agent` interface backed by a ToolCaller.
+ *
+ * Handles `initialize`, `newSession`, `prompt`, and `cancel` protocol messages.
+ * The `prompt` handler lists available MCP tools and returns them as a text
+ * response so the ACP client knows what tools the agent exposes.
+ */
+import { PROTOCOL_VERSION } from "@agentclientprotocol/sdk";
+import { executeCommand } from "./tool-caller.js";
+// ── Implementation ────────────────────────────────────────────────────
+export class AcpAgent {
+    connection;
+    caller;
+    onSessionSetup;
+    sessionId = null;
+    constructor(connection, config) {
+        this.connection = connection;
+        this.caller = config.caller;
+        this.onSessionSetup = config.onSessionSetup;
+    }
+    async initialize(_params) {
+        return {
+            protocolVersion: PROTOCOL_VERSION,
+            agentInfo: {
+                name: "mcp-agent",
+                version: "0.1.0",
+            },
+            agentCapabilities: {
+                loadSession: false,
+            },
+        };
+    }
+    async newSession(_params) {
+        // Run credential resolution and proxy connection if configured
+        if (this.onSessionSetup) {
+            await this.onSessionSetup();
+        }
+        // Generate a random session ID
+        this.sessionId = Array.from(crypto.getRandomValues(new Uint8Array(16)))
+            .map((b) => b.toString(16).padStart(2, "0"))
+            .join("");
+        return {
+            sessionId: this.sessionId,
+        };
+    }
+    async prompt(params) {
+        // Extract text from prompt content blocks
+        const inputText = params.prompt
+            .filter((block) => block.type === "text")
+            .map((block) => block.text)
+            .join("\n")
+            .trim();
+        // Execute the command (list, help, call <tool> <args>, etc.)
+        const { output } = await executeCommand(inputText, this.caller);
+        // Send the result as a session update notification
+        await this.connection.sessionUpdate({
+            sessionId: params.sessionId,
+            update: {
+                sessionUpdate: "agent_message_chunk",
+                content: {
+                    type: "text",
+                    text: output,
+                },
+            },
+        });
+        return {
+            stopReason: "end_turn",
+        };
+    }
+    async cancel(_params) {
+        // No-op: prompt handler is synchronous, nothing to cancel
+    }
+    async authenticate() {
+        return {};
+    }
+}
+// ── Factory ───────────────────────────────────────────────────────────
+/**
+ * Create a factory function suitable for passing to `AgentSideConnection`.
+ *
+ * Usage:
+ *   new AgentSideConnection(createAcpAgentFactory(config), stream)
+ */
+export function createAcpAgentFactory(config) {
+    return (conn) => new AcpAgent(conn, config);
+}
+//# sourceMappingURL=acp-agent.js.map

package/dist/acp-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-agent.js","sourceRoot":"","sources":["../src/acp-agent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAW5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAclD,yEAAyE;AAEzE,MAAM,OAAO,QAAQ;IACX,UAAU,CAAsB;IAChC,MAAM,CAAa;IACnB,cAAc,CAAuB;IACrC,SAAS,GAAkB,IAAI,CAAC;IAExC,YAAY,UAA+B,EAAE,MAAsB;QACjE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAA0B;QACzC,OAAO;YACL,eAAe,EAAE,gBAAgB;YACjC,SAAS,EAAE;gBACT,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,OAAO;aACjB;YACD,iBAAiB,EAAE;gBACjB,WAAW,EAAE,KAAK;aACnB;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAA0B;QACzC,+DAA+D;QAC/D,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC9B,CAAC;QAED,+BAA+B;QAC/B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;aACpE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;aAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;QAEZ,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAqB;QAChC,0CAA0C;QAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM;aAC5B,MAAM,CAAC,CAAC,KAAK,EAA2C,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;aACjF,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;aAC1B,IAAI,CAAC,IAAI,CAAC;aACV,IAAI,EAAE,CAAC;QAEV,6DAA6D;QAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhE,mDAAmD;QACnD,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;YAClC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE;gBACN,aAAa,EAAE,qBAAqB;gBACpC,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM;iBACb;aACF;SACF,CAAC,CAAC;QAEH,OAAO;YACL,UAAU,EAAE,UAAU;SACvB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAA2B;QACtC,0DAA0D;IAC5D,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED,yEAAyE;AAEzE;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAsB;IAEtB,OAAO,CAAC,IAAyB,EAAS,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC1E,CAAC"}

package/dist/agent-package.d.ts

@@ -0,0 +1,5 @@
+import type { AgentPackage } from "@clawmasons/agent-sdk";
+export { mcpAgentMaterializer } from "./materializer.js";
+declare const mcpAgent: AgentPackage;
+export default mcpAgent;
+//# sourceMappingURL=agent-package.d.ts.map

package/dist/agent-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-package.d.ts","sourceRoot":"","sources":["../src/agent-package.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,QAAA,MAAM,QAAQ,EAAE,YAaf,CAAC;AAKF,eAAe,QAAQ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MCP Agent — General-purpose MCP agent with REPL and ACP modes.
+ *
+ * Modes:
+ *   - REPL (default): Interactive tool-calling interface via stdin/stdout
+ *   - ACP (--acp): ACP endpoint reading/writing ndjson on stdin/stdout
+ *
+ * Environment variables:
+ *   - TEST_TOKEN       — credential injected by agent-entry (required)
+ *   - MCP_PROXY_URL    — proxy URL (default: http://localhost:9090)
+ *   - MCP_PROXY_TOKEN  — proxy auth token (required for MCP calls)
+ *
+ * CLI flags:
+ *   --acp              — start in ACP agent mode (stdin/stdout ndjson)
+ */
+export declare function main(argv?: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiLH,wBAAsB,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+IzD"}

package/dist/index.js

@@ -0,0 +1,304 @@
+/**
+ * MCP Agent — General-purpose MCP agent with REPL and ACP modes.
+ *
+ * Modes:
+ *   - REPL (default): Interactive tool-calling interface via stdin/stdout
+ *   - ACP (--acp): ACP endpoint reading/writing ndjson on stdin/stdout
+ *
+ * Environment variables:
+ *   - TEST_TOKEN       — credential injected by agent-entry (required)
+ *   - MCP_PROXY_URL    — proxy URL (default: http://localhost:9090)
+ *   - MCP_PROXY_TOKEN  — proxy auth token (required for MCP calls)
+ *
+ * CLI flags:
+ *   --acp              — start in ACP agent mode (stdin/stdout ndjson)
+ */
+import { createInterface } from "node:readline";
+import { Readable, Writable } from "node:stream";
+import { AgentSideConnection, ndJsonStream } from "@agentclientprotocol/sdk";
+import { createMcpClient } from "./mcp-client.js";
+import { createAcpAgentFactory } from "./acp-agent.js";
+import { executeCommand } from "./tool-caller.js";
+function parseArgs(argv) {
+    const args = {
+        acpMode: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        if (argv[i] === "--acp") {
+            args.acpMode = true;
+        }
+    }
+    return args;
+}
+// ── REPL Mode ─────────────────────────────────────────────────────────
+async function runRepl(caller) {
+    // Pre-fetch tools for help messages
+    let cachedTools = [];
+    try {
+        cachedTools = await caller.listTools();
+        console.log(`[mcp-agent] ${cachedTools.length} tool(s) available. Type "help" for commands.`);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[mcp-agent] WARNING: Could not list tools: ${msg}`);
+    }
+    console.log('[mcp-agent] Type "list" for available tools, "<tool> <json>" to call, "exit" to quit.');
+    console.log("");
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: "> ",
+    });
+    rl.prompt();
+    rl.on("line", async (line) => {
+        const input = line.trim();
+        if (!input) {
+            rl.prompt();
+            return;
+        }
+        const result = await executeCommand(input, caller, cachedTools);
+        console.log(result.output);
+        if (result.exit) {
+            rl.close();
+            return;
+        }
+        // Refresh cached tools after list command
+        if (input === "list") {
+            try {
+                cachedTools = await caller.listTools();
+            }
+            catch {
+                // Keep existing cache
+            }
+        }
+        rl.prompt();
+    });
+    rl.on("close", () => {
+        process.exit(0);
+    });
+}
+// ── Credential Resolution ─────────────────────────────────────────────
+/**
+ * Connect to the proxy's /connect-agent endpoint to get a session token.
+ * The session token is required for credential_request calls.
+ */
+async function connectAgent(proxyUrl, proxyToken) {
+    const response = await fetch(`${proxyUrl}/connect-agent`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${proxyToken}`,
+            "Content-Type": "application/json",
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`connect-agent failed: ${response.status} ${response.statusText}`);
+    }
+    const body = (await response.json());
+    return body.sessionToken;
+}
+/**
+ * Resolve credentials via the proxy's credential_request MCP tool.
+ * First obtains a session token via /connect-agent, then calls
+ * credential_request for each key.
+ * Retries proxy connection to handle startup timing.
+ */
+async function resolveCredentials(proxyUrl, proxyToken, keys) {
+    const maxRetries = 15;
+    let client = null;
+    let sessionToken = null;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            if (!sessionToken) {
+                sessionToken = await connectAgent(proxyUrl, proxyToken);
+            }
+            client = await createMcpClient({ proxyUrl, proxyToken });
+            break;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (attempt < maxRetries) {
+                console.error(`[mcp-agent] Proxy not ready for credentials (attempt ${attempt}/${maxRetries}): ${msg}`);
+                await new Promise((r) => setTimeout(r, 2000));
+            }
+            else {
+                throw new Error(`Could not connect to proxy after ${maxRetries} attempts: ${msg}`);
+            }
+        }
+    }
+    if (!client)
+        throw new Error("Failed to create MCP client for credential resolution");
+    if (!sessionToken)
+        throw new Error("Failed to obtain session token for credential resolution");
+    const credentials = {};
+    for (const key of keys) {
+        const result = await client.callTool("credential_request", { key, session_token: sessionToken });
+        const text = result.content[0]?.text;
+        if (!text)
+            throw new Error(`No response for credential: ${key}`);
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            throw new Error(`Invalid response for credential ${key}: ${text}`);
+        }
+        if ("error" in parsed) {
+            throw new Error(`Credential ${key}: ${parsed.error}`);
+        }
+        if ("value" in parsed && typeof parsed.value === "string") {
+            credentials[key] = parsed.value;
+        }
+        else {
+            throw new Error(`Unexpected response for credential ${key}`);
+        }
+    }
+    return credentials;
+}
+// ── Main ──────────────────────────────────────────────────────────────
+export async function main(argv) {
+    const cliArgs = parseArgs(argv ?? process.argv.slice(2));
+    // 1. Read proxy config
+    const proxyUrl = process.env.MCP_PROXY_URL ?? "http://localhost:9090";
+    const proxyToken = process.env.MCP_PROXY_TOKEN;
+    // 2. Parse declared credential keys
+    const declaredCredentials = (process.env.AGENT_CREDENTIALS ?? "").trim();
+    let credentialKeys = [];
+    if (declaredCredentials) {
+        try {
+            credentialKeys = JSON.parse(declaredCredentials);
+        }
+        catch { /* ignore parse errors */ }
+    }
+    // 3. Resolve credentials and verify (blocking for non-ACP, deferred for ACP)
+    async function resolveAndVerifyCredentials() {
+        if (credentialKeys.length > 0 && proxyToken) {
+            console.error(`[mcp-agent] Requesting ${credentialKeys.length} credential(s)...`);
+            const creds = await resolveCredentials(proxyUrl, proxyToken, credentialKeys);
+            for (const [key, value] of Object.entries(creds)) {
+                process.env[key] = value;
+            }
+            console.error("[mcp-agent] All credentials received.");
+        }
+        const testToken = process.env.TEST_TOKEN;
+        if (!testToken) {
+            console.error("[mcp-agent] ERROR: TEST_TOKEN not found in environment.");
+            console.error("[mcp-agent] The credential pipeline did not inject TEST_TOKEN.");
+            process.exit(1);
+        }
+        console.error("[mcp-agent] Connected. TEST_TOKEN received.");
+    }
+    let caller = null;
+    // connectToProxy retries MCP session establishment
+    async function connectToProxy() {
+        if (!proxyToken) {
+            console.error("[mcp-agent] MCP_PROXY_TOKEN not set. Running in credential-only mode.");
+            return null;
+        }
+        const maxRetries = 15;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            try {
+                const c = await createMcpClient({ proxyUrl, proxyToken });
+                console.error("[mcp-agent] MCP session established.");
+                return c;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (attempt < maxRetries) {
+                    console.error(`[mcp-agent] Proxy not ready (attempt ${attempt}/${maxRetries}): ${msg}`);
+                    await new Promise((r) => setTimeout(r, 2000));
+                }
+                else {
+                    console.error(`[mcp-agent] WARNING: Could not establish MCP session after ${maxRetries} attempts: ${msg}`);
+                    console.error("[mcp-agent] Tool listing and calling will not work.");
+                }
+            }
+        }
+        return null;
+    }
+    // In ACP mode, use AgentSideConnection on stdin/stdout
+    if (cliArgs.acpMode) {
+        // REQ-SDK-012: Redirect console.log to stderr to protect stdout for ACP ndjson
+        console.log = (...args) => {
+            console.error(...args);
+        };
+        console.error("[mcp-agent] Starting ACP agent on stdin/stdout...");
+        // Create a deferred caller that forwards to the real caller once connected
+        let realCaller = null;
+        const deferredCaller = {
+            async listTools() {
+                if (realCaller)
+                    return realCaller.listTools();
+                return [];
+            },
+            async callTool(name, args) {
+                if (realCaller)
+                    return realCaller.callTool(name, args);
+                throw new Error("MCP session not yet established. Proxy connection in progress.");
+            },
+        };
+        // Session setup: resolve credentials + connect to proxy (called from newSession)
+        let setupDone = false;
+        const onSessionSetup = async () => {
+            if (setupDone)
+                return;
+            setupDone = true;
+            try {
+                await resolveAndVerifyCredentials();
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`[mcp-agent] Credential resolution failed (non-fatal): ${msg}`);
+                console.error("[mcp-agent] ACP agent continues without credentials.");
+            }
+            try {
+                const c = await connectToProxy();
+                if (c)
+                    realCaller = c;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`[mcp-agent] Proxy connection failed (non-fatal): ${msg}`);
+            }
+        };
+        // Create the ACP stream and connection
+        const output = Writable.toWeb(process.stdout);
+        const input = Readable.toWeb(process.stdin);
+        const stream = ndJsonStream(output, input);
+        const connection = new AgentSideConnection(createAcpAgentFactory({ caller: deferredCaller, onSessionSetup }), stream);
+        // Handle graceful shutdown
+        const shutdown = () => {
+            console.error("\n[mcp-agent] Shutting down ACP agent...");
+            process.exit(0);
+        };
+        process.on("SIGTERM", shutdown);
+        process.on("SIGINT", shutdown);
+        // Keep process alive until connection closes
+        await connection.closed;
+        console.error("[mcp-agent] ACP connection closed.");
+    }
+    else {
+        // REPL mode: resolve credentials and connect synchronously before starting
+        await resolveAndVerifyCredentials();
+        caller = await connectToProxy();
+        if (!caller) {
+            caller = {
+                async listTools() { return []; },
+                async callTool() { throw new Error("No MCP session available. Cannot call tools."); },
+            };
+        }
+        await runRepl(caller);
+    }
+}
+// ── Run if executed directly ──────────────────────────────────────────
+const isMain = typeof process !== "undefined" &&
+    process.argv[1] &&
+    (process.argv[1].endsWith("mcp-agent.js") ||
+        process.argv[1].endsWith("/mcp-agent") ||
+        process.argv[1].endsWith("index.js"));
+if (isMain) {
+    main().catch((err) => {
+        console.error("[mcp-agent] Fatal:", err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/materializer.d.ts

@@ -0,0 +1,18 @@
+import type { RuntimeMaterializer, AgentPackage } from "@clawmasons/agent-sdk";
+/**
+ * MCP Agent runtime materializer.
+ *
+ * Generates a minimal workspace directory for the mcp-agent package:
+ * - .mcp.json — MCP server config pointing to chapter-proxy
+ * - AGENTS.md — agent identity and role documentation
+ *
+ * The mcp-agent is a tool-calling REPL/ACP agent, not a full coding
+ * agent, so it does not need slash commands, IDE settings, or extensions.
+ */
+export declare const mcpAgentMaterializer: RuntimeMaterializer;
+/**
+ * Set the parent AgentPackage reference (called during package initialization).
+ * @internal
+ */
+export declare function _setAgentPackage(pkg: AgentPackage): void;
+//# sourceMappingURL=materializer.d.ts.map

package/dist/materializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializer.d.ts","sourceRoot":"","sources":["../src/materializer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAA6C,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAuC1H;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,EAAE,mBA0BlC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAExD"}

package/dist/materializer.js

@@ -1,5 +1,4 @@
 import {
-  generateAgentsMd,
   generateAgentLaunchJson
 } from "@clawmasons/agent-sdk";
 function generateMcpJson(proxyEndpoint, proxyType, proxyToken) {
@@ -28,7 +27,6 @@ const mcpAgentMaterializer = {
       ".mcp.json",
       generateMcpJson(proxyEndpoint, proxyType, proxyToken)
     );
-    result.set("AGENTS.md", generateAgentsMd(agent));
     result.set(
       "agent-launch.json",
       generateAgentLaunchJson(_agentPkg, agent.credentials, options?.acpMode, void 0, options?.agentArgs)

package/dist/materializer.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/materializer.ts"],
-  "sourcesContent": ["import type { ResolvedAgent } from \"@clawmasons/shared\";\nimport type { RuntimeMaterializer, MaterializationResult, MaterializeOptions, AgentPackage } from \"@clawmasons/agent-sdk\";\nimport {\n  generateAgentsMd,\n  generateAgentLaunchJson,\n} from \"@clawmasons/agent-sdk\";\n\n/**\n * Generate .mcp.json content for the mcp-agent.\n *\n * Creates a single \"chapter\" MCP server entry pointing at the proxy's\n * unified endpoint:  /sse  (SSE)  or  /mcp  (streamable-http).\n */\nfunction generateMcpJson(\n  proxyEndpoint: string,\n  proxyType: \"sse\" | \"streamable-http\",\n  proxyToken?: string,\n): string {\n  const pathSuffix = proxyType === \"sse\" ? \"/sse\" : \"/mcp\";\n  const bearerValue = proxyToken\n    ? `Bearer ${proxyToken}`\n    : \"Bearer ${MCP_PROXY_TOKEN}\";\n\n  const mcpConfig = {\n    mcpServers: {\n      chapter: {\n        type: proxyType,\n        url: `${proxyEndpoint}${pathSuffix}`,\n        headers: {\n          Authorization: bearerValue,\n        },\n      },\n    },\n  };\n\n  return JSON.stringify(mcpConfig, null, 2);\n}\n\n/** Reference to the parent AgentPackage \u2014 set after construction. */\nlet _agentPkg: AgentPackage;\n\n/**\n * MCP Agent runtime materializer.\n *\n * Generates a minimal workspace directory for the mcp-agent package:\n * - .mcp.json \u2014 MCP server config pointing to chapter-proxy\n * - AGENTS.md \u2014 agent identity and role documentation\n *\n * The mcp-agent is a tool-calling REPL/ACP agent, not a full coding\n * agent, so it does not need slash commands, IDE settings, or extensions.\n */\nexport const mcpAgentMaterializer: RuntimeMaterializer = {\n  name: \"mcp-agent\",\n\n  materializeWorkspace(\n    agent: ResolvedAgent,\n    proxyEndpoint: string,\n    proxyToken?: string,\n    options?: MaterializeOptions,\n  ): MaterializationResult {\n    const result: MaterializationResult = new Map();\n    const proxyType = agent.proxy?.type ?? \"sse\";\n\n    // .mcp.json \u2014 MCP server config at workspace root\n    result.set(\n      \".mcp.json\",\n      generateMcpJson(proxyEndpoint, proxyType, proxyToken),\n    );\n\n    // AGENTS.md \u2014 agent identity and role documentation\n    result.set(\"AGENTS.md\", generateAgentsMd(agent));\n\n    // agent-launch.json \u2014 tells agent-entry how to bootstrap this agent\n    result.set(\n      \"agent-launch.json\",\n      generateAgentLaunchJson(_agentPkg, agent.credentials, options?.acpMode, undefined, options?.agentArgs),\n    );\n\n    return result;\n  },\n};\n\n/**\n * Set the parent AgentPackage reference (called during package initialization).\n * @internal\n */\nexport function _setAgentPackage(pkg: AgentPackage): void {\n  _agentPkg = pkg;\n}\n"],
-  "mappings": "AAEA;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAQP,SAAS,gBACP,eACA,WACA,YACQ;AACR,QAAM,aAAa,cAAc,QAAQ,SAAS;AAClD,QAAM,cAAc,aAChB,UAAU,UAAU,KACpB;AAEJ,QAAM,YAAY;AAAA,IAChB,YAAY;AAAA,MACV,SAAS;AAAA,QACP,MAAM;AAAA,QACN,KAAK,GAAG,aAAa,GAAG,UAAU;AAAA,QAClC,SAAS;AAAA,UACP,eAAe;AAAA,QACjB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO,KAAK,UAAU,WAAW,MAAM,CAAC;AAC1C;AAGA,IAAI;AAYG,MAAM,uBAA4C;AAAA,EACvD,MAAM;AAAA,EAEN,qBACE,OACA,eACA,YACA,SACuB;AACvB,UAAM,SAAgC,oBAAI,IAAI;AAC9C,UAAM,YAAY,MAAM,OAAO,QAAQ;AAGvC,WAAO;AAAA,MACL;AAAA,MACA,gBAAgB,eAAe,WAAW,UAAU;AAAA,IACtD;AAGA,WAAO,IAAI,aAAa,iBAAiB,KAAK,CAAC;AAG/C,WAAO;AAAA,MACL;AAAA,MACA,wBAAwB,WAAW,MAAM,aAAa,SAAS,SAAS,QAAW,SAAS,SAAS;AAAA,IACvG;AAEA,WAAO;AAAA,EACT;AACF;AAMO,SAAS,iBAAiB,KAAyB;AACxD,cAAY;AACd;",
+  "sourcesContent": ["import type { ResolvedAgent } from \"@clawmasons/shared\";\nimport type { RuntimeMaterializer, MaterializationResult, MaterializeOptions, AgentPackage } from \"@clawmasons/agent-sdk\";\nimport {\n  generateAgentLaunchJson,\n} from \"@clawmasons/agent-sdk\";\n\n/**\n * Generate .mcp.json content for the mcp-agent.\n *\n * Creates a single \"chapter\" MCP server entry pointing at the proxy's\n * unified endpoint:  /sse  (SSE)  or  /mcp  (streamable-http).\n */\nfunction generateMcpJson(\n  proxyEndpoint: string,\n  proxyType: \"sse\" | \"streamable-http\",\n  proxyToken?: string,\n): string {\n  const pathSuffix = proxyType === \"sse\" ? \"/sse\" : \"/mcp\";\n  const bearerValue = proxyToken\n    ? `Bearer ${proxyToken}`\n    : \"Bearer ${MCP_PROXY_TOKEN}\";\n\n  const mcpConfig = {\n    mcpServers: {\n      chapter: {\n        type: proxyType,\n        url: `${proxyEndpoint}${pathSuffix}`,\n        headers: {\n          Authorization: bearerValue,\n        },\n      },\n    },\n  };\n\n  return JSON.stringify(mcpConfig, null, 2);\n}\n\n/** Reference to the parent AgentPackage \u2014 set after construction. */\nlet _agentPkg: AgentPackage;\n\n/**\n * MCP Agent runtime materializer.\n *\n * Generates a minimal workspace directory for the mcp-agent package:\n * - .mcp.json \u2014 MCP server config pointing to chapter-proxy\n * - AGENTS.md \u2014 agent identity and role documentation\n *\n * The mcp-agent is a tool-calling REPL/ACP agent, not a full coding\n * agent, so it does not need slash commands, IDE settings, or extensions.\n */\nexport const mcpAgentMaterializer: RuntimeMaterializer = {\n  name: \"mcp-agent\",\n\n  materializeWorkspace(\n    agent: ResolvedAgent,\n    proxyEndpoint: string,\n    proxyToken?: string,\n    options?: MaterializeOptions,\n  ): MaterializationResult {\n    const result: MaterializationResult = new Map();\n    const proxyType = agent.proxy?.type ?? \"sse\";\n\n    // .mcp.json \u2014 MCP server config at workspace root\n    result.set(\n      \".mcp.json\",\n      generateMcpJson(proxyEndpoint, proxyType, proxyToken),\n    );\n\n    // agent-launch.json \u2014 tells agent-entry how to bootstrap this agent\n    result.set(\n      \"agent-launch.json\",\n      generateAgentLaunchJson(_agentPkg, agent.credentials, options?.acpMode, undefined, options?.agentArgs),\n    );\n\n    return result;\n  },\n};\n\n/**\n * Set the parent AgentPackage reference (called during package initialization).\n * @internal\n */\nexport function _setAgentPackage(pkg: AgentPackage): void {\n  _agentPkg = pkg;\n}\n"],
+  "mappings": "AAEA;AAAA,EACE;AAAA,OACK;AAQP,SAAS,gBACP,eACA,WACA,YACQ;AACR,QAAM,aAAa,cAAc,QAAQ,SAAS;AAClD,QAAM,cAAc,aAChB,UAAU,UAAU,KACpB;AAEJ,QAAM,YAAY;AAAA,IAChB,YAAY;AAAA,MACV,SAAS;AAAA,QACP,MAAM;AAAA,QACN,KAAK,GAAG,aAAa,GAAG,UAAU;AAAA,QAClC,SAAS;AAAA,UACP,eAAe;AAAA,QACjB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO,KAAK,UAAU,WAAW,MAAM,CAAC;AAC1C;AAGA,IAAI;AAYG,MAAM,uBAA4C;AAAA,EACvD,MAAM;AAAA,EAEN,qBACE,OACA,eACA,YACA,SACuB;AACvB,UAAM,SAAgC,oBAAI,IAAI;AAC9C,UAAM,YAAY,MAAM,OAAO,QAAQ;AAGvC,WAAO;AAAA,MACL;AAAA,MACA,gBAAgB,eAAe,WAAW,UAAU;AAAA,IACtD;AAGA,WAAO;AAAA,MACL;AAAA,MACA,wBAAwB,WAAW,MAAM,aAAa,SAAS,SAAS,QAAW,SAAS,SAAS;AAAA,IACvG;AAEA,WAAO;AAAA,EACT;AACF;AAMO,SAAS,iBAAiB,KAAyB;AACxD,cAAY;AACd;",
   "names": []
 }

package/dist/mcp-client.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Lightweight MCP client for the mcp-agent.
+ *
+ * Provides session initialization, tool listing, and tool calling
+ * via the MCP streamable-http protocol over the chapter proxy.
+ */
+import type { ToolCaller } from "./tool-caller.js";
+export interface McpClientConfig {
+    proxyUrl: string;
+    proxyToken: string;
+}
+/**
+ * Create a ToolCaller backed by the MCP streamable-http protocol.
+ *
+ * Initializes an MCP session with the proxy and returns a ToolCaller
+ * interface for listing and calling tools.
+ */
+export declare function createMcpClient(config: McpClientConfig): Promise<ToolCaller>;
+//# sourceMappingURL=mcp-client.d.ts.map

package/dist/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../src/mcp-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAkC,MAAM,kBAAkB,CAAC;AAInF,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAkLD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAalF"}

package/dist/mcp-client.js

@@ -0,0 +1,152 @@
+/**
+ * Lightweight MCP client for the mcp-agent.
+ *
+ * Provides session initialization, tool listing, and tool calling
+ * via the MCP streamable-http protocol over the chapter proxy.
+ */
+// ── Helpers ───────────────────────────────────────────────────────────
+let requestIdCounter = 1;
+const MCP_HEADERS = {
+    "Content-Type": "application/json",
+    Accept: "application/json, text/event-stream",
+};
+/**
+ * Parse an MCP response which may be JSON or SSE (text/event-stream).
+ * SSE responses contain JSON-RPC messages in `data:` lines.
+ */
+async function parseMcpResponse(response) {
+    const contentType = response.headers.get("content-type") ?? "";
+    if (contentType.includes("text/event-stream")) {
+        // Parse SSE to extract JSON-RPC response
+        const text = await response.text();
+        const lines = text.split("\n");
+        let lastData = "";
+        for (const line of lines) {
+            if (line.startsWith("data: ")) {
+                lastData = line.slice(6);
+            }
+        }
+        if (!lastData) {
+            throw new Error("SSE response contained no data events");
+        }
+        return JSON.parse(lastData);
+    }
+    // Standard JSON response
+    return response.json();
+}
+// ── Implementation ────────────────────────────────────────────────────
+async function initializeMcpSession(proxyUrl, proxyToken) {
+    const initResponse = await fetch(`${proxyUrl}/mcp`, {
+        method: "POST",
+        headers: {
+            ...MCP_HEADERS,
+            Authorization: `Bearer ${proxyToken}`,
+        },
+        body: JSON.stringify({
+            jsonrpc: "2.0",
+            id: requestIdCounter++,
+            method: "initialize",
+            params: {
+                protocolVersion: "2025-03-26",
+                capabilities: {},
+                clientInfo: { name: "mcp-agent", version: "1.0.0" },
+            },
+        }),
+    });
+    if (!initResponse.ok) {
+        throw new Error(`MCP initialize failed: ${initResponse.status} ${initResponse.statusText}`);
+    }
+    // Consume the response body (may be JSON or SSE)
+    await parseMcpResponse(initResponse);
+    const mcpSessionId = initResponse.headers.get("mcp-session-id");
+    if (!mcpSessionId) {
+        throw new Error("MCP initialize response missing mcp-session-id header");
+    }
+    // Send initialized notification
+    await fetch(`${proxyUrl}/mcp`, {
+        method: "POST",
+        headers: {
+            ...MCP_HEADERS,
+            Authorization: `Bearer ${proxyToken}`,
+            "mcp-session-id": mcpSessionId,
+        },
+        body: JSON.stringify({
+            jsonrpc: "2.0",
+            method: "notifications/initialized",
+        }),
+    });
+    return mcpSessionId;
+}
+async function mcpListTools(proxyUrl, proxyToken, mcpSessionId) {
+    const id = requestIdCounter++;
+    const response = await fetch(`${proxyUrl}/mcp`, {
+        method: "POST",
+        headers: {
+            ...MCP_HEADERS,
+            Authorization: `Bearer ${proxyToken}`,
+            "mcp-session-id": mcpSessionId,
+        },
+        body: JSON.stringify({
+            jsonrpc: "2.0",
+            id,
+            method: "tools/list",
+            params: {},
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`MCP tools/list failed: ${response.status} ${response.statusText}`);
+    }
+    const body = (await parseMcpResponse(response));
+    if (body.error) {
+        throw new Error(`MCP tools/list error: ${body.error.message}`);
+    }
+    return body.result?.tools ?? [];
+}
+async function mcpCallTool(proxyUrl, proxyToken, mcpSessionId, toolName, args) {
+    const id = requestIdCounter++;
+    const response = await fetch(`${proxyUrl}/mcp`, {
+        method: "POST",
+        headers: {
+            ...MCP_HEADERS,
+            Authorization: `Bearer ${proxyToken}`,
+            "mcp-session-id": mcpSessionId,
+        },
+        body: JSON.stringify({
+            jsonrpc: "2.0",
+            id,
+            method: "tools/call",
+            params: { name: toolName, arguments: args },
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`MCP tool call failed: ${response.status} ${response.statusText}`);
+    }
+    const body = (await parseMcpResponse(response));
+    if (body.error) {
+        throw new Error(`MCP tool error: ${body.error.message}`);
+    }
+    if (!body.result) {
+        throw new Error("MCP tool call returned no result");
+    }
+    return body.result;
+}
+// ── Public API ────────────────────────────────────────────────────────
+/**
+ * Create a ToolCaller backed by the MCP streamable-http protocol.
+ *
+ * Initializes an MCP session with the proxy and returns a ToolCaller
+ * interface for listing and calling tools.
+ */
+export async function createMcpClient(config) {
+    const { proxyUrl, proxyToken } = config;
+    const mcpSessionId = await initializeMcpSession(proxyUrl, proxyToken);
+    return {
+        async listTools() {
+            return mcpListTools(proxyUrl, proxyToken, mcpSessionId);
+        },
+        async callTool(name, args) {
+            return mcpCallTool(proxyUrl, proxyToken, mcpSessionId, name, args);
+        },
+    };
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/mcp-client.js.map

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

package/dist/tool-caller.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Shared tool-calling logic for the MCP agent.
+ *
+ * Provides command parsing, tool invocation, result formatting,
+ * and help generation used by both REPL and ACP modes.
+ */
+export interface ToolDefinition {
+    name: string;
+    description?: string;
+}
+export interface ToolCallResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Abstraction over the MCP client for tool operations.
+ */
+export interface ToolCaller {
+    listTools(): Promise<ToolDefinition[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<ToolCallResult>;
+}
+export type ParsedCommand = {
+    type: "list";
+} | {
+    type: "exit";
+} | {
+    type: "help";
+} | {
+    type: "call";
+    toolName: string;
+    args: Record<string, unknown>;
+} | {
+    type: "error";
+    message: string;
+};
+/**
+ * Parse a user input string into a structured command.
+ *
+ * Recognized commands:
+ * - "list" — list available tools
+ * - "exit" — exit the agent
+ * - "help" — show help message
+ * - "<tool_name>" — call tool with empty args
+ * - "<tool_name> <json>" — call tool with JSON args
+ */
+export declare function parseCommand(input: string): ParsedCommand;
+/**
+ * Format a tool call result for display.
+ */
+export declare function formatResult(result: ToolCallResult): string;
+/**
+ * Generate a help message listing all available tools.
+ */
+export declare function formatHelp(tools: ToolDefinition[]): string;
+/**
+ * Execute a parsed command using the provided tool caller.
+ *
+ * Returns the output string and whether the agent should exit.
+ */
+export declare function executeCommand(input: string, caller: ToolCaller, cachedTools?: ToolDefinition[]): Promise<{
+    output: string;
+    exit: boolean;
+}>;
+//# sourceMappingURL=tool-caller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-caller.d.ts","sourceRoot":"","sources":["../src/tool-caller.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAChF;AAID,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAIvC;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAwCzD;AAID;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAM3D;AAID;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAuB1D;AAID;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,UAAU,EAClB,WAAW,CAAC,EAAE,cAAc,EAAE,GAC7B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAkD5C"}

package/dist/tool-caller.js

@@ -0,0 +1,144 @@
+/**
+ * Shared tool-calling logic for the MCP agent.
+ *
+ * Provides command parsing, tool invocation, result formatting,
+ * and help generation used by both REPL and ACP modes.
+ */
+// ── Command Parsing ───────────────────────────────────────────────────
+/**
+ * Parse a user input string into a structured command.
+ *
+ * Recognized commands:
+ * - "list" — list available tools
+ * - "exit" — exit the agent
+ * - "help" — show help message
+ * - "<tool_name>" — call tool with empty args
+ * - "<tool_name> <json>" — call tool with JSON args
+ */
+export function parseCommand(input) {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        return { type: "help" };
+    }
+    if (trimmed === "list") {
+        return { type: "list" };
+    }
+    if (trimmed === "exit") {
+        return { type: "exit" };
+    }
+    if (trimmed === "help") {
+        return { type: "help" };
+    }
+    // Parse "<tool_name> <json_args>" or "<tool_name>"
+    const spaceIdx = trimmed.indexOf(" ");
+    if (spaceIdx === -1) {
+        return { type: "call", toolName: trimmed, args: {} };
+    }
+    const toolName = trimmed.substring(0, spaceIdx);
+    const argsStr = trimmed.substring(spaceIdx + 1).trim();
+    try {
+        const args = JSON.parse(argsStr);
+        if (typeof args !== "object" || args === null || Array.isArray(args)) {
+            return { type: "error", message: "Arguments must be a JSON object, e.g. {\"key\": \"value\"}" };
+        }
+        return { type: "call", toolName, args };
+    }
+    catch {
+        return {
+            type: "error",
+            message: `Invalid JSON arguments. Usage: ${toolName} {"key": "value"}`,
+        };
+    }
+}
+// ── Result Formatting ─────────────────────────────────────────────────
+/**
+ * Format a tool call result for display.
+ */
+export function formatResult(result) {
+    const text = result.content.map((c) => c.text).join("\n");
+    if (result.isError) {
+        return `Error: ${text}`;
+    }
+    return `Result: ${text}`;
+}
+// ── Help Formatting ───────────────────────────────────────────────────
+/**
+ * Generate a help message listing all available tools.
+ */
+export function formatHelp(tools) {
+    const lines = [];
+    lines.push("[mcp-agent] Available commands:");
+    lines.push("  list                        — List available MCP tools");
+    lines.push("  help                        — Show this help message");
+    lines.push("  <tool_name>                 — Call a tool with no arguments");
+    lines.push('  <tool_name> {"key": "val"}  — Call a tool with JSON arguments');
+    lines.push("  exit                        — Exit the agent");
+    if (tools.length > 0) {
+        lines.push("");
+        lines.push("Available tools:");
+        for (const tool of tools) {
+            const desc = tool.description ? ` — ${tool.description}` : "";
+            lines.push(`  - ${tool.name}${desc}`);
+        }
+    }
+    else {
+        lines.push("");
+        lines.push("No tools available. Use 'list' to refresh.");
+    }
+    return lines.join("\n");
+}
+// ── Command Execution ─────────────────────────────────────────────────
+/**
+ * Execute a parsed command using the provided tool caller.
+ *
+ * Returns the output string and whether the agent should exit.
+ */
+export async function executeCommand(input, caller, cachedTools) {
+    const command = parseCommand(input);
+    switch (command.type) {
+        case "exit":
+            return { output: "[mcp-agent] Goodbye.", exit: true };
+        case "list": {
+            try {
+                const tools = await caller.listTools();
+                if (tools.length === 0) {
+                    return { output: "No tools available.", exit: false };
+                }
+                const lines = ["Available tools:"];
+                for (const tool of tools) {
+                    const desc = tool.description ? ` — ${tool.description}` : "";
+                    lines.push(`  - ${tool.name}${desc}`);
+                }
+                return { output: lines.join("\n"), exit: false };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return { output: `[mcp-agent] Error listing tools: ${msg}`, exit: false };
+            }
+        }
+        case "help": {
+            const tools = cachedTools ?? [];
+            return { output: formatHelp(tools), exit: false };
+        }
+        case "error":
+            return { output: `[mcp-agent] ${command.message}`, exit: false };
+        case "call": {
+            try {
+                const result = await caller.callTool(command.toolName, command.args);
+                return { output: formatResult(result), exit: false };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                // If the tool call fails, show help with available tools
+                if (cachedTools && cachedTools.length > 0) {
+                    return {
+                        output: `[mcp-agent] Error: ${msg}\n\n${formatHelp(cachedTools)}`,
+                        exit: false,
+                    };
+                }
+                return { output: `[mcp-agent] Error: ${msg}`, exit: false };
+            }
+        }
+    }
+}
+//# sourceMappingURL=tool-caller.js.map

package/dist/tool-caller.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawmasons/mcp-agent",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "General-purpose MCP agent with REPL and ACP modes for testing and debugging the chapter proxy pipeline",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,8 +29,8 @@
   "license": "MIT",
   "dependencies": {
     "@agentclientprotocol/sdk": "^0.16.0",
-    "@clawmasons/agent-sdk": "^0.1.1",
-    "@clawmasons/shared": "^0.1.1"
+    "@clawmasons/agent-sdk": "^0.1.3",
+    "@clawmasons/shared": "^0.1.3"
   },
   "devDependencies": {
     "esbuild": "^0.25.0",