mcp-subagents-opencode 1.0.0

package/build/services/retry-queue.js

@@ -0,0 +1,195 @@
+import { TaskStatus } from '../types.js';
+// Rate-limit detection patterns for HTTP error messages
+const RATE_LIMIT_PATTERNS = [
+    /rate limit/i,
+    /too many requests/i,
+    /try again in \d+ (hour|minute|second)/i,
+    /exceeded.*quota/i,
+    /throttl/i,
+];
+const DEFAULT_RETRY_DELAYS_MS = [
+    5 * 60 * 1000, // 5 minutes
+    10 * 60 * 1000, // 10 minutes
+    20 * 60 * 1000, // 20 minutes
+    40 * 60 * 1000, // 40 minutes
+    60 * 60 * 1000, // 1 hour
+    120 * 60 * 1000, // 2 hours (max)
+];
+const MAX_RETRIES = DEFAULT_RETRY_DELAYS_MS.length;
+/**
+ * Check if an error/output indicates rate limiting.
+ * Prefers structured failureContext over string parsing when available.
+ */
+export function isRateLimitError(output, error, task) {
+    // Prefer structured failure context
+    if (task?.failureContext?.statusCode === 429) {
+        return true;
+    }
+    // Check quota info for exhausted quota
+    if (task?.quotaInfo?.remainingPercentage !== undefined && task.quotaInfo.remainingPercentage < 1) {
+        return true;
+    }
+    // Fallback to string pattern matching
+    const allText = [...output, error || ''].join('\n');
+    return RATE_LIMIT_PATTERNS.some(pattern => pattern.test(allText));
+}
+/**
+ * Extract rate limit wait time from error message if present.
+ * Returns milliseconds or null if not found.
+ * Prefers quotaInfo.resetDate for precise timing when available.
+ */
+export function extractWaitTime(output, error, task) {
+    // Prefer quota reset date for precise timing
+    if (task?.quotaInfo?.resetDate) {
+        const resetTime = new Date(task.quotaInfo.resetDate).getTime();
+        const now = Date.now();
+        if (resetTime > now) {
+            return resetTime - now;
+        }
+    }
+    // Fallback to string parsing
+    const allText = [...output, error || ''].join('\n');
+    // Match patterns like "try again in 2 hours" or "wait 30 minutes"
+    const hourMatch = allText.match(/(?:try again|wait).*?(\d+)\s*hour/i);
+    if (hourMatch) {
+        return parseInt(hourMatch[1], 10) * 60 * 60 * 1000;
+    }
+    const minuteMatch = allText.match(/(?:try again|wait).*?(\d+)\s*minute/i);
+    if (minuteMatch) {
+        return parseInt(minuteMatch[1], 10) * 60 * 1000;
+    }
+    const secondMatch = allText.match(/(?:try again|wait).*?(\d+)\s*second/i);
+    if (secondMatch) {
+        return parseInt(secondMatch[1], 10) * 1000;
+    }
+    return null;
+}
+/**
+ * Calculate next retry time based on retry count and task data.
+ * Uses quotaInfo.resetDate when available for precise timing.
+ */
+export function calculateNextRetryTime(retryCount, suggestedWaitMs, task) {
+    let delayMs;
+    // Priority 1: Use quota reset date if available and in the future
+    if (task?.quotaInfo?.resetDate) {
+        const resetTime = new Date(task.quotaInfo.resetDate).getTime();
+        const now = Date.now();
+        if (resetTime > now) {
+            // Add a small buffer (30s) after reset
+            return new Date(resetTime + 30000).toISOString();
+        }
+    }
+    // Priority 2: Use suggested wait time from error message
+    if (suggestedWaitMs && suggestedWaitMs > 0) {
+        // Add some jitter to avoid thundering herd
+        delayMs = suggestedWaitMs + Math.random() * 60000; // +0-60s jitter
+    }
+    else {
+        // Priority 3: Use exponential backoff
+        const index = Math.min(retryCount, DEFAULT_RETRY_DELAYS_MS.length - 1);
+        delayMs = DEFAULT_RETRY_DELAYS_MS[index];
+    }
+    const nextRetryTime = new Date(Date.now() + delayMs);
+    return nextRetryTime.toISOString();
+}
+/**
+ * Create retry info for a rate-limited task.
+ * Uses structured task data for better timing when available.
+ */
+export function createRetryInfo(task, reason, existingRetryInfo) {
+    const retryCount = (existingRetryInfo?.retryCount ?? 0) + 1;
+    const suggestedWait = extractWaitTime(task.output, task.error, task);
+    // Use failure context for better reason if available
+    let enhancedReason = reason;
+    if (task.failureContext) {
+        const { errorType, statusCode, errorContext } = task.failureContext;
+        const parts = [];
+        if (statusCode)
+            parts.push(`status: ${statusCode}`);
+        if (errorType)
+            parts.push(`type: ${errorType}`);
+        if (errorContext)
+            parts.push(`context: ${errorContext}`);
+        if (parts.length > 0) {
+            enhancedReason = `${reason} (${parts.join(', ')})`;
+        }
+    }
+    return {
+        reason: enhancedReason,
+        retryCount,
+        nextRetryTime: calculateNextRetryTime(retryCount - 1, suggestedWait, task),
+        maxRetries: MAX_RETRIES,
+        originalTaskId: existingRetryInfo?.originalTaskId || task.id,
+    };
+}
+/**
+ * Check if a task should be retried now.
+ * Considers quota info when deciding whether to retry.
+ */
+export function shouldRetryNow(task) {
+    if (task.status !== TaskStatus.RATE_LIMITED) {
+        return false;
+    }
+    if (!task.retryInfo) {
+        return true; // No retry info, retry immediately
+    }
+    if (task.retryInfo.retryCount >= task.retryInfo.maxRetries) {
+        return false; // Max retries exceeded
+    }
+    // Check quota reset date if available
+    if (task.quotaInfo?.resetDate) {
+        const resetTime = new Date(task.quotaInfo.resetDate).getTime();
+        if (Date.now() < resetTime) {
+            return false; // Quota hasn't reset yet
+        }
+    }
+    const nextRetryTime = new Date(task.retryInfo.nextRetryTime).getTime();
+    return Date.now() >= nextRetryTime;
+}
+/**
+ * Check if a task has exceeded max retries.
+ */
+export function hasExceededMaxRetries(task) {
+    if (!task.retryInfo) {
+        return false;
+    }
+    return task.retryInfo.retryCount >= task.retryInfo.maxRetries;
+}
+/**
+ * Check if handoff is recommended instead of retry.
+ * Uses task data to make intelligent recommendations.
+ */
+export function shouldRecommendHandoff(task) {
+    // If max retries exceeded and we have multiple accounts, recommend handoff
+    if (hasExceededMaxRetries(task)) {
+        return true;
+    }
+    // If quota is critically low (<1%), recommend handoff
+    if (task.quotaInfo?.remainingPercentage !== undefined && task.quotaInfo.remainingPercentage < 1) {
+        return true;
+    }
+    // If failure context indicates unrecoverable rate limit, recommend handoff
+    if (task.failureContext?.statusCode === 429 && task.failureContext.recoverable === false) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Get recommended action for a rate-limited task.
+ */
+export function getRecommendedAction(task) {
+    if (task.status !== TaskStatus.RATE_LIMITED) {
+        return 'give_up';
+    }
+    if (hasExceededMaxRetries(task)) {
+        return shouldRecommendHandoff(task) ? 'handoff' : 'give_up';
+    }
+    if (shouldRetryNow(task)) {
+        return 'retry';
+    }
+    if (shouldRecommendHandoff(task)) {
+        return 'handoff';
+    }
+    return 'wait';
+}
+//# sourceMappingURL=retry-queue.js.map

package/build/services/retry-queue.js.map

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

package/build/services/sdk-client-manager.d.ts

@@ -0,0 +1,149 @@
+/**
+ * SDK Client Manager - Manages CopilotClient instances for the MCP server.
+ *
+ * Provides a singleton pattern for managing Copilot SDK clients per workspace,
+ * handling authentication, lifecycle, and multi-account PAT token rotation.
+ *
+ * Multi-Account Support:
+ * - Integrates with AccountManager for round-robin PAT token rotation
+ * - Automatically switches tokens on rate limit (429) or server errors (5xx)
+ * - Resets to first token on MCP reconnect
+ *
+ * User Input (ask_user) Support:
+ * - Registers onUserInputRequest handler for SDK questions
+ * - Forwards questions to QuestionRegistry for MCP client handling
+ */
+import { CopilotClient, type CopilotSession, type SessionConfig } from '@github/copilot-sdk';
+declare class SDKClientManager {
+    private clients;
+    private pendingClients;
+    private isShuttingDown;
+    private staleSessionTimer;
+    private sweepCycle;
+    /**
+     * Initialize the client manager (call on MCP connect).
+     * Initializes the account manager and resets to first token.
+     */
+    initialize(): void;
+    /**
+     * Reset the client manager (call on MCP reconnect).
+     * Clears all clients and resets account rotation to first token.
+     */
+    reset(): Promise<void>;
+    /**
+     * Get or create a CopilotClient for the given workspace.
+     * Uses the current token from account manager.
+     */
+    getClient(cwd: string): Promise<CopilotClient>;
+    /**
+     * Create a new CopilotClient with the specified configuration.
+     */
+    private createClient;
+    /**
+     * Create a session using the SDK client for the given workspace.
+     * Includes user input handler for SDK ask_user tool support.
+     */
+    createSession(cwd: string, sessionId: string, config: Omit<SessionConfig, 'sessionId'>, taskId?: string): Promise<CopilotSession>;
+    /**
+     * Resume an existing session.
+     * Includes user input handler for SDK ask_user tool support.
+     */
+    resumeSession(cwd: string, sessionId: string, config?: Partial<SessionConfig>, taskId?: string): Promise<CopilotSession>;
+    /**
+     * Get an active session by ID.
+     */
+    getSession(sessionId: string): CopilotSession | undefined;
+    /**
+     * Destroy a session and remove it from tracking.
+     */
+    destroySession(sessionId: string): Promise<boolean>;
+    /**
+     * Abort a running session.
+     */
+    abortSession(sessionId: string): Promise<boolean>;
+    /**
+     * Rotate to the next account on error.
+     * Returns the new client if rotation was successful.
+     *
+     * @param cwd - Workspace directory
+     * @param reason - Reason for rotation (e.g., 'rate_limit_429', 'server_error_500')
+     */
+    rotateOnError(cwd: string, reason: string): Promise<{
+        success: boolean;
+        client?: CopilotClient;
+        error?: string;
+        allExhausted?: boolean;
+    }>;
+    /**
+     * RC-7: Remove client entries with no active sessions that belong to non-current tokens.
+     * Prevents gradual resource leak from accumulated stale clients after rotation.
+     */
+    private cleanupStaleClients;
+    /**
+     * Start the periodic stale-session sweeper. Timer is unref()'d so it
+     * doesn't prevent the process from exiting.
+     */
+    private startStaleSessionSweeper;
+    /**
+     * Ping each client to detect dead/crashed CLI processes. Removes dead
+     * clients from the pool and force-stops them.
+     */
+    private checkClientHealth;
+    /**
+     * Sweep all tracked sessions. If the corresponding task (looked up by
+     * sessionId which equals taskId by convention) is terminal or missing,
+     * destroy the session with a timeout. Then recycle PTY leakers.
+     */
+    private sweepStaleSessions;
+    /**
+     * Detect server-side sessions that we're not tracking locally (orphaned from
+     * crashes). Uses listSessions() and deletes any not in our tracking map.
+     */
+    private detectOrphanedSessions;
+    /**
+     * For each client entry, check PTY FD count via lsof. If count exceeds
+     * threshold and no active sessions remain, recycle the client (stop it
+     * and remove from map so the next getClient() creates a fresh one).
+     */
+    private recyclePtyLeakers;
+    /**
+     * Check if rotation should happen based on error.
+     */
+    shouldRotateOnError(statusCode?: number, errorMessage?: string): boolean;
+    /**
+     * Check authentication status for current token.
+     */
+    checkAuthStatus(cwd: string): Promise<{
+        isAuthenticated: boolean;
+        login?: string;
+        tokenIndex: number;
+    }>;
+    /**
+     * List available models.
+     */
+    listModels(cwd: string): Promise<Array<{
+        id: string;
+        name: string;
+    }>>;
+    /**
+     * Shutdown all clients gracefully.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get statistics about active clients, sessions, and account rotation.
+     */
+    getStats(): {
+        pools: number;
+        clients: number;
+        sessions: number;
+        accounts: {
+            total: number;
+            current: number;
+            rotations: number;
+            available: number;
+        };
+    };
+}
+export declare const sdkClientManager: SDKClientManager;
+export {};
+//# sourceMappingURL=sdk-client-manager.d.ts.map

package/build/services/sdk-client-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-client-manager.d.ts","sourceRoot":"","sources":["../../src/services/sdk-client-manager.ts"],"names":[],"mappings":"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"}