cyrus-codex-runner 0.2.64-test.6 → 0.2.64

package/dist/backend/AppServerCodexBackend.js

@@ -0,0 +1,352 @@
+import { EventEmitter } from "node:events";
+import { translateAppServerItem, } from "./appServerEvents.js";
+import { AppServerProcessManager, defaultAppServerProcessManager, } from "./appServerProcess.js";
+/**
+ * Backend that drives one Codex app-server thread over the process-wide shared
+ * JSON-RPC connection. The app-server process is shared; this class owns only
+ * per-thread state and supports injecting input into an active turn via
+ * `turn/steer` ({@link supportsSteer} is true).
+ */
+export class AppServerCodexBackend extends EventEmitter {
+    supportsSteer = true;
+    appServer = null;
+    threadId = null;
+    activeTurnId = null;
+    turnActive = false;
+    lastUsage = {
+        input_tokens: 0,
+        output_tokens: 0,
+        cached_input_tokens: 0,
+    };
+    /** Structured-output schema for turns, captured at open() for turn/start. */
+    outputSchema;
+    /** Resolver for the in-flight {@link runTurn} promise. */
+    turnResolve = null;
+    turnReject = null;
+    /** Watchdog: fails a turn that goes fully silent for too long. */
+    idleTimer = null;
+    turnIdleTimeoutMs;
+    processManager;
+    threadHandler = {
+        onNotification: (method, params) => this.onNotification(method, params),
+        onProcessGone: () => this.onProcessGone(),
+        onProcessError: (error) => this.onProcessError(error),
+    };
+    /**
+     * @param processManagerOrFactory Overridable shared process manager. Tests may
+     * still pass the older client factory shape; it is wrapped in an isolated
+     * manager for compatibility.
+     * @param options.turnIdleTimeoutMs Fail an in-flight turn if the app-server
+     * emits no notifications for this long (default 5min; Codex streams
+     * continuously, so prolonged silence means a wedged turn). 0 disables it.
+     * @param options.requestTimeoutMs Forwarded when wrapping a test client factory.
+     */
+    constructor(processManagerOrFactory = defaultAppServerProcessManager, options) {
+        super();
+        this.processManager =
+            typeof processManagerOrFactory === "function"
+                ? new AppServerProcessManager(processManagerOrFactory, {
+                    ...(options?.requestTimeoutMs !== undefined
+                        ? { requestTimeoutMs: options.requestTimeoutMs }
+                        : {}),
+                    idleCloseMs: 0,
+                })
+                : processManagerOrFactory;
+        this.turnIdleTimeoutMs = options?.turnIdleTimeoutMs ?? 300_000;
+    }
+    async open(config) {
+        this.outputSchema = config.outputSchema;
+        const appServer = await this.processManager.acquire(config);
+        this.appServer = appServer;
+        try {
+            const threadId = config.resumeSessionId
+                ? await this.resumeThread(config)
+                : await this.startThread(config);
+            this.threadId = threadId;
+            appServer.registerThread(threadId, this.threadHandler);
+            this.emit("event", { kind: "thread-started", threadId });
+            return { threadId };
+        }
+        catch (error) {
+            this.appServer = null;
+            appServer.release();
+            throw error;
+        }
+    }
+    async runTurn(input) {
+        if (!this.appServer || !this.threadId) {
+            throw new Error("AppServerCodexBackend.runTurn called before open()");
+        }
+        const turnPromise = new Promise((resolve, reject) => {
+            this.turnResolve = resolve;
+            this.turnReject = reject;
+        });
+        this.turnActive = true;
+        this.armIdleWatchdog();
+        try {
+            const result = await this.appServer.request("turn/start", {
+                threadId: this.threadId,
+                input: this.toProtocolInput(input),
+                ...(this.outputSchema !== undefined
+                    ? { outputSchema: this.outputSchema }
+                    : {}),
+            });
+            this.activeTurnId = result?.turn?.id ?? this.activeTurnId;
+            // NOTE: the turn is not steerable the instant turn/start returns — the
+            // server only accepts turn/steer once it has emitted the `turn/started`
+            // notification. The runner is signalled to flush buffered follow-ups
+            // from that notification handler, not here.
+        }
+        catch (error) {
+            this.turnActive = false;
+            this.turnResolve = null;
+            this.turnReject = null;
+            throw error;
+        }
+        await turnPromise;
+    }
+    async steer(input) {
+        if (!this.appServer || !this.threadId) {
+            throw new Error("AppServerCodexBackend.steer called before open()");
+        }
+        if (!this.turnActive || !this.activeTurnId) {
+            throw new Error("Cannot steer: no active turn");
+        }
+        await this.appServer.request("turn/steer", {
+            threadId: this.threadId,
+            expectedTurnId: this.activeTurnId,
+            input: this.toProtocolInput(input),
+        });
+    }
+    isTurnActive() {
+        // A turn is steerable only once turn/start has returned its id — during
+        // the brief turn/start request itself, turnActive is true but there is no
+        // id to target yet.
+        return this.turnActive && this.activeTurnId !== null;
+    }
+    async interrupt() {
+        if (!this.appServer || !this.threadId || !this.activeTurnId) {
+            return;
+        }
+        try {
+            await this.appServer.request("turn/interrupt", {
+                threadId: this.threadId,
+                turnId: this.activeTurnId,
+            });
+        }
+        catch {
+            // Interrupt is best-effort; the turn may already have ended.
+        }
+    }
+    async close() {
+        const appServer = this.appServer;
+        const threadId = this.threadId;
+        const turnId = this.activeTurnId;
+        this.appServer = null;
+        this.threadId = null;
+        this.activeTurnId = null;
+        if (appServer && threadId && turnId) {
+            void appServer
+                .request("turn/interrupt", { threadId, turnId })
+                .catch(() => undefined);
+        }
+        if (appServer && threadId) {
+            appServer.unregisterThread(threadId, this.threadHandler);
+        }
+        this.settleTurn(new Error("app-server backend closed"));
+        appServer?.release();
+    }
+    // ---- Thread setup -------------------------------------------------------
+    async startThread(config) {
+        const result = await this.appServer?.request("thread/start", this.threadOptionsParams(config));
+        const id = result?.thread?.id;
+        if (!id) {
+            throw new Error("thread/start did not return a thread id");
+        }
+        return id;
+    }
+    async resumeThread(config) {
+        const result = await this.appServer?.request("thread/resume", {
+            threadId: config.resumeSessionId,
+            ...this.threadOptionsParams(config),
+        });
+        // Resuming returns the same id we asked for; fall back to it defensively.
+        return result?.thread?.id ?? config.resumeSessionId ?? "";
+    }
+    threadOptionsParams(config) {
+        const sandbox = config.sandbox;
+        // `sandbox` (coarse mode) and `permissions` (named profile) are mutually
+        // exclusive on thread/start; pick exactly one based on the resolved arm.
+        const sandboxParams = sandbox.kind === "profile"
+            ? { permissions: sandbox.profileId }
+            : { sandbox: sandbox.mode };
+        return {
+            ...(config.workingDirectory ? { cwd: config.workingDirectory } : {}),
+            approvalPolicy: config.approvalPolicy,
+            ...sandboxParams,
+            ...(config.model ? { model: config.model } : {}),
+            ...(config.developerInstructions
+                ? { developerInstructions: config.developerInstructions }
+                : {}),
+            config: this.buildThreadConfig(config),
+        };
+    }
+    /**
+     * Build the free-form Codex `config` for thread/start. The app-server has no
+     * `--add-dir` flag, so:
+     * - `workspace-mode`: writable roots + network ride on `sandbox_workspace_write`
+     *   (only meaningful in workspace-write mode; omitted otherwise).
+     * - `profile`: the granular permission profile body is registered under
+     *   `permissions.<id>` and selected via the `permissions` thread param.
+     * MCP servers etc. ride along in configOverrides.
+     */
+    buildThreadConfig(config) {
+        const base = config.configOverrides
+            ? { ...config.configOverrides }
+            : {};
+        const sandbox = config.sandbox;
+        if (sandbox.kind === "profile") {
+            base.permissions = {
+                [sandbox.profileId]: {
+                    filesystem: { ...sandbox.filesystem },
+                    network: { enabled: sandbox.networkAccess },
+                },
+            };
+        }
+        else if (sandbox.mode === "workspace-write") {
+            base.sandbox_workspace_write = {
+                network_access: sandbox.networkAccess,
+                ...(sandbox.writableRoots.length > 0
+                    ? { writable_roots: [...sandbox.writableRoots] }
+                    : {}),
+            };
+        }
+        return base;
+    }
+    toProtocolInput(input) {
+        return input.map((item) => item.type === "text"
+            ? { type: "text", text: item.text }
+            : { type: "localImage", path: item.path });
+    }
+    // ---- Notification / request handling ------------------------------------
+    onNotification(method, params) {
+        // Any notification is a sign of life — reset the idle watchdog.
+        if (this.turnActive) {
+            this.armIdleWatchdog();
+        }
+        const p = (params ?? {});
+        switch (method) {
+            case "turn/started": {
+                // The server now accepts turn/steer for this turn. Capture the id
+                // (defensively) and signal the runner to flush buffered follow-ups.
+                const turn = p.turn;
+                if (turn?.id) {
+                    this.activeTurnId = turn.id;
+                }
+                this.emit("event", { kind: "turn-started" });
+                break;
+            }
+            case "item/started": {
+                const item = translateAppServerItem(p.item);
+                if (item)
+                    this.emit("event", { kind: "item-started", item });
+                break;
+            }
+            case "item/completed": {
+                const item = translateAppServerItem(p.item);
+                if (item)
+                    this.emit("event", { kind: "item-completed", item });
+                break;
+            }
+            case "thread/tokenUsage/updated": {
+                this.lastUsage = this.readUsage(p);
+                break;
+            }
+            case "turn/completed": {
+                this.onTurnCompleted(p);
+                break;
+            }
+            default:
+                // Other notifications (rate limits, mcp startup, warnings, deltas)
+                // are not needed for the current activity mapping.
+                break;
+        }
+    }
+    onTurnCompleted(params) {
+        const turn = (params.turn ?? {});
+        this.turnActive = false;
+        this.activeTurnId = null;
+        if (turn.status === "failed") {
+            const message = turn.error?.message || "Codex turn failed";
+            this.emit("event", { kind: "turn-failed", message });
+        }
+        else {
+            this.emit("event", { kind: "turn-completed", usage: this.lastUsage });
+        }
+        this.settleTurn();
+    }
+    readUsage(params) {
+        const total = (params.tokenUsage?.total ?? {});
+        return {
+            input_tokens: numberOr(total.inputTokens, this.lastUsage.input_tokens),
+            output_tokens: numberOr(total.outputTokens, this.lastUsage.output_tokens),
+            cached_input_tokens: numberOr(total.cachedInputTokens, this.lastUsage.cached_input_tokens),
+        };
+    }
+    onProcessGone() {
+        if (this.turnActive) {
+            this.emit("event", {
+                kind: "turn-failed",
+                message: "codex app-server exited before the turn completed",
+            });
+        }
+        this.settleTurn();
+    }
+    onProcessError(err) {
+        const message = err instanceof Error ? err.message : String(err);
+        this.emit("event", { kind: "error", message });
+    }
+    /** Resolve or reject the in-flight runTurn promise exactly once. */
+    settleTurn(error) {
+        this.clearIdleWatchdog();
+        const resolve = this.turnResolve;
+        const reject = this.turnReject;
+        this.turnResolve = null;
+        this.turnReject = null;
+        this.turnActive = false;
+        if (error && reject) {
+            reject(error);
+        }
+        else if (resolve) {
+            resolve();
+        }
+    }
+    /** (Re)start the idle watchdog for the current turn. */
+    armIdleWatchdog() {
+        if (this.turnIdleTimeoutMs <= 0) {
+            return;
+        }
+        this.clearIdleWatchdog();
+        this.idleTimer = setTimeout(() => {
+            if (!this.turnActive) {
+                return;
+            }
+            this.emit("event", {
+                kind: "turn-failed",
+                message: `codex app-server produced no activity for ${this.turnIdleTimeoutMs}ms`,
+            });
+            this.settleTurn();
+        }, this.turnIdleTimeoutMs);
+        this.idleTimer.unref?.();
+    }
+    clearIdleWatchdog() {
+        if (this.idleTimer) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = null;
+        }
+    }
+}
+function numberOr(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+//# sourceMappingURL=AppServerCodexBackend.js.map

package/dist/backend/AppServerCodexBackend.js.map

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

package/dist/backend/appServerClient.d.ts

@@ -0,0 +1,75 @@
+import { EventEmitter } from "node:events";
+/** Handles a server→client notification (no response expected). */
+export type NotificationHandler = (method: string, params: unknown) => void;
+/** Handles a server→client request; the returned value becomes the response. */
+export type ServerRequestHandler = (method: string, params: unknown) => unknown | Promise<unknown>;
+export interface AppServerClientOptions {
+    binaryPath: string;
+    args?: string[];
+    env?: Record<string, string>;
+    /** Optional logger; defaults to console. */
+    logger?: Pick<typeof console, "warn" | "error">;
+    /**
+     * Per-request timeout in milliseconds for control-plane calls
+     * (`initialize`, `thread/*`, `turn/start`, `turn/steer`, `turn/interrupt`).
+     * A wedged app-server then rejects the pending request instead of hanging
+     * the session forever. Defaults to 60s. Set to 0 to disable.
+     */
+    requestTimeoutMs?: number;
+}
+/**
+ * The slice of {@link AppServerClient} the backend depends on. Declaring it lets
+ * tests inject a fake transport without spawning a process (Dependency
+ * Inversion).
+ */
+export interface IAppServerClient {
+    setNotificationHandler(handler: NotificationHandler): void;
+    setServerRequestHandler(handler: ServerRequestHandler): void;
+    on(event: "exit", listener: (...args: unknown[]) => void): unknown;
+    on(event: "error", listener: (...args: unknown[]) => void): unknown;
+    on(event: string, listener: (...args: unknown[]) => void): unknown;
+    start(): void;
+    request<T = unknown>(method: string, params: unknown): Promise<T>;
+    close(): Promise<void>;
+}
+/** Factory used by the backend to create a client; overridable in tests. */
+export type AppServerClientFactory = (options: AppServerClientOptions) => IAppServerClient;
+/**
+ * Minimal JSON-RPC 2.0 client over a `codex app-server` child process speaking
+ * newline-delimited JSON on stdio. Single responsibility: framing + request
+ * correlation + dispatch of notifications/server-requests. Knows nothing about
+ * Codex semantics.
+ */
+export declare class AppServerClient extends EventEmitter {
+    private readonly options;
+    private child;
+    private rl;
+    private nextId;
+    private readonly pending;
+    private notificationHandler;
+    private serverRequestHandler;
+    private closed;
+    private readonly logger;
+    constructor(options: AppServerClientOptions);
+    setNotificationHandler(handler: NotificationHandler): void;
+    setServerRequestHandler(handler: ServerRequestHandler): void;
+    start(): void;
+    request<T = unknown>(method: string, params: unknown): Promise<T>;
+    /** Clear a pending request's timeout (called when settled). */
+    private settlePending;
+    notify(method: string, params: unknown): void;
+    close(): Promise<void>;
+    /**
+     * Terminate the child and any grandchildren. On POSIX the child was spawned
+     * `detached`, so it leads its own process group; signalling the negative pid
+     * reaps the whole group (the Node bin shim + the native codex binary) at
+     * once. Falls back to a direct kill if the group is already gone or on
+     * Windows (no process groups).
+     */
+    private terminateChild;
+    private write;
+    private onLine;
+    private handleServerRequest;
+    private failAllPending;
+}
+//# sourceMappingURL=appServerClient.d.ts.map

package/dist/backend/appServerClient.d.ts.map

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

package/dist/backend/appServerClient.js

@@ -0,0 +1,223 @@
+import { spawn } from "node:child_process";
+import { EventEmitter } from "node:events";
+import readline from "node:readline";
+/** Default control-plane request timeout. Turn execution is awaited separately
+ * (via notifications), so this only bounds quick request/response calls. */
+const DEFAULT_REQUEST_TIMEOUT_MS = 60_000;
+/**
+ * Minimal JSON-RPC 2.0 client over a `codex app-server` child process speaking
+ * newline-delimited JSON on stdio. Single responsibility: framing + request
+ * correlation + dispatch of notifications/server-requests. Knows nothing about
+ * Codex semantics.
+ */
+export class AppServerClient extends EventEmitter {
+    options;
+    child = null;
+    rl = null;
+    nextId = 1;
+    pending = new Map();
+    notificationHandler = null;
+    serverRequestHandler = null;
+    closed = false;
+    logger;
+    constructor(options) {
+        super();
+        this.options = options;
+        this.logger = options.logger ?? console;
+    }
+    setNotificationHandler(handler) {
+        this.notificationHandler = handler;
+    }
+    setServerRequestHandler(handler) {
+        this.serverRequestHandler = handler;
+    }
+    start() {
+        if (this.child) {
+            throw new Error("AppServerClient already started");
+        }
+        const args = this.options.args ?? ["app-server", "--listen", "stdio://"];
+        const child = spawn(this.options.binaryPath, args, {
+            stdio: ["pipe", "pipe", "pipe"],
+            // Run in its own process group (POSIX) so teardown can signal the whole
+            // tree at once. We launch codex via the `@openai/codex` Node bin shim,
+            // which spawns the native binary as a grandchild; killing only the shim
+            // would leave the native process to linger until its stdin pipe closes.
+            // Group-killing reaps both immediately. Not supported on Windows.
+            ...(process.platform !== "win32" ? { detached: true } : {}),
+            ...(this.options.env ? { env: this.options.env } : {}),
+        });
+        this.child = child;
+        child.once("error", (err) => {
+            this.failAllPending(err);
+            this.emit("error", err);
+        });
+        child.once("exit", (code, signal) => {
+            this.closed = true;
+            const reason = new Error(`codex app-server exited (code=${code ?? "null"}, signal=${signal ?? "null"})`);
+            this.failAllPending(reason);
+            this.emit("exit", code, signal);
+        });
+        child.stderr.on("data", (data) => {
+            const text = data.toString().trim();
+            if (text) {
+                this.emit("stderr", text);
+            }
+        });
+        this.rl = readline.createInterface({
+            input: child.stdout,
+            crlfDelay: Number.POSITIVE_INFINITY,
+        });
+        this.rl.on("line", (line) => this.onLine(line));
+    }
+    request(method, params) {
+        if (this.closed || !this.child) {
+            return Promise.reject(new Error(`Cannot send ${method}: app-server is not running`));
+        }
+        const id = this.nextId++;
+        const message = { jsonrpc: "2.0", id, method, params };
+        const timeoutMs = this.options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        return new Promise((resolve, reject) => {
+            const entry = {
+                resolve: resolve,
+                reject,
+                method,
+            };
+            if (timeoutMs > 0) {
+                entry.timer = setTimeout(() => {
+                    if (this.pending.delete(id)) {
+                        reject(new Error(`${method} timed out after ${timeoutMs}ms`));
+                    }
+                }, timeoutMs);
+                // Don't keep the event loop alive solely for this timer.
+                entry.timer.unref?.();
+            }
+            this.pending.set(id, entry);
+            this.write(message);
+        });
+    }
+    /** Clear a pending request's timeout (called when settled). */
+    settlePending(id) {
+        const entry = this.pending.get(id);
+        if (entry) {
+            this.pending.delete(id);
+            if (entry.timer) {
+                clearTimeout(entry.timer);
+            }
+        }
+        return entry;
+    }
+    notify(method, params) {
+        if (this.closed || !this.child) {
+            return;
+        }
+        this.write({ jsonrpc: "2.0", method, params });
+    }
+    async close() {
+        this.closed = true;
+        this.rl?.close();
+        this.rl = null;
+        const child = this.child;
+        this.child = null;
+        if (child && !child.killed) {
+            this.terminateChild(child);
+        }
+        this.failAllPending(new Error("app-server client closed"));
+    }
+    /**
+     * Terminate the child and any grandchildren. On POSIX the child was spawned
+     * `detached`, so it leads its own process group; signalling the negative pid
+     * reaps the whole group (the Node bin shim + the native codex binary) at
+     * once. Falls back to a direct kill if the group is already gone or on
+     * Windows (no process groups).
+     */
+    terminateChild(child) {
+        try {
+            if (process.platform !== "win32" && typeof child.pid === "number") {
+                process.kill(-child.pid, "SIGTERM");
+                return;
+            }
+        }
+        catch {
+            // Group already dead or unavailable — fall through to a direct kill.
+        }
+        try {
+            child.kill();
+        }
+        catch {
+            // best-effort
+        }
+    }
+    write(message) {
+        try {
+            this.child?.stdin.write(`${JSON.stringify(message)}\n`);
+        }
+        catch (err) {
+            this.logger.error("[AppServerClient] write failed", err);
+        }
+    }
+    onLine(line) {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            return;
+        }
+        let message;
+        try {
+            message = JSON.parse(trimmed);
+        }
+        catch {
+            this.logger.warn(`[AppServerClient] non-JSON line: ${trimmed.slice(0, 200)}`);
+            return;
+        }
+        // Response to a client request.
+        if (message.id !== undefined &&
+            (message.result !== undefined || message.error !== undefined)) {
+            const entry = this.settlePending(message.id);
+            if (!entry) {
+                return;
+            }
+            if (message.error) {
+                entry.reject(new Error(`${entry.method} failed: ${message.error.message ?? "unknown error"}`));
+            }
+            else {
+                entry.resolve(message.result);
+            }
+            return;
+        }
+        // Server→client request (expects a response).
+        if (message.id !== undefined && message.method) {
+            void this.handleServerRequest(message.id, message.method, message.params);
+            return;
+        }
+        // Notification.
+        if (message.method) {
+            try {
+                this.notificationHandler?.(message.method, message.params);
+            }
+            catch (err) {
+                this.logger.error(`[AppServerClient] notification handler threw for ${message.method}`, err);
+            }
+        }
+    }
+    async handleServerRequest(id, method, params) {
+        let result = {};
+        try {
+            if (this.serverRequestHandler) {
+                result = (await this.serverRequestHandler(method, params)) ?? {};
+            }
+        }
+        catch (err) {
+            this.logger.error(`[AppServerClient] server-request handler threw for ${method}`, err);
+        }
+        this.write({ jsonrpc: "2.0", id, result });
+    }
+    failAllPending(reason) {
+        for (const [, entry] of this.pending) {
+            if (entry.timer) {
+                clearTimeout(entry.timer);
+            }
+            entry.reject(reason);
+        }
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=appServerClient.js.map