opencode-websearch 0.1.0 → 0.1.2

package/dist/config.d.ts

@@ -0,0 +1,10 @@
+import { ConfigResult } from "./types.js";
+/**
+ * Resolve Anthropic configuration from multiple sources:
+ * 1. opencode.json config files (project-level, then global)
+ * 2. ANTHROPIC_API_KEY environment variable (fallback)
+ */
+declare const getAnthropicConfig: () => ConfigResult;
+declare const formatConfigError: (error?: string) => string;
+export { formatConfigError, getAnthropicConfig };
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EAIb,MAAM,YAAY,CAAC;AAiJpB;;;;GAIG;AACH,QAAA,MAAM,kBAAkB,QAAO,YAiB9B,CAAC;AAEF,QAAA,MAAM,iBAAiB,GAAI,QAAQ,MAAM,KAAG,MAuB3C,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,13 @@
+declare const DEFAULT_MODEL = "claude-sonnet-4-5";
+declare const DEFAULT_SEARCH_USES = 5;
+declare const EMPTY_LENGTH = 0;
+declare const ENV_VAR_CAPTURE_GROUP = 1;
+declare const FIRST_MODEL_INDEX = 0;
+declare const MAX_RESPONSE_TOKENS = 16000;
+declare const MAX_SEARCH_USES = 10;
+declare const MIN_QUERY_LENGTH = 2;
+declare const MIN_SEARCH_USES = 1;
+declare const MONTH_OFFSET = 1;
+declare const PAD_LENGTH = 2;
+export { DEFAULT_MODEL, DEFAULT_SEARCH_USES, EMPTY_LENGTH, ENV_VAR_CAPTURE_GROUP, FIRST_MODEL_INDEX, MAX_RESPONSE_TOKENS, MAX_SEARCH_USES, MIN_QUERY_LENGTH, MIN_SEARCH_USES, MONTH_OFFSET, PAD_LENGTH, };
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,aAAa,sBAAsB,CAAC;AAC1C,QAAA,MAAM,mBAAmB,IAAI,CAAC;AAC9B,QAAA,MAAM,YAAY,IAAI,CAAC;AACvB,QAAA,MAAM,qBAAqB,IAAI,CAAC;AAChC,QAAA,MAAM,iBAAiB,IAAI,CAAC;AAC5B,QAAA,MAAM,mBAAmB,QAAS,CAAC;AACnC,QAAA,MAAM,eAAe,KAAK,CAAC;AAC3B,QAAA,MAAM,gBAAgB,IAAI,CAAC;AAC3B,QAAA,MAAM,eAAe,IAAI,CAAC;AAC1B,QAAA,MAAM,YAAY,IAAI,CAAC;AACvB,QAAA,MAAM,UAAU,IAAI,CAAC;AAErB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,UAAU,GACX,CAAC"}

package/dist/helpers.d.ts

@@ -0,0 +1,6 @@
+declare const getTodayDate: () => string;
+declare const resolveEnvVar: (value: string) => string;
+declare const getCurrentMonthYear: () => string;
+declare const normalizeBaseURL: (url: string) => string;
+export { getCurrentMonthYear, getTodayDate, normalizeBaseURL, resolveEnvVar };
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,YAAY,QAAO,MAMxB,CAAC;AAEF,QAAA,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAMtC,CAAC;AAEF,QAAA,MAAM,mBAAmB,QAAO,MAC4C,CAAC;AAE7E,QAAA,MAAM,gBAAgB,GAAI,KAAK,MAAM,KAAG,MAAqC,CAAC;AAE9E,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC"}

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,27 +1,123 @@
-// src/index.ts
-import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { tool } from "@opencode-ai/plugin";
-import Anthropic, { APIError } from "@anthropic-ai/sdk";
+// src/constants.ts
 var DEFAULT_MODEL = "claude-sonnet-4-5";
-var MONTH_OFFSET = 1;
-var PAD_LENGTH = 2;
+var DEFAULT_SEARCH_USES = 5;
+var EMPTY_LENGTH = 0;
 var ENV_VAR_CAPTURE_GROUP = 1;
 var FIRST_MODEL_INDEX = 0;
-var EMPTY_LENGTH = 0;
+var MAX_RESPONSE_TOKENS = 16000;
+var MAX_SEARCH_USES = 10;
 var MIN_QUERY_LENGTH = 2;
 var MIN_SEARCH_USES = 1;
-var MAX_SEARCH_USES = 10;
-var DEFAULT_SEARCH_USES = 5;
-var MAX_RESPONSE_TOKENS = 16000;
-var getTodayDate = () => {
-  const now = new Date;
-  const year = now.getFullYear();
-  const month = String(now.getMonth() + MONTH_OFFSET).padStart(PAD_LENGTH, "0");
-  const day = String(now.getDate()).padStart(PAD_LENGTH, "0");
-  return `${year}-${month}-${day}`;
+
+// src/index.ts
+import { tool } from "@opencode-ai/plugin";
+
+// src/providers/anthropic.ts
+import Anthropic, { APIError } from "@anthropic-ai/sdk";
+var formatSearchResult = (result) => {
+  if (result.page_age) {
+    return `- [${result.title}](${result.url}) (Updated: ${result.page_age})`;
+  }
+  return `- [${result.title}](${result.url})`;
+};
+var processSearchToolResult = (block, results) => {
+  if (Array.isArray(block.content)) {
+    const searchResults = block.content;
+    if (searchResults.length === EMPTY_LENGTH) {
+      results.push("No results found.");
+    } else {
+      results.push(`
+Found ${searchResults.length} results:
+`);
+      for (const result of searchResults) {
+        results.push(formatSearchResult(result));
+      }
+    }
+  } else if (block.content?.type === "web_search_tool_result_error") {
+    results.push(`Search error: ${block.content.error_code}`);
+  }
+};
+var processBlock = (block, results) => {
+  if (block.type === "server_tool_use" && block.name === "web_search") {
+    results.push(`Search query: "${block.input.query}"`);
+    return;
+  }
+  if (block.type === "web_search_tool_result") {
+    processSearchToolResult(block, results);
+    return;
+  }
+  if (block.type === "text" && block.text) {
+    results.push(`
+${block.text}`);
+  }
+};
+var buildWebSearchTool = (args) => {
+  const searchTool = {
+    max_uses: args.max_uses ?? DEFAULT_SEARCH_USES,
+    name: "web_search",
+    type: "web_search_20250305"
+  };
+  if (args.allowed_domains?.length) {
+    searchTool.allowed_domains = args.allowed_domains;
+  }
+  if (args.blocked_domains?.length) {
+    searchTool.blocked_domains = args.blocked_domains;
+  }
+  return searchTool;
+};
+var formatErrorMessage = (error) => {
+  if (error instanceof APIError) {
+    return `Anthropic API error: ${error.message} (status: ${error.status})`;
+  }
+  if (error instanceof Error) {
+    return `Error performing web search: ${error.message}`;
+  }
+  return `Error performing web search: ${String(error)}`;
+};
+var createAnthropicClient = (config) => {
+  const options = {
+    apiKey: config.apiKey
+  };
+  if (config.baseURL) {
+    options.baseURL = config.baseURL;
+  }
+  return new Anthropic(options);
+};
+var appendUsageInfo = (usage, results) => {
+  if (usage.server_tool_use?.web_search_requests) {
+    results.push(`
+---
+Searches performed: ${usage.server_tool_use.web_search_requests}`);
+  }
+};
+var executeSearch = async (config, args) => {
+  const client = createAnthropicClient(config);
+  const webSearchTool = buildWebSearchTool(args);
+  const response = await client.messages.create({
+    max_tokens: MAX_RESPONSE_TOKENS,
+    messages: [
+      {
+        content: `Perform a web search for: ${args.query}`,
+        role: "user"
+      }
+    ],
+    model: config.model,
+    tools: [webSearchTool]
+  });
+  const results = [];
+  const content = response.content;
+  for (const block of content) {
+    processBlock(block, results);
+  }
+  appendUsageInfo(response.usage, results);
+  return results.join(`
+`) || "No results returned from web search.";
 };
+
+// src/config.ts
+import { existsSync, readFileSync } from "node:fs";
+
+// src/helpers.ts
 var resolveEnvVar = (value) => {
   const match = value.match(/^\{env:(\w+)\}$/);
   if (match?.[ENV_VAR_CAPTURE_GROUP]) {
@@ -29,7 +125,12 @@ var resolveEnvVar = (value) => {
   }
   return value;
 };
+var getCurrentMonthYear = () => new Date().toLocaleDateString("en-US", { month: "long", year: "numeric" });
 var normalizeBaseURL = (url) => url.replace(/\/v1\/?$/, "");
+
+// src/config.ts
+import { homedir } from "node:os";
+import { join } from "node:path";
 var CONFIG_PATHS = [
   join(process.cwd(), "opencode.json"),
   join(process.cwd(), ".opencode", "opencode.json"),
@@ -151,57 +252,6 @@ var getAnthropicConfig = () => {
   }
   return { config: null };
 };
-var formatSearchResult = (result) => {
-  if (result.page_age) {
-    return `- [${result.title}](${result.url}) (Updated: ${result.page_age})`;
-  }
-  return `- [${result.title}](${result.url})`;
-};
-var processSearchToolResult = (block, results) => {
-  if (Array.isArray(block.content)) {
-    const searchResults = block.content;
-    if (searchResults.length === EMPTY_LENGTH) {
-      results.push("No results found.");
-    } else {
-      results.push(`
-Found ${searchResults.length} results:
-`);
-      for (const result of searchResults) {
-        results.push(formatSearchResult(result));
-      }
-    }
-  } else if (block.content?.type === "web_search_tool_result_error") {
-    results.push(`Search error: ${block.content.error_code}`);
-  }
-};
-var processBlock = (block, results) => {
-  if (block.type === "server_tool_use" && block.name === "web_search") {
-    results.push(`Search query: "${block.input.query}"`);
-    return;
-  }
-  if (block.type === "web_search_tool_result") {
-    processSearchToolResult(block, results);
-    return;
-  }
-  if (block.type === "text" && block.text) {
-    results.push(`
-${block.text}`);
-  }
-};
-var buildWebSearchTool = (args) => {
-  const searchTool = {
-    max_uses: args.max_uses ?? DEFAULT_SEARCH_USES,
-    name: "web_search",
-    type: "web_search_20250305"
-  };
-  if (args.allowed_domains?.length) {
-    searchTool.allowed_domains = args.allowed_domains;
-  }
-  if (args.blocked_domains?.length) {
-    searchTool.blocked_domains = args.blocked_domains;
-  }
-  return searchTool;
-};
 var formatConfigError = (error) => {
   let hint = "";
   if (error) {
@@ -227,54 +277,8 @@ Set the ANTHROPIC_API_KEY environment variable, or add an Anthropic provider to
   }
 }${hint}`;
 };
-var formatErrorMessage = (error) => {
-  if (error instanceof APIError) {
-    return `Anthropic API error: ${error.message} (status: ${error.status})`;
-  }
-  if (error instanceof Error) {
-    return `Error performing web search: ${error.message}`;
-  }
-  return `Error performing web search: ${String(error)}`;
-};
-var createAnthropicClient = (config) => {
-  const options = {
-    apiKey: config.apiKey
-  };
-  if (config.baseURL) {
-    options.baseURL = config.baseURL;
-  }
-  return new Anthropic(options);
-};
-var appendUsageInfo = (usage, results) => {
-  if (usage.server_tool_use?.web_search_requests) {
-    results.push(`
----
-Searches performed: ${usage.server_tool_use.web_search_requests}`);
-  }
-};
-var executeSearch = async (config, args) => {
-  const client = createAnthropicClient(config);
-  const webSearchTool = buildWebSearchTool(args);
-  const response = await client.messages.create({
-    max_tokens: MAX_RESPONSE_TOKENS,
-    messages: [
-      {
-        content: `Perform a web search for: ${args.query}`,
-        role: "user"
-      }
-    ],
-    model: config.model,
-    tools: [webSearchTool]
-  });
-  const results = [];
-  const content = response.content;
-  for (const block of content) {
-    processBlock(block, results);
-  }
-  appendUsageInfo(response.usage, results);
-  return results.join(`
-`) || "No results returned from web search.";
-};
+
+// src/index.ts
 var src_default = async () => ({
   tool: {
     "web-search": tool({
@@ -284,15 +288,30 @@ var src_default = async () => ({
         max_uses: tool.schema.number().min(MIN_SEARCH_USES).max(MAX_SEARCH_USES).optional().describe("Maximum number of searches to perform (default: 5)"),
         query: tool.schema.string().min(MIN_QUERY_LENGTH).describe("The search query to execute")
       },
-      description: `Search the web using Anthropic's server-side web_search API.
-
+      description: `- Allows OpenCode to search the web and use the results to inform responses
 - Provides up-to-date information for current events and recent data
-- Returns search results with links as markdown hyperlinks
-- Use this for accessing information beyond the knowledge cutoff
+- Returns search result information formatted as search result blocks, including links as markdown hyperlinks
+- Use this tool for accessing information beyond the model's knowledge cutoff
+- Searches are performed automatically within a single API call
+
+CRITICAL REQUIREMENT - You MUST follow this:
+  - After answering the user's question, you MUST include a "Sources:" section at the end of your response
+  - In the Sources section, list all relevant URLs from the search results as markdown hyperlinks: [Title](URL)
+  - This is MANDATORY - never skip including sources in your response
+  - Example format:
+
+    [Your answer here]
+
+    Sources:
+    - [Source Title 1](https://example.com/1)
+    - [Source Title 2](https://example.com/2)
 
-CRITICAL: After answering, you MUST include a "Sources:" section with URLs as markdown hyperlinks.
+Usage notes:
+  - Domain filtering is supported to include or block specific websites
 
-Today's date: ${getTodayDate()}. Use the current year when searching for recent information.`,
+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) {
         const { config, error } = getAnthropicConfig();
         if (!config) {

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,10 @@
+import { AnthropicConfig } from "../types.js";
+declare const formatErrorMessage: (error: unknown) => string;
+declare const executeSearch: (config: AnthropicConfig, args: {
+    allowed_domains?: string[];
+    blocked_domains?: string[];
+    max_uses?: number;
+    query: string;
+}) => Promise<string>;
+export { executeSearch, formatErrorMessage };
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EAKhB,MAAM,aAAa,CAAC;AAqErB,QAAA,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,MAQ5C,CAAC;AAoBF,QAAA,MAAM,aAAa,GACjB,QAAQ,eAAe,EACvB,MAAM;IACJ,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,KACA,OAAO,CAAC,MAAM,CA0BhB,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+interface AnthropicConfig {
+    apiKey: string;
+    baseURL?: string;
+    model: string;
+}
+interface OpenCodeProvider {
+    models?: Record<string, {
+        name?: string;
+    }>;
+    npm?: string;
+    options?: {
+        apiKey?: string;
+        baseURL?: string;
+    };
+}
+interface OpenCodeConfig {
+    provider?: Record<string, OpenCodeProvider>;
+}
+interface ConfigResult {
+    config: AnthropicConfig | null;
+    error?: string;
+}
+interface ProviderContext {
+    configPath: string;
+    errors: string[];
+    providerName: string;
+}
+interface WebSearchResult {
+    page_age?: string;
+    title: string;
+    type: "web_search_result";
+    url: string;
+}
+interface WebSearchToolResult {
+    content: WebSearchResult[] | {
+        error_code: string;
+        type: "web_search_tool_result_error";
+    };
+    tool_use_id: string;
+    type: "web_search_tool_result";
+}
+interface ServerToolUse {
+    id: string;
+    input: {
+        query: string;
+    };
+    name: string;
+    type: "server_tool_use";
+}
+interface SearchUsage {
+    input_tokens: number;
+    output_tokens: number;
+    server_tool_use?: {
+        web_search_requests?: number;
+    };
+}
+type ContentBlock = {
+    text: string;
+    type: "text";
+} | ServerToolUse | WebSearchToolResult;
+export { AnthropicConfig, ConfigResult, ContentBlock, OpenCodeConfig, OpenCodeProvider, ProviderContext, SearchUsage, ServerToolUse, WebSearchResult, WebSearchToolResult, };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,gBAAgB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC7C;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,eAAe;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,UAAU,eAAe;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,mBAAmB,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,mBAAmB;IAC3B,OAAO,EAAE,eAAe,EAAE,GAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,8BAA8B,CAAA;KAAE,CAAC;IAC1F,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,wBAAwB,CAAC;CAChC;AAED,UAAU,aAAa;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,UAAU,WAAW;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE;QAAE,mBAAmB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAED,KAAK,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,GAAG,mBAAmB,CAAC;AAEzF,OAAO,EACL,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,aAAa,EACb,eAAe,EACf,mBAAmB,GACpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-websearch",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Claude Code's WebSearch tool ported to OpenCode",
   "type": "module",
   "main": "dist/index.js",
@@ -18,9 +18,12 @@
     "build": "bun build src/index.ts --outdir dist --target node --format esm --packages external && bun run build:types",
     "build:types": "tsc --emitDeclarationOnly --declaration --outDir dist",
     "dev": "bun run --watch src/index.ts",
+    "format": "oxfmt src/",
+    "format:check": "oxfmt --check src/",
     "lint": "oxlint --tsconfig tsconfig.json src/",
+    "lint:fix": "oxlint --tsconfig tsconfig.json --fix src/",
     "typecheck": "tsc --noEmit",
-    "check": "bun run lint && bun run typecheck",
+    "check": "bun run format:check && bun run lint && bun run typecheck",
     "prepublishOnly": "bun run check && bun run build"
   },
   "keywords": [
@@ -30,6 +33,13 @@
     "anthropic",
     "ai"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/emilsvennesson/opencode-websearch.git"
+  },
+  "engines": {
+    "node": ">=24"
+  },
   "license": "MIT",
   "dependencies": {
     "@anthropic-ai/sdk": "^0.52.0"
@@ -37,6 +47,7 @@
   "devDependencies": {
     "@opencode-ai/plugin": "^1.1.65",
     "@types/bun": "latest",
+    "oxfmt": "^0.32.0",
     "oxlint": "^1.47.0",
     "typescript": "^5.8.0"
   },