@timurproko/a1 0.1.8-dev.447 → 0.1.8-dev.459

package/README.md

@@ -71,6 +71,15 @@ preferred when consistent with your intent; genuinely unclear cases can remain
 empty. [Private diagnostic capture](docs/architecture/prompt-suggestions.md)
 explains how to distinguish skipped, empty, rejected, and timed-out suggestions.
 
+## Quitting
+
+`/quit`, `Ctrl+C` twice, and `Ctrl+D` on an empty prompt end a bare A1 session.
+The last screen dissolves on the alternate screen, the terminal is restored once,
+and only the dim `To resume this session:` hint is printed; the conversation is
+not echoed into your scrollback. `/settings` → Quit chooses the effect (`fall`,
+`dissolve`, `starburst`, `waves`, or `off`) and its duration (300–2000 ms). The
+`a1 pi` comparison profile keeps Pi's `fullscreenExitOutput` behavior.
+
 ## Prompt history
 
 Bare A1 recalls recent unique prompts across sessions with Up/Down. History is

package/dist/composition/owned-ui.js

@@ -84,6 +84,9 @@ export async function composeOwnedUi(options = {}) {
                 inputPresentation: { onEvent: event => clipboardDiagnostics.runtime(event) },
             }),
             ...(viewportSettings === null ? {} : { viewportSettings }),
+            ...(settings === null || !ownedSurfaces ? {} : {
+                quitOutro: { snapshot: () => quitOutroSettingsSnapshot(settings), interactive: process.stdout.isTTY === true },
+            }),
             ...(promptSuggestions === null ? {} : { promptSuggestions }),
             ...(promptHistory === null ? {} : { promptHistory: {
                     ...promptHistory,
@@ -113,6 +116,15 @@ export async function composeOwnedUi(options = {}) {
     };
     return { application, settings };
 }
+function quitOutroSettingsSnapshot(settings) {
+    const effect = settings.value("quitEffect");
+    const durationMs = settings.value("quitEffectDurationMs");
+    return {
+        enabled: settings.value("quitAnimation") !== false,
+        effect: effect === "dissolve" || effect === "starburst" || effect === "waves" ? effect : "fall",
+        durationMs: typeof durationMs === "number" ? durationMs : 800,
+    };
+}
 function viewportSettingsSnapshot(settings) {
     const appearance = settings.value("scrollbarAppearance");
     const style = settings.value("scrollbarStyle");

package/dist/contracts/owned-ui/model.d.ts

@@ -64,6 +64,18 @@ export interface OwnedUiViewportSettingsPort {
     snapshot(): OwnedUiViewportSettings;
     onChange(listener: (settings: OwnedUiViewportSettings) => void): () => void;
 }
+export type OwnedUiQuitEffect = "fall" | "dissolve" | "starburst" | "waves";
+/** Profile-local quit outro choice, read at the moment bare A1 quits. */
+export interface OwnedUiQuitOutroSettings {
+    /** False leaves the terminal immediately; the effect and duration are then ignored. */
+    readonly enabled: boolean;
+    readonly effect: OwnedUiQuitEffect;
+    /** Requested playback length; the player clamps it to its supported range. */
+    readonly durationMs: number;
+}
+export interface OwnedUiQuitOutroSettingsPort {
+    snapshot(): OwnedUiQuitOutroSettings;
+}
 export interface OwnedUiTerminalSurface {
     readonly columns: number;
     readonly rows: number;

package/dist/features/owned-ui/settings-app.d.ts

@@ -14,6 +14,7 @@ export declare class SettingsApp implements UiApp {
     readonly id = "settings";
     constructor(session: OwnedUiSettingsSession);
     onActivate(host: AppHostServices): void;
+    onClose(_host: AppHostServices): void;
     render(rect: PaneRect, host: AppHostServices): readonly string[];
     onInput(data: string, host: AppHostServices): PaneInputResult;
     onMouse(event: PaneMouseEvent, _host: AppHostServices): PaneInputResult;

package/dist/features/owned-ui/settings-app.js

@@ -1,10 +1,15 @@
-import { GLOBAL_SCOPE, LineInput, PLAIN_THEME, ShortcutRegistry, assertNoShortcutConflicts, blockJumpTarget, dialogValueColumn, numericValues, RAIL_COLUMNS, renderDialogPanel, renderEmptyState, renderGroupHeader, renderInputRow, renderListRow, renderNote, renderStatusLine, dialogRowAt, menuRowAt, regionAt, renderValueMenu, withScrollbarRail, stepperEnds, steppedValue, valueColumnFor, valueMenuFrame, blockRowSpan, displayWidth, handleLineInputKey, humanizeLabel, humanizeTitle, indexOfKey, isThumbRow, layoutList, moveSelection, rowKey, scrollForSelection, scrollbarGeometry, scrollbarWheelRows, selectableIndexes, } from "../../ui/components/index.js";
+import { GLOBAL_SCOPE, LineInput, PLAIN_THEME, ShortcutRegistry, assertNoShortcutConflicts, blockJumpTarget, dialogValueColumn, numericValues, RAIL_COLUMNS, renderDialogPanel, renderEmptyState, renderGroupHeader, renderInputRow, renderListRow, renderNote, renderStatusLine, dialogRowAt, menuRowAt, regionAt, renderValueMenu, withScrollbarRail, stepperEnds, steppedValue, valueColumnFor, valueMenuFrame, blockRowSpan, displayWidth, handleLineInputKey, humanizeLabel, humanizeTitle, indexOfKey, isThumbRow, layoutList, moveSelection, rowKey, scrollForSelection, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, ScrollbarRails, scrollbarWheelRows, selectableIndexes, } from "../../ui/components/index.js";
 import { SETTINGS_APP_ID, SETTINGS_ROUTE } from "./settings-route.js";
 export { SETTINGS_APP_ID, SETTINGS_ROUTE } from "./settings-route.js";
 const SCOPE = SETTINGS_APP_ID;
 /** The panel a setting with parts opens: its own keys, its own hint. */
 const DIALOG_SCOPE = `${SETTINGS_APP_ID}-parts`;
 const SCROLLBAR_TOP_INSET = 1;
+/** Identity of the settings list rail in the shared rail state. */
+const RAIL_KEY = "settings";
+// Compatibility: the transcript rail stays lit this long after a scroll, and repaints just after.
+const SCROLL_LINGER_MS = 900;
+const SCROLL_LINGER_REPAINT_MS = 925;
 const SEARCH_PLACEHOLDER = "search settings";
 /** What a structured value offers instead of printing itself. */
 const CONFIGURE = "configure";
@@ -16,8 +21,10 @@ SETTINGS_SHORTCUTS.declare({ key: "shift+up", scope: SCOPE, description: "Previo
 SETTINGS_SHORTCUTS.declare({ key: "shift+down", scope: SCOPE, description: "Next section", section: "Navigate", hint: { keys: "Shift+↑↓", does: "to jump" } }, "block-down");
 SETTINGS_SHORTCUTS.declare({ key: "pageUp", scope: SCOPE, description: "Up a page", section: "Navigate" }, "page-up");
 SETTINGS_SHORTCUTS.declare({ key: "pageDown", scope: SCOPE, description: "Down a page", section: "Navigate" }, "page-down");
-SETTINGS_SHORTCUTS.declare({ key: "home", scope: SCOPE, description: "First setting", section: "Navigate" }, "first");
-SETTINGS_SHORTCUTS.declare({ key: "end", scope: SCOPE, description: "Last setting", section: "Navigate" }, "last");
+// Compatibility: the same chords the transcript uses for its content boundaries; plain
+// Home and End stay with the search input's cursor.
+SETTINGS_SHORTCUTS.declare({ key: "ctrl+home", scope: SCOPE, description: "First setting", section: "Navigate" }, "first");
+SETTINGS_SHORTCUTS.declare({ key: "ctrl+end", scope: SCOPE, description: "Last setting", section: "Navigate" }, "last");
 SETTINGS_SHORTCUTS.declare({ key: "enter", scope: SCOPE, description: "Change value", section: "Change", hint: { keys: "Enter/Space", does: "to change" } }, "activate");
 SETTINGS_SHORTCUTS.declare({ key: "space", scope: SCOPE, description: "Change value", section: "Change", hint: { keys: "Enter/Space", does: "to change" } }, "activate");
 SETTINGS_SHORTCUTS.declare({ key: "left", scope: SCOPE, description: "Previous value", section: "Change", hint: { keys: "←→", does: "to adjust" } }, "previous-value");
@@ -39,8 +46,11 @@ const KEYS = {
     "\u001b[C": "right",
     "\u001b[5~": "pageUp",
     "\u001b[6~": "pageDown",
-    "\u001b[H": "home",
-    "\u001b[F": "end",
+    // Protocol: xterm modifier form, then the rxvt Ctrl form of the same chords.
+    "\u001b[1;5H": "ctrl+home",
+    "\u001b[1;5F": "ctrl+end",
+    "\u001b[7^": "ctrl+home",
+    "\u001b[8^": "ctrl+end",
     "\u001b": "escape",
     "\r": "enter",
     "\n": "enter",
@@ -76,6 +86,14 @@ export class SettingsApp {
     #hoverRegion = "label";
     #frameRows = [];
     #menuFrame = null;
+    // Invariant: rail hover and drag live in the shared keyed state, as the transcript's do.
+    #rails = new ScrollbarRails();
+    // Rationale: the rail as drawn in the last frame, or null when nothing can be pointed at.
+    #railFrame = null;
+    // Invariant: a scroll lights the rail until this time; the timer repaints once it has passed.
+    #activeUntil = 0;
+    #activityTimer;
+    #renderedScroll;
     constructor(session) {
         this.#session = session;
     }
@@ -85,6 +103,10 @@ export class SettingsApp {
             host.requestRender();
         });
     }
+    onClose(_host) {
+        this.#clearActivityTimer();
+        this.#rails.clear();
+    }
     render(rect, host) {
         const theme = host.theme ?? PLAIN_THEME;
         this.#interruptArmed = host.interruptArmed;
@@ -102,7 +124,17 @@ export class SettingsApp {
         this.#reveal = undefined;
         const layout = layoutList(rows, bodyHeight, this.#scroll);
         this.#scroll = layout.scroll;
-        const contentWidth = Math.max(0, rect.width - RAIL_COLUMNS);
+        const now = Date.now();
+        // Rationale: every way of scrolling ends in this frame, so a moved list is noticed here
+        // once rather than at each wheel, drag, key, and search branch.
+        if (this.#renderedScroll !== undefined && this.#renderedScroll !== layout.scroll)
+            this.#noteScrollActivity(host, now);
+        this.#renderedScroll = layout.scroll;
+        // Invariant: auto and always keep the rail columns while the list fits, so a revealed
+        // rail never reflows the rows; hidden gives the columns back to the rows.
+        const appearance = this.#scrollbarAppearance();
+        const reservesRail = appearance !== "hidden";
+        const contentWidth = reservesRail ? Math.max(0, rect.width - RAIL_COLUMNS) : rect.width;
         const valueColumn = this.#valueColumn(rows);
         const geometry = scrollbarGeometry({
             contentLength: rows.length,
@@ -110,6 +142,22 @@ export class SettingsApp {
             scroll: layout.scroll,
             trackHeight: Math.max(0, bodyHeight - SCROLLBAR_TOP_INSET),
         });
+        const presentation = scrollbarPresentation({
+            geometry,
+            appearance,
+            style: this.#scrollbarStyle(),
+            hovered: this.#rails.isHovered(RAIL_KEY),
+            dragging: this.#rails.isDragging(RAIL_KEY),
+            activeUntil: this.#activeUntil,
+            now,
+        });
+        this.#railFrame = reservesRail && geometry !== null
+            ? {
+                rail: { key: RAIL_KEY, column: rect.width, rowStart: SCROLLBAR_TOP_INSET, trackHeight: geometry.trackHeight },
+                geometry,
+                page: layout.visible,
+            }
+            : null;
         const body = [];
         this.#frameRows = [];
         if (rows.length === 0) {
@@ -140,8 +188,9 @@ export class SettingsApp {
         }
         const withRail = withScrollbarRail(body.slice(0, bodyHeight), geometry, contentWidth, theme, {
             topInset: SCROLLBAR_TOP_INSET,
+            presentation,
         });
-        return this.#withMenu([...withRail, ...footer], selected, layout, valueColumn, theme, rect);
+        return this.#withMenu([...withRail, ...footer], selected, layout, valueColumn, theme, rect, reservesRail ? RAIL_COLUMNS : 0);
     }
     onInput(data, host) {
         if (this.#structured !== null)
@@ -278,13 +327,16 @@ export class SettingsApp {
             this.#scroll = Math.max(0, this.#scroll + (event.kind === "wheel-down" ? distance : -distance));
             return { consumed: true };
         }
+        const rail = this.#railPointer(event);
+        if (rail.owned)
+            return { consumed: true };
         const row = this.#frameRows.find(candidate => candidate.screenRow === event.row - 1);
         const previousKey = this.#hoverKey;
         const previousRegion = this.#hoverRegion;
         if (row === undefined) {
             this.#hoverKey = null;
             this.#hoverRegion = "label";
-            return { consumed: event.kind !== "motion", render: previousKey !== null };
+            return { consumed: event.kind !== "motion", render: previousKey !== null || rail.changed };
         }
         this.#hoverKey = row.key;
         this.#hoverRegion = regionAt(row, event.column);
@@ -303,9 +355,55 @@ export class SettingsApp {
             }
             return { consumed: true };
         }
-        const changed = previousKey !== this.#hoverKey || previousRegion !== this.#hoverRegion;
+        const changed = previousKey !== this.#hoverKey || previousRegion !== this.#hoverRegion || rail.changed;
         return { consumed: event.kind !== "motion", render: changed };
     }
+    // Rationale: the rail takes its share of a pointer report first: hover, a thumb drag, or a
+    // track page. Owned means the list must not see the report; changed means the rail looks different.
+    #railPointer(event) {
+        const frame = this.#railFrame;
+        const wasHovered = this.#rails.isHovered(RAIL_KEY);
+        if (frame === null) {
+            this.#rails.clear();
+            return { owned: false, changed: wasHovered };
+        }
+        const pointer = { column: event.column, row: event.row - 1 };
+        if (this.#rails.isDragging(RAIL_KEY)) {
+            // Invariant: a drag keeps the pointer wherever it goes until the button comes up.
+            if (event.kind === "release")
+                this.#rails.endDrag();
+            else {
+                const target = this.#rails.dragTo(frame.rail, frame.geometry, pointer);
+                if (target !== null)
+                    this.#scroll = target;
+            }
+            return { owned: true, changed: true };
+        }
+        const over = this.#rails.notePointer([frame.rail], pointer) !== null;
+        if (!over)
+            return { owned: false, changed: wasHovered };
+        // Invariant: the rail is not a row: pointing at it lights nothing in the list.
+        this.#hoverKey = null;
+        this.#hoverRegion = "label";
+        if (event.kind === "press" && !this.#rails.beginDrag(frame.rail, frame.geometry, pointer)) {
+            this.#scroll = scrollForTrackPage(frame.geometry, pointer.row - frame.rail.rowStart, this.#scroll, frame.page);
+        }
+        return { owned: true, changed: true };
+    }
+    #noteScrollActivity(host, now) {
+        this.#activeUntil = Math.max(this.#activeUntil, now + SCROLL_LINGER_MS);
+        this.#clearActivityTimer();
+        this.#activityTimer = setTimeout(() => {
+            this.#activityTimer = undefined;
+            host.requestRender();
+        }, SCROLL_LINGER_REPAINT_MS);
+        this.#activityTimer.unref?.();
+    }
+    #clearActivityTimer() {
+        if (this.#activityTimer !== undefined)
+            clearTimeout(this.#activityTimer);
+        this.#activityTimer = undefined;
+    }
     #openMenu(rows, selected) {
         const row = rows[selected];
         if (row === undefined || row.kind !== "element")
@@ -348,6 +446,7 @@ export class SettingsApp {
         // thing under the pointer, so it stops looking like it.
         this.#hoverKey = null;
         this.#hoverRegion = "label";
+        this.#rails.clear();
         this.#structured = { entry, flags: entry.flags.map(flag => flag.key), index: 0, record };
     }
     #structuredKey(data) {
@@ -410,13 +509,15 @@ export class SettingsApp {
         if (input === null)
             return { consumed: false };
         const key = KEYS[data];
-        if (key === "home" || key === "end") {
+        // Rationale: the boundary chords jump through the results; plain Home and End stay with
+        // the search cursor, which the shared line input moves below.
+        if (key === "ctrl+home" || key === "ctrl+end") {
             const rows = this.#rows();
             const selectable = selectableIndexes(rows);
-            const target = key === "end" ? selectable.at(-1) : selectable[0];
+            const target = key === "ctrl+end" ? selectable.at(-1) : selectable[0];
             if (target !== undefined) {
                 this.#select(rows, target);
-                if (key === "home")
+                if (key === "ctrl+home")
                     this.#scroll = 0;
             }
             return { consumed: true };
@@ -502,11 +603,22 @@ export class SettingsApp {
         return this.#pending.get(`${entry.backend}:${entry.id}`) ?? entry.value;
     }
     #scrollbarSpeed() {
+        const value = this.#scrollSetting("scrollbarSpeed");
+        return isScrollbarSpeed(value) ? value : "normal";
+    }
+    #scrollbarAppearance() {
+        const value = this.#scrollSetting("scrollbarAppearance");
+        return value === "always" || value === "hidden" ? value : "auto";
+    }
+    #scrollbarStyle() {
+        return this.#scrollSetting("scrollbarStyle") === "thick" ? "thick" : "thin";
+    }
+    // Invariant: a Scroll setting reads as the screen shows it: an accepted value first, then the source.
+    #scrollSetting(id) {
         const entry = this.#session.sections()
             .flatMap(section => section.entries)
-            .find(candidate => candidate.backend === "a1" && candidate.id === "scrollbarSpeed");
-        const value = entry === undefined ? this.#session.value("scrollbarSpeed") : this.#shownValue(entry);
-        return isScrollbarSpeed(value) ? value : "normal";
+            .find(candidate => candidate.backend === "a1" && candidate.id === id);
+        return entry === undefined ? this.#session.value(id) : this.#shownValue(entry);
     }
     #jump(rows, target) {
         this.#select(rows, target);
@@ -590,7 +702,7 @@ export class SettingsApp {
             ...(typeof shown === "number" && entry.editable ? { stepper: stepperEnds(range, shown) } : {}),
         };
     }
-    #withMenu(lines, _selected, _layout, valueColumn, theme, rect) {
+    #withMenu(lines, _selected, _layout, valueColumn, theme, rect, reservedRight) {
         const menu = this.#menu;
         const anchor = menu === null ? undefined : this.#frameRows.find(candidate => candidate.key === menu.anchorKey);
         if (menu === null || anchor === undefined) {
@@ -605,7 +717,7 @@ export class SettingsApp {
         const frame = valueMenuFrame(state, { screenRow: anchor.screenRow, valueColumn }, {
             bodyHeight: lines.length - this.#footerHeight,
             surfaceWidth: rect.width,
-            reservedRight: RAIL_COLUMNS,
+            reservedRight,
         });
         this.#menuFrame = frame;
         return renderValueMenu(lines, state, frame, theme);

package/dist/integrations/pi/components/shell-editor-autocomplete.js

@@ -63,6 +63,7 @@ export function createPiShellEditor(options) {
         ...(options.keybindingProfile === "a1" ? {
             terminalRows: options.getRows,
             getVisualLineCount: (width) => editorVisualLineCount(editor, width),
+            clearCommandSearchOnEscape: true,
         } : {}),
         ...(options.keybindingProfile === "a1" && options.promptPresentation !== undefined ? {
             ...(inputPresentation === undefined ? {} : { inputPresentation }),

package/dist/integrations/pi/components/upstream/components/owned-editor.d.ts

@@ -17,6 +17,8 @@ export interface OwnedEditorOptions extends EditorOptions {
     readonly terminalRows?: () => number;
     /** Reuses the editor's established atomic-aware visual layout when available. */
     readonly getVisualLineCount?: (width: number) => number | undefined;
+    /** Bare-A1 exception: Escape on a sole top-level slash-command search also clears the prompt. */
+    readonly clearCommandSearchOnEscape?: boolean;
 }
 export interface ShellEditorInstance extends EditorSurface {
     readonly actionHandlers: Map<AppKeybinding, () => void>;

package/dist/integrations/pi/components/upstream/components/owned-editor.js

@@ -21,6 +21,7 @@ export function createOwnedEditorClass(Base) {
         #styleSuggestionCaret;
         #terminalRows;
         #getVisualLineCount;
+        #clearCommandSearchOnEscape;
         #renderedBodyRowCount = 0;
         constructor(tui, theme, keybindings, options = {}) {
             super(tui, theme, options);
@@ -30,6 +31,7 @@ export function createOwnedEditorClass(Base) {
             this.#styleSuggestionCaret = options.styleSuggestionCaret ?? (text => `\u001b[7m${text}\u001b[27m`);
             this.#terminalRows = options.terminalRows ?? (() => 24);
             this.#getVisualLineCount = options.getVisualLineCount;
+            this.#clearCommandSearchOnEscape = options.clearCommandSearchOnEscape === true;
         }
         getRenderedBodyRowCount() { return this.#renderedBodyRowCount; }
         setPromptSuggestion(text) {
@@ -42,6 +44,16 @@ export function createOwnedEditorClass(Base) {
                 && this.getText().length === 0
                 && !this.isShowingAutocomplete();
         }
+        /** True when autocomplete is searching one space-free slash command that is the editor's only content. */
+        isTopLevelCommandSearch() {
+            if (!this.isShowingAutocomplete())
+                return false;
+            const text = this.getText();
+            if (!/^\/\S*$/.test(text))
+                return false;
+            const cursor = this.getCursor();
+            return cursor.line === 0 && cursor.col === text.length;
+        }
         setText(text) {
             if (text.length > 0)
                 this.#promptSuggestion = null;
@@ -92,6 +104,11 @@ export function createOwnedEditorClass(Base) {
                         return;
                     }
                 }
+                else if (this.#clearCommandSearchOnEscape && this.isTopLevelCommandSearch()) {
+                    // Escape on a bare slash-command search restores the empty prompt instead of only closing the menu.
+                    this.setText("");
+                    return;
+                }
                 super.handleInput(data);
                 return;
             }

package/dist/integrations/pi/engine/adapter.d.ts

@@ -178,6 +178,8 @@ export declare class PiEngineAdapter implements OwnedUiPromptSuggestionGenerator
     configuredTheme(): string | undefined;
     /** Settings port for the live runtime, or null before the runtime is available. */
     settingsPort(): PiSettingsIntegration | null;
+    /** Which settings surface this adapter serves; hidden-in-bare effects are unbindable in bare mode. */
+    get settingsProductMode(): "bare" | "comparison";
     bindSettingsOwner(owner: AgentSettingOwner, handlers: PiSettingOwnerHandlers): () => void;
     pinnedModelSelectorContext(): {
         readonly currentModel: unknown;

package/dist/integrations/pi/engine/adapter.js

@@ -224,10 +224,8 @@ export class PiEngineAdapter {
             return "unavailable";
         if (!session.model.reasoning)
             return "ordinary";
-        const levels = session.getAvailableThinkingLevels?.() ?? [];
-        // Compatibility: capability order, not the user's current setting or a provider-name heuristic.
-        return ["off", "minimal", "low", "medium", "high", "xhigh", "max"]
-            .find(level => levels.includes(level)) ?? "unavailable";
+        // Performance: the run's own level keeps the provider's thinking parameters, and the cached prefix, identical.
+        return readSuggestionReasoning(session.thinkingLevel);
     }
     async generate(request) {
         assertOwnedUiPromptSuggestionRequest(request);
@@ -246,15 +244,23 @@ export class PiEngineAdapter {
             return { identity, outcome: request.signal.aborted ? "cancelled" : "unavailable", text: null };
         }
         const model = session.model;
-        const agentState = session.agent.state;
+        const agent = session.agent;
+        const agentState = agent.state;
         const policy = this.suggestionReasoningPolicy();
         if (model === undefined || policy === "unavailable" || typeof runtime.services.modelRuntime.completeSimple !== "function") {
             return { identity, outcome: "unavailable", text: null };
         }
-        const messages = agentState.messages.filter(message => message.role === "user" || message.role === "assistant" || message.role === "toolResult");
+        // Performance: mirror the primary loop's request shape so the provider serves the conversation prefix
+        // from the run's prompt cache. `onResponse` stays out: extensions must not see a suggestion as a response.
         const reasoning = policy === "ordinary" || policy === "off" ? undefined : policy;
         let response;
         try {
+            const transformed = typeof agent.transformContext === "function"
+                ? await agent.transformContext(agentState.messages, request.signal)
+                : agentState.messages;
+            const messages = typeof agent.convertToLlm === "function"
+                ? await agent.convertToLlm(transformed)
+                : transformed.filter(message => message.role === "user" || message.role === "assistant" || message.role === "toolResult");
             response = await runtime.services.modelRuntime.completeSimple(model, {
                 systemPrompt: agentState.systemPrompt,
                 messages: [
@@ -265,6 +271,10 @@ export class PiEngineAdapter {
             }, {
                 signal: request.signal,
                 ...(reasoning === undefined ? {} : { reasoning }),
+                ...(agent.sessionId === undefined ? {} : { sessionId: agent.sessionId }),
+                ...(agent.thinkingBudgets === undefined ? {} : { thinkingBudgets: agent.thinkingBudgets }),
+                ...(agent.transport === undefined ? {} : { transport: agent.transport }),
+                ...(agent.onPayload === undefined ? {} : { onPayload: agent.onPayload }),
             });
         }
         catch {
@@ -748,6 +758,10 @@ export class PiEngineAdapter {
         }
         return this.#settingsIntegration;
     }
+    /** Which settings surface this adapter serves; hidden-in-bare effects are unbindable in bare mode. */
+    get settingsProductMode() {
+        return this.#settingsProductMode;
+    }
     bindSettingsOwner(owner, handlers) {
         const settings = this.settingsPort();
         if (settings === null)
@@ -3235,6 +3249,11 @@ function readModel(value) {
         displayName: stringValue(value.name) ?? modelId,
     };
 }
+function readSuggestionReasoning(value) {
+    return value === "minimal" || value === "low" || value === "medium" || value === "high" || value === "xhigh" || value === "max"
+        ? value
+        : "off";
+}
 function readThinkingLevel(value) {
     return value === "off" || value === "minimal" || value === "low" || value === "medium"
         || value === "high" || value === "xhigh"

package/dist/integrations/pi/engine/settings-effects.d.ts

@@ -1,6 +1,6 @@
 import type { AgentJsonValue, AgentSettingApplicationBoundary, AgentSettingChangeOutcome, AgentSettingOwner } from "../../../contracts/agent-engine/index.js";
 export type PiSettingKey = "autoCompact" | "showImages" | "imageWidthCells" | "autoResizeImages" | "blockImages" | "enableSkillCommands" | "steeringMode" | "followUpMode" | "transport" | "httpIdleTimeoutMs" | "thinkingLevel" | "theme" | "hideThinkingBlock" | "mermaidRenderingMode" | "showCacheMissNotices" | "collapseChangelog" | "enableInstallTelemetry" | "quietStartup" | "defaultProjectTrust" | "doubleEscapeAction" | "treeFilterMode" | "showHardwareCursor" | "editorPaddingX" | "outputPad" | "autocompleteMaxVisible" | "clearOnShrink" | "showTerminalProgress" | "tuiMode" | "fullscreenExitOutput" | "fullscreenScrollbar" | "warnings";
-export type PiSettingVisualClass = "none" | "transcript" | "transcript-geometry" | "editor-menu" | "queue-transcript" | "status-error" | "retry-error" | "footer-transcript" | "markdown" | "transcript-notice" | "startup-transcript" | "startup-selector" | "selector" | "terminal-cursor" | "editor-geometry" | "menu-geometry" | "terminal-frame" | "terminal-status" | "restored-parent-output" | "hidden";
+export type PiSettingVisualClass = "none" | "transcript" | "transcript-geometry" | "editor-menu" | "queue-transcript" | "status-error" | "retry-error" | "footer-transcript" | "markdown" | "transcript-notice" | "startup-transcript" | "startup-selector" | "selector" | "terminal-cursor" | "editor-geometry" | "menu-geometry" | "terminal-frame" | "terminal-status" | "hidden";
 export interface PiSettingVisualEvidence {
     /** Reviewed visual family; `none` still names the behavior that can emit styled diagnostics. */
     readonly class: PiSettingVisualClass;

package/dist/integrations/pi/engine/settings-effects.js

@@ -31,7 +31,7 @@ export const PI_SETTING_EFFECTS = Object.freeze({
     clearOnShrink: effect("live", "terminal", "terminal-frame", "pinned resize clearing and resulting terminal frame", "pi-terminal-operation-parity"),
     showTerminalProgress: effect("live", "terminal", "terminal-status", "pinned OSC progress lifecycle", "pi-terminal-operation-parity"),
     tuiMode: hiddenEffect("next-session", "shell", "pinned regular/fullscreen selector and terminal lifecycle", "pi-terminal-operation-parity"),
-    fullscreenExitOutput: effect("current-exit", "shutdown", "restored-parent-output", "pinned styled transcript and compact dim resume hint", "pinned-fullscreen-exit-parity"),
+    fullscreenExitOutput: hiddenEffect("current-exit", "shutdown", "pinned styled transcript and compact dim resume hint", "pinned-fullscreen-exit-parity"),
     fullscreenScrollbar: hiddenEffect("live", "shell", "pinned fullscreen scrollbar reservation", "pi-terminal-operation-parity"),
     warnings: effect("live", "agent", "transcript-notice", "pinned warning rows by warning part", "pinned-transcript-lifecycle-parity"),
 });

package/dist/integrations/pi/session-ui/quit-outro-effects.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Deterministic quit-outro effect plans, ported from the v2 sketch.
+ *
+ * Each effect turns the captured frame's per-row visible widths and a seed into
+ * two sorted schedules over unit playback progress: sparkles paint a glyph at a
+ * cell from `start`, and clears blank a cell at `end`. The player consumes both
+ * in order, so a fixed seed yields a byte-stable animation.
+ */
+export interface QuitOutroCell {
+    readonly row: number;
+    readonly col: number;
+    /** Progress at which the sparkle glyph is painted. */
+    readonly start: number;
+    /** Progress at which the cell is cleared. */
+    readonly end: number;
+    readonly glyph: string;
+    readonly color: string;
+}
+export interface QuitOutroPlan {
+    /** Sorted by `start`. */
+    readonly sparkles: readonly QuitOutroCell[];
+    /** Sorted by `end`. */
+    readonly clears: readonly QuitOutroCell[];
+}
+export declare const QUIT_OUTRO_EFFECTS: readonly ["fall", "dissolve", "starburst", "waves"];
+export type QuitOutroEffect = (typeof QUIT_OUTRO_EFFECTS)[number];
+export declare function isQuitOutroEffect(value: unknown): value is QuitOutroEffect;
+/** Builds the selected effect's deterministic plan for the captured row widths. */
+export declare function createQuitOutroPlan(effect: QuitOutroEffect, rowWidths: readonly number[], seed: number): QuitOutroPlan;