mimo2codex 0.1.15 → 0.1.16

package/dist/providers/genericLoader.js

@@ -0,0 +1,229 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { createGenericProvider, GenericProviderSpecError, } from "./generic.js";
+import { log } from "../util/log.js";
+export class GenericLoaderError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GenericLoaderError";
+    }
+}
+// Resolve which JSON file path applies. Unlike resolveProvidersFile, this
+// returns the path even when the file doesn't exist yet — used by the admin
+// UI to know where a first-time save should go.
+export function locateProvidersFile(env, dataDir) {
+    const explicit = env.MIMO2CODEX_PROVIDERS_FILE;
+    if (explicit) {
+        return { path: explicit, source: "explicit", exists: existsSync(explicit) };
+    }
+    if (!dataDir)
+        return null;
+    const defaultPath = join(dataDir, "providers.json");
+    return { path: defaultPath, source: "default", exists: existsSync(defaultPath) };
+}
+// Resolve which JSON file (if any) to read. Order:
+//   1. $MIMO2CODEX_PROVIDERS_FILE — explicit override
+//   2. <dataDir>/providers.json — default location, co-located with sqlite
+function resolveProvidersFile(env, dataDir) {
+    const explicit = env.MIMO2CODEX_PROVIDERS_FILE;
+    if (explicit) {
+        if (!existsSync(explicit)) {
+            throw new GenericLoaderError(`MIMO2CODEX_PROVIDERS_FILE points to "${explicit}" but the file does not exist`);
+        }
+        return explicit;
+    }
+    if (!dataDir)
+        return null;
+    const defaultPath = join(dataDir, "providers.json");
+    return existsSync(defaultPath) ? defaultPath : null;
+}
+function parseModels(raw, providerId) {
+    if (raw === undefined || raw === null)
+        return [];
+    if (!Array.isArray(raw)) {
+        throw new GenericLoaderError(`provider "${providerId}" .models must be an array`);
+    }
+    return raw.map((m, idx) => {
+        if (typeof m !== "object" || m === null) {
+            throw new GenericLoaderError(`provider "${providerId}" .models[${idx}] must be an object`);
+        }
+        const obj = m;
+        if (typeof obj.id !== "string" || !obj.id) {
+            throw new GenericLoaderError(`provider "${providerId}" .models[${idx}].id must be a string`);
+        }
+        return {
+            id: obj.id,
+            aliases: Array.isArray(obj.aliases) ? obj.aliases : undefined,
+            displayName: typeof obj.displayName === "string" ? obj.displayName : undefined,
+            supportsImages: typeof obj.supportsImages === "boolean" ? obj.supportsImages : undefined,
+            supportsReasoning: typeof obj.supportsReasoning === "boolean" ? obj.supportsReasoning : undefined,
+            supportsWebSearch: typeof obj.supportsWebSearch === "boolean" ? obj.supportsWebSearch : undefined,
+            contextWindow: typeof obj.contextWindow === "number" ? obj.contextWindow : undefined,
+            maxOutputTokens: typeof obj.maxOutputTokens === "number" ? obj.maxOutputTokens : undefined,
+            deprecatedAfter: typeof obj.deprecatedAfter === "string" ? obj.deprecatedAfter : undefined,
+        };
+    });
+}
+function parseSpec(raw, idx) {
+    if (typeof raw !== "object" || raw === null) {
+        throw new GenericLoaderError(`providers[${idx}] must be an object`);
+    }
+    const obj = raw;
+    const id = typeof obj.id === "string" ? obj.id : undefined;
+    if (!id) {
+        throw new GenericLoaderError(`providers[${idx}].id is required`);
+    }
+    const features = obj.features && typeof obj.features === "object"
+        ? obj.features
+        : undefined;
+    return {
+        id,
+        shortcut: typeof obj.shortcut === "string" ? obj.shortcut : undefined,
+        displayName: typeof obj.displayName === "string" ? obj.displayName : undefined,
+        baseUrl: typeof obj.baseUrl === "string" ? obj.baseUrl : "",
+        envKey: typeof obj.envKey === "string" ? obj.envKey : "",
+        defaultModel: typeof obj.defaultModel === "string" ? obj.defaultModel : "",
+        wireApi: obj.wireApi === "responses" || obj.wireApi === "chat"
+            ? obj.wireApi
+            : undefined,
+        models: parseModels(obj.models, id),
+        features: features
+            ? {
+                webSearch: typeof features.webSearch === "boolean" ? features.webSearch : undefined,
+                forceParallelToolCalls: typeof features.forceParallelToolCalls === "boolean"
+                    ? features.forceParallelToolCalls
+                    : undefined,
+            }
+            : undefined,
+        docsUrl: typeof obj.docsUrl === "string" ? obj.docsUrl : undefined,
+    };
+}
+// Read & parse the providers.json at `filePath`. Returns the validated spec
+// list (model entries normalized, types coerced). Throws GenericLoaderError
+// on file/JSON/schema problems. Used both by loadGenericProviders at boot
+// and by the admin UI's GET /admin/api/generic-providers handler.
+export function readSpecsFromFile(filePath) {
+    return loadFromFile(filePath);
+}
+// Atomically write a vetted spec list to `filePath`. Creates the parent
+// directory if missing. Throws on validation failure: every spec is run
+// through createGenericProvider first (which is what loadGenericProviders
+// would do at boot), and ids must be unique. The admin UI never persists
+// data that wouldn't load cleanly on restart.
+export function writeSpecsToFile(filePath, specs) {
+    const seen = new Set();
+    for (const spec of specs) {
+        if (!spec || typeof spec !== "object") {
+            throw new GenericLoaderError("each provider entry must be an object");
+        }
+        if (seen.has(spec.id)) {
+            throw new GenericLoaderError(`duplicate generic provider id "${spec.id}" — each id must appear once`);
+        }
+        seen.add(spec.id);
+        try {
+            // Build the Provider to run the same validation the boot path uses.
+            // We discard the result — only the side-effect of validation matters.
+            createGenericProvider(spec);
+        }
+        catch (err) {
+            if (err instanceof GenericProviderSpecError) {
+                throw new GenericLoaderError(err.message);
+            }
+            throw err;
+        }
+    }
+    const dir = dirname(filePath);
+    if (dir && !existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(filePath, JSON.stringify({ providers: specs }, null, 2) + "\n", "utf-8");
+}
+function loadFromFile(filePath) {
+    let text;
+    try {
+        text = readFileSync(filePath, "utf-8");
+    }
+    catch (err) {
+        throw new GenericLoaderError(`failed to read providers file ${filePath}: ${err.message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (err) {
+        throw new GenericLoaderError(`providers file ${filePath} is not valid JSON: ${err.message}`);
+    }
+    if (!parsed || typeof parsed !== "object") {
+        throw new GenericLoaderError(`providers file ${filePath} must be a JSON object`);
+    }
+    const raw = parsed.providers;
+    if (raw === undefined)
+        return [];
+    if (!Array.isArray(raw)) {
+        throw new GenericLoaderError(`providers file ${filePath}: .providers must be an array`);
+    }
+    return raw.map((item, idx) => parseSpec(item, idx));
+}
+// Env-only single-instance shortcut. When providers.json is absent but the
+// user has set GENERIC_BASE_URL + GENERIC_API_KEY + GENERIC_DEFAULT_MODEL,
+// we synthesize one provider with id "generic" — the simplest path for "I
+// just want to plug in one OpenAI-compat upstream".
+function loadFromEnv(env) {
+    const baseUrl = env.GENERIC_BASE_URL;
+    const defaultModel = env.GENERIC_DEFAULT_MODEL;
+    if (!baseUrl || !defaultModel)
+        return [];
+    // We don't require GENERIC_API_KEY to be set right now (it might be set
+    // later when the user passes --api-key). But envKey itself is required for
+    // resolveProviderRuntime to know which env var to read, so we hardcode
+    // "GENERIC_API_KEY" as the convention.
+    return [
+        {
+            id: "generic",
+            shortcut: env.GENERIC_SHORTCUT ?? "generic",
+            displayName: env.GENERIC_DISPLAY_NAME ?? "Generic (OpenAI-compatible)",
+            baseUrl,
+            envKey: "GENERIC_API_KEY",
+            defaultModel,
+            wireApi: env.GENERIC_WIRE_API === "responses" || env.GENERIC_WIRE_API === "chat"
+                ? env.GENERIC_WIRE_API
+                : undefined,
+            models: [],
+        },
+    ];
+}
+// Load all user-declared generic providers. Returns [] when nothing is
+// configured — existing mimo/deepseek behavior stays untouched.
+export function loadGenericProviders(env, dataDir) {
+    const filePath = resolveProvidersFile(env, dataDir);
+    let specs = [];
+    if (filePath) {
+        specs = loadFromFile(filePath);
+        log.debug(`loaded ${specs.length} generic provider(s) from ${filePath}`);
+    }
+    else {
+        specs = loadFromEnv(env);
+        if (specs.length > 0) {
+            log.debug(`synthesized 1 generic provider from GENERIC_* env vars`);
+        }
+    }
+    const seen = new Set();
+    const result = [];
+    for (const spec of specs) {
+        if (seen.has(spec.id)) {
+            throw new GenericLoaderError(`duplicate generic provider id "${spec.id}" — each id must appear once`);
+        }
+        seen.add(spec.id);
+        try {
+            result.push(createGenericProvider(spec));
+        }
+        catch (err) {
+            if (err instanceof GenericProviderSpecError) {
+                throw new GenericLoaderError(err.message);
+            }
+            throw err;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=genericLoader.js.map

package/dist/providers/genericLoader.js.map

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

package/dist/providers/registry.js

@@ -1,25 +1,63 @@
 import { mimo } from "./mimo.js";
 import { deepseek } from "./deepseek.js";
-export const PROVIDERS = {
-    mimo,
-    deepseek,
-};
-export const PROVIDER_LIST = [mimo, deepseek];
+// Built-in providers are always registered first. Generic providers loaded
+// at startup (from providers.json or GENERIC_* env vars) are appended via
+// initRegistry() before buildConfig() runs. The registry is mutable state
+// but transitions only once per process — there is no hot reload.
+const BUILTIN_PROVIDERS = [mimo, deepseek];
+// Single mutable container objects. Importers keep their reference and see
+// the updated contents after initRegistry() runs. This avoids Proxy gymnastics
+// while still letting the registry be populated lazily at startup.
+const providerListMutable = [...BUILTIN_PROVIDERS];
+const providersMapMutable = Object.fromEntries(BUILTIN_PROVIDERS.map((p) => [p.id, p]));
+export const PROVIDER_LIST = providerListMutable;
+export const PROVIDERS = providersMapMutable;
+// Initialize the registry with extra generic providers. Called once from
+// cli.ts main() before buildConfig(). Safe to call zero times — the
+// built-ins are present from module load.
+export function initRegistry(generics) {
+    // Reset to built-ins (idempotent — tests may call this multiple times).
+    providerListMutable.length = 0;
+    providerListMutable.push(...BUILTIN_PROVIDERS);
+    for (const key of Object.keys(providersMapMutable)) {
+        delete providersMapMutable[key];
+    }
+    for (const p of BUILTIN_PROVIDERS) {
+        providersMapMutable[p.id] = p;
+    }
+    for (const p of generics) {
+        if (providersMapMutable[p.id]) {
+            throw new Error(`provider id "${p.id}" collides with an already-registered provider — pick a different id`);
+        }
+        providerListMutable.push(p);
+        providersMapMutable[p.id] = p;
+    }
+}
 export function byShortcut(s) {
     const norm = s.toLowerCase();
-    return PROVIDER_LIST.find((p) => p.shortcut === norm || p.id === norm);
+    return providerListMutable.find((p) => p.shortcut === norm || p.id === norm);
 }
 // Find which provider owns a given client-supplied model id (or alias).
-// Used in PR2+ for per-request routing; in PR1 callers fall back to the
-// configured default provider when this returns undefined.
+// Used by selectProvider() in server.ts for per-request routing.
+//
+// Note: generic providers with empty `builtinModels` accept any model id via
+// their `resolveModel()` (untyped passthrough). To prevent such a generic
+// from "swallowing" every unknown id (which would defeat the configured
+// default provider's routing), we skip open-catalog generics in this lookup.
+// Routing to an open-catalog generic happens via `selectProvider` only when
+// it is the configured default provider, or when the user has declared
+// matching `models[]` in the spec.
 export function byClientModel(model) {
-    for (const p of PROVIDER_LIST) {
+    for (const p of providerListMutable) {
+        const isOpenCatalog = !p.builtinModels || p.builtinModels.length === 0;
+        if (isOpenCatalog)
+            continue;
         if (p.resolveModel(model))
             return p;
     }
     return undefined;
 }
 export function isProviderId(s) {
-    return s === "mimo" || s === "deepseek";
+    return Object.prototype.hasOwnProperty.call(providersMapMutable, s);
 }
 //# sourceMappingURL=registry.js.map

package/dist/providers/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,MAAM,CAAC,MAAM,SAAS,GAA2C;IAC/D,IAAI;IACJ,QAAQ;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAwB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAEnE,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7B,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;AACzE,CAAC;AAED,wEAAwE;AACxE,wEAAwE;AACxE,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QAC9B,IAAI,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,UAAU,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,2EAA2E;AAC3E,0EAA0E;AAC1E,0EAA0E;AAC1E,kEAAkE;AAClE,MAAM,iBAAiB,GAAwB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAEhE,2EAA2E;AAC3E,+EAA+E;AAC/E,mEAAmE;AACnE,MAAM,mBAAmB,GAAe,CAAC,GAAG,iBAAiB,CAAC,CAAC;AAC/D,MAAM,mBAAmB,GAA6B,MAAM,CAAC,WAAW,CACtE,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAwB,mBAAmB,CAAC;AACtE,MAAM,CAAC,MAAM,SAAS,GAA2C,mBAAmB,CAAC;AAErF,yEAAyE;AACzE,oEAAoE;AACpE,0CAA0C;AAC1C,MAAM,UAAU,YAAY,CAAC,QAA6B;IACxD,wEAAwE;IACxE,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/B,mBAAmB,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,CAAC;IAC/C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACnD,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAClC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,gBAAgB,CAAC,CAAC,EAAE,sEAAsE,CAC3F,CAAC;QACJ,CAAC;QACD,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5B,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7B,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;AAC/E,CAAC;AAED,wEAAwE;AACxE,iEAAiE;AACjE,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,wEAAwE;AACxE,6EAA6E;AAC7E,4EAA4E;AAC5E,uEAAuE;AACvE,mCAAmC;AACnC,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,KAAK,MAAM,CAAC,IAAI,mBAAmB,EAAE,CAAC;QACpC,MAAM,aAAa,GAAG,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC;QACvE,IAAI,aAAa;YAAE,SAAS;QAC5B,IAAI,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/server.js

@@ -2,7 +2,7 @@ import { createServer } from "node:http";
 import { respToResponses } from "./translate/respToResponses.js";
 import { pipeChatStreamToResponses } from "./translate/streamToSse.js";
 import { iterChatStreamChunks } from "./upstream/chatStream.js";
-import { callOpenAICompat, UpstreamError } from "./upstream/openaiCompatClient.js";
+import { callOpenAICompat, callResponsesPassthrough, UpstreamError, } from "./upstream/openaiCompatClient.js";
 import { byClientModel, PROVIDER_LIST, PROVIDERS } from "./providers/registry.js";
 import { makeServerResponseSink } from "./util/sse.js";
 import { log } from "./util/log.js";
@@ -197,6 +197,7 @@ async function handleResponses(cfg, req, res) {
         baseUrl: runtime.baseUrl,
         clientModel: payload.model,
         upstreamModel,
+        wireApi: provider.wireApi ?? "chat",
     });
     if (rewriteNotice) {
         log.warn("client model rewritten on the way upstream", {
@@ -206,6 +207,14 @@ async function handleResponses(cfg, req, res) {
             reason: rewriteNotice.reason,
         });
     }
+    if (provider.wireApi === "responses") {
+        return await handleResponsesPassthrough(cfg, req, res, payload, {
+            provider,
+            runtime,
+            upstreamModel,
+            rewriteNotice,
+        });
+    }
     const chat = provider.preprocessResponses(payload, {
         runtime,
         exposeReasoning: cfg.exposeReasoning,
@@ -373,6 +382,197 @@ async function handleResponses(cfg, req, res) {
         });
     }
 }
+// wireApi === "responses" path: forward Codex's Responses payload directly to
+// the upstream's /v1/responses endpoint, with no Chat-Completions translation.
+// Streaming pipes raw SSE bytes; non-streaming JSON is forwarded verbatim.
+async function handleResponsesPassthrough(cfg, req, res, payload, selected) {
+    const { provider, runtime, upstreamModel, rewriteNotice } = selected;
+    const stream = !!payload.stream;
+    const preprocessed = provider.preprocessResponsesPassthrough?.(payload, {
+        runtime,
+        exposeReasoning: cfg.exposeReasoning,
+    }) ?? payload;
+    // The routing layer determined upstreamModel; honor it over whatever the
+    // provider hook returned. preprocess hooks shouldn't normally rewrite model.
+    const forwardBody = {
+        ...preprocessed,
+        model: upstreamModel,
+        stream,
+    };
+    const ac = new AbortController();
+    req.on("close", () => ac.abort());
+    const startedAt = Date.now();
+    const requestBodySnapshot = bodyForLog(payload);
+    const rewriteLogFields = rewriteNotice
+        ? (() => {
+            const w = rewriteWarning(rewriteNotice);
+            return { error_code: w.code, error_snippet: w.message };
+        })()
+        : { error_code: null, error_snippet: null };
+    const baseEntry = {
+        request_id: null,
+        provider_id: provider.id,
+        client_model: payload.model,
+        upstream_model: upstreamModel,
+        endpoint: "/v1/responses",
+        stream,
+        request_body: requestBodySnapshot,
+    };
+    // Non-streaming path: parse upstream JSON and forward verbatim.
+    if (!stream) {
+        try {
+            const upstreamRes = await callResponsesPassthrough({
+                baseUrl: runtime.baseUrl,
+                apiKey: runtime.apiKey,
+                userAgent: cfg.userAgent,
+                enhanceError: provider.enhanceError.bind(provider),
+            }, forwardBody, ac.signal);
+            const json = (await upstreamRes.json());
+            sendJson(res, 200, json);
+            const usage = (json.usage ?? {});
+            recordLog(cfg, {
+                ...baseEntry,
+                request_id: typeof json.id === "string" ? json.id : null,
+                status_code: 200,
+                duration_ms: Date.now() - startedAt,
+                prompt_tokens: typeof usage.input_tokens === "number" ? usage.input_tokens : null,
+                completion_tokens: typeof usage.output_tokens === "number" ? usage.output_tokens : null,
+                total_tokens: typeof usage.total_tokens === "number" ? usage.total_tokens : null,
+                ...rewriteLogFields,
+                response_body: bodyForLog(json),
+                tool_call_count: null,
+            });
+            return;
+        }
+        catch (err) {
+            if (err instanceof UpstreamError) {
+                sendJson(res, err.status, errorEnvelope(err.status, err.code, err.message));
+                recordLog(cfg, {
+                    ...baseEntry,
+                    status_code: err.status,
+                    duration_ms: Date.now() - startedAt,
+                    prompt_tokens: null,
+                    completion_tokens: null,
+                    total_tokens: null,
+                    error_code: err.code,
+                    error_snippet: err.bodySnippet ?? err.message,
+                    response_body: null,
+                    tool_call_count: null,
+                });
+                return;
+            }
+            log.error("responses passthrough non-stream failed", { error: err.message });
+            sendJson(res, 500, errorEnvelope(500, "internal_error", err.message));
+            recordLog(cfg, {
+                ...baseEntry,
+                status_code: 500,
+                duration_ms: Date.now() - startedAt,
+                prompt_tokens: null,
+                completion_tokens: null,
+                total_tokens: null,
+                error_code: "internal_error",
+                error_snippet: err.message,
+                response_body: null,
+                tool_call_count: null,
+            });
+            return;
+        }
+    }
+    // Streaming path: pipe upstream SSE bytes directly to the client.
+    let upstreamRes;
+    try {
+        upstreamRes = await callResponsesPassthrough({
+            baseUrl: runtime.baseUrl,
+            apiKey: runtime.apiKey,
+            userAgent: cfg.userAgent,
+            enhanceError: provider.enhanceError.bind(provider),
+        }, forwardBody, ac.signal);
+    }
+    catch (err) {
+        if (err instanceof UpstreamError) {
+            sendJson(res, err.status, errorEnvelope(err.status, err.code, err.message));
+            recordLog(cfg, {
+                ...baseEntry,
+                status_code: err.status,
+                duration_ms: Date.now() - startedAt,
+                prompt_tokens: null,
+                completion_tokens: null,
+                total_tokens: null,
+                error_code: err.code,
+                error_snippet: err.bodySnippet ?? err.message,
+                response_body: null,
+                tool_call_count: null,
+            });
+            return;
+        }
+        log.error("responses passthrough stream pre-request failed", {
+            error: err.message,
+        });
+        sendJson(res, 500, errorEnvelope(500, "internal_error", err.message));
+        recordLog(cfg, {
+            ...baseEntry,
+            status_code: 500,
+            duration_ms: Date.now() - startedAt,
+            prompt_tokens: null,
+            completion_tokens: null,
+            total_tokens: null,
+            error_code: "internal_error",
+            error_snippet: err.message,
+            response_body: null,
+            tool_call_count: null,
+        });
+        return;
+    }
+    res.statusCode = 200;
+    res.setHeader("Content-Type", "text/event-stream; charset=utf-8");
+    res.setHeader("Cache-Control", "no-cache, no-transform");
+    res.setHeader("Connection", "keep-alive");
+    const keepalive = setInterval(() => {
+        if (!res.writableEnded)
+            res.write(": keepalive\n\n");
+    }, KEEPALIVE_INTERVAL_MS);
+    res.on("close", () => clearInterval(keepalive));
+    let streamError = null;
+    try {
+        if (!upstreamRes.body) {
+            throw new Error("upstream responded without a body");
+        }
+        const reader = upstreamRes.body.getReader();
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            if (value && value.length > 0) {
+                res.write(Buffer.from(value));
+            }
+        }
+        if (!res.writableEnded)
+            res.end();
+    }
+    catch (err) {
+        streamError = err;
+        log.error("responses passthrough mid-stream failed", { error: streamError.message });
+        if (!res.writableEnded) {
+            res.write(`event: error\ndata: ${JSON.stringify({ type: "error", code: "server_error", message: streamError.message, sequence_number: 9999 })}\n\n`);
+            res.end();
+        }
+    }
+    finally {
+        clearInterval(keepalive);
+        recordLog(cfg, {
+            ...baseEntry,
+            status_code: streamError ? 500 : 200,
+            duration_ms: Date.now() - startedAt,
+            prompt_tokens: null,
+            completion_tokens: null,
+            total_tokens: null,
+            error_code: streamError ? "stream_error" : rewriteLogFields.error_code,
+            error_snippet: streamError ? streamError.message : rewriteLogFields.error_snippet,
+            response_body: null,
+            tool_call_count: null,
+        });
+    }
+}
 function respondToResponsesProbe(payload, res, stream) {
     const id = `resp_probe_${Date.now()}`;
     const created_at = Math.floor(Date.now() / 1000);