experimental-a2 0.15.0 → 0.16.1

package/CHANGELOG.md

@@ -1,5 +1,86 @@
 # Changelog
 
+## 0.16.1
+
+### Patch Changes
+
+- 8516609: Restore optimistic Stop previews at the observed generation frontier, clearing the displayed active turn until confirmation or rejection. Cancel model and tool work from the persisted Stop without waiting for control processing, and skip jobs created while their turn has a pending Stop. Keep turn ownership checks and canonical inbox advancement.
+
+  The default AI checkpoint key is now `a2.ai.state.v22:records-v2`; the internal control checkpoint key is `a2.ai.control.v5`. Custom AI reducer names need a version bump to replay pending Stops from older checkpoints.
+
+## 0.16.0
+
+### Minor Changes
+
+- 4798a8e: Separate compacted AI model context from execution control and the full client
+  transcript. Successful compaction is permanent: failure, stop, retry, and worker
+  recovery never restore pre-compaction content. Retry reruns only the unfinished
+  model step and preserves completed steps.
+
+  Server callbacks receive prompt messages and request information without
+  `state` or `execution` arguments. Model and instruction resolvers receive
+  `{ event, messages, session, signal }`. Custom transcript folds and schemas
+  apply only to the transcript; read application reducers through `session.state()`.
+
+  Store AI snapshots as normalized `AIStoredState`, sharing payload records and
+  keeping inverse changes for the current generation projection. Server callers
+  use `reducer.view(snapshot.state)` for inspection and `reducer.fromView(state)`
+  for application-owned views. Hydration takes stored state; client and React
+  snapshots continue to expose the immediate `AIState` view. The stored format
+  uses version 2, with no pre-compaction recovery records.
+
+  Release covered model context, settled worker facts, and completed tool inputs.
+  Compaction waits for final tool exchanges and all A2-owned tool work to settle,
+  including stopped or superseded turns. Each candidate reads one fresh coordinator
+  checkpoint. Cold tools restore their prompt from the tool-admission checkpoint
+  without a separate history read. No new service, subscription, or timer is added.
+  The transcript remains available in full.
+
+- f917f8a: Make queued-message edits last-write-wins in session log order. Use
+  `inputs.queue.edit({ message })`; `expectedRevision` and `InboxItem.revision` are
+  removed. Rapid edits remain optimistic while earlier edits await confirmation.
+  Editing an admitted message still returns `not-pending`, and changing a
+  message's role returns `role-mismatch`.
+- 32a2f76: Use bounded deterministic IDs in the reserved `a2.ai:` namespace for AI requests,
+  generations, assistant responses, worker jobs, reports, and lifecycle events.
+  Ownership comes from explicit event fields instead of recursive ID strings.
+
+  Generation requests require `responseMessageId`; tool continuations also require
+  `sourceGenerationId`. Approval and application-input payloads require `requestId`.
+  `AIState.responseOwners` records generation ID, request ID, and attempt.
+
+  Send, seed, and steering event IDs equal their input message IDs. The initial
+  model-request event ID is also the assistant message ID. Identical submissions
+  replay through core deduplication; conflicting payload, action, or session reuse
+  rejects before append. Caller command/input IDs must be nonempty and cannot use
+  the reserved prefix. Helpers stay synchronous and deterministic.
+
+  Remove the lifetime input/response-ID registry from control checkpoints. Missing
+  queue targets return `not-pending` regardless of prior admission or removal.
+  No storage operations, subscriptions, or timers are added. Use fresh sessions
+  and matching helpers/handlers; no legacy protocol adapter is provided.
+
+- 8959e66: Return one selected snapshot and a scalar head index from Redis state reads.
+  Eligible head snapshots skip the historical checkpoint lookup. Snapshot selection
+  and event-frontier capture remain atomic.
+
+  Propagate operational state-read failures with their backend diagnostics, instead
+  of silently retrying individual reads or rebuilding from raw
+  history. Missing and schema-rejected snapshots still rebuild normally.
+
+  Keep checkpoint writes in the background and report failures through a new
+  `a2.snapshot` telemetry span, or the default console sink. Include session,
+  reducer, greatest checkpoint index, and batch count without snapshot contents.
+
+### Patch Changes
+
+- 9f772b7: Exclude provider metadata from compaction token estimates without changing model
+  requests. Calibrate growing prompts against reported usage in either direction.
+  Record the pre-compaction estimate, calibrated input tokens, and threshold in
+  automatic compaction requests.
+
+  Count serialized UTF-8 bytes without allocating a second copy of the prompt.
+
 ## 0.15.0
 
 ### Minor Changes

package/dist/actor-client.d.ts

@@ -1,4 +1,4 @@
-import { n as ActorCallResult, v as ActorRefusedError } from "./actor-BfQSE0KC.js";
+import { n as ActorCallResult, v as ActorRefusedError } from "./actor-ohPC-81x.js";
 //#region src/actor-client.d.ts
 declare class ActorRequestError extends Error {
   readonly status: number | undefined;

package/dist/{actor-BfQSE0KC.d.ts → actor-ohPC-81x.d.ts}

@@ -1,7 +1,7 @@
-import { h as StandardSchemaV1, i as Contract, s as EventDefs, t as Reducer } from "./reducer-BcS9VDKC.js";
-import { t as A2Store } from "./store-D_yhNdPz.js";
-import { f as ScheduleTiming, m as Session, n as A2Server, t as A2Scheduler } from "./server-Bp5Nd1pF.js";
-import { i as A2Telemetry } from "./telemetry-CpeclqB2.js";
+import { h as StandardSchemaV1, i as Contract, s as EventDefs, t as Reducer } from "./reducer-otzHjuJj.js";
+import { t as A2Store } from "./store-DyZM6fS5.js";
+import { f as ScheduleTiming, m as Session, n as A2Server, t as A2Scheduler } from "./server-DbD7IJVK.js";
+import { i as A2Telemetry } from "./telemetry-B5jzpy6y.js";
 //#region src/actor-shared.d.ts
 /**
  * A handler answered by throwing `NonRetriableError`: the event
@@ -307,4 +307,4 @@ type ActorDefinition<D extends ActorProtocol> = {
 declare function actor<D extends ActorProtocol>(options: ActorOptions<D>): ActorDefinition<D>;
 //#endregion
 export { ActorProtocol as _, ActorHandle as a, ActorScheduleSend as b, ActorOptions as c, concurrent as d, ActorConcurrentContext as f, ActorPresenceValues as g, ActorPresenceOf as h, ActorFetchOptions as i, ActorSendOptions as l, ActorPresenceMap as m, ActorCallResult as n, ActorHandler as o, ActorContext as p, ActorDefinition as r, ActorOperation as s, ActorCallOptions as t, actor as u, ActorRefusedError as v, ActorSend as x, ActorScheduleOptions as y };
-//# sourceMappingURL=actor-BfQSE0KC.d.ts.map
+//# sourceMappingURL=actor-ohPC-81x.d.ts.map

package/dist/{actor-BfQSE0KC.d.ts.map → actor-ohPC-81x.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"actor-BfQSE0KC.d.ts","names":[],"sources":["../src/actor-shared.ts","../src/actor.ts"],"mappings":";;;;;;;;;;;cAgCa,0BAA0B;;WAE5B;;WAEA;EACT,YAAY,eAAe,mBAAmB;;;;;;;;;KAepC;EACV;EACA;;;;;;;EAOA;;;KAIU,gBAAgB,UAAU,iBAAiB;EACrD,gBAAgB;IAEd;;KAIQ,oBAAoB,QAC7B,WAAW,cAAc,EAAE;;;;;;KAQlB,iBAAiB;GAExB,yBAAA,WAAW;IAAgB,OAAO,EAAE;IAAI;IAAc,IAAI;;;;;;;;;;;;KAanD,UAAU,iBACV,WAAW,eAAe,EAAE,MACjC,QAAQ,EAAE,eACV,OAAO,EAAE;;;;;;;;;KAWJ,uBAAuB;EAAmB;;;;;;;;;;;;KAY1C,kBAAkB,iBAClB,WAAW,eAAe,EAAE,MACjC,OAAO,EAAE,gBAAgB,SAAS,yBAAyB,iBAC3D,OAAO,EAAE,IAAI,SAAS,yBAAyB;;KAI1C,aAAa,UAAU;;EAEjC,OAAO;;EAEP;;EAEA;;EAEA,QAAQ;;EAER,MAAM,UAAU;;EAEhB,UAAU,kBAAkB;;;;;;;;KASlB,uBAAuB,UAAU;;EAE3C;;EAEA;;EAEA,QAAQ;;EAER,SAAS;IAAU,OAAO;IAAY;;;EAEtC,MAAM,UAAU;;EAEhB,UAAU,kBAAkB;;KAGlB,kBAAkB;EAC5B,OAAO;;EAEP;;EAEA;;;KAWU,qBAAqB;EAC/B,kBAAkB,iBAAiB,kBAAkB;;;;;;;;;;;;;;KCzE3C,aAAa,UAAU,eAAe,gBAAgB,iBAC5D,KAAK,aAAa,IAAI,OAAO,YAAY,cAAc;EAEvD;EACA,SACE,KAAK,uBAAuB,IAC5B,OAAO,YAAY,cACT;;;;;;;;;;;;;;;;iBAiBF,WAAW,KAAK,GAC9B,SAAS,KAAK,KAAK,OAAO,aAAa;EACpC;EAAkB,SAAS,KAAK,KAAK,OAAO,aAAa;;KAIlD,aAAa,UAAU;;EAEjC;;EAEA,OAAO;;;;;EAKP,aAAa,WAAW,cAAc,aAAa,GAAG;EACtD,QAAQ;EACR,YAAY;EACZ,YAAY;MACR,gBAAgB;EAChB;;;;;;;;;;;;EAYA;;;;;;;KAQM;WACG;WAAwB;;WAExB;WACA;WACA;;WAGA;WACA;WACA;WACA;WACA;;WAGA;WACA;WACA;WACA,QAAQ,SAAS;;KAGpB,kBAAkB,UAAU;;EAEtC,aAAa,WAAW,6BAA6B;;;;;;;;;;;;EAYrD,QAAQ,OAAO;;KAGL;;EAEV;;KAGU,mBAAmB;;EAE7B;;KAGU,gBAAgB;;EAE1B,OAAO;;EAEP;;KAGG,WACH,UAAU,eACV,gBAAgB,0BACH,YAAY,MAErB,QAAQ,YAAY,IACpB,UAAU,qBACP,QAAQ,gBAAgB,gBAE3B,OAAO,YAAY,IACnB,UAAU,qBACP,QAAQ,gBAAgB;KAE5B,WACH,UAAU,eACV,gBAAgB,0BACH,YAAY,MAErB,QAAQ,YAAY,IACpB,UAAU,qBACP;EAAU;EAAY;MAEzB,OAAO,YAAY,IACnB,UAAU,qBACP;EAAU;EAAY;;;KAGnB,YAAY,UAAU;WACvB;;;;;;WAMA,kBAAkB,WAAW,cAAc,WAAW,GAAG;;WAEzD,kBAAkB,WAAW,cAAc,WAAW,GAAG;;WAEzD,aAAa,QAAQ,gBAAgB;;;;;;;;;;WAUrC,QACP,SAAS,SACT,UAAU,kBAAkB,OACzB,QAAQ;;WAEJ,SAAS,QAAQ;;KAGhB,gBAAgB,UAAU;WAC3B;;;;;;WAMA,WAAW;;WAEX,UAAU,SAAS;;WAEnB,QAAQ,SAAS;;WAEjB,SAAS,QAAQ,qBAAqB,aAAa;EAC5D,MAAM,aAAa,YAAY;;;;;;;iBAsDjB,MAAM,UAAU,eAC9B,SAAS,aAAa,KACrB,gBAAgB"}
+{"version":3,"file":"actor-ohPC-81x.d.ts","names":[],"sources":["../src/actor-shared.ts","../src/actor.ts"],"mappings":";;;;;;;;;;;cAgCa,0BAA0B;;WAE5B;;WAEA;EACT,YAAY,eAAe,mBAAmB;;;;;;;;;KAepC;EACV;EACA;;;;;;;EAOA;;;KAIU,gBAAgB,UAAU,iBAAiB;EACrD,gBAAgB;IAEd;;KAIQ,oBAAoB,QAC7B,WAAW,cAAc,EAAE;;;;;;KAQlB,iBAAiB;GAExB,yBAAA,WAAW;IAAgB,OAAO,EAAE;IAAI;IAAc,IAAI;;;;;;;;;;;;KAanD,UAAU,iBACV,WAAW,eAAe,EAAE,MACjC,QAAQ,EAAE,eACV,OAAO,EAAE;;;;;;;;;KAWJ,uBAAuB;EAAmB;;;;;;;;;;;;KAY1C,kBAAkB,iBAClB,WAAW,eAAe,EAAE,MACjC,OAAO,EAAE,gBAAgB,SAAS,yBAAyB,iBAC3D,OAAO,EAAE,IAAI,SAAS,yBAAyB;;KAI1C,aAAa,UAAU;;EAEjC,OAAO;;EAEP;;EAEA;;EAEA,QAAQ;;EAER,MAAM,UAAU;;EAEhB,UAAU,kBAAkB;;;;;;;;KASlB,uBAAuB,UAAU;;EAE3C;;EAEA;;EAEA,QAAQ;;EAER,SAAS;IAAU,OAAO;IAAY;;;EAEtC,MAAM,UAAU;;EAEhB,UAAU,kBAAkB;;KAGlB,kBAAkB;EAC5B,OAAO;;EAEP;;EAEA;;;KAWU,qBAAqB;EAC/B,kBAAkB,iBAAiB,kBAAkB;;;;;;;;;;;;;;KCzE3C,aAAa,UAAU,eAAe,gBAAgB,iBAC5D,KAAK,aAAa,IAAI,OAAO,YAAY,cAAc;EAEvD;EACA,SACE,KAAK,uBAAuB,IAC5B,OAAO,YAAY,cACT;;;;;;;;;;;;;;;;iBAiBF,WAAW,KAAK,GAC9B,SAAS,KAAK,KAAK,OAAO,aAAa;EACpC;EAAkB,SAAS,KAAK,KAAK,OAAO,aAAa;;KAIlD,aAAa,UAAU;;EAEjC;;EAEA,OAAO;;;;;EAKP,aAAa,WAAW,cAAc,aAAa,GAAG;EACtD,QAAQ;EACR,YAAY;EACZ,YAAY;MACR,gBAAgB;EAChB;;;;;;;;;;;;EAYA;;;;;;;KAQM;WACG;WAAwB;;WAExB;WACA;WACA;;WAGA;WACA;WACA;WACA;WACA;;WAGA;WACA;WACA;WACA,QAAQ,SAAS;;KAGpB,kBAAkB,UAAU;;EAEtC,aAAa,WAAW,6BAA6B;;;;;;;;;;;;EAYrD,QAAQ,OAAO;;KAGL;;EAEV;;KAGU,mBAAmB;;EAE7B;;KAGU,gBAAgB;;EAE1B,OAAO;;EAEP;;KAGG,WACH,UAAU,eACV,gBAAgB,0BACH,YAAY,MAErB,QAAQ,YAAY,IACpB,UAAU,qBACP,QAAQ,gBAAgB,gBAE3B,OAAO,YAAY,IACnB,UAAU,qBACP,QAAQ,gBAAgB;KAE5B,WACH,UAAU,eACV,gBAAgB,0BACH,YAAY,MAErB,QAAQ,YAAY,IACpB,UAAU,qBACP;EAAU;EAAY;MAEzB,OAAO,YAAY,IACnB,UAAU,qBACP;EAAU;EAAY;;;KAGnB,YAAY,UAAU;WACvB;;;;;;WAMA,kBAAkB,WAAW,cAAc,WAAW,GAAG;;WAEzD,kBAAkB,WAAW,cAAc,WAAW,GAAG;;WAEzD,aAAa,QAAQ,gBAAgB;;;;;;;;;;WAUrC,QACP,SAAS,SACT,UAAU,kBAAkB,OACzB,QAAQ;;WAEJ,SAAS,QAAQ;;KAGhB,gBAAgB,UAAU;WAC3B;;;;;;WAMA,WAAW;;WAEX,UAAU,SAAS;;WAEnB,QAAQ,SAAS;;WAEjB,SAAS,QAAQ,qBAAqB,aAAa;EAC5D,MAAM,aAAa,YAAY;;;;;;;iBAsDjB,MAAM,UAAU,eAC9B,SAAS,aAAa,KACrB,gBAAgB"}

package/dist/actor-react.d.ts

@@ -1,7 +1,7 @@
-import { a as ContractEvent, s as EventDefs } from "./reducer-BcS9VDKC.js";
-import { g as ActorPresenceValues, m as ActorPresenceMap } from "./actor-BfQSE0KC.js";
+import { a as ContractEvent, s as EventDefs } from "./reducer-otzHjuJj.js";
+import { g as ActorPresenceValues, m as ActorPresenceMap } from "./actor-ohPC-81x.js";
 import { ActorClientCall, ActorStateOf, AnyActorDefinition } from "./actor-client.js";
-import { a as Connection } from "./client-BAEABRZB.js";
+import { a as Connection } from "./client-CzyacQpJ.js";
 //#region src/actor-react.d.ts
 /** The server-to-client handoff: `await def.actor(id).state()`. */
 type ActorSnapshot<S> = {

package/dist/actor.d.ts

@@ -1,2 +1,2 @@
-import { _ as ActorProtocol, a as ActorHandle, b as ActorScheduleSend, c as ActorOptions, d as concurrent, f as ActorConcurrentContext, g as ActorPresenceValues, h as ActorPresenceOf, i as ActorFetchOptions, l as ActorSendOptions, m as ActorPresenceMap, n as ActorCallResult, o as ActorHandler, p as ActorContext, r as ActorDefinition, s as ActorOperation, t as ActorCallOptions, u as actor, v as ActorRefusedError, x as ActorSend, y as ActorScheduleOptions } from "./actor-BfQSE0KC.js";
+import { _ as ActorProtocol, a as ActorHandle, b as ActorScheduleSend, c as ActorOptions, d as concurrent, f as ActorConcurrentContext, g as ActorPresenceValues, h as ActorPresenceOf, i as ActorFetchOptions, l as ActorSendOptions, m as ActorPresenceMap, n as ActorCallResult, o as ActorHandler, p as ActorContext, r as ActorDefinition, s as ActorOperation, t as ActorCallOptions, u as actor, v as ActorRefusedError, x as ActorSend, y as ActorScheduleOptions } from "./actor-ohPC-81x.js";
 export { ActorCallOptions, ActorCallResult, type ActorConcurrentContext, type ActorContext, ActorDefinition, ActorFetchOptions, ActorHandle, ActorHandler, ActorOperation, ActorOptions, type ActorPresenceMap, type ActorPresenceOf, type ActorPresenceValues, type ActorProtocol, ActorRefusedError, type ActorScheduleOptions, type ActorScheduleSend, type ActorSend, ActorSendOptions, actor, concurrent };

package/dist/actor.js

@@ -1,6 +1,6 @@
 import { t as contract } from "./contract-CKRg_E4q.js";
 import { n as NonRetriableError, t as A2Error } from "./errors-DCk6ch5n.js";
-import { a as sseResponse, i as setServerFetchHooks, o as parsePresenceSibling, t as createServer } from "./server-CjJSGcF7.js";
+import { a as sseResponse, i as setServerFetchHooks, o as parsePresenceSibling, t as createServer } from "./server-BD5ckxZb.js";
 import { a as actorFailedSchema, c as isJsonTree, i as ActorRefusedError, l as openPresenceDefs, n as ACTOR_LANE, o as actorReducer, r as ACTOR_STATE_EVENT, s as actorStateSchema, t as ACTOR_FAILED_EVENT } from "./actor-shared-B5tJfzt-.js";
 //#region src/actor.ts
 /**

package/dist/{ai-Cai-lCbj.d.ts → ai-CrEf6p_W.d.ts}

@@ -1,10 +1,9 @@
-import { h as StandardSchemaV1, i as Contract, s as EventDefs, t as Reducer } from "./reducer-BcS9VDKC.js";
-import { s as HandlerContext } from "./server-Bp5Nd1pF.js";
+import { h as StandardSchemaV1, i as Contract, s as EventDefs, t as Reducer } from "./reducer-otzHjuJj.js";
+import { s as HandlerContext } from "./server-DbD7IJVK.js";
 import { FinishReason, JSONValue, LanguageModelUsage, UIMessage, UIMessage as UIMessage$1, UIMessageChunk, UIMessageChunk as UIMessageChunk$1 } from "ai";
 //#region src/ai-control.d.ts
 type InboxItem<M extends UIMessage = UIMessage> = {
   id: string;
-  revision: number;
   message: M;
   generate: boolean;
   afterStepOf?: string;
@@ -16,7 +15,6 @@ type ControlCommand<M extends UIMessage = UIMessage> = {
 } | {
   action: "edit";
   message: M;
-  expectedRevision: number;
 } | {
   action: "move";
   inputId: string;
@@ -66,7 +64,7 @@ type ControlReceipt = {
   commandId: string;
   work?: true;
   outcome: "applied" | "rejected";
-  reason?: "already-active" | "revision-conflict" | "stale-turn" | "not-found" | "duplicate-input" | "closed" | "stale-work" | "not-user-input";
+  reason?: "not-pending" | "role-mismatch" | "stale-turn" | "not-found" | "closed" | "stale-work" | "not-user-input";
 };
 type ActiveTurn<M extends UIMessage = UIMessage> = {
   turnId: string;
@@ -116,13 +114,15 @@ type ControlCommit = {
     paused: boolean;
     closed: boolean;
     requestId: string | null;
+    requestReason: GenerationReason | null;
+    sourceGenerationId: string | null;
     responseMessageId: string | null;
   };
 };
 //#endregion
 //#region src/ai-client-state.d.ts
 type QueueCommand<M extends UIMessage> = Extract<ControlCommand<M>, {
-  action: "send" | "edit" | "move" | "remove" | "send-now" | "steer" | "pause" | "resume";
+  action: "send" | "edit" | "move" | "remove" | "send-now" | "steer" | "pause" | "resume" | "stop";
 }>;
 type PendingQueueCommand<M extends UIMessage> = {
   commandId: string;
@@ -160,6 +160,52 @@ type ProgressBatches = {
   blocks: Array<BatchBlock | null>;
 };
 //#endregion
+//#region src/ai-message-projection.d.ts
+type MessageProjection<M extends UIMessage> = Omit<ActiveGenerationProjection<M>, "baseTools">;
+//#endregion
+//#region src/ai-stored-state.d.ts
+type Value = null | boolean | number | string | Value[] | {
+  [key: string]: Value;
+};
+type Payload = {
+  value?: unknown;
+};
+type Undo = {
+  value: Value;
+} | {
+  length: number;
+  items: Record<string, Undo>;
+} | {
+  fields: Record<string, Undo>;
+  remove: string[];
+};
+type Projection = {
+  fields: Value;
+  hasMessage: boolean;
+  message?: Undo;
+  tools?: Undo;
+};
+type AIStoredState = {
+  version: 2;
+  fields: Value;
+  projection: Projection | null;
+  values: Payload[];
+};
+type AIStoredView = {
+  messages: UIMessage[];
+  activeProjection: (MessageProjection<UIMessage> & {
+    baseTools?: AIState["tools"];
+  }) | null;
+  tools?: AIState["tools"];
+  usage?: AIState["usage"];
+};
+declare const aiStateReducer: unique symbol;
+type AIStoredReducer<D extends EventDefs, S extends AIStoredView> = Reducer<D, AIStoredState, Record<never, never>, S> & {
+  readonly [aiStateReducer]: Reducer<D, S>;
+  view(state: AIStoredState): S;
+  fromView(state: S): AIStoredState;
+};
+//#endregion
 //#region src/ai.d.ts
 type AgentStatus = "idle" | "generating" | "waiting" | "failed" | "closed" | "paused";
 type GenerationReason = "message" | "tool" | "input" | "retry" | "resume";
@@ -197,7 +243,8 @@ type GenerationRequestedPayload = {
   };
   messageId: string;
   reason: GenerationReason;
-  responseMessageId?: string;
+  responseMessageId: string;
+  sourceGenerationId?: string;
 };
 type RetryGenerationOptions = {
   messageId: string;
@@ -274,6 +321,7 @@ type ToolResultPayload = {
   toolMetadata?: unknown;
 };
 type ApprovalRequestedPayload = {
+  requestId: string;
   messageId: string;
   generationId: string;
   approvalId: string;
@@ -282,6 +330,7 @@ type ApprovalRequestedPayload = {
   signature?: string;
 };
 type ApprovalRespondedPayload = {
+  requestId: string;
   messageId: string;
   generationId: string;
   approvalId: string;
@@ -289,6 +338,7 @@ type ApprovalRespondedPayload = {
   reason?: string;
 };
 type InputRequestedPayload = {
+  requestId: string;
   messageId: string;
   generationId: string;
   inputId: string;
@@ -296,6 +346,7 @@ type InputRequestedPayload = {
   question?: JSONValue;
 };
 type InputRespondedPayload = {
+  requestId: string;
   messageId: string;
   generationId: string;
   inputId: string;
@@ -325,6 +376,9 @@ type CompactionRequestedPayload = {
   generationId: string;
   throughMessageId: string;
   throughIndex?: number;
+  inputTokenEstimate?: number;
+  inputTokens?: number;
+  thresholdTokens?: number;
 };
 type CompactionCompletedPayload<M extends UIMessage$1> = {
   generationId: string;
@@ -455,9 +509,11 @@ type AIState<M extends UIMessage$1 = UIMessage$1> = {
   status: AgentStatus;
   activeGeneration: ActiveGeneration | null;
   activeRequestId: string | null;
+  activeRequestReason: GenerationReason | null;
+  activeRequestSourceGenerationId: string | null;
   activeResponseMessageId: string | null;
   activeProjection: ActiveGenerationProjection<M> | null;
-  responseGenerationIds: Record<string, string>;
+  responseOwners: Record<string, Pick<GenerationStartedPayload, "generationId" | "requestId" | "attempt">>;
   terminalRequestIds?: Record<string, true>;
   terminalGenerations?: Record<string, "completed" | "failed" | "interrupted" | "superseded">;
   pendingApprovals: PendingApproval[];
@@ -470,7 +526,7 @@ type AIState<M extends UIMessage$1 = UIMessage$1> = {
 };
 type AgentDefinition<M extends UIMessage$1 = UIMessage$1, D extends EventDefs = AIEventDefs<M>> = {
   readonly contract: Contract<D>;
-  readonly reducer: Reducer<D, AIState<M>>;
+  readonly reducer: AIStoredReducer<D, AIState<M>>;
 };
 type AgentToolEventDefs = EventDefs & Pick<AIEventDefs, "ai.tool.execution.requested">;
 /** The durable handler context supplied when A2 executes a local AI tool. */
@@ -505,7 +561,9 @@ declare function deriveUIMessages<M extends UIMessage$1 = UIMessage$1>(history:
 declare function createReducer<D extends EventDefs>(options: {
   contract: Contract<D>;
   name?: string;
-}): Reducer<D, AIState<AIMessageFrom<D>>>;
+  fold?: Reducer<D, AIState<AIMessageFrom<D>>>["fold"];
+  stateSchema?: StandardSchemaV1<unknown, AIState<AIMessageFrom<D>>>;
+}): AIStoredReducer<D, AIState<AIMessageFrom<D>>>;
 type CommandInput<C> = {
   type: "ai.control.requested";
   payload: C;
@@ -513,7 +571,9 @@ type CommandInput<C> = {
 };
 type ControlInput<M extends UIMessage$1, A extends ControlCommand<M>["action"]> = CommandInput<Extract<ControlCommand<M>, {
   action: A;
-}>>;
+}>> & (A extends "send" | "steer" ? {
+  id: string;
+} : {});
 type AIInputs = {
   message<M extends UIMessage$1>(message: M, options?: {
     generate?: boolean;
@@ -530,7 +590,6 @@ type AIInputs = {
     }): ControlInput<UIMessage$1, "send-now">[];
     edit<M extends UIMessage$1>(options: {
       message: M;
-      expectedRevision: number;
     }): ControlInput<M, "edit">[];
     move(options: {
       inputId: string;
@@ -576,5 +635,5 @@ declare function handlerContext<D extends AgentToolEventDefs>(agentOrContract: C
  */
 declare function agent<M extends UIMessage$1 = UIMessage$1, E extends EventDefs = Record<never, never>>(options: AgentOptions<M, E>): AgentDefinition<M, AIEventDefs<M> & E>;
 //#endregion
-export { reduceAIState as $, MessageInterruptedPayload as A, SessionCreatedPayload as B, GenerationUsage as C, LanguageModelUsage as D, JSONValue as E, PendingApproval as F, UIMessageChunk$1 as G, ToolCalledPayload as H, PendingInput as I, createReducer as J, agent as K, RetryGenerationOptions as L, ModelMetadataRequestedPayload as M, ModelMetadataResolvedPayload as N, MessageCompletedPayload as O, ModelMetadataState as P, inputs as Q, RetryRequestedPayload as R, GenerationStartedPayload as S, InputRespondedPayload as T, ToolResultPayload as U, ToolActivity as V, UIMessage$1 as W, events as X, deriveUIMessages as Y, handlerContext as Z, GenerationCompletedPayload as _, ActiveGenerationProjection as a, GenerationReason as b, AgentStatus as c, ApprovalRequestedPayload as d, PendingQueueCommand as et, ApprovalRespondedPayload as f, FinishReason as g, CompactionState as h, ActiveGeneration as i, InboxItem as it, ModelLimits as j, MessageCreatedPayload as k, AgentToolContext as l, CompactionRequestedPayload as m, AIInputs as n, ControlCommand as nt, AgentDefinition as o, CompactionCompletedPayload as p, createEvents as q, AIState as r, ControlReceipt as rt, AgentOptions as s, AIEventDefs as t, ActiveTurn as tt, AgentToolEventDefs as u, GenerationFailedPayload as v, InputRequestedPayload as w, GenerationRequestedPayload as x, GenerationProgressPayload as y, SessionClosedPayload as z };
-//# sourceMappingURL=ai-Cai-lCbj.d.ts.map
+export { reduceAIState as $, MessageInterruptedPayload as A, SessionCreatedPayload as B, GenerationUsage as C, LanguageModelUsage as D, JSONValue as E, PendingApproval as F, UIMessageChunk$1 as G, ToolCalledPayload as H, PendingInput as I, createReducer as J, agent as K, RetryGenerationOptions as L, ModelMetadataRequestedPayload as M, ModelMetadataResolvedPayload as N, MessageCompletedPayload as O, ModelMetadataState as P, inputs as Q, RetryRequestedPayload as R, GenerationStartedPayload as S, InputRespondedPayload as T, ToolResultPayload as U, ToolActivity as V, UIMessage$1 as W, events as X, deriveUIMessages as Y, handlerContext as Z, GenerationCompletedPayload as _, ActiveGenerationProjection as a, ControlReceipt as at, GenerationReason as b, AgentStatus as c, ApprovalRequestedPayload as d, AIStoredReducer as et, ApprovalRespondedPayload as f, FinishReason as g, CompactionState as h, ActiveGeneration as i, ControlCommand as it, ModelLimits as j, MessageCreatedPayload as k, AgentToolContext as l, CompactionRequestedPayload as m, AIInputs as n, PendingQueueCommand as nt, AgentDefinition as o, InboxItem as ot, CompactionCompletedPayload as p, createEvents as q, AIState as r, ActiveTurn as rt, AgentOptions as s, AIEventDefs as t, AIStoredState as tt, AgentToolEventDefs as u, GenerationFailedPayload as v, InputRequestedPayload as w, GenerationRequestedPayload as x, GenerationProgressPayload as y, SessionClosedPayload as z };
+//# sourceMappingURL=ai-CrEf6p_W.d.ts.map

package/dist/ai-CrEf6p_W.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-CrEf6p_W.d.ts","names":[],"sources":["../src/ai-control.ts","../src/ai-client-state.ts","../src/ai-projector.ts","../src/ai-progress-batches.ts","../src/ai-message-projection.ts","../src/ai-stored-state.ts","../src/ai.ts"],"mappings":";;;;KAcY,UAAU,UAAU,YAAY;EAC1C;EACA,SAAS;EACT;EACA;;KAGU,eAAe,UAAU,YAAY;EAC3C;EAAgB,SAAS;EAAG;;EAC5B;EAAgB,SAAS;;EACzB;EAAgB;EAAiB;;EACjC;EAAkB;;EAElB;EACA;EACA;EACA;;EAEA;EAAgB;EAAgB;;EAChC;EAAiB;EAAgB,SAAS;EAAG;;EAC7C;EAAiB;;EACjB;;EACA;EAAuB,QAAQ;;EAC/B;EAAoB,UAAU;;EAC9B;EAAiB,UAAU;;EAC3B;EAAyB,SAAS;;EAClC;EAAiB,SAAS;;EAC1B;EAAqB,SAAS;;KAExB;EACV;EACA;EACA;EACA;;KAUU,WAAW,UAAU,YAAY;EAC3C;EACA,OAAO,UAAU;EACjB;;KA+BU;EAAa;EAAc;EAAY;;KACvC;EACV;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;;KAGE;EACV;EACA;EACA,MAAM;EACN,YAAY;;KAYF;EACV;EACA;EACA;EACA;IAAW;IAAe;IAAqB;;EAC/C;IAAS;IAAc;;;KAGb;EACV,SAAS;EACT;IACE;IACA;IACA,OAAO;IACP;IACA;IACA;IACA,eAAe;IACf;IACA;;;;;KCpIQ,aAAa,UAAU,aAAa,QAC9C,eAAe;EAEb;;KAYQ,oBAAoB,UAAU;EACxC;EACA,SAAS,aAAa;;;;KCjBnB;EACH;EACA;EACA;EACA;EACA;EACA;EACA;;KAmHU;EACV,MAAM;EACN,WAAW;EACX,OAAO,eAAe;;;;KChIZ;EAAkB;EAAe,QAAQ;;KAChD,aAAa;EAAoB,MAAM;EAAY,OAAO;;KAEnD;EACV;EACA,MAAM;EACN,QAAQ,MAAM;;;;KCcJ,kBAAkB,UAAU,aAAa,KACnD,2BAA2B;;;KChBxB,2CACgC;GAA2B,cAAA;;KAC3D;EAAY;;KACZ;EACC,OAAO;;EACP;EAAgB,OAAO,eAAe;;EACtC,QAAQ,eAAe;EAAO;;KAE/B;EACH,QAAQ;EACR;EACA,UAAU;EACV,QAAQ;;KAGE;EACV;EACA,QAAQ;EACR,YAAY;EACZ,QAAQ;;KAGE;EACV,UAAU;EACV,mBACG,kBAAkB;IAAe,YAAY;;EAChD,QAAQ;EACR,QAAQ;;cAGG;KAED,gBACV,UAAU,WACV,UAAU,gBACR,QAAQ,GAAG,eAAe,sBAAsB;YACxC,iBAAiB,QAAQ,GAAG;EACtC,KAAK,OAAO,gBAAgB;EAC5B,SAAS,OAAO,IAAI;;;;KC6BV;KAGA;KAEA;EAA0B,WAAW;;KACrC;EAAyB;;KACzB,sBAAsB,UAAU;EAC1C,SAAS;;EAET;;KAEU;EAA4B;;KACnC;EACH;EACA;;EAEA;;KAEU,4BAA4B;EAEhC;EAAsB;;EACtB;EAAmB;;KAEf;EACV;IAAY;IAAgB;;EAC5B;EACA,QAAQ;EACR;EACA;;KAEU;EACV;EACA;EACA;;KAEU,wBAAwB;KACxB;EACV;EACA;EACA;EACA;EACA;EACA;EACA;;KAEU;EACV;EACA;EACA;EACA;EACA;EACA,QAAQ;;KAEE;EACV;EACA;EACA;EACA;EACA,eAAe;EACf,QAAQ;EACR;;KAEU;EACV;EACA;EACA;EACA;EACA;;EAEA;EACA;;KAEU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;KAEU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;KAEU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;;KAEU;EACV;EACA;EACA;EACA;EACA;EACA;;KAEU;EACV;EACA;EACA;EACA;EACA;EACA,WAAW;;KAED;EACV;EACA;EACA;EACA;EACA;EACA,OAAO;;KAEG;EACV;EACA;;KAEU;EAAkC;;KAClC;EACV;EACA,QAAQ;;KAEE;EACN;;EACA;EAAoB,QAAQ;;EAC5B;;KAEM;EACV;EACA;EACA;EACA;EACA;EACA;;KAEU,2BAA2B,UAAU;EAC/C;EACA;EACA;EACA,UAAU;EACV;EACA;EACA,QAAQ;;KAGE,YAAY,UAAU,cAAY;EAC5C,wBAAwB,iBAAiB,eAAe;EACxD,wBAAwB,iBAAiB;EACzC,sBAAsB,iBAAiB;EACvC,oBAAoB,iBAAiB;EACrC,+BAA+B,iBAAiB;EAChD,wBAAwB;IACtB;IACA;;EAEF,sBAAsB,i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"}