@timurproko/a1 0.2.7-dev.1275 → 0.2.7-dev.1276

package/dist/app/session-shell/apps-dialog.d.ts

@@ -1,4 +1,4 @@
-import type { TerminalComponentPort } from "../../contracts/presentation/index.js";
+import { type TerminalComponentPort } from "../../contracts/presentation/index.js";
 import { type UiTheme } from "../../ui/components/index.js";
 declare const APPS: readonly [{
     readonly id: "agent";

package/dist/app/session-shell/apps-dialog.js

@@ -1,3 +1,4 @@
+import { wrapChoiceIndex } from "../../contracts/presentation/index.js";
 import { LineInput, handleLineInputKey, ShortcutRegistry, configureDialogChoiceCapacity, renderSteppedDialogPanel } from "../../ui/components/index.js";
 const APPS = [
     { id: "agent", label: "Agent" },
@@ -49,7 +50,7 @@ export class AppsDialog {
             return;
         }
         if (action === "previous" || action === "next") {
-            this.#index = Math.max(0, Math.min(matches.length - 1, this.#index + (action === "next" ? 1 : -1)));
+            this.#index = wrapChoiceIndex(this.#index, action === "next" ? 1 : -1, matches.length);
         }
         else {
             handleLineInputKey(this.#input, key);

package/dist/app/session-shell/dialog-coordinator.d.ts

@@ -12,6 +12,7 @@ interface SessionDialogPorts {
     readonly viewport?: () => {
         rows: number;
     };
+    readonly inPlaceSession?: boolean;
     readonly root: Pick<OwnedUiSessionShellRoot, "chrome" | "setInputSurface" | "usesDefaultInputSurface">;
     readonly routeHost: UiRouteHost | null;
     readonly dialogs: Pick<OwnedUiShellComponents["dialogs"], "dialog" | "selector">;
@@ -22,11 +23,7 @@ interface SessionDialogPorts {
     readonly routeClosed?: (route: string) => void;
     readonly startupRoute?: StartupRoute;
 }
-/**
- * Owns the one modal overlay a session shows at a time, whichever source opened it: an owned route,
- * a local selector, or a backend dialog. Opening one hides the previous one, and every close path
- * clears the same state.
- */
+/** Coordinates owned routes, dock dialogs, and backend overlays through one replacement/close lifecycle. */
 export declare class SessionDialogCoordinator {
     #private;
     constructor(ports: SessionDialogPorts);
@@ -39,6 +36,8 @@ export declare class SessionDialogCoordinator {
     /** Mirrors the backend's pending dialog; locally owned routes and selectors are left alone when it has none. */
     syncBackend(dialog: OwnedUiDialog | null): void;
     openRoute(route: string, input?: UiRouteInput, onClosed?: () => void | Promise<void>): OwnedUiCommandResult;
+    /** Close the route before global abort. */
+    handleInputRouteInterrupt(data: string): boolean;
     claimsRoute(name: string): boolean;
     /** Retains a route requested before the runtime runs; the latest request wins. */
     retainStartupRoute(route: string): void;

package/dist/app/session-shell/dialog-coordinator.js

@@ -1,10 +1,7 @@
+import { InputRoute } from "./input-route.js";
 const OVERLAY_OPTIONS = { width: "70%", maxHeight: "80%", anchor: "center", inputCoordination: "owned" };
 const STARTUP_ROUTE_RETRY_MS = 25;
-/**
- * Owns the one modal overlay a session shows at a time, whichever source opened it: an owned route,
- * a local selector, or a backend dialog. Opening one hides the previous one, and every close path
- * clears the same state.
- */
+/** Coordinates owned routes, dock dialogs, and backend overlays through one replacement/close lifecycle. */
 export class SessionDialogCoordinator {
     #ports;
     #handle;
@@ -12,6 +9,7 @@ export class SessionDialogCoordinator {
     #source;
     #route;
     #apps;
+    #inputRoute;
     #startupRoute;
     #startupRouteTimer;
     constructor(ports) {
@@ -133,24 +131,54 @@ export class SessionDialogCoordinator {
         this.#handle?.hide();
         this.#source = "route";
         this.#route = route;
+        const closed = (rendered) => {
+            if (rendered) {
+                try {
+                    void onClosed?.()?.catch(() => undefined);
+                }
+                catch { /* Rationale: a failed acknowledgement stays pending. */ }
+                this.#ports.routeClosed?.(route);
+            }
+        };
+        if (route === "session" && this.#ports.inPlaceSession) {
+            const component = new InputRoute(surface, {
+                requestRender: () => this.#ports.terminal.requestRender(),
+                closed: rendered => { this.closeInputSurface(); closed(rendered); },
+                released: () => { if (this.#handle === handle)
+                    this.#clear(); },
+                key: data => this.#ports.presentation?.terminalRuntime.legacyKeyInput(data) ?? data,
+                exit: () => this.#ports.exit(),
+            });
+            const handle = { hide: () => component.close(), close: () => component.close() };
+            this.#handle = handle;
+            this.#inputRoute = component;
+            this.#id = surface.id;
+            this.#ports.root.setInputSurface(component);
+            this.#ports.terminal.requestRender();
+            return { outcome: "completed", diagnostic: null };
+        }
         const handle = this.#ports.terminal.openRoute(surface, {
             exit: () => this.#ports.exit(),
             closed: rendered => {
                 if (this.#handle === handle)
                     this.#clear();
-                if (rendered) {
-                    try {
-                        void onClosed?.()?.catch(() => undefined);
-                    }
-                    catch { /* Rationale: a failed acknowledgement stays pending. */ }
-                    this.#ports.routeClosed?.(route);
-                }
+                closed(rendered);
             },
         });
         this.#handle = handle;
         this.#id = surface.id;
         return { outcome: "completed", diagnostic: null };
     }
+    /** Close the route before global abort. */
+    handleInputRouteInterrupt(data) {
+        if (this.#inputRoute === undefined || this.#apps !== undefined)
+            return false;
+        const key = this.#ports.presentation?.terminalRuntime.legacyKeyInput(data) ?? data;
+        if (key !== "\u0003")
+            return false;
+        this.#inputRoute.handleInput(key);
+        return true;
+    }
     claimsRoute(name) {
         return this.#ports.routeHost?.claims(name) ?? false;
     }
@@ -197,5 +225,6 @@ export class SessionDialogCoordinator {
         this.#id = undefined;
         this.#source = undefined;
         this.#route = undefined;
+        this.#inputRoute = undefined;
     }
 }

package/dist/app/session-shell/input-route.d.ts

@@ -0,0 +1,23 @@
+import type { OwnedUiShellComponentPort } from "../../contracts/owned-ui/index.js";
+import type { UiRouteSurface } from "../../ui/apps/index.js";
+import type { PaneMouseEvent } from "../../ui/components/index.js";
+type InputRouteOptions = {
+    readonly requestRender: () => void;
+    readonly closed: (rendered: boolean) => void;
+    readonly exit: () => void;
+    readonly released: () => void;
+    readonly key: (data: string) => string;
+};
+/** Hosts a bounded dock route. */
+export declare class InputRoute implements OwnedUiShellComponentPort {
+    #private;
+    constructor(surface: UiRouteSurface, options: InputRouteOptions);
+    render(width: number): readonly string[];
+    renderInDock(width: number, maxHeight: number): readonly string[];
+    handleInput(data: string): void;
+    handleLocalMouse(event: PaneMouseEvent): void;
+    invalidate(): void;
+    close(): void;
+    dispose(): void;
+}
+export {};

package/dist/app/session-shell/input-route.js

@@ -0,0 +1,59 @@
+/** Hosts a bounded dock route. */
+export class InputRoute {
+    #surface;
+    #options;
+    #disposed = false;
+    #rendered = false;
+    constructor(surface, options) {
+        this.#surface = surface;
+        this.#options = options;
+        surface.onRenderRequested(() => { if (!this.#disposed)
+            this.#refresh(); });
+        surface.onExitRequested(() => { this.close(); options.exit(); });
+    }
+    render(width) { return this.renderInDock(width, 24); }
+    renderInDock(width, maxHeight) {
+        if (this.#disposed)
+            return [];
+        const frame = this.#surface.render(width, Math.max(1, Math.min(24, maxHeight)));
+        this.#rendered = true;
+        return frame;
+    }
+    handleInput(data) {
+        if (this.#disposed)
+            return;
+        const key = this.#options.key(data);
+        // Compatibility: close even while the deferred document is loading.
+        if (key === "\u001b" || key === "\u0003") {
+            this.close();
+            return;
+        }
+        this.#surface.handleInput(key);
+        this.#refresh();
+    }
+    handleLocalMouse(event) {
+        if (this.#disposed)
+            return;
+        this.#surface.handleMouse(event);
+        this.#refresh();
+    }
+    invalidate() { }
+    close() {
+        if (this.#disposed)
+            return;
+        this.#options.closed(this.#rendered);
+        this.dispose();
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.#surface.close();
+        this.#options.released();
+    }
+    #refresh() {
+        if (this.#surface.isClosed())
+            this.close();
+        this.#options.requestRender();
+    }
+}

package/dist/app/session-shell/session-selectors.d.ts

@@ -28,8 +28,8 @@ export declare class SessionSelectors implements WorkflowSelectors {
     #private;
     constructor(ports: SessionSelectorPorts);
     showThinkingSelector(): Promise<void>;
-    /** The Skills dialog: a replacement input like the model selector, applying the chosen skill through the prompt path. */
-    showSkillsSelector(skills: readonly OwnedUiShellSkillSummary[]): void;
+    /** Applies a dock-selected skill through the prompt path. */
+    showSkillsSelector(skills: readonly OwnedUiShellSkillSummary[]): Promise<void> | undefined;
     showModelSelector(initialSearchInput?: string): void;
     showForkSelector(): void;
     showLogoutSelector(): Promise<void>;
@@ -39,7 +39,7 @@ export declare class SessionSelectors implements WorkflowSelectors {
     showLoginProviderSelector(authType?: "oauth" | "api_key", initialSearchInput?: string): void;
     showSessionSelector(): Promise<void>;
     showSettingsSelector(): void;
-    showTrustSelector(): void;
+    showTrustSelector(): Promise<void> | undefined;
     showScopedModelsSelector(): void;
     /** The bare-A1 unified Models dialog: switch on Enter, scope on Space, persist on Ctrl+S, all through the engine. */
     showModelsDialog(initialQuery?: string): void | Promise<void>;

package/dist/app/session-shell/session-selectors.js

@@ -77,7 +77,7 @@ export class SessionSelectors {
             releasePresentation?.();
         }
     }
-    /** The Skills dialog: a replacement input like the model selector, applying the chosen skill through the prompt path. */
+    /** Applies a dock-selected skill through the prompt path. */
     showSkillsSelector(skills) {
         const close = this.#dialogs.closeInputSurface;
         const component = this.#presenters.components.dialogs.skillsSelector({
@@ -89,6 +89,7 @@ export class SessionSelectors {
             onCancel: close,
         });
         this.#present(component);
+        return component.ready;
     }
     showModelSelector(initialSearchInput) {
         this.#presenters.openModelSelector(this.#dialogHost, initialSearchInput);
@@ -214,6 +215,7 @@ export class SessionSelectors {
             onCancel: close,
         });
         this.#present(component);
+        return component.ready;
     }
     showScopedModelsSelector() {
         this.#presenters.openScopedModelsSelector(this.#dialogHost);
@@ -261,9 +263,12 @@ export class SessionSelectors {
         if (result.diagnostic === "Branch summarization cancelled")
             await this.showTreeSelector(entryId);
     }
-    // Invariant: a selector replaces the editor in the input dock and paints in the same frame.
+    // Performance: retain the frame until a deferred selector is ready.
     #present(component) {
+        const release = component?.ready === undefined ? undefined : this.#terminal.beginPresentationHold();
         this.#root.setInputSurface(component);
+        void component?.ready?.finally(() => { release?.(); if (!this.#ports.disposed())
+            this.#terminal.requestRender(); });
         this.#terminal.requestRender();
     }
 }

package/dist/app/session-shell/session-shell-root.js

@@ -357,10 +357,14 @@ export class OwnedUiSessionShellRoot {
         const messageStart = queued.length;
         const copyableMessageRows = Array.from({ length: statusRows.length + noticeRows.length }, (_value, index) => ({ row: messageStart + index }));
         const aboveWidgets = this.#extensions.renderWidgets("aboveEditor", width);
-        const input = this.#input.surface.render(width);
-        const body = this.usesDefaultInputSurface() ? this.editor.bodyGeometry?.() : undefined;
         const belowWidgets = this.#extensions.renderWidgets("belowEditor", width);
         const footer = this.#renderFooter(width);
+        // Invariant: reserve transcript context above scrollable routes.
+        const available = Math.max(1, this.#componentRuntime.getRows() - transientRows.length - aboveWidgets.length - belowWidgets.length - footer.length - 3);
+        const surface = this.#input.surface;
+        const input = this.#customViewport && surface.renderInDock !== undefined
+            ? surface.renderInDock(width, available) : surface.render(width);
+        const body = this.usesDefaultInputSurface() ? this.editor.bodyGeometry?.() : undefined;
         const rowsWithoutTransient = [...aboveWidgets, ...input, ...belowWidgets, ...footer];
         const inputOffset = transientRows.length + aboveWidgets.length;
         return {

package/dist/app/session-shell/session-shell.js

@@ -181,7 +181,7 @@ export class OwnedUiSessionPresenter {
             this.#dialogs = new SessionDialogCoordinator({
                 terminal: this.#terminal,
                 root: this.root,
-                routeHost: routeHost ?? null, dialogs: options.presenters.components.dialogs,
+                routeHost: routeHost ?? null, dialogs: options.presenters.components.dialogs, inPlaceSession: this.#customViewport,
                 presentation: options.presenters, viewport: () => this.#terminal.viewport(),
                 disposed: () => this.#disposed,
                 exit: () => { void this.shutdown(); },
@@ -315,6 +315,8 @@ export class OwnedUiSessionPresenter {
         }
         // Compatibility: route modal paging and boundary keys before Pi's fullscreen handlers.
         const isDefault = this.root.usesDefaultInputSurface();
+        if (this.#dialogs.handleInputRouteInterrupt(data))
+            return { consume: true };
         if (!this.#terminal.hasOverlay() && !isDefault
             && (this.root.editor.matchesTerminalKey(data, "pageUp")
                 || this.root.editor.matchesTerminalKey(data, "pageDown"))) {
@@ -921,7 +923,7 @@ export class OwnedUiSessionPresenter {
         const skills = this.#skillSummaries();
         const trimmed = argument.trim();
         if (trimmed.length === 0) {
-            this.selectors.showSkillsSelector(skills);
+            await this.selectors.showSkillsSelector(skills);
             return { outcome: "completed", diagnostic: null };
         }
         const separator = trimmed.search(/\s/u);

package/dist/app/session-shell/viewport-pointer.js

@@ -110,7 +110,11 @@ export class ViewportPointerGestures {
             viewport.setRailHovered(false);
             viewport.setStickyHovered(false);
             this.#position = undefined;
-            owner.component.handleInput?.(report);
+            if (owner.component.handleLocalMouse !== undefined) {
+                owner.component.handleLocalMouse({ ...event, column: event.column - owner.columnStart + 1, row: event.row - owner.rowStart + 1 });
+            }
+            else
+                owner.component.handleInput?.(report);
             outcome.repaint = true;
             return true;
         }

package/dist/app/session-shell/workflow-router.d.ts

@@ -6,7 +6,7 @@ export interface WorkflowSelectors {
     showModelSelector(initialSearchInput?: string): void;
     showForkSelector(): void;
     showThinkingSelector(): Promise<void>;
-    showTrustSelector(): void;
+    showTrustSelector(): void | Promise<void>;
     showSettingsSelector(): void;
     showSessionSelector(): Promise<void>;
     showLoginAuthTypeSelector(): void;

package/dist/composition/settings-route-host.js

@@ -92,6 +92,7 @@ async function loadReferenceSurface(settings, route, title, document, options) {
         id,
         title,
         document: content,
+        ...(route === "session" ? { presentation: "dialog" } : {}),
         scrollSettings: () => ({
             scrollbarAppearance: settings.value("scrollbarAppearance"),
             scrollbarStyle: settings.value("scrollbarStyle"),

package/dist/contracts/owned-ui/shell-components.d.ts

@@ -14,9 +14,19 @@ export interface OwnedUiShellKeybindingsHost {
     reload(): void;
 }
 export interface OwnedUiShellComponentPort {
+    readonly ready?: Promise<void>;
     render(width: number): readonly string[];
+    /** Bounds scrollable replacement inputs within the dock. */
+    renderInDock?(width: number, maxHeight: number): readonly string[];
     invalidate(): void;
     handleInput?(data: string): void;
+    /** Pointer input in one-based component-local coordinates, when supported. */
+    handleLocalMouse?(event: {
+        readonly kind: "press" | "release" | "motion" | "wheel-up" | "wheel-down";
+        readonly button: number;
+        readonly column: number;
+        readonly row: number;
+    }): void;
     setFocused?(focused: boolean): void;
     dispose?(): void;
 }

package/dist/contracts/presentation/component.d.ts

@@ -2,6 +2,13 @@ export interface PresentationComponentPort {
     render(width: number): readonly string[];
     invalidate(): void;
     handleInput?(data: string): void;
+    /** Optional pointer input in one-based component-local coordinates. */
+    handleLocalMouse?(event: {
+        readonly kind: "press" | "release" | "motion" | "wheel-up" | "wheel-down";
+        readonly button: number;
+        readonly column: number;
+        readonly row: number;
+    }): void;
     setFocused?(focused: boolean): void;
     dispose?(): void;
 }

package/dist/contracts/presentation/index.d.ts

@@ -22,6 +22,8 @@ export declare const DIALOG_BACK_SHORTCUT_HINT: Readonly<{
 }>;
 /** Global inset inherited by every semantic row inside an A1-owned dialog frame. */
 export declare const DIALOG_CONTENT_PADDING_X = 1;
+/** Wraps choice navigation, leaving empty lists at a safe index. */
+export declare function wrapChoiceIndex(index: number, delta: number, count: number): number;
 export interface DialogFrameGeometry {
     readonly frameWidth: number;
     readonly contentPaddingX: number;

package/dist/contracts/presentation/index.js

@@ -6,6 +6,10 @@ export const DIALOG_CLOSE_SHORTCUT_HINT = Object.freeze({ key: "esc", action: "c
 export const DIALOG_BACK_SHORTCUT_HINT = Object.freeze({ key: "esc", action: "back" });
 /** Global inset inherited by every semantic row inside an A1-owned dialog frame. */
 export const DIALOG_CONTENT_PADDING_X = 1;
+/** Wraps choice navigation, leaving empty lists at a safe index. */
+export function wrapChoiceIndex(index, delta, count) {
+    return count > 0 ? ((index + delta) % count + count) % count : 0;
+}
 /** Shared full-width-rule/content-width geometry for string and component dialog renderers. */
 export function dialogFrameGeometry(width) {
     const frameWidth = Math.max(0, width);

package/dist/contracts/presentation/progress-palette.generated.d.ts

@@ -8,20 +8,24 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
         light: {
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
     };
@@ -30,20 +34,24 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
         light: {
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
     };
@@ -52,20 +60,24 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
         light: {
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
     };
@@ -74,20 +86,24 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
         light: {
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
     };
@@ -96,20 +112,24 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
         light: {
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
     };
@@ -118,20 +138,24 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
         light: {
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
     };