@timurproko/a1 0.1.0

package/dist/src/foundation/transparent-terminal/main.js

@@ -0,0 +1,107 @@
+import { randomUUID } from "node:crypto";
+import { realpath } from "node:fs/promises";
+import { resolve } from "node:path";
+import { assertLaunchProfileId } from "../lifecycle/index.js";
+import { SupervisorClient } from "../protocol/index.js";
+import { resolveAddOnePaths } from "../supervision/index.js";
+import { runForegroundBroker } from "./foreground-broker.js";
+import { createPlatformTransparentLauncher } from "./native-launcher.js";
+export async function runTransparentForeground(options = {}) {
+    const environment = { ...(options.environment ?? process.env) };
+    const profileId = options.profileId ?? environment.ADDONE_LAUNCH_PROFILE ?? "addone";
+    assertLaunchProfileId(profileId);
+    const paths = resolveAddOnePaths(environment);
+    const client = new SupervisorClient(environment.ADDONE_RELEASE_ID);
+    await client.connect(paths.endpoint);
+    const ownerId = `foreground-broker-${randomUUID()}`;
+    const profile = await launchProfile(environment, options, profileId);
+    const stop = stopSignal();
+    try {
+        const result = await runForegroundBroker({ leaseId: randomUUID(), generationId: randomUUID(), ownerId, profile, stopRequested: stop.requested }, client, createPlatformTransparentLauncher(), randomUUID);
+        if (result.outcome.kind === "exited")
+            return result.outcome.exitCode;
+        if (result.outcome.kind === "signaled")
+            return 1;
+        if (result.outcome.kind === "stopped" || result.outcome.kind === "detached")
+            return 0;
+        throw Object.assign(new Error(result.outcome.message), { code: result.outcome.code ?? undefined });
+    }
+    finally {
+        stop.dispose();
+        client.close();
+    }
+}
+async function launchProfile(environment, options, profileId) {
+    const executable = options.executable ?? environment.ADDONE_TERMINAL_EXECUTABLE ?? "pi";
+    const arguments_ = options.arguments
+        ?? parseArguments(environment.ADDONE_LAUNCH_ARGUMENTS_JSON)
+        ?? parseArguments(environment.ADDONE_TERMINAL_ARGUMENTS_JSON)
+        ?? [];
+    const cwd = await realpath(options.cwd ?? process.cwd());
+    const terminalType = environment.TERM?.trim() || "xterm-256color";
+    return {
+        id: `${profileId}-transparent-${randomUUID()}`,
+        terminalCapability: "transparent",
+        executable,
+        arguments: arguments_,
+        cwd,
+        environment: selectedChildEnvironment(environment),
+        terminalType,
+        dimensions: terminalDimensions(environment),
+        ownerDisconnect: "stop",
+        recovery: "none",
+        surface: "none",
+        visualReconnection: "none",
+    };
+}
+function parseArguments(source) {
+    if (!source)
+        return null;
+    const value = JSON.parse(source);
+    if (!Array.isArray(value) || value.some(item => typeof item !== "string")) {
+        throw new TypeError("ADDONE_TERMINAL_ARGUMENTS_JSON must be a JSON array of strings");
+    }
+    return value;
+}
+function selectedChildEnvironment(environment) {
+    const selected = {};
+    for (const [name, value] of Object.entries(environment)) {
+        if (value !== undefined && !name.startsWith("ADDONE_"))
+            selected[name] = value;
+    }
+    return selected;
+}
+function terminalDimensions(environment) {
+    const columns = positiveInteger(environment.COLUMNS) ?? 80;
+    const rows = positiveInteger(environment.LINES) ?? 24;
+    return { columns: Math.min(500, Math.max(2, columns)), rows: Math.min(300, Math.max(1, rows)) };
+}
+function positiveInteger(value) {
+    const parsed = Number(value);
+    return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
+}
+function stopSignal() {
+    let resolveStop;
+    let settled = false;
+    const requested = new Promise(resolve => { resolveStop = resolve; });
+    const request = (reason) => {
+        if (settled)
+            return;
+        settled = true;
+        resolveStop(reason);
+    };
+    const onSigterm = () => request("user-request");
+    // The attached child shares foreground signal delivery. Keep the broker alive
+    // without translating or forwarding Ctrl+C.
+    const onSigint = () => undefined;
+    process.once("SIGTERM", onSigterm);
+    process.on("SIGINT", onSigint);
+    return {
+        requested,
+        dispose() {
+            process.off("SIGTERM", onSigterm);
+            process.off("SIGINT", onSigint);
+        },
+    };
+}
+//# sourceMappingURL=main.js.map

package/dist/src/foundation/transparent-terminal/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../../src/foundation/transparent-terminal/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAA+D,MAAM,uBAAuB,CAAC;AAC3H,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAA8B,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,iCAAiC,EAAE,MAAM,sBAAsB,CAAC;AAUzE,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,UAAwC,EAAE;IACvF,MAAM,WAAW,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,WAAW,CAAC,qBAAqB,IAAI,QAAQ,CAAC;IACrF,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IACnE,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,qBAAqB,UAAU,EAAE,EAAE,CAAC;IACpD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CACtC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,SAAS,EAAE,EACtG,MAAM,EACN,iCAAiC,EAAE,EACnC,UAAU,CACX,CAAC;QACF,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;QACrE,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO,CAAC,CAAC;QACtF,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC;IACrG,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,WAA8B,EAC9B,OAAqC,EACrC,SAA0B;IAE1B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,WAAW,CAAC,0BAA0B,IAAI,IAAI,CAAC;IACxF,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS;WAC/B,cAAc,CAAC,WAAW,CAAC,4BAA4B,CAAC;WACxD,cAAc,CAAC,WAAW,CAAC,8BAA8B,CAAC;WAC1D,EAAE,CAAC;IACR,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,gBAAgB,CAAC;IAClE,OAAO;QACL,EAAE,EAAE,GAAG,SAAS,gBAAgB,UAAU,EAAE,EAAE;QAC9C,kBAAkB,EAAE,aAAa;QACjC,UAAU;QACV,SAAS,EAAE,UAAU;QACrB,GAAG;QACH,WAAW,EAAE,wBAAwB,CAAC,WAAW,CAAC;QAClD,YAAY;QACZ,UAAU,EAAE,kBAAkB,CAAC,WAAW,CAAC;QAC3C,eAAe,EAAE,MAAM;QACvB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,MAAM;QACf,kBAAkB,EAAE,MAAM;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,MAA0B;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,SAAS,CAAC,gEAAgE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,wBAAwB,CAAC,WAA8B;IAC9D,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACxD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACjF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,kBAAkB,CAAC,WAA8B;IACxD,MAAM,OAAO,GAAG,eAAe,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC3D,MAAM,IAAI,GAAG,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACtD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;AAClG,CAAC;AAED,SAAS,eAAe,CAAC,KAAyB;IAChD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACpE,CAAC;AAED,SAAS,UAAU;IACjB,IAAI,WAAqD,CAAC;IAC1D,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,SAAS,GAAG,IAAI,OAAO,CAAwB,OAAO,CAAC,EAAE,GAAG,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,MAAM,OAAO,GAAG,CAAC,MAA6B,EAAE,EAAE;QAChD,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,WAAW,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAChD,8EAA8E;IAC9E,4CAA4C;IAC5C,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO;QACL,SAAS;QACT,OAAO;YACL,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/foundation/transparent-terminal/native-launcher.d.ts

@@ -0,0 +1,26 @@
+import { type ChildProcess, type SpawnOptions } from "node:child_process";
+import type { TransparentTerminalLaunchProfile } from "../lifecycle/index.js";
+import type { TransparentChildHandle, TransparentNativeLauncher } from "./foreground-broker.js";
+export interface NativeSpawnAdapter {
+    resolveCommand(profile: TransparentTerminalLaunchProfile): Promise<{
+        readonly executable: string;
+        readonly arguments: readonly string[];
+    }>;
+    spawn(executable: string, arguments_: readonly string[], options: SpawnOptions): ChildProcess;
+    observeStartIdentity(child: ChildProcess): Promise<string>;
+    identityMatches(child: ChildProcess, expectedStartIdentity: string): Promise<boolean>;
+    stop(child: ChildProcess, force: boolean): Promise<void>;
+    waitForExit(child: ChildProcess, timeoutMs: number): Promise<boolean>;
+}
+export declare function createPlatformTransparentLauncher(platform?: NodeJS.Platform, adapter?: NativeSpawnAdapter): TransparentNativeLauncher;
+export declare class WindowsTransparentLauncher implements TransparentNativeLauncher {
+    private readonly adapter;
+    constructor(adapter?: NativeSpawnAdapter);
+    launch(profile: TransparentTerminalLaunchProfile): Promise<TransparentChildHandle>;
+}
+export declare class UnixTransparentLauncher implements TransparentNativeLauncher {
+    private readonly adapter;
+    constructor(adapter?: NativeSpawnAdapter);
+    launch(profile: TransparentTerminalLaunchProfile): Promise<TransparentChildHandle>;
+}
+//# sourceMappingURL=native-launcher.d.ts.map

package/dist/src/foundation/transparent-terminal/native-launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-launcher.d.ts","sourceRoot":"","sources":["../../../../src/foundation/transparent-terminal/native-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEjF,OAAO,KAAK,EAAE,gCAAgC,EAAuC,MAAM,uBAAuB,CAAC;AACnH,OAAO,KAAK,EAAE,sBAAsB,EAAE,yBAAyB,EAAyB,MAAM,wBAAwB,CAAC;AAGvH,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC3I,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY,CAAC;IAC9F,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtF,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvE;AAED,wBAAgB,iCAAiC,CAC/C,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,OAAO,GAAE,kBAAwC,GAChD,yBAAyB,CAI3B;AAED,qBAAa,0BAA2B,YAAW,yBAAyB;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,GAAE,kBAAwC;IAExE,MAAM,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAOzF;AAED,qBAAa,uBAAwB,YAAW,yBAAyB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,GAAE,kBAAwC;IAExE,MAAM,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAOzF"}

package/dist/src/foundation/transparent-terminal/native-launcher.js

@@ -0,0 +1,147 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { resolveTransparentCommand } from "./command-resolution.js";
+export function createPlatformTransparentLauncher(platform = process.platform, adapter = defaultSpawnAdapter) {
+    if (platform === "win32")
+        return new WindowsTransparentLauncher(adapter);
+    if (platform === "linux" || platform === "darwin")
+        return new UnixTransparentLauncher(adapter);
+    throw new Error(`transparent terminal attachment is unsupported on ${platform}`);
+}
+export class WindowsTransparentLauncher {
+    adapter;
+    constructor(adapter = defaultSpawnAdapter) {
+        this.adapter = adapter;
+    }
+    async launch(profile) {
+        return await launchInherited(profile, this.adapter, {
+            windowsHide: true,
+            windowsVerbatimArguments: false,
+            detached: false,
+        });
+    }
+}
+export class UnixTransparentLauncher {
+    adapter;
+    constructor(adapter = defaultSpawnAdapter) {
+        this.adapter = adapter;
+    }
+    async launch(profile) {
+        // Staying in the foreground process group preserves the inherited controlling
+        // terminal without an intermediary or synthetic terminal restoration.
+        return await launchInherited(profile, this.adapter, {
+            detached: false,
+        });
+    }
+}
+async function launchInherited(profile, adapter, platformOptions) {
+    const command = await adapter.resolveCommand(profile);
+    const child = adapter.spawn(command.executable, command.arguments, {
+        ...platformOptions,
+        cwd: profile.cwd,
+        env: { ...profile.environment, TERM: profile.terminalType },
+        shell: false,
+        stdio: "inherit",
+    });
+    await spawned(child);
+    if (!child.pid)
+        throw Object.assign(new Error("transparent child has no process identity"), { code: "NO_PROCESS_ID" });
+    const outcome = childOutcome(child);
+    const startIdentity = await adapter.observeStartIdentity(child);
+    const processIdentity = { pid: child.pid, startIdentity };
+    let stopOutcome = null;
+    return {
+        processIdentity,
+        outcome,
+        stop(reason) {
+            stopOutcome ??= stopOwnedChild(child, adapter, processIdentity.startIdentity, reason);
+            return stopOutcome;
+        },
+    };
+}
+function spawned(child) {
+    return new Promise((resolve, reject) => {
+        if (child.pid) {
+            resolve();
+            return;
+        }
+        child.once("spawn", resolve);
+        child.once("error", reject);
+    });
+}
+function childOutcome(child) {
+    return new Promise(resolve => {
+        child.once("error", error => resolve({ kind: "broker-error", message: error.message, code: errorCode(error) }));
+        child.once("close", (exitCode, signal) => {
+            if (signal)
+                resolve({ kind: "signaled", signal });
+            else
+                resolve({ kind: "exited", exitCode: exitCode ?? 1 });
+        });
+    });
+}
+async function stopOwnedChild(child, adapter, expectedStartIdentity, reason) {
+    if (!await adapter.identityMatches(child, expectedStartIdentity)) {
+        return { kind: "broker-error", message: "refusing cleanup because transparent child ownership changed", code: "PROCESS_IDENTITY_MISMATCH" };
+    }
+    await adapter.stop(child, false);
+    if (!await adapter.waitForExit(child, 1_500)) {
+        if (!await adapter.identityMatches(child, expectedStartIdentity)) {
+            return { kind: "broker-error", message: "refusing forced cleanup because transparent child ownership changed", code: "PROCESS_IDENTITY_MISMATCH" };
+        }
+        await adapter.stop(child, true);
+        if (!await adapter.waitForExit(child, 1_500)) {
+            return { kind: "broker-error", message: "transparent child did not exit within the bounded cleanup deadline", code: "CLEANUP_TIMEOUT" };
+        }
+    }
+    return { kind: "stopped", reason };
+}
+function errorCode(error) {
+    return "code" in error && typeof error.code === "string" ? error.code : null;
+}
+const observedStartIdentities = new WeakMap();
+const defaultSpawnAdapter = {
+    async resolveCommand(profile) {
+        return await resolveTransparentCommand(profile.executable, profile.arguments, {
+            cwd: profile.cwd,
+            environment: profile.environment,
+        });
+    },
+    spawn(executable, arguments_, options) {
+        return spawn(executable, [...arguments_], options);
+    },
+    async observeStartIdentity(child) {
+        if (!child.pid)
+            throw new Error("transparent child has no PID");
+        const identity = `${child.pid}:${randomUUID()}`;
+        observedStartIdentities.set(child, identity);
+        return identity;
+    },
+    async identityMatches(child, expectedStartIdentity) {
+        return child.pid !== undefined
+            && child.exitCode === null
+            && child.signalCode === null
+            && observedStartIdentities.get(child) === expectedStartIdentity;
+    },
+    async stop(child, force) {
+        if (child.exitCode !== null || child.signalCode !== null)
+            return;
+        child.kill(force ? "SIGKILL" : "SIGTERM");
+    },
+    async waitForExit(child, timeoutMs) {
+        if (child.exitCode !== null || child.signalCode !== null)
+            return true;
+        return await new Promise(resolve => {
+            const timer = setTimeout(() => finish(false), timeoutMs);
+            timer.unref();
+            const finish = (exited) => {
+                clearTimeout(timer);
+                child.off("close", onClose);
+                resolve(exited);
+            };
+            const onClose = () => finish(true);
+            child.once("close", onClose);
+        });
+    },
+};
+//# sourceMappingURL=native-launcher.js.map

package/dist/src/foundation/transparent-terminal/native-launcher.js.map

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

package/dist/src/foundation/workspace-contracts/index.d.ts

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

package/dist/src/foundation/workspace-contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundation/workspace-contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/src/foundation/workspace-contracts/index.js

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

package/dist/src/foundation/workspace-contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/foundation/workspace-contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/src/foundation/workspace-contracts/model.d.ts

@@ -0,0 +1,249 @@
+export declare const WORKSPACE_CONTRACT_VERSION: 1;
+export declare const NATIVE_HOST_PROTOCOL_VERSION: 1;
+export type WorkspaceId = string;
+export type AgentId = string;
+export type AdapterId = string;
+export type CorrelationId = string;
+export type EventPosition = number;
+export type WindowId = string;
+export type TabId = string;
+export type PaneId = string;
+export type TerminalSessionId = string;
+export type TopologyNodeId = string;
+export type NativeHostInstanceId = string;
+export type RecoveryReferenceId = string;
+export type AgentRuntimeKind = "structured" | "composed-terminal";
+export type AgentLifecycleState = "creating" | "ready" | "inactive" | "stopping" | "stopped" | "failed" | "discontinuous";
+export interface StructuredFlowLimits {
+    readonly maxEventBytes: number;
+    readonly maxSnapshotBytes: number;
+    readonly maxAttachmentBytes: number;
+    readonly maxQueuedEvents: number;
+    readonly maxConcurrentCommands: number;
+    readonly maxReconnectEvents: number;
+}
+export interface StructuredCapabilityContract {
+    readonly kind: "structured";
+    readonly protocolVersion: typeof WORKSPACE_CONTRACT_VERSION;
+    readonly adapterId: AdapterId;
+    readonly commands: readonly string[];
+    readonly eventTypes: readonly string[];
+    readonly snapshots: "none" | "authoritative";
+    readonly resume: "none" | "position" | "snapshot";
+    readonly cancellation: "none" | "correlated";
+    readonly attachmentTypes: readonly string[];
+    readonly flow: StructuredFlowLimits;
+}
+export interface ComposedTerminalCapabilityContract {
+    readonly kind: "composed-terminal";
+    readonly protocolVersion: typeof NATIVE_HOST_PROTOCOL_VERSION;
+    readonly hostInstanceId: NativeHostInstanceId;
+    readonly topologyRevision: number;
+    readonly proofStatus: "unavailable" | "pending" | "accepted" | "rejected";
+}
+export type AgentCapabilityContract = StructuredCapabilityContract | ComposedTerminalCapabilityContract;
+export interface ManagedAgentDescriptor {
+    readonly id: AgentId;
+    readonly displayName: string;
+    readonly adapterId: AdapterId;
+    readonly runtime: AgentRuntimeKind;
+    readonly lifecycle: AgentLifecycleState;
+    readonly capability: AgentCapabilityContract;
+    readonly createdAt: string;
+    readonly recoveryReferenceId: RecoveryReferenceId | null;
+}
+export interface TerminalDimensions {
+    readonly columns: number;
+    readonly rows: number;
+    readonly widthPixels: number;
+    readonly heightPixels: number;
+}
+export interface TerminalSessionLaunch {
+    readonly id: TerminalSessionId;
+    readonly executable: string;
+    readonly arguments: readonly string[];
+    readonly cwd: string;
+    readonly environment: Readonly<Record<string, string>>;
+    readonly dimensions: TerminalDimensions;
+    readonly inactivity: "live-unpainted" | "pause-display" | "suspend" | "terminate";
+}
+export interface TerminalPane {
+    readonly id: PaneId;
+    readonly sessionId: TerminalSessionId;
+}
+export type TerminalTopologyNode = {
+    readonly id: TopologyNodeId;
+    readonly kind: "leaf";
+    readonly paneId: PaneId;
+} | {
+    readonly id: TopologyNodeId;
+    readonly kind: "split";
+    readonly axis: "horizontal" | "vertical";
+    readonly ratio: number;
+    readonly first: TopologyNodeId;
+    readonly second: TopologyNodeId;
+};
+export interface TerminalTab {
+    readonly id: TabId;
+    readonly rootNodeId: TopologyNodeId;
+    readonly focusedPaneId: PaneId;
+    readonly nodes: readonly TerminalTopologyNode[];
+    readonly panes: readonly TerminalPane[];
+}
+export interface TerminalWindow {
+    readonly id: WindowId;
+    readonly activeTabId: TabId;
+    readonly tabs: readonly TerminalTab[];
+}
+export interface TerminalTopologySnapshot {
+    readonly hostInstanceId: NativeHostInstanceId;
+    readonly revision: number;
+    readonly windows: readonly TerminalWindow[];
+    readonly sessions: readonly TerminalSessionLaunch[];
+}
+export type WorkspaceCommand = {
+    readonly type: "create-agent";
+    readonly correlationId: CorrelationId;
+    readonly agent: ManagedAgentDescriptor;
+} | {
+    readonly type: "select-agent";
+    readonly correlationId: CorrelationId;
+    readonly agentId: AgentId;
+} | {
+    readonly type: "rename-agent";
+    readonly correlationId: CorrelationId;
+    readonly agentId: AgentId;
+    readonly displayName: string;
+} | {
+    readonly type: "stop-agent" | "restart-agent" | "remove-agent";
+    readonly correlationId: CorrelationId;
+    readonly agentId: AgentId;
+} | {
+    readonly type: "structured-command";
+    readonly correlationId: CorrelationId;
+    readonly agentId: AgentId;
+    readonly command: string;
+    readonly payload: unknown;
+} | {
+    readonly type: "cancel-structured-command";
+    readonly correlationId: CorrelationId;
+    readonly agentId: AgentId;
+    readonly targetCorrelationId: CorrelationId;
+};
+export type WorkspaceEvent = {
+    readonly type: "agent-lifecycle";
+    readonly agentId: AgentId;
+    readonly position: EventPosition;
+    readonly state: AgentLifecycleState;
+} | {
+    readonly type: "structured-event";
+    readonly agentId: AgentId;
+    readonly position: EventPosition;
+    readonly eventType: string;
+    readonly payload: unknown;
+} | {
+    readonly type: "command-outcome";
+    readonly agentId: AgentId;
+    readonly correlationId: CorrelationId;
+    readonly outcome: "accepted" | "rejected" | "completed" | "failed" | "timed-out" | "cancelled";
+} | {
+    readonly type: "terminal-topology";
+    readonly agentId: AgentId;
+    readonly topology: TerminalTopologySnapshot;
+} | {
+    readonly type: "recovery-discontinuity";
+    readonly agentId: AgentId;
+    readonly reason: string;
+};
+export interface WorkspaceSnapshot {
+    readonly contractVersion: typeof WORKSPACE_CONTRACT_VERSION;
+    readonly workspaceId: WorkspaceId;
+    readonly revision: number;
+    readonly selectedAgentId: AgentId | null;
+    readonly agents: readonly ManagedAgentDescriptor[];
+}
+export interface StructuredAgentSnapshot {
+    readonly contractVersion: typeof WORKSPACE_CONTRACT_VERSION;
+    readonly agentId: AgentId;
+    readonly snapshotId: string;
+    readonly position: EventPosition;
+    readonly authoritative: true;
+    readonly payload: unknown;
+}
+export interface NativeHostHello {
+    readonly protocolVersion: typeof NATIVE_HOST_PROTOCOL_VERSION;
+    readonly hostInstanceId: NativeHostInstanceId;
+    readonly buildId: string;
+    readonly platform: "windows" | "macos" | "linux";
+    readonly capabilities: readonly ("exact-command" | "revisioned-topology" | "native-input" | "native-rendering" | "retained-terminal-state")[];
+}
+export type NativeHostCommand = {
+    readonly type: "snapshot";
+    readonly correlationId: CorrelationId;
+} | {
+    readonly type: "apply-topology";
+    readonly correlationId: CorrelationId;
+    readonly expectedRevision: number;
+    readonly topology: TerminalTopologySnapshot;
+} | {
+    readonly type: "focus-pane";
+    readonly correlationId: CorrelationId;
+    readonly expectedRevision: number;
+    readonly paneId: PaneId;
+} | {
+    readonly type: "close-pane";
+    readonly correlationId: CorrelationId;
+    readonly expectedRevision: number;
+    readonly paneId: PaneId;
+} | {
+    readonly type: "shutdown";
+    readonly correlationId: CorrelationId;
+};
+export type NativeHostEvent = {
+    readonly type: "topology-changed";
+    readonly topology: TerminalTopologySnapshot;
+} | {
+    readonly type: "pane-ready";
+    readonly paneId: PaneId;
+    readonly sessionId: TerminalSessionId;
+} | {
+    readonly type: "process-exited";
+    readonly paneId: PaneId;
+    readonly sessionId: TerminalSessionId;
+    readonly exitCode: number | null;
+    readonly signal: string | null;
+} | {
+    readonly type: "host-degraded";
+    readonly code: string;
+    readonly message: string;
+};
+export interface StructuredRecoveryAuthority {
+    readonly kind: "structured";
+    readonly referenceId: RecoveryReferenceId;
+    readonly agentId: AgentId;
+    readonly adapterId: AdapterId;
+    readonly processIdentity: string;
+    readonly ownershipProof: string;
+    readonly boundary: {
+        readonly kind: "position";
+        readonly position: EventPosition;
+        readonly resumeToken: string;
+    } | {
+        readonly kind: "snapshot";
+        readonly snapshotId: string;
+    };
+}
+export interface ComposedRecoveryAuthority {
+    readonly kind: "composed-terminal";
+    readonly referenceId: RecoveryReferenceId;
+    readonly agentId: AgentId;
+    readonly hostInstanceId: NativeHostInstanceId;
+    readonly hostBuildId: string;
+    readonly processIdentity: string;
+    readonly pseudoterminalIdentity: string;
+    readonly retainedStateIdentity: string;
+    readonly topologyRevision: number;
+    readonly streamPosition: number;
+}
+export type AgentRecoveryAuthority = StructuredRecoveryAuthority | ComposedRecoveryAuthority;
+//# sourceMappingURL=model.d.ts.map

package/dist/src/foundation/workspace-contracts/model.d.ts.map

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

package/dist/src/foundation/workspace-contracts/model.js

@@ -0,0 +1,3 @@
+export const WORKSPACE_CONTRACT_VERSION = 1;
+export const NATIVE_HOST_PROTOCOL_VERSION = 1;
+//# sourceMappingURL=model.js.map

package/dist/src/foundation/workspace-contracts/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../src/foundation/workspace-contracts/model.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAU,CAAC;AACrD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAU,CAAC"}

package/dist/src/foundation/workspace-contracts/validation.d.ts

@@ -0,0 +1,14 @@
+import type { AgentCapabilityContract, AgentRecoveryAuthority, ComposedTerminalCapabilityContract, ManagedAgentDescriptor, NativeHostCommand, StructuredAgentSnapshot, StructuredCapabilityContract, TerminalSessionLaunch, TerminalTopologySnapshot, WorkspaceCommand, WorkspaceEvent, WorkspaceSnapshot } from "./model.js";
+export declare function assertManagedAgentDescriptor(agent: ManagedAgentDescriptor): void;
+export declare function assertAgentCapability(capability: AgentCapabilityContract): void;
+export declare function assertStructuredCapability(capability: StructuredCapabilityContract): void;
+export declare function assertComposedTerminalCapability(capability: ComposedTerminalCapabilityContract): void;
+export declare function assertWorkspaceSnapshot(snapshot: WorkspaceSnapshot): void;
+export declare function assertWorkspaceCommand(command: WorkspaceCommand): void;
+export declare function assertWorkspaceEvent(event: WorkspaceEvent): void;
+export declare function assertStructuredAgentSnapshot(snapshot: StructuredAgentSnapshot): void;
+export declare function assertTerminalTopologySnapshot(topology: TerminalTopologySnapshot): void;
+export declare function assertNativeHostCommand(command: NativeHostCommand): void;
+export declare function assertRecoveryAuthority(authority: AgentRecoveryAuthority): void;
+export declare function assertTerminalSessionLaunch(session: TerminalSessionLaunch): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/foundation/workspace-contracts/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/foundation/workspace-contracts/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,kCAAkC,EAClC,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,4BAA4B,EAE5B,qBAAqB,EAGrB,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAWpB,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAQhF;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAM/E;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,4BAA4B,GAAG,IAAI,CAazF;AAED,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,kCAAkC,GAAG,IAAI,CAIrG;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAczE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAyBtE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAoBhE;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAOrF;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI,CA4BvF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAcxE;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAqB/E;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAehF"}