opencode-orchestrator 0.9.57 β†’ 0.9.59

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.
Files changed (2) hide show
  1. package/README.md +47 -52
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,5 +1,5 @@
1
1
  <div align="center">
2
- <img src="assets/starship.png" alt="STARSHIP" width="280" />
2
+ <img src="assets/logo.png" alt="logo" width="280" />
3
3
  <h1>OpenCode Orchestrator</h1>
4
4
 
5
5
  [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
@@ -7,9 +7,7 @@
7
7
  [![Tests](https://img.shields.io/badge/tests-216%20passed-brightgreen.svg)]()
8
8
  </div>
9
9
 
10
- ---
11
-
12
- > The STARSHIP lands on a new planet: an unfamiliar codebase. No docs. No tests. Just a mission. The crew doesn't ask β€” they explore, adapt, and conquer.
10
+ > **πŸš€ Multi-Agent Orchestration Plugin for [OpenCode](https://opencode.ai)**
13
11
 
14
12
  ---
15
13
 
@@ -26,61 +24,60 @@ Then in OpenCode:
26
24
 
27
25
  ---
28
26
 
29
- ## πŸ›Έ Protocol
27
+ ## πŸŽ„ Core Philosophy
30
28
 
31
29
  ```
32
30
  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
33
- β”‚ πŸ” EXPLORE β†’ πŸ“ LEARN β†’ πŸ”„ ADAPT β†’ ⚑ ACT β”‚
31
+ β”‚ πŸ” EXPLORE β†’ πŸ“ LEARN β†’ πŸ”„ ADAPT β†’ ⚑ ACT β”‚
34
32
  β”‚ Scan Document Adjust Execute β”‚
35
33
  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
36
34
  ```
37
35
 
38
- ### πŸ‘¨β€πŸš€ The Crew
36
+ ### πŸ‘¨β€πŸš€ The Agents (Crews)
39
37
 
40
- *When the STARSHIP arrives, four specialists deploy:*
38
+ *Four AI agents work together on your task:*
41
39
 
42
- | Agent | Role | Mission |
43
- |:------|:-----|:--------|
44
- | 🎯 **Commander** | The Captain | *"I lead the mission. I delegate. I don't leave until it's done."* |
45
- | πŸ“‹ **Planner** | The Scientist | *"I map the terrain. I document everything. I create paths to follow."* |
46
- | πŸ”¨ **Worker** | The Engineer | *"I build with local materials. I adapt to what I find."* |
47
- | βœ… **Reviewer** | The Inspector | *"Nothing launches until I verify it. Zero defects."* |
40
+ | Agent | Role | What It Does |
41
+ |:------|:-----|:-------------|
42
+ | 🎯 **Commander** | Orchestrator | Leads the task, delegates work to other agents, ensures completion |
43
+ | πŸ“‹ **Planner** | Researcher | Analyzes the project, creates the plan, documents findings |
44
+ | πŸ”¨ **Worker** | Implementer | Writes code, modifies files, follows the project's patterns |
45
+ | βœ… **Reviewer** | Verifier | Tests changes, checks for errors, confirms quality |
48
46
 
49
- ### πŸ“– The Codex
47
+ ### πŸ“– Core Principles
50
48
 
51
- *These are the rules every crew member lives by:*
49
+ *Rules that guide every agent:*
52
50
 
53
- | Principle | In Practice |
54
- |:----------|:------------|
55
- | πŸ” **Never Assume Gravity** | Read `context.md`, detect stack, find actual commands |
56
- | πŸ“ **Document for Future Missions** | Record patterns, conventions, and findings for reuse |
57
- | πŸ“š **Evidence Over Memory** | Cite docs, run commands, complete only with proof |
58
- | πŸ”„ **Adapt to the Terrain** | Behavior evolves based on what we've documented |
59
- | 🀝 **Each Crew Member Has a Role** | Specialists don't overlap β€” they collaborate |
51
+ | Principle | What It Means |
52
+ |:----------|:--------------|
53
+ | πŸ” **Never Assume** | Always check the actual code and config files first |
54
+ | πŸ“ **Document Everything** | Record patterns and findings for future tasks |
55
+ | πŸ“š **Verify with Evidence** | Run tests, cite sources, complete with proof |
56
+ | πŸ”„ **Adapt to the Project** | Match the project's existing style and patterns |
57
+ | 🀝 **Specialized Roles** | Each agent has a clear, focused responsibility |
60
58
 
61
59
  ---
62
60
 
63
- ## πŸ›οΈ Mission Control
64
-
61
+ ## πŸ›οΈ Workflow
65
62
 
66
63
  ```
67
64
  /task "Build REST API"
68
65
  β”‚
69
66
  ╔═══════════════════════════════════╗
70
- β•‘ 🎯 COMMANDER β€” "Deploy the crew" β•‘
67
+ β•‘ 🎯 COMMANDER β€” "Start the task" β•‘
71
68
  β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•€β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•
72
69
  β”‚
73
70
  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
74
71
  β–Ό β–Ό β–Ό
75
72
  β”Œβ”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”
76
73
  β”‚PLANNERβ”‚ β”‚WORKER β”‚ β”‚WORKER β”‚ ← πŸ”₯ 50 PARALLEL
77
- β”‚plan.mdβ”‚ β”‚auth.tsβ”‚ β”‚api.ts β”‚ DEPLOYMENTS
74
+ β”‚plan.mdβ”‚ β”‚auth.tsβ”‚ β”‚api.ts β”‚ TASKS
78
75
  β””β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”˜
79
76
  β”‚ β”‚ β”‚
80
77
  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
81
78
  β–Ό
82
79
  ╔═══════════════════════════════════╗
83
- β•‘ βœ… REVIEWER β€” "Final inspection" β•‘
80
+ β•‘ βœ… REVIEWER β€” "Verify everything" β•‘
84
81
  β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•€β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•
85
82
  β”‚
86
83
  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”
@@ -88,34 +85,32 @@ Then in OpenCode:
88
85
  β”‚ Issues = 0? β”‚
89
86
  β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜
90
87
  No ↙ β†˜ Yes
91
- ♻️ LOOP πŸŽ–οΈ MISSION SEALED
88
+ ♻️ LOOP βœ… COMPLETE
92
89
  ```
93
90
 
94
91
  ---
95
92
 
96
- ## πŸš€ Capabilities
97
-
98
- | Capability | What It Means |
99
- |:-----------|:--------------|
100
- | ⚑ **50 Parallel Deployments** | Deploy up to 50 crew members simultaneously |
101
- | πŸ”₯ **Multi-Zone Operations** | Workers build different sectors at the same time |
102
- | 🧩 **Smart Crew Assignment** | One file = one specialist. Zero conflicts |
103
- | πŸ”— **Real-Time Comms** | Shared `.opencode/` state syncs all agents |
104
- | πŸ›‘οΈ **Pre-Launch Verification** | E2E tests, import checks, integration validation |
105
- | 🩹 **Self-Repair Systems** | Auto-recovery with 3 retries per session |
106
- | 🧬 **Adaptive AI Cores** | Agents evolve based on what they discover |
107
-
108
- ### 🚨 Emergency Protocols
109
-
110
- *When things go wrong in space, the STARSHIP knows what to do:*
111
-
112
- | Emergency | Recovery Action |
113
- |:----------|:----------------|
114
- | πŸ’₯ Tool crash | Inject recovery prompt |
115
- | 🚦 Rate limit hit | Exponential backoff + retry |
116
- | πŸ“¦ Context overflow | Smart compaction |
117
- | ⏱️ Session timeout | Resume from checkpoint |
118
- | πŸ”¨ Build failure | Loop back, fix, retry |
93
+ ## Features
94
+
95
+ | Feature | What It Does |
96
+ |:---------|:-------------|
97
+ | ⚑ **50 Parallel Tasks** | Run up to 50 agents simultaneously |
98
+ | πŸ”₯ **Multi-File Operations** | Work on different files at the same time |
99
+ | 🧩 **Smart Assignment** | One file = one agent. No conflicts |
100
+ | πŸ”— **Real-Time Sync** | Shared `.opencode/` state keeps all agents in sync |
101
+ | πŸ›‘οΈ **Automatic Verification** | E2E tests, import checks, integration validation |
102
+ | 🩹 **Auto-Recovery** | Retry failed tasks automatically (up to 3 times) |
103
+ | 🧬 **Adaptive AI** | Agents learn and adapt based on the project |
104
+
105
+ ### 🚨 Error Handling
106
+
107
+ | Error | What Happens |
108
+ |:------|:-------------|
109
+ | πŸ’₯ Tool crash | Inject recovery prompt and retry |
110
+ | 🚦 Rate limit hit | Wait and retry with exponential backoff |
111
+ | πŸ“¦ Context overflow | Compact the context automatically |
112
+ | ⏱️ Session timeout | Resume from the last checkpoint |
113
+ | πŸ”¨ Build failure | Fix the issue and retry |
119
114
 
120
115
  ---
121
116
 
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.57",
5
+ "version": "0.9.59",
6
6
  "author": "agnusdei1207",
7
7
  "license": "MIT",
8
8
  "repository": {