palmier 0.6.7 → 0.6.9

package/palmier-server/spec.md

@@ -12,7 +12,7 @@ The host supports **Linux** (systemd) and **Windows** (Task Scheduler for both d
 
 ### 1.2 Components
 
-* **Host Binary (Node.js):** Runs persistently on the user's host machine as a NATS + HTTP RPC handler. Manages file system operations (task CRUD), OS-level scheduling (systemd), and task generation. Provides a CLI with commands: `palmier init` (provisioning), `palmier pair` (generate pairing code for device pairing), `palmier clients` (manage client tokens), `palmier run <task-id>` (executes a task via the configured agent tool), `palmier uninstall` (stop daemon and remove all scheduled tasks), and `palmier serve` (persistent RPC handler, default command). The `serve` process always starts a local HTTP server (bound to `127.0.0.1` by default, or `0.0.0.0` if LAN mode is enabled) alongside the NATS transport. Localhost-only HTTP endpoints (`/notify`, `/request-input`, `/request-confirmation`, `/request-permission`, `/device-geolocation`) are used by agents and the `palmier run` process for interactive flows via held HTTP connections. `/request-input` and `/notify` are task-independent (no `taskId` required) — input requests use an internal `requestId` for routing. `palmier run` is a short-lived process invoked by systemd. Task execution is abstracted through an `AgentTool` interface (`src/agents/agent.ts`) so different AI CLI tools can be supported — each agent implements `getPlanGenerationCommandLine()`, `getTaskRunCommandLine()`, and `init()`. The task's `agent` field (e.g., `"claude"`) selects which agent is used.
+* **Host Binary (Node.js):** Runs persistently on the user's host machine as a NATS + HTTP RPC handler. Manages file system operations (task CRUD), OS-level scheduling (systemd), and task generation. Provides a CLI with commands: `palmier init` (provisioning), `palmier pair` (generate pairing code for device pairing), `palmier clients` (manage client tokens), `palmier run <task-id>` (executes a task via the configured agent tool), `palmier uninstall` (stop daemon and remove all scheduled tasks), and `palmier serve` (persistent RPC handler, default command). The `serve` process always starts a local HTTP server (bound to `127.0.0.1` by default, or `0.0.0.0` if LAN mode is enabled) alongside the NATS transport. Exposes a localhost-only MCP server at `/mcp` (streamable HTTP transport) with tools: `notify`, `request-input`, `request-confirmation`, `device-geolocation`. The same tools are auto-generated as REST endpoints (`/notify`, `/request-input`, etc.) from a shared tool registry — zero duplication. REST endpoints require `taskId` in the body for session identification. `/request-permission` remains a separate endpoint (not part of the MCP tool registry). MCP sessions track agent names from `initialize` clientInfo for logging and UI display. `palmier run` is a short-lived process invoked by systemd. Task execution is abstracted through an `AgentTool` interface (`src/agents/agent.ts`) so different AI CLI tools can be supported — each agent implements `getPlanGenerationCommandLine()`, `getTaskRunCommandLine()`, and `init()`. The task's `agent` field (e.g., `"claude"`) selects which agent is used.
 
 * **Web Server (Node.js):** Serves the PWA assets (React) via `app.palmier.me` (Cloudflare proxied), manages Web Push VAPID keys, and provides host registration. Uses **PostgreSQL** for persistent storage (host registrations, push subscriptions, FCM tokens). Connects to NATS via TCP to subscribe to `host-event.>` for sending push notifications (confirmations, dismissals, completion/failure). For `POST /api/push/respond` (confirmation responses via push notification action buttons), the Web Server forwards the response to the host via the `task.user_input` NATS RPC. Subscribes to `host.*.push.send` NATS subjects to relay push notification requests from the host CLI. Subscribes to `host.*.fcm.geolocation` to relay device geolocation requests via FCM. Co-located with the NATS server on the same machine.
 

package/src/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,46 +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. All endpoints require `taskId` in the request body.
-
-**`POST /request-input`** — Request input from the user. The request blocks until the user responds.
-```json
-{"taskId": "{{TASK_ID}}", "description": "optional context", "questions": ["question 1", "question 2"]}
-```
-- `taskId` (required, string): The current task ID.
-- `questions` (required, string array): Questions to present to the user.
-- `description` (optional, string): Context or heading for the input request.
-- Response: `{"values": ["answer1", "answer2"]}` on success, or `{"aborted": true}` if the user declines.
-- 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. Use this endpoint instead.
-
-**`POST /request-confirmation`** — Request confirmation from the user. The request blocks until the user confirms or aborts.
-```json
-{"taskId": "{{TASK_ID}}", "description": "What the user is confirming"}
-```
-- `taskId` (required, string): The current task ID.
-- `description` (required, string): What the user is confirming.
-- Response: `{"confirmed": true}` or `{"confirmed": false}`.
-
-**`POST /device-geolocation`** — Get the GPS location of the user's mobile device. Blocks until the device responds (up to 30 seconds).
-```json
-{"taskId": "{{TASK_ID}}"}
-```
-- `taskId` (required, string): The current task ID.
-- Response: `{"latitude": ..., "longitude": ..., "accuracy": ..., "timestamp": ...}` on success, or `{"error": "..."}` on failure.
-
-**`POST /notify`** — Send a push notification to the user's device.
-```json
-{"taskId": "{{TASK_ID}}", "title": "...", "body": "..."}
-```
-- `taskId` (required, string): The current task ID.
-- `title` (required, string): Notification title.
-- `body` (required, string): Notification body.
+{{ENDPOINT_DOCS}}
+
+The task to execute follows below:
 
 ---
 
-The task to execute follows below.
+{{TASK_DESCRIPTION}}
+

package/src/agents/agent.ts

@@ -31,8 +31,8 @@ export interface CommandLine {
  * Abstracts how plans are generated and tasks are executed across different AI agents.
  */
 export interface AgentTool {
-  /** Return the command and args used to generate a plan from a prompt. */
-  getPlanGenerationCommandLine(prompt: string): CommandLine;
+  /** Return the command and args for a short, non-interactive prompt (e.g. generating a task name). */
+  getPromptCommandLine(prompt: string): CommandLine;
 
   /** Return the command and args used to run a task. If followupPrompt is provided, use it instead of the task's prompt,
    *  and treat it as a continuation of the original run (reuse the same session, etc).

package/src/agents/aider.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class Aider implements AgentTool {
   supportsPermissions = false;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "aider",
-      args: ["--message", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "aider", args: ["--message", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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) {

package/src/agents/claude.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class ClaudeAgent implements AgentTool {
   supportsPermissions = true;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "claude",
-      args: ["-p", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "claude", args: ["-p", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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) {

package/src/agents/cline.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class Cline implements AgentTool {
   supportsPermissions = false;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "cline ",
-      args: ["--yolo", "-p", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "cline ", args: ["--yolo", "-p", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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) {

package/src/agents/codex.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class CodexAgent implements AgentTool {
   supportsPermissions = true;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "codex",
-      args: ["exec", "--skip-git-repo-check", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "codex", args: ["exec", "--skip-git-repo-check", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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) {

package/src/agents/copilot.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class CopilotAgent implements AgentTool {
   supportsPermissions = false;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "copilot",
-      args: ["-p", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "copilot", args: ["-p", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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) {

package/src/agents/cursor.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class Cursor implements AgentTool {
   supportsPermissions = false;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "cursor",
-      args: ["-p", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "cursor", args: ["-p", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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) {

package/src/agents/deepagents.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class DeepAgents implements AgentTool {
   supportsPermissions = false;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "deepagents",
-      args: ["--non-interactive", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "deepagents", args: ["--non-interactive", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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) {

package/src/agents/droid.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class DroidAgent implements AgentTool {
   supportsPermissions = false;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "droid",
-      args: ["exec", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "droid", args: ["exec", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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) {

package/src/agents/gemini.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class GeminiAgent implements AgentTool {
   supportsPermissions = true;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "gemini",
-      args: ["--prompt", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "gemini", args: ["--prompt", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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) {

package/src/agents/goose.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class GooseAgent implements AgentTool {
   supportsPermissions = false;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "goose",
-      args: ["run", "--text", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "goose", args: ["run", "--text", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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");} // continue mode for followups

package/src/agents/hermes.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class Hermes implements AgentTool {
   supportsPermissions = false;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "hermes",
-      args: ["chat", "-q", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "hermes", args: ["chat", "-q", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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) {

package/src/agents/kimi.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class KimiAgent implements AgentTool {
   supportsPermissions = false;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "kimi",
-      args: ["-p", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "kimi", args: ["-p", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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) {

package/src/agents/kiro.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class Kiro implements AgentTool {
   supportsPermissions = false;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "kiro-cli",
-      args: ["--no-interactive", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "kiro-cli", args: ["--no-interactive", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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) {

package/src/agents/openclaw.ts

@@ -5,16 +5,13 @@ import { getAgentInstructions } from "./shared-prompt.js";
 
 export class OpenClawAgent implements AgentTool {
   supportsPermissions = false;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "openclaw",
-      args: ["agent", "--local", "--agent", "main", "--message", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "openclaw", args: ["agent", "--local", "--agent", "main", "--message", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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];
 

package/src/agents/opencode.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class OpenCodeAgent implements AgentTool {
   supportsPermissions = false;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "opencode",
-      args: ["run", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "opencode", args: ["run", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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) {

package/src/agents/qoder.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class Qoder implements AgentTool {
   supportsPermissions = false;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "qodercli",
-      args: ["-p", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "qodercli", args: ["-p", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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) {

package/src/agents/qwen.ts

@@ -6,16 +6,13 @@ import { SHELL } from "../platform/index.js";
 
 export class QwenAgent implements AgentTool {
   supportsPermissions = false;
-  getPlanGenerationCommandLine(prompt: string): CommandLine {
-    return {
-      command: "qwen",
-      args: ["-p", prompt],
-    };
+  getPromptCommandLine(prompt: string): CommandLine {
+    return { command: "qwen", args: ["-p", prompt] };
   }
 
   getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine {
     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/src/agents/shared-prompt.ts

@@ -2,6 +2,8 @@ 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";
+import type { ParsedTask } from "../types.js";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -11,13 +13,14 @@ const AGENT_INSTRUCTIONS_TEMPLATE = fs.readFileSync(
 );
 
 /**
- * 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: string, skipPermissions?: boolean): string {
+export function getAgentInstructions(task: ParsedTask, skipPermissions?: boolean): string {
   const port = loadConfig().httpPort ?? 9966;
+  const taskDescription = 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/src/commands/run.ts

@@ -65,9 +65,6 @@ async function invokeAgentWithRetries(
     const { command, args, stdin, env: agentEnv } = ctx.agent.getTaskRunCommandLine(
       invokeTask, undefined, ctx.task.frontmatter.yolo_mode ? "yolo" : ctx.transientPermissions,
     );
-    const truncate = (s: string, 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_RUN_DIR: getRunDir(ctx.taskDir, ctx.runId), PALMIER_HTTP_PORT: String(ctx.config.httpPort ?? 9966) },
@@ -275,7 +272,7 @@ export async function runCommand(taskId: string): Promise<void> {
       await appendAndNotify(ctx, {
         role: "user",
         time: Date.now(),
-        content: task.body || task.frontmatter.user_prompt,
+        content: task.frontmatter.user_prompt,
       });
 
       const result = await invokeAgentWithRetries(ctx, task);
@@ -365,7 +362,6 @@ async function runCommandTriggeredMode(
     const perLinePrompt = `${ctx.task.frontmatter.user_prompt}\n\nProcess this input:\n${line}`;
     const perLineTask: ParsedTask = {
       frontmatter: { ...ctx.task.frontmatter, user_prompt: perLinePrompt },
-      body: "",
     };
 
     const result = await invokeAgentWithRetries(ctx, perLineTask);
@@ -516,10 +512,10 @@ async function requestConfirmation(
   taskDir: string,
 ): Promise<boolean> {
   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, description: `Run task "${task.frontmatter.name || task.frontmatter.id}"?` }),
+    body: JSON.stringify({ description: `Run task "${task.frontmatter.name || task.frontmatter.id}"?` }),
   });
   const body = await res.json() as { confirmed?: boolean; error?: string };
   if (typeof body.confirmed !== "boolean") {

package/src/mcp-handler.ts

@@ -90,7 +90,7 @@ export async function handleMcpRequest(body: string, sessionId: string | undefin
         body: rpcResult(id, {
           tools: agentTools.map((t) => ({
             name: t.name,
-            description: t.description,
+            description: t.description.join(" "),
             inputSchema: t.inputSchema,
           })),
         }),