offrouter-core 0.2.0 → 0.2.2

package/dist/proxy/responses-server.js

@@ -0,0 +1,360 @@
+/**
+ * Local OpenAI Responses-compatible proxy server.
+ *
+ * Exposes POST /v1/responses (and an optional /v1/chat/completions alias) so
+ * harnesses or apps that support custom model base URLs can route through
+ * OffRouter. Each request is policy-checked, routed to the best allowed
+ * provider (subscription-first), invoked via the provider adapter, and streamed
+ * back in OpenAI Responses (or Chat Completions) SSE format.
+ *
+ * Local-first: binds to 127.0.0.1 by default. An optional bearer token gates
+ * access; when unset the proxy runs in loopback-only dev mode and warns.
+ *
+ * Built on node:http with no external framework.
+ */
+import { createHash, timingSafeEqual } from "node:crypto";
+import { createServer } from "node:http";
+import { routeRequest } from "../router.js";
+import { buildDelegationRequest, buildRouteRequest, ChatCompletionsSseBuilder, CHAT_COMPLETIONS_DONE, extractPromptFromChatCompletions, extractPromptFromResponsesInput, openAiErrorPayload, policyDecisionToHttpStatus, providerErrorCodeToHttpStatus, responsesSseData, ResponsesSseBuilder, } from "./responses-mapper.js";
+const DEFAULT_PORT = 8787;
+const DEFAULT_HOST = "127.0.0.1";
+const DEFAULT_HARNESS = { kind: "other", profile: "proxy" };
+const SSE_HEADERS = {
+    "content-type": "text/event-stream; charset=utf-8",
+    "cache-control": "no-cache",
+    connection: "keep-alive",
+    "x-accel-buffering": "no",
+};
+/**
+ * Start the local proxy and resolve once it is listening.
+ * Returns a handle whose `close()` stops the server.
+ */
+export function startResponsesProxy(context, options = {}) {
+    const host = options.host ?? DEFAULT_HOST;
+    const port = options.port ?? DEFAULT_PORT;
+    const token = options.token;
+    const harness = options.harness ?? DEFAULT_HARNESS;
+    const workspace = options.workspace ?? {
+        cwd: process.cwd(),
+        trusted: true,
+    };
+    const now = options.now ?? (() => new Date());
+    const warn = options.warn ?? ((message) => console.warn(message));
+    if (token === undefined) {
+        warn("OffRouter proxy: OFFROUTER_PROXY_TOKEN unset; running in dev mode on loopback only.");
+    }
+    const server = createServer((req, res) => {
+        void handleRequest(req, res, context, {
+            token,
+            harness,
+            workspace,
+            now,
+        }).catch((err) => {
+            sendError(res, 500, errorMessage(err), "internal_error");
+        });
+    });
+    return new Promise((resolve, reject) => {
+        const onError = (err) => {
+            server.removeListener("error", onError);
+            reject(err);
+        };
+        server.once("error", onError);
+        server.listen(port, host, () => {
+            server.removeListener("error", onError);
+            const address = server.address();
+            const actualPort = typeof address === "object" && address ? address.port : port;
+            resolve({
+                port: actualPort,
+                host,
+                close: () => new Promise((closeResolve, closeReject) => {
+                    server.close((err) => (err ? closeReject(err) : closeResolve()));
+                }),
+            });
+        });
+    });
+}
+async function handleRequest(req, res, context, deps) {
+    if (req.method !== "POST") {
+        sendError(res, 404, "Not found", "not_found");
+        return;
+    }
+    const format = formatForPath(req.url ?? "");
+    if (!format) {
+        sendError(res, 404, "Not found", "not_found");
+        return;
+    }
+    if (!authorize(req, deps.token)) {
+        sendError(res, 401, "Missing or invalid bearer token.", "authentication_error");
+        return;
+    }
+    const body = await readBody(req);
+    let parsed;
+    try {
+        parsed =
+            format === "responses"
+                ? extractPromptFromResponsesInput(body)
+                : extractPromptFromChatCompletions(body);
+    }
+    catch {
+        sendError(res, 400, "Invalid request body.", "invalid_request_error");
+        return;
+    }
+    await streamResponse(req, res, context, deps, parsed, format);
+}
+function formatForPath(url) {
+    const path = url.split("?")[0];
+    if (path === "/v1/responses")
+        return "responses";
+    if (path === "/v1/chat/completions")
+        return "chat";
+    return null;
+}
+function authorize(req, token) {
+    if (token === undefined)
+        return true; // dev loopback mode
+    const header = req.headers["authorization"];
+    if (typeof header !== "string")
+        return false;
+    const expected = `Bearer ${token}`;
+    // Constant-time compare: hash both inputs to fixed-length digests so
+    // crypto.timingSafeEqual always receives equal-length buffers.
+    return safeEqual(header, expected);
+}
+function safeEqual(a, b) {
+    const da = createHash("sha256").update(a, "utf8").digest();
+    const db = createHash("sha256").update(b, "utf8").digest();
+    return timingSafeEqual(da, db);
+}
+async function readBody(req) {
+    const chunks = [];
+    for await (const chunk of req) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    const text = Buffer.concat(chunks).toString("utf8").trim();
+    if (text.length === 0)
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new Error("request body is not valid JSON");
+    }
+}
+async function streamResponse(req, res, context, deps, parsed, format) {
+    const route = buildRouteRequest({
+        prompt: parsed.prompt,
+        harness: deps.harness,
+        workspace: deps.workspace,
+    });
+    // Policy gate with digest/preview only (raw prompt never reaches routing).
+    const decision = routeRequest(route, context.candidates, context.policy);
+    if (decision.blocked || !decision.route) {
+        const status = policyDecisionToHttpStatus(decision);
+        const message = decision.explanation || decision.reason || "routing blocked by policy";
+        sendError(res, status, message, decision.needsConfiguration ? "needs_configuration" : "policy_blocked");
+        return;
+    }
+    const delegation = buildDelegationRequest({
+        prompt: parsed.prompt,
+        route,
+        maxOutputTokens: parsed.maxOutputTokens,
+        temperature: parsed.temperature,
+    });
+    const taskId = delegation.taskId;
+    let settled = false;
+    const onClose = () => {
+        if (!settled && !res.writableEnded) {
+            void context.runtime.cancel(taskId).catch(() => undefined);
+        }
+    };
+    // res 'close' is the canonical client-disconnect signal: it fires when the
+    // underlying connection terminates before the response completes.
+    res.on("close", onClose);
+    req.on("close", onClose);
+    try {
+        await pump(context, res, delegation, parsed, format, deps, () => {
+            settled = true;
+        });
+    }
+    catch (err) {
+        if (!res.headersSent) {
+            const status = 500;
+            sendError(res, status, errorMessage(err), "internal_error");
+            return;
+        }
+        safeEnd(res);
+    }
+    finally {
+        settled = true;
+        res.off("close", onClose);
+        req.off("close", onClose);
+    }
+}
+async function pump(context, res, delegation, parsed, format, deps, markSettled) {
+    // Only an explicit stream:false opts out of SSE; omitting stream (or true)
+    // keeps the streaming path identical to prior behavior.
+    const wantStream = parsed.stream !== false;
+    const responsesBuilder = new ResponsesSseBuilder("", deps.now);
+    const chatBuilder = new ChatCompletionsSseBuilder("", deps.now);
+    let headersSent = false;
+    const sendHeaders = () => {
+        if (headersSent)
+            return;
+        headersSent = true;
+        res.writeHead(200, SSE_HEADERS);
+        if (format === "responses") {
+            safeWrite(res, responsesSseData(responsesBuilder.createdEvent()));
+        }
+        else {
+            safeWrite(res, responsesSseData(chatBuilder.firstEvent()));
+        }
+    };
+    const eventStream = context.runtime.stream(delegation);
+    try {
+        for await (const event of eventStream) {
+            switch (event.type) {
+                case "start": {
+                    if (event.model) {
+                        responsesBuilder.setModel(event.model);
+                        chatBuilder.setModel(event.model);
+                    }
+                    break;
+                }
+                case "text-delta": {
+                    responsesBuilder.addText(event.text);
+                    chatBuilder.addText(event.text);
+                    if (wantStream) {
+                        sendHeaders();
+                        if (format === "responses") {
+                            safeWrite(res, responsesSseData(responsesBuilder.deltaEvent(event.text)));
+                        }
+                        else {
+                            safeWrite(res, responsesSseData(chatBuilder.deltaEvent(event.text)));
+                        }
+                    }
+                    break;
+                }
+                case "usage": {
+                    responsesBuilder.setUsage({
+                        inputTokens: event.inputTokens,
+                        outputTokens: event.outputTokens,
+                        totalTokens: event.totalTokens,
+                    });
+                    chatBuilder.setUsage({
+                        promptTokens: event.inputTokens,
+                        completionTokens: event.outputTokens,
+                        totalTokens: event.totalTokens,
+                    });
+                    break;
+                }
+                case "done": {
+                    if (wantStream) {
+                        sendHeaders();
+                        finalize(res, format, responsesBuilder, chatBuilder);
+                    }
+                    else {
+                        sendNonStreamJson(res, format, responsesBuilder, chatBuilder);
+                    }
+                    markSettled();
+                    return;
+                }
+                case "error": {
+                    if (!res.headersSent) {
+                        // Provider failed before any content was flushed.
+                        const status = event.code !== undefined
+                            ? providerErrorCodeToHttpStatus(event.code)
+                            : 500;
+                        sendError(res, status, event.message, event.code ?? "internal_error");
+                    }
+                    else {
+                        // Mid-stream error: emit an SSE error frame and close.
+                        safeWrite(res, responsesSseData({
+                            type: "error",
+                            error: {
+                                message: event.message,
+                                code: event.code ?? "internal_error",
+                            },
+                        }));
+                        finalize(res, format, responsesBuilder, chatBuilder, true);
+                    }
+                    markSettled();
+                    return;
+                }
+                case "cancelled": {
+                    if (!res.headersSent) {
+                        res.writeHead(499, { "content-type": "application/json" });
+                    }
+                    finalize(res, format, responsesBuilder, chatBuilder, true);
+                    markSettled();
+                    return;
+                }
+                default:
+                    break;
+            }
+        }
+        // Stream ended without an explicit done: finalize gracefully.
+        if (wantStream) {
+            if (!headersSent)
+                sendHeaders();
+            finalize(res, format, responsesBuilder, chatBuilder);
+        }
+        else {
+            sendNonStreamJson(res, format, responsesBuilder, chatBuilder);
+        }
+    }
+    finally {
+        markSettled();
+    }
+}
+/** Emit a single JSON response object for non-streaming requests. */
+function sendNonStreamJson(res, format, responsesBuilder, chatBuilder) {
+    if (res.writableEnded || res.destroyed)
+        return;
+    const body = format === "responses"
+        ? JSON.stringify(responsesBuilder.responseObject())
+        : JSON.stringify(chatBuilder.completionObject());
+    res.writeHead(200, {
+        "content-type": "application/json; charset=utf-8",
+        "content-length": Buffer.byteLength(body).toString(),
+    });
+    res.end(body);
+}
+function finalize(res, format, responsesBuilder, chatBuilder, aborted = false) {
+    if (res.writableEnded || res.destroyed)
+        return;
+    if (format === "responses" && !aborted) {
+        safeWrite(res, responsesSseData(responsesBuilder.completedEvent()));
+    }
+    else if (format === "chat" && !aborted) {
+        safeWrite(res, responsesSseData(chatBuilder.doneEvent()));
+        safeWrite(res, CHAT_COMPLETIONS_DONE);
+    }
+    safeEnd(res);
+}
+function safeWrite(res, chunk) {
+    if (res.writableEnded || res.destroyed)
+        return;
+    res.write(chunk);
+}
+function safeEnd(res) {
+    if (res.writableEnded || res.destroyed)
+        return;
+    res.end();
+}
+function sendError(res, status, message, code) {
+    if (res.headersSent) {
+        safeEnd(res);
+        return;
+    }
+    const payload = openAiErrorPayload(status, message, code);
+    const body = JSON.stringify(payload);
+    res.writeHead(status, {
+        "content-type": "application/json; charset=utf-8",
+        "content-length": Buffer.byteLength(body).toString(),
+    });
+    res.end(body);
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=responses-server.js.map

package/dist/proxy/responses-server.js.map

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

package/dist/router.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Deterministic model scoring and route explain for OffRouter V1.
+ */
+import { type PolicyConfig } from "./policy.js";
+import type { ProviderCandidate, RouteDecision, RouteRequest } from "./types.js";
+export interface RouteOptions {
+    /** Optional decision id factory for tests; defaults to deterministic hash-ish id. */
+    decisionId?: string;
+}
+declare function sortCandidates(candidates: ProviderCandidate[]): ProviderCandidate[];
+/**
+ * Route a request against candidates under policy.
+ * Pure and deterministic: same inputs -> same decision (except optional decisionId).
+ */
+export declare function routeRequest(request: RouteRequest, candidates: ProviderCandidate[], config: PolicyConfig, options?: RouteOptions): RouteDecision;
+/** @internal exported for focused testing */
+export { sortCandidates };
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,KAAK,EAGV,iBAAiB,EACjB,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC3B,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAwCD,iBAAS,cAAc,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAgB5E;AAsFD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,iBAAiB,EAAE,EAC/B,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,YAAiB,GACzB,aAAa,CAqLf;AAED,6CAA6C;AAC7C,OAAO,EAAE,cAAc,EAAE,CAAC"}