@khalilgharbaoui/opencode-claude-code-plugin 0.4.20 → 0.4.22

package/README.md

@@ -213,8 +213,11 @@ By default, when Claude Code's CLI uses `Bash`, `Edit`, `Write`, etc., it execut
 | `"Edit"` | `Edit`, `MultiEdit` | `mcp__opencode_proxy__edit` |
 | `"Write"` | `Write` | `mcp__opencode_proxy__write` |
 | `"WebFetch"` | `WebFetch` | `mcp__opencode_proxy__webfetch` |
+| `"Task"` | `Agent` | `mcp__opencode_proxy__task` |
 
-Only those four values are actually proxied; anything else you put in `proxyTools` is ignored. Proxying `Edit` also disables `MultiEdit` — opencode has no batched-edit equivalent, so Claude is forced to fan out into single `Edit` calls that each flow through the permission UI.
+The `Task` proxy is the way to let Claude orchestrate opencode's configured subagents (`build`, `general`, custom subagents defined in `opencode.json`) instead of Claude CLI's internal-only general-purpose / Explore / Plan options. With `"Task"` in `proxyTools` and `permission.task: allow` granted to the calling agent, a Claude session can invoke `task(subagent_type="build", prompt="...")` and the subagent runs natively under opencode (with its own permission UI, lifecycle, model assignment, and Tab visibility). Without `"Task"`, Claude's built-in `Agent` tool stays enabled and Claude orchestrates subagents internally with no opencode visibility.
+
+Only those five values are actually proxied; anything else you put in `proxyTools` is ignored. Proxying `Edit` also disables `MultiEdit` — opencode has no batched-edit equivalent, so Claude is forced to fan out into single `Edit` calls that each flow through the permission UI.
 
 To turn off proxying entirely:
 
@@ -440,6 +443,7 @@ plugin internals.
 ```bash
 bun install
 bun run typecheck   # tsc --noEmit
+bun run test        # tsx --test (unit suite)
 bun run build       # tsup -> dist/
 ```
 
@@ -449,17 +453,25 @@ Source layout:
 src/
   index.ts                       # opencode plugin entry, config + provider hooks
   models.ts                      # default models + variants
+  accounts.ts                    # multi-account expansion (per-account CLAUDE_CONFIG_DIR + wrapper script)
   claude-code-language-model.ts  # AI-SDK provider that drives `claude`
   message-builder.ts             # AI-SDK prompt → Claude CLI user message
+  tool-mapping.ts                # Claude tool name ↔ opencode tool name mapping; internal-tool skip list
   proxy-mcp.ts                   # in-process MCP server for proxied tools
+  proxy-broker.ts                # pending proxy-call broker between proxy-mcp and opencode tool execution
   mcp-bridge.ts                  # opencode → Claude --mcp-config translator
   session-manager.ts             # LRU cache of CLI subprocesses
   cli-version.ts                 # detect Claude CLI version, gate optional flags
+  runtime-status.ts              # runtime introspection of opencode (MCP status, tool registry)
   logger.ts                      # DEBUG=opencode-claude-code stderr logger
+  tmp.ts                         # per-plugin temp directory helper
+  cleanup-stale.ts               # remove legacy unscoped install from opencode's plugin cache
   types.ts                       # public option types
   opencode-types.ts              # mirrored opencode types
 ```
 
+For runtime gotchas, the v1.15.0 audit waterline, and the release flow, see [`AGENTS.md`](./AGENTS.md).
+
 ## Publishing (maintainers)
 
 ```bash

package/dist/index.d.ts

@@ -229,7 +229,15 @@ interface ClaudeCodeProviderSettings {
      *     opencode's tool executor (with its native permission UI) and returns
      *     the result.
      *
-     * Supported: `bash`, `write`, `edit`, `webfetch`. Leave empty or unset to disable proxying.
+     * Supported: `bash`, `write`, `edit`, `webfetch`, `task`. Leave empty or unset to disable proxying.
+     *
+     * `task` proxies Claude CLI's `Agent` (subagent dispatch) tool through
+     * opencode's `task` tool, so subagent calls run under opencode's
+     * configured subagent set (build/general/custom) with opencode's
+     * permission and lifecycle handling, instead of Claude CLI's
+     * internal-only general-purpose / Explore / Plan options. The calling
+     * agent must have `permission.task: allow` for the target subagent
+     * (see opencode's agent docs).
      */
     proxyTools?: string[];
     /**

package/dist/index.js

@@ -989,6 +989,25 @@ function setOpencodeClient(client) {
     opencodeClient = client;
   }
 }
+var opencodeProjectDirectory;
+function setOpencodeProjectDirectory(dir) {
+  opencodeProjectDirectory = dir;
+}
+function isUsableDirectory(d) {
+  return typeof d === "string" && d.length > 1 && d !== "/";
+}
+function resolveSpawnCwd(configured) {
+  return resolveSpawnCwdFrom(
+    configured,
+    process.cwd(),
+    opencodeProjectDirectory
+  );
+}
+function resolveSpawnCwdFrom(configured, live, captured) {
+  if (configured) return configured;
+  if (isUsableDirectory(live)) return live;
+  return captured ?? live;
+}
 async function getRuntimeMcpStatus() {
   const client = opencodeClient;
   if (!client?.mcp?.status) return void 0;
@@ -1387,6 +1406,36 @@ var DEFAULT_PROXY_TOOLS = [
       },
       required: ["url"]
     }
+  },
+  {
+    name: "task",
+    description: "Launch an opencode subagent to handle a complex multi-step task autonomously. Routed through opencode's task tool so subagent orchestration, permission, and lifecycle are handled by opencode. Use `subagent_type` to pick which configured subagent runs (e.g. `build`, `general`, `explore`, or any custom subagent declared in opencode.json). The call blocks until the subagent finishes; the 10-minute proxy timeout applies.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        description: {
+          type: "string",
+          description: "A short (3-5 words) description of the task"
+        },
+        prompt: {
+          type: "string",
+          description: "The task for the agent to perform"
+        },
+        subagent_type: {
+          type: "string",
+          description: "The type of specialized agent to use for this task"
+        },
+        task_id: {
+          type: "string",
+          description: "Set this only if you mean to resume a previous task \u2014 pass the prior task_id to continue the same subagent session instead of creating a fresh one."
+        },
+        command: {
+          type: "string",
+          description: "The command that triggered this task"
+        }
+      },
+      required: ["description", "prompt", "subagent_type"]
+    }
   }
 ];
 async function createProxyMcpServer(tools = DEFAULT_PROXY_TOOLS) {
@@ -1623,7 +1672,8 @@ function disallowedToolFlags(tools) {
     edit: ["Edit", "MultiEdit"],
     glob: ["Glob"],
     grep: ["Grep"],
-    webfetch: ["WebFetch"]
+    webfetch: ["WebFetch"],
+    task: ["Agent"]
   };
   const out = [];
   const seen = /* @__PURE__ */ new Set();
@@ -2385,7 +2435,7 @@ var ClaudeCodeLanguageModel = class {
   }
   async doGenerate(options) {
     const warnings = [];
-    const cwd = this.config.cwd ?? process.cwd();
+    const cwd = resolveSpawnCwd(this.config.cwd);
     const scope = this.requestScope(options);
     const affinity = this.sessionAffinity(options);
     const sk = sessionKey(cwd, `${this.modelId}::${scope}::${affinity}`);
@@ -2695,7 +2745,7 @@ ${plan}
   }
   async doStream(options) {
     const warnings = [];
-    const cwd = this.config.cwd ?? process.cwd();
+    const cwd = resolveSpawnCwd(this.config.cwd);
     const cliPath = this.config.cliPath;
     const skipPermissions = this.config.skipPermissions !== false;
     const scope = this.requestScope(options);
@@ -4188,10 +4238,6 @@ function cleanupOne(cacheRoot, ourDir) {
 }
 
 // src/index.ts
-var opencodeProjectDirectory;
-function isUsableDirectory(d) {
-  return typeof d === "string" && d.length > 1 && d !== "/";
-}
 function pickOpencodeDirectory(input) {
   if (!input || typeof input !== "object") return void 0;
   const ctx = input;
@@ -4329,7 +4375,6 @@ async function providerConfig(existing, providerID = PROVIDER_ID2, optionDefault
   const mergedOptions = {
     cliPath: "claude",
     proxyTools: ["Bash", "Edit", "Write", "WebFetch"],
-    ...opencodeProjectDirectory ? { cwd: opencodeProjectDirectory } : {},
     ...optionDefaults,
     ...cleanProviderOptions(existing?.options),
     providerID
@@ -4395,7 +4440,7 @@ var server = async (input) => {
   if (input && typeof input === "object" && "client" in input) {
     setOpencodeClient(input.client);
   }
-  opencodeProjectDirectory = pickOpencodeDirectory(input);
+  setOpencodeProjectDirectory(pickOpencodeDirectory(input));
   return {
     config: async (config) => {
       config.provider ??= {};