@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
125 lines (115 loc) • 5.39 kB
text/typescript
/** Minimal OAuth types, ported from jawcode packages/ai/src/utils/oauth/types.ts. */
export type OAuthCredentialSource = "oauth" | "local-cli" | "credential-file" | "environment" | "manual";
/**
* How the account authenticated. Mirrors `KiroAuthType` in `./kiro-credentials`, restated here so
* the credential-store types do not depend on the SQLite import module.
*
* `aws_sso_oidc` covers AWS Builder ID, which never issues an account-scoped CodeWhisperer
* profile ARN; the adapter needs that distinction to tell a Builder ID account apart from a
* `kiro_desktop` account whose profile import merely failed.
*/
export type KiroCredentialAuthType = "kiro_desktop" | "aws_sso_oidc";
/** Account-scoped Kiro data required for refresh and request routing. */
export interface KiroOAuthMetadata {
profileArn?: string;
ssoRegion?: string;
apiRegion?: string;
clientId?: string;
clientSecret?: string;
/**
* Non-secret routing signal. Derived from the presence of a device-registration client pair, so
* it stays accurate even though `clientId`/`clientSecret` never leave the credential store.
*/
authType?: KiroCredentialAuthType;
}
/**
* Account-scoped Muse Code data that is NOT the request bearer.
*
* The Model API is authenticated by the `LLM|` key in `access`; this token authenticates
* the Meta ACCOUNT and exists only to mint that key and to read subscription usage
* (devlog/_plan/260912_muse_device_oauth/002 A). Keeping it out of `access` is what lets
* every request path stay unchanged.
*
* It must never be added to `OAuthAccountSummary` (src/oauth/index.ts:1803) or to
* `OAuthAccessSnapshot` (src/oauth/index.ts:85-100). Both are hand-built allowlists, and
* that construction — not a redactor — is what keeps a secret out of a response.
*/
export interface MuseOAuthMetadata {
/** Meta account access token from the device grant. Never sent to api.meta.ai/v1. */
oauthAccessToken: string;
/**
* The stable Meta account id. Kept HERE rather than in `accountId` on purpose (wp2
* audit fold W2): the store keys a slot on `accountId ?? email`, and this provider
* import path has always supplied email only. Promoting `user_id` to `accountId` would
* make a device login fail to match the row an imported login already created, giving
* one human two accounts.
*/
userId?: string;
/** Epoch ms of the mint that produced the stored key. */
mintedAt?: number;
/** Subscription tier label as Meta reported it. Display only. */
tierName?: string;
}
export type OAuthCredentials = {
refresh: string;
access: string;
/** Epoch ms after any small provider-specific early-refresh margin; the shared gate adds 1 minute. */
expires: number;
email?: string;
accountId?: string;
source?: OAuthCredentialSource;
/** Google Antigravity (Cloud Code Assist) discovered project id; injected into the CCA envelope. */
projectId?: string;
/**
* GitHub Copilot allowlisted API origin from token `endpoints.api` (HTTPS `*.githubcopilot.com` only).
* Never reuse for Antigravity projectId; validated on write and again at request time.
*/
apiBaseUrl?: string;
/** Never returned by management APIs; persisted only inside the protected auth-store boundary. */
kiro?: KiroOAuthMetadata;
/** Never returned by management APIs; persisted only inside the protected auth-store boundary. */
muse?: MuseOAuthMetadata;
};
/** One logged-in account inside a provider's account set (multiauth). */
export interface ProviderAccount {
/** Stable short id, generated once at append time; never re-derived after rotation. */
id: string;
/** Rotated on each explicit login and retained across token refreshes. */
loginId?: string;
/** Native Kiro device accounts cannot use the kiro-cli reauth path. */
loginOrigin?: "kiro-device";
/** User-owned display label; never participates in auth identity or routing. */
alias?: string;
credential: OAuthCredentials;
/** Terminal refresh failure (invalid_grant / reused / revoked) — re-login required. */
needsReauth?: boolean;
/** Operator exclusion from generic OAuth account selection until explicitly resumed. */
paused?: boolean;
/** Anthropic-only usage-switch override; absent inherits its pool default, zero disables it. */
autoSwitchThresholdOverride?: number;
addedAt?: number;
}
/** auth.json value per provider: N accounts + which one requests use. */
export interface ProviderAccountSet {
activeAccountId: string;
/** Opaque selection generation; absent in legacy stores, independent of token refresh. */
selectionRevision?: string;
accounts: ProviderAccount[];
}
/** Non-secret snapshot used to condition a selection on the choice that started a request. */
export interface OAuthAccountSelection {
accountId: string;
revision?: string;
}
export interface OAuthController {
onAuth?(info: { url: string; instructions?: string; deviceCode?: string }): void;
onProgress?(message: string): void;
onManualCodeInput?(expectedState?: string): Promise<string>;
signal?: AbortSignal;
}
/**
* How a login flow may use a locally detected CLI token.
* "off" goes straight to the real OAuth flow, "fallback" imports a local token when present
* and falls back to OAuth otherwise, "only" imports without any OAuth fallback.
*/
export type LocalTokenImportMode = "off" | "fallback" | "only";