@umituz/web-ai 1.1.0 → 1.2.0

package/dist/core/index.d.cts

@@ -2,9 +2,10 @@ import { c as TokenUsage, C as ChatMessage } from '../index-OhvYUTXf.cjs';
 export { F as FinishReason, G as GenerationResult, P as ProviderHealth, S as StructuredGeneration, a as StructuredTextRequest, T as TextRequest, b as TextTier } from '../index-OhvYUTXf.cjs';
 import { A as AIError, b as AIErrorType, a as AIErrorMetadata } from '../index-Dv8gRzAu.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-Dv8gRzAu.cjs';
-import { b as RetryManager, c as RetryOptions, a as RequestQueue, R as RequestDeduplicator } from '../tool-call-accumulator-C7KhaXZA.cjs';
-export { A as AssistantToolCall, Q as QueueOptions, T as ToolCallAccumulator, W as WireToolCallDelta, r as requestDeduplicator, d as requestQueue, e as retryManager, w as withRetry } from '../tool-call-accumulator-C7KhaXZA.cjs';
+import { a as AiErrorCode, g as RetryManager, h as RetryOptions, f as RequestQueue, R as RequestDeduplicator } from '../context-manager-CuZz0vnC.cjs';
+export { A as AiError, b as AssistantToolCall, C as CODE_MESSAGES, c as ContextBudget, d as ContextMessage, e as ContextRole, P as ProviderErrorShape, Q as QueueOptions, S as STATUS_TO_CODE, T as ToolCallAccumulator, W as WireToolCallDelta, i as aiErrorMessage, j as buildContext, k as errorFromStatus, l as errorFromUnknown, m as estimateMessageTokens, n as estimateTokens, r as requestDeduplicator, o as requestQueue, p as retryManager, w as withRetry } from '../context-manager-CuZz0vnC.cjs';
 export { C as CacheManager, a as CacheOptions, b as CacheStats, c as cacheManager } from '../cache-manager-Df9LLYGA.cjs';
+export { P as ParsedSseEvent, R as RemoteChatClient, a as RemoteChatClientOptions, b as RemoteChatStreamBody, c as RemoteChatUrls, d as RemoteStreamHandle, S as StreamCallbacks, e as createRemoteChatClient, p as parseSseEvent, r as readSseResponse } from '../remote-chat-client-LrNlew4n.cjs';
 
 type GroqErrorMetadata = AIErrorMetadata;
 
@@ -55,21 +56,30 @@ declare function buildHttpStatusFallback(status: number, statusText: string): st
 declare function extractErrorMessageFromResponse(response: Response): Promise<string>;
 declare function describeAIErrorType(type: AIErrorType): string;
 
-type AiErrorCode = 'invalid_key' | 'missing_key' | 'rate_limited' | 'capacity' | 'timeout' | 'invalid_request' | 'model_unavailable' | 'upstream_error' | 'network' | 'cancelled';
-declare const STATUS_TO_CODE: Readonly<Record<number, AiErrorCode>>;
-declare const CODE_MESSAGES: Readonly<Record<AiErrorCode, string>>;
-declare class AiError extends Error {
-    readonly code: AiErrorCode;
-    constructor(code: AiErrorCode, message?: string);
-    get userMessage(): string;
-}
-declare function aiErrorMessage(code: AiErrorCode): string;
-interface ProviderErrorShape {
-    readonly type?: string;
-    readonly code?: string;
-}
-declare function errorFromStatus(status: number, detail?: string, provider?: ProviderErrorShape): AiError;
-declare function errorFromUnknown(err: unknown): AiError;
+/**
+ * HTTP status each AiErrorCode maps to when an AI failure is surfaced
+ * through a server route (hono/express-style `c.json(body, status)`).
+ *
+ * The map is intentionally `as const` so indexed access keeps the literal
+ * types — frameworks like hono type their status argument as a union of
+ * known literals, and a plain `Record<AiErrorCode, number>` would widen
+ * past it.
+ */
+declare const AI_ERROR_STATUS: {
+    readonly invalid_key: 502;
+    readonly missing_key: 503;
+    readonly rate_limited: 429;
+    readonly capacity: 503;
+    readonly timeout: 504;
+    readonly invalid_request: 400;
+    readonly model_unavailable: 503;
+    readonly upstream_error: 502;
+    readonly network: 502;
+    readonly cancelled: 400;
+};
+/** Status for a single code; kept as a function for call sites that only
+ *  have the code, not an AiError instance. */
+declare function aiErrorStatus(code: AiErrorCode): number;
 
 interface IRequestExecutor<TArgs extends unknown[], TResult> {
     execute(fn: (...args: TArgs) => Promise<TResult>, ...args: TArgs): Promise<TResult>;
@@ -340,25 +350,6 @@ interface SseResponseOptions {
 declare function defaultSseDeltaExtractor(payload: string): string | null;
 declare function createSseResponse(openUpstream: () => Promise<ReadableStream<Uint8Array>>, options: SseResponseOptions): Response;
 
-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 {
@@ -536,42 +527,6 @@ declare const GENERATION_BOUNDS: {
 declare const DEFAULT_GENERATION: Required<GenerationSettings>;
 declare function normalizeGenerationSettings(requested: GenerationSettings | undefined, maxModelTokens?: number): Required<GenerationSettings>;
 
-interface StreamCallbacks<TToolCall = unknown> {
-    onDelta(channel: 'answer' | 'reasoning', text: string): void;
-    onUsage?(usage: {
-        inputTokens: number;
-        outputTokens: number;
-        reasoningTokens?: number;
-    }): void;
-    onToolCall?(toolCall: TToolCall): void;
-    onDone?(messageId: string): void;
-    onError?(code: string, message: string): void;
-}
-type ParsedSseEvent<TToolCall = unknown> = {
-    readonly type: 'delta';
-    readonly channel: 'answer' | 'reasoning';
-    readonly text: string;
-} | {
-    readonly type: 'usage';
-    readonly usage: {
-        readonly inputTokens: number;
-        readonly outputTokens: number;
-        readonly reasoningTokens?: number;
-    };
-} | {
-    readonly type: 'tool_call';
-    readonly toolCall: TToolCall;
-} | {
-    readonly type: 'done';
-    readonly messageId: string;
-} | {
-    readonly type: 'error';
-    readonly code: string;
-    readonly message: string;
-};
-declare function parseSseEvent<TToolCall = unknown>(rawEvent: string): ParsedSseEvent<TToolCall> | null;
-declare function readSseResponse<TToolCall = unknown>(response: Response, callbacks: StreamCallbacks<TToolCall>): Promise<void>;
-
 type ToolValidationResult = {
     readonly ok: true;
 } | {
@@ -602,6 +557,69 @@ interface ZodLikeSchema {
 type ToolSchema = ToolValidatorFunction | ZodLikeSchema;
 declare function validateToolArgs(toolKey: string, args: Record<string, unknown>, schemas: Record<string, ToolSchema>): ToolValidationResult;
 
+/**
+ * Usage analytics over sparse day aggregates.
+ *
+ * Servers typically bucket usage rows per UTC day in SQL and hand back only
+ * the days that have data. These helpers turn those sparse rows into a
+ * zero-filled daily series and derive the window totals / trends / error
+ * rates a usage dashboard needs — pure functions, no persistence coupling.
+ */
+/** One point of a zero-filled daily series (UTC `YYYY-MM-DD` date keys). */
+interface UsageSeriesPoint {
+    readonly date: string;
+    readonly requests: number;
+    readonly attempts: number;
+    readonly errors: number;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly reasoningTokens: number;
+    readonly costMicros: number;
+}
+/** Sparse usage aggregate for a day, straight from SQL. Numbers may arrive
+ *  as strings depending on the driver (pg/bigint columns). */
+interface UsageSeriesDayRow {
+    readonly date: string;
+    readonly requests?: number | string | null;
+    readonly inputTokens?: number | string | null;
+    readonly outputTokens?: number | string | null;
+    readonly reasoningTokens?: number | string | null;
+    readonly costMicros?: number | string | null;
+}
+/** Sparse message-attempt aggregate for a day (attempts vs errors). */
+interface UsageSeriesMessageRow {
+    readonly date: string;
+    readonly attempts?: number | string | null;
+    readonly errors?: number | string | null;
+}
+interface UsageWindowTotals {
+    readonly requests: number;
+    readonly attempts: number;
+    readonly errors: number;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly costMicros: number;
+}
+interface UsageTrendPoint {
+    readonly current: number;
+    readonly previous: number;
+    /** Percentage change; null when the previous window was empty (avoid ±∞). */
+    readonly deltaPct: number | null;
+}
+/**
+ * Merge sparse SQL day aggregates into a zero-filled series covering the
+ * last `days` UTC days ending today. Both trend windows (current +
+ * previous) fit in the result when called with the doubled length.
+ */
+declare function buildUsageDailySeries(days: number, usageRows: readonly UsageSeriesDayRow[], messageRows: readonly UsageSeriesMessageRow[], today?: Date): UsageSeriesPoint[];
+/** Sum a contiguous slice of the daily series. `to` is exclusive; both may
+ *  be negative (Python-style windowing over the tail of the series). */
+declare function usageWindowTotals(series: readonly UsageSeriesPoint[], from: number, to: number): UsageWindowTotals;
+/** Percentage change between two windows; null when the previous window is empty. */
+declare function usageTrendOf(current: number, previous: number): UsageTrendPoint;
+/** Errors / attempts as a percentage (0–100); 0 when there were no attempts. */
+declare function errorRatePct(errors: number, attempts: number): number;
+
 declare const SSE_PREFIX: "data: ";
 declare const SSE_DONE_MARKER: "[DONE]";
 declare const JSON_CODE_BLOCK_PATTERN: RegExp;
@@ -613,4 +631,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 AccessCounted, type AccessTimestamped, type AgentContext, AiError, type AiErrorCode, type ApiKeyValidationRule, CHUNK_MAX_CHARS, CHUNK_OVERLAP_CHARS, CHUNK_TEXT_LIMIT, CODE_MESSAGES, ChatMessage, type ChunkOptions, CompositeExecutor, type ContextBudget, type ContextMessage, type ContextRole, DEFAULT_AI_IDENTITY, DEFAULT_API_KEY_RULE, DEFAULT_EMBED_BATCH_SIZE, DEFAULT_ERROR_CLASSIFICATION_RULE, DEFAULT_GENERATION, 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 DiffChangeCount, type DiffLine, type EmbeddingsBatchAdapter, type ErrorClassificationRule, type ExponentialBackoffParams, type FailoverErrorLike, type FetchLike, GENERATION_BOUNDS, type GenerationSettings, GroqError, type GroqErrorMetadata, AIErrorType as GroqErrorType, type HttpStatusClassificationRule, type IRequestExecutor, JSON_CODE_BLOCK_PATTERN, JSON_OBJECT_PATTERN, JsonResponseParser, type LeadingEdgeParams, type LoggedError, MEMORY_MAX_ITEMS, MEMORY_TOTAL_LIMIT, MICROS_PER_UNIT, type MarkdownSegment, type MemoryLike, type ModelPricing, type ModelWithProvider, type NormalizedSseChunk, type ParsedSseEvent, type ProjectContext, type ProviderErrorShape, QueueExecutor, RESEARCH_MAX_OUTPUT_TOKENS, RESEARCH_QUERY_MAX, RESEARCH_QUERY_MIN, RESEARCH_REPORT_MIN_CHARS, RESEARCH_SNIPPET_MAX_CHARS, RESEARCH_TEMPERATURE, RequestDeduplicator, RequestQueue, type ResearchSource, type ResearchStreamEvent, RetryExecutor, RetryManager, RetryOptions, SEARCH_MAX_RESULTS, SSE_BRIDGE_EVENTS, SSE_DONE_MARKER, SSE_PREFIX, STATUS_TO_CODE, SYSTEM_PROMPT_VERSION, type SearchTopic, type SseDeltaExtractor, type SseResponseOptions, type StreamCallbacks, type StreamEvent, type StreamingParserCallbacks, StreamingResponseParser, StructuredPromptBuilder, type SystemPromptInput, TEXT_EXTRACT_PER_FILE_LIMIT, TEXT_EXTRACT_TOTAL_LIMIT, TRANSIENT_ERROR_CODES, type TaskPlan, type TaskPolicy, type TaskState, ThrottleManager, type ThrottleOptions, TokenUsage, type ToolSchema, type ToolValidationResult, type ToolValidatorFunction, type TrailingDelayParams, type UsageRecordData, type UsageRecordInput, type VectorCandidate, type VectorMatch, type WebSearchInput, type WebSearchResponse, type WebSearchResult, type ZodLikeIssue, type ZodLikeSchema, accumulateReport, aiErrorMessage, asObjectArray, asRecord, asStringArray, asTrimmedOptionalString, batchEmbed, buildCacheKey, buildContext, buildHttpStatusFallback, buildResearchMessages, buildSystemPrompt, buildUsageData, calculateCacheHitRate, calculateExponentialBackoff, calculateTrailingDelay, canFailover, canStartTask, capText, chunkText, clampScore, classifyHttpStatus, computeCostMicros, cosineSimilarity, countChanges, createSseResponse, debounce, debounceManager, defaultSseDeltaExtractor, deriveSnippetTitle, describeAIErrorType, diffLines, dotProduct, errorFromStatus, errorFromUnknown, estimateMessageTokens, estimateTokens, extractErrorMessageFromJsonBody, extractErrorMessageFromResponse, extractJsonArray, extractJsonCandidate, extractJsonFromCodeFence, extractJsonObject, extractSseDataPayload, extractText, failoverCandidate, findTopKSimilar, formatCost, formatErrorForLogging, formatSseEvent, generateRandomBase36Suffix, isAuthErrorType, isRetryableErrorType, isSseDataLine, isSseDoneMarker, isTextLike, isTransientError, isValidApiKey, isWithinWindow, magnitude, nextAttemptDelayMs, normalizeGenerationSettings, normalizeSources, normalizeSseChunk, oneOfCatalog, parseSseEvent, planTaskFailure, readSseResponse, repairCommonJsonDefects, replayFirst, resolveUserFriendlyErrorMessage, resolveUserFriendlyMessage, searchWeb, selectLeastRecentlyUsedKey, selectMemories, shouldCallOnLeadingEdge, splitMarkdown, splitSseLines, sseStreamResponse, throttle, throttleManager, validateApiKey, validateToolArgs };
+export { AIError, type AIErrorBody, AIErrorMetadata, AIErrorType, AI_ERROR_STATUS, type AccessCounted, type AccessTimestamped, type AgentContext, AiErrorCode, type ApiKeyValidationRule, CHUNK_MAX_CHARS, CHUNK_OVERLAP_CHARS, CHUNK_TEXT_LIMIT, ChatMessage, type ChunkOptions, CompositeExecutor, DEFAULT_AI_IDENTITY, DEFAULT_API_KEY_RULE, DEFAULT_EMBED_BATCH_SIZE, DEFAULT_ERROR_CLASSIFICATION_RULE, DEFAULT_GENERATION, 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 DiffChangeCount, type DiffLine, type EmbeddingsBatchAdapter, type ErrorClassificationRule, type ExponentialBackoffParams, type FailoverErrorLike, type FetchLike, GENERATION_BOUNDS, type GenerationSettings, GroqError, type GroqErrorMetadata, AIErrorType as GroqErrorType, type HttpStatusClassificationRule, type IRequestExecutor, JSON_CODE_BLOCK_PATTERN, JSON_OBJECT_PATTERN, JsonResponseParser, type LeadingEdgeParams, type LoggedError, MEMORY_MAX_ITEMS, MEMORY_TOTAL_LIMIT, MICROS_PER_UNIT, type MarkdownSegment, type MemoryLike, type ModelPricing, type ModelWithProvider, type NormalizedSseChunk, type ProjectContext, QueueExecutor, RESEARCH_MAX_OUTPUT_TOKENS, RESEARCH_QUERY_MAX, RESEARCH_QUERY_MIN, RESEARCH_REPORT_MIN_CHARS, RESEARCH_SNIPPET_MAX_CHARS, RESEARCH_TEMPERATURE, RequestDeduplicator, RequestQueue, type ResearchSource, type ResearchStreamEvent, RetryExecutor, RetryManager, RetryOptions, SEARCH_MAX_RESULTS, SSE_BRIDGE_EVENTS, SSE_DONE_MARKER, SSE_PREFIX, SYSTEM_PROMPT_VERSION, type SearchTopic, type SseDeltaExtractor, type SseResponseOptions, type StreamEvent, type StreamingParserCallbacks, StreamingResponseParser, StructuredPromptBuilder, type SystemPromptInput, TEXT_EXTRACT_PER_FILE_LIMIT, TEXT_EXTRACT_TOTAL_LIMIT, TRANSIENT_ERROR_CODES, type TaskPlan, type TaskPolicy, type TaskState, ThrottleManager, type ThrottleOptions, TokenUsage, type ToolSchema, type ToolValidationResult, type ToolValidatorFunction, type TrailingDelayParams, type UsageRecordData, type UsageRecordInput, type UsageSeriesDayRow, type UsageSeriesMessageRow, type UsageSeriesPoint, type UsageTrendPoint, type UsageWindowTotals, type VectorCandidate, type VectorMatch, type WebSearchInput, type WebSearchResponse, type WebSearchResult, type ZodLikeIssue, type ZodLikeSchema, accumulateReport, aiErrorStatus, asObjectArray, asRecord, asStringArray, asTrimmedOptionalString, batchEmbed, buildCacheKey, buildHttpStatusFallback, buildResearchMessages, buildSystemPrompt, buildUsageDailySeries, buildUsageData, calculateCacheHitRate, calculateExponentialBackoff, calculateTrailingDelay, canFailover, canStartTask, capText, chunkText, clampScore, classifyHttpStatus, computeCostMicros, cosineSimilarity, countChanges, createSseResponse, debounce, debounceManager, defaultSseDeltaExtractor, deriveSnippetTitle, describeAIErrorType, diffLines, dotProduct, errorRatePct, extractErrorMessageFromJsonBody, extractErrorMessageFromResponse, extractJsonArray, extractJsonCandidate, extractJsonFromCodeFence, extractJsonObject, extractSseDataPayload, extractText, failoverCandidate, findTopKSimilar, formatCost, formatErrorForLogging, formatSseEvent, generateRandomBase36Suffix, isAuthErrorType, isRetryableErrorType, isSseDataLine, isSseDoneMarker, isTextLike, isTransientError, isValidApiKey, isWithinWindow, magnitude, nextAttemptDelayMs, normalizeGenerationSettings, normalizeSources, normalizeSseChunk, oneOfCatalog, planTaskFailure, repairCommonJsonDefects, replayFirst, resolveUserFriendlyErrorMessage, resolveUserFriendlyMessage, searchWeb, selectLeastRecentlyUsedKey, selectMemories, shouldCallOnLeadingEdge, splitMarkdown, splitSseLines, sseStreamResponse, throttle, throttleManager, usageTrendOf, usageWindowTotals, validateApiKey, validateToolArgs };

package/dist/core/index.d.ts

@@ -2,9 +2,10 @@ import { c as TokenUsage, C as ChatMessage } from '../index-OhvYUTXf.js';
 export { F as FinishReason, G as GenerationResult, P as ProviderHealth, S as StructuredGeneration, a as StructuredTextRequest, T as TextRequest, b as TextTier } from '../index-OhvYUTXf.js';
 import { A as AIError, b as AIErrorType, a as AIErrorMetadata } from '../index-1e91KRYU.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-1e91KRYU.js';
-import { b as RetryManager, c as RetryOptions, a as RequestQueue, R as RequestDeduplicator } from '../tool-call-accumulator-C7KhaXZA.js';
-export { A as AssistantToolCall, Q as QueueOptions, T as ToolCallAccumulator, W as WireToolCallDelta, r as requestDeduplicator, d as requestQueue, e as retryManager, w as withRetry } from '../tool-call-accumulator-C7KhaXZA.js';
+import { a as AiErrorCode, g as RetryManager, h as RetryOptions, f as RequestQueue, R as RequestDeduplicator } from '../context-manager-CuZz0vnC.js';
+export { A as AiError, b as AssistantToolCall, C as CODE_MESSAGES, c as ContextBudget, d as ContextMessage, e as ContextRole, P as ProviderErrorShape, Q as QueueOptions, S as STATUS_TO_CODE, T as ToolCallAccumulator, W as WireToolCallDelta, i as aiErrorMessage, j as buildContext, k as errorFromStatus, l as errorFromUnknown, m as estimateMessageTokens, n as estimateTokens, r as requestDeduplicator, o as requestQueue, p as retryManager, w as withRetry } from '../context-manager-CuZz0vnC.js';
 export { C as CacheManager, a as CacheOptions, b as CacheStats, c as cacheManager } from '../cache-manager-Df9LLYGA.js';
+export { P as ParsedSseEvent, R as RemoteChatClient, a as RemoteChatClientOptions, b as RemoteChatStreamBody, c as RemoteChatUrls, d as RemoteStreamHandle, S as StreamCallbacks, e as createRemoteChatClient, p as parseSseEvent, r as readSseResponse } from '../remote-chat-client-LrNlew4n.js';
 
 type GroqErrorMetadata = AIErrorMetadata;
 
@@ -55,21 +56,30 @@ declare function buildHttpStatusFallback(status: number, statusText: string): st
 declare function extractErrorMessageFromResponse(response: Response): Promise<string>;
 declare function describeAIErrorType(type: AIErrorType): string;
 
-type AiErrorCode = 'invalid_key' | 'missing_key' | 'rate_limited' | 'capacity' | 'timeout' | 'invalid_request' | 'model_unavailable' | 'upstream_error' | 'network' | 'cancelled';
-declare const STATUS_TO_CODE: Readonly<Record<number, AiErrorCode>>;
-declare const CODE_MESSAGES: Readonly<Record<AiErrorCode, string>>;
-declare class AiError extends Error {
-    readonly code: AiErrorCode;
-    constructor(code: AiErrorCode, message?: string);
-    get userMessage(): string;
-}
-declare function aiErrorMessage(code: AiErrorCode): string;
-interface ProviderErrorShape {
-    readonly type?: string;
-    readonly code?: string;
-}
-declare function errorFromStatus(status: number, detail?: string, provider?: ProviderErrorShape): AiError;
-declare function errorFromUnknown(err: unknown): AiError;
+/**
+ * HTTP status each AiErrorCode maps to when an AI failure is surfaced
+ * through a server route (hono/express-style `c.json(body, status)`).
+ *
+ * The map is intentionally `as const` so indexed access keeps the literal
+ * types — frameworks like hono type their status argument as a union of
+ * known literals, and a plain `Record<AiErrorCode, number>` would widen
+ * past it.
+ */
+declare const AI_ERROR_STATUS: {
+    readonly invalid_key: 502;
+    readonly missing_key: 503;
+    readonly rate_limited: 429;
+    readonly capacity: 503;
+    readonly timeout: 504;
+    readonly invalid_request: 400;
+    readonly model_unavailable: 503;
+    readonly upstream_error: 502;
+    readonly network: 502;
+    readonly cancelled: 400;
+};
+/** Status for a single code; kept as a function for call sites that only
+ *  have the code, not an AiError instance. */
+declare function aiErrorStatus(code: AiErrorCode): number;
 
 interface IRequestExecutor<TArgs extends unknown[], TResult> {
     execute(fn: (...args: TArgs) => Promise<TResult>, ...args: TArgs): Promise<TResult>;
@@ -340,25 +350,6 @@ interface SseResponseOptions {
 declare function defaultSseDeltaExtractor(payload: string): string | null;
 declare function createSseResponse(openUpstream: () => Promise<ReadableStream<Uint8Array>>, options: SseResponseOptions): Response;
 
-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 {
@@ -536,42 +527,6 @@ declare const GENERATION_BOUNDS: {
 declare const DEFAULT_GENERATION: Required<GenerationSettings>;
 declare function normalizeGenerationSettings(requested: GenerationSettings | undefined, maxModelTokens?: number): Required<GenerationSettings>;
 
-interface StreamCallbacks<TToolCall = unknown> {
-    onDelta(channel: 'answer' | 'reasoning', text: string): void;
-    onUsage?(usage: {
-        inputTokens: number;
-        outputTokens: number;
-        reasoningTokens?: number;
-    }): void;
-    onToolCall?(toolCall: TToolCall): void;
-    onDone?(messageId: string): void;
-    onError?(code: string, message: string): void;
-}
-type ParsedSseEvent<TToolCall = unknown> = {
-    readonly type: 'delta';
-    readonly channel: 'answer' | 'reasoning';
-    readonly text: string;
-} | {
-    readonly type: 'usage';
-    readonly usage: {
-        readonly inputTokens: number;
-        readonly outputTokens: number;
-        readonly reasoningTokens?: number;
-    };
-} | {
-    readonly type: 'tool_call';
-    readonly toolCall: TToolCall;
-} | {
-    readonly type: 'done';
-    readonly messageId: string;
-} | {
-    readonly type: 'error';
-    readonly code: string;
-    readonly message: string;
-};
-declare function parseSseEvent<TToolCall = unknown>(rawEvent: string): ParsedSseEvent<TToolCall> | null;
-declare function readSseResponse<TToolCall = unknown>(response: Response, callbacks: StreamCallbacks<TToolCall>): Promise<void>;
-
 type ToolValidationResult = {
     readonly ok: true;
 } | {
@@ -602,6 +557,69 @@ interface ZodLikeSchema {
 type ToolSchema = ToolValidatorFunction | ZodLikeSchema;
 declare function validateToolArgs(toolKey: string, args: Record<string, unknown>, schemas: Record<string, ToolSchema>): ToolValidationResult;
 
+/**
+ * Usage analytics over sparse day aggregates.
+ *
+ * Servers typically bucket usage rows per UTC day in SQL and hand back only
+ * the days that have data. These helpers turn those sparse rows into a
+ * zero-filled daily series and derive the window totals / trends / error
+ * rates a usage dashboard needs — pure functions, no persistence coupling.
+ */
+/** One point of a zero-filled daily series (UTC `YYYY-MM-DD` date keys). */
+interface UsageSeriesPoint {
+    readonly date: string;
+    readonly requests: number;
+    readonly attempts: number;
+    readonly errors: number;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly reasoningTokens: number;
+    readonly costMicros: number;
+}
+/** Sparse usage aggregate for a day, straight from SQL. Numbers may arrive
+ *  as strings depending on the driver (pg/bigint columns). */
+interface UsageSeriesDayRow {
+    readonly date: string;
+    readonly requests?: number | string | null;
+    readonly inputTokens?: number | string | null;
+    readonly outputTokens?: number | string | null;
+    readonly reasoningTokens?: number | string | null;
+    readonly costMicros?: number | string | null;
+}
+/** Sparse message-attempt aggregate for a day (attempts vs errors). */
+interface UsageSeriesMessageRow {
+    readonly date: string;
+    readonly attempts?: number | string | null;
+    readonly errors?: number | string | null;
+}
+interface UsageWindowTotals {
+    readonly requests: number;
+    readonly attempts: number;
+    readonly errors: number;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly costMicros: number;
+}
+interface UsageTrendPoint {
+    readonly current: number;
+    readonly previous: number;
+    /** Percentage change; null when the previous window was empty (avoid ±∞). */
+    readonly deltaPct: number | null;
+}
+/**
+ * Merge sparse SQL day aggregates into a zero-filled series covering the
+ * last `days` UTC days ending today. Both trend windows (current +
+ * previous) fit in the result when called with the doubled length.
+ */
+declare function buildUsageDailySeries(days: number, usageRows: readonly UsageSeriesDayRow[], messageRows: readonly UsageSeriesMessageRow[], today?: Date): UsageSeriesPoint[];
+/** Sum a contiguous slice of the daily series. `to` is exclusive; both may
+ *  be negative (Python-style windowing over the tail of the series). */
+declare function usageWindowTotals(series: readonly UsageSeriesPoint[], from: number, to: number): UsageWindowTotals;
+/** Percentage change between two windows; null when the previous window is empty. */
+declare function usageTrendOf(current: number, previous: number): UsageTrendPoint;
+/** Errors / attempts as a percentage (0–100); 0 when there were no attempts. */
+declare function errorRatePct(errors: number, attempts: number): number;
+
 declare const SSE_PREFIX: "data: ";
 declare const SSE_DONE_MARKER: "[DONE]";
 declare const JSON_CODE_BLOCK_PATTERN: RegExp;
@@ -613,4 +631,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 AccessCounted, type AccessTimestamped, type AgentContext, AiError, type AiErrorCode, type ApiKeyValidationRule, CHUNK_MAX_CHARS, CHUNK_OVERLAP_CHARS, CHUNK_TEXT_LIMIT, CODE_MESSAGES, ChatMessage, type ChunkOptions, CompositeExecutor, type ContextBudget, type ContextMessage, type ContextRole, DEFAULT_AI_IDENTITY, DEFAULT_API_KEY_RULE, DEFAULT_EMBED_BATCH_SIZE, DEFAULT_ERROR_CLASSIFICATION_RULE, DEFAULT_GENERATION, 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 DiffChangeCount, type DiffLine, type EmbeddingsBatchAdapter, type ErrorClassificationRule, type ExponentialBackoffParams, type FailoverErrorLike, type FetchLike, GENERATION_BOUNDS, type GenerationSettings, GroqError, type GroqErrorMetadata, AIErrorType as GroqErrorType, type HttpStatusClassificationRule, type IRequestExecutor, JSON_CODE_BLOCK_PATTERN, JSON_OBJECT_PATTERN, JsonResponseParser, type LeadingEdgeParams, type LoggedError, MEMORY_MAX_ITEMS, MEMORY_TOTAL_LIMIT, MICROS_PER_UNIT, type MarkdownSegment, type MemoryLike, type ModelPricing, type ModelWithProvider, type NormalizedSseChunk, type ParsedSseEvent, type ProjectContext, type ProviderErrorShape, QueueExecutor, RESEARCH_MAX_OUTPUT_TOKENS, RESEARCH_QUERY_MAX, RESEARCH_QUERY_MIN, RESEARCH_REPORT_MIN_CHARS, RESEARCH_SNIPPET_MAX_CHARS, RESEARCH_TEMPERATURE, RequestDeduplicator, RequestQueue, type ResearchSource, type ResearchStreamEvent, RetryExecutor, RetryManager, RetryOptions, SEARCH_MAX_RESULTS, SSE_BRIDGE_EVENTS, SSE_DONE_MARKER, SSE_PREFIX, STATUS_TO_CODE, SYSTEM_PROMPT_VERSION, type SearchTopic, type SseDeltaExtractor, type SseResponseOptions, type StreamCallbacks, type StreamEvent, type StreamingParserCallbacks, StreamingResponseParser, StructuredPromptBuilder, type SystemPromptInput, TEXT_EXTRACT_PER_FILE_LIMIT, TEXT_EXTRACT_TOTAL_LIMIT, TRANSIENT_ERROR_CODES, type TaskPlan, type TaskPolicy, type TaskState, ThrottleManager, type ThrottleOptions, TokenUsage, type ToolSchema, type ToolValidationResult, type ToolValidatorFunction, type TrailingDelayParams, type UsageRecordData, type UsageRecordInput, type VectorCandidate, type VectorMatch, type WebSearchInput, type WebSearchResponse, type WebSearchResult, type ZodLikeIssue, type ZodLikeSchema, accumulateReport, aiErrorMessage, asObjectArray, asRecord, asStringArray, asTrimmedOptionalString, batchEmbed, buildCacheKey, buildContext, buildHttpStatusFallback, buildResearchMessages, buildSystemPrompt, buildUsageData, calculateCacheHitRate, calculateExponentialBackoff, calculateTrailingDelay, canFailover, canStartTask, capText, chunkText, clampScore, classifyHttpStatus, computeCostMicros, cosineSimilarity, countChanges, createSseResponse, debounce, debounceManager, defaultSseDeltaExtractor, deriveSnippetTitle, describeAIErrorType, diffLines, dotProduct, errorFromStatus, errorFromUnknown, estimateMessageTokens, estimateTokens, extractErrorMessageFromJsonBody, extractErrorMessageFromResponse, extractJsonArray, extractJsonCandidate, extractJsonFromCodeFence, extractJsonObject, extractSseDataPayload, extractText, failoverCandidate, findTopKSimilar, formatCost, formatErrorForLogging, formatSseEvent, generateRandomBase36Suffix, isAuthErrorType, isRetryableErrorType, isSseDataLine, isSseDoneMarker, isTextLike, isTransientError, isValidApiKey, isWithinWindow, magnitude, nextAttemptDelayMs, normalizeGenerationSettings, normalizeSources, normalizeSseChunk, oneOfCatalog, parseSseEvent, planTaskFailure, readSseResponse, repairCommonJsonDefects, replayFirst, resolveUserFriendlyErrorMessage, resolveUserFriendlyMessage, searchWeb, selectLeastRecentlyUsedKey, selectMemories, shouldCallOnLeadingEdge, splitMarkdown, splitSseLines, sseStreamResponse, throttle, throttleManager, validateApiKey, validateToolArgs };
+export { AIError, type AIErrorBody, AIErrorMetadata, AIErrorType, AI_ERROR_STATUS, type AccessCounted, type AccessTimestamped, type AgentContext, AiErrorCode, type ApiKeyValidationRule, CHUNK_MAX_CHARS, CHUNK_OVERLAP_CHARS, CHUNK_TEXT_LIMIT, ChatMessage, type ChunkOptions, CompositeExecutor, DEFAULT_AI_IDENTITY, DEFAULT_API_KEY_RULE, DEFAULT_EMBED_BATCH_SIZE, DEFAULT_ERROR_CLASSIFICATION_RULE, DEFAULT_GENERATION, 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 DiffChangeCount, type DiffLine, type EmbeddingsBatchAdapter, type ErrorClassificationRule, type ExponentialBackoffParams, type FailoverErrorLike, type FetchLike, GENERATION_BOUNDS, type GenerationSettings, GroqError, type GroqErrorMetadata, AIErrorType as GroqErrorType, type HttpStatusClassificationRule, type IRequestExecutor, JSON_CODE_BLOCK_PATTERN, JSON_OBJECT_PATTERN, JsonResponseParser, type LeadingEdgeParams, type LoggedError, MEMORY_MAX_ITEMS, MEMORY_TOTAL_LIMIT, MICROS_PER_UNIT, type MarkdownSegment, type MemoryLike, type ModelPricing, type ModelWithProvider, type NormalizedSseChunk, type ProjectContext, QueueExecutor, RESEARCH_MAX_OUTPUT_TOKENS, RESEARCH_QUERY_MAX, RESEARCH_QUERY_MIN, RESEARCH_REPORT_MIN_CHARS, RESEARCH_SNIPPET_MAX_CHARS, RESEARCH_TEMPERATURE, RequestDeduplicator, RequestQueue, type ResearchSource, type ResearchStreamEvent, RetryExecutor, RetryManager, RetryOptions, SEARCH_MAX_RESULTS, SSE_BRIDGE_EVENTS, SSE_DONE_MARKER, SSE_PREFIX, SYSTEM_PROMPT_VERSION, type SearchTopic, type SseDeltaExtractor, type SseResponseOptions, type StreamEvent, type StreamingParserCallbacks, StreamingResponseParser, StructuredPromptBuilder, type SystemPromptInput, TEXT_EXTRACT_PER_FILE_LIMIT, TEXT_EXTRACT_TOTAL_LIMIT, TRANSIENT_ERROR_CODES, type TaskPlan, type TaskPolicy, type TaskState, ThrottleManager, type ThrottleOptions, TokenUsage, type ToolSchema, type ToolValidationResult, type ToolValidatorFunction, type TrailingDelayParams, type UsageRecordData, type UsageRecordInput, type UsageSeriesDayRow, type UsageSeriesMessageRow, type UsageSeriesPoint, type UsageTrendPoint, type UsageWindowTotals, type VectorCandidate, type VectorMatch, type WebSearchInput, type WebSearchResponse, type WebSearchResult, type ZodLikeIssue, type ZodLikeSchema, accumulateReport, aiErrorStatus, asObjectArray, asRecord, asStringArray, asTrimmedOptionalString, batchEmbed, buildCacheKey, buildHttpStatusFallback, buildResearchMessages, buildSystemPrompt, buildUsageDailySeries, buildUsageData, calculateCacheHitRate, calculateExponentialBackoff, calculateTrailingDelay, canFailover, canStartTask, capText, chunkText, clampScore, classifyHttpStatus, computeCostMicros, cosineSimilarity, countChanges, createSseResponse, debounce, debounceManager, defaultSseDeltaExtractor, deriveSnippetTitle, describeAIErrorType, diffLines, dotProduct, errorRatePct, extractErrorMessageFromJsonBody, extractErrorMessageFromResponse, extractJsonArray, extractJsonCandidate, extractJsonFromCodeFence, extractJsonObject, extractSseDataPayload, extractText, failoverCandidate, findTopKSimilar, formatCost, formatErrorForLogging, formatSseEvent, generateRandomBase36Suffix, isAuthErrorType, isRetryableErrorType, isSseDataLine, isSseDoneMarker, isTextLike, isTransientError, isValidApiKey, isWithinWindow, magnitude, nextAttemptDelayMs, normalizeGenerationSettings, normalizeSources, normalizeSseChunk, oneOfCatalog, planTaskFailure, repairCommonJsonDefects, replayFirst, resolveUserFriendlyErrorMessage, resolveUserFriendlyMessage, searchWeb, selectLeastRecentlyUsedKey, selectMemories, shouldCallOnLeadingEdge, splitMarkdown, splitSseLines, sseStreamResponse, throttle, throttleManager, usageTrendOf, usageWindowTotals, validateApiKey, validateToolArgs };

package/dist/core/index.js

@@ -303,6 +303,23 @@ function errorFromUnknown(err) {
   return new AiError("upstream_error");
 }
 
+// src/core/errors/error-status.ts
+var AI_ERROR_STATUS = {
+  invalid_key: 502,
+  missing_key: 503,
+  rate_limited: 429,
+  capacity: 503,
+  timeout: 504,
+  invalid_request: 400,
+  model_unavailable: 503,
+  upstream_error: 502,
+  network: 502,
+  cancelled: 400
+};
+function aiErrorStatus(code) {
+  return AI_ERROR_STATUS[code];
+}
+
 // src/core/executor/retry-executor.strategy.ts
 var RetryExecutor = class {
   constructor(retryManager2, options) {
@@ -1419,13 +1436,14 @@ function buildContext(history, systemPrompt, budget) {
   const selected = [];
   for (let i = history.length - 1; i >= 0; i -= 1) {
     const message = history[i];
+    if (!message) continue;
     const cost = estimateMessageTokens(message);
     if (used + cost > available && selected.length > 0) break;
     used += cost;
     selected.push(message);
   }
   selected.reverse();
-  while (selected.length > 1 && (selected[0].role === "assistant" || selected[0].role === "tool")) {
+  while (selected.length > 1 && (selected[0]?.role === "assistant" || selected[0]?.role === "tool")) {
     selected.shift();
   }
   return [{ role: "system", content: systemPrompt }, ...selected];
@@ -1628,7 +1646,10 @@ function diffLines(before, after) {
   const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
   for (let i2 = m - 1; i2 >= 0; i2 -= 1) {
     for (let j2 = n - 1; j2 >= 0; j2 -= 1) {
-      dp[i2][j2] = a[i2] === b[j2] ? dp[i2 + 1][j2 + 1] + 1 : Math.max(dp[i2 + 1][j2], dp[i2][j2 + 1]);
+      const row = dp[i2];
+      if (row) {
+        row[j2] = a[i2] === b[j2] ? (dp[i2 + 1]?.[j2 + 1] ?? 0) + 1 : Math.max(dp[i2 + 1]?.[j2] ?? 0, row[j2 + 1] ?? 0);
+      }
     }
   }
   const out = [];
@@ -1636,23 +1657,23 @@ function diffLines(before, after) {
   let j = 0;
   while (i < m && j < n) {
     if (a[i] === b[j]) {
-      out.push({ type: "same", text: a[i] });
+      out.push({ type: "same", text: a[i] ?? "" });
       i += 1;
       j += 1;
-    } else if (dp[i + 1][j] >= dp[i][j + 1]) {
-      out.push({ type: "remove", text: a[i] });
+    } else if ((dp[i + 1]?.[j] ?? 0) >= (dp[i]?.[j + 1] ?? 0)) {
+      out.push({ type: "remove", text: a[i] ?? "" });
       i += 1;
     } else {
-      out.push({ type: "add", text: b[j] });
+      out.push({ type: "add", text: b[j] ?? "" });
       j += 1;
     }
   }
   while (i < m) {
-    out.push({ type: "remove", text: a[i] });
+    out.push({ type: "remove", text: a[i] ?? "" });
     i += 1;
   }
   while (j < n) {
-    out.push({ type: "add", text: b[j] });
+    out.push({ type: "add", text: b[j] ?? "" });
     j += 1;
   }
   return out;
@@ -1767,14 +1788,14 @@ function dotProduct(a, b) {
   const length = Math.min(a.length, b.length);
   let sum = 0;
   for (let i = 0; i < length; i += 1) {
-    sum += a[i] * b[i];
+    sum += (a[i] ?? 0) * (b[i] ?? 0);
   }
   return sum;
 }
 function magnitude(v) {
   let sum = 0;
   for (let i = 0; i < v.length; i += 1) {
-    sum += v[i] * v[i];
+    sum += (v[i] ?? 0) * (v[i] ?? 0);
   }
   return Math.sqrt(sum);
 }
@@ -1919,6 +1940,115 @@ function validateToolArgs(toolKey, args, schemas) {
   return { ok: false, error: `Invalid schema definition for tool: ${toolKey}` };
 }
 
-export { AIError, AIErrorType, AiError, CHUNK_MAX_CHARS, CHUNK_OVERLAP_CHARS, CHUNK_TEXT_LIMIT, CODE_MESSAGES, CacheManager, CompositeExecutor, DEFAULT_AI_IDENTITY, DEFAULT_API_KEY_RULE, DEFAULT_EMBED_BATCH_SIZE, DEFAULT_ERROR_CLASSIFICATION_RULE, DEFAULT_GENERATION, 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, DedupeExecutor, GENERATION_BOUNDS, GroqError, AIErrorType as GroqErrorType, JSON_CODE_BLOCK_PATTERN, JSON_OBJECT_PATTERN, JsonResponseParser, MEMORY_MAX_ITEMS, MEMORY_TOTAL_LIMIT, MICROS_PER_UNIT, QueueExecutor, RESEARCH_MAX_OUTPUT_TOKENS, RESEARCH_QUERY_MAX, RESEARCH_QUERY_MIN, RESEARCH_REPORT_MIN_CHARS, RESEARCH_SNIPPET_MAX_CHARS, RESEARCH_TEMPERATURE, RequestDeduplicator, RequestQueue, RetryExecutor, RetryManager, SEARCH_MAX_RESULTS, SSE_BRIDGE_EVENTS, SSE_DONE_MARKER, SSE_PREFIX, STATUS_TO_CODE, SYSTEM_PROMPT_VERSION, StreamingResponseParser, StructuredPromptBuilder, TEXT_EXTRACT_PER_FILE_LIMIT, TEXT_EXTRACT_TOTAL_LIMIT, TEXT_TIERS, TRANSIENT_ERROR_CODES, ThrottleManager, ToolCallAccumulator, USER_FRIENDLY_ERROR_MESSAGES, accumulateReport, aiErrorMessage, asObjectArray, asRecord, asStringArray, asTrimmedOptionalString, batchEmbed, buildCacheKey, buildContext, buildHttpStatusFallback, buildResearchMessages, buildSystemPrompt, buildUsageData, cacheManager, calculateCacheHitRate, calculateExponentialBackoff, calculateTrailingDelay, canFailover, canStartTask, capText, chunkText, clampScore, classifyHttpStatus, computeCostMicros, cosineSimilarity, countChanges, createSseResponse, debounce, debounceManager, defaultSseDeltaExtractor, deriveSnippetTitle, describeAIErrorType, diffLines, dotProduct, errorFromStatus, errorFromUnknown, estimateMessageTokens, estimateTokens, extractErrorMessageFromJsonBody, extractErrorMessageFromResponse, extractJsonArray, extractJsonCandidate, extractJsonFromCodeFence, extractJsonObject, extractSseDataPayload, extractText, failoverCandidate, findTopKSimilar, formatCost, formatErrorForLogging, formatSseEvent, generateRandomBase36Suffix, isAuthErrorType, isRetryableErrorType, isSseDataLine, isSseDoneMarker, isTextLike, isTextTier, isTransientError, isValidApiKey, isWithinWindow, magnitude, mergeTierOverrides, nextAttemptDelayMs, normalizeGenerationSettings, normalizeSources, normalizeSseChunk, oneOfCatalog, parseSseEvent, planTaskFailure, readSseResponse, repairCommonJsonDefects, replayFirst, requestDeduplicator, requestQueue, resolveModel, resolveUserFriendlyErrorMessage, resolveUserFriendlyMessage, retryManager, searchWeb, selectLeastRecentlyUsedKey, selectMemories, shouldCallOnLeadingEdge, splitMarkdown, splitSseLines, sseStreamResponse, throttle, throttleManager, validateApiKey, validateToolArgs, withRetry };
+// src/core/analytics/usage-series.ts
+function num(value) {
+  const parsed = typeof value === "number" ? value : Number(value ?? 0);
+  return Number.isFinite(parsed) ? parsed : 0;
+}
+function utcDateKey(base, offsetDays) {
+  const shifted = new Date(base.getTime() - offsetDays * 864e5);
+  return shifted.toISOString().slice(0, 10);
+}
+function buildUsageDailySeries(days, usageRows, messageRows, today = /* @__PURE__ */ new Date()) {
+  const usageByDate = new Map(usageRows.map((row) => [row.date, row]));
+  const messageByDate = new Map(messageRows.map((row) => [row.date, row]));
+  const series = [];
+  for (let offset = days - 1; offset >= 0; offset -= 1) {
+    const date = utcDateKey(today, offset);
+    const usage = usageByDate.get(date);
+    const message = messageByDate.get(date);
+    series.push({
+      date,
+      requests: num(usage?.requests),
+      attempts: num(message?.attempts),
+      errors: num(message?.errors),
+      inputTokens: num(usage?.inputTokens),
+      outputTokens: num(usage?.outputTokens),
+      reasoningTokens: num(usage?.reasoningTokens),
+      costMicros: num(usage?.costMicros)
+    });
+  }
+  return series;
+}
+function usageWindowTotals(series, from, to) {
+  const slice = series.slice(from, to);
+  return slice.reduce(
+    (acc, day) => ({
+      requests: acc.requests + day.requests,
+      attempts: acc.attempts + day.attempts,
+      errors: acc.errors + day.errors,
+      inputTokens: acc.inputTokens + day.inputTokens,
+      outputTokens: acc.outputTokens + day.outputTokens,
+      costMicros: acc.costMicros + day.costMicros
+    }),
+    { requests: 0, attempts: 0, errors: 0, inputTokens: 0, outputTokens: 0, costMicros: 0 }
+  );
+}
+function usageTrendOf(current, previous) {
+  return {
+    current,
+    previous,
+    deltaPct: previous > 0 ? (current - previous) / previous * 100 : null
+  };
+}
+function errorRatePct(errors, attempts) {
+  if (attempts <= 0) return 0;
+  return errors / attempts * 100;
+}
+
+// src/core/remote/remote-chat-client.ts
+async function surfaceHttpError(response, callbacks) {
+  const payload = await response.json().catch(() => null);
+  callbacks.onError?.(payload?.code ?? "request_failed", payload?.error ?? "Request failed");
+}
+function createRemoteChatClient(options) {
+  const doFetch = options.fetchImpl ?? fetch;
+  const { urls } = options;
+  return {
+    streamChat(conversationId, body, callbacks) {
+      const controller = new AbortController();
+      const promise = (async () => {
+        const response = await doFetch(urls.stream(conversationId), {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify(body),
+          signal: controller.signal
+        });
+        if (!response.ok) {
+          await surfaceHttpError(response, callbacks);
+          return;
+        }
+        if (!response.body) {
+          callbacks.onError?.("request_failed", "The server returned an empty stream.");
+          return;
+        }
+        await readSseResponse(response, callbacks);
+      })();
+      return {
+        promise,
+        abort: () => controller.abort()
+      };
+    },
+    async resolveToolCall(conversationId, toolCallId, approved, callbacks) {
+      const response = await doFetch(urls.resolveToolCall(conversationId, toolCallId), {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ approved })
+      });
+      if (!response.ok) {
+        await surfaceHttpError(response, callbacks);
+        return false;
+      }
+      const contentType = response.headers.get("content-type") ?? "";
+      if (!contentType.includes("text/event-stream") || !response.body) {
+        return false;
+      }
+      await readSseResponse(response, callbacks);
+      return true;
+    }
+  };
+}
+
+export { AIError, AIErrorType, AI_ERROR_STATUS, AiError, CHUNK_MAX_CHARS, CHUNK_OVERLAP_CHARS, CHUNK_TEXT_LIMIT, CODE_MESSAGES, CacheManager, CompositeExecutor, DEFAULT_AI_IDENTITY, DEFAULT_API_KEY_RULE, DEFAULT_EMBED_BATCH_SIZE, DEFAULT_ERROR_CLASSIFICATION_RULE, DEFAULT_GENERATION, 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, DedupeExecutor, GENERATION_BOUNDS, GroqError, AIErrorType as GroqErrorType, JSON_CODE_BLOCK_PATTERN, JSON_OBJECT_PATTERN, JsonResponseParser, MEMORY_MAX_ITEMS, MEMORY_TOTAL_LIMIT, MICROS_PER_UNIT, QueueExecutor, RESEARCH_MAX_OUTPUT_TOKENS, RESEARCH_QUERY_MAX, RESEARCH_QUERY_MIN, RESEARCH_REPORT_MIN_CHARS, RESEARCH_SNIPPET_MAX_CHARS, RESEARCH_TEMPERATURE, RequestDeduplicator, RequestQueue, RetryExecutor, RetryManager, SEARCH_MAX_RESULTS, SSE_BRIDGE_EVENTS, SSE_DONE_MARKER, SSE_PREFIX, STATUS_TO_CODE, SYSTEM_PROMPT_VERSION, StreamingResponseParser, StructuredPromptBuilder, TEXT_EXTRACT_PER_FILE_LIMIT, TEXT_EXTRACT_TOTAL_LIMIT, TEXT_TIERS, TRANSIENT_ERROR_CODES, ThrottleManager, ToolCallAccumulator, USER_FRIENDLY_ERROR_MESSAGES, accumulateReport, aiErrorMessage, aiErrorStatus, asObjectArray, asRecord, asStringArray, asTrimmedOptionalString, batchEmbed, buildCacheKey, buildContext, buildHttpStatusFallback, buildResearchMessages, buildSystemPrompt, buildUsageDailySeries, buildUsageData, cacheManager, calculateCacheHitRate, calculateExponentialBackoff, calculateTrailingDelay, canFailover, canStartTask, capText, chunkText, clampScore, classifyHttpStatus, computeCostMicros, cosineSimilarity, countChanges, createRemoteChatClient, createSseResponse, debounce, debounceManager, defaultSseDeltaExtractor, deriveSnippetTitle, describeAIErrorType, diffLines, dotProduct, errorFromStatus, errorFromUnknown, errorRatePct, estimateMessageTokens, estimateTokens, extractErrorMessageFromJsonBody, extractErrorMessageFromResponse, extractJsonArray, extractJsonCandidate, extractJsonFromCodeFence, extractJsonObject, extractSseDataPayload, extractText, failoverCandidate, findTopKSimilar, formatCost, formatErrorForLogging, formatSseEvent, generateRandomBase36Suffix, isAuthErrorType, isRetryableErrorType, isSseDataLine, isSseDoneMarker, isTextLike, isTextTier, isTransientError, isValidApiKey, isWithinWindow, magnitude, mergeTierOverrides, nextAttemptDelayMs, normalizeGenerationSettings, normalizeSources, normalizeSseChunk, oneOfCatalog, parseSseEvent, planTaskFailure, readSseResponse, repairCommonJsonDefects, replayFirst, requestDeduplicator, requestQueue, resolveModel, resolveUserFriendlyErrorMessage, resolveUserFriendlyMessage, retryManager, searchWeb, selectLeastRecentlyUsedKey, selectMemories, shouldCallOnLeadingEdge, splitMarkdown, splitSseLines, sseStreamResponse, throttle, throttleManager, usageTrendOf, usageWindowTotals, validateApiKey, validateToolArgs, withRetry };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map