betahi-copilot-bridge 0.20.7 → 0.20.9

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.7" 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.8" 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
@@ -169,7 +183,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 +268,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");
 	}
 });
@@ -475,9 +487,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 +503,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,8 +519,9 @@ 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}`;
@@ -541,6 +565,19 @@ 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 removeTopLevelContextWindowWhenManaged(content, input) {
+	if (normalizeModelContextWindow(input.modelContextWindow) === void 0) return content;
+	const { top, rest } = splitTopSection(content);
+	const nextTop = removeTopKey(top, "model_context_window");
+	if (nextTop === top) return content;
+	if (rest.length === 0) return nextTop.endsWith("\n") ? nextTop : `${nextTop}\n`;
+	return `${nextTop}${nextTop.endsWith("\n") ? "" : "\n"}${rest}`;
+}
 function sanitizeTopReasoningEffort(topSection) {
 	const match = topSection.match(scalarRegex("model_reasoning_effort"));
 	if (!match) return topSection;
@@ -571,9 +608,14 @@ async function applyCodexConfig(input) {
 	}
 	let stripped = stripManagedBlock(existing);
 	stripped = applyUserScalars(stripped, input);
+	stripped = removeTopLevelContextWindowWhenManaged(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 +900,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 +2552,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 +2565,7 @@ const runCopilotCliCommand = (args, timeout) => new Promise((resolve, reject) =>
 			});
 			return;
 		}
-		resolve({
+		resolve$1({
 			stdout,
 			stderr
 		});
@@ -2666,6 +2726,9 @@ const webSearchResponseToEvents = (response) => {
 			content_block: block.type === "text" ? {
 				type: "text",
 				text: ""
+			} : block.type === "server_tool_use" || block.type === "tool_use" ? {
+				...block,
+				input: {}
 			} : block
 		});
 		if (block.type === "text" && block.text) events$1.push({
@@ -2676,7 +2739,7 @@ const webSearchResponseToEvents = (response) => {
 				text: block.text
 			}
 		});
-		else if (block.type === "server_tool_use") events$1.push({
+		else if (block.type === "server_tool_use" || block.type === "tool_use") events$1.push({
 			type: "content_block_delta",
 			index,
 			delta: {
@@ -4064,6 +4127,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",
@@ -4139,8 +4208,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}`;
@@ -4177,7 +4250,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}`);
@@ -4218,7 +4292,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) {
@@ -4226,8 +4301,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);
 		});
 	}