palmier 1.1.7 → 1.1.8

package/README.md

@@ -56,8 +56,7 @@ Palmier exposes an [MCP](https://modelcontextprotocol.io) server at `http://loca
 |------|-------------|
 | `notify` | Send a push notification to the user's device |
 | `request-input` | Request input from the user (blocks until response; aborting the prompt aborts the task) |
-| `request-confirmation` | Request confirmation from the user (blocks until response; aborting aborts the task) |
-| `request-choice` | Ask the user a question with a fixed set of options, e.g. Yes/No, and return the one picked (blocks until response; aborting aborts the task) |
+| `request-choice` | Ask the user a question with a fixed set of options and return the one picked; a single option serves as a confirmation (blocks until response; aborting aborts the task) |
 | `fill-password` | Fill a saved password or PIN into the active browser session and submit the form, prompting the user if unknown (the secret is never revealed to the agent) |
 | `device-geolocation` | Get GPS location of the user's mobile device |
 | `read-contacts` | Read the contact list from the user's device |

package/dist/mcp-tools.d.ts

@@ -19,6 +19,7 @@ export interface ToolDefinition {
     inputSchema: object;
     handler: (args: Record<string, unknown>, ctx: ToolContext) => Promise<unknown>;
 }
+export declare const requestConfirmationTool: ToolDefinition;
 export declare const agentTools: ToolDefinition[];
 export declare const agentToolMap: Map<string, ToolDefinition>;
 export interface ResourceDefinition {

package/dist/mcp-tools.js

@@ -145,7 +145,7 @@ async function abortSessionTask(ctx) {
         return;
     await ctx.abortTask(taskId);
 }
-const requestConfirmationTool = {
+export const requestConfirmationTool = {
     name: "request-confirmation",
     description: [
         "Request confirmation from the user.",
@@ -191,10 +191,11 @@ const requestConfirmationTool = {
 const requestChoiceTool = {
     name: "request-choice",
     description: [
-        "Ask the user a question with a fixed set of answers and let them pick one (e.g. Yes/No).",
+        "Ask the user a question with a fixed set of answers and let them pick one.",
         "The request blocks until the user picks an option or aborts the task.",
         'Response: `{"choice": "<option>"}` with the selected option, or `{"aborted": true}` if the user aborts.',
         "Use this instead of request-input whenever the possible answers are known in advance.",
+        "An abort option that ends the task is always shown, so to ask for confirmation before continuing, pass a single option naming the action (e.g. [\"Send email\"]). Add a decline option only if declining should let the task continue differently.",
     ],
     inputSchema: {
         type: "object",
@@ -203,8 +204,8 @@ const requestChoiceTool = {
             options: {
                 type: "array",
                 items: { type: "string" },
-                description: 'Unique option labels, in display order (e.g. ["Yes", "No"])',
-                minItems: 2,
+                description: 'Unique option labels, in display order (e.g. ["Reply now", "Reply later"])',
+                minItems: 1,
             },
         },
         required: ["question", "options"],
@@ -213,8 +214,8 @@ const requestChoiceTool = {
         const { question, options } = args;
         if (!question)
             throw new ToolError("question is required", 400);
-        if (!Array.isArray(options) || options.length < 2 || options.some((o) => typeof o !== "string" || !o.trim())) {
-            throw new ToolError("options must contain at least 2 non-empty strings", 400);
+        if (!Array.isArray(options) || options.length < 1 || options.some((o) => typeof o !== "string" || !o.trim())) {
+            throw new ToolError("options must contain at least 1 non-empty string", 400);
         }
         if (new Set(options).size !== options.length)
             throw new ToolError("options must be unique", 400);
@@ -820,7 +821,7 @@ const sendEmailTool = {
         return result;
     },
 };
-export const agentTools = [notifyTool, requestInputTool, requestConfirmationTool, requestChoiceTool, fillPasswordTool, deviceGeolocationTool, readContactsTool, createContactTool, readCalendarTool, createCalendarEventTool, sendSmsTool, sendEmailTool, sendAlarmTool, readBatteryTool, setRingerModeTool];
+export const agentTools = [notifyTool, requestInputTool, requestChoiceTool, fillPasswordTool, deviceGeolocationTool, readContactsTool, createContactTool, readCalendarTool, createCalendarEventTool, sendSmsTool, sendEmailTool, sendAlarmTool, readBatteryTool, setRingerModeTool];
 export const agentToolMap = new Map(agentTools.map((t) => [t.name, t]));
 const deviceNotificationsResource = {
     uri: "notifications://device",

package/dist/transports/http-transport.js

@@ -7,7 +7,7 @@ import { registerPending } from "../pending-requests.js";
 import * as fs from "node:fs";
 import { saveConfig } from "../config.js";
 import { detectDefaultInterface } from "../network.js";
-import { agentToolMap, agentResources, ToolError } from "../mcp-tools.js";
+import { agentToolMap, agentResources, requestConfirmationTool, ToolError } from "../mcp-tools.js";
 import { handleMcpRequest, getAgentName, getResourceSubscriptions } from "../mcp-handler.js";
 import { getTaskDir } from "../task.js";
 import { popEvent } from "../event-queues.js";
@@ -189,12 +189,13 @@ export async function startHttpTransport(config, handleRpc, port, nc, pairingCod
             }
             return;
         }
-        if (req.method === "POST" && agentToolMap.has(pathname.slice(1))) {
+        const tool = agentToolMap.get(pathname.slice(1))
+            ?? (pathname === `/${requestConfirmationTool.name}` ? requestConfirmationTool : undefined);
+        if (req.method === "POST" && tool) {
             if (!isLocalhost(req)) {
                 sendJson(res, 403, { error: "localhost only" });
                 return;
             }
-            const tool = agentToolMap.get(pathname.slice(1));
             try {
                 const taskId = url.searchParams.get("taskId");
                 if (!taskId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palmier",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "description": "Palmier host CLI - provisions, executes tasks, and serves NATS RPC",
   "license": "Apache-2.0",
   "author": "Hongxu Cai",