@vibecook/ghosttea-electron 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 James Yong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,41 @@
+# `@vibecook/ghosttea-electron`
+
+Electron lifecycle and direct renderer transport for Ghosttea.
+
+Use managed mode when this package should start a configured Rust service. Use
+external mode when the Electron application already owns a Rust composition
+service and only wants Ghosttea to attach its authenticated control and frame
+channels.
+
+Frame payloads travel directly from the utility process to renderer
+MessagePorts. They are not routed through Electron main.
+
+The backend also owns a control-only `GhostteaAutomationClient` for
+application-driven sessions and input. It never opens the frame socket,
+attaches a renderer view, or claims focus/resize authority:
+
+```ts
+await backend.start();
+const session = await backend.automation.createSession({
+  executable: "claude",
+  args: [],
+  environment: { mode: "clean", variables: agentEnvironment },
+  cols: 120,
+  rows: 40,
+  persistence: "terminate-with-app",
+});
+const result = await backend.automation.pasteAndSubmit(session.id, "Review this repository");
+if (!result.accepted) {
+  // Human input was accepted after the automation epoch was observed.
+}
+```
+
+Automation paste and submission are one ordered PTY operation. Human input
+invalidates a stale automation epoch rather than being delayed.
+
+Hosts that already own a `TerminalDaemonConnection` can import
+`GhostteaAutomationClient` directly from
+`@vibecook/ghosttea-electron/automation`. That subpath is Node-only and does
+not load Electron main-process modules. New Electron-free Node hosts should
+depend directly on `@vibecook/ghosttea-client`; the Electron export is retained
+for compatibility.

package/dist/automation.d.ts

@@ -0,0 +1,2 @@
+export { GhostteaAutomationClient, type AutomationInputResult, type GhostteaAutomationClientOptions, type GhostteaControlCommand, type GhostteaControlConnection, type SessionExitedEvent, } from "@vibecook/ghosttea-client";
+//# sourceMappingURL=automation.d.ts.map

package/dist/automation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../src/automation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,+BAA+B,EACpC,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC"}

package/dist/automation.js

@@ -0,0 +1,2 @@
+export { GhostteaAutomationClient, } from "@vibecook/ghosttea-client";
+//# sourceMappingURL=automation.js.map

package/dist/automation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.js","sourceRoot":"","sources":["../src/automation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,GAMzB,MAAM,2BAA2B,CAAC"}

package/dist/backend.d.ts

@@ -0,0 +1,28 @@
+import { EventEmitter } from "node:events";
+import type { WebContents } from "electron";
+import { GhostteaAutomationClient, type GhostteaAutomationClientOptions } from "./automation.js";
+import { type GhostteaElectronBridgeOptions } from "./bridge.js";
+import { type TerminalSupervisorOptions } from "./supervisor.js";
+import type { TerminalDaemonConnection } from "./types.js";
+export type GhostteaElectronBackendOptions = {
+    mode: "managed";
+    daemon: TerminalSupervisorOptions;
+    bridge?: Omit<GhostteaElectronBridgeOptions, "connection">;
+    automation?: GhostteaAutomationClientOptions;
+} | {
+    mode: "external";
+    connection: TerminalDaemonConnection;
+    bridge?: Omit<GhostteaElectronBridgeOptions, "connection">;
+    automation?: GhostteaAutomationClientOptions;
+};
+export declare class GhostteaElectronBackend extends EventEmitter {
+    #private;
+    constructor(options: GhostteaElectronBackendOptions);
+    get connection(): TerminalDaemonConnection;
+    get running(): boolean;
+    get automation(): GhostteaAutomationClient;
+    start(): Promise<void>;
+    attachRenderer(webContents: WebContents): void;
+    stop(): void;
+}
+//# sourceMappingURL=backend.d.ts.map

package/dist/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,KAAK,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EAA0B,KAAK,6BAA6B,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAsB,KAAK,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D,MAAM,MAAM,8BAA8B,GACtC;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,yBAAyB,CAAC;IAClC,MAAM,CAAC,EAAE,IAAI,CAAC,6BAA6B,EAAE,YAAY,CAAC,CAAC;IAC3D,UAAU,CAAC,EAAE,+BAA+B,CAAC;CAC9C,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,wBAAwB,CAAC;IACrC,MAAM,CAAC,EAAE,IAAI,CAAC,6BAA6B,EAAE,YAAY,CAAC,CAAC;IAC3D,UAAU,CAAC,EAAE,+BAA+B,CAAC;CAC9C,CAAC;AAEN,qBAAa,uBAAwB,SAAQ,YAAY;;IAMvD,YAAY,OAAO,EAAE,8BAA8B,EAQlD;IASD,IAAI,UAAU,IAAI,wBAAwB,CAEzC;IAED,IAAI,OAAO,IAAI,OAAO,CAGrB;IAED,IAAI,UAAU,IAAI,wBAAwB,CAGzC;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB3B;IAED,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAE7C;IAED,IAAI,IAAI,IAAI,CAGX;CACF"}

package/dist/backend.js

@@ -0,0 +1,63 @@
+import { EventEmitter } from "node:events";
+import { GhostteaAutomationClient } from "./automation.js";
+import { GhostteaElectronBridge } from "./bridge.js";
+import { TerminalSupervisor } from "./supervisor.js";
+export class GhostteaElectronBackend extends EventEmitter {
+    #options;
+    #supervisor;
+    #bridge;
+    #automation;
+    constructor(options) {
+        super();
+        this.#options = options;
+        this.#supervisor = options.mode === "managed" ? new TerminalSupervisor(options.daemon) : undefined;
+        this.#supervisor?.on("unexpected-exit", (detail) => {
+            this.#resetClients();
+            this.emit("unexpected-exit", { source: "daemon", ...detail });
+        });
+    }
+    #resetClients() {
+        this.#automation?.dispose();
+        this.#automation = undefined;
+        this.#bridge?.stop();
+        this.#bridge = undefined;
+    }
+    get connection() {
+        return this.#options.mode === "managed" ? this.#supervisor.connection : this.#options.connection;
+    }
+    get running() {
+        const daemonReady = this.#options.mode === "external" || this.#supervisor?.running === true;
+        return daemonReady && this.#bridge?.running === true;
+    }
+    get automation() {
+        this.#automation ??= new GhostteaAutomationClient(this.connection, this.#options.automation);
+        return this.#automation;
+    }
+    async start() {
+        await this.#supervisor?.start();
+        await this.automation.connect();
+        if (!this.#bridge) {
+            this.#bridge = new GhostteaElectronBridge({
+                ...this.#options.bridge,
+                connection: this.connection,
+            });
+            this.#bridge.on("unexpected-exit", (detail) => {
+                this.#bridge = undefined;
+                this.emit("unexpected-exit", { source: "bridge", ...detail });
+            });
+            this.#bridge.on("connection-lost", (detail) => {
+                this.#resetClients();
+                this.emit("unexpected-exit", { source: "connection", code: null, signal: null, ...detail });
+            });
+        }
+        this.#bridge.start();
+    }
+    attachRenderer(webContents) {
+        this.#bridge?.attachRenderer(webContents);
+    }
+    stop() {
+        this.#resetClients();
+        this.#supervisor?.stop();
+    }
+}
+//# sourceMappingURL=backend.js.map

package/dist/backend.js.map

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

package/dist/bridge-entry.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bridge-entry.d.ts.map

package/dist/bridge-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-entry.d.ts","sourceRoot":"","sources":["../src/bridge-entry.ts"],"names":[],"mappings":""}

package/dist/bridge-entry.js

@@ -0,0 +1,154 @@
+import { connectSocket, packet } from "./bridge-socket.js";
+import { FrameFlowControl, requestedFrameBridgeCapabilities } from "./frame-flow.js";
+import { isMainToBridgeMessage } from "./types.js";
+const parentPort = process.parentPort;
+const MAX_CONTROL_BYTES = 1024 * 1024;
+const MAX_FRAME_BYTES = 16 * 1024 * 1024;
+const MAX_FRAME_SUBSCRIPTION_BYTES = 1024 * 1024;
+const FRAME_MAGIC = 0x31465254;
+async function attachRenderer(rawData, ports) {
+    const [controlPort, framePort] = ports;
+    if (!isMainToBridgeMessage(rawData) || !controlPort || !framePort)
+        throw new Error("invalid bridge bootstrap");
+    const data = rawData;
+    let controlSocket;
+    let frameSocket;
+    let rendererClosed = false;
+    let connectionLost = false;
+    let frameFlowEnabled = false;
+    const frameFlow = new FrameFlowControl();
+    const reportConnectionLost = (cause) => {
+        if (rendererClosed || connectionLost)
+            return;
+        connectionLost = true;
+        const error = cause instanceof Error ? cause : new Error(String(cause));
+        controlPort.postMessage({ requestId: 0, type: "bridge-error", message: error.message });
+        parentPort.postMessage({ type: "connection-lost", message: error.message });
+        controlSocket?.destroy();
+        frameSocket?.destroy();
+    };
+    try {
+        controlSocket = await connectSocket(data.connection.controlSocket, data.connection.authToken, MAX_CONTROL_BYTES, (bytes) => {
+            try {
+                controlPort.postMessage(JSON.parse(bytes.toString("utf8")));
+            }
+            catch (cause) {
+                const error = cause instanceof Error ? cause : new Error(String(cause));
+                controlPort.postMessage({
+                    requestId: 0,
+                    type: "bridge-error",
+                    message: `Invalid terminald response: ${error.message}`,
+                });
+                controlSocket?.destroy();
+            }
+        }, reportConnectionLost);
+        frameSocket = await connectSocket(data.connection.frameSocket, data.connection.authToken, MAX_FRAME_BYTES, (bytes) => {
+            try {
+                if (bytes.byteLength >= 4 && bytes.readUInt32LE(0) === FRAME_MAGIC) {
+                    const transferable = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+                    const accounted = frameFlowEnabled;
+                    const action = accounted ? frameFlow.accept(transferable.byteLength) : undefined;
+                    try {
+                        framePort.postMessage(transferable);
+                    }
+                    catch (error) {
+                        if (accounted)
+                            frameFlow.release(transferable.byteLength);
+                        throw error;
+                    }
+                    if (action === "pause")
+                        frameSocket?.pause();
+                    return;
+                }
+                const message = JSON.parse(bytes.toString("utf8"));
+                if (!message ||
+                    typeof message !== "object" ||
+                    !["subscription-ack", "frame-gap"].includes(String(message.type))) {
+                    throw new Error("terminald sent an invalid frame-channel message");
+                }
+                framePort.postMessage(message);
+            }
+            catch (cause) {
+                reportConnectionLost(cause);
+            }
+        }, reportConnectionLost);
+    }
+    catch (error) {
+        controlSocket?.destroy();
+        frameSocket?.destroy();
+        connectionLost = true;
+        const message = error instanceof Error ? error.message : String(error);
+        parentPort.postMessage({ type: "connection-lost", message });
+        throw error;
+    }
+    controlPort.on("message", ({ data: command }) => {
+        try {
+            const encoded = Buffer.from(JSON.stringify(command));
+            if (encoded.byteLength > MAX_CONTROL_BYTES)
+                throw new Error("control packet exceeds quota");
+            controlSocket.write(packet(encoded));
+        }
+        catch (cause) {
+            const error = cause instanceof Error ? cause : new Error(String(cause));
+            controlPort.postMessage({ requestId: 0, type: "bridge-error", message: error.message });
+        }
+    });
+    framePort.on("message", ({ data: subscription }) => {
+        try {
+            if (subscription &&
+                typeof subscription === "object" &&
+                subscription.type === "frame-credit") {
+                if (!frameFlowEnabled)
+                    return;
+                const bytes = subscription.bytes;
+                if (!Number.isSafeInteger(bytes) || Number(bytes) < 0)
+                    throw new Error("invalid renderer frame credit");
+                if (frameFlow.release(Number(bytes)) === "resume")
+                    frameSocket.resume();
+                return;
+            }
+            if (subscription &&
+                typeof subscription === "object" &&
+                subscription.type === "subscribe") {
+                const capabilities = requestedFrameBridgeCapabilities(subscription);
+                if (capabilities) {
+                    // Announce support before forwarding the subscription. MessagePort
+                    // ordering then guarantees that the renderer knows credits are active
+                    // before terminald can deliver the subscription's first frame.
+                    framePort.postMessage(capabilities);
+                    frameFlowEnabled = true;
+                }
+                else if (subscription.frameCredits === true) {
+                    // Preserve compatibility with the first credit-enabled renderer,
+                    // which predated the explicit bridge capability handshake.
+                    frameFlowEnabled = true;
+                }
+            }
+            const encoded = Buffer.from(JSON.stringify(subscription));
+            if (encoded.byteLength > MAX_FRAME_SUBSCRIPTION_BYTES)
+                throw new Error("frame subscription exceeds quota");
+            frameSocket.write(packet(encoded));
+        }
+        catch (cause) {
+            const error = cause instanceof Error ? cause : new Error(String(cause));
+            controlPort.postMessage({ requestId: 0, type: "bridge-error", message: error.message });
+        }
+    });
+    const closeForRenderer = () => {
+        rendererClosed = true;
+        controlSocket.destroy();
+        frameSocket.destroy();
+    };
+    controlPort.once("close", closeForRenderer);
+    framePort.once("close", closeForRenderer);
+    controlPort.start();
+    framePort.start();
+}
+parentPort.on("message", (event) => {
+    void attachRenderer(event.data, event.ports).catch((cause) => {
+        const error = cause instanceof Error ? cause : new Error(String(cause));
+        console.error(`[terminal-bridge] ${error.stack ?? error.message}`);
+        event.ports[0]?.postMessage({ requestId: 0, type: "bridge-error", message: error.message });
+    });
+});
+//# sourceMappingURL=bridge-entry.js.map

package/dist/bridge-entry.js.map

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

package/dist/bridge-socket.d.ts

@@ -0,0 +1,4 @@
+import { type Socket } from "node:net";
+export declare function packet(bytes: Uint8Array): Buffer;
+export declare function connectSocket(path: string, token: string, limit: number, onPacket: (bytes: Buffer) => void, onDisconnect: (error: Error) => void, timeoutMs?: number): Promise<Socket>;
+//# sourceMappingURL=bridge-socket.d.ts.map

package/dist/bridge-socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-socket.d.ts","sourceRoot":"","sources":["../src/bridge-socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAEzD,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAKhD;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EACjC,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EACpC,SAAS,SAAS,GACjB,OAAO,CAAC,MAAM,CAAC,CA0EjB"}

package/dist/bridge-socket.js

@@ -0,0 +1,91 @@
+import { createConnection } from "node:net";
+export function packet(bytes) {
+    const output = Buffer.allocUnsafe(4 + bytes.byteLength);
+    output.writeUInt32LE(bytes.byteLength, 0);
+    output.set(bytes, 4);
+    return output;
+}
+export function connectSocket(path, token, limit, onPacket, onDisconnect, timeoutMs = 10_000) {
+    return new Promise((resolve, reject) => {
+        const socket = createConnection(path);
+        let buffered = Buffer.alloc(0);
+        let draining = false;
+        let authenticated = false;
+        let settled = false;
+        const timeout = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            socket.destroy();
+            reject(new Error(`terminald connection timed out during authentication at ${path}`));
+        }, timeoutMs);
+        socket.on("error", (error) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timeout);
+                reject(error);
+            }
+            else {
+                console.error(`[terminal-bridge] socket error at ${path}: ${error.message}`);
+                onDisconnect(error);
+            }
+        });
+        socket.on("close", () => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timeout);
+                reject(new Error(`terminald connection closed during authentication at ${path}`));
+            }
+            else if (authenticated) {
+                onDisconnect(new Error(`terminald connection closed at ${path}`));
+            }
+        });
+        socket.on("connect", () => socket.write(packet(Buffer.from(token))));
+        const drainPackets = () => {
+            if (draining || socket.isPaused())
+                return;
+            draining = true;
+            try {
+                while (buffered.length >= 4) {
+                    const length = buffered.readUInt32LE(0);
+                    if (length > limit) {
+                        socket.destroy(new Error("terminald packet exceeds bridge quota"));
+                        return;
+                    }
+                    if (buffered.length < 4 + length)
+                        return;
+                    const body = buffered.subarray(4, 4 + length);
+                    buffered = buffered.subarray(4 + length);
+                    if (!authenticated) {
+                        if (body.toString() !== "ok") {
+                            settled = true;
+                            clearTimeout(timeout);
+                            socket.destroy();
+                            reject(new Error("terminald authentication failed"));
+                            return;
+                        }
+                        authenticated = true;
+                        settled = true;
+                        clearTimeout(timeout);
+                        resolve(socket);
+                    }
+                    else {
+                        onPacket(body);
+                    }
+                    if (socket.isPaused())
+                        return;
+                }
+            }
+            finally {
+                draining = false;
+            }
+        };
+        socket.on("resume", drainPackets);
+        socket.on("data", (chunk) => {
+            const incoming = typeof chunk === "string" ? Buffer.from(chunk) : chunk;
+            buffered = Buffer.concat([buffered, incoming]);
+            drainPackets();
+        });
+    });
+}
+//# sourceMappingURL=bridge-socket.js.map

package/dist/bridge-socket.js.map

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

package/dist/bridge.d.ts

@@ -0,0 +1,18 @@
+import { EventEmitter } from "node:events";
+import { type WebContents } from "electron";
+import type { TerminalDaemonConnection } from "./types.js";
+export interface GhostteaElectronBridgeOptions {
+    connection: TerminalDaemonConnection;
+    entryPoint?: string;
+    serviceName?: string;
+    rendererChannel?: string;
+}
+export declare class GhostteaElectronBridge extends EventEmitter {
+    #private;
+    constructor(options: GhostteaElectronBridgeOptions);
+    get running(): boolean;
+    start(): void;
+    attachRenderer(webContents: WebContents): void;
+    stop(): void;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAA2D,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACrG,OAAO,KAAK,EAAuB,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEhF,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,wBAAwB,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,sBAAuB,SAAQ,YAAY;;IAItD,YAAY,OAAO,EAAE,6BAA6B,EAGjD;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,KAAK,IAAI,IAAI,CA2BZ;IAED,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAU7C;IAED,IAAI,IAAI,IAAI,CAIX;CACF"}

package/dist/bridge.js

@@ -0,0 +1,59 @@
+import { EventEmitter } from "node:events";
+import { fileURLToPath } from "node:url";
+import { MessageChannelMain, utilityProcess } from "electron";
+export class GhostteaElectronBridge extends EventEmitter {
+    #options;
+    #process;
+    constructor(options) {
+        super();
+        this.#options = options;
+    }
+    get running() {
+        return this.#process !== undefined;
+    }
+    start() {
+        if (this.#process)
+            return;
+        const entryPoint = this.#options.entryPoint ?? fileURLToPath(new URL("./bridge-entry.js", import.meta.url));
+        const child = utilityProcess.fork(entryPoint, [], {
+            serviceName: this.#options.serviceName ?? "ghosttea-terminal-bridge",
+        });
+        this.#process = child;
+        child.once("exit", (code) => {
+            if (this.#process !== child)
+                return;
+            this.#process = undefined;
+            this.emit("unexpected-exit", { code });
+        });
+        child.on("message", (message) => {
+            if (this.#process === child &&
+                message !== null &&
+                typeof message === "object" &&
+                message.type === "connection-lost") {
+                this.emit("connection-lost", {
+                    message: typeof message.message === "string"
+                        ? message.message
+                        : "terminald connection lost",
+                });
+            }
+        });
+    }
+    attachRenderer(webContents) {
+        const child = this.#process;
+        if (!child)
+            throw new Error("Ghosttea Electron bridge is not running");
+        const control = new MessageChannelMain();
+        const frames = new MessageChannelMain();
+        child.postMessage({ type: "connect", connection: this.#options.connection }, [
+            control.port1,
+            frames.port1,
+        ]);
+        webContents.postMessage(this.#options.rendererChannel ?? "terminal-ports", null, [control.port2, frames.port2]);
+    }
+    stop() {
+        const child = this.#process;
+        this.#process = undefined;
+        child?.kill();
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAyC,MAAM,UAAU,CAAC;AAUrG,MAAM,OAAO,sBAAuB,SAAQ,YAAY;IAC7C,QAAQ,CAAgC;IACjD,QAAQ,CAA6B;IAErC,YAAY,OAAsC;QAChD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC;IACrC,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,aAAa,CAAC,IAAI,GAAG,CAAC,mBAAmB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5G,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE;YAChD,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,0BAA0B;SACrE,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC1B,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK;gBAAE,OAAO;YACpC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAgB,EAAE,EAAE;YACvC,IACE,IAAI,CAAC,QAAQ,KAAK,KAAK;gBACvB,OAAO,KAAK,IAAI;gBAChB,OAAO,OAAO,KAAK,QAAQ;gBAC1B,OAA8B,CAAC,IAAI,KAAK,iBAAiB,EAC1D,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE;oBAC3B,OAAO,EACL,OAAQ,OAAiC,CAAC,OAAO,KAAK,QAAQ;wBAC5D,CAAC,CAAE,OAA+B,CAAC,OAAO;wBAC1C,CAAC,CAAC,2BAA2B;iBAClC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,cAAc,CAAC,WAAwB;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACxC,KAAK,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAgC,EAAE;YACzG,OAAO,CAAC,KAAK;YACb,MAAM,CAAC,KAAK;SACb,CAAC,CAAC;QACH,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,IAAI,gBAAgB,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAClH,CAAC;IAED,IAAI;QACF,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,KAAK,EAAE,IAAI,EAAE,CAAC;IAChB,CAAC;CACF"}

package/dist/clipboard.d.ts

@@ -0,0 +1,18 @@
+import type { Clipboard, IpcMain, IpcRenderer, WebContents } from "electron";
+export interface GhostteaClipboardHost {
+    canCopy(webContents: WebContents): boolean;
+    dispose(): void;
+}
+/**
+ * Own clipboard access in Electron's main process. Sandboxed preload scripts
+ * cannot use Electron's clipboard module directly.
+ */
+export declare function installGhostteaClipboardHost(ipcMain: IpcMain, clipboard: Clipboard): GhostteaClipboardHost;
+export interface GhostteaClipboardBridge {
+    writeText(text: string): void;
+    readText(): Promise<string>;
+    setCanCopy(canCopy: boolean): void;
+}
+/** Build the narrow, context-isolated clipboard API exposed by a preload. */
+export declare function createGhostteaClipboardBridge(ipcRenderer: IpcRenderer): GhostteaClipboardBridge;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../src/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAgB,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAM3F,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC;IAC3C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,qBAAqB,CAuC1G;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5B,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACpC;AAED,6EAA6E;AAC7E,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,WAAW,GAAG,uBAAuB,CAe/F"}

package/dist/clipboard.js

@@ -0,0 +1,65 @@
+const READ_CLIPBOARD_CHANNEL = "ghosttea:clipboard:read";
+const WRITE_CLIPBOARD_CHANNEL = "ghosttea:clipboard:write";
+const COPY_AVAILABILITY_CHANNEL = "ghosttea:clipboard:can-copy";
+/**
+ * Own clipboard access in Electron's main process. Sandboxed preload scripts
+ * cannot use Electron's clipboard module directly.
+ */
+export function installGhostteaClipboardHost(ipcMain, clipboard) {
+    const copyAvailability = new Map();
+    const trackedWebContents = new Map();
+    const readClipboard = () => clipboard.readText();
+    const writeClipboard = (event, text) => {
+        if (typeof text !== "string")
+            return;
+        clipboard.writeText(text);
+    };
+    const setCopyAvailability = (event, value) => {
+        const { sender } = event;
+        copyAvailability.set(sender.id, value === true);
+        if (!trackedWebContents.has(sender.id)) {
+            const onDestroyed = () => {
+                copyAvailability.delete(sender.id);
+                trackedWebContents.delete(sender.id);
+            };
+            trackedWebContents.set(sender.id, { sender, onDestroyed });
+            sender.once("destroyed", onDestroyed);
+        }
+    };
+    ipcMain.handle(READ_CLIPBOARD_CHANNEL, readClipboard);
+    ipcMain.on(WRITE_CLIPBOARD_CHANNEL, writeClipboard);
+    ipcMain.on(COPY_AVAILABILITY_CHANNEL, setCopyAvailability);
+    return {
+        canCopy: (webContents) => copyAvailability.get(webContents.id) === true,
+        dispose: () => {
+            ipcMain.removeHandler(READ_CLIPBOARD_CHANNEL);
+            ipcMain.removeListener(WRITE_CLIPBOARD_CHANNEL, writeClipboard);
+            ipcMain.removeListener(COPY_AVAILABILITY_CHANNEL, setCopyAvailability);
+            copyAvailability.clear();
+            for (const { sender, onDestroyed } of trackedWebContents.values()) {
+                sender.removeListener("destroyed", onDestroyed);
+            }
+            trackedWebContents.clear();
+        },
+    };
+}
+/** Build the narrow, context-isolated clipboard API exposed by a preload. */
+export function createGhostteaClipboardBridge(ipcRenderer) {
+    return {
+        writeText: (text) => {
+            if (typeof text !== "string")
+                throw new TypeError("Clipboard text must be a string");
+            ipcRenderer.send(WRITE_CLIPBOARD_CHANNEL, text);
+        },
+        readText: async () => {
+            const text = await ipcRenderer.invoke(READ_CLIPBOARD_CHANNEL);
+            if (typeof text !== "string")
+                throw new TypeError("Main process returned invalid clipboard text");
+            return text;
+        },
+        setCanCopy: (canCopy) => {
+            ipcRenderer.send(COPY_AVAILABILITY_CHANNEL, canCopy === true);
+        },
+    };
+}
+//# sourceMappingURL=clipboard.js.map