mirror of
https://github.com/diegosouzapw/OmniRoute.git
synced 2026-08-03 13:52:09 +03:00
9.1 — Semantic Cache - New: src/lib/semanticCache.js — Two-tier cache (in-memory LRU + SQLite) - Signature = SHA-256(model + normalized messages + temperature + top_p) - Only caches non-streaming, temperature=0 requests - X-OmniRoute-No-Cache: true header bypass - Response headers: X-OmniRoute-Cache: HIT/MISS - DB table: semantic_cache with indexes on signature and model - New: src/app/api/cache/route.js — GET stats, DELETE clear 9.2 — Request Idempotency - New: src/lib/idempotencyLayer.js — In-memory 5s dedup window - Reads Idempotency-Key or X-Request-Id headers - Returns cached response with X-OmniRoute-Idempotent: true header - Ephemeral by design (no SQLite) 9.3 — Progress Tracking in Streaming - New: open-sse/utils/progressTracker.js - Emits SSE 'event: progress' with tokens_generated + elapsed_ms - Opt-in via X-OmniRoute-Progress: true header - Supports AbortSignal cancellation - Final event includes done: true Integration: - chatCore.js: idempotency check → cache check → provider call → cache store → idempotency save - Streaming path: optional progress transform chain - DB: semantic_cache table added to db/core.js schema Tests: 320 pass (+25 new) | Build: success
102 lines
2.8 KiB
JavaScript
102 lines
2.8 KiB
JavaScript
/**
|
|
* Progress Tracker — Phase 9.3
|
|
*
|
|
* Emits SSE `event: progress` events during long streaming responses.
|
|
* Opt-in via X-OmniRoute-Progress: true header.
|
|
*
|
|
* Progress events contain:
|
|
* { tokens_generated, elapsed_ms }
|
|
*
|
|
* @module utils/progressTracker
|
|
*/
|
|
|
|
const DEFAULT_INTERVAL_MS = 2000;
|
|
|
|
/**
|
|
* Create a progress emitter for a streaming response.
|
|
* Returns a TransformStream that injects progress events periodically.
|
|
*
|
|
* @param {object} options
|
|
* @param {number} [options.intervalMs=2000] - Interval between events
|
|
* @param {AbortSignal} [options.signal] - Abort signal for cancellation
|
|
* @returns {TransformStream}
|
|
*/
|
|
export function createProgressTransform({ intervalMs = DEFAULT_INTERVAL_MS, signal } = {}) {
|
|
let tokenCount = 0;
|
|
let startTime = Date.now();
|
|
let intervalId;
|
|
let writer;
|
|
|
|
const encoder = new TextEncoder();
|
|
|
|
return new TransformStream({
|
|
start(controller) {
|
|
writer = controller;
|
|
startTime = Date.now();
|
|
|
|
intervalId = setInterval(() => {
|
|
if (signal?.aborted) {
|
|
clearInterval(intervalId);
|
|
return;
|
|
}
|
|
const progressEvent = `event: progress\ndata: ${JSON.stringify({
|
|
tokens_generated: tokenCount,
|
|
elapsed_ms: Date.now() - startTime,
|
|
})}\n\n`;
|
|
try {
|
|
controller.enqueue(encoder.encode(progressEvent));
|
|
} catch {
|
|
// Stream closed
|
|
clearInterval(intervalId);
|
|
}
|
|
}, intervalMs);
|
|
|
|
// Clean up on abort
|
|
signal?.addEventListener(
|
|
"abort",
|
|
() => {
|
|
clearInterval(intervalId);
|
|
},
|
|
{ once: true }
|
|
);
|
|
},
|
|
|
|
transform(chunk, controller) {
|
|
// Count token events in the chunk
|
|
const text = typeof chunk === "string" ? chunk : new TextDecoder().decode(chunk);
|
|
// Count data lines (each is roughly one token event)
|
|
const dataLines = text.split("\n").filter((l) => l.startsWith("data: "));
|
|
tokenCount += dataLines.length;
|
|
controller.enqueue(chunk);
|
|
},
|
|
|
|
flush() {
|
|
clearInterval(intervalId);
|
|
// Final progress event
|
|
if (writer) {
|
|
try {
|
|
const finalEvent = `event: progress\ndata: ${JSON.stringify({
|
|
tokens_generated: tokenCount,
|
|
elapsed_ms: Date.now() - startTime,
|
|
done: true,
|
|
})}\n\n`;
|
|
writer.enqueue(encoder.encode(finalEvent));
|
|
} catch {
|
|
// Stream already closed
|
|
}
|
|
}
|
|
},
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Check if client opted into progress tracking.
|
|
* @param {Headers|object} headers
|
|
* @returns {boolean}
|
|
*/
|
|
export function wantsProgress(headers) {
|
|
if (!headers) return false;
|
|
const get = typeof headers.get === "function" ? (k) => headers.get(k) : (k) => headers[k];
|
|
return get("x-omniroute-progress") === "true";
|
|
}
|