@timurproko/a1 0.2.7-dev.1252 → 0.2.7-dev.1255

package/dist/app/session-shell/prompt-history-controller.d.ts

@@ -1,10 +1,10 @@
+import type { OwnedUiShellEditorPort } from "../../contracts/owned-ui/index.js";
 import { type PromptHistoryKind, type PromptHistoryPort } from "../../contracts/owned-ui/index.js";
-import type { PiShellEditorPort } from "../../integrations/pi/components/index.js";
 /** Merges bounded recall snapshots; the editor alone owns browsing, draft, cursor, and undo state. */
 export declare class PromptHistoryController {
     #private;
     readonly options: {
-        editor: PiShellEditorPort;
+        editor: OwnedUiShellEditorPort;
         store: PromptHistoryPort;
         limit: number;
         fallback: readonly string[];
@@ -16,7 +16,7 @@ export declare class PromptHistoryController {
         rehydrate?: (text: string) => string;
     };
     constructor(options: {
-        editor: PiShellEditorPort;
+        editor: OwnedUiShellEditorPort;
         store: PromptHistoryPort;
         limit: number;
         fallback: readonly string[];

package/dist/app/session-shell/prompt-submission.d.ts

@@ -1,13 +1,15 @@
+import type { OwnedUiShellComponents } from "../../contracts/owned-ui/index.js";
 import type { OwnedUiCommand, OwnedUiCommandResult, OwnedUiSessionBackend, OwnedUiSessionViewModel, PromptHistoryImageSidecarPort } from "../../contracts/owned-ui/index.js";
 import type { PromptHistoryController } from "./prompt-history-controller.js";
 import type { SessionConcern } from "./session-concern.js";
 import type { OwnedUiSessionShellRoot } from "./session-shell-root.js";
 import type { OwnedUiPresenterTerminal } from "./shell-host.js";
-export interface PromptSubmissionPorts {
+interface PromptSubmissionPorts {
     readonly backend: Pick<OwnedUiSessionBackend, "session" | "identity" | "workflows">;
-    readonly root: Pick<OwnedUiSessionShellRoot, "editor" | "hasPendingPastes" | "waitForPromptPastes" | "setExtensionWidget" | "prepareHistoryText" | "imageChipAttachmentsFromEditor" | "preparePromptSubmission" | "omitUnsentPromptImages" | "resumeViewportFollowing" | "beginImageSubmissionStatus" | "appendWorkflowResult">;
+    readonly root: Pick<OwnedUiSessionShellRoot, "editor" | "hasPendingPastes" | "waitForPromptPastes" | "setExtensionWidget" | "prepareHistoryText" | "imageChipAttachmentsFromEditor" | "preparePromptSubmission" | "omitUnsentPromptImages" | "resumeViewportFollowing" | "beginImageSubmissionStatus" | "workflow">;
     readonly terminal: Pick<OwnedUiPresenterTerminal, "requestRender">;
     readonly cwd: string;
+    readonly statusText: OwnedUiShellComponents["info"]["statusText"];
     promptHistory(): PromptHistoryController | null;
     imageSidecar(): PromptHistoryImageSidecarPort | undefined;
     disposed(): boolean;
@@ -44,3 +46,4 @@ export declare class PromptSubmission implements SessionConcern {
     onSessionReplaced(): void;
     dispose(): void;
 }
+export {};

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

@@ -1,5 +1,4 @@
 import { assertOwnedUiCommand, assertPromptImages, ImageAttachmentError, } from "../../contracts/owned-ui/index.js";
-import { renderPiShellStatusText } from "../../integrations/pi/components/shell-presenters-info.js";
 const rejected = (diagnostic) => ({ outcome: "rejected", diagnostic });
 /**
  * Turns editor input into engine commands: prompts, steering, follow-ups, and bash, each recorded
@@ -80,7 +79,7 @@ export class PromptSubmission {
     reportError(error, message) {
         // Security: arbitrary provider/extension error messages can contain the entire request.
         try {
-            this.#ports.root.appendWorkflowResult({ command: "debug", outcome: "failed", message: message
+            this.#ports.root.workflow.appendResult({ command: "debug", outcome: "failed", message: message
                     ?? (error instanceof ImageAttachmentError ? error.message : "Submission failed. Check the prompt and try again.") }, error instanceof ImageAttachmentError ? error.code : undefined);
             this.#ports.terminal.requestRender();
         }
@@ -120,7 +119,7 @@ export class PromptSubmission {
     #showWaiting() {
         const count = this.#waiting.size;
         this.#ports.root.setExtensionWidget("owned-image-preparation", count === 0 ? null : {
-            render: width => [...renderPiShellStatusText(`Waiting for images (${count} submission${count === 1 ? "" : "s"}) — Esc cancels; dequeue restores`, width)],
+            render: width => [...this.#ports.statusText(`Waiting for images (${count} submission${count === 1 ? "" : "s"}) — Esc cancels; dequeue restores`, width)],
             invalidate: () => { },
         }, "aboveEditor");
         this.#ports.terminal.requestRender();
@@ -222,13 +221,13 @@ export class PromptSubmission {
                 message: result.cancelled ? "Bash command cancelled" : `Bash exited ${result.exitCode ?? 0}: ${command}`,
                 ...(result.output ? { detail: result.output } : {}),
             };
-            this.#ports.root.appendWorkflowResult(workflow);
+            this.#ports.root.workflow.appendResult(workflow);
             this.#ports.terminal.requestRender();
             return workflow.outcome === "failed" ? rejected(workflow.message) : { outcome: "completed", diagnostic: null };
         }
         catch (error) {
             const message = `Bash command failed: ${error instanceof Error ? error.message : String(error)}`;
-            this.#ports.root.appendWorkflowResult({ command: "debug", outcome: "failed", message });
+            this.#ports.root.workflow.appendResult({ command: "debug", outcome: "failed", message });
             this.#ports.terminal.requestRender();
             return rejected(message);
         }

package/dist/app/session-shell/quit-outro-effects.d.ts

@@ -16,14 +16,14 @@ export interface QuitOutroCell {
     readonly glyph: string;
     readonly color: string;
 }
-export interface QuitOutroPlan {
+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"];
+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;
+export {};

package/dist/app/session-shell/quit-outro-effects.js

@@ -6,10 +6,7 @@
  * 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 const QUIT_OUTRO_EFFECTS = Object.freeze(["fall", "dissolve", "starburst", "waves"]);
-export function isQuitOutroEffect(value) {
-    return typeof value === "string" && QUIT_OUTRO_EFFECTS.includes(value);
-}
+const QUIT_OUTRO_EFFECTS = Object.freeze(["fall", "dissolve", "starburst", "waves"]);
 const WHITE = "\x1b[38;2;238;238;238m";
 const DUST_GLYPHS = [".", "·", "'", ":", "+", "°"];
 const FALL_GLYPHS = [".", ".", "·", "'", ":", "°"];

package/dist/app/session-shell/quit-outro.d.ts

@@ -1,5 +1,5 @@
 import { type QuitOutroEffect } from "./quit-outro-effects.js";
-export interface QuitOutroFrame {
+interface QuitOutroFrame {
     /** Row content as presented, truncated to `columns`; index 0 is the top row. */
     readonly lines: readonly string[];
     readonly columns: number;
@@ -7,7 +7,7 @@ export interface QuitOutroFrame {
     /** Visible width of each line, at most `columns`. */
     readonly rowWidths: readonly number[];
 }
-export interface QuitOutroPlayback {
+interface QuitOutroPlayback {
     write(data: string): void;
     /** Monotonic clock seam; defaults to `Date.now`. */
     now?(): number;
@@ -16,25 +16,22 @@ export interface QuitOutroPlayback {
     /** Plan seed; defaults to a time- and geometry-derived value. */
     readonly seed?: number;
     /** Active bare-A1 canvas; omitted preserves transparent playback bytes. */
-    readonly canvasBackgroundAnsi?: string;
+    readonly canvas?: QuitOutroCanvas;
+}
+/** A painted canvas: its background sequence and how to rebase a row's default background onto it. */
+export interface QuitOutroCanvas {
+    readonly ansi: string;
+    readonly rebase: (content: string, backgroundAnsi: string) => string;
 }
-export declare const QUIT_OUTRO_MIN_MS = 300;
-export declare const QUIT_OUTRO_MAX_MS = 2000;
-/** Wall-clock allowance beyond the clamped duration before playback abandons remaining ticks. */
-export declare const QUIT_OUTRO_GUARD_MS = 500;
-/** Tick ceiling for a clock that stops advancing: the longest playback plus its guard at 30 fps. */
-export declare const QUIT_OUTRO_MAX_TICKS: number;
-export declare function clampQuitOutroDuration(durationMs: number): number;
 /**
  * Captures the presented rows into an outro frame. Returns null when nothing is
  * visible, so a blank screen never animates.
  */
 export declare function captureQuitOutroFrame(presented: readonly string[], columns: number, rows: number): QuitOutroFrame | null;
-/** The clear-and-repaint block that seeds the animation surface with the captured frame. */
-export declare function createQuitOutroSurfaceFrame(frame: QuitOutroFrame, canvasBackgroundAnsi?: string): string;
 /**
  * Plays the effect over the frame. Resolves true when the plan was played to
  * completion or abandoned at its guard, false when there was nothing to play.
  * Write failures propagate so the caller can decide to continue restoration.
  */
 export declare function playQuitOutro(frame: QuitOutroFrame, effect: QuitOutroEffect, durationMs: number, playback: QuitOutroPlayback): Promise<boolean>;
+export {};

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

@@ -6,22 +6,21 @@
  * terminal cannot delay restoration past the configured clamp.
  */
 import { displayWidth, truncateToWidth } from "../../ui/components/index.js";
-import { rebaseTerminalDefaultBackground } from "../../integrations/pi/tui-runtime/index.js";
 import { createQuitOutroPlan } from "./quit-outro-effects.js";
-export const QUIT_OUTRO_MIN_MS = 300;
-export const QUIT_OUTRO_MAX_MS = 2000;
+const QUIT_OUTRO_MIN_MS = 300;
+const QUIT_OUTRO_MAX_MS = 2000;
 /** Wall-clock allowance beyond the clamped duration before playback abandons remaining ticks. */
-export const QUIT_OUTRO_GUARD_MS = 500;
+const QUIT_OUTRO_GUARD_MS = 500;
 const FRAME_MS = 1000 / 30;
 /** Tick ceiling for a clock that stops advancing: the longest playback plus its guard at 30 fps. */
-export const QUIT_OUTRO_MAX_TICKS = Math.ceil((QUIT_OUTRO_MAX_MS + QUIT_OUTRO_GUARD_MS) / FRAME_MS) + 1;
+const QUIT_OUTRO_MAX_TICKS = Math.ceil((QUIT_OUTRO_MAX_MS + QUIT_OUTRO_GUARD_MS) / FRAME_MS) + 1;
 const SYNC_BEGIN = "\x1b[?2026h";
 const SYNC_END = "\x1b[?2026l";
 const RESET = "\x1b[0m";
 const CLEAR_SCREEN = "\x1b[2J";
 const HOME = "\x1b[H";
 const HIDE_CURSOR = "\x1b[?25l";
-export function clampQuitOutroDuration(durationMs) {
+function clampQuitOutroDuration(durationMs) {
     if (!Number.isFinite(durationMs))
         return QUIT_OUTRO_MIN_MS;
     return Math.max(QUIT_OUTRO_MIN_MS, Math.min(QUIT_OUTRO_MAX_MS, Math.floor(durationMs)));
@@ -45,8 +44,8 @@ export function captureQuitOutroFrame(presented, columns, rows) {
     return { lines, columns: width, rows: height, rowWidths };
 }
 /** The clear-and-repaint block that seeds the animation surface with the captured frame. */
-export function createQuitOutroSurfaceFrame(frame, canvasBackgroundAnsi) {
-    if (canvasBackgroundAnsi === undefined) {
+function createQuitOutroSurfaceFrame(frame, canvas) {
+    if (canvas === undefined) {
         let output = `${SYNC_BEGIN}${HIDE_CURSOR}${CLEAR_SCREEN}${HOME}${RESET}`;
         for (let row = 0; row < frame.rows; row++) {
             const line = frame.lines[row] ?? "";
@@ -55,12 +54,13 @@ export function createQuitOutroSurfaceFrame(frame, canvasBackgroundAnsi) {
         }
         return `${output}${SYNC_END}`;
     }
+    const canvasBackgroundAnsi = canvas.ansi;
     let output = `${SYNC_BEGIN}${HIDE_CURSOR}${RESET}${canvasBackgroundAnsi}${CLEAR_SCREEN}${HOME}`;
     for (let row = 0; row < frame.rows; row++) {
         const line = frame.lines[row] ?? "";
         if (frame.rowWidths[row] > 0) {
             output += `${cursorAt(row, 0)}${canvasBackgroundAnsi}`
-                + `${rebaseTerminalDefaultBackground(line, canvasBackgroundAnsi)}${RESET}${canvasBackgroundAnsi}`;
+                + `${canvas.rebase(line, canvasBackgroundAnsi)}${RESET}${canvasBackgroundAnsi}`;
         }
     }
     return `${output}${RESET}${SYNC_END}`;
@@ -81,8 +81,8 @@ export async function playQuitOutro(frame, effect, durationMs, playback) {
     let sparkleIndex = 0;
     let clearIndex = 0;
     let ticks = 0;
-    const canvas = playback.canvasBackgroundAnsi;
-    playback.write(createQuitOutroSurfaceFrame(frame, canvas));
+    playback.write(createQuitOutroSurfaceFrame(frame, playback.canvas));
+    const canvas = playback.canvas?.ansi;
     const startedAt = now();
     for (;;) {
         ticks += 1;

package/dist/app/session-shell/response-copy-protocol.d.ts

@@ -4,8 +4,8 @@ export declare const COPY_CLEANUP_MS = 250;
 export declare const MAX_COPY_BYTES: number;
 export declare const MAX_COPY_CONTROL_BYTES: number;
 export declare const COPY_CHUNK_UNITS = 16384;
-export type CopyOutcome = "delivered" | "submitted-unverified" | "failed" | "timed-out" | "superseded" | "canceled";
-export type CopyFailure = "size" | "unavailable" | "denied" | "transport" | "unsafe";
+type CopyOutcome = "delivered" | "submitted-unverified" | "failed" | "timed-out" | "superseded" | "canceled";
+type CopyFailure = "size" | "unavailable" | "denied" | "transport" | "unsafe";
 export interface CopyResult {
     readonly outcome: CopyOutcome;
     readonly failure?: CopyFailure;
@@ -54,3 +54,4 @@ export type CopyHelperOutput = {
     readonly result: CopyResult;
     readonly control?: string;
 };
+export {};

package/dist/app/session-shell/response-copy-transport.d.ts

@@ -15,26 +15,13 @@ export interface OwnedResponseCopyExecutor extends ResponseCopyExecutor {
     dispose(): void;
     readonly warmed: boolean;
 }
-export interface ResponseCopyTerminal {
+interface ResponseCopyTerminal {
     readonly maxBytes?: number;
     /** A supported non-blocking submission boundary, not clipboard acknowledgment. */
     submit(control: string, signal: AbortSignal): Promise<void>;
 }
 /** Never substitute a remote host's native clipboard for the terminal user's clipboard. */
 export declare function responseCopyDestination(env: NodeJS.ProcessEnv): "native" | "terminal";
-/**
- * Spawn options for one operating-system clipboard writer.
- * Platform: on POSIX the writer is detached into its own process group, as pinned Pi 1.4 does, so a writer
- * that daemonizes to keep serving the clipboard is not stopped when Ctrl+Z sends SIGTSTP to the shell's group.
- */
-export declare function platformClipboardWriteOptions(signal: AbortSignal, platform?: NodeJS.Platform): {
-    signal: AbortSignal;
-    windowsHide: boolean;
-    timeout: number;
-    killSignal: "SIGKILL";
-    maxBuffer: number;
-    detached: boolean;
-};
 /** Isolates preparation and native clipboard access; only the owner may submit terminal controls. */
 export declare function createResponseCopyExecutor(options?: {
     readonly terminal?: ResponseCopyTerminal;
@@ -52,3 +39,4 @@ export declare function createResponseCopyExecutor(options?: {
 }): OwnedResponseCopyExecutor;
 /** A spare-of-one pool of copy helpers; `createResponseCopyExecutor` takes its child and warms the next one after each copy. */
 export declare function createCopyHelperPool(helper?: URL, idleMs?: number): HelperPool;
+export {};

package/dist/app/session-shell/response-copy-transport.js

@@ -25,7 +25,7 @@ function platformClipboardCommands() {
  * Platform: on POSIX the writer is detached into its own process group, as pinned Pi 1.4 does, so a writer
  * that daemonizes to keep serving the clipboard is not stopped when Ctrl+Z sends SIGTSTP to the shell's group.
  */
-export function platformClipboardWriteOptions(signal, platform = process.platform) {
+function platformClipboardWriteOptions(signal, platform = process.platform) {
     return {
         signal,
         windowsHide: true,

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

@@ -5,7 +5,7 @@ export interface SessionResumeCommandMetadata {
 }
 export declare function formatSessionResumeCommand(metadata: SessionResumeCommandMetadata): string;
 export declare function quoteCommandArgument(value: string): string;
-export interface ExitTextInput {
+interface ExitTextInput {
     readonly terminalMode: "regular" | "fullscreen";
     readonly customViewport: boolean;
     readonly exitMode: "transcript" | "resume-hint";
@@ -27,3 +27,4 @@ export declare class SessionStopLatch {
     /** The engine stopped on its own: dispose the shell, then resolve whether or not disposal failed. */
     settleAfter(dispose: () => Promise<void>): void;
 }
+export {};

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

@@ -1,31 +1,23 @@
-import { ImageAttachmentError } from "../../contracts/owned-ui/index.js";
-import type { OwnedUiBackgroundSettingsPort, OwnedUiPromptSuggestionGeneratorPort, OwnedUiSessionBackend, OwnedUiSessionPresenters, OwnedUiSessionViewModel, OwnedUiTranscriptRendererPort, OwnedUiWorkflowMessage, OwnedUiWorkflowResult, OwnedUiViewportSettings, OwnedUiViewportSettingsPort, OwnedUiQuitOutroSettingsPort, SuggestionDecision, SuggestionDiagnosticObserver } from "../../contracts/owned-ui/index.js";
-import type { PiTuiPointerSurface } from "../../integrations/pi/tui-runtime/contracts.js";
+import type { OwnedUiShellComponents, OwnedUiShellHotkeysPresentation, OwnedUiShellClipboardContent, OwnedUiShellComponentPort, OwnedUiShellEditorPort, OwnedUiShellHeaderOptions, OwnedUiShellHeaderPort, OwnedUiShellHistoryEditor, OwnedUiShellImageAssetResolver, OwnedUiShellKeybindingsHost, OwnedUiShellLoadedResourcesPort, OwnedUiShellResourceEntry } from "../../contracts/owned-ui/index.js";
+import type { TerminalComponentPort, TerminalInputCoordinationScheduler, TerminalInputDiagnosticsEvent, TerminalInputSurfaceKind, TerminalLayoutNode, TerminalPointerSurface, TerminalPort } from "../../contracts/presentation/index.js";
+import type { ShellPresentationPorts, ThemeSource } from "../../contracts/presentation/index.js";
+import type { OwnedUiBackgroundSettingsPort, OwnedUiPromptSuggestionGeneratorPort, OwnedUiSessionBackend, OwnedUiSessionPresenters, OwnedUiSessionViewModel, OwnedUiTranscriptRendererPort, OwnedUiViewportSettings, OwnedUiViewportSettingsPort, OwnedUiQuitOutroSettingsPort, SuggestionDecision, SuggestionDiagnosticObserver } from "../../contracts/owned-ui/index.js";
 import type { UiRouteHost, UiRouteInput } from "../../ui/apps/contracts.js";
 import type { TranscriptViewportFrame, TranscriptViewportFrameDescriptor } from "../../ui/components/transcript-viewport.js";
-import type { PiShellLazySelectorLoader } from "../../integrations/pi/components/lazy-selectors.js";
-import type { PiShellHotkeysPresentation } from "../../integrations/pi/components/shell-presenters-info.js";
-import { type PiShellClipboardContent, type PiShellComponentPort, type PiKeybindingsHost, type PiShellEditorPort, type PiShellHeaderOptions, type PiShellHeaderPort, type PiShellImageAssetResolver, type PiShellLoadedResourcesPort, type PiShellResourceEntry, type PiShellTranscriptComponentPort } from "../../integrations/pi/components/shell-shared-facade.js";
-import { type PiTuiInputCoordinationScheduler, type PiTuiInputSurfaceKind } from "../../integrations/pi/tui-runtime/input-presentation-coordinator.js";
-import type { PiTuiComponentPort, PiTuiInputDiagnosticsEvent, PiTuiLayoutNode, PiTuiTerminalPort } from "../../integrations/pi/tui-runtime/contracts.js";
 import { type PreparedPrompt } from "./prompt-chips.js";
 import type { PastePreparationClientOptions } from "./paste-preparation-client.js";
 import type { OwnedUiClipboardServices } from "./clipboard-services.js";
+import type { OwnedUiClipboardPort } from "./shell-clipboard.js";
 import { type SessionViewportInputResult } from "./session-viewport-controller.js";
 import type { ResponseCopyExecutor } from "./response-copy-transport.js";
 import type { ResponseCopyEvent } from "./response-copy-protocol.js";
 import type { PasteEvent, PasteSource } from "./paste-protocol.js";
+import { DockChrome } from "./dock-chrome.js";
+import { WorkflowOutput } from "./workflow-output.js";
+import { TranscriptDocument } from "./transcript-document.js";
 import type { StreamPresentationScheduler } from "./stream-presentation-coalescer.js";
-export type OwnedUiTerminalPort = PiTuiTerminalPort;
-type OwnedUiStartupOptions = PiShellHeaderOptions;
-export interface OwnedUiClipboardPort {
-    readText(signal?: AbortSignal): Promise<string | null>;
-    readImage?(signal?: AbortSignal): Promise<{
-        readonly data: string;
-        readonly mimeType: string;
-    } | null>;
-    writeText?(text: string, signal?: AbortSignal): Promise<void>;
-}
+type OwnedUiTerminalPort = TerminalPort;
+type OwnedUiStartupOptions = OwnedUiShellHeaderOptions;
 /** The engine session the shell presents and the composition's decisions about it. */
 export interface OwnedUiShellEngineOptions {
     readonly backend: OwnedUiSessionBackend;
@@ -78,8 +70,8 @@ export interface OwnedUiShellPresentationOptions {
         readonly seed?: number;
     };
     readonly input?: {
-        readonly scheduler?: PiTuiInputCoordinationScheduler;
-        readonly onEvent?: (event: PiTuiInputDiagnosticsEvent) => void;
+        readonly scheduler?: TerminalInputCoordinationScheduler;
+        readonly onEvent?: (event: TerminalInputDiagnosticsEvent) => void;
         readonly now?: () => number;
         /** Evidence-only baseline seam; production leaves coordination enabled. */
         readonly coordination?: boolean;
@@ -98,7 +90,7 @@ export interface OwnedUiShellHistoryOptions {
     readonly forScope?: (scope: "unique" | "shared", sessionId: string | null) => Pick<OwnedUiShellHistoryOptions, "store" | "imageSidecar"> | null;
     readonly onScopeChange?: (listener: (scope: "unique" | "shared") => void) => () => void;
     readonly limit: number;
-    readonly editor: import("../../integrations/pi/components/index.js").HistoryEditorConstructor;
+    readonly editor: OwnedUiShellHistoryEditor;
     /** Optional per-profile filesystem sidecar for image chip payloads. When present, submit
      * writes each referenced attachment and recall reads them back to rehydrate live chips.
      * When absent, image chips silently strip on recall, matching the missing-sidecar path. */
@@ -124,8 +116,6 @@ export interface OwnedUiShellDiagnosticOptions {
     readonly paste?: (event: PasteEvent) => void;
     /** Test seams for isolated paste preparation: an in-process starter, or the forked helper's entry. */
     readonly pastePreparation?: Omit<PastePreparationClientOptions, "onEvent" | "spareIdleMs">;
-    /** Test seam for pending and failed optional selector-module preparation. */
-    readonly lazySelectors?: PiShellLazySelectorLoader;
 }
 /** Live prompt-image admission policy supplied only by the bare-A1 profile. */
 export interface OwnedUiShellPromptImagesOptions {
@@ -141,13 +131,13 @@ export interface OwnedUiShellSkillsOptions {
 export interface OwnedUiShellSharedServices {
     readonly clipboard?: OwnedUiClipboardServices;
     /** Must match the shell's layout: the owned-input profile for the custom viewport, Pi's otherwise. */
-    readonly keybindings?: PiKeybindingsHost;
+    readonly keybindings?: OwnedUiShellKeybindingsHost;
 }
 /** What composes an owned session shell, grouped by the collaborator that provides each part. */
 export interface OwnedUiSessionShellOptions {
     readonly engine: OwnedUiShellEngineOptions;
-    /** Resolves selectors and engine-backed transcript renderers. */
-    readonly presenters: OwnedUiSessionPresenters;
+    /** Resolves selectors, engine-backed transcript renderers, and the vendor presentation ports. */
+    readonly presenters: OwnedUiSessionPresenters & ShellPresentationPorts;
     readonly presentation?: OwnedUiShellPresentationOptions;
     readonly history?: OwnedUiShellHistoryOptions;
     readonly suggestions?: OwnedUiShellSuggestionOptions;
@@ -158,46 +148,56 @@ export interface OwnedUiSessionShellOptions {
     readonly diagnostics?: OwnedUiShellDiagnosticOptions;
     readonly shared?: OwnedUiShellSharedServices;
 }
+/** What the render root needs from its presenter: terminal size and render requests, the theme, and input callbacks. */
+interface OwnedUiSessionShellRootHandlers {
+    readonly presentation: ShellPresentationPorts;
+    readonly components: OwnedUiShellComponents;
+    readonly getColumns: () => number;
+    readonly getRows: () => number;
+    readonly requestRender: (force?: boolean) => void;
+    readonly onViewportFrame?: (frame: TranscriptViewportFrame) => void;
+    readonly requestHyperlinkCleanup?: (rows?: readonly number[]) => void;
+    readonly enableDockInputReuse?: boolean;
+    readonly persistentHistory?: boolean;
+    readonly historyEditor?: OwnedUiShellHistoryEditor;
+    readonly onSubmit: (text: string) => void;
+    readonly onPasteRejected?: (error: unknown) => void;
+    readonly onInterrupt: () => void;
+    readonly onClear?: () => void;
+    readonly onExit: () => void;
+    readonly onModelSelect: () => void;
+    readonly onModelCycle?: (direction: "forward" | "backward") => void;
+    readonly onThinkingCycle: () => void;
+    readonly onThinkingToggle?: () => void;
+    readonly onMessageCopy?: () => void;
+    readonly onFollowUp?: () => void;
+    readonly onDequeue?: () => void;
+    readonly onEditorChange?: (text: string) => void;
+    readonly onPromptSuggestionAccepted?: (text: string) => void;
+    readonly onInputSurfaceChanged?: () => void;
+    readonly onPromptSuggestionEligibilityChanged?: () => void;
+    readonly onCopyText?: (text: string, cut: boolean) => void;
+    readonly readClipboardContent?: (signal?: AbortSignal) => Promise<OwnedUiShellClipboardContent | null>;
+    readonly captureClipboardPaste?: () => PasteSource;
+    readonly pasteDiagnostics?: (event: PasteEvent) => void;
+    readonly pastePreparation?: Omit<PastePreparationClientOptions, "onEvent">;
+    readonly keybindings?: OwnedUiShellKeybindingsHost;
+    readonly promptImageLimit?: () => number;
+    readonly skillsPresentation?: () => "collapse" | "expand";
+}
 /** Composes session state into the owned transcript, viewport, editor, and dock. */
-export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
+export declare class OwnedUiSessionShellRoot implements TerminalComponentPort {
     #private;
-    readonly editor: PiShellEditorPort;
-    readonly header: PiShellHeaderPort;
-    readonly resources: PiShellLoadedResourcesPort;
-    constructor(view: OwnedUiSessionViewModel, cwd: string, handlers: {
-        readonly getColumns: () => number;
-        readonly getRows: () => number;
-        readonly requestRender: (force?: boolean) => void;
-        readonly onViewportFrame?: (frame: TranscriptViewportFrame) => void;
-        readonly requestHyperlinkCleanup?: (rows?: readonly number[]) => void;
-        readonly enableDockInputReuse?: boolean;
-        readonly persistentHistory?: boolean;
-        readonly historyEditor?: import("../../integrations/pi/components/index.js").HistoryEditorConstructor;
-        readonly onSubmit: (text: string) => void;
-        readonly onPasteRejected?: (error: unknown) => void;
-        readonly onInterrupt: () => void;
-        readonly onClear?: () => void;
-        readonly onExit: () => void;
-        readonly onModelSelect: () => void;
-        readonly onModelCycle?: (direction: "forward" | "backward") => void;
-        readonly onThinkingCycle: () => void;
-        readonly onThinkingToggle?: () => void;
-        readonly onMessageCopy?: () => void;
-        readonly onFollowUp?: () => void;
-        readonly onDequeue?: () => void;
-        readonly onEditorChange?: (text: string) => void;
-        readonly onPromptSuggestionAccepted?: (text: string) => void;
-        readonly onInputSurfaceChanged?: () => void;
-        readonly onPromptSuggestionEligibilityChanged?: () => void;
-        readonly onCopyText?: (text: string, cut: boolean) => void;
-        readonly readClipboardContent?: (signal?: AbortSignal) => Promise<PiShellClipboardContent | null>;
-        readonly captureClipboardPaste?: () => PasteSource;
-        readonly pasteDiagnostics?: (event: PasteEvent) => void;
-        readonly pastePreparation?: Omit<PastePreparationClientOptions, "onEvent">;
-        readonly keybindings?: PiKeybindingsHost;
-        readonly promptImageLimit?: () => number;
-        readonly skillsPresentation?: () => "collapse" | "expand";
-    }, startup?: PiShellHeaderOptions, agentDir?: string, extensionRenderers?: OwnedUiTranscriptRendererPort, sessionLayout?: "pinned" | "custom-viewport", imageAssets?: PiShellImageAssetResolver);
+    readonly editor: OwnedUiShellEditorPort;
+    readonly header: OwnedUiShellHeaderPort;
+    readonly resources: OwnedUiShellLoadedResourcesPort;
+    /** The transcript's semantic rows, caches, and engine-backed block renderers. */
+    readonly transcript: TranscriptDocument;
+    /** Workflow results, messages, and status lines appended to the transcript. */
+    readonly workflow: WorkflowOutput;
+    /** The dock's notices, copy acknowledgement, and release banner. */
+    readonly chrome: DockChrome;
+    constructor(view: OwnedUiSessionViewModel, cwd: string, handlers: OwnedUiSessionShellRootHandlers, startup?: OwnedUiShellHeaderOptions, agentDir?: string, extensionRenderers?: OwnedUiTranscriptRendererPort, sessionLayout?: "pinned" | "custom-viewport", imageAssets?: OwnedUiShellImageAssetResolver);
     setEditorPaddingX(padding: number): void;
     setAutocompleteMaxVisible(maxVisible: number): void;
     setOutputPad(padding: 0 | 1): void;
@@ -230,12 +230,6 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     canPresentPromptSuggestion(): boolean;
     setPromptSuggestion(text: string | null): void;
     update(view: OwnedUiSessionViewModel): void;
-    /**
-     * Applies one block: its component is created or updated in place and the order grows
-     * only when the block is new. A streamed chunk costs one component update rather than a
-     * walk of the whole transcript.
-     */
-    applyTranscriptBlock(block: OwnedUiSessionViewModel["transcript"][number]): void;
     render(width: number): readonly string[];
     viewportFrameDescriptor(): TranscriptViewportFrameDescriptor | null;
     /** Read-only, payload-free evidence; observing a pending frame must never render or repair it. */
@@ -268,58 +262,49 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     hasActiveSelection(): boolean;
     setViewportConfig(config: OwnedUiViewportSettings): void;
     setFullscreenCopyOnSelect(enabled: boolean): void;
-    showCopyAcknowledgement(message: string): void;
     resumeViewportFollowing(): void;
     noteCompletedAssistantMessage(): void;
-    /** A new session binding owns new mounts even when it reuses semantic invocation ids. */
-    resetTranscript(): void;
     resetViewport(): void;
     clearViewportPointerState(): void;
-    setViewportOverlaySurfaces(surfaces: readonly PiTuiPointerSurface[] | null): void;
+    setViewportOverlaySurfaces(surfaces: readonly TerminalPointerSurface[] | null): void;
     viewportInputGeometryReady(width: number, height: number): boolean;
     handleViewportPreInput(data: string, allowWheel?: boolean, now?: number, editorActive?: boolean): SessionViewportInputResult;
-    dismissNotice(): void;
     /** The pinned-profile layout regions of this session; the terminal host arranges them with `pinnedLayoutRoot`. */
     layoutParts(): PinnedLayoutParts;
-    transcriptComponent(id: string): PiShellTranscriptComponentPort | undefined;
-    exitTranscript(width: number): string;
-    appendWorkflowStatus(message: string): void;
-    appendWorkflowMessage(message: OwnedUiWorkflowMessage, errorCode?: ImageAttachmentError["code"]): void;
-    appendWorkflowResult(result: OwnedUiWorkflowResult, errorCode?: ImageAttachmentError["code"]): void;
     toggleThinkingVisibility(): void;
     get toolsExpanded(): boolean;
     setToolsExpanded(expanded: boolean): void;
-    setExtensionWidget(key: string, component: PiShellComponentPort | null, placement: "aboveEditor" | "belowEditor"): void;
-    setExtensionHeader(component: PiShellComponentPort | null): void;
-    setExtensionFooter(component: PiShellComponentPort | null): void;
+    setExtensionWidget(key: string, component: OwnedUiShellComponentPort | null, placement: "aboveEditor" | "belowEditor"): void;
+    setExtensionHeader(component: OwnedUiShellComponentPort | null): void;
+    setExtensionFooter(component: OwnedUiShellComponentPort | null): void;
     setExtensionStatus(key: string, text: string | undefined): void;
     setExtensionWorking(message: string | undefined, visible?: boolean): void;
     beginImageSubmissionStatus(): () => void;
-    hotkeysPresentation(): PiShellHotkeysPresentation;
+    hotkeysPresentation(): OwnedUiShellHotkeysPresentation;
     resetWorkflowPresentation(): void;
     resetExtensionUi(): void;
     addExtensionNotification(message: string, type: "info" | "warning" | "error"): void;
     extensionFooterData(): unknown;
     usesDefaultInputSurface(): boolean;
-    inputCoordinationSurface(): PiTuiInputSurfaceKind;
+    inputCoordinationSurface(): TerminalInputSurfaceKind;
     viewportCompositionEvidence(): {
         readonly full: number;
         readonly dockOnly: number;
     };
     transcriptRenderCount(): number;
     setFooterLevel(visible: boolean): void;
-    setInputSurface(component: PiShellComponentPort | null, disposePrevious?: boolean, coordination?: Exclude<PiTuiInputSurfaceKind, "editor">): void;
+    setInputSurface(component: OwnedUiShellComponentPort | null, disposePrevious?: boolean, coordination?: Exclude<TerminalInputSurfaceKind, "editor">): void;
     handleInput(data: string): void;
     invalidate(): void;
     setFocused(focused: boolean): void;
     dispose(): void;
 }
 export type PinnedLayoutPart = "document" | "queued" | "aboveWidgets" | "status" | "editor" | "belowWidgets" | "footer";
-export type PinnedLayoutParts = Readonly<Record<PinnedLayoutPart, PiTuiComponentPort>>;
+export type PinnedLayoutParts = Readonly<Record<PinnedLayoutPart, TerminalComponentPort>>;
 /**
  * The pinned-profile screen: a followed transcript scroll above the dock. The runtime mounts one such layout,
  * so its single `transcript` scroll view is shared by whichever session the parts currently resolve to.
  */
-export declare function pinnedLayoutRoot(parts: PinnedLayoutParts): PiTuiLayoutNode;
-export declare function shellResourceEntries(backend: OwnedUiSessionBackend): readonly PiShellResourceEntry[];
+export declare function pinnedLayoutRoot(parts: PinnedLayoutParts, theme: ThemeSource): TerminalLayoutNode;
+export declare function shellResourceEntries(backend: OwnedUiSessionBackend): readonly OwnedUiShellResourceEntry[];
 export {};