betahi-copilot-bridge 0.20.8 → 0.20.10

package/README.md

@@ -1,7 +1,7 @@
 <h1 align="center">copilot-bridge</h1>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/betahi-copilot-bridge"><img src="https://img.shields.io/npm/v/betahi-copilot-bridge.svg?v=0.20.8" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/betahi-copilot-bridge"><img src="https://img.shields.io/npm/v/betahi-copilot-bridge.svg?v=0.20.10" alt="npm version"></a>
   <a href="https://github.com/betahi/copilot-bridge/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/betahi-copilot-bridge.svg" alt="license"></a>
 </p>
 
@@ -13,6 +13,7 @@
 
 ## Contents
 - [Demo](#demo)
+- [Why this bridge?](#why-this-bridge)
 - [Install & run](#install--run)
 - [Configure Codex CLI](#configure-codex-cli)
 - [Configure Claude Code](#configure-claude-code)
@@ -34,6 +35,19 @@
 
 ![Claude demo](assets/screenshots/claude_demo.png)
 
+## Why this bridge?
+
+copilot-bridge is more than a raw HTTP proxy:
+
+1. **Codex and Claude support.** Exposes Codex `/v1/responses`, Claude Code
+   `/v1/messages`, and OpenAI-compatible chat, embeddings, and models routes.
+2. **Web search support.** Model-selected web search can be executed by the
+   bridge and fed back into a final model pass.
+3. **End-to-end reasoning support.** Normalizes model aliases and
+   `reasoning_effort`, routes through the right upstream API, and preserves
+   returned `reasoning_text` / `reasoning_content` in streaming and
+   non-streaming responses.
+
 ## Install & run
 
 ```sh
@@ -83,6 +97,12 @@ requires_openai_auth = false
 Use `--no-codex-setup` to skip this writer if you manage
 `~/.codex/config.toml` yourself.
 
+The managed config also keeps Codex CLI's `/status` context-window display in
+sync with Copilot model metadata. For example, GPT-5.5 shows a 1.05M context
+window through the bridge:
+
+![Codex context window](assets/screenshots/codex_2.png)
+
 ### Codex warning: "Model metadata ... not found"
 
 This is a Codex client-side metadata warning, not a bridge routing failure, requests can still complete through the bridge.
@@ -169,7 +189,7 @@ COPILOT_WEB_SEARCH_BACKEND = "gpt-5.5"
 
 | Value | Search path | Requirement |
 | ----- | ----------- | ----------- |
-| Copilot model id, for example `gpt-5.5` | Copilot HTTP `/responses` + `web_search_preview` | The model must support Copilot Responses web search. |
+| Copilot model id, for example `gpt-5.5` | Copilot HTTP `/responses` + `web_search_preview` | Recommended: `gpt-5.5`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.3-codex`, `gpt-5.2`, `gpt-5.2-codex`. |
 | `searxng`, use `"COPILOT_WEB_SEARCH_BACKEND": "searxng"` | Local SearXNG at `http://localhost:8080` | Start SearXNG yourself. Setup guide: https://github.com/betaHi/openclaw-searxng-search. |
 | `copilot-cli` or `copilot`, use `"COPILOT_WEB_SEARCH_BACKEND": "copilot-cli"` | GitHub Copilot CLI `web_search` tool, using the current request model | Install and sign in to GitHub Copilot CLI yourself. |
 
@@ -254,11 +274,11 @@ accepts upstream.
 | Model                            | Reasoning efforts                       | Notes                                  |
 | -------------------------------- | --------------------------------------- | -------------------------------------- |
 | `claude-opus-4.7`                | `medium`                                | Effort sent as `output_config.effort`. |
-| `claude-opus-4.7-1m`             | `low`, `medium`, `high`, `xhigh`        | 1M-token context window; effort sent as `output_config.effort`. |
-| `claude-opus-4.7-high`           | `high`                                  | Fixed high reasoning; effort sent as `output_config.effort`. |
-| `claude-opus-4.7-xhigh`          | `xhigh`                                 | Fixed extra-high reasoning; effort sent as `output_config.effort`. |
+| `claude-opus-4.7-1m`             | `low`, `medium`, `high`, `xhigh`        | 1M-token context window, prefer use `claude-opus-4.7-[1m]` in config|
+| `claude-opus-4.7-high`           | `high`                                  | Fixed high reasoning|
+| `claude-opus-4.7-xhigh`          | `xhigh`                                 | Fixed extra-high reasoning|
 | `claude-opus-4.6`                | `low`, `medium`, `high`                 |                                        |
-| `claude-opus-4.6-1m`             | `low`, `medium`, `high`                 | 1M-token context window.               |
+| `claude-opus-4.6-1m`             | `low`, `medium`, `high`                 | 1M-token context window, prefer use `claude-opus-4.6-[1m]` in config              |
 | `claude-sonnet-4.6`              | `low`, `medium`, `high`                 |                                        |
 | `claude-opus-4.5`                | —                                       | Reasoning not accepted upstream.       |
 | `claude-sonnet-4.5`              | —                                       | Reasoning not accepted upstream.       |

package/dist/main.js

@@ -3,9 +3,11 @@ import { defineCommand, runMain } from "citty";
 import consola from "consola";
 import fs, { appendFile } from "node:fs/promises";
 import os from "node:os";
-import path from "node:path";
+import path, { dirname, resolve } from "node:path";
 import { createHash, randomUUID } from "node:crypto";
 import { z } from "zod";
+import { accessSync, constants, readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 import { serve } from "@hono/node-server";
 import { Hono } from "hono";
 import { cors } from "hono/cors";
@@ -13,7 +15,6 @@ import { logger } from "hono/logger";
 import { streamSSE } from "hono/streaming";
 import { events } from "fetch-event-stream";
 import { execFile } from "node:child_process";
-import { accessSync, constants } from "node:fs";
 
 //#region src/lib/error.ts
 var BridgeNotImplementedError = class extends Error {
@@ -148,8 +149,8 @@ const standardHeaders = () => ({
 	accept: "application/json",
 	"content-type": "application/json"
 });
-const sleep$1 = (ms) => new Promise((resolve) => {
-	setTimeout(resolve, ms);
+const sleep$1 = (ms) => new Promise((resolve$1) => {
+	setTimeout(resolve$1, ms);
 });
 const readGitHubToken$1 = async () => {
 	return (await fs.readFile(PATHS.GITHUB_TOKEN_PATH, "utf8")).trim();
@@ -208,7 +209,7 @@ const getCopilotToken = async (githubToken, vsCodeVersion) => {
 	return await response.json();
 };
 const isCopilotTokenError = (error) => error instanceof HTTPError && error.message === "Failed to get Copilot token";
-const ensureGitHubToken = async (config, options = {}) => {
+const ensureGitHubToken = async (options = {}) => {
 	await ensurePaths();
 	const existingToken = options.force ? "" : await readGitHubToken$1();
 	if (existingToken) return existingToken;
@@ -217,17 +218,23 @@ const ensureGitHubToken = async (config, options = {}) => {
 	const githubToken = await pollAccessToken(deviceCode);
 	await writeGitHubToken(githubToken);
 	if (options.showToken) consola.info("GitHub token:", githubToken);
-	const user = await getGitHubUser(githubToken, config.vsCodeVersion);
-	consola.success(`Logged in as ${user.login}`);
 	return githubToken;
 };
+const loadGitHubLogin = async (githubToken, vsCodeVersion) => {
+	try {
+		return (await getGitHubUser(githubToken, vsCodeVersion)).login;
+	} catch (error) {
+		consola.warn("Could not load GitHub user:", error);
+		return;
+	}
+};
 const setupBridgeAuth = async (config, options = {}) => {
 	if (config.copilotToken) {
 		if (options.showToken) consola.info("Using COPILOT_TOKEN from environment");
 		await loadModels(config);
-		return;
+		return { source: "copilot-token" };
 	}
-	let githubToken = await ensureGitHubToken(config, options);
+	let githubToken = await ensureGitHubToken(options);
 	const applyCopilotToken = async () => {
 		const { refresh_in, token } = await getCopilotToken(githubToken, config.vsCodeVersion);
 		config.copilotToken = token;
@@ -240,7 +247,7 @@ const setupBridgeAuth = async (config, options = {}) => {
 	} catch (error) {
 		if (options.force || !isCopilotTokenError(error)) throw error;
 		consola.warn("Cached GitHub auth could not get a Copilot token; running device auth again.");
-		githubToken = await ensureGitHubToken(config, {
+		githubToken = await ensureGitHubToken({
 			...options,
 			force: true
 		});
@@ -256,6 +263,10 @@ const setupBridgeAuth = async (config, options = {}) => {
 		}
 	}, refreshInterval);
 	await loadModels(config);
+	return {
+		githubLogin: await loadGitHubLogin(githubToken, config.vsCodeVersion),
+		source: "github-token"
+	};
 };
 const loadModels = async (config) => {
 	try {
@@ -321,10 +332,11 @@ const auth = defineCommand({
 			port: Number(args.port)
 		});
 		config.copilotToken = void 0;
-		await setupBridgeAuth(config, {
+		const authSession = await setupBridgeAuth(config, {
 			force: true,
 			showToken: args["show-token"]
 		});
+		if (authSession.githubLogin) consola.info(`Logged in as ${authSession.githubLogin}`);
 		consola.success("copilot-bridge auth completed");
 	}
 });
@@ -458,6 +470,12 @@ const BEGIN_MARK = "# >>> copilot-bridge managed block — auto-generated, do no
 const END_MARK = "# <<< copilot-bridge managed block — edits outside this block are preserved <<<";
 const LEGACY_BEGIN_MARK = "# >>> copilot-bridge managed (do not edit) >>>";
 const LEGACY_END_MARK = "# <<< copilot-bridge managed (do not edit) <<<";
+const MANAGED_MARKERS = new Set([
+	BEGIN_MARK,
+	END_MARK,
+	LEGACY_BEGIN_MARK,
+	LEGACY_END_MARK
+]);
 function normalizeCodexConfigReasoningEffort(value) {
 	switch (value?.toLowerCase()) {
 		case "none":
@@ -475,9 +493,11 @@ function tomlEscape(value) {
 }
 function buildManagedBlock(input) {
 	const { baseUrl, settings } = input;
+	const modelContextWindow = normalizeModelContextWindow(input.modelContextWindow);
 	const lines = [];
 	lines.push(BEGIN_MARK);
 	if (settings.setAsDefault) lines.push(`model_provider = "${tomlEscape(settings.providerId)}"`);
+	if (modelContextWindow !== void 0) lines.push(`model_context_window = ${modelContextWindow}`);
 	lines.push("model_supports_reasoning_summaries = true");
 	lines.push("");
 	lines.push(`[model_providers.${settings.providerId}]`);
@@ -489,6 +509,15 @@ function buildManagedBlock(input) {
 	lines.push(END_MARK);
 	return lines.join("\n");
 }
+function extractPreservedContentFromManagedBlock(content) {
+	const lines = content.split("\n");
+	const preserveStart = lines.findIndex((line) => {
+		const trimmed = line.trim();
+		return trimmed.startsWith("[") && !trimmed.startsWith("[model_providers.");
+	});
+	if (preserveStart === -1) return "";
+	return lines.slice(preserveStart).join("\n").replace(/^\n+|\n+$/g, "");
+}
 function stripManagedBlock(content) {
 	let next = content;
 	for (const [begin, end] of [[BEGIN_MARK, END_MARK], [LEGACY_BEGIN_MARK, LEGACY_END_MARK]]) while (true) {
@@ -496,14 +525,33 @@ function stripManagedBlock(content) {
 		if (beginIdx === -1) break;
 		const endIdx = next.indexOf(end, beginIdx);
 		if (endIdx === -1) break;
+		const preserved = extractPreservedContentFromManagedBlock(next.slice(beginIdx + begin.length, endIdx));
 		const before = next.slice(0, beginIdx).replace(/\n*$/, "");
-		const after = next.slice(endIdx + end.length).replace(/^\n+/, "");
+		const after = [preserved, next.slice(endIdx + end.length)].filter(Boolean).join("\n").replace(/^\n+/, "");
 		if (before.length === 0) next = after;
 		else if (after.length === 0) next = `${before}\n`;
 		else next = `${before}\n\n${after}`;
 	}
 	return next;
 }
+function removeStrayManagedMarkerLines(content) {
+	return content.split("\n").filter((line) => !MANAGED_MARKERS.has(line.trim())).join("\n");
+}
+function removeManagedProviderTables(content, providerId) {
+	const lines = content.split("\n");
+	const out = [];
+	const tableHeader = `[model_providers.${providerId}]`;
+	for (let i = 0; i < lines.length;) {
+		if (lines[i].trim() === tableHeader) {
+			i += 1;
+			while (i < lines.length && !/^\s*\[/.test(lines[i])) i += 1;
+			continue;
+		}
+		out.push(lines[i]);
+		i += 1;
+	}
+	return out.join("\n").replace(/\n{3,}/g, "\n\n");
+}
 function splitTopSection(content) {
 	const lines = content.split("\n");
 	let cut = lines.length;
@@ -541,6 +589,22 @@ function removeTopKey(topSection, key) {
 	const re = /* @__PURE__ */ new RegExp(`^\\s*${key}\\s*=`);
 	return lines.filter((line) => !re.test(line)).join("\n");
 }
+function normalizeModelContextWindow(value) {
+	if (value === void 0 || !Number.isFinite(value)) return;
+	const normalized = Math.trunc(value);
+	return normalized > 0 ? normalized : void 0;
+}
+function removeManagedTopLevelKeys(content, input) {
+	const { top, rest } = splitTopSection(content);
+	let nextTop = top;
+	if (input.settings.setAsDefault) nextTop = removeTopKey(nextTop, "model_provider");
+	if (normalizeModelContextWindow(input.modelContextWindow) !== void 0) nextTop = removeTopKey(nextTop, "model_context_window");
+	nextTop = removeTopKey(nextTop, "model_supports_reasoning_summaries");
+	if (nextTop === top) return content;
+	if (rest.length === 0) return nextTop.endsWith("\n") ? nextTop : `${nextTop}\n`;
+	const sep = nextTop.endsWith("\n") ? "" : "\n";
+	return `${nextTop}${sep}${rest}`;
+}
 function sanitizeTopReasoningEffort(topSection) {
 	const match = topSection.match(scalarRegex("model_reasoning_effort"));
 	if (!match) return topSection;
@@ -570,10 +634,17 @@ async function applyCodexConfig(input) {
 		created = true;
 	}
 	let stripped = stripManagedBlock(existing);
+	stripped = removeStrayManagedMarkerLines(stripped);
+	stripped = removeManagedProviderTables(stripped, input.settings.providerId);
 	stripped = applyUserScalars(stripped, input);
+	stripped = removeManagedTopLevelKeys(stripped, input);
 	const block = buildManagedBlock(input);
-	const trimmed = stripped.replace(/\n+$/, "");
-	const next = trimmed.length === 0 ? `${block}\n` : `${trimmed}\n\n${block}\n`;
+	const { top, rest } = splitTopSection(stripped);
+	const next = `${[
+		top,
+		block,
+		rest
+	].map((part) => part.replace(/^\n+|\n+$/g, "")).filter(Boolean).join("\n\n")}\n`;
 	if (next === existing) return {
 		configPath,
 		changed: false,
@@ -858,10 +929,28 @@ const clampReasoningEffort = (modelId, requested) => {
 	};
 };
 
+//#endregion
+//#region src/lib/version.ts
+const PACKAGE_NAME = "betahi-copilot-bridge";
+const readPackageVersion = () => {
+	let currentDir = dirname(fileURLToPath(import.meta.url));
+	while (true) {
+		try {
+			const packageJsonPath = resolve(currentDir, "package.json");
+			const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+			if (packageJson.name === PACKAGE_NAME && typeof packageJson.version === "string") return packageJson.version;
+		} catch {}
+		const parentDir = dirname(currentDir);
+		if (parentDir === currentDir) return "unknown";
+		currentDir = parentDir;
+	}
+};
+const BRIDGE_VERSION = readPackageVersion();
+
 //#endregion
 //#region src/lib/rate-limit.ts
-const sleep = (ms) => new Promise((resolve) => {
-	setTimeout(resolve, ms);
+const sleep = (ms) => new Promise((resolve$1) => {
+	setTimeout(resolve$1, ms);
 });
 /**
 * Enforces the configured rate limit window between mutating upstream calls.
@@ -2492,7 +2581,7 @@ const findCopilotCliCommand = () => {
 	const candidates = (process.env.PATH ?? "").split(path.delimiter).filter(Boolean).flatMap((directory) => copilotExecutableNames().map((name) => path.join(directory, name))).filter(canExecute);
 	return candidates.find((candidate) => !COPILOT_CHAT_WRAPPER_PATH_PATTERN.test(candidate)) ?? candidates[0] ?? "copilot";
 };
-const runCopilotCliCommand = (args, timeout) => new Promise((resolve, reject) => {
+const runCopilotCliCommand = (args, timeout) => new Promise((resolve$1, reject) => {
 	execFile(findCopilotCliCommand(), args, {
 		encoding: "utf8",
 		timeout
@@ -2505,7 +2594,7 @@ const runCopilotCliCommand = (args, timeout) => new Promise((resolve, reject) =>
 			});
 			return;
 		}
-		resolve({
+		resolve$1({
 			stdout,
 			stderr
 		});
@@ -4067,6 +4156,12 @@ const fetchAvailableModels = async (config) => {
 		return [];
 	}
 };
+const getCodexModelContextWindow = (model) => {
+	if (!model) return void 0;
+	const resolvedModel = resolveModelId(model);
+	const contextWindow = (runtimeState.models?.data.find((candidate) => candidate.id === resolvedModel || candidate.id === model || getPublicModelId(candidate.id) === model || getPublicModelId(candidate.id) === resolvedModel))?.capabilities?.limits?.max_context_window_tokens;
+	return typeof contextWindow === "number" && contextWindow > 0 ? Math.trunc(contextWindow) : void 0;
+};
 const start = defineCommand({
 	meta: {
 		name: "start",
@@ -4142,8 +4237,12 @@ const start = defineCommand({
 			runtimeState.rateLimitWait = Boolean(args.wait);
 			consola.info(`Rate limit: ${parsed}s between requests (${runtimeState.rateLimitWait ? "wait" : "reject"} on overflow)`);
 		}
-		await setupBridgeAuth(config, { showToken: args["show-token"] });
+		const authSession = await setupBridgeAuth(config, { showToken: args["show-token"] });
 		const server = startServer(config);
+		consola.info(`copilot-bridge version: ${BRIDGE_VERSION}`);
+		if (authSession.githubLogin) consola.info(`GitHub user: ${authSession.githubLogin}`);
+		else if (authSession.source === "copilot-token") consola.info("GitHub user: unavailable (using COPILOT_TOKEN)");
+		else consola.warn("GitHub user: unavailable");
 		consola.success(`copilot-bridge listening on http://${config.host}:${config.port}`);
 		consola.info(`copilot base url: ${config.copilotBaseUrl}`);
 		const baseUrl = `http://${config.host}:${config.port}`;
@@ -4180,7 +4279,8 @@ const start = defineCommand({
 				configPath: codexConfigPath,
 				settings: CODEX_DEFAULTS,
 				model: chosenModel,
-				modelReasoningEffort: chosenEffort
+				modelReasoningEffort: chosenEffort,
+				modelContextWindow: getCodexModelContextWindow(chosenModel)
 			});
 			if (result.changed) {
 				consola.success(`codex config ${result.created ? "created" : "updated"}: ${result.configPath}`);
@@ -4221,7 +4321,8 @@ const start = defineCommand({
 						configPath: codexConfigPath,
 						settings: CODEX_DEFAULTS,
 						model: chosenModel,
-						modelReasoningEffort: chosenEffort
+						modelReasoningEffort: chosenEffort,
+						modelContextWindow: getCodexModelContextWindow(chosenModel)
 					});
 					if (result.changed) consola.success(`codex config updated: ${result.configPath}`);
 				} catch (error) {
@@ -4229,8 +4330,8 @@ const start = defineCommand({
 				}
 			}
 		}
-		await new Promise((resolve, reject) => {
-			server.on("close", resolve);
+		await new Promise((resolve$1, reject) => {
+			server.on("close", resolve$1);
 			server.on("error", reject);
 		});
 	}