super-subagents 1.0.1

package/.windsurf/plans/persist-tasks-by-cwd.md

@@ -0,0 +1,113 @@
+# Persist Tasks by CWD (MD5 Hashed)
+
+Make task state persistent per-workspace using MD5 hash of cwd as filename, stored in a centralized `~/.super-agents/` directory.
+
+## Architecture
+
+```
+~/.super-agents/
+├── {md5(cwd1)}.json    ← tasks for /Users/alice/project-a
+├── {md5(cwd2)}.json    ← tasks for /Users/bob/project-b
+└── ...
+```
+
+**Why MD5 hash?**
+- Multiple users/processes can use same MCP server with different workspaces
+- No filesystem path conflicts (slashes, special chars)
+- Centralized storage — doesn't pollute workspace directories
+- Deterministic: same cwd always maps to same file
+
+## Implementation Steps
+
+### 1. Create persistence service (`src/services/task-persistence.ts`)
+
+```typescript
+// Core functions
+getStorageDir(): string           // ~/.super-agents/
+getStoragePath(cwd: string): string  // ~/.super-agents/{md5(cwd)}.json
+saveTasks(cwd: string, tasks: TaskState[]): void
+loadTasks(cwd: string): TaskState[]
+```
+
+**Key behaviors:**
+- Use `crypto.createHash('md5').update(cwd).digest('hex')` for hash
+- Create `~/.super-agents/` directory if missing (use `os.homedir()`)
+- Exclude non-serializable `process` field via custom serializer
+- Atomic writes: write to `.tmp` file, then rename
+- Mark previously-running tasks as `failed` with `"Server restarted"` error on load
+
+### 2. Update `TaskManager` (`src/services/task-manager.ts`)
+
+**New methods:**
+- `setCwd(cwd: string)` — set active workspace, load existing tasks
+- `persist()` — save current state to disk (debounced)
+
+**Modify existing methods to trigger persistence:**
+- `createTask()` → persist after
+- `updateTask()` → persist after  
+- `appendOutput()` → persist after (debounced more aggressively)
+- `cancelTask()` → persist after
+
+**Debounce strategy:**
+- State changes: 100ms debounce
+- Output appends: 1000ms debounce (high frequency)
+
+### 3. Wire persistence in `index.ts`
+
+```typescript
+server.oninitialized = async () => {
+  // ... existing root detection ...
+  const cwd = clientContext.getDefaultCwd();
+  taskManager.setCwd(cwd);  // loads tasks from ~/.super-agents/{md5(cwd)}.json
+};
+```
+
+### 4. Update README.md
+
+Document:
+- Persistence location: `~/.super-agents/`
+- Per-workspace isolation via MD5 hash
+- Crash recovery behavior
+
+## Files to Create/Modify
+
+| File | Action |
+|------|--------|
+| `src/services/task-persistence.ts` | **Create** — MD5 hashing, atomic JSON read/write |
+| `src/services/task-manager.ts` | **Modify** — add `setCwd()`, `persist()`, debouncing |
+| `src/index.ts` | **Modify** — call `taskManager.setCwd()` on init |
+| `README.md` | **Modify** — document persistence |
+
+## Edge Cases (All Covered)
+
+| Scenario | Handling |
+|----------|----------|
+| **Orphaned running tasks** | Mark as `failed` with error `"Server restarted"` on load |
+| **Corrupted JSON** | Log warning to stderr, start with empty task list |
+| **Concurrent writes** | Atomic write (temp file + rename) prevents corruption |
+| **Missing storage dir** | Create `~/.super-agents/` on first write |
+| **Permission denied** | Log warning, continue in memory-only mode |
+| **Disk full** | Catch write error, log warning, don't crash |
+| **Very long output** | Already truncated by `MAX_OUTPUT_LINES` (2000) |
+| **Multiple MCP instances** | Each instance uses same hash → shares state (feature) |
+| **Task TTL cleanup** | Runs on loaded tasks too, cleans old completed tasks |
+
+## Serialization
+
+**Included fields:**
+```typescript
+{ id, status, prompt, output, pid, sessionId, startTime, endTime, 
+  exitCode, error, cwd, model, autonomous, isResume }
+```
+
+**Excluded fields:**
+- `process` — live process handle, not serializable
+
+## Success Criteria
+
+- [x] Tasks survive server restart
+- [x] Each workspace has independent task history (via MD5)
+- [x] Multiple users/workspaces supported concurrently  
+- [x] No data loss on normal shutdown
+- [x] Graceful degradation on disk errors
+- [x] Atomic writes prevent corruption

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]
+- Add centralized timeout configuration with env overrides.
+- Record task activity timestamps, timeout reasons, and context for diagnostics.
+- Improve get_status and stream_output guidance for stalls/timeouts.
+- Add recover_task tool for timed_out recovery paths.
+- Document timeout durability workflow and new env settings.

package/CLAUDE.md

@@ -0,0 +1,67 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build & Development Commands
+
+```bash
+npm install          # Install dependencies
+npm run build        # Compile TypeScript to build/
+npm run dev          # Watch mode with tsx (auto-reload)
+npm start            # Run compiled server
+npm run clean        # Remove build directory
+```
+
+## Architecture Overview
+
+This is an MCP (Model Context Protocol) server that spawns GitHub Copilot CLI agents as background tasks. It wraps the Copilot CLI (`/opt/homebrew/bin/copilot` by default) with task management, dependency chains, and automatic rate-limit retry.
+
+### Core Components
+
+**Entry Point** (`src/index.ts`): Sets up MCP server, registers all tools, and wires up task manager callbacks for retry and dependency execution.
+
+**Task Manager** (`src/services/task-manager.ts`): Central state machine managing all tasks. Handles:
+- Task lifecycle (pending → waiting → running → completed/failed/cancelled/rate_limited/timed_out)
+- Dependency resolution via `areDependenciesSatisfied()` and `processWaitingTasks()`
+- Persistence scheduling with debouncing
+- Auto-cleanup of expired tasks (1 hour TTL)
+
+**Process Spawner** (`src/services/process-spawner.ts`): Executes Copilot CLI via `execa`. Builds command args, captures stdout/stderr, detects rate limits, and handles timeouts.
+
+**Persistence** (`src/services/task-persistence.ts`): Tasks persist to `~/.super-agents/{md5(cwd)}.json`. Uses atomic writes (write temp → rename).
+
+**Retry Queue** (`src/services/retry-queue.ts`): Detects rate-limit errors via regex patterns, calculates exponential backoff (5m → 10m → 20m → 40m → 1h → 2h), and extracts wait times from error messages.
+
+### Tool Handlers
+
+Each tool in `src/tools/` exports:
+- A tool definition object (`{name, description, inputSchema}`)
+- A handler function that validates input via Zod schemas from `src/utils/sanitize.ts`
+
+### Templates
+
+Task templates in `src/templates/*.mdx` wrap user prompts with specialized instructions. The `applyTemplate()` function replaces `{{user_prompt}}` placeholder or appends if not found.
+
+### Key Types
+
+- `TaskStatus` enum: `pending`, `waiting`, `running`, `completed`, `failed`, `cancelled`, `rate_limited`, `timed_out`
+- `TaskState`: Full task object with output buffer, retry info, dependencies, labels
+- `SpawnOptions`: Input for creating tasks
+
+### Task IDs
+
+Human-readable IDs like `brave-tiger-42` generated via `unique-names-generator`. Normalized to lowercase for lookups.
+
+## Environment Variables
+
+| Variable | Default | Purpose |
+|----------|---------|---------|
+| `COPILOT_PATH` | `/opt/homebrew/bin/copilot` | Path to Copilot CLI executable |
+| `ENABLE_OPUS` | `false` | Allow opus model (cost control) |
+| `ENABLE_STREAMING` | `false` | Enable experimental `stream_output` tool |
+
+## Adding New Tools
+
+1. Create `src/tools/new-tool.ts` with tool definition and handler
+2. Import and add to `tools` array in `src/index.ts`
+3. Add case to switch statement in `CallToolRequestSchema` handler

package/README.md

@@ -0,0 +1,124 @@
+# Super Agents MCP Server
+
+MCP server that spawns GitHub Copilot CLI agents as background tasks with human-readable IDs, dependency chains, and automatic rate-limit retry.
+
+## Quick Start
+
+```bash
+npm install && npm run build
+```
+
+```json
+{
+  "mcpServers": {
+    "super-agents": {
+      "command": "node",
+      "args": ["/path/to/copilot-agents/build/index.js"]
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `spawn_task` | Create a task. Returns `task_id` for tracking. |
+| `batch_spawn` | Create multiple tasks with dependency chains (max 20). |
+| `get_status` | Check task status. Supports batch checking with array. |
+| `list_tasks` | List all tasks. Filter by `status` or `label`. |
+| `resume_task` | Resume interrupted session by `session_id`. |
+| `retry_task` | Immediately retry a rate-limited task. |
+| `cancel_task` | Kill a running/pending task (SIGTERM). |
+| `recover_task` | Recover a timed_out task (resume if session is available). |
+| `force_start` | Start a waiting task, bypassing dependencies. |
+| `clear_tasks` | Delete all tasks for workspace. Requires `confirm: true`. |
+| `stream_output` | *(experimental)* Get incremental output with offset. Requires `ENABLE_STREAMING=true`. |
+
+## Task Statuses
+
+`pending` → `waiting` → `running` → `completed` | `failed` | `cancelled` | `rate_limited` | `timed_out`
+
+## Features
+
+### Dependencies
+```json
+{ "prompt": "Deploy", "depends_on": ["build-task-id", "test-task-id"] }
+```
+Task waits until all dependencies complete. Use `force_start` to bypass.
+
+### Labels
+```json
+{ "prompt": "Build API", "labels": ["backend", "urgent"] }
+```
+Filter with `list_tasks({ "label": "backend" })`.
+
+### Batch Spawn
+```json
+{
+  "tasks": [
+    { "id": "build", "prompt": "Build project" },
+    { "id": "test", "prompt": "Run tests", "depends_on": ["build"] },
+    { "id": "deploy", "prompt": "Deploy", "depends_on": ["test"] }
+  ]
+}
+```
+Local `id` fields map to real `task_id` in response.
+
+### Task Templates
+
+| Template | Use Case |
+|----------|----------|
+| `super-coder` | Implementation, bug fixes, refactoring |
+| `super-planner` | Architecture, design decisions |
+| `super-researcher` | Codebase exploration, investigation |
+| `super-tester` | Writing tests, QA verification |
+
+### Models
+`claude-sonnet-4.5` (default), `claude-haiku-4.5`. Opus blocked by default (set `ENABLE_OPUS=true` to allow).
+
+### Timeout
+Default: 10 min (600000ms). Max: 1 hour. Tasks exceeding timeout get `timed_out` status.
+Configurable via `MCP_TASK_TIMEOUT_MS`, `MCP_TASK_TIMEOUT_MIN_MS`, and `MCP_TASK_TIMEOUT_MAX_MS`.
+Stall warnings are based on `MCP_TASK_STALL_WARN_MS`. Timed out tasks may include a reason and can be recovered via `recover_task` or `resume_task` when a session is available.
+
+### Rate Limit Auto-Retry
+Rate-limited tasks auto-retry with exponential backoff (5m → 10m → 20m → 40m → 1h → 2h). Max 6 retries.
+
+### Persistence
+Tasks persist to `~/.super-agents/{md5(cwd)}.json`. Survives server restarts.
+
+### Output Streaming (Experimental)
+Requires `ENABLE_STREAMING=true`. Disabled by default.
+```json
+// First call
+{ "task_id": "brave-tiger-42", "offset": 0 }
+// Response: { "lines": [...], "next_offset": 50, "has_more": true }
+
+// Subsequent calls
+{ "task_id": "brave-tiger-42", "offset": 50 }
+```
+Use `next_offset` from response to get new lines without re-fetching.
+
+### Polling Backoff
+Response includes `retry_after_seconds` (30s → 60s → 120s → 180s) to prevent excessive polling.
+
+## Environment
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `COPILOT_PATH` | `/opt/homebrew/bin/copilot` | Copilot CLI path |
+| `ENABLE_OPUS` | `false` | Allow opus model (cost control) |
+| `ENABLE_STREAMING` | `false` | Enable experimental `stream_output` tool |
+| `MCP_TASK_TIMEOUT_MS` | `600000` | Default task timeout (ms) |
+| `MCP_TASK_TIMEOUT_MIN_MS` | `1000` | Minimum allowed task timeout (ms) |
+| `MCP_TASK_TIMEOUT_MAX_MS` | `3600000` | Maximum allowed task timeout (ms) |
+| `MCP_TASK_STALL_WARN_MS` | `300000` | No-output stall warning threshold (ms) |
+| `MCP_COPILOT_SWITCH_TIMEOUT_MS` | `120000` | Timeout for copilot-switch command (ms) |
+| `MCP_COPILOT_SWITCH_LOCK_STALE_MS` | `150000` | Stale lock threshold for copilot-switch (ms) |
+| `MCP_COPILOT_SWITCH_LOCK_TIMEOUT_MS` | `150000` | Wait timeout for copilot-switch lock (ms) |
+| `MCP_COPILOT_SWITCH_LOCK_POLL_MS` | `500` | Lock poll interval for copilot-switch (ms) |
+
+## License
+
+MIT

package/build/config/timeouts.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Centralized timeout configuration with optional environment overrides.
+ */
+export declare const TASK_TIMEOUT_MIN_MS: number;
+export declare const TASK_TIMEOUT_MAX_MS: number;
+export declare const TASK_TIMEOUT_DEFAULT_MS: number;
+export declare const TASK_STALL_WARN_MS: number;
+export declare const COPILOT_SWITCH_COMMAND_TIMEOUT_MS: number;
+export declare const COPILOT_SWITCH_LOCK_STALE_MS: number;
+export declare const COPILOT_SWITCH_LOCK_TIMEOUT_MS: number;
+export declare const COPILOT_SWITCH_LOCK_POLL_MS: number;
+//# sourceMappingURL=timeouts.d.ts.map

package/build/config/timeouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeouts.d.ts","sourceRoot":"","sources":["../../src/config/timeouts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,eAAO,MAAM,mBAAmB,QAA+C,CAAC;AAChF,eAAO,MAAM,mBAAmB,QAAmD,CAAC;AACpF,eAAO,MAAM,uBAAuB,QAA6C,CAAC;AAClF,eAAO,MAAM,kBAAkB,QAAmD,CAAC;AAGnF,eAAO,MAAM,iCAAiC,QAAuD,CAAC;AACtG,eAAO,MAAM,4BAA4B,QAA0D,CAAC;AACpG,eAAO,MAAM,8BAA8B,QAA4D,CAAC;AACxG,eAAO,MAAM,2BAA2B,QAAqD,CAAC"}

package/build/config/timeouts.js

@@ -0,0 +1,21 @@
+/**
+ * Centralized timeout configuration with optional environment overrides.
+ */
+function readIntEnv(name, fallback) {
+    const raw = process.env[name];
+    if (!raw)
+        return fallback;
+    const value = Number(raw);
+    return Number.isFinite(value) && value > 0 ? Math.floor(value) : fallback;
+}
+// Task execution timeout bounds
+export const TASK_TIMEOUT_MIN_MS = readIntEnv('MCP_TASK_TIMEOUT_MIN_MS', 1_000);
+export const TASK_TIMEOUT_MAX_MS = readIntEnv('MCP_TASK_TIMEOUT_MAX_MS', 3_600_000);
+export const TASK_TIMEOUT_DEFAULT_MS = readIntEnv('MCP_TASK_TIMEOUT_MS', 600_000);
+export const TASK_STALL_WARN_MS = readIntEnv('MCP_TASK_STALL_WARN_MS', 5 * 60_000);
+// Copilot switch timings
+export const COPILOT_SWITCH_COMMAND_TIMEOUT_MS = readIntEnv('MCP_COPILOT_SWITCH_TIMEOUT_MS', 120_000);
+export const COPILOT_SWITCH_LOCK_STALE_MS = readIntEnv('MCP_COPILOT_SWITCH_LOCK_STALE_MS', 150_000);
+export const COPILOT_SWITCH_LOCK_TIMEOUT_MS = readIntEnv('MCP_COPILOT_SWITCH_LOCK_TIMEOUT_MS', 150_000);
+export const COPILOT_SWITCH_LOCK_POLL_MS = readIntEnv('MCP_COPILOT_SWITCH_LOCK_POLL_MS', 500);
+//# sourceMappingURL=timeouts.js.map

package/build/config/timeouts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeouts.js","sourceRoot":"","sources":["../../src/config/timeouts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,SAAS,UAAU,CAAC,IAAY,EAAE,QAAgB;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC5E,CAAC;AAED,gCAAgC;AAChC,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;AAChF,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC,yBAAyB,EAAE,SAAS,CAAC,CAAC;AACpF,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;AAClF,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC,wBAAwB,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC;AAEnF,yBAAyB;AACzB,MAAM,CAAC,MAAM,iCAAiC,GAAG,UAAU,CAAC,+BAA+B,EAAE,OAAO,CAAC,CAAC;AACtG,MAAM,CAAC,MAAM,4BAA4B,GAAG,UAAU,CAAC,kCAAkC,EAAE,OAAO,CAAC,CAAC;AACpG,MAAM,CAAC,MAAM,8BAA8B,GAAG,UAAU,CAAC,oCAAoC,EAAE,OAAO,CAAC,CAAC;AACxG,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/build/index.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { spawnTaskTool, handleSpawnTask } from './tools/spawn-task.js';
+import { getTaskStatusTool, handleGetTaskStatus } from './tools/get-status.js';
+import { listTasksTool, handleListTasks } from './tools/list-tasks.js';
+import { resumeTaskTool, handleResumeTask } from './tools/resume-task.js';
+import { clearTasksTool, handleClearTasks } from './tools/clear-tasks.js';
+import { retryTaskTool, handleRetryTask } from './tools/retry-task.js';
+import { cancelTaskTool, handleCancelTask } from './tools/cancel-task.js';
+import { recoverTaskTool, handleRecoverTask } from './tools/recover-task.js';
+import { forceStartTool, handleForceStart } from './tools/force-start.js';
+import { batchSpawnTool, handleBatchSpawn } from './tools/batch-spawn.js';
+import { streamOutputTool, handleStreamOutput } from './tools/stream-output.js';
+import { simulateRateLimitTool, handleSimulateRateLimit } from './tools/simulate-rate-limit.js';
+import { taskManager } from './services/task-manager.js';
+import { clientContext } from './services/client-context.js';
+import { checkCopilotInstalled, checkClaudeCliInstalled } from './services/process-spawner.js';
+import { isSwitchAvailable } from './services/copilot-switch.js';
+import { mcpText } from './utils/format.js';
+// Feature flags (off by default for cost control)
+const ENABLE_STREAMING = process.env.ENABLE_STREAMING === 'true';
+const server = new Server({ name: 'copilot-agent', version: '1.0.0' }, { capabilities: { tools: {} } });
+// Register retry callback for rate-limited tasks
+taskManager.onRetry(async (task) => {
+    const { spawnCopilotProcess } = await import('./services/process-spawner.js');
+    console.error(`[index] Retrying task ${task.id}: "${task.prompt.slice(0, 50)}..."`);
+    try {
+        // Spawn a new process with the same parameters, carrying forward retry info
+        const newTaskId = await spawnCopilotProcess({
+            prompt: task.prompt,
+            cwd: task.cwd,
+            model: task.model,
+            autonomous: task.autonomous ?? true,
+            retryInfo: task.retryInfo,
+            fallbackAttempted: task.fallbackAttempted,
+        });
+        return newTaskId;
+    }
+    catch (err) {
+        console.error(`[index] Failed to retry task ${task.id}:`, err);
+        return undefined;
+    }
+});
+// Register execute callback for waiting tasks (dependencies satisfied)
+taskManager.onExecute(async (task) => {
+    const { executeWaitingTask } = await import('./services/process-spawner.js');
+    console.error(`[index] Executing waiting task ${task.id}: "${task.prompt.slice(0, 50)}..."`);
+    await executeWaitingTask(task);
+});
+server.oninitialized = async () => {
+    try {
+        const result = await server.listRoots();
+        if (result?.roots?.length) {
+            clientContext.setRoots(result.roots);
+        }
+    }
+    catch {
+        // Client may not support roots - use server cwd as fallback
+    }
+    // Load persisted tasks for this workspace (also triggers auto-retry for rate-limited tasks)
+    const cwd = clientContext.getDefaultCwd();
+    taskManager.setCwd(cwd);
+};
+const tools = [
+    spawnTaskTool, getTaskStatusTool, listTasksTool, resumeTaskTool,
+    clearTasksTool, retryTaskTool, cancelTaskTool, recoverTaskTool, forceStartTool, batchSpawnTool,
+    ...(ENABLE_STREAMING ? [streamOutputTool] : []),
+    simulateRateLimitTool,
+];
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: tools.map(t => ({ name: t.name, description: t.description, inputSchema: t.inputSchema })),
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    switch (name) {
+        case 'spawn_task': return handleSpawnTask(args);
+        case 'get_status': return handleGetTaskStatus(args);
+        case 'list_tasks': return handleListTasks(args);
+        case 'resume_task': return handleResumeTask(args);
+        case 'clear_tasks': return handleClearTasks(request.params.arguments);
+        case 'retry_task': return handleRetryTask(request.params.arguments);
+        case 'cancel_task': return handleCancelTask(request.params.arguments);
+        case 'recover_task': return handleRecoverTask(args);
+        case 'force_start': return handleForceStart(request.params.arguments);
+        case 'batch_spawn': return handleBatchSpawn(request.params.arguments);
+        case 'stream_output': return ENABLE_STREAMING
+            ? handleStreamOutput(request.params.arguments)
+            : mcpText('**Error:** `stream_output` is disabled (experimental). Set `ENABLE_STREAMING=true` to enable.');
+        case 'simulate_rate_limit': return handleSimulateRateLimit(request.params.arguments);
+        default: return mcpText(`**Error:** Unknown tool \`${name}\``);
+    }
+});
+async function main() {
+    if (!checkCopilotInstalled())
+        console.error('Warning: Copilot CLI not found');
+    if (isSwitchAvailable()) {
+        console.error('Info: Copilot account switching available');
+    }
+    else {
+        console.error('Info: Copilot account switching not available (no ~/bin/copilot-switch)');
+    }
+    if (!checkClaudeCliInstalled()) {
+        console.error('Warning: Claude CLI not found - fallback on rate limit will not be available');
+    }
+    else {
+        console.error('Info: Claude CLI available for rate limit fallback');
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.on('SIGINT', () => { taskManager.shutdown(); process.exit(0); });
+    process.on('SIGTERM', () => { taskManager.shutdown(); process.exit(0); });
+}
+main().catch(e => { console.error('Fatal:', e); process.exit(1); });
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/models.d.ts

@@ -0,0 +1,11 @@
+export declare const MODELS: {
+    readonly 'claude-sonnet-4.5': "Latest Sonnet - best balance of speed and capability (default)";
+    readonly 'claude-opus-4.5': "Most capable - complex reasoning, large codebases";
+    readonly 'claude-haiku-4.5': "Fastest - simple tasks, quick iterations";
+};
+export type ModelId = keyof typeof MODELS;
+export declare const DEFAULT_MODEL: ModelId;
+export declare const MODEL_IDS: ModelId[];
+/** Validate and sanitize model selection */
+export declare function resolveModel(requested?: string): ModelId;
+//# sourceMappingURL=models.d.ts.map

package/build/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,MAAM,CAAC;AAC1C,eAAO,MAAM,aAAa,EAAE,OAA6B,CAAC;AAK1D,eAAO,MAAM,SAAS,EAAE,OAAO,EAEc,CAAC;AAE9C,4CAA4C;AAC5C,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAKxD"}

package/build/models.js

@@ -0,0 +1,22 @@
+export const MODELS = {
+    'claude-sonnet-4.5': 'Latest Sonnet - best balance of speed and capability (default)',
+    'claude-opus-4.5': 'Most capable - complex reasoning, large codebases',
+    'claude-haiku-4.5': 'Fastest - simple tasks, quick iterations',
+};
+export const DEFAULT_MODEL = 'claude-sonnet-4.5';
+// ENABLE_OPUS=false by default - opus blocked unless explicitly enabled
+const ENABLE_OPUS = process.env.ENABLE_OPUS === 'true';
+export const MODEL_IDS = ENABLE_OPUS
+    ? ['claude-sonnet-4.5', 'claude-opus-4.5', 'claude-haiku-4.5']
+    : ['claude-sonnet-4.5', 'claude-haiku-4.5'];
+/** Validate and sanitize model selection */
+export function resolveModel(requested) {
+    if (!requested)
+        return DEFAULT_MODEL;
+    if (requested === 'claude-opus-4.5' && !ENABLE_OPUS)
+        return DEFAULT_MODEL;
+    if (MODEL_IDS.includes(requested))
+        return requested;
+    return DEFAULT_MODEL;
+}
+//# sourceMappingURL=models.js.map

package/build/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,mBAAmB,EAAE,gEAAgE;IACrF,iBAAiB,EAAE,mDAAmD;IACtE,kBAAkB,EAAE,0CAA0C;CACtD,CAAC;AAGX,MAAM,CAAC,MAAM,aAAa,GAAY,mBAAmB,CAAC;AAE1D,wEAAwE;AACxE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,CAAC;AAEvD,MAAM,CAAC,MAAM,SAAS,GAAc,WAAW;IAC7C,CAAC,CAAC,CAAC,mBAAmB,EAAE,iBAAiB,EAAE,kBAAkB,CAAC;IAC9D,CAAC,CAAC,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;AAE9C,4CAA4C;AAC5C,MAAM,UAAU,YAAY,CAAC,SAAkB;IAC7C,IAAI,CAAC,SAAS;QAAE,OAAO,aAAa,CAAC;IACrC,IAAI,SAAS,KAAK,iBAAiB,IAAI,CAAC,WAAW;QAAE,OAAO,aAAa,CAAC;IAC1E,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAoB,CAAC;QAAE,OAAO,SAAoB,CAAC;IAC1E,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/build/services/client-context.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Stores client context including workspace roots from MCP initialization.
+ * The first root is used as default CWD for spawned processes.
+ */
+declare class ClientContext {
+    private _roots;
+    private _defaultCwd;
+    /**
+     * Set roots from client's roots/list response
+     */
+    setRoots(roots: Array<{
+        uri: string;
+        name?: string;
+    }>): void;
+    /**
+     * Get the default CWD for spawning processes.
+     * Returns first client root if available, otherwise server's cwd.
+     */
+    getDefaultCwd(): string;
+    /**
+     * Get all client roots
+     */
+    getRoots(): string[];
+    /**
+     * Check if roots were provided by client
+     */
+    hasRoots(): boolean;
+}
+export declare const clientContext: ClientContext;
+export {};
+//# sourceMappingURL=client-context.d.ts.map

package/build/services/client-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-context.d.ts","sourceRoot":"","sources":["../../src/services/client-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAyB;IAE5C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAc5D;;;OAGG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE;IAIpB;;OAEG;IACH,QAAQ,IAAI,OAAO;CAGpB;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/build/services/client-context.js

@@ -0,0 +1,44 @@
+/**
+ * Stores client context including workspace roots from MCP initialization.
+ * The first root is used as default CWD for spawned processes.
+ */
+class ClientContext {
+    _roots = [];
+    _defaultCwd = process.cwd();
+    /**
+     * Set roots from client's roots/list response
+     */
+    setRoots(roots) {
+        this._roots = roots.map(r => {
+            // Convert file:// URI to filesystem path
+            if (r.uri.startsWith('file://')) {
+                return decodeURIComponent(r.uri.replace('file://', ''));
+            }
+            return r.uri;
+        });
+        if (this._roots.length > 0) {
+            this._defaultCwd = this._roots[0];
+        }
+    }
+    /**
+     * Get the default CWD for spawning processes.
+     * Returns first client root if available, otherwise server's cwd.
+     */
+    getDefaultCwd() {
+        return this._defaultCwd;
+    }
+    /**
+     * Get all client roots
+     */
+    getRoots() {
+        return [...this._roots];
+    }
+    /**
+     * Check if roots were provided by client
+     */
+    hasRoots() {
+        return this._roots.length > 0;
+    }
+}
+export const clientContext = new ClientContext();
+//# sourceMappingURL=client-context.js.map

package/build/services/client-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-context.js","sourceRoot":"","sources":["../../src/services/client-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,aAAa;IACT,MAAM,GAAa,EAAE,CAAC;IACtB,WAAW,GAAW,OAAO,CAAC,GAAG,EAAE,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,KAA4C;QACnD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAC1B,yCAAyC;YACzC,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAChC,OAAO,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO,CAAC,CAAC,GAAG,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAChC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC"}