@dreb/coding-agent 2.50.0 → 2.52.0

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

@@ -0,0 +1,83 @@
+/**
+ * ask_user multi-question wizard.
+ *
+ * Renders one {@link AskRequest} — which carries one or more clarifying
+ * questions — as a single native wizard and returns the batch of answers, one
+ * {@link AskAnswer} per question, in order.
+ *
+ * Layout:
+ *   - Single question (N==1): compact inline panel with no tab strip.
+ *   - Multiple questions (N>=2): a compact tab strip at the top (one tab per
+ *     question plus a trailing "✔ Submit" review tab). Only the active tab is
+ *     rendered and receives keyboard input.
+ *
+ * Keyboard model:
+ *   ↑/↓         move a single cursor through the options and, last, the field
+ *   1..9        select (single) or toggle (multi) the numbered option
+ *   Space       toggle the highlighted checkbox (multi-select only)
+ *   Enter       single-select: pick the highlighted option, then advance/submit;
+ *               free-text field: advance/submit the typed answer;
+ *               review tab: submit the whole batch
+ *   Shift+Enter insert a newline in a multiline free-text field
+ *   Tab/Shift+Tab   switch to the next/previous tab (N>=2)
+ *   ←/→         switch tabs when the cursor is not on the free-text field (N>=2)
+ *   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 AskWizardComponentOptions {
+    tui?: TUI;
+    timeout?: number;
+}
+export declare class AskWizardComponent extends Container implements Focusable {
+    private questions;
+    private drafts;
+    /** Stable per-question free-text fields, created once and reused. */
+    private fields;
+    private requestTitle;
+    /** 0..N-1 are question tabs; index N is the review/Submit tab (N>=2 only). */
+    private activeTab;
+    private onSubmitCallback;
+    private onStopCallback;
+    private countdown;
+    private countdownSeconds;
+    private submitted;
+    private _focused;
+    get focused(): boolean;
+    set focused(value: boolean);
+    constructor(request: AskRequest, onSubmit: (result: AskResult) => void, onStop: () => void, opts?: AskWizardComponentOptions);
+    private optionsFor;
+    private isMultiSelect;
+    private allowFreeText;
+    /** Cursor row index of the free-text field, or -1 when there is none. */
+    private freeTextRow;
+    private lastRow;
+    private cursorOnField;
+    private fieldText;
+    private isAnswered;
+    /** Full (untruncated) tab title, whitespace-normalized. */
+    private fullTitle;
+    private shortTitle;
+    private countdownSuffix;
+    /** Full-width accent rule bounding the wizard, à la Claude Code. */
+    private rule;
+    private rebuild;
+    private singleHeader;
+    private buildTabStrip;
+    private addQuestionPanel;
+    private buildHint;
+    private addReviewPanel;
+    private answerSummary;
+    private syncFieldFocus;
+    private moveCursor;
+    private switchTab;
+    /** Move to the next tab, or submit when there is nowhere left to go. */
+    private advanceOrSubmit;
+    private toggle;
+    private answerFor;
+    private submit;
+    private stop;
+    handleInput(keyData: string): void;
+    dispose(): void;
+}
+//# sourceMappingURL=ask-wizard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ask-wizard.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/components/ask-wizard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAEN,SAAS,EAET,KAAK,SAAS,EAOd,KAAK,GAAG,EACR,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAA0B,UAAU,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAMvG,MAAM,WAAW,yBAAyB;IACzC,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAkCD,qBAAa,kBAAmB,SAAQ,SAAU,YAAW,SAAS;IACrE,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,MAAM,CAAU;IACxB,qEAAqE;IACrE,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,YAAY,CAAqB;IAEzC,8EAA8E;IAC9E,OAAO,CAAC,SAAS,CAAK;IAEtB,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,QAAQ,CAAS;IACzB,IAAI,OAAO,IAAI,OAAO,CAErB;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAGzB;IAED,YACC,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,EACrC,MAAM,EAAE,MAAM,IAAI,EAClB,IAAI,CAAC,EAAE,yBAAyB,EAoChC;IAID,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,aAAa;IAIrB,yEAAyE;IACzE,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,UAAU;IAIlB,2DAA2D;IAC3D,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,eAAe;IAMvB,qEAAoE;IACpE,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,gBAAgB;IA+CxB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,SAAS;IASjB,wEAAwE;IACxE,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,IAAI;IASZ,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAsHjC;IAED,OAAO,IAAI,IAAI,CAEd;CACD","sourcesContent":["/**\n * ask_user multi-question wizard.\n *\n * Renders one {@link AskRequest} — which carries one or more clarifying\n * questions — as a single native wizard and returns the batch of answers, one\n * {@link AskAnswer} per question, in order.\n *\n * Layout:\n *   - Single question (N==1): compact inline panel with no tab strip.\n *   - Multiple questions (N>=2): a compact tab strip at the top (one tab per\n *     question plus a trailing \"✔ Submit\" review tab). Only the active tab is\n *     rendered and receives keyboard input.\n *\n * Keyboard model:\n *   ↑/↓         move a single cursor through the options and, last, the field\n *   1..9        select (single) or toggle (multi) the numbered option\n *   Space       toggle the highlighted checkbox (multi-select only)\n *   Enter       single-select: pick the highlighted option, then advance/submit;\n *               free-text field: advance/submit the typed answer;\n *               review tab: submit the whole batch\n *   Shift+Enter insert a newline in a multiline free-text field\n *   Tab/Shift+Tab   switch to the next/previous tab (N>=2)\n *   ←/→         switch tabs when the cursor is not on the free-text field (N>=2)\n *   Esc         stop the current agent turn\n */\n\nimport {\n\ttype Component,\n\tContainer,\n\tEditor,\n\ttype Focusable,\n\tgetKeybindings,\n\tInput,\n\tMarkdown,\n\tmatchesKey,\n\tSpacer,\n\tText,\n\ttype TUI,\n} from \"@dreb/tui\";\nimport type { AskAnswer, AskQuestion, 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 AskWizardComponentOptions {\n\ttui?: TUI;\n\ttimeout?: number;\n}\n\n/**\n * Left-indents a child component (the question Markdown, or the free-text\n * Input/Editor) so it aligns with the wizard's answer block instead of jutting\n * out to the terminal margin. Focus and input still route to the wrapped field\n * directly; only rendering is shifted.\n */\nclass Indented implements Component {\n\tconstructor(\n\t\tprivate child: Component,\n\t\tprivate pad: number,\n\t) {}\n\n\trender(width: number): string[] {\n\t\tconst prefix = \" \".repeat(this.pad);\n\t\treturn this.child.render(Math.max(1, width - this.pad)).map((line) => prefix + line);\n\t}\n\n\tinvalidate(): void {\n\t\tthis.child.invalidate?.();\n\t}\n}\n\n/** Left indent (columns) aligning the question and free-text field with the\n * answer block (past the cursor gutter and the \"N.\" number). */\nconst BODY_INDENT = 3;\n\n/** Per-question draft state (selection + cursor). Free text lives in `fields`. */\ninterface Draft {\n\tselected: string[];\n\tcursorIndex: number;\n}\n\nexport class AskWizardComponent extends Container implements Focusable {\n\tprivate questions: AskQuestion[];\n\tprivate drafts: Draft[];\n\t/** Stable per-question free-text fields, created once and reused. */\n\tprivate fields: (Input | Editor | undefined)[];\n\tprivate requestTitle: string | undefined;\n\n\t/** 0..N-1 are question tabs; index N is the review/Submit tab (N>=2 only). */\n\tprivate activeTab = 0;\n\n\tprivate onSubmitCallback: (result: AskResult) => void;\n\tprivate onStopCallback: () => void;\n\tprivate countdown: CountdownTimer | undefined;\n\tprivate countdownSeconds: number | 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\tconstructor(\n\t\trequest: AskRequest,\n\t\tonSubmit: (result: AskResult) => void,\n\t\tonStop: () => void,\n\t\topts?: AskWizardComponentOptions,\n\t) {\n\t\tsuper();\n\n\t\tthis.questions = request.questions ?? [];\n\t\tthis.requestTitle = request.title?.trim() || undefined;\n\t\tthis.onSubmitCallback = onSubmit;\n\t\tthis.onStopCallback = onStop;\n\n\t\tthis.drafts = this.questions.map(() => ({ selected: [], cursorIndex: 0 }));\n\n\t\tthis.fields = this.questions.map((q) => {\n\t\t\tconst allowFree = q.allowFreeText !== false;\n\t\t\tif (!allowFree) return undefined;\n\t\t\tif (q.multiline && opts?.tui) {\n\t\t\t\t// Never wire editor.onSubmit — Enter is intercepted here so the editor\n\t\t\t\t// keeps its text (it clears itself on submit) across tab switches.\n\t\t\t\treturn new Editor(opts.tui, getEditorTheme(), {});\n\t\t\t}\n\t\t\treturn new Input();\n\t\t});\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) => {\n\t\t\t\t\tthis.countdownSeconds = s;\n\t\t\t\t\tthis.rebuild();\n\t\t\t\t},\n\t\t\t\t() => this.stop(),\n\t\t\t);\n\t\t}\n\n\t\tthis.rebuild();\n\t\tthis.syncFieldFocus();\n\t}\n\n\t// --- Per-question helpers -------------------------------------------------\n\n\tprivate optionsFor(i: number): string[] {\n\t\treturn this.questions[i]?.options ?? [];\n\t}\n\n\tprivate isMultiSelect(i: number): boolean {\n\t\treturn this.questions[i]?.multiSelect === true && this.optionsFor(i).length > 0;\n\t}\n\n\tprivate allowFreeText(i: number): boolean {\n\t\treturn this.questions[i]?.allowFreeText !== false;\n\t}\n\n\t/** Cursor row index of the free-text field, or -1 when there is none. */\n\tprivate freeTextRow(i: number): number {\n\t\treturn this.allowFreeText(i) ? this.optionsFor(i).length : -1;\n\t}\n\n\tprivate lastRow(i: number): number {\n\t\tconst opts = this.optionsFor(i).length;\n\t\treturn this.allowFreeText(i) ? opts : opts - 1;\n\t}\n\n\tprivate cursorOnField(i: number): boolean {\n\t\treturn this.allowFreeText(i) && this.drafts[i].cursorIndex === this.freeTextRow(i);\n\t}\n\n\tprivate fieldText(i: number): string {\n\t\tconst field = this.fields[i];\n\t\tif (field instanceof Editor) return field.getText();\n\t\tif (field instanceof Input) return field.getValue();\n\t\treturn \"\";\n\t}\n\n\tprivate isAnswered(i: number): boolean {\n\t\treturn this.drafts[i].selected.length > 0 || this.fieldText(i).trim().length > 0;\n\t}\n\n\t/** Full (untruncated) tab title, whitespace-normalized. */\n\tprivate fullTitle(i: number): string {\n\t\tconst q = this.questions[i];\n\t\treturn (q.title?.trim() || q.question || \"\").replace(/\\s+/g, \" \");\n\t}\n\n\tprivate shortTitle(i: number): string {\n\t\tconst raw = this.fullTitle(i);\n\t\treturn raw.length > 18 ? `${raw.slice(0, 17)}…` : raw;\n\t}\n\n\tprivate countdownSuffix(): string {\n\t\treturn this.countdownSeconds != null ? theme.fg(\"muted\", `  (${this.countdownSeconds}s)`) : \"\";\n\t}\n\n\t// --- Rendering ------------------------------------------------------------\n\n\t/** Full-width accent rule bounding the wizard, à la Claude Code. */\n\tprivate rule(): Component {\n\t\treturn new DynamicBorder((s) => theme.fg(\"accent\", s));\n\t}\n\n\tprivate rebuild(): void {\n\t\tthis.clear();\n\t\tconst n = this.questions.length;\n\t\tthis.addChild(this.rule());\n\t\tif (n === 1) {\n\t\t\tthis.addChild(new Text(this.singleHeader(0), 1, 0));\n\t\t\tthis.addQuestionPanel(0);\n\t\t} else {\n\t\t\tthis.addChild(new Text(this.buildTabStrip(), 1, 0));\n\t\t\tif (this.activeTab < n) {\n\t\t\t\tthis.addQuestionPanel(this.activeTab);\n\t\t\t} else {\n\t\t\t\tthis.addReviewPanel();\n\t\t\t}\n\t\t}\n\t\tthis.addChild(this.rule());\n\t}\n\n\tprivate singleHeader(i: number): string {\n\t\tconst base = this.questions[i]?.title?.trim() || this.requestTitle || \"Question\";\n\t\treturn theme.fg(\"accent\", theme.bold(base)) + this.countdownSuffix();\n\t}\n\n\tprivate buildTabStrip(): string {\n\t\tconst n = this.questions.length;\n\t\tconst parts = this.questions.map((_, i) => {\n\t\t\tconst marker = this.isAnswered(i) ? \"●\" : \"○\";\n\t\t\t// The active tab shows its full title; the rest stay truncated so the\n\t\t\t// strip stays compact.\n\t\t\tconst title = i === this.activeTab ? this.fullTitle(i) : this.shortTitle(i);\n\t\t\tconst label = `${i + 1}.${marker} ${title}`;\n\t\t\treturn i === this.activeTab ? theme.fg(\"accent\", theme.bold(label)) : theme.fg(\"muted\", label);\n\t\t});\n\t\tconst submitLabel = \"✔ Submit\";\n\t\tparts.push(this.activeTab === n ? theme.fg(\"accent\", theme.bold(submitLabel)) : theme.fg(\"muted\", submitLabel));\n\t\treturn parts.join(\"  \") + this.countdownSuffix();\n\t}\n\n\tprivate addQuestionPanel(i: number): void {\n\t\tconst q = this.questions[i];\n\t\tconst draft = this.drafts[i];\n\t\tconst opts = this.optionsFor(i);\n\t\tconst multiSelect = this.isMultiSelect(i);\n\n\t\t// Blank line + indented question aligned with the answer block below, so\n\t\t// the prompt reads as a heading over its options rather than crowding them.\n\t\tthis.addChild(new Spacer(1));\n\t\tthis.addChild(new Indented(new Markdown(q.question, 0, 0, getMarkdownTheme(), undefined, true), BODY_INDENT));\n\t\tthis.addChild(new Spacer(1));\n\n\t\tfor (let j = 0; j < opts.length; j++) {\n\t\t\tconst focused = draft.cursorIndex === j;\n\t\t\tconst chosen = draft.selected.includes(opts[j]);\n\t\t\tconst cursor = focused ? theme.fg(\"accent\", \"→ \") : \"  \";\n\t\t\tconst num = `${j + 1}.`;\n\t\t\t// Multi-select keeps checkboxes; single-select drops the radio glyph and\n\t\t\t// relies on the green check + accent label to mark the chosen answer.\n\t\t\tlet marker: string;\n\t\t\tif (multiSelect) {\n\t\t\t\tconst box = chosen ? \"[x]\" : \"[ ]\";\n\t\t\t\tmarker = chosen ? theme.fg(\"accent\", box) : box;\n\t\t\t} else {\n\t\t\t\tmarker = chosen ? theme.fg(\"accent\", \"✔\") : \" \";\n\t\t\t}\n\t\t\tconst label = focused || chosen ? theme.fg(\"accent\", opts[j]) : theme.fg(\"text\", opts[j]);\n\t\t\tthis.addChild(new Text(`${cursor}${num} ${marker} ${label}`, 1, 0));\n\t\t}\n\n\t\tif (this.allowFreeText(i)) {\n\t\t\tconst onField = this.cursorOnField(i);\n\t\t\tconst prefix = onField ? theme.fg(\"accent\", \"→ \") : \"  \";\n\t\t\tconst labelText = opts.length > 0 ? \"Or type your own answer:\" : \"Your answer:\";\n\t\t\tthis.addChild(\n\t\t\t\tnew Text(prefix + (onField ? theme.fg(\"accent\", labelText) : theme.fg(\"muted\", labelText)), 1, 0),\n\t\t\t);\n\t\t\tconst field = this.fields[i];\n\t\t\t// Indent the field so it aligns under the label instead of sitting at the\n\t\t\t// terminal margin like the main prompt — keeps focus visually inside the\n\t\t\t// wizard, consistent with the option rows.\n\t\t\tif (field) this.addChild(new Indented(field, BODY_INDENT));\n\t\t}\n\n\t\tthis.addChild(new Text(this.buildHint(i), 1, 0));\n\t}\n\n\tprivate buildHint(i: number): string {\n\t\tconst n = this.questions.length;\n\t\tconst parts = [rawKeyHint(\"↑↓\", \"move\")];\n\t\tif (this.isMultiSelect(i)) parts.push(rawKeyHint(\"Space\", \"toggle\"));\n\t\tif (n >= 2) parts.push(rawKeyHint(\"⇥\", \"switch\"));\n\t\tparts.push(keyHint(\"tui.select.confirm\", n === 1 ? \"submit\" : \"next\"));\n\t\tif (this.questions[i]?.multiline) parts.push(keyHint(\"tui.input.newLine\", \"newline\"));\n\t\tparts.push(keyHint(\"tui.select.cancel\", \"stop\"));\n\t\treturn parts.join(\"  \");\n\t}\n\n\tprivate addReviewPanel(): void {\n\t\tthis.addChild(new Text(theme.fg(\"accent\", theme.bold(\"Review your answers\")) + this.countdownSuffix(), 1, 0));\n\t\tfor (let i = 0; i < this.questions.length; i++) {\n\t\t\tthis.addChild(new Text(theme.fg(\"muted\", `• ${this.shortTitle(i)} → ${this.answerSummary(i)}`), 1, 0));\n\t\t}\n\t\tconst hint = [\n\t\t\tkeyHint(\"tui.select.confirm\", \"submit\"),\n\t\t\trawKeyHint(\"⇥\", \"switch\"),\n\t\t\tkeyHint(\"tui.select.cancel\", \"stop\"),\n\t\t].join(\"  \");\n\t\tthis.addChild(new Text(hint, 1, 0));\n\t}\n\n\tprivate answerSummary(i: number): string {\n\t\tconst draft = this.drafts[i];\n\t\tconst opts = this.optionsFor(i);\n\t\tconst selected = this.isMultiSelect(i)\n\t\t\t? opts.filter((o) => draft.selected.includes(o))\n\t\t\t: draft.selected.slice(0, 1);\n\t\tconst custom = this.fieldText(i).trim();\n\t\tconst parts = [...selected];\n\t\tif (custom) parts.push(custom);\n\t\treturn parts.length > 0 ? parts.join(\", \") : \"(unanswered)\";\n\t}\n\n\t// --- Focus ----------------------------------------------------------------\n\n\tprivate syncFieldFocus(): void {\n\t\tthis.fields.forEach((field, i) => {\n\t\t\tif (!field) return;\n\t\t\tfield.focused = this._focused && this.activeTab === i && this.cursorOnField(i);\n\t\t});\n\t}\n\n\t// --- Navigation -----------------------------------------------------------\n\n\tprivate moveCursor(delta: number): void {\n\t\tconst i = this.activeTab;\n\t\tconst first = this.optionsFor(i).length > 0 ? 0 : Math.max(0, this.freeTextRow(i));\n\t\tconst next = Math.max(first, Math.min(this.lastRow(i), this.drafts[i].cursorIndex + delta));\n\t\tif (next === this.drafts[i].cursorIndex) return;\n\t\tthis.drafts[i].cursorIndex = next;\n\t\tthis.rebuild();\n\t\tthis.syncFieldFocus();\n\t}\n\n\tprivate switchTab(delta: number): void {\n\t\tconst n = this.questions.length;\n\t\tif (n < 2) return;\n\t\tconst total = n + 1; // question tabs + review tab\n\t\tthis.activeTab = (this.activeTab + delta + total) % total;\n\t\tthis.rebuild();\n\t\tthis.syncFieldFocus();\n\t}\n\n\t/** Move to the next tab, or submit when there is nowhere left to go. */\n\tprivate advanceOrSubmit(i: number): void {\n\t\tif (this.questions.length === 1) {\n\t\t\tthis.submit();\n\t\t\treturn;\n\t\t}\n\t\tthis.activeTab = i + 1; // next question, or the review tab (index N)\n\t\tthis.rebuild();\n\t\tthis.syncFieldFocus();\n\t}\n\n\tprivate toggle(i: number, option: string): void {\n\t\tconst draft = this.drafts[i];\n\t\tconst at = draft.selected.indexOf(option);\n\t\tif (at === -1) draft.selected.push(option);\n\t\telse draft.selected.splice(at, 1);\n\t}\n\n\t// --- Submit / stop --------------------------------------------------------\n\n\tprivate answerFor(i: number): AskAnswer {\n\t\tconst draft = this.drafts[i];\n\t\tconst opts = this.optionsFor(i);\n\t\tconst customText = this.fieldText(i).trim() || undefined;\n\t\tif (this.isMultiSelect(i)) {\n\t\t\tconst selected = opts.filter((o) => draft.selected.includes(o));\n\t\t\tif (selected.length === 0 && !customText) return { selected: [], skipped: true };\n\t\t\treturn { selected, customText };\n\t\t}\n\t\tconst selected = draft.selected.slice(0, 1);\n\t\tif (selected.length === 0 && !customText) return { selected: [], skipped: true };\n\t\treturn { selected, customText };\n\t}\n\n\tprivate submit(): void {\n\t\tif (this.submitted) return;\n\t\tthis.submitted = true;\n\t\tthis.countdown?.dispose();\n\t\tconst answers = this.questions.map((_, i) => this.answerFor(i));\n\t\tthis.onSubmitCallback({ answers });\n\t}\n\n\tprivate stop(): void {\n\t\tif (this.submitted) return;\n\t\tthis.submitted = true;\n\t\tthis.countdown?.dispose();\n\t\tthis.onStopCallback();\n\t}\n\n\t// --- Input ----------------------------------------------------------------\n\n\thandleInput(keyData: string): void {\n\t\tconst kb = getKeybindings();\n\t\tconst n = this.questions.length;\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\t// Tab / Shift+Tab switch tabs before any field sees the key so switching\n\t\t// works regardless of which sub-field currently holds focus.\n\t\tif (n >= 2) {\n\t\t\tif (matchesKey(keyData, \"shift+tab\") || keyData === \"\\x1b[Z\") {\n\t\t\t\tthis.switchTab(-1);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (kb.matches(keyData, \"tui.input.tab\") || keyData === \"\\t\") {\n\t\t\t\tthis.switchTab(1);\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\t// Review tab: Enter submits; arrows switch tabs.\n\t\tif (n >= 2 && this.activeTab === n) {\n\t\t\tif (kb.matches(keyData, \"tui.select.confirm\") || keyData === \"\\n\" || keyData === \"\\r\") {\n\t\t\t\tthis.submit();\n\t\t\t} else if (keyData === \"\\x1b[D\") {\n\t\t\t\tthis.switchTab(-1);\n\t\t\t} else if (keyData === \"\\x1b[C\") {\n\t\t\t\tthis.switchTab(1);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tconst i = this.activeTab;\n\n\t\t// Free-text field has focus: delegate editing, intercept Enter/leave keys.\n\t\tif (this.cursorOnField(i)) {\n\t\t\tconst field = this.fields[i];\n\t\t\tif (field instanceof Editor) {\n\t\t\t\tif (kb.matches(keyData, \"tui.select.up\") && field.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\t// Shift+Enter (and bare LF newline) insert a line; real Enter advances.\n\t\t\t\tif (kb.matches(keyData, \"tui.input.newLine\") || keyData === \"\\n\") {\n\t\t\t\t\tfield.handleInput(keyData);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (kb.matches(keyData, \"tui.select.confirm\")) {\n\t\t\t\t\tthis.advanceOrSubmit(i);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tfield.handleInput(keyData);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (field instanceof 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\" || keyData === \"\\r\") {\n\t\t\t\t\tthis.advanceOrSubmit(i);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tfield.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 (or an option-less field-only question handled above).\n\t\tconst opts = this.optionsFor(i);\n\n\t\t// Numeric shortcuts select/toggle an option by its 1-based index.\n\t\tif (keyData.length === 1 && keyData >= \"1\" && keyData <= \"9\") {\n\t\t\tconst index = keyData.charCodeAt(0) - 49; // '1' -> 0\n\t\t\tif (index < opts.length) {\n\t\t\t\tif (this.isMultiSelect(i)) {\n\t\t\t\t\tthis.toggle(i, opts[index]);\n\t\t\t\t} else {\n\t\t\t\t\tthis.drafts[i].selected = [opts[index]];\n\t\t\t\t\tthis.drafts[i].cursorIndex = index;\n\t\t\t\t}\n\t\t\t\tthis.rebuild();\n\t\t\t\tthis.syncFieldFocus();\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tif (kb.matches(keyData, \"tui.select.up\")) {\n\t\t\tthis.moveCursor(-1);\n\t\t\treturn;\n\t\t}\n\t\tif (kb.matches(keyData, \"tui.select.down\")) {\n\t\t\tthis.moveCursor(1);\n\t\t\treturn;\n\t\t}\n\t\tif (n >= 2 && keyData === \"\\x1b[D\") {\n\t\t\tthis.switchTab(-1);\n\t\t\treturn;\n\t\t}\n\t\tif (n >= 2 && keyData === \"\\x1b[C\") {\n\t\t\tthis.switchTab(1);\n\t\t\treturn;\n\t\t}\n\t\tif (this.isMultiSelect(i) && keyData === \" \") {\n\t\t\tthis.toggle(i, opts[this.drafts[i].cursorIndex]);\n\t\t\tthis.rebuild();\n\t\t\treturn;\n\t\t}\n\t\tif (kb.matches(keyData, \"tui.select.confirm\") || keyData === \"\\n\" || keyData === \"\\r\") {\n\t\t\tconst option = opts[this.drafts[i].cursorIndex];\n\t\t\tif (option !== undefined && !this.isMultiSelect(i)) {\n\t\t\t\tthis.drafts[i].selected = [option];\n\t\t\t}\n\t\t\tthis.advanceOrSubmit(i);\n\t\t}\n\t}\n\n\tdispose(): void {\n\t\tthis.countdown?.dispose();\n\t}\n}\n"]}

package/dist/modes/interactive/components/ask-wizard.js

@@ -0,0 +1,464 @@
+/**
+ * ask_user multi-question wizard.
+ *
+ * Renders one {@link AskRequest} — which carries one or more clarifying
+ * questions — as a single native wizard and returns the batch of answers, one
+ * {@link AskAnswer} per question, in order.
+ *
+ * Layout:
+ *   - Single question (N==1): compact inline panel with no tab strip.
+ *   - Multiple questions (N>=2): a compact tab strip at the top (one tab per
+ *     question plus a trailing "✔ Submit" review tab). Only the active tab is
+ *     rendered and receives keyboard input.
+ *
+ * Keyboard model:
+ *   ↑/↓         move a single cursor through the options and, last, the field
+ *   1..9        select (single) or toggle (multi) the numbered option
+ *   Space       toggle the highlighted checkbox (multi-select only)
+ *   Enter       single-select: pick the highlighted option, then advance/submit;
+ *               free-text field: advance/submit the typed answer;
+ *               review tab: submit the whole batch
+ *   Shift+Enter insert a newline in a multiline free-text field
+ *   Tab/Shift+Tab   switch to the next/previous tab (N>=2)
+ *   ←/→         switch tabs when the cursor is not on the free-text field (N>=2)
+ *   Esc         stop the current agent turn
+ */
+import { Container, Editor, getKeybindings, Input, Markdown, matchesKey, Spacer, Text, } from "@dreb/tui";
+import { getEditorTheme, getMarkdownTheme, theme } from "../theme/theme.js";
+import { CountdownTimer } from "./countdown-timer.js";
+import { DynamicBorder } from "./dynamic-border.js";
+import { keyHint, rawKeyHint } from "./keybinding-hints.js";
+/**
+ * Left-indents a child component (the question Markdown, or the free-text
+ * Input/Editor) so it aligns with the wizard's answer block instead of jutting
+ * out to the terminal margin. Focus and input still route to the wrapped field
+ * directly; only rendering is shifted.
+ */
+class Indented {
+    child;
+    pad;
+    constructor(child, pad) {
+        this.child = child;
+        this.pad = pad;
+    }
+    render(width) {
+        const prefix = " ".repeat(this.pad);
+        return this.child.render(Math.max(1, width - this.pad)).map((line) => prefix + line);
+    }
+    invalidate() {
+        this.child.invalidate?.();
+    }
+}
+/** Left indent (columns) aligning the question and free-text field with the
+ * answer block (past the cursor gutter and the "N." number). */
+const BODY_INDENT = 3;
+export class AskWizardComponent extends Container {
+    questions;
+    drafts;
+    /** Stable per-question free-text fields, created once and reused. */
+    fields;
+    requestTitle;
+    /** 0..N-1 are question tabs; index N is the review/Submit tab (N>=2 only). */
+    activeTab = 0;
+    onSubmitCallback;
+    onStopCallback;
+    countdown;
+    countdownSeconds;
+    submitted = false;
+    _focused = false;
+    get focused() {
+        return this._focused;
+    }
+    set focused(value) {
+        this._focused = value;
+        this.syncFieldFocus();
+    }
+    constructor(request, onSubmit, onStop, opts) {
+        super();
+        this.questions = request.questions ?? [];
+        this.requestTitle = request.title?.trim() || undefined;
+        this.onSubmitCallback = onSubmit;
+        this.onStopCallback = onStop;
+        this.drafts = this.questions.map(() => ({ selected: [], cursorIndex: 0 }));
+        this.fields = this.questions.map((q) => {
+            const allowFree = q.allowFreeText !== false;
+            if (!allowFree)
+                return undefined;
+            if (q.multiline && opts?.tui) {
+                // Never wire editor.onSubmit — Enter is intercepted here so the editor
+                // keeps its text (it clears itself on submit) across tab switches.
+                return new Editor(opts.tui, getEditorTheme(), {});
+            }
+            return new Input();
+        });
+        if (opts?.timeout && opts.timeout > 0 && opts.tui) {
+            this.countdown = new CountdownTimer(opts.timeout, opts.tui, (s) => {
+                this.countdownSeconds = s;
+                this.rebuild();
+            }, () => this.stop());
+        }
+        this.rebuild();
+        this.syncFieldFocus();
+    }
+    // --- Per-question helpers -------------------------------------------------
+    optionsFor(i) {
+        return this.questions[i]?.options ?? [];
+    }
+    isMultiSelect(i) {
+        return this.questions[i]?.multiSelect === true && this.optionsFor(i).length > 0;
+    }
+    allowFreeText(i) {
+        return this.questions[i]?.allowFreeText !== false;
+    }
+    /** Cursor row index of the free-text field, or -1 when there is none. */
+    freeTextRow(i) {
+        return this.allowFreeText(i) ? this.optionsFor(i).length : -1;
+    }
+    lastRow(i) {
+        const opts = this.optionsFor(i).length;
+        return this.allowFreeText(i) ? opts : opts - 1;
+    }
+    cursorOnField(i) {
+        return this.allowFreeText(i) && this.drafts[i].cursorIndex === this.freeTextRow(i);
+    }
+    fieldText(i) {
+        const field = this.fields[i];
+        if (field instanceof Editor)
+            return field.getText();
+        if (field instanceof Input)
+            return field.getValue();
+        return "";
+    }
+    isAnswered(i) {
+        return this.drafts[i].selected.length > 0 || this.fieldText(i).trim().length > 0;
+    }
+    /** Full (untruncated) tab title, whitespace-normalized. */
+    fullTitle(i) {
+        const q = this.questions[i];
+        return (q.title?.trim() || q.question || "").replace(/\s+/g, " ");
+    }
+    shortTitle(i) {
+        const raw = this.fullTitle(i);
+        return raw.length > 18 ? `${raw.slice(0, 17)}…` : raw;
+    }
+    countdownSuffix() {
+        return this.countdownSeconds != null ? theme.fg("muted", `  (${this.countdownSeconds}s)`) : "";
+    }
+    // --- Rendering ------------------------------------------------------------
+    /** Full-width accent rule bounding the wizard, à la Claude Code. */
+    rule() {
+        return new DynamicBorder((s) => theme.fg("accent", s));
+    }
+    rebuild() {
+        this.clear();
+        const n = this.questions.length;
+        this.addChild(this.rule());
+        if (n === 1) {
+            this.addChild(new Text(this.singleHeader(0), 1, 0));
+            this.addQuestionPanel(0);
+        }
+        else {
+            this.addChild(new Text(this.buildTabStrip(), 1, 0));
+            if (this.activeTab < n) {
+                this.addQuestionPanel(this.activeTab);
+            }
+            else {
+                this.addReviewPanel();
+            }
+        }
+        this.addChild(this.rule());
+    }
+    singleHeader(i) {
+        const base = this.questions[i]?.title?.trim() || this.requestTitle || "Question";
+        return theme.fg("accent", theme.bold(base)) + this.countdownSuffix();
+    }
+    buildTabStrip() {
+        const n = this.questions.length;
+        const parts = this.questions.map((_, i) => {
+            const marker = this.isAnswered(i) ? "●" : "○";
+            // The active tab shows its full title; the rest stay truncated so the
+            // strip stays compact.
+            const title = i === this.activeTab ? this.fullTitle(i) : this.shortTitle(i);
+            const label = `${i + 1}.${marker} ${title}`;
+            return i === this.activeTab ? theme.fg("accent", theme.bold(label)) : theme.fg("muted", label);
+        });
+        const submitLabel = "✔ Submit";
+        parts.push(this.activeTab === n ? theme.fg("accent", theme.bold(submitLabel)) : theme.fg("muted", submitLabel));
+        return parts.join("  ") + this.countdownSuffix();
+    }
+    addQuestionPanel(i) {
+        const q = this.questions[i];
+        const draft = this.drafts[i];
+        const opts = this.optionsFor(i);
+        const multiSelect = this.isMultiSelect(i);
+        // Blank line + indented question aligned with the answer block below, so
+        // the prompt reads as a heading over its options rather than crowding them.
+        this.addChild(new Spacer(1));
+        this.addChild(new Indented(new Markdown(q.question, 0, 0, getMarkdownTheme(), undefined, true), BODY_INDENT));
+        this.addChild(new Spacer(1));
+        for (let j = 0; j < opts.length; j++) {
+            const focused = draft.cursorIndex === j;
+            const chosen = draft.selected.includes(opts[j]);
+            const cursor = focused ? theme.fg("accent", "→ ") : "  ";
+            const num = `${j + 1}.`;
+            // Multi-select keeps checkboxes; single-select drops the radio glyph and
+            // relies on the green check + accent label to mark the chosen answer.
+            let marker;
+            if (multiSelect) {
+                const box = chosen ? "[x]" : "[ ]";
+                marker = chosen ? theme.fg("accent", box) : box;
+            }
+            else {
+                marker = chosen ? theme.fg("accent", "✔") : " ";
+            }
+            const label = focused || chosen ? theme.fg("accent", opts[j]) : theme.fg("text", opts[j]);
+            this.addChild(new Text(`${cursor}${num} ${marker} ${label}`, 1, 0));
+        }
+        if (this.allowFreeText(i)) {
+            const onField = this.cursorOnField(i);
+            const prefix = onField ? theme.fg("accent", "→ ") : "  ";
+            const labelText = opts.length > 0 ? "Or type your own answer:" : "Your answer:";
+            this.addChild(new Text(prefix + (onField ? theme.fg("accent", labelText) : theme.fg("muted", labelText)), 1, 0));
+            const field = this.fields[i];
+            // Indent the field so it aligns under the label instead of sitting at the
+            // terminal margin like the main prompt — keeps focus visually inside the
+            // wizard, consistent with the option rows.
+            if (field)
+                this.addChild(new Indented(field, BODY_INDENT));
+        }
+        this.addChild(new Text(this.buildHint(i), 1, 0));
+    }
+    buildHint(i) {
+        const n = this.questions.length;
+        const parts = [rawKeyHint("↑↓", "move")];
+        if (this.isMultiSelect(i))
+            parts.push(rawKeyHint("Space", "toggle"));
+        if (n >= 2)
+            parts.push(rawKeyHint("⇥", "switch"));
+        parts.push(keyHint("tui.select.confirm", n === 1 ? "submit" : "next"));
+        if (this.questions[i]?.multiline)
+            parts.push(keyHint("tui.input.newLine", "newline"));
+        parts.push(keyHint("tui.select.cancel", "stop"));
+        return parts.join("  ");
+    }
+    addReviewPanel() {
+        this.addChild(new Text(theme.fg("accent", theme.bold("Review your answers")) + this.countdownSuffix(), 1, 0));
+        for (let i = 0; i < this.questions.length; i++) {
+            this.addChild(new Text(theme.fg("muted", `• ${this.shortTitle(i)} → ${this.answerSummary(i)}`), 1, 0));
+        }
+        const hint = [
+            keyHint("tui.select.confirm", "submit"),
+            rawKeyHint("⇥", "switch"),
+            keyHint("tui.select.cancel", "stop"),
+        ].join("  ");
+        this.addChild(new Text(hint, 1, 0));
+    }
+    answerSummary(i) {
+        const draft = this.drafts[i];
+        const opts = this.optionsFor(i);
+        const selected = this.isMultiSelect(i)
+            ? opts.filter((o) => draft.selected.includes(o))
+            : draft.selected.slice(0, 1);
+        const custom = this.fieldText(i).trim();
+        const parts = [...selected];
+        if (custom)
+            parts.push(custom);
+        return parts.length > 0 ? parts.join(", ") : "(unanswered)";
+    }
+    // --- Focus ----------------------------------------------------------------
+    syncFieldFocus() {
+        this.fields.forEach((field, i) => {
+            if (!field)
+                return;
+            field.focused = this._focused && this.activeTab === i && this.cursorOnField(i);
+        });
+    }
+    // --- Navigation -----------------------------------------------------------
+    moveCursor(delta) {
+        const i = this.activeTab;
+        const first = this.optionsFor(i).length > 0 ? 0 : Math.max(0, this.freeTextRow(i));
+        const next = Math.max(first, Math.min(this.lastRow(i), this.drafts[i].cursorIndex + delta));
+        if (next === this.drafts[i].cursorIndex)
+            return;
+        this.drafts[i].cursorIndex = next;
+        this.rebuild();
+        this.syncFieldFocus();
+    }
+    switchTab(delta) {
+        const n = this.questions.length;
+        if (n < 2)
+            return;
+        const total = n + 1; // question tabs + review tab
+        this.activeTab = (this.activeTab + delta + total) % total;
+        this.rebuild();
+        this.syncFieldFocus();
+    }
+    /** Move to the next tab, or submit when there is nowhere left to go. */
+    advanceOrSubmit(i) {
+        if (this.questions.length === 1) {
+            this.submit();
+            return;
+        }
+        this.activeTab = i + 1; // next question, or the review tab (index N)
+        this.rebuild();
+        this.syncFieldFocus();
+    }
+    toggle(i, option) {
+        const draft = this.drafts[i];
+        const at = draft.selected.indexOf(option);
+        if (at === -1)
+            draft.selected.push(option);
+        else
+            draft.selected.splice(at, 1);
+    }
+    // --- Submit / stop --------------------------------------------------------
+    answerFor(i) {
+        const draft = this.drafts[i];
+        const opts = this.optionsFor(i);
+        const customText = this.fieldText(i).trim() || undefined;
+        if (this.isMultiSelect(i)) {
+            const selected = opts.filter((o) => draft.selected.includes(o));
+            if (selected.length === 0 && !customText)
+                return { selected: [], skipped: true };
+            return { selected, customText };
+        }
+        const selected = draft.selected.slice(0, 1);
+        if (selected.length === 0 && !customText)
+            return { selected: [], skipped: true };
+        return { selected, customText };
+    }
+    submit() {
+        if (this.submitted)
+            return;
+        this.submitted = true;
+        this.countdown?.dispose();
+        const answers = this.questions.map((_, i) => this.answerFor(i));
+        this.onSubmitCallback({ answers });
+    }
+    stop() {
+        if (this.submitted)
+            return;
+        this.submitted = true;
+        this.countdown?.dispose();
+        this.onStopCallback();
+    }
+    // --- Input ----------------------------------------------------------------
+    handleInput(keyData) {
+        const kb = getKeybindings();
+        const n = this.questions.length;
+        if (kb.matches(keyData, "tui.select.cancel")) {
+            this.stop();
+            return;
+        }
+        // Tab / Shift+Tab switch tabs before any field sees the key so switching
+        // works regardless of which sub-field currently holds focus.
+        if (n >= 2) {
+            if (matchesKey(keyData, "shift+tab") || keyData === "\x1b[Z") {
+                this.switchTab(-1);
+                return;
+            }
+            if (kb.matches(keyData, "tui.input.tab") || keyData === "\t") {
+                this.switchTab(1);
+                return;
+            }
+        }
+        // Review tab: Enter submits; arrows switch tabs.
+        if (n >= 2 && this.activeTab === n) {
+            if (kb.matches(keyData, "tui.select.confirm") || keyData === "\n" || keyData === "\r") {
+                this.submit();
+            }
+            else if (keyData === "\x1b[D") {
+                this.switchTab(-1);
+            }
+            else if (keyData === "\x1b[C") {
+                this.switchTab(1);
+            }
+            return;
+        }
+        const i = this.activeTab;
+        // Free-text field has focus: delegate editing, intercept Enter/leave keys.
+        if (this.cursorOnField(i)) {
+            const field = this.fields[i];
+            if (field instanceof Editor) {
+                if (kb.matches(keyData, "tui.select.up") && field.getCursor().line === 0) {
+                    this.moveCursor(-1);
+                    return;
+                }
+                // Shift+Enter (and bare LF newline) insert a line; real Enter advances.
+                if (kb.matches(keyData, "tui.input.newLine") || keyData === "\n") {
+                    field.handleInput(keyData);
+                    return;
+                }
+                if (kb.matches(keyData, "tui.select.confirm")) {
+                    this.advanceOrSubmit(i);
+                    return;
+                }
+                field.handleInput(keyData);
+                return;
+            }
+            if (field instanceof Input) {
+                if (kb.matches(keyData, "tui.select.up")) {
+                    this.moveCursor(-1);
+                    return;
+                }
+                if (kb.matches(keyData, "tui.select.confirm") || keyData === "\n" || keyData === "\r") {
+                    this.advanceOrSubmit(i);
+                    return;
+                }
+                field.handleInput(keyData);
+                return;
+            }
+            return;
+        }
+        // Cursor on an option row (or an option-less field-only question handled above).
+        const opts = this.optionsFor(i);
+        // Numeric shortcuts select/toggle an option by its 1-based index.
+        if (keyData.length === 1 && keyData >= "1" && keyData <= "9") {
+            const index = keyData.charCodeAt(0) - 49; // '1' -> 0
+            if (index < opts.length) {
+                if (this.isMultiSelect(i)) {
+                    this.toggle(i, opts[index]);
+                }
+                else {
+                    this.drafts[i].selected = [opts[index]];
+                    this.drafts[i].cursorIndex = index;
+                }
+                this.rebuild();
+                this.syncFieldFocus();
+            }
+            return;
+        }
+        if (kb.matches(keyData, "tui.select.up")) {
+            this.moveCursor(-1);
+            return;
+        }
+        if (kb.matches(keyData, "tui.select.down")) {
+            this.moveCursor(1);
+            return;
+        }
+        if (n >= 2 && keyData === "\x1b[D") {
+            this.switchTab(-1);
+            return;
+        }
+        if (n >= 2 && keyData === "\x1b[C") {
+            this.switchTab(1);
+            return;
+        }
+        if (this.isMultiSelect(i) && keyData === " ") {
+            this.toggle(i, opts[this.drafts[i].cursorIndex]);
+            this.rebuild();
+            return;
+        }
+        if (kb.matches(keyData, "tui.select.confirm") || keyData === "\n" || keyData === "\r") {
+            const option = opts[this.drafts[i].cursorIndex];
+            if (option !== undefined && !this.isMultiSelect(i)) {
+                this.drafts[i].selected = [option];
+            }
+            this.advanceOrSubmit(i);
+        }
+    }
+    dispose() {
+        this.countdown?.dispose();
+    }
+}
+//# sourceMappingURL=ask-wizard.js.map