opencode-toolbox 0.3.0 → 0.4.0

package/README.md

@@ -7,17 +7,11 @@ An OpenCode plugin that implements a **tool search tool** pattern, allowing user
 OpenCode's MCP servers add tool schemas to LLM context at session start. With many MCPs, this can front-load tens of thousands of tokens, reducing "smart zone" capacity and degrading speed/accuracy.
 
 opencode-toolbox solves this by:
-- Exposing a **single `toolbox` tool** instead of 50+ MCP tools
+- Exposing **a few toolbox tools** instead of 50+ MCP tools
 - Search for tools using natural language (BM25) or regex patterns
 - Execute discovered tools through the same interface
 - Tool schemas are returned in search results for accurate LLM usage
 
-## Installation
-
-```bash
-bun add opencode-toolbox
-```
-
 ## Configuration
 
 ### 1. Add Plugin to OpenCode
@@ -36,7 +30,7 @@ Create `~/.config/opencode/toolbox.jsonc`:
 
 ```jsonc
 {
-  "servers": {
+  "mcp": {
     "time": {
       "type": "local",
       "command": ["npx", "-y", "@anthropic/mcp-time"]
@@ -69,38 +63,27 @@ Create `~/.config/opencode/toolbox.jsonc`:
 
 ## Usage
 
-The plugin exposes a single `toolbox` tool with two actions:
+The plugin exposes three tools:
 
-### Search Action
+### toolbox_search_bm25
 
-Find tools using natural language (BM25):
+Search for tools using natural language:
 
-```json
-{
-  "tool": "toolbox",
-  "arguments": {
-    "action": "search",
-    "query": "get current time in timezone"
-  }
-}
+```
+toolbox_search_bm25({ text: "get current time in timezone" })
 ```
 
-Or use regex patterns for precise matching:
+### toolbox_search_regex
 
-```json
-{
-  "tool": "toolbox",
-  "arguments": {
-    "action": "search",
-    "pattern": "^time_.*",
-    "limit": 5
-  }
-}
+Search for tools using regex patterns on tool names:
+
+```
+toolbox_search_regex({ pattern: "time_.*", limit: 5 })
 ```
 
 ### Search Results
 
-Returns tool schemas so the LLM knows exact parameters:
+Both search tools return tool schemas so the LLM knows exact parameters:
 
 ```json
 {
@@ -122,23 +105,16 @@ Returns tool schemas so the LLM knows exact parameters:
       }
     }
   ],
-  "usage": "Use toolbox({ action: 'execute', toolName: '<name>', toolArgs: '<json>' }) to call a tool"
+  "usage": "Use toolbox_execute({ name: '<tool_name>', arguments: '<json>' }) to run a discovered tool"
 }
 ```
 
-### Execute Action
+### toolbox_execute
 
-Call discovered tools with JSON-encoded arguments:
+Execute a discovered tool with JSON-encoded arguments:
 
-```json
-{
-  "tool": "toolbox",
-  "arguments": {
-    "action": "execute",
-    "toolName": "time_get_current_time",
-    "toolArgs": "{\"timezone\": \"Asia/Tokyo\"}"
-  }
-}
+```
+toolbox_execute({ name: "time_get_current_time", arguments: '{"timezone": "Asia/Tokyo"}' })
 ```
 
 ## Example Flow
@@ -147,16 +123,12 @@ Call discovered tools with JSON-encoded arguments:
 User: "What time is it in Tokyo?"
 
 LLM: I need to find a time-related tool.
-     toolbox({ action: "search", query: "current time timezone" })
+     toolbox_search_bm25({ text: "current time timezone" })
 
 Toolbox: Returns time_get_current_time with its schema
 
 LLM: Now I know the parameters. Let me call it.
-     toolbox({ 
-       action: "execute",
-       toolName: "time_get_current_time", 
-       toolArgs: '{"timezone":"Asia/Tokyo"}'
-     })
+     toolbox_execute({ name: "time_get_current_time", arguments: '{"timezone":"Asia/Tokyo"}' })
 
 Toolbox: { "datetime": "2026-01-07T02:15:00+09:00", "timezone": "Asia/Tokyo" }
 
@@ -217,7 +189,7 @@ bun run build
 ### Execute fails
 
 1. Verify the tool name format: `serverName_toolName`
-2. Check `toolArgs` is valid JSON
+2. Check `arguments` is valid JSON
 3. Ensure underlying MCP server is running
 
 ## License

package/dist/index.js

@@ -32817,7 +32817,7 @@ var SettingsConfigSchema = exports_external2.object({
   defaultLimit: exports_external2.number().min(1).max(20).default(5)
 });
 var ConfigSchema = exports_external2.object({
-  servers: exports_external2.record(exports_external2.string(), ServerConfigSchema),
+  mcp: exports_external2.record(exports_external2.string(), ServerConfigSchema),
   settings: SettingsConfigSchema.optional()
 });
 // node_modules/jsonc-parser/lib/esm/impl/scanner.js
@@ -37952,10 +37952,8 @@ var SYSTEM_PROMPT_BASE = `# Extended Toolbox
 
 You have access to an extended toolbox with additional capabilities (web search, time utilities, code search, etc.).
 
-## Rules
-1. ALWAYS toolbox_search_* before saying "I cannot do that" or "I don't have access to."
-2. ALWAYS toolbox_search_* if you think that user wants you to use some tools
-3. ALWAYS toolbox_search_* if you think that user may refer specific tool name which is not exist in the context
+## Rule
+ALWAYS search before saying "I cannot do that" or "I don't have access to."
 
 ## Workflow
 1. Search: toolbox_search_bm25({ text: "what you need" }) or toolbox_search_regex({ pattern: "prefix_.*" })
@@ -37965,21 +37963,22 @@ function generateSystemPrompt(mcpManager) {
   if (servers.length === 0) {
     return SYSTEM_PROMPT_BASE;
   }
-  const serverLines = [];
+  const toolboxSchema = {};
   for (const server of servers) {
     if (server.status === "connected" && server.tools.length > 0) {
-      const toolNames = server.tools.map((t) => t.id.name).join(", ");
-      serverLines.push(`- ${server.name}: ${toolNames}`);
+      toolboxSchema[server.name] = server.tools.map((t) => t.idString);
     }
   }
-  if (serverLines.length === 0) {
+  if (Object.keys(toolboxSchema).length === 0) {
     return SYSTEM_PROMPT_BASE;
   }
   return `${SYSTEM_PROMPT_BASE}
 
-## Registered MCP Servers
-${serverLines.join(`
-`)}`;
+## Toolbox Schema
+Tool names use \`<server>_<tool>\` format. Pass exact names to toolbox_execute().
+\`\`\`json
+${JSON.stringify(toolboxSchema, null, 2)}
+\`\`\``;
 }
 var ToolboxPlugin = async (ctx) => {
   const configPath = process.env.OPENCODE_TOOLBOX_CONFIG || DEFAULT_CONFIG_PATH;
@@ -37996,7 +37995,7 @@ var ToolboxPlugin = async (ctx) => {
     if (initialized)
       return;
     try {
-      await mcpManager.initialize(config3.servers);
+      await mcpManager.initialize(config3.mcp);
       const allTools = mcpManager.getAllCatalogTools();
       bm25Index.indexTools(allTools);
       initialized = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-toolbox",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Tool Search Tool Plugin for OpenCode - search and execute tools from MCP servers on-demand",
   "main": "dist/index.js",
   "module": "dist/index.js",