opencode-websearch 0.2.0 → 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>;
 }
 /**
@@ -16,5 +17,5 @@ interface ProviderData {
  */
 declare const resolveFromProviders: (providers: ProviderData[]) => AnthropicConfig | null;
 declare const formatConfigError: () => string;
-export { formatConfigError, resolveFromProviders };
+export { formatConfigError, ProviderData, resolveFromProviders };
 //# sourceMappingURL=config.d.ts.map

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,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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AASA,wBAsEoB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AA2BA,wBAsEoB"}

package/dist/index.js

@@ -10,6 +10,70 @@ var MIN_SEARCH_USES = 1;
 // src/index.ts
 import { tool } from "@opencode-ai/plugin";
 
+// src/config.ts
+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;
+  }
+  return normalizeBaseURL(options.baseURL);
+};
+var resolveFromProviders = (providers) => {
+  for (const provider of providers) {
+    for (const model of Object.values(provider.models)) {
+      if (isAnthropicModel(model) && hasWebSearch(model)) {
+        const apiKey = provider.key ?? extractApiKey(provider.options);
+        if (!apiKey) {
+          return null;
+        }
+        return {
+          apiKey,
+          baseURL: extractBaseURL(provider.options),
+          model: model.id
+        };
+      }
+    }
+  }
+  return null;
+};
+var formatConfigError = () => `Error: web-search requires an Anthropic provider with \`websearch: true\` set on at least one model.
+
+No model with \`"websearch": true\` was found in your opencode.json configuration.
+
+To fix this, add an Anthropic provider to your opencode.json and set \`"websearch": true\` in the options of the model you want to use for web searches:
+
+{
+  "provider": {
+    "anthropic": {
+      "npm": "@ai-sdk/anthropic",
+      "options": {
+        "apiKey": "{env:ANTHROPIC_API_KEY}"
+      },
+      "models": {
+        "claude-sonnet-4-5": {
+          "options": {
+            "websearch": true
+          }
+        }
+      }
+    }
+  }
+}
+
+Steps:
+1. Open your opencode.json (project root, .opencode/opencode.json, or ~/.config/opencode/opencode.json)
+2. Ensure you have an Anthropic provider configured with a valid API key
+3. Add \`"websearch": true\` to the \`options\` of the Claude model you want to use for web search
+4. Restart OpenCode to pick up the configuration change`;
+
 // src/providers/anthropic.ts
 import Anthropic, { APIError } from "@anthropic-ai/sdk";
 var formatSearchResult = (result) => {
@@ -112,73 +176,19 @@ var executeSearch = async (config, args) => {
 `) || "No results returned from web search.";
 };
 
-// src/config.ts
-var isAnthropicModel = (model) => model.api.npm === ANTHROPIC_NPM_PACKAGE;
-var hasWebSearch = (model) => model.options.websearch === true;
-var normalizeBaseURL = (url) => url.replace(/\/v1\/?$/, "");
-var extractBaseURL = (options) => {
-  if (typeof options.baseURL !== "string") {
-    return;
-  }
-  return normalizeBaseURL(options.baseURL);
-};
-var resolveFromProviders = (providers) => {
-  for (const provider of providers) {
-    for (const model of Object.values(provider.models)) {
-      if (isAnthropicModel(model) && hasWebSearch(model)) {
-        if (!provider.key) {
-          return null;
-        }
-        return {
-          apiKey: provider.key,
-          baseURL: extractBaseURL(provider.options),
-          model: model.id
-        };
-      }
-    }
-  }
-  return null;
-};
-var formatConfigError = () => `Error: web-search requires an Anthropic provider with \`websearch: true\` set on at least one model.
-
-No model with \`"websearch": true\` was found in your opencode.json configuration.
-
-To fix this, add an Anthropic provider to your opencode.json and set \`"websearch": true\` in the options of the model you want to use for web searches:
-
-{
-  "provider": {
-    "anthropic": {
-      "npm": "@ai-sdk/anthropic",
-      "options": {
-        "apiKey": "{env:ANTHROPIC_API_KEY}"
-      },
-      "models": {
-        "claude-sonnet-4-5": {
-          "options": {
-            "websearch": true
-          }
-        }
-      }
-    }
-  }
-}
-
-Steps:
-1. Open your opencode.json (project root, .opencode/opencode.json, or ~/.config/opencode/opencode.json)
-2. Ensure you have an Anthropic provider configured with a valid API key
-3. Add \`"websearch": true\` to the \`options\` of the Claude model you want to use for web search
-4. Restart OpenCode to pick up the configuration change`;
-
 // src/helpers.ts
 var getCurrentMonthYear = () => new Date().toLocaleDateString("en-US", { month: "long", year: "numeric" });
 
 // src/index.ts
-var src_default = async (input) => {
-  const { data } = await input.client.config.providers();
-  let config = null;
+var resolveConfig = async (client) => {
+  const { data } = await client.config.providers();
   if (data) {
-    config = resolveFromProviders(data.providers);
+    return resolveFromProviders(data.providers);
   }
+  return null;
+};
+var src_default = async (input) => {
+  let config = null;
   return {
     tool: {
       "web-search": tool({
@@ -213,6 +223,9 @@ IMPORTANT - Use the correct year in search queries:
   - It is currently ${getCurrentMonthYear()}. You MUST use this when searching for recent information, documentation, or current events.
   - Example: If the user asks for "latest React docs", search for "React documentation" with the current year, NOT last year`,
         async execute(args) {
+          if (!config) {
+            config = await resolveConfig(input.client);
+          }
           if (!config) {
             return formatConfigError();
           }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opencode-websearch",
-  "version": "0.2.0",
-  "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",