codex-multi-auth 0.1.0

package/dist/lib/recovery.js

@@ -0,0 +1,313 @@
+import { createLogger } from "./logger.js";
+import { readParts, findMessagesWithThinkingBlocks, findMessagesWithOrphanThinking, findMessageByIndexNeedingThinking, prependThinkingPart, stripThinkingParts, } from "./recovery/storage.js";
+const RECOVERY_RESUME_TEXT = "[session recovered - continuing previous task]";
+function getErrorMessage(error) {
+    if (!error)
+        return "";
+    if (typeof error === "string")
+        return error.toLowerCase();
+    const errorObj = error;
+    const paths = [
+        errorObj.data,
+        errorObj.error,
+        errorObj,
+        errorObj.data?.error,
+    ];
+    for (const obj of paths) {
+        if (obj && typeof obj === "object") {
+            const msg = obj.message;
+            if (typeof msg === "string" && msg.length > 0) {
+                return msg.toLowerCase();
+            }
+        }
+    }
+    try {
+        return JSON.stringify(error).toLowerCase();
+    }
+    catch {
+        return "";
+    }
+}
+function extractMessageIndex(error) {
+    const message = getErrorMessage(error);
+    const match = message.match(/messages\.(\d+)/);
+    if (!match || !match[1])
+        return null;
+    return parseInt(match[1], 10);
+}
+export function detectErrorType(error) {
+    const message = getErrorMessage(error);
+    if (message.includes("tool_use") && message.includes("tool_result")) {
+        return "tool_result_missing";
+    }
+    if (message.includes("thinking") &&
+        (message.includes("first block") ||
+            message.includes("must start with") ||
+            message.includes("preceeding") ||
+            (message.includes("expected") && message.includes("found")))) {
+        return "thinking_block_order";
+    }
+    if (message.includes("thinking is disabled") && message.includes("cannot contain")) {
+        return "thinking_disabled_violation";
+    }
+    return null;
+}
+export function isRecoverableError(error) {
+    return detectErrorType(error) !== null;
+}
+function extractToolUseIds(parts) {
+    return parts
+        .filter((p) => p.type === "tool_use" && !!p.id)
+        .map((p) => p.id);
+}
+async function sendToolResultsForRecovery(client, sessionID, toolResultParts) {
+    const bodyWithParts = {
+        parts: toolResultParts,
+    };
+    await client.session.prompt({
+        path: { id: sessionID },
+        body: bodyWithParts,
+    });
+}
+async function recoverToolResultMissing(client, sessionID, failedMsg) {
+    let parts = failedMsg.parts || [];
+    if (parts.length === 0 && failedMsg.info?.id) {
+        const storedParts = readParts(failedMsg.info.id);
+        parts = storedParts.map((p) => ({
+            type: p.type === "tool" ? "tool_use" : p.type,
+            id: "callID" in p ? p.callID : p.id,
+            name: "tool" in p ? p.tool : undefined,
+            input: "state" in p ? p.state?.input : undefined,
+        }));
+    }
+    const toolUseIds = extractToolUseIds(parts);
+    if (toolUseIds.length === 0) {
+        return false;
+    }
+    const toolResultParts = toolUseIds.map((id) => ({
+        type: "tool_result",
+        tool_use_id: id,
+        content: "Operation cancelled by user (ESC pressed)",
+    }));
+    try {
+        await sendToolResultsForRecovery(client, sessionID, toolResultParts);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function recoverThinkingBlockOrder(sessionID, _failedMsg, error) {
+    const targetIndex = extractMessageIndex(error);
+    if (targetIndex !== null) {
+        const targetMessageID = findMessageByIndexNeedingThinking(sessionID, targetIndex);
+        if (targetMessageID) {
+            return prependThinkingPart(sessionID, targetMessageID);
+        }
+    }
+    const orphanMessages = findMessagesWithOrphanThinking(sessionID);
+    if (orphanMessages.length === 0) {
+        return false;
+    }
+    let anySuccess = false;
+    for (const messageID of orphanMessages) {
+        if (prependThinkingPart(sessionID, messageID)) {
+            anySuccess = true;
+        }
+    }
+    return anySuccess;
+}
+function recoverThinkingDisabledViolation(sessionID, _failedMsg) {
+    const messagesWithThinking = findMessagesWithThinkingBlocks(sessionID);
+    if (messagesWithThinking.length === 0) {
+        return false;
+    }
+    let anySuccess = false;
+    for (const messageID of messagesWithThinking) {
+        if (stripThinkingParts(messageID)) {
+            anySuccess = true;
+        }
+    }
+    return anySuccess;
+}
+function findLastUserMessage(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        if (messages[i]?.info?.role === "user") {
+            return messages[i];
+        }
+    }
+    return undefined;
+}
+function extractResumeConfig(userMessage, sessionID) {
+    return {
+        sessionID,
+        agent: userMessage?.info?.agent,
+        model: userMessage?.info?.model,
+    };
+}
+async function resumeSession(client, config, directory) {
+    try {
+        await client.session.prompt({
+            path: { id: config.sessionID },
+            body: {
+                parts: [{ type: "text", text: RECOVERY_RESUME_TEXT }],
+                agent: config.agent,
+                model: config.model,
+            },
+            query: { directory },
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const TOAST_TITLES = {
+    tool_result_missing: "Tool Crash Recovery",
+    thinking_block_order: "Thinking Block Recovery",
+    thinking_disabled_violation: "Thinking Strip Recovery",
+};
+const TOAST_MESSAGES = {
+    tool_result_missing: "Injecting cancelled tool results...",
+    thinking_block_order: "Fixing message structure...",
+    thinking_disabled_violation: "Stripping thinking blocks...",
+};
+export function getRecoveryToastContent(errorType) {
+    if (!errorType) {
+        return {
+            title: "Session Recovery",
+            message: "Attempting to recover session...",
+        };
+    }
+    return {
+        title: TOAST_TITLES[errorType] || "Session Recovery",
+        message: TOAST_MESSAGES[errorType] || "Attempting to recover session...",
+    };
+}
+export function getRecoverySuccessToast() {
+    return {
+        title: "Session Recovered",
+        message: "Continuing where you left off...",
+    };
+}
+export function getRecoveryFailureToast() {
+    return {
+        title: "Recovery Failed",
+        message: "Please retry or start a new session.",
+    };
+}
+export function createSessionRecoveryHook(ctx, config) {
+    if (!config.sessionRecovery) {
+        return null;
+    }
+    const { client, directory } = ctx;
+    const processingErrors = new Set();
+    let onAbortCallback = null;
+    let onRecoveryCompleteCallback = null;
+    const setOnAbortCallback = (callback) => {
+        onAbortCallback = callback;
+    };
+    const setOnRecoveryCompleteCallback = (callback) => {
+        onRecoveryCompleteCallback = callback;
+    };
+    const handleSessionRecovery = async (info) => {
+        if (!info || info.role !== "assistant" || !info.error)
+            return false;
+        const errorType = detectErrorType(info.error);
+        if (!errorType)
+            return false;
+        const sessionID = info.sessionID;
+        if (!sessionID)
+            return false;
+        let assistantMsgID = info.id;
+        const log = createLogger("session-recovery");
+        log.debug("Recovery attempt started", {
+            errorType,
+            sessionID,
+            providedMsgID: assistantMsgID ?? "none",
+        });
+        if (onAbortCallback) {
+            onAbortCallback(sessionID);
+        }
+        await client.session.abort({ path: { id: sessionID } }).catch(() => { });
+        const messagesResp = await client.session.messages({
+            path: { id: sessionID },
+            query: { directory },
+        });
+        const msgs = messagesResp.data;
+        if (!assistantMsgID && msgs && msgs.length > 0) {
+            for (let i = msgs.length - 1; i >= 0; i--) {
+                const m = msgs[i];
+                if (m && m.info?.role === "assistant" && m.info?.id) {
+                    assistantMsgID = m.info.id;
+                    log.debug("Found assistant message ID from session messages", {
+                        msgID: assistantMsgID,
+                        msgIndex: i,
+                    });
+                    break;
+                }
+            }
+        }
+        if (!assistantMsgID) {
+            log.debug("No assistant message ID found, cannot recover");
+            return false;
+        }
+        if (processingErrors.has(assistantMsgID))
+            return false;
+        processingErrors.add(assistantMsgID);
+        try {
+            const failedMsg = msgs?.find((m) => m.info?.id === assistantMsgID);
+            if (!failedMsg) {
+                return false;
+            }
+            const toastContent = getRecoveryToastContent(errorType);
+            await client.tui
+                .showToast({
+                body: {
+                    title: toastContent.title,
+                    message: toastContent.message,
+                    variant: "warning",
+                },
+            })
+                .catch(() => { });
+            let success = false;
+            if (errorType === "tool_result_missing") {
+                success = await recoverToolResultMissing(client, sessionID, failedMsg);
+            }
+            else if (errorType === "thinking_block_order") {
+                success = recoverThinkingBlockOrder(sessionID, failedMsg, info.error);
+                if (success && config.autoResume) {
+                    const lastUser = findLastUserMessage(msgs ?? []);
+                    const resumeConfig = extractResumeConfig(lastUser, sessionID);
+                    await resumeSession(client, resumeConfig, directory);
+                }
+            }
+            else if (errorType === "thinking_disabled_violation") {
+                success = recoverThinkingDisabledViolation(sessionID, failedMsg);
+                if (success && config.autoResume) {
+                    const lastUser = findLastUserMessage(msgs ?? []);
+                    const resumeConfig = extractResumeConfig(lastUser, sessionID);
+                    await resumeSession(client, resumeConfig, directory);
+                }
+            }
+            return success;
+        }
+        catch (err) {
+            log.error("Recovery failed", { error: String(err) });
+            return false;
+        }
+        finally {
+            processingErrors.delete(assistantMsgID);
+            if (sessionID && onRecoveryCompleteCallback) {
+                onRecoveryCompleteCallback(sessionID);
+            }
+        }
+    };
+    return {
+        handleSessionRecovery,
+        isRecoverableError,
+        setOnAbortCallback,
+        setOnRecoveryCompleteCallback,
+    };
+}
+//# sourceMappingURL=recovery.js.map

package/dist/lib/recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../lib/recovery.ts"],"names":[],"mappings":"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"}

package/dist/lib/refresh-guardian.d.ts

@@ -0,0 +1,31 @@
+import type { AccountManager } from "./accounts.js";
+export interface RefreshGuardianOptions {
+    intervalMs?: number;
+    bufferMs?: number;
+}
+export interface RefreshGuardianStats {
+    runs: number;
+    refreshed: number;
+    failed: number;
+    notNeeded: number;
+    noRefreshToken: number;
+    rateLimited: number;
+    networkFailed: number;
+    authFailed: number;
+    lastRunAt: number | null;
+}
+export declare class RefreshGuardian {
+    private readonly getAccountManager;
+    private readonly intervalMs;
+    private readonly bufferMs;
+    private timer;
+    private running;
+    private stats;
+    constructor(getAccountManager: () => AccountManager | null, options?: RefreshGuardianOptions);
+    start(): void;
+    stop(): void;
+    getStats(): RefreshGuardianStats;
+    private classifyFailureReason;
+    tick(): Promise<void>;
+}
+//# sourceMappingURL=refresh-guardian.d.ts.map

package/dist/lib/refresh-guardian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-guardian.d.ts","sourceRoot":"","sources":["../../lib/refresh-guardian.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAMpD,MAAM,WAAW,sBAAsB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAID,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA8B;IAChE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAUX;gBAGD,iBAAiB,EAAE,MAAM,cAAc,GAAG,IAAI,EAC9C,OAAO,GAAE,sBAA2B;IAOrC,KAAK,IAAI,IAAI;IAcb,IAAI,IAAI,IAAI;IAMZ,QAAQ,IAAI,oBAAoB;IAIhC,OAAO,CAAC,qBAAqB;IAmBvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA8E3B"}

package/dist/lib/refresh-guardian.js

@@ -0,0 +1,151 @@
+import { createLogger } from "./logger.js";
+import { applyRefreshResult, refreshExpiringAccounts } from "./proactive-refresh.js";
+const log = createLogger("refresh-guardian");
+const DEFAULT_INTERVAL_MS = 60_000;
+export class RefreshGuardian {
+    getAccountManager;
+    intervalMs;
+    bufferMs;
+    timer = null;
+    running = false;
+    stats = {
+        runs: 0,
+        refreshed: 0,
+        failed: 0,
+        notNeeded: 0,
+        noRefreshToken: 0,
+        rateLimited: 0,
+        networkFailed: 0,
+        authFailed: 0,
+        lastRunAt: null,
+    };
+    constructor(getAccountManager, options = {}) {
+        this.getAccountManager = getAccountManager;
+        this.intervalMs = Math.max(5_000, Math.floor(options.intervalMs ?? DEFAULT_INTERVAL_MS));
+        this.bufferMs = Math.max(30_000, Math.floor(options.bufferMs ?? 5 * 60_000));
+    }
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => {
+            void this.tick();
+        }, this.intervalMs);
+        if (typeof this.timer === "object" && "unref" in this.timer && typeof this.timer.unref === "function") {
+            this.timer.unref();
+        }
+        log.debug("Refresh guardian started", {
+            intervalMs: this.intervalMs,
+            bufferMs: this.bufferMs,
+        });
+    }
+    stop() {
+        if (!this.timer)
+            return;
+        clearInterval(this.timer);
+        this.timer = null;
+    }
+    getStats() {
+        return { ...this.stats };
+    }
+    classifyFailureReason(tokenResult) {
+        if (!tokenResult || tokenResult.type !== "failed") {
+            return "network-error";
+        }
+        const statusCode = tokenResult.statusCode;
+        if (statusCode === 429)
+            return "rate-limit";
+        if (tokenResult.reason === "network_error")
+            return "network-error";
+        if (tokenResult.reason === "missing_refresh")
+            return "auth-failure";
+        if (tokenResult.reason === "invalid_response")
+            return "auth-failure";
+        if (tokenResult.reason === "http_error" &&
+            (statusCode === 400 || statusCode === 401 || statusCode === 403)) {
+            return "auth-failure";
+        }
+        return "network-error";
+    }
+    async tick() {
+        if (this.running)
+            return;
+        const manager = this.getAccountManager();
+        if (!manager)
+            return;
+        this.running = true;
+        try {
+            const snapshot = manager.getAccountsSnapshot().filter((account) => account.enabled !== false);
+            if (snapshot.length === 0) {
+                return;
+            }
+            const refreshResults = await refreshExpiringAccounts(snapshot, this.bufferMs);
+            if (refreshResults.size === 0) {
+                this.stats.runs += 1;
+                this.stats.lastRunAt = Date.now();
+                return;
+            }
+            const snapshotByIndex = new Map();
+            for (const candidate of snapshot) {
+                snapshotByIndex.set(candidate.index, candidate);
+            }
+            for (const [accountIndex, result] of refreshResults.entries()) {
+                const sourceAccount = snapshotByIndex.get(accountIndex);
+                if (!sourceAccount)
+                    continue;
+                const liveAccounts = manager.getAccountsSnapshot();
+                const resolvedIndex = liveAccounts.findIndex((candidate) => candidate.refreshToken === sourceAccount.refreshToken);
+                const account = resolvedIndex >= 0 ? manager.getAccountByIndex(resolvedIndex) : null;
+                if (!account)
+                    continue;
+                switch (result.reason) {
+                    case "success":
+                        if (result.tokenResult?.type === "success") {
+                            applyRefreshResult(account, result.tokenResult);
+                            manager.clearAuthFailures(account);
+                            this.stats.refreshed += 1;
+                        }
+                        else {
+                            manager.markAccountCoolingDown(account, this.bufferMs, "network-error");
+                            this.stats.failed += 1;
+                            this.stats.networkFailed += 1;
+                        }
+                        break;
+                    case "failed": {
+                        const cooldownReason = this.classifyFailureReason(result.tokenResult);
+                        manager.markAccountCoolingDown(account, this.bufferMs, cooldownReason);
+                        this.stats.failed += 1;
+                        if (cooldownReason === "rate-limit")
+                            this.stats.rateLimited += 1;
+                        else if (cooldownReason === "auth-failure")
+                            this.stats.authFailed += 1;
+                        else
+                            this.stats.networkFailed += 1;
+                        break;
+                    }
+                    case "not_needed":
+                        this.stats.notNeeded += 1;
+                        break;
+                    case "no_refresh_token":
+                        manager.markAccountCoolingDown(account, this.bufferMs, "auth-failure");
+                        manager.setAccountEnabled(account.index, false);
+                        this.stats.noRefreshToken += 1;
+                        this.stats.failed += 1;
+                        this.stats.authFailed += 1;
+                        break;
+                }
+            }
+            manager.saveToDiskDebounced();
+            this.stats.runs += 1;
+            this.stats.lastRunAt = Date.now();
+        }
+        catch (error) {
+            log.warn("Refresh guardian tick failed", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        finally {
+            this.running = false;
+        }
+    }
+}
+//# sourceMappingURL=refresh-guardian.js.map

package/dist/lib/refresh-guardian.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-guardian.js","sourceRoot":"","sources":["../../lib/refresh-guardian.ts"],"names":[],"mappings":"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"}

package/dist/lib/refresh-lease.d.ts

@@ -0,0 +1,37 @@
+import { promises as fs } from "node:fs";
+import type { TokenResult } from "./types.js";
+type LeaseFsOps = Pick<typeof fs, "mkdir" | "open" | "writeFile" | "rename" | "unlink" | "readFile" | "stat" | "readdir">;
+export interface RefreshLeaseCoordinatorOptions {
+    enabled?: boolean;
+    leaseDir?: string;
+    leaseTtlMs?: number;
+    waitTimeoutMs?: number;
+    pollIntervalMs?: number;
+    resultTtlMs?: number;
+    fsOps?: LeaseFsOps;
+}
+export interface RefreshLeaseHandle {
+    role: "owner" | "follower" | "bypass";
+    result?: TokenResult;
+    release: (result?: TokenResult) => Promise<void>;
+}
+export declare class RefreshLeaseCoordinator {
+    private readonly enabled;
+    private readonly leaseDir;
+    private readonly leaseTtlMs;
+    private readonly waitTimeoutMs;
+    private readonly pollIntervalMs;
+    private readonly resultTtlMs;
+    private readonly fsOps;
+    constructor(options?: RefreshLeaseCoordinatorOptions);
+    static fromEnvironment(): RefreshLeaseCoordinator;
+    acquire(refreshToken: string): Promise<RefreshLeaseHandle>;
+    private createBypassHandle;
+    private createOwnerHandle;
+    private writeResult;
+    private readFreshResult;
+    private assessLockStaleness;
+    private pruneExpiredArtifacts;
+}
+export {};
+//# sourceMappingURL=refresh-lease.d.ts.map

package/dist/lib/refresh-lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-lease.d.ts","sourceRoot":"","sources":["../../lib/refresh-lease.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAKrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAuB9C,KAAK,UAAU,GAAG,IAAI,CACrB,OAAO,EAAE,EACT,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CACtF,CAAC;AAEF,MAAM,WAAW,8BAA8B;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IACtC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAiHD,qBAAa,uBAAuB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAEvB,OAAO,GAAE,8BAAmC;IAUxD,MAAM,CAAC,eAAe,IAAI,uBAAuB;IAgB3C,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6EhE,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,iBAAiB;YAsBX,WAAW;YAmBX,eAAe;YAiBf,mBAAmB;YAuCnB,qBAAqB;CAsBnC"}