@illuma-ai/agents 1.5.1 → 2.1.1

package/dist/cjs/types/agent-cache.cjs

@@ -1,54 +0,0 @@
-'use strict';
-
-/**
- * Agent system-message prompt-cache types.
- * ==========================================
- *
- * `@illuma-ai/agents` exposes a generic primitive — `system_cache_blocks` —
- * for composing a system message that gets explicit cache markers
- * (cachePoint on Bedrock, cache_control on Anthropic) at consumer-defined
- * boundaries. The library encodes each entry into the right wire format
- * for the active provider; consumers decide what content to put in each
- * block.
- *
- * Why this is generic rather than tier-named
- * ------------------------------------------------
- * Earlier iterations exposed `platform_instructions` and `cache_ttl:
- * { platform, agent }` — vocabulary borrowed from a specific consumer's
- * multi-tenant chat-platform mental model. That leaked one consumer's
- * domain into the library and made it confusing for other consumers
- * (CLI tools, desktop apps, gateways) which have no notion of
- * "platforms" or "agents".
- *
- * The current shape lets every consumer define their own cache-tier
- * organization without the library knowing or caring.
- *
- * Cache key composition
- * ---------------------
- * Both Anthropic and Bedrock hash the message bytes leading up to each
- * cache marker. So entry N's cache key is the concatenation of bytes
- * 0..N. Stable content (universal rules, framework docs) goes earlier;
- * volatile content (per-agent identity, per-tool docs) goes later. The
- * earlier entries get cross-tenant cache hits; the later entries get
- * narrower hits.
- *
- * Provider budget
- * ---------------
- * Bedrock's Converse API supports up to 4 cachePoint blocks per request.
- * The default tools-array cache strategy (see `IllumaBedrockConverse`)
- * uses up to 2 of those. So at most 2 entries should appear in
- * `system_cache_blocks` to leave budget for the trailing
- * `instructions` block. The library throws on more than 2.
- *
- * Anthropic supports up to 4 cache breakpoints per request workspace-wide;
- * the same constraint applies to keep tools + system within budget.
- */
-/**
- * Maximum number of `system_cache_blocks` entries the library accepts.
- * Higher than this would exceed Bedrock's 4-cachePoint budget once the
- * tools array and trailing `instructions` block are counted.
- */
-const MAX_SYSTEM_CACHE_BLOCKS = 2;
-
-exports.MAX_SYSTEM_CACHE_BLOCKS = MAX_SYSTEM_CACHE_BLOCKS;
-//# sourceMappingURL=agent-cache.cjs.map

package/dist/cjs/types/agent-cache.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-cache.cjs","sources":["../../../src/types/agent-cache.ts"],"sourcesContent":["/**\n * Agent system-message prompt-cache types.\n * ==========================================\n *\n * `@illuma-ai/agents` exposes a generic primitive — `system_cache_blocks` —\n * for composing a system message that gets explicit cache markers\n * (cachePoint on Bedrock, cache_control on Anthropic) at consumer-defined\n * boundaries. The library encodes each entry into the right wire format\n * for the active provider; consumers decide what content to put in each\n * block.\n *\n * Why this is generic rather than tier-named\n * ------------------------------------------------\n * Earlier iterations exposed `platform_instructions` and `cache_ttl:\n * { platform, agent }` — vocabulary borrowed from a specific consumer's\n * multi-tenant chat-platform mental model. That leaked one consumer's\n * domain into the library and made it confusing for other consumers\n * (CLI tools, desktop apps, gateways) which have no notion of\n * \"platforms\" or \"agents\".\n *\n * The current shape lets every consumer define their own cache-tier\n * organization without the library knowing or caring.\n *\n * Cache key composition\n * ---------------------\n * Both Anthropic and Bedrock hash the message bytes leading up to each\n * cache marker. So entry N's cache key is the concatenation of bytes\n * 0..N. Stable content (universal rules, framework docs) goes earlier;\n * volatile content (per-agent identity, per-tool docs) goes later. The\n * earlier entries get cross-tenant cache hits; the later entries get\n * narrower hits.\n *\n * Provider budget\n * ---------------\n * Bedrock's Converse API supports up to 4 cachePoint blocks per request.\n * The default tools-array cache strategy (see `IllumaBedrockConverse`)\n * uses up to 2 of those. So at most 2 entries should appear in\n * `system_cache_blocks` to leave budget for the trailing\n * `instructions` block. The library throws on more than 2.\n *\n * Anthropic supports up to 4 cache breakpoints per request workspace-wide;\n * the same constraint applies to keep tools + system within budget.\n */\n\n/** Provider TTL hint applied to a cachePoint / cache_control marker. */\nexport type AgentCacheTTL = '5m' | '1h';\n\n/**\n * One cacheable system content block. Each entry produces a text block\n * followed by a provider-specific cache marker in the assembled system\n * message. Entries are emitted in array order — earlier = more stable\n * = wider cache key.\n */\nexport interface SystemCacheBlock {\n  /**\n   * Text payload. Caller is responsible for keeping this byte-stable\n   * across requests that should share a cache entry. ANY change to\n   * these bytes invalidates every cache key that includes this entry.\n   */\n  text: string;\n  /**\n   * Optional TTL hint for the cache marker. Defaults to '5m' when\n   * omitted. '1h' costs more to write (2× base vs 1.25×) but survives\n   * longer idle, which is the right tradeoff for low-traffic blocks.\n   */\n  ttl?: AgentCacheTTL;\n}\n\n/**\n * Maximum number of `system_cache_blocks` entries the library accepts.\n * Higher than this would exceed Bedrock's 4-cachePoint budget once the\n * tools array and trailing `instructions` block are counted.\n */\nexport const MAX_SYSTEM_CACHE_BLOCKS = 2;\n"],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CG;AA0BH;;;;AAIG;AACI,MAAM,uBAAuB,GAAG;;;;"}

package/dist/esm/langchain/google-common.mjs

@@ -1,2 +0,0 @@
-
-//# sourceMappingURL=google-common.mjs.map

package/dist/esm/langchain/google-common.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"google-common.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/esm/langchain/index.mjs

@@ -1,5 +0,0 @@
-export { AIMessage, AIMessageChunk, BaseMessage, BaseMessageChunk, HumanMessage, SystemMessage, ToolMessage, getBufferString, isAIMessage, isBaseMessage, isToolMessage } from '@langchain/core/messages';
-export { PromptTemplate } from '@langchain/core/prompts';
-export { Runnable, RunnableLambda, RunnableSequence } from '@langchain/core/runnables';
-export { DynamicStructuredTool, StructuredTool, Tool, tool } from '@langchain/core/tools';
-//# sourceMappingURL=index.mjs.map

package/dist/esm/langchain/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/esm/langchain/language_models/chat_models.mjs

@@ -1,2 +0,0 @@
-
-//# sourceMappingURL=chat_models.mjs.map

package/dist/esm/langchain/language_models/chat_models.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"chat_models.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/esm/langchain/messages/tool.mjs

@@ -1,2 +0,0 @@
-
-//# sourceMappingURL=tool.mjs.map

package/dist/esm/langchain/messages/tool.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/esm/langchain/messages.mjs

@@ -1,2 +0,0 @@
-export { AIMessage, AIMessageChunk, BaseMessage, BaseMessageChunk, HumanMessage, SystemMessage, ToolMessage, getBufferString, isAIMessage, isBaseMessage, isToolMessage } from '@langchain/core/messages';
-//# sourceMappingURL=messages.mjs.map

package/dist/esm/langchain/messages.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"messages.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/esm/langchain/openai.mjs

@@ -1,2 +0,0 @@
-
-//# sourceMappingURL=openai.mjs.map

package/dist/esm/langchain/openai.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/esm/langchain/prompts.mjs

@@ -1,2 +0,0 @@
-export { PromptTemplate } from '@langchain/core/prompts';
-//# sourceMappingURL=prompts.mjs.map

package/dist/esm/langchain/prompts.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"prompts.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/esm/langchain/runnables.mjs

@@ -1,2 +0,0 @@
-export { Runnable, RunnableLambda, RunnableSequence } from '@langchain/core/runnables';
-//# sourceMappingURL=runnables.mjs.map

package/dist/esm/langchain/runnables.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"runnables.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/esm/langchain/tools.mjs

@@ -1,2 +0,0 @@
-export { DynamicStructuredTool, StructuredTool, Tool, tool } from '@langchain/core/tools';
-//# sourceMappingURL=tools.mjs.map

package/dist/esm/langchain/tools.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/esm/langchain/utils/env.mjs

@@ -1,2 +0,0 @@
-export { getEnvironmentVariable } from '@langchain/core/utils/env';
-//# sourceMappingURL=env.mjs.map

package/dist/esm/langchain/utils/env.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"env.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/esm/llm/bedrock/cacheSupport.mjs

@@ -1,52 +0,0 @@
-/**
- * Bedrock prompt-cache model support detection.
- * ===============================================
- *
- * Bedrock prompt caching (via `cachePoint` blocks) is only supported on
- * specific model families. Other families silently reject or ignore the
- * markers. We maintain an allowlist instead of a substring heuristic so
- * a future model with an unfortunate name (e.g. `llama-claude-killer`)
- * doesn't accidentally match.
- *
- * Consumers can extend the allowlist with `bedrockCacheModelPatterns` in
- * `clientOptions` for proprietary or pre-release model IDs not yet in
- * the reference library.
- */
-/**
- * Default allowlist of Bedrock model ID patterns that support cachePoint.
- * Sourced from AWS Bedrock documentation (verified against us-east-1
- * 2026-05).
- *
- * Adding a new model: append a RegExp here AND add a regression test in
- * `cacheSupport.test.ts` covering at least one full model ID for that
- * family. Removing a model: do not remove without operator confirmation
- * — silent removal would suddenly stop emitting cachePoint markers and
- * regress cost savings.
- */
-const DEFAULT_BEDROCK_CACHE_MODEL_PATTERNS = [
-    // Anthropic Claude family (anthropic.claude-* and us.anthropic.claude-*)
-    /(?:^|[/.])anthropic\.claude-/i,
-    /(?:^|\.)us\.anthropic\.claude-/i,
-    // Amazon Nova family (nova-pro, nova-lite, nova-canvas, etc.)
-    /(?:^|[/.])amazon\.nova-/i,
-    /(?:^|\.)us\.amazon\.nova-/i,
-];
-/**
- * Returns true when the given Bedrock model ID belongs to a family that
- * supports cachePoint blocks. `additionalPatterns` lets consumers extend
- * the allowlist for models the library doesn't know about yet.
- *
- * @param modelId  Bedrock model ID (e.g. `us.anthropic.claude-sonnet-4-5-20250929-v1:0`)
- * @param additionalPatterns  Extra patterns from consumer config
- */
-function isBedrockCacheSupported(modelId, additionalPatterns) {
-    if (!modelId)
-        return false;
-    const allPatterns = additionalPatterns
-        ? [...DEFAULT_BEDROCK_CACHE_MODEL_PATTERNS, ...additionalPatterns]
-        : DEFAULT_BEDROCK_CACHE_MODEL_PATTERNS;
-    return allPatterns.some((p) => p.test(modelId));
-}
-
-export { DEFAULT_BEDROCK_CACHE_MODEL_PATTERNS, isBedrockCacheSupported };
-//# sourceMappingURL=cacheSupport.mjs.map

package/dist/esm/llm/bedrock/cacheSupport.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"cacheSupport.mjs","sources":["../../../../src/llm/bedrock/cacheSupport.ts"],"sourcesContent":["/**\n * Bedrock prompt-cache model support detection.\n * ===============================================\n *\n * Bedrock prompt caching (via `cachePoint` blocks) is only supported on\n * specific model families. Other families silently reject or ignore the\n * markers. We maintain an allowlist instead of a substring heuristic so\n * a future model with an unfortunate name (e.g. `llama-claude-killer`)\n * doesn't accidentally match.\n *\n * Consumers can extend the allowlist with `bedrockCacheModelPatterns` in\n * `clientOptions` for proprietary or pre-release model IDs not yet in\n * the reference library.\n */\n\n/**\n * Default allowlist of Bedrock model ID patterns that support cachePoint.\n * Sourced from AWS Bedrock documentation (verified against us-east-1\n * 2026-05).\n *\n * Adding a new model: append a RegExp here AND add a regression test in\n * `cacheSupport.test.ts` covering at least one full model ID for that\n * family. Removing a model: do not remove without operator confirmation\n * — silent removal would suddenly stop emitting cachePoint markers and\n * regress cost savings.\n */\nexport const DEFAULT_BEDROCK_CACHE_MODEL_PATTERNS: readonly RegExp[] = [\n  // Anthropic Claude family (anthropic.claude-* and us.anthropic.claude-*)\n  /(?:^|[/.])anthropic\\.claude-/i,\n  /(?:^|\\.)us\\.anthropic\\.claude-/i,\n  // Amazon Nova family (nova-pro, nova-lite, nova-canvas, etc.)\n  /(?:^|[/.])amazon\\.nova-/i,\n  /(?:^|\\.)us\\.amazon\\.nova-/i,\n];\n\n/**\n * Returns true when the given Bedrock model ID belongs to a family that\n * supports cachePoint blocks. `additionalPatterns` lets consumers extend\n * the allowlist for models the library doesn't know about yet.\n *\n * @param modelId  Bedrock model ID (e.g. `us.anthropic.claude-sonnet-4-5-20250929-v1:0`)\n * @param additionalPatterns  Extra patterns from consumer config\n */\nexport function isBedrockCacheSupported(\n  modelId: string | undefined,\n  additionalPatterns?: readonly RegExp[],\n): boolean {\n  if (!modelId) return false;\n  const allPatterns = additionalPatterns\n    ? [...DEFAULT_BEDROCK_CACHE_MODEL_PATTERNS, ...additionalPatterns]\n    : DEFAULT_BEDROCK_CACHE_MODEL_PATTERNS;\n  return allPatterns.some((p) => p.test(modelId));\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;AAaG;AAEH;;;;;;;;;;AAUG;AACI,MAAM,oCAAoC,GAAsB;;IAErE,+BAA+B;IAC/B,iCAAiC;;IAEjC,0BAA0B;IAC1B,4BAA4B;;AAG9B;;;;;;;AAOG;AACG,SAAU,uBAAuB,CACrC,OAA2B,EAC3B,kBAAsC,EAAA;AAEtC,IAAA,IAAI,CAAC,OAAO;AAAE,QAAA,OAAO,KAAK;IAC1B,MAAM,WAAW,GAAG;AAClB,UAAE,CAAC,GAAG,oCAAoC,EAAE,GAAG,kBAAkB;UAC/D,oCAAoC;AACxC,IAAA,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACjD;;;;"}

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

@@ -1,186 +0,0 @@
-import axios from 'axios';
-import { createDefaultLogger } from './utils.mjs';
-
-const DEFAULT_BASIC_TIMEOUT = 15000;
-const DEFAULT_ADVANCED_TIMEOUT = 30000;
-const MAX_BATCH_SIZE = 20;
-const getDefaultTimeout = (extractDepth) => extractDepth === 'advanced'
-    ? DEFAULT_ADVANCED_TIMEOUT
-    : DEFAULT_BASIC_TIMEOUT;
-const normalizeUrlKey = (url) => {
-    try {
-        const parsedUrl = new URL(url);
-        parsedUrl.hash = '';
-        if (parsedUrl.pathname.length > 1) {
-            parsedUrl.pathname = parsedUrl.pathname.replace(/\/+$/, '');
-        }
-        return parsedUrl.toString();
-    }
-    catch {
-        return url;
-    }
-};
-const setUrlResult = (map, result) => {
-    map.set(result.url, result);
-    const normalizedUrl = normalizeUrlKey(result.url);
-    if (!map.has(normalizedUrl)) {
-        map.set(normalizedUrl, result);
-    }
-};
-class TavilyScraper {
-    apiKey;
-    apiUrl;
-    timeout;
-    payloadTimeout;
-    logger;
-    extractDepth;
-    includeImages;
-    includeFavicon;
-    format;
-    constructor(config = {}) {
-        this.apiKey = config.apiKey ?? process.env.TAVILY_API_KEY ?? '';
-        this.apiUrl =
-            config.apiUrl ??
-                process.env.TAVILY_EXTRACT_URL ??
-                'https://api.tavily.com/extract';
-        this.payloadTimeout = config.timeout;
-        this.extractDepth = config.extractDepth ?? 'basic';
-        this.timeout = config.timeout ?? getDefaultTimeout(this.extractDepth);
-        this.includeImages = config.includeImages ?? false;
-        this.includeFavicon = config.includeFavicon ?? false;
-        this.format = config.format;
-        this.logger = config.logger || createDefaultLogger();
-        if (!this.apiKey) {
-            this.logger.warn('TAVILY_API_KEY is not set. Scraping will not work.');
-        }
-    }
-    async scrapeUrl(url, options = {}) {
-        const results = await this.scrapeUrls([url], options);
-        return results[0];
-    }
-    async scrapeUrls(urls, options = {}) {
-        if (!this.apiKey) {
-            return urls.map((url) => [
-                url,
-                { success: false, error: 'TAVILY_API_KEY is not set' },
-            ]);
-        }
-        const batches = [];
-        for (let i = 0; i < urls.length; i += MAX_BATCH_SIZE) {
-            batches.push(urls.slice(i, i + MAX_BATCH_SIZE));
-        }
-        const allResults = [];
-        for (const batch of batches) {
-            const batchResults = await this.extractBatch(batch, options);
-            allResults.push(...batchResults);
-        }
-        return allResults;
-    }
-    async extractBatch(urls, options = {}) {
-        try {
-            const includeFavicon = options.includeFavicon ?? this.includeFavicon;
-            const format = options.format ?? this.format;
-            const extractDepth = options.extractDepth ?? this.extractDepth;
-            const payload = {
-                urls,
-                extract_depth: extractDepth,
-                include_images: options.includeImages ?? this.includeImages,
-            };
-            if (includeFavicon) {
-                payload.include_favicon = true;
-            }
-            if (format != null) {
-                payload.format = format;
-            }
-            const effectiveTimeout = options.timeout ??
-                this.payloadTimeout ??
-                (options.extractDepth != null
-                    ? getDefaultTimeout(extractDepth)
-                    : this.timeout);
-            const payloadTimeout = options.timeout ?? this.payloadTimeout;
-            if (payloadTimeout != null) {
-                payload.timeout = Math.min(Math.max(payloadTimeout / 1000, 1), 60);
-            }
-            const response = await axios.post(this.apiUrl, payload, {
-                headers: {
-                    Authorization: `Bearer ${this.apiKey}`,
-                    'Content-Type': 'application/json',
-                },
-                timeout: effectiveTimeout,
-            });
-            const data = response.data;
-            const successMap = new Map();
-            const failedMap = new Map();
-            for (const result of data.results ?? []) {
-                setUrlResult(successMap, result);
-            }
-            for (const result of data.failed_results ?? []) {
-                setUrlResult(failedMap, result);
-            }
-            return urls.map((url) => {
-                const success = successMap.get(url) ?? successMap.get(normalizeUrlKey(url));
-                if (success && success.error == null) {
-                    return [
-                        url,
-                        {
-                            success: true,
-                            data: {
-                                rawContent: success.raw_content ?? '',
-                                images: success.images ?? [],
-                                favicon: success.favicon,
-                            },
-                        },
-                    ];
-                }
-                const failed = failedMap.get(url) ?? failedMap.get(normalizeUrlKey(url));
-                const error = success?.error ??
-                    failed?.error ??
-                    'URL not found in Tavily Extract response';
-                return [url, { success: false, error }];
-            });
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            return urls.map((url) => [
-                url,
-                {
-                    success: false,
-                    error: `Tavily Extract API request failed: ${errorMessage}`,
-                },
-            ]);
-        }
-    }
-    extractContent(response) {
-        if (!response.success || !response.data) {
-            return ['', undefined];
-        }
-        const content = response.data.rawContent ?? '';
-        const images = response.data.images ?? [];
-        const references = images.length > 0
-            ? {
-                links: [],
-                images: images.map((imageUrl) => ({ originalUrl: imageUrl })),
-                videos: [],
-            }
-            : undefined;
-        return [content, references];
-    }
-    extractMetadata(response) {
-        if (!response.success || !response.data) {
-            return {};
-        }
-        const metadata = {
-            images_count: response.data.images?.length ?? 0,
-        };
-        if (response.data.favicon != null) {
-            metadata.favicon = response.data.favicon;
-        }
-        return metadata;
-    }
-}
-const createTavilyScraper = (config = {}) => {
-    return new TavilyScraper(config);
-};
-
-export { TavilyScraper, createTavilyScraper };
-//# sourceMappingURL=tavily-scraper.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"tavily-scraper.mjs","sources":["../../../../src/tools/search/tavily-scraper.ts"],"sourcesContent":["import axios from 'axios';\nimport type * as t from './types';\nimport { createDefaultLogger } from './utils';\n\nconst DEFAULT_BASIC_TIMEOUT = 15000;\nconst DEFAULT_ADVANCED_TIMEOUT = 30000;\nconst MAX_BATCH_SIZE = 20;\n\nconst getDefaultTimeout = (extractDepth: 'basic' | 'advanced'): number =>\n  extractDepth === 'advanced'\n    ? DEFAULT_ADVANCED_TIMEOUT\n    : DEFAULT_BASIC_TIMEOUT;\n\nconst normalizeUrlKey = (url: string): string => {\n  try {\n    const parsedUrl = new URL(url);\n    parsedUrl.hash = '';\n    if (parsedUrl.pathname.length > 1) {\n      parsedUrl.pathname = parsedUrl.pathname.replace(/\\/+$/, '');\n    }\n    return parsedUrl.toString();\n  } catch {\n    return url;\n  }\n};\n\nconst setUrlResult = (\n  map: Map<string, t.TavilyExtractResult>,\n  result: t.TavilyExtractResult\n): void => {\n  map.set(result.url, result);\n  const normalizedUrl = normalizeUrlKey(result.url);\n  if (!map.has(normalizedUrl)) {\n    map.set(normalizedUrl, result);\n  }\n};\n\nexport class TavilyScraper implements t.BaseScraper {\n  private apiKey: string;\n  private apiUrl: string;\n  private timeout: number;\n  private payloadTimeout: number | undefined;\n  private logger: t.Logger;\n  private extractDepth: 'basic' | 'advanced';\n  private includeImages: boolean;\n  private includeFavicon: boolean;\n  private format: 'markdown' | 'text' | undefined;\n\n  constructor(config: t.TavilyScraperConfig = {}) {\n    this.apiKey = config.apiKey ?? process.env.TAVILY_API_KEY ?? '';\n    this.apiUrl =\n      config.apiUrl ??\n      process.env.TAVILY_EXTRACT_URL ??\n      'https://api.tavily.com/extract';\n    this.payloadTimeout = config.timeout;\n    this.extractDepth = config.extractDepth ?? 'basic';\n    this.timeout = config.timeout ?? getDefaultTimeout(this.extractDepth);\n    this.includeImages = config.includeImages ?? false;\n    this.includeFavicon = config.includeFavicon ?? false;\n    this.format = config.format;\n    this.logger = config.logger || createDefaultLogger();\n\n    if (!this.apiKey) {\n      this.logger.warn('TAVILY_API_KEY is not set. Scraping will not work.');\n    }\n  }\n\n  async scrapeUrl(\n    url: string,\n    options: t.TavilyScrapeOptions = {}\n  ): Promise<[string, t.TavilyScrapeResponse]> {\n    const results = await this.scrapeUrls([url], options);\n    return results[0];\n  }\n\n  async scrapeUrls(\n    urls: string[],\n    options: t.TavilyScrapeOptions = {}\n  ): Promise<Array<[string, t.TavilyScrapeResponse]>> {\n    if (!this.apiKey) {\n      return urls.map((url) => [\n        url,\n        { success: false, error: 'TAVILY_API_KEY is not set' },\n      ]);\n    }\n\n    const batches: string[][] = [];\n    for (let i = 0; i < urls.length; i += MAX_BATCH_SIZE) {\n      batches.push(urls.slice(i, i + MAX_BATCH_SIZE));\n    }\n\n    const allResults: Array<[string, t.TavilyScrapeResponse]> = [];\n\n    for (const batch of batches) {\n      const batchResults = await this.extractBatch(batch, options);\n      allResults.push(...batchResults);\n    }\n\n    return allResults;\n  }\n\n  private async extractBatch(\n    urls: string[],\n    options: t.TavilyScrapeOptions = {}\n  ): Promise<Array<[string, t.TavilyScrapeResponse]>> {\n    try {\n      const includeFavicon = options.includeFavicon ?? this.includeFavicon;\n      const format = options.format ?? this.format;\n      const extractDepth = options.extractDepth ?? this.extractDepth;\n      const payload: t.TavilyExtractPayload = {\n        urls,\n        extract_depth: extractDepth,\n        include_images: options.includeImages ?? this.includeImages,\n      };\n\n      if (includeFavicon) {\n        payload.include_favicon = true;\n      }\n      if (format != null) {\n        payload.format = format;\n      }\n\n      const effectiveTimeout =\n        options.timeout ??\n        this.payloadTimeout ??\n        (options.extractDepth != null\n          ? getDefaultTimeout(extractDepth)\n          : this.timeout);\n      const payloadTimeout = options.timeout ?? this.payloadTimeout;\n      if (payloadTimeout != null) {\n        payload.timeout = Math.min(Math.max(payloadTimeout / 1000, 1), 60);\n      }\n\n      const response = await axios.post<{\n        results?: t.TavilyExtractResult[];\n        failed_results?: t.TavilyExtractResult[];\n      }>(this.apiUrl, payload, {\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n        timeout: effectiveTimeout,\n      });\n\n      const data = response.data;\n      const successMap = new Map<string, t.TavilyExtractResult>();\n      const failedMap = new Map<string, t.TavilyExtractResult>();\n\n      for (const result of data.results ?? []) {\n        setUrlResult(successMap, result);\n      }\n      for (const result of data.failed_results ?? []) {\n        setUrlResult(failedMap, result);\n      }\n\n      return urls.map((url): [string, t.TavilyScrapeResponse] => {\n        const success =\n          successMap.get(url) ?? successMap.get(normalizeUrlKey(url));\n        if (success && success.error == null) {\n          return [\n            url,\n            {\n              success: true,\n              data: {\n                rawContent: success.raw_content ?? '',\n                images: success.images ?? [],\n                favicon: success.favicon,\n              },\n            },\n          ];\n        }\n\n        const failed =\n          failedMap.get(url) ?? failedMap.get(normalizeUrlKey(url));\n        const error =\n          success?.error ??\n          failed?.error ??\n          'URL not found in Tavily Extract response';\n        return [url, { success: false, error }];\n      });\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      return urls.map((url) => [\n        url,\n        {\n          success: false,\n          error: `Tavily Extract API request failed: ${errorMessage}`,\n        },\n      ]);\n    }\n  }\n\n  extractContent(\n    response: t.TavilyScrapeResponse\n  ): [string, undefined | t.References] {\n    if (!response.success || !response.data) {\n      return ['', undefined];\n    }\n\n    const content = response.data.rawContent ?? '';\n    const images = response.data.images ?? [];\n\n    const references: t.References | undefined =\n      images.length > 0\n        ? {\n            links: [],\n            images: images.map((imageUrl) => ({ originalUrl: imageUrl })),\n            videos: [],\n          }\n        : undefined;\n\n    return [content, references];\n  }\n\n  extractMetadata(response: t.TavilyScrapeResponse): t.GenericScrapeMetadata {\n    if (!response.success || !response.data) {\n      return {};\n    }\n\n    const metadata: t.GenericScrapeMetadata = {\n      images_count: response.data.images?.length ?? 0,\n    };\n    if (response.data.favicon != null) {\n      metadata.favicon = response.data.favicon;\n    }\n    return metadata;\n  }\n}\n\nexport const createTavilyScraper = (\n  config: t.TavilyScraperConfig = {}\n): TavilyScraper => {\n  return new TavilyScraper(config);\n};\n"],"names":[],"mappings":"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"}