opencode-orchestrator 0.9.39 β 0.9.47
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
CHANGED
|
@@ -1,14 +1,16 @@
|
|
|
1
1
|
<div align="center">
|
|
2
|
-
<img src="assets/
|
|
3
|
-
</
|
|
2
|
+
<img src="assets/starship_space.png" alt="STARSHIP" width="280" />
|
|
3
|
+
<h1>OpenCode Orchestrator</h1>
|
|
4
|
+
<p><em>π The mothership that deploys AI crews to unknown planet</em></p>
|
|
4
5
|
|
|
5
|
-
|
|
6
|
+
[](LICENSE)
|
|
7
|
+
[](https://www.npmjs.com/package/opencode-orchestrator)
|
|
8
|
+
[]()
|
|
9
|
+
</div>
|
|
6
10
|
|
|
7
|
-
|
|
11
|
+
---
|
|
8
12
|
|
|
9
|
-
|
|
10
|
-
[](https://www.npmjs.com/package/opencode-orchestrator)
|
|
11
|
-
[]()
|
|
13
|
+
> *The **STARSHIP** hovers above an uncharted planet. No docs. No tests. Just a mission. The Commander speaks: "We don't assume. We explore. We adapt. We conquer."* β **OpenCode Orchestrator** is that STARSHIP, deploying AI crews to complete missions in any planet.
|
|
12
14
|
|
|
13
15
|
---
|
|
14
16
|
|
|
@@ -23,58 +25,33 @@ Then in OpenCode:
|
|
|
23
25
|
/task "Build a REST API with authentication"
|
|
24
26
|
```
|
|
25
27
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
## π§ Core Philosophy
|
|
29
|
-
|
|
30
|
-
> **Imagine humanity landing on an unknown planet.**
|
|
31
|
-
> No maps. No guides. Just raw terrain and a mission to complete.
|
|
28
|
+
The STARSHIP deploys. The crew lands. The mission begins.
|
|
32
29
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
### π The New World Protocol
|
|
30
|
+
---
|
|
36
31
|
|
|
37
|
-
|
|
32
|
+
## πΈ The STARSHIP Protocol
|
|
38
33
|
|
|
39
34
|
```
|
|
40
|
-
|
|
41
|
-
β
|
|
42
|
-
β
|
|
43
|
-
|
|
44
|
-
β Scan the Document Adjust to Execute the β
|
|
45
|
-
β unknown discoveries the terrain mission β
|
|
46
|
-
β β
|
|
47
|
-
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
35
|
+
βββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
36
|
+
β π EXPLORE β π LEARN β π ADAPT β β‘ ACT β
|
|
37
|
+
β Scan Document Adjust Execute β
|
|
38
|
+
βββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
48
39
|
```
|
|
49
40
|
|
|
50
|
-
###
|
|
51
|
-
|
|
52
|
-
**π― Commander** β *The captain who landed the ship*
|
|
53
|
-
|
|
54
|
-
> Arrived on foreign soil with one mission: complete the objective. Doesn't know the atmosphere yet, doesn't know what grows here. But knows how to lead. Scans the horizon, delegates specialists, and keeps the mission moving until it's sealed.
|
|
55
|
-
|
|
56
|
-
**π Planner** β *The scientist who maps the terrain*
|
|
57
|
-
|
|
58
|
-
> First out of the ship with instruments in hand. Tests the soil, analyzes the air, documents every discovery. Creates the maps that everyone will follow. Without the Planner's records, the crew would be lost.
|
|
41
|
+
### π¨βπ The Crew
|
|
59
42
|
|
|
60
|
-
|
|
43
|
+
*When the STARSHIP arrives, four specialists deploy:*
|
|
61
44
|
|
|
62
|
-
|
|
45
|
+
| Agent | Role | Mission |
|
|
46
|
+
|:------|:-----|:--------|
|
|
47
|
+
| π― **Commander** | The Captain | *"I lead the mission. I delegate. I don't leave until it's done."* |
|
|
48
|
+
| π **Planner** | The Scientist | *"I map the terrain. I document everything. I create paths to follow."* |
|
|
49
|
+
| π¨ **Worker** | The Engineer | *"I build with local materials. I adapt to what I find."* |
|
|
50
|
+
| β
**Reviewer** | The Inspector | *"Nothing launches until I verify it. Zero defects."* |
|
|
63
51
|
|
|
64
|
-
|
|
52
|
+
### π The Codex
|
|
65
53
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
### πΈ The Protocol
|
|
69
|
-
|
|
70
|
-
| Phase | The Crew's Action |
|
|
71
|
-
|:------|:------------------|
|
|
72
|
-
| π **EXPLORE** | *"What kind of world is this?"* β Scan environment, detect patterns, never assume |
|
|
73
|
-
| οΏ½ **LEARN** | *"Let me write this down."* β Document findings for the team and future missions |
|
|
74
|
-
| οΏ½ **ADAPT** | *"We'll do it this way here."* β Adjust approach to fit what we've learned |
|
|
75
|
-
| β‘ **ACT** | *"Execute."* β Build, test, verify, seal the mission |
|
|
76
|
-
|
|
77
|
-
### π Crew Principles
|
|
54
|
+
*These are the rules every crew member lives by:*
|
|
78
55
|
|
|
79
56
|
| Principle | In Practice |
|
|
80
57
|
|:----------|:------------|
|
|
@@ -86,59 +63,69 @@ When you arrive on an uncharted world, you don't assume oxygen. You don't guess
|
|
|
86
63
|
|
|
87
64
|
---
|
|
88
65
|
|
|
89
|
-
## ποΈ
|
|
66
|
+
## ποΈ Mission Control
|
|
67
|
+
|
|
68
|
+
*Inside the STARSHIP, Mission Control coordinates everything:*
|
|
90
69
|
|
|
91
70
|
```
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
71
|
+
π UNKNOWN CODEBASE
|
|
72
|
+
β
|
|
73
|
+
/task "Build REST API"
|
|
74
|
+
β
|
|
75
|
+
βββββββββββββββββββββββββββββββββββββ
|
|
76
|
+
β πΈ STARSHIP MISSION CONTROL β
|
|
77
|
+
β ββββββββββββββββββββββββββββββββββββ£
|
|
78
|
+
β π― COMMANDER β "Deploy the crew" β
|
|
79
|
+
βββββββββββββββββ€ββββββββββββββββββββ
|
|
80
|
+
β
|
|
81
|
+
βββββββββββββββββΌββββββββββββββββ
|
|
82
|
+
βΌ βΌ βΌ
|
|
83
|
+
βββββββββ βββββββββ βββββββββ
|
|
84
|
+
βPLANNERβ βWORKER β βWORKER β β π₯ 50 PARALLEL
|
|
85
|
+
βplan.mdβ βauth.tsβ βapi.ts β DEPLOYMENTS
|
|
86
|
+
βββββββββ βββββββββ βββββββββ
|
|
87
|
+
β β β
|
|
88
|
+
βββββββββββββββββΌββββββββββββββββ
|
|
89
|
+
βΌ
|
|
90
|
+
βββββββββββββββββββββββββββββββββββββ
|
|
91
|
+
β β
REVIEWER β "Final inspection" β
|
|
92
|
+
βββββββββββββββββ€ββββββββββββββββββββ
|
|
93
|
+
β
|
|
94
|
+
ββββββββββ΄βββββββββ
|
|
95
|
+
β TODO 100%? β
|
|
96
|
+
β Issues = 0? β
|
|
97
|
+
ββββββββββ¬βββββββββ
|
|
98
|
+
No β β Yes
|
|
99
|
+
β»οΈ LOOP ποΈ MISSION SEALED
|
|
117
100
|
```
|
|
118
101
|
|
|
119
102
|
---
|
|
120
103
|
|
|
121
|
-
##
|
|
104
|
+
## π STARSHIP Capabilities
|
|
105
|
+
|
|
106
|
+
*The STARSHIP isn't just any vessel. It's built for the impossible:*
|
|
107
|
+
|
|
108
|
+
| Capability | What It Means |
|
|
109
|
+
|:-----------|:--------------|
|
|
110
|
+
| β‘ **50 Parallel Deployments** | Deploy up to 50 crew members simultaneously |
|
|
111
|
+
| π₯ **Multi-Zone Operations** | Workers build different sectors at the same time |
|
|
112
|
+
| π§© **Smart Crew Assignment** | One file = one specialist. Zero conflicts |
|
|
113
|
+
| π **Real-Time Comms** | Shared `.opencode/` state syncs all agents |
|
|
114
|
+
| π‘οΈ **Pre-Launch Verification** | E2E tests, import checks, integration validation |
|
|
115
|
+
| π©Ή **Self-Repair Systems** | Auto-recovery with 3 retries per session |
|
|
116
|
+
| 𧬠**Adaptive AI Cores** | Agents evolve based on what they discover |
|
|
122
117
|
|
|
123
|
-
|
|
124
|
-
|:--------|:------------|
|
|
125
|
-
| β‘ **50 Parallel Sessions** | True multi-threading with isolated contexts |
|
|
126
|
-
| π₯ **Parallel File Builds** | Workers build different files simultaneously |
|
|
127
|
-
| π§© **Smart Distribution** | One file = one worker. No conflicts |
|
|
128
|
-
| π **Real-Time Sync** | Shared `.opencode/` state across all agents |
|
|
129
|
-
| π‘οΈ **Auto Verification** | E2E tests, import checks, integration validation |
|
|
130
|
-
| π©Ή **Self-Healing** | Auto-recovery with 3 retries per session |
|
|
131
|
-
| 𧬠**Adaptive Intelligence** | Agents evolve behavior based on discoveries |
|
|
118
|
+
### π¨ Emergency Protocols
|
|
132
119
|
|
|
133
|
-
|
|
120
|
+
*When things go wrong in space, the STARSHIP knows what to do:*
|
|
134
121
|
|
|
135
|
-
|
|
|
136
|
-
|
|
137
|
-
| Tool crash | Inject recovery prompt |
|
|
138
|
-
| Rate limit | Exponential backoff + retry |
|
|
139
|
-
| Context overflow | Smart compaction |
|
|
140
|
-
| Session timeout | Resume from checkpoint |
|
|
141
|
-
| Build failure | Loop back, fix, retry |
|
|
122
|
+
| Emergency | Recovery Action |
|
|
123
|
+
|:----------|:----------------|
|
|
124
|
+
| π₯ Tool crash | Inject recovery prompt |
|
|
125
|
+
| π¦ Rate limit hit | Exponential backoff + retry |
|
|
126
|
+
| π¦ Context overflow | Smart compaction |
|
|
127
|
+
| β±οΈ Session timeout | Resume from checkpoint |
|
|
128
|
+
| π¨ Build failure | Loop back, fix, retry |
|
|
142
129
|
|
|
143
130
|
---
|
|
144
131
|
|
|
@@ -166,18 +153,7 @@ When you arrive on an uncharted world, you don't assume oxygen. You don't guess
|
|
|
166
153
|
|
|
167
154
|
## πΉ Developer's Words
|
|
168
155
|
|
|
169
|
-
|
|
170
|
-
<img src="assets/image.png" alt="Piano and Code" width="600" />
|
|
171
|
-
</div>
|
|
172
|
-
|
|
173
|
-
<br />
|
|
174
|
-
|
|
175
|
-
> *I believe playing the piano is also a form of orchestration.*
|
|
176
|
-
>
|
|
177
|
-
> *The harmony of polyphony β multiple voices β and homophony β a single melodic line.*
|
|
178
|
-
>
|
|
179
|
-
> *Each voice sings its most beautiful song from its own place, yet when combined, they create one grand, beautiful melody. I believe this structure is no different from AI agents.*
|
|
180
|
-
|
|
156
|
+
> [Read the full note β](docs/DEVELOPERS_NOTE.md)
|
|
181
157
|
|
|
182
158
|
---
|
|
183
159
|
|
package/dist/index.js
CHANGED
|
@@ -538,6 +538,16 @@ var PHILOSOPHY_PHASES = {
|
|
|
538
538
|
ADAPT: "ADAPT",
|
|
539
539
|
ACT: "ACT"
|
|
540
540
|
};
|
|
541
|
+
var EXECUTION_CYCLE = {
|
|
542
|
+
THINK: "THINK",
|
|
543
|
+
ACT: "ACT",
|
|
544
|
+
OBSERVE: "OBSERVE",
|
|
545
|
+
ADJUST: "ADJUST"
|
|
546
|
+
};
|
|
547
|
+
var EXECUTION_CYCLE_STEPS = `1. ${EXECUTION_CYCLE.THINK} - Reason about the task
|
|
548
|
+
2. ${EXECUTION_CYCLE.ACT} - Execute the work
|
|
549
|
+
3. ${EXECUTION_CYCLE.OBSERVE} - Check the result
|
|
550
|
+
4. ${EXECUTION_CYCLE.ADJUST} - Fix if needed`;
|
|
541
551
|
var PHILOSOPHY_TAGLINE = "Explore \u2192 Learn \u2192 Adapt \u2192 Act";
|
|
542
552
|
var PHILOSOPHY_QUOTE = "Like an astronaut landing on unknown planets \u2014 never assume, always discover.";
|
|
543
553
|
var PHILOSOPHY_LEARN_PRINCIPLE = "LEARN = DOCUMENT: What you discover, you record. Your learnings become the team's knowledge.";
|
|
@@ -14976,10 +14986,7 @@ ${args.context}
|
|
|
14976
14986
|
|
|
14977
14987
|
<execution>
|
|
14978
14988
|
Follow this pattern:
|
|
14979
|
-
|
|
14980
|
-
2. ACT - Execute the work
|
|
14981
|
-
3. OBSERVE - Check the result
|
|
14982
|
-
4. ADJUST - Fix if needed
|
|
14989
|
+
${EXECUTION_CYCLE_STEPS}
|
|
14983
14990
|
|
|
14984
14991
|
Report with evidence of success.
|
|
14985
14992
|
Never claim completion without proof.
|
|
@@ -3,4 +3,4 @@
|
|
|
3
3
|
*/
|
|
4
4
|
export { PROMPT_TAGS, wrapTag } from "./tags.js";
|
|
5
5
|
export { WORK_STATUS } from "./status.js";
|
|
6
|
-
export { PHILOSOPHY_PHASES, PHILOSOPHY_TAGLINE, PHILOSOPHY_QUOTE, PHILOSOPHY_LEARN_PRINCIPLE } from "./philosophy.js";
|
|
6
|
+
export { PHILOSOPHY_PHASES, PHILOSOPHY_TAGLINE, PHILOSOPHY_QUOTE, PHILOSOPHY_LEARN_PRINCIPLE, EXECUTION_CYCLE, EXECUTION_CYCLE_STEPS, } from "./philosophy.js";
|
|
@@ -9,6 +9,18 @@ export declare const PHILOSOPHY_PHASES: {
|
|
|
9
9
|
readonly ADAPT: "ADAPT";
|
|
10
10
|
readonly ACT: "ACT";
|
|
11
11
|
};
|
|
12
|
+
/**
|
|
13
|
+
* Execution Cycle Phases
|
|
14
|
+
*
|
|
15
|
+
* The 4-step execution pattern: THINK β ACT β OBSERVE β ADJUST
|
|
16
|
+
*/
|
|
17
|
+
export declare const EXECUTION_CYCLE: {
|
|
18
|
+
readonly THINK: "THINK";
|
|
19
|
+
readonly ACT: "ACT";
|
|
20
|
+
readonly OBSERVE: "OBSERVE";
|
|
21
|
+
readonly ADJUST: "ADJUST";
|
|
22
|
+
};
|
|
23
|
+
export declare const EXECUTION_CYCLE_STEPS: string;
|
|
12
24
|
/**
|
|
13
25
|
* Core philosophy tagline
|
|
14
26
|
*/
|
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.47",
|
|
6
6
|
"author": "agnusdei1207",
|
|
7
7
|
"license": "MIT",
|
|
8
8
|
"repository": {
|