pi-smart-router 0.1.0

package/dist/infrastructure/local/local-zero-tier.js

@@ -0,0 +1,92 @@
+/**
+ * Local zero-tier readiness pings — T045, FR-012, FR-013.
+ *
+ * Pings LM Studio and Ollama HTTP endpoints in parallel to determine
+ * whether a local model is loaded and ready. Combined latency target <15ms.
+ *
+ * Never throws — unreachable services return `available: false`.
+ * Port-based HTTP for testability; default uses Node.js global fetch.
+ */
+// ─── Defaults ────────────────────────────────────────────────────────────────
+export const DEFAULT_LOCAL_CONFIG = {
+    lmStudioBaseUrl: 'http://127.0.0.1:1234',
+    ollamaBaseUrl: 'http://127.0.0.1:11434',
+    pingTimeoutMs: 500,
+};
+const UNAVAILABLE = {
+    available: false,
+    hasLoadedModel: false,
+    latencyMs: 0,
+};
+async function pingLmStudio(baseUrl, signal, httpFetch) {
+    const start = performance.now();
+    try {
+        const res = await httpFetch.fetch(`${baseUrl}/v1/models`, { signal });
+        const latencyMs = performance.now() - start;
+        if (!res.ok) {
+            return { available: true, hasLoadedModel: false, latencyMs };
+        }
+        const body = (await res.json());
+        const hasLoadedModel = Array.isArray(body.data) && body.data.length > 0;
+        return { available: true, hasLoadedModel, latencyMs };
+    }
+    catch {
+        return { ...UNAVAILABLE, latencyMs: performance.now() - start };
+    }
+}
+async function pingOllama(baseUrl, signal, httpFetch) {
+    const start = performance.now();
+    try {
+        const res = await httpFetch.fetch(`${baseUrl}/api/tags`, { signal });
+        const latencyMs = performance.now() - start;
+        if (!res.ok) {
+            return { available: true, hasLoadedModel: false, latencyMs };
+        }
+        const body = (await res.json());
+        const hasLoadedModel = Array.isArray(body.models) && body.models.length > 0;
+        return { available: true, hasLoadedModel, latencyMs };
+    }
+    catch {
+        return { ...UNAVAILABLE, latencyMs: performance.now() - start };
+    }
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Default HTTP fetch port using Node.js global fetch.
+ */
+export const defaultHttpFetch = {
+    fetch: (url, init) => globalThis.fetch(url, init),
+};
+/**
+ * Ping LM Studio and Ollama in parallel. Returns readiness state for each
+ * service and whether any local model is loaded and ready for inference.
+ *
+ * Combined latency target: <15ms on a healthy system.
+ */
+export async function pingLocalServices(config = DEFAULT_LOCAL_CONFIG, httpFetch = defaultHttpFetch) {
+    const overallStart = performance.now();
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), config.pingTimeoutMs);
+    try {
+        const [lmStudio, ollama] = await Promise.all([
+            pingLmStudio(config.lmStudioBaseUrl, controller.signal, httpFetch),
+            pingOllama(config.ollamaBaseUrl, controller.signal, httpFetch),
+        ]);
+        const combinedLatencyMs = performance.now() - overallStart;
+        const anyModelReady = lmStudio.hasLoadedModel || ollama.hasLoadedModel;
+        return { lmStudio, ollama, anyModelReady, combinedLatencyMs };
+    }
+    catch {
+        // FR-022: never crash — return both unavailable on unexpected error
+        return {
+            lmStudio: UNAVAILABLE,
+            ollama: UNAVAILABLE,
+            anyModelReady: false,
+            combinedLatencyMs: performance.now() - overallStart,
+        };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+//# sourceMappingURL=local-zero-tier.js.map

package/dist/infrastructure/local/local-zero-tier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-zero-tier.js","sourceRoot":"","sources":["../../../src/infrastructure/local/local-zero-tier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA+BH,gFAAgF;AAEhF,MAAM,CAAC,MAAM,oBAAoB,GAAwB;IACvD,eAAe,EAAE,uBAAuB;IACxC,aAAa,EAAE,wBAAwB;IACvC,aAAa,EAAE,GAAG;CACnB,CAAC;AAEF,MAAM,WAAW,GAAsB;IACrC,SAAS,EAAE,KAAK;IAChB,cAAc,EAAE,KAAK;IACrB,SAAS,EAAE,CAAC;CACb,CAAC;AAYF,KAAK,UAAU,YAAY,CACzB,OAAe,EACf,MAAmB,EACnB,SAAwB;IAExB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,OAAO,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACtE,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAC5C,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC/D,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA2B,CAAC;QAC1D,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACxE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAClE,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,OAAe,EACf,MAAmB,EACnB,SAAwB;IAExB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,OAAO,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACrE,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAC5C,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC/D,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAuB,CAAC;QACtD,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5E,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAClE,CAAC;AACH,CAAC;AAED,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAkB;IAC7C,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC;CAClD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAA8B,oBAAoB,EAClD,YAA2B,gBAAgB;IAE3C,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CACxB,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EACxB,MAAM,CAAC,aAAa,CACrB,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC3C,YAAY,CAAC,MAAM,CAAC,eAAe,EAAE,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC;YAClE,UAAU,CAAC,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC;SAC/D,CAAC,CAAC;QAEH,MAAM,iBAAiB,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;QAC3D,MAAM,aAAa,GAAG,QAAQ,CAAC,cAAc,IAAI,MAAM,CAAC,cAAc,CAAC;QAEvE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;QACpE,OAAO;YACL,QAAQ,EAAE,WAAW;YACrB,MAAM,EAAE,WAAW;YACnB,aAAa,EAAE,KAAK;YACpB,iBAAiB,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,YAAY;SACpD,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/infrastructure/persistence/memory-store.d.ts

@@ -0,0 +1,31 @@
+/**
+ * In-memory persistence store — fallback when SQLite is unavailable.
+ *
+ * Implements StorePort for process-local state. Data does not survive
+ * process restart. Used as a safety net per FR-025: when the SQLite
+ * state store is unavailable, degrade to in-memory rather than crash.
+ */
+import type { ModelProfile, PriceCatalog, RoutingDatasetRecord, RoutingOutcomeRecord, RoutingTelemetry, SessionPin } from '../../domain/types/entities.js';
+import type { ListDatasetOptions, ListOutcomeOptions, ListTelemetryOptions, StorePort } from '../../domain/types/store-port.js';
+export declare class MemoryStore implements StorePort {
+    private readonly pins;
+    private readonly models;
+    private priceCatalog;
+    private readonly telemetry;
+    private readonly dataset;
+    private readonly outcomes;
+    constructor(models?: readonly ModelProfile[]);
+    getSessionPin(sessionId: string): Promise<SessionPin | null>;
+    putSessionPin(pin: SessionPin): Promise<void>;
+    deleteSessionPin(sessionId: string): Promise<void>;
+    getModelProfiles(): Promise<readonly ModelProfile[]>;
+    getPriceCatalog(): Promise<PriceCatalog | null>;
+    putPriceCatalog(catalog: PriceCatalog): Promise<void>;
+    appendTelemetry(entry: RoutingTelemetry): void;
+    listTelemetry(options?: ListTelemetryOptions): Promise<readonly RoutingTelemetry[]>;
+    appendDatasetRecord(entry: RoutingDatasetRecord): void;
+    listDatasetRecords(options?: ListDatasetOptions): Promise<readonly RoutingDatasetRecord[]>;
+    appendOutcomeRecord(entry: RoutingOutcomeRecord): void;
+    listOutcomeRecords(options?: ListOutcomeOptions): Promise<readonly RoutingOutcomeRecord[]>;
+}
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/infrastructure/persistence/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/persistence/memory-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC3J,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAchI,qBAAa,WAAY,YAAW,SAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;gBAE3C,MAAM,GAAE,SAAS,YAAY,EAAO;IAI1C,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAI5D,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,gBAAgB,IAAI,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC;IAIpD,eAAe,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAI/C,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAKxC,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC;IAazF,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAKhD,kBAAkB,CACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC;IAQ3C,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAKhD,kBAAkB,CACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC;CAe5C"}

package/dist/infrastructure/persistence/memory-store.js

@@ -0,0 +1,87 @@
+/**
+ * In-memory persistence store — fallback when SQLite is unavailable.
+ *
+ * Implements StorePort for process-local state. Data does not survive
+ * process restart. Used as a safety net per FR-025: when the SQLite
+ * state store is unavailable, degrade to in-memory rather than crash.
+ */
+import { DEFAULT_HISTORY_LIMIT, MAX_HISTORY_LIMIT, TELEMETRY_MAX_ENTRIES, makeTelemetryRoom, } from '../telemetry/telemetry-limits.js';
+import { makeDatasetRoom, } from '../telemetry/dataset-limits.js';
+import { makeOutcomeRoom, } from '../telemetry/outcome-limits.js';
+export class MemoryStore {
+    pins = new Map();
+    models;
+    priceCatalog = null;
+    telemetry = [];
+    dataset = [];
+    outcomes = [];
+    constructor(models = []) {
+        this.models = models;
+    }
+    async getSessionPin(sessionId) {
+        return this.pins.get(sessionId) ?? null;
+    }
+    async putSessionPin(pin) {
+        this.pins.set(pin.session_id, pin);
+    }
+    async deleteSessionPin(sessionId) {
+        this.pins.delete(sessionId);
+    }
+    async getModelProfiles() {
+        return this.models;
+    }
+    async getPriceCatalog() {
+        return this.priceCatalog;
+    }
+    async putPriceCatalog(catalog) {
+        this.priceCatalog = catalog;
+    }
+    appendTelemetry(entry) {
+        makeTelemetryRoom(this.telemetry, TELEMETRY_MAX_ENTRIES);
+        this.telemetry.push(entry);
+    }
+    async listTelemetry(options) {
+        const limit = clampHistoryLimit(options?.limit);
+        const sessionId = options?.sessionId;
+        const filtered = sessionId
+            ? this.telemetry.filter((entry) => entry.session_id === sessionId)
+            : this.telemetry;
+        return [...filtered]
+            .reverse()
+            .slice(0, limit);
+    }
+    appendDatasetRecord(entry) {
+        makeDatasetRoom(this.dataset);
+        this.dataset.push(entry);
+    }
+    async listDatasetRecords(options) {
+        const limit = clampHistoryLimit(options?.limit);
+        return [...this.dataset]
+            .reverse()
+            .slice(0, limit);
+    }
+    appendOutcomeRecord(entry) {
+        makeOutcomeRoom(this.outcomes);
+        this.outcomes.push(entry);
+    }
+    async listOutcomeRecords(options) {
+        const limit = clampHistoryLimit(options?.limit);
+        const requestId = options?.requestId;
+        const sessionId = options?.sessionId;
+        const filtered = requestId
+            ? this.outcomes.filter((entry) => entry.request_id === requestId)
+            : sessionId
+                ? this.outcomes.filter((entry) => entry.session_id === sessionId)
+                : this.outcomes;
+        return [...filtered]
+            .reverse()
+            .slice(0, limit);
+    }
+}
+function clampHistoryLimit(limit) {
+    if (limit === undefined) {
+        return DEFAULT_HISTORY_LIMIT;
+    }
+    return Math.min(Math.max(1, Math.floor(limit)), MAX_HISTORY_LIMIT);
+}
+//# sourceMappingURL=memory-store.js.map

package/dist/infrastructure/persistence/memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.js","sourceRoot":"","sources":["../../../src/infrastructure/persistence/memory-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,eAAe,GAChB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,eAAe,GAChB,MAAM,gCAAgC,CAAC;AAExC,MAAM,OAAO,WAAW;IACL,IAAI,GAAG,IAAI,GAAG,EAAsB,CAAC;IACrC,MAAM,CAA0B;IACzC,YAAY,GAAwB,IAAI,CAAC;IAChC,SAAS,GAAuB,EAAE,CAAC;IACnC,OAAO,GAA2B,EAAE,CAAC;IACrC,QAAQ,GAA2B,EAAE,CAAC;IAEvD,YAAY,SAAkC,EAAE;QAC9C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAe;QACjC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,SAAiB;QACtC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAqB;QACzC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;IAC9B,CAAC;IAED,eAAe,CAAC,KAAuB;QACrC,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;QACzD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAA8B;QAChD,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;QAErC,MAAM,QAAQ,GAAG,SAAS;YACxB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC;YAClE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;QAEnB,OAAO,CAAC,GAAG,QAAQ,CAAC;aACjB,OAAO,EAAE;aACT,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,mBAAmB,CAAC,KAA2B;QAC7C,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,OAA4B;QAE5B,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAEhD,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;aACrB,OAAO,EAAE;aACT,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,mBAAmB,CAAC,KAA2B;QAC7C,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,OAA4B;QAE5B,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;QACrC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;QAErC,MAAM,QAAQ,GAAG,SAAS;YACxB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC;YACjE,CAAC,CAAC,SAAS;gBACT,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC;gBACjE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;QAEpB,OAAO,CAAC,GAAG,QAAQ,CAAC;aACjB,OAAO,EAAE;aACT,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,KAAyB;IAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;AACrE,CAAC"}

package/dist/infrastructure/persistence/sqlite-store.d.ts

@@ -0,0 +1,81 @@
+/**
+ * SQLite-backed persistence store for routing state.
+ *
+ * Implements StorePort from domain types, plus token-bucket rate limiting.
+ * Uses WAL journal mode for concurrent reads and BEGIN IMMEDIATE for
+ * atomic token-bucket operations (prevents TOCTOU on rate_limits table).
+ *
+ * Maps to T013 in the routing pipeline spec.
+ */
+import type { ModelProfile, PriceCatalog, RoutingDatasetRecord, RoutingOutcomeRecord, RoutingTelemetry, SessionPin } from '../../domain/types/entities.js';
+import type { ListDatasetOptions, ListOutcomeOptions, ListTelemetryOptions, StorePort } from '../../domain/types/store-port.js';
+export interface TokenBucketResult {
+    readonly allowed: boolean;
+    readonly remaining: number;
+    readonly retryAfterSeconds: number | null;
+}
+export interface SqliteStoreOptions {
+    /** Path to SQLite database file, or ':memory:' for tests. */
+    readonly dbPath: string;
+    /** Fleet catalog (loaded from YAML config, not persisted in SQLite). */
+    readonly models: readonly ModelProfile[];
+}
+export interface CreateStoreResult {
+    readonly store: StorePort;
+    readonly degraded: boolean;
+}
+/**
+ * Create a persistence store with corrupt-DB recovery.
+ *
+ * Strategy:
+ * 1. Attempt to open the SQLite DB and run migrations.
+ * 2. On failure (corrupt/locked): rename the file, try fresh creation.
+ * 3. If recreation also fails: fall back to MemoryStore.
+ *
+ * Never throws — the host agent must not crash due to persistence issues.
+ */
+export declare function createResilientStore(options: SqliteStoreOptions): CreateStoreResult;
+export declare class SqliteStore implements StorePort {
+    private readonly db;
+    private readonly models;
+    private readonly consumeTokenTx;
+    constructor(options: SqliteStoreOptions);
+    getSessionPin(sessionId: string): Promise<SessionPin | null>;
+    putSessionPin(pin: SessionPin): Promise<void>;
+    deleteSessionPin(sessionId: string): Promise<void>;
+    getModelProfiles(): Promise<readonly ModelProfile[]>;
+    getPriceCatalog(): Promise<PriceCatalog | null>;
+    putPriceCatalog(catalog: PriceCatalog): Promise<void>;
+    appendTelemetry(entry: RoutingTelemetry): void;
+    listTelemetry(options?: ListTelemetryOptions): Promise<readonly RoutingTelemetry[]>;
+    private evictTelemetryRows;
+    appendDatasetRecord(entry: RoutingDatasetRecord): void;
+    listDatasetRecords(options?: ListDatasetOptions): Promise<readonly RoutingDatasetRecord[]>;
+    private evictDatasetRows;
+    appendOutcomeRecord(entry: RoutingOutcomeRecord): void;
+    listOutcomeRecords(options?: ListOutcomeOptions): Promise<readonly RoutingOutcomeRecord[]>;
+    private evictOutcomeRows;
+    /**
+     * Initialize a token bucket. Idempotent — existing buckets are unchanged.
+     */
+    initBucket(key: string, maxTokens: number, refillRate: number): void;
+    /**
+     * Atomically attempt to consume tokens from a bucket.
+     *
+     * Uses BEGIN IMMEDIATE to acquire a reserved lock before reading,
+     * preventing TOCTOU races between concurrent consumers.
+     */
+    consumeToken(key: string, cost?: number): TokenBucketResult;
+    /** Run PRAGMA integrity_check. Returns true if the database is healthy. */
+    checkHealth(): boolean;
+    /** Close the database connection. */
+    close(): void;
+    private initialize;
+    private runMigrations;
+    private buildConsumeTokenTx;
+}
+export declare class SqliteStoreError extends Error {
+    readonly name = "SqliteStoreError";
+    constructor(message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=sqlite-store.d.ts.map

package/dist/infrastructure/persistence/sqlite-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/persistence/sqlite-store.ts"],"names":[],"mappings":"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"}