@fudrouter/fsrouter 0.6.64 → 0.6.66

package/open-sse/AGENTS.md

@@ -0,0 +1,39 @@
+# open-sse
+
+Provider-agnostic SSE engine: one OpenAI-style request → any provider (LLM chat, image, embedding, tts, stt, search), streamed back in the client's format.
+
+## Request lifecycle (chat)
+
+`handlers/chatCore.js` → `services/model.js` `parseModel` (resolve `provider/model`) → **pre-translate hooks** (`rtk/` tool_result compress, `rtk/headroom.js` proxy compress, `rtk/caveman.js` system inject — all fail-open) → `executors/index.js` `getExecutor(provider)` → `translator/index.js` `translateRequest` (client format → provider format) → `executor.execute()` (streams upstream) → `translateResponse` (provider chunks → client format) → SSE out.
+
+## Directory map
+
+- `config/` — ALL constants/config (no hardcode elsewhere). `providers.js`/`registry/` (provider defs), `providerModels.js` (alias→models matrix), `runtimeConfig.js` (timeouts, token limits), `*Constants.js`.
+- `translator/` — format conversion. `request/<from>-to-<to>.js`, `response/<from>-to-<to>.js`, `schema/` (enums: ROLE, CLAUDE_BLOCK…), `concerns/` (shared logic), `formats.js`+`formats/` (per-format). `index.js` is the registry/entry.
+- `executors/` — per-provider upstream call. `base.js` (BaseExecutor), one file per special provider, `index.js` map.
+- `providers/` — registry build + `capabilities.js` + `pricing.js`. Entry: `index.js` (PROVIDERS).
+- `handlers/` — per-modality cores (chat/image/embedding/tts/stt/search) + sub-provider folders. `chatCore/` has the streaming/non-streaming/sse-to-json handlers.
+- `rtk/` — request token-killer. `index.js` compresses `tool_result` content in-place (OpenAI/Claude/Kiro shapes); `filters/` per-tool compressors + `autodetect.js`; `headroom.js` external compress proxy; `caveman.js` system-prompt injector.
+- `transformer/` — `responsesTransformer.js` (Chat Completions SSE → Codex Responses API SSE), `streamToJsonConverter.js`.
+- `shared/` — cross-provider auth/identity: `clineAuth.js`, `machineId.js`, `qoder/`.
+- `services/` — `model.js`, `provider.js`, `accountFallback.js`, `combo.js`, `compact.js`, `tokenRefresh/`+`tokenRefresh.js`, `oauthCredentialManager.js`, `usage/`, `projectId.js`, `kiroModels.js`/`qoderModels.js`.
+- `utils/` — streamHandler, stream, sse, error, sessionManager, claudeCloaking, clientDetector, proxyFetch (patches global fetch), cursorProtobuf/cursorChecksum, ollamaTransform.
+
+## Conventions
+
+- Config-driven, DRY, camelCase. NEVER hardcode values, models, or block/role strings — use `config/` + `schema/` constants.
+- Translator pipeline pivots through OpenAI as the intermediate format. A translator registered on the exact `source:target` pair (e.g. `claude:kiro`) runs as a **direct route**, skipping the lossy double-hop.
+- Translators self-register via `register(from, to, reqFn, resFn)` as an import side-effect — new files MUST be imported in `translator/index.js`.
+
+## How to add
+
+- **Provider**: copy `providers/REGISTRY_TEMPLATE.js` → `providers/registry/{id}.js`; add models to `config/providerModels.js`. Generic providers need no executor (DefaultExecutor handles OpenAI-compatible APIs).
+- **Executor** (only for non-standard upstream): subclass `BaseExecutor` (override `getBaseUrls`/`buildHeaders`/`buildUrl`/`execute`), register in `executors/index.js` map. `getExecutor` falls back to `DefaultExecutor` when absent.
+- **Translator**: add `request|response/<from>-to-<to>.js` calling `register(...)`, then import it in `translator/index.js`. Reuse `schema/` + `concerns/` — don't re-implement parsing.
+
+## Pitfalls
+
+- OpenAI bridge is lossy (thinking, non-base64 images, tool ids, is_error) — prefer a direct route for fragile pairs.
+- `registry/index.js` is an auto-generated static import list; regenerate it (don't hand-edit) after adding a `registry/{id}.js`. REGISTRY_TEMPLATE is excluded by design.
+- Special binary/protobuf formats (kiro EventStream, cursor protobuf, commandcode NDJSON) don't round-trip through OpenAI — handle in their executor.
+- `rtk/` + `headroom.js` mutate the request body in-place and are **fail-open**: any error returns null and leaves the body untouched — never throw out of them. RTK skips `is_error`/`status:"error"` tool results to preserve traces.

package/open-sse/config/anthropicHeaders.js

@@ -0,0 +1,87 @@
+const ANTHROPIC_VERSION_HEADER = "2023-06-01";
+const ANTHROPIC_BETA_BASE = Object.freeze([
+  "claude-code-20250219",
+  "oauth-2025-04-20",
+  "interleaved-thinking-2025-05-14",
+  "context-management-2025-06-27",
+  "prompt-caching-scope-2026-01-05",
+  "advanced-tool-use-2025-11-20",
+  "effort-2025-11-24",
+  "structured-outputs-2025-12-15",
+  "fast-mode-2026-02-01",
+  "redact-thinking-2026-02-12",
+  "token-efficient-tools-2026-03-28",
+  "advisor-tool-2026-03-01",
+  "extended-cache-ttl-2025-04-11",
+  "cache-diagnosis-2026-04-07"
+]);
+const CLAUDE_OAUTH_EXTRA_BETAS = Object.freeze(["fine-grained-tool-streaming-2025-05-14"]);
+const ANTHROPIC_BETA_FULL = ANTHROPIC_BETA_BASE.join(",");
+const ANTHROPIC_BETA_API_KEY = ANTHROPIC_BETA_BASE.filter(
+  (beta) => beta !== "oauth-2025-04-20"
+).join(",");
+const ANTHROPIC_BETA_CLAUDE_OAUTH = [
+  ...ANTHROPIC_BETA_BASE.slice(0, 3),
+  ...CLAUDE_OAUTH_EXTRA_BETAS,
+  ...ANTHROPIC_BETA_BASE.slice(3)
+].join(",");
+const FORWARDABLE_CLIENT_BETAS = Object.freeze(["tool-search-tool-2025-10-19"]);
+function mergeClientAnthropicBeta(base, clientBeta, allow = FORWARDABLE_CLIENT_BETAS) {
+  const baseList = base.split(",").map((s) => s.trim()).filter(Boolean);
+  if (typeof clientBeta !== "string" || !clientBeta.trim()) return baseList.join(",");
+  const seen = new Set(baseList.map((s) => s.toLowerCase()));
+  const allowSet = new Set(allow.map((s) => s.toLowerCase()));
+  for (const token of clientBeta.split(",").map((s) => s.trim()).filter(Boolean)) {
+    const lower = token.toLowerCase();
+    if (allowSet.has(lower) && !seen.has(lower)) {
+      baseList.push(token);
+      seen.add(lower);
+    }
+  }
+  return baseList.join(",");
+}
+function uniqueCommaValues(values) {
+  return [
+    ...new Set(
+      values.filter((value) => value !== void 0 && value !== null && value !== "").flatMap((value) => String(value).split(",")).map((value) => value.trim()).filter(Boolean)
+    )
+  ];
+}
+function normalizeAnthropicHeaderVariants(headers) {
+  if ("anthropic-version" in headers && "Anthropic-Version" in headers) {
+    const versionValues = uniqueCommaValues([
+      headers["anthropic-version"],
+      headers["Anthropic-Version"]
+    ]);
+    delete headers["Anthropic-Version"];
+    delete headers["anthropic-version"];
+    if (versionValues.length > 0) {
+      headers["anthropic-version"] = versionValues[0];
+    }
+  }
+  if ("anthropic-beta" in headers && "Anthropic-Beta" in headers) {
+    const betaValues = uniqueCommaValues([headers["anthropic-beta"], headers["Anthropic-Beta"]]);
+    delete headers["Anthropic-Beta"];
+    delete headers["anthropic-beta"];
+    if (betaValues.length > 0) {
+      headers["anthropic-beta"] = betaValues.join(",");
+    }
+  }
+}
+const CLAUDE_CLI_VERSION = "2.1.195";
+const CLAUDE_CLI_USER_AGENT = `claude-cli/${CLAUDE_CLI_VERSION} (external, cli)`;
+const CLAUDE_CLI_STAINLESS_PACKAGE_VERSION = "0.94.0";
+const CLAUDE_CLI_STAINLESS_RUNTIME_VERSION = "v24.3.0";
+export {
+  ANTHROPIC_BETA_API_KEY,
+  ANTHROPIC_BETA_CLAUDE_OAUTH,
+  ANTHROPIC_BETA_FULL,
+  ANTHROPIC_VERSION_HEADER,
+  CLAUDE_CLI_STAINLESS_PACKAGE_VERSION,
+  CLAUDE_CLI_STAINLESS_RUNTIME_VERSION,
+  CLAUDE_CLI_USER_AGENT,
+  CLAUDE_CLI_VERSION,
+  FORWARDABLE_CLIENT_BETAS,
+  mergeClientAnthropicBeta,
+  normalizeAnthropicHeaderVariants
+};

package/open-sse/config/appConstants.js

@@ -0,0 +1,238 @@
+import { platform, arch } from "os";
+import { proxyAwareFetch } from "../utils/proxyFetch.js";
+
+// === Kimchi CLI version (dynamic, cached from GitHub releases) ===
+const KIMCHI_FALLBACK_VERSION = "0.1.39";
+let _kimchiVersionCache = null;
+let _kimchiVersionFetching = null;
+const KIMCHI_VERSION_TTL_MS = 3600_000; // 1h
+
+async function fetchKimchiVersion() {
+  try {
+    const res = await proxyAwareFetch("https://api.github.com/repos/getkimchi/kimchi/releases/latest", {
+      headers: { Accept: "application/vnd.github+json" },
+      signal: AbortSignal.timeout(5000),
+    });
+    if (!res.ok) return KIMCHI_FALLBACK_VERSION;
+    const body = await res.json();
+    const tag = body?.tag_name || "";
+    const ver = tag.replace(/^v/, "");
+    return ver || KIMCHI_FALLBACK_VERSION;
+  } catch {
+    return KIMCHI_FALLBACK_VERSION;
+  }
+}
+
+export async function getKimchiVersion() {
+  if (_kimchiVersionCache && Date.now() - _kimchiVersionCache.ts < KIMCHI_VERSION_TTL_MS) return _kimchiVersionCache.ver;
+  if (_kimchiVersionFetching) return _kimchiVersionFetching;
+  _kimchiVersionFetching = fetchKimchiVersion().finally(() => { _kimchiVersionFetching = null; });
+  const ver = await _kimchiVersionFetching;
+  _kimchiVersionCache = { ver, ts: Date.now() };
+  return ver;
+}
+
+export function getKimchiVersionSync() {
+  return _kimchiVersionCache?.ver || KIMCHI_FALLBACK_VERSION;
+}
+
+// === Gemini CLI ===
+export const GEMINI_CLI_VERSION = "0.34.0";
+export const GEMINI_CLI_API_CLIENT = "google-genai-sdk/1.41.0 gl-node/v22.19.0";
+
+// Map Node arch to Gemini CLI arch string (x64/x86/arm64/...)
+function geminiCLIArch() {
+  const a = arch();
+  if (a === "ia32") return "x86";
+  return a;
+}
+
+export function geminiCLIUserAgent(model = "unknown") {
+  return `GeminiCLI/${GEMINI_CLI_VERSION}/${model || "unknown"} (${platform()}; ${geminiCLIArch()}; terminal)`;
+}
+
+// === GitHub Copilot ===
+export const GITHUB_COPILOT = {
+  VSCODE_VERSION: "1.110.0",
+  COPILOT_CHAT_VERSION: "0.38.0",
+  USER_AGENT: "GitHubCopilotChat/0.38.0",
+  API_VERSION: "2025-04-01",
+};
+
+// === Antigravity enums ===
+export const IDE_TYPE = {
+  UNSPECIFIED: 0,
+  JETSKI: 10,
+  ANTIGRAVITY: 9,
+  PLUGINS: 7
+};
+
+export const PLATFORM = {
+  UNSPECIFIED: 0,
+  DARWIN_AMD64: 1,
+  DARWIN_ARM64: 2,
+  LINUX_AMD64: 3,
+  LINUX_ARM64: 4,
+  WINDOWS_AMD64: 5
+};
+
+export const PLUGIN_TYPE = {
+  UNSPECIFIED: 0,
+  CLOUD_CODE: 1,
+  GEMINI: 2
+};
+
+export function getPlatformEnum() {
+  const os = platform();
+  const architecture = arch();
+  if (os === "darwin") return architecture === "arm64" ? PLATFORM.DARWIN_ARM64 : PLATFORM.DARWIN_AMD64;
+  if (os === "linux") return architecture === "arm64" ? PLATFORM.LINUX_ARM64 : PLATFORM.LINUX_AMD64;
+  if (os === "win32") return PLATFORM.WINDOWS_AMD64;
+  return PLATFORM.UNSPECIFIED;
+}
+
+export function getPlatformUserAgent() {
+  return `antigravity/1.104.0 ${platform()}/${arch()}`;
+}
+
+export const CLIENT_METADATA = {
+  ideType: IDE_TYPE.ANTIGRAVITY,
+  platform: getPlatformEnum(),
+  pluginType: PLUGIN_TYPE.GEMINI
+};
+
+// Internal anti-loop header
+export const INTERNAL_REQUEST_HEADER = { name: "x-request-source", value: "local" };
+
+// Suffix added to client tools when forwarding to Antigravity provider (anti-ban cloaking)
+export const AG_TOOL_SUFFIX = "_ide";
+
+// Suffix added to client tools when forwarding to Claude provider (anti-ban cloaking)
+export const CLAUDE_TOOL_SUFFIX = "_ide";
+
+// CC native default tools — these are Claude Code's own tools, kept as decoys
+// Client tools matching these names are skipped (not renamed), others get _cc suffix
+export const CC_DEFAULT_TOOLS = new Set([
+  "Task",
+  "TaskOutput",
+  "TaskStop",
+  "TaskCreate",
+  "TaskGet",
+  "TaskUpdate",
+  "TaskList",
+  "Bash",
+  "Glob",
+  "Grep",
+  "Read",
+  "Edit",
+  "Write",
+  "NotebookEdit",
+  "WebFetch",
+  "WebSearch",
+  "AskUserQuestion",
+  "Skill",
+  "EnterPlanMode",
+  "ExitPlanMode",
+]);
+
+// AG native default tools — kept as decoys with neutral description/properties
+// These names must match exactly what AG sends in the real request log
+export const AG_DEFAULT_TOOLS = new Set([
+  "browser_subagent",
+  "command_status",
+  "find_by_name",
+  "generate_image",
+  "grep_search",
+  "list_dir",
+  "list_resources",
+  "multi_replace_file_content",
+  "notify_user",
+  "read_resource",
+  "read_terminal",
+  "read_url_content",
+  "replace_file_content",
+  "run_command",
+  "search_web",
+  "send_command_input",
+  "task_boundary",
+  "view_content_chunk",
+  "view_file",
+  "write_to_file"
+]);
+
+// Antigravity chat/stream headers
+export const ANTIGRAVITY_HEADERS = {
+  "User-Agent": `antigravity/1.107.0 ${platform()}/${arch()}`
+};
+
+// Cloud Code Assist API
+export const CLOUD_CODE_API = {
+  loadCodeAssist: "https://cloudcode-pa.googleapis.com/v1internal:loadCodeAssist",
+  onboardUser: "https://cloudcode-pa.googleapis.com/v1internal:onboardUser",
+};
+
+export const LOAD_CODE_ASSIST_HEADERS = {
+  "Content-Type": "application/json",
+  "User-Agent": "google-api-nodejs-client/9.15.1",
+  "X-Goog-Api-Client": "google-cloud-sdk vscode_cloudshelleditor/0.1",
+  "Client-Metadata": JSON.stringify({ ideType: IDE_TYPE.ANTIGRAVITY, platform: getPlatformEnum(), pluginType: PLUGIN_TYPE.GEMINI }),
+};
+
+export const LOAD_CODE_ASSIST_METADATA = {
+  ideType: IDE_TYPE.ANTIGRAVITY,
+  platform: getPlatformEnum(),
+  pluginType: PLUGIN_TYPE.GEMINI,
+};
+
+// System prompts
+export const CLAUDE_SYSTEM_PROMPT = "You are Claude Code, Anthropic's official CLI for Claude.";
+export const ANTIGRAVITY_DEFAULT_SYSTEM = "You are Antigravity, a powerful agentic AI coding assistant designed by the Google Deepmind team working on Advanced Agentic Coding.You are pair programming with a USER to solve their coding task. The task may require creating a new codebase, modifying or debugging an existing codebase, or simply answering a question.**Absolute paths only****Proactiveness**";
+
+// Proactive token refresh lead times per provider (ms)
+export const REFRESH_LEAD_MS = {
+  codex:       5 * 24 * 60 * 60 * 1000, // 5 days
+  claude:       4 * 60 * 60 * 1000,     // 4 hours
+  iflow:       24 * 60 * 60 * 1000,     // 24 hours
+  qwen:        20 * 60 * 1000,          // 20 minutes
+  "kimi-coding": 5 * 60 * 1000,         // 5 minutes
+  antigravity:  5 * 60 * 1000,          // 5 minutes
+};
+
+// OAuth endpoints
+export const OAUTH_ENDPOINTS = {
+  google: {
+    token: "https://oauth2.googleapis.com/token",
+    auth: "https://accounts.google.com/o/oauth2/auth"
+  },
+  openai: {
+    token: "https://auth.openai.com/oauth/token",
+    auth: "https://auth.openai.com/oauth/authorize"
+  },
+  anthropic: {
+    token: "https://api.anthropic.com/v1/oauth/token",
+    auth: "https://api.anthropic.com/v1/oauth/authorize"
+  },
+  qwen: {
+    token: "https://qwen.ai/api/v1/oauth2/token",
+    auth: "https://qwen.ai/api/v1/oauth2/device/code"
+  },
+  iflow: {
+    token: "https://iflow.cn/oauth/token",
+    auth: "https://iflow.cn/oauth"
+  },
+  github: {
+    token: "https://github.com/login/oauth/access_token",
+    auth: "https://github.com/login/oauth/authorize",
+    deviceCode: "https://github.com/login/device/code"
+  }
+};
+
+// Generate Kimi OAuth custom headers
+export function buildKimiHeaders() {
+  return {
+    "X-Msh-Platform": "9router",
+    "X-Msh-Version": "2.1.2",
+    "X-Msh-Device-Model": typeof process !== "undefined" ? `${process.platform} ${process.arch}` : "unknown",
+    "X-Msh-Device-Id": `kimi-${Date.now()}`
+  };
+}