@hheei/pi-ask-user 0.1.0 → 0.2.0

package/README.md

@@ -10,10 +10,9 @@ Forked from [`edlsh/pi-ask-user`](https://github.com/edlsh/pi-ask-user) at revis
 - Uses the `typebox` package instead of `@sinclair/typebox`.
 - Tests run on vitest instead of `bun test`.
 - Code conforms to this repo's Biome and `exactOptionalPropertyTypes` rules.
-- Reads preferences through `@hheei/pi-ext-core` from the `askUser` section of `ext_settings.json`, so project `.pi/ext_settings.json` can override the global file. Upstream's own `ask-user.json` and the `PI_ASK_USER_*` environment layer are gone.
+- Renders only inline: upstream's centered overlay mode, its `displayMode` parameter, and the whole `askUser` settings section are gone, so the prompt always sits in pi's input dock and reports `blocked` to the terminal through the host.
 - Drops upstream's searchable split-pane list, optional comment stage, overlay hide shortcut, review-page scrolling, and `ctrl+j`/`ctrl+k` vim aliases: the prompt now matches pi's own select-list keys.
 - Drops the upstream `pi-tern` native-presentation integration. Prompts render through pi's own TUI components, and results publish presentation facts that `@hheei/pi-ext-ui` frames with its 0/1/2 fold levels when it is installed.
-- Registers an `ask_user` settings page through `@hheei/pi-ext-core`, so the preferences below are editable in the host settings UI instead of by hand.
 
 Module boundaries, invariants, and the test layout are recorded in
 [`docs/architecture/ask-user.md`](../../docs/architecture/ask-user.md).
@@ -36,7 +35,6 @@ pi install npm:@hheei/pi-ask-user
 | `options` | `{title, description?}[]?` | — | Choices offered to the user |
 | `allowMultiple` | `boolean?` | `false` | Allow selecting several options |
 | `allowFreeform` | `boolean?` | `true` | Add a freeform answer row |
-| `displayMode` | `"overlay" \| "inline"` | `overlay` | Centered modal or in-place prompt |
 | `timeout_ms` | `integer?` | — | Auto-dismiss after N milliseconds; the result is cancelled |
 
 ## Keys
@@ -47,14 +45,10 @@ pi install npm:@hheei/pi-ask-user
 | Single select | `enter` choose (on the freeform row: open the editor) |
 | Multi select | `space` tick, `enter` submit |
 | Editor | `enter` submit, `shift+enter`/`ctrl+j` newline, `esc` back or cancel |
-| Prompt | `ctrl+e` expand context, `PgUp`/`PgDn`/`Home`/`End` scroll (overlay) |
+| Prompt | `ctrl+e` expand or collapse context |
 | Batch | `tab`/`shift+tab` pages, `1`-`N` jump from review, `enter` submit, `esc` cancel |
 | Anywhere | `esc`/`ctrl+c` cancel |
 
-## Preferences
-
-One setting, editable from the host settings UI or by hand: `displayMode` in the `askUser` section of `<agent-dir>/ext_settings.json` (project `.pi/ext_settings.json` wins), read on every call. A call parameter overrides it.
-
 `ask:answered` and `ask:cancelled` events carry only the question and the response kind; context and the actual answer stay in the tool result.
 
 ## Skill

package/dist/ask-prompt.d.ts

@@ -1,6 +1,5 @@
 import type { Theme } from "@earendil-works/pi-coding-agent";
 import { Container, type KeybindingsManager, type TUI } from "@earendil-works/pi-tui";
-import type { PromptSettings } from "./preferences";
 import { type AskUIResult } from "./response";
 import type { BatchQuestion } from "./schema";
 /**
@@ -9,7 +8,6 @@ import type { BatchQuestion } from "./schema";
  */
 export declare class AskComponent extends Container {
     private readonly prompt;
-    private readonly settings;
     private readonly contextPane;
     private readonly tui;
     private readonly theme;
@@ -18,9 +16,6 @@ export declare class AskComponent extends Container {
     private mode;
     private chrome;
     private freeformDraft;
-    private promptScrollOffset;
-    private promptMaxScrollOffset;
-    private promptViewportRows;
     private get contextIsCollapsible();
     private get contextExpanded();
     private questionText;
@@ -30,21 +25,17 @@ export declare class AskComponent extends Container {
     private _focused;
     get focused(): boolean;
     set focused(value: boolean);
-    constructor(prompt: BatchQuestion, settings: PromptSettings, tui: TUI, theme: Theme, keybindings: KeybindingsManager, onDone: (result: AskUIResult | null) => void);
+    constructor(prompt: BatchQuestion, tui: TUI, theme: Theme, keybindings: KeybindingsManager, onDone: (result: AskUIResult | null) => void);
     invalidate(): void;
     render(width: number): string[];
     private renderInlineLayout;
-    private renderOverlayLayout;
     private buildPromptLines;
-    private renderModeLines;
-    private renderEditorModeLines;
-    /** Header shared by the container children (inline) and the overlay budget path. */
+    /** Header shown above the freeform editor. */
     private editorHeader;
-    private renderPromptPane;
     private updateStaticText;
     /** Batch pages: show the question strip and the page-navigation hint above the question. */
     setBatchChrome(frameTitle: string, navigationHint: string): void;
-    /** The hint row for the current mode; `promptScrollable` only applies where the pane can clip. */
+    /** The hint row for the current mode. */
     private helpLines;
     /** The select-mode body; both lists share the wiring and differ in the selection shape. */
     private get optionList();
@@ -53,8 +44,5 @@ export declare class AskComponent extends Container {
     private showSelectMode;
     private showEditorMode;
     private toggleContext;
-    private setPromptScrollOffset;
-    private handlePromptScrollInput;
-    private scrollPromptBy;
     handleInput(data: string): void;
 }

package/dist/ask-prompt.js

@@ -3,10 +3,8 @@ import { INLINE_CONTEXT_MAX_ROWS } from "./constants";
 import { MultiSelectList } from "./multi-select-list";
 import { PromptContextPane } from "./prompt-context";
 import { buildHelpText } from "./prompt-help";
-import { contextShouldCollapse, getOverlayMaxRenderLinesForRows, planOverlayBody, RAIL_ROWS, railRow, } from "./prompt-layout";
-import { applyOverflowMarkers, limitEditorLines, limitLines } from "./prompt-overflow";
+import { railRow } from "./prompt-layout";
 import { createFreeformResponse, createSelectionResponse } from "./response";
-import { pageDelta } from "./shortcuts";
 import { WrappedSingleSelectList } from "./single-select-list";
 function editorTheme(theme) {
     return {
@@ -26,7 +24,6 @@ function editorTheme(theme) {
  */
 export class AskComponent extends Container {
     prompt;
-    settings;
     contextPane;
     tui;
     theme;
@@ -35,9 +32,6 @@ export class AskComponent extends Container {
     mode = "select";
     chrome = "";
     freeformDraft = "";
-    promptScrollOffset = 0;
-    promptMaxScrollOffset = 0;
-    promptViewportRows = 0;
     get contextIsCollapsible() {
         return this.contextPane.collapsible;
     }
@@ -61,10 +55,9 @@ export class AskComponent extends Container {
             this.editor.focused = value;
         }
     }
-    constructor(prompt, settings, tui, theme, keybindings, onDone) {
+    constructor(prompt, tui, theme, keybindings, onDone) {
         super();
         this.prompt = prompt;
-        this.settings = settings;
         this.tui = tui;
         this.theme = theme;
         this.keybindings = keybindings;
@@ -94,8 +87,6 @@ export class AskComponent extends Container {
         this.updateStaticText();
     }
     render(width) {
-        if (this.settings.displayMode === "overlay")
-            return this.renderOverlayLayout(width);
         if (this.mode === "select")
             this.optionList.setMaxVisibleRows(12);
         return this.renderInlineLayout(width);
@@ -109,51 +100,9 @@ export class AskComponent extends Container {
             "",
             ...this.modeContainer.render(width),
             railRow(this.theme, width),
-            ...this.helpLines(width, false),
+            ...this.helpLines(width),
         ];
     }
-    renderOverlayLayout(width) {
-        const maxLines = getOverlayMaxRenderLinesForRows(this.tui.terminal.rows);
-        if (maxLines <= 0)
-            return [];
-        const bodyCapacity = Math.max(0, maxLines - RAIL_ROWS);
-        let helpLines = this.helpLines(width, false);
-        const questionLines = this.questionText.render(width);
-        const fullContextLines = this.contextPane.fullLines(width);
-        this.contextPane.setCollapsible(contextShouldCollapse({
-            displayMode: this.settings.displayMode,
-            mode: this.mode,
-            contextCollapsible: this.contextIsCollapsible,
-            questionRows: questionLines.length,
-            contextRows: fullContextLines.length,
-            bodyCapacity,
-            helpRows: helpLines.length,
-        }));
-        const promptLines = this.buildPromptLines(width, fullContextLines);
-        const plan = planOverlayBody({
-            maxRenderLines: bodyCapacity,
-            mode: this.mode,
-            contextCollapsible: this.contextIsCollapsible,
-            promptRows: promptLines.length,
-            helpRows: helpLines.length,
-        });
-        const modeLines = this.renderModeLines(width, plan.modeBudget);
-        const promptBudget = plan.promptBudget + Math.max(0, plan.modeBudget - modeLines.length);
-        const promptPaneLines = this.renderPromptPane(promptLines, promptBudget, width);
-        helpLines = this.helpLines(width, promptLines.length > promptBudget);
-        const visibleHelpLines = limitLines(this.theme, helpLines, plan.helpBudget, width, false);
-        const contentLines = [
-            ...promptPaneLines,
-            ...(plan.separatorRows > 0 && promptPaneLines.length > 0 && modeLines.length > 0 ? [""] : []),
-            ...modeLines,
-        ];
-        return [
-            railRow(this.theme, width),
-            ...contentLines.slice(0, plan.bodyCapacity),
-            railRow(this.theme, width),
-            ...visibleHelpLines,
-        ].slice(0, maxLines);
-    }
     buildPromptLines(width, fullContextLines) {
         const questionLines = this.questionText.render(width);
         const contextLines = this.contextPane.displayLines(fullContextLines, width);
@@ -163,46 +112,10 @@ export class AskComponent extends Container {
             ...(contextLines.length > 0 ? [...contextSeparator, ...contextLines] : []),
         ];
     }
-    renderModeLines(width, budget) {
-        const safeBudget = Math.max(0, Math.floor(budget));
-        if (safeBudget <= 0)
-            return [];
-        if (this.mode === "select") {
-            this.optionList.setMaxVisibleRows(Math.max(1, safeBudget));
-            return limitLines(this.theme, this.modeContainer.render(width), safeBudget, width, true);
-        }
-        return this.renderEditorModeLines(width, safeBudget);
-    }
-    renderEditorModeLines(width, budget) {
-        const headerLines = [...new Text(this.editorHeader(), 1, 0).render(width), ""];
-        const minimumEditorRows = Math.min(3, budget);
-        const headerBudget = Math.max(0, budget - minimumEditorRows);
-        const visibleHeaderLines = limitLines(this.theme, headerLines, headerBudget, width, true);
-        const editorBudget = Math.max(0, budget - visibleHeaderLines.length);
-        return [
-            ...visibleHeaderLines,
-            ...limitEditorLines(this.theme, this.ensureEditor().render(width), editorBudget, width),
-        ];
-    }
-    /** Header shared by the container children (inline) and the overlay budget path. */
+    /** Header shown above the freeform editor. */
     editorHeader() {
         return this.theme.fg("accent", this.theme.bold("Custom response"));
     }
-    renderPromptPane(promptLines, budget, width) {
-        const viewportRows = Math.max(0, Math.floor(budget));
-        this.promptViewportRows = viewportRows;
-        if (viewportRows <= 0 || promptLines.length === 0) {
-            this.promptMaxScrollOffset = 0;
-            this.promptScrollOffset = 0;
-            return [];
-        }
-        this.promptMaxScrollOffset = Math.max(0, promptLines.length - viewportRows);
-        this.promptScrollOffset = Math.max(0, Math.min(this.promptScrollOffset, this.promptMaxScrollOffset));
-        const visibleLines = promptLines.slice(this.promptScrollOffset, this.promptScrollOffset + viewportRows);
-        const hasHiddenAbove = this.promptScrollOffset > 0;
-        const hasHiddenBelow = this.promptScrollOffset + viewportRows < promptLines.length;
-        return applyOverflowMarkers(this.theme, visibleLines, width, hasHiddenAbove, hasHiddenBelow);
-    }
     updateStaticText() {
         const theme = this.theme;
         const question = theme.fg("text", theme.bold(this.prompt.question));
@@ -215,17 +128,15 @@ export class AskComponent extends Container {
         this.chrome = `${theme.fg("dim", frameTitle)}  ${theme.fg("dim", navigationHint)}`;
         this.updateStaticText();
     }
-    /** The hint row for the current mode; `promptScrollable` only applies where the pane can clip. */
-    helpLines(width, promptScrollable) {
+    /** The hint row for the current mode. */
+    helpLines(width) {
         return wrapTextWithAnsi(buildHelpText({
             theme: this.theme,
             mode: this.mode,
-            displayMode: this.settings.displayMode,
             allowMultiple: this.prompt.allowMultiple,
             hasOptions: this.prompt.options.length > 0,
             contextCollapsible: this.contextIsCollapsible,
             contextToggleKey: this.contextPane.toggleKey(),
-            promptScrollable,
             keybindings: this.keybindings,
         }), width);
     }
@@ -291,51 +202,14 @@ export class AskComponent extends Container {
             return false;
         if (!this.contextPane.toggle())
             return false;
-        this.promptScrollOffset = 0;
         this.invalidate();
         this.tui.requestRender();
         return true;
     }
-    setPromptScrollOffset(nextOffset) {
-        this.promptScrollOffset = Math.max(0, Math.min(Math.floor(nextOffset), this.promptMaxScrollOffset));
-    }
-    handlePromptScrollInput(data) {
-        if (this.settings.displayMode !== "overlay")
-            return false;
-        if (this.promptMaxScrollOffset <= 0)
-            return false;
-        // Prompt scrolling is select-mode only: in freeform mode the editor owns
-        // PageUp/PageDown (tui.editor.pageUp/pageDown) for paging through long
-        // input, so intercepting them here would steal editor keys.
-        if (this.mode !== "select")
-            return false;
-        const pageRows = Math.max(1, this.promptViewportRows - 1);
-        const halfPageRows = Math.max(1, Math.floor(this.promptViewportRows / 2));
-        const delta = pageDelta(data, pageRows);
-        if (delta !== 0)
-            return this.scrollPromptBy(delta);
-        if (matchesKey(data, Key.home))
-            return this.scrollPromptBy(-this.promptScrollOffset);
-        if (matchesKey(data, Key.end))
-            return this.scrollPromptBy(this.promptMaxScrollOffset);
-        if (matchesKey(data, Key.ctrl("u")))
-            return this.scrollPromptBy(-halfPageRows);
-        if (matchesKey(data, Key.ctrl("d")))
-            return this.scrollPromptBy(halfPageRows);
-        return false;
-    }
-    scrollPromptBy(delta) {
-        this.setPromptScrollOffset(this.promptScrollOffset + delta);
-        return true;
-    }
     handleInput(data) {
         if (matchesKey(data, this.contextPane.toggleKey()) && this.toggleContext()) {
             return;
         }
-        if (this.handlePromptScrollInput(data)) {
-            this.tui.requestRender();
-            return;
-        }
         if (this.mode === "freeform") {
             if (matchesKey(data, Key.escape)) {
                 // Without options there is no list to go back to, so esc cancels.

package/dist/batch-prompt.d.ts

@@ -1,6 +1,5 @@
 import type { Theme } from "@earendil-works/pi-coding-agent";
 import { type Component, type KeybindingsManager, type TUI } from "@earendil-works/pi-tui";
-import type { PromptSettings } from "./preferences";
 import { type BatchAnswer } from "./response";
 import type { BatchQuestion } from "./schema";
 /**
@@ -11,7 +10,6 @@ import type { BatchQuestion } from "./schema";
  */
 export declare class BatchAskComponent implements Component {
     private questions;
-    private settings;
     private tui;
     private theme;
     private keybindings;
@@ -23,7 +21,7 @@ export declare class BatchAskComponent implements Component {
     private title;
     private confirmingSkips;
     private _focused;
-    constructor(questions: BatchQuestion[], settings: PromptSettings, tui: TUI, theme: Theme, keybindings: KeybindingsManager, onDone: (answers: BatchAnswer[] | null) => void, heading?: string | undefined);
+    constructor(questions: BatchQuestion[], tui: TUI, theme: Theme, keybindings: KeybindingsManager, onDone: (answers: BatchAnswer[] | null) => void, heading?: string | undefined);
     get focused(): boolean;
     set focused(value: boolean);
     invalidate(): void;

package/dist/batch-prompt.js

@@ -2,7 +2,7 @@ import { decodeKittyPrintable, Key, matchesKey, wrapTextWithAnsi, } from "@earen
 import { AskComponent } from "./ask-prompt";
 import { INLINE_DOCK_RESERVED_ROWS } from "./constants";
 import { formatKeyList } from "./prompt-help";
-import { getOverlayMaxRenderLinesForRows, railRow } from "./prompt-layout";
+import { getMaxRenderLinesForRows, railRow } from "./prompt-layout";
 import { formatResponseSummary, } from "./response";
 /**
  * One prompt for a whole `questions` batch: a page per question plus a review
@@ -12,7 +12,6 @@ import { formatResponseSummary, } from "./response";
  */
 export class BatchAskComponent {
     questions;
-    settings;
     tui;
     theme;
     keybindings;
@@ -24,16 +23,15 @@ export class BatchAskComponent {
     title = "";
     confirmingSkips = false;
     _focused = false;
-    constructor(questions, settings, tui, theme, keybindings, onDone, heading) {
+    constructor(questions, tui, theme, keybindings, onDone, heading) {
         this.questions = questions;
-        this.settings = settings;
         this.tui = tui;
         this.theme = theme;
         this.keybindings = keybindings;
         this.onDone = onDone;
         this.heading = heading;
         this.answers = questions.map(() => undefined);
-        this.pages = questions.map((entry, index) => new AskComponent(entry, settings, tui, theme, keybindings, (result) => this.handlePageDone(index, result)));
+        this.pages = questions.map((entry, index) => new AskComponent(entry, tui, theme, keybindings, (result) => this.handlePageDone(index, result)));
         this.updateChrome();
     }
     get focused() {
@@ -180,13 +178,11 @@ export class BatchAskComponent {
     /** Rows the review page may use, rails included. */
     reviewLineCap() {
         const rows = Number.isFinite(this.tui.terminal.rows) ? Math.floor(this.tui.terminal.rows) : 24;
-        const overlayCap = getOverlayMaxRenderLinesForRows(rows);
-        if (this.settings.displayMode === "overlay")
-            return overlayCap;
         // Inline prompts sit in Pi's fullscreen input dock, which clips anything
         // taller than what remains after the transcript's minimum row, the
         // working status, and the 2-3 row footer. Components only learn their
         // width, so stay within that space instead of growing with the content.
-        return Math.max(4, Math.min(overlayCap, rows - INLINE_DOCK_RESERVED_ROWS));
+        const cap = getMaxRenderLinesForRows(rows);
+        return Math.max(4, Math.min(cap, rows - INLINE_DOCK_RESERVED_ROWS));
     }
 }

package/dist/constants.d.ts

@@ -1,15 +1,11 @@
 export declare const BATCH_MIN_QUESTIONS = 2;
 export declare const BATCH_MAX_QUESTIONS = 4;
 export type AskMode = "select" | "freeform";
-export declare const ASK_OVERLAY_MAX_HEIGHT_RATIO = 0.85;
-export declare const ASK_OVERLAY_MIN_RENDER_LINES = 8;
-export declare const ASK_OVERLAY_WIDTH = "92%";
-export declare const ASK_OVERLAY_MIN_WIDTH = 40;
+export declare const ASK_MAX_RENDER_LINES_RATIO = 0.85;
+export declare const ASK_MIN_RENDER_LINES = 8;
 export declare const FREEFORM_SENTINEL = "\u270F\uFE0F Type custom response...";
 export declare const FREEFORM_LABEL = "Type something.";
 export declare const FREEFORM_HINT = "Enter a custom response";
 export declare const CONTEXT_TOGGLE_KEYS: readonly ["ctrl+e", "ctrl+x", "ctrl+y"];
 export declare const INLINE_CONTEXT_MAX_ROWS = 3;
 export declare const INLINE_DOCK_RESERVED_ROWS = 5;
-/** Section of `<agent-dir>/ext_settings.json` (and its project override) holding these preferences. */
-export declare const SETTINGS_SECTION = "askUser";

package/dist/constants.js

@@ -1,10 +1,8 @@
 import { Key } from "@earendil-works/pi-tui";
 export const BATCH_MIN_QUESTIONS = 2;
 export const BATCH_MAX_QUESTIONS = 4;
-export const ASK_OVERLAY_MAX_HEIGHT_RATIO = 0.85;
-export const ASK_OVERLAY_MIN_RENDER_LINES = 8;
-export const ASK_OVERLAY_WIDTH = "92%";
-export const ASK_OVERLAY_MIN_WIDTH = 40;
+export const ASK_MAX_RENDER_LINES_RATIO = 0.85;
+export const ASK_MIN_RENDER_LINES = 8;
 export const FREEFORM_SENTINEL = "\u270f\ufe0f Type custom response...";
 export const FREEFORM_LABEL = "Type something.";
 export const FREEFORM_HINT = "Enter a custom response";
@@ -13,5 +11,3 @@ export const INLINE_CONTEXT_MAX_ROWS = 3;
 // Rows Pi's fullscreen layout keeps outside the input dock: the transcript's
 // minimum row, the working status, and up to three footer rows.
 export const INLINE_DOCK_RESERVED_ROWS = 5;
-/** Section of `<agent-dir>/ext_settings.json` (and its project override) holding these preferences. */
-export const SETTINGS_SECTION = "askUser";

package/dist/custom-prompt.d.ts

@@ -1,12 +1,8 @@
 import type { ExtensionAPI, ExtensionContext, KeybindingsManager, Theme } from "@earendil-works/pi-coding-agent";
 import type { Component, TUI } from "@earendil-works/pi-tui";
-import type { AskDisplayMode } from "./schema";
-/** Report the session as blocked on the user (`herdr:blocked`) for the duration of `run`. */
-export declare function whileBlocked<T>(pi: ExtensionAPI, run: () => Promise<T>): Promise<T>;
 export interface CustomPromptRequest<T> {
     signal?: AbortSignal | undefined;
     timeout?: number | undefined;
-    displayMode: AskDisplayMode;
     /** Absent when the host's own dialog answers the prompt, e.g. a question without options. */
     createComponent?: (tui: TUI, theme: Theme, keybindings: KeybindingsManager, complete: (value: T | null) => void) => Component;
     /** Non-TUI hosts (RPC, print) answer through dialogs instead of a custom surface. */

package/dist/custom-prompt.js

@@ -1,33 +1,11 @@
 import { openTuiSurface } from "@hheei/pi-ext-core";
-import { ASK_OVERLAY_MIN_WIDTH, ASK_OVERLAY_WIDTH } from "./constants";
-/** Report the session as blocked on the user (`herdr:blocked`) for the duration of `run`. */
-export async function whileBlocked(pi, run) {
-    pi.events.emit("herdr:blocked", { active: true, label: "Waiting for user response" });
-    try {
-        return await run();
-    }
-    finally {
-        pi.events.emit("herdr:blocked", { active: false });
-    }
-}
-function overlayOptions(displayMode) {
-    if (displayMode !== "overlay")
-        return undefined;
-    return {
-        anchor: "center",
-        width: ASK_OVERLAY_WIDTH,
-        minWidth: ASK_OVERLAY_MIN_WIDTH,
-        maxHeight: "85%",
-        margin: 1,
-    };
-}
 /**
  * Runs one prompt and owns everything around it: the surface slot, the abort
  * forwarding, and the timeout. `null` means the user cancelled, the deadline
  * passed, or the host has no custom UI.
  */
 export async function runCustomPrompt(pi, ctx, request) {
-    const { signal, timeout, displayMode, createComponent } = request;
+    const { signal, timeout, createComponent } = request;
     const deadline = timeout && timeout > 0 ? Date.now() + timeout : undefined;
     const local = new AbortController();
     const abortLocally = () => local.abort(signal?.reason);
@@ -39,11 +17,10 @@ export async function runCustomPrompt(pi, ctx, request) {
         if (ctx.mode !== "tui" || createComponent === undefined) {
             return await request.fallback(local.signal, deadline);
         }
-        const options = overlayOptions(displayMode);
         const result = await openTuiSurface(pi, ctx, {
             hostId: "ask-user",
             signal: local.signal,
-            ...(options === undefined ? {} : { overlay: true, overlayOptions: options }),
+            blocked: { kind: "question", message: "Waiting for user response" },
             create: ({ tui, theme, keybindings, close }) => createComponent(tui, theme, keybindings, close),
         });
         return result.status === "closed" ? result.value : null;

package/dist/execute.js

@@ -1,10 +1,9 @@
 import { AskComponent } from "./ask-prompt";
 import { BatchAskComponent } from "./batch-prompt";
-import { runCustomPrompt, whileBlocked } from "./custom-prompt";
+import { runCustomPrompt } from "./custom-prompt";
 import { askBatchViaDialogs, askText, askViaDialogs } from "./dialogs";
 import { createAskEventEmitter } from "./events";
 import { formatBatchAnswers, formatBatchForMessage, formatSingleForMessage } from "./format";
-import { resolvePromptSettings } from "./preferences";
 import { createFreeformResponse, formatResponseSummary, } from "./response";
 import { batchHeading, coerceOptions, malformedOptionsError, normalizeBatchQuestions, } from "./schema";
 /** Host text dialog for a prompt without options; shares the caller's deadline and abort. */
@@ -20,14 +19,13 @@ async function askForText(ctx, question, context, signal, deadline) {
 }
 /** One prompt run: the surface, its deadline, the abort forwarding, and the dialog fallback. */
 async function runInteractive(pi, ctx, request) {
-    const { settings, createComponent } = request;
-    return await whileBlocked(pi, () => runCustomPrompt(pi, ctx, {
+    const { createComponent } = request;
+    return await runCustomPrompt(pi, ctx, {
         signal: request.signal,
         timeout: request.timeout,
-        displayMode: settings.displayMode,
         ...(createComponent === undefined ? {} : { createComponent }),
         fallback: request.fallback,
-    }));
+    });
 }
 export async function executeSingle(pi, params, signal, onUpdate, ctx) {
     const question = params.question;
@@ -40,7 +38,6 @@ export async function executeSingle(pi, params, signal, onUpdate, ctx) {
             details: { question, context: params.context, options: [], response: null, cancelled: true },
         };
     }
-    const settings = await resolvePromptSettings(params, signal);
     const context = params.context?.trim() || undefined;
     const rawOptions = params.options ?? [];
     const options = coerceOptions(rawOptions);
@@ -72,12 +69,11 @@ export async function executeSingle(pi, params, signal, onUpdate, ctx) {
         });
     }
     const response = await runInteractive(pi, ctx, {
-        settings,
         signal,
         timeout: params.timeout_ms,
         createComponent: options.length === 0
             ? undefined
-            : (tui, theme, keybindings, complete) => new AskComponent(prompt, settings, tui, theme, keybindings, complete),
+            : (tui, theme, keybindings, complete) => new AskComponent(prompt, tui, theme, keybindings, complete),
         fallback: (fallbackSignal, deadline) => options.length === 0
             ? askForText(ctx, question, context, fallbackSignal, deadline)
             : askViaDialogs(ctx.ui, question, context, options, prompt.allowMultiple, prompt.allowFreeform, { signal: fallbackSignal }, deadline),
@@ -117,7 +113,6 @@ export async function executeBatch(pi, params, signal, onUpdate, ctx) {
             details: details([], true),
         };
     }
-    const settings = await resolvePromptSettings(params, signal);
     const events = createAskEventEmitter(pi);
     if (!ctx.hasUI || !ctx.ui) {
         throw new Error(formatBatchForMessage(questions, heading));
@@ -127,10 +122,9 @@ export async function executeBatch(pi, params, signal, onUpdate, ctx) {
         details: details([], false),
     });
     const answers = await runInteractive(pi, ctx, {
-        settings,
         signal,
         timeout: params.timeout_ms,
-        createComponent: (tui, theme, keybindings, complete) => new BatchAskComponent(questions, settings, tui, theme, keybindings, complete, heading),
+        createComponent: (tui, theme, keybindings, complete) => new BatchAskComponent(questions, tui, theme, keybindings, complete, heading),
         fallback: (fallbackSignal, deadline) => askBatchViaDialogs(ctx.ui, questions, fallbackSignal, deadline, heading),
     });
     if (answers === null || signal?.aborted) {

package/dist/index.js

@@ -1,6 +1,4 @@
-import { registerAskUserSettings } from "./settings-provider";
 import { registerAskUserTool } from "./tool";
 export default function askUser(pi) {
     registerAskUserTool(pi);
-    registerAskUserSettings(pi);
 }

package/dist/prompt-help.d.ts

@@ -1,18 +1,14 @@
 import type { Theme } from "@earendil-works/pi-coding-agent";
 import type { KeybindingsManager } from "@earendil-works/pi-tui";
 import type { AskMode } from "./constants";
-import type { AskDisplayMode } from "./schema";
 export declare function formatKeyList(keys: readonly string[]): string;
 export interface HelpHintInput {
     theme: Theme;
     mode: AskMode;
-    displayMode: AskDisplayMode;
     allowMultiple: boolean;
     hasOptions: boolean;
     contextCollapsible: boolean;
     contextToggleKey: string;
-    /** True when the prompt pane clipped, so the scroll keys are worth showing. */
-    promptScrollable: boolean;
     keybindings: KeybindingsManager;
 }
 /**

package/dist/prompt-help.js

@@ -30,7 +30,6 @@ export function buildHelpText(input) {
                 : [binding("tui.select.confirm"), "select"],
             input.allowMultiple ? ["␣", "toggle"] : null,
             input.contextCollapsible ? [input.contextToggleKey, "context"] : null,
-            input.promptScrollable ? ["PgUp/PgDn", "prompt"] : null,
             [binding("tui.select.cancel"), "cancel"],
         ]
         : [

package/dist/prompt-layout.d.ts

@@ -1,43 +1,5 @@
 import type { Theme } from "@earendil-works/pi-coding-agent";
-import { type AskMode } from "./constants";
-import type { AskDisplayMode } from "./schema";
-/** A surface is bracketed by two `──` rails, the way `pi-ext-ui` groups are. */
-export declare const RAIL_ROWS = 2;
 /** The native separator row: one full-width `─` rule in `borderMuted`. */
 export declare function railRow(theme: Theme, width: number): string;
-/** Rows an overlay may draw for the terminal height: a ratio cap with a usable floor. */
-export declare function getOverlayMaxRenderLinesForRows(rows: number): number;
-export declare function modeMinRows(mode: AskMode): number;
-export declare function modePreferredRows(mode: AskMode): number;
-export declare function overlayHelpBudget(bodyCapacity: number, renderedHelpRows: number): number;
-export interface ContextCollapseInput {
-    displayMode: AskDisplayMode;
-    mode: AskMode;
-    contextCollapsible: boolean;
-    questionRows: number;
-    contextRows: number;
-    bodyCapacity: number;
-    helpRows: number;
-}
-/**
- * Inline mode always follows the row budget; the overlay keeps context open
- * when the prompt still fits next to the minimum mode rows.
- */
-export declare function contextShouldCollapse(input: ContextCollapseInput): boolean;
-export interface BodyPlanInput {
-    maxRenderLines: number;
-    mode: AskMode;
-    contextCollapsible: boolean;
-    promptRows: number;
-    helpRows: number;
-}
-export interface BodyPlan {
-    bodyCapacity: number;
-    helpBudget: number;
-    contentRows: number;
-    promptBudget: number;
-    modeBudget: number;
-    separatorRows: number;
-}
-/** Split the overlay rows between prompt, mode body and help. */
-export declare function planOverlayBody(input: BodyPlanInput): BodyPlan;
+/** Rows a prompt may draw for the terminal height: a ratio cap with a usable floor. */
+export declare function getMaxRenderLinesForRows(rows: number): number;

package/dist/prompt-layout.js

@@ -1,89 +1,13 @@
-import { ASK_OVERLAY_MAX_HEIGHT_RATIO, ASK_OVERLAY_MIN_RENDER_LINES, } from "./constants";
-/** Rows each mode needs to stay usable, and the size it grows to when there is room. */
-const MODE_ROWS = {
-    select: { min: 3, preferred: 8 },
-    freeform: { min: 5, preferred: 10 },
-};
-/** A surface is bracketed by two `──` rails, the way `pi-ext-ui` groups are. */
-export const RAIL_ROWS = 2;
+import { ASK_MAX_RENDER_LINES_RATIO, ASK_MIN_RENDER_LINES } from "./constants";
 /** The native separator row: one full-width `─` rule in `borderMuted`. */
 export function railRow(theme, width) {
     return theme.fg("borderMuted", "─".repeat(Math.max(0, width)));
 }
-/** Rows an overlay may draw for the terminal height: a ratio cap with a usable floor. */
-export function getOverlayMaxRenderLinesForRows(rows) {
+/** Rows a prompt may draw for the terminal height: a ratio cap with a usable floor. */
+export function getMaxRenderLinesForRows(rows) {
     const normalizedRows = Number.isFinite(rows) ? Math.max(1, Math.floor(rows)) : 24;
     const availableRows = Math.max(1, normalizedRows - 2);
-    const ratioRows = Math.max(1, Math.floor(normalizedRows * ASK_OVERLAY_MAX_HEIGHT_RATIO));
-    const minimumRows = Math.min(ASK_OVERLAY_MIN_RENDER_LINES, availableRows);
+    const ratioRows = Math.max(1, Math.floor(normalizedRows * ASK_MAX_RENDER_LINES_RATIO));
+    const minimumRows = Math.min(ASK_MIN_RENDER_LINES, availableRows);
     return Math.min(availableRows, Math.max(minimumRows, ratioRows));
 }
-export function modeMinRows(mode) {
-    return MODE_ROWS[mode].min;
-}
-export function modePreferredRows(mode) {
-    return MODE_ROWS[mode].preferred;
-}
-export function overlayHelpBudget(bodyCapacity, renderedHelpRows) {
-    if (renderedHelpRows <= 0 || bodyCapacity <= 0)
-        return 0;
-    if (bodyCapacity >= 12)
-        return Math.min(2, renderedHelpRows);
-    return 1;
-}
-/**
- * Inline mode always follows the row budget; the overlay keeps context open
- * when the prompt still fits next to the minimum mode rows.
- */
-export function contextShouldCollapse(input) {
-    if (input.displayMode === "inline")
-        return input.contextCollapsible;
-    if (input.mode !== "select")
-        return input.contextCollapsible;
-    if (input.contextRows === 0)
-        return false;
-    const helpBudget = overlayHelpBudget(input.bodyCapacity, input.helpRows);
-    const contentRows = Math.max(0, input.bodyCapacity - helpBudget);
-    const separatorRows = contentRows >= 4 ? 1 : 0;
-    const promptCapacity = Math.max(0, contentRows - separatorRows - modeMinRows(input.mode));
-    return input.questionRows + 1 + input.contextRows > promptCapacity;
-}
-/** Split the overlay rows between prompt, mode body and help. */
-export function planOverlayBody(input) {
-    const bodyCapacity = Math.max(0, input.maxRenderLines);
-    const helpBudget = overlayHelpBudget(bodyCapacity, input.helpRows);
-    const contentRows = Math.max(0, bodyCapacity - helpBudget);
-    let promptBudget = 0;
-    let modeBudget = 0;
-    let separatorRows = 0;
-    if (input.mode === "select") {
-        separatorRows = contentRows >= 4 ? 1 : 0;
-        const promptAndModeRows = Math.max(0, contentRows - separatorRows);
-        promptBudget = promptAndModeRows;
-        if (promptAndModeRows > 0) {
-            const promptMinRows = input.promptRows > 0 ? 1 : 0;
-            const maximumModeRows = Math.max(0, promptAndModeRows - promptMinRows);
-            const modeMin = Math.min(modeMinRows(input.mode), maximumModeRows);
-            modeBudget = Math.min(modePreferredRows(input.mode), maximumModeRows);
-            modeBudget = Math.max(modeMin, modeBudget);
-            promptBudget = promptAndModeRows - modeBudget;
-            const usefulPromptTarget = input.contextCollapsible ? 3 : 2;
-            const usefulPromptRows = Math.min(input.promptRows, promptAndModeRows >= modeMin + usefulPromptTarget ? usefulPromptTarget : promptMinRows);
-            if (promptBudget < usefulPromptRows && modeBudget > modeMin) {
-                const shiftedRows = Math.min(usefulPromptRows - promptBudget, modeBudget - modeMin);
-                modeBudget -= shiftedRows;
-                promptBudget += shiftedRows;
-            }
-        }
-    }
-    else {
-        modeBudget = Math.min(modePreferredRows(input.mode), contentRows);
-        modeBudget = Math.max(Math.min(modeMinRows(input.mode), contentRows), modeBudget);
-        promptBudget = Math.max(0, contentRows - modeBudget);
-        if (promptBudget > 0 && modeBudget > 0) {
-            separatorRows = 1;
-            promptBudget = Math.max(0, promptBudget - separatorRows);
-        }
-    }
-    return { bodyCapacity, helpBudget, contentRows, promptBudget, modeBudget, separatorRows };
-}

package/dist/schema.d.ts

@@ -1,8 +1,5 @@
-import { StringEnum } from "@earendil-works/pi-ai";
 import type { QuestionOption } from "./single-select-layout";
-export { StringEnum };
 type AskOptionInput = QuestionOption | string;
-export type AskDisplayMode = "overlay" | "inline";
 interface BatchQuestionInput {
     question: string;
     context?: string;
@@ -17,7 +14,6 @@ export interface AskParams {
     options?: AskOptionInput[];
     allowMultiple?: boolean;
     allowFreeform?: boolean;
-    displayMode?: AskDisplayMode;
     timeout_ms?: number;
 }
 /** One validated entry of a `questions` batch. */
@@ -41,3 +37,4 @@ export declare function batchHeading(params: AskParams): string | undefined;
  * correct the call.
  */
 export declare function normalizeBatchQuestions(params: AskParams): BatchQuestion[];
+export {};

package/dist/schema.js

@@ -1,7 +1,5 @@
-import { StringEnum } from "@earendil-works/pi-ai";
 import { isRecord } from "@hheei/pi-ext-core";
 import { BATCH_MAX_QUESTIONS, BATCH_MIN_QUESTIONS } from "./constants";
-export { StringEnum };
 // Key aliases models fall back to when a schema-mangling proxy (Google
 // function calling, Codex-style backends, cmux) strips the option shape and
 // the model has to guess. See issue #22.

package/dist/shortcuts.d.ts

@@ -1,7 +1,5 @@
 import { type KeybindingsManager } from "@earendil-works/pi-tui";
 export declare function matchesSelectUp(data: string, keybindings: KeybindingsManager): boolean;
 export declare function matchesSelectDown(data: string, keybindings: KeybindingsManager): boolean;
-/** PageUp/PageDown move by a viewport. The prompt pane owns these; lists own the arrows. */
-export declare function pageDelta(data: string, pageRows: number): number;
 /** A 1-9 digit key, including the CSI-u form the kitty keyboard protocol sends. */
 export declare function digitKey(data: string): number | null;

package/dist/shortcuts.js

@@ -6,14 +6,6 @@ export function matchesSelectUp(data, keybindings) {
 export function matchesSelectDown(data, keybindings) {
     return keybindings.matches(data, "tui.select.down") || matchesKey(data, Key.tab);
 }
-/** PageUp/PageDown move by a viewport. The prompt pane owns these; lists own the arrows. */
-export function pageDelta(data, pageRows) {
-    if (matchesKey(data, Key.pageUp))
-        return -pageRows;
-    if (matchesKey(data, Key.pageDown))
-        return pageRows;
-    return 0;
-}
 /** A 1-9 digit key, including the CSI-u form the kitty keyboard protocol sends. */
 export function digitKey(data) {
     const key = decodeKittyPrintable(data) ?? data;

package/dist/tool.js

@@ -2,7 +2,6 @@ import { Type } from "typebox";
 import { BATCH_MAX_QUESTIONS, BATCH_MIN_QUESTIONS } from "./constants";
 import { executeBatch, executeSingle } from "./execute";
 import { createAskUserRenderers } from "./presentation";
-import { StringEnum } from "./schema";
 const ASK_DESCRIPTION = "Ask the user a question with optional multiple-choice answers, or 2-4 independent questions in one prompt. The turn blocks until the user answers.";
 const ASK_PROMPT_SNIPPET = "Ask the user one focused question, or 2-4 independent ones together, with optional multiple-choice answers";
 const ASK_PROMPT_GUIDELINES = [
@@ -21,7 +20,6 @@ const ASK_PARAMETER_DESCRIPTIONS = {
     options: "Options for the user to choose from",
     allowMultiple: "Allow selecting multiple options (default: false)",
     allowFreeform: "Add a freeform text option (default: true)",
-    displayMode: "'overlay' shows a centered modal, 'inline' renders in place (default: displayMode in the askUser section of ext_settings.json, otherwise 'overlay')",
     timeoutMs: "Auto-dismiss after N milliseconds; the result is cancelled",
 };
 // Flat object shape: union item schemas get stripped or rejected by several
@@ -63,9 +61,6 @@ export function registerAskUserTool(pi) {
             options: Type.Optional(Type.Array(optionSchema, { description: ASK_PARAMETER_DESCRIPTIONS.options })),
             allowMultiple: Type.Optional(Type.Boolean({ description: ASK_PARAMETER_DESCRIPTIONS.allowMultiple })),
             allowFreeform: Type.Optional(Type.Boolean({ description: ASK_PARAMETER_DESCRIPTIONS.allowFreeform })),
-            displayMode: Type.Optional(StringEnum(["overlay", "inline"], {
-                description: ASK_PARAMETER_DESCRIPTIONS.displayMode,
-            })),
             timeout_ms: Type.Optional(Type.Integer({
                 minimum: 1,
                 description: ASK_PARAMETER_DESCRIPTIONS.timeoutMs,

package/package.json

@@ -1,60 +1,57 @@
 {
-	"name": "@hheei/pi-ask-user",
-	"version": "0.1.0",
-	"description": "Interactive ask_user tool for pi-coding-agent: one question or 2-4 in one prompt, multiple choice, multi-select, and freeform answers.",
-	"type": "module",
-	"main": "dist/index.js",
-	"types": "dist/index.d.ts",
-	"exports": {
-		".": "./dist/index.js"
-	},
-	"files": [
-		"dist",
-		"skills",
-		"README.md",
-		"LICENSE"
-	],
-	"pi": {
-		"extensions": [
-			"dist/index.js"
-		],
-		"skills": [
-			"./skills"
-		]
-	},
-	"scripts": {
-		"build": "node -e \"import { rmSync } from 'node:fs'; rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.build.json",
-		"prepack": "pnpm run build"
-	},
-	"keywords": [
-		"pi",
-		"pi-package",
-		"pi-extension",
-		"ask",
-		"ask_user",
-		"interactive"
-	],
-	"license": "MIT",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/hheei/pi-mono.git",
-		"directory": "packages/pi-ask-user"
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"dependencies": {
-		"@hheei/pi-ext-core": "workspace:^"
-	},
-	"peerDependencies": {
-		"@earendil-works/pi-ai": ">=1.2.0",
-		"@earendil-works/pi-coding-agent": ">=1.2.0",
-		"@earendil-works/pi-tui": ">=1.2.0",
-		"typebox": "*"
-	},
-	"devDependencies": {
-		"@earendil-works/pi-ai": "^1.4.0",
-		"@earendil-works/pi-coding-agent": "^1.4.0",
-		"@earendil-works/pi-tui": "^1.4.0"
-	}
-}
+  "name": "@hheei/pi-ask-user",
+  "version": "0.2.0",
+  "description": "Interactive ask_user tool for pi-coding-agent: one question or 2-4 in one prompt, multiple choice, multi-select, and freeform answers.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "dist/index.js"
+    ],
+    "skills": [
+      "./skills"
+    ]
+  },
+  "keywords": [
+    "pi",
+    "pi-package",
+    "pi-extension",
+    "ask",
+    "ask_user",
+    "interactive"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hheei/pi-mono.git",
+    "directory": "packages/pi-ask-user"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@hheei/pi-ext-core": "^0.8.1"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": ">=1.5.0",
+    "@earendil-works/pi-tui": ">=1.5.0",
+    "typebox": "*"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "^1.5.0",
+    "@earendil-works/pi-tui": "^1.5.0"
+  },
+  "scripts": {
+    "build": "node -e \"import { rmSync } from 'node:fs'; rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.build.json"
+  }
+}

package/skills/ask-user/SKILL.md

@@ -54,7 +54,6 @@ Call `ask_user` with one decision at a time:
 - `options`: 2-5 clear choices when possible
 - `allowMultiple`: `false` unless independent selections are genuinely needed
 - `allowFreeform`: usually `true`
-- `displayMode` *(optional)*: `"overlay"` (default) or `"inline"`. Use `"inline"` when preceding assistant context (summary, trade-offs, recommendation) is essential to the decision and should remain visible — overlays cover the conversation underneath. The user may set a personal default via `displayMode` in the `askUser` section of `ext_settings.json`; only pass this when you intentionally want to override it for one call.
 - `timeout_ms` *(optional)*: auto-dismiss after N milliseconds; the result comes back cancelled. Omit unless the decision is genuinely time-boxed.
 
 When 2-4 decisions at the same boundary are independent of each other and their prerequisites are settled, you may ask them together with `questions` instead of `question`. Each entry carries its own `question`, `context`, `options`, `allowMultiple`, and `allowFreeform`. A top-level `question` sent with `questions` is only a heading, never asked. Never batch a decision whose options depend on another answer; ask it in a later call once that answer is known.

package/skills/ask-user/references/ask-user-skill-extension-spec.md

@@ -66,19 +66,6 @@ Use this protocol whenever the trigger matrix says to ask.
 }
 ```
 
-### Display mode (optional)
-
-The `ask_user` tool accepts an optional `displayMode` parameter:
-
-- `"overlay"` *(default)*: centered modal; covers the conversation underneath.
-- `"inline"`: rendered in the conversation flow; preceding messages stay visible.
-
-Guidance:
-
-- Omit `displayMode` to respect the user's configured preference (`displayMode` in the `askUser` section of `ext_settings.json`).
-- Pass `"inline"` only when the immediately preceding assistant message (summary, trade-offs, recommendation) is the primary context for the decision and must remain visible.
-- Pass `"overlay"` only to explicitly force the modal style (rare).
-
 ### Batches (optional)
 
 `questions` replaces `question` with 2-4 entries, each with its own `question`, `context`, `options`, `allowMultiple`, and `allowFreeform`. The user answers them on separate pages and submits from a review page, where unanswered questions can be submitted as skipped.

package/dist/preferences.d.ts

@@ -1,8 +0,0 @@
-import { SETTINGS_SECTION } from "./constants";
-import type { AskDisplayMode, AskParams } from "./schema";
-export { SETTINGS_SECTION };
-export interface PromptSettings {
-    displayMode: AskDisplayMode;
-}
-/** Resolve presentation preferences: call parameter, then the askUser section of ext_settings.json, then the field default. */
-export declare function resolvePromptSettings(params: AskParams, signal?: AbortSignal): Promise<PromptSettings>;

package/dist/preferences.js

@@ -1,25 +0,0 @@
-import { defaultExtensionSettingsPaths, readMergedJsonSettingsSection, } from "@hheei/pi-ext-core";
-import { SETTINGS_SECTION } from "./constants";
-import { ASK_USER_FIELDS } from "./settings-provider";
-export { SETTINGS_SECTION };
-function pickEnum(raw, field) {
-    // ext-core types option values as SettingPrimitive; an enum field only ever lists its own T.
-    const matched = field.options?.find((option) => option.value === raw)?.value;
-    return matched ?? field.defaultValue;
-}
-/** Read on every ask_user call so edits apply without restarting Pi. */
-async function readAskUserSettings(signal) {
-    const { merged } = await readMergedJsonSettingsSection({
-        paths: defaultExtensionSettingsPaths(),
-        section: SETTINGS_SECTION,
-        ...(signal ? { signal } : {}),
-    });
-    return merged;
-}
-/** Resolve presentation preferences: call parameter, then the askUser section of ext_settings.json, then the field default. */
-export async function resolvePromptSettings(params, signal) {
-    const raw = await readAskUserSettings(signal);
-    return {
-        displayMode: params.displayMode ?? pickEnum(raw.displayMode, ASK_USER_FIELDS.displayMode),
-    };
-}

package/dist/prompt-overflow.d.ts

@@ -1,5 +0,0 @@
-import type { Theme } from "@earendil-works/pi-coding-agent";
-export declare function applyOverflowMarkers(theme: Theme, lines: string[], width: number, hasHiddenAbove: boolean, hasHiddenBelow: boolean): string[];
-export declare function limitLines(theme: Theme, lines: string[], budget: number, width: number, showOverflowMarker: boolean): string[];
-/** Editor rows keep their top/bottom borders and follow the cursor when clipped. */
-export declare function limitEditorLines(theme: Theme, lines: string[], budget: number, width: number): string[];

package/dist/prompt-overflow.js

@@ -1,59 +0,0 @@
-import { CURSOR_MARKER, truncateToWidth } from "@earendil-works/pi-tui";
-export function applyOverflowMarkers(theme, lines, width, hasHiddenAbove, hasHiddenBelow) {
-    if (lines.length === 0)
-        return lines;
-    const marker = (line, glyph) => truncateToWidth(`${theme.fg("dim", glyph)} ${line}`, width, "", true);
-    const marked = [...lines];
-    if (hasHiddenAbove && hasHiddenBelow && marked.length === 1) {
-        marked[0] = marker(marked[0] ?? "", "↕");
-        return marked;
-    }
-    if (hasHiddenAbove) {
-        marked[0] = marker(marked[0] ?? "", "↑");
-    }
-    if (hasHiddenBelow) {
-        const lastIndex = marked.length - 1;
-        marked[lastIndex] = marker(marked[lastIndex] ?? "", "↓");
-    }
-    return marked;
-}
-const truncateLines = (lines, width) => lines.map((line) => truncateToWidth(line, width, "", true));
-export function limitLines(theme, lines, budget, width, showOverflowMarker) {
-    const safeBudget = Math.max(0, Math.floor(budget));
-    if (safeBudget <= 0)
-        return [];
-    if (lines.length <= safeBudget)
-        return truncateLines(lines, width);
-    if (!showOverflowMarker)
-        return truncateLines(lines.slice(0, safeBudget), width);
-    if (safeBudget === 1)
-        return [theme.fg("dim", "…")];
-    return [...truncateLines(lines.slice(0, safeBudget - 1), width), theme.fg("dim", "…")];
-}
-/** Editor rows keep their top/bottom borders and follow the cursor when clipped. */
-export function limitEditorLines(theme, lines, budget, width) {
-    const safeBudget = Math.max(0, Math.floor(budget));
-    if (safeBudget <= 0)
-        return [];
-    if (lines.length <= safeBudget)
-        return truncateLines(lines, width);
-    if (safeBudget === 1)
-        return [theme.fg("dim", "…")];
-    const topBorder = truncateToWidth(lines[0] ?? "", width, "", true);
-    const bottomBorder = truncateToWidth(lines[lines.length - 1] ?? "", width, "", true);
-    if (safeBudget === 2)
-        return [topBorder, bottomBorder];
-    const contentLines = lines.slice(1, -1);
-    const contentBudget = safeBudget - 2;
-    // Locate the cursor row: prefer the zero-width CURSOR_MARKER the editor
-    // emits while focused (the same mechanism pi-tui core uses for hardware
-    // cursor placement), falling back to the inverse-video fake cursor.
-    const cursorLineIndex = contentLines.findIndex((line) => line.includes(CURSOR_MARKER) || line.includes("\x1b[7m"));
-    const maxStart = Math.max(0, contentLines.length - contentBudget);
-    const start = cursorLineIndex >= 0
-        ? Math.max(0, Math.min(cursorLineIndex - contentBudget + 1, maxStart))
-        : maxStart;
-    const visibleContentLines = contentLines.slice(start, start + contentBudget);
-    const markedContentLines = applyOverflowMarkers(theme, visibleContentLines, width, start > 0, start + contentBudget < contentLines.length);
-    return [topBorder, ...markedContentLines, bottomBorder];
-}

package/dist/settings-provider.d.ts

@@ -1,15 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { type SettingField, type SettingsProvider } from "@hheei/pi-ext-core";
-import type { AskDisplayMode } from "./schema";
-export declare const ASK_USER_SETTINGS_PROVIDER_ID = "pi-ask-user";
-/**
- * The `askUser` section, defined once: the settings UI renders these fields and the tool
- * resolves its own defaults from them. Values land in the global layer; a project layer
- * still wins when the tool resolves preferences.
- */
-export declare const ASK_USER_FIELDS: {
-    displayMode: SettingField<AskDisplayMode>;
-};
-export declare function createAskUserSettingsProvider(): SettingsProvider;
-/** Registers the provider in the runtime registry; returns the unregister handle. */
-export declare function registerAskUserSettings(pi: ExtensionAPI): () => void;

package/dist/settings-provider.js

@@ -1,42 +0,0 @@
-import { createJsonSettingsStorage, getRuntimeSettingsRegistry, registerSettings, } from "@hheei/pi-ext-core";
-import { SETTINGS_SECTION } from "./constants";
-export const ASK_USER_SETTINGS_PROVIDER_ID = "pi-ask-user";
-function enumField(id, label, description, defaultValue, values) {
-    return {
-        id,
-        label,
-        type: "enum",
-        defaultValue,
-        description,
-        options: values.map((value) => ({ value, label: value })),
-        parse: (draft) => (values.includes(draft) ? draft : defaultValue),
-    };
-}
-/**
- * The `askUser` section, defined once: the settings UI renders these fields and the tool
- * resolves its own defaults from them. Values land in the global layer; a project layer
- * still wins when the tool resolves preferences.
- */
-export const ASK_USER_FIELDS = {
-    displayMode: enumField("displayMode", "display mode", "Overlay shows a centered modal; inline renders the prompt in place.", "overlay", ["overlay", "inline"]),
-};
-export function createAskUserSettingsProvider() {
-    return {
-        id: ASK_USER_SETTINGS_PROVIDER_ID,
-        title: "ask_user",
-        origin: "@hheei/pi-ask-user",
-        description: "Interactive prompts: where the question is drawn.",
-        groups: [
-            {
-                id: SETTINGS_SECTION,
-                title: "",
-                fields: Object.values(ASK_USER_FIELDS),
-            },
-        ],
-        storage: createJsonSettingsStorage({ group: SETTINGS_SECTION }),
-    };
-}
-/** Registers the provider in the runtime registry; returns the unregister handle. */
-export function registerAskUserSettings(pi) {
-    return registerSettings(createAskUserSettingsProvider(), getRuntimeSettingsRegistry(pi));
-}