mcp-subagents-opencode 1.0.0

package/build/services/progress-registry.js

@@ -0,0 +1,97 @@
+const THROTTLE_MS = 100;
+class ProgressRegistry {
+    bindings = new Map();
+    register(taskId, progressToken, sendNotification) {
+        // Clean up any existing binding
+        this.unregister(taskId);
+        this.bindings.set(taskId.toLowerCase(), {
+            progressToken,
+            sendNotification,
+            progressCount: 0,
+            lastSendTime: 0,
+            pendingMessage: null,
+            pendingTotal: undefined,
+            flushTimer: null,
+        });
+    }
+    unregister(taskId) {
+        const key = taskId.toLowerCase();
+        const binding = this.bindings.get(key);
+        if (binding) {
+            if (binding.flushTimer) {
+                clearTimeout(binding.flushTimer);
+            }
+            // Flush any pending message before unregistering
+            if (binding.pendingMessage) {
+                this.doSend(binding, binding.pendingMessage);
+            }
+            this.bindings.delete(key);
+        }
+    }
+    has(taskId) {
+        return this.bindings.has(taskId.toLowerCase());
+    }
+    sendProgress(taskId, message, total) {
+        const binding = this.bindings.get(taskId.toLowerCase());
+        if (!binding)
+            return;
+        const now = Date.now();
+        const elapsed = now - binding.lastSendTime;
+        // Always update pendingTotal to the most recent value
+        if (total !== undefined) {
+            binding.pendingTotal = total;
+        }
+        if (elapsed >= THROTTLE_MS) {
+            // Send immediately
+            if (binding.flushTimer) {
+                clearTimeout(binding.flushTimer);
+                binding.flushTimer = null;
+            }
+            // If there was a pending message, prepend it
+            const fullMessage = binding.pendingMessage
+                ? `${binding.pendingMessage}\n${message}`
+                : message;
+            binding.pendingMessage = null;
+            const sendTotal = binding.pendingTotal;
+            binding.pendingTotal = undefined;
+            this.doSend(binding, fullMessage, sendTotal);
+        }
+        else {
+            // Buffer the message
+            binding.pendingMessage = binding.pendingMessage
+                ? `${binding.pendingMessage}\n${message}`
+                : message;
+            // Schedule flush if not already scheduled
+            if (!binding.flushTimer) {
+                binding.flushTimer = setTimeout(() => {
+                    binding.flushTimer = null;
+                    if (binding.pendingMessage) {
+                        const msg = binding.pendingMessage;
+                        binding.pendingMessage = null;
+                        const sendTotal = binding.pendingTotal;
+                        binding.pendingTotal = undefined;
+                        this.doSend(binding, msg, sendTotal);
+                    }
+                }, THROTTLE_MS);
+            }
+        }
+    }
+    doSend(binding, message, total) {
+        binding.progressCount++;
+        binding.lastSendTime = Date.now();
+        const notification = {
+            method: 'notifications/progress',
+            params: {
+                progressToken: binding.progressToken,
+                progress: binding.progressCount,
+                ...(total !== undefined ? { total } : {}),
+                message,
+            },
+        };
+        binding.sendNotification(notification).catch((err) => {
+            console.error(`[progress-registry] Failed to send progress for token ${binding.progressToken}:`, err);
+        });
+    }
+}
+export const progressRegistry = new ProgressRegistry();
+//# sourceMappingURL=progress-registry.js.map

package/build/services/progress-registry.js.map

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

package/build/services/question-registry.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Question Registry - Manages pending questions from the agent's ask_user tool.
+ *
+ * When the agent asks a question via ask_user, this registry:
+ * - Stores the question with Promise callbacks for resolution
+ * - Updates TaskState with pending question
+ * - Provides answer submission with validation
+ * - Handles timeouts (30 min default)
+ * - Sends MCP notifications when questions arrive
+ */
+import type { PendingQuestion } from '../types.js';
+/** User input response shape. */
+interface UserInputResponse {
+    answer: string;
+    wasFreeform: boolean;
+}
+type QuestionNotificationCallback = (taskId: string, question: PendingQuestion) => void;
+declare class QuestionRegistry {
+    private bindings;
+    private notificationCallback?;
+    /**
+     * Set callback for MCP notifications when questions arrive.
+     */
+    onQuestionAsked(callback: QuestionNotificationCallback): void;
+    /**
+     * Register a pending question and return a Promise that resolves when answered.
+     * This is called when a session asks for user input.
+     */
+    register(taskId: string, sessionId: string, question: string, choices?: string[], allowFreeform?: boolean): Promise<UserInputResponse>;
+    /**
+     * Submit an answer for a pending question.
+     * Validates the answer format and resolves the Promise.
+     */
+    submitAnswer(taskId: string, answer: string): {
+        success: boolean;
+        error?: string;
+        resolvedAnswer?: string;
+        wasFreeform?: boolean;
+    };
+    /**
+     * Parse and validate an answer.
+     * Supports: "1", "2", "3" (choice index), "CUSTOM: text", or direct text.
+     */
+    private parseAnswer;
+    /**
+     * Handle question timeout.
+     */
+    private handleTimeout;
+    /**
+     * Clear a pending question for a task.
+     */
+    clearQuestion(taskId: string, reason?: string): void;
+    /**
+     * Get the pending question for a task.
+     */
+    getQuestion(taskId: string): PendingQuestion | undefined;
+    /**
+     * Check if a task has a pending question.
+     */
+    hasPendingQuestion(taskId: string): boolean;
+    /**
+     * Get all tasks with pending questions.
+     */
+    getAllPendingQuestions(): Map<string, PendingQuestion>;
+    /**
+     * Clean up all pending questions (e.g., on server shutdown).
+     */
+    cleanup(): void;
+    /**
+     * Get statistics.
+     */
+    getStats(): {
+        pendingCount: number;
+        oldestQuestionAge?: number;
+    };
+}
+export declare const questionRegistry: QuestionRegistry;
+export {};
+//# sourceMappingURL=question-registry.d.ts.map

package/build/services/question-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-registry.d.ts","sourceRoot":"","sources":["../../src/services/question-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,iCAAiC;AACjC,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;CACtB;AAiBD,KAAK,4BAA4B,GAAG,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,KACtB,IAAI,CAAC;AAEV,cAAM,gBAAgB;IACpB,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,oBAAoB,CAAC,CAA+B;IAE5D;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,4BAA4B,GAAG,IAAI;IAI7D;;;OAGG;IACH,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,aAAa,GAAE,OAAc,GAC5B,OAAO,CAAC,iBAAiB,CAAC;IA0D7B;;;OAGG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE;IAwCvF;;;OAGG;IACH,OAAO,CAAC,WAAW;IAyDnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAkB,GAAG,IAAI;IAgB/D;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAaxD;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI3C;;OAEG;IACH,sBAAsB,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAgBtD;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;IACH,QAAQ,IAAI;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE;CAgBjE;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/build/services/question-registry.js

@@ -0,0 +1,249 @@
+/**
+ * Question Registry - Manages pending questions from the agent's ask_user tool.
+ *
+ * When the agent asks a question via ask_user, this registry:
+ * - Stores the question with Promise callbacks for resolution
+ * - Updates TaskState with pending question
+ * - Provides answer submission with validation
+ * - Handles timeouts (30 min default)
+ * - Sends MCP notifications when questions arrive
+ */
+import { taskManager } from './task-manager.js';
+const QUESTION_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
+class QuestionRegistry {
+    bindings = new Map();
+    notificationCallback;
+    /**
+     * Set callback for MCP notifications when questions arrive.
+     */
+    onQuestionAsked(callback) {
+        this.notificationCallback = callback;
+    }
+    /**
+     * Register a pending question and return a Promise that resolves when answered.
+     * This is called when a session asks for user input.
+     */
+    register(taskId, sessionId, question, choices, allowFreeform = true) {
+        // Clean up any existing question for this task
+        this.clearQuestion(taskId, 'new question asked');
+        return new Promise((resolve, reject) => {
+            const askedAt = new Date();
+            // Set timeout for question
+            const timeoutId = setTimeout(() => {
+                this.handleTimeout(taskId);
+            }, QUESTION_TIMEOUT_MS);
+            const binding = {
+                taskId,
+                sessionId,
+                question,
+                choices,
+                allowFreeform,
+                askedAt,
+                timeoutId,
+                resolve,
+                reject,
+            };
+            this.bindings.set(taskId.toLowerCase(), binding);
+            // Update task state with pending question
+            const pendingQuestion = {
+                question,
+                choices,
+                allowFreeform,
+                askedAt: askedAt.toISOString(),
+                sessionId,
+            };
+            taskManager.updateTask(taskId, { pendingQuestion });
+            taskManager.appendOutput(taskId, `\n[question] Agent is asking: ${question}`);
+            if (choices && choices.length > 0) {
+                const choiceList = choices.map((c, i) => `  ${i + 1}. ${c}`).join('\n');
+                taskManager.appendOutput(taskId, `[question] Options:\n${choiceList}`);
+            }
+            if (allowFreeform) {
+                taskManager.appendOutput(taskId, `[question] Custom answers are allowed.`);
+            }
+            taskManager.appendOutput(taskId, `[question] Task paused. Use answer_question tool to respond.`);
+            console.error(`[question-registry] Question registered for task ${taskId}: "${question}"`);
+            // Send MCP notification
+            if (this.notificationCallback) {
+                this.notificationCallback(taskId, pendingQuestion);
+            }
+        });
+    }
+    /**
+     * Submit an answer for a pending question.
+     * Validates the answer format and resolves the Promise.
+     */
+    submitAnswer(taskId, answer) {
+        const normalizedId = taskId.toLowerCase();
+        const binding = this.bindings.get(normalizedId);
+        if (!binding) {
+            return { success: false, error: 'No pending question for this task' };
+        }
+        // Parse and validate the answer
+        const parseResult = this.parseAnswer(answer, binding.choices, binding.allowFreeform);
+        if (!parseResult.valid) {
+            return { success: false, error: parseResult.error };
+        }
+        // Clear timeout
+        clearTimeout(binding.timeoutId);
+        // Resolve the Promise
+        binding.resolve({
+            answer: parseResult.answer,
+            wasFreeform: parseResult.wasFreeform,
+        });
+        // Clear the pending question from task state
+        taskManager.updateTask(taskId, { pendingQuestion: undefined });
+        taskManager.appendOutput(taskId, `[question] Answer submitted: ${parseResult.answer}`);
+        // Remove from registry
+        this.bindings.delete(normalizedId);
+        console.error(`[question-registry] Answer submitted for task ${taskId}: "${parseResult.answer}" (freeform: ${parseResult.wasFreeform})`);
+        return {
+            success: true,
+            resolvedAnswer: parseResult.answer,
+            wasFreeform: parseResult.wasFreeform,
+        };
+    }
+    /**
+     * Parse and validate an answer.
+     * Supports: "1", "2", "3" (choice index), "CUSTOM: text", or direct text.
+     */
+    parseAnswer(answer, choices, allowFreeform = true) {
+        const trimmedAnswer = answer.trim();
+        // Check for CUSTOM: prefix
+        if (trimmedAnswer.toUpperCase().startsWith('CUSTOM:')) {
+            if (!allowFreeform) {
+                return { valid: false, error: 'Custom answers not allowed. Please select from the choices.' };
+            }
+            const customText = trimmedAnswer.slice(7).trim();
+            if (!customText) {
+                return { valid: false, error: 'Custom answer cannot be empty.' };
+            }
+            return { valid: true, answer: customText, wasFreeform: true };
+        }
+        // Check for numeric choice (1-indexed)
+        if (choices && choices.length > 0 && /^\d+$/.test(trimmedAnswer)) {
+            const index = parseInt(trimmedAnswer, 10) - 1; // Convert to 0-indexed
+            if (index >= 0 && index < choices.length) {
+                return { valid: true, answer: choices[index], wasFreeform: false };
+            }
+            return { valid: false, error: `Invalid choice. Please enter 1-${choices.length}.` };
+        }
+        // Check if answer matches a choice exactly
+        if (choices && choices.length > 0) {
+            const matchIndex = choices.findIndex(c => c.toLowerCase() === trimmedAnswer.toLowerCase());
+            if (matchIndex >= 0) {
+                return { valid: true, answer: choices[matchIndex], wasFreeform: false };
+            }
+        }
+        // Freeform answer
+        if (allowFreeform) {
+            if (!trimmedAnswer) {
+                return { valid: false, error: 'Answer cannot be empty.' };
+            }
+            return { valid: true, answer: trimmedAnswer, wasFreeform: true };
+        }
+        // Not allowed
+        if (choices && choices.length > 0) {
+            return {
+                valid: false,
+                error: `Invalid answer. Please select a choice (1-${choices.length}) or use "CUSTOM: your answer" if freeform is enabled.`,
+            };
+        }
+        return { valid: false, error: 'Cannot submit answer.' };
+    }
+    /**
+     * Handle question timeout.
+     */
+    handleTimeout(taskId) {
+        const normalizedId = taskId.toLowerCase();
+        const binding = this.bindings.get(normalizedId);
+        if (binding) {
+            binding.reject(new Error('Question timed out after 30 minutes'));
+            taskManager.updateTask(taskId, { pendingQuestion: undefined });
+            taskManager.appendOutput(taskId, `[question] Question timed out after 30 minutes. Task may fail.`);
+            this.bindings.delete(normalizedId);
+            console.error(`[question-registry] Question timed out for task ${taskId}`);
+        }
+    }
+    /**
+     * Clear a pending question for a task.
+     */
+    clearQuestion(taskId, reason = 'cleared') {
+        const normalizedId = taskId.toLowerCase();
+        const binding = this.bindings.get(normalizedId);
+        if (binding) {
+            clearTimeout(binding.timeoutId);
+            binding.reject(new Error(`Question cleared: ${reason}`));
+            taskManager.updateTask(taskId, { pendingQuestion: undefined });
+            this.bindings.delete(normalizedId);
+            console.error(`[question-registry] Question cleared for task ${taskId}: ${reason}`);
+        }
+    }
+    /**
+     * Get the pending question for a task.
+     */
+    getQuestion(taskId) {
+        const binding = this.bindings.get(taskId.toLowerCase());
+        if (!binding)
+            return undefined;
+        return {
+            question: binding.question,
+            choices: binding.choices,
+            allowFreeform: binding.allowFreeform,
+            askedAt: binding.askedAt.toISOString(),
+            sessionId: binding.sessionId,
+        };
+    }
+    /**
+     * Check if a task has a pending question.
+     */
+    hasPendingQuestion(taskId) {
+        return this.bindings.has(taskId.toLowerCase());
+    }
+    /**
+     * Get all tasks with pending questions.
+     */
+    getAllPendingQuestions() {
+        const result = new Map();
+        for (const [taskId, binding] of this.bindings) {
+            result.set(taskId, {
+                question: binding.question,
+                choices: binding.choices,
+                allowFreeform: binding.allowFreeform,
+                askedAt: binding.askedAt.toISOString(),
+                sessionId: binding.sessionId,
+            });
+        }
+        return result;
+    }
+    /**
+     * Clean up all pending questions (e.g., on server shutdown).
+     */
+    cleanup() {
+        for (const [taskId, binding] of this.bindings) {
+            clearTimeout(binding.timeoutId);
+            binding.reject(new Error('Server shutdown'));
+        }
+        this.bindings.clear();
+        console.error(`[question-registry] Cleaned up all pending questions`);
+    }
+    /**
+     * Get statistics.
+     */
+    getStats() {
+        const now = Date.now();
+        let oldestAge;
+        for (const binding of this.bindings.values()) {
+            const age = now - binding.askedAt.getTime();
+            if (oldestAge === undefined || age > oldestAge) {
+                oldestAge = age;
+            }
+        }
+        return {
+            pendingCount: this.bindings.size,
+            oldestQuestionAge: oldestAge,
+        };
+    }
+}
+export const questionRegistry = new QuestionRegistry();
+//# sourceMappingURL=question-registry.js.map

package/build/services/question-registry.js.map

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

package/build/services/retry-queue.d.ts

@@ -0,0 +1,41 @@
+import { TaskState, RetryInfo } from '../types.js';
+/**
+ * Check if an error/output indicates rate limiting.
+ * Prefers structured failureContext over string parsing when available.
+ */
+export declare function isRateLimitError(output: string[], error?: string, task?: TaskState): boolean;
+/**
+ * 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 declare function extractWaitTime(output: string[], error?: string, task?: TaskState): number | null;
+/**
+ * Calculate next retry time based on retry count and task data.
+ * Uses quotaInfo.resetDate when available for precise timing.
+ */
+export declare function calculateNextRetryTime(retryCount: number, suggestedWaitMs?: number | null, task?: TaskState): string;
+/**
+ * Create retry info for a rate-limited task.
+ * Uses structured task data for better timing when available.
+ */
+export declare function createRetryInfo(task: TaskState, reason: string, existingRetryInfo?: RetryInfo): RetryInfo;
+/**
+ * Check if a task should be retried now.
+ * Considers quota info when deciding whether to retry.
+ */
+export declare function shouldRetryNow(task: TaskState): boolean;
+/**
+ * Check if a task has exceeded max retries.
+ */
+export declare function hasExceededMaxRetries(task: TaskState): boolean;
+/**
+ * Check if handoff is recommended instead of retry.
+ * Uses task data to make intelligent recommendations.
+ */
+export declare function shouldRecommendHandoff(task: TaskState): boolean;
+/**
+ * Get recommended action for a rate-limited task.
+ */
+export declare function getRecommendedAction(task: TaskState): 'retry' | 'handoff' | 'wait' | 'give_up';
+//# sourceMappingURL=retry-queue.d.ts.map

package/build/services/retry-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-queue.d.ts","sourceRoot":"","sources":["../../src/services/retry-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAc,SAAS,EAAE,MAAM,aAAa,CAAC;AAsB/D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,CAc5F;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CA8BjG;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,EAC/B,IAAI,CAAC,EAAE,SAAS,GACf,MAAM,CAyBR;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EACd,iBAAiB,CAAC,EAAE,SAAS,GAC5B,SAAS,CAwBX;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAuBvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAK9D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAiB/D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAkB9F"}