@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
text/typescript
/*
* 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);
}