@dreb/coding-agent 2.51.0 → 2.52.0

package/docs/rpc.md

@@ -2015,7 +2015,7 @@ Expected response: `extension_ui_response` with `value` (the edited text) or `ca
 
 #### ask
 
-Ask the user a rich clarifying question with Markdown-formatted question text, optional single- or multi-select options, and an optional free-text field. This powers the built-in `ask_user` tool. `options` (2-4 nonblank strings) is optional; `allowFreeText` (default `true`), `multiSelect`, and `multiline` are optional booleans.
+Ask the user one or more rich clarifying questions together as a single wizard. Each question has Markdown-formatted question text, optional single- or multi-select options, and an optional free-text field. This powers the built-in `ask_user` tool. The request carries a `questions` array (1-10 entries); per question, `options` (2-4 nonblank strings) is optional and `allowFreeText` (default `true`), `multiSelect`, and `multiline` are optional booleans. An overall `title` defaults to `"Question"`.
 
 ```json
 {
@@ -2023,11 +2023,20 @@ Ask the user a rich clarifying question with Markdown-formatted question text, o
   "id": "uuid-5",
   "method": "ask",
   "title": "Choose a database",
-  "question": "Which persistence strategy should I use?",
-  "options": ["SQLite", "PostgreSQL", "Keep the JSON file"],
-  "allowFreeText": true,
-  "multiSelect": false,
-  "multiline": false,
+  "questions": [
+    {
+      "question": "Which persistence strategy should I use?",
+      "title": "Storage",
+      "options": ["SQLite", "PostgreSQL", "Keep the JSON file"],
+      "allowFreeText": true,
+      "multiSelect": false,
+      "multiline": false
+    },
+    {
+      "question": "Any migration constraints I should know about?",
+      "multiline": true
+    }
+  ],
   "timeout": 60000,
   "expiresAt": 1785434460000
 }
@@ -2035,12 +2044,21 @@ Ask the user a rich clarifying question with Markdown-formatted question text, o
 
 `timeout` is the original duration in milliseconds. `expiresAt` is the corresponding absolute Unix timestamp in milliseconds; Dashboard clients should use it for the visible countdown so reload, resync, or drill-in recovery does not restart the full duration.
 
-Expected response: `extension_ui_response` with `selected` (an array of strings) and optional string `customText` (the typed answer). Sending `cancelled: true`, or an empty `selected` with no nonblank `customText`, stops the current agent turn rather than continuing without an answer. A timeout has the same stop semantics. Other malformed ask responses are rejected as protocol failures.
+Expected response: `extension_ui_response` with `answers` — an array with one entry per question, in the same order. Each answer has `selected` (an array of strings) and optional string `customText` (the typed answer); an answer with an empty `selected` and no nonblank `customText` is treated as skipped (an explicit `skipped: true` is also honored). Answering submits the batch even when some questions are skipped. Sending `cancelled: true` stops the current agent turn rather than continuing; a timeout has the same stop semantics. A missing/non-array `answers`, or a malformed `selected`/`customText`, is rejected as a protocol failure.
 
 ```json
-{ "type": "extension_ui_response", "id": "uuid-5", "selected": ["SQLite"], "customText": "with WAL enabled" }
+{
+  "type": "extension_ui_response",
+  "id": "uuid-5",
+  "answers": [
+    { "selected": ["SQLite"], "customText": "with WAL enabled" },
+    { "selected": [], "skipped": true }
+  ]
+}
 ```
 
+`ask` requests are single-flight per RPC runtime. If parallel tool execution starts several calls concurrently, RPC emits only the first request and queues the rest in FIFO order. The next request is emitted only after the active request settles; a queued call that is aborted before it starts settles without emitting. Hosts therefore need to render at most one pending `ask` wizard at a time.
+
 #### notify
 
 Display a notification. Fire-and-forget, no response expected.

package/examples/extensions/rpc-demo.ts

@@ -10,6 +10,7 @@
  * - confirm() - on session_before_switch
  * - input() - via /rpc-input command
  * - editor() - via /rpc-editor command
+ * - ask() - via /rpc-ask command
  * - notify() - after each dialog completes
  * - setStatus() - on turn_start/turn_end
  * - setWidget() - on session_start
@@ -112,6 +113,34 @@ export default function (dreb: ExtensionAPI) {
 		},
 	});
 
+	// -- batch ask wizard via command --
+
+	dreb.registerCommand("rpc-ask", {
+		description: "Open a batch question wizard (demonstrates ctx.ui.ask in RPC)",
+		handler: async (_args, ctx) => {
+			const result = await ctx.ui.ask({
+				title: "Configure the RPC demo",
+				questions: [
+					{
+						question: "Which **transport checks** should run?",
+						title: "Checks",
+						options: ["Protocol", "Reconnect", "Timeout"],
+						multiSelect: true,
+						allowFreeText: true,
+					},
+					{
+						question: "Anything else the RPC host should display?",
+						title: "Notes",
+						multiline: true,
+					},
+				],
+			});
+			if (!result) return;
+			const answered = result.answers.filter((answer) => !answer.skipped).length;
+			ctx.ui.notify(`Submitted ${answered} of ${result.answers.length} answers`, "info");
+		},
+	});
+
 	// -- setEditorText via command --
 
 	dreb.registerCommand("rpc-prefill", {

package/examples/rpc-extension-ui.ts

@@ -3,15 +3,16 @@
  *
  * A lightweight TUI chat client that spawns the agent in RPC mode.
  * Demonstrates how to build a custom UI on top of the RPC protocol,
- * including handling extension UI requests (select, confirm, input, editor).
+ * including handling extension UI requests (select, confirm, input, editor, ask).
  *
  * Usage: npx tsx examples/rpc-extension-ui.ts
  *
  * Slash commands:
- *   /select  - demo select dialog
- *   /confirm - demo confirm dialog
- *   /input   - demo input dialog
- *   /editor  - demo editor dialog
+ *   /select   - demo select dialog
+ *   /confirm  - demo confirm dialog
+ *   /input    - demo input dialog
+ *   /editor   - demo editor dialog
+ *   /rpc-ask  - demo batch ask wizard from the companion extension
  */
 
 import { spawn } from "node:child_process";
@@ -39,12 +40,28 @@ const RESET = "\x1b[0m";
 // Extension UI request type (subset of rpc-types.ts)
 // ============================================================================
 
+interface AskQuestion {
+	question: string;
+	title?: string;
+	options?: string[];
+	allowFreeText?: boolean;
+	multiSelect?: boolean;
+	multiline?: boolean;
+}
+
+interface AskAnswer {
+	selected: string[];
+	customText?: string;
+	skipped?: boolean;
+}
+
 interface ExtensionUIRequest {
 	type: "extension_ui_request";
 	id: string;
 	method: string;
 	title?: string;
 	options?: string[];
+	questions?: AskQuestion[];
 	message?: string;
 	placeholder?: string;
 	prefill?: string;
@@ -239,6 +256,98 @@ class InputDialog implements Component {
 	}
 }
 
+/**
+ * Compact batch-question wizard for the RPC example. Each page accepts option
+ * numbers and optional free text separated by commas, then sends one ordered
+ * answers[] response after the final question.
+ */
+class AskDialog implements Component {
+	private readonly input = new Input();
+	private readonly answers: AskAnswer[] = [];
+	private questionIndex = 0;
+	onSubmit?: (answers: AskAnswer[]) => void;
+	onCancel?: () => void;
+	onCtrlD?: () => void;
+
+	constructor(
+		private readonly title: string,
+		private readonly questions: AskQuestion[],
+	) {
+		this.input.onSubmit = (value) => this.acceptAnswer(value);
+		this.input.onEscape = () => this.onCancel?.();
+	}
+
+	private acceptAnswer(value: string): void {
+		const question = this.questions[this.questionIndex];
+		if (!question) return;
+		const raw = value.trim();
+		const options = question.options ?? [];
+		const selected: string[] = [];
+		const customParts: string[] = [];
+
+		if (options.length === 0) {
+			if (raw) customParts.push(raw);
+		} else if (raw) {
+			for (const token of raw
+				.split(",")
+				.map((part) => part.trim())
+				.filter(Boolean)) {
+				const numericIndex = /^\d+$/.test(token) ? Number(token) - 1 : -1;
+				const matched =
+					options[numericIndex] ?? options.find((option) => option.toLowerCase() === token.toLowerCase());
+				if (matched && (question.multiSelect || selected.length === 0)) {
+					if (!selected.includes(matched)) selected.push(matched);
+				} else if (!matched && question.allowFreeText !== false) {
+					customParts.push(token);
+				}
+			}
+		}
+
+		const customText = customParts.join(", ").trim() || undefined;
+		this.answers.push(selected.length > 0 || customText ? { selected, customText } : { selected: [], skipped: true });
+		this.questionIndex++;
+		if (this.questionIndex >= this.questions.length) {
+			this.onSubmit?.(this.answers);
+			return;
+		}
+		this.input.setValue("");
+	}
+
+	handleInput(data: string): void {
+		if (matchesKey(data, "ctrl+d")) {
+			this.onCtrlD?.();
+			return;
+		}
+		this.input.handleInput(data);
+	}
+
+	invalidate(): void {
+		this.input.invalidate();
+	}
+
+	render(width: number): string[] {
+		const question = this.questions[this.questionIndex];
+		if (!question) return [`${RED}Invalid empty ask request${RESET}`];
+		const options = question.options ?? [];
+		const optionLines = options.map((option, index) => `  ${index + 1}. ${option}`);
+		const answerHint =
+			options.length === 0
+				? "Type an answer"
+				: question.multiSelect
+					? "Type option numbers separated by commas"
+					: "Type one option number";
+		const customHint = options.length > 0 && question.allowFreeText !== false ? ", plus optional text" : "";
+		return [
+			`${MAGENTA}${BOLD}${this.title} — ${this.questionIndex + 1}/${this.questions.length}${RESET}`,
+			`${BOLD}${question.title ?? question.question}${RESET}`,
+			...(question.title ? [question.question] : []),
+			...optionLines,
+			...this.input.render(width),
+			`${DIM}${answerHint}${customHint}. Enter to continue, Esc to cancel.${RESET}`,
+		];
+	}
+}
+
 // ============================================================================
 // Main
 // ============================================================================
@@ -300,6 +409,7 @@ async function main() {
 	// These helpers swap between them.
 
 	let activeDialog: Component | null = null;
+	let activeDialogId: string | null = null;
 
 	function setBottomComponent(component: Component): void {
 		root.clear();
@@ -312,6 +422,7 @@ async function main() {
 
 	function showPrompt(): void {
 		activeDialog = null;
+		activeDialogId = null;
 		setBottomComponent(promptInput);
 		tui.setFocus(promptInput.input);
 	}
@@ -374,8 +485,27 @@ async function main() {
 		tui.setFocus(dialog.inputComponent);
 	}
 
+	function showAskDialog(
+		title: string,
+		questions: AskQuestion[],
+		onDone: (answers: AskAnswer[] | undefined) => void,
+	): void {
+		const dialog = new AskDialog(title, questions);
+		dialog.onSubmit = (answers) => {
+			showPrompt();
+			onDone(answers);
+		};
+		dialog.onCancel = () => {
+			showPrompt();
+			onDone(undefined);
+		};
+		dialog.onCtrlD = exit;
+		showDialog(dialog);
+	}
+
 	function handleExtensionUI(req: ExtensionUIRequest): void {
 		const { id, method } = req;
+		if (["select", "confirm", "input", "editor", "ask"].includes(method)) activeDialogId = id;
 
 		switch (method) {
 			// Dialog methods: replace prompt with interactive component
@@ -422,6 +552,23 @@ async function main() {
 				break;
 			}
 
+			case "ask": {
+				const questions = req.questions ?? [];
+				if (questions.length === 0) {
+					showPrompt();
+					send({ type: "extension_ui_response", id, cancelled: true });
+					break;
+				}
+				showAskDialog(req.title ?? "Question", questions, (answers) => {
+					if (answers) {
+						send({ type: "extension_ui_response", id, answers });
+					} else {
+						send({ type: "extension_ui_response", id, cancelled: true });
+					}
+				});
+				break;
+			}
+
 			// Fire-and-forget methods: display as notification
 			case "notify": {
 				const notifyType = (req.notifyType as string) ?? "info";
@@ -450,6 +597,10 @@ async function main() {
 				break;
 			}
 
+			case "setTitle":
+				terminal.setTitle(req.title ?? "");
+				break;
+
 			case "set_editor_text":
 				promptInput.input.setValue((req.text as string) ?? "");
 				tui.requestRender();
@@ -535,6 +686,11 @@ async function main() {
 			return;
 		}
 
+		if (data.type === "extension_ui_response_handled") {
+			if (data.id === activeDialogId) showPrompt();
+			return;
+		}
+
 		if (data.type === "message_update") {
 			const evt = data.assistantMessageEvent as Record<string, unknown> | undefined;
 			if (evt?.type === "text_delta") {
@@ -620,7 +776,7 @@ async function main() {
 
 	outputLog.append(`${BOLD}RPC Chat${RESET}`);
 	outputLog.append(`${DIM}Type a message and press Enter. Esc to abort or exit. Ctrl+D to quit.${RESET}`);
-	outputLog.append(`${DIM}Slash commands: /select /confirm /input /editor${RESET}`);
+	outputLog.append(`${DIM}Slash commands: /select /confirm /input /editor /rpc-ask${RESET}`);
 	outputLog.append("");
 
 	tui.start();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@dreb/coding-agent",
-	"version": "2.51.0",
+	"version": "2.52.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"drebConfig": {

package/dist/modes/interactive/components/ask-user.d.ts

@@ -1,59 +0,0 @@
-/**
- * ask_user question component.
- *
- * Renders a clarifying question with optional single- or multi-select options
- * and an optional free-text field, matching the approved cross-surface design.
- *
- * Keyboard model (settled in issue 396 discussion):
- *   ↑/↓        move a single cursor through the options and, last, the free-text field
- *   Space      toggle the highlighted checkbox (multi-select only)
- *   Enter      single-select: pick the highlighted option and submit;
- *              free-text field: submit the typed answer;
- *              multi-select: submit all checked options plus any free text
- *   Shift+Enter insert a newline in the multiline free-text field
- *   Esc        stop the current agent turn
- */
-import { Container, type Focusable, type TUI } from "@dreb/tui";
-import type { AskRequest, AskResult } from "../../../core/extensions/types.js";
-export interface AskUserComponentOptions {
-    tui?: TUI;
-    timeout?: number;
-}
-export declare class AskUserComponent extends Container implements Focusable {
-    private options;
-    private allowFreeText;
-    private multiSelect;
-    private multiline;
-    /** Cursor over [options..., freeTextRow?]. */
-    private cursorIndex;
-    /** Checkbox state for multi-select, aligned to options. */
-    private checked;
-    private onSubmitCallback;
-    private onStopCallback;
-    private titleText;
-    private baseTitle;
-    private optionsContainer;
-    private fieldLabel;
-    private input;
-    private editor;
-    private countdown;
-    private submitted;
-    private _focused;
-    get focused(): boolean;
-    set focused(value: boolean);
-    private get freeTextRow();
-    private get lastRow();
-    private cursorOnField;
-    constructor(request: AskRequest, onSubmit: (result: AskResult) => void, onStop: () => void, opts?: AskUserComponentOptions);
-    private buildHint;
-    private renderRows;
-    private syncFieldFocus;
-    private moveCursor;
-    private fieldText;
-    private currentAnswer;
-    private submit;
-    private stop;
-    handleInput(keyData: string): void;
-    dispose(): void;
-}
-//# sourceMappingURL=ask-user.d.ts.map

package/dist/modes/interactive/components/ask-user.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ask-user.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/components/ask-user.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAU,KAAK,SAAS,EAAiD,KAAK,GAAG,EAAE,MAAM,WAAW,CAAC;AACvH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAM/E,MAAM,WAAW,uBAAuB;IACvC,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,gBAAiB,SAAQ,SAAU,YAAW,SAAS;IACnE,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,SAAS,CAAU;IAE3B,8CAA8C;IAC9C,OAAO,CAAC,WAAW,CAAK;IACxB,2DAA2D;IAC3D,OAAO,CAAC,OAAO,CAAY;IAE3B,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,cAAc,CAAa;IAEnC,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAY;IACpC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,QAAQ,CAAS;IACzB,IAAI,OAAO,IAAI,OAAO,CAErB;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAGzB;IAED,OAAO,KAAK,WAAW,GAEtB;IAED,OAAO,KAAK,OAAO,GAElB;IAED,OAAO,CAAC,aAAa;IAIrB,YACC,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,EACrC,MAAM,EAAE,MAAM,IAAI,EAClB,IAAI,CAAC,EAAE,uBAAuB,EA8D9B;IAED,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,IAAI;IAMZ,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CA8CjC;IAED,OAAO,IAAI,IAAI,CAEd;CACD","sourcesContent":["/**\n * ask_user question component.\n *\n * Renders a clarifying question with optional single- or multi-select options\n * and an optional free-text field, matching the approved cross-surface design.\n *\n * Keyboard model (settled in issue 396 discussion):\n *   ↑/↓        move a single cursor through the options and, last, the free-text field\n *   Space      toggle the highlighted checkbox (multi-select only)\n *   Enter      single-select: pick the highlighted option and submit;\n *              free-text field: submit the typed answer;\n *              multi-select: submit all checked options plus any free text\n *   Shift+Enter insert a newline in the multiline free-text field\n *   Esc        stop the current agent turn\n */\n\nimport { Container, Editor, type Focusable, getKeybindings, Input, Markdown, Spacer, Text, type TUI } from \"@dreb/tui\";\nimport type { AskRequest, AskResult } from \"../../../core/extensions/types.js\";\nimport { getEditorTheme, getMarkdownTheme, theme } from \"../theme/theme.js\";\nimport { CountdownTimer } from \"./countdown-timer.js\";\nimport { DynamicBorder } from \"./dynamic-border.js\";\nimport { keyHint, rawKeyHint } from \"./keybinding-hints.js\";\n\nexport interface AskUserComponentOptions {\n\ttui?: TUI;\n\ttimeout?: number;\n}\n\nexport class AskUserComponent extends Container implements Focusable {\n\tprivate options: string[];\n\tprivate allowFreeText: boolean;\n\tprivate multiSelect: boolean;\n\tprivate multiline: boolean;\n\n\t/** Cursor over [options..., freeTextRow?]. */\n\tprivate cursorIndex = 0;\n\t/** Checkbox state for multi-select, aligned to options. */\n\tprivate checked: boolean[];\n\n\tprivate onSubmitCallback: (result: AskResult) => void;\n\tprivate onStopCallback: () => void;\n\n\tprivate titleText: Text;\n\tprivate baseTitle: string;\n\tprivate optionsContainer: Container;\n\tprivate fieldLabel: Text | undefined;\n\tprivate input: Input | undefined;\n\tprivate editor: Editor | undefined;\n\tprivate countdown: CountdownTimer | undefined;\n\tprivate submitted = false;\n\n\tprivate _focused = false;\n\tget focused(): boolean {\n\t\treturn this._focused;\n\t}\n\tset focused(value: boolean) {\n\t\tthis._focused = value;\n\t\tthis.syncFieldFocus();\n\t}\n\n\tprivate get freeTextRow(): number {\n\t\treturn this.allowFreeText ? this.options.length : -1;\n\t}\n\n\tprivate get lastRow(): number {\n\t\treturn this.allowFreeText ? this.options.length : this.options.length - 1;\n\t}\n\n\tprivate cursorOnField(): boolean {\n\t\treturn this.allowFreeText && this.cursorIndex === this.freeTextRow;\n\t}\n\n\tconstructor(\n\t\trequest: AskRequest,\n\t\tonSubmit: (result: AskResult) => void,\n\t\tonStop: () => void,\n\t\topts?: AskUserComponentOptions,\n\t) {\n\t\tsuper();\n\n\t\tthis.options = request.options ?? [];\n\t\tthis.allowFreeText = request.allowFreeText !== false;\n\t\tthis.multiSelect = request.multiSelect === true && this.options.length > 0;\n\t\tthis.multiline = request.multiline === true;\n\t\tthis.checked = this.options.map(() => false);\n\t\tthis.onSubmitCallback = onSubmit;\n\t\tthis.onStopCallback = onStop;\n\t\tthis.baseTitle = request.title?.trim() || \"Question\";\n\n\t\t// Start the cursor on the first option, or the free-text field when there\n\t\t// are no options.\n\t\tthis.cursorIndex = this.options.length > 0 ? 0 : this.freeTextRow;\n\n\t\tthis.addChild(new DynamicBorder());\n\t\tthis.addChild(new Spacer(1));\n\n\t\tthis.titleText = new Text(theme.fg(\"accent\", theme.bold(this.baseTitle)), 1, 0);\n\t\tthis.addChild(this.titleText);\n\t\tthis.addChild(new Spacer(1));\n\n\t\tthis.addChild(new Markdown(request.question, 1, 0, getMarkdownTheme(), undefined, true));\n\t\tthis.addChild(new Spacer(1));\n\n\t\tif (opts?.timeout && opts.timeout > 0 && opts.tui) {\n\t\t\tthis.countdown = new CountdownTimer(\n\t\t\t\topts.timeout,\n\t\t\t\topts.tui,\n\t\t\t\t(s) => this.titleText.setText(theme.fg(\"accent\", theme.bold(`${this.baseTitle} (${s}s)`))),\n\t\t\t\t() => this.stop(),\n\t\t\t);\n\t\t}\n\n\t\tthis.optionsContainer = new Container();\n\t\tthis.addChild(this.optionsContainer);\n\n\t\tif (this.allowFreeText) {\n\t\t\tthis.addChild(new Spacer(1));\n\t\t\tthis.fieldLabel = new Text(\"\", 1, 0);\n\t\t\tthis.addChild(this.fieldLabel);\n\t\t\tif (this.multiline && opts?.tui) {\n\t\t\t\tthis.editor = new Editor(opts.tui, getEditorTheme(), {});\n\t\t\t\t// The Editor clears its own state before invoking onSubmit, so we must\n\t\t\t\t// use the text it hands us rather than re-reading the now-empty editor.\n\t\t\t\tthis.editor.onSubmit = (text) => this.submit(text);\n\t\t\t\tthis.addChild(this.editor);\n\t\t\t} else {\n\t\t\t\tthis.input = new Input();\n\t\t\t\tthis.addChild(this.input);\n\t\t\t}\n\t\t}\n\n\t\tthis.addChild(new Spacer(1));\n\t\tthis.addChild(new Text(this.buildHint(), 1, 0));\n\t\tthis.addChild(new Spacer(1));\n\t\tthis.addChild(new DynamicBorder());\n\n\t\tthis.renderRows();\n\t\tthis.syncFieldFocus();\n\t}\n\n\tprivate buildHint(): string {\n\t\tconst parts = [rawKeyHint(\"↑↓\", \"move\")];\n\t\tif (this.multiSelect) parts.push(rawKeyHint(\"Space\", \"toggle\"));\n\t\tparts.push(keyHint(\"tui.select.confirm\", \"submit\"));\n\t\tif (this.multiline) parts.push(keyHint(\"tui.input.newLine\", \"newline\"));\n\t\tparts.push(keyHint(\"tui.select.cancel\", \"stop agent\"));\n\t\treturn parts.join(\"  \");\n\t}\n\n\tprivate renderRows(): void {\n\t\tthis.optionsContainer.clear();\n\t\tfor (let i = 0; i < this.options.length; i++) {\n\t\t\tconst focused = this.cursorIndex === i;\n\t\t\tconst cursor = focused ? theme.fg(\"accent\", \"→ \") : \"  \";\n\t\t\tconst glyph = this.multiSelect ? (this.checked[i] ? \"[x]\" : \"[ ]\") : focused ? \"(•)\" : \"( )\";\n\t\t\tconst label = focused ? theme.fg(\"accent\", this.options[i]) : theme.fg(\"text\", this.options[i]);\n\t\t\tconst glyphColored = this.checked[i] || (!this.multiSelect && focused) ? theme.fg(\"accent\", glyph) : glyph;\n\t\t\tthis.optionsContainer.addChild(new Text(`${cursor}${glyphColored} ${label}`, 1, 0));\n\t\t}\n\t\tif (this.fieldLabel) {\n\t\t\tconst focused = this.cursorOnField();\n\t\t\tconst prefix = focused ? theme.fg(\"accent\", \"→ \") : \"  \";\n\t\t\tconst labelText = this.options.length > 0 ? \"Or type your own answer:\" : \"Your answer:\";\n\t\t\tthis.fieldLabel.setText(prefix + (focused ? theme.fg(\"accent\", labelText) : theme.fg(\"muted\", labelText)));\n\t\t}\n\t}\n\n\tprivate syncFieldFocus(): void {\n\t\tconst fieldFocused = this._focused && this.cursorOnField();\n\t\tif (this.input) this.input.focused = fieldFocused;\n\t\tif (this.editor) this.editor.focused = fieldFocused;\n\t}\n\n\tprivate moveCursor(delta: number): void {\n\t\tconst first = this.options.length > 0 ? 0 : this.freeTextRow;\n\t\tconst next = Math.max(first, Math.min(this.lastRow, this.cursorIndex + delta));\n\t\tif (next === this.cursorIndex) return;\n\t\tthis.cursorIndex = next;\n\t\tthis.renderRows();\n\t\tthis.syncFieldFocus();\n\t}\n\n\tprivate fieldText(editorTextOverride?: string): string {\n\t\tif (this.editor) return (editorTextOverride ?? this.editor.getText()).trim();\n\t\tif (this.input) return this.input.getValue().trim();\n\t\treturn \"\";\n\t}\n\n\tprivate currentAnswer(editorTextOverride?: string): AskResult | undefined {\n\t\tconst customText = this.fieldText(editorTextOverride) || undefined;\n\t\tif (this.multiSelect) {\n\t\t\tconst selected = this.options.filter((_, i) => this.checked[i]);\n\t\t\tif (selected.length === 0 && !customText) return undefined;\n\t\t\treturn { selected, customText };\n\t\t}\n\t\tif (this.cursorOnField()) {\n\t\t\tif (!customText) return undefined;\n\t\t\treturn { selected: [], customText };\n\t\t}\n\t\tconst option = this.options[this.cursorIndex];\n\t\t// Single-select: submit the highlighted option together with any typed\n\t\t// free text, matching the Dashboard, which combines a radio selection with\n\t\t// custom text (and the tool's own combined-answer result formatting).\n\t\treturn option ? { selected: [option], customText } : undefined;\n\t}\n\n\tprivate submit(editorTextOverride?: string): void {\n\t\tif (this.submitted) return;\n\t\tconst answer = this.currentAnswer(editorTextOverride);\n\t\tif (!answer) return; // Nothing to submit yet — Esc stops the turn instead.\n\t\tthis.submitted = true;\n\t\tthis.onSubmitCallback(answer);\n\t}\n\n\tprivate stop(): void {\n\t\tif (this.submitted) return;\n\t\tthis.submitted = true;\n\t\tthis.onStopCallback();\n\t}\n\n\thandleInput(keyData: string): void {\n\t\tconst kb = getKeybindings();\n\n\t\tif (kb.matches(keyData, \"tui.select.cancel\")) {\n\t\t\tthis.stop();\n\t\t\treturn;\n\t\t}\n\n\t\tif (this.cursorOnField()) {\n\t\t\t// Multiline editor: Enter submits (via onSubmit), Shift+Enter inserts a\n\t\t\t// newline, ↑ at the top line leaves to the options, everything else edits.\n\t\t\tif (this.editor) {\n\t\t\t\tif (kb.matches(keyData, \"tui.select.up\") && this.editor.getCursor().line === 0) {\n\t\t\t\t\tthis.moveCursor(-1);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tthis.editor.handleInput(keyData);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\t// Single-line input: ↑ leaves to the options, Enter submits, else edits.\n\t\t\tif (this.input) {\n\t\t\t\tif (kb.matches(keyData, \"tui.select.up\")) {\n\t\t\t\t\tthis.moveCursor(-1);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (kb.matches(keyData, \"tui.select.confirm\") || keyData === \"\\n\") {\n\t\t\t\t\tthis.submit();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tthis.input.handleInput(keyData);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\t// Cursor on an option row.\n\t\tif (kb.matches(keyData, \"tui.select.up\")) {\n\t\t\tthis.moveCursor(-1);\n\t\t} else if (kb.matches(keyData, \"tui.select.down\")) {\n\t\t\tthis.moveCursor(1);\n\t\t} else if (this.multiSelect && keyData === \" \") {\n\t\t\tthis.checked[this.cursorIndex] = !this.checked[this.cursorIndex];\n\t\t\tthis.renderRows();\n\t\t} else if (kb.matches(keyData, \"tui.select.confirm\") || keyData === \"\\n\") {\n\t\t\tthis.submit();\n\t\t}\n\t}\n\n\tdispose(): void {\n\t\tthis.countdown?.dispose();\n\t}\n}\n"]}