agentenkit 0.2.3 → 0.4.0

package/dist/ports/queue.d.ts

@@ -1,18 +1,98 @@
 import type { RunJob } from '../core/types.js';
+/** The priority of the platform's own housekeeping: park expiries, reclaims
+ *  and lock redrives. A user's message is never queued behind them. */
+export declare const PRIORITY_LOW = -10;
+/** `enqueue` refused a fresh dispatch: a depth cap is set and the queue has
+ *  reached it. Only a fresh dispatch is ever refused; retries, redrives,
+ *  resumes and expiries always go in, or a run already under way would be
+ *  stranded. */
+export declare class QueueFullError extends Error {
+    constructor(message?: string);
+}
+/** A job whose encoded payload is over the adapter's cap. */
+export declare class PayloadTooLargeError extends Error {
+    constructor(message?: string);
+}
+/** An enqueue whose `key` is already waiting or running. */
+export declare class DuplicateJobError extends Error {
+    constructor(key: string);
+}
+/** An adapter's answer to an operation it cannot do, such as counting on a
+ *  queue with no read side. Callers treat it as "unknown", never as a
+ *  failure. */
+export declare class UnsupportedError extends Error {
+    constructor(what: string);
+}
 export interface EnqueueOptions {
     /** Hold the job for this many seconds before delivering it: the HITL expiry
-     *  (§2.5) and a job blocked by an older run's lock (§2.8).
+     *  (§2.5), a job blocked by an older run's lock (§2.8) and a failed run's
+     *  retry backoff.
      *
-     *  An adapter that cannot delay may deliver immediately — both callers treat
-     *  an early arrival as a no-op — but it must NOT throw, or a park would fail
-     *  the run that scheduled it. Note the shape of the reference adapter: QStash
-     *  supports delays on publish only and rejects them on queue enqueue, so
-     *  QStashQueue publishes delayed jobs and queues the rest. */
+     *  An adapter that cannot delay may deliver immediately — every caller
+     *  treats an early arrival as a no-op — but it must NOT throw, or a park
+     *  would fail the run that scheduled it. Note the shape of the reference
+     *  adapter: QStash supports delays on publish only and rejects them on
+     *  queue enqueue, so QStashQueue publishes delayed jobs and queues the
+     *  rest. */
     delaySeconds?: number;
+    /** Dedupes. At most one live job per key: a second enqueue with the same
+     *  key is refused with `DuplicateJobError`, and `cancel` drops the waiting
+     *  job for a key. Omitted means no dedupe. */
+    key?: string;
+    /** Orders ready jobs: higher first, then oldest first. 0 is a normal
+     *  dispatch; the platform's housekeeping uses `PRIORITY_LOW`. */
+    priority?: number;
+}
+/** What a queue can say about itself. */
+export interface QueueStats {
+    /** Jobs a worker could take right now. */
+    ready: number;
+    /** Jobs held for a future run time: park expiries, retry backoffs. Not
+     *  backlog. */
+    delayed: number;
+    /** Jobs a worker holds. */
+    inFlight: number;
+    /** Jobs the queue gave up on and kept for an operator. */
+    dead: number;
+    /** How long the oldest ready job has been waiting: the number that says a
+     *  queue is stuck rather than merely busy. */
+    oldestReadyMs: number;
+    /** True while the consumer is told not to claim. */
+    paused: boolean;
+    /** When this process last took a job. */
+    lastClaimAt?: Date;
+    /** How many claims in a row have failed in this process. */
+    claimErrors: number;
+}
+/** One job as the queue sees it, for a host that asks where a run's job is. */
+export interface QueuedJob {
+    id: string;
+    runId: string;
+    threadId: string;
+    kind: RunJob['kind'];
+    attempts: number;
+    runAt: Date;
+    lockedUntil?: Date;
+    /** How many ready jobs are ahead of it; -1 when the adapter cannot say. */
+    position: number;
 }
 /** Durable dispatch port (§2.8). Delivery is at-least-once — the engine's
- *  state guard + Storage.threads.claimState make double dispatch a no-op. */
+ *  state guard and the run lock make double dispatch a no-op.
+ *
+ *  Beside `enqueue` the port carries the little an engine and a host need to
+ *  see the queue: a way to withdraw a job by key, a way to find a run's job,
+ *  and counts. An adapter with no read side throws `UnsupportedError` from
+ *  `find` and `stats`; callers treat that as "unknown", never as a failure. */
 export interface Queue {
     enqueue(job: RunJob, opts?: EnqueueOptions): Promise<void>;
+    /** Drop every waiting job enqueued under `key`. A key nothing is waiting
+     *  under is not an error. Best-effort by contract: a delivered job is a
+     *  correct no-op anyway. */
+    cancel(key: string): Promise<void>;
+    /** The earliest waiting or running job for a run, or null when the queue
+     *  holds none. */
+    find(runId: string): Promise<QueuedJob | null>;
+    /** Count what waits, runs and died. */
+    stats(): Promise<QueueStats>;
 }
 //# sourceMappingURL=queue.d.ts.map

package/dist/ports/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/ports/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B;;;;;;;kEAO8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;6EAC6E;AAC7E,MAAM,WAAW,KAAK;IACpB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/ports/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C;uEACuE;AACvE,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC;;;gBAGgB;AAChB,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,SAAkB;CAItC;AAED,6DAA6D;AAC7D,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,SAA0B;CAI9C;AAED,4DAA4D;AAC5D,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,GAAG,EAAE,MAAM;CAIxB;AAED;;eAEe;AACf,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,IAAI,EAAE,MAAM;CAIzB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;gBASY;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;kDAE8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;qEACiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,yCAAyC;AACzC,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd;mBACe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb;kDAC8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,MAAM,EAAE,OAAO,CAAC;IAChB,yCAAyC;IACzC,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,+EAA+E;AAC/E,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,IAAI,CAAC;IACZ,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;+EAM+E;AAC/E,MAAM,WAAW,KAAK;IACpB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D;;gCAE4B;IAC5B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC;sBACkB;IAClB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC/C,uCAAuC;IACvC,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;CAC9B"}

package/dist/ports/queue.js

@@ -1,2 +1,37 @@
-export {};
+/** The priority of the platform's own housekeeping: park expiries, reclaims
+ *  and lock redrives. A user's message is never queued behind them. */
+export const PRIORITY_LOW = -10;
+/** `enqueue` refused a fresh dispatch: a depth cap is set and the queue has
+ *  reached it. Only a fresh dispatch is ever refused; retries, redrives,
+ *  resumes and expiries always go in, or a run already under way would be
+ *  stranded. */
+export class QueueFullError extends Error {
+    constructor(message = 'queue is full') {
+        super(message);
+        this.name = 'QueueFullError';
+    }
+}
+/** A job whose encoded payload is over the adapter's cap. */
+export class PayloadTooLargeError extends Error {
+    constructor(message = 'job payload too large') {
+        super(message);
+        this.name = 'PayloadTooLargeError';
+    }
+}
+/** An enqueue whose `key` is already waiting or running. */
+export class DuplicateJobError extends Error {
+    constructor(key) {
+        super(`a job with this key is already queued: ${key}`);
+        this.name = 'DuplicateJobError';
+    }
+}
+/** An adapter's answer to an operation it cannot do, such as counting on a
+ *  queue with no read side. Callers treat it as "unknown", never as a
+ *  failure. */
+export class UnsupportedError extends Error {
+    constructor(what) {
+        super(`not supported by this adapter: ${what}`);
+        this.name = 'UnsupportedError';
+    }
+}
 //# sourceMappingURL=queue.js.map

package/dist/ports/queue.js.map

@@ -1 +1 @@
-{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/ports/queue.ts"],"names":[],"mappings":""}
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/ports/queue.ts"],"names":[],"mappings":"AAEA;uEACuE;AACvE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAE,CAAC;AAEhC;;;gBAGgB;AAChB,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAO,GAAG,eAAe;QACnC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,6DAA6D;AAC7D,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAO,GAAG,uBAAuB;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,4DAA4D;AAC5D,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,GAAW;QACrB,KAAK,CAAC,0CAA0C,GAAG,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;eAEe;AACf,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,IAAY;QACtB,KAAK,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}

package/dist/ports/runtime.d.ts

@@ -4,13 +4,19 @@ import type { TokenAttribution } from '../core/usage.js';
 import type { Storage } from './storage.js';
 import type { AdminStore, RunFilter, StepRecord } from './admin.js';
 import type { AgentRunState, BoundStorage } from '../core/state.js';
-import type { FollowOptions, SseOptions, SseStream } from '../core/follow.js';
+import type { FollowFrame, FollowOptions, FollowThreadOptions, SseStream, ThreadCursor } from '../core/follow.js';
+import type { StreamItem } from '../core/stream-events.js';
+import type { StreamSnapshot } from './streams.js';
 import type { PublishEventOptions } from '../core/publish.js';
+import type { SnapshotStream } from '../core/snapshot.js';
+import type { PruneOptions, PruneReport } from '../core/prune.js';
+import type { WireFormat } from '../core/agui.js';
 export type { AdminStore, NewStepRecord, RunFilter, StepRecord } from './admin.js';
 export type { AgentRunState, BoundStorage, StorageContext } from '../core/state.js';
 import type { EventBus } from './bus.js';
 import type { Queue } from './queue.js';
 import type { Kv } from './kv.js';
+import type { RunStreams } from './streams.js';
 import type { ExecuteInput, ExecuteOutcome } from '../core/engine.js';
 import type { AdminOverview, RunDetail, RunStats, ThreadDetail, ThreadSummary } from '../core/admin.js';
 export type { AdminOverview, RunDetail, RunStats, } from '../core/admin.js';
@@ -28,6 +34,8 @@ export interface RuntimePorts {
     bus: EventBus;
     queue: Queue;
     kv: Kv;
+    /** Run streams, one per segment; absent, none are written. */
+    streams?: RunStreams;
     /** User-provided model resolution (§3.3): models can live in any shape on
      *  the consumer side — the platform only ever sees `ResolvedModel`. */
     resolveModel(modelName: string): ResolvedModel;
@@ -65,6 +73,10 @@ export interface RuntimeOptions {
     bus: EventBus;
     queue: Queue;
     kv: Kv;
+    /** Short-lived logs, one per run segment: where a run's live events go.
+     *  Omitted, they are kept in memory, which only this process can read —
+     *  fine for one process, not for web servers and workers that run apart. */
+    streams?: RunStreams;
     /** Models can come in any shape — config files, a database, provider SDKs.
      *  The platform only ever sees the resolved `ResolvedModel`. */
     resolveModel(modelName: string): ResolvedModel;
@@ -107,10 +119,40 @@ export interface RunInput {
      *  from the AI SDK (§3.1). Merged over the spec default: the execute
      *  input wins per provider namespace. */
     providerOptions?: ProviderOptions;
+    /** Name the run yourself (§2.1): your own records can be keyed by it
+     *  before dispatch, and the worker sees the same id. Reusing one is
+     *  refused, never silently re-run. */
+    runId?: string;
+    /** Cap this run's round trips below the config's `maxSteps`; a larger
+     *  value is clamped to it. */
+    maxSteps?: number;
+    /** Images the user sent with the prompt. They are stored as image parts on
+     *  the user message and reach the model natively. */
+    attachments?: Attachment[];
+    /** The caller's tenant, written on the dispatch ticket so a queue that
+     *  spreads its claims across partitions can keep one tenant's backlog from
+     *  starving the others. Opaque to the platform. */
+    partitionKey?: string;
+    /** The sending client's own name for the user turn. It comes back on the
+     *  turn's MESSAGE_APPENDED, so the client that sent it can swap its
+     *  optimistic copy for the real one by id, never by matching text. Opaque
+     *  to the platform, and not stored. */
+    clientMessageId?: string;
+}
+/** An image on a user turn: a URL the provider can fetch, or a data: URL. */
+export interface Attachment {
+    url: string;
+    mediaType?: string;
 }
+/** Why a run was refused, for a host that answers differently to each:
+ *  `active_run` (the thread already has one), `queue_full` (try again
+ *  shortly), `billing` (the billing check said no). */
+export type RefusedReason = 'active_run' | 'queue_full' | 'billing';
 export interface RunResult {
     accepted: boolean;
     threadId: string;
+    /** For the refusals a host acts on. */
+    reason?: RefusedReason;
     /** This run's id (§2.1) — the same one carried by the enqueued job. An
      *  in-process worker must pass it back, or its dispatch has no identity. */
     runId?: string;
@@ -148,12 +190,16 @@ export interface ThreadUsage {
     /** The model the budget was measured against. */
     model: string;
 }
-/** What the platform hands a spec's `onFinish` once the run is finalized. */
+/** What the platform hands a spec's `onSettle` and `onFinish`. */
 export interface RunFinishInfo {
     threadId: string;
     runId?: string;
     state: ExecutionState;
     stopReason: string;
+    /** A user stop (§2.1). */
+    cancelled: boolean;
+    /** Why the run failed, when it did. */
+    error?: string;
     tokensUsed: number;
     /** The tokens THIS segment spent. A run that parked and resumed finishes
      *  once, so this is the last segment, not the whole run — and it is tokens
@@ -167,8 +213,40 @@ export interface RunFinishInfo {
      *  `unpriced` above zero means some calls went unpriced and `costMicros` is
      *  a floor. */
     usage: UsageTotals;
+    /** Set when the platform could not read the run's rows back. `usage` is
+     *  then zeroed, and a hook that bills from it should refuse to settle
+     *  rather than charge nothing: throw from `onSettle` and the run fails
+     *  instead of going free. */
+    usageError?: unknown;
 }
+/** A spec's settle hook (§5.6): where a run is charged. It runs once per run,
+ *  whatever way the run ends — completed, stopped (while running, queued or
+ *  parked), failed, or found later by the late-settle sweep — before the
+ *  terminal state is written when a worker ends the run. A throw fails a run
+ *  that was going to complete, and leaves the run unsettled so a later
+ *  settle runs it again.
+ *
+ *  Make it idempotent by `runId`. Once is kept by a claim on the run record,
+ *  but a hook slower than the claim (10 minutes), or a mark that could not be
+ *  written, can see the same run twice. */
+export type SettleFn = (info: RunFinishInfo) => void | Promise<void>;
+/** Builds the persona per step with the run's state (§3.1). It wins over the
+ *  static `system` when set. A throw fails the step, like a model error. */
+export type SystemFn = (threadId: string, state: AgentRunState) => string | Promise<string>;
+/** Edits the prompt for one step, just before it is sent (§3.1): `messages` is
+ *  the history the platform assembled (compacted, repaired, cache-stamped) and
+ *  what comes back is what the model sees. It is the place for context that
+ *  must NOT be saved — a screenshot the model should look at once, an editor
+ *  snapshot — because anything added here is gone on the next step unless it
+ *  is added again. */
+export type PrepareStepFn = (threadId: string, state: AgentRunState, messages: Array<any>) => Array<any> | Promise<Array<any>>;
 /** Durable state used to hydrate a client before it starts live event replay. */
+/** Where a follow starts: `cursor` (a ThreadCursor, or its wire string as an
+ *  SSE Last-Event-ID carries it), or a bare record seq `since`. */
+export interface FollowStartOptions extends Omit<FollowThreadOptions, 'cursor'> {
+    cursor?: ThreadCursor | string | null;
+    since?: number;
+}
 export interface ThreadSnapshot {
     thread: ThreadDTO;
     messages: MessageDTO[];
@@ -176,10 +254,13 @@ export interface ThreadSnapshot {
      *  reconnecting client rebuilds its subagent panel without depending on
      *  events that only replay while a run is unfinished. */
     runs: RunRecord[];
-    /** Cursor for starting live replay without duplicating snapshot state. */
+    /** The thread record's last seq. */
     lastEventSeq: number;
-    /** Only the unfinished run's events, used to restore transient activity. */
+    /** The unfinished run's record entries: its open park, a refusal. */
     activeEvents: AgentEvent[];
+    /** The run stream in flight, or one that just ended: what the messages
+     *  do not have yet, and where a live read picks up. */
+    stream: SnapshotStream | null;
 }
 /** Everything streamText accepts except the platform-owned keys (§3.1).
  *  `onChunk` / `onFinish` ARE allowed — the platform chains them (§4). */
@@ -204,8 +285,14 @@ export type StreamTextAgentSpec = {
 } & Omit<Parameters<typeof import('ai').streamText>[0], 'model' | 'messages' | 'prompt' | 'system' | 'abortSignal' | 'maxSteps' | 'onStepFinish' | 'onError' | 'onFinish' | 'onChunk'> & {
     /** `system` is allowed here (static persona); per-run system is not. */
     system?: string;
+    /** The persona built per step with the run's state; wins over `system`. */
+    systemFn?: SystemFn;
+    /** Edits the prompt per step, for context that must not be saved. */
+    prepareStep?: PrepareStepFn;
     tools?: ToolSet;
     onChunk?: (para: any) => void | Promise<void>;
+    /** Charges the run (§5.6). See SettleFn. */
+    onSettle?: SettleFn;
     /** Fires once, after the platform finalized the run, with what the run did
      *  and what it spent (§4). */
     onFinish?: (info: RunFinishInfo) => void | Promise<void>;
@@ -220,9 +307,26 @@ export type GenerateTextAgentSpec = {
     providerOptions?: ProviderOptions;
 } & Omit<Parameters<typeof import('ai').generateText>[0], 'model' | 'messages' | 'prompt' | 'abortSignal' | 'onFinish' | 'onStepFinish'> & {
     tools?: ToolSet;
+    /** The persona built per step with the run's state; wins over `system`. */
+    systemFn?: SystemFn;
+    /** Edits the prompt per step, for context that must not be saved. */
+    prepareStep?: PrepareStepFn;
+    /** Charges the run (§5.6). See SettleFn. */
+    onSettle?: SettleFn;
     /** Fires once, after the platform finalized the run (§4). */
     onFinish?: (info: RunFinishInfo) => void | Promise<void>;
 };
+/** What a stuck-run sweep did. */
+export interface ReclaimReport {
+    /** How many run records the sweep looked at. */
+    checked: number;
+    /** How many runs went back on the queue or were moved to their end state. */
+    redispatched: number;
+    /** How many ended runs had their settle run late. */
+    settled: number;
+    /** How many runs the sweep could not act on. */
+    errors: number;
+}
 /** An executor bound to a generation flavor and to the user's generation
  *  arguments (§3). Returned by the `create*Agent` factories. */
 export interface AgentHandle {
@@ -230,8 +334,9 @@ export interface AgentHandle {
     readonly kind: AgentKind;
     /** Worker-side only (§5.6). Throws on failure — see executeWithPolicy.
      *  Returns 'lock-conflict' when another worker owns the thread's run lock
-     *  (nothing was executed) and 'stale' when a newer run has replaced this
-     *  one (§2.1, §2.8). */
+     *  (nothing was executed), 'stale' when a newer run has replaced this
+     *  one (§2.1, §2.8), and 'lock-lost' when this worker could not keep the
+     *  lock and stopped early (§3.4). */
     execute(input: ExecuteInput): Promise<ExecuteOutcome>;
     /** execute + §2.8 failure policy: redrive < maxAttempts, else finalize FAILED */
     executeWithPolicy(input: ExecuteInput, policy?: {
@@ -260,6 +365,13 @@ export interface AgentCore {
      *  usage rows, subagent runs, and the thread's hot kv keys (§3.2).
      *  Refused while a run is active; stop() first. */
     deleteThread(threadId: string, state?: AgentRunState): Promise<DeleteThreadResult>;
+    /** The backstop for a run that nothing is working on (§2.5, §2.8): a QUEUED
+     *  or RUNNING record older than `olderThanMs` whose lock nobody holds and
+     *  whose job is gone is re-dispatched, and an ended record older than that
+     *  whose settle never ran is settled. Call it from a periodic job. It pages
+     *  through every such run. A record with no recorded state is read with an
+     *  empty state. */
+    reclaimStuckRuns(olderThanMs: number): Promise<ReclaimReport>;
     hitl: {
         respond(input: RespondInput): Promise<RespondResult>;
         reclaimIfOrphaned(threadId: string, state?: AgentRunState): Promise<boolean>;
@@ -267,30 +379,54 @@ export interface AgentCore {
     events: {
         since(threadId: string, sinceSeq: number, state?: AgentRunState): Promise<AgentEvent[]>;
         subscribe(threadId: string, handler: (event: AgentEvent) => void): Promise<() => void>;
-        /** Replay then live, as one sequence, with the cursor discipline already
-         *  applied (§2.2): subscribe before replaying, never emit at or below the
-         *  cursor, forward a seq-0 notice without moving it.
+        /** A thread live, as one sequence of frames (§2.2): its record entries
+         *  and notices, and its run streams — the stream the cursor names read on
+         *  from its offset, the next segment's from its RUN_STARTED, and one
+         *  SNAPSHOT frame when the stream the client was reading is gone.
          *
-         *  Framework-neutral — an async iterable is something Express, Nest, Hono,
-         *  Next or a plain worker can each consume in their own way. Pass a signal,
-         *  or the subscription outlives the client. */
-        follow(threadId: string, options?: FollowOptions & {
+         *  `cursor` is where the client is: the SSE `id:` it last saw
+         *  (Last-Event-ID), as a string or parsed. `since` is a bare record seq,
+         *  as older clients send. Framework-neutral — an async iterable is
+         *  something Express, Nest, Hono, Next or a plain worker can each consume
+         *  in their own way. Pass a signal, or the follow outlives the client. */
+        follow(threadId: string, options?: FollowStartOptions & {
             state?: AgentRunState;
-        }): AsyncGenerator<AgentEvent>;
-        /** `follow`, encoded as Server-Sent Events. Returns the stream and the
+        }): AsyncGenerator<FollowFrame>;
+        /** `follow`, encoded as Server-Sent Events. Each frame that moves the
+         *  cursor carries it as its `id:`. `wireFormat: 'ag-ui'` sends AG-UI
+         *  events instead of our frames (opt-in). Returns the stream and the
          *  headers rather than a Response, because half the ecosystem has none. */
-        sse(threadId: string, options?: SseOptions & {
+        sse(threadId: string, options?: FollowStartOptions & {
+            retryMs?: number;
+            wireFormat?: WireFormat;
             state?: AgentRunState;
         }): SseStream;
+        /** The thread record and its notices alone, as before run streams: no
+         *  stream frames. */
+        followRecord(threadId: string, options?: FollowOptions & {
+            state?: AgentRunState;
+        }): AsyncGenerator<AgentEvent>;
         /** Publish an event of your own on a thread, from anywhere on the server
          *  — a webhook, a cron job, a route. Tools get the same thing bound to
-         *  their thread as `publishEvent` on their options. Durable by default;
-         *  `{ durable: false }` is a bus-only notice. Platform event types are
-         *  refused. */
+         *  their thread as `publishEvent` on their options. Live only by default;
+         *  `{ durable: true }` also keeps it in the thread record. Platform event
+         *  types are refused. */
         publishEvent(threadId: string, type: string, payload: unknown, options?: PublishEventOptions & {
             state?: AgentRunState;
         }): Promise<AgentEvent>;
     };
+    /** Delete the stream-only rows (chunks, step markers, state changes…)
+     *  releases before run streams left in the event table, a batch at a
+     *  time. Nothing reads them any more; an app's own types are kept. Run it
+     *  when it suits you, after upgrading: `{ dryRun: true }` counts first. */
+    pruneEvents(options?: PruneOptions): Promise<PruneReport>;
+    /** A run stream by id, for a caller that only cares about one run: its
+     *  items after `after`, live until it closes. Throws StreamGoneError once
+     *  the stream is past its grace window. */
+    streams: {
+        read(streamId: string, after: string | null, signal?: AbortSignal): AsyncIterable<StreamItem>;
+        snapshot(streamId: string, after?: string | null): Promise<StreamSnapshot | null>;
+    };
     /** Agent factories — see §4. Each call registers a handle under `spec.name`. */
     createStreamTextAgent(spec: StreamTextAgentSpec): AgentHandle;
     createGenerateTextAgent(spec: GenerateTextAgentSpec): AgentHandle;
@@ -325,10 +461,25 @@ export interface AgentCore {
      *  delivery (the per-thread run lock, §3.4). The HTTP layer only verifies
      *  signatures, parses JSON, and calls this. */
     worker: {
-        handleJob(job: RunJob): Promise<{
+        /** Run one job. Throws `UnknownAgentError` for a job naming an agent this
+         *  process does not have, so a queue that retries on failure keeps it.
+         *  Abort `signal` on shutdown: the segment stops at once and the job goes
+         *  back on the queue without spending an attempt. */
+        handleJob(job: RunJob, options?: {
+            signal?: AbortSignal;
+        }): Promise<{
             accepted: boolean;
             reason?: string;
         }>;
+        /** What a queue calls when it gives up on a job (§2.8): the run behind it
+         *  is failed with the reason and settled, so its thread does not read
+         *  QUEUED or RUNNING for ever. A job whose run has already moved on is
+         *  left alone. */
+        handleDeadJob(job: RunJob, attempts: number, cause: unknown): Promise<void>;
     };
+    /** The ports bundle, scoped to a run's state when one is given (§2.10): for
+     *  a host that reads storage, publishes or checks the kv the way the
+     *  platform does. */
+    ports(state?: AgentRunState): RuntimePorts;
 }
 //# sourceMappingURL=runtime.d.ts.map

package/dist/ports/runtime.d.ts.map

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

package/dist/ports/storage.d.ts

@@ -1,5 +1,5 @@
 import type { StorageContext } from '../core/state.js';
-import type { AgentEvent, ExecutionState, MessageDTO, NewMessage, NewUsage, UsageFilter, UsageTotals, ThreadDTO } from '../core/types.js';
+import type { AgentEvent, ExecutionState, MessageDTO, NewMessage, NewThreadEvent, ThreadEventFilter, NewUsage, UsageFilter, UsageTotals, ThreadDTO, ThreadTransition } from '../core/types.js';
 /** Persistence port for a caller's OWN data (§3.2): threads, messages, events,
  *  usage. DTOs cross the boundary; ORM/entity types never leak into core.
  *  Implement it once for MongoDB, MySQL, DynamoDB — or use the shipped
@@ -29,6 +29,11 @@ export interface Storage {
          *  Backs HITL reclamation + double-dispatch protection (§2.5, §2.8).
          *  Must be atomic — a single conditional UPDATE or equivalent. */
         claimState(threadId: string, from: ExecutionState, to: ExecutionState, ctx: StorageContext): Promise<boolean>;
+        /** The compare-and-set every run state change goes through: true iff THIS
+         *  caller moved the thread (see ThreadTransition). The adapter keeps the
+         *  thread's current run beside its state. Atomic, like `claimState`: one
+         *  conditional UPDATE or equivalent. */
+        transition(threadId: string, t: ThreadTransition, ctx: StorageContext): Promise<boolean>;
     };
     messages: {
         append(threadId: string, message: NewMessage, ctx: StorageContext): Promise<MessageDTO>;
@@ -51,16 +56,32 @@ export interface Storage {
          *  provider accepts. `run()` enforces that; adapters just delete. */
         deleteFrom(threadId: string, messageId: string, ctx: StorageContext): Promise<number>;
     };
+    /** The thread record: the few events that must outlive a run — parks and
+     *  their answers, refusals, budget stops, compaction, each segment's start
+     *  and end, and an app's own events published durable. A run's live
+     *  events go to its run stream, never here, so this grows with runs, not
+     *  with tokens. */
     events: {
-        append(threadId: string, event: AgentEvent, ctx: StorageContext): Promise<void>;
-        /** All events after the cursor, ascending by seq — SSE replay (§2.2) */
+        /** Store an entry and mint its seq: the thread's next, one higher than
+         *  any it holds. Two appends on one thread never get the same seq. */
+        append(threadId: string, event: NewThreadEvent, ctx: StorageContext): Promise<AgentEvent>;
+        /** Entries by filter, ascending by seq. */
+        list(threadId: string, filter: ThreadEventFilter, ctx: StorageContext): Promise<AgentEvent[]>;
+        /** All events after the cursor, ascending by seq. */
         listSince(threadId: string, sinceSeq: number, ctx: StorageContext): Promise<AgentEvent[]>;
         /** Most recent event of a type — the HITL pending check (§2.5) */
         latest(threadId: string, type: string, ctx: StorageContext): Promise<AgentEvent | null>;
         /** Every event of a type, ascending by seq. The open-approval set (§2.7)
-         *  is derived from these; scanning `listSince` instead would drag every
-         *  CHUNK on the thread through memory. */
+         *  is derived from these. */
         listByType(threadId: string, type: string, ctx: StorageContext): Promise<AgentEvent[]>;
+        /** Optional: one batch of `runtime.pruneEvents`. Deletes up to `limit`
+         *  entries of these types, on every thread, and says how many of each
+         *  went. With `dryRun` it deletes nothing and counts every entry of
+         *  these types instead. */
+        prune?(types: string[], opts: {
+            limit: number;
+            dryRun?: boolean;
+        }): Promise<Record<string, number>>;
     };
     /** One row per model call (§4).
      *

package/dist/ports/storage.d.ts.map

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