@umituz/web-ai 1.3.0 → 1.4.0

package/README.md

@@ -90,6 +90,12 @@ The pieces a backend-proxy chat stack needs, all persistence-free:
 - `buildUsageDailySeries` / `usageWindowTotals` / `usageTrendOf` /
   `errorRatePct` — turn sparse SQL day aggregates into zero-filled usage
   series and dashboard math.
+- `deriveConversationTitle(content, { fallback, maxChars })` — first-line
+  title derivation for new conversations (Markdown prefix strip, collapse,
+  truncate).
+- `planStuckRecovery(task, now)` / `STUCK_TASK_THRESHOLD_MS` — recovery
+  decision for queue rows found stale in `running`; sits next to
+  `canStartTask` / `planTaskFailure`.
 
 ## Client-side chat over your own backend
 

package/dist/core/index.cjs

@@ -322,6 +322,31 @@ function aiErrorStatus(code) {
   return AI_ERROR_STATUS[code];
 }
 
+// src/core/errors/ai-failure.ts
+var TYPE_TO_CODE = {
+  ["INVALID_API_KEY" /* INVALID_API_KEY */]: "invalid_key",
+  ["MISSING_CONFIG" /* MISSING_CONFIG */]: "missing_key",
+  ["NETWORK_ERROR" /* NETWORK_ERROR */]: "network",
+  ["ABORT_ERROR" /* ABORT_ERROR */]: "timeout",
+  ["RATE_LIMIT_ERROR" /* RATE_LIMIT_ERROR */]: "rate_limited",
+  ["SERVER_ERROR" /* SERVER_ERROR */]: "upstream_error",
+  ["CLIENT_ERROR" /* CLIENT_ERROR */]: "invalid_request",
+  ["UNKNOWN_ERROR" /* UNKNOWN_ERROR */]: "upstream_error"
+};
+function aiFailureOf(error) {
+  if (error instanceof AiError) {
+    return { code: error.code, status: AI_ERROR_STATUS[error.code], message: error.userMessage };
+  }
+  if (error instanceof AIError) {
+    const code = TYPE_TO_CODE[error.type];
+    return { code, status: AI_ERROR_STATUS[code], message: CODE_MESSAGES[code] };
+  }
+  if (error instanceof Error && error.name === "AbortError") {
+    return { code: "timeout", status: AI_ERROR_STATUS.timeout, message: CODE_MESSAGES.timeout };
+  }
+  return { code: "upstream_error", status: AI_ERROR_STATUS.upstream_error, message: CODE_MESSAGES.upstream_error };
+}
+
 // src/core/executor/retry-executor.strategy.ts
 var RetryExecutor = class {
   constructor(retryManager2, options) {
@@ -935,6 +960,24 @@ function deriveConversationTitle(content, options = {}) {
   return cleaned.length > maxChars ? `${cleaned.slice(0, maxChars).trimEnd()}\u2026` : cleaned;
 }
 
+// src/core/utils/allowance-window.ts
+var DEFAULT_ALLOWANCE_WINDOW_MS = 36e5;
+function createAllowanceWindow(options) {
+  const windowMs = options.windowMs ?? DEFAULT_ALLOWANCE_WINDOW_MS;
+  const buckets = /* @__PURE__ */ new Map();
+  return {
+    allow(key, now = Date.now()) {
+      const bucket = buckets.get(key);
+      if (bucket === void 0 || now - bucket.windowStart >= windowMs) {
+        buckets.set(key, { windowStart: now, count: 1 });
+        return true;
+      }
+      bucket.count += 1;
+      return bucket.count <= options.limit;
+    }
+  };
+}
+
 // src/core/constants/protocol.constants.ts
 var SSE_PREFIX = "data: ";
 var SSE_DONE_MARKER = "[DONE]";
@@ -2108,6 +2151,7 @@ exports.CODE_MESSAGES = CODE_MESSAGES;
 exports.CacheManager = CacheManager;
 exports.CompositeExecutor = CompositeExecutor;
 exports.DEFAULT_AI_IDENTITY = DEFAULT_AI_IDENTITY;
+exports.DEFAULT_ALLOWANCE_WINDOW_MS = DEFAULT_ALLOWANCE_WINDOW_MS;
 exports.DEFAULT_API_KEY_RULE = DEFAULT_API_KEY_RULE;
 exports.DEFAULT_EMBED_BATCH_SIZE = DEFAULT_EMBED_BATCH_SIZE;
 exports.DEFAULT_ERROR_CLASSIFICATION_RULE = DEFAULT_ERROR_CLASSIFICATION_RULE;
@@ -2160,6 +2204,7 @@ exports.USER_FRIENDLY_ERROR_MESSAGES = USER_FRIENDLY_ERROR_MESSAGES;
 exports.accumulateReport = accumulateReport;
 exports.aiErrorMessage = aiErrorMessage;
 exports.aiErrorStatus = aiErrorStatus;
+exports.aiFailureOf = aiFailureOf;
 exports.asObjectArray = asObjectArray;
 exports.asRecord = asRecord;
 exports.asStringArray = asStringArray;
@@ -2185,6 +2230,7 @@ exports.classifyHttpStatus = classifyHttpStatus;
 exports.computeCostMicros = computeCostMicros;
 exports.cosineSimilarity = cosineSimilarity;
 exports.countChanges = countChanges;
+exports.createAllowanceWindow = createAllowanceWindow;
 exports.createRemoteChatClient = createRemoteChatClient;
 exports.createSseResponse = createSseResponse;
 exports.debounce = debounce;