opencode-antigravity-auth-mf 11.3.0

package/dist/src/plugin/recovery.js

@@ -0,0 +1,376 @@
+/**
+ * Session recovery hook for handling recoverable errors.
+ *
+ * Supports:
+ * - tool_result_missing: When ESC is pressed during tool execution
+ * - thinking_block_order: When thinking blocks are corrupted/stripped
+ * - thinking_disabled_violation: Thinking in non-thinking model
+ *
+ * Based on oh-my-opencode/src/hooks/session-recovery/index.ts
+ */
+import { createLogger } from "./logger";
+import { readParts, findMessagesWithThinkingBlocks, findMessagesWithOrphanThinking, findMessageByIndexNeedingThinking, prependThinkingPart, stripThinkingParts, } from "./recovery/storage";
+// =============================================================================
+// Constants
+// =============================================================================
+const RECOVERY_RESUME_TEXT = "[session recovered - continuing previous task]";
+// =============================================================================
+// Error Detection
+// =============================================================================
+/**
+ * Extract a normalized error message string from an unknown error.
+ */
+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 "";
+    }
+}
+/**
+ * Extract the message index from an error message (e.g., "messages.79").
+ */
+function extractMessageIndex(error) {
+    const message = getErrorMessage(error);
+    const match = message.match(/messages\.(\d+)/);
+    if (!match || !match[1])
+        return null;
+    return parseInt(match[1], 10);
+}
+/**
+ * Detect the type of recoverable error from an error object.
+ */
+export function detectErrorType(error) {
+    const message = getErrorMessage(error);
+    // tool_result_missing: Happens when ESC is pressed during tool execution
+    if (message.includes("tool_use") && message.includes("tool_result")) {
+        return "tool_result_missing";
+    }
+    // thinking_block_order: Happens when thinking blocks are corrupted
+    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";
+    }
+    // thinking_disabled_violation: Thinking in non-thinking model
+    if (message.includes("thinking is disabled") && message.includes("cannot contain")) {
+        return "thinking_disabled_violation";
+    }
+    return null;
+}
+/**
+ * Check if an error is recoverable.
+ */
+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);
+}
+// =============================================================================
+// Recovery Functions
+// =============================================================================
+/**
+ * Recover from tool_result_missing error by injecting synthetic tool_result blocks.
+ */
+async function recoverToolResultMissing(client, sessionID, failedMsg) {
+    // Try API parts first, fallback to filesystem if empty
+    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 client.session.prompt({
+            path: { id: sessionID },
+            // @ts-expect-error - SDK types may not include tool_result parts
+            body: { parts: toolResultParts },
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Recover from thinking_block_order error by prepending thinking parts.
+ */
+async function recoverThinkingBlockOrder(sessionID, _failedMsg, error) {
+    // Try to find the target message index from error
+    const targetIndex = extractMessageIndex(error);
+    if (targetIndex !== null) {
+        const targetMessageID = findMessageByIndexNeedingThinking(sessionID, targetIndex);
+        if (targetMessageID) {
+            return prependThinkingPart(sessionID, targetMessageID);
+        }
+    }
+    // Fallback: find all orphan thinking messages
+    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;
+}
+/**
+ * Recover from thinking_disabled_violation by stripping thinking parts.
+ */
+async 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;
+}
+// =============================================================================
+// Resume Session Helper
+// =============================================================================
+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;
+    }
+}
+// =============================================================================
+// Toast Messages
+// =============================================================================
+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.",
+    };
+}
+/**
+ * Create a session recovery hook with the given configuration.
+ */
+export function createSessionRecoveryHook(ctx, config) {
+    // If session recovery is disabled, return null
+    if (!config.session_recovery) {
+        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) => {
+        // Validate input
+        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;
+        // OpenCode's session.error event may not include messageID
+        // In that case, we need to fetch messages and find the latest assistant with error
+        let assistantMsgID = info.id;
+        let msgs;
+        const log = createLogger("session-recovery");
+        log.debug("Recovery attempt started", {
+            errorType,
+            sessionID,
+            providedMsgID: assistantMsgID ?? "none",
+        });
+        // Notify abort callback early
+        if (onAbortCallback) {
+            onAbortCallback(sessionID);
+        }
+        // Abort current request
+        await client.session.abort({ path: { id: sessionID } }).catch(() => { });
+        // Fetch messages - needed to find the failed message
+        const messagesResp = await client.session.messages({
+            path: { id: sessionID },
+            query: { directory },
+        });
+        msgs = messagesResp.data;
+        // If messageID wasn't provided, find the latest assistant message with an error
+        if (!assistantMsgID && msgs && msgs.length > 0) {
+            // Find the last assistant message (most recent is typically last in array)
+            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;
+            }
+            // Show toast notification
+            const toastContent = getRecoveryToastContent(errorType);
+            await client.tui
+                .showToast({
+                body: {
+                    title: toastContent.title,
+                    message: toastContent.message,
+                    variant: "warning",
+                },
+            })
+                .catch(() => { });
+            // Perform recovery based on error type
+            let success = false;
+            if (errorType === "tool_result_missing") {
+                success = await recoverToolResultMissing(client, sessionID, failedMsg);
+            }
+            else if (errorType === "thinking_block_order") {
+                success = await recoverThinkingBlockOrder(sessionID, failedMsg, info.error);
+                if (success && config.auto_resume) {
+                    const lastUser = findLastUserMessage(msgs ?? []);
+                    const resumeConfig = extractResumeConfig(lastUser, sessionID);
+                    await resumeSession(client, resumeConfig, directory);
+                }
+            }
+            else if (errorType === "thinking_disabled_violation") {
+                success = await recoverThinkingDisabledViolation(sessionID, failedMsg);
+                if (success && config.auto_resume) {
+                    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);
+            // Always notify recovery complete
+            if (sessionID && onRecoveryCompleteCallback) {
+                onRecoveryCompleteCallback(sessionID);
+            }
+        }
+    };
+    return {
+        handleSessionRecovery,
+        isRecoverableError,
+        setOnAbortCallback,
+        setOnRecoveryCompleteCallback,
+    };
+}
+//# sourceMappingURL=recovery.js.map

package/dist/src/plugin/recovery.js.map

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

package/dist/src/plugin/refresh-queue.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Proactive Token Refresh Queue
+ *
+ * Ported from LLM-API-Key-Proxy's BackgroundRefresher.
+ *
+ * This module provides background token refresh to ensure OAuth tokens
+ * remain valid without blocking user requests. It periodically checks
+ * all accounts and refreshes tokens that are approaching expiry.
+ *
+ * Features:
+ * - Non-blocking background refresh (doesn't block requests)
+ * - Configurable refresh buffer (default: 30 minutes before expiry)
+ * - Configurable check interval (default: 5 minutes)
+ * - Serialized refresh to prevent concurrent refresh storms
+ * - Integrates with existing AccountManager and token refresh logic
+ * - Silent operation: no console output, uses structured logger
+ */
+import type { AccountManager, ManagedAccount } from "./accounts";
+import type { PluginClient } from "./types";
+/** Configuration for the proactive refresh queue */
+export interface ProactiveRefreshConfig {
+    /** Enable proactive token refresh (default: true) */
+    enabled: boolean;
+    /** Seconds before expiry to trigger proactive refresh (default: 1800 = 30 minutes) */
+    bufferSeconds: number;
+    /** Interval between refresh checks in seconds (default: 300 = 5 minutes) */
+    checkIntervalSeconds: number;
+}
+export declare const DEFAULT_PROACTIVE_REFRESH_CONFIG: ProactiveRefreshConfig;
+/**
+ * Proactive Token Refresh Queue
+ *
+ * Runs in the background and proactively refreshes tokens before they expire.
+ * This ensures that user requests never block on token refresh.
+ *
+ * All logging is silent by default - uses structured logger that only outputs
+ * when OPENCODE_ANTIGRAVITY_CONSOLE_LOG=1 is set or TUI logging is available.
+ */
+export declare class ProactiveRefreshQueue {
+    private readonly config;
+    private readonly client;
+    private readonly providerId;
+    private accountManager;
+    private state;
+    constructor(client: PluginClient, providerId: string, config?: Partial<ProactiveRefreshConfig>);
+    /**
+     * Set the account manager to use for refresh operations.
+     * Must be called before start().
+     */
+    setAccountManager(manager: AccountManager): void;
+    /**
+     * Check if a token needs proactive refresh.
+     * Returns true if the token expires within the buffer period.
+     */
+    needsRefresh(account: ManagedAccount): boolean;
+    /**
+     * Check if a token is already expired.
+     */
+    isExpired(account: ManagedAccount): boolean;
+    /**
+     * Get all accounts that need proactive refresh.
+     */
+    getAccountsNeedingRefresh(): ManagedAccount[];
+    /**
+     * Perform a single refresh check iteration.
+     * This is called periodically by the background interval.
+     */
+    private runRefreshCheck;
+    /**
+     * Refresh a single token.
+     */
+    private refreshToken;
+    /**
+     * Start the background refresh queue.
+     */
+    start(): void;
+    /**
+     * Stop the background refresh queue.
+     */
+    stop(): void;
+    /**
+     * Get current queue statistics.
+     */
+    getStats(): {
+        isRunning: boolean;
+        isRefreshing: boolean;
+        lastCheckTime: number;
+        lastRefreshTime: number;
+        refreshCount: number;
+        errorCount: number;
+    };
+    /**
+     * Check if the queue is currently running.
+     */
+    isRunning(): boolean;
+}
+/**
+ * Create a proactive refresh queue instance.
+ */
+export declare function createProactiveRefreshQueue(client: PluginClient, providerId: string, config?: Partial<ProactiveRefreshConfig>): ProactiveRefreshQueue;
+//# sourceMappingURL=refresh-queue.d.ts.map

package/dist/src/plugin/refresh-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-queue.d.ts","sourceRoot":"","sources":["../../../src/plugin/refresh-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,SAAS,CAAC;AAM9D,oDAAoD;AACpD,MAAM,WAAW,sBAAsB;IACrC,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,sFAAsF;IACtF,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,gCAAgC,EAAE,sBAI9C,CAAC;AAaF;;;;;;;;GAQG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,cAAc,CAA+B;IAErD,OAAO,CAAC,KAAK,CAQX;gBAGA,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC;IAU1C;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIhD;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;IAa9C;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;IAO3C;;OAEG;IACH,yBAAyB,IAAI,cAAc,EAAE;IAc7C;;;OAGG;YACW,eAAe;IA2D7B;;OAEG;YACW,YAAY;IAiB1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAuCb;;OAEG;IACH,IAAI,IAAI,IAAI;IAkBZ;;OAEG;IACH,QAAQ,IAAI;QACV,SAAS,EAAE,OAAO,CAAC;QACnB,YAAY,EAAE,OAAO,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB;IAID;;OAEG;IACH,SAAS,IAAI,OAAO;CAGrB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACvC,qBAAqB,CAEvB"}