palmier 0.7.7 → 0.7.9

package/README.md

@@ -8,7 +8,7 @@
 
 You have AI agents on your machine. But you have to sit at your desk to use them. Palmier lets you dispatch, schedule, and monitor them from any device, anywhere.
 
-It runs on your machine as a background daemon and connects to a mobile-friendly PWA, so you can create tasks, approve permissions, and check results without being at your computer.
+It runs on your machine as a background daemon and connects to a mobile-friendly PWA, so you can start one-off sessions, schedule recurring tasks, approve permissions, and check results without being at your computer.
 > **Important:** By using Palmier, you agree to the [Terms of Service](https://www.palmier.me/terms) and [Privacy Policy](https://www.palmier.me/privacy). See the [Disclaimer](#disclaimer) section below.
 
 ## Quick Start

package/dist/agents/agent.d.ts

@@ -22,6 +22,8 @@ export interface AgentTool {
     /** Whether this agent supports permission overrides (e.g. --allowedTools).
      *  If false, the permissions section is omitted from agent instructions. */
     supportsPermissions: boolean;
+    /** Whether this agent supports yolo mode (auto-approve all tools). */
+    supportsYolo: boolean;
     /** Detect whether the agent CLI is available and perform any agent-specific
      *  initialization. Returns true if the agent was detected and initialized successfully. */
     init(): Promise<boolean>;
@@ -30,6 +32,7 @@ export interface DetectedAgent {
     key: string;
     label: string;
     supportsPermissions: boolean;
+    supportsYolo: boolean;
 }
 export declare function detectAgents(): Promise<DetectedAgent[]>;
 export declare function getAgent(name: string): AgentTool;

package/dist/agents/agent.js

@@ -59,7 +59,7 @@ export async function detectAgents() {
         const label = agentLabels[key] ?? key;
         const ok = await agent.init();
         if (ok)
-            detected.push({ key, label, supportsPermissions: agent.supportsPermissions });
+            detected.push({ key, label, supportsPermissions: agent.supportsPermissions, supportsYolo: agent.supportsYolo });
     }
     return detected;
 }

package/dist/agents/aider.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class Aider implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/aider.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class Aider {
     supportsPermissions = false;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "aider", args: ["--message", prompt] };
     }

package/dist/agents/claude.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class ClaudeAgent implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/claude.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class ClaudeAgent {
     supportsPermissions = true;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "claude", args: ["-p", prompt] };
     }

package/dist/agents/cline.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class Cline implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/cline.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class Cline {
     supportsPermissions = false;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "cline ", args: ["--yolo", "-p", prompt] };
     }

package/dist/agents/codex.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class CodexAgent implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/codex.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class CodexAgent {
     supportsPermissions = true;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "codex", args: ["exec", "--skip-git-repo-check", prompt] };
     }

package/dist/agents/copilot.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class CopilotAgent implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/copilot.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class CopilotAgent {
     supportsPermissions = false;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "copilot", args: ["-p", prompt] };
     }

package/dist/agents/cursor.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class Cursor implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/cursor.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class Cursor {
     supportsPermissions = false;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "cursor", args: ["-p", prompt] };
     }

package/dist/agents/deepagents.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class DeepAgents implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/deepagents.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class DeepAgents {
     supportsPermissions = false;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "deepagents", args: ["--non-interactive", prompt] };
     }

package/dist/agents/droid.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class DroidAgent implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/droid.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class DroidAgent {
     supportsPermissions = false;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "droid", args: ["exec", prompt] };
     }

package/dist/agents/gemini.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class GeminiAgent implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/gemini.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class GeminiAgent {
     supportsPermissions = true;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "gemini", args: ["--prompt", prompt] };
     }

package/dist/agents/goose.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class GooseAgent implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/goose.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class GooseAgent {
     supportsPermissions = false;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "goose", args: ["run", "--text", prompt] };
     }

package/dist/agents/hermes.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class Hermes implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/hermes.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class Hermes {
     supportsPermissions = false;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "hermes", args: ["chat", "-q", prompt] };
     }

package/dist/agents/kimi.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class KimiAgent implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/kimi.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class KimiAgent {
     supportsPermissions = false;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "kimi", args: ["-p", prompt] };
     }

package/dist/agents/kiro.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class Kiro implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/kiro.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class Kiro {
     supportsPermissions = false;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "kiro-cli", args: ["--no-interactive", prompt] };
     }

package/dist/agents/openclaw.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class OpenClawAgent implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/openclaw.js

@@ -2,12 +2,12 @@ import { execSync } from "child_process";
 import { getAgentInstructions } from "./shared-prompt.js";
 export class OpenClawAgent {
     supportsPermissions = false;
+    supportsYolo = false;
     getPromptCommandLine(prompt) {
         return { command: "openclaw", args: ["agent", "--local", "--agent", "main", "--message", prompt] };
     }
     getTaskRunCommandLine(task, followupPrompt, extraPermissions) {
-        const yolo = extraPermissions === "yolo";
-        const prompt = followupPrompt ?? getAgentInstructions(task, yolo || !this.supportsPermissions);
+        const prompt = followupPrompt ?? getAgentInstructions(task, true);
         // 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.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class OpenCodeAgent implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/opencode.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class OpenCodeAgent {
     supportsPermissions = false;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "opencode", args: ["run", prompt] };
     }

package/dist/agents/qoder.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class Qoder implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/qoder.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class Qoder {
     supportsPermissions = false;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "qodercli", args: ["-p", prompt] };
     }

package/dist/agents/qwen.d.ts

@@ -2,6 +2,7 @@ import type { ParsedTask, RequiredPermission } from "../types.js";
 import type { AgentTool, CommandLine } from "./agent.js";
 export declare class QwenAgent implements AgentTool {
     supportsPermissions: boolean;
+    supportsYolo: boolean;
     getPromptCommandLine(prompt: string): CommandLine;
     getTaskRunCommandLine(task: ParsedTask, followupPrompt?: string, extraPermissions?: RequiredPermission[] | "yolo"): CommandLine;
     init(): Promise<boolean>;

package/dist/agents/qwen.js

@@ -3,6 +3,7 @@ import { getAgentInstructions } from "./shared-prompt.js";
 import { SHELL } from "../platform/index.js";
 export class QwenAgent {
     supportsPermissions = false;
+    supportsYolo = true;
     getPromptCommandLine(prompt) {
         return { command: "qwen", args: ["-p", prompt] };
     }

package/dist/commands/pair.js

@@ -5,7 +5,7 @@ import { connectNats } from "../nats-client.js";
 import { addClient } from "../client-store.js";
 const CODE_CHARS = "ABCDEFGHJKMNPQRSTUVWXYZ23456789"; // no O/0/I/1/L
 const CODE_LENGTH = 6;
-export const PAIRING_EXPIRY_MS = 5 * 60 * 1000; // 5 minutes
+export const PAIRING_EXPIRY_MS = 60 * 1000; // 1 minute
 export function generatePairingCode() {
     const bytes = new Uint8Array(CODE_LENGTH);
     crypto.getRandomValues(bytes);
@@ -69,7 +69,7 @@ export async function pairCommand() {
     console.log("");
     console.log(`  ${code}`);
     console.log("");
-    console.log("Code expires in 5 minutes.");
+    console.log("Code expires in 1 minute.");
     // NATS pairing (server mode)
     const nc = await connectNats(config);
     const sc = StringCodec();

package/dist/mcp-tools.d.ts

@@ -32,6 +32,8 @@ export interface ResourceDefinition {
     restPath: string;
     /** Return the current resource content. */
     read: () => unknown;
+    /** Register a listener for content changes. Returns an unsubscribe function. */
+    subscribe: (listener: () => void) => () => void;
 }
 export declare const agentResources: ResourceDefinition[];
 export declare const agentResourceMap: Map<string, ResourceDefinition>;

package/dist/mcp-tools.js

@@ -1,8 +1,8 @@
 import { StringCodec } from "nats";
 import { registerPending } from "./pending-requests.js";
 import { getCapabilityDevice } from "./device-capabilities.js";
-import { getNotifications } from "./notification-store.js";
-import { getSmsMessages } from "./sms-store.js";
+import { getNotifications, onNotificationsChanged } from "./notification-store.js";
+import { getSmsMessages, onSmsChanged } from "./sms-store.js";
 export class ToolError extends Error {
     statusCode;
     constructor(message, statusCode = 500) {
@@ -50,7 +50,7 @@ const requestInputTool = {
         "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.",
+        "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 instead.",
     ],
     inputSchema: {
         type: "object",
@@ -69,12 +69,17 @@ const requestInputTool = {
         const { description, questions } = args;
         if (!questions?.length)
             throw new ToolError("questions is required", 400);
-        const pendingPromise = registerPending(ctx.sessionId, "input", questions);
+        const pendingPromise = registerPending(ctx.sessionId, "input", questions, {
+            session_id: ctx.sessionId,
+            session_name: ctx.agentName,
+            description,
+            input_questions: questions,
+        });
         await ctx.publishEvent("_input", {
             event_type: "input-request",
             host_id: ctx.config.hostId,
             session_id: ctx.sessionId,
-            agent_name: ctx.agentName,
+            session_name: ctx.agentName,
             description,
             input_questions: questions,
         });
@@ -111,12 +116,16 @@ const requestConfirmationTool = {
         const { description } = args;
         if (!description)
             throw new ToolError("description is required", 400);
-        const pendingPromise = registerPending(ctx.sessionId, "confirmation");
+        const pendingPromise = registerPending(ctx.sessionId, "confirmation", undefined, {
+            session_id: ctx.sessionId,
+            session_name: ctx.agentName,
+            description,
+        });
         await ctx.publishEvent("_confirm", {
             event_type: "confirm-request",
             host_id: ctx.config.hostId,
             session_id: ctx.sessionId,
-            agent_name: ctx.agentName,
+            session_name: ctx.agentName,
             description,
         });
         const response = await pendingPromise;
@@ -134,7 +143,7 @@ const deviceGeolocationTool = {
     name: "device-geolocation",
     description: [
         "Get the GPS location of the user's mobile device.",
-        "When you need the user's real-time location, use this endpoint.",
+        "When you need the user's real-time location, use this.",
         "Blocks until the device responds (up to 30 seconds).",
         'Response: `{"latitude": ..., "longitude": ..., "accuracy": ..., "timestamp": ...}` on success, or `{"error": "..."}` on failure.',
     ],
@@ -571,7 +580,7 @@ const sendEmailTool = {
     name: "send-email",
     description: [
         "Send an email from the user's mobile device.",
-        "When you need to send an email, use this tool. The email app opens on the device with the draft pre-filled for the user to review and send.",
+        "When you need to send an email, use this. The email app opens on the device with the draft pre-filled for the user to review and send.",
         'Response: `{"ok": true}` on success, or `{"error": "..."}` on failure.',
     ],
     inputSchema: {
@@ -642,6 +651,7 @@ const deviceNotificationsResource = {
     mimeType: "application/json",
     restPath: "/notifications",
     read: getNotifications,
+    subscribe: onNotificationsChanged,
 };
 const deviceSmsResource = {
     uri: "sms-messages://device",
@@ -653,6 +663,7 @@ const deviceSmsResource = {
     mimeType: "application/json",
     restPath: "/sms-messages",
     read: getSmsMessages,
+    subscribe: onSmsChanged,
 };
 export const agentResources = [deviceNotificationsResource, deviceSmsResource];
 export const agentResourceMap = new Map(agentResources.map((r) => [r.uri, r]));

package/dist/pending-requests.d.ts

@@ -1,27 +1,49 @@
 import type { RequiredPermission } from "./types.js";
+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. */
+    session_name?: string;
+    description?: string;
+    input_questions?: string[];
+}
 export interface PendingRequest {
     type: "confirmation" | "permission" | "input";
     resolve: (value: string[]) => void;
     /** Permission list (for 'permission') or input descriptions (for 'input'). */
     params?: RequiredPermission[] | string[];
+    /** Display context for PWAs that connect while this request is already open. */
+    meta?: PendingRequestMeta;
 }
 /**
- * Register a pending request for a task. Returns a Promise that resolves
- * when `resolvePending` is called with the user's response.
- * Only one pending request per task at a time.
+ * Register a pending request keyed by either a sessionId (confirmation / input)
+ * or a taskId (permission). The `meta` is surfaced to PWAs that connect after
+ * the request was opened, so their modals can render without replaying events.
+ * Only one pending request per key at a time.
  */
-export declare function registerPending(taskId: string, type: PendingRequest["type"], params?: PendingRequest["params"]): Promise<string[]>;
+export declare function registerPending(key: string, type: PendingRequest["type"], params?: PendingRequest["params"], meta?: PendingRequestMeta): Promise<string[]>;
 /**
  * Resolve a pending request with the user's response.
  * Returns true if a pending request was found and resolved.
  */
-export declare function resolvePending(taskId: string, value: string[]): boolean;
+export declare function resolvePending(key: string, value: string[]): boolean;
 /**
- * Get the current pending request for a task (if any).
+ * Get the current pending request for a key (if any).
  */
-export declare function getPending(taskId: string): PendingRequest | undefined;
+export declare function getPending(key: string): PendingRequest | undefined;
 /**
  * Remove a pending request without resolving it.
  */
-export declare function removePending(taskId: string): void;
+export declare function removePending(key: string): void;
+/**
+ * List all currently-pending requests, stripped of the unserializable `resolve`
+ * callback. Used by `host.info` so the PWA can seed its modal state on connect.
+ */
+export declare function listPending(): Array<{
+    key: string;
+    type: PendingRequest["type"];
+    params?: PendingRequest["params"];
+    meta?: PendingRequestMeta;
+}>;
 //# sourceMappingURL=pending-requests.d.ts.map

package/dist/pending-requests.js

@@ -1,39 +1,52 @@
 const pending = new Map();
 /**
- * Register a pending request for a task. Returns a Promise that resolves
- * when `resolvePending` is called with the user's response.
- * Only one pending request per task at a time.
+ * Register a pending request keyed by either a sessionId (confirmation / input)
+ * or a taskId (permission). The `meta` is surfaced to PWAs that connect after
+ * the request was opened, so their modals can render without replaying events.
+ * Only one pending request per key at a time.
  */
-export function registerPending(taskId, type, params) {
-    if (pending.has(taskId)) {
-        return Promise.reject(new Error(`Task ${taskId} already has a pending request`));
+export function registerPending(key, type, params, meta) {
+    if (pending.has(key)) {
+        return Promise.reject(new Error(`Key ${key} already has a pending request`));
     }
     return new Promise((resolve) => {
-        pending.set(taskId, { type, resolve, params });
+        pending.set(key, { type, resolve, params, meta });
     });
 }
 /**
  * Resolve a pending request with the user's response.
  * Returns true if a pending request was found and resolved.
  */
-export function resolvePending(taskId, value) {
-    const entry = pending.get(taskId);
+export function resolvePending(key, value) {
+    const entry = pending.get(key);
     if (!entry)
         return false;
-    pending.delete(taskId);
+    pending.delete(key);
     entry.resolve(value);
     return true;
 }
 /**
- * Get the current pending request for a task (if any).
+ * Get the current pending request for a key (if any).
  */
-export function getPending(taskId) {
-    return pending.get(taskId);
+export function getPending(key) {
+    return pending.get(key);
 }
 /**
  * Remove a pending request without resolving it.
  */
-export function removePending(taskId) {
-    pending.delete(taskId);
+export function removePending(key) {
+    pending.delete(key);
+}
+/**
+ * List all currently-pending requests, stripped of the unserializable `resolve`
+ * callback. Used by `host.info` so the PWA can seed its modal state on connect.
+ */
+export function listPending() {
+    return [...pending.entries()].map(([key, entry]) => ({
+        key,
+        type: entry.type,
+        params: entry.params,
+        meta: entry.meta,
+    }));
 }
 //# sourceMappingURL=pending-requests.js.map