@umituz/web-ai 1.1.0 → 1.2.0

package/dist/context-manager-CuZz0vnC.d.cts

@@ -0,0 +1,104 @@
+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;
+
+interface RetryOptions {
+    readonly maxAttempts?: number;
+    readonly initialDelay?: number;
+    readonly maxDelay?: number;
+    readonly backoffMultiplier?: number;
+    readonly jitterFactor?: number;
+    readonly shouldRetry?: (error: Error) => boolean;
+}
+declare class RetryManager {
+    private readonly defaults;
+    constructor();
+    execute<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+    private shouldRetry;
+    private delay;
+}
+declare const retryManager: RetryManager;
+declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+
+interface QueueOptions {
+    readonly maxConcurrent?: number;
+    readonly defaultPriority?: number;
+    readonly requestTimeout?: number;
+}
+declare class RequestQueue {
+    private queue;
+    private readonly activeRequests;
+    private readonly maxConcurrent;
+    private readonly defaultPriority;
+    private readonly requestTimeout;
+    private requestIdCounter;
+    constructor(options?: QueueOptions);
+    add<T>(requestFn: () => Promise<T>, priority?: number): Promise<T>;
+    cancelAll(): void;
+    private sortQueue;
+    private process;
+    private executeRequest;
+}
+declare const requestQueue: RequestQueue;
+
+declare class RequestDeduplicator {
+    private readonly pendingRequests;
+    private readonly ttl;
+    constructor(ttl?: number);
+    execute<T>(key: string, requestFn: () => Promise<T>): Promise<T>;
+    cancelAll(): void;
+    private cleanup;
+}
+declare const requestDeduplicator: RequestDeduplicator;
+
+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[];
+
+export { AiError as A, CODE_MESSAGES as C, type ProviderErrorShape as P, type QueueOptions as Q, RequestDeduplicator as R, STATUS_TO_CODE as S, ToolCallAccumulator as T, type WireToolCallDelta as W, type AiErrorCode as a, type AssistantToolCall as b, type ContextBudget as c, type ContextMessage as d, type ContextRole as e, RequestQueue as f, RetryManager as g, type RetryOptions as h, aiErrorMessage as i, buildContext as j, errorFromStatus as k, errorFromUnknown as l, estimateMessageTokens as m, estimateTokens as n, requestQueue as o, retryManager as p, requestDeduplicator as r, withRetry as w };

package/dist/context-manager-CuZz0vnC.d.ts

@@ -0,0 +1,104 @@
+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;
+
+interface RetryOptions {
+    readonly maxAttempts?: number;
+    readonly initialDelay?: number;
+    readonly maxDelay?: number;
+    readonly backoffMultiplier?: number;
+    readonly jitterFactor?: number;
+    readonly shouldRetry?: (error: Error) => boolean;
+}
+declare class RetryManager {
+    private readonly defaults;
+    constructor();
+    execute<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+    private shouldRetry;
+    private delay;
+}
+declare const retryManager: RetryManager;
+declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+
+interface QueueOptions {
+    readonly maxConcurrent?: number;
+    readonly defaultPriority?: number;
+    readonly requestTimeout?: number;
+}
+declare class RequestQueue {
+    private queue;
+    private readonly activeRequests;
+    private readonly maxConcurrent;
+    private readonly defaultPriority;
+    private readonly requestTimeout;
+    private requestIdCounter;
+    constructor(options?: QueueOptions);
+    add<T>(requestFn: () => Promise<T>, priority?: number): Promise<T>;
+    cancelAll(): void;
+    private sortQueue;
+    private process;
+    private executeRequest;
+}
+declare const requestQueue: RequestQueue;
+
+declare class RequestDeduplicator {
+    private readonly pendingRequests;
+    private readonly ttl;
+    constructor(ttl?: number);
+    execute<T>(key: string, requestFn: () => Promise<T>): Promise<T>;
+    cancelAll(): void;
+    private cleanup;
+}
+declare const requestDeduplicator: RequestDeduplicator;
+
+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[];
+
+export { AiError as A, CODE_MESSAGES as C, type ProviderErrorShape as P, type QueueOptions as Q, RequestDeduplicator as R, STATUS_TO_CODE as S, ToolCallAccumulator as T, type WireToolCallDelta as W, type AiErrorCode as a, type AssistantToolCall as b, type ContextBudget as c, type ContextMessage as d, type ContextRole as e, RequestQueue as f, RetryManager as g, type RetryOptions as h, aiErrorMessage as i, buildContext as j, errorFromStatus as k, errorFromUnknown as l, estimateMessageTokens as m, estimateTokens as n, requestQueue as o, retryManager as p, requestDeduplicator as r, withRetry as w };

package/dist/core/index.cjs

@@ -305,6 +305,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) {
@@ -1421,13 +1438,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];
@@ -1630,7 +1648,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 = [];
@@ -1638,23 +1659,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;
@@ -1769,14 +1790,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);
 }
@@ -1921,8 +1942,118 @@ function validateToolArgs(toolKey, args, schemas) {
   return { ok: false, error: `Invalid schema definition for tool: ${toolKey}` };
 }
 
+// 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;
+    }
+  };
+}
+
 exports.AIError = AIError;
 exports.AIErrorType = AIErrorType;
+exports.AI_ERROR_STATUS = AI_ERROR_STATUS;
 exports.AiError = AiError;
 exports.CHUNK_MAX_CHARS = CHUNK_MAX_CHARS;
 exports.CHUNK_OVERLAP_CHARS = CHUNK_OVERLAP_CHARS;
@@ -1981,6 +2112,7 @@ exports.ToolCallAccumulator = ToolCallAccumulator;
 exports.USER_FRIENDLY_ERROR_MESSAGES = USER_FRIENDLY_ERROR_MESSAGES;
 exports.accumulateReport = accumulateReport;
 exports.aiErrorMessage = aiErrorMessage;
+exports.aiErrorStatus = aiErrorStatus;
 exports.asObjectArray = asObjectArray;
 exports.asRecord = asRecord;
 exports.asStringArray = asStringArray;
@@ -1991,6 +2123,7 @@ exports.buildContext = buildContext;
 exports.buildHttpStatusFallback = buildHttpStatusFallback;
 exports.buildResearchMessages = buildResearchMessages;
 exports.buildSystemPrompt = buildSystemPrompt;
+exports.buildUsageDailySeries = buildUsageDailySeries;
 exports.buildUsageData = buildUsageData;
 exports.cacheManager = cacheManager;
 exports.calculateCacheHitRate = calculateCacheHitRate;
@@ -2005,6 +2138,7 @@ exports.classifyHttpStatus = classifyHttpStatus;
 exports.computeCostMicros = computeCostMicros;
 exports.cosineSimilarity = cosineSimilarity;
 exports.countChanges = countChanges;
+exports.createRemoteChatClient = createRemoteChatClient;
 exports.createSseResponse = createSseResponse;
 exports.debounce = debounce;
 exports.debounceManager = debounceManager;
@@ -2015,6 +2149,7 @@ exports.diffLines = diffLines;
 exports.dotProduct = dotProduct;
 exports.errorFromStatus = errorFromStatus;
 exports.errorFromUnknown = errorFromUnknown;
+exports.errorRatePct = errorRatePct;
 exports.estimateMessageTokens = estimateMessageTokens;
 exports.estimateTokens = estimateTokens;
 exports.extractErrorMessageFromJsonBody = extractErrorMessageFromJsonBody;
@@ -2067,6 +2202,8 @@ exports.splitSseLines = splitSseLines;
 exports.sseStreamResponse = sseStreamResponse;
 exports.throttle = throttle;
 exports.throttleManager = throttleManager;
+exports.usageTrendOf = usageTrendOf;
+exports.usageWindowTotals = usageWindowTotals;
 exports.validateApiKey = validateApiKey;
 exports.validateToolArgs = validateToolArgs;
 exports.withRetry = withRetry;