opencode-multiagent 0.4.0 → 0.6.0

package/docs/usage-guide.md

@@ -39,20 +39,23 @@ When OpenCode loads the package, the plugin:
 ## 3. Normal User Flow
 
 In normal use, you do not need to pick worker agents manually. The system is designed so the
-top-level interaction goes through `planner`.
+top-level interaction goes through `planner` for most tasks. For exploratory work where the
+direction is unclear, start with `brainstormer` first.
 
-Typical flow:
+Typical flows:
 
 ```text
 user -> planner -> executor -> specialized subagents
+user -> brainstormer -> (concludes with brief) -> planner -> executor -> ...
 ```
 
 ### The main routing roles
 
-| Agent      | Role                                                                       |
-| ---------- | -------------------------------------------------------------------------- |
-| `planner`  | Owns triage, planning, challenge, inspection, and result integration.      |
-| `executor` | Runs the plan by dispatching bounded coding tasks and validating results.  |
+| Agent          | Role                                                                       |
+| -------------- | -------------------------------------------------------------------------- |
+| `brainstormer` | Explores ideas with the user before planning. Produces a planner brief.    |
+| `planner`      | Owns triage, planning, challenge, inspection, and result integration.      |
+| `executor`     | Runs the plan by dispatching bounded coding tasks and validating results.  |
 
 ## 4. Triage Levels
 
@@ -70,11 +73,12 @@ the route unless you have a strong reason to override the flow.
 
 ## 5. Shared Task Board
 
-The plugin exposes three shared task tools:
+The plugin exposes shared task tools:
 
-- `task_create`
-- `task_update`
-- `task_list`
+- `task_create` — create a new task with optional `maxRetries` and `escalationModel`
+- `task_update` — update task status, result, and `findings` for sibling context sharing
+- `task_list` — list tasks with dependency status (`depsMet`, `unmetDeps`)
+- `task_ready` — list tasks whose dependencies are all met and are ready to dispatch
 
 These are used internally by the agent system to track work, but they are also important to
 understand when reading logs or `.opencode` artifacts.
@@ -90,6 +94,23 @@ Possible task states:
 - `failed`
 - `blocked`
 
+### Retry and escalation
+
+Tasks created with `maxRetries > 0` are automatically retried when the child session ends with
+a failure. When retries are exhausted and an `escalationModel` is set, the task is reset with a
+prompt to re-dispatch using a more capable model.
+
+### Sibling context sharing
+
+When a task is completed with `findings`, those findings are included in the completion
+notification sent to sibling tasks. This lets parallel workers learn from each other's results
+without requiring manual coordination.
+
+### Dependency visibility
+
+`task_list` now returns dependency status for each task (`depsMet: true/false`, `unmetDeps: [...]`).
+Use `task_ready` to quickly find tasks that are ready to dispatch.
+
 ### Persistence
 
 When a project root is available, the task board is persisted to:
@@ -137,6 +158,28 @@ Example:
 }
 ```
 
+### Extended model parameters
+
+You can also set `top_p` and provider-specific `options` per agent. For example, to enable
+thinking mode with a token budget:
+
+```json
+{
+  "agentSettings": {
+    "planner": {
+      "model": "anthropic/claude-opus-4-6",
+      "top_p": 0.9,
+      "options": {
+        "thinking": { "type": "enabled", "budget_tokens": 10000 }
+      }
+    }
+  }
+}
+```
+
+These parameters are injected both at config compilation time and at runtime via the `chat.params`
+hook, ensuring they reach the LLM provider regardless of how OpenCode merges agent config.
+
 Use `opencode.json` when you want an explicit host-level override for a specific OpenCode field.
 
 Example:
@@ -197,7 +240,7 @@ Common generated files and directories:
 
 | Path                                                  | Purpose                                              |
 | ----------------------------------------------------- | ---------------------------------------------------- |
-| `~/.config/opencode/logs/opencode-multiagent.jsonl`   | Observation and telemetry log                        |
+| `~/.config/opencode/logs/opencode-multiagent.jsonl`   | Observation, telemetry, and token usage log           |
 | `~/.config/opencode/plugins/opencode-multiagent.json` | User runtime overrides                               |
 | `.opencode/tasks/taskboard.json`                      | Shared task board persistence                        |
 | `.opencode/plans/`                                    | Durable plans created through planner and docmaster  |

package/docs/usage-guide.tr.md

@@ -38,21 +38,24 @@ OpenCode paketi yüklediğinde plugin şu adımları uygular:
 
 ## 3. Normal Kullanım Akışı
 
-Normal kullanımda uzman ajanları elle seçmeniz gerekmez. Sistem, top-level etkileşimin `planner`
-üzerinden gitmesi için tasarlanmıştır.
+Normal kullanımda uzman ajanları elle seçmeniz gerekmez. Sistem, çoğu görev için top-level
+etkileşimin `planner` üzerinden gitmesi için tasarlanmıştır. Yönün belirsiz olduğu keşif
+çalışmalarında önce `brainstormer` ile başlayabilirsiniz.
 
-Tipik akış:
+Tipik akışlar:
 
 ```text
 kullanici -> planner -> executor -> uzman alt ajanlar
+kullanici -> brainstormer -> (brief ile sonuçlanır) -> planner -> executor -> ...
 ```
 
 ### Temel routing rolleri
 
-| Agent      | Rol                                                                                    |
-| ---------- | -------------------------------------------------------------------------------------- |
-| `planner`  | Talebi triage eder, route seçer, büyük işler için plan üretir, sonuçları inceler.     |
-| `executor` | Planı bounded uzman görevlerine bölerek uygular ve sonuçları doğrular.                |
+| Agent          | Rol                                                                                    |
+| -------------- | -------------------------------------------------------------------------------------- |
+| `brainstormer` | Planlama öncesi kullanıcıyla fikirleri keşfeder, planner'a hazır brief üretir.        |
+| `planner`      | Talebi triage eder, route seçer, büyük işler için plan üretir, sonuçları inceler.     |
+| `executor`     | Planı bounded uzman görevlerine bölerek uygular ve sonuçları doğrular.                |
 
 ## 4. Triage Seviyeleri (Tier Modeli)
 
@@ -70,11 +73,12 @@ Kullanıcı açısından pratik kural basittir: güçlü bir sebep yoksa görevi
 
 ## 5. Ortak Task Board
 
-Plugin üç ortak task aracı sunar:
+Plugin ortak task araçları sunar:
 
-- `task_create`
-- `task_update`
-- `task_list`
+- `task_create` — opsiyonel `maxRetries` ve `escalationModel` ile yeni görev oluşturma
+- `task_update` — görev durumu, sonuç ve sibling context paylaşımı için `findings` güncelleme
+- `task_list` — bağımlılık durumu ile görevleri listeleme (`depsMet`, `unmetDeps`)
+- `task_ready` — bağımlılıkları karşılanmış ve dispatch'e hazır görevleri listeleme
 
 Bu araçlar ajan sistemi tarafından dahili olarak kullanılır; ancak log ve `.opencode` çıktılarının
 nasıl oluştuğunu anlamak için bilinmeleri faydalıdır.
@@ -90,6 +94,23 @@ Olası task durumları:
 - `failed`
 - `blocked`
 
+### Yeniden deneme ve yükseltme
+
+`maxRetries > 0` ile oluşturulan görevler, child session hatayla sonlandığında otomatik olarak
+yeniden denenir. Yeniden denemeler tükendiğinde ve bir `escalationModel` tanımlıysa, görev daha
+güçlü bir modelle yeniden dispatch edilmesi için sıfırlanır.
+
+### Sibling context paylaşımı
+
+Bir görev `findings` ile tamamlandığında, bu bulgular kardeş görevlere gönderilen tamamlanma
+bildirimlerine eklenir. Bu sayede paralel çalışanlar, manuel koordinasyon gerektirmeden
+birbirlerinin sonuçlarından öğrenebilir.
+
+### Bağımlılık görünürlüğü
+
+`task_list` artık her görev için bağımlılık durumunu döndürür (`depsMet: true/false`,
+`unmetDeps: [...]`). Dispatch'e hazır görevleri hızlıca bulmak için `task_ready` kullanın.
+
 ### Kalıcılık
 
 Bir proje kökü varsa task board şu dosyaya yazılır:
@@ -138,6 +159,29 @@ kullanın.
 }
 ```
 
+### Genişletilmiş model parametreleri
+
+Her ajan için `top_p` ve provider'a özgü `options` da ayarlanabilir. Örneğin, thinking modunu
+bir token bütçesiyle açmak için:
+
+```json
+{
+  "agentSettings": {
+    "planner": {
+      "model": "anthropic/claude-opus-4-6",
+      "top_p": 0.9,
+      "options": {
+        "thinking": { "type": "enabled", "budget_tokens": 10000 }
+      }
+    }
+  }
+}
+```
+
+Bu parametreler hem config derleme zamanında hem de runtime'da `chat.params` hook'u aracılığıyla
+enjekte edilir; böylece OpenCode agent config'i nasıl birleştirirse birleştirsin parametreler
+LLM provider'a ulaşır.
+
 Belirli bir OpenCode alanını açıkça override etmek istediğinizde `opencode.json` kullanın.
 
 Örnek:
@@ -198,7 +242,7 @@ Sık görülen dosya ve dizinler:
 
 | Yol                                                   | Amaç                                                           |
 | ----------------------------------------------------- | -------------------------------------------------------------- |
-| `~/.config/opencode/logs/opencode-multiagent.jsonl`   | Observation ve telemetry logu                                  |
+| `~/.config/opencode/logs/opencode-multiagent.jsonl`   | Observation, telemetry ve token kullanım logu                  |
 | `~/.config/opencode/plugins/opencode-multiagent.json` | Kullanıcı runtime override dosyası                             |
 | `.opencode/tasks/taskboard.json`                      | Ortak task board verisi                                        |
 | `.opencode/plans/`                                    | `planner` ve `docmaster` tarafından yazılan kalıcı planlar     |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-multiagent",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "type": "module",
   "description": "Multi-agent orchestration plugin for OpenCode",
   "license": "MIT",