super-subagents 1.0.1

package/build/tools/stream-output.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+import { taskManager } from '../services/task-manager.js';
+import { TaskStatus } from '../types.js';
+import { mcpText, formatError, displayStatus, formatDuration, join } from '../utils/format.js';
+import { TASK_STALL_WARN_MS } from '../config/timeouts.js';
+const StreamOutputSchema = z.object({
+    task_id: z.string().min(1),
+    offset: z.number().int().min(0).optional().default(0),
+    limit: z.number().int().min(1).max(500).optional().default(100),
+});
+export const streamOutputTool = {
+    name: 'stream_output',
+    description: `Get incremental output from a task. Use offset to get new lines since last call. This is the preferred way to monitor task output -- unlike get_status, this tool is not throttled and returns only the new output lines you haven't seen yet.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            task_id: {
+                type: 'string',
+                description: 'Task ID to stream output from.',
+            },
+            offset: {
+                type: 'number',
+                description: 'Line offset to start from. Default: 0. Use next_offset from response.',
+            },
+            limit: {
+                type: 'number',
+                description: 'Max lines to return. Default: 100. Max: 500.',
+            },
+        },
+        required: ['task_id'],
+    },
+};
+export async function handleStreamOutput(args) {
+    try {
+        const parsed = StreamOutputSchema.parse(args || {});
+        const taskId = parsed.task_id.toLowerCase().trim();
+        const task = taskManager.getTask(taskId);
+        if (!task) {
+            return mcpText(formatError('Task not found', 'Use `list_tasks` to find valid task IDs.'));
+        }
+        const totalLines = task.output.length;
+        const offset = Math.min(parsed.offset, totalLines);
+        const outputLines = task.output.slice(offset, offset + parsed.limit);
+        const nextOffset = offset + outputLines.length;
+        const hasMore = nextOffset < totalLines;
+        const now = Date.now();
+        const lastOutputAgeMs = task.lastOutputAt ? now - new Date(task.lastOutputAt).getTime() : undefined;
+        const isTerminal = [
+            TaskStatus.COMPLETED,
+            TaskStatus.FAILED,
+            TaskStatus.CANCELLED,
+            TaskStatus.TIMED_OUT,
+        ].includes(task.status);
+        // Build headline
+        const statusStr = displayStatus(task.status);
+        let rangeStr;
+        if (outputLines.length > 0) {
+            rangeStr = `lines ${offset}-${nextOffset - 1} of ${totalLines}`;
+        }
+        else {
+            rangeStr = `${totalLines} lines`;
+        }
+        const exitInfo = isTerminal && task.exitCode !== undefined ? `, exit code: ${task.exitCode}` : '';
+        const headline = `**${task.id}** -- ${statusStr} (${rangeStr}${exitInfo})`;
+        // Build body
+        let body;
+        if (outputLines.length > 0) {
+            body = outputLines.map(l => `> ${l}`).join('\n');
+        }
+        else {
+            body = 'No output yet.';
+        }
+        // Build footer
+        let footer;
+        if (hasMore) {
+            const remaining = totalLines - nextOffset;
+            footer = `${remaining} more lines available. Use offset \`${nextOffset}\` to continue.`;
+        }
+        else if (isTerminal) {
+            footer = 'All output retrieved.';
+        }
+        else if (lastOutputAgeMs !== undefined && lastOutputAgeMs >= TASK_STALL_WARN_MS) {
+            footer = `No output for ${formatDuration(lastOutputAgeMs)}. Task may be stalled.`;
+        }
+        else {
+            footer = 'Waiting for more output...';
+        }
+        // Add error if terminal and has error
+        const errorLine = task.error && isTerminal ? `**Error:** ${task.error}` : undefined;
+        return mcpText(join(headline, '', body, '', errorLine, footer));
+    }
+    catch (error) {
+        return mcpText(formatError(error instanceof Error ? error.message : 'Unknown error'));
+    }
+}
+//# sourceMappingURL=stream-output.js.map

package/build/tools/stream-output.js.map

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

package/build/types.d.ts

@@ -0,0 +1,75 @@
+import type { ResultPromise } from 'execa';
+export type Provider = 'copilot' | 'claude-cli';
+export declare enum TaskStatus {
+    PENDING = "pending",
+    WAITING = "waiting",
+    RUNNING = "running",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    CANCELLED = "cancelled",
+    RATE_LIMITED = "rate_limited",
+    TIMED_OUT = "timed_out"
+}
+export type TimeoutReason = 'hard_timeout' | 'stall' | 'process_dead' | 'server_restart' | 'unknown';
+export interface TimeoutContext {
+    timeoutMs?: number;
+    timeoutAt?: string;
+    elapsedMs?: number;
+    lastOutputAt?: string;
+    lastOutputAgeMs?: number;
+    lastHeartbeatAt?: string;
+    pidAlive?: boolean;
+    detectedBy?: 'execa' | 'health_check' | 'startup_recovery' | 'manual';
+}
+export interface RetryInfo {
+    reason: string;
+    retryCount: number;
+    nextRetryTime: string;
+    maxRetries: number;
+    originalTaskId?: string;
+}
+export interface TaskState {
+    id: string;
+    status: TaskStatus;
+    prompt: string;
+    output: string[];
+    pid?: number;
+    sessionId?: string;
+    startTime: string;
+    lastOutputAt?: string;
+    lastHeartbeatAt?: string;
+    endTime?: string;
+    exitCode?: number;
+    error?: string;
+    cwd?: string;
+    model?: string;
+    autonomous?: boolean;
+    isResume?: boolean;
+    process?: ResultPromise;
+    retryInfo?: RetryInfo;
+    dependsOn?: string[];
+    timeout?: number;
+    timeoutAt?: string;
+    timeoutReason?: TimeoutReason;
+    timeoutContext?: TimeoutContext;
+    labels?: string[];
+    provider?: Provider;
+    fallbackAttempted?: boolean;
+    switchAttempted?: boolean;
+    recoveryAttempted?: boolean;
+}
+export interface SpawnOptions {
+    prompt: string;
+    timeout?: number;
+    cwd?: string;
+    model?: string;
+    autonomous?: boolean;
+    resumeSessionId?: string;
+    retryInfo?: RetryInfo;
+    dependsOn?: string[];
+    labels?: string[];
+    provider?: Provider;
+    fallbackAttempted?: boolean;
+    switchAttempted?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

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

package/build/types.js

@@ -0,0 +1,12 @@
+export var TaskStatus;
+(function (TaskStatus) {
+    TaskStatus["PENDING"] = "pending";
+    TaskStatus["WAITING"] = "waiting";
+    TaskStatus["RUNNING"] = "running";
+    TaskStatus["COMPLETED"] = "completed";
+    TaskStatus["FAILED"] = "failed";
+    TaskStatus["CANCELLED"] = "cancelled";
+    TaskStatus["RATE_LIMITED"] = "rate_limited";
+    TaskStatus["TIMED_OUT"] = "timed_out";
+})(TaskStatus || (TaskStatus = {}));
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,UASX;AATD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,iCAAmB,CAAA;IACnB,iCAAmB,CAAA;IACnB,qCAAuB,CAAA;IACvB,+BAAiB,CAAA;IACjB,qCAAuB,CAAA;IACvB,2CAA6B,CAAA;IAC7B,qCAAuB,CAAA;AACzB,CAAC,EATW,UAAU,KAAV,UAAU,QASrB"}

package/build/utils/format.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared formatting helpers for converting MCP tool responses to markdown.
+ */
+/** Wraps a markdown string in the MCP response shape. */
+export declare function mcpText(markdown: string): {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+};
+/** Display status in human-readable form: "rate_limited" -> "rate limited" */
+export declare function displayStatus(status: string): string;
+/** Format labels as inline code: "`label-a`, `label-b`". Returns empty string if none. */
+export declare function formatLabels(labels?: string[]): string;
+/** "Labels: `a`, `b`" or empty string. */
+export declare function formatLabelsLine(labels?: string[]): string;
+/** Milliseconds to human duration: 541364 -> "~9m" */
+export declare function formatDuration(ms: number): string;
+/** Format output as a blockquote with optional truncation. Returns empty string for empty output. */
+export declare function formatOutputBlock(output: string, label?: string, maxLen?: number): string;
+/** Standard error block with optional actionable hint. */
+export declare function formatError(error: string, hint?: string): string;
+/** "Run `sleep 120` then check again." or empty string. */
+export declare function formatRetryHint(retryCommand?: string): string;
+/** Render a markdown table from headers and rows. */
+export declare function formatTable(headers: string[], rows: string[][]): string;
+/** Join non-empty strings with newlines, filtering out falsy/empty values. */
+export declare function join(...parts: (string | undefined | false | null)[]): string;
+//# sourceMappingURL=format.d.ts.map

package/build/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yDAAyD;AACzD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAE5F;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAGtD;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAG1D;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CASjD;AAED,qGAAqG;AACrG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAW,EAAE,MAAM,SAAO,GAAG,MAAM,CAYzF;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAG7D;AAOD,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAKvE;AAED,8EAA8E;AAC9E,wBAAgB,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC,EAAE,GAAG,MAAM,CAE5E"}

package/build/utils/format.js

@@ -0,0 +1,81 @@
+/**
+ * Shared formatting helpers for converting MCP tool responses to markdown.
+ */
+/** Wraps a markdown string in the MCP response shape. */
+export function mcpText(markdown) {
+    return { content: [{ type: 'text', text: markdown }] };
+}
+/** Display status in human-readable form: "rate_limited" -> "rate limited" */
+export function displayStatus(status) {
+    return status.replace(/_/g, ' ');
+}
+/** Format labels as inline code: "`label-a`, `label-b`". Returns empty string if none. */
+export function formatLabels(labels) {
+    if (!labels || labels.length === 0)
+        return '';
+    return labels.map(l => `\`${l}\``).join(', ');
+}
+/** "Labels: `a`, `b`" or empty string. */
+export function formatLabelsLine(labels) {
+    const f = formatLabels(labels);
+    return f ? `Labels: ${f}` : '';
+}
+/** Milliseconds to human duration: 541364 -> "~9m" */
+export function formatDuration(ms) {
+    if (ms <= 0)
+        return '0s';
+    const totalSec = Math.round(ms / 1000);
+    if (totalSec < 60)
+        return `~${totalSec}s`;
+    const min = Math.round(totalSec / 60);
+    if (min < 60)
+        return `~${min}m`;
+    const h = Math.floor(min / 60);
+    const rm = min % 60;
+    return rm === 0 ? `~${h}h` : `~${h}h ${rm}m`;
+}
+/** Format output as a blockquote with optional truncation. Returns empty string for empty output. */
+export function formatOutputBlock(output, label = 'Output', maxLen = 2000) {
+    if (!output || !output.trim())
+        return '';
+    let text = output;
+    let truncated = false;
+    if (text.length > maxLen) {
+        text = text.slice(-maxLen);
+        truncated = true;
+    }
+    const quoted = text.split('\n').map(line => `> ${line}`).join('\n');
+    const parts = [`**${label}:**`, quoted];
+    if (truncated)
+        parts.push('*(truncated -- use `stream_output` for full output)*');
+    return parts.join('\n');
+}
+/** Standard error block with optional actionable hint. */
+export function formatError(error, hint) {
+    const parts = [`**Error:** ${error}`];
+    if (hint)
+        parts.push('', hint);
+    return parts.join('\n');
+}
+/** "Run `sleep 120` then check again." or empty string. */
+export function formatRetryHint(retryCommand) {
+    if (!retryCommand)
+        return '';
+    return `Run \`${retryCommand}\` then check again.`;
+}
+/** Escape pipe characters in table cell content. */
+function escapeCell(value) {
+    return value.replace(/\|/g, '\\|');
+}
+/** Render a markdown table from headers and rows. */
+export function formatTable(headers, rows) {
+    const headerRow = `| ${headers.map(escapeCell).join(' | ')} |`;
+    const separator = `|${headers.map(() => '------').join('|')}|`;
+    const dataRows = rows.map(r => `| ${r.map(escapeCell).join(' | ')} |`);
+    return [headerRow, separator, ...dataRows].join('\n');
+}
+/** Join non-empty strings with newlines, filtering out falsy/empty values. */
+export function join(...parts) {
+    return parts.filter(p => typeof p === 'string' && p.length > 0).join('\n');
+}
+//# sourceMappingURL=format.js.map

package/build/utils/format.js.map

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

package/build/utils/sanitize.d.ts

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+export declare const SpawnTaskSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodEnum<[string, ...string[]]>>;
+    task_type: z.ZodOptional<z.ZodEnum<[string, ...string[]]>>;
+    autonomous: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    depends_on: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    timeout: number;
+    autonomous: boolean;
+    cwd?: string | undefined;
+    model?: string | undefined;
+    task_type?: string | undefined;
+    depends_on?: string[] | undefined;
+    labels?: string[] | undefined;
+}, {
+    prompt: string;
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+    model?: string | undefined;
+    task_type?: string | undefined;
+    autonomous?: boolean | undefined;
+    depends_on?: string[] | undefined;
+    labels?: string[] | undefined;
+}>;
+export declare const ResumeTaskSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    autonomous: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    timeout: number;
+    autonomous: boolean;
+    sessionId: string;
+    cwd?: string | undefined;
+}, {
+    sessionId: string;
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+    autonomous?: boolean | undefined;
+}>;
+export declare const GetTaskStatusSchema: z.ZodObject<{
+    taskId: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+}, "strip", z.ZodTypeAny, {
+    taskId: string | string[];
+}, {
+    taskId: string | string[];
+}>;
+export declare const ListTasksSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<["pending", "waiting", "running", "completed", "failed", "cancelled", "rate_limited", "timed_out"]>>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status?: "pending" | "waiting" | "running" | "completed" | "failed" | "cancelled" | "rate_limited" | "timed_out" | undefined;
+    label?: string | undefined;
+}, {
+    status?: "pending" | "waiting" | "running" | "completed" | "failed" | "cancelled" | "rate_limited" | "timed_out" | undefined;
+    label?: string | undefined;
+}>;
+//# sourceMappingURL=sanitize.d.ts.map

package/build/utils/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS1B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;EAG1B,CAAC"}

package/build/utils/sanitize.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { MODEL_IDS } from '../models.js';
+import { TASK_TYPE_IDS } from '../templates/index.js';
+import { TASK_TIMEOUT_DEFAULT_MS, TASK_TIMEOUT_MAX_MS, TASK_TIMEOUT_MIN_MS, } from '../config/timeouts.js';
+export const SpawnTaskSchema = z.object({
+    prompt: z.string().min(1).max(50000),
+    timeout: z.number().int().min(TASK_TIMEOUT_MIN_MS).max(TASK_TIMEOUT_MAX_MS).optional().default(TASK_TIMEOUT_DEFAULT_MS), // 10 minutes default
+    cwd: z.string().optional(),
+    model: z.enum(MODEL_IDS).optional(),
+    task_type: z.enum(TASK_TYPE_IDS).optional(),
+    autonomous: z.boolean().optional().default(true),
+    depends_on: z.array(z.string().min(1)).optional(),
+    labels: z.array(z.string().min(1).max(50)).max(10).optional(),
+});
+export const ResumeTaskSchema = z.object({
+    sessionId: z.string().min(1),
+    timeout: z.number().int().min(TASK_TIMEOUT_MIN_MS).max(TASK_TIMEOUT_MAX_MS).optional().default(TASK_TIMEOUT_DEFAULT_MS), // 10 minutes default
+    cwd: z.string().optional(),
+    autonomous: z.boolean().optional().default(true),
+});
+export const GetTaskStatusSchema = z.object({
+    taskId: z.union([z.string().min(1), z.array(z.string().min(1))]),
+});
+export const ListTasksSchema = z.object({
+    status: z.enum(['pending', 'waiting', 'running', 'completed', 'failed', 'cancelled', 'rate_limited', 'timed_out']).optional(),
+    label: z.string().min(1).optional(),
+});
+//# sourceMappingURL=sanitize.js.map

package/build/utils/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,qBAAqB;IAC9I,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,SAAkC,CAAC,CAAC,QAAQ,EAAE;IAC5D,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,aAAsC,CAAC,CAAC,QAAQ,EAAE;IACpE,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAChD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACjD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC9D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,qBAAqB;IAC9I,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACjD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACjE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7H,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC"}

package/build/utils/task-id-generator.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generates human-readable task IDs like "brave-tiger-42" or "cosmic-falcon-17"
+ * Much easier to remember and communicate than UUIDs or random strings
+ */
+export declare function generateTaskId(): string;
+/**
+ * Normalizes task ID for case-insensitive lookups
+ */
+export declare function normalizeTaskId(taskId: string): string;
+//# sourceMappingURL=task-id-generator.d.ts.map

package/build/utils/task-id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-id-generator.d.ts","sourceRoot":"","sources":["../../src/utils/task-id-generator.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAWvC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/build/utils/task-id-generator.js

@@ -0,0 +1,22 @@
+import { uniqueNamesGenerator, adjectives, animals } from 'unique-names-generator';
+/**
+ * Generates human-readable task IDs like "brave-tiger-42" or "cosmic-falcon-17"
+ * Much easier to remember and communicate than UUIDs or random strings
+ */
+export function generateTaskId() {
+    const randomNumber = Math.floor(Math.random() * 100);
+    const name = uniqueNamesGenerator({
+        dictionaries: [adjectives, animals],
+        separator: '-',
+        length: 2,
+        style: 'lowerCase',
+    });
+    return `${name}-${randomNumber}`;
+}
+/**
+ * Normalizes task ID for case-insensitive lookups
+ */
+export function normalizeTaskId(taskId) {
+    return taskId.toLowerCase().trim();
+}
+//# sourceMappingURL=task-id-generator.js.map

package/build/utils/task-id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-id-generator.js","sourceRoot":"","sources":["../../src/utils/task-id-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAU,OAAO,EAAS,MAAM,wBAAwB,CAAC;AAElG;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IAErD,MAAM,IAAI,GAAG,oBAAoB,CAAC;QAChC,YAAY,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;QACnC,SAAS,EAAE,GAAG;QACd,MAAM,EAAE,CAAC;QACT,KAAK,EAAE,WAAW;KACnB,CAAC,CAAC;IAEH,OAAO,GAAG,IAAI,IAAI,YAAY,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;AACrC,CAAC"}

package/docs/timeout-durability.md

@@ -0,0 +1,28 @@
+# Timeout Durability Notes
+
+## What changed
+- Task state now records last output and heartbeat timestamps.
+- Timeout events record a reason and context for diagnosis.
+- `get_status` and `stream_output` provide stall-aware guidance.
+- `recover_task` can resume timed_out tasks when a session is available.
+
+## Timeout reasons
+- hard_timeout: Task exceeded configured timeout.
+- stall: No output for a long interval before timeout.
+- process_dead: Process died unexpectedly.
+- server_restart: Server restarted while task was running.
+
+## Recovery workflow
+1. Run `get_status` to see timeout reason and session availability.
+2. If session_id is present, use `recover_task` or `resume_task`.
+3. If no session_id, re-run with `spawn_task` (optionally with a higher timeout).
+4. If the process is still alive after timeout, `recover_task` will attempt cleanup.
+
+## Manual verification checklist
+- Spawn a task with a very small timeout and confirm status becomes timed_out.
+- Verify `get_status` shows timeout reason and suggested action.
+- Confirm `stream_output` shows stall warning if no output for a while.
+- If a session_id is present, call `recover_task` and verify a new task starts.
+
+## Notes
+- Timed out tasks are removed after the task TTL window; recover before expiration.

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "super-subagents",
+  "version": "1.0.1",
+  "description": "MCP server for spawning and managing GitHub Copilot CLI tasks",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "copilot-mcp-server": "build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node build/index.js",
+    "clean": "rm -rf build"
+  },
+  "keywords": [
+    "mcp",
+    "copilot",
+    "github",
+    "cli",
+    "agent"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "execa": "^9.5.2",
+    "nanoid": "^5.0.9",
+    "unique-names-generator": "^4.7.1",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/plans/timeout-durability/00-overview.md

@@ -0,0 +1,38 @@
+# Plan: Timeout Durability
+
+**Date:** 2026-02-01
+**Goal:** Identify timeout root causes in the MCP task system and design durable handling with clear diagnostics, recovery, and user guidance.
+**Complexity:** medium
+
+## Scope
+**In:** Task lifecycle, timeout config/enforcement, process health checks, persistence schema, get_status messaging, recovery/resume flows, diagnostic logging.
+**Out:** Changes to Copilot CLI itself, external service behavior, UI/UX outside MCP tool responses.
+
+## Phases
+### Phase 1: Evidence and Root Causes (Steps 1-2)
+- Step 1: Document current timeout flow and gaps
+- Step 2: Distinguish root cause categories and signals
+**Goal:** Evidence-backed root cause map | **Estimate:** 1-2 hours
+
+### Phase 2: State and Diagnostics Design (Steps 3-4)
+- Step 3: Define state fields for heartbeat/output/timeout reason
+- Step 4: Design diagnostics and recovery actions per cause
+**Goal:** Durable architecture for timeouts | **Estimate:** 2-3 hours
+
+### Phase 3: Messaging and Recovery UX (Steps 5-6)
+- Step 5: Improve get_status and stream_output guidance
+- Step 6: Resume/retry/cleanup guidance for timed_out cases
+**Goal:** Actionable feedback for operators | **Estimate:** 1-2 hours
+
+## Approach
+Ground the design in existing task lifecycle code, add minimal state fields needed for diagnosis, and surface recovery paths (resume_task, retry_task) when available. Prioritize persistence correctness before feature expansion.
+
+## Risks
+1. **Misclassification of timeouts** — Mitigation: add explicit timeout_reason and last_activity timestamps.
+2. **State incompatibility** — Mitigation: backward-compatible persistence and schema defaults.
+3. **Noisy logs** — Mitigation: throttle diagnostic logging and focus on actionable data.
+
+## Success Metrics
+- Timed_out tasks show a specific reason and a next step.
+- Operators can resume or retry without manual log digging.
+- No loss of task state across server restarts.

package/plans/timeout-durability/01-analysis.md

@@ -0,0 +1,37 @@
+# Analysis
+
+## Current State (Evidence)
+- Tasks are created in memory with generated IDs and persisted to JSON under the user home directory per workspace.
+- Timeout defaults to 600000 ms for spawn and resume; execa enforces the timeout and sets status to timed_out.
+- Health checks only verify process liveness; no heartbeat or last-activity timestamps exist.
+- get_status provides timeout remaining for running tasks but no timed_out-specific guidance.
+- Session IDs can be captured from output and used by resume_task, but timed_out does not surface that hint.
+- Server restarts mark running or pending tasks as failed with a generic interruption error.
+
+## Root Cause Categories and Signals
+1. **Hard timeout exceeded**
+   - Signal: TaskStatus timed_out with error text “timed out after X ms”.
+   - Distinguish from: server restart and dead process via error text and endTime source.
+2. **Process died (zombie or crash)**
+   - Signal: health check or get_status liveness check marks task failed with “process exited unexpectedly”.
+3. **Stall or no-output hang**
+   - Signal: process still alive, but output and activity do not change for a long period.
+   - Currently indistinguishable due to missing last-activity tracking.
+4. **Server restart interruption**
+   - Signal: load-time recovery marks running or pending tasks as failed with “server restarted” error.
+5. **Rate-limit backoff**
+   - Signal: rate_limited status with retryInfo; already handled by retry queue.
+
+## Options
+- **Option A: Increase timeout only**
+  - Pros: minimal change.
+  - Cons: hides root causes, doesn’t improve reliability.
+- **Option B: Add diagnostics + recovery guidance (preferred)**
+  - Pros: actionable feedback, durable state, clearer recovery paths.
+  - Cons: requires schema and message updates.
+- **Option C: Separate watchdog service**
+  - Pros: robust.
+  - Cons: more complexity than needed.
+
+## Decision
+Proceed with Option B: extend task state for activity and timeout reasons, improve messaging, and add recovery actions aligned with existing tools.

package/plans/timeout-durability/decisions.md

@@ -0,0 +1,22 @@
+# Key Decisions
+
+## Decision 1: Add activity timestamps to TaskState
+**Context:** Need to distinguish stall vs slow but healthy.
+**Options:** A=No change, B=Track lastOutputAt and lastHeartbeatAt, C=External watchdog.
+**Chosen:** B
+**Rationale:** Minimal change with strong diagnostic value.
+**Tradeoffs:** Requires updating persistence and runtime updates.
+
+## Decision 2: Introduce timeout_reason taxonomy
+**Context:** timed_out status is too generic for recovery guidance.
+**Options:** A=Free-form error string only, B=Structured reason enum, C=Separate status values.
+**Chosen:** B
+**Rationale:** Keeps status stable while enabling precise messaging.
+**Tradeoffs:** Requires mapping logic and migration defaults.
+
+## Decision 3: Surface resume guidance for timed_out
+**Context:** Session IDs are captured but not shown for timed_out tasks.
+**Options:** A=No change, B=Show resume_task hint whenever sessionId exists, C=Auto-resume.
+**Chosen:** B
+**Rationale:** Actionable guidance without automatic behavior changes.
+**Tradeoffs:** Must ensure hints are accurate and not misleading.