codex-openai-proxy 0.1.0-rc.0

package/dist/continuation/state.d.ts

@@ -0,0 +1,71 @@
+import type { JsonRpcTransport, ServerRequest } from "../app-server/json-rpc.js";
+import { bindingHash, canonicalJson } from "../core/canonical.js";
+export { bindingHash, canonicalJson };
+/** Context that must remain identical over a Codex thread's lifetime. */
+export interface ThreadBinding {
+    model: string;
+    cwd: string;
+    toolsHash: string;
+    policyHash: string;
+}
+/** One opaque response-to-thread record persisted by the proxy. */
+export interface ResponseRecord extends ThreadBinding {
+    responseId: string;
+    threadId: string;
+    state: "ready" | "pending_tool" | "expired" | "superseded" | "corrupt";
+    createdAt: number;
+    expiresAt: number;
+    callIds?: string[];
+}
+/** Durable atomic response mapping store with bounded retention. */
+export declare class ResponseStore {
+    #private;
+    private readonly retentionMs;
+    private readonly temporaryPath;
+    constructor(directory: string, retentionMs?: number, temporaryPath?: (statePath: string) => string);
+    /** Retrieves a record after applying expiry and newest-response rules. */
+    get(responseId: string): ResponseRecord | undefined;
+    /** Inserts a record and supersedes the prior completed response for its thread. */
+    put(record: Omit<ResponseRecord, "createdAt" | "expiresAt">): ResponseRecord;
+    /** Changes an existing record without exposing partial disk writes. */
+    update(responseId: string, patch: Partial<ResponseRecord>): ResponseRecord | undefined;
+    /** Finds durable records containing every requested dynamic-tool call ID. */
+    findByCallIds(callIds: readonly string[]): ResponseRecord[];
+}
+/** In-memory responder for one suspended app-server dynamic tool call. */
+export interface PendingToolCall {
+    request: ServerRequest;
+    callId: string;
+    name: string;
+    arguments: unknown;
+    threadId: string;
+    turnId: string;
+}
+/** Coordinates durable mappings, thread ownership, and ephemeral tool responders. */
+export declare class ContinuationCoordinator {
+    #private;
+    readonly store: ResponseStore;
+    private readonly rpc;
+    private readonly toolTimeoutMs;
+    constructor(store: ResponseStore, rpc: JsonRpcTransport, toolTimeoutMs: number);
+    /** Installs the sole dynamic-tool callback owner for a claimed thread. */
+    setToolOwner(threadId: string, owner: (request: PendingToolCall) => void): boolean;
+    /** Removes a dynamic-tool callback owner if it is still the expected owner. */
+    clearToolOwner(threadId: string, owner: (request: PendingToolCall) => void): void;
+    /** Claims exclusive use of a thread, returning false rather than queueing. */
+    claim(threadId: string): boolean;
+    /** Releases exclusive use unless a suspended tool call still owns the thread. */
+    release(threadId: string): void;
+    /** Persists and keeps the responder for a dynamic-tool suspension. */
+    suspend(responseId: string, binding: ThreadBinding, calls: PendingToolCall[]): void;
+    /** Returns the live suspension, distinguishing restart tombstones from unknown IDs. */
+    pending(responseId: string): PendingToolCall[] | undefined;
+    /** Resolves live pending tool IDs to exactly one suspended response. */
+    findPendingResponse(callIds: readonly string[]): string;
+    /** Answers pending calls in deterministic call order and consumes the suspension. */
+    resolve(responseId: string, results: Map<string, string>): PendingToolCall[] | undefined;
+    /** Records a completed response only while this transport generation is current. */
+    recordReady(responseId: string, threadId: string, binding: ThreadBinding): boolean;
+    /** Cancels ephemeral responders and detaches routing before transport replacement. */
+    dispose(): void;
+}

package/dist/continuation/state.js

@@ -0,0 +1,460 @@
+import { randomUUID } from "node:crypto";
+import { chmodSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, unlinkSync, writeFileSync, } from "node:fs";
+import { basename, join } from "node:path";
+import { toolCorrelationErrorForStatus, } from "../http/errors.js";
+import { bindingHash, canonicalJson, record as asRecord, } from "../core/canonical.js";
+export { bindingHash, canonicalJson };
+/** Current on-disk continuation-store schema for the unreleased format. */
+const SCHEMA_VERSION = 0;
+/** Durable atomic response mapping store with bounded retention. */
+export class ResponseStore {
+    retentionMs;
+    temporaryPath;
+    #path;
+    #records = new Map();
+    constructor(directory, retentionMs = 30 * 24 * 60 * 60_000, temporaryPath = defaultTemporaryPath) {
+        this.retentionMs = retentionMs;
+        this.temporaryPath = temporaryPath;
+        mkdirSync(directory, { recursive: true, mode: 0o700 });
+        hardenStatePath(directory, "directory");
+        this.#path = join(directory, "continuations.json");
+        hardenExistingStateFile(this.#path);
+        this.#sweepStaleTemporaries(directory);
+        this.#load();
+    }
+    /** Removes temporaries stranded by a crash between write and atomic rename. */
+    #sweepStaleTemporaries(directory) {
+        const prefix = `${basename(this.#path)}.`;
+        let entries;
+        try {
+            entries = readdirSync(directory);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (!entry.startsWith(prefix) || !entry.endsWith(".tmp"))
+                continue;
+            try {
+                unlinkSync(join(directory, entry));
+            }
+            catch {
+                // A concurrent writer may still hold this temporary; leave it in place.
+            }
+        }
+    }
+    /** Retrieves a record after applying expiry and newest-response rules. */
+    get(responseId) {
+        const record = this.#records.get(responseId);
+        if (record &&
+            record.expiresAt <= Date.now() &&
+            record.state !== "expired") {
+            this.#mutateAndSave(() => {
+                record.state = "expired";
+            });
+        }
+        return record;
+    }
+    /** Inserts a record and supersedes the prior completed response for its thread. */
+    put(record) {
+        const now = Date.now();
+        const stored = {
+            ...record,
+            createdAt: now,
+            expiresAt: now + this.retentionMs,
+        };
+        this.#mutateAndSave(() => {
+            for (const prior of this.#records.values()) {
+                if (prior.threadId === record.threadId && prior.state === "ready")
+                    prior.state = "superseded";
+            }
+            this.#records.set(stored.responseId, stored);
+            this.#prune(now);
+        });
+        return stored;
+    }
+    /** Changes an existing record without exposing partial disk writes. */
+    update(responseId, patch) {
+        const current = this.#records.get(responseId);
+        if (!current)
+            return undefined;
+        const updated = {
+            ...current,
+            ...patch,
+            responseId: current.responseId,
+            threadId: current.threadId,
+        };
+        this.#mutateAndSave(() => {
+            this.#records.set(responseId, updated);
+        });
+        return updated;
+    }
+    /** Finds durable records containing every requested dynamic-tool call ID. */
+    findByCallIds(callIds) {
+        const requested = new Set(callIds);
+        return [...this.#records.values()].filter((record) => record.callIds !== undefined &&
+            [...requested].every((id) => record.callIds.includes(id)));
+    }
+    /** Loads valid records and quarantines an unreadable store logically as empty. */
+    #load() {
+        try {
+            const input = JSON.parse(readFileSync(this.#path, "utf8"));
+            const parsed = asRecord(input);
+            if (!parsed)
+                return;
+            const records = parsed.version === SCHEMA_VERSION && Array.isArray(parsed.records)
+                ? parsed.records
+                : undefined;
+            // Other schemas are left untouched and treated as untrusted. There is no
+            // compatibility path because this on-disk format has not been released.
+            if (!records)
+                return;
+            for (const record of records)
+                if (isResponseRecord(record))
+                    this.#records.set(record.responseId, { ...record });
+            // A responder cannot survive process restart; retain only its safe tombstone.
+            for (const record of this.#records.values())
+                if (record.state === "pending_tool")
+                    record.state = "expired";
+            this.#prune(Date.now());
+            this.#save();
+        }
+        catch {
+            // Missing or corrupt state cannot be trusted for continuation.
+        }
+    }
+    /** Drops records older than the configured retention horizon. */
+    #prune(now) {
+        for (const [id, record] of this.#records)
+            if (record.expiresAt + this.retentionMs < now)
+                this.#records.delete(id);
+    }
+    /** Replaces the state file atomically so abrupt termination preserves the old file. */
+    #save() {
+        const temporary = this.temporaryPath(this.#path);
+        try {
+            writeFileSync(temporary, JSON.stringify({
+                version: SCHEMA_VERSION,
+                records: [...this.#records.values()],
+            }), {
+                encoding: "utf8",
+                mode: 0o600,
+                flag: "wx",
+            });
+            renameSync(temporary, this.#path);
+        }
+        catch (error) {
+            try {
+                unlinkSync(temporary);
+            }
+            catch {
+                // The write may have failed before creating its private temporary file.
+            }
+            throw error;
+        }
+    }
+    /** Commits a mutation durably or restores the exact prior in-memory view. */
+    #mutateAndSave(mutate) {
+        const snapshot = new Map([...this.#records].map(([id, record]) => [id, { ...record }]));
+        try {
+            mutate();
+            this.#save();
+        }
+        catch (error) {
+            this.#records.clear();
+            for (const [id, record] of snapshot)
+                this.#records.set(id, record);
+            throw error;
+        }
+    }
+}
+/** Creates an unpredictable same-directory path for one atomic state write. */
+function defaultTemporaryPath(statePath) {
+    return `${statePath}.${process.pid}.${randomUUID()}.tmp`;
+}
+/** Tightens and validates the state directory on platforms with POSIX modes. */
+function hardenStatePath(path, kind) {
+    const before = lstatSync(path);
+    if (before.isSymbolicLink() ||
+        (kind === "directory" ? !before.isDirectory() : !before.isFile()))
+        throw new Error(`Continuation state ${kind} must be a regular ${kind}.`);
+    if (process.platform === "win32")
+        return;
+    chmodSync(path, kind === "directory" ? 0o700 : 0o600);
+    const after = lstatSync(path);
+    const unsafe = kind === "directory" ? 0o077 : 0o177;
+    if ((after.mode & unsafe) !== 0)
+        throw new Error(`Continuation state ${kind} permissions are too broad.`);
+}
+/** Secures an existing state file without creating an empty replacement. */
+function hardenExistingStateFile(path) {
+    try {
+        hardenStatePath(path, "file");
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            error.code === "ENOENT")
+            return;
+        throw error;
+    }
+}
+/** Coordinates durable mappings, thread ownership, and ephemeral tool responders. */
+export class ContinuationCoordinator {
+    store;
+    rpc;
+    toolTimeoutMs;
+    #pending = new Map();
+    #busy = new Set();
+    #toolOwners = new Map();
+    #disposed = false;
+    constructor(store, rpc, toolTimeoutMs) {
+        this.store = store;
+        this.rpc = rpc;
+        this.toolTimeoutMs = toolTimeoutMs;
+        this.rpc.on("request", this.#routeToolRequest);
+        this.rpc.once("close", this.#detachRouter);
+    }
+    /** Detaches the fail-closed router once no more frames can arrive. */
+    #detachRouter = () => {
+        this.rpc.off("request", this.#routeToolRequest);
+    };
+    /** Rejects one request while allowing disposal to survive transport closure. */
+    #failRequestReplaced(id) {
+        try {
+            this.rpc.respondError(id, {
+                code: -32000,
+                message: "App-server transport is being replaced",
+            });
+        }
+        catch {
+            // A concurrently closed transport has already failed the request.
+        }
+    }
+    /** Routes one dynamic-tool callback to the sole owner of its thread. */
+    #routeToolRequest = (request) => {
+        if (request.method !== "item/tool/call")
+            return;
+        if (this.#disposed) {
+            this.#failRequestReplaced(request.id);
+            return;
+        }
+        const params = asRecord(request.params);
+        if (!params ||
+            typeof params.threadId !== "string" ||
+            typeof params.turnId !== "string" ||
+            typeof params.callId !== "string" ||
+            typeof params.tool !== "string" ||
+            (params.namespace !== undefined && params.namespace !== null)) {
+            this.rpc.respondError(request.id, {
+                code: -32602,
+                message: "Invalid dynamic tool request",
+            });
+            return;
+        }
+        const owner = this.#toolOwners.get(params.threadId);
+        if (!owner) {
+            this.rpc.respondError(request.id, {
+                code: -32602,
+                message: "Dynamic tool correlation mismatch",
+            });
+            return;
+        }
+        owner({
+            request,
+            callId: params.callId,
+            name: params.tool,
+            arguments: params.arguments,
+            threadId: params.threadId,
+            turnId: params.turnId,
+        });
+    };
+    /** Installs the sole dynamic-tool callback owner for a claimed thread. */
+    setToolOwner(threadId, owner) {
+        if (this.#disposed)
+            throw new Error("Continuation coordinator is disposed.");
+        if (this.#toolOwners.has(threadId))
+            return false;
+        this.#toolOwners.set(threadId, owner);
+        return true;
+    }
+    /** Removes a dynamic-tool callback owner if it is still the expected owner. */
+    clearToolOwner(threadId, owner) {
+        if (this.#toolOwners.get(threadId) === owner)
+            this.#toolOwners.delete(threadId);
+    }
+    /** Claims exclusive use of a thread, returning false rather than queueing. */
+    claim(threadId) {
+        if (this.#busy.has(threadId))
+            return false;
+        this.#busy.add(threadId);
+        return true;
+    }
+    /** Releases exclusive use unless a suspended tool call still owns the thread. */
+    release(threadId) {
+        if (![...this.#pending.values()].some((entry) => entry.calls[0]?.threadId === threadId))
+            this.#busy.delete(threadId);
+    }
+    /** Persists and keeps the responder for a dynamic-tool suspension. */
+    suspend(responseId, binding, calls) {
+        if (this.#disposed)
+            throw new Error("Continuation coordinator is disposed.");
+        const threadId = calls[0].threadId;
+        this.#toolOwners.delete(threadId);
+        this.store.put({
+            responseId,
+            threadId,
+            state: "pending_tool",
+            ...binding,
+            callIds: calls.map((call) => call.callId),
+        });
+        const timer = setTimeout(() => {
+            for (const call of calls) {
+                try {
+                    this.rpc.respondError(call.request.id, {
+                        code: -32002,
+                        message: "Dynamic tool result timed out",
+                    });
+                }
+                catch {
+                    // Transport failure must not escape a timer callback.
+                }
+            }
+            this.#pending.delete(responseId);
+            this.#busy.delete(threadId);
+            this.store.update(responseId, { state: "expired" });
+        }, this.toolTimeoutMs);
+        timer.unref();
+        this.#pending.set(responseId, { calls, timer });
+    }
+    /** Returns the live suspension, distinguishing restart tombstones from unknown IDs. */
+    pending(responseId) {
+        return this.#pending.get(responseId)?.calls;
+    }
+    /** Resolves live pending tool IDs to exactly one suspended response. */
+    findPendingResponse(callIds) {
+        const requested = new Set(callIds);
+        if (requested.size !== callIds.length)
+            throw toolLookupFailure(400, "duplicate_tool_call_id");
+        const matches = [...this.#pending.entries()].filter(([, entry]) => [...requested].every((id) => entry.calls.some((call) => call.callId === id)));
+        if (matches.length === 0) {
+            const tombstones = this.store
+                .findByCallIds(callIds)
+                .filter((record) => record.state === "expired");
+            if (tombstones.length === 1)
+                throw toolLookupFailure(410, "expired_tool_continuation");
+            if (tombstones.length > 1)
+                throw toolLookupFailure(409, "ambiguous_tool_call_id");
+            throw toolLookupFailure(404, "unknown_tool_call_id");
+        }
+        if (matches.length > 1)
+            throw toolLookupFailure(409, "ambiguous_tool_call_id");
+        return matches[0][0];
+    }
+    /** Answers pending calls in deterministic call order and consumes the suspension. */
+    resolve(responseId, results) {
+        const entry = this.#pending.get(responseId);
+        if (!entry)
+            return undefined;
+        const threadId = entry.calls[0].threadId;
+        // Consume before writing any response so a partial transport failure cannot
+        // leave a timerless suspension that may replay already-written results.
+        this.#pending.delete(responseId);
+        clearTimeout(entry.timer);
+        try {
+            for (const call of entry.calls) {
+                this.rpc.respond(call.request.id, {
+                    contentItems: [
+                        { type: "inputText", text: results.get(call.callId) },
+                    ],
+                    success: true,
+                });
+            }
+        }
+        catch (error) {
+            // Some earlier responses may already be on the wire. Expire the whole
+            // batch and release ownership; retrying it could duplicate those results.
+            this.#busy.delete(threadId);
+            this.store.update(responseId, { state: "expired" });
+            throw error;
+        }
+        this.store.update(responseId, { state: "superseded" });
+        return entry.calls;
+    }
+    /** Records a completed response only while this transport generation is current. */
+    recordReady(responseId, threadId, binding) {
+        if (this.#disposed)
+            return false;
+        this.store.put({ responseId, threadId, state: "ready", ...binding });
+        return true;
+    }
+    /** Cancels ephemeral responders and detaches routing before transport replacement. */
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        // Keep the router installed in fail-closed mode until the transport closes.
+        this.#toolOwners.clear();
+        this.#busy.clear();
+        for (const [responseId, entry] of this.#pending) {
+            clearTimeout(entry.timer);
+            for (const call of entry.calls)
+                this.#failRequestReplaced(call.request.id);
+            this.store.update(responseId, { state: "expired" });
+        }
+        this.#pending.clear();
+    }
+}
+/** Validates every persisted field before a record can influence continuation. */
+function isResponseRecord(value) {
+    const record = asRecord(value);
+    if (!record)
+        return false;
+    const allowedKeys = new Set([
+        "responseId",
+        "threadId",
+        "state",
+        "model",
+        "cwd",
+        "toolsHash",
+        "policyHash",
+        "createdAt",
+        "expiresAt",
+        "callIds",
+    ]);
+    const validStates = new Set([
+        "ready",
+        "pending_tool",
+        "expired",
+        "superseded",
+        "corrupt",
+    ]);
+    const validHash = (hash) => typeof hash === "string" && /^[a-f0-9]{64}$/.test(hash);
+    const callIds = record.callIds;
+    return (Object.keys(record).every((key) => allowedKeys.has(key)) &&
+        typeof record.responseId === "string" &&
+        record.responseId.length > 0 &&
+        typeof record.threadId === "string" &&
+        record.threadId.length > 0 &&
+        typeof record.model === "string" &&
+        record.model.length > 0 &&
+        typeof record.cwd === "string" &&
+        record.cwd.length > 0 &&
+        validHash(record.toolsHash) &&
+        validHash(record.policyHash) &&
+        typeof record.state === "string" &&
+        validStates.has(record.state) &&
+        typeof record.createdAt === "number" &&
+        Number.isFinite(record.createdAt) &&
+        typeof record.expiresAt === "number" &&
+        Number.isFinite(record.expiresAt) &&
+        (callIds === undefined ||
+            (Array.isArray(callIds) &&
+                callIds.every((id) => typeof id === "string") &&
+                new Set(callIds).size === callIds.length)));
+}
+/** Builds an OpenAI-shaped failure for implicit tool-call correlation. */
+function toolLookupFailure(status, code) {
+    return toolCorrelationErrorForStatus(status, "The tool result could not be correlated to one pending call.", code, "tool_call_id");
+}
+//# sourceMappingURL=state.js.map

package/dist/continuation/state.js.map

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

package/dist/core/abort.d.ts

@@ -0,0 +1,13 @@
+/** Options controlling a derived cancellation deadline. */
+interface DeadlineOptions {
+    milliseconds: number;
+    timeoutReason: unknown;
+    abortReason?: (signal: AbortSignal) => unknown;
+}
+/** Registers one abort listener and returns an idempotent disposer. */
+export declare function listenForAbort(signal: AbortSignal | undefined, listener: (signal: AbortSignal) => void): () => void;
+/** Resolves after a delay or rejects with the signal's exact abort reason. */
+export declare function abortableDelay(milliseconds: number, signal?: AbortSignal): Promise<void>;
+/** Runs work with a derived signal that aborts at a deadline or with its parent. */
+export declare function withDeadline<T>(parentSignal: AbortSignal | undefined, options: DeadlineOptions, run: (signal: AbortSignal) => Promise<T>): Promise<T>;
+export {};

package/dist/core/abort.js

@@ -0,0 +1,74 @@
+/** Registers one abort listener and returns an idempotent disposer. */
+export function listenForAbort(signal, listener) {
+    if (signal === undefined)
+        return () => undefined;
+    if (signal.aborted) {
+        listener(signal);
+        return () => undefined;
+    }
+    let disposed = false;
+    const onAbort = () => {
+        if (disposed)
+            return;
+        try {
+            listener(signal);
+        }
+        finally {
+            dispose();
+        }
+    };
+    signal.addEventListener("abort", onAbort, { once: true });
+    const dispose = () => {
+        if (disposed)
+            return;
+        disposed = true;
+        signal.removeEventListener("abort", onAbort);
+    };
+    return dispose;
+}
+/** Resolves after a delay or rejects with the signal's exact abort reason. */
+export function abortableDelay(milliseconds, signal) {
+    if (signal?.aborted)
+        return Promise.reject(signal.reason);
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const timer = setTimeout(done, milliseconds);
+        timer.unref();
+        const disposeAbort = listenForAbort(signal, (abortedSignal) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            disposeAbort();
+            reject(abortedSignal.reason);
+        });
+        function done() {
+            if (settled)
+                return;
+            settled = true;
+            disposeAbort();
+            resolve();
+        }
+    });
+}
+/** Runs work with a derived signal that aborts at a deadline or with its parent. */
+export async function withDeadline(parentSignal, options, run) {
+    const controller = new AbortController();
+    const disposeParent = listenForAbort(parentSignal, (abortedSignal) => {
+        controller.abort(options.abortReason === undefined
+            ? abortedSignal.reason
+            : options.abortReason(abortedSignal));
+    });
+    const timer = setTimeout(() => controller.abort(options.timeoutReason), options.milliseconds);
+    timer.unref();
+    try {
+        // Await the operation itself: aborting the derived signal does not settle an
+        // operation that intentionally ignores cancellation.
+        return await run(controller.signal);
+    }
+    finally {
+        clearTimeout(timer);
+        disposeParent();
+    }
+}
+//# sourceMappingURL=abort.js.map

package/dist/core/abort.js.map

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

package/dist/core/canonical.d.ts

@@ -0,0 +1,6 @@
+/** Canonicalizes JSON values so equivalent structures serialize identically. */
+export declare function canonicalJson(value: unknown): string;
+/** Returns a stable SHA-256 binding for a JSON-compatible value. */
+export declare function bindingHash(value: unknown): string;
+/** Narrows an unknown value to a non-null, non-array object record. */
+export declare function record(value: unknown): Record<string, unknown> | undefined;