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

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

@@ -12,8 +12,8 @@ const LEGACY_KEY_BYTES = {
     space: " ", "ctrl+c": "\u0003", "ctrl+z": "\u001a",
 };
 /**
- * Re-encodes one key report decoded by pi-tui in the legacy form, so a kitty-keyboard child
- * (resident tabs) and a legacy terminal produce the same owned-screen action. Releases decode
+ * Re-encodes one key report decoded by pi-tui in the legacy form, so a kitty-keyboard terminal
+ * and a legacy terminal produce the same owned-screen action. Releases decode
  * to nothing; mouse reports, paste, and unknown sequences pass through unchanged.
  */
 export function legacyKeyInput(data) {
@@ -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/product-identity.d.ts

@@ -1,11 +1,10 @@
-declare const ENVIRONMENT_KEYS: readonly ["clipboardDiagnostics", "configDir", "dataDir", "databasePath", "developmentHistoryDataDir", "developmentInstanceId", "developmentRoot", "endpoint", "exitNoticePath", "paneId", "probeTrace", "processGuardianPath", "prFooterPreview", "profileHome", "residentFixtureControlDir", "residentProgressObservationDir", "residentProgressRunId", "residentProgressTabId", "residentProgressTabIncarnation", "runtimeDir", "sessionRuntimeId", "skipVersionCheck", "startupTrace", "suggestionDiagnostics", "tabEndpoint", "tabId", "tabReleaseId", "tabToken", "tabsEndpoint", "terminalHostPath", "terminalSessionId"];
+declare const ENVIRONMENT_KEYS: readonly ["clipboardDiagnostics", "configDir", "dataDir", "developmentHistoryDataDir", "developmentInstanceId", "developmentRoot", "exitNoticePath", "prFooterPreview", "profileHome", "runtimeDir", "sessionRuntimeId", "skipVersionCheck", "startupTrace", "suggestionDiagnostics"];
 declare const FILESYSTEM_KEYS: readonly ["slug", "windowsDirectory", "unixDirectory", "temporaryPrefix"];
 declare const STATE_KEYS: readonly ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile", "sessionRepositoryDirectory", "sessionWorktreeClaimDirectory"];
-declare const ENDPOINT_KEYS: readonly ["windowsPipeStem", "unixSocketFilename", "metadataFilename", "supervisorLogFilename", "databaseFilename"];
 declare const MANIFEST_KEYS: readonly ["releaseFilename", "packageFilename"];
-declare const PROTOCOL_KEYS: readonly ["namespace", "controlEnvelope", "supervisorSchema", "nativeHostSchema", "structuredAgentSchema", "controlStoreSchema", "promptHistorySchema", "releaseCohortSchema", "updateJournalSchema"];
-declare const EVIDENCE_KEYS: readonly ["nativeSpikeSchema", "terminalProvenanceSchema", "terminalProofSchema", "terminalTemporalSnapshotSchema", "stableReleaseSchema", "previewReleaseSchema", "releaseCertificationSchema", "previewPlatformVerdictSchema", "piSourceLedgerSchema", "piComponentParitySchema", "piEventFrameParitySchema", "startupTraceSchema", "dependencyLayerSchema", "dependencyLayerCertificationSchema", "runtimePayloadSchema"];
-declare const ARTIFACT_KEYS: readonly ["cliEntry", "supervisorEntry", "guardianEntry", "uiEntry", "terminalHostAddon", "terminalHostEntry", "nativeCrate", "processGuardianAddon", "releaseTarballStem", "diagnosticStem"];
+declare const PROTOCOL_KEYS: readonly ["namespace", "promptHistorySchema", "releaseCohortSchema", "updateJournalSchema"];
+declare const EVIDENCE_KEYS: readonly ["stableReleaseSchema", "previewReleaseSchema", "releaseCertificationSchema", "previewPlatformVerdictSchema", "piSourceLedgerSchema", "piComponentParitySchema", "piEventFrameParitySchema", "startupTraceSchema", "dependencyLayerSchema", "dependencyLayerCertificationSchema", "runtimePayloadSchema"];
+declare const ARTIFACT_KEYS: readonly ["cliEntry", "uiEntry", "releaseTarballStem", "diagnosticStem"];
 type StringRecord<Keys extends readonly string[]> = {
     readonly [Key in Keys[number]]: string;
 };
@@ -17,7 +16,6 @@ export interface ProductIdentity {
     readonly filesystem: StringRecord<typeof FILESYSTEM_KEYS>;
     readonly environment: StringRecord<typeof ENVIRONMENT_KEYS>;
     readonly state: StringRecord<typeof STATE_KEYS>;
-    readonly endpoint: StringRecord<typeof ENDPOINT_KEYS>;
     readonly manifest: StringRecord<typeof MANIFEST_KEYS>;
     readonly protocol: StringRecord<typeof PROTOCOL_KEYS>;
     readonly evidence: StringRecord<typeof EVIDENCE_KEYS>;

package/dist/product-identity.js

@@ -1,16 +1,15 @@
 import rawIdentity from "./product-identity.json" with { type: "json" };
 const ENVIRONMENT_KEYS = [
-    "clipboardDiagnostics", "configDir", "dataDir", "databasePath", "developmentHistoryDataDir", "developmentInstanceId", "developmentRoot", "endpoint", "exitNoticePath",
-    "paneId", "probeTrace", "processGuardianPath", "prFooterPreview", "profileHome", "residentFixtureControlDir", "residentProgressObservationDir", "residentProgressRunId", "residentProgressTabId", "residentProgressTabIncarnation", "runtimeDir", "sessionRuntimeId", "skipVersionCheck", "startupTrace", "suggestionDiagnostics", "tabEndpoint", "tabId", "tabReleaseId", "tabToken", "tabsEndpoint", "terminalHostPath", "terminalSessionId",
+    "clipboardDiagnostics", "configDir", "dataDir", "developmentHistoryDataDir", "developmentInstanceId", "developmentRoot", "exitNoticePath",
+    "prFooterPreview", "profileHome", "runtimeDir", "sessionRuntimeId", "skipVersionCheck", "startupTrace", "suggestionDiagnostics",
 ];
 const FILESYSTEM_KEYS = ["slug", "windowsDirectory", "unixDirectory", "temporaryPrefix"];
 const STATE_KEYS = ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile", "sessionRepositoryDirectory", "sessionWorktreeClaimDirectory"];
-const ENDPOINT_KEYS = ["windowsPipeStem", "unixSocketFilename", "metadataFilename", "supervisorLogFilename", "databaseFilename"];
 const MANIFEST_KEYS = ["releaseFilename", "packageFilename"];
-const PROTOCOL_KEYS = ["namespace", "controlEnvelope", "supervisorSchema", "nativeHostSchema", "structuredAgentSchema", "controlStoreSchema", "promptHistorySchema", "releaseCohortSchema", "updateJournalSchema"];
-const EVIDENCE_KEYS = ["nativeSpikeSchema", "terminalProvenanceSchema", "terminalProofSchema", "terminalTemporalSnapshotSchema", "stableReleaseSchema", "previewReleaseSchema", "releaseCertificationSchema", "previewPlatformVerdictSchema", "piSourceLedgerSchema", "piComponentParitySchema", "piEventFrameParitySchema", "startupTraceSchema", "dependencyLayerSchema", "dependencyLayerCertificationSchema", "runtimePayloadSchema"];
-const ARTIFACT_KEYS = ["cliEntry", "supervisorEntry", "guardianEntry", "uiEntry", "terminalHostAddon", "terminalHostEntry", "nativeCrate", "processGuardianAddon", "releaseTarballStem", "diagnosticStem"];
-const ROOT_KEYS = ["schema", "displayName", "commandName", "packageName", "filesystem", "environment", "state", "endpoint", "manifest", "protocol", "evidence", "artifacts"];
+const PROTOCOL_KEYS = ["namespace", "promptHistorySchema", "releaseCohortSchema", "updateJournalSchema"];
+const EVIDENCE_KEYS = ["stableReleaseSchema", "previewReleaseSchema", "releaseCertificationSchema", "previewPlatformVerdictSchema", "piSourceLedgerSchema", "piComponentParitySchema", "piEventFrameParitySchema", "startupTraceSchema", "dependencyLayerSchema", "dependencyLayerCertificationSchema", "runtimePayloadSchema"];
+const ARTIFACT_KEYS = ["cliEntry", "uiEntry", "releaseTarballStem", "diagnosticStem"];
+const ROOT_KEYS = ["schema", "displayName", "commandName", "packageName", "filesystem", "environment", "state", "manifest", "protocol", "evidence", "artifacts"];
 export function validateProductIdentity(value) {
     const root = exactObject(value, ROOT_KEYS, "product identity");
     const schema = stringValue(root.schema, "product identity schema");
@@ -20,7 +19,6 @@ export function validateProductIdentity(value) {
     const filesystem = stringObject(root.filesystem, FILESYSTEM_KEYS, "filesystem identity");
     const environment = stringObject(root.environment, ENVIRONMENT_KEYS, "environment identity");
     const state = stringObject(root.state, STATE_KEYS, "state identity");
-    const endpoint = stringObject(root.endpoint, ENDPOINT_KEYS, "endpoint identity");
     const manifest = stringObject(root.manifest, MANIFEST_KEYS, "manifest identity");
     const protocol = stringObject(root.protocol, PROTOCOL_KEYS, "protocol identity");
     const evidence = stringObject(root.evidence, EVIDENCE_KEYS, "evidence identity");
@@ -41,8 +39,6 @@ export function validateProductIdentity(value) {
     if (state.windowsControlDirectory !== filesystem.windowsDirectory || state.unixControlDirectory !== filesystem.unixDirectory) {
         throw new TypeError("product state directories must match the filesystem identity");
     }
-    if (endpoint.windowsPipeStem !== filesystem.slug)
-        throw new TypeError("product endpoint stem must match the filesystem slug");
     if (protocol.namespace !== commandName)
         throw new TypeError("product protocol namespace must match the command name");
     if (artifacts.diagnosticStem !== filesystem.slug)
@@ -73,7 +69,6 @@ export function validateProductIdentity(value) {
         filesystem,
         environment,
         state,
-        endpoint,
         manifest,
         protocol,
         evidence,

package/dist/product-identity.json

@@ -13,34 +13,17 @@
         "clipboardDiagnostics": "A1_CLIPBOARD_DIAGNOSTICS",
         "configDir": "A1_CONFIG_DIR",
         "dataDir": "A1_DATA_DIR",
-        "databasePath": "A1_DATABASE_PATH",
         "developmentHistoryDataDir": "A1_DEV_HISTORY_DATA_DIR",
         "developmentInstanceId": "A1_DEV_INSTANCE_ID",
         "developmentRoot": "A1_DEV_ROOT",
-        "endpoint": "A1_ENDPOINT",
         "exitNoticePath": "A1_EXIT_NOTICE_PATH",
-        "paneId": "A1_PANE_ID",
-        "probeTrace": "A1_PROBE_TRACE",
-        "processGuardianPath": "A1_PROCESS_GUARDIAN_PATH",
         "prFooterPreview": "A1_PR_FOOTER_PREVIEW",
         "profileHome": "A1_PROFILE_HOME",
-        "residentFixtureControlDir": "A1_RESIDENT_FIXTURE_CONTROL_DIR",
-        "residentProgressObservationDir": "A1_RESIDENT_PROGRESS_OBSERVATION_DIR",
-        "residentProgressRunId": "A1_RESIDENT_PROGRESS_RUN_ID",
-        "residentProgressTabId": "A1_RESIDENT_PROGRESS_TAB_ID",
-        "residentProgressTabIncarnation": "A1_RESIDENT_PROGRESS_TAB_INCARNATION",
         "runtimeDir": "A1_RUNTIME_DIR",
         "sessionRuntimeId": "A1_SESSION_RUNTIME_ID",
         "skipVersionCheck": "A1_SKIP_VERSION_CHECK",
         "startupTrace": "A1_STARTUP_TRACE",
-        "suggestionDiagnostics": "A1_SUGGESTION_DIAGNOSTICS",
-        "tabEndpoint": "A1_TAB_ENDPOINT",
-        "tabId": "A1_TAB_ID",
-        "tabReleaseId": "A1_TAB_RELEASE_ID",
-        "tabToken": "A1_TAB_TOKEN",
-        "tabsEndpoint": "A1_TABS_ENDPOINT",
-        "terminalHostPath": "A1_TERMINAL_HOST_PATH",
-        "terminalSessionId": "A1_TERMINAL_SESSION_ID"
+        "suggestionDiagnostics": "A1_SUGGESTION_DIAGNOSTICS"
     },
     "state": {
         "windowsControlDirectory": "a1",
@@ -51,33 +34,17 @@
         "sessionRepositoryDirectory": "session-repositories",
         "sessionWorktreeClaimDirectory": "session-worktree-claims"
     },
-    "endpoint": {
-        "windowsPipeStem": "a1",
-        "unixSocketFilename": "supervisor.sock",
-        "metadataFilename": "supervisor.json",
-        "supervisorLogFilename": "supervisor.log",
-        "databaseFilename": "control.sqlite3"
-    },
     "manifest": {
         "releaseFilename": ".a1-release.json",
         "packageFilename": "package.json"
     },
     "protocol": {
         "namespace": "a1",
-        "controlEnvelope": "a1-control-envelope",
-        "supervisorSchema": "a1-supervisor-v1",
-        "nativeHostSchema": "a1-native-host-v1",
-        "structuredAgentSchema": "a1-structured-agent-v1",
-        "controlStoreSchema": "a1-control-store-v1",
         "promptHistorySchema": "a1-prompt-history-v1",
         "releaseCohortSchema": "a1-release-cohort-v1",
         "updateJournalSchema": "a1-update-journal-v1"
     },
     "evidence": {
-        "nativeSpikeSchema": "a1-native-host-spike-evidence-v1",
-        "terminalProvenanceSchema": "a1-terminal-host-provenance-v1",
-        "terminalProofSchema": "a1-terminal-host-proof-v1",
-        "terminalTemporalSnapshotSchema": "a1-terminal-temporal-snapshot-v1",
         "stableReleaseSchema": "a1-stable-release-v1",
         "previewReleaseSchema": "a1-preview-release-v1",
         "releaseCertificationSchema": "a1-release-certification-v1",
@@ -92,13 +59,7 @@
     },
     "artifacts": {
         "cliEntry": "bin/cli.js",
-        "supervisorEntry": "bin/supervisor.js",
-        "guardianEntry": "bin/guardian.js",
         "uiEntry": "bin/ui.js",
-        "terminalHostAddon": "terminal-host",
-        "terminalHostEntry": "host-entry",
-        "nativeCrate": "terminal-host",
-        "processGuardianAddon": "process-guardian",
         "releaseTarballStem": "timurproko-a1",
         "diagnosticStem": "a1"
     }

package/dist/runtime-payload-inventory.json

@@ -3,12 +3,9 @@
   "entryPoints": [
     "bin/activate.js",
     "bin/cli.js",
-    "bin/guardian.js",
-    "bin/supervisor.js",
     "bin/ui.js",
     "bin/update-recovery.js",
     "bin/warmup.js",
-    "dist/foundation/launch-guardian/exit-watcher.js",
     "dist/foundation/startup/startup-descriptor.js",
     "dist/integrations/pi/startup-public.js"
   ],