@smithers-orchestrator/agents 0.24.2 → 0.25.1

package/src/web-search/createSerperSearchProvider.js

@@ -0,0 +1,63 @@
+/** @typedef {import("./GroundedWebSearchProvider.ts").GroundedWebSearchProvider} GroundedWebSearchProvider */
+
+/**
+ * @param {{ apiKey: string; baseUrl?: string; fetch?: typeof fetch }} options
+ * @returns {GroundedWebSearchProvider}
+ */
+export function createSerperSearchProvider(options) {
+  return {
+    name: "serper",
+    kind: "fresh",
+    async search(input) {
+      const fetchImpl = options.fetch ?? fetch;
+      const response = await fetchImpl(options.baseUrl ?? "https://google.serper.dev/search", {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          "x-api-key": options.apiKey,
+        },
+        body: JSON.stringify({
+          q: input.query,
+          num: input.maxResults,
+          ...freshnessParams(input.freshness),
+        }),
+      });
+      const body = await readJson(response, "Serper");
+      const results = Array.isArray(body.organic) ? body.organic : [];
+      return results.map((result) => ({
+        title: String(result.title ?? result.link ?? "Untitled"),
+        url: String(result.link ?? ""),
+        snippet: result.snippet,
+        publishedDate: result.date,
+      })).filter((result) => result.url);
+    },
+  };
+}
+
+/** @param {string | undefined} freshness */
+function freshnessParams(freshness) {
+  const tbs = freshnessTbs(freshness);
+  return tbs ? { tbs } : {};
+}
+
+/** @param {string | undefined} freshness */
+function freshnessTbs(freshness) {
+  if (freshness === "day") return "qdr:d";
+  if (freshness === "week") return "qdr:w";
+  if (freshness === "month") return "qdr:m";
+  if (freshness === "year") return "qdr:y";
+  return undefined;
+}
+
+/**
+ * @param {Response} response
+ * @param {string} provider
+ * @returns {Promise<any>}
+ */
+async function readJson(response, provider) {
+  const text = await response.text();
+  if (!response.ok) {
+    throw new Error(`${provider} search failed (${response.status}): ${text}`);
+  }
+  return text ? JSON.parse(text) : {};
+}

package/src/web-search/createTavilySearchProvider.js

@@ -0,0 +1,59 @@
+/** @typedef {import("./GroundedWebSearchProvider.ts").GroundedWebSearchProvider} GroundedWebSearchProvider */
+
+/**
+ * @param {{ apiKey: string; baseUrl?: string; fetch?: typeof fetch }} options
+ * @returns {GroundedWebSearchProvider}
+ */
+export function createTavilySearchProvider(options) {
+  return {
+    name: "tavily",
+    kind: "fresh",
+    async search(input) {
+      const fetchImpl = options.fetch ?? fetch;
+      const response = await fetchImpl(`${options.baseUrl ?? "https://api.tavily.com"}/search`, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          authorization: `Bearer ${options.apiKey}`,
+        },
+        body: JSON.stringify({
+          query: input.query,
+          max_results: input.maxResults,
+          topic: input.freshness ? "news" : "general",
+          days: freshnessDays(input.freshness),
+        }),
+      });
+      const body = await readJson(response, "Tavily");
+      const results = Array.isArray(body.results) ? body.results : [];
+      return results.map((result) => ({
+        title: String(result.title ?? result.url ?? "Untitled"),
+        url: String(result.url ?? ""),
+        snippet: result.content,
+        publishedDate: result.published_date,
+        score: typeof result.score === "number" ? result.score : undefined,
+      })).filter((result) => result.url);
+    },
+  };
+}
+
+/** @param {string | undefined} freshness */
+function freshnessDays(freshness) {
+  if (freshness === "day") return 1;
+  if (freshness === "week") return 7;
+  if (freshness === "month") return 30;
+  if (freshness === "year") return 365;
+  return undefined;
+}
+
+/**
+ * @param {Response} response
+ * @param {string} provider
+ * @returns {Promise<any>}
+ */
+async function readJson(response, provider) {
+  const text = await response.text();
+  if (!response.ok) {
+    throw new Error(`${provider} search failed (${response.status}): ${text}`);
+  }
+  return text ? JSON.parse(text) : {};
+}

package/src/web-search/index.js

@@ -0,0 +1,5 @@
+export { createGroundedWebSearchToolset } from "./createGroundedWebSearchToolset.js";
+export { createExaSearchProvider } from "./createExaSearchProvider.js";
+export { createTavilySearchProvider } from "./createTavilySearchProvider.js";
+export { createBraveSearchProvider } from "./createBraveSearchProvider.js";
+export { createSerperSearchProvider } from "./createSerperSearchProvider.js";

package/src/zodToOpenAISchema.js

@@ -1,3 +1,4 @@
+import { assertZodV4 } from "@smithers-orchestrator/errors/assertZodV4";
 import { sanitizeForOpenAI } from "./sanitizeForOpenAI.js";
 /**
  * Convert a Zod schema to an OpenAI-safe JSON Schema object.
@@ -9,6 +10,9 @@ import { sanitizeForOpenAI } from "./sanitizeForOpenAI.js";
  * ```
  */
 export async function zodToOpenAISchema(zodSchema) {
+    // z.toJSONSchema() reads Zod v4 internals; a v3 schema throws a cryptic
+    // `schema._zod.def` TypeError. Surface a clear, actionable error instead.
+    assertZodV4(zodSchema);
     const { z } = await import("zod");
     const jsonSchema = z.toJSONSchema(zodSchema);
     sanitizeForOpenAI(jsonSchema);

package/src/OpenCodeAgent.ts

@@ -1,43 +0,0 @@
-import { type CliOutputInterpreter, BaseCliAgent } from "./BaseCliAgent";
-import type { BaseCliAgentOptions } from "./BaseCliAgent";
-import { type AgentCapabilityRegistry } from "./capability-registry";
-
-export type OpenCodeAgentOptions = BaseCliAgentOptions & {
-  /** Model identifier (e.g., "anthropic/claude-opus-4-20250514", "openai/gpt-5.4") */
-  model?: string;
-  /** OpenCode agent name (maps to --agent flag, selects predefined agent config) */
-  agentName?: string;
-  /** Files to attach to the prompt via -f flags */
-  attachFiles?: string[];
-  /** Continue a previous session */
-  continueSession?: boolean;
-  /** Resume a specific session by ID */
-  sessionId?: string;
-  /** Provider-specific model variant/reasoning effort level */
-  variant?: string;
-};
-
-export declare function createOpenCodeCapabilityRegistry(
-  opts?: OpenCodeAgentOptions
-): AgentCapabilityRegistry;
-
-export declare class OpenCodeAgent extends BaseCliAgent {
-  private readonly opts: OpenCodeAgentOptions;
-  readonly capabilities: AgentCapabilityRegistry;
-  readonly cliEngine: "opencode";
-  constructor(opts?: OpenCodeAgentOptions);
-  createOutputInterpreter(): CliOutputInterpreter;
-  buildCommand(params: {
-    prompt: string;
-    systemPrompt?: string;
-    cwd: string;
-    options: any;
-  }): Promise<{
-    command: string;
-    args: string[];
-    outputFormat: "stream-json";
-    env?: Record<string, string>;
-    stdoutBannerPatterns: RegExp[];
-    stdoutErrorPatterns: RegExp[];
-  }>;
-}