opencode: add custom tools support

Adds support for custom tools - user-defined functions that the LLM can
call during conversations. Custom tools work alongside opencode's built-in
tools and are configured through the new `tools` option.

The configuration follows the same pattern as other opencode settings like
`agents` and `commands`, supporting:
- Inline TypeScript content
- Individual file paths
- Bulk directory imports

tests/modules/programs/opencode/api-client-tool.ts

@@ -0,0 +1,12 @@
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Make API requests to external services",
+  args: {
+    endpoint: tool.schema.string().describe("API endpoint to call"),
+    method: tool.schema.string().describe("HTTP method"),
+  },
+  async execute(args) {
+    return `Called ${args.method} ${args.endpoint}`
+  },
+})

tests/modules/programs/opencode/database-query-tool.ts

@@ -0,0 +1,11 @@
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Query the project database",
+  args: {
+    query: tool.schema.string().describe("SQL query to execute"),
+  },
+  async execute(args) {
+    return `Executed query: ${args.query}`
+  },
+})

tests/modules/programs/opencode/default.nix

@@ -10,6 +10,9 @@
   opencode-commands-path = ./commands-path.nix;
   opencode-agents-bulk-directory = ./agents-bulk-directory.nix;
   opencode-commands-bulk-directory = ./commands-bulk-directory.nix;
+  opencode-tools-inline = ./tools-inline.nix;
+  opencode-tools-path = ./tools-path.nix;
+  opencode-tools-bulk-directory = ./tools-bulk-directory.nix;
   opencode-mixed-content = ./mixed-content.nix;
   opencode-skills-inline = ./skills-inline.nix;
   opencode-skills-path = ./skills-path.nix;

tests/modules/programs/opencode/mixed-content.nix

@@ -15,6 +15,22 @@
       '';
       path-agent = ./test-agent.md;
     };
+    tools = {
+      inline-tool = ''
+        import { tool } from "@opencode-ai/plugin"
+
+        export default tool({
+          description: "Inline tool definition",
+          args: {
+            input: tool.schema.string().describe("Test input"),
+          },
+          async execute(args) {
+            return `Processed: ''${args.input}`
+          },
+        })
+      '';
+      path-tool = ./test-tool.ts;
+    };
     skills = {
       inline-skill = ''
         ---
@@ -54,6 +70,13 @@
     assertFileContent home-files/.config/opencode/agent/path-agent.md \
       ${./test-agent.md}
 
+    # Tools
+    assertFileExists home-files/.config/opencode/tool/inline-tool.ts
+    assertFileExists home-files/.config/opencode/tool/path-tool.ts
+
+    assertFileContent home-files/.config/opencode/tool/path-tool.ts \
+      ${./test-tool.ts}
+
     # Skills
     assertFileExists home-files/.config/opencode/skill/inline-skill/SKILL.md
     assertFileExists home-files/.config/opencode/skill/path-skill/SKILL.md

tests/modules/programs/opencode/test-tool.ts

@@ -0,0 +1,11 @@
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Test tool for unit testing",
+  args: {
+    input: tool.schema.string().describe("Test input parameter"),
+  },
+  async execute(args) {
+    return `Processed: ${args.input}`
+  },
+})

tests/modules/programs/opencode/tools-bulk-directory.nix

@@ -0,0 +1,15 @@
+{
+  programs.opencode = {
+    enable = true;
+    tools = ./tools-bulk;
+  };
+
+  nmt.script = ''
+    assertFileExists home-files/.config/opencode/tool/database-query.ts
+    assertFileExists home-files/.config/opencode/tool/api-client.ts
+    assertFileContent home-files/.config/opencode/tool/database-query.ts \
+      ${./tools-bulk/database-query.ts}
+    assertFileContent home-files/.config/opencode/tool/api-client.ts \
+      ${./tools-bulk/api-client.ts}
+  '';
+}

tests/modules/programs/opencode/tools-bulk/api-client.ts

@@ -0,0 +1,12 @@
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Make API requests to external services",
+  args: {
+    endpoint: tool.schema.string().describe("API endpoint to call"),
+    method: tool.schema.string().describe("HTTP method"),
+  },
+  async execute(args) {
+    return `Called ${args.method} ${args.endpoint}`
+  },
+})

tests/modules/programs/opencode/tools-bulk/database-query.ts

@@ -0,0 +1,11 @@
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Query the project database",
+  args: {
+    query: tool.schema.string().describe("SQL query to execute"),
+  },
+  async execute(args) {
+    return `Executed query: ${args.query}`
+  },
+})

tests/modules/programs/opencode/tools-inline.nix

@@ -0,0 +1,42 @@
+{
+  programs.opencode = {
+    enable = true;
+    tools = {
+      database-query = ''
+        import { tool } from "@opencode-ai/plugin"
+
+        export default tool({
+          description: "Query the project database",
+          args: {
+            query: tool.schema.string().describe("SQL query to execute"),
+          },
+          async execute(args) {
+            return `Executed query: ''${args.query}`
+          },
+        })
+      '';
+      api-client = ''
+        import { tool } from "@opencode-ai/plugin"
+
+        export default tool({
+          description: "Make API requests to external services",
+          args: {
+            endpoint: tool.schema.string().describe("API endpoint to call"),
+            method: tool.schema.string().describe("HTTP method"),
+          },
+          async execute(args) {
+            return `Called ''${args.method} ''${args.endpoint}`
+          },
+        })
+      '';
+    };
+  };
+  nmt.script = ''
+    assertFileExists home-files/.config/opencode/tool/database-query.ts
+    assertFileExists home-files/.config/opencode/tool/api-client.ts
+    assertFileContent home-files/.config/opencode/tool/database-query.ts \
+      ${./database-query-tool.ts}
+    assertFileContent home-files/.config/opencode/tool/api-client.ts \
+      ${./api-client-tool.ts}
+  '';
+}

tests/modules/programs/opencode/tools-path.nix

@@ -0,0 +1,13 @@
+{
+  programs.opencode = {
+    enable = true;
+    tools = {
+      test-tool = ./test-tool.ts;
+    };
+  };
+  nmt.script = ''
+    assertFileExists home-files/.config/opencode/tool/test-tool.ts
+    assertFileContent home-files/.config/opencode/tool/test-tool.ts \
+      ${./test-tool.ts}
+  '';
+}