@umituz/web-ai 1.0.5 → 1.0.7

package/dist/core/index.d.cts

@@ -1,4 +1,5 @@
-export { C as ChatMessage, F as FinishReason, G as GenerationResult, P as ProviderHealth, S as StreamCallbacks, a as StructuredGeneration, b as StructuredTextRequest, T as TextRequest, c as TextTier, d as TokenUsage } from '../index-fXjxTR5W.cjs';
+import { d as TokenUsage } from '../index-fXjxTR5W.cjs';
+export { C as ChatMessage, F as FinishReason, G as GenerationResult, P as ProviderHealth, S as StreamCallbacks, a as StructuredGeneration, b as StructuredTextRequest, T as TextRequest, c as TextTier } from '../index-fXjxTR5W.cjs';
 import { A as AIError, b as AIErrorType, a as AIErrorMetadata } from '../index-DKHNcMbl.cjs';
 export { T as TEXT_TIERS, c as TierModelMap, U as USER_FRIENDLY_ERROR_MESSAGES, i as isTextTier, m as mergeTierOverrides, r as resolveModel } from '../index-DKHNcMbl.cjs';
 import { b as RetryManager, c as RetryOptions, a as RequestQueue, R as RequestDeduplicator } from '../request-deduplicator.util-NDo0_n1y.cjs';
@@ -140,6 +141,27 @@ declare function asTrimmedOptionalString(value: unknown): string | undefined;
 declare function clampScore(value: unknown, min: number, max: number): number | null;
 declare function oneOfCatalog<T extends readonly string[]>(catalog: T, value: unknown): T[number] | null;
 
+declare const TRANSIENT_ERROR_CODES: ReadonlySet<string>;
+interface FailoverErrorLike {
+    readonly code?: string;
+    readonly type?: string;
+    readonly status?: number;
+}
+declare function isTransientError(err: unknown): boolean;
+declare function canFailover(err: unknown, streamedChars: number): boolean;
+interface ModelWithProvider {
+    readonly model: {
+        readonly id: string;
+        readonly capabilities?: {
+            readonly streaming?: boolean;
+        };
+    };
+    readonly provider: {
+        readonly id: string;
+    };
+}
+declare function failoverCandidate<T extends ModelWithProvider>(primary: T, fallback: T | null): T | null;
+
 declare function isSseDataLine(line: string): boolean;
 declare function extractSseDataPayload(line: string): string;
 declare function isSseDoneMarker(payload: string): boolean;
@@ -186,6 +208,101 @@ declare class StructuredPromptBuilder {
     build(): string;
 }
 
+declare const CHUNK_MAX_CHARS = 1200;
+declare const CHUNK_OVERLAP_CHARS = 160;
+declare const CHUNK_TEXT_LIMIT = 200000;
+interface ChunkOptions {
+    maxChars?: number;
+    overlapChars?: number;
+}
+declare function chunkText(text: string, options?: ChunkOptions): string[];
+
+interface AccessTimestamped {
+    readonly lastAccess: number;
+}
+declare function selectLeastRecentlyUsedKey<K, V extends AccessTimestamped>(entries: ReadonlyMap<K, V>): K | null;
+
+interface ExponentialBackoffParams {
+    readonly attempt: number;
+    readonly initialDelay: number;
+    readonly maxDelay: number;
+    readonly backoffMultiplier: number;
+    readonly jitterFactor: number;
+    readonly random?: () => number;
+}
+declare function calculateExponentialBackoff(params: ExponentialBackoffParams): number;
+
+declare function generateRandomBase36Suffix(length: number, random?: () => number): string;
+
+interface AccessCounted {
+    readonly accessCount: number;
+}
+declare function calculateCacheHitRate(entries: ReadonlyArray<AccessCounted>): number;
+
+interface LeadingEdgeParams {
+    readonly now: number;
+    readonly lastCallTime: number;
+    readonly interval: number;
+    readonly leadingEnabled: boolean;
+    readonly isThrottled: boolean;
+}
+declare function shouldCallOnLeadingEdge(params: LeadingEdgeParams): boolean;
+interface TrailingDelayParams {
+    readonly interval: number;
+    readonly timeSinceLastCall: number;
+}
+declare function calculateTrailingDelay(params: TrailingDelayParams): number;
+declare function isWithinWindow(now: number, lastCallTime: number, interval: number): boolean;
+
+declare const MICROS_PER_UNIT = 1000000;
+interface ModelPricing {
+    readonly inputPerMTok: number;
+    readonly outputPerMTok: number;
+    readonly currency: 'USD';
+}
+declare function computeCostMicros(pricing: ModelPricing, usage: Pick<TokenUsage, 'inputTokens' | 'outputTokens'>): number;
+interface UsageRecordInput {
+    readonly usage: TokenUsage & {
+        readonly reasoningTokens?: number;
+    };
+    readonly pricing: ModelPricing;
+    readonly durationMs: number;
+}
+interface UsageRecordData {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly reasoningTokens: number;
+    readonly costMicros: number;
+    readonly durationMs: number;
+}
+declare function buildUsageData(input: UsageRecordInput): UsageRecordData;
+declare function formatCost(costMicros: number): string;
+
+interface TaskPolicy {
+    readonly maxAttempts: number;
+    readonly backoffBaseMs: number;
+}
+declare const DEFAULT_TASK_POLICIES: Record<string, TaskPolicy>;
+declare function nextAttemptDelayMs(attempt: number, baseMs: number): number;
+interface TaskState {
+    readonly status: string;
+    readonly nextAttemptAt?: string | null;
+}
+declare function canStartTask(task: TaskState, now?: Date): boolean;
+interface TaskPlan {
+    readonly status: 'queued' | 'failed';
+    readonly nextAttemptAt: string | null;
+    readonly log: {
+        readonly at: string;
+        readonly level: 'info' | 'warn' | 'error';
+        readonly message: string;
+    };
+}
+declare function planTaskFailure(task: {
+    attempts: number;
+    maxAttempts: number;
+}, errorDetail: string, backoffBaseMs: number, now?: Date): TaskPlan;
+
 declare const SSE_BRIDGE_EVENTS: {
     readonly delta: "delta";
     readonly done: "done";
@@ -195,11 +312,102 @@ interface SseResponseOptions {
     readonly donePayload: unknown;
     readonly errorCode: (error: unknown) => string;
     readonly onStreamFailure?: (error: unknown) => Promise<void> | void;
-    /** Provider-specific: pulls the displayable text delta out of an SSE payload. */
-    readonly extractDelta: SseDeltaExtractor;
+    /** Provider-specific: pulls the displayable text delta out of an SSE payload. Defaults to standard choices[0].delta.content extractor. */
+    readonly extractDelta?: SseDeltaExtractor;
 }
+declare function defaultSseDeltaExtractor(payload: string): string | null;
 declare function createSseResponse(openUpstream: () => Promise<ReadableStream<Uint8Array>>, options: SseResponseOptions): Response;
 
+interface WireToolCallDelta {
+    readonly index?: number;
+    readonly id?: string;
+    readonly function?: {
+        readonly name?: string;
+        readonly arguments?: string;
+    };
+}
+interface AssistantToolCall {
+    readonly id: string;
+    readonly name: string;
+    readonly arguments: string;
+}
+declare class ToolCallAccumulator {
+    private readonly slots;
+    push(delta: WireToolCallDelta): void;
+    finish(): AssistantToolCall[];
+}
+
+type ContextRole = 'system' | 'user' | 'assistant' | 'tool';
+interface ContextMessage {
+    readonly role: ContextRole;
+    readonly content: string;
+    readonly toolCalls?: ReadonlyArray<{
+        id: string;
+        name: string;
+        arguments: string;
+    }>;
+    readonly toolCallId?: string;
+}
+interface ContextBudget {
+    readonly contextWindow: number;
+    readonly maxOutputTokens: number;
+}
+declare function estimateTokens(text: string): number;
+declare function estimateMessageTokens(message: ContextMessage): number;
+declare function buildContext<T extends ContextMessage = ContextMessage>(history: ReadonlyArray<T>, systemPrompt: string, budget: ContextBudget): T[];
+
+declare const SYSTEM_PROMPT_VERSION = 2;
+declare const DEFAULT_AI_IDENTITY: string;
+interface ProjectContext {
+    name: string;
+    instructions: string;
+}
+interface AgentContext {
+    name: string;
+    instructions: string;
+}
+interface SystemPromptInput {
+    identity?: string;
+    settings?: {
+        systemExtra?: string;
+    };
+    project?: ProjectContext | null;
+    agent?: AgentContext | null;
+    attachments?: readonly {
+        name: string;
+        text: string;
+    }[];
+    memories?: readonly string[];
+    now?: Date;
+}
+declare function buildSystemPrompt(input?: SystemPromptInput): string;
+
+type SearchTopic = 'general' | 'news';
+interface WebSearchResult {
+    readonly title: string;
+    readonly url: string;
+    readonly content: string;
+    readonly score: number | null;
+}
+interface WebSearchResponse {
+    readonly query: string;
+    readonly answer: string | null;
+    readonly results: ReadonlyArray<WebSearchResult>;
+    readonly responseTime: number | null;
+}
+interface WebSearchInput {
+    readonly query: string;
+    readonly maxResults?: number;
+    readonly topic?: SearchTopic;
+    readonly includeAnswer?: boolean;
+}
+type FetchLike = (input: string, init: Record<string, unknown>) => Promise<Response>;
+declare const SEARCH_MAX_RESULTS = 5;
+declare function searchWeb(env: {
+    readonly TAVILY_API_KEY?: string;
+    readonly TAVILY_BASE_URL?: string;
+}, input: WebSearchInput, fetchImpl?: FetchLike): Promise<WebSearchResponse>;
+
 declare const SSE_PREFIX: "data: ";
 declare const SSE_DONE_MARKER: "[DONE]";
 declare const JSON_CODE_BLOCK_PATTERN: RegExp;
@@ -211,4 +419,4 @@ declare const DEFAULT_RETRY_MAX_DELAY_MS = 10000;
 declare const DEFAULT_RETRY_BACKOFF_MULTIPLIER = 2;
 declare const DEFAULT_RETRY_JITTER_FACTOR = 0.1;
 
-export { AIError, type AIErrorBody, AIErrorMetadata, AIErrorType, type ApiKeyValidationRule, CompositeExecutor, DEFAULT_API_KEY_RULE, DEFAULT_ERROR_CLASSIFICATION_RULE, DEFAULT_HTTP_STATUS_RULE, DEFAULT_RETRY_BACKOFF_MULTIPLIER, DEFAULT_RETRY_INITIAL_DELAY_MS, DEFAULT_RETRY_JITTER_FACTOR, DEFAULT_RETRY_MAX_ATTEMPTS, DEFAULT_RETRY_MAX_DELAY_MS, DebounceManager, type DebounceOptions, DedupeExecutor, type DedupeExecutorOptions, type ErrorClassificationRule, GroqError, type GroqErrorMetadata, AIErrorType as GroqErrorType, type HttpStatusClassificationRule, type IRequestExecutor, JSON_CODE_BLOCK_PATTERN, JSON_OBJECT_PATTERN, JsonResponseParser, type LoggedError, type NormalizedSseChunk, QueueExecutor, RequestDeduplicator, RequestQueue, RetryExecutor, RetryManager, RetryOptions, SSE_BRIDGE_EVENTS, SSE_DONE_MARKER, SSE_PREFIX, type SseDeltaExtractor, type SseResponseOptions, type StreamingParserCallbacks, StreamingResponseParser, StructuredPromptBuilder, ThrottleManager, type ThrottleOptions, asObjectArray, asRecord, asStringArray, asTrimmedOptionalString, buildCacheKey, buildHttpStatusFallback, clampScore, classifyHttpStatus, createSseResponse, debounce, debounceManager, describeAIErrorType, extractErrorMessageFromJsonBody, extractErrorMessageFromResponse, extractJsonArray, extractJsonCandidate, extractJsonFromCodeFence, extractJsonObject, extractSseDataPayload, formatErrorForLogging, isAuthErrorType, isRetryableErrorType, isSseDataLine, isSseDoneMarker, isValidApiKey, normalizeSseChunk, oneOfCatalog, repairCommonJsonDefects, resolveUserFriendlyErrorMessage, resolveUserFriendlyMessage, splitSseLines, throttle, throttleManager, validateApiKey };
+export { AIError, type AIErrorBody, AIErrorMetadata, AIErrorType, type AccessCounted, type AccessTimestamped, type AgentContext, type ApiKeyValidationRule, type AssistantToolCall, CHUNK_MAX_CHARS, CHUNK_OVERLAP_CHARS, CHUNK_TEXT_LIMIT, type ChunkOptions, CompositeExecutor, type ContextBudget, type ContextMessage, type ContextRole, DEFAULT_AI_IDENTITY, DEFAULT_API_KEY_RULE, DEFAULT_ERROR_CLASSIFICATION_RULE, DEFAULT_HTTP_STATUS_RULE, DEFAULT_RETRY_BACKOFF_MULTIPLIER, DEFAULT_RETRY_INITIAL_DELAY_MS, DEFAULT_RETRY_JITTER_FACTOR, DEFAULT_RETRY_MAX_ATTEMPTS, DEFAULT_RETRY_MAX_DELAY_MS, DEFAULT_TASK_POLICIES, DebounceManager, type DebounceOptions, DedupeExecutor, type DedupeExecutorOptions, type ErrorClassificationRule, type ExponentialBackoffParams, type FailoverErrorLike, type FetchLike, GroqError, type GroqErrorMetadata, AIErrorType as GroqErrorType, type HttpStatusClassificationRule, type IRequestExecutor, JSON_CODE_BLOCK_PATTERN, JSON_OBJECT_PATTERN, JsonResponseParser, type LeadingEdgeParams, type LoggedError, MICROS_PER_UNIT, type ModelPricing, type ModelWithProvider, type NormalizedSseChunk, type ProjectContext, QueueExecutor, RequestDeduplicator, RequestQueue, RetryExecutor, RetryManager, RetryOptions, SEARCH_MAX_RESULTS, SSE_BRIDGE_EVENTS, SSE_DONE_MARKER, SSE_PREFIX, SYSTEM_PROMPT_VERSION, type SearchTopic, type SseDeltaExtractor, type SseResponseOptions, type StreamingParserCallbacks, StreamingResponseParser, StructuredPromptBuilder, type SystemPromptInput, TRANSIENT_ERROR_CODES, type TaskPlan, type TaskPolicy, type TaskState, ThrottleManager, type ThrottleOptions, TokenUsage, ToolCallAccumulator, type TrailingDelayParams, type UsageRecordData, type UsageRecordInput, type WebSearchInput, type WebSearchResponse, type WebSearchResult, type WireToolCallDelta, asObjectArray, asRecord, asStringArray, asTrimmedOptionalString, buildCacheKey, buildContext, buildHttpStatusFallback, buildSystemPrompt, buildUsageData, calculateCacheHitRate, calculateExponentialBackoff, calculateTrailingDelay, canFailover, canStartTask, chunkText, clampScore, classifyHttpStatus, computeCostMicros, createSseResponse, debounce, debounceManager, defaultSseDeltaExtractor, describeAIErrorType, estimateMessageTokens, estimateTokens, extractErrorMessageFromJsonBody, extractErrorMessageFromResponse, extractJsonArray, extractJsonCandidate, extractJsonFromCodeFence, extractJsonObject, extractSseDataPayload, failoverCandidate, formatCost, formatErrorForLogging, generateRandomBase36Suffix, isAuthErrorType, isRetryableErrorType, isSseDataLine, isSseDoneMarker, isTransientError, isValidApiKey, isWithinWindow, nextAttemptDelayMs, normalizeSseChunk, oneOfCatalog, planTaskFailure, repairCommonJsonDefects, resolveUserFriendlyErrorMessage, resolveUserFriendlyMessage, searchWeb, selectLeastRecentlyUsedKey, shouldCallOnLeadingEdge, splitSseLines, throttle, throttleManager, validateApiKey };

package/dist/core/index.d.ts

@@ -1,4 +1,5 @@
-export { C as ChatMessage, F as FinishReason, G as GenerationResult, P as ProviderHealth, S as StreamCallbacks, a as StructuredGeneration, b as StructuredTextRequest, T as TextRequest, c as TextTier, d as TokenUsage } from '../index-fXjxTR5W.js';
+import { d as TokenUsage } from '../index-fXjxTR5W.js';
+export { C as ChatMessage, F as FinishReason, G as GenerationResult, P as ProviderHealth, S as StreamCallbacks, a as StructuredGeneration, b as StructuredTextRequest, T as TextRequest, c as TextTier } from '../index-fXjxTR5W.js';
 import { A as AIError, b as AIErrorType, a as AIErrorMetadata } from '../index-DIHz8_OJ.js';
 export { T as TEXT_TIERS, c as TierModelMap, U as USER_FRIENDLY_ERROR_MESSAGES, i as isTextTier, m as mergeTierOverrides, r as resolveModel } from '../index-DIHz8_OJ.js';
 import { b as RetryManager, c as RetryOptions, a as RequestQueue, R as RequestDeduplicator } from '../request-deduplicator.util-NDo0_n1y.js';
@@ -140,6 +141,27 @@ declare function asTrimmedOptionalString(value: unknown): string | undefined;
 declare function clampScore(value: unknown, min: number, max: number): number | null;
 declare function oneOfCatalog<T extends readonly string[]>(catalog: T, value: unknown): T[number] | null;
 
+declare const TRANSIENT_ERROR_CODES: ReadonlySet<string>;
+interface FailoverErrorLike {
+    readonly code?: string;
+    readonly type?: string;
+    readonly status?: number;
+}
+declare function isTransientError(err: unknown): boolean;
+declare function canFailover(err: unknown, streamedChars: number): boolean;
+interface ModelWithProvider {
+    readonly model: {
+        readonly id: string;
+        readonly capabilities?: {
+            readonly streaming?: boolean;
+        };
+    };
+    readonly provider: {
+        readonly id: string;
+    };
+}
+declare function failoverCandidate<T extends ModelWithProvider>(primary: T, fallback: T | null): T | null;
+
 declare function isSseDataLine(line: string): boolean;
 declare function extractSseDataPayload(line: string): string;
 declare function isSseDoneMarker(payload: string): boolean;
@@ -186,6 +208,101 @@ declare class StructuredPromptBuilder {
     build(): string;
 }
 
+declare const CHUNK_MAX_CHARS = 1200;
+declare const CHUNK_OVERLAP_CHARS = 160;
+declare const CHUNK_TEXT_LIMIT = 200000;
+interface ChunkOptions {
+    maxChars?: number;
+    overlapChars?: number;
+}
+declare function chunkText(text: string, options?: ChunkOptions): string[];
+
+interface AccessTimestamped {
+    readonly lastAccess: number;
+}
+declare function selectLeastRecentlyUsedKey<K, V extends AccessTimestamped>(entries: ReadonlyMap<K, V>): K | null;
+
+interface ExponentialBackoffParams {
+    readonly attempt: number;
+    readonly initialDelay: number;
+    readonly maxDelay: number;
+    readonly backoffMultiplier: number;
+    readonly jitterFactor: number;
+    readonly random?: () => number;
+}
+declare function calculateExponentialBackoff(params: ExponentialBackoffParams): number;
+
+declare function generateRandomBase36Suffix(length: number, random?: () => number): string;
+
+interface AccessCounted {
+    readonly accessCount: number;
+}
+declare function calculateCacheHitRate(entries: ReadonlyArray<AccessCounted>): number;
+
+interface LeadingEdgeParams {
+    readonly now: number;
+    readonly lastCallTime: number;
+    readonly interval: number;
+    readonly leadingEnabled: boolean;
+    readonly isThrottled: boolean;
+}
+declare function shouldCallOnLeadingEdge(params: LeadingEdgeParams): boolean;
+interface TrailingDelayParams {
+    readonly interval: number;
+    readonly timeSinceLastCall: number;
+}
+declare function calculateTrailingDelay(params: TrailingDelayParams): number;
+declare function isWithinWindow(now: number, lastCallTime: number, interval: number): boolean;
+
+declare const MICROS_PER_UNIT = 1000000;
+interface ModelPricing {
+    readonly inputPerMTok: number;
+    readonly outputPerMTok: number;
+    readonly currency: 'USD';
+}
+declare function computeCostMicros(pricing: ModelPricing, usage: Pick<TokenUsage, 'inputTokens' | 'outputTokens'>): number;
+interface UsageRecordInput {
+    readonly usage: TokenUsage & {
+        readonly reasoningTokens?: number;
+    };
+    readonly pricing: ModelPricing;
+    readonly durationMs: number;
+}
+interface UsageRecordData {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly reasoningTokens: number;
+    readonly costMicros: number;
+    readonly durationMs: number;
+}
+declare function buildUsageData(input: UsageRecordInput): UsageRecordData;
+declare function formatCost(costMicros: number): string;
+
+interface TaskPolicy {
+    readonly maxAttempts: number;
+    readonly backoffBaseMs: number;
+}
+declare const DEFAULT_TASK_POLICIES: Record<string, TaskPolicy>;
+declare function nextAttemptDelayMs(attempt: number, baseMs: number): number;
+interface TaskState {
+    readonly status: string;
+    readonly nextAttemptAt?: string | null;
+}
+declare function canStartTask(task: TaskState, now?: Date): boolean;
+interface TaskPlan {
+    readonly status: 'queued' | 'failed';
+    readonly nextAttemptAt: string | null;
+    readonly log: {
+        readonly at: string;
+        readonly level: 'info' | 'warn' | 'error';
+        readonly message: string;
+    };
+}
+declare function planTaskFailure(task: {
+    attempts: number;
+    maxAttempts: number;
+}, errorDetail: string, backoffBaseMs: number, now?: Date): TaskPlan;
+
 declare const SSE_BRIDGE_EVENTS: {
     readonly delta: "delta";
     readonly done: "done";
@@ -195,11 +312,102 @@ interface SseResponseOptions {
     readonly donePayload: unknown;
     readonly errorCode: (error: unknown) => string;
     readonly onStreamFailure?: (error: unknown) => Promise<void> | void;
-    /** Provider-specific: pulls the displayable text delta out of an SSE payload. */
-    readonly extractDelta: SseDeltaExtractor;
+    /** Provider-specific: pulls the displayable text delta out of an SSE payload. Defaults to standard choices[0].delta.content extractor. */
+    readonly extractDelta?: SseDeltaExtractor;
 }
+declare function defaultSseDeltaExtractor(payload: string): string | null;
 declare function createSseResponse(openUpstream: () => Promise<ReadableStream<Uint8Array>>, options: SseResponseOptions): Response;
 
+interface WireToolCallDelta {
+    readonly index?: number;
+    readonly id?: string;
+    readonly function?: {
+        readonly name?: string;
+        readonly arguments?: string;
+    };
+}
+interface AssistantToolCall {
+    readonly id: string;
+    readonly name: string;
+    readonly arguments: string;
+}
+declare class ToolCallAccumulator {
+    private readonly slots;
+    push(delta: WireToolCallDelta): void;
+    finish(): AssistantToolCall[];
+}
+
+type ContextRole = 'system' | 'user' | 'assistant' | 'tool';
+interface ContextMessage {
+    readonly role: ContextRole;
+    readonly content: string;
+    readonly toolCalls?: ReadonlyArray<{
+        id: string;
+        name: string;
+        arguments: string;
+    }>;
+    readonly toolCallId?: string;
+}
+interface ContextBudget {
+    readonly contextWindow: number;
+    readonly maxOutputTokens: number;
+}
+declare function estimateTokens(text: string): number;
+declare function estimateMessageTokens(message: ContextMessage): number;
+declare function buildContext<T extends ContextMessage = ContextMessage>(history: ReadonlyArray<T>, systemPrompt: string, budget: ContextBudget): T[];
+
+declare const SYSTEM_PROMPT_VERSION = 2;
+declare const DEFAULT_AI_IDENTITY: string;
+interface ProjectContext {
+    name: string;
+    instructions: string;
+}
+interface AgentContext {
+    name: string;
+    instructions: string;
+}
+interface SystemPromptInput {
+    identity?: string;
+    settings?: {
+        systemExtra?: string;
+    };
+    project?: ProjectContext | null;
+    agent?: AgentContext | null;
+    attachments?: readonly {
+        name: string;
+        text: string;
+    }[];
+    memories?: readonly string[];
+    now?: Date;
+}
+declare function buildSystemPrompt(input?: SystemPromptInput): string;
+
+type SearchTopic = 'general' | 'news';
+interface WebSearchResult {
+    readonly title: string;
+    readonly url: string;
+    readonly content: string;
+    readonly score: number | null;
+}
+interface WebSearchResponse {
+    readonly query: string;
+    readonly answer: string | null;
+    readonly results: ReadonlyArray<WebSearchResult>;
+    readonly responseTime: number | null;
+}
+interface WebSearchInput {
+    readonly query: string;
+    readonly maxResults?: number;
+    readonly topic?: SearchTopic;
+    readonly includeAnswer?: boolean;
+}
+type FetchLike = (input: string, init: Record<string, unknown>) => Promise<Response>;
+declare const SEARCH_MAX_RESULTS = 5;
+declare function searchWeb(env: {
+    readonly TAVILY_API_KEY?: string;
+    readonly TAVILY_BASE_URL?: string;
+}, input: WebSearchInput, fetchImpl?: FetchLike): Promise<WebSearchResponse>;
+
 declare const SSE_PREFIX: "data: ";
 declare const SSE_DONE_MARKER: "[DONE]";
 declare const JSON_CODE_BLOCK_PATTERN: RegExp;
@@ -211,4 +419,4 @@ declare const DEFAULT_RETRY_MAX_DELAY_MS = 10000;
 declare const DEFAULT_RETRY_BACKOFF_MULTIPLIER = 2;
 declare const DEFAULT_RETRY_JITTER_FACTOR = 0.1;
 
-export { AIError, type AIErrorBody, AIErrorMetadata, AIErrorType, type ApiKeyValidationRule, CompositeExecutor, DEFAULT_API_KEY_RULE, DEFAULT_ERROR_CLASSIFICATION_RULE, DEFAULT_HTTP_STATUS_RULE, DEFAULT_RETRY_BACKOFF_MULTIPLIER, DEFAULT_RETRY_INITIAL_DELAY_MS, DEFAULT_RETRY_JITTER_FACTOR, DEFAULT_RETRY_MAX_ATTEMPTS, DEFAULT_RETRY_MAX_DELAY_MS, DebounceManager, type DebounceOptions, DedupeExecutor, type DedupeExecutorOptions, type ErrorClassificationRule, GroqError, type GroqErrorMetadata, AIErrorType as GroqErrorType, type HttpStatusClassificationRule, type IRequestExecutor, JSON_CODE_BLOCK_PATTERN, JSON_OBJECT_PATTERN, JsonResponseParser, type LoggedError, type NormalizedSseChunk, QueueExecutor, RequestDeduplicator, RequestQueue, RetryExecutor, RetryManager, RetryOptions, SSE_BRIDGE_EVENTS, SSE_DONE_MARKER, SSE_PREFIX, type SseDeltaExtractor, type SseResponseOptions, type StreamingParserCallbacks, StreamingResponseParser, StructuredPromptBuilder, ThrottleManager, type ThrottleOptions, asObjectArray, asRecord, asStringArray, asTrimmedOptionalString, buildCacheKey, buildHttpStatusFallback, clampScore, classifyHttpStatus, createSseResponse, debounce, debounceManager, describeAIErrorType, extractErrorMessageFromJsonBody, extractErrorMessageFromResponse, extractJsonArray, extractJsonCandidate, extractJsonFromCodeFence, extractJsonObject, extractSseDataPayload, formatErrorForLogging, isAuthErrorType, isRetryableErrorType, isSseDataLine, isSseDoneMarker, isValidApiKey, normalizeSseChunk, oneOfCatalog, repairCommonJsonDefects, resolveUserFriendlyErrorMessage, resolveUserFriendlyMessage, splitSseLines, throttle, throttleManager, validateApiKey };
+export { AIError, type AIErrorBody, AIErrorMetadata, AIErrorType, type AccessCounted, type AccessTimestamped, type AgentContext, type ApiKeyValidationRule, type AssistantToolCall, CHUNK_MAX_CHARS, CHUNK_OVERLAP_CHARS, CHUNK_TEXT_LIMIT, type ChunkOptions, CompositeExecutor, type ContextBudget, type ContextMessage, type ContextRole, DEFAULT_AI_IDENTITY, DEFAULT_API_KEY_RULE, DEFAULT_ERROR_CLASSIFICATION_RULE, DEFAULT_HTTP_STATUS_RULE, DEFAULT_RETRY_BACKOFF_MULTIPLIER, DEFAULT_RETRY_INITIAL_DELAY_MS, DEFAULT_RETRY_JITTER_FACTOR, DEFAULT_RETRY_MAX_ATTEMPTS, DEFAULT_RETRY_MAX_DELAY_MS, DEFAULT_TASK_POLICIES, DebounceManager, type DebounceOptions, DedupeExecutor, type DedupeExecutorOptions, type ErrorClassificationRule, type ExponentialBackoffParams, type FailoverErrorLike, type FetchLike, GroqError, type GroqErrorMetadata, AIErrorType as GroqErrorType, type HttpStatusClassificationRule, type IRequestExecutor, JSON_CODE_BLOCK_PATTERN, JSON_OBJECT_PATTERN, JsonResponseParser, type LeadingEdgeParams, type LoggedError, MICROS_PER_UNIT, type ModelPricing, type ModelWithProvider, type NormalizedSseChunk, type ProjectContext, QueueExecutor, RequestDeduplicator, RequestQueue, RetryExecutor, RetryManager, RetryOptions, SEARCH_MAX_RESULTS, SSE_BRIDGE_EVENTS, SSE_DONE_MARKER, SSE_PREFIX, SYSTEM_PROMPT_VERSION, type SearchTopic, type SseDeltaExtractor, type SseResponseOptions, type StreamingParserCallbacks, StreamingResponseParser, StructuredPromptBuilder, type SystemPromptInput, TRANSIENT_ERROR_CODES, type TaskPlan, type TaskPolicy, type TaskState, ThrottleManager, type ThrottleOptions, TokenUsage, ToolCallAccumulator, type TrailingDelayParams, type UsageRecordData, type UsageRecordInput, type WebSearchInput, type WebSearchResponse, type WebSearchResult, type WireToolCallDelta, asObjectArray, asRecord, asStringArray, asTrimmedOptionalString, buildCacheKey, buildContext, buildHttpStatusFallback, buildSystemPrompt, buildUsageData, calculateCacheHitRate, calculateExponentialBackoff, calculateTrailingDelay, canFailover, canStartTask, chunkText, clampScore, classifyHttpStatus, computeCostMicros, createSseResponse, debounce, debounceManager, defaultSseDeltaExtractor, describeAIErrorType, estimateMessageTokens, estimateTokens, extractErrorMessageFromJsonBody, extractErrorMessageFromResponse, extractJsonArray, extractJsonCandidate, extractJsonFromCodeFence, extractJsonObject, extractSseDataPayload, failoverCandidate, formatCost, formatErrorForLogging, generateRandomBase36Suffix, isAuthErrorType, isRetryableErrorType, isSseDataLine, isSseDoneMarker, isTransientError, isValidApiKey, isWithinWindow, nextAttemptDelayMs, normalizeSseChunk, oneOfCatalog, planTaskFailure, repairCommonJsonDefects, resolveUserFriendlyErrorMessage, resolveUserFriendlyMessage, searchWeb, selectLeastRecentlyUsedKey, shouldCallOnLeadingEdge, splitSseLines, throttle, throttleManager, validateApiKey };