opencode-orchestrator 0.8.2 → 0.8.4

package/dist/core/agents/consts/task-status.const.d.ts

@@ -1,5 +1,5 @@
 /**
- * TASK_STATUS - Task status constants
+ * TASK_STATUS - Task status constants (for parallel tasks)
  */
 export declare const TASK_STATUS: {
     readonly PENDING: "pending";
@@ -10,3 +10,12 @@ export declare const TASK_STATUS: {
     readonly TIMEOUT: "timeout";
     readonly CANCELLED: "cancelled";
 };
+/**
+ * TODO_STATUS - Todo item status constants
+ */
+export declare const TODO_STATUS: {
+    readonly PENDING: "pending";
+    readonly IN_PROGRESS: "in_progress";
+    readonly COMPLETED: "completed";
+    readonly CANCELLED: "cancelled";
+};

package/dist/core/loop/formatters.d.ts

@@ -8,6 +8,7 @@ import type { Todo } from "./interfaces.js";
 export declare function formatProgress(todos: Todo[]): string;
 /**
  * Generate continuation prompt when todos remain
+ * Enforces parallel dispatch when multiple independent tasks exist
  */
 export declare function generateContinuationPrompt(todos: Todo[]): string;
 /**

package/dist/index.js

@@ -30,6 +30,12 @@ var TASK_STATUS = {
   TIMEOUT: "timeout",
   CANCELLED: "cancelled"
 };
+var TODO_STATUS = {
+  PENDING: "pending",
+  IN_PROGRESS: "in_progress",
+  COMPLETED: "completed",
+  CANCELLED: "cancelled"
+};
 
 // src/shared/constants.ts
 var TIME = {
@@ -233,39 +239,56 @@ EXECUTION FLOW:
 </phase_2_execute>
 
 <parallel_execution>
-\u26A1 USE PARALLELISM WHEN APPROPRIATE
+\u26A1 AGGRESSIVELY USE: Parallel Agents + Background Commands + Session Resume
 
-DECIDE: Parallel vs Sequential
-- Tasks that DON'T depend on each other \u2192 background=true (parallel)
-- Task B needs Task A's output \u2192 background=false (sequential)
-- Model should judge based on task dependencies
+\u{1F680} THESE 3 FEATURES ARE YOUR SUPERPOWERS - USE THEM!
 
-PATTERN 1: PARALLEL AGENTS (when tasks are independent)
+1\uFE0F\u20E3 PARALLEL AGENTS (Strongly Recommended)
+Launch multiple agents simultaneously for independent work:
 \`\`\`
-// Good for INDEPENDENT tasks (different files, no shared state)
-${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.WORKER}", prompt: "Create file A", background: true })
-${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.WORKER}", prompt: "Create file B", background: true })
+// Research multiple topics at once
+${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.PLANNER}", prompt: "Research React docs", background: true })
+${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.PLANNER}", prompt: "Research API patterns", background: true })
+${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.PLANNER}", prompt: "Research testing libs", background: true })
+// \u2192 3x faster than sequential!
+
+// Create multiple files at once
+${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.WORKER}", prompt: "Create component A", background: true })
+${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.WORKER}", prompt: "Create component B", background: true })
 \`\`\`
 
-PATTERN 2: SEQUENTIAL (when order matters)
+2\uFE0F\u20E3 BACKGROUND COMMANDS (Strongly Recommended)
+Run slow shell commands without blocking:
 \`\`\`
-// Good for DEPENDENT tasks (output feeds next input)
-result1 = ${TOOL_NAMES.DELEGATE_TASK}({ ..., background: false })
-result2 = ${TOOL_NAMES.DELEGATE_TASK}({ prompt: "Use result1", background: false })
+// Start build, keep working
+${TOOL_NAMES.RUN_BACKGROUND}({ command: "npm run build", description: "Building..." })
+// ...continue with other work...
+${TOOL_NAMES.CHECK_BACKGROUND}({ taskId: "xxx" }) // check when needed
 \`\`\`
 
-PATTERN 3: BACKGROUND COMMANDS (for slow operations)
+3\uFE0F\u20E3 SESSION RESUME (Strongly Recommended)
+Preserve context across multiple interactions:
 \`\`\`
-${TOOL_NAMES.RUN_BACKGROUND}({ command: "npm run build" }) // non-blocking
+// First task returns sessionID
+result = ${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.WORKER}", prompt: "Start feature" })
+// Session: session_abc123
+
+// Later: continue with full context
+${TOOL_NAMES.DELEGATE_TASK}({ prompt: "Add tests to feature", resume: "session_abc123" })
 \`\`\`
 
-DECISION GUIDE:
-| Scenario | Use |
-|----------|-----|
-| Editing 3 unrelated files | background=true for each |
-| Step A \u2192 B \u2192 C chain | background=false (sequential) |
-| Build while coding | ${TOOL_NAMES.RUN_BACKGROUND} |
-| Need result immediately | background=false |
+\u{1F4CB} SYNC STRATEGY (When to wait)
+- Use background=false ONLY when: next task needs THIS task's output
+- Collect results with ${TOOL_NAMES.GET_TASK_RESULT} before dependent work
+- Use ${TOOL_NAMES.LIST_TASKS} to monitor all parallel tasks
+
+| Task Type | Approach |
+|-----------|----------|
+| Research/Exploration | PARALLEL - spawn multiple Planners |
+| File creation (different files) | PARALLEL - spawn multiple Workers |
+| Build/Test/Install | BACKGROUND - use run_background |
+| Sequential chain (A\u2192B\u2192C) | SYNC - background=false |
+| Follow-up to previous work | RESUME - use sessionID |
 </parallel_execution>
 
 <agents>
@@ -16312,19 +16335,21 @@ function formatProgress(todos) {
 }
 function generateContinuationPrompt(todos) {
   const incomplete = todos.filter(
-    (t) => t.status !== "completed" && t.status !== "cancelled"
+    (t) => t.status !== TODO_STATUS.COMPLETED && t.status !== TODO_STATUS.CANCELLED
   );
   if (incomplete.length === 0) {
     return "";
   }
   const next = getNextPending(todos);
+  const pendingTasks = incomplete.filter((t) => t.status === TODO_STATUS.PENDING);
+  const pendingCount = pendingTasks.length;
   let prompt = `<todo_continuation>
 \u{1F4CB} **TODO Progress**: ${formatProgress(todos)}
 
 **Incomplete Tasks** (${incomplete.length} remaining):
 `;
   for (const todo of incomplete.slice(0, 5)) {
-    const status = todo.status === "in_progress" ? "\u{1F504}" : "\u23F3";
+    const status = todo.status === TODO_STATUS.IN_PROGRESS ? "\u{1F504}" : "\u23F3";
     const priority = todo.priority === "high" ? "\u{1F534}" : todo.priority === "medium" ? "\u{1F7E1}" : "\u{1F7E2}";
     prompt += `${status} ${priority} [${todo.id}] ${todo.content}
 `;
@@ -16333,13 +16358,33 @@ function generateContinuationPrompt(todos) {
     prompt += `... and ${incomplete.length - 5} more
 `;
   }
-  prompt += `
+  if (pendingCount >= 2) {
+    prompt += `
+\u26A1 **PARALLEL DISPATCH REQUIRED** \u26A1
+You have ${pendingCount} pending tasks. Launch them ALL IN PARALLEL for maximum efficiency:
+
+\`\`\`
+// EXECUTE NOW - Launch all ${pendingCount} tasks simultaneously:
+`;
+    for (const todo of pendingTasks.slice(0, 6)) {
+      prompt += `delegate_task({ agent: "Worker", prompt: "${todo.content}", background: true })
+`;
+    }
+    prompt += `\`\`\`
+
+\u26A0\uFE0F Do NOT run these sequentially. Use background=true for ALL.
+After launching, use list_tasks to monitor progress.
+
+`;
+  } else {
+    prompt += `
 **Action Required**:
 1. Continue working on incomplete todos
 2. Mark each task complete when finished
 3. Do NOT stop until all todos are completed or cancelled
 
 `;
+  }
   if (next) {
     prompt += `**Next Task**: [${next.id}] ${next.content}
 `;

package/dist/shared/constants.d.ts

@@ -129,7 +129,7 @@ export declare const PROMPTS: {
     readonly CONTINUE_DEFAULT: "continue from where we left off";
 };
 export { AGENT_NAMES } from "./agent.js";
-export { TASK_STATUS } from "../core/agents/consts/task-status.const.js";
+export { TASK_STATUS, TODO_STATUS } from "../core/agents/consts/task-status.const.js";
 export type { ParallelTaskStatus } from "../core/agents/types/parallel-task-status.type.js";
 export declare const STATUS_EMOJI: {
     readonly pending: "⏳";

package/package.json

@@ -2,7 +2,7 @@
   "name": "opencode-orchestrator",
   "displayName": "OpenCode Orchestrator",
   "description": "Distributed Cognitive Architecture for OpenCode. Turns simple prompts into specialized multi-agent workflows (Planner, Coder, Reviewer).",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "author": "agnusdei1207",
   "license": "MIT",
   "repository": {