@srouterhq/server 0.0.0-stage → 0.9.0

package/dist/services/compression/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../src/services/compression/pipeline.ts"],"names":[],"mappings":"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"}

package/dist/services/compression/preservation.d.ts

@@ -0,0 +1,27 @@
+export type ProtectedKind = 'fenced-code' | 'inline-code' | 'url' | 'path' | 'json-key' | 'number' | 'stack-trace' | 'diff-hunk' | 'key-value' | 'error' | 'constraint';
+export interface ProtectedSpan {
+    start: number;
+    end: number;
+    text: string;
+    kinds: ProtectedKind[];
+}
+export declare function mergeProtectedSpans(spans: ProtectedSpan[]): ProtectedSpan[];
+export declare function scanProtectedSpans(text: string): ProtectedSpan[];
+export declare function transformUnprotectedText(text: string, transform: (part: string) => string): string;
+/**
+ * Boolean-only fast path: true when any rule matches, WITHOUT collecting,
+ * sorting or merging the spans. Equivalent to `scanProtectedSpans(text).length > 0`
+ * (none of the rules can match the empty string — every pattern requires at
+ * least one character), but it exits on the first hit instead of building the
+ * full span list. The per-line callers (toolfilter's `mustKeep`,
+ * `protectedLines`, hard-budget, relevance) were paying the full
+ * collect + sort + merge cost just to answer a yes/no question; on a
+ * 20k-line adversarial payload that is the difference between the
+ * compression regression test sitting under and over its budget on slow
+ * hardware.
+ */
+export declare function hasProtectedSpan(text: string): boolean;
+export declare function hasProtectedContent(text: string): boolean;
+export declare function protectedLines(text: string): string[];
+export declare function extractProtectedValues(text: string, kind?: ProtectedKind): string[];
+//# sourceMappingURL=preservation.d.ts.map

package/dist/services/compression/preservation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preservation.d.ts","sourceRoot":"","sources":["../../../src/services/compression/preservation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,aAAa,GACb,KAAK,GACL,MAAM,GACN,UAAU,GACV,QAAQ,GACR,aAAa,GACb,WAAW,GACX,WAAW,GACX,OAAO,GACP,YAAY,CAAC;AAEjB,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAoBD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAe3E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAehE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAoBlG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMtD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAErD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM,EAAE,CAUnF"}

package/dist/services/compression/preservation.js

@@ -0,0 +1,109 @@
+const RULES = [
+    { kind: 'fenced-code', regex: /```[\s\S]*?```/g },
+    { kind: 'inline-code', regex: /`[^`\n]+`/g },
+    { kind: 'url', regex: /\bhttps?:\/\/[^\s<>()]+/gi },
+    { kind: 'path', regex: /(?:\b[A-Za-z]:\\(?:[^\\\s:"<>|?*]+\\)*[^\\\s:"<>|?*]*|\B~?\/(?:[\w.@%+~=-]+\/)*[\w.@%+~=-]+|\B\.{1,2}\/(?:[\w.@%+~=-]+\/)*[\w.@%+~=-]+)/g },
+    { kind: 'json-key', regex: /"(?:\\.|[^"\\])+"\s*:/g },
+    { kind: 'number', regex: /(?<![\w])[-+]?(?:0[xX][0-9a-fA-F]+|\d+(?:\.\d+)?(?:[eE][-+]?\d+)?)(?![\w])/g },
+    { kind: 'stack-trace', regex: /^\s*at\s+.+$/gm },
+    { kind: 'diff-hunk', regex: /^@@[^\n]*@@[^\n]*$/gm },
+    { kind: 'key-value', regex: /\b[A-Za-z_][A-Za-z0-9_.-]*=(?:"[^"]*"|'[^']*'|[^\s]+)/g },
+    { kind: 'error', regex: /^.*\b(?:error|exception|fatal|failed|failure|traceback|panic)\b.*$/gim },
+    {
+        kind: 'constraint',
+        regex: /^.*\b(?:must(?:\s+not)?|do\s+not|don't|never|always|require(?:d|ment|ments)?|constraint|important|warning|security|permission|authorization|forbidden|prohibited)\b.*$/gim,
+    },
+];
+export function mergeProtectedSpans(spans) {
+    const ordered = spans
+        .filter(span => span.end > span.start)
+        .sort((a, b) => a.start - b.start || b.end - a.end);
+    const merged = [];
+    for (const span of ordered) {
+        const previous = merged[merged.length - 1];
+        if (!previous || span.start > previous.end) {
+            merged.push({ ...span, kinds: [...new Set(span.kinds)] });
+            continue;
+        }
+        previous.end = Math.max(previous.end, span.end);
+        previous.kinds = [...new Set([...previous.kinds, ...span.kinds])];
+    }
+    return merged;
+}
+export function scanProtectedSpans(text) {
+    const spans = [];
+    for (const rule of RULES) {
+        rule.regex.lastIndex = 0;
+        for (const match of text.matchAll(rule.regex)) {
+            if (match.index == null || !match[0])
+                continue;
+            spans.push({
+                start: match.index,
+                end: match.index + match[0].length,
+                text: match[0],
+                kinds: [rule.kind],
+            });
+        }
+    }
+    return mergeProtectedSpans(spans).map(span => ({ ...span, text: text.slice(span.start, span.end) }));
+}
+export function transformUnprotectedText(text, transform) {
+    const spans = scanProtectedSpans(text);
+    if (spans.length === 0)
+        return transform(text);
+    const placeholders = [];
+    let masked = '';
+    let cursor = 0;
+    spans.forEach((span, index) => {
+        const placeholder = `\uE000${index.toString(36)}\uE001`;
+        placeholders.push(text.slice(span.start, span.end));
+        masked += text.slice(cursor, span.start);
+        masked += placeholder;
+        cursor = span.end;
+    });
+    masked += text.slice(cursor);
+    // Restore in one pass \u2014 a per-placeholder `.replace()` rescans the whole
+    // string each time and turns span-heavy text quadratic.
+    return transform(masked).replace(/\uE000([0-9a-z]+)\uE001/g, (match, index) => placeholders[Number.parseInt(index, 36)] ?? match);
+}
+/**
+ * Boolean-only fast path: true when any rule matches, WITHOUT collecting,
+ * sorting or merging the spans. Equivalent to `scanProtectedSpans(text).length > 0`
+ * (none of the rules can match the empty string — every pattern requires at
+ * least one character), but it exits on the first hit instead of building the
+ * full span list. The per-line callers (toolfilter's `mustKeep`,
+ * `protectedLines`, hard-budget, relevance) were paying the full
+ * collect + sort + merge cost just to answer a yes/no question; on a
+ * 20k-line adversarial payload that is the difference between the
+ * compression regression test sitting under and over its budget on slow
+ * hardware.
+ */
+export function hasProtectedSpan(text) {
+    for (const rule of RULES) {
+        rule.regex.lastIndex = 0;
+        if (rule.regex.test(text))
+            return true;
+    }
+    return false;
+}
+export function hasProtectedContent(text) {
+    return hasProtectedSpan(text);
+}
+export function protectedLines(text) {
+    return text.split('\n').filter(line => hasProtectedSpan(line));
+}
+export function extractProtectedValues(text, kind) {
+    const values = [];
+    if (!kind)
+        return scanProtectedSpans(text).map(span => span.text);
+    const rule = RULES.find(entry => entry.kind === kind);
+    if (!rule)
+        return values;
+    rule.regex.lastIndex = 0;
+    for (const match of text.matchAll(rule.regex)) {
+        if (match[0])
+            values.push(match[0]);
+    }
+    return values;
+}
+//# sourceMappingURL=preservation.js.map

package/dist/services/compression/preservation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preservation.js","sourceRoot":"","sources":["../../../src/services/compression/preservation.ts"],"names":[],"mappings":"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"}

package/dist/services/compression/registry.d.ts

@@ -0,0 +1,6 @@
+import type { CompressionEngine } from './types.js';
+export declare function registerEngine(engine: CompressionEngine): void;
+export declare function getEngine(id: string): CompressionEngine | undefined;
+export declare function getRegisteredEngines(): CompressionEngine[];
+export declare function _clearRegistryForTesting(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/services/compression/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/services/compression/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpD,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAG9D;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEnE;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,EAAE,CAE1D;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/services/compression/registry.js

@@ -0,0 +1,16 @@
+const engines = new Map();
+export function registerEngine(engine) {
+    if (engines.has(engine.id))
+        throw new Error(`Compression engine already registered: ${engine.id}`);
+    engines.set(engine.id, engine);
+}
+export function getEngine(id) {
+    return engines.get(id);
+}
+export function getRegisteredEngines() {
+    return [...engines.values()].sort((a, b) => a.priority - b.priority || a.id.localeCompare(b.id));
+}
+export function _clearRegistryForTesting() {
+    engines.clear();
+}
+//# sourceMappingURL=registry.js.map

package/dist/services/compression/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/services/compression/registry.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;AAErD,MAAM,UAAU,cAAc,CAAC,MAAyB;IACtD,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IACnG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACnG,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/dist/services/compression/stats.d.ts

@@ -0,0 +1,29 @@
+import type { CompressionMode, CompressionRequestStats } from './types.js';
+interface EngineAggregate {
+    applied: number;
+    discarded: number;
+    savedChars: number;
+}
+export declare function recordCompressionStats(mode: CompressionMode, stats: CompressionRequestStats): void;
+export declare function getCompressionStats(): {
+    requests: number;
+    compressedRequests: number;
+    originalChars: number;
+    compressedChars: number;
+    estSavedTokens: number;
+    savingsPercent: number;
+    avgDurationMs: number;
+    byMode: {
+        [k: string]: {
+            estSavedTokens: number;
+            requests: number;
+            savedChars: number;
+        };
+    };
+    engines: {
+        [k: string]: EngineAggregate;
+    };
+};
+export declare function clearCompressionStats(): void;
+export {};
+//# sourceMappingURL=stats.d.ts.map

package/dist/services/compression/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/services/compression/stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE3E,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAeD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAiBlG;AAED,wBAAgB,mBAAmB;;;;;;;;;;;sBA/BvB,MAAM;wBACJ,MAAM;;;;;;EA8CnB;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAQ5C"}

package/dist/services/compression/stats.js

@@ -0,0 +1,55 @@
+let requests = 0;
+let compressedRequests = 0;
+let originalChars = 0;
+let compressedChars = 0;
+let totalDurationMs = 0;
+const engines = new Map();
+const modes = new Map();
+export function recordCompressionStats(mode, stats) {
+    requests += 1;
+    if (stats.compressedChars < stats.originalChars)
+        compressedRequests += 1;
+    originalChars += stats.originalChars;
+    compressedChars += stats.compressedChars;
+    totalDurationMs += stats.durationMs;
+    const modeRow = modes.get(mode) ?? { requests: 0, savedChars: 0 };
+    modeRow.requests += 1;
+    modeRow.savedChars += stats.originalChars - stats.compressedChars;
+    modes.set(mode, modeRow);
+    for (const stage of stats.stages) {
+        const row = engines.get(stage.engine) ?? { applied: 0, discarded: 0, savedChars: 0 };
+        if (stage.applied)
+            row.applied += 1;
+        else if (stage.discarded && stage.discarded !== 'disabled' && stage.discarded !== 'unchanged')
+            row.discarded += 1;
+        row.savedChars += stage.savedChars;
+        engines.set(stage.engine, row);
+    }
+}
+export function getCompressionStats() {
+    const savedChars = Math.max(0, originalChars - compressedChars);
+    return {
+        requests,
+        compressedRequests,
+        originalChars,
+        compressedChars,
+        estSavedTokens: Math.floor(savedChars / 4),
+        savingsPercent: originalChars > 0 ? Math.round((savedChars / originalChars) * 10_000) / 100 : 0,
+        avgDurationMs: requests > 0 ? Math.round((totalDurationMs / requests) * 100) / 100 : 0,
+        byMode: Object.fromEntries([...modes.entries()].map(([mode, row]) => [
+            mode,
+            { ...row, estSavedTokens: Math.floor(row.savedChars / 4) },
+        ])),
+        engines: Object.fromEntries([...engines.entries()].sort(([a], [b]) => a.localeCompare(b))),
+    };
+}
+export function clearCompressionStats() {
+    requests = 0;
+    compressedRequests = 0;
+    originalChars = 0;
+    compressedChars = 0;
+    totalDurationMs = 0;
+    engines.clear();
+    modes.clear();
+}
+//# sourceMappingURL=stats.js.map

package/dist/services/compression/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/services/compression/stats.ts"],"names":[],"mappings":"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"}

package/dist/services/compression/types.d.ts

@@ -0,0 +1,90 @@
+import type { ChatMessage, ChatToolDefinition } from '@srouter/shared/types.js';
+import type { ZodTypeAny } from 'zod';
+export declare const COMPRESSION_MODES: readonly ["off", "lossless", "standard", "aggressive"];
+export type CompressionMode = (typeof COMPRESSION_MODES)[number];
+export type CompressionTarget = 'tool-results' | 'messages' | 'system';
+export interface CompressionEngineConfig {
+    enabled: boolean;
+    [key: string]: unknown;
+}
+export interface CompressionConfig {
+    mode: CompressionMode;
+    engines: Record<string, CompressionEngineConfig>;
+    autoTriggerEstTokens?: number;
+    targetTokens?: number;
+    trustProjectFilters: boolean;
+    prefixFreeze: boolean;
+}
+export interface ToolCallOrigin {
+    id: string;
+    name: string;
+    arguments: string;
+    messageIndex: number;
+}
+export interface EngineContext {
+    mode: CompressionMode;
+    tools?: ChatToolDefinition[];
+    targetTokens?: number;
+    frozenMessageIndexes: ReadonlySet<number>;
+    toolCallOrigins: ReadonlyMap<string, ToolCallOrigin>;
+}
+export interface EngineInput {
+    messages: ChatMessage[];
+    config: CompressionEngineConfig;
+    context: EngineContext;
+}
+export interface EngineOutput {
+    messages: ChatMessage[];
+    details?: Record<string, unknown>;
+}
+export interface CompressionEngine {
+    id: string;
+    priority: number;
+    lossless: boolean;
+    targets: CompressionTarget[];
+    configSchema: ZodTypeAny;
+    apply(input: EngineInput): EngineOutput;
+}
+export interface CompressionStageStats {
+    engine: string;
+    inputChars: number;
+    outputChars: number;
+    savedChars: number;
+    applied: boolean;
+    discarded?: 'exception' | 'fidelity' | 'inflation' | 'disabled' | 'unchanged';
+    fidelity?: {
+        protectedTokenSurvival: number;
+        numericLiteralsPreserved: boolean;
+        jsonKeySurvival: number;
+        diffHunksPreserved: boolean;
+        criticalLinesPreserved: boolean;
+    };
+    details?: Record<string, unknown>;
+}
+export interface CompressionRequestStats {
+    originalChars: number;
+    compressedChars: number;
+    estOriginalTokens: number;
+    estCompressedTokens: number;
+    estSavedTokens: number;
+    enginesApplied: string[];
+    discardedByGate: string[];
+    durationMs: number;
+    stages: CompressionStageStats[];
+}
+export interface CompressionResult {
+    messages: ChatMessage[];
+    mode: CompressionMode;
+    cacheKey: string;
+    stats: CompressionRequestStats;
+}
+export interface CompressRequestOptions {
+    header?: string | string[];
+    tools?: ChatToolDefinition[];
+    config?: CompressionConfig;
+    previewMode?: CompressionMode;
+    targetTokens?: number;
+    cacheControlPrefixLength?: number;
+    recordStats?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/compression/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/compression/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEtC,eAAO,MAAM,iBAAiB,wDAAyD,CAAC;AACxF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEvE,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IACjD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,uBAAuB,CAAC;IAChC,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,YAAY,EAAE,UAAU,CAAC;IACzB,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAAC;CACzC;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;IAC9E,QAAQ,CAAC,EAAE;QACT,sBAAsB,EAAE,MAAM,CAAC;QAC/B,wBAAwB,EAAE,OAAO,CAAC;QAClC,eAAe,EAAE,MAAM,CAAC;QACxB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,sBAAsB,EAAE,OAAO,CAAC;KACjC,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,uBAAuB,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/services/compression/types.js

@@ -0,0 +1,2 @@
+export const COMPRESSION_MODES = ['off', 'lossless', 'standard', 'aggressive'];
+//# sourceMappingURL=types.js.map

package/dist/services/compression/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/compression/types.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,CAAU,CAAC"}

package/dist/services/context-handoff.d.ts

@@ -0,0 +1,22 @@
+import type { ChatMessage } from '@srouter/shared/types.js';
+export type ContextHandoffMode = 'off' | 'on_model_switch';
+export declare const HANDOFF_MAX_TOKENS: number;
+export declare function getContextHandoffMode(): ContextHandoffMode;
+export declare function recordIncomingMessages(sessionKey: string, messages: ChatMessage[]): void;
+export declare function hasPriorModel(sessionKey: string): boolean;
+export declare function maybeInjectContextHandoff(params: {
+    mode: ContextHandoffMode;
+    sessionKey: string;
+    messages: ChatMessage[];
+    selectedModelKey: string;
+}): {
+    messages: ChatMessage[];
+    injected: boolean;
+    injectedTokens: number;
+};
+export declare function recordSuccessfulModel(params: {
+    sessionKey: string;
+    modelKey: string;
+}): void;
+export declare function _clearStoreForTesting(): void;
+//# sourceMappingURL=context-handoff.d.ts.map

package/dist/services/context-handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-handoff.d.ts","sourceRoot":"","sources":["../../src/services/context-handoff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,iBAAiB,CAAC;AAmB3D,eAAO,MAAM,kBAAkB,QAA2C,CAAC;AAI3E,wBAAgB,qBAAqB,IAAI,kBAAkB,CAG1D;AA0BD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAoCxF;AAcD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,IAAI,EAAE,kBAAkB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG;IAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAyCzE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAqBP;AAGD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/services/context-handoff.js

@@ -0,0 +1,164 @@
+import { contentToString } from '../lib/content.js';
+const MAX_RECENT_MESSAGES = 12;
+const MAX_HANDOFF_CHARS = 6000;
+const MAX_CONTENT_PER_MSG = 500;
+const SESSION_TTL_MS = 3 * 60 * 60 * 1000;
+const MAX_STORE_SIZE = 500;
+// (MAX_HANDOFF_CHARS chars + ~400 overhead chars) / 4 chars-per-token — conservative upper bound.
+// Exported so proxy.ts can pad the routing token estimate to account for the injected message
+// before routeRequest() runs its context-window and TPM checks.
+export const HANDOFF_MAX_TOKENS = Math.ceil((MAX_HANDOFF_CHARS + 400) / 4);
+const store = new Map();
+export function getContextHandoffMode() {
+    const raw = process.env.SROUTER_CONTEXT_HANDOFF?.trim().toLowerCase();
+    return raw === 'on_model_switch' ? 'on_model_switch' : 'off';
+}
+// Slice without cutting through a surrogate pair. A bare String.slice can
+// leave a lone high surrogate when it lands mid astral-plane char (emoji etc.),
+// and some providers 400 on a lone surrogate. Trim that trailing half-char off.
+// (Lib-agnostic — String.prototype.toWellFormed needs the es2024 lib target.)
+function safeSlice(text, max) {
+    if (text.length <= max)
+        return text;
+    const lastCode = text.charCodeAt(max - 1);
+    const end = lastCode >= 0xd800 && lastCode <= 0xdbff ? max - 1 : max;
+    return text.slice(0, end);
+}
+function trimContent(content) {
+    const text = contentToString(content);
+    return text.length > MAX_CONTENT_PER_MSG ? safeSlice(text, MAX_CONTENT_PER_MSG) + '…' : text;
+}
+function pruneExpired() {
+    if (store.size === 0)
+        return;
+    const now = Date.now();
+    for (const [key, ctx] of store) {
+        if (now - ctx.updatedAt > SESSION_TTL_MS)
+            store.delete(key);
+    }
+}
+export function recordIncomingMessages(sessionKey, messages) {
+    if (!sessionKey)
+        return;
+    pruneExpired();
+    const trimmed = messages
+        .filter(m => m.role === 'user' || m.role === 'assistant')
+        .map(m => ({ role: m.role, content: trimContent(m.content) }))
+        .slice(-MAX_RECENT_MESSAGES);
+    // Mutate in place to preserve lastModelKey written by recordSuccessfulModel
+    // on concurrent/overlapping requests without replacing the whole entry.
+    // If the incoming payload has no assistant turns, treat it as a fresh conversation
+    // and clear lastModelKey — prevents spurious handoffs when a session ID is reused
+    // after the sticky-session (30 min) TTL expires but before the handoff TTL (3 h).
+    const hasAssistant = messages.some(m => m.role === 'assistant');
+    const existing = store.get(sessionKey);
+    if (existing) {
+        if (!hasAssistant)
+            existing.lastModelKey = undefined;
+        existing.recentMessages = trimmed;
+        existing.updatedAt = Date.now();
+    }
+    else {
+        store.set(sessionKey, { recentMessages: trimmed, updatedAt: Date.now() });
+    }
+    // Size cap: TTL-prune first; if store is still over the limit, evict the
+    // oldest entries by updatedAt. Mirrors the stickySessionMap 500-entry pattern.
+    if (store.size > MAX_STORE_SIZE) {
+        const now = Date.now();
+        for (const [k, v] of store) {
+            if (now - v.updatedAt > SESSION_TTL_MS)
+                store.delete(k);
+        }
+        if (store.size > MAX_STORE_SIZE) {
+            const sorted = [...store.entries()].sort((a, b) => a[1].updatedAt - b[1].updatedAt);
+            for (const [k] of sorted.slice(0, store.size - MAX_STORE_SIZE))
+                store.delete(k);
+        }
+    }
+}
+function buildSummary(messages) {
+    const lines = messages.map(m => `${m.role === 'user' ? 'User' : 'Assistant'}: ${m.content}`);
+    const joined = lines.join('\n');
+    return joined.length > MAX_HANDOFF_CHARS
+        ? safeSlice(joined, MAX_HANDOFF_CHARS) + '\n…[truncated]'
+        : joined;
+}
+// True when a prior successful model is on record for this session, i.e. the
+// next request *could* trigger a handoff. proxy.ts uses this to skip padding
+// the routing token estimate on turns where injection is impossible (every
+// turn 1, and sessions that never switched), avoiding a needless headroom tax.
+export function hasPriorModel(sessionKey) {
+    if (!sessionKey)
+        return false;
+    return !!store.get(sessionKey)?.lastModelKey;
+}
+export function maybeInjectContextHandoff(params) {
+    const { mode, sessionKey, messages, selectedModelKey } = params;
+    if (mode === 'off' || !sessionKey)
+        return { messages, injected: false, injectedTokens: 0 };
+    const ctx = store.get(sessionKey);
+    if (!ctx?.lastModelKey || ctx.lastModelKey === selectedModelKey) {
+        return { messages, injected: false, injectedTokens: 0 };
+    }
+    // Skip if a handoff message is already present — handles both plain strings
+    // and the array-content format that OpenCode/Continue.dev send.
+    const alreadyPresent = messages.some(m => {
+        if (m.role !== 'system')
+            return false;
+        const text = typeof m.content === 'string' ? m.content : contentToString(m.content);
+        return text.startsWith('srouter context handoff:');
+    });
+    if (alreadyPresent)
+        return { messages, injected: false, injectedTokens: 0 };
+    const summary = buildSummary(ctx.recentMessages);
+    const handoffContent = [
+        'srouter context handoff:',
+        `You are taking over an ongoing conversation from another model (${ctx.lastModelKey} → ${selectedModelKey}).`,
+        'Continue the user\'s task using the conversation context already provided in this request.',
+        'Do not restart the task, re-ask already answered setup questions, or discard prior tool results.',
+        'Respect the user\'s latest message as the highest-priority instruction.',
+        '',
+        'Recent session summary:',
+        summary,
+    ].join('\n');
+    const handoffMsg = { role: 'system', content: handoffContent };
+    // Insert after any leading system messages so provider system-prompt ordering is preserved
+    const insertAt = messages.findIndex(m => m.role !== 'system');
+    const pos = insertAt === -1 ? messages.length : insertAt;
+    return {
+        messages: [...messages.slice(0, pos), handoffMsg, ...messages.slice(pos)],
+        injected: true,
+        injectedTokens: Math.ceil(handoffContent.length / 4),
+    };
+}
+export function recordSuccessfulModel(params) {
+    const { sessionKey, modelKey } = params;
+    if (!sessionKey)
+        return;
+    pruneExpired();
+    const ctx = store.get(sessionKey);
+    if (ctx) {
+        ctx.lastModelKey = modelKey;
+        ctx.updatedAt = Date.now();
+    }
+    else {
+        store.set(sessionKey, { lastModelKey: modelKey, recentMessages: [], updatedAt: Date.now() });
+        if (store.size > MAX_STORE_SIZE) {
+            const now = Date.now();
+            for (const [k, v] of store) {
+                if (now - v.updatedAt > SESSION_TTL_MS)
+                    store.delete(k);
+            }
+            if (store.size > MAX_STORE_SIZE) {
+                const sorted = [...store.entries()].sort((a, b) => a[1].updatedAt - b[1].updatedAt);
+                for (const [k] of sorted.slice(0, store.size - MAX_STORE_SIZE))
+                    store.delete(k);
+            }
+        }
+    }
+}
+// For tests only
+export function _clearStoreForTesting() {
+    store.clear();
+}
+//# sourceMappingURL=context-handoff.js.map

package/dist/services/context-handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-handoff.js","sourceRoot":"","sources":["../../src/services/context-handoff.ts"],"names":[],"mappings":"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"}

package/dist/services/cooldown-probe.d.ts

@@ -0,0 +1,24 @@
+import type { Scheduler } from '../lib/scheduler.js';
+import { type KeyProbeOutcome } from './health.js';
+export interface ProbePassOptions {
+    now?: number;
+    probe?: (keyId: number) => Promise<KeyProbeOutcome>;
+    jitter?: () => number;
+    maxProbes?: number;
+}
+export interface ProbePassResult {
+    probedKeyIds: number[];
+    clearedCooldowns: number;
+}
+/**
+ * One probe pass: find ripe heuristic cooldowns, probe up to maxProbes of their
+ * keys (respecting per-key backoff), and clear every heuristic cooldown on a
+ * key whose probe passed. Exported for tests; production runs it on the
+ * scheduler via startCooldownProbe.
+ */
+export declare function runCooldownProbePass(opts?: ProbePassOptions): Promise<ProbePassResult>;
+export declare function startCooldownProbe(scheduler: Scheduler): void;
+export declare function stopCooldownProbe(): void;
+/** Test seam: drop all per-key probe pacing state. */
+export declare function resetCooldownProbeState(): void;
+//# sourceMappingURL=cooldown-probe.d.ts.map

package/dist/services/cooldown-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cooldown-probe.d.ts","sourceRoot":"","sources":["../../src/services/cooldown-probe.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMrD,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAkDrE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACpD,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAYD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqEhG;AAgBD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAc7D;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC;AAED,sDAAsD;AACtD,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}