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/logo.png" alt="Logo" width="200" />
3
- </div>
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
- # OpenCode Orchestrator
6
+ [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
7
+ [![npm](https://img.shields.io/npm/v/opencode-orchestrator.svg)](https://www.npmjs.com/package/opencode-orchestrator)
8
+ [![Tests](https://img.shields.io/badge/tests-216%20passed-brightgreen.svg)]()
9
+ </div>
6
10
 
7
- > **πŸš€ Multi-Agent Orchestration Plugin for [OpenCode](https://opencode.ai)**
11
+ ---
8
12
 
9
- [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
10
- [![npm](https://img.shields.io/npm/v/opencode-orchestrator.svg)](https://www.npmjs.com/package/opencode-orchestrator)
11
- [![Tests](https://img.shields.io/badge/tests-216%20passed-brightgreen.svg)]()
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
- This is how our agents approach every project.
34
-
35
- ### 🌍 The New World Protocol
30
+ ---
36
31
 
37
- When you arrive on an uncharted world, you don't assume oxygen. You don't guess gravity. You **explore**, **learn**, **adapt**, and then **act**.
32
+ ## πŸ›Έ The STARSHIP Protocol
38
33
 
39
34
  ```
40
- β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
41
- β”‚ β”‚
42
- β”‚ πŸ” EXPLORE β†’ πŸ“ LEARN β†’ πŸ”„ ADAPT β†’ ⚑ ACT β”‚
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
- ### πŸš€ The Crew
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
- **πŸ”¨ Worker** β€” *The engineer who builds the base*
43
+ *When the STARSHIP arrives, four specialists deploy:*
61
44
 
62
- > Takes the Planner's maps and builds. Adapts construction to local materials. If the terrain is rocky, builds on rock. If it's sandy, adjusts foundations. Doesn't fight the environment β€” works with it.
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
- **βœ… Reviewer** β€” *The inspector who clears for launch*
52
+ ### πŸ“– The Codex
65
53
 
66
- > Before the mission can be called complete, everything must pass inspection. Walks the perimeter, tests the structures, verifies against the original blueprints. Only when every check passes does the mission get sealed.
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
- ## πŸ›οΈ Architecture
66
+ ## πŸ›οΈ Mission Control
67
+
68
+ *Inside the STARSHIP, Mission Control coordinates everything:*
90
69
 
91
70
  ```
92
- /task "Build REST API"
93
- β”‚
94
- ╔═══════════════╧═══════════════╗
95
- β•‘ 🎯 COMMANDER β€” Delegate+Loop β•‘
96
- β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•€β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•
97
- β”‚
98
- β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
99
- β–Ό β–Ό β–Ό
100
- β”Œβ”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”
101
- β”‚PLANNERβ”‚ β”‚WORKER β”‚ β”‚WORKER β”‚ ← πŸ”₯ 50 PARALLEL
102
- β”‚plan.mdβ”‚ β”‚auth.tsβ”‚ β”‚api.ts β”‚ SESSIONS
103
- β””β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”˜
104
- β”‚ β”‚ β”‚
105
- β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
106
- β–Ό
107
- ╔═══════════════╧═══════════════╗
108
- β•‘ βœ… REVIEWER β€” Verify β•‘
109
- β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•€β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•
110
- β”‚
111
- β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”
112
- β”‚ TODO 100%? β”‚
113
- β”‚ Issues = 0? β”‚
114
- β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜
115
- No ↙ β†˜ Yes
116
- ♻️ LOOP πŸŽ–οΈ SEALED
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
- ## ✨ Key Features
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
- | Feature | Description |
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
- ### Self-Healing Details
120
+ *When things go wrong in space, the STARSHIP knows what to do:*
134
121
 
135
- | Error Type | Recovery Action |
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
- <div align="center">
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
- 1. THINK - Reason about the task
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.39",
5
+ "version": "0.9.47",
6
6
  "author": "agnusdei1207",
7
7
  "license": "MIT",
8
8
  "repository": {