agentenkit 0.1.0

package/dist/adapters/sqlite.js

@@ -0,0 +1,199 @@
+import { randomUUID } from 'node:crypto';
+/** Open a SQLite handle with whichever driver the process has: `bun:sqlite`
+ *  first, then `node:sqlite`. Preferring one and requiring it are different
+ *  things — a Next.js server runs on Node even inside a Bun workspace, which
+ *  is exactly where a bun-only store fails. Pass ':memory:' for a database
+ *  that lives only as long as the process.
+ *
+ *  Imported dynamically so neither driver enters the module graph until asked
+ *  for: importing this file is safe anywhere, only calling this needs one. */
+export async function openSqlite(filename = 'agentic-kit.sqlite') {
+    const tried = [];
+    for (const specifier of ['bun:sqlite', 'node:sqlite']) {
+        try {
+            // webpackIgnore keeps this a real runtime import. Bundlers otherwise
+            // turn a variable specifier into a context module and fail to resolve
+            // `node:sqlite` even on a Node that ships it — which is what happens
+            // inside a Next.js server build.
+            const mod = await import(/* webpackIgnore: true */ /* @vite-ignore */ specifier);
+            const Ctor = mod.Database ?? mod.DatabaseSync;
+            if (Ctor)
+                return new Ctor(filename);
+        }
+        catch (err) {
+            tried.push(`${specifier}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    throw new Error('No SQLite driver available. Run under Bun, or Node 22+ for node:sqlite, ' +
+        `or construct the store with your own handle. Tried — ${tried.join('; ')}`);
+}
+// SQLite has no date or JSON type: times are epoch milliseconds so they sort
+// and compare as integers, and structured columns are TEXT holding JSON.
+const json = (v) => (v === undefined ? null : JSON.stringify(v));
+const parse = (v) => (typeof v === 'string' ? JSON.parse(v) : v ?? null);
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS threads (
+  id TEXT PRIMARY KEY, title TEXT NOT NULL DEFAULT 'New Thread',
+  state TEXT NOT NULL DEFAULT 'IDLE', model TEXT NOT NULL DEFAULT 'gpt-4o',
+  createdAt INTEGER NOT NULL, updatedAt INTEGER NOT NULL
+);
+CREATE TABLE IF NOT EXISTS messages (
+  id TEXT PRIMARY KEY, threadId TEXT NOT NULL, agentId TEXT,
+  role TEXT NOT NULL, content TEXT NOT NULL, createdAt INTEGER NOT NULL,
+  seq INTEGER NOT NULL
+);
+CREATE INDEX IF NOT EXISTS messages_thread ON messages(threadId, seq);
+CREATE TABLE IF NOT EXISTS events (
+  id TEXT PRIMARY KEY, threadId TEXT NOT NULL, seq INTEGER NOT NULL,
+  type TEXT NOT NULL, payload TEXT, createdAt INTEGER NOT NULL
+);
+CREATE INDEX IF NOT EXISTS events_thread_seq ON events(threadId, seq);
+CREATE INDEX IF NOT EXISTS events_thread_type ON events(threadId, type, seq);
+CREATE TABLE IF NOT EXISTS usage (
+  id TEXT PRIMARY KEY, threadId TEXT NOT NULL, agentId TEXT,
+  inputTokens INTEGER NOT NULL, cachedInputTokens INTEGER NOT NULL,
+  outputTokens INTEGER NOT NULL, totalTokens INTEGER NOT NULL, createdAt INTEGER NOT NULL
+);
+CREATE INDEX IF NOT EXISTS usage_thread ON usage(threadId);
+CREATE TABLE IF NOT EXISTS runs (
+  id TEXT PRIMARY KEY, threadId TEXT NOT NULL, parentRunId TEXT,
+  depth INTEGER NOT NULL DEFAULT 0, agent TEXT NOT NULL, model TEXT NOT NULL,
+  state TEXT NOT NULL DEFAULT 'RUNNING', stopReason TEXT, error TEXT,
+  startedAt INTEGER NOT NULL, endedAt INTEGER, durationMs INTEGER, queuedMs INTEGER,
+  attempts INTEGER NOT NULL DEFAULT 0, steps INTEGER NOT NULL DEFAULT 0,
+  inputTokens INTEGER NOT NULL DEFAULT 0, cachedInputTokens INTEGER NOT NULL DEFAULT 0,
+  outputTokens INTEGER NOT NULL DEFAULT 0, totalTokens INTEGER NOT NULL DEFAULT 0,
+  result TEXT
+);
+CREATE INDEX IF NOT EXISTS runs_thread ON runs(threadId, startedAt);
+CREATE INDEX IF NOT EXISTS runs_state ON runs(state, startedAt);
+CREATE INDEX IF NOT EXISTS runs_parent ON runs(parentRunId);
+`;
+/** A complete Storage over SQLite (§3.2) — every table the platform needs,
+ *  created on construction. This is what `dev: true` wires up: a working
+ *  agent platform with no infrastructure to stand up first. */
+export class SqliteStorage {
+    db;
+    constructor(db) {
+        this.db = db;
+        for (const stmt of SCHEMA.split(';')) {
+            const sql = stmt.trim();
+            if (sql)
+                this.db.prepare(sql).run();
+        }
+    }
+    all(sql, ...p) {
+        return this.db.prepare(sql).all(...p);
+    }
+    one(sql, ...p) {
+        return this.db.prepare(sql).all(...p)[0] ?? null;
+    }
+    write(sql, ...p) {
+        this.db.prepare(sql).run(...p);
+    }
+    toThread = (r) => ({
+        id: r.id, state: r.state, model: r.model,
+        createdAt: new Date(r.createdAt), updatedAt: new Date(r.updatedAt),
+    });
+    toMessage = (r) => ({
+        id: r.id, threadId: r.threadId, agentId: r.agentId ?? null,
+        role: r.role, content: parse(r.content), createdAt: new Date(r.createdAt),
+    });
+    toEvent = (r) => ({
+        threadId: r.threadId, seq: r.seq, type: r.type,
+        payload: parse(r.payload), createdAt: new Date(r.createdAt),
+    });
+    threads = {
+        get: async (threadId) => {
+            const r = this.one('SELECT * FROM threads WHERE id = ?', threadId);
+            return r ? this.toThread(r) : null;
+        },
+        create: async (init) => {
+            const now = Date.now();
+            const id = randomUUID();
+            this.write('INSERT INTO threads (id,title,state,model,createdAt,updatedAt) VALUES (?,?,?,?,?,?)', id, 'New Thread', 'IDLE', init?.model ?? 'gpt-4o', now, now);
+            return this.toThread({
+                id, state: 'IDLE', model: init?.model ?? 'gpt-4o', createdAt: now, updatedAt: now,
+            });
+        },
+        list: async () => this.all('SELECT * FROM threads ORDER BY updatedAt DESC').map(this.toThread),
+        setState: async (threadId, state) => {
+            this.write('UPDATE threads SET state = ?, updatedAt = ? WHERE id = ?', state, Date.now(), threadId);
+        },
+        delete: async (threadId) => {
+            // No FK cascade here: the schema is created by this adapter and the
+            // cascade is spelled out, so a caller can read exactly what is removed.
+            for (const t of ['messages', 'events', 'usage', 'runs']) {
+                this.write(`DELETE FROM ${t} WHERE threadId = ?`, threadId);
+            }
+            this.write('DELETE FROM threads WHERE id = ?', threadId);
+        },
+        claimState: async (threadId, from, to) => {
+            // The §3.4 compare-and-set: one conditional UPDATE, so exactly one
+            // caller can win. SQLite serialises writers, which is enough.
+            const before = this.one('SELECT state FROM threads WHERE id = ?', threadId);
+            if (!before || before.state !== from)
+                return false;
+            this.write('UPDATE threads SET state = ?, updatedAt = ? WHERE id = ? AND state = ?', to, Date.now(), threadId, from);
+            const after = this.one('SELECT state FROM threads WHERE id = ?', threadId);
+            return after?.state === to;
+        },
+    };
+    messages = {
+        append: async (threadId, m) => {
+            const now = Date.now();
+            const id = randomUUID();
+            // An explicit seq keeps insertion order stable: several messages land
+            // inside the same millisecond, so createdAt alone cannot order them.
+            const seq = (this.one('SELECT COALESCE(MAX(seq),0) AS n FROM messages WHERE threadId = ?', threadId)?.n ?? 0) + 1;
+            this.write('INSERT INTO messages (id,threadId,agentId,role,content,createdAt,seq) VALUES (?,?,?,?,?,?,?)', id, threadId, m.agentId ?? null, m.role, json(m.content), now, seq);
+            return this.toMessage({
+                id, threadId, agentId: m.agentId ?? null, role: m.role,
+                content: json(m.content), createdAt: now,
+            });
+        },
+        list: async (threadId, opts) => {
+            if (opts && 'agentId' in opts) {
+                return this.all(opts.agentId === null
+                    ? 'SELECT * FROM messages WHERE threadId = ? AND agentId IS NULL ORDER BY seq'
+                    : 'SELECT * FROM messages WHERE threadId = ? AND agentId = ? ORDER BY seq', ...(opts.agentId === null ? [threadId] : [threadId, opts.agentId])).map(this.toMessage);
+            }
+            return this.all('SELECT * FROM messages WHERE threadId = ? ORDER BY seq', threadId)
+                .map(this.toMessage);
+        },
+        deleteFrom: async (threadId, messageId) => {
+            const target = this.one('SELECT seq FROM messages WHERE id = ? AND threadId = ?', messageId, threadId);
+            if (!target)
+                return 0;
+            const doomed = this.all('SELECT id FROM messages WHERE threadId = ? AND seq >= ?', threadId, target.seq);
+            this.write('DELETE FROM messages WHERE threadId = ? AND seq >= ?', threadId, target.seq);
+            return doomed.length;
+        },
+    };
+    events = {
+        append: async (threadId, e) => {
+            this.write('INSERT INTO events (id,threadId,seq,type,payload,createdAt) VALUES (?,?,?,?,?,?)', randomUUID(), threadId, e.seq, e.type, json(e.payload), new Date(e.createdAt).getTime());
+        },
+        listSince: async (threadId, sinceSeq) => this.all('SELECT * FROM events WHERE threadId = ? AND seq > ? ORDER BY seq', threadId, sinceSeq).map(this.toEvent),
+        latest: async (threadId, type) => {
+            const r = this.one('SELECT * FROM events WHERE threadId = ? AND type = ? ORDER BY seq DESC LIMIT 1', threadId, type);
+            return r ? this.toEvent(r) : null;
+        },
+        listByType: async (threadId, type) => this.all('SELECT * FROM events WHERE threadId = ? AND type = ? ORDER BY seq', threadId, type).map(this.toEvent),
+    };
+    usage = {
+        record: async (threadId, u) => {
+            this.write('INSERT INTO usage (id,threadId,agentId,inputTokens,cachedInputTokens,outputTokens,totalTokens,createdAt) VALUES (?,?,?,?,?,?,?,?)', randomUUID(), threadId, u.agentId ?? null, u.inputTokens, u.cachedInputTokens, u.outputTokens, u.totalTokens, Date.now());
+        },
+        total: async (threadId) => {
+            const r = this.one(`SELECT COALESCE(SUM(inputTokens),0) AS i, COALESCE(SUM(cachedInputTokens),0) AS c,
+                COALESCE(SUM(outputTokens),0) AS o, COALESCE(SUM(totalTokens),0) AS t
+         FROM usage WHERE threadId = ?`, threadId);
+            return {
+                inputTokens: r?.i ?? 0, cachedInputTokens: r?.c ?? 0,
+                outputTokens: r?.o ?? 0, totalTokens: r?.t ?? 0,
+            };
+        },
+    };
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/adapters/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../src/adapters/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAuBzC;;;;;;;8EAO8E;AAC9E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAQ,GAAG,oBAAoB;IAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,SAAS,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,qEAAqE;YACrE,sEAAsE;YACtE,qEAAqE;YACrE,iCAAiC;YACjC,MAAM,GAAG,GAAQ,MAAM,MAAM,CAAC,yBAAyB,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;YACtF,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,YAAY,CAAC;YAC9C,IAAI,IAAI;gBAAE,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAe,CAAC;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CACb,0EAA0E;QACxE,wDAAwD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7E,CAAC;AACJ,CAAC;AAGD,6EAA6E;AAC7E,yEAAyE;AACzE,MAAM,IAAI,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1E,MAAM,KAAK,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;AAElF,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCd,CAAC;AAEF;;+DAE+D;AAC/D,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,EAAc;QAAd,OAAE,GAAF,EAAE,CAAY;QACzC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACxB,IAAI,GAAG;gBAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QACtC,CAAC;IACH,CAAC;IAEO,GAAG,CAAC,GAAW,EAAE,GAAG,CAAY;QACtC,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAU,CAAC;IACjD,CAAC;IACO,GAAG,CAAC,GAAW,EAAE,GAAG,CAAY;QACtC,OAAQ,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAC9D,CAAC;IACO,KAAK,CAAC,GAAW,EAAE,GAAG,CAAY;QACxC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,CAAC;IAEO,QAAQ,GAAG,CAAC,CAAM,EAAa,EAAE,CAAC,CAAC;QACzC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAuB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK;QAC1D,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;KACnE,CAAC,CAAC;IACK,SAAS,GAAG,CAAC,CAAM,EAAc,EAAE,CAAC,CAAC;QAC3C,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;QAC1D,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;KAC1E,CAAC,CAAC;IACK,OAAO,GAAG,CAAC,CAAM,EAAc,EAAE,CAAC,CAAC;QACzC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;QAC9C,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;KAC5D,CAAe,CAAC;IACjB,OAAO,GAAG;QACR,GAAG,EAAE,KAAK,EAAE,QAAgB,EAAE,EAAE;YAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,oCAAoC,EAAE,QAAQ,CAAC,CAAC;YACnE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrC,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,IAAyB,EAAE,EAAE;YAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CACR,qFAAqF,EACrF,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,IAAI,QAAQ,EAAE,GAAG,EAAE,GAAG,CAC5D,CAAC;YACF,OAAO,IAAI,CAAC,QAAQ,CAAC;gBACnB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG;aAClF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,EAAE,KAAK,IAAI,EAAE,CACf,IAAI,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC9E,QAAQ,EAAE,KAAK,EAAE,QAAgB,EAAE,KAAqB,EAAE,EAAE;YAC1D,IAAI,CAAC,KAAK,CAAC,0DAA0D,EACnE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,QAAgB,EAAE,EAAE;YACjC,oEAAoE;YACpE,wEAAwE;YACxE,KAAK,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;gBACxD,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;YAC9D,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,kCAAkC,EAAE,QAAQ,CAAC,CAAC;QAC3D,CAAC;QACD,UAAU,EAAE,KAAK,EAAE,QAAgB,EAAE,IAAoB,EAAE,EAAkB,EAAE,EAAE;YAC/E,mEAAmE;YACnE,8DAA8D;YAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,wCAAwC,EAAE,QAAQ,CAAC,CAAC;YAC5E,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YACnD,IAAI,CAAC,KAAK,CAAC,wEAAwE,EACjF,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,wCAAwC,EAAE,QAAQ,CAAC,CAAC;YAC3E,OAAO,KAAK,EAAE,KAAK,KAAK,EAAE,CAAC;QAC7B,CAAC;KACF,CAAC;IAEF,QAAQ,GAAG;QACT,MAAM,EAAE,KAAK,EAAE,QAAgB,EAAE,CAAa,EAAE,EAAE;YAChD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;YACxB,sEAAsE;YACtE,qEAAqE;YACrE,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CACnB,mEAAmE,EAAE,QAAQ,CAC9E,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACf,IAAI,CAAC,KAAK,CACR,8FAA8F,EAC9F,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,CACnE,CAAC;YACF,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;gBACtD,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG;aACzC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,EAAE,KAAK,EAAE,QAAgB,EAAE,IAAkC,EAAE,EAAE;YACnE,IAAI,IAAI,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;gBAC9B,OAAO,IAAI,CAAC,GAAG,CACb,IAAI,CAAC,OAAO,KAAK,IAAI;oBACnB,CAAC,CAAC,4EAA4E;oBAC9E,CAAC,CAAC,wEAAwE,EAC5E,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CACnE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;YACD,OAAO,IAAI,CAAC,GAAG,CAAC,wDAAwD,EAAE,QAAQ,CAAC;iBAChF,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC;QACD,UAAU,EAAE,KAAK,EAAE,QAAgB,EAAE,SAAiB,EAAE,EAAE;YACxD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,wDAAwD,EAC9E,SAAS,EAAE,QAAQ,CAAC,CAAC;YACvB,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,CAAC;YACtB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,yDAAyD,EAC/E,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,sDAAsD,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;YACzF,OAAO,MAAM,CAAC,MAAM,CAAC;QACvB,CAAC;KACF,CAAC;IAEF,MAAM,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,QAAgB,EAAE,CAAa,EAAE,EAAE;YAChD,IAAI,CAAC,KAAK,CAAC,kFAAkF,EAC3F,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,SAAS,EAAE,KAAK,EAAE,QAAgB,EAAE,QAAgB,EAAE,EAAE,CACtD,IAAI,CAAC,GAAG,CAAC,kEAAkE,EACzE,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;QACzC,MAAM,EAAE,KAAK,EAAE,QAAgB,EAAE,IAAY,EAAE,EAAE;YAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAChB,gFAAgF,EAChF,QAAQ,EAAE,IAAI,CAAC,CAAC;YAClB,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpC,CAAC;QACD,UAAU,EAAE,KAAK,EAAE,QAAgB,EAAE,IAAY,EAAE,EAAE,CACnD,IAAI,CAAC,GAAG,CAAC,mEAAmE,EAC1E,QAAQ,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;KACtC,CAAC;IAEF,KAAK,GAAG;QACN,MAAM,EAAE,KAAK,EAAE,QAAgB,EAAE,CAAW,EAAE,EAAE;YAC9C,IAAI,CAAC,KAAK,CACR,mIAAmI,EACnI,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI,EACzC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,CAC9E,CAAC;QACJ,CAAC;QACD,KAAK,EAAE,KAAK,EAAE,QAAgB,EAAwB,EAAE;YACtD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAChB;;uCAE+B,EAAE,QAAQ,CAAC,CAAC;YAC7C,OAAO;gBACL,WAAW,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;gBACpD,YAAY,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;aAChD,CAAC;QACJ,CAAC;KACF,CAAC;CAIH"}

package/dist/adapters/upstash.d.ts

@@ -0,0 +1,48 @@
+import type { AgentEvent } from '../core/types.js';
+import type { Kv } from '../ports/kv.js';
+import type { EventBus } from '../ports/bus.js';
+/** Minimal structural type of the @upstash/redis client we use — the real
+ *  client satisfies it without importing the SDK here. */
+export interface UpstashRedisLike {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, opts?: {
+        ex?: number;
+        nx?: boolean;
+    }): Promise<unknown>;
+    del(...keys: string[]): Promise<unknown>;
+    incr(key: string): Promise<number>;
+    publish(channel: string, value: string): Promise<unknown>;
+}
+/** Reference Kv adapter over Upstash Redis. */
+export declare class UpstashKv implements Kv {
+    private readonly redis;
+    constructor(redis: UpstashRedisLike);
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, opts?: {
+        exSeconds?: number;
+        onlyIfNotExists?: boolean;
+    }): Promise<boolean>;
+    del(key: string): Promise<undefined>;
+    incr(key: string): Promise<number>;
+}
+/** Upstash Pub/Sub over REST requires a WebSocket-based subscriber; the Redis
+ *  REST client's `subscribe` differs per SDK version. Wire it in explicitly:
+ *
+ *    new UpstashBus(publisherRedis, {
+ *      subscribe: (threadId, handler) => {
+ *        // e.g. `redis.subscribe(channel, cb)` from a WS-enabled client
+ *      },
+ *    })
+ */
+export interface UpstashSubscriberLike {
+    subscribe(threadId: string, handler: (raw: string) => void): Promise<() => void>;
+}
+export declare const THREAD_CHANNEL: (threadId: string) => string;
+export declare class UpstashBus implements EventBus {
+    private readonly redis;
+    private readonly subscriber?;
+    constructor(redis: UpstashRedisLike, subscriber?: UpstashSubscriberLike | undefined);
+    publish(threadId: string, event: AgentEvent): Promise<void>;
+    subscribe(threadId: string, handler: (event: AgentEvent) => void): Promise<() => void>;
+}
+//# sourceMappingURL=upstash.d.ts.map

package/dist/adapters/upstash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstash.d.ts","sourceRoot":"","sources":["../../src/adapters/upstash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;0DAC0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxF,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3D;AAED,+CAA+C;AAC/C,qBAAa,SAAU,YAAW,EAAE;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,gBAAgB;IAEpD,GAAG,CAAC,GAAG,EAAE,MAAM;IACT,GAAG,CACP,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GACvD,OAAO,CAAC,OAAO,CAAC;IAanB,GAAG,CAAC,GAAG,EAAE,MAAM;IACf,IAAI,CAAC,GAAG,EAAE,MAAM;CACjB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;CAClF;AAED,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,WAAgC,CAAC;AAEhF,qBAAa,UAAW,YAAW,QAAQ;IAEvC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBADX,KAAK,EAAE,gBAAgB,EACvB,UAAU,CAAC,EAAE,qBAAqB,YAAA;IAG/C,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU;IAI3C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,iBAfK,IAAI;CA8BhF"}

package/dist/adapters/upstash.js

@@ -0,0 +1,46 @@
+/** Reference Kv adapter over Upstash Redis. */
+export class UpstashKv {
+    redis;
+    constructor(redis) {
+        this.redis = redis;
+    }
+    get(key) { return this.redis.get(key); }
+    async set(key, value, opts) {
+        const res = await this.redis.set(key, value, opts?.onlyIfNotExists
+            ? { nx: true, ex: opts.exSeconds }
+            : opts?.exSeconds
+                ? { ex: opts.exSeconds }
+                : undefined);
+        // SET NX returns null when the key exists
+        return opts?.onlyIfNotExists ? res === 'OK' : true;
+    }
+    del(key) { return this.redis.del(key).then(() => undefined); }
+    incr(key) { return this.redis.incr(key); }
+}
+export const THREAD_CHANNEL = (threadId) => `thread:${threadId}:events`;
+export class UpstashBus {
+    redis;
+    subscriber;
+    constructor(redis, subscriber) {
+        this.redis = redis;
+        this.subscriber = subscriber;
+    }
+    async publish(threadId, event) {
+        await this.redis.publish(THREAD_CHANNEL(threadId), JSON.stringify(event));
+    }
+    async subscribe(threadId, handler) {
+        if (!this.subscriber) {
+            throw new Error('UpstashBus requires a subscriber (WebSocket-based) for live tailing — ' +
+                'see the UpstashSubscriberLike docblock. Replay-only usage works without one.');
+        }
+        return this.subscriber.subscribe(threadId, (raw) => {
+            try {
+                handler(JSON.parse(raw));
+            }
+            catch {
+                // malformed frame — never kill the subscription
+            }
+        });
+    }
+}
+//# sourceMappingURL=upstash.js.map

package/dist/adapters/upstash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstash.js","sourceRoot":"","sources":["../../src/adapters/upstash.ts"],"names":[],"mappings":"AAcA,+CAA+C;AAC/C,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,KAAuB;QAAvB,UAAK,GAAL,KAAK,CAAkB;IAAG,CAAC;IAExD,GAAG,CAAC,GAAW,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChD,KAAK,CAAC,GAAG,CACP,GAAW,EACX,KAAa,EACb,IAAwD;QAExD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAC9B,GAAG,EACH,KAAK,EACL,IAAI,EAAE,eAAe;YACnB,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE;YAClC,CAAC,CAAC,IAAI,EAAE,SAAS;gBACf,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE;gBACxB,CAAC,CAAC,SAAS,CAChB,CAAC;QACF,0CAA0C;QAC1C,OAAO,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,CAAC;IACD,GAAG,CAAC,GAAW,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACtE,IAAI,CAAC,GAAW,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACnD;AAeD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,UAAU,QAAQ,SAAS,CAAC;AAEhF,MAAM,OAAO,UAAU;IAEF;IACA;IAFnB,YACmB,KAAuB,EACvB,UAAkC;QADlC,UAAK,GAAL,KAAK,CAAkB;QACvB,eAAU,GAAV,UAAU,CAAwB;IAClD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,KAAiB;QAC/C,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAgB,EAAE,OAAoC;QACpE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,wEAAwE;gBACtE,8EAA8E,CACjF,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;YACjD,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC,CAAC;YACzC,CAAC;YAAC,MAAM,CAAC;gBACP,gDAAgD;YAClD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/admin/default.d.ts

@@ -0,0 +1,15 @@
+import type { AdminStore } from '../ports/admin.js';
+/** Where the default store writes when no Postgres URL is set. */
+export declare const DEFAULT_ADMIN_DB = "agentic-kit-admin.sqlite";
+/** The store `setupAgentCore` uses when none is configured (§2.9).
+ *
+ *  `AGENTIC_KIT_ADMIN_DATABASE_URL` selects Postgres — point it at its own
+ *  database or the one you already have, the `agentic_` prefix keeps them
+ *  apart. Without it, SQLite on disk at `AGENTIC_KIT_ADMIN_DB`, with whichever
+ *  driver the process has.
+ *
+ *  Opened eagerly. A store that cannot be opened is a configuration problem
+ *  worth failing on at startup: degrading quietly would lose every run record,
+ *  and a dashboard showing nothing looks the same as no traffic. */
+export declare function openDefaultAdminStore(): Promise<AdminStore>;
+//# sourceMappingURL=default.d.ts.map

package/dist/admin/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../src/admin/default.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpD,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAE3D;;;;;;;;;oEASoE;AACpE,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,UAAU,CAAC,CAMjE"}

package/dist/admin/default.js

@@ -0,0 +1,22 @@
+import { openSqlite } from '../adapters/sqlite.js';
+import { SqliteAdminStore } from './sqlite.js';
+import { PostgresAdminStore, openPostgres } from './postgres.js';
+/** Where the default store writes when no Postgres URL is set. */
+export const DEFAULT_ADMIN_DB = 'agentic-kit-admin.sqlite';
+/** The store `setupAgentCore` uses when none is configured (§2.9).
+ *
+ *  `AGENTIC_KIT_ADMIN_DATABASE_URL` selects Postgres — point it at its own
+ *  database or the one you already have, the `agentic_` prefix keeps them
+ *  apart. Without it, SQLite on disk at `AGENTIC_KIT_ADMIN_DB`, with whichever
+ *  driver the process has.
+ *
+ *  Opened eagerly. A store that cannot be opened is a configuration problem
+ *  worth failing on at startup: degrading quietly would lose every run record,
+ *  and a dashboard showing nothing looks the same as no traffic. */
+export async function openDefaultAdminStore() {
+    const url = process.env.AGENTIC_KIT_ADMIN_DATABASE_URL;
+    if (url)
+        return PostgresAdminStore.connect(await openPostgres(url));
+    return new SqliteAdminStore(await openSqlite(process.env.AGENTIC_KIT_ADMIN_DB ?? DEFAULT_ADMIN_DB));
+}
+//# sourceMappingURL=default.js.map

package/dist/admin/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../src/admin/default.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEjE,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAE3D;;;;;;;;;oEASoE;AACpE,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC;IACvD,IAAI,GAAG;QAAE,OAAO,kBAAkB,CAAC,OAAO,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,OAAO,IAAI,gBAAgB,CACzB,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,gBAAgB,CAAC,CACvE,CAAC;AACJ,CAAC"}

package/dist/admin/memory.d.ts

@@ -0,0 +1,29 @@
+import type { ExecutionState, NewRunRecord, RunPatch, RunRecord } from '../core/types.js';
+import type { AdminStore, AdminThread, AdminThreadFilter, NewAdminThread, NewStepRecord, RunFilter, StepRecord } from '../ports/admin.js';
+/** Operational history held in memory — tests, and the default when nothing
+ *  durable is configured. Loses everything on restart, which is exactly what
+ *  the SQLite and Postgres stores exist to fix. */
+export declare class MemoryAdminStore implements AdminStore {
+    readonly runRows: Map<string, RunRecord>;
+    readonly stepRows: StepRecord[];
+    readonly threadRows: Map<string, AdminThread>;
+    threads: {
+        upsert: (t: NewAdminThread) => Promise<void>;
+        countByState: () => Promise<Partial<Record<ExecutionState, number>>>;
+        list: (f: AdminThreadFilter) => Promise<AdminThread[]>;
+    };
+    runs: {
+        start: (r: NewRunRecord) => Promise<RunRecord>;
+        patch: (runId: string, patch: RunPatch) => Promise<void>;
+        get: (runId: string) => Promise<RunRecord | null>;
+        listByThread: (threadId: string) => Promise<RunRecord[]>;
+        list: (f: RunFilter) => Promise<RunRecord[]>;
+        countByState: () => Promise<Partial<Record<ExecutionState, number>>>;
+    };
+    steps: {
+        record: (s: NewStepRecord) => Promise<void>;
+        listByRun: (runId: string) => Promise<StepRecord[]>;
+        listByThread: (threadId: string) => Promise<StepRecord[]>;
+    };
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/admin/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/admin/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,KAAK,EACV,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAC1D,aAAa,EAAE,SAAS,EAAE,UAAU,EACrC,MAAM,mBAAmB,CAAC;AAE3B;;mDAEmD;AACnD,qBAAa,gBAAiB,YAAW,UAAU;IACjD,QAAQ,CAAC,OAAO,yBAAgC;IAChD,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAM;IAErC,QAAQ,CAAC,UAAU,2BAAkC;IAErD,OAAO;oBACa,cAAc;;kBAUhB,iBAAiB;MAQjC;IAEF,IAAI;mBACe,YAAY;uBASR,MAAM,SAAS,QAAQ;qBAIzB,MAAM;iCACM,MAAM;kBAIrB,SAAS;;MAgBzB;IAEF,KAAK;oBACe,aAAa;2BAGN,MAAM;iCAEA,MAAM;MAIrC;CACH"}

package/dist/admin/memory.js

@@ -0,0 +1,83 @@
+/** Operational history held in memory — tests, and the default when nothing
+ *  durable is configured. Loses everything on restart, which is exactly what
+ *  the SQLite and Postgres stores exist to fix. */
+export class MemoryAdminStore {
+    runRows = new Map();
+    stepRows = [];
+    threadRows = new Map();
+    threads = {
+        upsert: async (t) => {
+            const now = new Date();
+            const prior = this.threadRows.get(t.id);
+            this.threadRows.set(t.id, { ...t, firstSeenAt: prior?.firstSeenAt ?? now, updatedAt: now });
+        },
+        countByState: async () => {
+            const out = {};
+            for (const t of this.threadRows.values())
+                out[t.state] = (out[t.state] ?? 0) + 1;
+            return out;
+        },
+        list: async (f) => {
+            let rows = [...this.threadRows.values()];
+            if (f.state?.length)
+                rows = rows.filter((t) => f.state.includes(t.state));
+            if (f.since)
+                rows = rows.filter((t) => t.updatedAt >= f.since);
+            return rows
+                .sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime())
+                .slice(0, f.limit ?? 100);
+        },
+    };
+    runs = {
+        start: async (r) => {
+            const rec = {
+                parentRunId: null, depth: 0, prompt: null, tokenBudget: null, runState: null, ...r,
+                state: 'RUNNING', startedAt: new Date(), steps: 0, attempts: 0,
+                inputTokens: 0, cachedInputTokens: 0, outputTokens: 0, totalTokens: 0,
+            };
+            this.runRows.set(rec.id, rec);
+            return rec;
+        },
+        patch: async (runId, patch) => {
+            const cur = this.runRows.get(runId);
+            if (cur)
+                this.runRows.set(runId, { ...cur, ...patch });
+        },
+        get: async (runId) => this.runRows.get(runId) ?? null,
+        listByThread: async (threadId) => [...this.runRows.values()]
+            .filter((r) => r.threadId === threadId)
+            .sort((a, b) => b.startedAt.getTime() - a.startedAt.getTime()),
+        list: async (f) => {
+            let rows = [...this.runRows.values()];
+            if (f.state?.length)
+                rows = rows.filter((r) => f.state.includes(r.state));
+            if (f.agent)
+                rows = rows.filter((r) => r.agent === f.agent);
+            if (f.threadId)
+                rows = rows.filter((r) => r.threadId === f.threadId);
+            if (f.since)
+                rows = rows.filter((r) => r.startedAt >= f.since);
+            if (f.until)
+                rows = rows.filter((r) => r.startedAt <= f.until);
+            return rows
+                .sort((a, b) => b.startedAt.getTime() - a.startedAt.getTime())
+                .slice(0, f.limit ?? 100);
+        },
+        countByState: async () => {
+            const out = {};
+            for (const r of this.runRows.values())
+                out[r.state] = (out[r.state] ?? 0) + 1;
+            return out;
+        },
+    };
+    steps = {
+        record: async (s) => {
+            this.stepRows.push({ ...s, at: s.at ?? new Date() });
+        },
+        listByRun: async (runId) => this.stepRows.filter((s) => s.runId === runId).sort((a, b) => a.index - b.index),
+        listByThread: async (threadId) => this.stepRows
+            .filter((s) => s.threadId === threadId)
+            .sort((a, b) => a.at.getTime() - b.at.getTime()),
+    };
+}
+//# sourceMappingURL=memory.js.map

package/dist/admin/memory.js.map

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

package/dist/admin/postgres.d.ts

@@ -0,0 +1,43 @@
+import type { ExecutionState, NewRunRecord, RunPatch, RunRecord } from '../core/types.js';
+import type { AdminStore, AdminThread, AdminThreadFilter, NewAdminThread, NewStepRecord, RunFilter, StepRecord } from '../ports/admin.js';
+/** Minimal structural type over a Postgres client. Both `pg`'s `Pool` and its
+ *  `Client` satisfy it, so the package never imports the driver (§3.4). */
+export interface PgLike {
+    query(text: string, params?: unknown[]): Promise<{
+        rows: any[];
+    }>;
+}
+/** Open a `pg` Pool from a connection string. Dynamically imported so the
+ *  driver only loads for callers who actually use Postgres, and marked
+ *  webpackIgnore so a bundler leaves it as a runtime import. */
+export declare function openPostgres(url: string): Promise<PgLike>;
+/** Operational history in Postgres — the production store (§2.9), reached
+ *  through AGENTIC_KIT_ADMIN_DATABASE_URL. Point it at its own database or the
+ *  one you already have; the prefix keeps them apart either way. */
+export declare class PostgresAdminStore implements AdminStore {
+    private readonly db;
+    private constructor();
+    /** Creates the tables if they are missing, then returns the store. A factory
+     *  rather than a constructor because that first step is asynchronous — and
+     *  `setupAgentCore` awaits its store precisely so this can fail at startup. */
+    static connect(db: PgLike): Promise<PostgresAdminStore>;
+    threads: {
+        upsert: (t: NewAdminThread) => Promise<void>;
+        countByState: () => Promise<Partial<Record<ExecutionState, number>>>;
+        list: (f: AdminThreadFilter) => Promise<AdminThread[]>;
+    };
+    runs: {
+        start: (run: NewRunRecord) => Promise<RunRecord>;
+        patch: (runId: string, patch: RunPatch) => Promise<void>;
+        get: (runId: string) => Promise<RunRecord | null>;
+        listByThread: (threadId: string) => Promise<RunRecord[]>;
+        list: (f: RunFilter) => Promise<RunRecord[]>;
+        countByState: () => Promise<Partial<Record<ExecutionState, number>>>;
+    };
+    steps: {
+        record: (s: NewStepRecord) => Promise<void>;
+        listByRun: (runId: string) => Promise<StepRecord[]>;
+        listByThread: (threadId: string) => Promise<StepRecord[]>;
+    };
+}
+//# sourceMappingURL=postgres.d.ts.map

package/dist/admin/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/admin/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,KAAK,EACV,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAC1D,aAAa,EAAE,SAAS,EAAE,UAAU,EACrC,MAAM,mBAAmB,CAAC;AAE3B;2EAC2E;AAC3E,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC,CAAC;CACnE;AAED;;gEAEgE;AAChE,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY/D;AA4DD;;oEAEoE;AACpE,qBAAa,kBAAmB,YAAW,UAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,EAAE;IAAvC,OAAO;IAEP;;mFAE+E;WAClE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAK7D,OAAO;oBACa,cAAc;;kBAgBhB,iBAAiB,KAAG,OAAO,CAAC,WAAW,EAAE,CAAC;MAiB1D;IAEF,IAAI;qBACiB,YAAY;uBAcV,MAAM,SAAS,QAAQ;qBAczB,MAAM;iCAIM,MAAM;kBAOrB,SAAS;;MAuBzB;IAEF,KAAK;oBACe,aAAa;2BAgBN,MAAM,KAAG,OAAO,CAAC,UAAU,EAAE,CAAC;iCAOxB,MAAM,KAAG,OAAO,CAAC,UAAU,EAAE,CAAC;MAO7D;CACH"}