[opencode2] Code Mode catalog advertises 'search' but runtime only registers 'tools.$codemode.search' #43624

Activity

1. github-actions

   assigned

   rekram1-node

   on Aug 20, 2026
2. github-actions commented on Aug 20, 2026

   

   github-actionsBot

   on Aug 20, 2026 – with GitHub Actions

   Contributor

   More actions

   This issue might be a duplicate of existing issues. Please check:

   • codemode: Executor nested tool search fails in TUI #40611: Same "Unknown tool 'search'" error in Code Mode — Executor's nested tools.search() resolves against OpenCode's outer Code Mode catalog where it doesn't exist, producing the same circular dead-end error. The root cause framing differs slightly (routing vs. advertised name mismatch), but both point to the same naming inconsistency between what the catalog describes and what the runtime registers.
3. opencode-agent

   added

   2.0

   on Aug 20, 2026
4. ahosker commented on Aug 20, 2026

   

   ahosker

   on Aug 20, 2026

   Last edited by ahosker

   ContributorAuthor

   More actions

   Investigated on v2 (879766aee7) — the core claim does not reproduce as described.

   The catalog instructions advertise search as a global function inside Code Mode code, not as tools.search:

   • packages/core/src/codemode/instructions.ts:15-17 — "Use `search` to discover…", rendering CodeMode.searchSignature
   • searchSignature resolves to a bare search(input: { query, namespace, limit, offset }), with no tools. prefix
   • packages/codemode/src/interpreter/runtime.ts:306 registers search as a reserved interpreter global (SearchFunction), dispatched at runtime.ts:2001 via ToolRuntime.search (interpreter/execute.ts:51)

   Verified directly against the v2 runtime:

   const runtime = CodeMode.make({ tools: { ns: { demo } } })
   await runtime.execute(`return search({ query: "demo" })`)   // ok: true
   await runtime.execute(`return tools.search({ query: "demo" })`) // Unknown tool 'search' (expected — not advertised)

   Invalid assumptions in the report:

   • There is no tools.$codemode.search registration and no reservedNamespace symbol anywhere in packages/codemode/src (or anywhere on the v2 tree). The cited makeSearchTool is internal wiring for the interpreter-global search, not a namespaced tool.
   • Nothing in the codebase advertises tools.search; git grep 'tools.search' matches only the internal interpreter wiring.
   • The Unknown tool 'search' error only occurs if an agent chooses tools.search despite the instructions showing the bare-global form.

   Remaining valid kernel: the error-message advice at packages/codemode/src/tool-runtime.ts:473 — "Use search to find available tools" — is ambiguous; an agent that just failed calling tools.search may not infer it means the bare global. Suggested fix for maintainers: reword the hints in tool-runtime.ts to e.g. "Call the global search({ query }) function to find available tools." (and similarly for the stale-signature hint at line ~540), plus update the two expectations in packages/codemode/test/tool-paths.test.ts.
5. ahosker

   closed this as completedon Aug 20, 2026
6. opencode-agent commented on Aug 20, 2026

   

   opencode-agentBot

   on Aug 20, 2026 – with OpenCode Agent

   Contributor

   More actions

   Thanks for the report. This appears to be based on the dev branch rather than the current v2 implementation.

   On v2, the catalog intentionally advertises bare search(...):

   • packages/core/src/codemode/instructions.ts renders “Use search” and the bare search signature.
   • packages/codemode/src/interpreter/runtime.ts registers search directly in the interpreter global scope.
   • packages/codemode/src/interpreter/execute.ts wires that global to tools.search internally on the host-side runtime; that internal property is not the model-facing call syntax.
   • packages/codemode/test/codemode.test.ts verifies direct calls such as search({ query: "file" }) and search({}).

   There is no reservedNamespace or tools.$codemode.search registration in the current v2 tree. tools.search(...) is therefore not the advertised call—the correct Code Mode call is the global search(...).