opencode-orchestrator 0.9.44 β†’ 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,44 +25,33 @@ Then in OpenCode:
23
25
  /task "Build a REST API with authentication"
24
26
  ```
25
27
 
26
- ---
28
+ The STARSHIP deploys. The crew lands. The mission begins.
27
29
 
28
- ## ⭐ Core Philosophy
29
-
30
- > **Humanity lands on an unknown planet. No maps. No guides. Just a mission.**
30
+ ---
31
31
 
32
- You don't assume oxygen. You don't guess gravity. You **explore**, **learn**, **adapt**, and **act**.
32
+ ## πŸ›Έ The STARSHIP Protocol
33
33
 
34
34
  ```
35
- β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
36
- β”‚ β”‚
37
- β”‚ πŸ” EXPLORE β†’ πŸ“ LEARN β†’ πŸ”„ ADAPT β†’ ⚑ ACT β”‚
38
- β”‚ β”‚
39
- β”‚ Scan the Document Adjust to Execute the β”‚
40
- β”‚ unknown discoveries the terrain mission β”‚
41
- β”‚ β”‚
42
- β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
35
+ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
36
+ β”‚ πŸ” EXPLORE β†’ πŸ“ LEARN β†’ πŸ”„ ADAPT β†’ ⚑ ACT β”‚
37
+ β”‚ Scan Document Adjust Execute β”‚
38
+ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
43
39
  ```
44
40
 
45
41
  ### πŸ‘¨β€πŸš€ The Crew
46
42
 
43
+ *When the STARSHIP arrives, four specialists deploy:*
44
+
47
45
  | Agent | Role | Mission |
48
46
  |:------|:-----|:--------|
49
- | 🎯 **Commander** | The captain | Leads the mission. Delegates specialists. Seals when complete. |
50
- | πŸ“‹ **Planner** | The scientist | Maps the terrain. Documents everything. Creates paths to follow. |
51
- | πŸ”¨ **Worker** | The engineer | Builds with local materials. Adapts to the terrain. |
52
- | βœ… **Reviewer** | The inspector | Verifies all structures. Clears the mission for launch. |
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."* |
53
51
 
54
- ### πŸ›Έ The Protocol
52
+ ### πŸ“– The Codex
55
53
 
56
- | Phase | The Crew's Action |
57
- |:------|:------------------|
58
- | πŸ” **EXPLORE** | *"What world is this?"* β€” Scan, detect, never assume |
59
- | πŸ“ **LEARN** | *"Write it down."* β€” Document for future missions |
60
- | πŸ”„ **ADAPT** | *"Do it this way here."* β€” Fit the terrain |
61
- | ⚑ **ACT** | *"Execute."* β€” Build, test, seal |
62
-
63
- ### 🌟 Crew Principles
54
+ *These are the rules every crew member lives by:*
64
55
 
65
56
  | Principle | In Practice |
66
57
  |:----------|:------------|
@@ -72,59 +63,69 @@ You don't assume oxygen. You don't guess gravity. You **explore**, **learn**, **
72
63
 
73
64
  ---
74
65
 
75
- ## πŸ›οΈ Architecture
66
+ ## πŸ›οΈ Mission Control
67
+
68
+ *Inside the STARSHIP, Mission Control coordinates everything:*
76
69
 
77
70
  ```
78
- /task "Build REST API"
79
- β”‚
80
- ╔═══════════════╧═══════════════╗
81
- β•‘ 🎯 COMMANDER β€” Delegate+Loop β•‘
82
- β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•€β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•
83
- β”‚
84
- β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
85
- β–Ό β–Ό β–Ό
86
- β”Œβ”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”
87
- β”‚PLANNERβ”‚ β”‚WORKER β”‚ β”‚WORKER β”‚ ← πŸ”₯ 50 PARALLEL
88
- β”‚plan.mdβ”‚ β”‚auth.tsβ”‚ β”‚api.ts β”‚ SESSIONS
89
- β””β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”˜
90
- β”‚ β”‚ β”‚
91
- β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
92
- β–Ό
93
- ╔═══════════════╧═══════════════╗
94
- β•‘ βœ… REVIEWER β€” Verify β•‘
95
- β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•€β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•
96
- β”‚
97
- β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”
98
- β”‚ TODO 100%? β”‚
99
- β”‚ Issues = 0? β”‚
100
- β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜
101
- No ↙ β†˜ Yes
102
- ♻️ 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
103
100
  ```
104
101
 
105
102
  ---
106
103
 
107
- ## ✨ Key Features
108
-
109
- | Feature | Description |
110
- |:--------|:------------|
111
- | ⚑ **50 Parallel Sessions** | True multi-threading with isolated contexts |
112
- | πŸ”₯ **Parallel File Builds** | Workers build different files simultaneously |
113
- | 🧩 **Smart Distribution** | One file = one worker. No conflicts |
114
- | πŸ”— **Real-Time Sync** | Shared `.opencode/` state across all agents |
115
- | πŸ›‘οΈ **Auto Verification** | E2E tests, import checks, integration validation |
116
- | 🩹 **Self-Healing** | Auto-recovery with 3 retries per session |
117
- | 🧬 **Adaptive Intelligence** | Agents evolve behavior based on discoveries |
118
-
119
- ### Self-Healing Details
120
-
121
- | Error Type | Recovery Action |
122
- |:-----------|:----------------|
123
- | Tool crash | Inject recovery prompt |
124
- | Rate limit | Exponential backoff + retry |
125
- | Context overflow | Smart compaction |
126
- | Session timeout | Resume from checkpoint |
127
- | Build failure | Loop back, fix, retry |
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 |
117
+
118
+ ### 🚨 Emergency Protocols
119
+
120
+ *When things go wrong in space, the STARSHIP knows what to do:*
121
+
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 |
128
129
 
129
130
  ---
130
131
 
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.44",
5
+ "version": "0.9.47",
6
6
  "author": "agnusdei1207",
7
7
  "license": "MIT",
8
8
  "repository": {