agentenkit 0.3.0 → 0.5.0

package/dist/adapters/sqlite.d.ts

@@ -1,5 +1,8 @@
-import type { AgentEvent, ExecutionState, MessageDTO, NewMessage, NewUsage, ThreadDTO, UsageFilter, UsageTotals } from '../core/types.js';
+import type { AgentEvent, ExecutionState, MessageDTO, NewMessage, NewThreadEvent, NewUsage, ThreadDTO, ThreadEventFilter, UsageFilter, UsageTotals, ThreadTransition } from '../core/types.js';
 import type { Storage } from '../ports/storage.js';
+import type { Kv } from '../ports/kv.js';
+import { type RunStreams, type StreamMeta, type StreamSnapshot } from '../ports/streams.js';
+import { type StreamEnd, type StreamEvent, type StreamItem } from '../core/stream-events.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
@@ -24,12 +27,30 @@ export interface SqliteStatementLike {
  *  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>;
+/** Set a file up for more than one process (§3.4): WAL lets readers run beside
+ *  the one writer, and busy_timeout makes a writer wait up to five seconds for
+ *  the lock rather than fail at once with SQLITE_BUSY. `openSqlite` calls it;
+ *  call it yourself on a handle you opened some other way. An in-memory
+ *  database keeps its own journal mode, which is fine.
+ *
+ *  busy_timeout goes FIRST: switching a new file to WAL takes a lock too.
+ *  And SQLite does not always wait on the busy timeout for that switch: with
+ *  several processes opening one fresh file at once (the workers of a
+ *  `next build`) it can give up at once with "database is locked". So the
+ *  switch is tried again for up to five seconds, like any other write. The
+ *  Go runtime's Tune does the same. */
+export declare function tuneSqlite<T extends SqliteLike>(db: T): T;
 /** 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);
+    /** Run `fn` in one write transaction. IMMEDIATE takes the write lock up
+     *  front, so another process waits (busy_timeout) rather than failing half
+     *  way through. */
+    private tx;
+    private changes;
     private addMissing;
     private all;
     private one;
@@ -45,6 +66,7 @@ export declare class SqliteStorage implements Storage {
         list: () => Promise<ThreadDTO[]>;
         setState: (threadId: string, state: ExecutionState) => Promise<void>;
         delete: (threadId: string) => Promise<void>;
+        transition: (threadId: string, tr: ThreadTransition) => Promise<boolean>;
         claimState: (threadId: string, from: ExecutionState, to: ExecutionState) => Promise<boolean>;
     };
     messages: {
@@ -55,14 +77,78 @@ export declare class SqliteStorage implements Storage {
         deleteFrom: (threadId: string, messageId: string) => Promise<number>;
     };
     events: {
-        append: (threadId: string, e: AgentEvent) => Promise<void>;
+        append: (threadId: string, e: NewThreadEvent) => Promise<AgentEvent>;
+        list: (threadId: string, f?: ThreadEventFilter) => Promise<AgentEvent[]>;
         listSince: (threadId: string, sinceSeq: number) => Promise<AgentEvent[]>;
         latest: (threadId: string, type: string) => Promise<AgentEvent | null>;
         listByType: (threadId: string, type: string) => Promise<AgentEvent[]>;
+        prune: (types: string[], opts: {
+            limit: number;
+            dryRun?: boolean;
+        }) => Promise<Record<string, number>>;
     };
     usage: {
         record: (threadId: string, u: NewUsage) => Promise<void>;
         total: (threadId: string, filter?: UsageFilter) => Promise<UsageTotals>;
     };
 }
+/** RunStreams over SQLite: the run_streams and run_stream_events tables, the
+ *  same ones the Go adapter uses. The offset is the event row's key, which
+ *  AUTOINCREMENT never reuses. Readers in this process wake on its own
+ *  appends; one in another process sees them on its next poll. Expired
+ *  streams are deleted as new ones open, 500 a pass, at most once a minute. */
+export declare class SqliteRunStreams implements RunStreams {
+    private readonly db;
+    private readonly opts;
+    private readonly waiters;
+    private swept;
+    constructor(db: SqliteLike, opts?: {
+        pollMs?: number;
+    });
+    private tx;
+    private wake;
+    /** Registers a wake-up before the reader reads, so an append that lands
+     *  between the read and the wait still wakes it. */
+    private arm;
+    private sweep;
+    private remove;
+    open(streamId: string, meta: StreamMeta, ttlMs: number): Promise<void>;
+    /** Inside a transaction: whether the stream is live and closed. */
+    private state;
+    private insert;
+    append(streamId: string, events: StreamEvent[]): Promise<string[]>;
+    close(streamId: string, end: StreamEnd, graceMs: number): Promise<void>;
+    delete(streamId: string): Promise<void>;
+    private page;
+    read(streamId: string, after: string | null, signal?: AbortSignal): AsyncIterable<StreamItem>;
+    snapshot(streamId: string, after?: string | null): Promise<StreamSnapshot | null>;
+}
+/** A Kv over SQLite, for a local setup whose storage is durable too: one
+ *  file, one lifetime. With an in-memory Kv beside SQLite storage, a restart
+ *  forgets what the kv held while the log keeps it: a thread's sandbox (so
+ *  the next call makes a fresh one without saying the files are gone), a
+ *  run's lock, an answered approval on its way to the worker.
+ *
+ *  Expiry is enforced on read. `incr` and SET NX are single statements, so
+ *  concurrent callers never collide on a counter or a lock. The Go package
+ *  has the same adapter (adapters/sqlite/kv.go), with the same table. */
+export declare class SqliteKv implements Kv {
+    private readonly db;
+    constructor(db: SqliteLike);
+    private one;
+    private changes;
+    private expiry;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, opts?: {
+        exSeconds?: number;
+        onlyIfNotExists?: boolean;
+    }): Promise<boolean>;
+    del(key: string): Promise<void>;
+    incr(key: string): Promise<number>;
+    incrWithExpiry(key: string, exSeconds: number): Promise<number>;
+    setIfValue(key: string, expected: string, value: string, opts?: {
+        exSeconds?: number;
+    }): Promise<boolean>;
+    delIfValue(key: string, expected: string): Promise<boolean>;
+}
 //# sourceMappingURL=sqlite.d.ts.map

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

@@ -1 +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,EAAE,WAAW,EAClG,MAAM,kBAAkB,CAAC;AAE1B,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;AA8DD;;+DAE+D;AAC/D,qBAAa,aAAc,YAAW,OAAO;IAC/B,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,UAAU;IA2B3C,OAAO,CAAC,UAAU;IASlB,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;0BAmBpB,MAAM,WAAU,WAAW,KAAQ,OAAO,CAAC,WAAW,CAAC;MAkC/E;CAIH"}
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/adapters/sqlite.ts"],"names":[],"mappings":"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"}