@agentdocumentformat/cli 0.8.1 → 0.8.3

package/dist/chunks/{daemon-BVDB565V.mjs → daemon-YHD7PUQI.mjs}

@@ -58,11 +58,15 @@ import {
   wrapper_default
 } from "./chunk-F5ELW46V.mjs";
 import {
+  AskAnswerError,
+  formatAskAnswers,
   formatOwnerCommandRow,
   formatTurnErrorRow,
+  normalizeAskAnswers,
   parseLoopToDisplay,
-  providerContextCategory
-} from "./chunk-7JZXMDDF.mjs";
+  providerContextCategory,
+  summarizeAsk
+} from "./chunk-WPT3FAFX.mjs";
 import {
   AiSdkProvider,
   createClaudeSubscriptionProvider,
@@ -60900,17 +60904,24 @@ var InputSchema24 = external_exports.object({
 };
 
 // src/main/tools/built-in/ask.tool.ts
-var InputSchema25 = external_exports.object({
-  question: external_exports.string().min(1).describe("The question to ask the human operator. Be specific about what you need to proceed.")
+var OptionSchema = external_exports.object({
+  label: external_exports.string().min(1).describe('Short choice text, e.g. "Postgres".'),
+  description: external_exports.string().optional().describe('One line on what picking it means, e.g. "Needs a server; better for concurrent writes".')
+}), QuestionSchema = external_exports.object({
+  question: external_exports.string().min(1).describe("The full question."),
+  options: external_exports.array(OptionSchema).min(1).optional().describe('Choices to pick from. Omit for a free-text answer. "Other" is always offered.'),
+  multiple: external_exports.boolean().optional().describe("Allow picking several options.")
+}), AskInputSchema = external_exports.object({
+  questions: external_exports.array(QuestionSchema).min(1).describe("One or more questions, shown together as a form. The human may skip any of them.")
 }), AskTool = class {
   name = "ask";
-  description = "Ask the human operator a question and wait for their response. The turn pauses until the human replies. In autonomous mode, only use this when critically blocked and cannot proceed without human input.";
-  inputSchema = InputSchema25;
+  description = 'Ask the human operator one or more questions as a form and wait for their answers. The turn pauses until they submit. Free-text question: {"question": "Anything I should avoid?"}. Choice question: {"question": "Which database?", "options": [{"label": "Postgres", "description": "Needs a server"}, {"label": "SQLite", "description": "Single file"}]}. Answers come back as Q:/A: pairs; skipped questions read "(skipped)". In autonomous mode, only use this when critically blocked and cannot proceed without human input.';
+  inputSchema = AskInputSchema;
   category = "general";
   async execute(input, _workspace) {
-    let { question } = input;
+    let { questions } = input;
     return {
-      content: JSON.stringify({ ask_question: question }),
+      content: JSON.stringify({ ask_questions: questions }),
       isError: !1,
       endTurn: !1
     };
@@ -65598,7 +65609,7 @@ var AgentExecutor = class _AgentExecutor extends EventEmitter3 {
       this._lastTargetState = null, this.getState() !== "stopped" && this.abort(), this.emitEvent({ type: "state_changed", payload: { state: "off" }, timestamp: Date.now() });
       return;
     }
-    this.state === "thinking" || this.state === "tool_use" ? this._lastTargetState = targetState : (this.state = "idle", this.cancelScheduledRecovery("state_transition"), this.pendingTriggers = [], this.emitEvent({ type: "state_changed", payload: { state: targetState }, timestamp: Date.now() }));
+    this.state === "thinking" || this.state === "tool_use" || this.state === "awaiting_ask" ? this._lastTargetState = targetState : (this.state = "idle", this.cancelScheduledRecovery("state_transition"), this.pendingTriggers = [], this.emitEvent({ type: "state_changed", payload: { state: targetState }, timestamp: Date.now() }));
   }
   /** Returns pending HIL approval requests so the renderer can restore UI after navigation. */
   getPendingApprovals() {
@@ -65705,16 +65716,17 @@ var AgentExecutor = class _AgentExecutor extends EventEmitter3 {
    * with prose, so the hub row carries no resolve callback and the UI offers
    * "jump to the agent" rather than a verdict.
    */
-  trackPendingAsk(requestId, question, resolve20) {
-    this.pendingAsks.set(requestId, { resolve: resolve20, question }), approvalHub.register({
+  trackPendingAsk(requestId, questions, resolve20) {
+    this.pendingAsks.set(requestId, { resolve: resolve20, questions }), approvalHub.register({
       id: this.notificationKeyFor(requestId),
       kind: "ask",
       requestId,
       filePath: this.approvalFilePath(),
       agentName: this.config.name,
       loop: this.approvalLoopName(),
-      preview: summarizeQuestion(question),
-      question,
+      preview: summarizeQuestion(summarizeAsk(questions)),
+      question: summarizeAsk(questions),
+      questions,
       requestedAt: Date.now()
     });
   }
@@ -65723,7 +65735,7 @@ var AgentExecutor = class _AgentExecutor extends EventEmitter3 {
     let entries = [...this.pendingAsks.entries()];
     this.pendingAsks.clear();
     for (let [requestId, pending] of entries)
-      approvalHub.unregister(this.notificationKeyFor(requestId)), pending.resolve("");
+      approvalHub.unregister(this.notificationKeyFor(requestId)), pending.resolve(pending.questions.map(() => null));
   }
   /**
    * Why an approval prompt is shown and whether "Always approve" is allowed.
@@ -66077,38 +66089,44 @@ var AgentExecutor = class _AgentExecutor extends EventEmitter3 {
   getPendingAsks() {
     let result = [];
     for (let [requestId, pending] of this.pendingAsks)
-      result.push({ requestId, question: pending.question });
+      result.push({ requestId, question: summarizeAsk(pending.questions), questions: pending.questions });
     return result;
   }
   /**
    * Request human input for an ask tool call. Emits an `ask_request`
    * event and pauses the executor until the user responds via `resolveAsk`.
    */
-  requestAsk(question) {
-    let requestId = `ask_${++this.askCounter}`;
-    return this.setState("awaiting_ask"), this.emitEvent({
+  requestAsk(questions) {
+    let requestId = `ask_${++this.askCounter}`, question = summarizeAsk(questions);
+    this.setState("awaiting_ask"), this.emitEvent({
       type: "ask_request",
-      payload: { requestId, question },
+      payload: { requestId, question, questions },
       timestamp: Date.now()
-    }), this.emitRuntimeEvent("ask.requested", { request_id: requestId, question }), new Promise((resolve20) => {
-      this.trackPendingAsk(requestId, question, resolve20);
+    }), this.emitRuntimeEvent("ask.requested", { request_id: requestId, question, questions });
+    let answers = new Promise((resolve20) => {
+      this.trackPendingAsk(requestId, questions, resolve20);
     });
+    return { requestId, answers };
   }
   /**
-   * Resolve a pending ask request. Called from the IPC handler
-   * when the human types an answer.
+   * Resolve a pending ask request with one answer per question (`null` =
+   * skipped). Throws AskAnswerError when the payload does not fit the form;
+   * the ask stays pending.
    */
-  resolveAsk(requestId, answer) {
+  resolveAsk(requestId, answers) {
     let pending = this.pendingAsks.get(requestId);
     if (pending) {
+      let normalized = normalizeAskAnswers(pending.questions, answers);
       this.pendingAsks.delete(requestId), approvalHub.unregister(this.notificationKeyFor(requestId), "answered");
-      let text = typeof answer == "string" ? answer : "";
+      let answered = normalized.filter((a) => a !== null).length, text = answered > 0 ? formatAskAnswers(pending.questions, normalized) : "";
       this.emitRuntimeEvent("ask.resolved", {
         request_id: requestId,
-        has_response: text.length > 0,
+        has_response: answered > 0,
+        answered,
+        skipped: normalized.length - answered,
         response_length: text.length,
-        ...text.length > 0 ? { preview: text.slice(0, 200) } : {}
-      }), pending.resolve(answer);
+        ...text.length > 0 ? { preview: sliceWellFormed(text, 0, 200) } : {}
+      }), pending.resolve(normalized);
     }
   }
   hasPendingSuspend() {
@@ -66678,25 +66696,34 @@ Provider response: ${validation.error}` : "");
               },
               timestamp: Date.now()
             }), toolBlock.name === "ask") {
-              let askInput = toolBlock.input, answer = await this.requestAsk(askInput.question);
+              let parsed = AskInputSchema.safeParse(toolBlock.input);
+              if (!parsed.success) {
+                let content2 = `Invalid ask input: ${parsed.error.issues.map((i) => `${i.path.join(".") || "input"}: ${i.message}`).join("; ")}`;
+                toolResults.push({ type: "tool_result", tool_use_id: toolBlock.id, content: content2, is_error: !0 }), this.emitEvent({
+                  type: "tool_call_result",
+                  payload: { name: "ask", id: toolBlock.id, result: { content: content2, isError: !0 } },
+                  timestamp: Date.now()
+                }), this.emitSyntheticToolEvents("ask", toolBlock.id, toolBlock.input, { content: content2, isError: !0 });
+                continue;
+              }
+              let { questions } = parsed.data, ask = this.requestAsk(questions), answers = await ask.answers;
               if (this._interruptRestart || this._ownerStateTransitionRequested) break;
-              this.setState("tool_use"), toolResults.push({
+              this.setState("tool_use");
+              let content = formatAskAnswers(questions, answers);
+              toolResults.push({
                 type: "tool_result",
                 tool_use_id: toolBlock.id,
-                content: `Human answered: ${answer}`,
+                content,
                 is_error: !1
               }), this.emitEvent({
                 type: "ask_response",
-                payload: { question: askInput.question, answer },
+                payload: { requestId: ask.requestId, result: content },
                 timestamp: Date.now()
               }), this.emitEvent({
                 type: "tool_call_result",
-                payload: { name: "ask", id: toolBlock.id, result: { content: `Human answered: ${answer}`, isError: !1 } },
+                payload: { name: "ask", id: toolBlock.id, result: { content, isError: !1 } },
                 timestamp: Date.now()
-              }), this.emitSyntheticToolEvents("ask", toolBlock.id, toolBlock.input, {
-                content: `Human answered: ${answer}`,
-                isError: !1
-              });
+              }), this.emitSyntheticToolEvents("ask", toolBlock.id, toolBlock.input, { content, isError: !1 });
               continue;
             }
             if (!toolSnapshot.enabledNames.has(toolBlock.name)) {
@@ -70024,7 +70051,7 @@ function urlRecipientError(recipient) {
 }
 
 // src/main/tools/built-in/msg-send.tool.ts
-var InputSchema26 = external_exports.object({
+var InputSchema25 = external_exports.object({
   recipient: external_exports.string().min(1).optional().describe('DID of the recipient agent (e.g., "did:key:..."). Required unless parent_id is provided, in which case the runtime resolves recipient from the inbox message. For adapter recipients use the format "type:id" (e.g., "telegram:123").'),
   address: external_exports.string().url().optional().describe('Delivery URL for mesh recipients (e.g., "http://127.0.0.1:7295/agents/agent-handle/inbox"). Required unless parent_id is provided or sending to an adapter recipient.'),
   content: external_exports.string().min(1).describe("The message content to send."),
@@ -70055,7 +70082,7 @@ function resolveParentReplyAddress(parentMsg) {
 var SendMessageTool = class {
   name = "msg_send";
   description = `Send a message to another agent. Modes: (1) recipient DID + address for direct remote send; (2) parent_id to reply (runtime resolves recipient and address from the inbox row); (3) bare handle with no address \u2014 works only for locally-registered agents on this runtime; the runtime resolves the address from the handle and enforces the recipient's visibility tier. For remote agents, always provide an explicit address from agent_discover. Adapter recipients use "type:id" (e.g. "telegram:123").`;
-  inputSchema = InputSchema26;
+  inputSchema = InputSchema25;
   category = "communication";
   sendFn;
   checkFn;
@@ -70159,7 +70186,7 @@ var SendMessageTool = class {
 };
 
 // src/main/tools/built-in/agent-discover.tool.ts
-var VisibilityEnum = external_exports.enum(["directory", "localhost", "lan", "public", "off"]), InputSchema27 = external_exports.object({
+var VisibilityEnum = external_exports.enum(["directory", "localhost", "lan", "public", "off"]), InputSchema26 = external_exports.object({
   scope: external_exports.enum(["local", "all"]).optional().default("local").describe('Discovery scope. "local" (default) returns only agents on this runtime. "all" also includes remote peers found via mDNS, tailnet sweep, or manual peer entries.'),
   visibility: external_exports.array(VisibilityEnum).optional().describe("If provided, return only agents whose declared visibility tier is in this list."),
   handle: external_exports.string().optional().describe("Optional case-insensitive substring match on the agent handle."),
@@ -70168,7 +70195,7 @@ var VisibilityEnum = external_exports.enum(["directory", "localhost", "lan", "pu
 }), AgentDiscoverTool = class {
   name = "agent_discover";
   description = `Discover agents reachable from this agent. Returns signed agent cards (did, handle, description, endpoints, public_key, policies, visibility, source, runtime_did) plus each local agent's live "status" line \u2014 poll this to watch what peers are working on without messaging them. The visibility tier of each card indicates how broadly the agent is exposed. Filter by visibility tier, handle substring, or description substring. Use scope="local" (default) for same-runtime only; "all" also includes remote peers found via mDNS, tailnet sweep, or manual peer entries \u2014 the source field says which (silently empty when discovery is unavailable).`;
-  inputSchema = InputSchema27;
+  inputSchema = InputSchema26;
   category = "communication";
   getDirectoryFn;
   getRemoteDirectoryFn;
@@ -70314,7 +70341,7 @@ function resolveLoopPool(accessor) {
 }
 
 // src/main/tools/built-in/loop-send.tool.ts
-var LOOP_SEND_MAX_CHARS = 48e3, InputSchema28 = external_exports.object({
+var LOOP_SEND_MAX_CHARS = 48e3, InputSchema27 = external_exports.object({
   to_loop: external_exports.string().min(1).describe(
     'Name of the loop to deliver to, from loop_list. "main" is the membrane-facing loop.'
   ),
@@ -70327,7 +70354,7 @@ var LOOP_SEND_MAX_CHARS = 48e3, InputSchema28 = external_exports.object({
 }), LoopSendTool = class {
   name = "loop_send";
   description = "Send a message to another cognition loop of this same agent. Use loop_list to see the loops and their goals. The message is appended to that loop's stream stamped with your loop name; without wake it is read the next time that loop runs. With wake, an idle target runs a turn immediately and a busy one reads it at its next step, mid-turn. The message stays inside the agent (use msg_send to reach another agent or a person).";
-  inputSchema = InputSchema28;
+  inputSchema = InputSchema27;
   category = "self";
   getPool;
   constructor(getPool) {
@@ -70377,10 +70404,10 @@ var LOOP_SEND_MAX_CHARS = 48e3, InputSchema28 = external_exports.object({
 };
 
 // src/main/tools/built-in/loop-list.tool.ts
-var InputSchema29 = external_exports.object({}), LoopListTool = class {
+var InputSchema28 = external_exports.object({}), LoopListTool = class {
   name = "loop_list";
   description = 'List the cognition loops of this agent \u2014 name, goal, whether each is enabled, and whether it is running right now. Includes "main" (the loop that faces the outside world) and marks which one you are. Use it to pick a target for loop_send.';
-  inputSchema = InputSchema29;
+  inputSchema = InputSchema28;
   category = "self";
   getPool;
   constructor(getPool) {
@@ -70446,7 +70473,7 @@ var LoopConfigInputSchema = external_exports.object({
   tools: external_exports.array(external_exports.string().min(1)).max(LOOP_TOOLS_MAX).optional().describe(
     `Absolute allow-list, intersected with your enabled tools; nothing implicit. Omit for ${DEFAULT_NEW_LOOP_TOOLS.join(" + ")}; [] for a mute loop. Include sys_set_state to yield.`
   )
-}).describe("Loop definition. Full definition for create; partial patch for update."), InputSchema30 = external_exports.object({
+}).describe("Loop definition. Full definition for create; partial patch for update."), InputSchema29 = external_exports.object({
   // No `list`: that is `loop_list`, an ordinary tool you hold like every other
   // loop does. Two ways to enumerate the same roster was one too many.
   action: external_exports.enum(["create", "get", "update", "delete"]).describe(
@@ -70461,7 +70488,7 @@ function errorResult(content) {
 var LoopManageTool = class {
   name = "loop_manage";
   description = "Create, inspect, update and delete this agent's inner cognition loops: named streams inside you that share your file, identity and credentials but run their own stream with their own goal and a subset of your tools. Use loop_list to see which loops exist; this tool changes them. Deleting a loop archives its stream to the audit log first. Only the main loop can call this, and loops cannot create loops.";
-  inputSchema = InputSchema30;
+  inputSchema = InputSchema29;
   category = "self";
   requireApproval = !1;
   getPool;
@@ -70678,7 +70705,7 @@ Excluded for now: ${disabled.join(", ")} \u2014 ${disabled.length === 1 ? "that
 };
 
 // src/main/tools/built-in/ws-connect.tool.ts
-var InputSchema31 = external_exports.object({
+var InputSchema30 = external_exports.object({
   id: external_exports.string().optional().describe("ID of a configured connection to start"),
   url: external_exports.string().url().optional().describe("WebSocket URL for ad-hoc connection"),
   did: external_exports.string().optional().describe("Expected remote DID"),
@@ -70690,7 +70717,7 @@ var InputSchema31 = external_exports.object({
 }), WsConnectTool = class {
   name = "ws_connect";
   description = "Start a WebSocket connection. Either provide an ID of a configured connection, or a URL for an ad-hoc connection.";
-  inputSchema = InputSchema31;
+  inputSchema = InputSchema30;
   category = "communication";
   connectFn;
   getSecurityConfig;
@@ -70725,13 +70752,13 @@ var InputSchema31 = external_exports.object({
 };
 
 // src/main/tools/built-in/ws-disconnect.tool.ts
-var InputSchema32 = external_exports.object({
+var InputSchema31 = external_exports.object({
   connection_id: external_exports.string().optional().describe("Connection ID to close"),
   id: external_exports.string().optional().describe("Config ID to disconnect")
 }), WsDisconnectTool = class {
   name = "ws_disconnect";
   description = "Close a WebSocket connection by connection_id or config id.";
-  inputSchema = InputSchema32;
+  inputSchema = InputSchema31;
   category = "communication";
   disconnectFn;
   constructor(disconnectFn) {
@@ -70754,12 +70781,12 @@ var InputSchema32 = external_exports.object({
 };
 
 // src/main/tools/built-in/ws-connections.tool.ts
-var InputSchema33 = external_exports.object({
+var InputSchema32 = external_exports.object({
   direction: external_exports.enum(["inbound", "outbound"]).optional().describe("Filter by direction")
 }), WsConnectionsTool = class {
   name = "ws_connections";
   description = "List active WebSocket connections (both inbound and outbound).";
-  inputSchema = InputSchema33;
+  inputSchema = InputSchema32;
   category = "communication";
   listFn;
   constructor(listFn) {
@@ -70782,7 +70809,7 @@ var InputSchema33 = external_exports.object({
 };
 
 // src/main/tools/built-in/ws-send.tool.ts
-var InputSchema34 = external_exports.object({
+var InputSchema33 = external_exports.object({
   connection_id: external_exports.string().describe("Target connection ID"),
   data: external_exports.union([
     external_exports.string(),
@@ -70792,7 +70819,7 @@ var InputSchema34 = external_exports.object({
 }), WsSendTool = class {
   name = "ws_send";
   description = "Send text or binary data over an active WebSocket connection. Awaits socket drain when buffered bytes exceed the connection high-water mark.";
-  inputSchema = InputSchema34;
+  inputSchema = InputSchema33;
   category = "communication";
   sendFn;
   constructor(sendFn) {
@@ -70844,7 +70871,7 @@ function umbilicalFilterIsWildcard(filter2) {
   let types = filter2?.event_types;
   return !types || types.length === 0 ? !0 : types.some((t) => t === "*" || t.endsWith(".*"));
 }
-var InputSchema35 = external_exports.object({
+var InputSchema34 = external_exports.object({
   a: EndpointSchema,
   b: EndpointSchema,
   bidirectional: external_exports.boolean().optional(),
@@ -70872,7 +70899,7 @@ var InputSchema35 = external_exports.object({
   manager;
   name = "stream_bind";
   description = "Bind two runtime-managed byte endpoints so bytes are pumped outside the agent loop. Supports WebSocket, TCP, host process, and umbilical source endpoints.";
-  inputSchema = InputSchema35;
+  inputSchema = InputSchema34;
   category = "communication";
   async execute(input, _workspace) {
     let parsed = input;
@@ -70893,7 +70920,7 @@ var InputSchema35 = external_exports.object({
 };
 
 // src/main/tools/built-in/stream-unbind.tool.ts
-var InputSchema36 = external_exports.object({
+var InputSchema35 = external_exports.object({
   binding_id: external_exports.string().min(1)
 }), StreamUnbindTool = class {
   constructor(manager) {
@@ -70902,7 +70929,7 @@ var InputSchema36 = external_exports.object({
   manager;
   name = "stream_unbind";
   description = "Terminate an active stream binding by ID.";
-  inputSchema = InputSchema36;
+  inputSchema = InputSchema35;
   category = "communication";
   async execute(input, _workspace) {
     let parsed = input;
@@ -70923,14 +70950,14 @@ var InputSchema36 = external_exports.object({
 };
 
 // src/main/tools/built-in/stream-bindings.tool.ts
-var InputSchema37 = external_exports.object({}), StreamBindingsTool = class {
+var InputSchema36 = external_exports.object({}), StreamBindingsTool = class {
   constructor(manager) {
     this.manager = manager;
   }
   manager;
   name = "stream_bindings";
   description = "List active stream bindings for this agent, including sanitized endpoint summaries and byte counters.";
-  inputSchema = InputSchema37;
+  inputSchema = InputSchema36;
   category = "communication";
   async execute(_input, _workspace) {
     return { content: JSON.stringify(this.manager.bindingsSummary()), isError: !1 };
@@ -71694,7 +71721,7 @@ function ensureHostWorkspace(agentId) {
 }
 
 // src/main/tools/built-in/fs-transfer.tool.ts
-var Endpoint = external_exports.enum(["vfs", "isolated", "shared", "host"]), InputSchema38 = external_exports.object({
+var Endpoint = external_exports.enum(["vfs", "isolated", "shared", "host"]), InputSchema37 = external_exports.object({
   from: Endpoint.describe("Source environment: 'vfs', 'isolated', 'shared', or 'host'."),
   to: Endpoint.describe("Destination environment: 'vfs', 'isolated', 'shared', or 'host'."),
   path: external_exports.string().describe("Path of the file or directory to transfer (relative to the environment root)."),
@@ -71708,7 +71735,7 @@ var Endpoint = external_exports.enum(["vfs", "isolated", "shared", "host"]), Inp
   capabilities;
   name = "fs_transfer";
   description = "Transfer files or directories between environments: 'vfs' (agent virtual filesystem), 'isolated' (agent container), 'shared' (shared container), or 'host' (host workspace). 'from' and 'to' must differ.";
-  inputSchema = InputSchema38;
+  inputSchema = InputSchema37;
   category = "filesystem";
   async execute(input, workspace) {
     let { from, to, path, save_as } = input, sourcePath, destPath;
@@ -74246,14 +74273,14 @@ function truncate(text, maxBytes) {
 }
 
 // src/main/tools/built-in/chat-info.tool.ts
-var InputSchema39 = external_exports.object({
+var InputSchema38 = external_exports.object({
   adapter: external_exports.string().min(1).describe('Channel adapter type to query: "telegram", "discord", "slack", "whatsapp", ... Must be enabled and connected for this agent.'),
   chat_id: external_exports.string().min(1).describe('Platform chat/channel id \u2014 the source_context.chat_id (or channel_id) from an inbox message. E.g. Telegram "-100123...", Slack "C0123...", WhatsApp "xyz@g.us".'),
   limit: external_exports.number().int().min(1).max(100).optional().describe("Max participants to return (default 50).")
 }), ChatInfoTool = class {
   name = "chat_info";
   description = "Look up a chat/channel you are in via a connected channel adapter: title, description, member roster (truncated), participant count. Read-only. Use when the meta.group context on an inbound message is not enough. Note: Telegram can only list admins; email has no live roster (recipients are in source_context.to/cc via msg_read).";
-  inputSchema = InputSchema39;
+  inputSchema = InputSchema38;
   category = "communication";
   chatInfoFn;
   constructor(chatInfoFn) {
@@ -74527,7 +74554,7 @@ async function writeBackCredentialFiles(store2, serverCfg, target, capturedAt, l
 }
 
 // src/main/tools/built-in/mcp-install.tool.ts
-var InputSchema40 = external_exports.object({
+var InputSchema39 = external_exports.object({
   package: external_exports.string().optional().describe('Package name (npm/pypi) or command path (custom). E.g. "@modelcontextprotocol/server-github", "garmin-mcp", "node"'),
   type: external_exports.enum(["npm", "pypi", "custom", "http"]).default("npm").describe("Package type: npm, pypi, custom, or http"),
   url: external_exports.string().url().optional().describe("Streamable HTTP MCP URL. Required when type=http."),
@@ -74568,7 +74595,7 @@ var McpInstallTool = class {
   getRegistrations;
   name = "mcp_install";
   description = "Install an MCP server package, attach a custom server, or connect a Streamable HTTP MCP server. If the requested name or package is already configured in ADF Studio Settings and available to agents, this tool ATTACHES that registration instead of installing a fresh copy \u2014 the user's configuration, credentials, and authorization come along. Provide package (name or command) for npm/pypi/custom, or url for type=http. Optionally pass env with credential values to store in agent identity, and credential_files for file-shaped credentials (OAuth keys/token stores) that are kept sealed in the keystore and materialized where the server runs. Set host=true to run on host (requires host_access). For an OAuth remote (type=http) that has no stored token yet, attaching it opens a browser for the user to sign in before it connects \u2014 only in the interactive (Studio) runtime; a headless/background runtime instead reports that the user must sign in once from Settings. For the agent's visible persistent browser, prefer the maintained @playwright/mcp package; it attaches to ADF-owned Chromium. New tools are discovered immediately, enabled and visible, and protected by human approval. Use mcp_restart to reconnect if discovery is delayed.";
-  inputSchema = InputSchema40;
+  inputSchema = InputSchema39;
   category = "system";
   /** Find the Settings registration this install request matches, if any. */
   findMatchingRegistration(parsed, derivedName) {
@@ -74837,7 +74864,7 @@ var McpInstallTool = class {
 };
 
 // src/main/tools/built-in/mcp-uninstall.tool.ts
-var InputSchema41 = external_exports.object({
+var InputSchema40 = external_exports.object({
   name: external_exports.string().describe("Name of the MCP server to uninstall")
 }), McpUninstallTool = class {
   constructor(onServerUninstalled) {
@@ -74846,7 +74873,7 @@ var InputSchema41 = external_exports.object({
   onServerUninstalled;
   name = "mcp_uninstall";
   description = "Remove an MCP server from this agent. Removes the server configuration and all associated tool declarations.";
-  inputSchema = InputSchema41;
+  inputSchema = InputSchema40;
   category = "system";
   async execute(input, workspace) {
     let { name: serverName } = input, config = workspace.getAgentConfig(), servers = config.mcp?.servers ?? [], idx = servers.findIndex((s) => s.name === serverName);
@@ -74873,7 +74900,7 @@ var InputSchema41 = external_exports.object({
 };
 
 // src/main/tools/built-in/mcp-restart.tool.ts
-var InputSchema42 = external_exports.object({
+var InputSchema41 = external_exports.object({
   name: external_exports.string().describe("Name of the MCP server to reconnect")
 }), McpRestartTool = class {
   constructor(onServerRestarted) {
@@ -74882,7 +74909,7 @@ var InputSchema42 = external_exports.object({
   onServerRestarted;
   name = "mcp_restart";
   description = "Reconnect an MCP server already configured on this agent and refresh its discovered tools. Use this after installing a server, changing credentials, or when tool discovery returned no tools.";
-  inputSchema = InputSchema42;
+  inputSchema = InputSchema41;
   category = "system";
   async execute(input, workspace) {
     let { name: serverName } = input;
@@ -74960,7 +74987,7 @@ function protectionGatedRegistry(registry2, gate) {
 }
 
 // src/main/tools/shell/shell.tool.ts
-var InputSchema43 = external_exports.object({
+var InputSchema42 = external_exports.object({
   command: external_exports.string().describe("Bash command or pipeline")
 }), ShellTool = class {
   name = "adf_shell";
@@ -74996,7 +75023,7 @@ Execution surfaces \u2014 pick by where the work must run:
 Event context arrives as env vars (\`$EVENT_TYPE\`, \`$MSG_ID\`, \`$TIMER_ID\`, ...) \u2014 \`env\` lists them.
 
 Full guide: ${DOCS_GUIDES_URL}/tools.md`;
-  inputSchema = InputSchema43;
+  inputSchema = InputSchema42;
   category = "system";
   toolRegistry;
   workspace;
@@ -86865,11 +86892,19 @@ var LOOP_PATCH_FIELDS = ["goal", "enabled", "autostart", "autonomous", "model",
     let managed = target.managed, asks = this.askExecutors(managed).flatMap(({ loop, executor }) => executor.getPendingAsks().map((ask) => ({ ...ask, loop })));
     return { agentId: managed.id, asks };
   }
-  /** Request ids are per executor, so `loop` disambiguates; absent = the first loop holding that id. */
-  answerAgentAsk(agentId, requestId, answer, loop) {
+  /**
+   * `answers`: one per question (`null` = skipped); a payload that does not fit the form is a 400 and the ask stays pending.
+   * Request ids are per executor, so `loop` disambiguates; absent = the first loop holding that id.
+   */
+  answerAgentAsk(agentId, requestId, answers, loop) {
     let managed = this.requireAgent(agentId), holder = this.askExecutors(managed).find((entry) => (loop === void 0 || entry.loop === loop) && entry.executor.getPendingAsks().some((ask) => ask.requestId === requestId));
     if (!holder) throw new RuntimeLoopError(`Ask request "${requestId}" not found${loop ? ` in loop "${loop}"` : ""} (already answered, or never asked).`, 404, "ask_not_found");
-    return holder.executor.resolveAsk(requestId, answer), { agentId: managed.id, requestId, loop: holder.loop, answered: !0 };
+    try {
+      holder.executor.resolveAsk(requestId, answers);
+    } catch (err) {
+      throw err instanceof AskAnswerError ? new RuntimeLoopError(`Invalid answers: ${err.message}.`, 400, "invalid_answers") : err;
+    }
+    return { agentId: managed.id, requestId, loop: holder.loop, answered: !0 };
   }
   /**
    * One loop's per-request context breakdown (Studio's context modal; daemon
@@ -99034,7 +99069,7 @@ data: {"cursor":42,"event":{"seq":7,"event_type":"agent.state.changed","turn_id"
           "Tasks & approvals"
         ],
         summary: "Answer an ask request",
-        description: "Request ids are numbered per loop: pass the `loop` from GET \u2026/asks when two loops ask at once; without it the first loop holding the id is answered. An id no loop holds (already answered, or never asked) answers 404 `ask_not_found`.",
+        description: "Answer with one entry per question, in order: a string (free text, or one option label), an array of strings (several picks, for a question with `multiple`), or `null` to skip. A value that is not one of the question's option labels is the human's own (\"Other\") text. Answers that do not fit the form (wrong count, a value that is not a string) answer 400 `invalid_answers` and the ask stays pending. The agent receives `Q: <question>` / `A: <answer>` pairs (`(skipped)` for a skipped question, `Other: <text>` for free text beside options). Request ids are numbered per loop: pass the `loop` from GET \u2026/asks when two loops ask at once; without it the first loop holding the id is answered. An id no loop holds (already answered, or never asked) answers 404 `ask_not_found`.",
         operationId: "answerAgentAsk",
         parameters: [
           {
@@ -99066,7 +99101,22 @@ data: {"cursor":42,"event":{"seq":7,"event_type":"agent.state.changed","turn_id"
             }
           },
           "400": {
-            $ref: "#/components/responses/BadRequest"
+            description: "`answers` missing, not an array, the wrong length, or holding a non-string entry (`invalid_answers`); a bad `loop` (`bad_request`)",
+            content: {
+              "application/json": {
+                schema: {
+                  $ref: "#/components/schemas/ErrorResponse"
+                },
+                examples: {
+                  invalid_answers: {
+                    value: {
+                      error: "Invalid answers: answers has 1 entries but the ask has 2 questions.",
+                      code: "invalid_answers"
+                    }
+                  }
+                }
+              }
+            }
           },
           "401": {
             $ref: "#/components/responses/Unauthorized"
@@ -111681,22 +111731,92 @@ data: {"cursor":13,"kind":"executor","agentId":"\u2026","filePath":"/agents/agen
           skippedProtection: 1
         }
       },
-      AskRespondBody: {
+      AskQuestion: {
         type: "object",
         required: [
-          "answer"
+          "question"
         ],
+        description: 'One question of an ask form. No `options` = free text; with `options` = one pick (several with `multiple`). Free ("Other") text and skipping are always allowed.',
         properties: {
-          answer: {
+          question: {
             type: "string"
           },
+          options: {
+            type: "array",
+            items: {
+              type: "object",
+              required: [
+                "label"
+              ],
+              properties: {
+                label: {
+                  type: "string"
+                },
+                description: {
+                  type: "string"
+                }
+              }
+            }
+          },
+          multiple: {
+            type: "boolean",
+            description: "Several options may be picked"
+          }
+        },
+        example: {
+          question: "Which regions?",
+          options: [
+            {
+              label: "eu-west"
+            },
+            {
+              label: "us-east",
+              description: "Closest to most users"
+            }
+          ],
+          multiple: !0
+        }
+      },
+      AskRespondBody: {
+        type: "object",
+        required: [
+          "answers"
+        ],
+        properties: {
+          answers: {
+            type: "array",
+            description: "One per question, in order: a string, an array of strings (picks), or null (skipped)",
+            items: {
+              oneOf: [
+                {
+                  type: "string"
+                },
+                {
+                  type: "array",
+                  items: {
+                    type: "string"
+                  }
+                },
+                {
+                  type: "null"
+                }
+              ]
+            }
+          },
           loop: {
             type: "string",
             description: "The loop that asked (GET \u2026/asks lists it); absent = the first loop holding the id"
           }
         },
         example: {
-          answer: "Yes, go ahead."
+          answers: [
+            "Yes, go ahead.",
+            [
+              "eu-west",
+              "us-east"
+            ],
+            null
+          ]
         }
       },
       AskRespondResponse: {
@@ -111743,6 +111863,7 @@ data: {"cursor":13,"kind":"executor","agentId":"\u2026","filePath":"/agents/agen
               required: [
                 "requestId",
                 "question",
+                "questions",
                 "loop"
               ],
               properties: {
@@ -111750,7 +111871,15 @@ data: {"cursor":13,"kind":"executor","agentId":"\u2026","filePath":"/agents/agen
                   type: "string"
                 },
                 question: {
-                  type: "string"
+                  type: "string",
+                  description: "One-line summary: the first question, plus how many more"
+                },
+                questions: {
+                  type: "array",
+                  description: "The form; answer with one entry per question",
+                  items: {
+                    $ref: "#/components/schemas/AskQuestion"
+                  }
                 },
                 loop: {
                   type: "string",
@@ -133574,7 +133703,7 @@ function registerApprovalsRoutes(server, ctx) {
     for (let filePath of order) {
       let handle = handles.get(filePath) ?? deriveHandle(filePath), mine = pending.filter((entry) => entry.filePath === filePath);
       for (let ask of mine.filter((entry) => entry.kind === "ask"))
-        out.push({ filePath, handle, type: "ask", requestId: ask.requestId, question: ask.question });
+        out.push({ filePath, handle, type: "ask", requestId: ask.requestId, question: ask.question, questions: ask.questions });
       for (let approval of mine.filter((entry) => entry.kind === "approval"))
         out.push({
           filePath,
@@ -139149,12 +139278,10 @@ function createDaemonHttpApi(runtime2, opts = {}) {
     }
   }), server.get("/agents/:id/asks", async (request, reply) => runtime2.getAgentOrDocument(request.params.id) ? runtime2.getAgentAsks(request.params.id) : notFound3(reply, `Unknown agent "${request.params.id}"`)), server.post("/agents/:id/asks/:requestId/respond", async (request, reply) => {
     if (!runtime2.getAgentOrDocument(request.params.id)) return notFound3(reply, `Unknown agent "${request.params.id}"`);
-    let answer = request.body?.answer;
-    if (typeof answer != "string") return badRequest3(reply, "answer is required");
-    let loop = request.body?.loop;
+    let answers = request.body?.answers, loop = request.body?.loop;
     if (loop !== void 0 && (typeof loop != "string" || !loop)) return badRequest3(reply, "loop must be a non-empty string");
     try {
-      return runtime2.answerAgentAsk(request.params.id, request.params.requestId, answer, loop);
+      return runtime2.answerAgentAsk(request.params.id, request.params.requestId, answers, loop);
     } catch (err) {
       return handleRuntimeError(reply, err);
     }
@@ -141651,7 +141778,7 @@ process.on("uncaughtException", (err) => {
 process.on("unhandledRejection", (reason) => {
   console.error("[ADF Daemon] Unhandled rejection:", reason instanceof Error ? reason.stack : reason);
 });
-var port = Number(process.env.ADF_DAEMON_PORT ?? 7385), host = process.env.ADF_DAEMON_HOST ?? "127.0.0.1", pidFile = process.env.ADF_DAEMON_PIDFILE, settingsPath = process.env.ADF_DAEMON_SETTINGS ?? defaultSettingsPath(), daemonVersion = "0.8.1", startedBy = takeLaunchEnv();
+var port = Number(process.env.ADF_DAEMON_PORT ?? 7385), host = process.env.ADF_DAEMON_HOST ?? "127.0.0.1", pidFile = process.env.ADF_DAEMON_PIDFILE, settingsPath = process.env.ADF_DAEMON_SETTINGS ?? defaultSettingsPath(), daemonVersion = "0.8.3", startedBy = takeLaunchEnv();
 console.log(`[ADF Daemon] Version ${daemonVersion} (pid ${process.pid}, started by ${startedBy})`);
 var settings = new FileSettingsStore(settingsPath);
 processAgentLeases().configure({ kind: "daemon", settingsPath, version: daemonVersion });