opencode-raven 2.1.8 → 2.2.1

package/mcp-guidance.md

@@ -1,35 +1,33 @@
-## Raven tool/MCP routing guidance
-
-Do not call tools or MCPs that Raven blocks directly. Raven may route search/fetch tools, docs/web/GitHub MCPs, user-configured tool/MCP prefixes, or on-demand MCP capabilities through `raven_seek` to save context.
-
-Use `raven_seek(query="...")` as the next tool call for blocked tool/MCP requests. Include the original tool/MCP name, intent, and relevant arguments.
-
-When a request follows up on an earlier Raven result, pass the Raven session ID returned by that call as `sessionId` so Raven retains its research context. Omit `sessionId` for unrelated work.
-
-For on-demand MCP requests, include the target MCP server and likely tool name in the `raven_seek` query when the listed capabilities make that obvious. Do not call `raven_mcp` directly unless you are Raven.
-
-Raven commonly handles:
-
-- local codebase search
-- filesystem discovery
-- reading a specific URL or webpage
-- web search and current information
-- docs/library/API lookup
-- public GitHub examples
-- user-configured MCP requests
-- on-demand MCPs configured in Raven, without exposing their full schemas to the main session
-- command-output or local system inspection that would otherwise use grep/rg/head over command output
-
-Examples:
-
-`raven_seek(query="Search the repo for where auth tokens are validated")`
-
-`raven_seek(query="Fetch/read https://example.com and summarize the install instructions")`
-
-`raven_seek(query="Check whether archivemount/libarchive supports ISO or UDF. Use docs, web, or command output as needed.")`
-
-`raven_seek(query="Use the Linear MCP to find open bugs assigned to me and summarize the top 3")`
-
-`raven_seek(query="Compare the first two bugs in more detail", sessionId="ses_...")`
-
-Simple piped output filters like `command | grep ...`, `command | rg ...`, `command | findstr ...`, or `command | head ...` are allowed when they only filter bounded output from the immediately preceding command.
+## Raven search/MCP routing guidance
+
+Raven performs search and information retrieval only. The calling agent must retain code review, auditing, correctness judgments, implementation, debugging decisions, planning, and final recommendations.
+
+Non-Raven agents use `raven_seek` for narrowly scoped evidence retrieval when a routed local search, filesystem discovery, URL fetch, web/docs/GitHub search, globally configured MCP, or search-like shell command is blocked. Include the original tool intent and relevant arguments. Do not delegate an entire review or general task.
+
+Non-Raven agents use `raven_mcp` for information available through Raven's configured on-demand MCP servers. Include the target server or capability when obvious. Only the `raven-mcp` agent calls `raven_mcp_bridge`; it must use the bridge directly instead of either public delegation tool.
+
+When a request follows up on an earlier Raven result, pass the session ID returned by the matching tool. Omit `sessionId` for unrelated work and never pass a `raven_seek` session to `raven_mcp` or vice versa.
+
+Appropriate `raven_seek` requests:
+
+- Find definitions, references, files, or concrete code locations.
+- Fetch and extract facts from a specific URL.
+- Search current web, documentation, or public GitHub sources.
+- Inspect bounded command output or local system facts.
+
+Inappropriate delegation:
+
+- Review or audit this codebase.
+- Decide whether an implementation is correct or secure.
+- Plan or implement a feature.
+- Diagnose a bug beyond retrieving requested evidence.
+
+Examples:
+
+`raven_seek(query="Find every caller of validateToken and return file/line locations")`
+
+`raven_seek(query="Fetch/read https://example.com and extract the documented install flags")`
+
+`raven_mcp(query="Use Context7 to retrieve the current API documentation for Effect Schema decoding")`
+
+Simple piped output filters like `command | grep ...`, `command | rg ...`, `command | findstr ...`, or `command | head ...` are allowed when they only filter bounded output from the immediately preceding command.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opencode-raven",
-  "version": "2.1.8",
-  "description": "Context-saving search and on-demand MCP routing for OpenCode through a focused Raven subagent.",
+  "version": "2.2.1",
+  "description": "Context-saving search and on-demand MCP routing for OpenCode through focused Raven agents.",
   "main": "./index.ts",
   "exports": {
     ".": "./index.ts"
@@ -10,6 +10,7 @@
   "files": [
     "index.ts",
     "Raven.md",
+    "RavenMcp.md",
     "Raven.png",
     "example.gif",
     "mcp-guidance.md",