@timurproko/a1 0.1.0

package/dist/src/foundation/pi-tui-runtime-adapter/conformance.js

@@ -0,0 +1,132 @@
+import { PI_TUI_PACKAGE_VERSION } from "./contracts.js";
+import { PiTuiRuntimeAdapter, PiTuiRuntimeError } from "./adapter.js";
+export async function runPiTuiRuntimeConformance() {
+    const terminal = new ConformanceTerminal();
+    const root = new ConformanceComponent(["stable row", "before"]);
+    const overlay = new ConformanceComponent(["overlay"]);
+    const runtime = new PiTuiRuntimeAdapter({ root, terminal, mouse: false });
+    try {
+        runtime.start();
+        runtime.renderNow(true);
+        root.lines = ["stable row", "after"];
+        const writesBeforeDifferential = terminal.writes.length;
+        runtime.renderNow();
+        const differentialFrame = terminal.writes.slice(writesBeforeDifferential).join("");
+        terminal.input("root-input");
+        runtime.renderNow();
+        const overlayHandle = runtime.showOverlay(overlay, { width: 12, anchor: "center" });
+        runtime.renderNow();
+        terminal.input("overlay-input");
+        runtime.renderNow();
+        const overlayRouted = overlay.inputs.includes("overlay-input") && !root.inputs.includes("overlay-input");
+        overlayHandle.hide();
+        const redrawsBeforeResize = runtime.fullRedraws;
+        terminal.resize(60, 10);
+        runtime.renderNow();
+        const resizeRedraw = runtime.fullRedraws > redrawsBeforeResize && runtime.viewport().columns === 60;
+        await runtime.stop({ drainMaxMs: 1, drainIdleMs: 1 });
+        const emitted = terminal.writes.join("");
+        return {
+            packageName: "@earendil-works/pi-tui",
+            packageVersion: PI_TUI_PACKAGE_VERSION,
+            mode: runtime.mode,
+            lifecycleRestored: terminal.startCount === 1
+                && terminal.stopCount === 1
+                && terminal.drainCount === 1
+                && !emitted.includes("\x1b[?1049h")
+                && !emitted.includes("\x1b[?1049l")
+                && root.disposed,
+            inputRouted: root.inputs.includes("root-input"),
+            overlayRouted,
+            differentialRendering: differentialFrame.includes("after") && !differentialFrame.includes("stable row"),
+            resizeRedraw,
+            terminalNativeSelection: !emitted.includes("\x1b[?1000h") && !emitted.includes("\x1b[?1006h"),
+        };
+    }
+    catch (error) {
+        if (runtime.active)
+            await runtime.stop({ drainInput: false }).catch(() => { });
+        if (error instanceof PiTuiRuntimeError)
+            throw error;
+        throw new PiTuiRuntimeError("construction", error);
+    }
+}
+class ConformanceComponent {
+    lines;
+    inputs = [];
+    disposed = false;
+    constructor(lines) {
+        this.lines = lines;
+    }
+    render() {
+        return this.lines;
+    }
+    handleInput(data) {
+        this.inputs.push(data);
+    }
+    invalidate() { }
+    dispose() {
+        this.disposed = true;
+    }
+}
+class ConformanceTerminal {
+    columns = 40;
+    rows = 6;
+    kittyProtocolActive = false;
+    writes = [];
+    startCount = 0;
+    stopCount = 0;
+    drainCount = 0;
+    #onInput;
+    #onResize;
+    start(onInput, onResize) {
+        this.startCount += 1;
+        this.#onInput = onInput;
+        this.#onResize = onResize;
+    }
+    stop() {
+        this.stopCount += 1;
+        this.#onInput = undefined;
+        this.#onResize = undefined;
+    }
+    async drainInput() {
+        this.drainCount += 1;
+    }
+    write(data) {
+        this.writes.push(data);
+    }
+    input(data) {
+        this.#onInput?.(data);
+    }
+    resize(columns, rows) {
+        this.columns = columns;
+        this.rows = rows;
+        this.#onResize?.();
+    }
+    moveBy(lines) {
+        if (lines !== 0)
+            this.write(`move:${lines}`);
+    }
+    hideCursor() {
+        this.write("\x1b[?25l");
+    }
+    showCursor() {
+        this.write("\x1b[?25h");
+    }
+    clearLine() {
+        this.write("\x1b[K");
+    }
+    clearFromCursor() {
+        this.write("\x1b[J");
+    }
+    clearScreen() {
+        this.write("\x1b[2J\x1b[H");
+    }
+    setTitle(title) {
+        this.write(`title:${title}`);
+    }
+    setProgress(active) {
+        this.write(`progress:${active}`);
+    }
+}
+//# sourceMappingURL=conformance.js.map

package/dist/src/foundation/pi-tui-runtime-adapter/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../../../../src/foundation/pi-tui-runtime-adapter/conformance.ts"],"names":[],"mappings":"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"}

package/dist/src/foundation/pi-tui-runtime-adapter/contracts.d.ts

@@ -0,0 +1,122 @@
+export declare const PI_TUI_PACKAGE_VERSION: "0.84.2";
+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 interface PiTuiComponentPort {
+    render(width: number): readonly string[];
+    invalidate(): void;
+    handleInput?(data: string): void;
+    readonly wantsKeyRelease?: boolean;
+    setFocused?(focused: boolean): void;
+    dispose?(): void;
+}
+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;
+}
+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;
+}
+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;
+}
+export interface PiTuiInputListenerResult {
+    readonly consume?: boolean;
+    readonly data?: string;
+}
+export type PiTuiInputListener = (data: string) => PiTuiInputListenerResult | undefined;
+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";
+    readonly scrollbarStyle?: (text: string) => string;
+    readonly scrollbarHideDelayMs?: number;
+};
+export interface PiTuiRuntimeAdapterOptions {
+    readonly root: PiTuiComponentPort;
+    readonly mode?: "regular" | "fullscreen";
+    readonly layoutRoot?: PiTuiLayoutNode;
+    readonly terminal?: PiTuiTerminalPort;
+    readonly hardwareCursor?: boolean;
+    readonly mouse?: boolean;
+    readonly wheelScrollLines?: number;
+    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;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/src/foundation/pi-tui-runtime-adapter/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../../src/foundation/pi-tui-runtime-adapter/contracts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,EAAG,QAAiB,CAAC;AAExD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACzC,UAAU,IAAI,IAAI,CAAC;IACnB,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,UAAU,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACnE,IAAI,IAAI,IAAI,CAAC;IACb,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,IAAI,IAAI,CAAC;IACnB,UAAU,IAAI,IAAI,CAAC;IACnB,SAAS,IAAI,IAAI,CAAC;IAClB,eAAe,IAAI,IAAI,CAAC;IACxB,WAAW,IAAI,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC;AACnD,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,UAAU,GACV,WAAW,GACX,aAAa,GACb,cAAc,GACd,YAAY,GACZ,eAAe,GACf,aAAa,GACb,cAAc,CAAC;AAEnB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9D,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,IAAI,IAAI,CAAC;IACb,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,QAAQ,IAAI,OAAO,CAAC;IACpB,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACpD,SAAS,IAAI,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,wBAAwB,GAAG,SAAS,CAAC;AAExF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,OAAO,CAAC;CACzD;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAA;CAAE,GACtE;IACA,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,UAAU,GAAG,YAAY,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;CACzD,GACC;IACA,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClD,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACnD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC,CAAC;AAEJ,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/dist/src/foundation/pi-tui-runtime-adapter/contracts.js

@@ -0,0 +1,2 @@
+export const PI_TUI_PACKAGE_VERSION = "0.84.2";
+//# sourceMappingURL=contracts.js.map

package/dist/src/foundation/pi-tui-runtime-adapter/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../../src/foundation/pi-tui-runtime-adapter/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAiB,CAAC"}

package/dist/src/foundation/pi-tui-runtime-adapter/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./contracts.js";
+export * from "./adapter.js";
+export * from "./conformance.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/foundation/pi-tui-runtime-adapter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundation/pi-tui-runtime-adapter/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}

package/dist/src/foundation/pi-tui-runtime-adapter/index.js

@@ -0,0 +1,4 @@
+export * from "./contracts.js";
+export * from "./adapter.js";
+export * from "./conformance.js";
+//# sourceMappingURL=index.js.map

package/dist/src/foundation/pi-tui-runtime-adapter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/foundation/pi-tui-runtime-adapter/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}

package/dist/src/foundation/protocol/client.d.ts

@@ -0,0 +1,17 @@
+import { EventEmitter } from "node:events";
+import type { CommandResult, SupervisorCommand, SupervisorSnapshot } from "../lifecycle/index.js";
+interface ClientEvents {
+    snapshot: [SupervisorSnapshot];
+    disconnect: [];
+}
+export declare class SupervisorClient extends EventEmitter<ClientEvents> {
+    #private;
+    readonly clientId: `${string}-${string}-${string}-${string}-${string}`;
+    readonly releaseId?: string;
+    constructor(releaseId?: string);
+    connect(endpoint: string, timeoutMs?: number): Promise<SupervisorSnapshot>;
+    command(command: SupervisorCommand): Promise<CommandResult>;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/src/foundation/protocol/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/foundation/protocol/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGlG,UAAU,YAAY;IACpB,QAAQ,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAC/B,UAAU,EAAE,EAAE,CAAC;CAChB;AAED,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,YAAY,CAAC;;IAC9D,QAAQ,CAAC,QAAQ,sDAAgB;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,SAAS,CAAC,EAAE,MAAM;IAOxB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqF/E,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ3D,KAAK,IAAI,IAAI;CAId"}

package/dist/src/foundation/protocol/client.js

@@ -0,0 +1,127 @@
+import { EventEmitter } from "node:events";
+import { connect } from "node:net";
+import { randomUUID } from "node:crypto";
+import { CONTROL_ENVELOPE, CONTROL_ENVELOPE_REVISION, encodeFrame, LineFrameDecoder, localControlHello, negotiateControlFeatures } from "./messages.js";
+export class SupervisorClient extends EventEmitter {
+    clientId = randomUUID();
+    releaseId;
+    constructor(releaseId) {
+        super();
+        if (releaseId !== undefined)
+            this.releaseId = releaseId;
+    }
+    #socket = null;
+    #pending = new Map();
+    async connect(endpoint, timeoutMs = 5_000) {
+        if (this.#socket)
+            throw new Error("client is already connected");
+        const deadline = Date.now() + timeoutMs;
+        let lastError = null;
+        while (Date.now() < deadline) {
+            try {
+                return await this.#connectOnce(endpoint, Math.max(1, deadline - Date.now()));
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (!isTransientEndpointError(lastError))
+                    throw lastError;
+                await new Promise(resolve => setTimeout(resolve, Math.min(40, Math.max(1, deadline - Date.now()))));
+            }
+        }
+        throw new Error(`supervisor endpoint ${endpoint} remained unavailable for ${timeoutMs}ms`, { cause: lastError ?? undefined });
+    }
+    #connectOnce(endpoint, timeoutMs) {
+        const socket = connect(endpoint);
+        this.#socket = socket;
+        socket.setNoDelay(true);
+        const decoder = new LineFrameDecoder();
+        return new Promise((resolve, reject) => {
+            let welcomed = false;
+            const timeout = setTimeout(() => {
+                const error = transientError(`supervisor connection timed out after ${timeoutMs}ms`, "ETIMEDOUT");
+                fail(error);
+                socket.destroy();
+            }, timeoutMs);
+            const fail = (error) => {
+                clearTimeout(timeout);
+                if (!welcomed)
+                    reject(error);
+            };
+            socket.once("error", fail);
+            socket.on("close", () => {
+                if (this.#socket === socket)
+                    this.#socket = null;
+                if (!welcomed) {
+                    fail(transientError("supervisor disconnected before completing its handshake", "ECONNRESET"));
+                    return;
+                }
+                for (const pending of this.#pending.values())
+                    pending.reject(new Error("supervisor disconnected"));
+                this.#pending.clear();
+                this.emit("disconnect");
+            });
+            socket.on("data", chunk => {
+                try {
+                    for (const value of decoder.push(chunk)) {
+                        const message = value;
+                        if (message.type === "server-hello" && message.snapshot) {
+                            const hello = message;
+                            if (hello.envelope !== CONTROL_ENVELOPE || hello.envelopeRevision !== CONTROL_ENVELOPE_REVISION || !Array.isArray(hello.requiredFeatures) || !Array.isArray(hello.optionalFeatures) || typeof hello.contractDigest !== "string") {
+                                fail(new Error("supervisor returned an invalid control handshake"));
+                                socket.destroy();
+                                continue;
+                            }
+                            const negotiation = negotiateControlFeatures(localControlHello(this.releaseId), hello);
+                            if (!negotiation.ok) {
+                                fail(new Error(negotiation.diagnostic));
+                                socket.destroy();
+                                continue;
+                            }
+                            welcomed = true;
+                            clearTimeout(timeout);
+                            resolve(message.snapshot);
+                        }
+                        else if (message.type === "snapshot" && message.snapshot) {
+                            this.emit("snapshot", message.snapshot);
+                        }
+                        else if (message.type === "command-result" && message.result) {
+                            const pending = this.#pending.get(message.result.requestId);
+                            if (pending) {
+                                this.#pending.delete(message.result.requestId);
+                                pending.resolve(message.result);
+                            }
+                        }
+                        else if (message.type === "protocol-error") {
+                            fail(new Error(message.message ?? "protocol error"));
+                        }
+                    }
+                }
+                catch (error) {
+                    fail(error instanceof Error ? error : new Error(String(error)));
+                    socket.destroy();
+                }
+            });
+            socket.once("connect", () => socket.write(encodeFrame({ type: "client-hello", clientId: this.clientId, ...localControlHello(this.releaseId) })));
+        });
+    }
+    command(command) {
+        if (!this.#socket)
+            return Promise.reject(new Error("supervisor is not connected"));
+        return new Promise((resolve, reject) => {
+            this.#pending.set(command.requestId, { resolve, reject });
+            this.#socket?.write(encodeFrame({ type: "command", command }));
+        });
+    }
+    close() {
+        this.#socket?.end();
+        this.#socket = null;
+    }
+}
+function isTransientEndpointError(error) {
+    const code = "code" in error ? String(error.code) : "";
+    return ["ENOENT", "ECONNREFUSED", "ECONNRESET", "EPIPE", "ETIMEDOUT"].includes(code);
+}
+function transientError(message, code) {
+    return Object.assign(new Error(message), { code });
+}
+//# sourceMappingURL=client.js.map

package/dist/src/foundation/protocol/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/foundation/protocol/client.ts"],"names":[],"mappings":"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"}

package/dist/src/foundation/protocol/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./client.js";
+export * from "./messages.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/foundation/protocol/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundation/protocol/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/src/foundation/protocol/index.js

@@ -0,0 +1,3 @@
+export * from "./client.js";
+export * from "./messages.js";
+//# sourceMappingURL=index.js.map

package/dist/src/foundation/protocol/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/foundation/protocol/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/src/foundation/protocol/messages.d.ts

@@ -0,0 +1,90 @@
+import type { CommandResult, SupervisorCommand, SupervisorSnapshot } from "../lifecycle/index.js";
+export declare const CONTROL_ENVELOPE: "addone-control-envelope";
+export declare const CONTROL_ENVELOPE_REVISION: 1;
+export declare const REQUIRED_CONTROL_FEATURES: readonly ["handshake.features.v1", "snapshot.revision.v1", "commands.request-identity.v1", "generation.lifecycle.v1", "terminal.foreground-lease.v1"];
+export declare const OPTIONAL_CONTROL_FEATURES: readonly ["messages.unknown-additive-ignore.v1", "snapshot.resynchronize.v1"];
+export type ControlFeature = string;
+export declare const GENERATED_CONTRACT_DIGEST: string;
+export declare const MAX_CONTROL_FRAME_BYTES: number;
+export interface ControlHello {
+    readonly envelope: typeof CONTROL_ENVELOPE;
+    readonly envelopeRevision: typeof CONTROL_ENVELOPE_REVISION;
+    readonly requiredFeatures: readonly ControlFeature[];
+    readonly optionalFeatures: readonly ControlFeature[];
+    readonly contractDigest: string;
+    readonly releaseId?: string;
+}
+export type ClientMessage = {
+    readonly type: "identity-probe";
+} | {
+    readonly type: "release-idle-ownership";
+    readonly bootNonce: string;
+    readonly candidateReleaseId: string;
+} | {
+    readonly type: "release-update-ownership";
+    readonly bootNonce: string;
+    readonly targetVersion: string;
+} | ({
+    readonly type: "client-hello";
+    readonly clientId: string;
+} & ControlHello) | {
+    readonly type: "command";
+    readonly command: SupervisorCommand;
+};
+export type ServerMessage = {
+    readonly type: "identity";
+    readonly supervisorId: string;
+    readonly bootNonce: string;
+    readonly pidStartIdentity: string;
+    readonly releaseId: string;
+} | {
+    readonly type: "release-ownership-result";
+    readonly released: boolean;
+    readonly reason: string;
+    readonly liveGenerationIds: readonly string[];
+} | {
+    readonly type: "release-update-result";
+    readonly accepted: boolean;
+    readonly reason: string;
+    readonly liveGenerationIds: readonly string[];
+} | ({
+    readonly type: "server-hello";
+    readonly supervisorId: string;
+    readonly bootNonce: string;
+    readonly pidStartIdentity: string;
+    readonly negotiatedFeatures: readonly string[];
+    readonly snapshot: SupervisorSnapshot;
+} & ControlHello) | {
+    readonly type: "snapshot";
+    readonly snapshot: SupervisorSnapshot;
+} | {
+    readonly type: "command-result";
+    readonly result: CommandResult;
+} | {
+    readonly type: "protocol-error";
+    readonly code: string;
+    readonly message: string;
+    readonly diagnostics?: unknown;
+};
+export interface ControlNegotiation {
+    readonly ok: boolean;
+    readonly negotiatedFeatures: readonly string[];
+    readonly missingFromClient: readonly string[];
+    readonly missingFromServer: readonly string[];
+    readonly diagnostic: string;
+}
+export declare function localControlHello(releaseId?: string): ControlHello;
+export declare function negotiateControlFeatures(client: ControlHello, server?: ControlHello): ControlNegotiation;
+export declare function encodeFrame(message: ClientMessage | ServerMessage | Readonly<Record<string, unknown>>): string;
+export declare class LineFrameDecoder {
+    #private;
+    push(chunk: Buffer | string): unknown[];
+}
+export declare function isControlHello(value: unknown): value is {
+    readonly type: "client-hello";
+    readonly clientId: string;
+} & ControlHello;
+export declare function isCommandMessage(value: unknown): value is Extract<ClientMessage, {
+    type: "command";
+}>;
+//# sourceMappingURL=messages.d.ts.map

package/dist/src/foundation/protocol/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../../src/foundation/protocol/messages.ts"],"names":[],"mappings":"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"}