opencode-raven 2.0.1 → 2.1.1

package/mcp-guidance.md

@@ -1,19 +1,22 @@
-## 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, or user-configured tools/MCP prefixes 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.
-
-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
-- command-output or local system inspection that would otherwise use grep/rg/head over command output
+## 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.
+
+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:
 
@@ -21,8 +24,8 @@ Examples:
 
 `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")`
-
-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_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")`
+
+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.0.1",
-  "description": "Hard tool/MCP rerouter for opencode — avoids flooding and wasted context from searches, docs, web, GitHub examples, and verbose MCP calls",
+  "version": "2.1.1",
+  "description": "Raven is a context firewall for OpenCode. It routes noisy search, docs, web, GitHub, and MCP calls through a free focused agent before they hit your main model, saving cost and context!",
   "main": "./index.ts",
   "exports": {
     ".": "./index.ts"
@@ -11,6 +11,7 @@
     "index.ts",
     "Raven.md",
     "Raven.png",
+    "example.gif",
     "mcp-guidance.md",
     "README.md"
   ],
@@ -32,5 +33,8 @@
   },
   "engines": {
     "bun": ">=1.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
   }
 }