opencode-websearch 0.2.1 → 0.2.3

package/README.md

@@ -16,41 +16,49 @@ OpenCode will install it automatically at startup.
 
 ## Configuration
 
-The plugin needs an Anthropic API key. It resolves credentials in this order:
+The plugin looks for an Anthropic provider (`@ai-sdk/anthropic`) with `"websearch": true` set on at least one model. It picks up credentials however you've configured them in OpenCode -- via `/connect`, environment variables, or `options.apiKey` in your config.
 
-1. **opencode.json** -- looks for an `@ai-sdk/anthropic` provider in your project or global config
-2. **Environment variable** -- falls back to `ANTHROPIC_API_KEY`
+Add `"websearch": true` to the model you want the plugin to use for searches:
 
-### Option 1: opencode.json provider (recommended)
+```json
+{
+  "provider": {
+    "anthropic": {
+      "models": {
+        "claude-sonnet-4-5": {
+          "options": {
+            "websearch": true
+          }
+        }
+      }
+    }
+  }
+}
+```
 
-If you already have an Anthropic provider configured, the plugin will use it automatically:
+This also works with custom providers that use `@ai-sdk/anthropic`, such as a LiteLLM proxy:
 
 ```json
 {
   "provider": {
-    "anthropic": {
+    "my-anthropic": {
       "npm": "@ai-sdk/anthropic",
       "options": {
-        "apiKey": "{env:ANTHROPIC_API_KEY}"
+        "baseURL": "http://localhost:4000/v1/",
+        "apiKey": "{env:MY_API_KEY}"
       },
       "models": {
-        "claude-sonnet-4-5": { "name": "Claude Sonnet 4.5" }
+        "claude-sonnet-4-5": {
+          "options": {
+            "websearch": true
+          }
+        }
       }
     }
   }
 }
 ```
 
-The model used for search is the first model listed in the provider config.
-
-### Option 2: environment variable
-
-```sh
-export ANTHROPIC_API_KEY=sk-ant-...
-```
-
-When using the env var fallback, `claude-sonnet-4-5` is used as the default model.
-
 ## Usage
 
 Once configured, the `web-search` tool is available to the AI agent. It accepts:
@@ -68,15 +76,36 @@ Results are returned as formatted markdown with source links.
 
 ## Development
 
+### Local Development
+
+To develop or customize the plugin locally, clone the repo and symlink the
+source entry point into your OpenCode plugin directory:
+
 ```sh
-# Install dependencies
+git clone https://github.com/emilsvennesson/opencode-websearch ~/.config/opencode/opencode-websearch
+cd ~/.config/opencode/opencode-websearch
 bun install
+mkdir -p ~/.config/opencode/plugin
+ln -sf ~/.config/opencode/opencode-websearch/src/index.ts ~/.config/opencode/plugin/websearch.ts
+```
+
+OpenCode will load the plugin directly from source on startup. Any edits to the
+files in `src/` take effect next time you start OpenCode.
 
-# Type check
-bun run typecheck
+> **Note:** When using the symlink approach, remove `"opencode-websearch"` from
+> the `plugin` array in your `opencode.json` to avoid loading the plugin twice.
 
-# Build
-bun run build
+### Commands
+
+```sh
+bun install            # install dependencies
+bun run format         # auto-format source files
+bun run format:check   # verify formatting (no changes)
+bun run lint           # run oxlint
+bun run lint:fix       # auto-fix lint issues
+bun run typecheck      # type check with tsc
+bun run check          # format:check + lint + typecheck (full quality gate)
+bun run build          # ESM bundle + declaration files → dist/
 ```
 
 ## License

package/dist/config.d.ts

@@ -1,5 +1,7 @@
 import { AnthropicConfig } from "./types.js";
 interface ProviderData {
+    id: string;
+    key?: string;
     models: Record<string, {
         api: {
             npm: string;
@@ -7,7 +9,6 @@ interface ProviderData {
         id: string;
         options: Record<string, unknown>;
     }>;
-    key?: string;
     options: Record<string, unknown>;
 }
 /**

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI7C,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAC/F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAqBD;;;GAGG;AACH,QAAA,MAAM,oBAAoB,GAAI,WAAW,YAAY,EAAE,KAAG,eAAe,GAAG,IAgB3E,CAAC;AAIF,QAAA,MAAM,iBAAiB,QAAO,MA6B0B,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI7C,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAC/F,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AA4BD;;;GAGG;AACH,QAAA,MAAM,oBAAoB,GAAI,WAAW,YAAY,EAAE,KAAG,eAAe,GAAG,IAiB3E,CAAC;AAIF,QAAA,MAAM,iBAAiB,QAAO,MA6B0B,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/index.js

@@ -14,6 +14,12 @@ import { tool } from "@opencode-ai/plugin";
 var isAnthropicModel = (model) => model.api.npm === ANTHROPIC_NPM_PACKAGE;
 var hasWebSearch = (model) => model.options.websearch === true;
 var normalizeBaseURL = (url) => url.replace(/\/v1\/?$/, "");
+var extractApiKey = (options) => {
+  if (typeof options.apiKey !== "string") {
+    return;
+  }
+  return options.apiKey;
+};
 var extractBaseURL = (options) => {
   if (typeof options.baseURL !== "string") {
     return;
@@ -24,11 +30,12 @@ var resolveFromProviders = (providers) => {
   for (const provider of providers) {
     for (const model of Object.values(provider.models)) {
       if (isAnthropicModel(model) && hasWebSearch(model)) {
-        if (!provider.key) {
+        const apiKey = provider.key ?? extractApiKey(provider.options);
+        if (!apiKey) {
           return null;
         }
         return {
-          apiKey: provider.key,
+          apiKey,
           baseURL: extractBaseURL(provider.options),
           model: model.id
         };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opencode-websearch",
-  "version": "0.2.1",
-  "description": "Claude Code's WebSearch tool ported to OpenCode",
+  "version": "0.2.3",
+  "description": "Web search plugin for OpenCode, inspired by Claude Code's WebSearch tool",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",