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

package/dist/integrations/pi/session-presenters/components.d.ts

@@ -0,0 +1,3 @@
+import type { OwnedUiShellComponents, OwnedUiShellLazySelectorLoader } from "../../../contracts/owned-ui/index.js";
+/** The Pi components and helpers behind the shell's neutral component record. */
+export declare function createPiShellComponents(loadLazySelectors: () => Promise<OwnedUiShellLazySelectorLoader>): OwnedUiShellComponents;

package/dist/integrations/pi/session-presenters/components.js

@@ -0,0 +1,75 @@
+import { createPiShellEditor } from "../components/shell-editor-autocomplete.js";
+import { createPiExtensionUiBridge } from "../components/shell-extension-ui.js";
+import { createPiQueuedInputStatus, createPiShellFooter, createPiShellHeader, createPiShellLoadedResources, createPiShellStatus, } from "../components/shell-footer-status.js";
+import { createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellHotkeys, createPiShellSessionInfo, renderPiShellCommandMessage, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStatusText, } from "../components/shell-presenters-info.js";
+import { createPiShellTranscriptComponent, isPiPromptStyleCompaction, renderPiShellStartupDiagnostic, renderPiShellTranscriptBlock, } from "../components/shell-presenters-transcript.js";
+import { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellReloadBox, createPiShellSelector, createPiShellSkillsSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../components/shell-selectors-dialogs.js";
+import { piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellInstalledUpdateStatus, } from "../components/shell-shared-facade.js";
+import { SKILLS_COMMAND_NAME, findSkillByArgument, rewriteSkillsTunnelSubmission, skillPrompt, skillsFromCommands, } from "../components/skills-command.js";
+import { ProgramStatusReporter } from "../components/upstream/program-status-reporter.js";
+import { workflowCommandNames } from "../engine/workflows.js";
+/** The Pi components and helpers behind the shell's neutral component record. */
+export function createPiShellComponents(loadLazySelectors) {
+    return {
+        editor: { create: createPiShellEditor },
+        chrome: {
+            header: createPiShellHeader,
+            status: createPiShellStatus,
+            footer: createPiShellFooter,
+            queuedInput: createPiQueuedInputStatus,
+            loadedResources: createPiShellLoadedResources,
+            installedUpdateStatus: renderPiShellInstalledUpdateStatus,
+            releaseUpdateBanner: renderPiShellReleaseUpdateBanner,
+            programStatusReporter: (report, getSessionName, app) => new ProgramStatusReporter(report, getSessionName, app),
+        },
+        transcript: {
+            component: createPiShellTranscriptComponent,
+            renderBlock: renderPiShellTranscriptBlock,
+            renderStartupDiagnostic: renderPiShellStartupDiagnostic,
+            isPromptStyleCompaction: isPiPromptStyleCompaction,
+        },
+        info: {
+            changelog: createPiShellChangelog,
+            collapsedChangelog: createPiShellCollapsedChangelog,
+            hotkeys: createPiShellHotkeys,
+            sessionInfo: createPiShellSessionInfo,
+            commandMessage: renderPiShellCommandMessage,
+            statusText: renderPiShellStatusText,
+            packageUpdateNotice: renderPiShellPackageUpdateNotice,
+            releaseUpdateNotice: renderPiShellReleaseUpdateNotice,
+            armin: createPiShellArmin,
+            earendilAnnouncement: createPiShellEarendilAnnouncement,
+            reloadBox: createPiShellReloadBox,
+        },
+        dialogs: {
+            dialog: createPiShellDialog,
+            selector: createPiShellSelector,
+            extensionSelector: createPiShellExtensionSelector,
+            authProviderSelector: createPiShellAuthProviderSelector,
+            loginDialog: createPiShellLoginDialog,
+            skillsSelector: createPiShellSkillsSelector,
+            trustSelector: createPiShellTrustSelector,
+            userMessageSelector: createPiShellUserMessageSelector,
+            async shareProgress(runtime, message, style) {
+                // Rationale: sharing is rare, so its progress surfaces stay off the startup graph.
+                const surfaces = await import("../components/share-operation-dialog.js");
+                return (style === "dialog" ? surfaces.createPiShellShareOperationDialog : surfaces.createPiShellOperationLoader)(runtime, message);
+            },
+            extensionUiBridge: createPiExtensionUiBridge,
+            lazySelectors: loadLazySelectors,
+        },
+        text: {
+            visibleWidth: piShellVisibleWidth,
+            truncateToWidth: piShellTruncateToWidth,
+            hyperlink: piShellHyperlink,
+        },
+        workflows: { commandNames: workflowCommandNames },
+        skills: {
+            commandName: SKILLS_COMMAND_NAME,
+            fromCommands: skillsFromCommands,
+            findByArgument: findSkillByArgument,
+            rewriteTunnelSubmission: rewriteSkillsTunnelSubmission,
+            prompt: skillPrompt,
+        },
+    };
+}

package/dist/integrations/pi/session-presenters/index.d.ts

@@ -1,2 +1,3 @@
+export { PI_SHELL_PRESENTATION } from "./presentation.js";
 export { createPiSessionPresenters } from "./presenters.js";
 export type { PiSessionPresenterBackend, PiSessionPresentersOptions } from "./presenters.js";

package/dist/integrations/pi/session-presenters/index.js

@@ -1 +1,2 @@
+export { PI_SHELL_PRESENTATION } from "./presentation.js";
 export { createPiSessionPresenters } from "./presenters.js";

package/dist/integrations/pi/session-presenters/presentation.d.ts

@@ -0,0 +1,3 @@
+import type { ShellPresentationPorts } from "../../../contracts/presentation/index.js";
+/** Everything the shell takes from Pi's presentation, assembled once from the component and TUI adapters. */
+export declare const PI_SHELL_PRESENTATION: ShellPresentationPorts;

package/dist/integrations/pi/session-presenters/presentation.js

@@ -0,0 +1,10 @@
+import { PI_THEME_SOURCE } from "../components/theme.js";
+import { piCanvasBackgroundAnsi, PINNED_PI_LAYOUT } from "../components/upstream/theme/theme.js";
+import { PI_TERMINAL_RUNTIME } from "../tui-runtime/runtime-factory.js";
+/** Everything the shell takes from Pi's presentation, assembled once from the component and TUI adapters. */
+export const PI_SHELL_PRESENTATION = Object.freeze({
+    theme: PI_THEME_SOURCE,
+    canvasBackground: (style) => piCanvasBackgroundAnsi(style),
+    pinnedOutputPad: PINNED_PI_LAYOUT.outputPad,
+    terminalRuntime: PI_TERMINAL_RUNTIME,
+});

package/dist/integrations/pi/session-presenters/presenters.d.ts

@@ -1,4 +1,5 @@
 import type { OwnedUiSessionBackend, OwnedUiSessionPresenters } from "../../../contracts/owned-ui/index.js";
+import type { ShellPresentationPorts } from "../../../contracts/presentation/index.js";
 import type { PiSessionPresentationSource } from "../engine/adapter.js";
 import type { PiShellLazySelectorLoader } from "../components/lazy-selectors.js";
 /** The session backend plus the Pi objects its selectors are built from; the Pi engine adapter is one. */
@@ -13,4 +14,4 @@ export interface PiSessionPresentersOptions {
  * Builds the selectors and transcript renderers whose inputs are Pi engine objects. This owner is the one place
  * that sees both the engine adapter and the Pi components, so the shell only ever holds the neutral port.
  */
-export declare function createPiSessionPresenters(adapter: PiSessionPresenterBackend, options?: PiSessionPresentersOptions): OwnedUiSessionPresenters;
+export declare function createPiSessionPresenters(adapter: PiSessionPresenterBackend, options?: PiSessionPresentersOptions): OwnedUiSessionPresenters & ShellPresentationPorts;

package/dist/integrations/pi/session-presenters/presenters.js

@@ -1,4 +1,6 @@
 import { createPiShellModelSelector, createPiShellModelsDialog, createPiShellScopedModelsSelector, createPiShellSessionSelector, createPiShellSettingsSelector, } from "../components/shell-selectors-dialogs.js";
+import { PI_SHELL_PRESENTATION } from "./presentation.js";
+import { createPiShellComponents } from "./components.js";
 const MODEL_REFRESH_TIMEOUT_MS = 15_000;
 const MODEL_REFRESH_TIMED_OUT = "Model refresh timed out; showing cached models.";
 /**
@@ -24,7 +26,7 @@ export function createPiSessionPresenters(adapter, options = {}) {
         // Compatibility: the component adapter passes Pi's own keybinding config through the neutral port.
         getShortcuts: bindings => source().pinnedShortcutDescriptions(bindings),
     };
-    return {
+    return { ...PI_SHELL_PRESENTATION, components: createPiShellComponents(loadLazySelectors),
         transcriptRenderers: () => renderers,
         openModelSelector(host, initialSearchInput) {
             const context = source().pinnedModelSelectorContext();

package/dist/integrations/pi/tui-runtime/adapter.js

@@ -136,8 +136,6 @@ export class PiTuiRuntimeAdapter {
     #preInputListeners = new Set();
     #consumeUnhandledMouse;
     #inputCoordinator;
-    #inputDiagnostics;
-    #diagnosticNow;
     #inputSink;
     #state = "idle";
     #stopPromise;
@@ -149,15 +147,14 @@ export class PiTuiRuntimeAdapter {
         this.#overlayGeometry = options.onOverlayGeometry === undefined ? undefined : new OverlayGeometryTracker(options.onOverlayGeometry);
         this.#terminal = options.terminal ?? new ProcessTerminal();
         this.#consumeUnhandledMouse = options.consumeUnhandledMouse ?? false;
-        this.#inputDiagnostics = options.inputDiagnostics;
-        this.#diagnosticNow = options.inputDiagnostics?.now ?? (() => performance.now());
+        const diagnostics = options.inputDiagnostics;
+        const diagnosticNow = diagnostics?.now ?? (() => performance.now());
+        const tracePhase = diagnostics === undefined ? undefined : runtimePhaseTracer(diagnostics, diagnosticNow, () => this.#inputCoordinator);
         // Invariant: the pinned renderer's frames pass through this gate, while writeControl and
         // the stop sequence reach the terminal directly. Freezing drops frames without touching
         // the renderer, so a scheduled repaint cannot land on top of the quit outro.
         const gatedTerminal = frozenGateTerminal(this.#terminal, () => this.#presentationFrozen || this.#presentationHolds.size > 0);
-        const tracedTerminal = options.inputDiagnostics === undefined
-            ? gatedTerminal
-            : diagnosticTerminal(gatedTerminal, phase => this.#traceRuntimePhase(phase));
+        const tracedTerminal = tracePhase === undefined ? gatedTerminal : diagnosticTerminal(gatedTerminal, tracePhase);
         const decoratedTerminal = options.decorateTerminal?.(tracedTerminal) ?? tracedTerminal;
         const coordination = options.inputCoordination ?? (options.inputDiagnostics === undefined
             ? undefined
@@ -173,10 +170,8 @@ export class PiTuiRuntimeAdapter {
                 },
                 ...(coordination.onReceipt === undefined ? {} : { onReceipt: coordination.onReceipt }),
                 ...(coordination.scheduler === undefined ? {} : { scheduler: coordination.scheduler }),
-                now: this.#diagnosticNow,
-                ...(options.inputDiagnostics === undefined ? {} : {
-                    onTrace: event => this.#traceInputCoordination(event),
-                }),
+                now: diagnosticNow,
+                ...(diagnostics === undefined ? {} : { onTrace: event => diagnostics.onEvent(event) }),
             });
         this.#tuiTerminal = this.#inputCoordinator === undefined
             ? preInputTerminal(decoratedTerminal, data => this.#routePreInput(data), this.#overlayGeometry !== undefined)
@@ -187,9 +182,7 @@ export class PiTuiRuntimeAdapter {
         this.#tuiTerminal.restoreOnExit = (before, after) => exitTerminal.restoreOnExit?.(before, after);
         this.#layoutRoot = options.layoutRoot;
         this.#logDirectory = options.logDirectory;
-        this.#rootBridge = new ComponentBridge(options.root, options.inputDiagnostics === undefined
-            ? undefined
-            : phase => this.#traceRuntimePhase(phase));
+        this.#rootBridge = new ComponentBridge(options.root, tracePhase);
         this.#bridges.set(options.root, this.#rootBridge);
         this.#mountedComponents.add(options.root);
         try {
@@ -560,22 +553,6 @@ export class PiTuiRuntimeAdapter {
         }
         return undefined;
     }
-    #traceInputCoordination(event) {
-        this.#inputDiagnostics?.onEvent(event);
-    }
-    #traceRuntimePhase(phase) {
-        if (this.#inputDiagnostics === undefined)
-            return;
-        const coordinator = this.#inputCoordinator;
-        this.#inputDiagnostics.onEvent({
-            phase,
-            revision: coordinator?.appliedRevision ?? 0,
-            atMs: this.#diagnosticNow(),
-            pendingDepth: coordinator?.pendingDepth ?? 0,
-            pendingPresentationDepth: coordinator?.pendingPresentation === true ? 1 : 0,
-            appliedRevision: coordinator?.appliedRevision ?? 0,
-        });
-    }
     #mountTui(tui) {
         tui.addChild(this.#rootBridge);
         if (tui instanceof TuiAltScreen && this.#layoutRoot !== undefined) {
@@ -854,3 +831,17 @@ function toOverlayOptions(options) {
         mapped.nonCapturing = options.nonCapturing;
     return mapped;
 }
+/** Reports one runtime phase with the input coordinator's depth and revision at that moment. */
+function runtimePhaseTracer(diagnostics, now, coordinator) {
+    return phase => {
+        const current = coordinator();
+        diagnostics.onEvent({
+            phase,
+            revision: current?.appliedRevision ?? 0,
+            atMs: now(),
+            pendingDepth: current?.pendingDepth ?? 0,
+            pendingPresentationDepth: current?.pendingPresentation === true ? 1 : 0,
+            appliedRevision: current?.appliedRevision ?? 0,
+        });
+    };
+}

package/dist/integrations/pi/tui-runtime/contracts.d.ts

@@ -1,166 +1,22 @@
-import type { PresentationComponentPort, PresentationPointerSurface } from "../../../contracts/presentation/index.js";
-import type { ProgramStatus, WheelScrollLines } from "@earendil-works/pi-tui";
-import type { PiTuiInputCoordinationDecision, PiTuiInputCoordinationScheduler, PiTuiInputSurfaceKind } from "./input-presentation-coordinator.js";
-export type PiTuiRuntimeState = "idle" | "running" | "stopping" | "stopped" | "failed";
-export interface PiTuiViewport {
-    readonly columns: number;
-    readonly rows: number;
-}
-export interface PiTuiScrollState {
-    readonly scrollTop: number;
-    readonly viewportHeight: number;
-    readonly followingEnd: boolean;
-    readonly scrollbarVisible: boolean;
-}
-export type PiTuiPointerSurface = PresentationPointerSurface;
-export interface PiTuiComponentPort extends PresentationComponentPort {
-    readonly wantsKeyRelease?: boolean;
-}
-export interface PiTuiTerminalPort {
-    start(onInput: (data: string) => void, onResize: () => void): void;
-    stop(): void;
-    drainInput(maxMs?: number, idleMs?: number): Promise<void>;
-    write(data: string): void;
-    readonly columns: number;
-    readonly rows: number;
-    readonly kittyProtocolActive: boolean;
-    moveBy(lines: number): void;
-    hideCursor(): void;
-    showCursor(): void;
-    clearLine(): void;
-    clearFromCursor(): void;
-    clearScreen(): void;
-    setTitle(title: string): void;
-    setProgress(active: boolean): void;
-    /** Optional for neutral test/decorator ports; the Pi-facing adapter always supplies it. */
-    setProgramStatus?(status: ProgramStatus): void;
-    /**
-     * Optional synchronous last-resort mode restore that Pi TUI invokes from a process `exit` handler when
-     * `stop()` did not run; the runtime adapter binds it to the undecorated terminal, so decorators need not forward it.
-     */
-    restoreOnExit?(before: string, after: string): void;
-}
-export type PiTuiSizeValue = number | `${number}%`;
-export type PiTuiOverlayAnchor = "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top-center" | "bottom-center" | "left-center" | "right-center";
-export interface PiTuiOverlayMargin {
-    readonly top?: number;
-    readonly right?: number;
-    readonly bottom?: number;
-    readonly left?: number;
-}
-export interface PiTuiOverlayOptions {
-    readonly width?: PiTuiSizeValue;
-    readonly minWidth?: number;
-    readonly maxHeight?: PiTuiSizeValue;
-    readonly anchor?: PiTuiOverlayAnchor;
-    readonly offsetX?: number;
-    readonly offsetY?: number;
-    readonly row?: PiTuiSizeValue;
-    readonly col?: PiTuiSizeValue;
-    readonly margin?: PiTuiOverlayMargin | number;
-    readonly visible?: (columns: number, rows: number) => boolean;
-    readonly nonCapturing?: boolean;
-    /** A1-owned input scheduling declaration; omitted extension overlays fail closed. */
-    readonly inputCoordination?: Exclude<PiTuiInputSurfaceKind, "editor">;
-}
-export interface PiTuiOverlayUnfocusOptions {
-    readonly target: PiTuiComponentPort | null;
-}
-export interface PiTuiOverlayHandle {
-    hide(): void;
-    setHidden(hidden: boolean): void;
-    isHidden(): boolean;
-    focus(): void;
-    unfocus(options?: PiTuiOverlayUnfocusOptions): void;
-    isFocused(): boolean;
-    /** The most recently rendered terminal-relative rectangle of a visible overlay. */
-    getBounds(): {
-        readonly row: number;
-        readonly col: number;
-        readonly width: number;
-        readonly height: number;
-    } | undefined;
-}
-export interface PiTuiInputListenerResult {
-    readonly consume?: boolean;
-    readonly data?: string;
-}
-export type PiTuiInputListener = (data: string) => PiTuiInputListenerResult | undefined;
-/** Runs at the terminal bridge before Pi TUI receives physical input. */
-export type PiTuiPreInputListener = PiTuiInputListener;
-export interface PiTuiLayoutEntry {
-    readonly node: PiTuiLayoutNode;
-    readonly basis?: number | "auto";
-    readonly grow?: number;
-    readonly shrink?: number;
-    readonly minSize?: number;
-    readonly maxSize?: number;
-    readonly visible?: (viewport: PiTuiViewport) => boolean;
-}
-export type PiTuiLayoutNode = {
-    readonly type: "component";
-    readonly component: PiTuiComponentPort;
-} | {
-    readonly type: "stack";
-    readonly direction: "vertical" | "horizontal";
-    readonly children: readonly PiTuiLayoutEntry[];
-    readonly gap?: number;
-    readonly align?: "stretch" | "start" | "center" | "end";
-} | {
-    readonly type: "scroll";
-    readonly id: string;
-    readonly child: PiTuiLayoutNode;
-    readonly follow?: "none" | "end";
-    readonly primary?: boolean;
-    readonly overscroll?: "chain" | "contain";
-    readonly scrollbar?: "hidden" | "auto" | "always";
-    /** Styles the scrollbar track; the pinned runtime draws it as foreground text. */
-    readonly scrollbarTrackStyle?: (text: string) => string;
-    /** Styles the scrollbar thumb; the pinned runtime draws it as foreground text. */
-    readonly scrollbarThumbStyle?: (text: string) => string;
-    readonly scrollbarHideDelayMs?: number;
-};
-export type PiTuiInputDiagnosticsPhase = "receipt" | "semantic-start" | "semantic-end" | "composition-start" | "composition-end" | "write-start" | "write-end";
-export interface PiTuiInputDiagnosticsEvent {
-    readonly phase: PiTuiInputDiagnosticsPhase;
-    readonly revision: number;
-    readonly atMs: number;
-    readonly pendingDepth: number;
-    readonly pendingPresentationDepth: 0 | 1;
-    readonly appliedRevision: number;
-}
-export interface PiTuiRuntimeAdapterOptions {
-    readonly root: PiTuiComponentPort;
-    /** Bare viewport only: painted overlays in back-to-front order; null while geometry is stale. */
-    readonly onOverlayGeometry?: (surfaces: readonly PiTuiPointerSurface[] | null) => void;
-    readonly mode?: "regular" | "fullscreen";
-    readonly layoutRoot?: PiTuiLayoutNode;
-    readonly terminal?: PiTuiTerminalPort;
-    /** A1-owned public-boundary decorator; comparison paths omit it. */
-    readonly decorateTerminal?: (terminal: PiTuiTerminalPort) => PiTuiTerminalPort;
-    /** Bare-custom-viewport scheduling policy; comparison paths omit it. */
-    readonly inputCoordination?: {
-        readonly classify: (data: string, focusedOverlay?: Exclude<PiTuiInputSurfaceKind, "editor">) => PiTuiInputCoordinationDecision;
-        readonly onReceipt?: () => void;
-        readonly scheduler?: PiTuiInputCoordinationScheduler;
-    };
-    /** Optional bounded evidence hook. Production composition omits it. */
-    readonly inputDiagnostics?: {
-        readonly onEvent: (event: PiTuiInputDiagnosticsEvent) => void;
-        readonly now?: () => number;
-    };
-    readonly hardwareCursor?: boolean;
-    readonly mouse?: boolean;
-    /** Consume residual SGR mouse reports after every pre-input listener has run. */
-    readonly consumeUnhandledMouse?: boolean;
-    readonly wheelScrollLines?: WheelScrollLines;
-    readonly openUrl?: (url: string) => void;
-    readonly onRightClickPaste?: () => void;
-    readonly logDirectory?: string;
-}
-export interface PiTuiStopOptions {
-    readonly preserveScreen?: boolean;
-    readonly drainInput?: boolean;
-    readonly drainMaxMs?: number;
-    readonly drainIdleMs?: number;
-}
+import type { TerminalRuntimeState, TerminalViewport, TerminalScrollState, TerminalPointerSurface, TerminalComponentPort, TerminalPort, TerminalSizeValue, TerminalOverlayAnchor, TerminalOverlayMargin, TerminalOverlayOptions, TerminalOverlayUnfocusOptions, TerminalOverlayHandle, TerminalInputListenerResult, TerminalInputListener, TerminalPreInputListener, TerminalLayoutEntry, TerminalLayoutNode, TerminalInputDiagnosticsPhase, TerminalInputDiagnosticsEvent, TerminalRuntimeOptions, TerminalStopOptions } from "../../../contracts/presentation/index.js";
+export type PiTuiRuntimeState = TerminalRuntimeState;
+export type PiTuiViewport = TerminalViewport;
+export type PiTuiScrollState = TerminalScrollState;
+export type PiTuiPointerSurface = TerminalPointerSurface;
+export type PiTuiComponentPort = TerminalComponentPort;
+export type PiTuiTerminalPort = TerminalPort;
+export type PiTuiSizeValue = TerminalSizeValue;
+export type PiTuiOverlayAnchor = TerminalOverlayAnchor;
+export type PiTuiOverlayMargin = TerminalOverlayMargin;
+export type PiTuiOverlayOptions = TerminalOverlayOptions;
+export type PiTuiOverlayUnfocusOptions = TerminalOverlayUnfocusOptions;
+export type PiTuiOverlayHandle = TerminalOverlayHandle;
+export type PiTuiInputListenerResult = TerminalInputListenerResult;
+export type PiTuiInputListener = TerminalInputListener;
+export type PiTuiPreInputListener = TerminalPreInputListener;
+export type PiTuiLayoutEntry = TerminalLayoutEntry;
+export type PiTuiLayoutNode = TerminalLayoutNode;
+export type PiTuiInputDiagnosticsPhase = TerminalInputDiagnosticsPhase;
+export type PiTuiInputDiagnosticsEvent = TerminalInputDiagnosticsEvent;
+export type PiTuiRuntimeAdapterOptions = TerminalRuntimeOptions;
+export type PiTuiStopOptions = TerminalStopOptions;

package/dist/integrations/pi/tui-runtime/damage-aware-terminal.d.ts

@@ -1,45 +1,10 @@
 import type { PiTuiTerminalPort } from "./contracts.js";
 export declare const PINNED_PI_TUI_DAMAGE_GRAMMAR = "@earendil-works/pi-tui@1.5.0:tui-alt-screen-one-write-v1";
-export interface PiTuiDamageFrameDescriptor {
-    /**
-     * Frame ids are compared only within one presentation epoch; absent means the current epoch. A
-     * presenter switch starts a new epoch, because each presenter numbers its own frames.
-     */
-    readonly epoch?: number;
-    readonly frameId: number;
-    readonly width: number;
-    readonly height: number;
-    readonly transcript: {
-        readonly rowStart: number;
-        readonly rowEnd: number;
-    } | null;
-    readonly dock: {
-        readonly rowStart: number;
-        readonly rowEnd: number;
-    } | null;
-    /**
-     * Visible rows owned by the block that is currently streaming. A live block repaints
-     * every row it owns when it reflows, so the allowed damage follows the declared tail
-     * instead of assuming a one-row tail.
-     */
-    readonly liveTailRows?: number;
-    readonly verticalShiftRows: number;
-    readonly safeVerticalShift: boolean;
-    readonly cause: string;
-}
-export interface PiTuiDamageFrameSafety {
-    readonly overlayActive: boolean;
-    readonly selectionActive: boolean;
-    readonly replacementSurfaceActive: boolean;
-}
-export type PiTuiDamageDecisionReason = "transformed" | "suppressed-redundant-clear" | "hyperlink-cleanup" | "pending-hyperlink-cleanup" | "not-armed" | "unsafe-frame" | "stale-frame" | "unsupported-region-scroll" | "geometry-mismatch" | "grammar-mismatch" | "unsafe-terminal-content" | "incomplete-prior-frame" | "excessive-real-damage";
-export interface PiTuiDamageDecision {
-    readonly frameId: number | null;
-    readonly transformed: boolean;
-    readonly reason: PiTuiDamageDecisionReason;
-    readonly shiftRows: number;
-    readonly paintedRows: readonly number[];
-}
+import type { TerminalDamageDecision, TerminalDamageDecisionReason, TerminalDamageFrameDescriptor, TerminalDamageFrameSafety } from "../../../contracts/presentation/index.js";
+export type PiTuiDamageFrameDescriptor = TerminalDamageFrameDescriptor;
+export type PiTuiDamageFrameSafety = TerminalDamageFrameSafety;
+export type PiTuiDamageDecisionReason = TerminalDamageDecisionReason;
+export type PiTuiDamageDecision = TerminalDamageDecision;
 export interface DamageAwareTerminalOptions {
     readonly regionalScroll: boolean;
     /** The shell supplies visible-row analysis; the terminal layer owns no UI parser. */

package/dist/integrations/pi/tui-runtime/index.d.ts

@@ -1,5 +1,6 @@
 export type { PiTuiComponentPort, PiTuiInputDiagnosticsEvent, PiTuiInputDiagnosticsPhase, PiTuiInputListener, PiTuiInputListenerResult, PiTuiLayoutEntry, PiTuiLayoutNode, PiTuiOverlayAnchor, PiTuiOverlayHandle, PiTuiOverlayMargin, PiTuiOverlayOptions, PiTuiOverlayUnfocusOptions, PiTuiPointerSurface, PiTuiPreInputListener, PiTuiRuntimeAdapterOptions, PiTuiRuntimeState, PiTuiScrollState, PiTuiSizeValue, PiTuiStopOptions, PiTuiTerminalPort, PiTuiViewport, } from "./contracts.js";
 export { samePointerSurfaces } from "./overlay-geometry.js";
+export { PI_TERMINAL_RUNTIME } from "./runtime-factory.js";
 export { DamageAwareTerminalAdapter, PINNED_PI_TUI_DAMAGE_GRAMMAR, paintTerminalCanvasFrame, rebaseTerminalDefaultBackground, } from "./damage-aware-terminal.js";
 export type { DamageAwareTerminalOptions, PiTuiDamageDecision, PiTuiDamageDecisionReason, PiTuiDamageFrameDescriptor, PiTuiDamageFrameSafety, } from "./damage-aware-terminal.js";
 export { InputPresentationCoordinator, classifyPiTuiInput } from "./input-presentation-coordinator.js";

package/dist/integrations/pi/tui-runtime/index.js

@@ -1,4 +1,5 @@
 export { samePointerSurfaces } from "./overlay-geometry.js";
+export { PI_TERMINAL_RUNTIME } from "./runtime-factory.js";
 export { DamageAwareTerminalAdapter, PINNED_PI_TUI_DAMAGE_GRAMMAR, paintTerminalCanvasFrame, rebaseTerminalDefaultBackground, } from "./damage-aware-terminal.js";
 export { InputPresentationCoordinator, classifyPiTuiInput } from "./input-presentation-coordinator.js";
 export { PiTuiRuntimeAdapter, PiTuiRuntimeError } from "./adapter.js";

package/dist/integrations/pi/tui-runtime/input-presentation-coordinator.d.ts

@@ -1,9 +1,7 @@
-export type PiTuiInputCoordinationDecision = "safe" | "barrier";
-export type PiTuiInputSurfaceKind = "editor" | "owned" | "opaque";
-export interface PiTuiInputCoordinationScheduler {
-    scheduleImmediate(callback: () => void): ReturnType<typeof setImmediate>;
-    cancelImmediate(handle: ReturnType<typeof setImmediate>): void;
-}
+import type { TerminalInputCoordinationDecision, TerminalInputCoordinationScheduler, TerminalInputSurfaceKind } from "../../../contracts/presentation/index.js";
+export type PiTuiInputCoordinationDecision = TerminalInputCoordinationDecision;
+export type PiTuiInputSurfaceKind = TerminalInputSurfaceKind;
+export type PiTuiInputCoordinationScheduler = TerminalInputCoordinationScheduler;
 export interface PiTuiInputCoordinationTrace {
     readonly phase: "receipt" | "semantic-start" | "semantic-end";
     readonly revision: number;

package/dist/integrations/pi/tui-runtime/overlay-geometry.d.ts

@@ -1,5 +1,6 @@
 import { TuiAltScreen, type Component, type OverlayHandle, type OverlayOptions } from "@earendil-works/pi-tui";
 import type { PresentationComponentPort, PresentationPointerSurface } from "../../../contracts/presentation/index.js";
+import { samePointerSurfaces } from "../../../contracts/presentation/index.js";
 import type { PiTuiOverlayOptions } from "./contracts.js";
 /** Observes public component renders in compositor order, without accessing renderer state. */
 export declare class OverlayGeometryTracker {
@@ -22,11 +23,4 @@ export declare class GeometryObservedAltScreen extends TuiAltScreen {
     hideOverlay(): void;
     protected compositeOverlays(lines: string[], width: number, height: number): string[];
 }
-/** Compare only geometry and ownership, never animation content or transcript position. */
-export declare function samePointerSurfaces(a: readonly PresentationPointerSurface[], b: readonly PresentationPointerSurface[]): boolean;
-/**
- * Resolve the pinned public overlay options against the actual render width/height.
- * The runtime still owns layout and painting. Independent terminal-cell tests certify
- * this option-to-hit-region projection against its compositor, including clipping.
- */
-export declare function overlayPointerSurface(component: PresentationComponentPort, options: PiTuiOverlayOptions | undefined, width: number, renderedHeight: number, columns: number, rows: number): PresentationPointerSurface | undefined;
+export { samePointerSurfaces };

package/dist/integrations/pi/tui-runtime/overlay-geometry.js

@@ -1,4 +1,5 @@
 import { TuiAltScreen, isFocusable } from "@earendil-works/pi-tui";
+import { samePointerSurfaces } from "../../../contracts/presentation/index.js";
 /** Observes public component renders in compositor order, without accessing renderer state. */
 export class OverlayGeometryTracker {
     #frame = [];
@@ -97,20 +98,13 @@ export class GeometryObservedAltScreen extends TuiAltScreen {
         return result;
     }
 }
-/** Compare only geometry and ownership, never animation content or transcript position. */
-export function samePointerSurfaces(a, b) {
-    return a.length === b.length && a.every((surface, index) => {
-        const other = b[index];
-        return surface.component === other.component && surface.columnStart === other.columnStart
-            && surface.columnEnd === other.columnEnd && surface.rowStart === other.rowStart && surface.rowEnd === other.rowEnd;
-    });
-}
+export { samePointerSurfaces };
 /**
  * Resolve the pinned public overlay options against the actual render width/height.
  * The runtime still owns layout and painting. Independent terminal-cell tests certify
  * this option-to-hit-region projection against its compositor, including clipping.
  */
-export function overlayPointerSurface(component, options, width, renderedHeight, columns, rows) {
+function overlayPointerSurface(component, options, width, renderedHeight, columns, rows) {
     const opt = options ?? {};
     const margin = typeof opt.margin === "number"
         ? { top: opt.margin, right: opt.margin, bottom: opt.margin, left: opt.margin }

package/dist/integrations/pi/tui-runtime/runtime-factory.d.ts

@@ -0,0 +1,3 @@
+import type { TerminalRuntimeFactory } from "../../../contracts/presentation/index.js";
+/** The Pi TUI runtime behind the neutral terminal runtime factory the shell uses. */
+export declare const PI_TERMINAL_RUNTIME: TerminalRuntimeFactory;

package/dist/integrations/pi/tui-runtime/runtime-factory.js

@@ -0,0 +1,11 @@
+import { legacyKeyInput, PiTuiRuntimeAdapter } from "./adapter.js";
+import { DamageAwareTerminalAdapter, rebaseTerminalDefaultBackground } from "./damage-aware-terminal.js";
+import { classifyPiTuiInput } from "./input-presentation-coordinator.js";
+/** The Pi TUI runtime behind the neutral terminal runtime factory the shell uses. */
+export const PI_TERMINAL_RUNTIME = Object.freeze({
+    createRuntime: options => new PiTuiRuntimeAdapter(options),
+    createDamageTerminal: (terminal, options) => new DamageAwareTerminalAdapter(terminal, options),
+    classifyInput: (data, surface) => classifyPiTuiInput(data, surface),
+    legacyKeyInput: data => legacyKeyInput(data),
+    rebaseDefaultBackground: (content, backgroundAnsi) => rebaseTerminalDefaultBackground(content, backgroundAnsi),
+});

package/dist/ui/components/index.d.ts

@@ -44,7 +44,7 @@ export { displayColumnSlice, displayWidth, displayWordColumnRange, faint, padToW
 export type { DisplayColumnRange, DisplayColumnSlice } from "./text.js";
 export { TEXT_SELECTION_MULTI_CLICK_MS, extendTextSelection, orderedTextSelection, paintTextSelection, plainTextBetweenColumns, pressTextSelection, releaseTextSelection, textSelectionLineExtendColumn, textSelectionPointAt, textSelectionText, usefulTextLineContent, } from "./text-selection.js";
 export type { OrderedTextSelection, TextSelection, TextSelectionClick, TextSelectionLineContent, TextSelectionPoint, TextSelectionPressInput, } from "./text-selection.js";
-export { PLAIN_THEME } from "./theme.js";
-export type { UiTheme, UiThemeToken } from "./theme.js";
+export { PLAIN_THEME, PLAIN_THEME_SOURCE } from "./theme.js";
+export type { ThemeSource, UiTheme, UiThemeBackground, UiThemeToken } from "./theme.js";
 export { menuRowAt, renderValueMenu, valueMenuFrame } from "./value-menu.js";
 export type { ValueMenuAnchor, ValueMenuFrame, ValueMenuLayout, ValueMenuState } from "./value-menu.js";

package/dist/ui/components/index.js

@@ -22,5 +22,5 @@ export { TranscriptViewport, assertTranscriptViewportFrameDescriptor } from "./t
 export { RAIL_COLUMNS, renderEmptyState, withScrollbarRail } from "./surface.js";
 export { displayColumnSlice, displayWidth, displayWordColumnRange, faint, padToWidth, stripAnsi, truncateToWidth } from "./text.js";
 export { TEXT_SELECTION_MULTI_CLICK_MS, extendTextSelection, orderedTextSelection, paintTextSelection, plainTextBetweenColumns, pressTextSelection, releaseTextSelection, textSelectionLineExtendColumn, textSelectionPointAt, textSelectionText, usefulTextLineContent, } from "./text-selection.js";
-export { PLAIN_THEME } from "./theme.js";
+export { PLAIN_THEME, PLAIN_THEME_SOURCE } from "./theme.js";
 export { menuRowAt, renderValueMenu, valueMenuFrame } from "./value-menu.js";

package/dist/ui/components/selection-copy.d.ts

@@ -19,6 +19,5 @@ export interface SelectionCopySnapshot {
     readonly rejected?: "size";
 }
 export declare function selectionCopyLineContent(text: string, prompt: SelectionCopyPrompt): TextSelectionLineContent;
-export declare function literalSelectionCopySnapshot(text: string, revision?: number): SelectionCopySnapshot | null;
 /** Extracts one snapshot row with the existing grapheme/newline policy; run expensive rows off-thread. */
 export declare function selectionCopyRowText(snapshot: Pick<SelectionCopySnapshot, "selection" | "literal">, row: SelectionCopyRow, index: number): string;

package/dist/ui/components/selection-copy.js

@@ -22,18 +22,6 @@ export function selectionCopyLineContent(text, prompt) {
         return { from, to: from + 1 };
     return usefulTextLineContent(plain, from);
 }
-export function literalSelectionCopySnapshot(text, revision = 0) {
-    if (text.trim().length === 0)
-        return null;
-    const selection = {
-        start: { line: 0, column: 0 },
-        end: { line: 0, column: Number.MAX_SAFE_INTEGER },
-    };
-    if (text.length > MAX_COPY_SOURCE_UNITS) {
-        return { literal: true, selection, revision, rows: [], sourceUnits: 0, rejected: "size" };
-    }
-    return { literal: true, selection, revision, rows: [{ text }], sourceUnits: text.length };
-}
 /** Extracts one snapshot row with the existing grapheme/newline policy; run expensive rows off-thread. */
 export function selectionCopyRowText(snapshot, row, index) {
     if (snapshot.literal)