opencode-raven 2.2.2 → 2.3.1

package/CHANGELOG.md

@@ -1,76 +1,98 @@
 # Changelog
 
-## 2.2.2
-
-### Added
-- Fresh installs automatically select an available zero-cost, tool-capable model from OpenCode's connected provider catalog for Raven Search and Raven MCP.
-- `/raven seek model auto` and `/raven mcp model auto` retry free-model detection.
-
-### Changed
-- Removed the retired `opencode/deepseek-v4-flash-free` default. Raven now leaves routing inactive and shows first-time setup instructions when no suitable free model is available.
-- Auto-selected models are rechecked on startup, while manually configured models are never replaced.
-
-## 2.2.1
-
-### Fixed
-- Plugin-created Raven sessions now emit a session update after creation so OpenCode adds root-level sessions to its navigable child-session list.
-
-## 2.2.0
-
-### Added
-- Separate Raven Search and Raven MCP agents with independent models, reasoning effort, instructions, and timeouts.
-- Public `raven_mcp` delegation tool and Raven-only `raven_mcp_bridge` for on-demand MCP operations.
-- Delegated sessions now attach directly to the root session so nested agent calls remain visible in the main session's child switcher.
-
-### Changed
-- Raven configuration now uses `raven_seek` and `raven_mcp` sections. Existing flat configuration migrates automatically without a version field.
-- `raven_seek` is explicitly limited to narrowly scoped search and evidence retrieval; review, audit, implementation, and judgment remain with the calling agent.
-- Per-agent commands replace the shared model, effort, and timeout commands.
-
-### Removed
-- `/raven on`, `/raven off`, and the configuration-wide `enabled` field. Search routing is active while the plugin is installed.
-- Shared `/raven model`, `/raven effort`, and `/raven timeout` commands.
-
-## 2.1.8
-
-### Added
-- `raven_seek` now returns a model-visible session ID and accepts it through the optional `sessionId` argument, allowing follow-up research to continue in the same Raven session.
-- Resumed sessions are validated as Raven children of the current main session before they can be prompted again.
-
-### Fixed
-- Context estimates for resumed sessions count only the newly handled context instead of counting earlier Raven turns again.
-
-## 2.1.7
+## 2.3.1
 
 ### Fixed
-- Stats and `/raven` setting updates now patch the latest on-disk configuration instead of rewriting stale in-memory state, preserving externally edited MCP servers and headers.
-- Existing malformed or partially written configuration files are preserved for repair instead of being replaced with defaults.
-
-## 2.1.6
-
-### Added
-- Bun-based TypeScript verification and reproducible development dependencies.
+- V2 manual MCP refreshes now use notifications only, and reopening the TUI shows refresh progress and results in top-right notifications.
+- V2 now refreshes on-demand MCP health and tool discovery whenever the TUI attaches to the background service, sharing overlapping checks instead of relying on one-time server initialization.
+- V2 MCP-agent requests now receive live capability guidance so refreshed tools are visible without reloading the agent or service.
+- V2 `/raven` output now uses an opaque, terminal-height-bounded dialog with keyboard and mouse scrolling instead of an overflowing alert.
+- V2 public Raven delegation no longer asks for confirmation on every call. Deny rules and permissions for other tools remain unchanged.
 
-### Changed
-- On-demand MCP requests now propagate cancellation and SDK-native timeouts, reuse one in-flight connection per session/server, and close idle or deleted-session connections.
-- README structure and wording now focus on installation, usage, configuration, routing, security, and troubleshooting.
-- Removed legacy root-config and embedded MCP-metadata migration support.
-
-### Fixed
-- Quoted `cmd`, PowerShell, and Unix shell search commands can no longer bypass Raven routing.
-- Session event handling now follows the OpenCode SDK event shape.
-- Raven receives configured on-demand MCP guidance while startup health checks are pending.
-- Invalid timeout and stats values are normalized safely.
-
-## 2.1.5
-
-### Changed
-- **On-demand MCP guidance** — autogenerated guidance now preserves existing MCP order and appends newly loaded MCPs at the end.
-- **Guidance descriptions** — full-mode on-demand MCP guidance now keeps generated metadata intact while rendering only first-sentence descriptions to reduce main-model context.
-
-## 2.1.4
-
-### Changed
+## 2.3.0
+
+### Added
+- OpenCode 2 support through a native `setup()` adapter, sharing Raven configuration and MCP runtime with OpenCode 1.
+- V2 agent/tool registration, shell routing, model discovery, guidance injection, child-session completion waiting, cancellation, continuation validation, and provider-error handling.
+- A v2 terminal companion and typed RPC contract for immediate `/raven` command output and notifications without a model turn.
+- Native-host smoke checks, including offline v2 routing and delegation, alongside v1/v2 regression tests.
+
+### Changed
+- Raised the OpenCode 1 minimum to 1.18.29 for the shared `server()`/`setup()` object entrypoint. The v2 adapter targets OpenCode 2.0.26 and newer 2.x releases.
+- OpenCode 2 installation uses `plugins`; OpenCode 1 continues to use `plugin`.
+- V2 update instructions delegate cache management to OpenCode instead of deleting v1 cache paths.
+
+## 2.2.2
+
+### Added
+- Fresh installs automatically select an available zero-cost, tool-capable model from OpenCode's connected provider catalog for Raven Search and Raven MCP.
+- `/raven seek model auto` and `/raven mcp model auto` retry free-model detection.
+
+### Changed
+- Removed the retired `opencode/deepseek-v4-flash-free` default. Raven now leaves routing inactive and shows first-time setup instructions when no suitable free model is available.
+- Auto-selected models are rechecked on startup, while manually configured models are never replaced.
+
+## 2.2.1
+
+### Fixed
+- Plugin-created Raven sessions now emit a session update after creation so OpenCode adds root-level sessions to its navigable child-session list.
+
+## 2.2.0
+
+### Added
+- Separate Raven Search and Raven MCP agents with independent models, reasoning effort, instructions, and timeouts.
+- Public `raven_mcp` delegation tool and Raven-only `raven_mcp_bridge` for on-demand MCP operations.
+- Delegated sessions now attach directly to the root session so nested agent calls remain visible in the main session's child switcher.
+
+### Changed
+- Raven configuration now uses `raven_seek` and `raven_mcp` sections. Existing flat configuration migrates automatically without a version field.
+- `raven_seek` is explicitly limited to narrowly scoped search and evidence retrieval; review, audit, implementation, and judgment remain with the calling agent.
+- Per-agent commands replace the shared model, effort, and timeout commands.
+
+### Removed
+- `/raven on`, `/raven off`, and the configuration-wide `enabled` field. Search routing is active while the plugin is installed.
+- Shared `/raven model`, `/raven effort`, and `/raven timeout` commands.
+
+## 2.1.8
+
+### Added
+- `raven_seek` now returns a model-visible session ID and accepts it through the optional `sessionId` argument, allowing follow-up research to continue in the same Raven session.
+- Resumed sessions are validated as Raven children of the current main session before they can be prompted again.
+
+### Fixed
+- Context estimates for resumed sessions count only the newly handled context instead of counting earlier Raven turns again.
+
+## 2.1.7
+
+### Fixed
+- Stats and `/raven` setting updates now patch the latest on-disk configuration instead of rewriting stale in-memory state, preserving externally edited MCP servers and headers.
+- Existing malformed or partially written configuration files are preserved for repair instead of being replaced with defaults.
+
+## 2.1.6
+
+### Added
+- Bun-based TypeScript verification and reproducible development dependencies.
+
+### Changed
+- On-demand MCP requests now propagate cancellation and SDK-native timeouts, reuse one in-flight connection per session/server, and close idle or deleted-session connections.
+- README structure and wording now focus on installation, usage, configuration, routing, security, and troubleshooting.
+- Removed legacy root-config and embedded MCP-metadata migration support.
+
+### Fixed
+- Quoted `cmd`, PowerShell, and Unix shell search commands can no longer bypass Raven routing.
+- Session event handling now follows the OpenCode SDK event shape.
+- Raven receives configured on-demand MCP guidance while startup health checks are pending.
+- Invalid timeout and stats values are normalized safely.
+
+## 2.1.5
+
+### Changed
+- **On-demand MCP guidance** — autogenerated guidance now preserves existing MCP order and appends newly loaded MCPs at the end.
+- **Guidance descriptions** — full-mode on-demand MCP guidance now keeps generated metadata intact while rendering only first-sentence descriptions to reduce main-model context.
+
+## 2.1.4
+
+### Changed
 - **Subagent prompts** — Raven no longer injects routing guidance into subagent prompts; global instructions and tool enforcement handle routing.
 
 ## 2.1.3

package/README.md

@@ -1,6 +1,7 @@
 <div align="center">
   <h1>opencode-raven</h1>
   <p><strong>Keep noisy tool work out of your main OpenCode context.</strong></p>
+  <p><strong>Supports OpenCode V2 (2.0.26+) and OpenCode V1 (1.18.29+), in one package.</strong></p>
   <p>
     <a href="https://www.npmjs.com/package/opencode-raven"><img src="https://img.shields.io/npm/v/opencode-raven.svg" alt="npm version" /></a>
     <a href="https://www.npmjs.com/package/opencode-raven"><img src="https://img.shields.io/npm/dm/opencode-raven.svg" alt="npm downloads" /></a>
@@ -29,7 +30,21 @@
 
 ## Install
 
-Raven requires OpenCode 1.15.12 or newer. Add it to `opencode.jsonc`:
+**Raven 2.3 supports OpenCode V2 (2.0.26+).** OpenCode V1 (1.18.29+) remains supported in the same package—no separate plugin is needed.
+
+### OpenCode V2
+
+Use the v2 `plugins` key in `opencode.jsonc`:
+
+```jsonc
+{
+  "plugins": ["opencode-raven"]
+}
+```
+
+### OpenCode V1
+
+Use the v1 `plugin` key in `opencode.jsonc`:
 
 ```jsonc
 {
@@ -41,6 +56,16 @@ Restart OpenCode, then run `/raven` to verify the loaded version, model, routing
 
 OpenCode resolves the package from npm and caches it automatically.
 
+### Upgrading From OpenCode 1 To 2
+
+Keep using `opencode-raven`; change its OpenCode config entry from `plugin` to `plugins`. Raven's existing `~/.config/opencode/opencode-raven/raven-config.json` is shared by both versions, including models, on-demand MCPs, routing settings, and stats. Quit and restart OpenCode after upgrading.
+
+OpenCode 1 uses Raven's `server()` entrypoint; OpenCode 2 uses `setup()` and automatically loads the terminal companion. The terminal companion displays `/raven` command results in a scrollable dialog (arrow keys, Page Up/Down, or mouse wheel; Esc to close) and delivers startup/update warnings as toasts, without sending a prompt to the model. The v2 server also exposes the typed `opencode-raven/rpc` command contract for other clients.
+
+The v1 minimum is 1.18.29 because earlier versions cannot load the shared object entrypoint. See OpenCode's [plugin migration guide](https://opencode.ai/v2/docs/build/plugins/migrate-v1) for the upstream lifecycle and config changes.
+
+For local development, v1 can load `file:///path/to/opencode-raven/index.ts`; v2 requires the package directory, `file:///path/to/opencode-raven`.
+
 ### First-Time Setup
 
 On first start, Raven checks OpenCode's connected provider catalog and automatically selects an available zero-cost, tool-capable model from the `opencode` provider for both Raven agents. Free-model availability is controlled by the provider and can change.
@@ -85,6 +110,8 @@ Under the hood, Raven registers two public delegation tools and one internal bri
 | `raven_mcp` | Creates or resumes a Raven MCP session for configured on-demand MCP capabilities. |
 | `raven_mcp_bridge` | Internal bridge used only by the Raven MCP agent. |
 
+On OpenCode V2, Raven auto-approves permission checks for the public `raven_seek` and `raven_mcp` delegation tools instead of prompting on every call. Explicit deny rules still apply. This does not change permission checks for other tools or access restrictions on the internal MCP bridge.
+
 For a related follow-up, the main agent can reuse the ID returned by the earlier call:
 
 ```text
@@ -98,6 +125,10 @@ OpenCode's built-in tools already exist; Raven routes selected calls instead of
 
 On-demand MCPs are different: Raven discovers and calls them internally, so their full schemas are not registered globally. Enabled servers are probed after startup to discover tools and health, then per-session connections are opened when Raven uses them. "On-demand" describes schema exposure and normal use, not the absence of a startup health probe.
 
+On OpenCode V2, reopening the TUI triggers a fresh background health and tool-discovery check even if the shared service is still running. Overlapping attachment checks share the same refresh. Use `/raven mcp refresh [server_name]` to retry manually without restarting the service.
+
+Automatic and manual MCP refreshes use top-right notifications for progress and results, without opening a command dialog or a session tab.
+
 ## Configuration
 
 Raven creates its global configuration here:
@@ -183,7 +214,7 @@ Generated MCP metadata and main-model guidance live beside `raven-config.json`.
 
 ## Routing
 
-Default routed tools are `grep`, `glob`, `webfetch`, `fetch`, `websearch`, and search-like `bash` commands.
+Default routed tools are `grep`, `glob`, `webfetch`, `fetch`, `websearch`, and search-like `bash` commands. On OpenCode 2, Raven also recognizes the native `shell` tool; `bash` and `shell` are routing aliases, so existing routing settings continue to work. Exact `excludeTools` entries use the host's actual tool name.
 
 Global MCPs are automatically routed when their OpenCode tool names use the normal `<server>_<tool>` prefix. Use a keyword for suffix-style names:
 
@@ -247,6 +278,20 @@ Review `Raven.md` and your MCP commands before using Raven in sensitive environm
 - Stale plugin version: run `/raven update`, restart OpenCode, and follow the cache-clearing instructions it prints if needed.
 - Remove Raven: delete `"opencode-raven"` from `plugin`, restart, then optionally remove `~/.config/opencode/opencode-raven/`.
 
+On OpenCode 2, remove it from `plugins` instead. `/raven update` uses v1 cache-clearing behavior only on OpenCode 1; on v2 it checks the version and provides restart/pinned-version instructions while leaving cache management to OpenCode.
+
+## Development Checks
+
+```sh
+bun install
+bun test
+bun run typecheck
+bun scripts/smoke-compat.ts v1 /path/to/opencode-v1
+bun scripts/smoke-compat.ts v2 /path/to/opencode-v2
+```
+
+The native smoke checks use isolated configuration and data directories. The v2 check uses a deterministic local model endpoint to exercise routed main-agent search, direct Raven child search, delegation completion, and command/RPC output without calling a paid model provider.
+
 See [CHANGELOG.md](CHANGELOG.md) for release history.
 
 ## Disclaimer