spawnee 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 spencech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,265 @@
+# spawnee
+
+Spawn and orchestrate Cursor Cloud Agents from task templates with dependency resolution, parallel execution, and automatic retries.
+
+## Installation
+
+```bash
+npm install -g spawnee
+```
+
+## Quick Start
+
+```bash
+# Initialize a config file
+spawnee init
+
+# Edit .spawneerc.json with your API key
+
+# Validate a template
+spawnee validate my-tasks.yaml
+
+# Dry run (preview without spawning agents)
+spawnee run my-tasks.yaml --dry-run
+
+# Execute the template
+spawnee run my-tasks.yaml
+```
+
+## Configuration
+
+spawnee supports three configuration methods with the following priority (highest to lowest):
+
+1. **CLI flags** - Override everything
+2. **Environment variables** - Override config file and defaults
+3. **Config file** (`.spawneerc.json`) - Override defaults
+4. **Built-in defaults**
+
+### Configuration Options
+
+| Option | CLI Flag | Environment Variable | Config Key | Default |
+|--------|----------|---------------------|------------|---------|
+| API Key | `--api-key, -k` | `SPAWNEE_API_KEY` | `apiKey` | (required) |
+| API Base URL | `--api-url` | `SPAWNEE_API_URL` | `apiBaseUrl` | `https://api.cursor.com` |
+| Max Concurrent | `--concurrency, -c` | `SPAWNEE_CONCURRENCY` | `maxConcurrent` | `10` |
+| Poll Interval | `--poll-interval` | `SPAWNEE_POLL_INTERVAL` | `pollInterval` | `15000` (ms) |
+| Default Timeout | `--timeout, -t` | `SPAWNEE_TIMEOUT` | `defaultTimeout` | `3600000` (ms) |
+| State File | `--state-file` | `SPAWNEE_STATE_FILE` | `stateFile` | `.spawnee-state.json` |
+| Config File | `--config` | `SPAWNEE_CONFIG` | - | `.spawneerc.json` |
+| Verbose | `--verbose, -v` | `SPAWNEE_VERBOSE` | `verbose` | `false` |
+
+### Config File
+
+Create a `.spawneerc.json` file in your project root:
+
+```json
+{
+  "apiKey": "your-cursor-api-key",
+  "apiBaseUrl": "https://api.cursor.com",
+  "maxConcurrent": 10,
+  "pollInterval": 15000,
+  "defaultTimeout": 3600000,
+  "stateFile": ".spawnee-state.json",
+  "verbose": false
+}
+```
+
+Or generate one with:
+
+```bash
+spawnee init
+```
+
+### Environment Variables
+
+```bash
+export SPAWNEE_API_KEY="your-cursor-api-key"
+export SPAWNEE_CONCURRENCY=5
+export SPAWNEE_TIMEOUT=7200000
+export SPAWNEE_VERBOSE=true
+```
+
+### CLI Flags
+
+```bash
+spawnee run my-tasks.yaml \
+  --api-key "your-key" \
+  --concurrency 5 \
+  --timeout 7200000 \
+  --poll-interval 10000 \
+  --state-file ".my-state.json" \
+  --verbose
+```
+
+## Commands
+
+### `spawnee run <template>`
+
+Execute a task template.
+
+```bash
+spawnee run my-tasks.yaml [options]
+```
+
+**Options:**
+- `-k, --api-key <key>` - Cursor API key
+- `--api-url <url>` - API base URL
+- `-c, --concurrency <n>` - Max concurrent agents
+- `-t, --timeout <ms>` - Default task timeout
+- `--poll-interval <ms>` - Status poll interval
+- `--state-file <path>` - State file for persistence
+- `-d, --dry-run` - Preview without spawning agents
+- `--no-persist` - Disable state persistence
+- `-v, --verbose` - Enable verbose output
+
+### `spawnee validate <template>`
+
+Validate a task template without running it.
+
+```bash
+spawnee validate my-tasks.yaml
+```
+
+### `spawnee status`
+
+Check status of running agents.
+
+```bash
+spawnee status [options]
+```
+
+**Options:**
+- `-k, --api-key <key>` - Cursor API key
+- `--api-url <url>` - API base URL
+
+### `spawnee cancel <agent-id>`
+
+Cancel a running agent.
+
+```bash
+spawnee cancel abc123def456
+```
+
+### `spawnee init`
+
+Create a `.spawneerc.json` config file.
+
+```bash
+spawnee init          # Create config file
+spawnee init --force  # Overwrite existing
+```
+
+### `spawnee config`
+
+Show the resolved configuration (useful for debugging).
+
+```bash
+spawnee config
+```
+
+## Task Templates
+
+Templates can be JSON or YAML. Here's a complete example:
+
+```yaml
+name: "My Task Plan"
+repository:
+  url: "https://github.com/your-org/your-repo"
+  branch: "main"
+  baseBranch: "develop"
+
+defaults:
+  model: "auto"
+  timeout: 3600000
+  retries: 2
+
+context:
+  instructions: |
+    You are implementing features for a Node.js application.
+    Follow existing code patterns and conventions.
+  files:
+    - "README.md"
+    - "package.json"
+
+tasks:
+  - id: "setup"
+    name: "Project Setup"
+    priority: 100
+    branch: "feature/setup"
+    prompt: |
+      Initialize the project structure:
+      1. Create necessary directories
+      2. Set up configuration files
+
+  - id: "feature-a"
+    name: "Feature A"
+    dependsOn: ["setup"]
+    priority: 80
+    branch: "feature/a"
+    prompt: |
+      Implement Feature A with tests.
+    files:
+      - "src/features/"
+
+  - id: "feature-b"
+    name: "Feature B"
+    dependsOn: ["setup"]
+    priority: 80
+    branch: "feature/b"
+    prompt: |
+      Implement Feature B with tests.
+
+  - id: "integration"
+    name: "Integration"
+    dependsOn: ["feature-a", "feature-b"]
+    priority: 60
+    branch: "feature/integration"
+    prompt: |
+      Integrate features and add integration tests.
+    validation:
+      command: "npm test"
+      successPattern: "passed"
+```
+
+### Template Schema
+
+**Required fields:**
+- `name` - Template name
+- `repository.url` - GitHub repository URL
+- `tasks` - Array of tasks
+
+**Task fields:**
+- `id` (required) - Unique task identifier
+- `name` (required) - Human-readable name
+- `prompt` (required) - Instructions for the agent
+- `dependsOn` - Array of task IDs this task depends on
+- `priority` - Higher runs first (default: 0)
+- `branch` - Git branch for the task
+- `files` - Files to include in context
+- `timeout` - Task-specific timeout (ms)
+- `retries` - Max retry attempts
+- `complete` - Mark as already complete (skip)
+- `validation.command` - Command to verify completion
+- `validation.successPattern` - Expected output pattern
+
+## Features
+
+- **Dependency Resolution** - Tasks run in correct order based on `dependsOn`
+- **Parallel Execution** - Independent tasks run concurrently (up to `maxConcurrent`)
+- **Automatic Retries** - Failed tasks retry with configurable attempts
+- **State Persistence** - Resume interrupted runs from where they left off
+- **Validation** - Optional command validation for task completion
+- **Dry Run** - Preview task graph without spawning agents
+
+## Limits
+
+- Maximum 256 concurrent agents per API key
+- Usage-based pricing (same as Cursor Background Agents)
+
+## Getting Your API Key
+
+Get your Cursor API key from: **Cursor Dashboard → Integrations → User API Keys**
+
+## License
+
+MIT

package/dist/core/orchestrator.d.ts

@@ -0,0 +1,45 @@
+import { EventEmitter } from 'events';
+import { TaskInput } from './task-queue.js';
+import { StateStore } from '../storage/state-store.js';
+import { Config } from '../utils/config.js';
+export interface OrchestratorOptions {
+    config: Config;
+    stateStore?: StateStore;
+    repository: string;
+    baseBranch: string;
+    globalContext?: string;
+    globalFiles?: string[];
+}
+export declare class Orchestrator extends EventEmitter {
+    private client;
+    private queue;
+    private stateStore?;
+    private logger;
+    private options;
+    private activeAgents;
+    private timeouts;
+    private isRunning;
+    private templateName;
+    constructor(options: OrchestratorOptions);
+    private setupEventHandlers;
+    loadTasks(templateName: string, tasks: TaskInput[]): void;
+    start(): Promise<void>;
+    private trySpawnAgents;
+    private spawnAgent;
+    private buildPrompt;
+    private handleAgentComplete;
+    private handleAgentFailed;
+    private clearTimeout;
+    private clearAllTimeouts;
+    private saveState;
+    stop(): Promise<void>;
+    getStatus(): {
+        isRunning: boolean;
+        queue: Record<string, number>;
+        activeAgents: Array<{
+            agentId: string;
+            taskId: string;
+        }>;
+    };
+    sendFollowUp(taskId: string, message: string): Promise<void>;
+}

package/dist/core/orchestrator.js

@@ -0,0 +1,240 @@
+import { EventEmitter } from 'events';
+import { CursorClient } from '../cursor/client.js';
+import { TaskQueue } from './task-queue.js';
+import { Logger } from '../utils/logger.js';
+export class Orchestrator extends EventEmitter {
+    client;
+    queue;
+    stateStore;
+    logger;
+    options;
+    activeAgents = new Map(); // agentId -> taskId
+    timeouts = new Map();
+    isRunning = false;
+    templateName = '';
+    constructor(options) {
+        super();
+        this.options = options;
+        this.client = new CursorClient(options.config.apiKey, options.config.apiBaseUrl);
+        this.queue = new TaskQueue();
+        this.stateStore = options.stateStore;
+        this.logger = new Logger('Orchestrator');
+        this.setupEventHandlers();
+    }
+    setupEventHandlers() {
+        this.queue.on('taskReady', () => this.trySpawnAgents());
+        this.queue.on('taskCompleted', (task) => {
+            this.logger.success(`Task completed: ${task.id}`);
+            this.emit('taskCompleted', task);
+            this.saveState();
+        });
+        this.queue.on('taskFailed', (task) => {
+            this.logger.error(`Task failed: ${task.id} - ${task.error}`);
+            this.emit('taskFailed', task);
+            this.saveState();
+        });
+        this.queue.on('taskRetry', (task) => {
+            this.logger.warn(`Retrying task: ${task.id} (attempt ${task.attempts + 1})`);
+            this.emit('taskRetry', task);
+        });
+        this.queue.on('allComplete', (results) => {
+            this.isRunning = false;
+            this.client.stopAllMonitoring();
+            this.clearAllTimeouts();
+            this.logger.info('All tasks complete');
+            this.emit('complete', results);
+            this.stateStore?.clear();
+        });
+        this.client.on('completed', ({ agentId, ...agent }) => {
+            this.handleAgentComplete(agentId, agent);
+        });
+        this.client.on('failed', ({ agentId, ...agent }) => {
+            const errorMsg = agent.summary || 'Agent failed';
+            this.handleAgentFailed(agentId, errorMsg);
+        });
+        this.client.on('cancelled', ({ agentId }) => {
+            this.handleAgentFailed(agentId, 'Agent was stopped');
+        });
+        this.client.on('error', ({ agentId, error }) => {
+            this.logger.error(`Agent ${agentId} error: ${error.message}`);
+        });
+    }
+    loadTasks(templateName, tasks) {
+        this.templateName = templateName;
+        this.queue.addTasks(tasks);
+        const completedCount = tasks.filter(t => t.complete).length;
+        const activeCount = tasks.length - completedCount;
+        this.logger.info(`Loaded ${tasks.length} tasks from "${templateName}"${completedCount > 0 ? ` (${completedCount} already completed, ${activeCount} active)` : ''}`);
+    }
+    async start() {
+        if (this.isRunning)
+            throw new Error('Orchestrator is already running');
+        this.isRunning = true;
+        this.logger.info('Starting orchestration...');
+        this.emit('started', this.queue.getStatus());
+        await this.saveState();
+        await this.trySpawnAgents();
+    }
+    async trySpawnAgents() {
+        if (!this.isRunning)
+            return;
+        const availableSlots = this.options.config.maxConcurrent - this.activeAgents.size;
+        if (availableSlots <= 0)
+            return;
+        const readyTasks = this.queue.getReadyTasks().slice(0, availableSlots);
+        for (const task of readyTasks) {
+            try {
+                await this.spawnAgent(task);
+            }
+            catch (error) {
+                this.logger.error(`Failed to spawn agent for ${task.id}: ${error}`);
+                this.queue.markFailed(task.id, error.message);
+            }
+        }
+    }
+    async spawnAgent(task) {
+        const prompt = this.buildPrompt(task);
+        this.logger.info(`Spawning agent for task: ${task.id}`);
+        const agent = await this.client.createAgent({
+            prompt,
+            repository: this.options.repository,
+            branchName: task.branch || `task/${task.id}`,
+            ref: this.options.baseBranch,
+            autoCreatePr: true,
+        });
+        this.activeAgents.set(agent.id, task.id);
+        this.queue.markRunning(task.id, agent.id);
+        this.client.startMonitoring(agent.id, this.options.config.pollInterval);
+        const timeout = task.timeout || this.options.config.defaultTimeout;
+        const timer = setTimeout(() => {
+            if (!this.activeAgents.has(agent.id))
+                return;
+            this.logger.warn(`Task ${task.id} timed out`);
+            this.client.stopAgent(agent.id).catch(() => { });
+            this.handleAgentFailed(agent.id, 'Timeout exceeded');
+        }, timeout);
+        this.timeouts.set(agent.id, timer);
+        this.emit('agentSpawned', { taskId: task.id, agentId: agent.id });
+        await this.saveState();
+    }
+    buildPrompt(task) {
+        const parts = [];
+        if (this.options.globalContext) {
+            parts.push(`## Global Instructions\n${this.options.globalContext}`);
+        }
+        if (this.options.globalFiles?.length) {
+            parts.push(`## Reference Files\n${this.options.globalFiles.map(f => `- ${f}`).join('\n')}`);
+        }
+        // Add dependency context - reference previous agents' work
+        if (task.dependsOn.length > 0) {
+            const dependencyInfo = [];
+            for (const depId of task.dependsOn) {
+                const depTask = this.queue.getTask(depId);
+                if (depTask?.result) {
+                    const branchInfo = depTask.result.branch ? ` (branch: ${depTask.result.branch})` : '';
+                    const prInfo = depTask.result.pullRequestUrl ? `\n   PR: ${depTask.result.pullRequestUrl}` : '';
+                    dependencyInfo.push(`- **${depTask.name}**${branchInfo}${prInfo}`);
+                }
+                else if (depTask) {
+                    dependencyInfo.push(`- **${depTask.name}** (in progress)`);
+                }
+            }
+            if (dependencyInfo.length > 0) {
+                parts.push(`## Dependencies\nThis task depends on the following completed tasks:\n${dependencyInfo.join('\n')}\n\nPlease review the work from these dependencies before proceeding. If they created documentation or files, reference those in your work.`);
+            }
+        }
+        if (task.files?.length) {
+            parts.push(`## Task-Specific Files\n${task.files.map(f => `- ${f}`).join('\n')}`);
+        }
+        parts.push(`## Task\n${task.prompt}`);
+        if (task.validation) {
+            parts.push(`## Validation\nAfter completing the task, verify by running:\n\`${task.validation.command}\`\nExpected output should match: ${task.validation.successPattern}`);
+        }
+        return parts.join('\n\n');
+    }
+    handleAgentComplete(agentId, agent) {
+        const taskId = this.activeAgents.get(agentId);
+        if (!taskId)
+            return;
+        this.activeAgents.delete(agentId);
+        this.clearTimeout(agentId);
+        this.queue.markCompleted(taskId, {
+            branch: agent.target?.branchName,
+            pullRequestUrl: agent.target?.prUrl
+        });
+        this.trySpawnAgents();
+    }
+    handleAgentFailed(agentId, error) {
+        const taskId = this.activeAgents.get(agentId);
+        if (!taskId)
+            return;
+        this.activeAgents.delete(agentId);
+        this.clearTimeout(agentId);
+        this.client.stopMonitoring(agentId);
+        this.queue.markFailed(taskId, error);
+        this.trySpawnAgents();
+    }
+    clearTimeout(agentId) {
+        const timer = this.timeouts.get(agentId);
+        if (!timer)
+            return;
+        clearTimeout(timer);
+        this.timeouts.delete(agentId);
+    }
+    clearAllTimeouts() {
+        for (const timer of this.timeouts.values())
+            clearTimeout(timer);
+        this.timeouts.clear();
+    }
+    async saveState() {
+        if (!this.stateStore)
+            return;
+        const tasks = this.queue.getAllTasks().map(t => ({
+            id: t.id,
+            name: t.name,
+            status: t.status,
+            agentId: t.agentId,
+            attempts: t.attempts,
+            error: t.error,
+            result: t.result,
+        }));
+        const state = {
+            templateName: this.templateName,
+            startedAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            repository: this.options.repository,
+            tasks,
+            activeAgents: Array.from(this.activeAgents.entries()).map(([agentId, taskId]) => ({ agentId, taskId })),
+        };
+        await this.stateStore.save(state);
+    }
+    async stop() {
+        this.isRunning = false;
+        this.client.stopAllMonitoring();
+        this.clearAllTimeouts();
+        for (const agentId of this.activeAgents.keys()) {
+            try {
+                await this.client.stopAgent(agentId);
+            }
+            catch {
+                // Ignore cancellation errors
+            }
+        }
+        this.logger.info('Orchestrator stopped');
+        this.emit('stopped', this.queue.getStatus());
+    }
+    getStatus() {
+        return {
+            isRunning: this.isRunning,
+            queue: this.queue.getStatus(),
+            activeAgents: Array.from(this.activeAgents.entries()).map(([agentId, taskId]) => ({ agentId, taskId })),
+        };
+    }
+    async sendFollowUp(taskId, message) {
+        const task = this.queue.getTask(taskId);
+        if (!task?.agentId)
+            throw new Error(`No active agent for task ${taskId}`);
+        await this.client.sendFollowUp(task.agentId, message);
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/core/orchestrator.js.map

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

package/dist/core/task-queue.d.ts

@@ -0,0 +1,49 @@
+import { EventEmitter } from 'events';
+export interface Task {
+    id: string;
+    name: string;
+    prompt: string;
+    dependsOn: string[];
+    priority: number;
+    branch?: string;
+    files?: string[];
+    timeout?: number;
+    retries?: number;
+    validation?: {
+        command: string;
+        successPattern: string;
+    };
+    complete?: boolean;
+    status: TaskStatus;
+    agentId?: string;
+    attempts: number;
+    error?: string;
+    result?: TaskResult;
+}
+export type TaskStatus = 'pending' | 'ready' | 'running' | 'completed' | 'failed';
+export interface TaskResult {
+    branch?: string;
+    pullRequestUrl?: string;
+    completedAt: string;
+}
+export type TaskInput = Omit<Task, 'status' | 'attempts' | 'agentId' | 'error' | 'result'>;
+export declare class TaskQueue extends EventEmitter {
+    private tasks;
+    private completed;
+    addTask(input: TaskInput): void;
+    addTasks(inputs: TaskInput[]): void;
+    private updateReadyTasks;
+    getReadyTasks(): Task[];
+    getTask(id: string): Task | undefined;
+    getAllTasks(): Task[];
+    markRunning(id: string, agentId: string): void;
+    markCompleted(id: string, result?: Partial<TaskResult>, checkComplete?: boolean): void;
+    markFailed(id: string, error: string, maxRetries?: number): void;
+    private checkAllComplete;
+    getResults(): {
+        completed: Task[];
+        failed: Task[];
+    };
+    getStatus(): Record<string, number>;
+    reset(): void;
+}