linkshell-cli 0.5.42 → 0.6.0

package/dist/host/src/drivers/codex/app-server.js

@@ -0,0 +1,144 @@
+import { spawn, execFile } from "node:child_process";
+import { existsSync, rmSync } from "node:fs";
+import { promisify } from "node:util";
+import WebSocket from "ws";
+import { ABANDON, RpcPeer } from "@linkshell/wire";
+const execFileAsync = promisify(execFile);
+// Notifications LinkShell never renders; opting out keeps the socket quiet.
+const OPT_OUT_NOTIFICATIONS = [
+    "account/rateLimits/updated",
+    "account/updated",
+    "app/list/updated",
+    "fs/changed",
+    "hook/started",
+    "hook/completed",
+    "mcpServer/startupStatus/updated",
+    "rawResponse/completed",
+    "rawResponseItem/completed",
+    "remoteControl/status/changed",
+    "skills/changed",
+    "thread/goal/cleared",
+    "thread/goal/updated",
+];
+export async function detectCodex(command = "codex", env) {
+    try {
+        const { stdout } = await execFileAsync(command, ["--version"], { env, timeout: 10_000 });
+        return stdout.trim().replace(/^codex-cli\s+/, "") || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Owns one `codex app-server --listen unix://…` process and a client connection
+ * to it. The same socket is what `codex --remote` attaches the desktop TUI to,
+ * so the TUI and LinkShell are peers on the same threads.
+ *
+ * The socket speaks WebSocket; permessage-deflate must be off or the upgrade is reset.
+ */
+export class CodexAppServer {
+    options;
+    child;
+    socket;
+    peer;
+    stopping = false;
+    constructor(options) {
+        this.options = options;
+    }
+    get socketPath() {
+        return this.options.socketPath;
+    }
+    async start() {
+        this.stopping = false;
+        if (existsSync(this.options.socketPath))
+            rmSync(this.options.socketPath, { force: true });
+        const child = spawn(this.options.command ?? "codex", ["app-server", "--listen", `unix://${this.options.socketPath}`], { env: this.options.env, stdio: ["ignore", "pipe", "pipe"] });
+        this.child = child;
+        let stderrTail = "";
+        child.stderr?.on("data", (chunk) => {
+            stderrTail = (stderrTail + chunk.toString()).slice(-2000);
+        });
+        child.stdout?.on("data", () => { });
+        const exited = new Promise((_, reject) => {
+            child.once("exit", (code, signal) => {
+                const reason = `codex app-server exited (${signal ?? code})${stderrTail ? `: ${stderrTail.trim()}` : ""}`;
+                if (!this.stopping)
+                    this.options.onDown(reason);
+                reject(new Error(reason));
+            });
+            child.once("error", (error) => reject(error));
+        });
+        exited.catch(() => { });
+        await Promise.race([this.connectWhenReady(), exited]);
+    }
+    async stop() {
+        this.stopping = true;
+        this.peer?.close("stopping");
+        this.socket?.close();
+        const child = this.child;
+        this.child = undefined;
+        if (child && child.exitCode === null) {
+            child.kill("SIGTERM");
+            await new Promise((resolve) => {
+                const timer = setTimeout(() => {
+                    child.kill("SIGKILL");
+                    resolve();
+                }, 3000);
+                child.once("exit", () => {
+                    clearTimeout(timer);
+                    resolve();
+                });
+            });
+        }
+        rmSync(this.options.socketPath, { force: true });
+    }
+    request(method, params, timeoutMs) {
+        if (!this.peer)
+            return Promise.reject(new Error("codex app-server is not connected"));
+        return this.peer.request(method, params, timeoutMs);
+    }
+    async connectWhenReady() {
+        const deadline = Date.now() + 15_000;
+        let lastError;
+        while (Date.now() < deadline) {
+            if (existsSync(this.options.socketPath)) {
+                try {
+                    await this.connect();
+                    return;
+                }
+                catch (error) {
+                    lastError = error;
+                }
+            }
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+        throw new Error(`codex app-server did not accept connections: ${lastError instanceof Error ? lastError.message : "timeout"}`);
+    }
+    async connect() {
+        const socket = new WebSocket(`ws+unix://${this.options.socketPath}:/`, { perMessageDeflate: false });
+        await new Promise((resolve, reject) => {
+            socket.once("open", () => resolve());
+            socket.once("error", reject);
+        });
+        const peer = new RpcPeer({
+            send: (text) => socket.send(text),
+            onNotification: (method, params) => this.options.onNotification(method, params),
+            onRequest: (method, params, id) => this.options.onRequest(method, params, id) ?? ABANDON,
+            requestTimeoutMs: 60_000,
+        });
+        socket.on("message", (data) => peer.receive(data.toString()));
+        socket.on("close", () => {
+            peer.close("codex app-server connection closed");
+            if (!this.stopping)
+                this.options.onDown("codex app-server connection closed");
+        });
+        this.socket = socket;
+        this.peer = peer;
+        await peer.request("initialize", {
+            clientInfo: { name: "linkshell", title: "LinkShell", version: this.options.clientVersion },
+            capabilities: { experimentalApi: false, requestAttestation: false, optOutNotificationMethods: OPT_OUT_NOTIFICATIONS },
+        });
+        peer.notify("initialized", {});
+    }
+}
+//# sourceMappingURL=app-server.js.map

package/dist/host/src/drivers/codex/app-server.js.map

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

package/dist/host/src/drivers/codex/driver.d.ts

@@ -0,0 +1,89 @@
+import { type ContentBlock } from "@linkshell/wire";
+import type { AgentAuth } from "@linkshell/wire";
+import type { AgentDriver, DiscoveredSession, DriverHost, DriverStatus, HistoryItem, LaunchSpec } from "../types.js";
+export interface CodexDriverOptions {
+    socketPath: string;
+    command?: string;
+    env?: NodeJS.ProcessEnv;
+    hostVersion: string;
+    /** Delay before restarting a crashed app-server; doubles up to 30s. */
+    restartDelayMs?: number;
+}
+/**
+ * Codex, tier multi_client: LinkShell and the desktop TUI (`codex --remote`)
+ * are both clients of one app-server, so every thread is live on both sides.
+ */
+export declare class CodexDriver implements AgentDriver {
+    private readonly options;
+    readonly id = "codex";
+    readonly label = "Codex";
+    readonly tier: "multi_client";
+    readonly capabilities: {
+        interrupt: boolean;
+        steer: boolean;
+        permissions: boolean;
+        images: boolean;
+        fork: boolean;
+        models: boolean;
+        modes: boolean;
+    };
+    private host?;
+    private server?;
+    private current;
+    private readonly threads;
+    private readonly attached;
+    /** Threads this connection started: already subscribed, and not on disk until their first turn. */
+    private readonly startedHere;
+    private readonly followRetries;
+    private readonly startsInFlight;
+    private readonly approvals;
+    private readonly settings;
+    private readonly overrides;
+    /** Sub-agent thread → the parent thread and the spawnAgent call its work nests under. */
+    private readonly children;
+    /** Threads Codex reported as sub-agents (parentThreadId set); never shown as sessions. */
+    private readonly subThreads;
+    private models?;
+    private restartTimer?;
+    private restartDelay;
+    private stopped;
+    constructor(options: CodexDriverOptions);
+    status(): DriverStatus;
+    start(host: DriverHost): Promise<DriverStatus>;
+    authStatus(): Promise<AgentAuth>;
+    stop(): Promise<void>;
+    listSessions(limit: number): Promise<DiscoveredSession[]>;
+    createSession(options: {
+        cwd: string;
+        model?: string;
+    }): Promise<DiscoveredSession>;
+    attach(nativeId: string): Promise<HistoryItem[]>;
+    /** Nests each sub-agent's own history right after the call that spawned it. */
+    private withSubAgents;
+    detach(nativeId: string): Promise<void>;
+    prompt(nativeId: string, content: ContentBlock[], clientMessageId: string): Promise<"started" | "steered">;
+    /** Model, reasoning effort and permissions apply from the next turn on. */
+    setConfig(nativeId: string, optionId: string, value: string): Promise<void>;
+    private loadModels;
+    private announceConfig;
+    cancel(nativeId: string): Promise<void>;
+    respondPermission(nativeId: string, requestId: string, optionId: string): Promise<void>;
+    desktopLaunch(args: string[], nativeId?: string): LaunchSpec;
+    private boot;
+    /** Follows every thread already live in the app-server (e.g. opened in the TUI). */
+    private reattachLoaded;
+    /**
+     * Asks the host to follow a thread another client opened. A brand-new thread
+     * has no rollout on disk until its first turn, so thread/resume fails until
+     * then; keep retrying while the thread stays loaded.
+     */
+    private follow;
+    private onDown;
+    private scheduleRestart;
+    private stateOf;
+    private onNotification;
+    /** Remembers which spawnAgent call each new sub-agent thread belongs to. */
+    private noteSpawns;
+    private onServerRequest;
+    private rpc;
+}