@agentqueue/worker 0.0.0 → 0.3.1-ci.g02c90ca5cd192c5a75a7d1d19329683cefb22d6e

package/dist/src/app-server/index.js

@@ -0,0 +1,319 @@
+import { StdioTransport, WebSocketTransport, frameLimit, stdioRedactions, } from "./transports.js";
+export function codexServiceTier(fastMode) {
+    return { serviceTier: fastMode ? "priority" : "default" };
+}
+export class CodexRpcError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = "CodexRpcError";
+        this.code = code;
+    }
+}
+export class CodexTransportError extends Error {
+    kind;
+    constructor(kind, message) {
+        super(message);
+        this.name = "CodexTransportError";
+        this.kind = kind;
+    }
+}
+function validateOptions(options) {
+    frameLimit(options.maxFrameBytes);
+    for (const [name, value] of Object.entries({
+        maxPendingRequests: options.maxPendingRequests ?? 1024,
+        maxQueuedBytes: options.maxQueuedBytes ?? 32 * 1024 * 1024,
+        requestTimeoutMs: options.requestTimeoutMs ?? 120000,
+    })) {
+        if (!Number.isSafeInteger(value) || value < (name === "requestTimeoutMs" ? 0 : 1))
+            throw new Error(`Invalid ${name}`);
+    }
+}
+export class CodexAppServerClient {
+    pending = new Map();
+    serverRequests = new Set();
+    threadTails = new Map();
+    secrets = new Set();
+    maxFrameBytes;
+    maxPending;
+    maxQueuedBytes;
+    timeoutMs;
+    nextId = 1;
+    queuedBytes = 0;
+    inboundBytes = 0;
+    callbacks = 0;
+    writeTail = Promise.resolve();
+    eventTail = Promise.resolve();
+    closed = false;
+    closeError = null;
+    closing;
+    transport;
+    options;
+    constructor(transport, options = {}) {
+        this.transport = transport;
+        this.options = options;
+        this.maxFrameBytes = frameLimit(options.maxFrameBytes);
+        this.maxPending = options.maxPendingRequests ?? 1024;
+        this.maxQueuedBytes = options.maxQueuedBytes ?? 32 * 1024 * 1024;
+        this.timeoutMs = options.requestTimeoutMs ?? 120000;
+        validateOptions(options);
+        this.addRedactions(options.redactValues ?? []);
+        transport.listen((frame) => this.receiveFrame(frame), (error) => this.fail("transport", error.message));
+    }
+    addRedactions(values) {
+        for (const value of values)
+            if (value)
+                this.secrets.add(value);
+    }
+    error() {
+        return this.closeError;
+    }
+    async drainNotifications() {
+        for (;;) {
+            const pending = this.eventTail;
+            await pending;
+            if (pending === this.eventTail)
+                break;
+        }
+        if (this.closeError)
+            throw this.closeError;
+    }
+    async initialize() {
+        await this.request("initialize", {
+            clientInfo: { name: "qm", title: "Agent Queue", version: "1" },
+            capabilities: { experimentalApi: true },
+        });
+        await this.notify("initialized");
+    }
+    request(method, params, options = {}) {
+        if (this.closed)
+            return Promise.reject(this.closeError ?? new CodexTransportError("closed", "Codex app-server is closed"));
+        if (options.signal?.aborted)
+            return Promise.reject(new CodexTransportError("closed", "Codex request was aborted"));
+        if (this.pending.size >= this.maxPending)
+            return Promise.reject(new CodexTransportError("limit", "Too many pending Codex requests"));
+        const timeoutMs = options.timeoutMs ?? this.timeoutMs;
+        if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 0)
+            return Promise.reject(new Error("Invalid request timeout"));
+        const id = this.nextId++;
+        const promise = new Promise((resolve, reject) => {
+            let timer;
+            const abort = () => this.fail("closed", "Codex request was aborted; its remote outcome may be unknown");
+            const cleanup = () => {
+                clearTimeout(timer);
+                options.signal?.removeEventListener("abort", abort);
+            };
+            this.pending.set(id, { resolve: (value) => resolve(value), reject, cleanup });
+            if (timeoutMs) {
+                timer = setTimeout(() => this.fail("timeout", "Codex request timed out; its remote outcome may be unknown"), timeoutMs);
+                timer.unref();
+            }
+            options.signal?.addEventListener("abort", abort, { once: true });
+        });
+        void this.send({ id, method, ...(params === undefined ? {} : { params }) }).catch((error) => this.fail("transport", error instanceof Error ? error.message : "Codex request write failed"));
+        return promise;
+    }
+    notify(method, params) {
+        return this.send({ method, ...(params === undefined ? {} : { params }) });
+    }
+    close() {
+        if (!this.closing) {
+            this.closed = true;
+            this.rejectPending(new CodexTransportError("closed", "Codex app-server is closed"));
+            this.serverRequests.clear();
+            this.threadTails.clear();
+            this.inboundBytes = 0;
+            this.closing = this.transport.close();
+        }
+        return this.closing;
+    }
+    receiveFrame(frame) {
+        if (this.closed || !frame.trim())
+            return;
+        const bytes = Buffer.byteLength(frame);
+        if (bytes > this.maxFrameBytes)
+            return this.fail("limit", "Codex app-server frame exceeds the byte limit");
+        let message;
+        try {
+            const parsed = JSON.parse(frame);
+            if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+                throw new Error();
+            message = parsed;
+            if (message.id !== undefined &&
+                !(typeof message.id === "string" || (typeof message.id === "number" && Number.isSafeInteger(message.id))))
+                throw new Error();
+            if (message.method !== undefined) {
+                if (typeof message.method !== "string" ||
+                    !message.method ||
+                    Object.hasOwn(message, "result") ||
+                    Object.hasOwn(message, "error"))
+                    throw new Error();
+            }
+            else {
+                if (message.id === undefined || Object.hasOwn(message, "result") === Object.hasOwn(message, "error"))
+                    throw new Error();
+                if (Object.hasOwn(message, "error") &&
+                    (!message.error ||
+                        typeof message.error !== "object" ||
+                        !Number.isInteger(message.error.code) ||
+                        typeof message.error.message !== "string"))
+                    throw new Error();
+            }
+        }
+        catch {
+            return this.fail("protocol", "Codex app-server emitted invalid JSON-RPC");
+        }
+        if (message.method === undefined) {
+            const waiter = this.pending.get(message.id);
+            if (!waiter)
+                return;
+            this.pending.delete(message.id);
+            waiter.cleanup();
+            if (message.error)
+                waiter.reject(new CodexRpcError(this.redact(`Codex ${message.error.code}: ${message.error.message}`), message.error.code));
+            else
+                waiter.resolve(message.result);
+            return;
+        }
+        if (message.id !== undefined) {
+            if (this.serverRequests.has(message.id))
+                return this.fail("protocol", "Codex reused an outstanding server request ID");
+            if (this.serverRequests.size >= this.maxPending)
+                return this.fail("limit", "Too many pending Codex server requests");
+            this.serverRequests.add(message.id);
+        }
+        if (this.inboundBytes + bytes > this.maxQueuedBytes)
+            return this.fail("limit", "Codex inbound callback queue exceeds its byte limit");
+        this.inboundBytes += bytes;
+        let released = false;
+        const release = () => {
+            if (released)
+                return;
+            released = true;
+            this.inboundBytes = Math.max(0, this.inboundBytes - bytes);
+        };
+        if (++this.callbacks > this.maxPending)
+            return this.fail("limit", "Codex notification queue exceeded its limit");
+        this.eventTail = this.eventTail
+            .then(async () => {
+            if (this.closed)
+                return;
+            if (message.id === undefined)
+                await this.options.onNotification?.(message.method, message.params);
+            else
+                this.queueRequest(message, release);
+        })
+            .catch((error) => this.fail("protocol", error instanceof Error ? error.message : "Codex callback failed"))
+            .finally(() => {
+            this.callbacks--;
+            if (message.id === undefined || this.closed)
+                release();
+        });
+    }
+    queueRequest(message, release) {
+        const threadId = message.params?.threadId;
+        const key = typeof threadId === "string" ? threadId : "";
+        const prior = this.threadTails.get(key) ?? Promise.resolve();
+        const run = prior
+            .then(async () => {
+            if (this.closed)
+                return;
+            if (!this.options.onRequest) {
+                await this.send({ id: message.id, error: { code: -32601, message: "Unsupported Codex server request" } });
+                return;
+            }
+            try {
+                const result = await this.options.onRequest(message.method, message.params);
+                await this.send({ id: message.id, result: result ?? null });
+            }
+            catch (error) {
+                if (!this.closed)
+                    await this.send({
+                        id: message.id,
+                        error: {
+                            code: -32000,
+                            message: this.redact(error instanceof Error ? error.message : "Codex request handler failed"),
+                        },
+                    });
+            }
+        })
+            .catch((error) => this.fail("transport", error instanceof Error ? error.message : "Codex answer write failed"))
+            .finally(() => {
+            release();
+            this.serverRequests.delete(message.id);
+            if (this.threadTails.get(key) === run)
+                this.threadTails.delete(key);
+        });
+        this.threadTails.set(key, run);
+    }
+    send(message) {
+        if (this.closed)
+            return Promise.reject(this.closeError ?? new CodexTransportError("closed", "Codex app-server is closed"));
+        let frame;
+        try {
+            frame = JSON.stringify(message);
+        }
+        catch {
+            return Promise.reject(new CodexTransportError("protocol", "Codex request is not JSON serializable"));
+        }
+        const bytes = Buffer.byteLength(frame);
+        if (bytes > this.maxFrameBytes || this.queuedBytes + bytes > this.maxQueuedBytes)
+            return Promise.reject(new CodexTransportError("limit", "Codex outgoing frame or write queue exceeds its byte limit"));
+        this.queuedBytes += bytes;
+        const operation = this.writeTail
+            .then(async () => {
+            if (this.closed)
+                throw this.closeError ?? new CodexTransportError("closed", "Codex app-server is closed");
+            await this.transport.write(frame);
+        })
+            .finally(() => {
+            this.queuedBytes -= bytes;
+        });
+        this.writeTail = operation.catch(() => { });
+        return operation;
+    }
+    redact(text) {
+        for (const secret of this.secrets)
+            text = text.replaceAll(secret, "[redacted]");
+        return text;
+    }
+    rejectPending(error) {
+        for (const waiter of this.pending.values()) {
+            waiter.cleanup();
+            waiter.reject(error);
+        }
+        this.pending.clear();
+    }
+    fail(kind, message) {
+        if (this.closed)
+            return;
+        this.closeError = new CodexTransportError(kind, this.redact(message));
+        this.rejectPending(this.closeError);
+        void this.close().catch(() => { });
+    }
+}
+export class CodexAppServer extends CodexAppServerClient {
+    process;
+    constructor(options) {
+        validateOptions(options);
+        const transport = new StdioTransport(options);
+        super(transport, options);
+        this.process = transport.process;
+        this.addRedactions(stdioRedactions(options));
+    }
+}
+export async function connectCodexAppServer(options) {
+    validateOptions(options);
+    const transport = new WebSocketTransport(options);
+    const client = new CodexAppServerClient(transport, options);
+    client.addRedactions(Object.values(options.headers ?? {}).flatMap((value) => [value, value.replace(/^Bearer\s+/i, "")]));
+    try {
+        await transport.ready;
+    }
+    catch {
+        await client.close();
+        throw new CodexTransportError("transport", "Codex App Server WebSocket connection failed");
+    }
+    return client;
+}
+//# sourceMappingURL=index.js.map

package/dist/src/app-server/index.js.map

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

package/dist/src/app-server/native-checkpoint.d.ts

@@ -0,0 +1,12 @@
+import type { CodexAppServerClient } from "./index.ts";
+export interface NativeThreadLink {
+    threadId: string;
+    parentThreadId: string | null;
+}
+type NativeClient = Pick<CodexAppServerClient, "request">;
+export declare class NativeCheckpointPending extends Error {
+    constructor();
+}
+export declare function quiesceNativeCheckpoint(client: NativeClient, rootThreadId: string): Promise<NativeThreadLink[]>;
+export declare function verifyNativeCheckpoint(client: NativeClient, rootThreadId: string, expected: readonly NativeThreadLink[]): Promise<void>;
+export {};

package/dist/src/app-server/native-checkpoint.js

@@ -0,0 +1,179 @@
+const sourceKinds = [
+    "cli",
+    "vscode",
+    "exec",
+    "appServer",
+    "subAgent",
+    "subAgentReview",
+    "subAgentCompact",
+    "subAgentThreadSpawn",
+    "subAgentOther",
+    "unknown",
+];
+async function nativeThreads(client, archived) {
+    const threads = [];
+    const cursors = new Set();
+    let cursor = null;
+    do {
+        const page = await client.request("thread/list", {
+            archived,
+            modelProviders: [],
+            sourceKinds,
+            limit: 100,
+            cursor,
+        });
+        if (!Array.isArray(page.data) || threads.length + page.data.length > 4096)
+            throw new Error("native thread inventory exceeds qualified boundary");
+        threads.push(...page.data);
+        cursor = page.nextCursor ?? null;
+        if (cursor !== null && (typeof cursor !== "string" || cursors.has(cursor)))
+            throw new Error("native thread cursor repeated");
+        if (cursor !== null)
+            cursors.add(cursor);
+    } while (cursor !== null);
+    return threads;
+}
+function nativeGraph(threads, rootId) {
+    const ids = new Set(threads.map((thread) => thread.id));
+    if (ids.size !== threads.length || !ids.has(rootId))
+        throw new Error("native thread inventory is incomplete");
+    const links = threads.map((thread) => ({
+        threadId: thread.id,
+        parentThreadId: thread.parentThreadId ?? thread.forkedFromId ?? null,
+    }));
+    if (links.filter((link) => link.parentThreadId === null).length !== 1 ||
+        !links.some((link) => link.threadId === rootId && link.parentThreadId === null))
+        throw new Error("native conversation has foreign roots");
+    const reached = new Set([rootId]);
+    for (let index = 0; index < links.length; index++) {
+        const before = reached.size;
+        for (const link of links)
+            if (link.parentThreadId !== null && reached.has(link.parentThreadId))
+                reached.add(link.threadId);
+        if (before === reached.size)
+            break;
+    }
+    if (reached.size !== links.length)
+        throw new Error("native conversation graph is disconnected");
+    return links.sort((a, b) => a.threadId.localeCompare(b.threadId));
+}
+async function loadedNativeIds(client) {
+    const result = [], cursors = new Set();
+    let cursor = null;
+    do {
+        const page = await client.request("thread/loaded/list", {
+            cursor,
+            limit: 100,
+        });
+        if (!Array.isArray(page.data) ||
+            page.data.some((id) => typeof id !== "string" || result.includes(id)) ||
+            result.length + page.data.length > 4096)
+            throw new Error("invalid loaded native inventory");
+        result.push(...page.data);
+        cursor = page.nextCursor ?? null;
+        if (cursor !== null && (typeof cursor !== "string" || cursors.has(cursor)))
+            throw new Error("native loaded cursor repeated");
+        if (cursor !== null)
+            cursors.add(cursor);
+    } while (cursor !== null);
+    return result;
+}
+async function nativeInventory(client) {
+    const active = await nativeThreads(client, false), archived = await nativeThreads(client, true);
+    const threads = [...active, ...archived];
+    for (const id of await loadedNativeIds(client))
+        if (!threads.some((thread) => thread.id === id)) {
+            const { thread } = await client.request("thread/read", {
+                threadId: id,
+                includeTurns: false,
+            });
+            if (!thread || thread.id !== id)
+                throw new Error("unexpected native threads remain loaded");
+            active.push(thread);
+            threads.push(thread);
+        }
+    for (const item of threads) {
+        const { thread } = await client.request("thread/read", {
+            threadId: item.id,
+            includeTurns: false,
+        });
+        if (!thread || thread.id !== item.id)
+            throw new Error("native thread identity changed");
+        const listedParent = item.parentThreadId ?? item.forkedFromId ?? null;
+        const readParent = thread.parentThreadId ?? thread.forkedFromId ?? null;
+        if (listedParent !== null && readParent !== null && listedParent !== readParent)
+            throw new Error("native thread identity changed");
+        Object.assign(item, thread, { parentThreadId: readParent ?? listedParent, forkedFromId: null });
+    }
+    return { active, archived, threads };
+}
+export class NativeCheckpointPending extends Error {
+    constructor() {
+        super("native conversation tree is not quiescent");
+        this.name = "NativeCheckpointPending";
+    }
+}
+export async function quiesceNativeCheckpoint(client, rootThreadId) {
+    const { active, threads: inventory } = await nativeInventory(client);
+    for (const thread of inventory)
+        if (thread.ephemeral)
+            throw new Error("ephemeral native state cannot be checkpointed");
+        else if (!["idle", "notLoaded"].includes(thread.status.type))
+            throw new NativeCheckpointPending();
+    const graph = nativeGraph(inventory, rootThreadId);
+    const parents = new Map(graph.map((link) => [link.threadId, link.parentThreadId]));
+    const depth = (id) => {
+        let count = 0, parent = parents.get(id);
+        while (parent) {
+            count++;
+            parent = parents.get(parent);
+        }
+        return count;
+    };
+    const leavesFirst = [...graph].sort((a, b) => depth(b.threadId) - depth(a.threadId));
+    for (const link of leavesFirst)
+        if (active.some((thread) => thread.id === link.threadId))
+            await client.request("thread/archive", { threadId: link.threadId });
+    const { active: remaining, threads: retained } = await nativeInventory(client);
+    if (remaining.length || JSON.stringify(nativeGraph(retained, rootThreadId)) !== JSON.stringify(graph))
+        throw new Error("native archive boundary changed");
+    let cursor = null;
+    const cursors = new Set();
+    do {
+        const loaded = await client.request("thread/loaded/list", {
+            cursor,
+            limit: 100,
+        });
+        if (!Array.isArray(loaded.data) || loaded.data.some((id) => !parents.has(id)))
+            throw new Error("unexpected native threads remain loaded");
+        for (const id of loaded.data) {
+            const { thread } = await client.request("thread/read", {
+                threadId: id,
+                includeTurns: false,
+            });
+            if (thread.id !== id || !["idle", "notLoaded"].includes(thread.status.type))
+                throw new Error("native thread resumed during quiescence");
+        }
+        cursor = loaded.nextCursor ?? null;
+        if (cursor !== null && (typeof cursor !== "string" || cursors.has(cursor)))
+            throw new Error("native loaded cursor repeated");
+        if (cursor !== null)
+            cursors.add(cursor);
+    } while (cursor !== null);
+    return graph;
+}
+export async function verifyNativeCheckpoint(client, rootThreadId, expected) {
+    const { threads } = await nativeInventory(client);
+    const graph = nativeGraph(threads, rootThreadId);
+    if (JSON.stringify(graph) !== JSON.stringify([...expected].sort((a, b) => a.threadId.localeCompare(b.threadId))))
+        throw new Error("restored native tree differs from committed checkpoint");
+    for (const link of graph) {
+        const { thread } = await client.request("thread/read", {
+            threadId: link.threadId,
+            includeTurns: false,
+        });
+        if (thread.id !== link.threadId || thread.ephemeral || !["idle", "notLoaded"].includes(thread.status.type))
+            throw new Error("restored native identity unavailable");
+    }
+}
+//# sourceMappingURL=native-checkpoint.js.map

package/dist/src/app-server/native-checkpoint.js.map

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

package/dist/src/app-server/process-group.d.ts

@@ -0,0 +1,6 @@
+import { type ChildProcess, type SpawnOptions } from "node:child_process";
+export declare function spawnProcessGroup(command: string, args: string[], options: SpawnOptions, termination?: {
+    graceMs?: number;
+    killMs?: number;
+}): ChildProcess;
+export declare function closeProcessGroup(child: ChildProcess, graceMs?: number, killMs?: number): Promise<void>;