opencode-orchestrator 0.8.1 → 0.8.3

package/dist/index.js

@@ -233,52 +233,56 @@ EXECUTION FLOW:
 </phase_2_execute>
 
 <parallel_execution>
-\u26A1 MAXIMIZE PARALLELISM - This is CRITICAL!
+\u26A1 AGGRESSIVELY USE: Parallel Agents + Background Commands + Session Resume
 
-PATTERN 1: AGENT PARALLELISM
+\u{1F680} THESE 3 FEATURES ARE YOUR SUPERPOWERS - USE THEM!
+
+1\uFE0F\u20E3 PARALLEL AGENTS (Strongly Recommended)
+Launch multiple agents simultaneously for independent work:
 \`\`\`
-// GOOD \u2705 - Launch 3 agents at once
-${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.PLANNER}", prompt: "Research API", background: true })
-${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.PLANNER}", prompt: "Research DB", background: true })
-${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.PLANNER}", prompt: "Research Auth", background: true })
-// Then later: collect all results
-
-// BAD \u274C - Sequential when not needed
-${TOOL_NAMES.DELEGATE_TASK}({ ..., background: false }) // waits
-${TOOL_NAMES.DELEGATE_TASK}({ ..., background: false }) // waits
-${TOOL_NAMES.DELEGATE_TASK}({ ..., background: false }) // waits
+// 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: BACKGROUND COMMANDS
+2\uFE0F\u20E3 BACKGROUND COMMANDS (Strongly Recommended)
+Run slow shell commands without blocking:
 \`\`\`
-// GOOD \u2705 - Start build, continue working
-${TOOL_NAMES.RUN_BACKGROUND}({ command: "npm run build" }) \u2192 job_xxx
-// Continue with other work...
-${TOOL_NAMES.CHECK_BACKGROUND}({ taskId: "job_xxx" }) // Check later
-
-// BAD \u274C - Blocking on slow command
-bash("npm run build") // Blocks everything for 30+ seconds
+// 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: SESSION CONTINUITY
+3\uFE0F\u20E3 SESSION RESUME (Strongly Recommended)
+Preserve context across multiple interactions:
 \`\`\`
-// First call returns sessionID
-result = ${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.WORKER}", prompt: "Start feature", background: false })
-// Session: \`session_abc123\`
+// First task returns sessionID
+result = ${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.WORKER}", prompt: "Start feature" })
+// Session: session_abc123
 
-// Later: resume same session for follow-up
-${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.WORKER}", prompt: "Add tests", resume: "session_abc123" })
-// Preserves all context!
+// Later: continue with full context
+${TOOL_NAMES.DELEGATE_TASK}({ prompt: "Add tests to feature", resume: "session_abc123" })
 \`\`\`
 
-WHEN TO USE EACH:
-| Situation | Use |
-|-----------|-----|
-| Independent tasks (different files) | background=true, spawn ALL |
-| Sequential dependency (A\u2192B\u2192C) | background=false for chain |
-| Long shell command (>5sec) | ${TOOL_NAMES.RUN_BACKGROUND} |
-| Follow-up to previous work | resume: sessionID |
-| Final verification | 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>

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.1",
+  "version": "0.8.3",
   "author": "agnusdei1207",
   "license": "MIT",
   "repository": {