UNPKG

@bitkyc08/opencodex

Version:

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code

164 lines (153 loc) • 7.19 kB
/* * Derived from rsvedant/opencode-windsurf-auth (src/cloud-direct/), MIT licensed, * Copyright (c) 2026 Vedant. The full notice is in ./index.ts. */ /** * `exa.codeium_common_pb.Metadata` proto builder. * * Field numbers come from src/plugin/discovery.ts (which reads the bundled * extension.js for live numbers). For cloud-direct we hard-code the canonical * set of fields the LS always populates — the IDE-extracted dynamic numbers * would help if Windsurf renumbers, but we don't have a way to refresh those * without the bundled extension.js path being present. * * Captured from real LS upstream traffic via mitm reverse-proxy. See * docs/CLOUD_DIRECT.md → "The exact captured request body (annotated)". */ import { encodeMessage, encodeString, encodeTimestampBody, encodeVarintField, } from './wire.js'; import { randomBytes } from 'node:crypto'; /** * extension_version + ide_version sent to the cloud. It MUST be a string the * cloud recognizes as a real client release: an unknown version comes back as * an opaque "an internal error occurred", with no hint that the version is what * it objected to. * * Pinned to the version the shipped desktop client reports * (`product.json` -> `windsurfVersion`) rather than to anything of ours. The * previous pin of "2.0.0" predates the Devin rebrand and no longer chats. * `OPENCODEX_DEVIN_CLIENT_VERSION` overrides it, which is the escape hatch when * Cognition retires a version before this constant is updated. */ const WINDSURF_VERSION_STRING = process.env.OPENCODEX_DEVIN_CLIENT_VERSION?.trim() || '3.9.19'; /** * Identity the hosted chat RPC expects, which is not the desktop client's. * GetChatMessage is calibrated against a different client name and version, and * sending the IDE's own strings is one of the ways the request comes back as an * opaque "an internal error occurred". */ const CLOUD_CHAT_CLIENT_NAME = 'chisel'; const CLOUD_CHAT_CLIENT_VERSION = process.env.OPENCODEX_DEVIN_CHAT_CLIENT_VERSION?.trim() || '2026.8.18'; const CLOUD_CHAT_OS = 'windows'; /** * Metadata #31 is a device fingerprint, and the server checks its shape rather * than its value: 732 hex characters (366 bytes). Anything shorter — including * absent — is rejected with the same opaque internal error, and a fresh random * value per request is accepted, so nothing here identifies the machine. */ const DEVICE_FINGERPRINT_BYTES = 366; /** Prefix every Cognition session key carries in `Metadata.api_key`. */ const DEVIN_SESSION_TOKEN_PREFIX = 'devin-session-token$'; /** A bare JWT: three base64url segments. Nothing else is reshaped. */ const BARE_JWT_PATTERN = /^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]*$/; /** * Restore the `devin-session-token$` prefix on a bare JWT. * * Cognition reads `Metadata.api_key` as a prefixed session token. A key that * arrives without the prefix — a JWT pasted into `apiKey` by hand, or one * copied out of the CLI's file without its prefix — is sent verbatim and comes * back as an opaque `permission_denied`, which reads as a revoked account * rather than as a malformed credential. * * Only a bare JWT is reshaped. The other key formats this field has carried are * not JWTs and must pass through untouched: a Codeium-classic bare UUID, an * `sk-ws-01-…` Windsurf key, and a `cog_…` session key would all break if they * were prefixed. Anything already containing `$` is left alone for the same * reason. */ export function normalizeDevinSessionToken(apiKey: string): string { const trimmed = apiKey.trim(); if (!trimmed || trimmed.includes('$')) return apiKey; return BARE_JWT_PATTERN.test(trimmed) ? `${DEVIN_SESSION_TOKEN_PREFIX}${trimmed}` : apiKey; } export interface MetadataInput { /** Persistent api_key from OAuth (`devin-session-token$<JWT>`). */ apiKey: string; /** * Fresh user_jwt from GetUserJwt. The catalog RPC uses it; the hosted chat * path does not need it and only sends it when an operator opts in. */ userJwt?: string; /** UUID — one per opencode session is fine. */ sessionId: string; /** Monotonic, milliseconds since epoch. */ requestId: bigint; /** UUID — one per RPC call. */ triggerId: string; /** Optional override for the version string. Cosmetic. */ windsurfVersion?: string; /** Optional override for the host OS string. */ osName?: string; /** * Emit the exact field set the hosted chat RPC accepts. * * GetChatMessage validates this message far more strictly than * GetCascadeModelConfigs does, which is why the catalog has always worked * while chat did not. The shape is seven identity fields, the optional * user_jwt, and the fingerprint — the telemetry fields this module otherwise * sends (request_id, session_id, ls_timestamp, trigger_id, plan_name, * ide_type) are not part of it. */ cloudChatShape?: boolean; /** Override for Metadata #31; a random fingerprint is generated when absent. */ deviceHex?: string; } function osString(): string { switch (process.platform) { case 'darwin': return 'darwin'; case 'linux': return 'linux'; case 'win32': return 'windows'; default: return String(process.platform); } } export function buildMetadata(input: MetadataInput): Buffer { const version = input.windsurfVersion ?? WINDSURF_VERSION_STRING; const os = input.osName ?? osString(); // One boundary, so no caller has to remember the prefix rule. const apiKey = normalizeDevinSessionToken(input.apiKey); if (input.cloudChatShape) { const clientVersion = input.windsurfVersion ?? CLOUD_CHAT_CLIENT_VERSION; return Buffer.concat([ encodeString(1, CLOUD_CHAT_CLIENT_NAME), encodeString(2, clientVersion), encodeString(3, apiKey), encodeString(4, 'en'), encodeString(5, input.osName ?? CLOUD_CHAT_OS), encodeString(7, clientVersion), encodeString(12, CLOUD_CHAT_CLIENT_NAME), ...(input.userJwt ? [encodeString(21, input.userJwt)] : []), encodeString(31, input.deviceHex ?? randomBytes(DEVICE_FINGERPRINT_BYTES).toString('hex')), ]); } const parts: Buffer[] = [ encodeString(1, 'windsurf'), // ide_name encodeString(2, version), // extension_version encodeString(3, apiKey), // api_key encodeString(4, 'en'), // locale encodeString(5, os), // os encodeString(7, version), // ide_version encodeVarintField(9, input.requestId), // request_id (uint64 monotonic) encodeString(10, input.sessionId), // session_id encodeString(12, 'windsurf'), // extension_name encodeMessage(16, encodeTimestampBody()), // ls_timestamp (google.protobuf.Timestamp) encodeString(25, input.triggerId), // trigger_id encodeString(26, 'Unset'), // plan_name encodeString(28, 'windsurf'), // ide_type ]; if (input.userJwt) parts.push(encodeString(21, input.userJwt)); // user_jwt return Buffer.concat(parts); }