agentenkit 0.1.0

package/dist/adapters/prisma.d.ts

@@ -0,0 +1,176 @@
+import type { AgentEvent, ExecutionState, NewMessage, NewUsage, ThreadDTO, UsageTotals } from '../core/types.js';
+import type { Storage } from '../ports/storage.js';
+/** Minimal structural type of the Prisma client surface we use. The real
+ *  `PrismaClient` satisfies it — no SDK import needed in the package. */
+export interface PrismaLike {
+    thread: {
+        findUnique(a: {
+            where: {
+                id: string;
+            };
+        }): Promise<(Omit<ThreadDTO, 'createdAt' | 'updatedAt'> & {
+            createdAt: Date;
+            updatedAt: Date;
+        }) | null>;
+        findMany(a: {
+            orderBy: {
+                updatedAt: 'desc';
+            };
+        }): Promise<ThreadDTO[]>;
+        create(a: {
+            data: {
+                model?: string;
+            };
+        }): Promise<ThreadDTO>;
+        update(a: {
+            where: {
+                id: string;
+            };
+            data: {
+                state: ExecutionState;
+            };
+        }): Promise<unknown>;
+        updateMany(a: {
+            where: {
+                id: string;
+                state: ExecutionState;
+            };
+            data: {
+                state: ExecutionState;
+            };
+        }): Promise<{
+            count: number;
+        }>;
+        delete(a: {
+            where: {
+                id: string;
+            };
+        }): Promise<unknown>;
+        groupBy(a: {
+            by: ['state'];
+            _count: {
+                _all: true;
+            };
+        }): Promise<Array<{
+            state: ExecutionState;
+            _count: {
+                _all: number;
+            };
+        }>>;
+    };
+    message: {
+        create(a: {
+            data: {
+                threadId: string;
+                agentId?: string | null;
+                role: string;
+                content: any;
+            };
+        }): Promise<any>;
+        findMany(a: {
+            where: {
+                threadId: string;
+                agentId?: string | null;
+            };
+            orderBy: {
+                createdAt: 'asc';
+            };
+        }): Promise<any[]>;
+        deleteMany(a: {
+            where: {
+                id: {
+                    in: string[];
+                };
+            };
+        }): Promise<{
+            count: number;
+        }>;
+    };
+    agentEvent: {
+        create(a: {
+            data: {
+                threadId: string;
+                seq: number;
+                type: string;
+                payload: any;
+            };
+        }): Promise<unknown>;
+        findMany(a: {
+            where: {
+                threadId: string;
+                seq?: {
+                    gt: number;
+                };
+                type?: string;
+            };
+            orderBy: {
+                seq: 'asc';
+            };
+        }): Promise<AgentEvent[]>;
+        findFirst(a: {
+            where: {
+                threadId: string;
+                type: string;
+            };
+            orderBy: {
+                seq: 'desc';
+            };
+        }): Promise<AgentEvent | null>;
+    };
+    tokenUsage: {
+        create(a: {
+            data: NewUsage & {
+                threadId: string;
+            };
+        }): Promise<unknown>;
+        aggregate(a: {
+            where: {
+                threadId: string;
+            };
+            _sum: {
+                inputTokens: true;
+                cachedInputTokens: true;
+                outputTokens: true;
+                totalTokens: true;
+            };
+        }): Promise<{
+            _sum: Partial<Record<keyof UsageTotals, number | null>>;
+        }>;
+    };
+}
+/** Reference Storage adapter over PostgreSQL/Prisma (schema in the README / spec §2.4). */
+export declare class PrismaStorage implements Storage {
+    private readonly prisma;
+    constructor(prisma: PrismaLike);
+    threads: {
+        get: (threadId: string) => Promise<(Omit<ThreadDTO, "updatedAt" | "createdAt"> & {
+            createdAt: Date;
+            updatedAt: Date;
+        }) | null>;
+        create: (init?: {
+            model?: string;
+        }) => Promise<ThreadDTO>;
+        list: () => Promise<ThreadDTO[]>;
+        setState: (threadId: string, state: ExecutionState) => Promise<void>;
+        claimState: (threadId: string, from: ExecutionState, to: ExecutionState) => Promise<boolean>;
+        delete: (threadId: string) => Promise<undefined>;
+    };
+    messages: {
+        append: (threadId: string, m: NewMessage) => Promise<any>;
+        list: (threadId: string, opts?: {
+            agentId?: string | null;
+        }) => Promise<any[]>;
+        deleteFrom: (threadId: string, messageId: string) => Promise<number>;
+    };
+    events: {
+        append: (threadId: string, event: AgentEvent) => Promise<void>;
+        listSince: (threadId: string, sinceSeq: number) => Promise<AgentEvent[]>;
+        latest: (threadId: string, type: string) => Promise<AgentEvent | null>;
+        listByType: (threadId: string, type: string) => Promise<AgentEvent[]>;
+    };
+    usage: {
+        total: (threadId: string) => Promise<UsageTotals>;
+        record: (threadId: string, usage: NewUsage) => Promise<void>;
+    };
+}
+//# sourceMappingURL=prisma.d.ts.map

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

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

package/dist/adapters/prisma.js

@@ -0,0 +1,107 @@
+/** Reference Storage adapter over PostgreSQL/Prisma (schema in the README / spec §2.4). */
+export class PrismaStorage {
+    prisma;
+    constructor(prisma) {
+        this.prisma = prisma;
+    }
+    threads = {
+        get: (threadId) => this.prisma.thread.findUnique({ where: { id: threadId } }),
+        create: (init) => this.prisma.thread.create({ data: { model: init?.model } }),
+        list: () => this.prisma.thread.findMany({ orderBy: { updatedAt: 'desc' } }),
+        setState: async (threadId, state) => {
+            await this.prisma.thread.update({ where: { id: threadId }, data: { state } });
+        },
+        claimState: async (threadId, from, to) => {
+            // Single conditional UPDATE — the atomicity contract (§3.4)
+            const res = await this.prisma.thread.updateMany({
+                where: { id: threadId, state: from },
+                data: { state: to },
+            });
+            return res.count > 0;
+        },
+        delete: (threadId) => 
+        // One delete — the reference schema cascades to Message, AgentEvent,
+        // TokenUsage and SubagentRun via `onDelete: Cascade` (spec §2.4)
+        this.prisma.thread.delete({ where: { id: threadId } }).then(() => undefined),
+    };
+    messages = {
+        append: (threadId, m) => this.prisma.message.create({
+            data: { threadId, agentId: m.agentId ?? null, role: m.role, content: m.content },
+        }),
+        list: (threadId, opts) => this.prisma.message.findMany({
+            // `agentId: null` is a real filter (IS NULL), not an absent one — the
+            // scope is only dropped when the caller omits it entirely.
+            where: {
+                threadId,
+                ...(opts && 'agentId' in opts ? { agentId: opts.agentId } : {}),
+            },
+            orderBy: { createdAt: 'asc' },
+        }),
+        deleteFrom: async (threadId, messageId) => {
+            // Delete by id over the same ordering `list` uses, rather than a
+            // `createdAt >=` range: a run appends several messages inside one
+            // millisecond, and a range would take neighbours with it.
+            const rows = await this.prisma.message.findMany({
+                where: { threadId },
+                orderBy: { createdAt: 'asc' },
+            });
+            const from = rows.findIndex((m) => m.id === messageId);
+            if (from === -1)
+                return 0;
+            const { count } = await this.prisma.message.deleteMany({
+                where: { id: { in: rows.slice(from).map((m) => m.id) } },
+            });
+            return count;
+        },
+    };
+    events = {
+        append: async (threadId, event) => {
+            await this.prisma.agentEvent.create({
+                data: { threadId, seq: event.seq, type: event.type, payload: event.payload },
+            });
+        },
+        listSince: (threadId, sinceSeq) => this.prisma.agentEvent.findMany({
+            where: { threadId, seq: { gt: sinceSeq } },
+            orderBy: { seq: 'asc' },
+        }),
+        latest: (threadId, type) => this.prisma.agentEvent.findFirst({
+            where: { threadId, type },
+            orderBy: { seq: 'desc' },
+        }),
+        listByType: (threadId, type) => this.prisma.agentEvent.findMany({ where: { threadId, type }, orderBy: { seq: 'asc' } }),
+    };
+    usage = {
+        total: async (threadId) => {
+            // One aggregate rather than reading every row: a long thread can hold a
+            // usage row per run segment (§4).
+            const { _sum } = await this.prisma.tokenUsage.aggregate({
+                where: { threadId },
+                _sum: {
+                    inputTokens: true,
+                    cachedInputTokens: true,
+                    outputTokens: true,
+                    totalTokens: true,
+                },
+            });
+            return {
+                inputTokens: _sum.inputTokens ?? 0,
+                cachedInputTokens: _sum.cachedInputTokens ?? 0,
+                outputTokens: _sum.outputTokens ?? 0,
+                totalTokens: _sum.totalTokens ?? 0,
+            };
+        },
+        record: async (threadId, usage) => {
+            await this.prisma.tokenUsage.create({
+                data: {
+                    threadId,
+                    agentId: usage.agentId ?? null,
+                    inputTokens: usage.inputTokens,
+                    cachedInputTokens: usage.cachedInputTokens,
+                    outputTokens: usage.outputTokens,
+                    totalTokens: usage.totalTokens,
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=prisma.js.map

package/dist/adapters/prisma.js.map

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

package/dist/adapters/qstash.d.ts

@@ -0,0 +1,36 @@
+import type { EnqueueOptions, Queue } from '../ports/queue.js';
+import type { RunJob } from '../core/types.js';
+/** Minimal structural type of the @upstash/qstash (v2) client we use. */
+export interface QStashLike {
+    queue(a: {
+        queueName: string;
+    }): {
+        enqueueJSON(a: {
+            url: string;
+            body: unknown;
+        }): Promise<unknown>;
+    };
+    /** `delay` is in seconds. QStash supports it on publish only — an enqueue
+     *  carrying Upstash-Delay is REJECTED outright ("Upstash-Not-Before/
+     *  Upstash-Delay can not be used with enqueue"), so a delayed dispatch has
+     *  to be published instead. */
+    publishJSON(a: {
+        url: string;
+        body: unknown;
+        delay?: number;
+    }): Promise<unknown>;
+}
+export interface QStashQueueOptions {
+    /** Fully-qualified consumer URL, e.g. https://app.example.com/api/queue/agent-run */
+    url: string;
+    /** Queue name for flow control (§2.8). Defaults to `agent-runs`. */
+    queueName?: string;
+}
+/** Reference Queue adapter over Upstash QStash HTTP queues. */
+export declare class QStashQueue implements Queue {
+    private readonly client;
+    private readonly opts;
+    constructor(client: QStashLike, opts: QStashQueueOptions);
+    enqueue(job: RunJob, opts?: EnqueueOptions): Promise<void>;
+}
+//# sourceMappingURL=qstash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qstash.d.ts","sourceRoot":"","sources":["../../src/adapters/qstash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG;QAC/B,WAAW,CAAC,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,OAAO,CAAA;SAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KAClE,CAAC;IACF;;;mCAG+B;IAC/B,WAAW,CAAC,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,kBAAkB;IACjC,qFAAqF;IACrF,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,+DAA+D;AAC/D,qBAAa,WAAY,YAAW,KAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAc,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAzC,MAAM,EAAE,UAAU,EAAmB,IAAI,EAAE,kBAAkB;IAE1F,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAiB3D"}

package/dist/adapters/qstash.js

@@ -0,0 +1,26 @@
+/** Reference Queue adapter over Upstash QStash HTTP queues. */
+export class QStashQueue {
+    client;
+    opts;
+    constructor(client, opts) {
+        this.client = client;
+        this.opts = opts;
+    }
+    enqueue(job, opts) {
+        // A delayed job goes out as a published message rather than a queued one:
+        // QStash rejects Upstash-Delay on enqueue. The trade is that this one
+        // message skips the queue's flow control — acceptable for the two things
+        // that ask for a delay (a HITL expiry and a blocked job's redrive), since
+        // both are single messages the run lock already serializes.
+        if (opts?.delaySeconds) {
+            return this.client
+                .publishJSON({ url: this.opts.url, body: job, delay: opts.delaySeconds })
+                .then(() => undefined);
+        }
+        return this.client
+            .queue({ queueName: this.opts.queueName ?? 'agent-runs' })
+            .enqueueJSON({ url: this.opts.url, body: job })
+            .then(() => undefined);
+    }
+}
+//# sourceMappingURL=qstash.js.map

package/dist/adapters/qstash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qstash.js","sourceRoot":"","sources":["../../src/adapters/qstash.ts"],"names":[],"mappings":"AAsBA,+DAA+D;AAC/D,MAAM,OAAO,WAAW;IACO;IAAqC;IAAlE,YAA6B,MAAkB,EAAmB,IAAwB;QAA7D,WAAM,GAAN,MAAM,CAAY;QAAmB,SAAI,GAAJ,IAAI,CAAoB;IAAG,CAAC;IAE9F,OAAO,CAAC,GAAW,EAAE,IAAqB;QACxC,0EAA0E;QAC1E,sEAAsE;QACtE,yEAAyE;QACzE,0EAA0E;QAC1E,4DAA4D;QAC5D,IAAI,IAAI,EAAE,YAAY,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,MAAM;iBACf,WAAW,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;iBACxE,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO,IAAI,CAAC,MAAM;aACf,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,YAAY,EAAE,CAAC;aACzD,WAAW,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;aAC9C,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;CACF"}

package/dist/adapters/redis.d.ts

@@ -0,0 +1,49 @@
+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 a node-redis (v4) client — the real client
+ *  satisfies it without importing the SDK here. Works against any Redis:
+ *  local Docker, self-hosted, or managed. */
+export interface RedisClientLike {
+    connect(): Promise<unknown>;
+    get: any;
+    set: any;
+    del: any;
+    incr: any;
+    publish: any;
+    duplicate(): any;
+}
+/** A dedicated connection for subscriptions (node-redis `client.duplicate()`). */
+export interface RedisSubscriberLike {
+    connect(): Promise<unknown>;
+    subscribe: any;
+    unsubscribe: any;
+    quit: any;
+    on: any;
+}
+/** Reference Kv adapter over plain Redis (node-redis). */
+export declare class RedisKv implements Kv {
+    private readonly redis;
+    constructor(redis: RedisClientLike);
+    get(key: string): any;
+    set(key: string, value: string, opts?: {
+        exSeconds?: number;
+        onlyIfNotExists?: boolean;
+    }): Promise<boolean>;
+    del(key: string): any;
+    incr(key: string): any;
+}
+/** Reference EventBus adapter over plain Redis Pub/Sub (node-redis).
+ *
+ *  While subscribed, emits a bus-only `HEARTBEAT` notice (seq 0, never
+ *  persisted) every heartbeatMs — the §2.5 watchdog pattern: pub/sub is
+ *  at-most-once, so the SSE distributor treats heartbeats as a trigger to
+ *  re-check for orphaned HITL waits. */
+export declare class RedisBus implements EventBus {
+    private readonly client;
+    private readonly heartbeatMs;
+    constructor(client: RedisClientLike, heartbeatMs?: number);
+    publish(threadId: string, event: AgentEvent): Promise<void>;
+    subscribe(threadId: string, handler: (event: AgentEvent) => void): Promise<() => Promise<void>>;
+}
+//# sourceMappingURL=redis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/adapters/redis.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;AAGhD;;6CAE6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAG5B,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,EAAE,GAAG,CAAC;IACb,SAAS,IAAI,GAAG,CAAC;CAClB;AAED,kFAAkF;AAClF,MAAM,WAAW,mBAAmB;IAClC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,SAAS,EAAE,GAAG,CAAC;IACf,WAAW,EAAE,GAAG,CAAC;IACjB,IAAI,EAAE,GAAG,CAAC;IACV,EAAE,EAAE,GAAG,CAAC;CACT;AAED,0DAA0D;AAC1D,qBAAa,OAAQ,YAAW,EAAE;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAEnD,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;;;;;wCAKwC;AACxC,qBAAa,QAAS,YAAW,QAAQ;IAErC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,MAAM,EAAE,eAAe,EACvB,WAAW,SAAS;IAGjC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU;IAI3C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI;CAuBvE"}

package/dist/adapters/redis.js

@@ -0,0 +1,60 @@
+import { THREAD_CHANNEL } from './upstash.js';
+/** Reference Kv adapter over plain Redis (node-redis). */
+export class RedisKv {
+    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 'OK' on success, 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); }
+}
+/** Reference EventBus adapter over plain Redis Pub/Sub (node-redis).
+ *
+ *  While subscribed, emits a bus-only `HEARTBEAT` notice (seq 0, never
+ *  persisted) every heartbeatMs — the §2.5 watchdog pattern: pub/sub is
+ *  at-most-once, so the SSE distributor treats heartbeats as a trigger to
+ *  re-check for orphaned HITL waits. */
+export class RedisBus {
+    client;
+    heartbeatMs;
+    constructor(client, heartbeatMs = 60_000) {
+        this.client = client;
+        this.heartbeatMs = heartbeatMs;
+    }
+    async publish(threadId, event) {
+        await this.client.publish(THREAD_CHANNEL(threadId), JSON.stringify(event));
+    }
+    async subscribe(threadId, handler) {
+        const sub = this.client.duplicate();
+        await sub.connect();
+        await sub.subscribe(THREAD_CHANNEL(threadId), (message) => {
+            try {
+                handler(JSON.parse(message));
+            }
+            catch {
+                // malformed frame — never kill the subscription
+            }
+        });
+        const heartbeat = setInterval(() => {
+            handler({
+                threadId, seq: 0, type: 'HEARTBEAT', payload: null, createdAt: new Date(),
+            });
+        }, this.heartbeatMs);
+        return async () => {
+            clearInterval(heartbeat);
+            await sub.unsubscribe(THREAD_CHANNEL(threadId)).catch(() => undefined);
+            await sub.quit().catch(() => undefined);
+        };
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/adapters/redis.js.map

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

package/dist/adapters/sqlite.d.ts

@@ -0,0 +1,67 @@
+import type { AgentEvent, ExecutionState, MessageDTO, NewMessage, NewUsage, ThreadDTO, UsageTotals } from '../core/types.js';
+import type { Storage } from '../ports/storage.js';
+/** Minimal structural type over a synchronous SQLite handle — `bun:sqlite`'s
+ *  `Database` satisfies it. Kept structural for the same reason every other
+ *  adapter is: the package never imports a driver itself (§3.4), so a caller
+ *  can hand in their own handle (an in-memory one for tests, a tuned one for
+ *  production). */
+export interface SqliteLike {
+    prepare(sql: string): SqliteStatementLike;
+    exec?(sql: string): unknown;
+    run?(sql: string): unknown;
+}
+export interface SqliteStatementLike {
+    all(...params: unknown[]): unknown[];
+    get?(...params: unknown[]): unknown;
+    run(...params: unknown[]): unknown;
+}
+/** 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 declare function openSqlite(filename?: string): Promise<SqliteLike>;
+/** 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 declare class SqliteStorage implements Storage {
+    private readonly db;
+    constructor(db: SqliteLike);
+    private all;
+    private one;
+    private write;
+    private toThread;
+    private toMessage;
+    private toEvent;
+    threads: {
+        get: (threadId: string) => Promise<ThreadDTO | null>;
+        create: (init?: {
+            model?: string;
+        }) => Promise<ThreadDTO>;
+        list: () => Promise<ThreadDTO[]>;
+        setState: (threadId: string, state: ExecutionState) => Promise<void>;
+        delete: (threadId: string) => Promise<void>;
+        claimState: (threadId: string, from: ExecutionState, to: ExecutionState) => Promise<boolean>;
+    };
+    messages: {
+        append: (threadId: string, m: NewMessage) => Promise<MessageDTO>;
+        list: (threadId: string, opts?: {
+            agentId?: string | null;
+        }) => Promise<MessageDTO[]>;
+        deleteFrom: (threadId: string, messageId: string) => Promise<number>;
+    };
+    events: {
+        append: (threadId: string, e: AgentEvent) => Promise<void>;
+        listSince: (threadId: string, sinceSeq: number) => Promise<AgentEvent[]>;
+        latest: (threadId: string, type: string) => Promise<AgentEvent | null>;
+        listByType: (threadId: string, type: string) => Promise<AgentEvent[]>;
+    };
+    usage: {
+        record: (threadId: string, u: NewUsage) => Promise<void>;
+        total: (threadId: string) => Promise<UsageTotals>;
+    };
+}
+//# sourceMappingURL=sqlite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/adapters/sqlite.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EACrF,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;mBAImB;AACnB,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAC1C,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;IACrC,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACpC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;CACpC;AAED;;;;;;;8EAO8E;AAC9E,wBAAsB,UAAU,CAAC,QAAQ,SAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,CAmBrF;AA+CD;;+DAE+D;AAC/D,qBAAa,aAAc,YAAW,OAAO;IAC/B,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,UAAU;IAO3C,OAAO,CAAC,GAAG;IAGX,OAAO,CAAC,GAAG;IAGX,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,QAAQ,CAGb;IACH,OAAO,CAAC,SAAS,CAGd;IACH,OAAO,CAAC,OAAO,CAGE;IACjB,OAAO;wBACiB,MAAM;wBAIN;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE;;6BAab,MAAM,SAAS,cAAc;2BAI/B,MAAM;+BAQF,MAAM,QAAQ,cAAc,MAAM,cAAc;MAU7E;IAEF,QAAQ;2BACmB,MAAM,KAAK,UAAU;yBAiBvB,MAAM,SAAS;YAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE;+BAYpC,MAAM,aAAa,MAAM;MAStD;IAEF,MAAM;2BACqB,MAAM,KAAK,UAAU;8BAIlB,MAAM,YAAY,MAAM;2BAG3B,MAAM,QAAQ,MAAM;+BAMhB,MAAM,QAAQ,MAAM;MAGjD;IAEF,KAAK;2BACsB,MAAM,KAAK,QAAQ;0BAOpB,MAAM,KAAG,OAAO,CAAC,WAAW,CAAC;MAUrD;CAIH"}