opencode-orchestrator 0.9.23 → 0.9.25
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 +60 -54
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -12,12 +12,6 @@
|
|
|
12
12
|
|
|
13
13
|
---
|
|
14
14
|
|
|
15
|
-
## 🔥 Why This Plugin?
|
|
16
|
-
|
|
17
|
-
**Budget models have limits. Orchestration breaks them.**
|
|
18
|
-
|
|
19
|
-
---
|
|
20
|
-
|
|
21
15
|
## ⚡ Quick Start
|
|
22
16
|
|
|
23
17
|
```bash
|
|
@@ -25,36 +19,53 @@ npm install -g opencode-orchestrator
|
|
|
25
19
|
```
|
|
26
20
|
|
|
27
21
|
Then in OpenCode:
|
|
28
|
-
|
|
29
22
|
```bash
|
|
30
23
|
/task "Build a REST API with authentication"
|
|
31
24
|
```
|
|
32
25
|
|
|
33
|
-
**Done.**
|
|
26
|
+
**Done.** AI agents plan, build, test, fix — and don't stop until it's sealed. ✨
|
|
27
|
+
|
|
28
|
+
> **Stop anytime:** `/stop`
|
|
34
29
|
|
|
35
30
|
---
|
|
36
31
|
|
|
37
|
-
##
|
|
32
|
+
## 🧠 Core Philosophy
|
|
38
33
|
|
|
39
|
-
|
|
34
|
+
> **Explore → Adapt → Act**
|
|
35
|
+
> *Never assume. Always verify. Then execute.*
|
|
40
36
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
37
|
+
```
|
|
38
|
+
┌───────────────────────────────────────────────────────────┐
|
|
39
|
+
│ │
|
|
40
|
+
│ 🔍 EXPLORE → 🔄 ADAPT → ⚡ ACT │
|
|
41
|
+
│ │
|
|
42
|
+
│ Discover Adjust to Execute with │
|
|
43
|
+
│ the reality what you find confidence │
|
|
44
|
+
│ │
|
|
45
|
+
└───────────────────────────────────────────────────────────┘
|
|
46
|
+
```
|
|
51
47
|
|
|
52
|
-
|
|
48
|
+
### Agents & Their Philosophy
|
|
53
49
|
|
|
50
|
+
| Agent | Role | Philosophy |
|
|
51
|
+
|:-----:|:-----|:-----------|
|
|
52
|
+
| 🎯 **Commander** | Orchestrator | Discover project → Delegate intelligently → Loop until sealed |
|
|
53
|
+
| 📋 **Planner** | Strategist | Research docs → Plan with parallelism → Document findings |
|
|
54
|
+
| 🔨 **Worker** | Implementer | Observe patterns → Learn conventions → Implement with fit |
|
|
55
|
+
| ✅ **Reviewer** | Gatekeeper | Read standards → Run tests → Approve with evidence |
|
|
54
56
|
|
|
55
|
-
|
|
57
|
+
### Guiding Principles
|
|
56
58
|
|
|
57
|
-
|
|
59
|
+
| Principle | Practice |
|
|
60
|
+
|:----------|:---------|
|
|
61
|
+
| 🔍 **Discover, Don't Assume** | Read `context.md`, detect tech stack, find build/test commands |
|
|
62
|
+
| 📚 **Evidence Over Memory** | Cite docs, run actual commands, complete only with proof |
|
|
63
|
+
| 🔄 **Adapt to the Project** | Match existing patterns, follow discovered conventions |
|
|
64
|
+
| 🤝 **Separation of Concerns** | Each agent does one thing excellently |
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## �️ Architecture
|
|
58
69
|
|
|
59
70
|
```
|
|
60
71
|
/task "Build REST API"
|
|
@@ -84,17 +95,32 @@ Then in OpenCode:
|
|
|
84
95
|
♻️ LOOP 🎖️ SEALED
|
|
85
96
|
```
|
|
86
97
|
|
|
87
|
-
|
|
98
|
+
---
|
|
88
99
|
|
|
89
|
-
|
|
90
|
-
|:------:|:-------------|
|
|
91
|
-
| **🔀 Multi-Session** | `delegate_task` → `client.session.create()` → new isolated session |
|
|
92
|
-
| **⚡ Parallel Agents** | 50 sessions run simultaneously, `ConcurrencyController` manages slots |
|
|
93
|
-
| **🖥️ Background Tasks** | `run_background` → async shell commands, non-blocking |
|
|
94
|
-
| **🔄 Auto-Continuation** | `session.idle` → check TODOs → inject prompt → keep going |
|
|
95
|
-
| **🛡️ Self-Healing** | Rate limits, crashes → 3 auto-retries per session |
|
|
100
|
+
## ✨ Key Features
|
|
96
101
|
|
|
97
|
-
|
|
102
|
+
| Feature | Description |
|
|
103
|
+
|:--------|:------------|
|
|
104
|
+
| ⚡ **50 Parallel Sessions** | True multi-threading with isolated contexts |
|
|
105
|
+
| 🔥 **Parallel File Builds** | Workers build different files simultaneously |
|
|
106
|
+
| 🧩 **Smart Distribution** | One file = one worker. No conflicts |
|
|
107
|
+
| � **Real-Time Sync** | Shared `.opencode/` state across all agents |
|
|
108
|
+
| �️ **Auto Verification** | E2E tests, import checks, integration validation |
|
|
109
|
+
| 🩹 **Self-Healing** | Auto-recovery with 3 retries per session |
|
|
110
|
+
|
|
111
|
+
### Self-Healing Details
|
|
112
|
+
|
|
113
|
+
| Error Type | Recovery Action |
|
|
114
|
+
|:-----------|:----------------|
|
|
115
|
+
| Tool crash | Inject recovery prompt |
|
|
116
|
+
| Rate limit | Exponential backoff + retry |
|
|
117
|
+
| Context overflow | Smart compaction |
|
|
118
|
+
| Session timeout | Resume from checkpoint |
|
|
119
|
+
| Build failure | Loop back, fix, retry |
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
## 📸 Screenshots
|
|
98
124
|
|
|
99
125
|
<div align="center">
|
|
100
126
|
<p><strong>TUI</strong></p>
|
|
@@ -110,30 +136,13 @@ Then in OpenCode:
|
|
|
110
136
|
|
|
111
137
|
---
|
|
112
138
|
|
|
113
|
-
## 🔧 Self-Healing Features
|
|
114
|
-
|
|
115
|
-
```
|
|
116
|
-
┌────────────────────────────────────────────────────────────┐
|
|
117
|
-
│ ERROR TYPE │ AUTO-RECOVERY ACTION │
|
|
118
|
-
├────────────────────────────────────────────────────────────┤
|
|
119
|
-
│ Tool crash │ Inject recovery prompt │
|
|
120
|
-
│ Rate limit │ Exponential backoff + retry │
|
|
121
|
-
│ Context overflow │ Smart compaction │
|
|
122
|
-
│ Thinking block error │ Auto-restructure │
|
|
123
|
-
│ Session timeout │ Resume from checkpoint │
|
|
124
|
-
│ Build failure │ Loop back, fix, retry │
|
|
125
|
-
└────────────────────────────────────────────────────────────┘
|
|
126
|
-
```
|
|
127
|
-
|
|
128
|
-
---
|
|
129
|
-
|
|
130
139
|
## 📚 Documentation
|
|
131
140
|
|
|
132
141
|
- **[System Architecture](docs/SYSTEM_ARCHITECTURE.md)** — Full technical deep-dive
|
|
133
142
|
|
|
134
143
|
---
|
|
135
144
|
|
|
136
|
-
## Uninstall
|
|
145
|
+
## 🗑️ Uninstall
|
|
137
146
|
|
|
138
147
|
```bash
|
|
139
148
|
npm uninstall -g opencode-orchestrator
|
|
@@ -141,9 +150,6 @@ npm uninstall -g opencode-orchestrator
|
|
|
141
150
|
|
|
142
151
|
---
|
|
143
152
|
|
|
144
|
-
## License
|
|
153
|
+
## 📄 License
|
|
145
154
|
|
|
146
155
|
MIT License. [LICENSE](LICENSE)
|
|
147
|
-
|
|
148
|
-
---
|
|
149
|
-
|
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.9.
|
|
5
|
+
"version": "0.9.25",
|
|
6
6
|
"author": "agnusdei1207",
|
|
7
7
|
"license": "MIT",
|
|
8
8
|
"repository": {
|