palmier 0.6.7 → 0.6.8

package/README.md

@@ -36,6 +36,20 @@ It runs on your machine as a background daemon and connects to a mobile-friendly
 
 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,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/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/run.js

@@ -34,9 +34,6 @@ 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_RUN_DIR: getRunDir(ctx.taskDir, ctx.runId), PALMIER_HTTP_PORT: String(ctx.config.httpPort ?? 9966) },
@@ -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, 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();
     if (typeof body.confirmed !== "boolean") {

package/dist/mcp-handler.js

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

package/dist/mcp-tools.d.ts

@@ -13,10 +13,15 @@ export interface ToolContext {
 }
 export interface ToolDefinition {
     name: string;
-    description: 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

package/dist/mcp-tools.js

@@ -10,7 +10,10 @@ export class ToolError extends Error {
 }
 const notifyTool = {
     name: "notify",
-    description: "Send a push notification to the user's device.",
+    description: [
+        "Send a push notification to the user's device.",
+        'Response: `{"ok": true}` on success.',
+    ],
     inputSchema: {
         type: "object",
         properties: {
@@ -41,7 +44,12 @@ const notifyTool = {
 };
 const requestInputTool = {
     name: "request-input",
-    description: "Request input from the user. The request blocks until the user responds.",
+    description: [
+        "Request input from the user.",
+        "The request blocks until the user responds.",
+        '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.",
+    ],
     inputSchema: {
         type: "object",
         properties: {
@@ -70,16 +78,26 @@ const requestInputTool = {
         });
         const response = await pendingPromise;
         if (response.length === 1 && response[0] === "aborted") {
-            await ctx.publishEvent("_input", { event_type: "input-resolved", host_id: ctx.config.hostId, session_id: ctx.sessionId, status: "aborted" });
+            await ctx.publishEvent("_input", {
+                event_type: "input-resolved", host_id: ctx.config.hostId,
+                session_id: ctx.sessionId, status: "aborted",
+            });
             return { aborted: true };
         }
-        await ctx.publishEvent("_input", { event_type: "input-resolved", host_id: ctx.config.hostId, session_id: ctx.sessionId, status: "provided" });
+        await ctx.publishEvent("_input", {
+            event_type: "input-resolved", host_id: ctx.config.hostId,
+            session_id: ctx.sessionId, status: "provided",
+        });
         return { values: response };
     },
 };
 const requestConfirmationTool = {
     name: "request-confirmation",
-    description: "Request confirmation from the user. The request blocks until the user confirms or aborts.",
+    description: [
+        "Request confirmation from the user.",
+        "The request blocks until the user confirms or aborts.",
+        'Response: `{"confirmed": true}` or `{"confirmed": false}`.',
+    ],
     inputSchema: {
         type: "object",
         properties: {
@@ -112,7 +130,12 @@ const requestConfirmationTool = {
 };
 const deviceGeolocationTool = {
     name: "device-geolocation",
-    description: "Get the GPS location of the user's mobile device. Blocks until the device responds (up to 30 seconds).",
+    description: [
+        "Get the GPS location of the user's mobile device.",
+        "When you need the user's real-time location, use this endpoint.",
+        "Blocks until the device responds (up to 30 seconds).",
+        'Response: `{"latitude": ..., "longitude": ..., "accuracy": ..., "timestamp": ...}` on success, or `{"error": "..."}` on failure.',
+    ],
     inputSchema: {
         type: "object",
         properties: {},
@@ -149,4 +172,47 @@ const deviceGeolocationTool = {
 };
 export const agentTools = [notifyTool, requestInputTool, requestConfirmationTool, deviceGeolocationTool];
 export const agentToolMap = new Map(agentTools.map((t) => [t.name, t]));
+/**
+ * Generate the HTTP Endpoints markdown section for agent-instructions.md from the tool registry.
+ */
+export function generateEndpointDocs(port, taskId) {
+    const baseUrl = `http://localhost:${port}`;
+    const lines = [
+        `The following HTTP endpoints are available during task execution. Use curl to call them.`,
+        "",
+    ];
+    for (const tool of agentTools) {
+        const schema = tool.inputSchema;
+        const props = schema.properties ?? {};
+        const required = new Set(schema.required ?? []);
+        // Build example JSON (body only, no taskId)
+        const example = {};
+        for (const [key, prop] of Object.entries(props)) {
+            if (prop.type === "array")
+                example[key] = ["..."];
+            else
+                example[key] = "...";
+        }
+        const queryUrl = `${baseUrl}/${tool.name}?taskId=${taskId}`;
+        const [header, ...details] = tool.description;
+        lines.push(`**\`POST ${queryUrl}\`** — ${header}`);
+        if (Object.keys(example).length > 0) {
+            lines.push("```json");
+            lines.push(JSON.stringify(example));
+            lines.push("```");
+        }
+        for (const [key, prop] of Object.entries(props)) {
+            const req = required.has(key) ? "required" : "optional";
+            let typeStr = prop.type ?? "unknown";
+            if (prop.type === "array" && prop.items?.type)
+                typeStr = `${prop.items.type} array`;
+            lines.push(`- \`${key}\` (${req}, ${typeStr}): ${prop.description ?? ""}`);
+        }
+        for (const detail of details) {
+            lines.push(`- ${detail}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trimEnd();
+}
 //# sourceMappingURL=mcp-tools.js.map