pi-agent-flow 1.8.39 → 2.0.0

package/dist/ask-user.js

@@ -1,1405 +0,0 @@
-/**
- * Ask Tool Extension - Interactive question UI for pi-coding-agent
- *
- * Refactored to use built-in TUI primitives (Container/Text/Spacer/SelectList/Editor)
- * and a custom box border instead of manual ANSI box drawing.
- */
-import { getMarkdownTheme } from "@mariozechner/pi-coding-agent";
-import { Type } from "@sinclair/typebox";
-import { appendStrategicHintOnce } from "./tool-utils.js";
-import { setPendingDecision } from "./notify-state.js";
-import { scrambleManager, runScrambleTimer } from "./scramble.js";
-import { stripAnsi } from "./render-utils.js";
-import { Container, decodeKittyPrintable, Editor, fuzzyFilter, Key, Markdown, matchesKey, Spacer, Text, truncateToWidth, wrapTextWithAnsi, } from "@mariozechner/pi-tui";
-import { renderSingleSelectRows } from "./single-select-layout.js";
-const ASK_USER_VERSION = "0.11.0";
-/**
- * Emit a flat `{ type: "string", enum: [...] }` JSON Schema instead of the
- * `anyOf`/`oneOf` shape that `Type.Union([Type.Literal()])` produces. Google's
- * function-calling API rejects the union form. Local copy of pi-ai's StringEnum
- * to avoid a peer dependency for one helper.
- */
-function StringEnum(values, options) {
-    return Type.Unsafe({
-        type: "string",
-        enum: [...values],
-        ...(options?.description ? { description: options.description } : {}),
-        ...(options?.default !== undefined ? { default: options.default } : {}),
-    });
-}
-function normalizeOptions(options) {
-    return options
-        .map((option) => {
-        if (typeof option === "string") {
-            return { title: option };
-        }
-        if (option && typeof option === "object" && typeof option.title === "string") {
-            return { title: option.title, description: option.description };
-        }
-        return null;
-    })
-        .filter((option) => option !== null);
-}
-function formatOptionsForMessage(options) {
-    return options
-        .map((option, index) => {
-        const desc = option.description ? ` — ${option.description}` : "";
-        return `${index + 1}. ${option.title}${desc}`;
-    })
-        .join("\n");
-}
-function normalizeOptionalComment(text) {
-    const trimmed = text?.trim();
-    return trimmed ? trimmed : undefined;
-}
-function createFreeformResponse(text) {
-    const trimmed = text?.trim();
-    return trimmed ? { kind: "freeform", text: trimmed } : null;
-}
-function createSelectionResponse(selections, comment) {
-    const normalizedSelections = selections.map((selection) => selection.trim()).filter(Boolean);
-    if (normalizedSelections.length === 0)
-        return null;
-    const normalizedComment = normalizeOptionalComment(comment);
-    return normalizedComment
-        ? { kind: "selection", selections: normalizedSelections, comment: normalizedComment }
-        : { kind: "selection", selections: normalizedSelections };
-}
-function formatResponseSummary(response) {
-    if (response.kind === "freeform")
-        return response.text;
-    const selections = response.selections.join(", ");
-    return response.comment ? `${selections} — ${response.comment}` : selections;
-}
-function buildCommentPrompt(prompt, selections) {
-    const label = selections.length === 1 ? "Selected option" : "Selected options";
-    const lines = selections.map((selection) => `- ${selection}`).join("\n");
-    return `${prompt}\n\n${label}:\n${lines}`;
-}
-function parseDialogSelections(input) {
-    return input
-        .split(",")
-        .map((selection) => selection.trim())
-        .filter(Boolean);
-}
-function isCancelledInput(value) {
-    return value === null || value === undefined;
-}
-function isSelectionResponse(response) {
-    return response.kind === "selection";
-}
-function createSelectListTheme(theme) {
-    return {
-        selectedPrefix: (t) => theme.fg("accent", t),
-        selectedText: (t) => theme.fg("accent", t),
-        description: (t) => theme.fg("muted", t),
-        scrollInfo: (t) => theme.fg("dim", t),
-        noMatch: (t) => theme.fg("warning", t),
-    };
-}
-function createEditorTheme(theme) {
-    return {
-        borderColor: (s) => theme.fg("accent", s),
-        selectList: createSelectListTheme(theme),
-    };
-}
-const BOX_BORDER_LEFT = "│ ";
-const BOX_BORDER_RIGHT = " │";
-const BOX_BORDER_OVERHEAD = BOX_BORDER_LEFT.length + BOX_BORDER_RIGHT.length;
-class BoxBorderTop {
-    color;
-    title;
-    titleColor;
-    constructor(color, title, titleColor) {
-        this.color = color;
-        this.title = title;
-        this.titleColor = titleColor;
-    }
-    invalidate() { }
-    render(width) {
-        const inner = Math.max(0, width - 2);
-        if (!this.title || inner < this.title.length + 4) {
-            return [this.color(`╭${"─".repeat(inner)}╮`)];
-        }
-        const label = ` ${this.title} `;
-        const remaining = inner - 1 - label.length;
-        const titleStyle = this.titleColor ?? this.color;
-        return [
-            this.color("╭─") + titleStyle(label) + this.color("─".repeat(Math.max(0, remaining)) + "╮"),
-        ];
-    }
-}
-class BoxBorderBottom {
-    color;
-    label;
-    labelColor;
-    constructor(color, label, labelColor) {
-        this.color = color;
-        this.label = label;
-        this.labelColor = labelColor;
-    }
-    invalidate() { }
-    render(width) {
-        const inner = Math.max(0, width - 2);
-        if (!this.label || inner < this.label.length + 4) {
-            return [this.color(`╰${"─".repeat(inner)}╯`)];
-        }
-        const tag = ` ${this.label} `;
-        const leftDashes = inner - tag.length - 1;
-        const style = this.labelColor ?? this.color;
-        return [
-            this.color("╰" + "─".repeat(Math.max(0, leftDashes))) + style(tag) + this.color("─╯"),
-        ];
-    }
-}
-function formatKeyList(keys) {
-    return keys.join("/");
-}
-function keybindingHint(theme, keybindings, keybinding, description) {
-    return `${theme.fg("dim", formatKeyList(keybindings.getKeys(keybinding)))}${theme.fg("muted", ` ${description}`)}`;
-}
-function literalHint(theme, key, description) {
-    return `${theme.fg("dim", key)}${theme.fg("muted", ` ${description}`)}`;
-}
-const DISABLED_SHORTCUT = {
-    disabled: true,
-    spec: null,
-    matches: ((_data) => false),
-};
-const SHORTCUT_DISABLE_VALUES = new Set(["off", "none", "disabled", ""]);
-function normalizeShortcutSpec(value) {
-    if (value === undefined)
-        return undefined;
-    if (value === null)
-        return null;
-    const trimmed = value.trim().toLowerCase();
-    if (SHORTCUT_DISABLE_VALUES.has(trimmed))
-        return null;
-    return trimmed;
-}
-function isValidShortcutSpec(spec) {
-    // KeyId is canonical lowercase: modifiers (`ctrl|shift|alt|super`) joined by `+`,
-    // plus a base key. We do a light syntactic sanity check; matchesKey() does the rest.
-    if (!spec)
-        return false;
-    if (!/^[a-z0-9+_\-!@#$%^&*()|~`'":;,./<>?[\]{}=\\]+$/i.test(spec))
-        return false;
-    if (spec.startsWith("+") || spec.endsWith("+"))
-        return false;
-    if (spec.includes("++"))
-        return false;
-    return true;
-}
-function buildShortcut(spec) {
-    return {
-        disabled: false,
-        spec,
-        matches: (data) => matchesKey(data, spec),
-    };
-}
-function resolveShortcut(paramValue, envValue, defaultSpec) {
-    const candidates = [paramValue, envValue, defaultSpec];
-    for (const raw of candidates) {
-        const normalized = normalizeShortcutSpec(raw);
-        if (normalized === undefined)
-            continue; // not provided, fall through
-        if (normalized === null)
-            return DISABLED_SHORTCUT; // explicit disable
-        if (isValidShortcutSpec(normalized))
-            return buildShortcut(normalized);
-        // Invalid spec: silently fall through to next candidate.
-    }
-    return DISABLED_SHORTCUT;
-}
-const ASK_OVERLAY_MAX_HEIGHT_RATIO = 0.85;
-const ASK_OVERLAY_WIDTH = "92%";
-const ASK_OVERLAY_MIN_WIDTH = 40;
-const SINGLE_SELECT_SPLIT_PANE_MIN_WIDTH = 84;
-const SINGLE_SELECT_SPLIT_PANE_LEFT_MIN_WIDTH = 32;
-const SINGLE_SELECT_SPLIT_PANE_RIGHT_MIN_WIDTH = 28;
-const SINGLE_SELECT_SPLIT_PANE_SEPARATOR = " │ ";
-const FREEFORM_SENTINEL = "\u270f\ufe0f Type custom response...";
-const COMMENT_TOGGLE_LABEL = "Add extra context after selection";
-const DEFAULT_OVERLAY_TOGGLE_KEY = "alt+o";
-const DEFAULT_COMMENT_TOGGLE_KEY = "ctrl+g";
-// Vim-style aliases for navigating option lists. ctrl+j/k are safe in the
-// searchable single-select because they don't collide with fuzzy-search input.
-const VIM_SELECT_UP_KEY = Key.ctrl("k");
-const VIM_SELECT_DOWN_KEY = Key.ctrl("j");
-function matchesSelectUp(data, keybindings) {
-    return (keybindings.matches(data, "tui.select.up") ||
-        matchesKey(data, Key.shift("tab")) ||
-        matchesKey(data, VIM_SELECT_UP_KEY));
-}
-function matchesSelectDown(data, keybindings) {
-    return (keybindings.matches(data, "tui.select.down") ||
-        matchesKey(data, Key.tab) ||
-        matchesKey(data, VIM_SELECT_DOWN_KEY));
-}
-function buildCustomUIOptions(displayMode, onHandle) {
-    switch (displayMode) {
-        case "inline":
-            return undefined;
-        case "overlay":
-            return {
-                overlay: true,
-                overlayOptions: {
-                    anchor: "center",
-                    width: ASK_OVERLAY_WIDTH,
-                    minWidth: ASK_OVERLAY_MIN_WIDTH,
-                    maxHeight: "85%",
-                    margin: 1,
-                },
-                ...(onHandle ? { onHandle } : {}),
-            };
-        default: {
-            const _exhaustive = displayMode;
-            void _exhaustive;
-            return {
-                overlay: true,
-                overlayOptions: {
-                    anchor: "center",
-                    width: ASK_OVERLAY_WIDTH,
-                    minWidth: ASK_OVERLAY_MIN_WIDTH,
-                    maxHeight: "85%",
-                    margin: 1,
-                },
-                ...(onHandle ? { onHandle } : {}),
-            };
-        }
-    }
-}
-class MultiSelectList {
-    options;
-    allowFreeform;
-    allowComment;
-    theme;
-    keybindings;
-    commentToggle;
-    selectedIndex = 0;
-    checked = new Set();
-    commentEnabled = false;
-    cachedWidth;
-    cachedLines;
-    onCancel;
-    onSubmit;
-    onEnterFreeform;
-    constructor(options, allowFreeform, allowComment, theme, keybindings, commentToggle) {
-        this.options = options;
-        this.allowFreeform = allowFreeform;
-        this.allowComment = allowComment;
-        this.theme = theme;
-        this.keybindings = keybindings;
-        this.commentToggle = commentToggle;
-    }
-    isCommentEnabled() {
-        return this.commentEnabled;
-    }
-    invalidate() {
-        this.cachedWidth = undefined;
-        this.cachedLines = undefined;
-    }
-    getItemCount() {
-        return this.options.length + (this.allowComment ? 1 : 0) + (this.allowFreeform ? 1 : 0);
-    }
-    getCommentToggleIndex() {
-        return this.allowComment ? this.options.length : null;
-    }
-    getFreeformIndex() {
-        return this.options.length + (this.allowComment ? 1 : 0);
-    }
-    isCommentToggleRow(index) {
-        const toggleIndex = this.getCommentToggleIndex();
-        return toggleIndex !== null && index === toggleIndex;
-    }
-    isFreeformRow(index) {
-        return this.allowFreeform && index === this.getFreeformIndex();
-    }
-    toggle(index) {
-        if (index < 0 || index >= this.options.length)
-            return;
-        if (this.checked.has(index))
-            this.checked.delete(index);
-        else
-            this.checked.add(index);
-    }
-    toggleComment() {
-        if (!this.allowComment)
-            return;
-        this.commentEnabled = !this.commentEnabled;
-        this.invalidate();
-    }
-    handleInput(data) {
-        if (this.keybindings.matches(data, "tui.select.cancel")) {
-            this.onCancel?.();
-            return;
-        }
-        const count = this.getItemCount();
-        if (count === 0) {
-            this.onCancel?.();
-            return;
-        }
-        if (this.allowComment && !this.commentToggle.disabled && this.commentToggle.matches(data)) {
-            this.toggleComment();
-            return;
-        }
-        if (matchesSelectUp(data, this.keybindings)) {
-            this.selectedIndex = this.selectedIndex === 0 ? count - 1 : this.selectedIndex - 1;
-            this.invalidate();
-            return;
-        }
-        if (matchesSelectDown(data, this.keybindings)) {
-            this.selectedIndex = this.selectedIndex === count - 1 ? 0 : this.selectedIndex + 1;
-            this.invalidate();
-            return;
-        }
-        const numMatch = data.match(/^[1-9]$/);
-        if (numMatch) {
-            const idx = Number.parseInt(numMatch[0], 10) - 1;
-            if (idx >= 0 && idx < this.options.length) {
-                this.toggle(idx);
-                this.selectedIndex = Math.min(idx, count - 1);
-                this.invalidate();
-            }
-            return;
-        }
-        if (matchesKey(data, Key.space)) {
-            if (this.isCommentToggleRow(this.selectedIndex)) {
-                this.toggleComment();
-                return;
-            }
-            if (this.isFreeformRow(this.selectedIndex)) {
-                this.onEnterFreeform?.();
-                return;
-            }
-            this.toggle(this.selectedIndex);
-            this.invalidate();
-            return;
-        }
-        if (this.keybindings.matches(data, "tui.select.confirm")) {
-            if (this.isCommentToggleRow(this.selectedIndex)) {
-                this.toggleComment();
-                return;
-            }
-            if (this.isFreeformRow(this.selectedIndex)) {
-                this.onEnterFreeform?.();
-                return;
-            }
-            const selectedTitles = Array.from(this.checked)
-                .sort((a, b) => a - b)
-                .map((i) => this.options[i]?.title)
-                .filter((t) => !!t);
-            const fallback = this.options[this.selectedIndex]?.title;
-            const result = selectedTitles.length > 0 ? selectedTitles : fallback ? [fallback] : [];
-            if (result.length > 0)
-                this.onSubmit?.(result);
-            else
-                this.onCancel?.();
-        }
-    }
-    render(width) {
-        if (this.cachedLines && this.cachedWidth === width) {
-            return this.cachedLines;
-        }
-        const theme = this.theme;
-        const count = this.getItemCount();
-        const maxVisible = Math.min(count, 10);
-        if (count === 0) {
-            this.cachedLines = [theme.fg("warning", "No options")];
-            this.cachedWidth = width;
-            return this.cachedLines;
-        }
-        const startIndex = Math.max(0, Math.min(this.selectedIndex - Math.floor(maxVisible / 2), count - maxVisible));
-        const endIndex = Math.min(startIndex + maxVisible, count);
-        const lines = [];
-        for (let i = startIndex; i < endIndex; i++) {
-            const isSelected = i === this.selectedIndex;
-            const prefix = isSelected ? theme.fg("accent", "▶") : " ";
-            if (this.isCommentToggleRow(i)) {
-                const checkbox = this.commentEnabled ? theme.fg("success", "[✔]") : theme.fg("dim", "[ ]");
-                const label = isSelected
-                    ? theme.fg("accent", theme.bold(COMMENT_TOGGLE_LABEL))
-                    : theme.fg("text", theme.bold(COMMENT_TOGGLE_LABEL));
-                lines.push(truncateToWidth(`${prefix}   ${checkbox} ${label}`, width, ""));
-                continue;
-            }
-            if (this.isFreeformRow(i)) {
-                const label = theme.fg("text", theme.bold("Type something."));
-                const desc = theme.fg("muted", "Enter a custom response");
-                const line = `${prefix}   ${label} ${theme.fg("dim", "—")} ${desc}`;
-                lines.push(truncateToWidth(line, width, ""));
-                continue;
-            }
-            const option = this.options[i];
-            if (!option)
-                continue;
-            const checkbox = this.checked.has(i) ? theme.fg("success", "[✔]") : theme.fg("dim", "[ ]");
-            const num = theme.fg("dim", `${i + 1}.`);
-            const title = isSelected
-                ? theme.fg("accent", theme.bold(option.title))
-                : theme.fg("text", theme.bold(option.title));
-            const firstLine = `${prefix} ${num} ${checkbox} ${title}`;
-            lines.push(truncateToWidth(firstLine, width, ""));
-            if (option.description) {
-                const indent = "      ";
-                const wrapWidth = Math.max(10, width - indent.length);
-                const wrapped = wrapTextWithAnsi(option.description, wrapWidth);
-                for (const w of wrapped) {
-                    lines.push(truncateToWidth(indent + theme.fg("muted", w), width, ""));
-                }
-            }
-        }
-        if (startIndex > 0 || endIndex < count) {
-            lines.push(theme.fg("dim", truncateToWidth(`  (${this.selectedIndex + 1}/${count})`, width, "")));
-        }
-        this.cachedWidth = width;
-        this.cachedLines = lines;
-        return lines;
-    }
-}
-class WrappedSingleSelectList {
-    options;
-    allowFreeform;
-    allowComment;
-    theme;
-    keybindings;
-    commentToggle;
-    selectedIndex = 0;
-    searchQuery = "";
-    commentEnabled = false;
-    maxVisibleRows = 12;
-    cachedWidth;
-    cachedLines;
-    onCancel;
-    onSubmit;
-    onEnterFreeform;
-    constructor(options, allowFreeform, allowComment, theme, keybindings, commentToggle) {
-        this.options = options;
-        this.allowFreeform = allowFreeform;
-        this.allowComment = allowComment;
-        this.theme = theme;
-        this.keybindings = keybindings;
-        this.commentToggle = commentToggle;
-    }
-    isCommentEnabled() {
-        return this.commentEnabled;
-    }
-    setMaxVisibleRows(rows) {
-        const next = Math.max(1, Math.floor(rows));
-        if (next !== this.maxVisibleRows) {
-            this.maxVisibleRows = next;
-            this.invalidate();
-        }
-    }
-    invalidate() {
-        this.cachedWidth = undefined;
-        this.cachedLines = undefined;
-    }
-    getFilteredOptions() {
-        return fuzzyFilter(this.options, this.searchQuery, (option) => `${option.title} ${option.description ?? ""}`);
-    }
-    getItemCount(filteredOptions) {
-        return filteredOptions.length + (this.allowComment ? 1 : 0) + (this.allowFreeform ? 1 : 0);
-    }
-    isCommentToggleRow(index, filteredOptions) {
-        return this.allowComment && index === filteredOptions.length;
-    }
-    isFreeformRow(index, filteredOptions) {
-        return this.allowFreeform && index === filteredOptions.length + (this.allowComment ? 1 : 0);
-    }
-    toggleComment() {
-        if (!this.allowComment)
-            return;
-        this.commentEnabled = !this.commentEnabled;
-        this.invalidate();
-    }
-    setSearchQuery(query) {
-        this.searchQuery = query;
-        this.selectedIndex = 0;
-        this.invalidate();
-    }
-    popSearchCharacter() {
-        if (!this.searchQuery)
-            return;
-        const characters = [...this.searchQuery];
-        characters.pop();
-        this.setSearchQuery(characters.join(""));
-    }
-    getPrintableInput(data) {
-        const kittyPrintable = decodeKittyPrintable(data);
-        if (kittyPrintable !== undefined)
-            return kittyPrintable;
-        const characters = [...data];
-        if (characters.length !== 1)
-            return null;
-        const [character] = characters;
-        if (!character)
-            return null;
-        const code = character.charCodeAt(0);
-        if (code < 32 || code === 0x7f || (code >= 0x80 && code <= 0x9f)) {
-            return null;
-        }
-        return character;
-    }
-    styleListLine(line, width, isSelected) {
-        const trimmed = line.trim();
-        if (trimmed.startsWith("(")) {
-            return truncateToWidth(this.theme.fg("dim", line), width, "");
-        }
-        if (isSelected) {
-            return truncateToWidth(this.theme.fg("accent", this.theme.bold(line)), width, "");
-        }
-        if (line.startsWith("      ")) {
-            return truncateToWidth(this.theme.fg("muted", line), width, "");
-        }
-        if (line.startsWith("▶")) {
-            return truncateToWidth(this.theme.fg("accent", this.theme.bold(line)), width, "");
-        }
-        return truncateToWidth(this.theme.fg("text", line), width, "");
-    }
-    getSplitPaneWidths(width) {
-        if (width < SINGLE_SELECT_SPLIT_PANE_MIN_WIDTH)
-            return null;
-        const availableWidth = width - SINGLE_SELECT_SPLIT_PANE_SEPARATOR.length;
-        if (availableWidth < SINGLE_SELECT_SPLIT_PANE_LEFT_MIN_WIDTH + SINGLE_SELECT_SPLIT_PANE_RIGHT_MIN_WIDTH) {
-            return null;
-        }
-        const preferredLeftWidth = Math.floor(availableWidth * 0.42);
-        const left = Math.max(SINGLE_SELECT_SPLIT_PANE_LEFT_MIN_WIDTH, Math.min(preferredLeftWidth, availableWidth - SINGLE_SELECT_SPLIT_PANE_RIGHT_MIN_WIDTH));
-        const right = availableWidth - left;
-        if (right < SINGLE_SELECT_SPLIT_PANE_RIGHT_MIN_WIDTH)
-            return null;
-        return { left, right };
-    }
-    buildListLines(width, filteredOptions, hideDescriptions = false) {
-        const lines = [];
-        const count = this.getItemCount(filteredOptions);
-        const searchValue = this.searchQuery ? this.theme.fg("text", this.searchQuery) : this.theme.fg("dim", "type to filter");
-        lines.push(truncateToWidth(`${this.theme.fg("accent", "Filter:")} ${searchValue}`, width, ""));
-        if (this.searchQuery && filteredOptions.length === 0) {
-            lines.push(truncateToWidth(this.theme.fg("warning", "No matching options"), width, ""));
-        }
-        if (count === 0) {
-            if (!this.searchQuery) {
-                lines.push(truncateToWidth(this.theme.fg("warning", "No options"), width, ""));
-            }
-            return lines.slice(0, this.maxVisibleRows);
-        }
-        const maxRows = Math.max(1, this.maxVisibleRows - lines.length);
-        const optionRows = renderSingleSelectRows({
-            options: filteredOptions,
-            selectedIndex: this.selectedIndex,
-            width,
-            allowFreeform: this.allowFreeform,
-            allowComment: this.allowComment,
-            commentEnabled: this.commentEnabled,
-            maxRows,
-            hideDescriptions,
-        });
-        const optionLines = optionRows.map((row) => this.styleListLine(row.line, width, row.selected));
-        lines.push(...optionLines);
-        return lines.slice(0, this.maxVisibleRows);
-    }
-    buildPreviewLines(width, filteredOptions, maxLines) {
-        if (maxLines <= 0)
-            return [];
-        let mdTheme;
-        try {
-            mdTheme = getMarkdownTheme();
-        }
-        catch { }
-        let md = "";
-        if (this.isCommentToggleRow(this.selectedIndex, filteredOptions)) {
-            md += "## Additional context\n\n";
-            md += `Currently: **${this.commentEnabled ? "Enabled" : "Disabled"}**\n\n`;
-            md += "Turn this on when the selected option needs extra explanation before the tool submits.\n";
-        }
-        else if (this.isFreeformRow(this.selectedIndex, filteredOptions)) {
-            md += "## Custom response\n\n";
-            md += "Open the editor to write **any** answer.\n\n";
-            md += "*Use this when none of the listed options fit.*\n";
-            if (this.searchQuery) {
-                md += `\n> Current filter: \`${this.searchQuery}\`\n`;
-            }
-        }
-        else {
-            const selected = filteredOptions[this.selectedIndex];
-            if (!selected) {
-                md += "*No option selected*\n";
-            }
-            else {
-                md += `## ${selected.title}\n\n`;
-                if (selected.description?.trim()) {
-                    md += `${selected.description}\n`;
-                }
-                else {
-                    md += "*No additional details provided for this option.*\n";
-                }
-                md += `\n---\n\nPress \`Enter\` to select this option.\n`;
-                if (this.searchQuery) {
-                    md += `\n> Filter: \`${this.searchQuery}\`\n`;
-                }
-            }
-        }
-        let lines;
-        if (mdTheme) {
-            const mdComponent = new Markdown(md.trim(), 0, 0, mdTheme);
-            lines = mdComponent.render(width);
-        }
-        else {
-            lines = [];
-            for (const line of wrapTextWithAnsi(md.trim(), Math.max(10, width))) {
-                lines.push(truncateToWidth(line, width, ""));
-            }
-        }
-        while (lines.length > 0 && lines[lines.length - 1]?.trim() === "") {
-            lines.pop();
-        }
-        if (lines.length <= maxLines)
-            return lines;
-        if (maxLines === 1)
-            return [truncateToWidth(this.theme.fg("dim", "…"), width, "")];
-        const visibleLines = lines.slice(0, maxLines - 1);
-        visibleLines.push(truncateToWidth(this.theme.fg("dim", "…"), width, ""));
-        return visibleLines;
-    }
-    handleInput(data) {
-        if (this.searchQuery && matchesKey(data, Key.escape)) {
-            this.setSearchQuery("");
-            return;
-        }
-        if (this.keybindings.matches(data, "tui.select.cancel")) {
-            this.onCancel?.();
-            return;
-        }
-        if (this.allowComment && !this.commentToggle.disabled && this.commentToggle.matches(data)) {
-            this.toggleComment();
-            return;
-        }
-        const filteredOptions = this.getFilteredOptions();
-        const count = this.getItemCount(filteredOptions);
-        if (matchesSelectUp(data, this.keybindings) && count > 0) {
-            this.selectedIndex = this.selectedIndex === 0 ? count - 1 : this.selectedIndex - 1;
-            this.invalidate();
-            return;
-        }
-        if (matchesSelectDown(data, this.keybindings) && count > 0) {
-            this.selectedIndex = this.selectedIndex === count - 1 ? 0 : this.selectedIndex + 1;
-            this.invalidate();
-            return;
-        }
-        const numMatch = data.match(/^[1-9]$/);
-        if (numMatch && filteredOptions.length > 0) {
-            const idx = Number.parseInt(numMatch[0], 10) - 1;
-            if (idx >= 0 && idx < filteredOptions.length) {
-                this.selectedIndex = idx;
-                this.invalidate();
-                return;
-            }
-        }
-        if (matchesKey(data, Key.space) && count > 0 && this.isCommentToggleRow(this.selectedIndex, filteredOptions)) {
-            this.toggleComment();
-            return;
-        }
-        if (this.keybindings.matches(data, "tui.select.confirm") && count > 0) {
-            if (this.isCommentToggleRow(this.selectedIndex, filteredOptions)) {
-                this.toggleComment();
-                return;
-            }
-            if (this.isFreeformRow(this.selectedIndex, filteredOptions)) {
-                this.onEnterFreeform?.();
-                return;
-            }
-            const result = filteredOptions[this.selectedIndex]?.title;
-            if (result)
-                this.onSubmit?.(result);
-            else
-                this.onCancel?.();
-            return;
-        }
-        if (this.keybindings.matches(data, "tui.editor.deleteCharBackward") || matchesKey(data, Key.backspace)) {
-            this.popSearchCharacter();
-            return;
-        }
-        const printableInput = this.getPrintableInput(data);
-        if (printableInput) {
-            this.setSearchQuery(this.searchQuery + printableInput);
-        }
-    }
-    render(width) {
-        if (this.cachedLines && this.cachedWidth === width) {
-            return this.cachedLines;
-        }
-        const filteredOptions = this.getFilteredOptions();
-        const count = this.getItemCount(filteredOptions);
-        this.selectedIndex = count > 0 ? Math.max(0, Math.min(this.selectedIndex, count - 1)) : 0;
-        const splitPane = this.getSplitPaneWidths(width);
-        let lines;
-        if (!splitPane) {
-            lines = this.buildListLines(width, filteredOptions);
-        }
-        else {
-            const listLines = this.buildListLines(splitPane.left, filteredOptions, true);
-            const previewLines = this.buildPreviewLines(splitPane.right, filteredOptions, this.maxVisibleRows);
-            const rowCount = Math.min(this.maxVisibleRows, Math.max(listLines.length, previewLines.length));
-            const separator = this.theme.fg("dim", SINGLE_SELECT_SPLIT_PANE_SEPARATOR);
-            lines = Array.from({ length: rowCount }, (_, index) => {
-                const left = truncateToWidth(listLines[index] ?? "", splitPane.left, "", true);
-                const right = truncateToWidth(previewLines[index] ?? "", splitPane.right, "");
-                return `${left}${separator}${right}`;
-            });
-        }
-        this.cachedWidth = width;
-        this.cachedLines = lines;
-        return lines;
-    }
-}
-/**
- * Interactive ask UI. Uses a root Container for layout and swaps the center
- * component between SelectList/MultiSelectList and an Editor (freeform mode).
- */
-class AskComponent extends Container {
-    question;
-    context;
-    options;
-    allowMultiple;
-    allowFreeform;
-    allowComment;
-    displayMode;
-    tui;
-    theme;
-    keybindings;
-    shortcuts;
-    onDone;
-    mode = "select";
-    pendingSelections = [];
-    freeformDraft = "";
-    commentDraft = "";
-    // Static layout components
-    titleText;
-    questionText;
-    contextComponent;
-    modeContainer;
-    helpText;
-    // Mode components
-    singleSelectList;
-    multiSelectList;
-    editor;
-    // Focusable - propagate to Editor for IME cursor positioning
-    _focused = false;
-    get focused() {
-        return this._focused;
-    }
-    set focused(value) {
-        this._focused = value;
-        if (this.editor && (this.mode === "freeform" || this.mode === "comment")) {
-            this.editor.focused = value;
-        }
-    }
-    constructor(question, context, options, allowMultiple, allowFreeform, allowComment, displayMode, tui, theme, keybindings, shortcuts, onDone) {
-        super();
-        this.question = question;
-        this.context = context;
-        this.options = options;
-        this.allowMultiple = allowMultiple;
-        this.allowFreeform = allowFreeform;
-        this.allowComment = allowComment;
-        this.displayMode = displayMode;
-        this.tui = tui;
-        this.theme = theme;
-        this.keybindings = keybindings;
-        this.shortcuts = shortcuts;
-        this.onDone = onDone;
-        // Layout skeleton
-        this.addChild(new BoxBorderTop((s) => theme.fg("accent", s), "ask_user", (s) => theme.fg("dim", theme.bold(s))));
-        this.addChild(new Spacer(1));
-        this.titleText = new Text("", 1, 0);
-        this.addChild(this.titleText);
-        this.addChild(new Spacer(1));
-        this.questionText = new Text("", 1, 0);
-        this.addChild(this.questionText);
-        if (this.context) {
-            this.addChild(new Spacer(1));
-            let mdTheme;
-            try {
-                mdTheme = getMarkdownTheme();
-            }
-            catch { }
-            if (mdTheme) {
-                this.contextComponent = new Markdown("", 1, 0, mdTheme);
-            }
-            else {
-                this.contextComponent = new Text("", 1, 0);
-            }
-            this.addChild(this.contextComponent);
-        }
-        this.addChild(new Spacer(1));
-        this.modeContainer = new Container();
-        this.addChild(this.modeContainer);
-        this.addChild(new Spacer(1));
-        this.helpText = new Text("", 1, 0);
-        this.addChild(this.helpText);
-        this.addChild(new Spacer(1));
-        this.addChild(new BoxBorderBottom((s) => theme.fg("accent", s), `v${ASK_USER_VERSION}`, (s) => theme.fg("dim", s)));
-        this.updateStaticText();
-        this.showSelectMode();
-    }
-    invalidate() {
-        super.invalidate();
-        this.updateStaticText();
-        this.updateHelpText();
-    }
-    render(width) {
-        const innerWidth = Math.max(1, width - BOX_BORDER_OVERHEAD);
-        if (this.mode === "select" && !this.allowMultiple) {
-            const overlayMaxHeight = Math.max(12, Math.floor(this.tui.terminal.rows * ASK_OVERLAY_MAX_HEIGHT_RATIO));
-            const staticLines = this.countStaticLines(innerWidth);
-            const availableOptionRows = Math.max(4, overlayMaxHeight - staticLines);
-            this.ensureSingleSelectList().setMaxVisibleRows(availableOptionRows);
-        }
-        // Render children at the inner width (excluding side border characters)
-        const rawLines = super.render(innerWidth);
-        // First and last lines are the top/bottom box borders — pass through at full width.
-        // All inner lines get wrapped with side borders.
-        const borderColor = (s) => this.theme.fg("accent", s);
-        const titleColor = (s) => this.theme.fg("dim", this.theme.bold(s));
-        return rawLines.map((line, index) => {
-            if (index === 0 || index === rawLines.length - 1) {
-                // Box top/bottom borders already rendered at innerWidth — re-render at full width
-                if (index === 0)
-                    return new BoxBorderTop(borderColor, "ask_user", titleColor).render(width)[0];
-                return new BoxBorderBottom(borderColor, `v${ASK_USER_VERSION}`, (s) => this.theme.fg("dim", s)).render(width)[0];
-            }
-            const padded = truncateToWidth(line, innerWidth, "", true);
-            return `${borderColor(BOX_BORDER_LEFT)}${padded}${borderColor(BOX_BORDER_RIGHT)}`;
-        });
-    }
-    countWrappedLines(text, width) {
-        return Math.max(1, wrapTextWithAnsi(text, Math.max(10, width - 2)).length);
-    }
-    countStaticLines(width) {
-        const titleLines = 1;
-        const questionLines = this.countWrappedLines(this.question, width);
-        const contextLines = this.context ? 1 + this.countWrappedLines(this.context, width) : 0;
-        const helpLines = 1;
-        const borderLines = 2;
-        const spacerLines = this.context ? 6 : 5;
-        return borderLines + spacerLines + titleLines + questionLines + contextLines + helpLines;
-    }
-    updateStaticText() {
-        const theme = this.theme;
-        const title = this.mode === "comment" ? "Optional comment" : "Question";
-        this.titleText.setText(theme.fg("accent", theme.bold(title)));
-        this.questionText.setText(theme.fg("text", theme.bold(this.question)));
-        if (this.contextComponent && this.context) {
-            if (this.contextComponent instanceof Markdown) {
-                this.contextComponent.setText(`**Context:**\n${this.context}`);
-            }
-            else {
-                this.contextComponent.setText(`${theme.fg("accent", theme.bold("Context:"))}\n${theme.fg("dim", this.context)}`);
-            }
-        }
-    }
-    updateHelpText() {
-        const theme = this.theme;
-        const overlayHint = this.displayMode === "overlay" && !this.shortcuts.overlayToggle.disabled
-            ? literalHint(theme, this.shortcuts.overlayToggle.spec, "hide")
-            : null;
-        const commentHint = this.allowComment && !this.shortcuts.commentToggle.disabled
-            ? literalHint(theme, this.shortcuts.commentToggle.spec, "toggle context")
-            : null;
-        if (this.mode === "freeform" || this.mode === "comment") {
-            const alternateCancelKeys = this.keybindings
-                .getKeys("tui.select.cancel")
-                .filter((key) => key !== "escape" && key !== "esc");
-            const hints = [
-                keybindingHint(theme, this.keybindings, "tui.input.submit", this.mode === "comment" ? "submit/skip" : "submit"),
-                keybindingHint(theme, this.keybindings, "tui.input.newLine", "newline"),
-                literalHint(theme, "esc", "back"),
-                overlayHint,
-                alternateCancelKeys.length > 0 ? literalHint(theme, formatKeyList(alternateCancelKeys), "cancel") : null,
-            ]
-                .filter((hint) => !!hint)
-                .join(" • ");
-            this.helpText.setText(theme.fg("dim", hints));
-            return;
-        }
-        if (this.allowMultiple) {
-            const hints = [
-                literalHint(theme, "↑↓", "navigate"),
-                literalHint(theme, "space", "toggle"),
-                commentHint,
-                overlayHint,
-                keybindingHint(theme, this.keybindings, "tui.select.confirm", "submit"),
-                keybindingHint(theme, this.keybindings, "tui.select.cancel", "cancel"),
-            ]
-                .filter((hint) => !!hint)
-                .join(" • ");
-            this.helpText.setText(theme.fg("dim", hints));
-        }
-        else {
-            const alternateCancelKeys = this.keybindings
-                .getKeys("tui.select.cancel")
-                .filter((key) => key !== "escape" && key !== "esc");
-            const hints = [
-                literalHint(theme, "type", "filter"),
-                keybindingHint(theme, this.keybindings, "tui.editor.deleteCharBackward", "erase"),
-                literalHint(theme, "↑↓", "navigate"),
-                commentHint,
-                overlayHint,
-                keybindingHint(theme, this.keybindings, "tui.select.confirm", "select"),
-                literalHint(theme, "esc", "clear/cancel"),
-                alternateCancelKeys.length > 0
-                    ? literalHint(theme, formatKeyList(alternateCancelKeys), "cancel")
-                    : null,
-            ]
-                .filter((hint) => !!hint)
-                .join(" • ");
-            this.helpText.setText(theme.fg("dim", hints));
-        }
-    }
-    ensureSingleSelectList() {
-        if (this.singleSelectList)
-            return this.singleSelectList;
-        const list = new WrappedSingleSelectList(this.options, this.allowFreeform, this.allowComment, this.theme, this.keybindings, this.shortcuts.commentToggle);
-        list.onSubmit = (result) => this.handleSelectionSubmit([result], list.isCommentEnabled());
-        list.onCancel = () => this.onDone(null);
-        list.onEnterFreeform = () => this.showFreeformMode();
-        this.singleSelectList = list;
-        return list;
-    }
-    ensureMultiSelectList() {
-        if (this.multiSelectList)
-            return this.multiSelectList;
-        const list = new MultiSelectList(this.options, this.allowFreeform, this.allowComment, this.theme, this.keybindings, this.shortcuts.commentToggle);
-        list.onCancel = () => this.onDone(null);
-        list.onSubmit = (result) => this.handleSelectionSubmit(result, list.isCommentEnabled());
-        list.onEnterFreeform = () => this.showFreeformMode();
-        this.multiSelectList = list;
-        return list;
-    }
-    ensureEditor() {
-        if (this.editor)
-            return this.editor;
-        const editor = new Editor(this.tui, createEditorTheme(this.theme));
-        editor.disableSubmit = false;
-        editor.onSubmit = (text) => {
-            this.handleEditorSubmit(text);
-        };
-        this.editor = editor;
-        return editor;
-    }
-    saveEditorDraft() {
-        if (!this.editor)
-            return;
-        const getText = this.editor.getText;
-        if (typeof getText !== "function")
-            return;
-        const currentText = String(getText.call(this.editor) ?? "");
-        if (this.mode === "freeform") {
-            this.freeformDraft = currentText;
-        }
-        else if (this.mode === "comment") {
-            this.commentDraft = currentText;
-        }
-    }
-    setEditorText(text) {
-        const editor = this.ensureEditor();
-        const setText = editor.setText;
-        if (typeof setText === "function") {
-            setText.call(editor, text);
-        }
-    }
-    handleSelectionSubmit(selections, wantsComment) {
-        if (this.allowComment && wantsComment) {
-            this.pendingSelections = selections;
-            this.commentDraft = "";
-            this.showCommentMode();
-            return;
-        }
-        this.onDone(createSelectionResponse(selections));
-    }
-    handleEditorSubmit(text) {
-        if (this.mode === "freeform") {
-            this.onDone(createFreeformResponse(text));
-            return;
-        }
-        if (this.mode === "comment") {
-            this.commentDraft = text;
-            this.onDone(createSelectionResponse(this.pendingSelections, text));
-        }
-    }
-    showSelectMode() {
-        if (this.mode === "freeform" || this.mode === "comment") {
-            this.saveEditorDraft();
-        }
-        this.mode = "select";
-        this.pendingSelections = [];
-        this.modeContainer.clear();
-        if (this.allowMultiple) {
-            this.modeContainer.addChild(this.ensureMultiSelectList());
-        }
-        else {
-            this.modeContainer.addChild(this.ensureSingleSelectList());
-        }
-        this.updateHelpText();
-        this.invalidate();
-        this.tui.requestRender();
-    }
-    showFreeformMode() {
-        if (this.mode === "comment") {
-            this.saveEditorDraft();
-        }
-        this.mode = "freeform";
-        this.modeContainer.clear();
-        const editor = this.ensureEditor();
-        this.setEditorText(this.freeformDraft);
-        editor.focused = this._focused;
-        this.modeContainer.addChild(new Text(this.theme.fg("accent", this.theme.bold("Custom response")), 1, 0));
-        this.modeContainer.addChild(new Spacer(1));
-        this.modeContainer.addChild(editor);
-        this.updateHelpText();
-        this.invalidate();
-        this.tui.requestRender();
-    }
-    showCommentMode() {
-        if (this.mode === "freeform") {
-            this.saveEditorDraft();
-        }
-        this.mode = "comment";
-        this.modeContainer.clear();
-        const editor = this.ensureEditor();
-        this.setEditorText(this.commentDraft);
-        editor.focused = this._focused;
-        const selectedLabel = this.pendingSelections.length === 1 ? "Selected option:" : "Selected options:";
-        this.modeContainer.addChild(new Text(this.theme.fg("accent", this.theme.bold(selectedLabel)), 1, 0));
-        this.modeContainer.addChild(new Text(this.theme.fg("text", this.pendingSelections.join(", ")), 1, 0));
-        this.modeContainer.addChild(new Spacer(1));
-        this.modeContainer.addChild(editor);
-        this.updateHelpText();
-        this.invalidate();
-        this.tui.requestRender();
-    }
-    handleInput(data) {
-        if (this.mode === "freeform" || this.mode === "comment") {
-            if (matchesKey(data, Key.escape)) {
-                this.showSelectMode();
-                return;
-            }
-            if (this.keybindings.matches(data, "tui.select.cancel")) {
-                this.onDone(null);
-                return;
-            }
-            this.ensureEditor().handleInput(data);
-            this.tui.requestRender();
-            return;
-        }
-        if (this.allowMultiple) {
-            this.ensureMultiSelectList().handleInput?.(data);
-            this.tui.requestRender();
-            return;
-        }
-        this.ensureSingleSelectList().handleInput?.(data);
-        this.tui.requestRender();
-    }
-}
-/**
- * RPC/headless fallback: use dialog methods (select/input) instead of the rich TUI overlay.
- * ctx.ui.custom() returns undefined in RPC mode, so we degrade gracefully.
- */
-async function askViaDialogs(ui, question, context, options, allowMultiple, allowFreeform, allowComment, allowCancel, timeout) {
-    const dialogOpts = {};
-    if (timeout)
-        dialogOpts.timeout = timeout;
-    if (!allowCancel)
-        dialogOpts.allowCancel = false;
-    const prompt = context ? `${question}\n\nContext:\n${context}` : question;
-    if (allowMultiple) {
-        const optionList = formatOptionsForMessage(options);
-        const rawSelections = await ui.input(`${prompt}\n\nOptions (select one or more):\n${optionList}`, "Type your selection(s)...", dialogOpts);
-        if (isCancelledInput(rawSelections))
-            return null;
-        const selections = parseDialogSelections(rawSelections);
-        if (selections.length === 0)
-            return null;
-        if (!allowComment) {
-            return createSelectionResponse(selections);
-        }
-        const comment = await ui.input(buildCommentPrompt(prompt, selections), "Optional comment (press Enter to skip)...", dialogOpts);
-        return createSelectionResponse(selections, comment);
-    }
-    const selectOptions = options.map((o) => o.title);
-    if (allowFreeform)
-        selectOptions.push(FREEFORM_SENTINEL);
-    const selected = await ui.select(prompt, selectOptions, dialogOpts);
-    if (isCancelledInput(selected))
-        return null;
-    if (selected === FREEFORM_SENTINEL) {
-        const answer = await ui.input(prompt, "Type your answer...", dialogOpts);
-        if (isCancelledInput(answer))
-            return null;
-        return createFreeformResponse(answer);
-    }
-    if (!allowComment) {
-        return createSelectionResponse([selected]);
-    }
-    const comment = await ui.input(buildCommentPrompt(prompt, [selected]), "Optional comment (press Enter to skip)...", dialogOpts);
-    return createSelectionResponse([selected], comment);
-}
-export function createAskUserTool() {
-    return {
-        name: "ask_user",
-        label: "Ask User",
-        description: "Ask the user a question with optional multiple-choice answers. Use this to gather information interactively. Ask exactly one focused question per call. Before calling, gather context with tools (read/web/ref) and pass a short summary via the context field. When presenting options, mark your recommended choice with [preferred] and place it first. Base your recommendation on evidence gathered from tools or investigation.",
-        promptSnippet: "Ask the user one focused question with optional multiple-choice answers to gather information interactively",
-        promptGuidelines: [
-            "Before calling ask_user, gather context with tools (read/web/ref) and pass a short summary via the context field.",
-            "Use ask_user when the user's intent is ambiguous, when a decision requires explicit user input, or when multiple valid options exist.",
-            "Ask exactly one focused question per ask_user call.",
-            "Do not combine multiple numbered, multipart, or unrelated questions into one ask_user prompt.",
-        ],
-        parameters: Type.Object({
-            question: Type.String({ description: "The question to ask the user" }),
-            context: Type.Optional(Type.String({
-                description: "Relevant context to show before the question (summary of findings)",
-            })),
-            options: Type.Optional(Type.Array(Type.Union([
-                Type.String({ description: "Short title for this option" }),
-                Type.Object({
-                    title: Type.String({ description: "Short title for this option" }),
-                    description: Type.Optional(Type.String({ description: "Longer description explaining this option" })),
-                }),
-            ]), { description: "List of options for the user to choose from" })),
-            allowMultiple: Type.Optional(Type.Boolean({ description: "Allow selecting multiple options. Default: false" })),
-            allowFreeform: Type.Optional(Type.Boolean({ description: "Add a freeform text option. Default: true" })),
-            allowComment: Type.Optional(Type.Boolean({ description: "Collect an optional comment after selecting one or more options. Default: false" })),
-            allowCancel: Type.Optional(Type.Boolean({ description: "Allow the user to cancel without answering. Default: true" })),
-            displayMode: Type.Optional(StringEnum(["overlay", "inline"], {
-                description: "UI rendering mode. 'overlay' shows a centered modal, 'inline' renders in-place. Default: PI_ASK_USER_DISPLAY_MODE env var if set, otherwise 'overlay'. Omit to respect the user's configured preference.",
-            })),
-            overlayToggleKey: Type.Optional(Type.String({
-                description: "Shortcut for hiding/showing the overlay popup (overlay mode only), e.g. 'alt+o' or 'ctrl+shift+h'. Pass 'off' to disable. Default: PI_ASK_USER_OVERLAY_TOGGLE_KEY env var if set, otherwise 'alt+o'.",
-            })),
-            commentToggleKey: Type.Optional(Type.String({
-                description: "Shortcut for toggling the optional comment/extra-context row when allowComment is true, e.g. 'ctrl+g'. Pass 'off' to disable. Default: PI_ASK_USER_COMMENT_TOGGLE_KEY env var if set, otherwise 'ctrl+g'.",
-            })),
-            timeout: Type.Optional(Type.Number({ description: "Auto-dismiss after N milliseconds. Returns null (cancelled) when expired." })),
-        }),
-        async execute(_toolCallId, params, signal, onUpdate, ctx) {
-            setPendingDecision();
-            if (signal?.aborted) {
-                return {
-                    content: [{ type: "text", text: "Cancelled" }],
-                    details: { question: params.question, options: [], response: null, cancelled: true },
-                };
-            }
-            const { question, context, options: rawOptions = [], allowMultiple = false, allowFreeform = true, allowComment = false, allowCancel = true, displayMode, overlayToggleKey, commentToggleKey, timeout, } = params;
-            const envMode = process.env.PI_ASK_USER_DISPLAY_MODE;
-            const envDisplayMode = envMode === "overlay" || envMode === "inline" ? envMode : undefined;
-            const effectiveDisplayMode = displayMode ?? envDisplayMode ?? "overlay";
-            const shortcuts = {
-                overlayToggle: resolveShortcut(overlayToggleKey, process.env.PI_ASK_USER_OVERLAY_TOGGLE_KEY, DEFAULT_OVERLAY_TOGGLE_KEY),
-                commentToggle: resolveShortcut(commentToggleKey, process.env.PI_ASK_USER_COMMENT_TOGGLE_KEY, DEFAULT_COMMENT_TOGGLE_KEY),
-            };
-            const options = normalizeOptions(rawOptions);
-            const normalizedContext = context?.trim() || undefined;
-            if (!ctx.hasUI || !ctx.ui) {
-                const optionText = options.length > 0 ? `\n\nOptions:\n${formatOptionsForMessage(options)}` : "";
-                const freeformHint = allowFreeform ? "\n\nYou can also answer freely." : "";
-                const commentHint = allowComment ? "\n\nAfter choosing an option, you may add an optional comment." : "";
-                const contextText = normalizedContext ? `\n\nContext:\n${normalizedContext}` : "";
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Ask requires interactive mode. Please answer:\n\n${question}${contextText}${optionText}${freeformHint}${commentHint}`,
-                        },
-                    ],
-                    isError: true,
-                    details: { question, context: normalizedContext, options, response: null, cancelled: true },
-                };
-            }
-            if (options.length === 0) {
-                const prompt = normalizedContext ? `${question}\n\nContext:\n${normalizedContext}` : question;
-                const inputOpts = {};
-                if (timeout)
-                    inputOpts.timeout = timeout;
-                if (!allowCancel)
-                    inputOpts.allowCancel = false;
-                const answer = await ctx.ui.input(prompt, "Type your answer...", Object.keys(inputOpts).length > 0 ? inputOpts : undefined);
-                const response = createFreeformResponse(answer);
-                if (!response) {
-                    return {
-                        content: [{ type: "text", text: "User cancelled the question" }],
-                        details: { question, context: normalizedContext, options, response: null, cancelled: true },
-                    };
-                }
-                const _result0 = {
-                    content: [{ type: "text", text: `User answered: ${formatResponseSummary(response)}` }],
-                    details: { question, context: normalizedContext, options, response, cancelled: false },
-                };
-                appendStrategicHintOnce(_result0);
-                return _result0;
-            }
-            onUpdate?.({
-                content: [{ type: "text", text: "Waiting for user input..." }],
-                details: { question, context: normalizedContext, options, response: null, cancelled: false },
-            });
-            let result;
-            let overlayHandle;
-            let removeOverlayInputListener;
-            let hasAnnouncedHide = false;
-            try {
-                const customFactory = (tui, theme, keybindings, done) => {
-                    if (signal) {
-                        const onAbort = () => done(null);
-                        signal.addEventListener("abort", onAbort, { once: true });
-                    }
-                    if (timeout && timeout > 0) {
-                        setTimeout(() => done(null), timeout);
-                    }
-                    return new AskComponent(question, normalizedContext, options, allowMultiple, allowFreeform, allowComment, effectiveDisplayMode, tui, theme, keybindings, shortcuts, done);
-                };
-                // Register a raw terminal input listener for the overlay-toggle key so the
-                // overlay can be toggled even while it is hidden (hidden overlays do not
-                // receive input). Inline mode does not need this because the prompt is
-                // already non-modal. Skipped entirely if the user disabled the shortcut.
-                const overlayToggle = shortcuts.overlayToggle;
-                if (effectiveDisplayMode === "overlay"
-                    && !overlayToggle.disabled
-                    && typeof ctx.ui.onTerminalInput === "function") {
-                    removeOverlayInputListener = ctx.ui.onTerminalInput((data) => {
-                        if (!overlayToggle.matches(data) || !overlayHandle)
-                            return undefined;
-                        const nextHidden = !overlayHandle.isHidden();
-                        overlayHandle.setHidden(nextHidden);
-                        if (nextHidden && !hasAnnouncedHide) {
-                            hasAnnouncedHide = true;
-                            ctx.ui.notify?.(`ask_user hidden — press ${overlayToggle.spec} to reopen`, "info");
-                        }
-                        return { consume: true };
-                    });
-                }
-                const customResult = await ctx.ui.custom(customFactory, buildCustomUIOptions(effectiveDisplayMode, (handle) => {
-                    overlayHandle = handle;
-                }));
-                if (customResult !== undefined) {
-                    result = customResult;
-                }
-                else {
-                    // RPC/headless mode: degrade to select()/input() dialog protocol
-                    result = await askViaDialogs(ctx.ui, question, normalizedContext, options, allowMultiple, allowFreeform, allowComment, allowCancel, timeout);
-                }
-            }
-            catch (error) {
-                const message = error instanceof Error ? `${error.message}\n${error.stack ?? ""}` : String(error);
-                return {
-                    content: [{ type: "text", text: `Ask tool failed: ${message}` }],
-                    isError: true,
-                    details: { error: message },
-                };
-            }
-            finally {
-                removeOverlayInputListener?.();
-            }
-            if (result === null) {
-                return {
-                    content: [{ type: "text", text: "User cancelled the question" }],
-                    details: { question, context: normalizedContext, options, response: null, cancelled: true },
-                };
-            }
-            return {
-                content: [{ type: "text", text: `User answered: ${formatResponseSummary(result)}` }],
-                details: {
-                    question,
-                    context: normalizedContext,
-                    options,
-                    response: result,
-                    cancelled: false,
-                },
-            };
-        },
-        renderCall(args, theme) {
-            const question = args.question || "";
-            const rawOptions = Array.isArray(args.options) ? args.options : [];
-            let text = theme.fg("toolTitle", theme.bold("ask_user "));
-            text += theme.fg("muted", question);
-            if (rawOptions.length > 0) {
-                const labels = rawOptions.map((o) => typeof o === "string" ? o : o?.title ?? "");
-                text += "\n" + theme.fg("dim", `  ${rawOptions.length} option(s): ${labels.join(", ")}`);
-            }
-            if (args.allowMultiple) {
-                text += theme.fg("dim", " [multi-select]");
-            }
-            if (args.allowComment) {
-                text += theme.fg("dim", " [optional comment]");
-            }
-            return new Text(text, 0, 0);
-        },
-        renderResult(result, options, theme, args) {
-            const details = result.details;
-            const canAnimate = !!args?.invalidate && !!args?.state;
-            const now = Date.now();
-            const id = args?.toolCallId || args?.id || "ask_user";
-            if (details?.error) {
-                const line = theme.fg("error", `✖ ${details.error}`);
-                if (!canAnimate)
-                    return new Text(line, 0, 0);
-                const scrambled = scrambleManager.updateText(id, "result", stripAnsi(line), now, false).content;
-                runScrambleTimer(args);
-                return new Text(scrambled, 0, 0);
-            }
-            if (options.isPartial) {
-                const waitingText = result.content
-                    ?.filter((part) => part?.type === "text")
-                    .map((part) => part.text ?? "")
-                    .join("\n")
-                    .trim() || "Waiting for user input...";
-                const line = theme.fg("muted", waitingText);
-                if (!canAnimate)
-                    return new Text(line, 0, 0);
-                const scrambled = scrambleManager.updateText(id, "result", stripAnsi(line), now, false).content;
-                runScrambleTimer(args);
-                return new Text(scrambled, 0, 0);
-            }
-            if (!details || details.cancelled || !details.response) {
-                const line = theme.fg("warning", "Cancelled");
-                if (!canAnimate)
-                    return new Text(line, 0, 0);
-                const scrambled = scrambleManager.updateText(id, "result", stripAnsi(line), now, false).content;
-                runScrambleTimer(args);
-                return new Text(scrambled, 0, 0);
-            }
-            const response = details.response;
-            let text = theme.fg("success", "✔ ");
-            if (response.kind === "freeform") {
-                text += theme.fg("muted", "(wrote) ");
-            }
-            text += theme.fg("accent", formatResponseSummary(response));
-            if (options.expanded) {
-                text += "\n" + theme.fg("dim", `Q: ${details.question}`);
-                if (details.context) {
-                    text += "\n" + theme.fg("dim", details.context);
-                }
-                if (isSelectionResponse(response) && details.options.length > 0) {
-                    const selectedTitles = new Set(response.selections);
-                    text += "\n" + theme.fg("dim", "Options:");
-                    for (const opt of details.options) {
-                        const desc = opt.description ? ` — ${opt.description}` : "";
-                        const marker = selectedTitles.has(opt.title) ? theme.fg("success", "●") : theme.fg("dim", "○");
-                        text += `\n  ${marker} ${theme.fg("dim", opt.title)}${theme.fg("dim", desc)}`;
-                    }
-                    if (response.comment) {
-                        text += `\n${theme.fg("dim", "Comment:")} ${theme.fg("dim", response.comment)}`;
-                    }
-                }
-            }
-            if (!canAnimate)
-                return new Text(text, 0, 0);
-            const scrambled = scrambleManager.updateText(id, "result", stripAnsi(text), now, false).content;
-            runScrambleTimer(args);
-            return new Text(scrambled, 0, 0);
-        },
-    };
-}
-//# sourceMappingURL=ask-user.js.map