opencode-orchestrator 0.8.2 → 0.8.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/index.js +39 -22
  2. package/package.json +1 -1
package/dist/index.js CHANGED
@@ -233,39 +233,56 @@ EXECUTION FLOW:
233
233
  </phase_2_execute>
234
234
 
235
235
  <parallel_execution>
236
- \u26A1 USE PARALLELISM WHEN APPROPRIATE
236
+ \u26A1 AGGRESSIVELY USE: Parallel Agents + Background Commands + Session Resume
237
237
 
238
- DECIDE: Parallel vs Sequential
239
- - Tasks that DON'T depend on each other \u2192 background=true (parallel)
240
- - Task B needs Task A's output \u2192 background=false (sequential)
241
- - Model should judge based on task dependencies
238
+ \u{1F680} THESE 3 FEATURES ARE YOUR SUPERPOWERS - USE THEM!
242
239
 
243
- PATTERN 1: PARALLEL AGENTS (when tasks are independent)
240
+ 1\uFE0F\u20E3 PARALLEL AGENTS (Strongly Recommended)
241
+ Launch multiple agents simultaneously for independent work:
244
242
  \`\`\`
245
- // Good for INDEPENDENT tasks (different files, no shared state)
246
- ${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.WORKER}", prompt: "Create file A", background: true })
247
- ${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.WORKER}", prompt: "Create file B", background: true })
243
+ // Research multiple topics at once
244
+ ${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.PLANNER}", prompt: "Research React docs", background: true })
245
+ ${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.PLANNER}", prompt: "Research API patterns", background: true })
246
+ ${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.PLANNER}", prompt: "Research testing libs", background: true })
247
+ // \u2192 3x faster than sequential!
248
+
249
+ // Create multiple files at once
250
+ ${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.WORKER}", prompt: "Create component A", background: true })
251
+ ${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.WORKER}", prompt: "Create component B", background: true })
248
252
  \`\`\`
249
253
 
250
- PATTERN 2: SEQUENTIAL (when order matters)
254
+ 2\uFE0F\u20E3 BACKGROUND COMMANDS (Strongly Recommended)
255
+ Run slow shell commands without blocking:
251
256
  \`\`\`
252
- // Good for DEPENDENT tasks (output feeds next input)
253
- result1 = ${TOOL_NAMES.DELEGATE_TASK}({ ..., background: false })
254
- result2 = ${TOOL_NAMES.DELEGATE_TASK}({ prompt: "Use result1", background: false })
257
+ // Start build, keep working
258
+ ${TOOL_NAMES.RUN_BACKGROUND}({ command: "npm run build", description: "Building..." })
259
+ // ...continue with other work...
260
+ ${TOOL_NAMES.CHECK_BACKGROUND}({ taskId: "xxx" }) // check when needed
255
261
  \`\`\`
256
262
 
257
- PATTERN 3: BACKGROUND COMMANDS (for slow operations)
263
+ 3\uFE0F\u20E3 SESSION RESUME (Strongly Recommended)
264
+ Preserve context across multiple interactions:
258
265
  \`\`\`
259
- ${TOOL_NAMES.RUN_BACKGROUND}({ command: "npm run build" }) // non-blocking
266
+ // First task returns sessionID
267
+ result = ${TOOL_NAMES.DELEGATE_TASK}({ agent: "${AGENT_NAMES.WORKER}", prompt: "Start feature" })
268
+ // Session: session_abc123
269
+
270
+ // Later: continue with full context
271
+ ${TOOL_NAMES.DELEGATE_TASK}({ prompt: "Add tests to feature", resume: "session_abc123" })
260
272
  \`\`\`
261
273
 
262
- DECISION GUIDE:
263
- | Scenario | Use |
264
- |----------|-----|
265
- | Editing 3 unrelated files | background=true for each |
266
- | Step A \u2192 B \u2192 C chain | background=false (sequential) |
267
- | Build while coding | ${TOOL_NAMES.RUN_BACKGROUND} |
268
- | Need result immediately | background=false |
274
+ \u{1F4CB} SYNC STRATEGY (When to wait)
275
+ - Use background=false ONLY when: next task needs THIS task's output
276
+ - Collect results with ${TOOL_NAMES.GET_TASK_RESULT} before dependent work
277
+ - Use ${TOOL_NAMES.LIST_TASKS} to monitor all parallel tasks
278
+
279
+ | Task Type | Approach |
280
+ |-----------|----------|
281
+ | Research/Exploration | PARALLEL - spawn multiple Planners |
282
+ | File creation (different files) | PARALLEL - spawn multiple Workers |
283
+ | Build/Test/Install | BACKGROUND - use run_background |
284
+ | Sequential chain (A\u2192B\u2192C) | SYNC - background=false |
285
+ | Follow-up to previous work | RESUME - use sessionID |
269
286
  </parallel_execution>
270
287
 
271
288
  <agents>
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "opencode-orchestrator",
3
3
  "displayName": "OpenCode Orchestrator",
4
4
  "description": "Distributed Cognitive Architecture for OpenCode. Turns simple prompts into specialized multi-agent workflows (Planner, Coder, Reviewer).",
5
- "version": "0.8.2",
5
+ "version": "0.8.3",
6
6
  "author": "agnusdei1207",
7
7
  "license": "MIT",
8
8
  "repository": {