opencode-orchestrator 0.4.23 → 0.4.24

package/README.md

@@ -28,16 +28,17 @@ A **5-agent autonomous architecture** designed to solve complex engineering task
 
 **Core Philosophy**: Intelligence is a resource. We orchestrate that resource through **Phase-based Workflows** and **Mandatory Environment Scans** to ensure code always fits the project's infrastructure.
 
+> 🦀 **Powered by Rust** — Background tasks and parallel searches run on native Rust binaries for maximum performance.
+
 ### Key Features
-- **🎯 Autonomous Loop** — Commander runs relentlessly until mission is complete.
+- **🎯 Autonomous Loop** — Commander runs relentlessly until the mission is complete.
 - **🔍 Environment Scan** — Mandatory analysis of Infra (Docker/OS), Stack, and Domain before any code change.
 - **🔨 Smart Implementation** — Builder matches existing codebase patterns exactly.
 - **🛡️ Rigorous Audit** — Inspector proves success with environment-specific evidence (Builds/Tests/Logs).
 - **💾 Persistent Context** — Recorder saves session state to disk, enabling resume at any time.
 - **🏗️ Parallel Agents** — Delegated agent execution (`delegate_task`) with sync/async modes.
 - **⏳ Background Tasks** — Run long commands (builds, tests) in background and check results later.
- - **🔎 mgrep** — Multi-pattern parallel search for fast codebase analysis.
-- **🎯 Smart Batch** — Centralized validation and retry for efficient parallel processing. Dynamic concurrency limits with intelligent failure handling.
+- **🔎 mgrep** — Multi-pattern parallel search powered by Rust for blazing-fast codebase analysis.
 
 ---
 
@@ -58,8 +59,8 @@ Restart OpenCode after installation.
 In OpenCode, press `Tab` to open the Agent selection menu. Select **Commander** and type your mission!
 
 <div align="center">
-   <img src="assets/commander-screenshot.png" alt="Commander Screenshot" width="600" />
-   <p><em>Press Tab to select Commander</em></p>
+  <img src="assets/commander-screenshot.png" alt="Commander Screenshot" width="600" />
+  <p><em>Press Tab to select Commander</em></p>
 </div>
 
 ```
@@ -94,71 +95,164 @@ Trigger parallel agent execution with prompts like:
 
 Commander will automatically use `delegate_task` with `background: true` for independent tasks.
 
+**Parallel Execution UI**
+
+When tasks run in parallel, you'll see detailed progress in OpenCode:
+
+```
+## 🚀 BACKGROUND TASK SPAWNED
+
+**Task Details**
+- **ID**: `task_a1b2c3d4`
+- **Agent**: builder
+- **Description**: Implement authentication system
+- **Status**: ⏳ Running in background (non-blocking)
+
+**Active Tasks**
+- Running: 2
+- Pending: 1
+
+---
+
+**Monitoring Commands**
+
+Check progress anytime:
+- `list_tasks()` - View all parallel tasks
+- `get_task_result({ taskId: "task_a1b2c3d4" })` - Get latest result
+- `cancel_task({ taskId: "task_a1b2c3d4" })` - Stop this task
+
+---
+
+✓ System will notify when ALL tasks complete. You can continue working!
+```
+
+**Terminal Logs**
+
 Monitor parallel tasks in terminal:
 
 ```
-[parallel] 🚀 SPAWNED task_a1b2 → builder: Implement feature X
-[parallel] 🚀 SPAWNED task_c3d4 → inspector: Review module Y
-[parallel] ✅ COMPLETED task_c3d4 → inspector: Review module Y (45s)
-[parallel] 🗑️ CLEANED task_c3d4 (session deleted)
+[parallel] 🚀 SPAWNED task_a1b2c3d4 → builder: Implement authentication
+[parallel] 🚀 SPAWNED task_e5f6g7h8 → inspector: Review module
+[parallel] ✅ COMPLETED task_e5f6g7h8 → inspector: Review module (45s)
+[parallel] 🗑️ CLEANED task_e5f6g7h8 (session deleted)
 ```
 
-### 🎯 Smart Batch — Centralized Validation and Retry
+**All Tasks Complete**
 
-For processing many microtasks efficiently, use the Smart Batch approach:
+When all parallel tasks finish, you'll see:
 
-```bash
-# Use Smart Batch to process many tasks with intelligent validation
-process_batch({
-  concurrency: "10",
-  maxRetries: "2",
-  tasks: [
-    { id: "task1", agent: "builder", description: "Write API handler", prompt: "..." },
-    { id: "task2", agent: "inspector", description: "Review API code", prompt: "..." },
-    { id: "task3", agent: "architect", description: "Design database schema", prompt: "..." },
-    { id: "task4", agent: "recorder", description: "Document API", prompt: "..." }
-  ]
-})
 ```
+**All Parallel Tasks Complete**
 
-**Smart Batch Benefits**:
-| Benefit | Description |
-|---------|-------------|
-| **Speed** | 50% faster (1000 tasks: 200min → 150min) |
-| **Efficiency** | 30% fewer API calls (only retry failures) |
-| **Quality** | Centralized validation identifies all failures at once |
-| **Adaptive** | Dynamic concurrency (up to 10, unlimited with validation) |
+✅ `task_a1b2c3d4` (1m 30s): Implement authentication
+✅ `task_e5f6g7h8` (45s): Review module
 
-**Smart Batch Tools**:
-- `process_batch()` — Execute multiple tasks with intelligent validation
-- `export_failed_tasks()` — Export failed tasks for manual review
-- `compare_strategies()` — Compare naive vs smart batch performance
+---
 
-### 🔧 Configuration Management
+**Retrieval Options**
 
-Dynamic configuration for runtime tuning:
+Use `get_task_result({ taskId: "task_xxx" })` to retrieve full results.
 
-```bash
-# View current configuration
-show_config()
+---
+
+**Task Summary**
+
+Total Tasks: 2
+Status: All Complete
+Mode: Background (non-blocking)
+```
+"Build and test in parallel"
+"Implement feature X while reviewing module Y"
+"Run linting, tests, and build at the same time"
+```
+
+Commander will automatically use `delegate_task` with `background: true` for independent tasks.
 
-# Update concurrency limits
-set_concurrency({ agent: "builder", limit: 10 })
+**Parallel Execution UI**
 
-# Update timeouts
-set_timeout({ taskTtlMinutes: 45, cleanupDelayMinutes: 2 })
+When tasks run in parallel, you'll see detailed progress in OpenCode:
 
-# Toggle debug logging
-set_debug({ component: "parallel_agent", enable: true })
 ```
+╔════════════════════════════════════════════════════════════╗
+║  🚀 BACKGROUND TASK SPAWNED                                   ║
+╠═════════════════════════════════════════════════════════════╣
+║  Task ID:     task_a1b2c3d4                                 ║
+║  Agent:       builder                                           ║
+║  Description: Implement authentication system                       ║
+║  Status:      ⏳ RUNNING (background)                          ║
+╠═════════════════════════════════════════════════════════════╣
+║  Running: 2     │ Pending: 1                                 ║
+╚══════════════════════════════════════════════════════════════╝
+
+---
+
+**Parallel Execution Started**
+
+- 📌 Task ID: `task_a1b2c3d4`
+- 🤖 Agent: builder
+- 📝 Description: Implement authentication system
+- ⏳ Status: Running in background (non-blocking)
+- 🔄 Active Tasks: 2 running, 1 pending
 
-**Environment Variables**:
-- `OPENCODE_TASK_TTL_MS` — Task timeout (default: 30min)
-- `OPENCODE_CLEANUP_DELAY_MS` — Cleanup delay (default: 5min)
-- `OPENCODE_DEFAULT_CONCURRENCY` — Default parallelism (default: 3)
-- `OPENCODE_MAX_CONCURRENCY` — Max parallelism (default: 10)
-- `OPENCODE_DEBUG_PARALLEL` — Enable debug logs
-- `OPENCODE_DEBUG_BACKGROUND` — Enable debug logs
+**Monitoring**
+
+Check progress anytime with:
+- `list_tasks()` - View all parallel tasks
+- `get_task_result({ taskId: "task_a1b2c3d4" })` - Get latest result
+- `cancel_task({ taskId: "task_a1b2c3d4" })` - Stop this task
+
+System will notify when ALL tasks complete. You can continue working!
+```
+
+**Terminal Logs**
+
+Monitor parallel tasks in terminal:
+
+```
+[parallel] 🚀 SPAWNED task_a1b2c3d4 → builder: Implement authentication
+[parallel] 🚀 SPAWNED task_e5f6g7h8 → inspector: Review module
+[parallel] ✅ COMPLETED task_e5f6g7h8 → inspector: Review module (45s)
+[parallel] 🗑️ CLEANED task_e5f6g7h8 (session deleted)
+```
+
+**All Tasks Complete**
+
+When all parallel tasks finish, you'll see:
+
+```
+**All Parallel Tasks Complete**
+
+✅ `task_a1b2c3d4` (1m 30s): Implement authentication
+✅ `task_e5f6g7h8` (45s): Review module
+
+---
+
+**Retrieval Options**
+
+Use `get_task_result({ taskId: "task_xxx" })` to retrieve full results.
+
+---
+
+**Task Summary**
+
+Total Tasks: 2
+Status: All Complete
+Mode: Background (non-blocking)
+```
+"Build and test in parallel"
+"Implement feature X while reviewing module Y"
+"Run linting, tests, and build at the same time"
+```
+
+Commander will automatically use `delegate_task` with `background: true` for independent tasks.
+
+Monitor parallel tasks in the terminal:
+```
+[parallel] 🚀 SPAWNED task_a1b2 → builder: Implement feature X
+[parallel] 🚀 SPAWNED task_c3d4 → inspector: Review module Y
+[parallel] ✅ COMPLETED task_c3d4 → inspector: Review module Y (45s)
+[parallel] 🗑️ CLEANED task_c3d4 (session deleted)
+```
 
 ---
 

package/dist/agents/coder.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "./types.js";
+export declare const coder: AgentDefinition;

package/dist/agents/fixer.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "./types.js";
+export declare const fixer: AgentDefinition;

package/dist/agents/names.d.ts

@@ -0,0 +1,12 @@
+export declare const AGENT_NAMES: {
+    readonly ORCHESTRATOR: "orchestrator";
+    readonly PLANNER: "planner";
+    readonly CODER: "coder";
+    readonly REVIEWER: "reviewer";
+    readonly SEARCHER: "searcher";
+    readonly SURGEON: "surgeon";
+    readonly EXECUTOR: "executor";
+    readonly VISUALIST: "visualist";
+    readonly PUBLISHER: "publisher";
+};
+export type AgentName = typeof AGENT_NAMES[keyof typeof AGENT_NAMES];

package/dist/agents/planner.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "./types.js";
+export declare const planner: AgentDefinition;

package/dist/agents/reviewer.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "./types.js";
+export declare const reviewer: AgentDefinition;

package/dist/agents/searcher.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "./types.js";
+export declare const searcher: AgentDefinition;

package/dist/agents/subagents/coder.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "../../shared/contracts/interfaces.js";
+export declare const coder: AgentDefinition;

package/dist/agents/subagents/executor.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "../../shared/contracts/interfaces.js";
+export declare const executor: AgentDefinition;

package/dist/agents/subagents/fixer.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "../../shared/contracts/interfaces.js";
+export declare const fixer: AgentDefinition;

package/dist/agents/subagents/memory.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "../../shared/contracts/interfaces.js";
+export declare const memory: AgentDefinition;

package/dist/agents/subagents/planner.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "../../shared/contracts/interfaces.js";
+export declare const planner: AgentDefinition;

package/dist/agents/subagents/publisher.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "../../shared/contracts/interfaces.js";
+export declare const publisher: AgentDefinition;

package/dist/agents/subagents/reviewer.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "../../shared/contracts/interfaces.js";
+export declare const reviewer: AgentDefinition;

package/dist/agents/subagents/searcher.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "../../shared/contracts/interfaces.js";
+export declare const searcher: AgentDefinition;

package/dist/agents/subagents/strategist.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "../../shared/contracts/interfaces.js";
+export declare const strategist: AgentDefinition;

package/dist/agents/subagents/surgeon.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "../../shared/contracts/interfaces.js";
+export declare const surgeon: AgentDefinition;

package/dist/agents/subagents/types.d.ts

@@ -0,0 +1,7 @@
+export interface AgentDefinition {
+    id: string;
+    description: string;
+    systemPrompt: string;
+    canWrite: boolean;
+    canBash: boolean;
+}

package/dist/agents/subagents/visualist.d.ts

@@ -0,0 +1,2 @@
+import { AgentDefinition } from "../../shared/contracts/interfaces.js";
+export declare const visualist: AgentDefinition;

package/dist/agents/types.d.ts

@@ -0,0 +1,7 @@
+export interface AgentDefinition {
+    id: string;
+    description: string;
+    systemPrompt: string;
+    canWrite: boolean;
+    canBash: boolean;
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/core/async-agent.d.ts

@@ -70,21 +70,9 @@ export declare class ParallelAgentManager {
      */
     getResult(taskId: string): Promise<string | null>;
     /**
-      * Set concurrency limit for agent type
-      */
+     * Set concurrency limit for agent type
+     */
     setConcurrencyLimit(agentType: string, limit: number): void;
-    /**
-      * Get concurrency statistics for all agent types
-      */
-    getConcurrencyStats(): Record<string, {
-        running: number;
-        queued: number;
-        limit: number;
-    }>;
-    /**
-      * Update concurrency limit dynamically at runtime
-      */
-    updateConcurrency(agentType: string, newLimit: number): void;
     /**
      * Get pending notification count
      */

package/dist/core/background.d.ts

@@ -8,7 +8,6 @@ import { ChildProcess } from "child_process";
 export type TaskStatus = "pending" | "running" | "done" | "error" | "timeout";
 export interface BackgroundTask {
     id: string;
-    sessionID?: string;
     command: string;
     args: string[];
     cwd: string;
@@ -27,45 +26,17 @@ export interface RunBackgroundOptions {
     cwd?: string;
     timeout?: number;
     label?: string;
-    sessionID?: string;
 }
 declare class BackgroundTaskManager {
     private static _instance;
     private tasks;
     private debugMode;
-    private storageDir;
-    private storageFile;
-    private monitoringInterval?;
     private constructor();
     static get instance(): BackgroundTaskManager;
     /**
      * Generate a unique task ID in the format job_xxxxxxxx
      */
     private generateId;
-    /**
-     * Ensure storage directory exists
-     */
-    private ensureStorageDir;
-    /**
-     * Load tasks from disk on startup
-     */
-    private loadFromDisk;
-    /**
-     * Save tasks to disk
-     */
-    private saveToDisk;
-    /**
-     * Start periodic monitoring of running processes
-     */
-    private startMonitoring;
-    /**
-     * Stop monitoring
-     */
-    private stopMonitoring;
-    /**
-     * Monitor running processes and detect zombie processes
-     */
-    private monitorRunningProcesses;
     /**
      * Debug logging helper
      */
@@ -86,10 +57,6 @@ declare class BackgroundTaskManager {
      * Get tasks by status
      */
     getByStatus(status: TaskStatus): BackgroundTask[];
-    /**
-     * Clean up tasks by session ID
-     */
-    cleanupBySession(sessionID: string): number;
     /**
      * Clear completed/failed tasks
      */

package/dist/core/tasks.d.ts

@@ -7,7 +7,6 @@ export interface Task {
     description: string;
     action: string;
     file: string;
-    agent: string;
     dependencies: string[];
     status: TaskStatus;
     result?: string;

package/dist/index.d.ts

@@ -82,14 +82,12 @@ declare const OrchestratorPlugin: (input: PluginInput) => Promise<{
                 cwd: import("zod").ZodOptional<import("zod").ZodString>;
                 timeout: import("zod").ZodOptional<import("zod").ZodNumber>;
                 label: import("zod").ZodOptional<import("zod").ZodString>;
-                sessionID: import("zod").ZodOptional<import("zod").ZodString>;
             };
             execute(args: {
                 command: string;
                 cwd?: string | undefined;
                 timeout?: number | undefined;
                 label?: string | undefined;
-                sessionID?: string | undefined;
             }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
         };
         check_background: {
@@ -139,7 +137,8 @@ declare const OrchestratorPlugin: (input: PluginInput) => Promise<{
         output: string;
         metadata: any;
     }) => Promise<void>;
-    event: (input: {
+    "assistant.done": (assistantInput: any, assistantOutput: any) => Promise<void>;
+    handler: ({ event }: {
         event: {
             type: string;
             properties?: unknown;