@khalilgharbaoui/opencode-claude-code-plugin 0.8.0 → 0.8.2

package/README.md

@@ -92,6 +92,34 @@ Variants set the underlying reasoning effort. They're regular opencode model var
 
 ---
 
+## Billing change: June 15, 2026 (Agent SDK credit)
+
+This plugin drives Claude Code headlessly (`claude --print`), which Anthropic bills as [`claude -p` / Agent SDK usage](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan). Starting **June 15, 2026**, on subscription plans that usage no longer counts toward your normal plan limits — it draws from a separate monthly **Agent SDK credit**:
+
+| Plan | Monthly credit |
+|---|---|
+| Pro | $20 |
+| Max 5x | $100 |
+| Max 20x | $200 |
+| Team Standard | $20/seat |
+| Team Premium | $100/seat |
+| Enterprise (Standard seats) | none |
+
+What this means for plugin users:
+
+- **Claim the credit once.** It's a one-time opt-in via your Claude account (claim emails started going out June 8, 2026); after that it refreshes every billing cycle. Unused credit does not roll over.
+- **When the credit runs out, plugin requests stop** until the next billing cycle — unless you enable usage credits in your Claude account, in which case overflow is billed at standard API rates.
+- **The credit is denominated in dollars at standard API rates**, so the Price × column above maps directly to how fast each model drains it — Fable 5 / Mythos 5 burn it 10× faster than Haiku, 2× faster than Opus 4.8.
+- **API-key auth is unaffected.** If your `claude` CLI authenticates with an Anthropic API key / Console billing instead of a subscription, nothing changes — pay-as-you-go as before.
+- **Interactive Claude Code in your terminal is unaffected.** The change targets programmatic usage only: the Agent SDK, `claude -p`, Claude Code GitHub Actions, and third-party apps like this plugin.
+
+Two related dates:
+
+- **June 15, 2026** also retires the original Claude 4 model IDs `claude-sonnet-4-20250514` and `claude-opus-4-20250514` from the API. The plugin doesn't register either, but model IDs pass straight through to `claude --model` — if you've configured one of these as an override, migrate to `claude-sonnet-4-6` / `claude-opus-4-8` before then.
+- **June 22, 2026** is the last day [Fable 5 is included at no extra cost](https://platform.claude.com/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5) on Pro, Max, Team, and seat-based Enterprise plans. From June 23, `claude-fable-5` requires usage credits (Anthropic says it aims to fold it back into plans once capacity allows). `claude-mythos-5` is unaffected — it's Glasswing access-gated either way.
+
+---
+
 ## Configuration
 
 The minimum config is just the `plugin` entry above. Everything below is optional override that goes in a `provider.claude-code` block.
@@ -251,7 +279,7 @@ Claude Code ships a built-in `WebSearch` tool. The `webSearch` option controls w
 
 | `webSearch` value | Behavior | When to use |
 |---|---|---|
-| `"claude"` (default) | Claude CLI runs WebSearch internally via Anthropic. Zero setup, no extra cost, no API key. | Most users. |
+| `"claude"` (default) | Claude CLI runs WebSearch internally via Anthropic. Zero setup, no extra cost, no API key. The query is shown in the transcript as a `> Web search:` line (opencode has no `WebSearch` tool registry entry, so a raw tool row would render as `⚙ invalid`). | Most users. |
 | `"<opencode-tool-name>"` (e.g. `"websearch_web_search_exa"`) | Forward to that opencode-side tool with `executed:false`. Requires the corresponding MCP server to be configured in opencode (e.g. [exa-mcp-server](https://github.com/exa-labs/exa-mcp-server)). | You want a specific search backend (Exa, Tavily, Brave) and have the MCP wired up in opencode. |
 | `"disabled"` | `WebSearch` is added to `--disallowedTools` so the model can't call it. | Compliance/security scenarios where outbound search isn't allowed. |
 

package/dist/index.js

@@ -210,6 +210,12 @@ function clearLedger(sessionId) {
 }
 
 // src/tool-mapping.ts
+function isWebSearchTool(name) {
+  return name === "WebSearch" || name === "web_search";
+}
+function isWebSearchHandledByCli(route) {
+  return !route || route === "claude" || route === "disabled";
+}
 function mapToolInput(name, input) {
   if (!input) return input;
   switch (name) {
@@ -326,7 +332,7 @@ function mapTool(name, input, opts) {
     const mappedInput = mapToolInput(name, input);
     return { name: "todowrite", input: mappedInput, executed: false };
   }
-  if (name === "WebSearch" || name === "web_search") {
+  if (isWebSearchTool(name)) {
     const mappedInput = input?.query ? { query: input.query } : input;
     const route = opts?.webSearch;
     if (route && route !== "claude" && route !== "disabled") {
@@ -334,7 +340,7 @@ function mapTool(name, input, opts) {
       return { name: route, input: mappedInput, executed: false };
     }
     log.debug("WebSearch executed by Claude CLI", { mappedInput });
-    return { name: "WebSearch", input: mappedInput, executed: true };
+    return { name: "WebSearch", input: mappedInput, executed: true, skip: true };
   }
   if (name === "TaskOutput") {
     if (!input) return { name: "bash", executed: false };
@@ -3372,11 +3378,13 @@ ${plan}
                 }
                 if (block.type === "tool_use" && block.id && block.name) {
                   noteToolActivity();
-                  toolCallMap.set(idx, {
+                  const entry = {
                     id: block.id,
                     name: block.name,
-                    inputJson: ""
-                  });
+                    inputJson: "",
+                    started: false
+                  };
+                  toolCallMap.set(idx, entry);
                   if (block.name !== "AskUserQuestion" && block.name !== "ask_user_question" && block.name !== "ExitPlanMode" && !block.name.startsWith(PROXY_TOOL_PREFIX)) {
                     const { name: mappedName, skip, executed } = mapTool(
                       block.name,
@@ -3388,6 +3396,7 @@ ${plan}
                       }
                     );
                     if (!skip) {
+                      entry.started = true;
                       controller.enqueue({
                         type: "tool-input-start",
                         id: block.id,
@@ -3439,11 +3448,13 @@ ${plan}
                   const tc = toolCallMap.get(idx);
                   if (tc) {
                     tc.inputJson += delta.partial_json;
-                    controller.enqueue({
-                      type: "tool-input-delta",
-                      id: tc.id,
-                      delta: delta.partial_json
-                    });
+                    if (tc.started) {
+                      controller.enqueue({
+                        type: "tool-input-delta",
+                        id: tc.id,
+                        delta: delta.partial_json
+                      });
+                    }
                   }
                 }
                 if (!KNOWN_DELTA_TYPES.has(delta.type)) {
@@ -3495,6 +3506,17 @@ ${plan}
 
 ---
 **Do you want to proceed with this plan?** (yes/no)
+`
+                    });
+                    endTextBlock();
+                  } else if (isWebSearchTool(tc.name) && isWebSearchHandledByCli(self.config.webSearch)) {
+                    const query = typeof parsedInput?.query === "string" ? parsedInput.query : JSON.stringify(parsedInput);
+                    const searchId = startTextBlock();
+                    controller.enqueue({
+                      type: "text-delta",
+                      id: searchId,
+                      delta: `
+> **Web search:** ${query}
 `
                     });
                     endTextBlock();
@@ -3654,6 +3676,18 @@ ${plan}
 
 ---
 **Do you want to proceed with this plan?** (yes/no)
+`
+                      });
+                      endTextBlock();
+                    } else if (isWebSearchTool(block.name) && isWebSearchHandledByCli(self.config.webSearch)) {
+                      toolCallsById.delete(block.id);
+                      const query = typeof parsedInput?.query === "string" ? parsedInput.query : JSON.stringify(parsedInput);
+                      const searchId = startTextBlock();
+                      controller.enqueue({
+                        type: "text-delta",
+                        id: searchId,
+                        delta: `
+> **Web search:** ${query}
 `
                       });
                       endTextBlock();