@radaros/core 0.3.1 → 0.3.2

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import * as zod from 'zod';
 import { z } from 'zod';
 
 type MessageRole = "system" | "user" | "assistant" | "tool";
@@ -341,6 +342,7 @@ declare class Agent {
     get modelId(): string;
     get providerId(): string;
     get hasStructuredOutput(): boolean;
+    get structuredOutputSchema(): zod.ZodSchema | undefined;
     constructor(config: AgentConfig);
     run(input: MessageContent, opts?: RunOpts): Promise<RunOutput>;
     stream(input: MessageContent, opts?: RunOpts): AsyncGenerator<StreamChunk>;
@@ -1280,4 +1282,36 @@ declare class HackerNewsToolkit extends Toolkit {
     getTools(): ToolDef[];
 }
 
-export { type A2AAgentCard, type A2AArtifact, type A2ADataPart, type A2AFilePart, type A2AJsonRpcRequest, type A2AJsonRpcResponse, type A2AMessage, type A2APart, A2ARemoteAgent, type A2ARemoteAgentConfig, type A2ASendParams, type A2ASkill, type A2ATask, type A2ATaskQueryParams, type A2ATaskState, type A2ATextPart, Agent, type AgentConfig, type AgentEventMap, type AgentHooks, type AgentStep, AnthropicProvider, type Artifact, type AudioPart, BaseVectorStore, type ChatMessage, type ConditionStep, type ContentPart, type EmbeddingProvider, EventBus, type FilePart, type FunctionStep, type GmailConfig, GmailToolkit, GoogleEmbedding, type GoogleEmbeddingConfig, GoogleProvider, type GuardrailResult, type HackerNewsConfig, HackerNewsToolkit, type ImagePart, InMemoryStorage, InMemoryVectorStore, type InputGuardrail, KnowledgeBase, type KnowledgeBaseConfig, type KnowledgeBaseToolConfig, LLMLoop, type LogLevel, Logger, type LoggerConfig, MCPToolProvider, type MCPToolProviderConfig, Memory, type MemoryConfig, type MemoryEntry, type MessageContent, type MessageRole, type ModelConfig, type ModelProvider, ModelRegistry, type ModelResponse, MongoDBStorage, type MongoDBVectorConfig, MongoDBVectorStore, OllamaProvider, OpenAIEmbedding, type OpenAIEmbeddingConfig, OpenAIProvider, type OutputGuardrail, type ParallelStep, type PgVectorConfig, PgVectorStore, PostgresStorage, type QdrantConfig, QdrantVectorStore, RunContext, type RunOpts, type RunOutput, type Session, SessionManager, SqliteStorage, type StepDef, type StepResult, type StorageDriver, type StreamChunk, Team, type TeamConfig, TeamMode, type TextPart, type TokenUsage, type ToolCall, type ToolCallResult, type ToolDef, type ToolDefinition, ToolExecutor, type ToolResult, Toolkit, type VectorDocument, type VectorSearchOptions, type VectorSearchResult, type VectorStore, type VertexAIConfig, VertexAIProvider, type WebSearchConfig, WebSearchToolkit, type WhatsAppConfig, WhatsAppToolkit, Workflow, type WorkflowConfig, type WorkflowResult, anthropic, defineTool, getTextContent, google, isMultiModal, ollama, openai, registry, vertex };
+interface DuckDuckGoConfig {
+    /** Enable web search (default true). */
+    enableSearch?: boolean;
+    /** Enable news search (default true). */
+    enableNews?: boolean;
+    /** Fixed max results per query (default 5). */
+    maxResults?: number;
+}
+/**
+ * DuckDuckGo Toolkit — search the web and news without any API key.
+ *
+ * Uses the DuckDuckGo HTML API (no key required).
+ *
+ * @example
+ * ```ts
+ * const ddg = new DuckDuckGoToolkit();
+ * const agent = new Agent({ tools: [...ddg.getTools()] });
+ * ```
+ */
+declare class DuckDuckGoToolkit extends Toolkit {
+    readonly name = "duckduckgo";
+    private config;
+    constructor(config?: DuckDuckGoConfig);
+    getTools(): ToolDef[];
+    private buildSearchTool;
+    private buildNewsTool;
+    private search;
+    private scrapeHtmlSearch;
+    private decodeDdgUrl;
+    private searchNews;
+}
+
+export { type A2AAgentCard, type A2AArtifact, type A2ADataPart, type A2AFilePart, type A2AJsonRpcRequest, type A2AJsonRpcResponse, type A2AMessage, type A2APart, A2ARemoteAgent, type A2ARemoteAgentConfig, type A2ASendParams, type A2ASkill, type A2ATask, type A2ATaskQueryParams, type A2ATaskState, type A2ATextPart, Agent, type AgentConfig, type AgentEventMap, type AgentHooks, type AgentStep, AnthropicProvider, type Artifact, type AudioPart, BaseVectorStore, type ChatMessage, type ConditionStep, type ContentPart, type DuckDuckGoConfig, DuckDuckGoToolkit, type EmbeddingProvider, EventBus, type FilePart, type FunctionStep, type GmailConfig, GmailToolkit, GoogleEmbedding, type GoogleEmbeddingConfig, GoogleProvider, type GuardrailResult, type HackerNewsConfig, HackerNewsToolkit, type ImagePart, InMemoryStorage, InMemoryVectorStore, type InputGuardrail, KnowledgeBase, type KnowledgeBaseConfig, type KnowledgeBaseToolConfig, LLMLoop, type LogLevel, Logger, type LoggerConfig, MCPToolProvider, type MCPToolProviderConfig, Memory, type MemoryConfig, type MemoryEntry, type MessageContent, type MessageRole, type ModelConfig, type ModelProvider, ModelRegistry, type ModelResponse, MongoDBStorage, type MongoDBVectorConfig, MongoDBVectorStore, OllamaProvider, OpenAIEmbedding, type OpenAIEmbeddingConfig, OpenAIProvider, type OutputGuardrail, type ParallelStep, type PgVectorConfig, PgVectorStore, PostgresStorage, type QdrantConfig, QdrantVectorStore, RunContext, type RunOpts, type RunOutput, type Session, SessionManager, SqliteStorage, type StepDef, type StepResult, type StorageDriver, type StreamChunk, Team, type TeamConfig, TeamMode, type TextPart, type TokenUsage, type ToolCall, type ToolCallResult, type ToolDef, type ToolDefinition, ToolExecutor, type ToolResult, Toolkit, type VectorDocument, type VectorSearchOptions, type VectorSearchResult, type VectorStore, type VertexAIConfig, VertexAIProvider, type WebSearchConfig, WebSearchToolkit, type WhatsAppConfig, WhatsAppToolkit, Workflow, type WorkflowConfig, type WorkflowResult, anthropic, defineTool, getTextContent, google, isMultiModal, ollama, openai, registry, vertex };

package/dist/index.js

@@ -639,6 +639,9 @@ var Agent = class {
   get hasStructuredOutput() {
     return !!this.config.structuredOutput;
   }
+  get structuredOutputSchema() {
+    return this.config.structuredOutput;
+  }
   constructor(config) {
     this.config = config;
     this.name = config.name;
@@ -3787,14 +3790,14 @@ var MCPToolProvider = class {
     await this.discoverTools();
   }
   async discoverTools() {
-    const { z: z7 } = await import("zod");
+    const { z: z8 } = await import("zod");
     const result = await this.client.listTools();
     const mcpTools = result.tools ?? [];
     this.tools = mcpTools.map((mcpTool) => {
       const toolName = mcpTool.name;
       const description = mcpTool.description ?? "";
       const inputSchema = mcpTool.inputSchema ?? { type: "object", properties: {} };
-      const parameters = this.jsonSchemaToZod(inputSchema, z7);
+      const parameters = this.jsonSchemaToZod(inputSchema, z8);
       const execute = async (args, _ctx) => {
         const callResult = await this.client.callTool({
           name: toolName,
@@ -3822,9 +3825,9 @@ var MCPToolProvider = class {
       };
     });
   }
-  jsonSchemaToZod(schema, z7) {
+  jsonSchemaToZod(schema, z8) {
     if (!schema || !schema.properties) {
-      return z7.object({}).passthrough();
+      return z8.object({}).passthrough();
     }
     const shape = {};
     const required = schema.required ?? [];
@@ -3832,24 +3835,24 @@ var MCPToolProvider = class {
       let field;
       switch (prop.type) {
         case "string":
-          field = z7.string();
-          if (prop.enum) field = z7.enum(prop.enum);
+          field = z8.string();
+          if (prop.enum) field = z8.enum(prop.enum);
           break;
         case "number":
         case "integer":
-          field = z7.number();
+          field = z8.number();
           break;
         case "boolean":
-          field = z7.boolean();
+          field = z8.boolean();
           break;
         case "array":
-          field = z7.array(z7.any());
+          field = z8.array(z8.any());
           break;
         case "object":
-          field = z7.record(z7.any());
+          field = z8.record(z8.any());
           break;
         default:
-          field = z7.any();
+          field = z8.any();
       }
       if (prop.description) {
         field = field.describe(prop.description);
@@ -3859,7 +3862,7 @@ var MCPToolProvider = class {
       }
       shape[key] = field;
     }
-    return z7.object(shape);
+    return z8.object(shape);
   }
   /**
    * Returns tools from this MCP server as RadarOS ToolDef[].
@@ -4591,11 +4594,191 @@ var HackerNewsToolkit = class extends Toolkit {
     return tools;
   }
 };
+
+// src/toolkits/duckduckgo.ts
+import { z as z7 } from "zod";
+var DuckDuckGoToolkit = class extends Toolkit {
+  name = "duckduckgo";
+  config;
+  constructor(config = {}) {
+    super();
+    this.config = {
+      enableSearch: config.enableSearch ?? true,
+      enableNews: config.enableNews ?? true,
+      maxResults: config.maxResults ?? 5
+    };
+  }
+  getTools() {
+    const tools = [];
+    if (this.config.enableSearch) {
+      tools.push(this.buildSearchTool());
+    }
+    if (this.config.enableNews) {
+      tools.push(this.buildNewsTool());
+    }
+    return tools;
+  }
+  buildSearchTool() {
+    const self = this;
+    return {
+      name: "duckduckgo_search",
+      description: "Search the web using DuckDuckGo. Returns titles, URLs, and snippets. No API key required.",
+      parameters: z7.object({
+        query: z7.string().describe("The search query"),
+        maxResults: z7.number().optional().describe("Maximum number of results (default 5)")
+      }),
+      async execute(args, _ctx) {
+        const query = args.query;
+        const max = args.maxResults ?? self.config.maxResults ?? 5;
+        return self.search(query, max);
+      }
+    };
+  }
+  buildNewsTool() {
+    const self = this;
+    return {
+      name: "duckduckgo_news",
+      description: "Get the latest news from DuckDuckGo. Returns headlines, sources, URLs, and dates.",
+      parameters: z7.object({
+        query: z7.string().describe("The news search query"),
+        maxResults: z7.number().optional().describe("Maximum number of results (default 5)")
+      }),
+      async execute(args, _ctx) {
+        const query = args.query;
+        const max = args.maxResults ?? self.config.maxResults ?? 5;
+        return self.searchNews(query, max);
+      }
+    };
+  }
+  async search(query, maxResults) {
+    const url = `https://api.duckduckgo.com/?q=${encodeURIComponent(query)}&format=json&no_redirect=1&no_html=1&skip_disambig=1`;
+    const res = await fetch(url, {
+      headers: { "User-Agent": "RadarOS/1.0" }
+    });
+    if (!res.ok) {
+      throw new Error(`DuckDuckGo search failed: ${res.status}`);
+    }
+    const data = await res.json();
+    const results = [];
+    if (data.Abstract) {
+      results.push(
+        `Answer: ${data.Abstract}
+Source: ${data.AbstractSource}
+URL: ${data.AbstractURL}`
+      );
+    }
+    const topics = data.RelatedTopics ?? [];
+    for (const topic of topics.slice(0, maxResults)) {
+      if (topic.Text && topic.FirstURL) {
+        results.push(`${topic.Text}
+URL: ${topic.FirstURL}`);
+      }
+      if (topic.Topics) {
+        for (const sub of topic.Topics.slice(0, 2)) {
+          if (sub.Text && sub.FirstURL) {
+            results.push(`${sub.Text}
+URL: ${sub.FirstURL}`);
+          }
+        }
+      }
+    }
+    if (results.length === 0 && data.Redirect) {
+      return `Redirect: ${data.Redirect}`;
+    }
+    if (results.length === 0) {
+      const htmlResults = await this.scrapeHtmlSearch(query, maxResults);
+      if (htmlResults) return htmlResults;
+      return "No results found.";
+    }
+    return results.join("\n\n---\n\n");
+  }
+  async scrapeHtmlSearch(query, maxResults) {
+    const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}`;
+    const res = await fetch(url, {
+      headers: {
+        "User-Agent": "Mozilla/5.0 (compatible; RadarOS/1.0; +https://radaros.dev)"
+      }
+    });
+    if (!res.ok) return null;
+    const html = await res.text();
+    const results = [];
+    const linkRegex = /<a[^>]*class="result__a"[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi;
+    const snippetRegex = /<a[^>]*class="result__snippet"[^>]*>([\s\S]*?)<\/a>/gi;
+    const links = [];
+    let match;
+    while ((match = linkRegex.exec(html)) !== null) {
+      const rawUrl = match[1];
+      const title = match[2].replace(/<[^>]*>/g, "").trim();
+      const decoded = this.decodeDdgUrl(rawUrl);
+      if (title && decoded) {
+        links.push({ url: decoded, title });
+      }
+    }
+    const snippets = [];
+    while ((match = snippetRegex.exec(html)) !== null) {
+      snippets.push(match[1].replace(/<[^>]*>/g, "").trim());
+    }
+    for (let i = 0; i < Math.min(links.length, maxResults); i++) {
+      results.push(
+        `Title: ${links[i].title}
+URL: ${links[i].url}
+Snippet: ${snippets[i] ?? ""}`
+      );
+    }
+    return results.length > 0 ? results.join("\n\n---\n\n") : null;
+  }
+  decodeDdgUrl(url) {
+    if (url.startsWith("//duckduckgo.com/l/?uddg=")) {
+      const match = url.match(/uddg=([^&]*)/);
+      if (match) return decodeURIComponent(match[1]);
+    }
+    if (url.startsWith("http")) return url;
+    return null;
+  }
+  async searchNews(query, maxResults) {
+    const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query + " news")}&iar=news`;
+    const res = await fetch(url, {
+      headers: {
+        "User-Agent": "Mozilla/5.0 (compatible; RadarOS/1.0; +https://radaros.dev)"
+      }
+    });
+    if (!res.ok) {
+      throw new Error(`DuckDuckGo news search failed: ${res.status}`);
+    }
+    const html = await res.text();
+    const results = [];
+    const linkRegex = /<a[^>]*class="result__a"[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi;
+    const snippetRegex = /<a[^>]*class="result__snippet"[^>]*>([\s\S]*?)<\/a>/gi;
+    const links = [];
+    let match;
+    while ((match = linkRegex.exec(html)) !== null) {
+      const rawUrl = match[1];
+      const title = match[2].replace(/<[^>]*>/g, "").trim();
+      const decoded = this.decodeDdgUrl(rawUrl);
+      if (title && decoded) {
+        links.push({ url: decoded, title });
+      }
+    }
+    const snippets = [];
+    while ((match = snippetRegex.exec(html)) !== null) {
+      snippets.push(match[1].replace(/<[^>]*>/g, "").trim());
+    }
+    for (let i = 0; i < Math.min(links.length, maxResults); i++) {
+      results.push(
+        `Title: ${links[i].title}
+URL: ${links[i].url}
+Snippet: ${snippets[i] ?? ""}`
+      );
+    }
+    return results.length > 0 ? results.join("\n\n---\n\n") : "No news results found.";
+  }
+};
 export {
   A2ARemoteAgent,
   Agent,
   AnthropicProvider,
   BaseVectorStore,
+  DuckDuckGoToolkit,
   EventBus,
   GmailToolkit,
   GoogleEmbedding,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radaros/core",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/agent/agent.ts

@@ -39,6 +39,10 @@ export class Agent {
     return !!this.config.structuredOutput;
   }
 
+  get structuredOutputSchema(): import("zod").ZodSchema | undefined {
+    return this.config.structuredOutput;
+  }
+
   constructor(config: AgentConfig) {
     this.config = config;
     this.name = config.name;

package/src/index.ts

@@ -146,3 +146,5 @@ export { WhatsAppToolkit } from "./toolkits/whatsapp.js";
 export type { WhatsAppConfig } from "./toolkits/whatsapp.js";
 export { HackerNewsToolkit } from "./toolkits/hackernews.js";
 export type { HackerNewsConfig } from "./toolkits/hackernews.js";
+export { DuckDuckGoToolkit } from "./toolkits/duckduckgo.js";
+export type { DuckDuckGoConfig } from "./toolkits/duckduckgo.js";

package/src/toolkits/duckduckgo.ts

@@ -0,0 +1,256 @@
+import { z } from "zod";
+import type { ToolDef } from "../tools/types.js";
+import type { RunContext } from "../agent/run-context.js";
+import { Toolkit } from "./base.js";
+
+export interface DuckDuckGoConfig {
+  /** Enable web search (default true). */
+  enableSearch?: boolean;
+  /** Enable news search (default true). */
+  enableNews?: boolean;
+  /** Fixed max results per query (default 5). */
+  maxResults?: number;
+}
+
+/**
+ * DuckDuckGo Toolkit — search the web and news without any API key.
+ *
+ * Uses the DuckDuckGo HTML API (no key required).
+ *
+ * @example
+ * ```ts
+ * const ddg = new DuckDuckGoToolkit();
+ * const agent = new Agent({ tools: [...ddg.getTools()] });
+ * ```
+ */
+export class DuckDuckGoToolkit extends Toolkit {
+  readonly name = "duckduckgo";
+  private config: DuckDuckGoConfig;
+
+  constructor(config: DuckDuckGoConfig = {}) {
+    super();
+    this.config = {
+      enableSearch: config.enableSearch ?? true,
+      enableNews: config.enableNews ?? true,
+      maxResults: config.maxResults ?? 5,
+    };
+  }
+
+  getTools(): ToolDef[] {
+    const tools: ToolDef[] = [];
+
+    if (this.config.enableSearch) {
+      tools.push(this.buildSearchTool());
+    }
+
+    if (this.config.enableNews) {
+      tools.push(this.buildNewsTool());
+    }
+
+    return tools;
+  }
+
+  private buildSearchTool(): ToolDef {
+    const self = this;
+    return {
+      name: "duckduckgo_search",
+      description:
+        "Search the web using DuckDuckGo. Returns titles, URLs, and snippets. No API key required.",
+      parameters: z.object({
+        query: z.string().describe("The search query"),
+        maxResults: z
+          .number()
+          .optional()
+          .describe("Maximum number of results (default 5)"),
+      }),
+      async execute(
+        args: Record<string, unknown>,
+        _ctx: RunContext
+      ): Promise<string> {
+        const query = args.query as string;
+        const max = (args.maxResults as number) ?? self.config.maxResults ?? 5;
+        return self.search(query, max);
+      },
+    };
+  }
+
+  private buildNewsTool(): ToolDef {
+    const self = this;
+    return {
+      name: "duckduckgo_news",
+      description:
+        "Get the latest news from DuckDuckGo. Returns headlines, sources, URLs, and dates.",
+      parameters: z.object({
+        query: z.string().describe("The news search query"),
+        maxResults: z
+          .number()
+          .optional()
+          .describe("Maximum number of results (default 5)"),
+      }),
+      async execute(
+        args: Record<string, unknown>,
+        _ctx: RunContext
+      ): Promise<string> {
+        const query = args.query as string;
+        const max = (args.maxResults as number) ?? self.config.maxResults ?? 5;
+        return self.searchNews(query, max);
+      },
+    };
+  }
+
+  private async search(query: string, maxResults: number): Promise<string> {
+    const url = `https://api.duckduckgo.com/?q=${encodeURIComponent(query)}&format=json&no_redirect=1&no_html=1&skip_disambig=1`;
+
+    const res = await fetch(url, {
+      headers: { "User-Agent": "RadarOS/1.0" },
+    });
+
+    if (!res.ok) {
+      throw new Error(`DuckDuckGo search failed: ${res.status}`);
+    }
+
+    const data = (await res.json()) as any;
+    const results: string[] = [];
+
+    if (data.Abstract) {
+      results.push(
+        `Answer: ${data.Abstract}\nSource: ${data.AbstractSource}\nURL: ${data.AbstractURL}`
+      );
+    }
+
+    const topics = data.RelatedTopics ?? [];
+    for (const topic of topics.slice(0, maxResults)) {
+      if (topic.Text && topic.FirstURL) {
+        results.push(`${topic.Text}\nURL: ${topic.FirstURL}`);
+      }
+      if (topic.Topics) {
+        for (const sub of topic.Topics.slice(0, 2)) {
+          if (sub.Text && sub.FirstURL) {
+            results.push(`${sub.Text}\nURL: ${sub.FirstURL}`);
+          }
+        }
+      }
+    }
+
+    if (results.length === 0 && data.Redirect) {
+      return `Redirect: ${data.Redirect}`;
+    }
+
+    if (results.length === 0) {
+      const htmlResults = await this.scrapeHtmlSearch(query, maxResults);
+      if (htmlResults) return htmlResults;
+      return "No results found.";
+    }
+
+    return results.join("\n\n---\n\n");
+  }
+
+  private async scrapeHtmlSearch(
+    query: string,
+    maxResults: number
+  ): Promise<string | null> {
+    const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}`;
+
+    const res = await fetch(url, {
+      headers: {
+        "User-Agent":
+          "Mozilla/5.0 (compatible; RadarOS/1.0; +https://radaros.dev)",
+      },
+    });
+
+    if (!res.ok) return null;
+
+    const html = await res.text();
+
+    const results: string[] = [];
+    const linkRegex =
+      /<a[^>]*class="result__a"[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi;
+    const snippetRegex =
+      /<a[^>]*class="result__snippet"[^>]*>([\s\S]*?)<\/a>/gi;
+
+    const links: { url: string; title: string }[] = [];
+    let match;
+    while ((match = linkRegex.exec(html)) !== null) {
+      const rawUrl = match[1];
+      const title = match[2].replace(/<[^>]*>/g, "").trim();
+      const decoded = this.decodeDdgUrl(rawUrl);
+      if (title && decoded) {
+        links.push({ url: decoded, title });
+      }
+    }
+
+    const snippets: string[] = [];
+    while ((match = snippetRegex.exec(html)) !== null) {
+      snippets.push(match[1].replace(/<[^>]*>/g, "").trim());
+    }
+
+    for (let i = 0; i < Math.min(links.length, maxResults); i++) {
+      results.push(
+        `Title: ${links[i].title}\nURL: ${links[i].url}\nSnippet: ${snippets[i] ?? ""}`
+      );
+    }
+
+    return results.length > 0 ? results.join("\n\n---\n\n") : null;
+  }
+
+  private decodeDdgUrl(url: string): string | null {
+    if (url.startsWith("//duckduckgo.com/l/?uddg=")) {
+      const match = url.match(/uddg=([^&]*)/);
+      if (match) return decodeURIComponent(match[1]);
+    }
+    if (url.startsWith("http")) return url;
+    return null;
+  }
+
+  private async searchNews(
+    query: string,
+    maxResults: number
+  ): Promise<string> {
+    const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query + " news")}&iar=news`;
+
+    const res = await fetch(url, {
+      headers: {
+        "User-Agent":
+          "Mozilla/5.0 (compatible; RadarOS/1.0; +https://radaros.dev)",
+      },
+    });
+
+    if (!res.ok) {
+      throw new Error(`DuckDuckGo news search failed: ${res.status}`);
+    }
+
+    const html = await res.text();
+    const results: string[] = [];
+
+    const linkRegex =
+      /<a[^>]*class="result__a"[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi;
+    const snippetRegex =
+      /<a[^>]*class="result__snippet"[^>]*>([\s\S]*?)<\/a>/gi;
+
+    const links: { url: string; title: string }[] = [];
+    let match;
+    while ((match = linkRegex.exec(html)) !== null) {
+      const rawUrl = match[1];
+      const title = match[2].replace(/<[^>]*>/g, "").trim();
+      const decoded = this.decodeDdgUrl(rawUrl);
+      if (title && decoded) {
+        links.push({ url: decoded, title });
+      }
+    }
+
+    const snippets: string[] = [];
+    while ((match = snippetRegex.exec(html)) !== null) {
+      snippets.push(match[1].replace(/<[^>]*>/g, "").trim());
+    }
+
+    for (let i = 0; i < Math.min(links.length, maxResults); i++) {
+      results.push(
+        `Title: ${links[i].title}\nURL: ${links[i].url}\nSnippet: ${snippets[i] ?? ""}`
+      );
+    }
+
+    return results.length > 0
+      ? results.join("\n\n---\n\n")
+      : "No news results found.";
+  }
+}