codex-openai-proxy 0.1.0-rc.0

package/dist/http/chat-validate.js

@@ -0,0 +1,190 @@
+import { record } from "../core/canonical.js";
+import { validateRequestPolicy, } from "../core/policy.js";
+import { HttpError } from "./errors.js";
+/** Validates the deliberately narrow request surface implemented in Stage 04. */
+export function validateRequest(value, log, requestId, implicitToolContinuation) {
+    const body = record(value);
+    if (!body)
+        invalid("Request body must be a JSON object.", null);
+    if (typeof body.model !== "string" || body.model.trim() === "")
+        invalid("model must be a non-empty string.", "model");
+    if (!Array.isArray(body.messages) || body.messages.length === 0)
+        invalid("messages must be a non-empty array.", "messages");
+    if (body.stream !== undefined && typeof body.stream !== "boolean")
+        invalid("stream must be a boolean.", "stream");
+    if (body.previous_response_id !== undefined &&
+        (typeof body.previous_response_id !== "string" ||
+            body.previous_response_id === ""))
+        invalid("previous_response_id must be a non-empty string.", "previous_response_id");
+    const requestPolicy = validateRequestPolicy(body.x_codex);
+    const messages = body.messages.map((entry, index) => validateMessage(entry, index));
+    const hasToolResults = messages.some((message) => message.role === "tool");
+    if (!body.previous_response_id && hasToolResults && !implicitToolContinuation)
+        invalid("Tool results require previous_response_id when implicit tool continuation is disabled.", "previous_response_id");
+    if (!body.previous_response_id &&
+        !hasToolResults &&
+        messages.at(-1)?.role !== "user")
+        invalid("The final message must have role user.", "messages");
+    if (body.previous_response_id &&
+        !["user", "tool"].includes(messages.at(-1).role))
+        invalid("A continuation must end with a user or tool message.", "messages");
+    let includeUsage = false;
+    if (body.stream_options !== undefined) {
+        const streamOptions = record(body.stream_options);
+        if (!streamOptions ||
+            Object.keys(streamOptions).some((key) => key !== "include_usage") ||
+            (streamOptions.include_usage !== undefined &&
+                typeof streamOptions.include_usage !== "boolean"))
+            invalid("stream_options supports only a boolean include_usage field.", "stream_options");
+        includeUsage = streamOptions.include_usage === true;
+    }
+    const dynamicTools = validateTools(body.tools, body.tool_choice);
+    const supported = new Set([
+        "model",
+        "messages",
+        "stream",
+        "stream_options",
+        "tools",
+        "tool_choice",
+        "previous_response_id",
+        "x_codex",
+    ]);
+    const ignored = Object.keys(body).filter((key) => !supported.has(key));
+    if (ignored.length)
+        log("warn", "unsupported_chat_fields_ignored", {
+            request_id: requestId,
+            fields: ignored.sort(),
+        });
+    return {
+        model: body.model,
+        messages,
+        stream: body.stream === true,
+        includeUsage,
+        dynamicTools,
+        requestPolicy,
+        ...(typeof body.previous_response_id === "string"
+            ? { previousResponseId: body.previous_response_id }
+            : {}),
+    };
+}
+/** Converts a safe policy failure to the public OpenAI error envelope. */
+export function policyHttpError(error) {
+    return new HttpError(400, error.message, "invalid_request_error", error.code, error.param);
+}
+/** Validates one role-preserving, text-only message. */
+function validateMessage(value, index) {
+    const message = record(value);
+    const param = `messages.${index}`;
+    if (!message ||
+        !["system", "developer", "user", "assistant", "tool"].includes(String(message.role)))
+        invalid("Only system, developer, user, assistant, and tool messages are supported.", `${param}.role`);
+    if (typeof message.content !== "string" &&
+        !(message.role === "assistant" && message.content === null))
+        invalid("Message content must be a string.", `${param}.content`);
+    const allowed = new Set([
+        "role",
+        "content",
+        "name",
+        "tool_call_id",
+        "tool_calls",
+    ]);
+    if (Object.keys(message).some((key) => !allowed.has(key)))
+        invalid("This message contains unsupported fields.", param);
+    let toolCalls;
+    if (message.role === "assistant" && message.tool_calls !== undefined) {
+        if (!Array.isArray(message.tool_calls))
+            invalid("tool_calls must be an array.", `${param}.tool_calls`);
+        toolCalls = message.tool_calls.map((raw, callIndex) => {
+            const call = record(raw);
+            const fn = record(call?.function);
+            if (call?.type !== "function" ||
+                typeof call.id !== "string" ||
+                typeof fn?.name !== "string" ||
+                typeof fn.arguments !== "string")
+                invalid("Each assistant tool call must be a complete function call.", `${param}.tool_calls.${callIndex}`);
+            return { id: call.id, name: fn.name, arguments: fn.arguments };
+        });
+    }
+    if (message.role === "tool" && typeof message.tool_call_id !== "string")
+        invalid("A tool message requires tool_call_id.", `${param}.tool_call_id`);
+    return {
+        role: message.role,
+        content: typeof message.content === "string" ? message.content : "",
+        ...(typeof message.tool_call_id === "string"
+            ? { toolCallId: message.tool_call_id }
+            : {}),
+        ...(toolCalls ? { toolCalls } : {}),
+    };
+}
+/** Converts OpenAI function declarations to app-server dynamic tool specs. */
+function validateTools(value, choice) {
+    if (choice !== undefined && choice !== "auto" && choice !== "none")
+        invalid("tool_choice supports only auto or none in this stage.", "tool_choice");
+    if (value === undefined || choice === "none")
+        return [];
+    if (!Array.isArray(value))
+        invalid("tools must be an array.", "tools");
+    return value.map((raw, index) => {
+        const tool = record(raw);
+        const fn = record(tool?.function);
+        if (tool?.type !== "function" ||
+            !fn ||
+            typeof fn.name !== "string" ||
+            fn.name === "" ||
+            fn.name.length > 128 ||
+            !/^[a-zA-Z0-9_-]+$/.test(fn.name) ||
+            !record(fn.parameters))
+            invalid("Each tool must be a named function with a JSON Schema parameters object.", `tools.${index}`);
+        return {
+            type: "function",
+            name: fn.name,
+            description: typeof fn.description === "string" ? fn.description : "",
+            inputSchema: fn.parameters,
+        };
+    });
+}
+/** Maps prior messages to raw Responses API history without flattening roles. */
+export function toHistoryItem(message) {
+    return {
+        type: "message",
+        role: message.role,
+        content: [
+            {
+                type: message.role === "assistant" ? "output_text" : "input_text",
+                text: message.content,
+            },
+        ],
+    };
+}
+/** Validates a complete, single-use result set for a suspended tool batch. */
+export function validateToolResults(messages, pending) {
+    const assistant = [...messages]
+        .reverse()
+        .find((message) => message.role === "assistant" && message.toolCalls !== undefined);
+    if (!assistant?.toolCalls)
+        invalid("The assistant tool-call message is required.", "messages");
+    const expected = new Map(pending.map((call) => [call.callId, call]));
+    if (assistant.toolCalls.length !== expected.size ||
+        assistant.toolCalls.some((call) => expected.get(call.id)?.name !== call.name ||
+            call.arguments !==
+                JSON.stringify(expected.get(call.id)?.arguments ?? {})))
+        invalid("The assistant tool calls do not match the pending continuation.", "messages");
+    const results = new Map();
+    for (const message of messages) {
+        if (message.role !== "tool")
+            continue;
+        if (!message.toolCallId || !expected.has(message.toolCallId))
+            invalid("The tool result references a foreign call ID.", "messages");
+        if (results.has(message.toolCallId))
+            invalid("A tool call has more than one result.", "messages");
+        results.set(message.toolCallId, message.content);
+    }
+    if (results.size !== expected.size)
+        invalid("Exactly one result is required for every pending tool call.", "messages");
+    return results;
+}
+/** Throws an OpenAI-shaped request validation error. */
+function invalid(message, param) {
+    throw new HttpError(400, message, "invalid_request_error", "invalid_request", param);
+}
+//# sourceMappingURL=chat-validate.js.map

package/dist/http/chat-validate.js.map

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

package/dist/http/chat.d.ts

@@ -0,0 +1,8 @@
+import type { ServerResponse } from "node:http";
+import { type ChatHandlerOptions } from "./chat-execute.js";
+export { serializeSseFrame } from "./chat-sse.js";
+export { aggregateNormalizedEvents, EventNormalizer, HANDLED_NOTIFICATION_METHODS, normalizeNotification, } from "./chat-normalize.js";
+export type { AggregatedNormalizedEvents, NormalizedDelta, NormalizedError, NormalizedEvent, NormalizedFunction, NormalizedToolCall, NormalizedToolResult, NormalizedToolResultData, Usage, } from "./chat-normalize.js";
+export type { ChatHandlerOptions } from "./chat-execute.js";
+/** Validates, executes, and serializes one Chat Completions request. */
+export declare function handleChatCompletion(body: unknown, response: ServerResponse, options: ChatHandlerOptions): Promise<void>;

package/dist/http/chat.js

@@ -0,0 +1,137 @@
+import { randomUUID } from "node:crypto";
+import { writeJson } from "./errors.js";
+import { chunk, writeFrame, writeSse, writeSseError } from "./chat-sse.js";
+import { aggregateNormalizedEvents, } from "./chat-normalize.js";
+import { execute } from "./chat-execute.js";
+import { policyHttpError, validateRequest, } from "./chat-validate.js";
+import { PolicyError, resolveEffectivePolicy, } from "../core/policy.js";
+export { serializeSseFrame } from "./chat-sse.js";
+export { aggregateNormalizedEvents, EventNormalizer, HANDLED_NOTIFICATION_METHODS, normalizeNotification, } from "./chat-normalize.js";
+/** Validates, executes, and serializes one Chat Completions request. */
+export async function handleChatCompletion(body, response, options) {
+    let parsed;
+    try {
+        parsed = validateRequest(body, options.log, options.requestId, options.implicitToolContinuation);
+    }
+    catch (error) {
+        if (error instanceof PolicyError)
+            throw policyHttpError(error);
+        throw error;
+    }
+    let policy;
+    try {
+        policy = await resolveEffectivePolicy(parsed.requestPolicy, options.root, options.requirements);
+    }
+    catch (error) {
+        if (error instanceof PolicyError)
+            throw policyHttpError(error);
+        throw error;
+    }
+    const request = {
+        model: parsed.model,
+        messages: parsed.messages,
+        stream: parsed.stream,
+        includeUsage: parsed.includeUsage,
+        dynamicTools: parsed.dynamicTools,
+        ...(parsed.previousResponseId
+            ? { previousResponseId: parsed.previousResponseId }
+            : {}),
+        policy,
+    };
+    if (!request.previousResponseId &&
+        request.messages.some((message) => message.role === "tool")) {
+        const callIds = request.messages
+            .filter((message) => message.role === "tool")
+            .map((message) => message.toolCallId);
+        request.previousResponseId =
+            options.continuations.findPendingResponse(callIds);
+    }
+    const responseId = `chatcmpl_codex_${randomUUID().replaceAll("-", "")}`;
+    const created = Math.floor(Date.now() / 1_000);
+    // Setup is eager so validation and RPC failures retain their HTTP status
+    // instead of committing an SSE response before the generator is advanced.
+    const execution = await execute(request, options, responseId);
+    const { events } = execution;
+    try {
+        if (request.stream) {
+            await streamChatResponse(response, events, request, responseId, created);
+            return;
+        }
+        await writeAggregateResponse(response, events, request, responseId, created);
+    }
+    finally {
+        // This also covers writeHead/initial-role failures before the async
+        // generator has ever started, when its own finally block cannot run.
+        await execution.dispose();
+    }
+}
+/** Serializes one execution as an SSE Chat Completions response. */
+async function streamChatResponse(response, events, request, responseId, created) {
+    response.writeHead(200, {
+        "content-type": "text/event-stream; charset=utf-8",
+        "cache-control": "no-cache, no-store",
+        connection: "keep-alive",
+        "x-accel-buffering": "no",
+    });
+    await writeSse(response, chunk(responseId, created, request.model, { role: "assistant" }, null));
+    let streamFailed = false;
+    try {
+        for await (const event of events) {
+            if (event.error) {
+                await writeSseError(response, event.error);
+                streamFailed = true;
+                break;
+            }
+            if (event.delta)
+                await writeSse(response, chunk(responseId, created, request.model, event.delta, null));
+            if (event.finishReason)
+                await writeSse(response, chunk(responseId, created, request.model, {}, event.finishReason));
+            if (event.usage && request.includeUsage)
+                await writeSse(response, {
+                    id: responseId,
+                    object: "chat.completion.chunk",
+                    created,
+                    model: request.model,
+                    choices: [],
+                    usage: event.usage,
+                });
+        }
+    }
+    catch (error) {
+        streamFailed = true;
+        if (!response.writableEnded && !response.destroyed)
+            await writeSseError(response, error instanceof Error ? error.message : "The app-server turn failed.");
+    }
+    if (!streamFailed)
+        await writeFrame(response, "[DONE]");
+    response.end();
+}
+/** Aggregates and serializes one non-streaming Chat Completions response. */
+async function writeAggregateResponse(response, events, request, responseId, created) {
+    const aggregated = await aggregateNormalizedEvents(events);
+    const { content, reasoning, toolResults, finishReason, usage } = aggregated;
+    const message = {
+        role: "assistant",
+        content: aggregated.toolCalls.length && content === "" ? null : content,
+    };
+    if (reasoning)
+        message.reasoning = reasoning;
+    if (aggregated.toolCalls.length) {
+        message.tool_calls = aggregated.toolCalls.map((call) => ({
+            id: call.id,
+            type: call.type,
+            function: call.function,
+        }));
+    }
+    if (toolResults.length)
+        message.tool_results = toolResults;
+    writeJson(response, 200, {
+        id: responseId,
+        object: "chat.completion",
+        created,
+        model: request.model,
+        choices: [{ index: 0, message, finish_reason: finishReason ?? "stop" }],
+        ...(usage ? { usage } : {}),
+    });
+}
+//# sourceMappingURL=chat.js.map

package/dist/http/chat.js.map

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

package/dist/http/errors.d.ts

@@ -0,0 +1,19 @@
+import type { ServerResponse } from "node:http";
+/** OpenAI-compatible error categories emitted by the proxy. */
+export type ErrorType = "invalid_request_error" | "conflict_error" | "not_found_error" | "rate_limit_error" | "server_error";
+/** Carries an HTTP status and OpenAI-shaped error metadata. */
+export declare class HttpError extends Error {
+    readonly status: number;
+    readonly type: ErrorType;
+    readonly code: string;
+    readonly param: string | null;
+    constructor(status: number, message: string, type: ErrorType, code: string, param?: string | null);
+}
+/** Builds the OpenAI-compatible error envelope shared by JSON and SSE output. */
+export declare function errorEnvelope(message: string, type: ErrorType, code: string, param: string | null): Record<string, unknown>;
+/** Builds a tool-correlation error using its narrow status-to-type policy. */
+export declare function toolCorrelationErrorForStatus(status: number, message: string, code: string, param: string | null): HttpError;
+/** Writes a non-cacheable JSON response unless it has already ended. */
+export declare function writeJson(response: ServerResponse, status: number, value: unknown): void;
+/** Serializes an HttpError in the OpenAI error envelope. */
+export declare function writeError(response: ServerResponse, error: HttpError): void;

package/dist/http/errors.js

@@ -0,0 +1,56 @@
+/** Carries an HTTP status and OpenAI-shaped error metadata. */
+export class HttpError extends Error {
+    status;
+    type;
+    code;
+    param;
+    constructor(status, message, type, code, param = null) {
+        super(message);
+        this.status = status;
+        this.type = type;
+        this.code = code;
+        this.param = param;
+    }
+}
+/** Builds the OpenAI-compatible error envelope shared by JSON and SSE output. */
+export function errorEnvelope(message, type, code, param) {
+    return {
+        error: {
+            message,
+            type,
+            param,
+            code,
+        },
+    };
+}
+/** Builds a tool-correlation error using its narrow status-to-type policy. */
+export function toolCorrelationErrorForStatus(status, message, code, param) {
+    const type = status >= 500
+        ? "server_error"
+        : status === 409
+            ? "conflict_error"
+            : "invalid_request_error";
+    return new HttpError(status, message, type, code, param);
+}
+/** Writes a non-cacheable JSON response unless it has already ended. */
+export function writeJson(response, status, value) {
+    if (response.writableEnded)
+        return;
+    // A streaming route may fail after its status and content type are committed.
+    if (response.headersSent) {
+        response.end();
+        return;
+    }
+    const body = JSON.stringify(value);
+    response.writeHead(status, {
+        "content-type": "application/json; charset=utf-8",
+        "content-length": Buffer.byteLength(body),
+        "cache-control": "no-store",
+    });
+    response.end(body);
+}
+/** Serializes an HttpError in the OpenAI error envelope. */
+export function writeError(response, error) {
+    writeJson(response, error.status, errorEnvelope(error.message, error.type, error.code, error.param));
+}
+//# sourceMappingURL=errors.js.map

package/dist/http/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/http/errors.ts"],"names":[],"mappings":"AAUA,+DAA+D;AAC/D,MAAM,OAAO,SAAU,SAAQ,KAAK;IAEvB;IAEA;IACA;IACA;IALX,YACW,MAAc,EACvB,OAAe,EACN,IAAe,EACf,IAAY,EACZ,QAAuB,IAAI;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QANN,WAAM,GAAN,MAAM,CAAQ;QAEd,SAAI,GAAJ,IAAI,CAAW;QACf,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAsB;IAGtC,CAAC;CACF;AAED,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,IAAe,EACf,IAAY,EACZ,KAAoB;IAEpB,OAAO;QACL,KAAK,EAAE;YACL,OAAO;YACP,IAAI;YACJ,KAAK;YACL,IAAI;SACL;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,6BAA6B,CAC3C,MAAc,EACd,OAAe,EACf,IAAY,EACZ,KAAoB;IAEpB,MAAM,IAAI,GACR,MAAM,IAAI,GAAG;QACX,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,MAAM,KAAK,GAAG;YACd,CAAC,CAAC,gBAAgB;YAClB,CAAC,CAAC,uBAAuB,CAAC;IAChC,OAAO,IAAI,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,SAAS,CACvB,QAAwB,EACxB,MAAc,EACd,KAAc;IAEd,IAAI,QAAQ,CAAC,aAAa;QAAE,OAAO;IACnC,8EAA8E;IAC9E,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzB,QAAQ,CAAC,GAAG,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE;QACzB,cAAc,EAAE,iCAAiC;QACjD,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;QACzC,eAAe,EAAE,UAAU;KAC5B,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,UAAU,CAAC,QAAwB,EAAE,KAAgB;IACnE,SAAS,CACP,QAAQ,EACR,KAAK,CAAC,MAAM,EACZ,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAClE,CAAC;AACJ,CAAC"}

package/dist/http/server.d.ts

@@ -0,0 +1,19 @@
+import { type Server } from "node:http";
+import type { ServeOptions } from "../core/config.js";
+import type { Logger } from "../core/logger.js";
+import type { JsonRpcTransport } from "../app-server/json-rpc.js";
+import { type PolicyRequirements } from "../core/policy.js";
+/** Controls the proxy HTTP listener and readiness state. */
+export interface ProxyServer {
+    server: Server;
+    listen(): Promise<{
+        address: string;
+        port: number;
+    }>;
+    close(): Promise<void>;
+    setReady(ready: boolean): void;
+    setTransport(transport: JsonRpcTransport, requirements: PolicyRequirements): void;
+    setTransport(transport: undefined): void;
+}
+/** Creates a loopback proxy with bounded concurrency and request lifetimes. */
+export declare function createProxyServer(options: ServeOptions, log: Logger): ProxyServer;