@phren/cli
Version:
Knowledge layer for AI agents - CLI, MCP server, and data layer
41 lines (40 loc) • 2.15 kB
TypeScript
/**
* Every Codex process on a computer shares one ChatGPT sign-in in
* `$CODEX_HOME/auth.json`, and each refreshes it when `last_refresh` grows
* old (Codex's own threshold is 8 days). The refresh token rotates on every
* use, so processes that reach the threshold together (a batch of workers,
* one app-server per pane) race: one wins, the rest spend a token that is
* already used and fail ("refresh token was already used"). Codex re-reads
* the file before refreshing and skips when another process already did.
* So the Hook refreshes first, once, before any process reaches the
* threshold, and the others take that skip path.
*/
/** Refresh when the sign-in is this old: well before Codex's 8 days. */
export declare const REFRESH_AFTER_MS: number;
/** The sign-in's last refresh, or undefined when auth.json holds no ChatGPT
* sign-in (an API key, no file) and there is nothing to refresh. */
export declare function lastCodexRefresh(file?: string): Promise<number | undefined>;
/** A doctor line for the ChatGPT sign-in Codex shares on this computer, or undefined when there is none
* to judge (no Codex, or an API key). A refresh token that has gone unused for over 9 days has expired
* server-side, and every `codex exec` and Hook-run worker then fails with a 401 until `codex login`. */
export declare function codexSignInCheck(file?: string, now?: number): Promise<{
ok: boolean;
message: string;
} | undefined>;
export declare function codexAuthRefreshEnabled(env?: NodeJS.ProcessEnv): boolean;
export interface CodexAuthRefresher {
/** One proactive refresh through Codex's own flow (`account/read` with
* `refreshToken`). */
refreshAuth(): Promise<void>;
}
/** Checks the sign-in's age and refreshes it once when it is due. One check
* runs at a time; a failed refresh is logged and tried again next tick. */
export declare class CodexAuthKeeper {
private readonly refresher;
private readonly file?;
private readonly now;
private running?;
constructor(refresher: CodexAuthRefresher, file?: string | undefined, now?: () => number);
tick(): Promise<boolean>;
private check;
}