palmier 0.6.6 → 0.6.8

package/README.md

@@ -34,7 +34,21 @@ It runs on your machine as a background daemon and connects to a mobile-friendly
 
 ## How It Works
 
-Palmier runs as a background daemon (systemd on Linux, Task Scheduler on Windows). It invokes your agent CLIs directly, schedules tasks via native OS timers, and exposes an API that the PWA connects to — either directly over HTTP or remotely through a relay server.
+Palmier runs as a background daemon (systemd on Linux, Task Scheduler on Windows). It invokes your agent CLIs directly, schedules tasks via native OS timers, and exposes an API that the PWA connects to — either directly over HTTP or remotely through a relay server. Agents can interact with the user's mobile device during execution — requesting input, sending push notifications, and fetching GPS location.
+
+### MCP Server
+
+Palmier exposes an [MCP](https://modelcontextprotocol.io) server at `http://localhost:<port>/mcp` (streamable HTTP transport). MCP-capable agents can register it to get tool definitions automatically. The same tools are also available as REST endpoints for curl-based agents.
+
+**MCP server URL:** `http://localhost:<port>/mcp`
+
+**Available tools:**
+| Tool | Description |
+|------|-------------|
+| `notify` | Send a push notification to the user's device |
+| `request-input` | Request input from the user (blocks until response) |
+| `request-confirmation` | Request confirmation from the user (blocks until response) |
+| `device-geolocation` | Get GPS location of the user's mobile device |
 
 ```
 ┌──────────────┐         HTTP          ┌──────────────────┐

package/dist/agents/agent-instructions.md

@@ -1,4 +1,4 @@
-You are an AI agent executing a task on behalf of the user via the Palmier platform. Follow these instructions carefully.
+You are an AI agent executing a task on behalf of the user. Follow these instructions carefully.
 
 ## Reporting Output
 
@@ -13,24 +13,16 @@ When you are done, output exactly one of these markers as the very last line (no
 
 ## Permissions
 
-If the task fails because a tool was denied or you lack the required permissions, print each required permission on its own line using this exact format:
+Whenever a tool you are trying to use is denied or you lack the required permissions, print each required permission on its own line using this exact format:
 [PALMIER_PERMISSION] <tool_name> | <description>
 
 ## HTTP Endpoints
 
-The following HTTP endpoints are available at http://localhost:{{PORT}} during task execution. Use curl to call them.
+{{ENDPOINT_DOCS}}
 
-**Requesting user input** — When you need information from the user (credentials, answers to questions, preferences, clarifications, etc.), do not guess, fail, or prompt via stdout, even in a non-interactive environment. Instead, POST to `/request-input` with:
-```json
-{"taskId":"{{TASK_ID}}","descriptions":["question 1","question 2"]}
-```
-The request blocks until the user responds. Response: `{"values":["answer1","answer2"]}` on success, or `{"aborted":true}` if the user declines.
-
-**Sending push notifications** — To notify the user, POST to `/notify` with:
-```json
-{"taskId":"{{TASK_ID}}","title":"...","body":"..."}
-```
+The task to execute follows below:
 
 ---
 
-The task to execute follows below.
+{{TASK_DESCRIPTION}}
+

package/dist/agents/aider.js

@@ -11,7 +11,7 @@ export class Aider {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = [];
         if (yolo) {
             args.push("--yes-always");

package/dist/agents/claude.js

@@ -11,7 +11,7 @@ export class ClaudeAgent {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = ["--permission-mode", yolo ? "bypassPermissions" : "acceptEdits", "-p"];
         if (!yolo) {
             args.push("--allowedTools", "WebFetch");

package/dist/agents/cline.js

@@ -11,7 +11,7 @@ export class Cline {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = [];
         if (yolo) {
             args.push("--yolo");

package/dist/agents/codex.js

@@ -11,7 +11,7 @@ export class CodexAgent {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = ["exec", "--skip-git-repo-check", "--sandbox", yolo ? "danger-full-access" : "workspace-write"];
         if (!yolo) {
             const allPerms = [...(task.frontmatter.permissions ?? []), ...(extraPermissions ?? [])];

package/dist/agents/copilot.js

@@ -11,7 +11,7 @@ export class CopilotAgent {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = ["-p", prompt];
         if (yolo) {
             args.push("--yolo");

package/dist/agents/cursor.js

@@ -11,7 +11,7 @@ export class Cursor {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = [];
         if (yolo) {
             args.push("--force");

package/dist/agents/deepagents.js

@@ -11,7 +11,7 @@ export class DeepAgents {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = [];
         if (yolo) {
             args.push("--auto-approve");

package/dist/agents/droid.js

@@ -11,7 +11,7 @@ export class DroidAgent {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = ["exec", "--session-id", task.frontmatter.id];
         if (yolo) {
             args.push("--skip-permissions-unsafe");

package/dist/agents/gemini.js

@@ -11,7 +11,7 @@ export class GeminiAgent {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = ["--approval-mode", yolo ? "yolo" : "auto_edit"];
         if (!yolo) {
             const tools = ["run_shell_command", "web_fetch"];

package/dist/agents/goose.js

@@ -11,7 +11,7 @@ export class GooseAgent {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = ["run"];
         if (followupPrompt) {
             args.push("--resume");

package/dist/agents/hermes.js

@@ -11,7 +11,7 @@ export class Hermes {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = ["chat"];
         if (yolo) {
             args.push("--trust-all-tools");

package/dist/agents/kimi.js

@@ -11,7 +11,7 @@ export class KimiAgent {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = [];
         if (yolo) {
             args.push("--yolo");

package/dist/agents/kiro.js

@@ -11,7 +11,7 @@ export class Kiro {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = [];
         if (yolo) {
             args.push("--trust-all-tools");

package/dist/agents/openclaw.js

@@ -10,7 +10,7 @@ export class OpenClawAgent {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         // OpenClaw does not support stdin as prompt.
         const args = ["agent", "--local", "--session-id", task.frontmatter.id, "--message", prompt];
         return { command: "openclaw", args };

package/dist/agents/opencode.js

@@ -11,7 +11,7 @@ export class OpenCodeAgent {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = ["run"];
         if (yolo) {
             args.push("--dangerously-skip-permissions");

package/dist/agents/qoder.js

@@ -11,7 +11,7 @@ export class Qoder {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = [];
         if (yolo) {
             args.push("--yolo");

package/dist/agents/qwen.js

@@ -11,7 +11,7 @@ export class QwenAgent {
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
         const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? (getAgentInstructions(task.frontmatter.id, yolo || !this.supportsPermissions) + "\n\n" + (task.body || task.frontmatter.user_prompt));
+        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
         const args = ["--approval-mode", yolo ? "yolo" : "auto-edit"];
         if (followupPrompt) {
             args.push("-c");

package/dist/agents/shared-prompt.d.ts

@@ -1,7 +1,8 @@
+import type { ParsedTask } from "../types.js";
 /**
- * Agent instructions with the serve daemon's HTTP port and task ID baked in.
+ * Build the full agent prompt: instructions + endpoint docs + task description.
  */
-export declare function getAgentInstructions(taskId: string, skipPermissions?: boolean): string;
+export declare function getAgentInstructions(task: ParsedTask, skipPermissions?: boolean): string;
 export declare const TASK_SUCCESS_MARKER = "[PALMIER_TASK_SUCCESS]";
 export declare const TASK_FAILURE_MARKER = "[PALMIER_TASK_FAILURE]";
 export declare const TASK_REPORT_PREFIX = "[PALMIER_REPORT]";

package/dist/agents/shared-prompt.js

@@ -2,16 +2,18 @@ import * as fs from "fs";
 import * as path from "path";
 import { fileURLToPath } from "url";
 import { loadConfig } from "../config.js";
+import { generateEndpointDocs } from "../mcp-tools.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const AGENT_INSTRUCTIONS_TEMPLATE = fs.readFileSync(path.join(__dirname, "agent-instructions.md"), "utf-8");
 /**
- * Agent instructions with the serve daemon's HTTP port and task ID baked in.
+ * Build the full agent prompt: instructions + endpoint docs + task description.
  */
-export function getAgentInstructions(taskId, skipPermissions) {
+export function getAgentInstructions(task, skipPermissions) {
     const port = loadConfig().httpPort ?? 9966;
+    const taskDescription = task.body || task.frontmatter.user_prompt;
     let instructions = AGENT_INSTRUCTIONS_TEMPLATE
-        .replace(/\{\{PORT\}\}/g, String(port))
-        .replace(/\{\{TASK_ID\}\}/g, taskId);
+        .replace(/\{\{ENDPOINT_DOCS\}\}/g, generateEndpointDocs(port, task.frontmatter.id))
+        .replace(/\{\{TASK_DESCRIPTION\}\}/g, taskDescription);
     if (skipPermissions) {
         instructions = instructions.replace(/## Permissions\r?\n[\s\S]*?(?=## |\r?\n---)/m, "");
     }

package/dist/commands/plan-generation.md

@@ -16,6 +16,7 @@ task_name: <concise label, 3-6 words>
 - If the task produces formatted output (report, email, summary, etc.), specify the structure, sections, and tone.
 - When a step requires user input, simply state what information is needed from the user. Do **not** specify how to obtain it — the agent has its own tool for requesting user input.
 - Preserve relative time expressions (e.g., "today", "yesterday", "last week") exactly as written — do **not** resolve them to specific dates. The plan may be executed on a different day than it was generated.
+- If the task involves opening a web browser or application, include a final step to close it before finishing.
 
 ## Task Description
 

package/dist/commands/run.js

@@ -34,12 +34,9 @@ async function invokeAgentWithRetries(ctx, invokeTask) {
             }, 500);
         }
         const { command, args, stdin, env: agentEnv } = ctx.agent.getTaskRunCommandLine(invokeTask, undefined, ctx.task.frontmatter.yolo_mode ? "yolo" : ctx.transientPermissions);
-        const truncate = (s, max = 100) => s.length > max ? s.slice(0, max) + "…" : s;
-        const displayArgs = args.map((a) => truncate(a));
-        console.log(`[invoke] ${command} ${displayArgs.join(" ")}${stdin ? ` (stdin: ${truncate(stdin, 100)})` : ""}`);
         const result = await spawnCommand(command, args, {
             cwd: getRunDir(ctx.taskDir, ctx.runId),
-            env: { ...ctx.guiEnv, ...agentEnv, PALMIER_TASK_ID: ctx.task.frontmatter.id, PALMIER_RUN_DIR: getRunDir(ctx.taskDir, ctx.runId), PALMIER_HTTP_PORT: String(ctx.config.httpPort ?? 9966) },
+            env: { ...ctx.guiEnv, ...agentEnv, PALMIER_RUN_DIR: getRunDir(ctx.taskDir, ctx.runId), PALMIER_HTTP_PORT: String(ctx.config.httpPort ?? 9966) },
             echoStdout: true,
             resolveOnFailure: true,
             stdin,
@@ -261,7 +258,7 @@ async function runCommandTriggeredMode(ctx) {
     await publishHostEvent(ctx.nc, ctx.config.hostId, ctx.taskId, { event_type: "result-updated", run_id: ctx.runId });
     const child = spawnStreamingCommand(commandStr, {
         cwd: getRunDir(ctx.taskDir, ctx.runId),
-        env: { ...ctx.guiEnv, PALMIER_TASK_ID: ctx.task.frontmatter.id, PALMIER_RUN_DIR: getRunDir(ctx.taskDir, ctx.runId), PALMIER_HTTP_PORT: String(ctx.config.httpPort ?? 9966) },
+        env: { ...ctx.guiEnv, PALMIER_RUN_DIR: getRunDir(ctx.taskDir, ctx.runId), PALMIER_HTTP_PORT: String(ctx.config.httpPort ?? 9966) },
     });
     let linesProcessed = 0;
     let invocationsSucceeded = 0;
@@ -421,10 +418,10 @@ async function requestPermission(config, task, taskDir, requiredPermissions) {
 }
 async function requestConfirmation(config, task, taskDir) {
     const port = config.httpPort ?? 9966;
-    const res = await fetch(`http://localhost:${port}/request-confirmation`, {
+    const res = await fetch(`http://localhost:${port}/request-confirmation?taskId=${encodeURIComponent(task.frontmatter.id)}`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ taskId: task.frontmatter.id, taskName: task.frontmatter.name }),
+        body: JSON.stringify({ description: `Run task "${task.frontmatter.name || task.frontmatter.id}"?` }),
     });
     const body = await res.json();
     if (typeof body.confirmed !== "boolean") {

package/dist/location-device.d.ts

@@ -0,0 +1,8 @@
+export interface LocationDevice {
+    clientToken: string;
+    fcmToken: string;
+}
+export declare function getLocationDevice(): LocationDevice | null;
+export declare function setLocationDevice(clientToken: string, fcmToken: string): void;
+export declare function clearLocationDevice(): void;
+//# sourceMappingURL=location-device.d.ts.map

package/dist/location-device.js

@@ -0,0 +1,32 @@
+import * as fs from "fs";
+import * as path from "path";
+import { CONFIG_DIR } from "./config.js";
+const LOCATION_FILE = path.join(CONFIG_DIR, "location-device.json");
+export function getLocationDevice() {
+    try {
+        if (!fs.existsSync(LOCATION_FILE))
+            return null;
+        const raw = fs.readFileSync(LOCATION_FILE, "utf-8");
+        const data = JSON.parse(raw);
+        if (!data.clientToken || !data.fcmToken)
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+export function setLocationDevice(clientToken, fcmToken) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    fs.writeFileSync(LOCATION_FILE, JSON.stringify({ clientToken, fcmToken }, null, 2), "utf-8");
+}
+export function clearLocationDevice() {
+    try {
+        if (fs.existsSync(LOCATION_FILE))
+            fs.unlinkSync(LOCATION_FILE);
+    }
+    catch {
+        // ignore
+    }
+}
+//# sourceMappingURL=location-device.js.map

package/dist/mcp-handler.d.ts

@@ -0,0 +1,8 @@
+import { type ToolContext } from "./mcp-tools.js";
+export interface McpResponse {
+    body: object;
+    sessionId?: string;
+}
+export declare function getAgentName(sessionId: string): string | undefined;
+export declare function handleMcpRequest(body: string, sessionId: string | undefined, ctx: ToolContext): Promise<McpResponse>;
+//# sourceMappingURL=mcp-handler.d.ts.map

package/dist/mcp-handler.js

@@ -0,0 +1,110 @@
+import { randomUUID } from "crypto";
+import { agentTools, agentToolMap, ToolError } from "./mcp-tools.js";
+// Session-to-agent name map with 24h TTL
+const SESSION_TTL_MS = 24 * 60 * 60 * 1000;
+const sessionAgents = new Map();
+export function getAgentName(sessionId) {
+    const entry = sessionAgents.get(sessionId);
+    if (!entry)
+        return undefined;
+    if (Date.now() > entry.expiresAt) {
+        sessionAgents.delete(sessionId);
+        return undefined;
+    }
+    return entry.agentName;
+}
+function pruneExpiredSessions() {
+    const now = Date.now();
+    for (const [id, entry] of sessionAgents) {
+        if (now > entry.expiresAt)
+            sessionAgents.delete(id);
+    }
+}
+function rpcError(id, code, message) {
+    return { jsonrpc: "2.0", id, error: { code, message } };
+}
+function rpcResult(id, result) {
+    return { jsonrpc: "2.0", id, result };
+}
+export async function handleMcpRequest(body, sessionId, ctx) {
+    let req;
+    try {
+        req = JSON.parse(body);
+    }
+    catch {
+        return { body: rpcError(null, -32700, "Parse error") };
+    }
+    const id = req.id ?? null;
+    if (req.jsonrpc !== "2.0") {
+        return { body: rpcError(id, -32600, "Invalid Request: missing jsonrpc 2.0") };
+    }
+    const agent = sessionId ? getAgentName(sessionId) : undefined;
+    const sid = sessionId?.slice(0, 8) ?? "none";
+    const logPrefix = agent ? `[mcp] [${sid}] [${agent}]` : `[mcp] [${sid}]`;
+    console.log(`${logPrefix} ${req.method}${req.method === "tools/call" ? ` → ${req.params?.name}` : ""}`);
+    switch (req.method) {
+        case "initialize": {
+            const newSessionId = randomUUID();
+            const clientInfo = req.params?.clientInfo;
+            const agentName = clientInfo
+                ? `${clientInfo.name || "unknown"}${clientInfo.version ? ` ${clientInfo.version}` : ""}`
+                : undefined;
+            if (agentName) {
+                sessionAgents.set(newSessionId, { agentName, expiresAt: Date.now() + SESSION_TTL_MS });
+                pruneExpiredSessions();
+            }
+            console.log(`[mcp] [${newSessionId.slice(0, 8)}] Session initialized${agentName ? ` (${agentName})` : ""}`);
+            return {
+                body: rpcResult(id, {
+                    protocolVersion: "2025-03-26",
+                    capabilities: { tools: {} },
+                    serverInfo: { name: "palmier", version: "1.0.0" },
+                }),
+                sessionId: newSessionId,
+            };
+        }
+        case "tools/list": {
+            return {
+                body: rpcResult(id, {
+                    tools: agentTools.map((t) => ({
+                        name: t.name,
+                        description: t.description.join(" "),
+                        inputSchema: t.inputSchema,
+                    })),
+                }),
+            };
+        }
+        case "tools/call": {
+            const name = req.params?.name;
+            const args = (req.params?.arguments ?? {});
+            if (!name)
+                return { body: rpcError(id, -32602, "Missing params.name") };
+            const tool = agentToolMap.get(name);
+            if (!tool)
+                return { body: rpcError(id, -32602, `Unknown tool: ${name}`) };
+            try {
+                const result = await tool.handler(args, ctx);
+                console.log(`${logPrefix} tools/call ${name} done:`, JSON.stringify(result).slice(0, 200));
+                return {
+                    body: rpcResult(id, {
+                        content: [{ type: "text", text: JSON.stringify(result) }],
+                    }),
+                };
+            }
+            catch (err) {
+                const message = err instanceof ToolError ? err.message : String(err);
+                console.error(`${logPrefix} tools/call ${name} error:`, message);
+                return {
+                    body: rpcResult(id, {
+                        content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+                        isError: true,
+                    }),
+                };
+            }
+        }
+        default:
+            console.warn(`${logPrefix} Unknown method: ${req.method}`);
+            return { body: rpcError(id, -32601, `Method not found: ${req.method}`) };
+    }
+}
+//# sourceMappingURL=mcp-handler.js.map

package/dist/mcp-tools.d.ts

@@ -0,0 +1,27 @@
+import { type NatsConnection } from "nats";
+import type { HostConfig } from "./types.js";
+export declare class ToolError extends Error {
+    statusCode: number;
+    constructor(message: string, statusCode?: number);
+}
+export interface ToolContext {
+    config: HostConfig;
+    nc: NatsConnection | undefined;
+    publishEvent: (id: string, payload: Record<string, unknown>) => Promise<void>;
+    sessionId: string;
+    agentName?: string;
+}
+export interface ToolDefinition {
+    name: string;
+    /** First line is the summary (used as endpoint header). Remaining lines become bullet points in docs. */
+    description: string[];
+    inputSchema: object;
+    handler: (args: Record<string, unknown>, ctx: ToolContext) => Promise<unknown>;
+}
+export declare const agentTools: ToolDefinition[];
+export declare const agentToolMap: Map<string, ToolDefinition>;
+/**
+ * Generate the HTTP Endpoints markdown section for agent-instructions.md from the tool registry.
+ */
+export declare function generateEndpointDocs(port: number, taskId: string): string;
+//# sourceMappingURL=mcp-tools.d.ts.map