@librechat/agents 3.3.11 → 3.3.13

package/dist/esm/tools/search/tavily-search.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tavily-search.mjs","names":[],"sources":["../../../../src/tools/search/tavily-search.ts"],"sourcesContent":["import axios from 'axios';\nimport type * as t from './types';\n\nconst DEFAULT_TAVILY_TIMEOUT = 15000;\n\nconst TAVILY_COUNTRY_ALIASES: Partial<Record<string, string>> = {\n  ba: 'bosnia and herzegovina',\n  cg: 'congo',\n  cz: 'czech republic',\n  gb: 'united kingdom',\n  mm: 'myanmar',\n  tr: 'turkey',\n  tt: 'trinidad and tobago',\n  uk: 'united kingdom',\n};\n\nconst TAVILY_SUPPORTED_COUNTRIES = new Set([\n  'afghanistan',\n  'albania',\n  'algeria',\n  'andorra',\n  'angola',\n  'argentina',\n  'armenia',\n  'australia',\n  'austria',\n  'azerbaijan',\n  'bahamas',\n  'bahrain',\n  'bangladesh',\n  'barbados',\n  'belarus',\n  'belgium',\n  'belize',\n  'benin',\n  'bhutan',\n  'bolivia',\n  'bosnia and herzegovina',\n  'botswana',\n  'brazil',\n  'brunei',\n  'bulgaria',\n  'burkina faso',\n  'burundi',\n  'cambodia',\n  'cameroon',\n  'canada',\n  'cape verde',\n  'central african republic',\n  'chad',\n  'chile',\n  'china',\n  'colombia',\n  'comoros',\n  'congo',\n  'costa rica',\n  'croatia',\n  'cuba',\n  'cyprus',\n  'czech republic',\n  'denmark',\n  'djibouti',\n  'dominican republic',\n  'ecuador',\n  'egypt',\n  'el salvador',\n  'equatorial guinea',\n  'eritrea',\n  'estonia',\n  'ethiopia',\n  'fiji',\n  'finland',\n  'france',\n  'gabon',\n  'gambia',\n  'georgia',\n  'germany',\n  'ghana',\n  'greece',\n  'guatemala',\n  'guinea',\n  'haiti',\n  'honduras',\n  'hungary',\n  'iceland',\n  'india',\n  'indonesia',\n  'iran',\n  'iraq',\n  'ireland',\n  'israel',\n  'italy',\n  'jamaica',\n  'japan',\n  'jordan',\n  'kazakhstan',\n  'kenya',\n  'kuwait',\n  'kyrgyzstan',\n  'latvia',\n  'lebanon',\n  'lesotho',\n  'liberia',\n  'libya',\n  'liechtenstein',\n  'lithuania',\n  'luxembourg',\n  'madagascar',\n  'malawi',\n  'malaysia',\n  'maldives',\n  'mali',\n  'malta',\n  'mauritania',\n  'mauritius',\n  'mexico',\n  'moldova',\n  'monaco',\n  'mongolia',\n  'montenegro',\n  'morocco',\n  'mozambique',\n  'myanmar',\n  'namibia',\n  'nepal',\n  'netherlands',\n  'new zealand',\n  'nicaragua',\n  'niger',\n  'nigeria',\n  'north korea',\n  'north macedonia',\n  'norway',\n  'oman',\n  'pakistan',\n  'panama',\n  'papua new guinea',\n  'paraguay',\n  'peru',\n  'philippines',\n  'poland',\n  'portugal',\n  'qatar',\n  'romania',\n  'russia',\n  'rwanda',\n  'saudi arabia',\n  'senegal',\n  'serbia',\n  'singapore',\n  'slovakia',\n  'slovenia',\n  'somalia',\n  'south africa',\n  'south korea',\n  'south sudan',\n  'spain',\n  'sri lanka',\n  'sudan',\n  'sweden',\n  'switzerland',\n  'syria',\n  'taiwan',\n  'tajikistan',\n  'tanzania',\n  'thailand',\n  'togo',\n  'trinidad and tobago',\n  'tunisia',\n  'turkey',\n  'turkmenistan',\n  'uganda',\n  'ukraine',\n  'united arab emirates',\n  'united kingdom',\n  'united states',\n  'uruguay',\n  'uzbekistan',\n  'venezuela',\n  'vietnam',\n  'yemen',\n  'zambia',\n  'zimbabwe',\n]);\n\nconst TAVILY_REGION_NAMES = new Intl.DisplayNames(['en'], {\n  type: 'region',\n});\n\nconst normalizeTavilyCountryName = (country: string): string =>\n  country\n    .toLowerCase()\n    .replace(/\\s*\\([^)]*\\)/g, '')\n    .replace(/\\s*&\\s*/g, ' and ')\n    .normalize('NFD')\n    .replace(/\\p{Diacritic}/gu, '');\n\nconst normalizeTavilyCountry = (country?: string): string | undefined => {\n  const normalizedCountry = country?.trim().toLowerCase();\n  if (normalizedCountry == null || normalizedCountry === '') {\n    return undefined;\n  }\n\n  const countryAlias = TAVILY_COUNTRY_ALIASES[normalizedCountry];\n  if (countryAlias != null) {\n    return TAVILY_SUPPORTED_COUNTRIES.has(countryAlias)\n      ? countryAlias\n      : undefined;\n  }\n\n  if (/^[a-z]{2}$/.test(normalizedCountry)) {\n    const regionName = TAVILY_REGION_NAMES.of(normalizedCountry.toUpperCase());\n    if (regionName == null) {\n      return undefined;\n    }\n    const countryName = normalizeTavilyCountryName(regionName);\n    return TAVILY_SUPPORTED_COUNTRIES.has(countryName)\n      ? countryName\n      : undefined;\n  }\n\n  const countryName = normalizeTavilyCountryName(normalizedCountry);\n  return TAVILY_SUPPORTED_COUNTRIES.has(countryName) ? countryName : undefined;\n};\n\nconst normalizeTavilyTimeRange = (\n  timeRange?: t.TavilyTimeRangeInput\n): t.TavilyTimeRange | undefined => {\n  switch (timeRange) {\n  case 'h':\n  case 'd':\n    return 'day';\n  case 'w':\n    return 'week';\n  case 'm':\n    return 'month';\n  case 'y':\n    return 'year';\n  case 'day':\n  case 'week':\n  case 'month':\n  case 'year':\n    return timeRange;\n  default:\n    return undefined;\n  }\n};\n\nconst getHostname = (link: string): string => {\n  try {\n    return new URL(link).hostname;\n  } catch {\n    return link;\n  }\n};\n\nexport const createTavilyAPI = (\n  apiKey?: string,\n  apiUrl?: string,\n  options?: t.TavilySearchOptions\n): {\n  getSources: (params: t.GetSourcesParams) => Promise<t.SearchResult>;\n} => {\n  const config = {\n    apiKey: apiKey ?? process.env.TAVILY_API_KEY,\n    apiUrl:\n      apiUrl ??\n      process.env.TAVILY_SEARCH_URL ??\n      'https://api.tavily.com/search',\n    timeout: options?.timeout ?? DEFAULT_TAVILY_TIMEOUT,\n  };\n\n  if (config.apiKey == null || config.apiKey === '') {\n    throw new Error('TAVILY_API_KEY is required for Tavily API');\n  }\n\n  const getSources = async ({\n    query,\n    date,\n    country,\n    numResults = 8,\n    type,\n    news,\n  }: t.GetSourcesParams): Promise<t.SearchResult> => {\n    if (!query.trim()) {\n      return { success: false, error: 'Query cannot be empty' };\n    }\n\n    try {\n      const timeRange =\n        normalizeTavilyTimeRange(options?.timeRange) ??\n        (date != null ? (normalizeTavilyTimeRange(date) ?? 'day') : undefined);\n      const topic =\n        news === true || type === 'news'\n          ? 'news'\n          : (options?.topic ?? 'general');\n      const maxResults = options?.maxResults ?? numResults;\n      const searchDepth = options?.searchDepth ?? 'basic';\n\n      const payload: t.TavilySearchPayload = {\n        query,\n        search_depth: searchDepth,\n        topic,\n        max_results: Math.min(Math.max(1, maxResults), 20),\n      };\n\n      if (\n        options?.safeSearch != null &&\n        searchDepth !== 'fast' &&\n        searchDepth !== 'ultra-fast'\n      ) {\n        payload.safe_search = options.safeSearch;\n      }\n      if (timeRange != null) {\n        payload.time_range = timeRange;\n      }\n      const tavilyCountry =\n        topic === 'general' ? normalizeTavilyCountry(country) : undefined;\n      if (tavilyCountry != null) {\n        payload.country = tavilyCountry;\n      }\n      if (type === 'images' || options?.includeImages === true) {\n        payload.include_images = true;\n      }\n      if (options?.includeAnswer != null) {\n        payload.include_answer = options.includeAnswer;\n      }\n      if (options?.includeRawContent != null) {\n        payload.include_raw_content = options.includeRawContent;\n      }\n      if (\n        options?.includeDomains != null &&\n        options.includeDomains.length > 0\n      ) {\n        payload.include_domains = options.includeDomains;\n      }\n      if (\n        options?.excludeDomains != null &&\n        options.excludeDomains.length > 0\n      ) {\n        payload.exclude_domains = options.excludeDomains;\n      }\n      if (options?.includeImageDescriptions != null) {\n        payload.include_image_descriptions = options.includeImageDescriptions;\n      }\n      if (options?.includeFavicon != null) {\n        payload.include_favicon = options.includeFavicon;\n      }\n      if (options?.chunksPerSource != null && searchDepth === 'advanced') {\n        payload.chunks_per_source = options.chunksPerSource;\n      }\n\n      const response = await axios.post<t.TavilySearchResponse>(\n        config.apiUrl,\n        payload,\n        {\n          headers: {\n            Authorization: `Bearer ${config.apiKey}`,\n            'Content-Type': 'application/json',\n          },\n          timeout: config.timeout,\n        }\n      );\n\n      const data = response.data;\n\n      const organicResults: t.OrganicResult[] = (data.results ?? []).map(\n        (result: t.TavilySearchResult) => ({\n          title: result.title ?? '',\n          link: result.url ?? '',\n          snippet: result.content ?? '',\n          date: result.published_date,\n        })\n      );\n\n      const imageResults: t.ImageResult[] = Array.isArray(data.images)\n        ? data.images.slice(0, 6).reduce<t.ImageResult[]>((acc, image) => {\n          const imageUrl = typeof image === 'string' ? image : image.url;\n          if (imageUrl == null || imageUrl === '') {\n            return acc;\n          }\n          acc.push({\n            imageUrl,\n            title: typeof image === 'string' ? undefined : image.description,\n            position: acc.length + 1,\n          });\n          return acc;\n        }, [])\n        : [];\n\n      const newsResults: t.NewsResult[] =\n        topic === 'news'\n          ? organicResults.map((r) => ({\n            title: r.title,\n            link: r.link,\n            snippet: r.snippet,\n            date: r.date,\n            source: getHostname(r.link),\n          }))\n          : [];\n\n      const results: t.SearchResultData = {\n        organic: organicResults,\n        images: imageResults,\n        topStories: [],\n        videos: [],\n        news: newsResults,\n        answerBox: data.answer != null ? { snippet: data.answer } : undefined,\n        relatedSearches: [],\n      };\n\n      return { success: true, data: results };\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      return {\n        success: false,\n        error: `Tavily API request failed: ${errorMessage}`,\n      };\n    }\n  };\n\n  return { getSources };\n};\n"],"mappings":";;AAGA,MAAM,yBAAyB;AAE/B,MAAM,yBAA0D;CAC9D,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;AAEA,MAAM,6BAA6B,IAAI,IAAI;CACzC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,sBAAsB,IAAI,KAAK,aAAa,CAAC,IAAI,GAAG,EACxD,MAAM,SACR,CAAC;AAED,MAAM,8BAA8B,YAClC,QACG,YAAY,CAAC,CACb,QAAQ,iBAAiB,EAAE,CAAC,CAC5B,QAAQ,YAAY,OAAO,CAAC,CAC5B,UAAU,KAAK,CAAC,CAChB,QAAQ,mBAAmB,EAAE;AAElC,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"}
+{"version":3,"file":"tavily-search.mjs","names":[],"sources":["../../../../src/tools/search/tavily-search.ts"],"sourcesContent":["import axios from 'axios';\nimport type * as t from './types';\n\nconst DEFAULT_TAVILY_TIMEOUT = 15000;\n\nconst TAVILY_COUNTRY_ALIASES: Partial<Record<string, string>> = {\n  ba: 'bosnia and herzegovina',\n  cg: 'congo',\n  cz: 'czech republic',\n  gb: 'united kingdom',\n  mm: 'myanmar',\n  tr: 'turkey',\n  tt: 'trinidad and tobago',\n  uk: 'united kingdom',\n};\n\nconst TAVILY_SUPPORTED_COUNTRIES = new Set([\n  'afghanistan',\n  'albania',\n  'algeria',\n  'andorra',\n  'angola',\n  'argentina',\n  'armenia',\n  'australia',\n  'austria',\n  'azerbaijan',\n  'bahamas',\n  'bahrain',\n  'bangladesh',\n  'barbados',\n  'belarus',\n  'belgium',\n  'belize',\n  'benin',\n  'bhutan',\n  'bolivia',\n  'bosnia and herzegovina',\n  'botswana',\n  'brazil',\n  'brunei',\n  'bulgaria',\n  'burkina faso',\n  'burundi',\n  'cambodia',\n  'cameroon',\n  'canada',\n  'cape verde',\n  'central african republic',\n  'chad',\n  'chile',\n  'china',\n  'colombia',\n  'comoros',\n  'congo',\n  'costa rica',\n  'croatia',\n  'cuba',\n  'cyprus',\n  'czech republic',\n  'denmark',\n  'djibouti',\n  'dominican republic',\n  'ecuador',\n  'egypt',\n  'el salvador',\n  'equatorial guinea',\n  'eritrea',\n  'estonia',\n  'ethiopia',\n  'fiji',\n  'finland',\n  'france',\n  'gabon',\n  'gambia',\n  'georgia',\n  'germany',\n  'ghana',\n  'greece',\n  'guatemala',\n  'guinea',\n  'haiti',\n  'honduras',\n  'hungary',\n  'iceland',\n  'india',\n  'indonesia',\n  'iran',\n  'iraq',\n  'ireland',\n  'israel',\n  'italy',\n  'jamaica',\n  'japan',\n  'jordan',\n  'kazakhstan',\n  'kenya',\n  'kuwait',\n  'kyrgyzstan',\n  'latvia',\n  'lebanon',\n  'lesotho',\n  'liberia',\n  'libya',\n  'liechtenstein',\n  'lithuania',\n  'luxembourg',\n  'madagascar',\n  'malawi',\n  'malaysia',\n  'maldives',\n  'mali',\n  'malta',\n  'mauritania',\n  'mauritius',\n  'mexico',\n  'moldova',\n  'monaco',\n  'mongolia',\n  'montenegro',\n  'morocco',\n  'mozambique',\n  'myanmar',\n  'namibia',\n  'nepal',\n  'netherlands',\n  'new zealand',\n  'nicaragua',\n  'niger',\n  'nigeria',\n  'north korea',\n  'north macedonia',\n  'norway',\n  'oman',\n  'pakistan',\n  'panama',\n  'papua new guinea',\n  'paraguay',\n  'peru',\n  'philippines',\n  'poland',\n  'portugal',\n  'qatar',\n  'romania',\n  'russia',\n  'rwanda',\n  'saudi arabia',\n  'senegal',\n  'serbia',\n  'singapore',\n  'slovakia',\n  'slovenia',\n  'somalia',\n  'south africa',\n  'south korea',\n  'south sudan',\n  'spain',\n  'sri lanka',\n  'sudan',\n  'sweden',\n  'switzerland',\n  'syria',\n  'taiwan',\n  'tajikistan',\n  'tanzania',\n  'thailand',\n  'togo',\n  'trinidad and tobago',\n  'tunisia',\n  'turkey',\n  'turkmenistan',\n  'uganda',\n  'ukraine',\n  'united arab emirates',\n  'united kingdom',\n  'united states',\n  'uruguay',\n  'uzbekistan',\n  'venezuela',\n  'vietnam',\n  'yemen',\n  'zambia',\n  'zimbabwe',\n]);\n\nconst TAVILY_REGION_NAMES = new Intl.DisplayNames(['en'], {\n  type: 'region',\n});\n\nconst normalizeTavilyCountryName = (country: string): string =>\n  country\n    .toLowerCase()\n    .replace(/\\s*\\([^)]*\\)/g, '')\n    .replace(/\\s*&\\s*/g, ' and ')\n    .normalize('NFD')\n    .replace(/\\p{Diacritic}/gu, '');\n\nconst normalizeTavilyCountry = (country?: string): string | undefined => {\n  const normalizedCountry = country?.trim().toLowerCase();\n  if (normalizedCountry == null || normalizedCountry === '') {\n    return undefined;\n  }\n\n  const countryAlias = TAVILY_COUNTRY_ALIASES[normalizedCountry];\n  if (countryAlias != null) {\n    return TAVILY_SUPPORTED_COUNTRIES.has(countryAlias)\n      ? countryAlias\n      : undefined;\n  }\n\n  if (/^[a-z]{2}$/.test(normalizedCountry)) {\n    const regionName = TAVILY_REGION_NAMES.of(normalizedCountry.toUpperCase());\n    if (regionName == null) {\n      return undefined;\n    }\n    const countryName = normalizeTavilyCountryName(regionName);\n    return TAVILY_SUPPORTED_COUNTRIES.has(countryName)\n      ? countryName\n      : undefined;\n  }\n\n  const countryName = normalizeTavilyCountryName(normalizedCountry);\n  return TAVILY_SUPPORTED_COUNTRIES.has(countryName) ? countryName : undefined;\n};\n\nconst normalizeTavilyTimeRange = (\n  timeRange?: t.TavilyTimeRangeInput\n): t.TavilyTimeRange | undefined => {\n  switch (timeRange) {\n  case 'h':\n  case 'd':\n    return 'day';\n  case 'w':\n    return 'week';\n  case 'm':\n    return 'month';\n  case 'y':\n    return 'year';\n  case 'day':\n  case 'week':\n  case 'month':\n  case 'year':\n    return timeRange;\n  default:\n    return undefined;\n  }\n};\n\nconst getHostname = (link: string): string => {\n  try {\n    return new URL(link).hostname;\n  } catch {\n    return link;\n  }\n};\n\nexport const createTavilyAPI = (\n  apiKey?: string,\n  apiUrl?: string,\n  options?: t.TavilySearchOptions\n): {\n  getSources: (params: t.GetSourcesParams) => Promise<t.SearchResult>;\n} => {\n  const config = {\n    apiKey: apiKey ?? process.env.TAVILY_API_KEY,\n    apiUrl:\n      apiUrl ??\n      process.env.TAVILY_SEARCH_URL ??\n      'https://api.tavily.com/search',\n    timeout: options?.timeout ?? DEFAULT_TAVILY_TIMEOUT,\n  };\n\n  if (config.apiKey == null || config.apiKey === '') {\n    throw new Error('TAVILY_API_KEY is required for Tavily API');\n  }\n\n  const getSources = async ({\n    query,\n    date,\n    country,\n    numResults = 8,\n    type,\n    news,\n  }: t.GetSourcesParams): Promise<t.SearchResult> => {\n    if (!query.trim()) {\n      return { success: false, error: 'Query cannot be empty' };\n    }\n\n    try {\n      const timeRange =\n        normalizeTavilyTimeRange(options?.timeRange) ??\n        (date != null ? (normalizeTavilyTimeRange(date) ?? 'day') : undefined);\n      const topic =\n        news === true || type === 'news'\n          ? 'news'\n          : (options?.topic ?? 'general');\n      const maxResults = options?.maxResults ?? numResults;\n      const searchDepth = options?.searchDepth ?? 'basic';\n\n      const payload: t.TavilySearchPayload = {\n        query,\n        search_depth: searchDepth,\n        topic,\n        max_results: Math.min(Math.max(1, maxResults), 20),\n      };\n\n      if (\n        options?.safeSearch != null &&\n        searchDepth !== 'fast' &&\n        searchDepth !== 'ultra-fast'\n      ) {\n        payload.safe_search = options.safeSearch;\n      }\n      if (timeRange != null) {\n        payload.time_range = timeRange;\n      }\n      const tavilyCountry =\n        topic === 'general' ? normalizeTavilyCountry(country) : undefined;\n      if (tavilyCountry != null) {\n        payload.country = tavilyCountry;\n      }\n      if (type === 'images' || options?.includeImages === true) {\n        payload.include_images = true;\n      }\n      if (options?.includeAnswer != null) {\n        payload.include_answer = options.includeAnswer;\n      }\n      if (options?.includeRawContent != null) {\n        payload.include_raw_content = options.includeRawContent;\n      }\n      if (\n        options?.includeDomains != null &&\n        options.includeDomains.length > 0\n      ) {\n        payload.include_domains = options.includeDomains;\n      }\n      if (\n        options?.excludeDomains != null &&\n        options.excludeDomains.length > 0\n      ) {\n        payload.exclude_domains = options.excludeDomains;\n      }\n      if (options?.includeImageDescriptions != null) {\n        payload.include_image_descriptions = options.includeImageDescriptions;\n      }\n      if (options?.includeFavicon != null) {\n        payload.include_favicon = options.includeFavicon;\n      }\n      if (options?.chunksPerSource != null && searchDepth === 'advanced') {\n        payload.chunks_per_source = options.chunksPerSource;\n      }\n\n      const response = await axios.post<t.TavilySearchResponse>(\n        config.apiUrl,\n        payload,\n        {\n          headers: {\n            Authorization: `Bearer ${config.apiKey}`,\n            'Content-Type': 'application/json',\n          },\n          timeout: config.timeout,\n          httpAgent: options?.httpAgent,\n          httpsAgent: options?.httpsAgent,\n        }\n      );\n\n      const data = response.data;\n\n      const organicResults: t.OrganicResult[] = (data.results ?? []).map(\n        (result: t.TavilySearchResult) => ({\n          title: result.title ?? '',\n          link: result.url ?? '',\n          snippet: result.content ?? '',\n          date: result.published_date,\n        })\n      );\n\n      const imageResults: t.ImageResult[] = Array.isArray(data.images)\n        ? data.images.slice(0, 6).reduce<t.ImageResult[]>((acc, image) => {\n          const imageUrl = typeof image === 'string' ? image : image.url;\n          if (imageUrl == null || imageUrl === '') {\n            return acc;\n          }\n          acc.push({\n            imageUrl,\n            title: typeof image === 'string' ? undefined : image.description,\n            position: acc.length + 1,\n          });\n          return acc;\n        }, [])\n        : [];\n\n      const newsResults: t.NewsResult[] =\n        topic === 'news'\n          ? organicResults.map((r) => ({\n            title: r.title,\n            link: r.link,\n            snippet: r.snippet,\n            date: r.date,\n            source: getHostname(r.link),\n          }))\n          : [];\n\n      const results: t.SearchResultData = {\n        organic: organicResults,\n        images: imageResults,\n        topStories: [],\n        videos: [],\n        news: newsResults,\n        answerBox: data.answer != null ? { snippet: data.answer } : undefined,\n        relatedSearches: [],\n      };\n\n      return { success: true, data: results };\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      return {\n        success: false,\n        error: `Tavily API request failed: ${errorMessage}`,\n      };\n    }\n  };\n\n  return { getSources };\n};\n"],"mappings":";;AAGA,MAAM,yBAAyB;AAE/B,MAAM,yBAA0D;CAC9D,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;AAEA,MAAM,6BAA6B,IAAI,IAAI;CACzC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,sBAAsB,IAAI,KAAK,aAAa,CAAC,IAAI,GAAG,EACxD,MAAM,SACR,CAAC;AAED,MAAM,8BAA8B,YAClC,QACG,YAAY,CAAC,CACb,QAAQ,iBAAiB,EAAE,CAAC,CAC5B,QAAQ,YAAY,OAAO,CAAC,CAC5B,UAAU,KAAK,CAAC,CAChB,QAAQ,mBAAmB,EAAE;AAElC,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"}

package/dist/esm/tools/search/tool.mjs

@@ -210,7 +210,7 @@ function createTool({ schema, search, maxOutputChars, onSearchResults: _onSearch
 	});
 }
 const createSearchTool = (config = {}) => {
-	const { searchProvider = "serper", serperApiKey, searxngInstanceUrl, searxngApiKey, tavilyApiKey, tavilySearchUrl, tavilyExtractUrl, tavilySearchOptions, keenableApiKey, keenableApiUrl, keenableSearchOptions, keenableScraperOptions, rerankerType = "cohere", rerankerTimeout, topResults = 5, maxContentLength, chunkSize, chunkOverlap, mainExpandBy, separatorExpandBy, maxOutputChars, strategies = ["no_extraction"], filterContent = true, safeSearch = 1, scraperProvider = "firecrawl", firecrawlApiKey, firecrawlApiUrl, firecrawlVersion, firecrawlOptions, serperScraperOptions, tavilyScraperOptions, crwApiKey, crwApiUrl, crwSearchOptions, crwScraperOptions, scraperTimeout, jinaApiKey, jinaApiUrl, cohereApiKey, onSearchResults: _onSearchResults, onGetHighlights } = config;
+	const { searchProvider = "serper", serperApiKey, searxngInstanceUrl, searxngApiKey, tavilyApiKey, tavilySearchUrl, tavilyExtractUrl, tavilySearchOptions, keenableApiKey, keenableApiUrl, keenableSearchOptions, keenableScraperOptions, rerankerType = "cohere", rerankerTimeout, topResults = 5, maxContentLength, chunkSize, chunkOverlap, mainExpandBy, separatorExpandBy, maxOutputChars, strategies = ["no_extraction"], filterContent = true, safeSearch = 1, scraperProvider = "firecrawl", firecrawlApiKey, firecrawlApiUrl, firecrawlVersion, firecrawlOptions, serperScraperOptions, tavilyScraperOptions, crwApiKey, crwApiUrl, crwSearchOptions, crwScraperOptions, scraperTimeout, jinaApiKey, jinaApiUrl, cohereApiKey, httpAgent, httpsAgent, onSearchResults: _onSearchResults, onGetHighlights } = config;
 	const logger = config.logger || createDefaultLogger();
 	const effectiveTavilySearchOptions = searchProvider === "tavily" && config.safeSearch != null ? {
 		...tavilySearchOptions,
@@ -243,7 +243,9 @@ const createSearchTool = (config = {}) => {
 		keenableSearchOptions,
 		crwApiKey,
 		crwApiUrl,
-		crwSearchOptions
+		crwSearchOptions,
+		httpAgent,
+		httpsAgent
 	});
 	/** Create scraper based on scraperProvider */
 	let scraperInstance;
@@ -251,6 +253,8 @@ const createSearchTool = (config = {}) => {
 		...serperScraperOptions,
 		apiKey: serperApiKey,
 		timeout: scraperTimeout ?? serperScraperOptions?.timeout,
+		httpAgent: httpAgent ?? serperScraperOptions?.httpAgent,
+		httpsAgent: httpsAgent ?? serperScraperOptions?.httpsAgent,
 		logger
 	});
 	else if (scraperProvider === "tavily") scraperInstance = createTavilyScraper({
@@ -258,6 +262,8 @@ const createSearchTool = (config = {}) => {
 		apiKey: tavilyScraperOptions?.apiKey ?? tavilyApiKey ?? process.env.TAVILY_API_KEY,
 		apiUrl: tavilyScraperOptions?.apiUrl ?? tavilyExtractUrl,
 		timeout: scraperTimeout ?? tavilyScraperOptions?.timeout,
+		httpAgent: httpAgent ?? tavilyScraperOptions?.httpAgent,
+		httpsAgent: httpsAgent ?? tavilyScraperOptions?.httpsAgent,
 		logger
 	});
 	else if (scraperProvider === "crw") scraperInstance = createCrwScraper({
@@ -266,6 +272,8 @@ const createSearchTool = (config = {}) => {
 		apiUrl: crwScraperOptions?.apiUrl ?? crwApiUrl,
 		timeout: scraperTimeout ?? crwScraperOptions?.timeout,
 		formats: crwScraperOptions?.formats ?? ["markdown", "rawHtml"],
+		httpAgent: httpAgent ?? crwScraperOptions?.httpAgent,
+		httpsAgent: httpsAgent ?? crwScraperOptions?.httpsAgent,
 		logger
 	});
 	else if (scraperProvider === "keenable") scraperInstance = createKeenableScraper({
@@ -273,6 +281,8 @@ const createSearchTool = (config = {}) => {
 		apiKey: keenableScraperOptions?.apiKey ?? keenableApiKey,
 		timeout: scraperTimeout ?? keenableScraperOptions?.timeout,
 		attributionTitle: keenableScraperOptions?.attributionTitle ?? keenableSearchOptions?.attributionTitle,
+		httpAgent: httpAgent ?? keenableScraperOptions?.httpAgent,
+		httpsAgent: httpsAgent ?? keenableScraperOptions?.httpsAgent,
 		logger
 	});
 	else scraperInstance = createFirecrawlScraper({
@@ -282,6 +292,8 @@ const createSearchTool = (config = {}) => {
 		version: firecrawlVersion,
 		timeout: scraperTimeout ?? firecrawlOptions?.timeout,
 		formats: firecrawlOptions?.formats ?? ["markdown", "rawHtml"],
+		httpAgent: httpAgent ?? firecrawlOptions?.httpAgent,
+		httpsAgent: httpsAgent ?? firecrawlOptions?.httpsAgent,
 		logger
 	});
 	const selectedReranker = createReranker({
@@ -290,6 +302,8 @@ const createSearchTool = (config = {}) => {
 		jinaApiUrl,
 		cohereApiKey,
 		rerankerTimeout,
+		httpAgent,
+		httpsAgent,
 		logger
 	});
 	if (!selectedReranker) logger.warn("No reranker selected. Using default ranking.");

package/dist/esm/tools/search/tool.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tool.mjs","names":["params"],"sources":["../../../../src/tools/search/tool.ts"],"sourcesContent":["import { tool, DynamicStructuredTool } from '@langchain/core/tools';\nimport type { RunnableConfig } from '@langchain/core/runnables';\nimport type * as t from './types';\nimport {\n  WebSearchToolDescription,\n  WebSearchToolName,\n  countrySchema,\n  imagesSchema,\n  videosSchema,\n  querySchema,\n  dateSchema,\n  newsSchema,\n  DATE_RANGE,\n} from './schema';\nimport { createSearchAPI, createSourceProcessor } from './search';\nimport { createKeenableScraper } from './keenable-scraper';\nimport { createSerperScraper } from './serper-scraper';\nimport { createTavilyScraper } from './tavily-scraper';\nimport { createFirecrawlScraper } from './firecrawl';\nimport { INTENT_PROPERTY } from '@/tools/intentArg';\nimport { createCrwScraper } from './crw-scraper';\nimport { expandHighlights } from './highlights';\nimport { formatResultsForLLM } from './format';\nimport { createDefaultLogger } from './utils';\nimport { createReranker } from './rerankers';\nimport { Constants } from '@/common';\n\n/**\n * Settled label for a `web_search` call's intent (see `intentArg.ts`).\n *\n * Counts the result kinds `formatResultsForLLM` actually renders —\n * `references` only tracks links embedded in extracted highlights, so it\n * undercounts ordinary results and can overcount when one highlight embeds\n * several links.\n *\n * A caught provider or processing failure is reported through `data.error`\n * while the tool still returns NORMALLY, so that case must author its own\n * label: the `ToolMessage` carries success status, so without an authored\n * outcome the in-flight intent (\"Searching…\") would stand as the settled\n * label and present a failed search as an ordinary one.\n *\n * Returns undefined for a genuine zero-result search, leaving the\n * model-authored intent to stand unchanged as the label.\n */\nexport function resolveSearchOutcome(\n  data: t.SearchResultData,\n  query: string\n): string | undefined {\n  if (data.error != null && data.error !== '') {\n    return `Search failed for \"${query}\"`;\n  }\n  const count =\n    (data.organic?.length ?? 0) +\n    (data.topStories?.length ?? 0) +\n    (data.news?.length ?? 0) +\n    (data.images?.length ?? 0) +\n    (data.videos?.length ?? 0) +\n    (data.places?.length ?? 0) +\n    (data.peopleAlsoAsk?.length ?? 0) +\n    (data.knowledgeGraph != null ? 1 : 0) +\n    (data.answerBox != null ? 1 : 0);\n  if (count === 0) {\n    return undefined;\n  }\n  return `Found ${count} result${count === 1 ? '' : 's'} for \"${query}\"`;\n}\n\n/**\n * Executes parallel searches and merges the results,\n * deduplicating top stories by link\n */\nexport async function executeParallelSearches({\n  searchAPI,\n  query,\n  date,\n  country,\n  safeSearch,\n  images,\n  videos,\n  news,\n  logger,\n}: {\n  searchAPI: ReturnType<typeof createSearchAPI>;\n  query: string;\n  date?: DATE_RANGE;\n  country?: string;\n  safeSearch: t.SearchToolConfig['safeSearch'];\n  images: boolean;\n  videos: boolean;\n  news: boolean;\n  logger: t.Logger;\n}): Promise<t.SearchResult> {\n  // Prepare all search tasks to run in parallel\n  const searchTasks: Promise<t.SearchResult>[] = [\n    // Main search\n    searchAPI.getSources({\n      query,\n      date,\n      country,\n      safeSearch,\n    }),\n  ];\n\n  if (images) {\n    searchTasks.push(\n      searchAPI\n        .getSources({\n          query,\n          date,\n          country,\n          safeSearch,\n          type: 'images',\n        })\n        .catch((error) => {\n          logger.error('Error fetching images:', error);\n          return {\n            success: false,\n            error: `Images search failed: ${error instanceof Error ? error.message : String(error)}`,\n          };\n        })\n    );\n  }\n  if (videos) {\n    searchTasks.push(\n      searchAPI\n        .getSources({\n          query,\n          date,\n          country,\n          safeSearch,\n          type: 'videos',\n        })\n        .catch((error) => {\n          logger.error('Error fetching videos:', error);\n          return {\n            success: false,\n            error: `Videos search failed: ${error instanceof Error ? error.message : String(error)}`,\n          };\n        })\n    );\n  }\n  if (news) {\n    searchTasks.push(\n      searchAPI\n        .getSources({\n          query,\n          date,\n          country,\n          safeSearch,\n          type: 'news',\n        })\n        .catch((error) => {\n          logger.error('Error fetching news:', error);\n          return {\n            success: false,\n            error: `News search failed: ${error instanceof Error ? error.message : String(error)}`,\n          };\n        })\n    );\n  }\n\n  // Run all searches in parallel\n  const results = await Promise.all(searchTasks);\n\n  // Get the main search result (first result)\n  const mainResult = results[0];\n  if (!mainResult.success) {\n    throw new Error(mainResult.error ?? 'Search failed');\n  }\n\n  // Merge additional results with the main results\n  const mergedResults = { ...mainResult.data };\n\n  // Convert existing news to topStories if present\n  if (mergedResults.news !== undefined && mergedResults.news.length > 0) {\n    const existingNewsAsTopStories = mergedResults.news\n      .filter((newsItem) => newsItem.link !== undefined && newsItem.link !== '')\n      .map((newsItem) => ({\n        title: newsItem.title ?? '',\n        link: newsItem.link ?? '',\n        source: newsItem.source ?? '',\n        date: newsItem.date ?? '',\n        imageUrl: newsItem.imageUrl ?? '',\n        processed: false,\n      }));\n    mergedResults.topStories = [\n      ...(mergedResults.topStories ?? []),\n      ...existingNewsAsTopStories,\n    ];\n    delete mergedResults.news;\n  }\n\n  results.slice(1).forEach((result) => {\n    if (result.success && result.data !== undefined) {\n      if (result.data.images !== undefined && result.data.images.length > 0) {\n        mergedResults.images = [\n          ...(mergedResults.images ?? []),\n          ...result.data.images,\n        ];\n      }\n      if (result.data.videos !== undefined && result.data.videos.length > 0) {\n        mergedResults.videos = [\n          ...(mergedResults.videos ?? []),\n          ...result.data.videos,\n        ];\n      }\n      if (result.data.news !== undefined && result.data.news.length > 0) {\n        const newsAsTopStories = result.data.news.map((newsItem) => ({\n          ...newsItem,\n          link: newsItem.link ?? '',\n        }));\n        mergedResults.topStories = [\n          ...(mergedResults.topStories ?? []),\n          ...newsAsTopStories,\n        ];\n      }\n    }\n  });\n\n  if (\n    mergedResults.topStories !== undefined &&\n    mergedResults.topStories.length > 1\n  ) {\n    /** The main search's own news results and the parallel news sub-search\n     * frequently return the same stories — keep the first occurrence of each\n     * link so duplicates aren't scraped, reranked, and formatted repeatedly */\n    const seenLinks = new Set<string>();\n    mergedResults.topStories = mergedResults.topStories.filter((story) => {\n      if (!story.link || seenLinks.has(story.link)) {\n        return false;\n      }\n      seenLinks.add(story.link);\n      return true;\n    });\n  }\n\n  return { success: true, data: mergedResults };\n}\n\nfunction createSearchProcessor({\n  searchAPI,\n  safeSearch,\n  supportsImages,\n  supportsVideos,\n  supportsNews,\n  sourceProcessor,\n  onGetHighlights,\n  mainExpandBy,\n  separatorExpandBy,\n  logger,\n}: {\n  safeSearch: t.SearchToolConfig['safeSearch'];\n  supportsImages: boolean;\n  supportsVideos: boolean;\n  supportsNews: boolean;\n  searchAPI: ReturnType<typeof createSearchAPI>;\n  sourceProcessor: ReturnType<typeof createSourceProcessor>;\n  onGetHighlights: t.SearchToolConfig['onGetHighlights'];\n  mainExpandBy: t.SearchToolConfig['mainExpandBy'];\n  separatorExpandBy: t.SearchToolConfig['separatorExpandBy'];\n  logger: t.Logger;\n}) {\n  return async function ({\n    query,\n    date,\n    country,\n    proMode = true,\n    maxSources = 5,\n    onSearchResults,\n    images = false,\n    videos = false,\n    news = false,\n  }: {\n    query: string;\n    country?: string;\n    date?: DATE_RANGE;\n    proMode?: boolean;\n    maxSources?: number;\n    onSearchResults: t.SearchToolConfig['onSearchResults'];\n    images?: boolean;\n    videos?: boolean;\n    news?: boolean;\n  }): Promise<t.SearchResultData> {\n    try {\n      // Execute parallel searches and merge results\n      const searchResult = await executeParallelSearches({\n        searchAPI,\n        query,\n        date,\n        country,\n        safeSearch,\n        images: supportsImages && images,\n        videos: supportsVideos && videos,\n        news: supportsNews && news,\n        logger,\n      });\n\n      onSearchResults?.(searchResult);\n\n      const processedSources = await sourceProcessor.processSources({\n        query,\n        news,\n        result: searchResult,\n        proMode,\n        onGetHighlights,\n        numElements: maxSources,\n      });\n\n      return expandHighlights(\n        processedSources,\n        mainExpandBy,\n        separatorExpandBy\n      );\n    } catch (error) {\n      logger.error('Error in search:', error);\n      return {\n        organic: [],\n        topStories: [],\n        images: [],\n        videos: [],\n        news: [],\n        relatedSearches: [],\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  };\n}\n\nfunction createOnSearchResults({\n  runnableConfig,\n  onSearchResults,\n}: {\n  runnableConfig: RunnableConfig;\n  onSearchResults: t.SearchToolConfig['onSearchResults'];\n}) {\n  return function (results: t.SearchResult): void {\n    if (!onSearchResults) {\n      return;\n    }\n    onSearchResults(results, runnableConfig);\n  };\n}\n\nfunction createTool({\n  schema,\n  search,\n  maxOutputChars,\n  onSearchResults: _onSearchResults,\n}: {\n  schema: Record<string, unknown>;\n  search: ReturnType<typeof createSearchProcessor>;\n  maxOutputChars?: number;\n  onSearchResults: t.SearchToolConfig['onSearchResults'];\n}): DynamicStructuredTool {\n  return tool(\n    async (rawParams, runnableConfig) => {\n      const params = rawParams as SearchToolParams;\n      const { query, date, country: _c, images, videos, news } = params;\n      const country = typeof _c === 'string' && _c ? _c : undefined;\n      const searchResult = await search({\n        query,\n        date,\n        country,\n        images,\n        videos,\n        news,\n        onSearchResults: createOnSearchResults({\n          runnableConfig,\n          onSearchResults: _onSearchResults,\n        }),\n      });\n      const turn = runnableConfig.toolCall?.turn ?? 0;\n      const { output, references } = formatResultsForLLM(\n        turn,\n        searchResult,\n        maxOutputChars\n      );\n      const data: t.SearchResultData = { turn, ...searchResult, references };\n      const outcome = resolveSearchOutcome(data, query);\n      return [\n        output,\n        { [Constants.WEB_SEARCH]: data, ...(outcome != null && { outcome }) },\n      ];\n    },\n    {\n      name: WebSearchToolName,\n      description: WebSearchToolDescription,\n      schema: schema,\n      responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    }\n  );\n}\n\n/**\n * Creates a search tool with configurable search and scraper providers.\n *\n * Search providers: Serper (Google results), SearXNG (self-hosted meta-search), Tavily (AI-optimized), fastCRW (Firecrawl-compatible, self-host or cloud).\n * Scraper providers: Firecrawl (default, full-featured), Serper (lightweight), Tavily (batch extraction), fastCRW (Firecrawl-compatible, self-host or cloud).\n *\n * The country schema field is exposed to the LLM for providers that support localized results.\n */\n/** Input params type for search tool */\ninterface SearchToolParams {\n  query: string;\n  date?: DATE_RANGE;\n  country?: string;\n  images?: boolean;\n  videos?: boolean;\n  news?: boolean;\n}\n\nexport const createSearchTool = (\n  config: t.SearchToolConfig = {}\n): DynamicStructuredTool => {\n  const {\n    searchProvider = 'serper',\n    serperApiKey,\n    searxngInstanceUrl,\n    searxngApiKey,\n    tavilyApiKey,\n    tavilySearchUrl,\n    tavilyExtractUrl,\n    tavilySearchOptions,\n    keenableApiKey,\n    keenableApiUrl,\n    keenableSearchOptions,\n    keenableScraperOptions,\n    rerankerType = 'cohere',\n    rerankerTimeout,\n    topResults = 5,\n    maxContentLength,\n    chunkSize,\n    chunkOverlap,\n    mainExpandBy,\n    separatorExpandBy,\n    maxOutputChars,\n    strategies = ['no_extraction'],\n    filterContent = true,\n    safeSearch = 1,\n    scraperProvider = 'firecrawl',\n    firecrawlApiKey,\n    firecrawlApiUrl,\n    firecrawlVersion,\n    firecrawlOptions,\n    serperScraperOptions,\n    tavilyScraperOptions,\n    crwApiKey,\n    crwApiUrl,\n    crwSearchOptions,\n    crwScraperOptions,\n    scraperTimeout,\n    jinaApiKey,\n    jinaApiUrl,\n    cohereApiKey,\n    onSearchResults: _onSearchResults,\n    onGetHighlights,\n  } = config;\n\n  const logger = config.logger || createDefaultLogger();\n  const effectiveTavilySearchOptions =\n    searchProvider === 'tavily' && config.safeSearch != null\n      ? {\n        ...tavilySearchOptions,\n        safeSearch: config.safeSearch !== 0,\n      }\n      : tavilySearchOptions;\n\n  const schemaProperties: Record<string, unknown> = {\n    intent: { ...INTENT_PROPERTY },\n    query: querySchema,\n    date: dateSchema,\n    images: imagesSchema,\n    videos: videosSchema,\n    news: newsSchema,\n  };\n\n  if (searchProvider === 'serper' || searchProvider === 'tavily') {\n    schemaProperties.country = countrySchema;\n  }\n\n  const toolSchema = {\n    type: 'object',\n    properties: schemaProperties,\n    required: ['query'],\n  };\n\n  const searchAPI = createSearchAPI({\n    searchProvider,\n    serperApiKey,\n    searxngInstanceUrl,\n    searxngApiKey,\n    tavilyApiKey,\n    tavilySearchUrl,\n    tavilySearchOptions: effectiveTavilySearchOptions,\n    keenableApiKey,\n    keenableApiUrl,\n    keenableSearchOptions,\n    crwApiKey,\n    crwApiUrl,\n    crwSearchOptions,\n  });\n\n  /** Create scraper based on scraperProvider */\n  let scraperInstance: t.BaseScraper;\n\n  if (scraperProvider === 'serper') {\n    scraperInstance = createSerperScraper({\n      ...serperScraperOptions,\n      apiKey: serperApiKey,\n      timeout: scraperTimeout ?? serperScraperOptions?.timeout,\n      logger,\n    });\n  } else if (scraperProvider === 'tavily') {\n    scraperInstance = createTavilyScraper({\n      ...tavilyScraperOptions,\n      apiKey:\n        tavilyScraperOptions?.apiKey ??\n        tavilyApiKey ??\n        process.env.TAVILY_API_KEY,\n      apiUrl: tavilyScraperOptions?.apiUrl ?? tavilyExtractUrl,\n      timeout: scraperTimeout ?? tavilyScraperOptions?.timeout,\n      logger,\n    });\n  } else if (scraperProvider === 'crw') {\n    scraperInstance = createCrwScraper({\n      ...crwScraperOptions,\n      apiKey: crwScraperOptions?.apiKey ?? crwApiKey ?? process.env.CRW_API_KEY,\n      apiUrl: crwScraperOptions?.apiUrl ?? crwApiUrl,\n      timeout: scraperTimeout ?? crwScraperOptions?.timeout,\n      formats: crwScraperOptions?.formats ?? ['markdown', 'rawHtml'],\n      logger,\n    });\n  } else if (scraperProvider === 'keenable') {\n    scraperInstance = createKeenableScraper({\n      ...keenableScraperOptions,\n      apiKey: keenableScraperOptions?.apiKey ?? keenableApiKey,\n      timeout: scraperTimeout ?? keenableScraperOptions?.timeout,\n      attributionTitle:\n        keenableScraperOptions?.attributionTitle ??\n        keenableSearchOptions?.attributionTitle,\n      logger,\n    });\n  } else {\n    scraperInstance = createFirecrawlScraper({\n      ...firecrawlOptions,\n      apiKey: firecrawlApiKey ?? process.env.FIRECRAWL_API_KEY,\n      apiUrl: firecrawlApiUrl,\n      version: firecrawlVersion,\n      timeout: scraperTimeout ?? firecrawlOptions?.timeout,\n      formats: firecrawlOptions?.formats ?? ['markdown', 'rawHtml'],\n      logger,\n    });\n  }\n\n  const selectedReranker = createReranker({\n    rerankerType,\n    jinaApiKey,\n    jinaApiUrl,\n    cohereApiKey,\n    rerankerTimeout,\n    logger,\n  });\n\n  if (!selectedReranker) {\n    logger.warn('No reranker selected. Using default ranking.');\n  }\n\n  const sourceProcessor = createSourceProcessor(\n    {\n      reranker: selectedReranker,\n      topResults,\n      maxContentLength,\n      chunkSize,\n      chunkOverlap,\n      strategies,\n      filterContent,\n      logger,\n    },\n    scraperInstance\n  );\n\n  const search = createSearchProcessor({\n    searchAPI,\n    safeSearch,\n    // Keenable is organic-only: its API ignores `type`, so image/news\n    // sub-searches would spend rate limit and merge nothing.\n    supportsImages: searchProvider !== 'keenable',\n    supportsVideos:\n      searchProvider !== 'tavily' &&\n      searchProvider !== 'keenable' &&\n      searchProvider !== 'crw',\n    supportsNews: searchProvider !== 'keenable',\n    sourceProcessor,\n    onGetHighlights,\n    mainExpandBy,\n    separatorExpandBy,\n    logger,\n  });\n\n  return createTool({\n    search,\n    schema: toolSchema,\n    maxOutputChars,\n    onSearchResults: _onSearchResults,\n  });\n};\n"],"mappings":"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"}
+{"version":3,"file":"tool.mjs","names":["params"],"sources":["../../../../src/tools/search/tool.ts"],"sourcesContent":["import { tool, DynamicStructuredTool } from '@langchain/core/tools';\nimport type { RunnableConfig } from '@langchain/core/runnables';\nimport type * as t from './types';\nimport {\n  WebSearchToolDescription,\n  WebSearchToolName,\n  countrySchema,\n  imagesSchema,\n  videosSchema,\n  querySchema,\n  dateSchema,\n  newsSchema,\n  DATE_RANGE,\n} from './schema';\nimport { createSearchAPI, createSourceProcessor } from './search';\nimport { createKeenableScraper } from './keenable-scraper';\nimport { createSerperScraper } from './serper-scraper';\nimport { createTavilyScraper } from './tavily-scraper';\nimport { createFirecrawlScraper } from './firecrawl';\nimport { INTENT_PROPERTY } from '@/tools/intentArg';\nimport { createCrwScraper } from './crw-scraper';\nimport { expandHighlights } from './highlights';\nimport { formatResultsForLLM } from './format';\nimport { createDefaultLogger } from './utils';\nimport { createReranker } from './rerankers';\nimport { Constants } from '@/common';\n\n/**\n * Settled label for a `web_search` call's intent (see `intentArg.ts`).\n *\n * Counts the result kinds `formatResultsForLLM` actually renders —\n * `references` only tracks links embedded in extracted highlights, so it\n * undercounts ordinary results and can overcount when one highlight embeds\n * several links.\n *\n * A caught provider or processing failure is reported through `data.error`\n * while the tool still returns NORMALLY, so that case must author its own\n * label: the `ToolMessage` carries success status, so without an authored\n * outcome the in-flight intent (\"Searching…\") would stand as the settled\n * label and present a failed search as an ordinary one.\n *\n * Returns undefined for a genuine zero-result search, leaving the\n * model-authored intent to stand unchanged as the label.\n */\nexport function resolveSearchOutcome(\n  data: t.SearchResultData,\n  query: string\n): string | undefined {\n  if (data.error != null && data.error !== '') {\n    return `Search failed for \"${query}\"`;\n  }\n  const count =\n    (data.organic?.length ?? 0) +\n    (data.topStories?.length ?? 0) +\n    (data.news?.length ?? 0) +\n    (data.images?.length ?? 0) +\n    (data.videos?.length ?? 0) +\n    (data.places?.length ?? 0) +\n    (data.peopleAlsoAsk?.length ?? 0) +\n    (data.knowledgeGraph != null ? 1 : 0) +\n    (data.answerBox != null ? 1 : 0);\n  if (count === 0) {\n    return undefined;\n  }\n  return `Found ${count} result${count === 1 ? '' : 's'} for \"${query}\"`;\n}\n\n/**\n * Executes parallel searches and merges the results,\n * deduplicating top stories by link\n */\nexport async function executeParallelSearches({\n  searchAPI,\n  query,\n  date,\n  country,\n  safeSearch,\n  images,\n  videos,\n  news,\n  logger,\n}: {\n  searchAPI: ReturnType<typeof createSearchAPI>;\n  query: string;\n  date?: DATE_RANGE;\n  country?: string;\n  safeSearch: t.SearchToolConfig['safeSearch'];\n  images: boolean;\n  videos: boolean;\n  news: boolean;\n  logger: t.Logger;\n}): Promise<t.SearchResult> {\n  // Prepare all search tasks to run in parallel\n  const searchTasks: Promise<t.SearchResult>[] = [\n    // Main search\n    searchAPI.getSources({\n      query,\n      date,\n      country,\n      safeSearch,\n    }),\n  ];\n\n  if (images) {\n    searchTasks.push(\n      searchAPI\n        .getSources({\n          query,\n          date,\n          country,\n          safeSearch,\n          type: 'images',\n        })\n        .catch((error) => {\n          logger.error('Error fetching images:', error);\n          return {\n            success: false,\n            error: `Images search failed: ${error instanceof Error ? error.message : String(error)}`,\n          };\n        })\n    );\n  }\n  if (videos) {\n    searchTasks.push(\n      searchAPI\n        .getSources({\n          query,\n          date,\n          country,\n          safeSearch,\n          type: 'videos',\n        })\n        .catch((error) => {\n          logger.error('Error fetching videos:', error);\n          return {\n            success: false,\n            error: `Videos search failed: ${error instanceof Error ? error.message : String(error)}`,\n          };\n        })\n    );\n  }\n  if (news) {\n    searchTasks.push(\n      searchAPI\n        .getSources({\n          query,\n          date,\n          country,\n          safeSearch,\n          type: 'news',\n        })\n        .catch((error) => {\n          logger.error('Error fetching news:', error);\n          return {\n            success: false,\n            error: `News search failed: ${error instanceof Error ? error.message : String(error)}`,\n          };\n        })\n    );\n  }\n\n  // Run all searches in parallel\n  const results = await Promise.all(searchTasks);\n\n  // Get the main search result (first result)\n  const mainResult = results[0];\n  if (!mainResult.success) {\n    throw new Error(mainResult.error ?? 'Search failed');\n  }\n\n  // Merge additional results with the main results\n  const mergedResults = { ...mainResult.data };\n\n  // Convert existing news to topStories if present\n  if (mergedResults.news !== undefined && mergedResults.news.length > 0) {\n    const existingNewsAsTopStories = mergedResults.news\n      .filter((newsItem) => newsItem.link !== undefined && newsItem.link !== '')\n      .map((newsItem) => ({\n        title: newsItem.title ?? '',\n        link: newsItem.link ?? '',\n        source: newsItem.source ?? '',\n        date: newsItem.date ?? '',\n        imageUrl: newsItem.imageUrl ?? '',\n        processed: false,\n      }));\n    mergedResults.topStories = [\n      ...(mergedResults.topStories ?? []),\n      ...existingNewsAsTopStories,\n    ];\n    delete mergedResults.news;\n  }\n\n  results.slice(1).forEach((result) => {\n    if (result.success && result.data !== undefined) {\n      if (result.data.images !== undefined && result.data.images.length > 0) {\n        mergedResults.images = [\n          ...(mergedResults.images ?? []),\n          ...result.data.images,\n        ];\n      }\n      if (result.data.videos !== undefined && result.data.videos.length > 0) {\n        mergedResults.videos = [\n          ...(mergedResults.videos ?? []),\n          ...result.data.videos,\n        ];\n      }\n      if (result.data.news !== undefined && result.data.news.length > 0) {\n        const newsAsTopStories = result.data.news.map((newsItem) => ({\n          ...newsItem,\n          link: newsItem.link ?? '',\n        }));\n        mergedResults.topStories = [\n          ...(mergedResults.topStories ?? []),\n          ...newsAsTopStories,\n        ];\n      }\n    }\n  });\n\n  if (\n    mergedResults.topStories !== undefined &&\n    mergedResults.topStories.length > 1\n  ) {\n    /** The main search's own news results and the parallel news sub-search\n     * frequently return the same stories — keep the first occurrence of each\n     * link so duplicates aren't scraped, reranked, and formatted repeatedly */\n    const seenLinks = new Set<string>();\n    mergedResults.topStories = mergedResults.topStories.filter((story) => {\n      if (!story.link || seenLinks.has(story.link)) {\n        return false;\n      }\n      seenLinks.add(story.link);\n      return true;\n    });\n  }\n\n  return { success: true, data: mergedResults };\n}\n\nfunction createSearchProcessor({\n  searchAPI,\n  safeSearch,\n  supportsImages,\n  supportsVideos,\n  supportsNews,\n  sourceProcessor,\n  onGetHighlights,\n  mainExpandBy,\n  separatorExpandBy,\n  logger,\n}: {\n  safeSearch: t.SearchToolConfig['safeSearch'];\n  supportsImages: boolean;\n  supportsVideos: boolean;\n  supportsNews: boolean;\n  searchAPI: ReturnType<typeof createSearchAPI>;\n  sourceProcessor: ReturnType<typeof createSourceProcessor>;\n  onGetHighlights: t.SearchToolConfig['onGetHighlights'];\n  mainExpandBy: t.SearchToolConfig['mainExpandBy'];\n  separatorExpandBy: t.SearchToolConfig['separatorExpandBy'];\n  logger: t.Logger;\n}) {\n  return async function ({\n    query,\n    date,\n    country,\n    proMode = true,\n    maxSources = 5,\n    onSearchResults,\n    images = false,\n    videos = false,\n    news = false,\n  }: {\n    query: string;\n    country?: string;\n    date?: DATE_RANGE;\n    proMode?: boolean;\n    maxSources?: number;\n    onSearchResults: t.SearchToolConfig['onSearchResults'];\n    images?: boolean;\n    videos?: boolean;\n    news?: boolean;\n  }): Promise<t.SearchResultData> {\n    try {\n      // Execute parallel searches and merge results\n      const searchResult = await executeParallelSearches({\n        searchAPI,\n        query,\n        date,\n        country,\n        safeSearch,\n        images: supportsImages && images,\n        videos: supportsVideos && videos,\n        news: supportsNews && news,\n        logger,\n      });\n\n      onSearchResults?.(searchResult);\n\n      const processedSources = await sourceProcessor.processSources({\n        query,\n        news,\n        result: searchResult,\n        proMode,\n        onGetHighlights,\n        numElements: maxSources,\n      });\n\n      return expandHighlights(\n        processedSources,\n        mainExpandBy,\n        separatorExpandBy\n      );\n    } catch (error) {\n      logger.error('Error in search:', error);\n      return {\n        organic: [],\n        topStories: [],\n        images: [],\n        videos: [],\n        news: [],\n        relatedSearches: [],\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  };\n}\n\nfunction createOnSearchResults({\n  runnableConfig,\n  onSearchResults,\n}: {\n  runnableConfig: RunnableConfig;\n  onSearchResults: t.SearchToolConfig['onSearchResults'];\n}) {\n  return function (results: t.SearchResult): void {\n    if (!onSearchResults) {\n      return;\n    }\n    onSearchResults(results, runnableConfig);\n  };\n}\n\nfunction createTool({\n  schema,\n  search,\n  maxOutputChars,\n  onSearchResults: _onSearchResults,\n}: {\n  schema: Record<string, unknown>;\n  search: ReturnType<typeof createSearchProcessor>;\n  maxOutputChars?: number;\n  onSearchResults: t.SearchToolConfig['onSearchResults'];\n}): DynamicStructuredTool {\n  return tool(\n    async (rawParams, runnableConfig) => {\n      const params = rawParams as SearchToolParams;\n      const { query, date, country: _c, images, videos, news } = params;\n      const country = typeof _c === 'string' && _c ? _c : undefined;\n      const searchResult = await search({\n        query,\n        date,\n        country,\n        images,\n        videos,\n        news,\n        onSearchResults: createOnSearchResults({\n          runnableConfig,\n          onSearchResults: _onSearchResults,\n        }),\n      });\n      const turn = runnableConfig.toolCall?.turn ?? 0;\n      const { output, references } = formatResultsForLLM(\n        turn,\n        searchResult,\n        maxOutputChars\n      );\n      const data: t.SearchResultData = { turn, ...searchResult, references };\n      const outcome = resolveSearchOutcome(data, query);\n      return [\n        output,\n        { [Constants.WEB_SEARCH]: data, ...(outcome != null && { outcome }) },\n      ];\n    },\n    {\n      name: WebSearchToolName,\n      description: WebSearchToolDescription,\n      schema: schema,\n      responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    }\n  );\n}\n\n/**\n * Creates a search tool with configurable search and scraper providers.\n *\n * Search providers: Serper (Google results), SearXNG (self-hosted meta-search), Tavily (AI-optimized), fastCRW (Firecrawl-compatible, self-host or cloud).\n * Scraper providers: Firecrawl (default, full-featured), Serper (lightweight), Tavily (batch extraction), fastCRW (Firecrawl-compatible, self-host or cloud).\n *\n * The country schema field is exposed to the LLM for providers that support localized results.\n */\n/** Input params type for search tool */\ninterface SearchToolParams {\n  query: string;\n  date?: DATE_RANGE;\n  country?: string;\n  images?: boolean;\n  videos?: boolean;\n  news?: boolean;\n}\n\nexport const createSearchTool = (\n  config: t.SearchToolConfig = {}\n): DynamicStructuredTool => {\n  const {\n    searchProvider = 'serper',\n    serperApiKey,\n    searxngInstanceUrl,\n    searxngApiKey,\n    tavilyApiKey,\n    tavilySearchUrl,\n    tavilyExtractUrl,\n    tavilySearchOptions,\n    keenableApiKey,\n    keenableApiUrl,\n    keenableSearchOptions,\n    keenableScraperOptions,\n    rerankerType = 'cohere',\n    rerankerTimeout,\n    topResults = 5,\n    maxContentLength,\n    chunkSize,\n    chunkOverlap,\n    mainExpandBy,\n    separatorExpandBy,\n    maxOutputChars,\n    strategies = ['no_extraction'],\n    filterContent = true,\n    safeSearch = 1,\n    scraperProvider = 'firecrawl',\n    firecrawlApiKey,\n    firecrawlApiUrl,\n    firecrawlVersion,\n    firecrawlOptions,\n    serperScraperOptions,\n    tavilyScraperOptions,\n    crwApiKey,\n    crwApiUrl,\n    crwSearchOptions,\n    crwScraperOptions,\n    scraperTimeout,\n    jinaApiKey,\n    jinaApiUrl,\n    cohereApiKey,\n    httpAgent,\n    httpsAgent,\n    onSearchResults: _onSearchResults,\n    onGetHighlights,\n  } = config;\n\n  const logger = config.logger || createDefaultLogger();\n  const effectiveTavilySearchOptions =\n    searchProvider === 'tavily' && config.safeSearch != null\n      ? {\n        ...tavilySearchOptions,\n        safeSearch: config.safeSearch !== 0,\n      }\n      : tavilySearchOptions;\n\n  const schemaProperties: Record<string, unknown> = {\n    intent: { ...INTENT_PROPERTY },\n    query: querySchema,\n    date: dateSchema,\n    images: imagesSchema,\n    videos: videosSchema,\n    news: newsSchema,\n  };\n\n  if (searchProvider === 'serper' || searchProvider === 'tavily') {\n    schemaProperties.country = countrySchema;\n  }\n\n  const toolSchema = {\n    type: 'object',\n    properties: schemaProperties,\n    required: ['query'],\n  };\n\n  const searchAPI = createSearchAPI({\n    searchProvider,\n    serperApiKey,\n    searxngInstanceUrl,\n    searxngApiKey,\n    tavilyApiKey,\n    tavilySearchUrl,\n    tavilySearchOptions: effectiveTavilySearchOptions,\n    keenableApiKey,\n    keenableApiUrl,\n    keenableSearchOptions,\n    crwApiKey,\n    crwApiUrl,\n    crwSearchOptions,\n    httpAgent,\n    httpsAgent,\n  });\n\n  /** Create scraper based on scraperProvider */\n  let scraperInstance: t.BaseScraper;\n\n  if (scraperProvider === 'serper') {\n    scraperInstance = createSerperScraper({\n      ...serperScraperOptions,\n      apiKey: serperApiKey,\n      timeout: scraperTimeout ?? serperScraperOptions?.timeout,\n      httpAgent: httpAgent ?? serperScraperOptions?.httpAgent,\n      httpsAgent: httpsAgent ?? serperScraperOptions?.httpsAgent,\n      logger,\n    });\n  } else if (scraperProvider === 'tavily') {\n    scraperInstance = createTavilyScraper({\n      ...tavilyScraperOptions,\n      apiKey:\n        tavilyScraperOptions?.apiKey ??\n        tavilyApiKey ??\n        process.env.TAVILY_API_KEY,\n      apiUrl: tavilyScraperOptions?.apiUrl ?? tavilyExtractUrl,\n      timeout: scraperTimeout ?? tavilyScraperOptions?.timeout,\n      httpAgent: httpAgent ?? tavilyScraperOptions?.httpAgent,\n      httpsAgent: httpsAgent ?? tavilyScraperOptions?.httpsAgent,\n      logger,\n    });\n  } else if (scraperProvider === 'crw') {\n    scraperInstance = createCrwScraper({\n      ...crwScraperOptions,\n      apiKey: crwScraperOptions?.apiKey ?? crwApiKey ?? process.env.CRW_API_KEY,\n      apiUrl: crwScraperOptions?.apiUrl ?? crwApiUrl,\n      timeout: scraperTimeout ?? crwScraperOptions?.timeout,\n      formats: crwScraperOptions?.formats ?? ['markdown', 'rawHtml'],\n      httpAgent: httpAgent ?? crwScraperOptions?.httpAgent,\n      httpsAgent: httpsAgent ?? crwScraperOptions?.httpsAgent,\n      logger,\n    });\n  } else if (scraperProvider === 'keenable') {\n    scraperInstance = createKeenableScraper({\n      ...keenableScraperOptions,\n      apiKey: keenableScraperOptions?.apiKey ?? keenableApiKey,\n      timeout: scraperTimeout ?? keenableScraperOptions?.timeout,\n      attributionTitle:\n        keenableScraperOptions?.attributionTitle ??\n        keenableSearchOptions?.attributionTitle,\n      httpAgent: httpAgent ?? keenableScraperOptions?.httpAgent,\n      httpsAgent: httpsAgent ?? keenableScraperOptions?.httpsAgent,\n      logger,\n    });\n  } else {\n    scraperInstance = createFirecrawlScraper({\n      ...firecrawlOptions,\n      apiKey: firecrawlApiKey ?? process.env.FIRECRAWL_API_KEY,\n      apiUrl: firecrawlApiUrl,\n      version: firecrawlVersion,\n      timeout: scraperTimeout ?? firecrawlOptions?.timeout,\n      formats: firecrawlOptions?.formats ?? ['markdown', 'rawHtml'],\n      httpAgent: httpAgent ?? firecrawlOptions?.httpAgent,\n      httpsAgent: httpsAgent ?? firecrawlOptions?.httpsAgent,\n      logger,\n    });\n  }\n\n  const selectedReranker = createReranker({\n    rerankerType,\n    jinaApiKey,\n    jinaApiUrl,\n    cohereApiKey,\n    rerankerTimeout,\n    httpAgent,\n    httpsAgent,\n    logger,\n  });\n\n  if (!selectedReranker) {\n    logger.warn('No reranker selected. Using default ranking.');\n  }\n\n  const sourceProcessor = createSourceProcessor(\n    {\n      reranker: selectedReranker,\n      topResults,\n      maxContentLength,\n      chunkSize,\n      chunkOverlap,\n      strategies,\n      filterContent,\n      logger,\n    },\n    scraperInstance\n  );\n\n  const search = createSearchProcessor({\n    searchAPI,\n    safeSearch,\n    // Keenable is organic-only: its API ignores `type`, so image/news\n    // sub-searches would spend rate limit and merge nothing.\n    supportsImages: searchProvider !== 'keenable',\n    supportsVideos:\n      searchProvider !== 'tavily' &&\n      searchProvider !== 'keenable' &&\n      searchProvider !== 'crw',\n    supportsNews: searchProvider !== 'keenable',\n    sourceProcessor,\n    onGetHighlights,\n    mainExpandBy,\n    separatorExpandBy,\n    logger,\n  });\n\n  return createTool({\n    search,\n    schema: toolSchema,\n    maxOutputChars,\n    onSearchResults: _onSearchResults,\n  });\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,SAAgB,qBACd,MACA,OACoB;CACpB,IAAI,KAAK,SAAS,QAAQ,KAAK,UAAU,IACvC,OAAO,sBAAsB,MAAM;CAErC,MAAM,SACH,KAAK,SAAS,UAAU,MACxB,KAAK,YAAY,UAAU,MAC3B,KAAK,MAAM,UAAU,MACrB,KAAK,QAAQ,UAAU,MACvB,KAAK,QAAQ,UAAU,MACvB,KAAK,QAAQ,UAAU,MACvB,KAAK,eAAe,UAAU,MAC9B,KAAK,kBAAkB,OAAO,IAAI,MAClC,KAAK,aAAa,OAAO,IAAI;CAChC,IAAI,UAAU,GACZ;CAEF,OAAO,SAAS,MAAM,SAAS,UAAU,IAAI,KAAK,IAAI,QAAQ,MAAM;AACtE;;;;;AAMA,eAAsB,wBAAwB,EAC5C,WACA,OACA,MACA,SACA,YACA,QACA,QACA,MACA,UAW0B;CAE1B,MAAM,cAAyC,CAE7C,UAAU,WAAW;EACnB;EACA;EACA;EACA;CACF,CAAC,CACH;CAEA,IAAI,QACF,YAAY,KACV,UACG,WAAW;EACV;EACA;EACA;EACA;EACA,MAAM;CACR,CAAC,CAAC,CACD,OAAO,UAAU;EAChB,OAAO,MAAM,0BAA0B,KAAK;EAC5C,OAAO;GACL,SAAS;GACT,OAAO,yBAAyB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EACvF;CACF,CAAC,CACL;CAEF,IAAI,QACF,YAAY,KACV,UACG,WAAW;EACV;EACA;EACA;EACA;EACA,MAAM;CACR,CAAC,CAAC,CACD,OAAO,UAAU;EAChB,OAAO,MAAM,0BAA0B,KAAK;EAC5C,OAAO;GACL,SAAS;GACT,OAAO,yBAAyB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EACvF;CACF,CAAC,CACL;CAEF,IAAI,MACF,YAAY,KACV,UACG,WAAW;EACV;EACA;EACA;EACA;EACA,MAAM;CACR,CAAC,CAAC,CACD,OAAO,UAAU;EAChB,OAAO,MAAM,wBAAwB,KAAK;EAC1C,OAAO;GACL,SAAS;GACT,OAAO,uBAAuB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EACrF;CACF,CAAC,CACL;CAIF,MAAM,UAAU,MAAM,QAAQ,IAAI,WAAW;CAG7C,MAAM,aAAa,QAAQ;CAC3B,IAAI,CAAC,WAAW,SACd,MAAM,IAAI,MAAM,WAAW,SAAS,eAAe;CAIrD,MAAM,gBAAgB,EAAE,GAAG,WAAW,KAAK;CAG3C,IAAI,cAAc,SAAS,KAAA,KAAa,cAAc,KAAK,SAAS,GAAG;EACrE,MAAM,2BAA2B,cAAc,KAC5C,QAAQ,aAAa,SAAS,SAAS,KAAA,KAAa,SAAS,SAAS,EAAE,CAAC,CACzE,KAAK,cAAc;GAClB,OAAO,SAAS,SAAS;GACzB,MAAM,SAAS,QAAQ;GACvB,QAAQ,SAAS,UAAU;GAC3B,MAAM,SAAS,QAAQ;GACvB,UAAU,SAAS,YAAY;GAC/B,WAAW;EACb,EAAE;EACJ,cAAc,aAAa,CACzB,GAAI,cAAc,cAAc,CAAC,GACjC,GAAG,wBACL;EACA,OAAO,cAAc;CACvB;CAEA,QAAQ,MAAM,CAAC,CAAC,CAAC,SAAS,WAAW;EACnC,IAAI,OAAO,WAAW,OAAO,SAAS,KAAA,GAAW;GAC/C,IAAI,OAAO,KAAK,WAAW,KAAA,KAAa,OAAO,KAAK,OAAO,SAAS,GAClE,cAAc,SAAS,CACrB,GAAI,cAAc,UAAU,CAAC,GAC7B,GAAG,OAAO,KAAK,MACjB;GAEF,IAAI,OAAO,KAAK,WAAW,KAAA,KAAa,OAAO,KAAK,OAAO,SAAS,GAClE,cAAc,SAAS,CACrB,GAAI,cAAc,UAAU,CAAC,GAC7B,GAAG,OAAO,KAAK,MACjB;GAEF,IAAI,OAAO,KAAK,SAAS,KAAA,KAAa,OAAO,KAAK,KAAK,SAAS,GAAG;IACjE,MAAM,mBAAmB,OAAO,KAAK,KAAK,KAAK,cAAc;KAC3D,GAAG;KACH,MAAM,SAAS,QAAQ;IACzB,EAAE;IACF,cAAc,aAAa,CACzB,GAAI,cAAc,cAAc,CAAC,GACjC,GAAG,gBACL;GACF;EACF;CACF,CAAC;CAED,IACE,cAAc,eAAe,KAAA,KAC7B,cAAc,WAAW,SAAS,GAClC;;;;EAIA,MAAM,4BAAY,IAAI,IAAY;EAClC,cAAc,aAAa,cAAc,WAAW,QAAQ,UAAU;GACpE,IAAI,CAAC,MAAM,QAAQ,UAAU,IAAI,MAAM,IAAI,GACzC,OAAO;GAET,UAAU,IAAI,MAAM,IAAI;GACxB,OAAO;EACT,CAAC;CACH;CAEA,OAAO;EAAE,SAAS;EAAM,MAAM;CAAc;AAC9C;AAEA,SAAS,sBAAsB,EAC7B,WACA,YACA,gBACA,gBACA,cACA,iBACA,iBACA,cACA,mBACA,UAYC;CACD,OAAO,eAAgB,EACrB,OACA,MACA,SACA,UAAU,MACV,aAAa,GACb,iBACA,SAAS,OACT,SAAS,OACT,OAAO,SAWuB;EAC9B,IAAI;GAEF,MAAM,eAAe,MAAM,wBAAwB;IACjD;IACA;IACA;IACA;IACA;IACA,QAAQ,kBAAkB;IAC1B,QAAQ,kBAAkB;IAC1B,MAAM,gBAAgB;IACtB;GACF,CAAC;GAED,kBAAkB,YAAY;GAW9B,OAAO,iBACL,MAV6B,gBAAgB,eAAe;IAC5D;IACA;IACA,QAAQ;IACR;IACA;IACA,aAAa;GACf,CAAC,GAIC,cACA,iBACF;EACF,SAAS,OAAO;GACd,OAAO,MAAM,oBAAoB,KAAK;GACtC,OAAO;IACL,SAAS,CAAC;IACV,YAAY,CAAC;IACb,QAAQ,CAAC;IACT,QAAQ,CAAC;IACT,MAAM,CAAC;IACP,iBAAiB,CAAC;IAClB,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAC9D;EACF;CACF;AACF;AAEA,SAAS,sBAAsB,EAC7B,gBACA,mBAIC;CACD,OAAO,SAAU,SAA+B;EAC9C,IAAI,CAAC,iBACH;EAEF,gBAAgB,SAAS,cAAc;CACzC;AACF;AAEA,SAAS,WAAW,EAClB,QACA,QACA,gBACA,iBAAiB,oBAMO;CACxB,OAAO,KACL,OAAO,WAAW,mBAAmB;EAEnC,MAAM,EAAE,OAAO,MAAM,SAAS,IAAI,QAAQ,QAAQ,SAASA;EAE3D,MAAM,eAAe,MAAM,OAAO;GAChC;GACA;GACA,SAJc,OAAO,OAAO,YAAY,KAAK,KAAK,KAAA;GAKlD;GACA;GACA;GACA,iBAAiB,sBAAsB;IACrC;IACA,iBAAiB;GACnB,CAAC;EACH,CAAC;EACD,MAAM,OAAO,eAAe,UAAU,QAAQ;EAC9C,MAAM,EAAE,QAAQ,eAAe,oBAC7B,MACA,cACA,cACF;EACA,MAAM,OAA2B;GAAE;GAAM,GAAG;GAAc;EAAW;EACrE,MAAM,UAAU,qBAAqB,MAAM,KAAK;EAChD,OAAO,CACL,QACA;mBAA0B;GAAM,GAAI,WAAW,QAAQ,EAAE,QAAQ;EAAG,CACtE;CACF,GACA;EACE,MAAM;EACN,aAAa;EACL;EACR,gBAAA;CACF,CACF;AACF;AAoBA,MAAa,oBACX,SAA6B,CAAC,MACJ;CAC1B,MAAM,EACJ,iBAAiB,UACjB,cACA,oBACA,eACA,cACA,iBACA,kBACA,qBACA,gBACA,gBACA,uBACA,wBACA,eAAe,UACf,iBACA,aAAa,GACb,kBACA,WACA,cACA,cACA,mBACA,gBACA,aAAa,CAAC,eAAe,GAC7B,gBAAgB,MAChB,aAAa,GACb,kBAAkB,aAClB,iBACA,iBACA,kBACA,kBACA,sBACA,sBACA,WACA,WACA,kBACA,mBACA,gBACA,YACA,YACA,cACA,WACA,YACA,iBAAiB,kBACjB,oBACE;CAEJ,MAAM,SAAS,OAAO,UAAU,oBAAoB;CACpD,MAAM,+BACJ,mBAAmB,YAAY,OAAO,cAAc,OAChD;EACA,GAAG;EACH,YAAY,OAAO,eAAe;CACpC,IACE;CAEN,MAAM,mBAA4C;EAChD,QAAQ,EAAE,GAAG,gBAAgB;EAC7B,OAAO;EACP,MAAM;EACN,QAAQ;EACR,QAAQ;EACR,MAAM;CACR;CAEA,IAAI,mBAAmB,YAAY,mBAAmB,UACpD,iBAAiB,UAAU;CAG7B,MAAM,aAAa;EACjB,MAAM;EACN,YAAY;EACZ,UAAU,CAAC,OAAO;CACpB;CAEA,MAAM,YAAY,gBAAgB;EAChC;EACA;EACA;EACA;EACA;EACA;EACA,qBAAqB;EACrB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;;CAGD,IAAI;CAEJ,IAAI,oBAAoB,UACtB,kBAAkB,oBAAoB;EACpC,GAAG;EACH,QAAQ;EACR,SAAS,kBAAkB,sBAAsB;EACjD,WAAW,aAAa,sBAAsB;EAC9C,YAAY,cAAc,sBAAsB;EAChD;CACF,CAAC;MACI,IAAI,oBAAoB,UAC7B,kBAAkB,oBAAoB;EACpC,GAAG;EACH,QACE,sBAAsB,UACtB,gBACA,QAAQ,IAAI;EACd,QAAQ,sBAAsB,UAAU;EACxC,SAAS,kBAAkB,sBAAsB;EACjD,WAAW,aAAa,sBAAsB;EAC9C,YAAY,cAAc,sBAAsB;EAChD;CACF,CAAC;MACI,IAAI,oBAAoB,OAC7B,kBAAkB,iBAAiB;EACjC,GAAG;EACH,QAAQ,mBAAmB,UAAU,aAAa,QAAQ,IAAI;EAC9D,QAAQ,mBAAmB,UAAU;EACrC,SAAS,kBAAkB,mBAAmB;EAC9C,SAAS,mBAAmB,WAAW,CAAC,YAAY,SAAS;EAC7D,WAAW,aAAa,mBAAmB;EAC3C,YAAY,cAAc,mBAAmB;EAC7C;CACF,CAAC;MACI,IAAI,oBAAoB,YAC7B,kBAAkB,sBAAsB;EACtC,GAAG;EACH,QAAQ,wBAAwB,UAAU;EAC1C,SAAS,kBAAkB,wBAAwB;EACnD,kBACE,wBAAwB,oBACxB,uBAAuB;EACzB,WAAW,aAAa,wBAAwB;EAChD,YAAY,cAAc,wBAAwB;EAClD;CACF,CAAC;MAED,kBAAkB,uBAAuB;EACvC,GAAG;EACH,QAAQ,mBAAmB,QAAQ,IAAI;EACvC,QAAQ;EACR,SAAS;EACT,SAAS,kBAAkB,kBAAkB;EAC7C,SAAS,kBAAkB,WAAW,CAAC,YAAY,SAAS;EAC5D,WAAW,aAAa,kBAAkB;EAC1C,YAAY,cAAc,kBAAkB;EAC5C;CACF,CAAC;CAGH,MAAM,mBAAmB,eAAe;EACtC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;CAED,IAAI,CAAC,kBACH,OAAO,KAAK,8CAA8C;CAG5D,MAAM,kBAAkB,sBACtB;EACE,UAAU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;CACF,GACA,eACF;CAoBA,OAAO,WAAW;EAChB,QAnBa,sBAAsB;GACnC;GACA;GAGA,gBAAgB,mBAAmB;GACnC,gBACE,mBAAmB,YACnB,mBAAmB,cACnB,mBAAmB;GACrB,cAAc,mBAAmB;GACjC;GACA;GACA;GACA;GACA;EACF,CAGO;EACL,QAAQ;EACR;EACA,iBAAiB;CACnB,CAAC;AACH"}

package/dist/esm/tools/subagent/SubagentExecutor.mjs

@@ -1,5 +1,6 @@
 import "../../common/enum.mjs";
 import "../../common/index.mjs";
+import { StreamLimitExceededError } from "../../llm/streamLimits.mjs";
 import { executeHooks } from "../../hooks/executeHooks.mjs";
 import "../../hooks/index.mjs";
 import { nanoid } from "nanoid";
@@ -24,11 +25,20 @@ const LANGGRAPH_CHECKPOINT_CONFIG_KEYS = new Set([
 var SubagentExecutor = class {
 	configs;
 	parentSignal;
+	/** Aborted when a child trips a stream circuit breaker: parallel sibling
+	* subagents run concurrently on the parent's signal, and rejecting the
+	* batch alone would leave their provider requests streaming after the
+	* safety abort. One-way by design — a tripped breaker ends the run, so no
+	* later child of this executor should start either. Fallback for hosts
+	* that do not supply the graph's shared `breakerScope`. */
+	childRunAbort = new AbortController();
+	breakerScope;
 	hookRegistry;
 	parentRunId;
 	parentAgentId;
 	langfuse;
 	tokenCounter;
+	streamLimits;
 	maxDepth;
 	createChildGraph;
 	usageSink;
@@ -36,11 +46,13 @@ var SubagentExecutor = class {
 	constructor(options) {
 		this.configs = options.configs;
 		this.parentSignal = options.parentSignal;
+		this.breakerScope = options.breakerScope;
 		this.hookRegistry = options.hookRegistry;
 		this.parentRunId = options.parentRunId;
 		this.parentAgentId = options.parentAgentId;
 		this.langfuse = options.langfuse;
 		this.tokenCounter = options.tokenCounter;
+		this.streamLimits = options.streamLimits;
 		this.maxDepth = options.maxDepth ?? 1;
 		this.createChildGraph = options.createChildGraph;
 		this.usageSink = options.usageSink;
@@ -48,12 +60,34 @@ var SubagentExecutor = class {
 		if (typeof rawRegistry === "function") this.resolveParentHandlerRegistry = rawRegistry;
 		else if (rawRegistry != null) this.resolveParentHandlerRegistry = () => rawRegistry;
 	}
+	/** The breaker controller current for this execution — read per spawn
+	* because the graph recreates its controller each run. */
+	resolveBreakerController() {
+		return this.breakerScope?.controller() ?? this.childRunAbort;
+	}
+	/** One signal that fires on the parent's abort or the breaker abort,
+	* collapsed to a single signal when possible (mirrors
+	* `composeAbortSignals` in Graph.ts). */
+	composeChildSignal(breaker) {
+		const child = breaker.signal;
+		if (this.parentSignal == null || this.parentSignal === child) return child;
+		return AbortSignal.any([this.parentSignal, child]);
+	}
 	/** Snapshot of the parent's registry at the moment a subagent is dispatched. */
 	getParentHandlerRegistry() {
 		return this.resolveParentHandlerRegistry?.();
 	}
 	async execute(params) {
 		const { description, subagentType, threadId, parentToolCallId } = params;
+		/** Captured ONCE per execution, preferring the controller the parent
+		* tool batch captured at ITS entry (before PreToolUse hooks): a failed
+		* run's graph reset replaces the live controller, and resolving it here
+		* — after the hook awaits — would bind this child to the NEW run's
+		* un-aborted controller: reviving old-run work, or worse, tripping the
+		* new run's breaker from an old child's stream-limit breach. Signal and
+		* trip target both bind to this capture. */
+		const childBreaker = params.breaker ?? this.resolveBreakerController();
+		const childSignal = this.composeChildSignal(childBreaker);
 		const config = this.configs.get(subagentType);
 		if (!config) return {
 			content: `Error: Unknown subagent type "${subagentType}". Available types: ${[...this.configs.keys()].join(", ")}`,
@@ -107,10 +141,11 @@ var SubagentExecutor = class {
 		const hostUsageSink = this.usageSink;
 		const childGraph = this.createChildGraph({
 			runId: childRunId,
-			signal: this.parentSignal,
+			signal: childSignal,
 			agents: [childInputs],
 			langfuse: this.langfuse,
 			tokenCounter: this.tokenCounter,
+			streamLimits: this.streamLimits,
 			subagentScope: true,
 			/**
 			* Forwarded so the child graph's own `SubagentExecutor` (created in
@@ -220,7 +255,7 @@ var SubagentExecutor = class {
 			const inheritedConfigurable = sanitizeChildConfigurable(params.parentConfigurable);
 			result = await workflow.invoke({ messages: [new HumanMessage(description)] }, {
 				recursionLimit: maxTurns * RECURSION_MULTIPLIER,
-				signal: this.parentSignal,
+				signal: childSignal,
 				callbacks,
 				runName: `subagent:${subagentType}`,
 				configurable: {
@@ -229,6 +264,14 @@ var SubagentExecutor = class {
 				}
 			});
 		} catch (error) {
+			/** Aborted before any observational work below: parallel siblings — in
+			* this executor and, via the graph-scoped breaker, under other
+			* parallel agent nodes — stream on the composed child signal, and
+			* awaiting forwarding.drain() first would let them consume provider
+			* quota for that entire interval. Trips the ENTRY-captured controller:
+			* after a reset, a straggler must break its own dead run, not the
+			* current one. */
+			if (error instanceof StreamLimitExceededError) childBreaker.abort(error);
 			const errorMessage = truncateErrorMessage(error);
 			if (forwarding) {
 				await forwarding.drain();
@@ -243,6 +286,14 @@ var SubagentExecutor = class {
 				});
 			}
 			childGraph.clearHeavyState();
+			/**
+			* A tripped stream circuit breaker is a safety abort, not a recoverable
+			* subagent failure: converting it into a tool result would let the
+			* parent keep generating (or spawn another child) after the limit
+			* fired. Rethrown here and passed through ToolNode's error conversion,
+			* so the parent run rejects with the child's limit error.
+			*/
+			if (error instanceof StreamLimitExceededError) throw error;
 			return {
 				content: `Subagent error: ${errorMessage}`,
 				messages: []
@@ -531,7 +582,7 @@ function sanitizeChildConfigurable(parentConfigurable) {
 	return Object.fromEntries(Object.entries(parentConfigurable).filter(([key]) => !isLangGraphRuntimeConfigKey(key)));
 }
 function isLangGraphRuntimeConfigKey(key) {
-	return key.startsWith(LANGGRAPH_RUNTIME_CONFIG_PREFIX) || LANGGRAPH_CHECKPOINT_CONFIG_KEYS.has(key);
+	return key.startsWith(LANGGRAPH_RUNTIME_CONFIG_PREFIX) || LANGGRAPH_CHECKPOINT_CONFIG_KEYS.has(key) || key === "lc_run_breaker_scope";
 }
 function sanitizeForwardedSubagentUpdateData(eventName, data) {
 	if (eventName === "on_tool_execute") return sanitizeToolExecuteUpdateData(data);