palmier 1.0.11 → 1.0.13

package/README.md

@@ -57,6 +57,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) |
 | `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.js

@@ -89,7 +89,9 @@ const requestInputTool = {
         });
         const response = await pendingPromise;
         const aborted = response.length === 1 && response[0] === "aborted";
-        recordUserInputToRun(ctx, questions, response, aborted);
+        recordUserResponseToRun(ctx, aborted
+            ? "Aborted"
+            : questions.map((q, i) => `**${q}**\n\n${response[i] ?? ""}`).join("\n\n"));
         if (aborted) {
             await ctx.publishEvent("_input", {
                 event_type: "input-resolved", host_id: ctx.config.hostId,
@@ -112,7 +114,7 @@ const requestInputTool = {
  * agent called via the REST endpoint with taskId); silently skips for pure
  * MCP-protocol sessions where sessionId is a random UUID.
  */
-function recordUserInputToRun(ctx, questions, response, aborted) {
+function recordUserResponseToRun(ctx, content) {
     const taskId = ctx.sessionId;
     if (!taskId)
         return;
@@ -123,9 +125,6 @@ function recordUserInputToRun(ctx, questions, response, aborted) {
     const runId = entries[0]?.run_id;
     if (!runId)
         return;
-    const content = aborted
-        ? "Aborted"
-        : questions.map((q, i) => `**${q}**\n\n${response[i] ?? ""}`).join("\n\n");
     try {
         spliceUserMessage(taskDir, runId, {
             role: "user",
@@ -189,6 +188,67 @@ const requestConfirmationTool = {
         return { confirmed };
     },
 };
+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).",
+        "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.",
+    ],
+    inputSchema: {
+        type: "object",
+        properties: {
+            question: { type: "string", description: "The question to ask" },
+            options: {
+                type: "array",
+                items: { type: "string" },
+                description: 'Unique option labels, in display order (e.g. ["Yes", "No"])',
+                minItems: 2,
+            },
+        },
+        required: ["question", "options"],
+    },
+    async handler(args, ctx) {
+        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 (new Set(options).size !== options.length)
+            throw new ToolError("options must be unique", 400);
+        const pendingPromise = registerPending(ctx.sessionId, "choice", options, {
+            session_id: ctx.sessionId,
+            session_name: ctx.agentName,
+            description: question,
+        });
+        await ctx.publishEvent("_choice", {
+            event_type: "choice-request",
+            host_id: ctx.config.hostId,
+            session_id: ctx.sessionId,
+            session_name: ctx.agentName,
+            description: question,
+            options,
+        });
+        // Clients answer with the option index so no label can collide with the "aborted" sentinel.
+        const response = await pendingPromise;
+        const choice = /^\d+$/.test(response[0] ?? "") ? options[Number(response[0])] : undefined;
+        const aborted = choice === undefined;
+        recordUserResponseToRun(ctx, aborted ? "Aborted" : `**${question}**\n\n${choice}`);
+        await ctx.publishEvent("_choice", {
+            event_type: "choice-resolved",
+            host_id: ctx.config.hostId,
+            session_id: ctx.sessionId,
+            status: aborted ? "aborted" : "chosen",
+        });
+        if (aborted) {
+            await abortSessionTask(ctx);
+            return { aborted: true };
+        }
+        return { choice };
+    },
+};
 const fillPasswordTool = {
     name: "fill-password",
     description: [
@@ -760,7 +820,7 @@ const sendEmailTool = {
         return result;
     },
 };
-export const agentTools = [notifyTool, requestInputTool, requestConfirmationTool, fillPasswordTool, deviceGeolocationTool, readContactsTool, createContactTool, readCalendarTool, createCalendarEventTool, sendSmsTool, sendEmailTool, sendAlarmTool, readBatteryTool, setRingerModeTool];
+export const agentTools = [notifyTool, requestInputTool, requestConfirmationTool, 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/pending-requests.d.ts

@@ -3,7 +3,7 @@ export interface PendingRequestMeta {
     /** Doubles as task_id for permission-type entries (the key the task uses). */
     session_id?: string;
     /** Human-readable label for whoever opened the prompt — agent name for
-     *  confirm/input, task name for permission. */
+     *  confirm/input/choice, task name for permission. */
     session_name?: string;
     description?: string;
     input_questions?: string[];
@@ -11,15 +11,15 @@ export interface PendingRequestMeta {
     secret?: boolean;
 }
 export interface PendingRequest {
-    type: "confirmation" | "permission" | "input";
+    type: "confirmation" | "permission" | "input" | "choice";
     resolve: (value: string[]) => void;
-    /** Permission list (for 'permission') or input descriptions (for 'input'). */
+    /** Permission list (for 'permission'), input descriptions (for 'input'), or option labels (for 'choice'). */
     params?: RequiredPermission[] | string[];
     /** Display context for PWAs that connect while this request is already open. */
     meta?: PendingRequestMeta;
 }
 /**
- * Key is sessionId for confirmation/input, taskId for permission. Only one
+ * Key is sessionId for confirmation/input/choice, taskId for permission. Only one
  * pending request per key at a time. `meta` is surfaced via host.info so a
  * freshly-connected PWA can render the modal without replaying events.
  */

package/dist/pending-requests.js

@@ -1,6 +1,6 @@
 const pending = new Map();
 /**
- * Key is sessionId for confirmation/input, taskId for permission. Only one
+ * Key is sessionId for confirmation/input/choice, taskId for permission. Only one
  * pending request per key at a time. `meta` is surfaced via host.info so a
  * freshly-connected PWA can render the modal without replaying events.
  */