opencode-orchestrator 0.8.13 β 0.8.14
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.
- package/README.md +76 -64
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -30,97 +30,109 @@ Multi-agent system that autonomously executes complex tasks. Commander delegates
|
|
|
30
30
|
|
|
31
31
|
## ποΈ Architecture Overview
|
|
32
32
|
|
|
33
|
-
### π User Flow
|
|
33
|
+
### π User Flow: Real Scenario
|
|
34
|
+
|
|
35
|
+
> **Example:** `/task "Build a REST API with user authentication"`
|
|
34
36
|
|
|
35
37
|
```
|
|
36
38
|
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
37
|
-
β
|
|
38
|
-
β /task "Build a REST API" β
|
|
39
|
+
β π€ USER: /task "Build a REST API with user authentication" β
|
|
39
40
|
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
40
41
|
β
|
|
41
42
|
βΌ
|
|
42
43
|
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
43
|
-
β
|
|
44
|
-
β
|
|
45
|
-
β
|
|
46
|
-
β
|
|
47
|
-
β β
|
|
48
|
-
β β
|
|
49
|
-
β
|
|
44
|
+
β π― COMMANDER (Master Session) β
|
|
45
|
+
β β
|
|
46
|
+
β "I'll break this into parallel tasks and delegate to specialized agents" β
|
|
47
|
+
β β
|
|
48
|
+
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
|
|
49
|
+
β β π Creates TODO.md: β β
|
|
50
|
+
β β - [ ] Research: Express.js + JWT best practices β β
|
|
51
|
+
β β - [ ] Setup: Project structure + dependencies β β
|
|
52
|
+
β β - [ ] Implement: User model + auth routes β β
|
|
53
|
+
β β - [ ] Test: API endpoints verification β β
|
|
54
|
+
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
|
|
50
55
|
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
51
56
|
β
|
|
57
|
+
ββββββββββββββββββββββββββΌβββββββββββββββββββββββββ
|
|
58
|
+
β β β
|
|
59
|
+
βΌ βΌ βΌ
|
|
60
|
+
|
|
61
|
+
βββββββββββββββββββββ βββββββββββββββββββββ βββββββββββββββββββββ
|
|
62
|
+
β π PLANNER β β π¨ WORKER #1 β β π¨ WORKER #2 β
|
|
63
|
+
β Session: ses_001 β β Session: ses_002 β β Session: ses_003 β
|
|
64
|
+
β ββββββββββββββββββββ£ β ββββββββββββββββββββ£ β ββββββββββββββββββββ£
|
|
65
|
+
β Research Express β β Create src/ β β Write auth.ts β
|
|
66
|
+
β + JWT docs β β Setup package.jsonβ β + user.model.ts β
|
|
67
|
+
β β β β β β
|
|
68
|
+
β π₯ websearch() β β π₯ write files β β π₯ write files β
|
|
69
|
+
β οΏ½ cache_docs() β β οΏ½ run_background β β β
|
|
70
|
+
βββββββββββββββββββββ β β npm install β βββββββββββββββββββββ
|
|
71
|
+
β βββββββββββββββββββββ β
|
|
72
|
+
β β β
|
|
73
|
+
β β‘ ALL RUN IN PARALLEL (async: true) β
|
|
74
|
+
β β±οΈ Commander monitors, doesn't wait β
|
|
75
|
+
ββββββββββββββββββββββββββΌβββββββββββββββββββββββ
|
|
52
76
|
βΌ
|
|
53
77
|
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
54
|
-
β
|
|
78
|
+
β π BACKGROUND PROCESSES β
|
|
55
79
|
β β
|
|
56
|
-
β
|
|
57
|
-
β
|
|
58
|
-
β
|
|
59
|
-
β
|
|
60
|
-
β
|
|
80
|
+
β βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ β
|
|
81
|
+
β β npm install β β npm run build β β npm test β β
|
|
82
|
+
β β (bg_cmd_001) β β (bg_cmd_002) β β (bg_cmd_003) β β
|
|
83
|
+
β β β³ running... β β β³ running... β β β³ pending... β β
|
|
84
|
+
β βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ β
|
|
61
85
|
β β
|
|
62
|
-
β
|
|
63
|
-
β
|
|
64
|
-
β β’ π TodoContinuation (auto-resume on idle) β
|
|
65
|
-
β β’ ποΈ MissionSealHandler (completion detection) β
|
|
66
|
-
β β’ π£ TaskToastManager (consolidated notifications) β
|
|
86
|
+
β β’ Check with: check_background / list_background β
|
|
87
|
+
β β’ Non-blocking: Commander continues other work β
|
|
67
88
|
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
68
89
|
β
|
|
69
|
-
delegate_task (background: true)
|
|
70
|
-
β
|
|
71
|
-
ββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββ
|
|
72
|
-
βΌ βΌ βΌ
|
|
73
|
-
ββββββββββββββββββββββ ββββββββββββββββββββββ ββββββββββββββββββββββ
|
|
74
|
-
β β‘ Worker Session 1 β β β‘ Worker Session 2 β β β‘ Worker Session N β
|
|
75
|
-
β Agent: Planner β β Agent: Worker β β Agent: Reviewer β
|
|
76
|
-
ββββββββββββββββββββββ€ ββββββββββββββββββββββ€ ββββββββββββββββββββββ€
|
|
77
|
-
β β’ Independent exec β β β’ Independent exec β β β’ Read/Write β
|
|
78
|
-
β β’ Read/Write β β β’ Read/Write β β .opencode/ β
|
|
79
|
-
β .opencode/ β β .opencode/ β β β’ Notify parent β
|
|
80
|
-
β β’ Notify parent β β β’ Notify parent β β on complete β
|
|
81
|
-
β on complete β β on complete β ββββββββββββββββββββββ
|
|
82
|
-
ββββββββββββββββββββββ ββββββββββββββββββββββ
|
|
83
|
-
β β β
|
|
84
|
-
ββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββ
|
|
85
90
|
βΌ
|
|
86
91
|
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
87
|
-
β
|
|
92
|
+
β π ASYNC RESULT COLLECTION β
|
|
88
93
|
β β
|
|
89
|
-
β
|
|
94
|
+
β get_task_result("ses_001") βββΆ β
Planner done: "Found JWT patterns..." β
|
|
95
|
+
β get_task_result("ses_002") βββΆ β
Worker #1 done: "Project setup complete" β
|
|
96
|
+
β get_task_result("ses_003") βββΆ β³ Still running... β
|
|
90
97
|
β β
|
|
91
|
-
β
|
|
92
|
-
β π Progress is tracked via todo.md checkboxes β
|
|
98
|
+
β Commander: "Worker #2 still working, I'll delegate review task meanwhile" β
|
|
93
99
|
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
94
100
|
β
|
|
95
101
|
βΌ
|
|
102
|
+
βββββββββββββββββββββ
|
|
103
|
+
β β
REVIEWER β
|
|
104
|
+
β Session: ses_004 β
|
|
105
|
+
β ββββββββββββββββββββ£
|
|
106
|
+
β Verify endpoints β
|
|
107
|
+
β Update TODO.md: β
|
|
108
|
+
β - [x] Research β β
|
|
109
|
+
β - [x] Setup β β
|
|
110
|
+
β - [x] Implement ββ
|
|
111
|
+
β - [x] Test β β
|
|
112
|
+
βββββββββββββββββββββ
|
|
113
|
+
β
|
|
114
|
+
βΌ
|
|
96
115
|
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
97
|
-
β
|
|
116
|
+
β ποΈ MISSION COMPLETE β
|
|
98
117
|
β β
|
|
99
|
-
β
|
|
100
|
-
β
|
|
101
|
-
β
|
|
102
|
-
β
|
|
103
|
-
β
|
|
104
|
-
β β β βΌ βΌ β β
|
|
105
|
-
β β β [Seal Found] [Not Found] β β
|
|
106
|
-
β β β β β β β
|
|
107
|
-
β β β βΌ βΌ β β
|
|
108
|
-
β β β β
Mission Complete iteration < max? β β
|
|
109
|
-
β β β Clear state β β β
|
|
110
|
-
β β β ββββββββ΄βββββββ β β
|
|
111
|
-
β β β βΌ βΌ β β
|
|
112
|
-
β β β [YES] [NO] β β
|
|
113
|
-
β β β β β β β
|
|
114
|
-
β β β βΌ βΌ β β
|
|
115
|
-
β β β 3s countdown toast β οΈ Max iterations β β
|
|
116
|
-
β β β Inject continuation Force stop β β
|
|
117
|
-
β β β β β β
|
|
118
|
-
β β ββββββββββββββββββββββββββββ β β
|
|
119
|
-
β β LOOP β β
|
|
120
|
-
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
|
|
118
|
+
β Commander: "All TODOs checked. Mission complete." β
|
|
119
|
+
β β
|
|
120
|
+
β Output: <mission_seal>SEALED</mission_seal> β
|
|
121
|
+
β β
|
|
122
|
+
β β
Session cleanup β Resources freed β Ready for next mission β
|
|
121
123
|
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
122
124
|
```
|
|
123
125
|
|
|
126
|
+
**Key Concepts Visualized:**
|
|
127
|
+
|
|
128
|
+
| Concept | How It Works |
|
|
129
|
+
|---------|--------------|
|
|
130
|
+
| **Session** | Each agent runs in isolated session (ses_001, ses_002...) |
|
|
131
|
+
| **Parallel Agents** | Multiple Workers execute simultaneously, not sequentially |
|
|
132
|
+
| **Background Commands** | Long-running commands (npm install) don't block agents |
|
|
133
|
+
| **Async Collection** | Commander polls results, continues work while waiting |
|
|
134
|
+
| **Auto-Continue** | If TODOs remain, loop continues until all `[x]` checked |
|
|
135
|
+
|
|
124
136
|
### π Project Architecture
|
|
125
137
|
|
|
126
138
|
```
|
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.
|
|
5
|
+
"version": "0.8.14",
|
|
6
6
|
"author": "agnusdei1207",
|
|
7
7
|
"license": "MIT",
|
|
8
8
|
"repository": {
|