mcp-copilot-cli 1.0.0

package/dist/src/services/copilot-runtime.d.ts

@@ -0,0 +1,28 @@
+import { type CopilotClientOptions } from '@github/copilot-sdk';
+import type { TaskRecord } from '../types/task.js';
+import type { CopilotProfile } from './profile-manager.js';
+import type { ProfileManager } from './profile-manager.js';
+import type { QuestionRegistry } from './question-registry.js';
+import type { TaskManager } from './task-manager.js';
+export interface BuildCopilotClientOptionsInput {
+    cwd: string;
+    profile: CopilotProfile;
+    cliPath?: string | undefined;
+}
+export declare function buildCopilotClientOptions(input: BuildCopilotClientOptionsInput): CopilotClientOptions;
+export declare class CopilotRuntime {
+    private readonly clients;
+    private readonly taskManager;
+    private readonly profileManager;
+    private readonly questionRegistry;
+    constructor(input: {
+        taskManager: TaskManager;
+        profileManager: ProfileManager;
+        questionRegistry: QuestionRegistry;
+    });
+    runTask(task: TaskRecord): Promise<void>;
+    shutdown(): Promise<void>;
+    private bindSessionEvents;
+    private getClient;
+    private resolveProfile;
+}

package/dist/src/services/copilot-runtime.js

@@ -0,0 +1,194 @@
+import { accessSync, constants } from 'node:fs';
+import { delimiter, join } from 'node:path';
+import { CopilotClient, approveAll, } from '@github/copilot-sdk';
+import { DEFAULT_TIMEOUT_MS } from '../config/defaults.js';
+import { buildAgentPrompt } from '../templates/agent-prompt.js';
+import { TaskStatus } from '../types/task.js';
+function canExecute(path) {
+    try {
+        accessSync(path, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function resolveCopilotCliPath(explicitPath) {
+    if (explicitPath && canExecute(explicitPath)) {
+        return explicitPath;
+    }
+    const configuredPath = process.env.COPILOT_CLI_PATH;
+    if (configuredPath && canExecute(configuredPath)) {
+        return configuredPath;
+    }
+    for (const segment of (process.env.PATH ?? '').split(delimiter)) {
+        if (!segment) {
+            continue;
+        }
+        const candidate = join(segment, 'copilot');
+        if (canExecute(candidate)) {
+            return candidate;
+        }
+    }
+    return explicitPath ?? configuredPath ?? 'copilot';
+}
+export function buildCopilotClientOptions(input) {
+    return {
+        cliPath: resolveCopilotCliPath(input.cliPath),
+        cliArgs: ['--config-dir', input.profile.configDir],
+        cwd: input.cwd,
+        useLoggedInUser: true,
+        useStdio: false,
+        autoStart: true,
+        autoRestart: false,
+        logLevel: 'error',
+    };
+}
+function isRateLimitError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const normalized = message.toLowerCase();
+    return (normalized.includes('rate limit') ||
+        normalized.includes('too many requests') ||
+        normalized.includes('429') ||
+        normalized.includes('quota'));
+}
+export class CopilotRuntime {
+    clients = new Map();
+    taskManager;
+    profileManager;
+    questionRegistry;
+    constructor(input) {
+        this.taskManager = input.taskManager;
+        this.profileManager = input.profileManager;
+        this.questionRegistry = input.questionRegistry;
+    }
+    async runTask(task) {
+        try {
+            const profile = this.resolveProfile(task);
+            const client = await this.getClient(task.baseCwd ?? task.cwd, profile);
+            const prompt = await buildAgentPrompt({
+                agentType: task.agentType,
+                prompt: task.prompt,
+                contextFiles: task.contextFiles,
+            });
+            const session = task.sessionId
+                ? await client.resumeSession(task.sessionId, {
+                    onPermissionRequest: approveAll,
+                    onUserInputRequest: (request, invocation) => this.questionRegistry.register({
+                        taskId: task.id,
+                        sessionId: invocation.sessionId,
+                        question: request.question,
+                        choices: request.choices,
+                        allowFreeform: request.allowFreeform,
+                    }),
+                    streaming: true,
+                })
+                : await client.createSession({
+                    model: task.model,
+                    onPermissionRequest: approveAll,
+                    onUserInputRequest: (request, invocation) => this.questionRegistry.register({
+                        taskId: task.id,
+                        sessionId: invocation.sessionId,
+                        question: request.question,
+                        choices: request.choices,
+                        allowFreeform: request.allowFreeform,
+                    }),
+                    streaming: true,
+                });
+            await this.taskManager.registerExecution(task.id, {
+                abort: async () => {
+                    await session.abort().catch(() => { });
+                },
+                cleanup: async () => {
+                    await session.disconnect().catch(() => { });
+                },
+            });
+            await this.taskManager.updateTask(task.id, {
+                status: TaskStatus.RUNNING,
+                sessionId: session.sessionId,
+                profileId: profile.id,
+                profileConfigDir: profile.configDir,
+            });
+            this.bindSessionEvents(task.id, session);
+            await this.taskManager.appendOutput(task.id, `[session] profile: ${profile.id} (${profile.configDir})`);
+            await session.sendAndWait({ prompt }, task.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+            await this.taskManager.updateTask(task.id, {
+                status: TaskStatus.COMPLETED,
+                endTime: new Date().toISOString(),
+            });
+        }
+        catch (error) {
+            if (isRateLimitError(error)) {
+                this.profileManager.markFailure('rate_limit');
+                await this.taskManager.updateTask(task.id, {
+                    status: TaskStatus.RATE_LIMITED,
+                    error: error instanceof Error ? error.message : String(error),
+                    endTime: new Date().toISOString(),
+                });
+            }
+            else {
+                await this.taskManager.updateTask(task.id, {
+                    status: TaskStatus.FAILED,
+                    error: error instanceof Error ? error.message : String(error),
+                    endTime: new Date().toISOString(),
+                });
+            }
+        }
+        finally {
+            await this.taskManager.clearExecution(task.id);
+        }
+    }
+    async shutdown() {
+        await Promise.all([...this.clients.values()].map(async (client) => {
+            await client.stop().catch(async () => {
+                await client.forceStop().catch(() => { });
+            });
+        }));
+        this.clients.clear();
+    }
+    bindSessionEvents(taskId, session) {
+        session.on('assistant.message', (event) => {
+            void this.taskManager.appendOutput(taskId, event.data.content);
+        });
+        session.on('tool.execution_start', (event) => {
+            void this.taskManager.appendOutput(taskId, `[tool] start: ${event.data.toolName}`);
+        });
+        session.on('tool.execution_complete', (event) => {
+            const label = 'toolName' in event.data ? event.data.toolName : event.data.toolCallId;
+            void this.taskManager.appendOutput(taskId, `[tool] complete: ${label} success=${String(event.data.success)}`);
+        });
+        session.on('session.error', (event) => {
+            void this.taskManager.appendOutput(taskId, `[error] ${event.data.message}`);
+        });
+    }
+    async getClient(cwd, profile) {
+        const key = `${cwd}:${profile.configDir}`;
+        const existing = this.clients.get(key);
+        if (existing) {
+            return existing;
+        }
+        const client = new CopilotClient(buildCopilotClientOptions({ cwd, profile }));
+        await client.start();
+        const auth = await client.getAuthStatus();
+        if (!auth.isAuthenticated) {
+            throw new Error(`Copilot profile "${profile.configDir}" is not authenticated. Run \`copilot login --config-dir ${profile.configDir}\`.`);
+        }
+        this.clients.set(key, client);
+        return client;
+    }
+    resolveProfile(task) {
+        if (task.profileConfigDir && task.profileId) {
+            const match = this.profileManager.getProfiles().find((profile) => profile.id === task.profileId);
+            if (match) {
+                return match;
+            }
+            return {
+                id: task.profileId,
+                configDir: task.profileConfigDir,
+                failureCount: 0,
+            };
+        }
+        return this.profileManager.getCurrentProfile();
+    }
+}
+//# sourceMappingURL=copilot-runtime.js.map

package/dist/src/services/copilot-runtime.js.map

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

package/dist/src/services/output-log.d.ts

@@ -0,0 +1,7 @@
+export declare function getOutputDir(cwd: string): string;
+export declare function getOutputPath(cwd: string, taskId: string): string;
+export declare class OutputLogService {
+    create(cwd: string, taskId: string): Promise<string>;
+    append(cwd: string, taskId: string, line: string): Promise<void>;
+    finalize(cwd: string, taskId: string, status: string, error?: string): Promise<void>;
+}

package/dist/src/services/output-log.js

@@ -0,0 +1,59 @@
+import { mkdir, open, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const OUTPUT_DIR_NAME = '.super-agents';
+function sanitizeTaskId(taskId) {
+    return taskId.replace(/[\/\\:\x00]/g, '_');
+}
+export function getOutputDir(cwd) {
+    return join(cwd, OUTPUT_DIR_NAME);
+}
+export function getOutputPath(cwd, taskId) {
+    return join(getOutputDir(cwd), `${sanitizeTaskId(taskId)}.output`);
+}
+function timestamp() {
+    return new Date().toISOString();
+}
+export class OutputLogService {
+    async create(cwd, taskId) {
+        await mkdir(getOutputDir(cwd), { recursive: true });
+        const outputPath = getOutputPath(cwd, taskId);
+        const handle = await open(outputPath, 'a+');
+        try {
+            const existing = await readFile(outputPath, 'utf8').catch(() => '');
+            if (!existing) {
+                await handle.writeFile(`# Task: ${taskId}\n# Started: ${timestamp()}\n# Working directory: ${cwd}\n${'─'.repeat(60)}\n`, 'utf8');
+            }
+        }
+        finally {
+            await handle.close();
+        }
+        return outputPath;
+    }
+    async append(cwd, taskId, line) {
+        const outputPath = await this.create(cwd, taskId);
+        const handle = await open(outputPath, 'a');
+        try {
+            await handle.writeFile(`[${timestamp()}] ${line}\n`, 'utf8');
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    async finalize(cwd, taskId, status, error) {
+        const outputPath = await this.create(cwd, taskId);
+        const handle = await open(outputPath, 'a');
+        try {
+            const footer = [
+                `${'─'.repeat(60)}`,
+                `# Completed: ${timestamp()}`,
+                `# Status: ${status}`,
+                error ? `# Error: ${error}` : null,
+            ].filter(Boolean).join('\n');
+            await handle.writeFile(`${footer}\n`, 'utf8');
+        }
+        finally {
+            await handle.close();
+        }
+    }
+}
+//# sourceMappingURL=output-log.js.map

package/dist/src/services/output-log.js.map

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

package/dist/src/services/profile-manager.d.ts

@@ -0,0 +1,34 @@
+import type { PersistedProfileState } from '../types/task.js';
+export interface CopilotProfile {
+    id: string;
+    configDir: string;
+    cooldownUntil?: number | undefined;
+    failureCount: number;
+    lastFailureReason?: string | undefined;
+}
+export interface ProfileManagerOptions {
+    profileDirs?: string[] | undefined;
+    cooldownMs?: number | undefined;
+    now?: (() => number) | undefined;
+    persistedProfiles?: PersistedProfileState[] | undefined;
+}
+export interface ProfileRotationResult {
+    success: boolean;
+    allExhausted?: boolean | undefined;
+    currentProfile?: CopilotProfile | undefined;
+}
+export declare class ProfileManager {
+    private readonly cooldownMs;
+    private readonly now;
+    private readonly profiles;
+    private currentIndex;
+    constructor(options?: ProfileManagerOptions);
+    static fromEnvironment(now?: () => number): ProfileManager;
+    hydrate(persistedProfiles: PersistedProfileState[]): void;
+    getProfiles(): CopilotProfile[];
+    getCurrentProfile(): CopilotProfile;
+    markFailure(reason: string): ProfileRotationResult;
+    resetExpiredCooldowns(): void;
+    toPersistedState(): PersistedProfileState[];
+    private findFirstAvailableIndex;
+}

package/dist/src/services/profile-manager.js

@@ -0,0 +1,113 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const DEFAULT_COOLDOWN_MS = 60_000;
+function defaultProfileDir() {
+    return join(homedir(), '.copilot');
+}
+function dedupeProfileDirs(profileDirs) {
+    const seen = new Set();
+    const result = [];
+    for (const dir of profileDirs) {
+        const normalized = dir.trim();
+        if (!normalized || seen.has(normalized)) {
+            continue;
+        }
+        seen.add(normalized);
+        result.push(normalized);
+    }
+    return result.length > 0 ? result : [defaultProfileDir()];
+}
+export class ProfileManager {
+    cooldownMs;
+    now;
+    profiles;
+    currentIndex = 0;
+    constructor(options = {}) {
+        this.cooldownMs = options.cooldownMs ?? DEFAULT_COOLDOWN_MS;
+        this.now = options.now ?? Date.now;
+        const configuredDirs = dedupeProfileDirs(options.profileDirs ?? [defaultProfileDir()]);
+        const persistedByDir = new Map((options.persistedProfiles ?? []).map((profile) => [profile.configDir, profile]));
+        this.profiles = configuredDirs.map((configDir, index) => {
+            const persisted = persistedByDir.get(configDir);
+            return {
+                id: persisted?.id ?? `profile-${index + 1}`,
+                configDir,
+                cooldownUntil: persisted?.cooldownUntil,
+                failureCount: persisted?.failureCount ?? 0,
+                lastFailureReason: persisted?.lastFailureReason,
+            };
+        });
+        this.currentIndex = this.findFirstAvailableIndex();
+    }
+    static fromEnvironment(now) {
+        const raw = process.env.COPILOT_CONFIG_DIRS;
+        const dirs = raw
+            ? raw.split(',').map((entry) => entry.trim()).filter(Boolean)
+            : [defaultProfileDir()];
+        return new ProfileManager({ profileDirs: dirs, now });
+    }
+    hydrate(persistedProfiles) {
+        const persistedByDir = new Map(persistedProfiles.map((profile) => [profile.configDir, profile]));
+        for (const profile of this.profiles) {
+            const persisted = persistedByDir.get(profile.configDir);
+            if (!persisted) {
+                continue;
+            }
+            profile.failureCount = persisted.failureCount;
+            profile.cooldownUntil = persisted.cooldownUntil;
+            profile.lastFailureReason = persisted.lastFailureReason;
+        }
+        this.resetExpiredCooldowns();
+    }
+    getProfiles() {
+        return this.profiles.map((profile) => ({ ...profile }));
+    }
+    getCurrentProfile() {
+        this.resetExpiredCooldowns();
+        return { ...this.profiles[this.currentIndex] };
+    }
+    markFailure(reason) {
+        const current = this.profiles[this.currentIndex];
+        if (!current) {
+            return { success: false, allExhausted: true };
+        }
+        current.failureCount += 1;
+        current.lastFailureReason = reason;
+        current.cooldownUntil = this.now() + this.cooldownMs;
+        const nextIndex = this.findFirstAvailableIndex();
+        if (nextIndex === -1) {
+            return { success: false, allExhausted: true };
+        }
+        this.currentIndex = nextIndex;
+        return {
+            success: true,
+            currentProfile: this.getCurrentProfile(),
+        };
+    }
+    resetExpiredCooldowns() {
+        const now = this.now();
+        for (const profile of this.profiles) {
+            if (profile.cooldownUntil !== undefined && profile.cooldownUntil <= now) {
+                profile.cooldownUntil = undefined;
+            }
+        }
+        const nextIndex = this.findFirstAvailableIndex();
+        if (nextIndex !== -1) {
+            this.currentIndex = nextIndex;
+        }
+    }
+    toPersistedState() {
+        return this.profiles.map((profile) => ({
+            id: profile.id,
+            configDir: profile.configDir,
+            cooldownUntil: profile.cooldownUntil,
+            failureCount: profile.failureCount,
+            lastFailureReason: profile.lastFailureReason,
+        }));
+    }
+    findFirstAvailableIndex() {
+        const now = this.now();
+        return this.profiles.findIndex((profile) => profile.cooldownUntil === undefined || profile.cooldownUntil <= now);
+    }
+}
+//# sourceMappingURL=profile-manager.js.map

package/dist/src/services/profile-manager.js.map

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

package/dist/src/services/question-registry.d.ts

@@ -0,0 +1,29 @@
+import type { PendingQuestion } from '../types/task.js';
+import type { TaskManager } from './task-manager.js';
+interface RegisterQuestionInput {
+    taskId: string;
+    sessionId: string;
+    question: string;
+    choices?: string[] | undefined;
+    allowFreeform?: boolean | undefined;
+}
+export declare class QuestionRegistry {
+    private readonly taskManager;
+    private readonly timeoutMs;
+    private readonly pending;
+    constructor(taskManager: TaskManager, timeoutMs?: number);
+    register(input: RegisterQuestionInput): Promise<{
+        answer: string;
+        wasFreeform: boolean;
+    }>;
+    submitAnswer(taskId: string, rawAnswer: string): {
+        success: boolean;
+        resolvedAnswer?: string | undefined;
+        error?: string | undefined;
+    };
+    hasPendingQuestion(taskId: string): boolean;
+    getAllPendingQuestions(): Map<string, PendingQuestion>;
+    clear(taskId: string, reason: string): void;
+    private parseAnswer;
+}
+export {};

package/dist/src/services/question-registry.js

@@ -0,0 +1,115 @@
+import { TaskStatus } from '../types/task.js';
+const DEFAULT_TIMEOUT_MS = 30 * 60 * 1000;
+export class QuestionRegistry {
+    taskManager;
+    timeoutMs;
+    pending = new Map();
+    constructor(taskManager, timeoutMs = DEFAULT_TIMEOUT_MS) {
+        this.taskManager = taskManager;
+        this.timeoutMs = timeoutMs;
+    }
+    register(input) {
+        this.clear(input.taskId, 'replaced by newer question');
+        return new Promise((resolve, reject) => {
+            const question = {
+                question: input.question,
+                choices: input.choices,
+                allowFreeform: input.allowFreeform ?? true,
+                askedAt: new Date().toISOString(),
+                sessionId: input.sessionId,
+            };
+            const timeout = setTimeout(() => {
+                void this.taskManager.updateTask(input.taskId, {
+                    status: TaskStatus.FAILED,
+                    error: 'Task failed: user question timed out after 30 minutes',
+                    pendingQuestion: undefined,
+                    endTime: new Date().toISOString(),
+                });
+                reject(new Error('Question timed out'));
+                this.pending.delete(input.taskId);
+            }, this.timeoutMs);
+            timeout.unref();
+            this.pending.set(input.taskId, { question, resolve, reject, timeout });
+            void this.taskManager.updateTask(input.taskId, {
+                status: TaskStatus.WAITING_ANSWER,
+                pendingQuestion: question,
+            });
+            void this.taskManager.appendOutput(input.taskId, `[question] ${input.question}`);
+        });
+    }
+    submitAnswer(taskId, rawAnswer) {
+        const binding = this.pending.get(taskId);
+        if (!binding) {
+            return { success: false, error: 'No pending question for this task' };
+        }
+        const parsed = this.parseAnswer(rawAnswer, binding.question);
+        if (!parsed.success) {
+            return parsed;
+        }
+        clearTimeout(binding.timeout);
+        binding.resolve({ answer: parsed.resolvedAnswer, wasFreeform: parsed.wasFreeform });
+        this.pending.delete(taskId);
+        void this.taskManager.updateTask(taskId, {
+            status: TaskStatus.RUNNING,
+            pendingQuestion: undefined,
+        });
+        void this.taskManager.appendOutput(taskId, `[question] Answer submitted: ${parsed.resolvedAnswer}`);
+        return parsed;
+    }
+    hasPendingQuestion(taskId) {
+        return this.pending.has(taskId);
+    }
+    getAllPendingQuestions() {
+        return new Map([...this.pending.entries()].map(([taskId, binding]) => [taskId, binding.question]));
+    }
+    clear(taskId, reason) {
+        const binding = this.pending.get(taskId);
+        if (!binding) {
+            return;
+        }
+        clearTimeout(binding.timeout);
+        binding.reject(new Error(reason));
+        this.pending.delete(taskId);
+        void this.taskManager.updateTask(taskId, { pendingQuestion: undefined });
+    }
+    parseAnswer(rawAnswer, question) {
+        const answer = rawAnswer.trim();
+        if (!answer) {
+            return { success: false, error: 'Answer cannot be empty' };
+        }
+        if (question.choices && /^\d+$/.test(answer)) {
+            const index = Number.parseInt(answer, 10) - 1;
+            if (index < 0 || index >= question.choices.length) {
+                return { success: false, error: `Invalid choice. Please enter 1-${question.choices.length}.` };
+            }
+            return {
+                success: true,
+                resolvedAnswer: question.choices[index],
+                wasFreeform: false,
+            };
+        }
+        if (answer.toUpperCase().startsWith('OTHER:') && question.allowFreeform) {
+            return {
+                success: true,
+                resolvedAnswer: answer.slice('OTHER:'.length).trim(),
+                wasFreeform: true,
+            };
+        }
+        if (question.choices?.includes(answer)) {
+            return {
+                success: true,
+                resolvedAnswer: answer,
+                wasFreeform: false,
+            };
+        }
+        if (question.allowFreeform) {
+            return {
+                success: true,
+                resolvedAnswer: answer,
+                wasFreeform: true,
+            };
+        }
+        return { success: false, error: 'Invalid answer' };
+    }
+}
+//# sourceMappingURL=question-registry.js.map

package/dist/src/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/dist/src/services/spawn-validation.d.ts

@@ -0,0 +1,9 @@
+import type { ContextFile } from '../types/task.js';
+import type { SpawnAgentInput } from '../mcp/tool-definitions.js';
+export interface ValidateSpawnAgentInputArgs {
+    input: SpawnAgentInput;
+    baseCwd: string;
+}
+export declare function validateSpawnAgentInput(args: ValidateSpawnAgentInputArgs): Promise<{
+    contextFiles: ContextFile[] | undefined;
+}>;