@evelinka-ai/core 0.3.0 → 0.4.0

package/dist/channels/usage.js

@@ -1,7 +1,8 @@
 import { defineChannel, GET } from "eve/channels";
-import { logger } from "../lib/observability/logger.js";
 import { readRunUsageByModel } from "../lib/budgets/token-usage-pg.js";
 import { buildRunUsage, buildUsage, buildUsageLogs, UsageQueryError, } from "../lib/budgets/usage.js";
+import { logger } from "../lib/observability/logger.js";
+import { parseModelEventsQuery, readModelEventsPage } from "../lib/observability/model-events.js";
 const log = logger.child({ module: "usage" });
 export default defineChannel({
     routes: [
@@ -26,10 +27,17 @@ export default defineChannel({
                 return Response.json(await buildUsageLogs(req.url, new Date()));
             }
             catch (err) {
+                if (err instanceof UsageQueryError) {
+                    return Response.json({ error: err.message }, { status: 400 });
+                }
                 log.error({ err }, "failed to build usage logs");
                 return Response.json({ error: "failed to build usage logs" }, { status: 500 });
             }
         }),
+        GET("/eve/v1/usage/events", async (req) => {
+            const page = await readModelEventsPage(parseModelEventsQuery(req.url));
+            return Response.json({ ...page, generatedAt: new Date().toISOString() });
+        }),
     ],
 });
 //# sourceMappingURL=usage.js.map

package/dist/channels/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/channels/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EACL,aAAa,EACb,UAAU,EACV,cAAc,EACd,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AAO9C,eAAe,aAAa,CAAC;IAC3B,MAAM,EAAE;QACN,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACjC,IAAI,CAAC;gBACH,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;YAC9D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBAEb,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;oBACnC,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;gBAChE,CAAC;gBAED,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,iCAAiC,CAAC,CAAC;gBACtD,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC,CAAC;QAMF,GAAG,CAAC,uBAAuB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;YACtD,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAClD,OAAO,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QACnE,CAAC,CAAC;QACF,GAAG,CAAC,oBAAoB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACtC,IAAI,CAAC;gBACH,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;YAClE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,4BAA4B,CAAC,CAAC;gBACjD,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,4BAA4B,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC,CAAC;KACH;CACF,CAAC,CAAC"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/channels/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EACL,aAAa,EACb,UAAU,EACV,cAAc,EACd,eAAe,GAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAElG,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AAO9C,eAAe,aAAa,CAAC;IAC3B,MAAM,EAAE;QACN,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACjC,IAAI,CAAC;gBACH,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;YAC9D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBAEb,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;oBACnC,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;gBAChE,CAAC;gBAED,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,iCAAiC,CAAC,CAAC;gBACtD,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC,CAAC;QAMF,GAAG,CAAC,uBAAuB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;YACtD,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAClD,OAAO,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QACnE,CAAC,CAAC;QACF,GAAG,CAAC,oBAAoB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACtC,IAAI,CAAC;gBACH,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;YAClE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;oBACnC,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;gBAChE,CAAC;gBACD,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,4BAA4B,CAAC,CAAC;gBACjD,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,4BAA4B,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC,CAAC;QAIF,GAAG,CAAC,sBAAsB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACxC,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACvE,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC3E,CAAC,CAAC;KACH;CACF,CAAC,CAAC"}

package/dist/db/connection-pool.d.ts

@@ -0,0 +1,18 @@
+import { Pool, type PoolClient, type PoolConfig } from "pg";
+type ConnectCallback = Parameters<Pool["connect"]>[0];
+export declare class ConnectionPool extends Pool {
+    private readonly ordinary;
+    private readonly leases;
+    private closing;
+    constructor(config: PoolConfig);
+    get queuedCount(): number;
+    connect(): Promise<PoolClient>;
+    connect(callback: ConnectCallback): void;
+    connectLease(name: string, slots: number): Promise<PoolClient>;
+    private drain;
+    private borrow;
+    end(): Promise<void>;
+    end(callback: () => void): void;
+}
+export {};
+//# sourceMappingURL=connection-pool.d.ts.map

package/dist/db/connection-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-pool.d.ts","sourceRoot":"","sources":["../../src/db/connection-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,IAAI,CAAC;AAE5D,KAAK,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAgBtD,qBAAa,cAAe,SAAQ,IAAI;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAO;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,UAAU;IAK9B,IAAI,WAAW,IAAI,MAAM,CAMxB;IAEQ,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAC9B,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAajD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiB9D,OAAO,CAAC,KAAK;IASb,OAAO,CAAC,MAAM;IAwEL,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IACpB,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;CASzC"}

package/dist/db/connection-pool.js

@@ -0,0 +1,125 @@
+import { Pool } from "pg";
+export class ConnectionPool extends Pool {
+    ordinary;
+    leases = new Map();
+    closing = false;
+    constructor(config) {
+        super(config);
+        this.ordinary = { limit: this.options.max, active: 0, waiting: new Set() };
+    }
+    get queuedCount() {
+        return (this.waitingCount +
+            this.ordinary.waiting.size +
+            [...this.leases.values()].reduce((sum, lane) => sum + lane.waiting.size, 0));
+    }
+    connect(callback) {
+        const result = this.borrow(this.ordinary);
+        if (!callback)
+            return result;
+        void result.then((client) => callback(undefined, client, client.release), (error) => callback(error, undefined, () => { }));
+    }
+    connectLease(name, slots) {
+        if (!name || !Number.isSafeInteger(slots) || slots < 1) {
+            return Promise.reject(new Error("Invalid shared-pool lease capacity"));
+        }
+        let lane = this.leases.get(name);
+        if (!lane) {
+            lane = { limit: slots, active: 0, waiting: new Set() };
+            this.leases.set(name, lane);
+        }
+        else {
+            lane.limit = Math.max(lane.limit, slots);
+        }
+        this.options.max =
+            this.ordinary.limit + [...this.leases.values()].reduce((sum, l) => sum + l.limit, 0);
+        this.drain(lane);
+        return this.borrow(lane);
+    }
+    drain(lane) {
+        while (!this.closing && lane.active < lane.limit) {
+            const next = lane.waiting.values().next().value;
+            if (!next)
+                break;
+            lane.waiting.delete(next);
+            next.start();
+        }
+    }
+    borrow(lane) {
+        if (this.closing || this.ending)
+            return Promise.reject(new Error("Cannot use a pool after calling end"));
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            let active = false;
+            const releaseSlot = () => {
+                if (!active)
+                    return;
+                active = false;
+                lane.active--;
+                this.drain(lane);
+            };
+            const borrower = {
+                cancel: (error) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    lane.waiting.delete(borrower);
+                    clearTimeout(timer);
+                    reject(error);
+                },
+                start: () => {
+                    active = true;
+                    lane.active++;
+                    try {
+                        super.connect((error, client, release) => {
+                            if (error || !client) {
+                                releaseSlot();
+                                borrower.cancel(error ?? new Error("Postgres returned no client"));
+                                return;
+                            }
+                            if (settled) {
+                                try {
+                                    release();
+                                }
+                                finally {
+                                    releaseSlot();
+                                }
+                                return;
+                            }
+                            settled = true;
+                            clearTimeout(timer);
+                            let released = false;
+                            client.release = (destroy) => {
+                                if (released)
+                                    throw new Error("Release called on client which has already been released to the pool.");
+                                released = true;
+                                try {
+                                    release(destroy);
+                                }
+                                finally {
+                                    releaseSlot();
+                                }
+                            };
+                            resolve(client);
+                        });
+                    }
+                    catch (error) {
+                        releaseSlot();
+                        borrower.cancel(error instanceof Error ? error : new Error(String(error)));
+                    }
+                },
+            };
+            const timer = setTimeout(() => borrower.cancel(new Error("timeout exceeded when trying to connect")), this.options.connectionTimeoutMillis || 5000);
+            lane.waiting.add(borrower);
+            this.drain(lane);
+        });
+    }
+    end(callback) {
+        this.closing = true;
+        for (const lane of [this.ordinary, ...this.leases.values()]) {
+            for (const borrower of lane.waiting)
+                borrower.cancel(new Error("Cannot use a pool after calling end"));
+        }
+        return callback ? super.end(callback) : super.end();
+    }
+}
+//# sourceMappingURL=connection-pool.js.map

package/dist/db/connection-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-pool.js","sourceRoot":"","sources":["../../src/db/connection-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoC,MAAM,IAAI,CAAC;AAkB5D,MAAM,OAAO,cAAe,SAAQ,IAAI;IACrB,QAAQ,CAAO;IACf,MAAM,GAAG,IAAI,GAAG,EAAgB,CAAC;IAC1C,OAAO,GAAG,KAAK,CAAC;IAExB,YAAY,MAAkB;QAC5B,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,QAAQ,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IAC7E,CAAC;IAED,IAAI,WAAW;QACb,OAAO,CACL,IAAI,CAAC,YAAY;YACjB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI;YAC1B,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAC5E,CAAC;IACJ,CAAC;IAIQ,OAAO,CAAC,QAA0B;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ;YAAE,OAAO,MAAM,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,CACd,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EACvD,CAAC,KAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CACvD,CAAC;IACJ,CAAC;IAKD,YAAY,CAAC,IAAY,EAAE,KAAa;QACtC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACvD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;YACvD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG;YACd,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACvF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,IAAU;QACtB,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAChD,IAAI,CAAC,IAAI;gBAAE,MAAM;YACjB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,IAAU;QACvB,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM;YAC7B,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC,CAAC;QAC1E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,MAAM,GAAG,KAAK,CAAC;YACnB,MAAM,WAAW,GAAG,GAAG,EAAE;gBACvB,IAAI,CAAC,MAAM;oBAAE,OAAO;gBACpB,MAAM,GAAG,KAAK,CAAC;gBACf,IAAI,CAAC,MAAM,EAAE,CAAC;gBACd,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC,CAAC;YACF,MAAM,QAAQ,GAAa;gBACzB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;oBAChB,IAAI,OAAO;wBAAE,OAAO;oBACpB,OAAO,GAAG,IAAI,CAAC;oBACf,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBAC9B,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,MAAM,CAAC,KAAK,CAAC,CAAC;gBAGhB,CAAC;gBACD,KAAK,EAAE,GAAG,EAAE;oBACV,MAAM,GAAG,IAAI,CAAC;oBACd,IAAI,CAAC,MAAM,EAAE,CAAC;oBACd,IAAI,CAAC;wBACH,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;4BACvC,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;gCACrB,WAAW,EAAE,CAAC;gCACd,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC;gCACnE,OAAO;4BACT,CAAC;4BACD,IAAI,OAAO,EAAE,CAAC;gCACZ,IAAI,CAAC;oCACH,OAAO,EAAE,CAAC;gCACZ,CAAC;wCAAS,CAAC;oCACT,WAAW,EAAE,CAAC;gCAChB,CAAC;gCACD,OAAO;4BACT,CAAC;4BACD,OAAO,GAAG,IAAI,CAAC;4BACf,YAAY,CAAC,KAAK,CAAC,CAAC;4BACpB,IAAI,QAAQ,GAAG,KAAK,CAAC;4BACrB,MAAM,CAAC,OAAO,GAAG,CAAC,OAAO,EAAE,EAAE;gCAC3B,IAAI,QAAQ;oCACV,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAC;gCACJ,QAAQ,GAAG,IAAI,CAAC;gCAChB,IAAI,CAAC;oCACH,OAAO,CAAC,OAAO,CAAC,CAAC;gCACnB,CAAC;wCAAS,CAAC;oCACT,WAAW,EAAE,CAAC;gCAChB,CAAC;4BACH,CAAC,CAAC;4BACF,OAAO,CAAC,MAAM,CAAC,CAAC;wBAClB,CAAC,CAAC,CAAC;oBACL,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,WAAW,EAAE,CAAC;wBACd,QAAQ,CAAC,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC7E,CAAC;gBACH,CAAC;aACF,CAAC;YACF,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC,EAC3E,IAAI,CAAC,OAAO,CAAC,uBAAuB,IAAI,IAAI,CAC7C,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;IAIQ,GAAG,CAAC,QAAqB;QAChC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;YAC5D,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,OAAO;gBACjC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IACtD,CAAC;CACF"}

package/dist/db/migrate.d.ts

@@ -0,0 +1,33 @@
+import { type ClientConfig } from "pg";
+export declare const CORE_MIGRATIONS_FOLDER: string;
+export declare const CORE_LEDGER_TABLE = "eve_core_schema_migrations";
+export type MigrationFile = {
+    id: string;
+    sql: string;
+    checksum: string;
+};
+export type RunMigrationsOptions = {
+    connectionString: string;
+    clientConfig?: Omit<ClientConfig, "connectionString">;
+    migrationsFolder?: string;
+    migrations?: {
+        id: string;
+        sql: string;
+    }[];
+    ledgerTable: string;
+    legacyLedger?: {
+        tableName: string;
+        checksums: Readonly<Record<string, string>>;
+    };
+    dryRun?: boolean;
+    log?: (line: string) => void;
+};
+export type RunMigrationsResult = {
+    applied: string[];
+    pending: string[];
+    alreadyApplied: number;
+};
+export declare function listMigrationFiles(folder: string): MigrationFile[];
+export declare function runMigrations(opts: RunMigrationsOptions): Promise<RunMigrationsResult>;
+export declare function runCoreMigrations(opts: Omit<RunMigrationsOptions, "migrationsFolder" | "ledgerTable">): Promise<RunMigrationsResult>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/db/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/db/migrate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,IAAI,CAAC;AA6B/C,eAAO,MAAM,sBAAsB,QAA2D,CAAC;AAC/F,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAI9D,MAAM,MAAM,aAAa,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,MAAM,MAAM,oBAAoB,GAAG;IACjC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;IAEtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAO1B,UAAU,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAE3C,WAAW,EAAE,MAAM,CAAC;IAGpB,YAAY,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;KAAE,CAAC;IAElF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAIF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAQlE;AAqCD,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqJ5F;AAGD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,CAAC,oBAAoB,EAAE,kBAAkB,GAAG,aAAa,CAAC,GACnE,OAAO,CAAC,mBAAmB,CAAC,CAM9B"}

package/dist/db/migrate.js

@@ -0,0 +1,183 @@
+import { createHash } from "node:crypto";
+import { readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Client } from "pg";
+export const CORE_MIGRATIONS_FOLDER = fileURLToPath(new URL("./migrations/", import.meta.url));
+export const CORE_LEDGER_TABLE = "eve_core_schema_migrations";
+const LEDGER_NAME = /^[a-z_][a-z0-9_]*$/;
+const checksumOf = (sql) => createHash("sha256").update(sql).digest("hex");
+export function listMigrationFiles(folder) {
+    return readdirSync(folder)
+        .filter((f) => f.endsWith(".sql"))
+        .sort()
+        .map((id) => {
+        const sql = readFileSync(join(folder, id), "utf8");
+        return { id, sql, checksum: checksumOf(sql) };
+    });
+}
+function lineageOf(opts) {
+    if (opts.migrations) {
+        const ids = new Set();
+        for (const m of opts.migrations) {
+            if (ids.has(m.id))
+                throw new Error(`[eve-core/db] duplicate migration id ${m.id}`);
+            ids.add(m.id);
+        }
+        return opts.migrations.map((m) => ({ ...m, checksum: checksumOf(m.sql) }));
+    }
+    if (opts.migrationsFolder)
+        return listMigrationFiles(opts.migrationsFolder);
+    throw new Error("[eve-core/db] runMigrations needs `migrationsFolder` or `migrations`");
+}
+async function protectLedger(client, ledgerTable) {
+    const grants = await client.query(`SELECT DISTINCT CASE WHEN a.grantee = 0 THEN 'PUBLIC'
+       ELSE quote_ident(r.rolname) END AS grantee
+     FROM pg_class c
+     CROSS JOIN LATERAL aclexplode(c.relacl) a
+     LEFT JOIN pg_roles r ON r.oid = a.grantee
+     WHERE c.oid = to_regclass($1) AND a.grantee <> c.relowner
+       AND a.privilege_type IN
+         ('INSERT', 'UPDATE', 'DELETE', 'TRUNCATE', 'REFERENCES', 'TRIGGER')`, [ledgerTable]);
+    for (const { grantee } of grants.rows) {
+        await client.query(`REVOKE INSERT, UPDATE, DELETE, TRUNCATE, REFERENCES, TRIGGER
+       ON TABLE ${ledgerTable} FROM ${grantee}`);
+    }
+}
+export async function runMigrations(opts) {
+    const { ledgerTable, dryRun = false, log = () => undefined } = opts;
+    if (!LEDGER_NAME.test(ledgerTable)) {
+        throw new Error(`[eve-core/db] ledger table name must match ${LEDGER_NAME}: ${ledgerTable}`);
+    }
+    if (opts.legacyLedger &&
+        (!LEDGER_NAME.test(opts.legacyLedger.tableName) || opts.legacyLedger.tableName === ledgerTable)) {
+        throw new Error("[eve-core/db] legacy ledger must be a distinct lower-snake identifier");
+    }
+    const files = lineageOf(opts);
+    const client = new Client({
+        connectionString: opts.connectionString,
+        connectionTimeoutMillis: 10_000,
+        ...opts.clientConfig,
+    });
+    await client.connect();
+    try {
+        await client.query("SET statement_timeout = 0");
+        await client.query("SET lock_timeout = '30s'");
+        await client.query("SELECT pg_advisory_lock(hashtext($1))", [ledgerTable]);
+        try {
+            let adopted;
+            if (opts.legacyLedger) {
+                const legacy = opts.legacyLedger;
+                const existing = await client.query("SELECT to_regclass($1) AS old_ledger, to_regclass($2) AS new_ledger", [
+                    legacy.tableName,
+                    ledgerTable,
+                ]);
+                if (existing.rows[0]?.old_ledger) {
+                    if (existing.rows[0].new_ledger)
+                        throw new Error("[eve-core/db] both legacy and current ledgers exist; reconcile their history before migrating");
+                    const history = await client.query(`SELECT id FROM ${legacy.tableName}`);
+                    const known = new Map(files.map((file) => [file.id, file.checksum]));
+                    adopted = history.rows.map(({ id }) => {
+                        const checksum = legacy.checksums[id];
+                        if (!checksum || known.get(id) !== checksum)
+                            throw new Error(`[eve-core/db] legacy migration ${id} is unknown or differs from its pinned history`);
+                        return { id, checksum };
+                    });
+                    if (!dryRun) {
+                        await client.query("BEGIN");
+                        try {
+                            await client.query(`ALTER TABLE ${legacy.tableName} RENAME TO ${ledgerTable}`);
+                            await client.query(`ALTER TABLE ${ledgerTable} ADD COLUMN checksum TEXT`);
+                            for (const row of adopted)
+                                await client.query(`UPDATE ${ledgerTable} SET checksum = $2 WHERE id = $1`, [
+                                    row.id,
+                                    row.checksum,
+                                ]);
+                            await client.query(`ALTER TABLE ${ledgerTable} ALTER COLUMN checksum SET NOT NULL`);
+                            await protectLedger(client, ledgerTable);
+                            await client.query("COMMIT");
+                        }
+                        catch (err) {
+                            await client.query("ROLLBACK");
+                            throw err;
+                        }
+                    }
+                }
+            }
+            if (!dryRun) {
+                await client.query("BEGIN");
+                try {
+                    await client.query(`CREATE TABLE IF NOT EXISTS ${ledgerTable} (
+           id TEXT PRIMARY KEY,
+           checksum TEXT NOT NULL,
+           applied_at TIMESTAMPTZ NOT NULL DEFAULT now()
+         )`);
+                    await protectLedger(client, ledgerTable);
+                    await client.query("COMMIT");
+                }
+                catch (err) {
+                    await client.query("ROLLBACK");
+                    throw err;
+                }
+            }
+            const exists = await client.query("SELECT to_regclass($1) AS name", [
+                ledgerTable,
+            ]);
+            const rows = adopted ??
+                (exists.rows[0]?.name
+                    ? (await client.query(`SELECT id, checksum FROM ${ledgerTable}`)).rows
+                    : []);
+            const recorded = new Map(rows.map((r) => [r.id, r.checksum]));
+            const pending = [];
+            for (const file of files) {
+                const seen = recorded.get(file.id);
+                if (seen === undefined) {
+                    pending.push(file);
+                }
+                else if (seen !== file.checksum) {
+                    throw new Error(`[eve-core/db] ${file.id} was applied with a different content (ledger ${ledgerTable}); migrations are append-only — add a new file`);
+                }
+            }
+            const result = {
+                applied: [],
+                pending: pending.map((f) => f.id),
+                alreadyApplied: files.length - pending.length,
+            };
+            if (dryRun)
+                return result;
+            for (const file of pending) {
+                try {
+                    await client.query("BEGIN");
+                    await client.query(file.sql);
+                    await client.query(`INSERT INTO ${ledgerTable} (id, checksum) VALUES ($1, $2)`, [
+                        file.id,
+                        file.checksum,
+                    ]);
+                    await client.query("COMMIT");
+                }
+                catch (err) {
+                    await client.query("ROLLBACK").catch(() => undefined);
+                    throw new Error(`[eve-core/db] migration ${file.id} failed: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+                }
+                result.applied.push(file.id);
+                log(`applied ${file.id}`);
+            }
+            return result;
+        }
+        finally {
+            await client.query("SELECT pg_advisory_unlock(hashtext($1))", [ledgerTable]).catch(() => {
+            });
+        }
+    }
+    finally {
+        await client.end().catch(() => undefined);
+    }
+}
+export function runCoreMigrations(opts) {
+    return runMigrations({
+        ...opts,
+        migrationsFolder: CORE_MIGRATIONS_FOLDER,
+        ledgerTable: CORE_LEDGER_TABLE,
+    });
+}
+//# sourceMappingURL=migrate.js.map

package/dist/db/migrate.js.map

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

package/dist/db/migrations/0000_core_ledgers.sql

@@ -0,0 +1,118 @@
+-- 0000_core_ledgers — HAND-EDITED after `drizzle-kit generate` (2026-09-09).
+--
+-- Every table here already exists on live DBs, created by the stores' old lazy
+-- `CREATE TABLE IF NOT EXISTS` on first use. This migration relocates their
+-- definitions into the schema without touching data, so it MUST be a no-op on a
+-- populated DB: every CREATE carries IF NOT EXISTS, and the columns that were
+-- added to pre-existing tables by later `ALTER TABLE ... ADD COLUMN IF NOT EXISTS`
+-- patches are re-asserted the same way before the indexes (CREATE TABLE IF NOT EXISTS
+-- skips silently on an existing table, so a DB created before those patches
+-- would otherwise keep the old column set). drizzle-kit's snapshot in meta/ is
+-- untouched — the drift gate compares journal entries, not SQL text.
+-- Migrations after this one are plain generated DDL: the lazy DDL is gone.
+
+CREATE TABLE IF NOT EXISTS "external_call_budget" (
+	"call_key" text PRIMARY KEY NOT NULL,
+	"provider" text NOT NULL,
+	"op" text,
+	"meta" jsonb,
+	"called_on" date DEFAULT current_date NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "token_usage" (
+	"id" bigserial PRIMARY KEY NOT NULL,
+	"session_id" text NOT NULL,
+	"root_id" text NOT NULL,
+	"flow" text,
+	"model" text NOT NULL,
+	"turn_id" text,
+	"step_index" integer,
+	"at" timestamp with time zone NOT NULL,
+	"input_tokens" integer DEFAULT 0 NOT NULL,
+	"output_tokens" integer DEFAULT 0 NOT NULL,
+	"cache_read_tokens" integer DEFAULT 0 NOT NULL,
+	"cache_write_tokens" integer DEFAULT 0 NOT NULL,
+	"instance" text DEFAULT 'eve' NOT NULL,
+	"scope" text
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "bugs" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"project" text NOT NULL,
+	"title" text NOT NULL,
+	"summary" text NOT NULL,
+	"affected_surface" text,
+	"repro_steps" text,
+	"severity" integer DEFAULT 3 NOT NULL,
+	"confidence" real DEFAULT 0.5 NOT NULL,
+	"reporter_ref" text,
+	"screenshot_file_ids" jsonb DEFAULT '[]'::jsonb NOT NULL,
+	"screenshot_urls" jsonb DEFAULT '[]'::jsonb NOT NULL,
+	"locale" text,
+	"status" text DEFAULT 'open' NOT NULL,
+	"session_id" text,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"fix_state" text,
+	"fix_pr_url" text
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "ui_documents" (
+	"id" text PRIMARY KEY NOT NULL,
+	"session_id" text NOT NULL,
+	"root_id" text NOT NULL,
+	"source" text,
+	"doc" jsonb NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "github_delivery_claims" (
+	"key" text PRIMARY KEY NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "notifications" (
+	"id" bigserial PRIMARY KEY NOT NULL,
+	"ts" timestamp with time zone DEFAULT now() NOT NULL,
+	"flow" text,
+	"title" text NOT NULL,
+	"body" text NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "telegram_dedup" (
+	"session_id" text NOT NULL,
+	"content_hash" text NOT NULL,
+	"delivered_at" timestamp with time zone DEFAULT now() NOT NULL,
+	CONSTRAINT "telegram_dedup_session_id_content_hash_pk" PRIMARY KEY("session_id","content_hash")
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "model_events" (
+	"id" bigserial PRIMARY KEY NOT NULL,
+	"at" timestamp with time zone NOT NULL,
+	"instance" text DEFAULT 'eve' NOT NULL,
+	"key" text,
+	"session_id" text,
+	"root_id" text,
+	"main" text,
+	"error_code" text,
+	"error" text NOT NULL,
+	"elapsed_ms" integer,
+	"outcome" text NOT NULL,
+	"leg_model" text
+);
+--> statement-breakpoint
+-- Re-asserted BEFORE the indexes: token_usage_instance_idx needs `instance`.
+ALTER TABLE "token_usage" ADD COLUMN IF NOT EXISTS "instance" text DEFAULT 'eve' NOT NULL;--> statement-breakpoint
+ALTER TABLE "token_usage" ADD COLUMN IF NOT EXISTS "scope" text;--> statement-breakpoint
+ALTER TABLE "bugs" ADD COLUMN IF NOT EXISTS "fix_state" text;--> statement-breakpoint
+ALTER TABLE "bugs" ADD COLUMN IF NOT EXISTS "fix_pr_url" text;--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "external_call_budget_provider_day_idx" ON "external_call_budget" USING btree ("provider","called_on");--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "token_usage_at_idx" ON "token_usage" USING btree ("at");--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "token_usage_root_idx" ON "token_usage" USING btree ("root_id");--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "token_usage_instance_idx" ON "token_usage" USING btree ("instance");--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "bugs_project_created_idx" ON "bugs" USING btree ("project","created_at" DESC NULLS LAST,"id" DESC NULLS LAST);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "bugs_project_status_created_idx" ON "bugs" USING btree ("project","status","created_at" DESC NULLS LAST,"id" DESC NULLS LAST);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "notifications_ts_idx" ON "notifications" USING btree ("ts" DESC NULLS LAST,"id" DESC NULLS LAST);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "model_events_at_idx" ON "model_events" USING btree ("at");--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "model_events_root_idx" ON "model_events" USING btree ("root_id");

package/dist/db/migrations/0001_memory.sql

@@ -0,0 +1,47 @@
+-- Adopt the six existing memory stores without replacing their tables or rows.
+CREATE TABLE IF NOT EXISTS "memory_dream_runs" (
+	"id" uuid PRIMARY KEY NOT NULL,
+	"kind" text DEFAULT 'nightly' NOT NULL,
+	"started_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"finished_at" timestamp with time zone,
+	"summary" text DEFAULT '' NOT NULL,
+	"scopes" jsonb DEFAULT '[]'::jsonb NOT NULL,
+	"ops" jsonb DEFAULT '[]'::jsonb NOT NULL,
+	"counts" jsonb DEFAULT '{}'::jsonb NOT NULL,
+	"error" text
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "memory_events" (
+	"id" uuid PRIMARY KEY NOT NULL,
+	"scope" text NOT NULL,
+	"kind" text NOT NULL,
+	"summary" text NOT NULL,
+	"payload" jsonb DEFAULT '{}'::jsonb NOT NULL,
+	"source_session" text,
+	"source_key" text,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"processed_at" timestamp with time zone
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "memory_rules" (
+	"id" uuid PRIMARY KEY NOT NULL,
+	"scope" text NOT NULL,
+	"layer" text DEFAULT 'domain' NOT NULL,
+	"rule" text NOT NULL,
+	"why" text,
+	"confidence" integer DEFAULT 50 NOT NULL,
+	"support" integer DEFAULT 1 NOT NULL,
+	"provenance" text DEFAULT 'dreamed' NOT NULL,
+	"pinned" boolean DEFAULT false NOT NULL,
+	"sources" jsonb DEFAULT '[]'::jsonb NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"last_reinforced_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"invalidated_at" timestamp with time zone,
+	"invalidated_by" uuid
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "memory_dream_runs_started_idx" ON "memory_dream_runs" USING btree ("started_at" DESC NULLS FIRST);--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS "memory_events_source_key_uniq" ON "memory_events" USING btree ("source_key") WHERE "memory_events"."source_key" IS NOT NULL;--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "memory_events_scope_idx" ON "memory_events" USING btree ("scope","created_at" DESC NULLS FIRST);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "memory_events_unprocessed_idx" ON "memory_events" USING btree ("created_at") WHERE "memory_events"."processed_at" IS NULL;--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "memory_rules_scope_idx" ON "memory_rules" USING btree ("scope","confidence" DESC NULLS FIRST) WHERE "memory_rules"."invalidated_at" IS NULL;

package/dist/db/migrations/0002_memory_search.sql

@@ -0,0 +1,21 @@
+-- Move legacy search indexes into the memory lineage. Trigram support is optional.
+CREATE INDEX IF NOT EXISTS "memory_rules_fts_idx" ON "memory_rules" USING gin (to_tsvector('simple', coalesce("rule",'') || ' ' || coalesce("why",'') || ' ' || coalesce("scope",'')));--> statement-breakpoint
+DO $$
+DECLARE extension_schema text;
+BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_extension WHERE extname = 'pg_trgm') THEN
+    IF EXISTS (SELECT 1 FROM pg_available_extensions WHERE name = 'pg_trgm') THEN
+      BEGIN
+        CREATE EXTENSION IF NOT EXISTS pg_trgm WITH SCHEMA public;
+      EXCEPTION WHEN insufficient_privilege THEN
+        RAISE NOTICE 'pg_trgm installation denied; search will use full-text and substring matching';
+      END;
+    END IF;
+  END IF;
+  SELECT n.nspname INTO extension_schema FROM pg_extension e
+    JOIN pg_namespace n ON n.oid = e.extnamespace
+    WHERE e.extname = 'pg_trgm' AND has_schema_privilege(n.oid, 'USAGE');
+  IF extension_schema IS NOT NULL THEN
+    EXECUTE format('CREATE INDEX IF NOT EXISTS "memory_rules_rule_trgm_idx" ON "memory_rules" USING gin ("rule" %I.gin_trgm_ops)', extension_schema);
+  END IF;
+END $$;

package/dist/db/migrations/0003_token_usage_account.sql

@@ -0,0 +1 @@
+ALTER TABLE "token_usage" ADD COLUMN "account" text;