feat(hook): add tool.definition hook for plugins to modify tool description and parameters (#4956)

spoons-and-mirrors · web-flow · commit 1608565c808c · 2026-02-12T22:52:17.000-06:00
diff --git a/packages/opencode/src/tool/registry.ts b/packages/opencode/src/tool/registry.ts
@@ -149,9 +149,17 @@ export namespace ToolRegistry {
         })
         .map(async (t) => {
           using _ = log.time(t.id)
+          const tool = await t.init({ agent })
+          const output = {
+            description: tool.description,
+            parameters: tool.parameters,
+          }
+          await Plugin.trigger("tool.definition", { toolID: t.id }, output)
           return {
             id: t.id,
-            ...(await t.init({ agent })),
+            ...tool,
+            description: output.description,
+            parameters: output.parameters,
           }
         }),
     )
diff --git a/packages/plugin/src/index.ts b/packages/plugin/src/index.ts
@@ -224,4 +224,8 @@ export interface Hooks {
     input: { sessionID: string; messageID: string; partID: string },
     output: { text: string },
   ) => Promise<void>
+  /**
+   * Modify tool definitions (description and parameters) sent to LLM
+   */
+  "tool.definition"?: (input: { toolID: string }, output: { description: string; parameters: any }) => Promise<void>
 }

Original file line number	Diff line number	Diff line change
`@@ -224,4 +224,8 @@ export interface Hooks {`
`224`	`224`	`input: { sessionID: string; messageID: string; partID: string },`
`225`	`225`	`output: { text: string },`
`226`	`226`	`) => Promise<void>`
	`227`	`+ /**`
	`228`	`+ * Modify tool definitions (description and parameters) sent to LLM`
	`229`	`+ */`
	`230`	`+ "tool.definition"?: (input: { toolID: string }, output: { description: string; parameters: any }) => Promise<void>`
`227`	`231`	`}`