@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
619 lines (582 loc) • 28 kB
text/typescript
/** xAI OAuth flow (Grok account login). Ported from jawcode oauth/xai.ts. */
import { abortError, sleepWithAbort } from "../lib/upstream-retry";
import { OAuthCallbackFlow, type OAuthCallbackFlowOptions } from "./callback-server";
import { generatePKCE } from "./pkce";
import type { LocalTokenImportMode, OAuthController, OAuthCredentials } from "./types";
const XAI_OAUTH_ISSUER = "https://auth.x.ai";
export const XAI_OAUTH_DISCOVERY_URL = `${XAI_OAUTH_ISSUER}/.well-known/openid-configuration`;
export const XAI_OAUTH_CLIENT_ID = "b1a00492-073a-47ea-816f-4c329264a828";
export const XAI_OAUTH_SCOPE = "openid profile email offline_access grok-cli:access api:access";
const XAI_OAUTH_CALLBACK_PORT = 56121;
const XAI_OAUTH_CALLBACK_PATH = "/callback";
const XAI_OAUTH_REFRESH_SKEW_MS = 2 * 60 * 1000;
const TOKEN_REQUEST_TIMEOUT_MS = 30_000;
const RETRY_AFTER_MAX_DELAY_MS = 60_000;
const JITTER_DELAY_CAP_MS = 2_000;
const XAI_TRUSTED_AUTH_HOSTS = new Set(["auth.x.ai", "accounts.x.ai"]);
export const XAI_LOCAL_CLI_DETACH_WARNING =
"[oauth:xai] Grok CLI credential was stale; refreshed into OpenCodex ownership. Grok CLI may require login again.";
interface XaiDiscovery {
authorizationEndpoint: string;
tokenEndpoint: string;
/** RFC 8628 endpoint, when the issuer advertises one. */
deviceAuthorizationEndpoint?: string;
}
interface XaiDiscoveryPayload {
authorization_endpoint?: unknown;
token_endpoint?: unknown;
device_authorization_endpoint?: unknown;
}
export interface XaiTokenPayload {
access_token?: unknown;
refresh_token?: unknown;
expires_in?: unknown;
id_token?: unknown;
token_type?: unknown;
}
interface XaiJwtPayload {
sub?: unknown;
email?: unknown;
[key: string]: unknown;
}
function requestSignal(signal: AbortSignal | undefined): AbortSignal {
const timeoutSignal = AbortSignal.timeout(TOKEN_REQUEST_TIMEOUT_MS);
return signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;
}
function validateXaiEndpoint(rawUrl: string): string {
let parsed: URL;
try {
parsed = new URL(rawUrl);
} catch {
throw new Error("xAI OAuth discovery returned an unparseable endpoint URL");
}
const host = parsed.hostname.toLowerCase();
if (
parsed.protocol !== "https:"
|| parsed.username !== ""
|| parsed.password !== ""
|| parsed.port !== ""
|| !XAI_TRUSTED_AUTH_HOSTS.has(host)
) {
throw new Error(`xAI OAuth discovery returned an unexpected endpoint (host: ${host || "none"})`);
}
return parsed.toString();
}
export async function discoverXaiOAuthEndpoints(signal?: AbortSignal): Promise<XaiDiscovery> {
let response: Response;
try {
response = await fetch(XAI_OAUTH_DISCOVERY_URL, {
headers: { Accept: "application/json" },
signal: requestSignal(signal),
});
} catch (error) {
throw new XaiTokenRequestError(undefined, undefined, "xAI OAuth discovery failed: network error", { cause: error });
}
if (!response.ok) {
throw new XaiTokenRequestError(response.status, undefined, `xAI OAuth discovery failed: ${response.status} ${await response.text()}`);
}
const payload = (await response.json()) as XaiDiscoveryPayload;
if (typeof payload.authorization_endpoint !== "string" || typeof payload.token_endpoint !== "string") {
throw new Error("xAI OAuth discovery response missing authorization/token endpoints");
}
return {
authorizationEndpoint: validateXaiEndpoint(payload.authorization_endpoint),
tokenEndpoint: validateXaiEndpoint(payload.token_endpoint),
...(typeof payload.device_authorization_endpoint === "string"
? { deviceAuthorizationEndpoint: validateXaiEndpoint(payload.device_authorization_endpoint) }
: {}),
};
}
function decodeJwtPayload(token: string): XaiJwtPayload | undefined {
const parts = token.split(".");
const payload = parts[1];
if (parts.length !== 3 || !payload) return undefined;
try {
return JSON.parse(Buffer.from(payload, "base64url").toString("utf8")) as XaiJwtPayload;
} catch {
return undefined;
}
}
function getTokenIdentity(accessToken: string, idToken: string | undefined): { accountId?: string; email?: string } {
const payload = (idToken ? decodeJwtPayload(idToken) : undefined) ?? decodeJwtPayload(accessToken);
const accountId = typeof payload?.sub === "string" && payload.sub.length > 0 ? payload.sub : undefined;
const email =
typeof payload?.email === "string" && payload.email.length > 0 ? payload.email.toLowerCase() : undefined;
return { accountId, email };
}
export class XaiTokenRequestError extends Error {
constructor(
public readonly status?: number,
public readonly oauthError?: string,
message = "xAI token request failed",
options?: { cause?: unknown },
/** Server-requested throttle from a retryable response, already floored and finite. */
public readonly retryAfterMs?: number,
) {
super(message, options);
this.name = "XaiTokenRequestError";
}
}
/**
* The endpoint answered with a redirect while the caller asked `redirect: "error"`.
*
* Non-retriable by construction: replaying the request would send the same body to a host
* `validateXaiEndpoint` never approved. The message is fixed on purpose. Bun's redirect
* `TypeError` embeds the target URL in its text, and the poll body carries the
* bearer-equivalent `device_code`, so neither may reach a log, an error `cause`, a login
* status payload, or the terminal.
*/
export class XaiRedirectRefusedError extends XaiTokenRequestError {
constructor() {
super(undefined, undefined, "xAI token request refused a redirect");
this.name = "XaiRedirectRefusedError";
}
}
/**
* True when `fetch` refused a redirect because this caller passed `redirect: "error"`.
*
* The two runtimes signal it differently and both were checked against a real local server:
* Bun throws `TypeError` with `code: "UnexpectedRedirect"`; Node/undici throws
* `TypeError("fetch failed")` whose `cause` is `Error("unexpected redirect")`. Matching exactly
* keeps a programming `TypeError` (no marker) and a real connection failure (Bun
* `ECONNREFUSED`/`ENOTFOUND`, undici's own cause text) retriable.
*/
function isRedirectRefusal(error: unknown): boolean {
if (!(error instanceof TypeError)) return false;
if ((error as { code?: unknown }).code === "UnexpectedRedirect") return true;
const cause = (error as { cause?: unknown }).cause;
return cause instanceof Error && cause.message === "unexpected redirect";
}
export interface XaiTokenRetryDeps { sleep?:(ms:number)=>Promise<void>; random?:()=>number; /** Default 3; the device poll sends one request per interval. */ maxAttempts?:number; /**
* Fetch redirect policy. Inherited callers keep the runtime default (follow); the device poll sets
* `error` because its body carries the RFC 8628 `device_code`, a bearer-equivalent secret that must
* not be re-POSTed to a redirect target. A 307/308 preserves the method and body.
*/ redirect?:RequestRedirect }
const IMF_FIXDATE_RE = /^(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun), (\d{2}) (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) (\d{4}) (\d{2}):(\d{2}):(\d{2}) GMT$/i;
const RFC850_DATE_RE = /^(?:Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday), (\d{2})-(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)-(\d{2}) (\d{2}):(\d{2}):(\d{2}) GMT$/i;
const ASCTIME_DATE_RE = /^(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun) (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) ( \d|\d{2}) (\d{2}):(\d{2}):(\d{2}) (\d{4})$/i;
const HTTP_MONTH_INDEX: Record<string, number> = {
jan: 0, feb: 1, mar: 2, apr: 3, may: 4, jun: 5,
jul: 6, aug: 7, sep: 8, oct: 9, nov: 10, dec: 11,
};
function parseUtcDateParts(
year: number,
monthName: string,
day: number,
hour: number,
minute: number,
second: number,
): number | undefined {
const month = HTTP_MONTH_INDEX[monthName.toLowerCase()];
if (month === undefined) return undefined;
const timestamp = Date.UTC(year, month, day, hour, minute, second);
const parsed = new Date(timestamp);
return parsed.getUTCFullYear() === year
&& parsed.getUTCMonth() === month
&& parsed.getUTCDate() === day
&& parsed.getUTCHours() === hour
&& parsed.getUTCMinutes() === minute
&& parsed.getUTCSeconds() === second
? timestamp
: undefined;
}
function parseHttpDateMs(value: string, now: number): number | undefined {
const match = IMF_FIXDATE_RE.exec(value);
if (match) {
return parseUtcDateParts(
Number(match[3]), match[2]!, Number(match[1]),
Number(match[4]), Number(match[5]), Number(match[6]),
);
}
const rfc850 = RFC850_DATE_RE.exec(value);
if (rfc850) {
// Two-digit years more than 50 years in the future are in the past (RFC 9110).
const currentYear = new Date(now).getUTCFullYear();
let year = Math.floor(currentYear / 100) * 100 + Number(rfc850[3]);
const candidateTimeOfYear = Date.UTC(
2000, HTTP_MONTH_INDEX[rfc850[2]!.toLowerCase()]!, Number(rfc850[1]),
Number(rfc850[4]), Number(rfc850[5]), Number(rfc850[6]),
);
const current = new Date(now);
const currentTimeOfYear = Date.UTC(
2000, current.getUTCMonth(), current.getUTCDate(),
current.getUTCHours(), current.getUTCMinutes(), current.getUTCSeconds(),
current.getUTCMilliseconds(),
);
const yearDelta = year - currentYear;
if (yearDelta < -50 || (yearDelta === -50 && candidateTimeOfYear < currentTimeOfYear)) {
year += 100;
} else if (yearDelta > 50 || (yearDelta === 50 && candidateTimeOfYear > currentTimeOfYear)) {
year -= 100;
}
return parseUtcDateParts(
year, rfc850[2]!, Number(rfc850[1]),
Number(rfc850[4]), Number(rfc850[5]), Number(rfc850[6]),
);
}
const asctime = ASCTIME_DATE_RE.exec(value);
if (!asctime) return undefined;
return parseUtcDateParts(
Number(asctime[6]), asctime[1]!, Number(asctime[2]),
Number(asctime[3]), Number(asctime[4]), Number(asctime[5]),
);
}
function parseRetryAfterMs(retryAfter: string | null): number | undefined {
const text = retryAfter?.trim();
if (!text) return undefined;
if (/^\d+(?:\.\d+)?$/.test(text)) {
const ms = Math.min(Number.MAX_SAFE_INTEGER, Math.ceil(Number(text) * 1000));
return ms > 0 ? ms : undefined;
}
const now = Date.now();
const timestamp = parseHttpDateMs(text, now);
if (timestamp === undefined) return undefined;
const delay = timestamp - now;
return delay > 0 ? delay : undefined;
}
function jitterDelay(attempt: number, random: () => number): number {
const base = attempt === 1 ? 100 : 250;
return Math.min(JITTER_DELAY_CAP_MS, Math.round(base * (0.75 + random() * 0.5)));
}
/**
* Delay before the next attempt, or undefined when the server asked for a wait
* beyond the retry budget — retrying earlier than Retry-After would hammer the
* token endpoint, so the caller fails the request instead of clamping.
*/
function retryDelay(attempt: number, retryAfter: string | null, random: () => number): number | undefined {
const serverMs = parseRetryAfterMs(retryAfter);
if (serverMs === undefined) return jitterDelay(attempt, random);
return serverMs <= RETRY_AFTER_MAX_DELAY_MS ? serverMs : undefined;
}
async function sleepAbortable(
ms: number,
sleep: (ms: number) => Promise<void>,
signal: AbortSignal | undefined,
): Promise<void> {
if (!signal) return sleep(ms);
if (signal.aborted) throw abortError(signal);
let onAbort!: () => void;
try {
await Promise.race([
sleep(ms),
new Promise<never>((_, reject) => {
onAbort = () => reject(abortError(signal));
signal.addEventListener("abort", onAbort, { once: true });
}),
]);
} finally {
signal.removeEventListener("abort", onAbort);
}
}
async function readTokenError(response:Response):Promise<XaiTokenRequestError>{let oauthError:string|undefined,detail="";try{const body=await response.json() as {error?:unknown;error_description?:unknown};if(typeof body.error==="string")oauthError=body.error;if(typeof body.error_description==="string")detail=body.error_description;}catch{/* non-JSON error body: fall through to the generic message */}const suffix=detail?`: ${detail}`:oauthError?`: ${oauthError}`:"";const retryAfterMs=response.status===429||response.status>=500||(response.status===400&&oauthError==="slow_down")?parseRetryAfterMs(response.headers.get("retry-after")):undefined;return new XaiTokenRequestError(response.status,oauthError,`xAI token request failed: ${response.status}${suffix}`,undefined,retryAfterMs!==undefined&&Number.isFinite(retryAfterMs)?retryAfterMs:undefined);}
export async function postXaiToken(
tokenEndpoint: string,
body: Record<string, string>,
signal?: AbortSignal, deps:XaiTokenRetryDeps={},
): Promise<XaiTokenPayload> {
const sleep=deps.sleep??((ms:number)=>sleepWithAbort(ms,signal)),random=deps.random??Math.random,max=deps.maxAttempts??3,redirect=deps.redirect;let last:unknown;
for(let attempt=1;attempt<=max;attempt++){let response:Response;try{response=await fetch(tokenEndpoint, {
method: "POST",
headers: {
Accept: "application/json",
"Content-Type": "application/x-www-form-urlencoded",
},
body: new URLSearchParams(body).toString(),
...(redirect === undefined ? {} : { redirect }),
signal: requestSignal(signal),
});}catch(error){
if(signal?.aborted)throw error;
const name=(error as {name?:string}|undefined)?.name;
if(name==="AbortError"||name==="TimeoutError")throw error;
// A refused redirect is deterministic: the same body replayed reaches the same answer, and
// the caller asked for `error` precisely so the request never leaves the approved endpoint.
if(redirect==="error"&&isRedirectRefusal(error))throw new XaiRedirectRefusedError();
last=error;
if(attempt===max)throw new XaiTokenRequestError(undefined,undefined,"xAI token request failed: network error",{cause:error});
await sleepAbortable(jitterDelay(attempt,random),sleep,signal);
continue;
}if(response.ok)return await response.json() as XaiTokenPayload;const error=await readTokenError(response);last=error;if(!(response.status===429||response.status>=500)||attempt===max)throw error;if(signal?.aborted)throw error;const delay=retryDelay(attempt,response.headers.get("retry-after"),random);if(delay===undefined)throw error;await sleepAbortable(delay,sleep,signal);}throw last;
}
function credentialsFromTokenPayload(payload: XaiTokenPayload, refreshFallback = ""): OAuthCredentials {
if (typeof payload.access_token !== "string" || payload.access_token.length === 0) {
throw new Error("xAI token response did not include an access token");
}
const refresh =
typeof payload.refresh_token === "string" && payload.refresh_token.length > 0
? payload.refresh_token
: refreshFallback;
if (!refresh) {
throw new Error("xAI token response did not include a refresh token");
}
const expiresIn =
typeof payload.expires_in === "number" && Number.isFinite(payload.expires_in) ? payload.expires_in : 3600;
const idToken = typeof payload.id_token === "string" ? payload.id_token : undefined;
const { accountId, email } = getTokenIdentity(payload.access_token, idToken);
return {
refresh,
access: payload.access_token,
expires: Date.now() + expiresIn * 1000 - XAI_OAUTH_REFRESH_SKEW_MS,
accountId,
email,
};
}
export class XaiOAuthFlow extends OAuthCallbackFlow {
#verifier = "";
#discovery: XaiDiscovery | undefined;
constructor(ctrl: OAuthController) {
super(ctrl, {
preferredPort: XAI_OAUTH_CALLBACK_PORT,
callbackPath: XAI_OAUTH_CALLBACK_PATH,
callbackHostname: "127.0.0.1",
callbackBindHostname: "127.0.0.1",
redirectUri: `http://127.0.0.1:${XAI_OAUTH_CALLBACK_PORT}${XAI_OAUTH_CALLBACK_PATH}`,
} satisfies OAuthCallbackFlowOptions);
}
async generateAuthUrl(state: string, redirectUri: string): Promise<{ url: string; instructions?: string }> {
const pkce = await generatePKCE();
this.#verifier = pkce.verifier;
this.#discovery = await discoverXaiOAuthEndpoints(this.ctrl.signal);
const params = new URLSearchParams({
response_type: "code",
client_id: XAI_OAUTH_CLIENT_ID,
redirect_uri: redirectUri,
scope: XAI_OAUTH_SCOPE,
code_challenge: pkce.challenge,
code_challenge_method: "S256",
state,
nonce: crypto.randomUUID(),
});
return {
url: `${this.#discovery.authorizationEndpoint}?${params.toString()}`,
instructions:
"Complete xAI/Grok login in your browser. If the browser cannot reach this machine, paste the final redirect URL or authorization code when prompted.",
};
}
async exchangeToken(code: string, _state: string, redirectUri: string): Promise<OAuthCredentials> {
if (!this.#verifier) {
throw new Error("xAI OAuth PKCE verifier was not initialized");
}
const discovery = this.#discovery ?? (await discoverXaiOAuthEndpoints(this.ctrl.signal));
const tokenPayload = await postXaiToken(
discovery.tokenEndpoint,
{
grant_type: "authorization_code",
client_id: XAI_OAUTH_CLIENT_ID,
code,
redirect_uri: redirectUri,
code_verifier: this.#verifier,
},
this.ctrl.signal,
);
return credentialsFromTokenPayload(tokenPayload);
}
}
const XAI_DEVICE_GRANT = "urn:ietf:params:oauth:grant-type:device_code";
/** RFC 8628 §3.2 `expires_in` default when the issuer omits it; also the fallback `interval`. */
const XAI_DEVICE_DEFAULT_TTL_S = 900;
const XAI_DEVICE_DEFAULT_INTERVAL_S = 5;
/**
* Hard ceilings on values the issuer supplies, so a hostile or corrupt response cannot turn the
* poll into a hot loop or an unbounded login.
*
* `setTimeout` stores its delay in a 32-bit signed int. A larger value overflows and fires on the
* next tick, which is exactly a hot loop against the auth endpoint; a `0`/negative/fractional
* `interval` floors to ~1 ms for the same effect. So the interval is clamped into
* [MIN, TTL] and the grant lifetime into (0, MAX_TTL]. RFC 8628 §3.2 says the issuer supplies
* `interval` and `expires_in`, but sets no ceiling on either, so the values below are this client's
* policy rather than an RFC rule: a grant that outlives a plausible human approval at another
* machine is not worth holding a login open for. A grant the issuer would still honour past the
* ceiling ends here: pending approval reports `expired_token`, while a final transport or server
* failure retains its cause.
*/
const XAI_DEVICE_MIN_INTERVAL_MS = 1_000;
const XAI_DEVICE_MAX_TTL_S = 30 * 60;
interface XaiDeviceAuthorization {
device_code?: unknown;
user_code?: unknown;
verification_uri?: unknown;
verification_uri_complete?: unknown;
expires_in?: unknown;
interval?: unknown;
}
/** Coerce a provider-supplied seconds value to a finite, positive number, or undefined. */
function secondsToPositive(value: unknown): number | undefined {
const seconds = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
return Number.isFinite(seconds) && seconds > 0 ? seconds : undefined;
}
/**
* Poll wait in ms: floored at 1s and capped at the grant lifetime.
*
* The lifetime cap is also the overflow guard. `setTimeout` stores its delay in a 32-bit signed
* int, so anything above 2^31-1 ms fires on the next tick instead of waiting; a 30-minute ceiling
* is 1.8e6 ms, three orders of magnitude below that, and the floor keeps a `0`, negative or
* fractional `interval` from becoming a tight loop.
*/
function deviceIntervalMs(raw: unknown, ttlMs: number): number {
const seconds = secondsToPositive(raw) ?? XAI_DEVICE_DEFAULT_INTERVAL_S;
return Math.min(ttlMs, Math.max(XAI_DEVICE_MIN_INTERVAL_MS, Math.round(seconds * 1000)));
}
/** Grant lifetime in ms: defaulted when absent, capped so a login cannot run unbounded. */
function deviceGrantTtlMs(raw: unknown): number {
const seconds = Math.min(secondsToPositive(raw) ?? XAI_DEVICE_DEFAULT_TTL_S, XAI_DEVICE_MAX_TTL_S);
return Math.round(seconds * 1000);
}
/**
* RFC 8628 device login, for a host whose browser cannot reach the 127.0.0.1:56121 callback:
* the user opens the URL in any browser, confirms the short code, and this polls for the token.
*/
export async function loginXaiDevice(
ctrl: OAuthController,
deps: { sleep?: (ms: number) => Promise<void> } = {},
): Promise<OAuthCredentials> {
const signal = ctrl.signal;
const sleep = deps.sleep ?? ((ms: number) => sleepWithAbort(ms, signal));
const discovery = await discoverXaiOAuthEndpoints(signal);
if (!discovery.deviceAuthorizationEndpoint) {
throw new Error("xAI OAuth discovery does not advertise device authorization");
}
let response: Response;
try {
response = await fetch(discovery.deviceAuthorizationEndpoint, {
method: "POST",
headers: { Accept: "application/json", "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({ client_id: XAI_OAUTH_CLIENT_ID, scope: XAI_OAUTH_SCOPE }).toString(),
// The request carries the client id in its body and lands on a vetted issuer; a redirect would
// replay it somewhere `validateXaiEndpoint` never saw. Discovery already refused to produce a
// non-x.ai endpoint, so a redirect here can only be a downgrade, never a legitimate hop.
redirect: "error",
signal: requestSignal(signal),
});
} catch (error) {
if (isRedirectRefusal(error)) throw new XaiRedirectRefusedError();
throw error;
}
if (!response.ok) throw await readTokenError(response);
const device = (await response.json()) as XaiDeviceAuthorization;
const verificationUri = typeof device.verification_uri_complete === "string"
? device.verification_uri_complete
: device.verification_uri;
if (
typeof device.device_code !== "string" || !device.device_code
|| typeof device.user_code !== "string" || !device.user_code
|| typeof verificationUri !== "string"
) {
throw new Error("xAI device authorization response is incomplete");
}
// Validate before the optional call: `onAuth?.(…)` skips evaluating its argument when unset.
// `validateXaiEndpoint` parses the URL, which percent-encodes control characters out of the
// path/query. The user code is kept exact here: `deviceCode` is structured data that every login
// surface renders, and escaping belongs at the terminal boundary that prints it.
const url = validateXaiEndpoint(verificationUri);
ctrl.onAuth?.({
url,
instructions: `Open this URL in any browser and confirm the code ${device.user_code}.`,
deviceCode: device.user_code,
});
// Both bounds come from the issuer, so both are clamped before they reach a timer: an oversized
// `expires_in` would make `AbortSignal.timeout` and the deadline meaningless, and a tiny
// `interval` would poll the auth endpoint in a tight loop.
const ttlMs = deviceGrantTtlMs(device.expires_in);
const deadline = Date.now() + ttlMs;
let waitMs = deviceIntervalMs(device.interval, ttlMs);
// Wait for the next iteration. `slow_down` raises the grant interval itself; a 429/5xx
// `Retry-After` applies to the response that carried it, so it is held for one poll.
let nextWaitMs = waitMs;
let lastFailure: unknown;
for (let remaining = deadline - Date.now(); remaining > 0; remaining = deadline - Date.now()) {
await sleep(Math.min(nextWaitMs, remaining));
nextWaitMs = waitMs;
const left = deadline - Date.now();
if (left <= 0) break;
// One request per interval, cut off at the grant deadline; the loop owns every retry.
const pollSignal = signal ? AbortSignal.any([signal, AbortSignal.timeout(left)]) : AbortSignal.timeout(left);
try {
const payload = await postXaiToken(
discovery.tokenEndpoint,
{ grant_type: XAI_DEVICE_GRANT, client_id: XAI_OAUTH_CLIENT_ID, device_code: device.device_code },
pollSignal,
// The device code is a bearer-equivalent secret; it must not survive a redirect hop.
{ maxAttempts: 1, redirect: "error" },
);
return credentialsFromTokenPayload(payload);
} catch (error) {
if (signal?.aborted) throw error;
// Checked before the retriable branches: it subclasses `XaiTokenRequestError` with no
// status, which they would otherwise read as a transient network failure and poll on
// until the grant expires.
if (error instanceof XaiRedirectRefusedError) throw error;
if (error instanceof XaiTokenRequestError) {
if (error.oauthError === "slow_down") {
lastFailure = error.status === 400 ? undefined : error;
// RFC 8628 §3.5: lengthen the interval by 5s and never poll faster than before. Kept
// under the same ceiling so the sleep cannot overflow into an immediate retry.
waitMs = Math.min(ttlMs, waitMs + 5_000);
nextWaitMs = Math.min(ttlMs, Math.max(waitMs, error.retryAfterMs ?? 0));
continue;
}
// Still waiting for approval, or a network or server failure the grant can outlast.
const status = error.status;
if (error.oauthError === "authorization_pending" || status === undefined || status === 429 || status >= 500) {
// Only an ordinary pending answer clears the cause; a 429/5xx carrying that body is still an outage.
lastFailure = error.oauthError === "authorization_pending" && status === 400 ? undefined : error;
// The server's own throttle wins over this client's interval, but never over the
// grant deadline: the loop still sleeps at most what the grant has left.
if (error.retryAfterMs !== undefined) nextWaitMs = Math.min(ttlMs, Math.max(waitMs, error.retryAfterMs));
continue;
}
throw error;
}
// A timed-out poll (Bun reports it as TimeoutError or AbortError) is retried; the deadline still holds.
const name = (error as { name?: string } | undefined)?.name;
if (name === "TimeoutError" || name === "AbortError") { lastFailure = error; continue; }
throw error;
}
}
if (lastFailure) throw lastFailure;
throw new XaiTokenRequestError(undefined, "expired_token", "xAI device authorization expired");
}
export async function loginXai(
ctrl: OAuthController,
opts?: { importLocal?: LocalTokenImportMode; device?: boolean },
): Promise<OAuthCredentials> {
if (opts?.device) return loginXaiDevice(ctrl);
const importLocal = opts?.importLocal ?? "off";
if (importLocal !== "off") {
const { detectGrokCliToken } = await import("./local-token-detect");
const local = detectGrokCliToken();
if (local) {
ctrl.onProgress?.("Found Grok CLI token, importing automatically");
if (local.expires >= Date.now() + 60_000) return local;
try {
const fresh = await refreshXaiToken(local.refresh, ctrl.signal);
ctrl.onProgress?.(XAI_LOCAL_CLI_DETACH_WARNING);
return { ...fresh, source: "oauth" };
} catch (error) {
if (importLocal === "only") {
throw new Error(
`Grok CLI token is expired and could not be refreshed: ${error instanceof Error ? error.message : String(error)}`,
);
}
}
} else if (importLocal === "only") {
throw new Error("No Grok CLI token found at ~/.grok/auth.json. Run 'ocx login xai' for browser OAuth.");
}
}
return new XaiOAuthFlow(ctrl).login();
}
export async function refreshXaiToken(refreshToken: string, signal?: AbortSignal): Promise<OAuthCredentials> {
if (!refreshToken) {
throw new Error("xAI credentials are expired and do not include a refresh token");
}
const discovery = await discoverXaiOAuthEndpoints(signal);
const tokenPayload = await postXaiToken(
discovery.tokenEndpoint,
{
grant_type: "refresh_token",
client_id: XAI_OAUTH_CLIENT_ID,
refresh_token: refreshToken,
},
signal,
);
return credentialsFromTokenPayload(tokenPayload, refreshToken);
}