experimental-a2 0.18.0 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## 0.19.0
+
+### Minor Changes
+
+- 8f373b5: Under `fx()` and `pi()`, a user message's images now reach the model. A2 fetches each `image/*` file part from its `https:` or `data:` URL through the AI SDK's download, which refuses private addresses and checks redirects, up to 32 MiB of one message's files, and keeps what it fetched for the process. FX gets them as image prompt blocks and Pi as prompt and steering images. A file that isn't an image, an image A2 can't fetch, or a steer with files under FX fails the turn with an error that names the file. Every step sends the conversation so far with all its files, as under `{ type: 'ai-sdk' }`.
+
+  Before, both harnesses read only a message's text and dropped its files without a word.
+
+- b83ba8b: `agent()` now throws a `TypeError` when a provider-defined tool (`type: 'provider'`, such as a provider's web search) is passed with `fx()` or `pi()`, as it does for a tool that sets `needsApproval`. Before, both harnesses dropped such a tool without a word, so the model never saw it.
+- 88ee923: A2's AI log stores each message's content once, in the `ai.control.requested` command that brought it in. Before, a message sent with no turn running was stored three times, and a queued or steering one four: in its command, in `ai.control.committed`, and in `ai.message.created`.
+
+  - `ai.message.created` now records an admission as `{ messageId, role, generate? }`. `MessageCreatedPayload` is no longer generic. Only A2's control lane writes the event, after the command that brought its input in; `reduceAIState()` and `deriveUIMessages()` throw on one that no command explains.
+  - `ai.control.committed` never carries message content: queued inputs and `AIState.active.input` are the new `InputRef` type, `{ id, role, generate, afterStepOf? }`. `ActiveTurn` is no longer generic. `AIState.inbox.items` keep their `message`, now with `role`.
+  - `AIMessageOf` reads the message type from the contract's input command schema.
+  - The AI state, model context, and control reducers advance to `a2.ai.state.v27`, `a2.ai.context.v7`, and `a2.ai.control.v6`, so their checkpoints rebuild from the log. Logs written before this release don't fold.
+
+  Reading the log costs nothing more: the transcript's readers keep a queued input's content in their state from its command until its admission.
+
+- da1e0e5: Steering hands off in the order it was sent, as one turn. `steer()` now queues new input right after the turn's earlier steering instead of ahead of it, and `queue.sendNow()` lands after that steering too. At the handoff, every input steering the turn enters together: the last one starts the new turn and the earlier ones enter as its context (`generate: false`), so the model answers them once. Under `fx()` and `pi()`, they reach the harness as one steering message. A turn paused with `pause({ when: 'now' })` keeps its steering until `resume()`, so every steer sent while it's paused targets it and they all enter on Resume.
+
+  Before, each steer jumped to the front, so several steers ran last-first, each as its own turn, and the first steer ended a paused turn at once, leaving later steers no turn to target.
+
+### Patch Changes
+
+- 9b80f3e: Under `pi()`, `speed: 'fast'` now asks AI Gateway for the model's fast tier on each of Pi's model calls, as it already did under `{ type: 'ai-sdk' }` and `fx()`. Before, `pi()` ignored `speed`, so every step ran at standard speed.
+- b83ba8b: The interruption reason `'steered after step'` is reserved: A2 writes it when steering ends a response, and `fx()` and `pi()` replay the next response as that steering. A client interruption that carries it is now rejected. Before, one would make the harness replay a stopped response as steered, so the replay diverged and the session failed.
+- c7afea6: `vercelQueues()` no longer refuses delays over six days itself. A task's delay goes to Vercel Queues as asked, with the seven-day retention it already set, and Vercel Queues refuses one longer than that.
+
+## 0.18.1
+
+### Patch Changes
+
+- 27f2d19: A handler that throws is held back before its retry: one second after the first failure, doubling up to 30 seconds. The store holds the failed event, so nothing retries it early, and the scheduler's next wake after the hold runs it. Before, a failed event was retried on every wake, every six to eight seconds whatever its failure count, and Vercel Queues also redelivered the failing message on a second 30-second chain. Custom `A2Store` implementations take a new `retryAfterMs` option on `failAttempt`: short of dead-lettering, keep the event unclaimable for that long by setting its claim expiry with no holder.
+- 38e557b: An attempt that ends before it finishes, because its process timed out, crashed, or lost its claim, now counts toward the event's ten-attempt failure budget, the same as a handler that throws. The store counts it when the next claim takes the lapsed one over, and dead-letters the event in that same write once the count reaches ten, without running an eleventh attempt. A handler that never fits in its invocation dead-letters instead of retrying forever. A timeout costs every event it interrupts one attempt, so a session whose fan-out keeps outrunning its function can dead-letter work that was only waiting: bound the fan-out, or put work that contends for one resource in a lane. `lastError` keeps the last error a handler threw, or is null when every attempt lapsed. Custom `A2Store` implementations count the takeover of an expired claim whose holder is still recorded, and take a new `maxFailures` option on `claimAvailable` that dead-letters at the limit.
+- 89c600a: Under `fx()`, a step no longer fails with "This operation was aborted" when the Gateway closes its response a moment after FX has read it. And a model stream that breaks while a step's progress is being written now fails that step, instead of leaving an unhandled rejection that ended the process.
+- 7c5912f: Under `fx()`, a tool call's input goes through the tool's schema, as under `{ type: 'ai-sdk' }`. `execute` receives the schema's output, so defaults apply, and input the schema rejects goes back to the model as an error without running the tool. Before, `execute` received the model's raw JSON: an omitted field with a default arrived as `undefined`, and invalid input ran the tool. Responses recorded before this change replay unchanged.
+- d28e1bf: Once a function's deadline passes, A2 claims nothing more in that invocation, so a timeout costs each in-flight event one attempt. Before, a drain past its deadline kept claiming the event it had just lost, with a 1ms window each time, until the platform ended the process: a single timeout could cost an event a dozen or more attempts, each one restarting its handler and writing to the store.
+- 96c4968: Under `pi()`, a call to one of the agent's own tools goes through Pi's checks and then the tool's schema, as under `{ type: 'ai-sdk' }`. `execute` receives the schema's output of the arguments Pi accepts, so defaults apply and Pi's coercion carries through. Input either check rejects, and a call to a tool that does not exist, goes back to the model as an error without running the tool; so does input Pi rejects for its own tools, which no longer starts a tool execution. Before, `execute` received the model's raw arguments: an omitted field with a default arrived as `undefined`, a number sent as a string stayed a string, and a call Pi had rejected still ran while the model saw Pi's error. Pi's transcript keeps the model's own arguments, and responses recorded before this change replay unchanged.
+
 ## 0.18.0
 
 ### Minor Changes

package/dist/{actor-Bjce9_5U.d.ts → actor-C7b-1arn.d.ts}

@@ -1,6 +1,6 @@
 import { s as Contract, t as Reducer, u as EventDefs, v as StandardSchemaV1 } from "./reducer-CqA59Q6U.js";
-import { t as A2Store } from "./store-Djdv0bnZ.js";
-import { h as Session, n as A2Server, p as ScheduleTiming, t as A2Scheduler } from "./server-En7cbi3v.js";
+import { t as A2Store } from "./store-CyLUy86v.js";
+import { h as Session, n as A2Server, p as ScheduleTiming, t as A2Scheduler } from "./server-DYAATFuT.js";
 import { i as A2Telemetry } from "./telemetry-Cyfqo6Qt.js";
 //#region src/actor-shared.d.ts
 /**
@@ -317,4 +317,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-Bjce9_5U.d.ts.map
+//# sourceMappingURL=actor-C7b-1arn.d.ts.map

package/dist/{actor-Bjce9_5U.d.ts.map → actor-C7b-1arn.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"actor-Bjce9_5U.d.ts","names":[],"sources":["../src/actor-shared.ts","../src/actor.ts"],"mappings":";;;;;;;;;;;cAiCa,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;;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;;;;;EAKA;;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;;;;;;;;WAQA,kBAAkB,WAAW,cAAc,WAAW,GAAG;;WAEzD,kBAAkB,WAAW,cAAc,WAAW,GAAG;;WAEzD,aAAa,QAAQ,gBAAgB;;;;;;;;;;;WAWrC,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-C7b-1arn.d.ts","names":[],"sources":["../src/actor-shared.ts","../src/actor.ts"],"mappings":";;;;;;;;;;;cAiCa,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;;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;;;;;EAKA;;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;;;;;;;;WAQA,kBAAkB,WAAW,cAAc,WAAW,GAAG;;WAEzD,kBAAkB,WAAW,cAAc,WAAW,GAAG;;WAEzD,aAAa,QAAQ,gBAAgB;;;;;;;;;;;WAWrC,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-client.d.ts

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

package/dist/actor-react.d.ts

@@ -1,5 +1,5 @@
 import { c as ContractEvent, u as EventDefs } from "./reducer-CqA59Q6U.js";
-import { g as ActorPresenceValues, m as ActorPresenceMap } from "./actor-Bjce9_5U.js";
+import { g as ActorPresenceValues, m as ActorPresenceMap } from "./actor-C7b-1arn.js";
 import { ActorClientCall, ActorStateOf, AnyActorDefinition } from "./actor-client.js";
 import { a as Connection } from "./client-h_DKFAjj.js";
 //#region src/actor-react.d.ts

package/dist/actor-react.js

@@ -2,7 +2,7 @@
 import { n as isSessionCleared } from "./session-clear-DGI4jTQ5.js";
 import { r as foldsClearMarkers } from "./reducer-BAXc8JyF.js";
 import { n as internalContract } from "./contract-BYKASlCV.js";
-import { t as createClient } from "./client-BReKqwZC.js";
+import { t as createClient } from "./client-BhHLoNKF.js";
 import { useSession } from "./react.js";
 import { l as openPresenceDefs } from "./actor-shared-t7w8xIKP.js";
 import { createActorClient } from "./actor-client.js";

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-Bjce9_5U.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-C7b-1arn.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,7 +1,7 @@
 import { a as NonRetriableError, i as A2Error, n as isSessionCleared, r as sessionClearedError } from "./session-clear-DGI4jTQ5.js";
 import { n as internalContract } from "./contract-BYKASlCV.js";
-import { v as serverInternals } from "./internal-B2T3U4Rq.js";
-import { c as parsePresenceSibling, o as setServerFetchHooks, s as sseResponse, t as createServer } from "./server-Dw_k_7kO.js";
+import { v as serverInternals } from "./internal-CscSY7K_.js";
+import { c as parsePresenceSibling, o as setServerFetchHooks, s as sseResponse, t as createServer } from "./server-D-Y4pqwu.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-t7w8xIKP.js";
 //#region src/actor.ts
 /**

package/dist/{ai-DrUaMyRt.d.ts → ai-Cz3hqVhk.d.ts}

@@ -1,5 +1,5 @@
 import { c as ContractEvent, s as Contract, t as Reducer, u as EventDefs, v as StandardSchemaV1 } from "./reducer-CqA59Q6U.js";
-import { c as HandlerContext } from "./server-En7cbi3v.js";
+import { c as HandlerContext } from "./server-DYAATFuT.js";
 import { FinishReason, JSONValue as JSONValue$1, LanguageModelCallOptions, LanguageModelUsage, UIMessage, UIMessage as UIMessage$1, UIMessageChunk, UIMessageChunk as UIMessageChunk$1 } from "ai";
 //#region src/ai-message-base.d.ts
 type FieldUndo = {
@@ -22,12 +22,20 @@ type MessageBase = {
 };
 //#endregion
 //#region src/ai-control.d.ts
-type InboxItem<M extends UIMessage = UIMessage> = {
+/**
+ * An input in the queue or the active turn. Its content stays in the
+ * `ai.control.requested` command that brought it, and in no other event.
+ */
+type InputRef = {
   id: string;
-  message: M;
+  role: UIMessage["role"];
   generate: boolean;
   afterStepOf?: string;
 };
+/** A queued input with its content, as `AIState` shows it. */
+type InboxItem<M extends UIMessage = UIMessage> = InputRef & {
+  message: M;
+};
 type ControlCommand<M extends UIMessage = UIMessage> = {
   action: "send";
   message: M;
@@ -86,9 +94,9 @@ type ControlReceipt = {
   outcome: "applied" | "rejected";
   reason?: "not-pending" | "role-mismatch" | "stale-turn" | "not-found" | "closed" | "stale-work" | "not-user-input";
 };
-type ActiveTurn<M extends UIMessage = UIMessage> = {
+type ActiveTurn = {
   turnId: string;
-  input: InboxItem<M>;
+  input: InputRef;
   phase: "starting" | "generating" | "tools" | "waiting" | "failed" | "pausing" | "paused";
 };
 type WorkFact = {
@@ -216,10 +224,15 @@ type SessionCreatedPayload = {
 type SessionClosedPayload = {
   reason?: string;
 };
-type MessageCreatedPayload<M extends UIMessage$1> = {
-  message: M;
-  /** For user messages, false records passive context. Omission or true schedules. */
-  generate?: boolean;
+/**
+ * A message entering the transcript. Its content is the command's that brought
+ * it in, which every reader of the transcript has already folded.
+ */
+type MessageCreatedPayload = {
+  messageId: string;
+  role: UIMessage$1["role"];
+  /** For user messages, false records passive context. Omission schedules. */
+  generate?: false;
 };
 type MessageCompletedPayload = {
   messageId: string;
@@ -400,7 +413,7 @@ type AIEventDefs<M extends UIMessage$1 = UIMessage$1> = {
   }>;
   "ai.session.created": StandardSchemaV1<SessionCreatedPayload>;
   "ai.session.closed": StandardSchemaV1<SessionClosedPayload>;
-  "ai.message.created": StandardSchemaV1<MessageCreatedPayload<M>>;
+  "ai.message.created": StandardSchemaV1<MessageCreatedPayload>;
   "ai.message.completed": StandardSchemaV1<MessageCompletedPayload>;
   "ai.message.interrupted": StandardSchemaV1<MessageInterruptedPayload>;
   "ai.generation.requested": StandardSchemaV1<GenerationRequestedPayload>;
@@ -491,7 +504,7 @@ type AIState<M extends UIMessage$1 = UIMessage$1> = {
     items: InboxItem<M>[];
   };
   pendingQueueCommands?: PendingQueueCommand<M>[];
-  active: ActiveTurn<M> | null;
+  active: ActiveTurn | null;
   starting: boolean;
   receipt: ControlReceipt | null;
   pausedGenerationIds?: Record<string, true>;
@@ -518,10 +531,14 @@ type AIState<M extends UIMessage$1 = UIMessage$1> = {
   usage: GenerationUsage[];
   error: string | null;
 };
-/** The `UIMessage` type a contract's `ai.message.created` schema carries. */
+/** The `UIMessage` type a contract's input commands carry. */
 type AIMessageOf<D> = D extends {
-  readonly "ai.message.created": infer S extends StandardSchemaV1;
-} ? StandardSchemaV1.InferOutput<S> extends MessageCreatedPayload<infer M extends UIMessage$1> ? M : UIMessage$1 : UIMessage$1;
+  readonly "ai.control.requested": infer S extends StandardSchemaV1;
+} ? Extract<StandardSchemaV1.InferOutput<S>, {
+  action: "send";
+}> extends {
+  message: infer M extends UIMessage$1;
+} ? M : UIMessage$1 : UIMessage$1;
 /** What `agentContract()` returns: the AI protocol, with `X` as application state. */
 type AgentContract<M extends UIMessage$1 = UIMessage$1, D extends EventDefs = AIEventDefs<M>, X extends object = Record<never, never>> = Contract<D, Record<never, never>, AgentReducer<M, D, X>>;
 type AgentToolEventDefs = EventDefs & Pick<AIEventDefs, "ai.tool.execution.requested">;
@@ -640,7 +657,7 @@ declare const inputs: AIInputs;
  */
 declare function handlerContext<D extends AgentToolEventDefs = AIEventDefs>(contract?: Contract<D>): AgentToolContext<D>;
 /** The built-in AI reducer's name, and so its checkpoint identity. */
-declare const AI_STATE_REDUCER = "a2.ai.state.v26";
+declare const AI_STATE_REDUCER = "a2.ai.state.v27";
 /**
  * The built-in AI protocol plus application events, as a core contract whose
  * reducer folds `AIState`. Isomorphic: share it when a client needs
@@ -649,5 +666,5 @@ declare const AI_STATE_REDUCER = "a2.ai.state.v26";
  */
 declare function agentContract<M extends UIMessage$1 = UIMessage$1, E extends EventDefs = Record<never, never>, X extends object = Record<never, never>>(options: AgentContractOptions<M, E, X>): AgentContract<M, AIEventDefs<M> & E, X>;
 //#endregion
-export { agentContract as $, InputRespondedPayload as A, PendingApproval as B, GenerationFailedPayload as C, GenerationStartedPayload as D, GenerationRequestedPayload as E, MessageInterruptedPayload as F, SessionClosedPayload as G, ReasoningLevel as H, ModelLimits as I, ToolCalledPayload as J, SessionCreatedPayload as K, ModelMetadataRequestedPayload as L, LanguageModelUsage as M, MessageCompletedPayload as N, GenerationUsage as O, MessageCreatedPayload as P, UIMessageChunk$1 as Q, ModelMetadataResolvedPayload as R, GenerationCompletedPayload as S, GenerationReason as T, RetryGenerationOptions as U, PendingInput as V, RetryRequestedPayload as W, TranscriptMessage as X, ToolResultPayload as Y, UIMessage$1 as Z, CompactionPart as _, AI_STATE_REDUCER as a, reasoningLevels as at, CompactionState as b, AgentContract as c, PendingQueueCommand as ct, AgentStatus as d, ControlReceipt as dt, createEvents as et, AgentToolContext as f, InboxItem as ft, CompactionCompletedPayload as g, ApprovalRespondedPayload as h, AIState as i, inputs as it, JSONValue$1 as j, InputRequestedPayload as k, AgentContractOptions as l, ActiveTurn as lt, ApprovalRequestedPayload as m, AIInputs as n, events as nt, ActiveGeneration as o, reduceAIState as ot, AgentToolEventDefs as p, ToolActivity as q, AIMessageOf as r, handlerContext as rt, ActiveGenerationProjection as s, isCompactionPart as st, AIEventDefs as t, deriveUIMessages as tt, AgentReducer as u, ControlCommand as ut, CompactionPartData as v, GenerationProgressPayload as w, FinishReason as x, CompactionRequestedPayload as y, ModelMetadataState as z };
-//# sourceMappingURL=ai-DrUaMyRt.d.ts.map
+export { agentContract as $, InputRespondedPayload as A, PendingApproval as B, GenerationFailedPayload as C, GenerationStartedPayload as D, GenerationRequestedPayload as E, MessageInterruptedPayload as F, SessionClosedPayload as G, ReasoningLevel as H, ModelLimits as I, ToolCalledPayload as J, SessionCreatedPayload as K, ModelMetadataRequestedPayload as L, LanguageModelUsage as M, MessageCompletedPayload as N, GenerationUsage as O, MessageCreatedPayload as P, UIMessageChunk$1 as Q, ModelMetadataResolvedPayload as R, GenerationCompletedPayload as S, GenerationReason as T, RetryGenerationOptions as U, PendingInput as V, RetryRequestedPayload as W, TranscriptMessage as X, ToolResultPayload as Y, UIMessage$1 as Z, CompactionPart as _, AI_STATE_REDUCER as a, reasoningLevels as at, CompactionState as b, AgentContract as c, PendingQueueCommand as ct, AgentStatus as d, ControlReceipt as dt, createEvents as et, AgentToolContext as f, InboxItem as ft, CompactionCompletedPayload as g, ApprovalRespondedPayload as h, AIState as i, inputs as it, JSONValue$1 as j, InputRequestedPayload as k, AgentContractOptions as l, ActiveTurn as lt, ApprovalRequestedPayload as m, AIInputs as n, events as nt, ActiveGeneration as o, reduceAIState as ot, AgentToolEventDefs as p, InputRef as pt, ToolActivity as q, AIMessageOf as r, handlerContext as rt, ActiveGenerationProjection as s, isCompactionPart as st, AIEventDefs as t, deriveUIMessages as tt, AgentReducer as u, ControlCommand as ut, CompactionPartData as v, GenerationProgressPayload as w, FinishReason as x, CompactionRequestedPayload as y, ModelMetadataState as z };
+//# sourceMappingURL=ai-Cz3hqVhk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-Cz3hqVhk.d.ts","names":[],"sources":["../src/ai-message-base.ts","../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.ts"],"mappings":";;;;KAGK;EAAc;;EAAsB;;EAAmB;;KACvD,aAAa,eAAe;KAC5B;EAAa,OAAO;;EAAiC,QAAQ;;KAEtD;EACV;EACA,SAAS;EACT,QAAQ,eAAe;;;;;;;;KCQb;EACV;EACA,MAAM;EACN;EACA;;;KAIU,UAAU,UAAU,YAAY,aAAa;EACvD,SAAS;;KAGC,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;EACV;EACA,OAAO;EACP;;KA+BU;EAAa;EAAc;EAAY;;KACvC;EACV;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;;KAGE;EACV;EACA;EACA,MAAM;EACN,YAAY;;KAoDF;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;;;;;KC7KQ,aAAa,UAAU,aAAa,QAC9C,eAAe;EAEb;;KAYQ,oBAAoB,UAAU;EACxC;EACA,SAAS,aAAa;;;;KCpBnB;EACH;EACA;EACA;EACA;EACA;EACA;EACA;;KAwJU;EACV,MAAM;EACN,WAAW;EACX,OAAO,eAAe;;;;KChJZ;EAAkB;EAAe,QAAQ;;KAChD,aAAa;EAAoB,MAAM;EAAY,OAAO;;KAEnD;EACV;EACA,MAAM;EACN,QAAQ,MAAM;;;;cCmgBH,mBAAoB;EAC/B;MACE,QAAQ;;;KCncA;KAGA;KAEA,iBAAiB,YAAY;cAE5B,0BAA0B;KAU3B;EACV;EACA;EACA;EACA;EACA,QAAQ;;;KAIE;EACV;EACA;EACA,MAAM;;;;;;KASI,kBAAkB,UAAU,eAAa,KAAK;EACxD,OAAO,MAAM,qBAAqB;;KAGxB;EAA0B,WAAW;;KACrC;EAAyB;;;;;;KAKzB;EACV;EACA,MAAM;;EAEN;;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;;EAEA;EACA;;KAEU;;EAEV;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,iBAAiB;EACvC,qBAAqB,iBAAiB;EACtC,sBAAsB,iBAAiB;EACvC,wBAAwB,iBAAiB;EACzC,0BAA0B,iBAAiB;EAC3C,2BAA2B,iBAAiB;EAC5C,sBAAsB,iBAAiB;EACvC,yBAAyB,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"}

package/dist/ai-client.d.ts

@@ -1,5 +1,5 @@
 import { s as CreateClientOptions, t as A2Client } from "./client-h_DKFAjj.js";
-import { a as AI_STATE_REDUCER, i as AIState, r as AIMessageOf, t as AIEventDefs } from "./ai-DrUaMyRt.js";
+import { a as AI_STATE_REDUCER, i as AIState, r as AIMessageOf, t as AIEventDefs } from "./ai-Cz3hqVhk.js";
 //#region src/ai-client.d.ts
 /**
  * The structural shape of `typeof` an `agent({ name })` server: one whose

package/dist/ai-client.js

@@ -1,5 +1,5 @@
-import { t as createClient } from "./client-BReKqwZC.js";
-import { n as agentContract } from "./ai-BpOGm-zB.js";
+import { t as createClient } from "./client-BhHLoNKF.js";
+import { n as agentContract } from "./ai-mMiWul1T.js";
 //#region src/ai-client.ts
 /**
 * experimental-a2/ai/client — a client for an `agent()` route that needs no

package/dist/ai-control-CvLbW10B.js

@@ -0,0 +1,46 @@
+//#region src/ai-control.ts
+/**
+* The `ai.message.interrupted` reason A2 writes when steering ends a response
+* after a step; a harness's replay continues the turn on it. Reserved, so a
+* client's interruption can't carry it.
+*/
+const STEERED_REASON = "steered after step";
+/**
+* A fold met an admission no command explains. Only A2's control lane writes
+* `ai.message.created`, after the command that brought its input in.
+*/
+const unexplainedAdmission = (messageId) => /* @__PURE__ */ new TypeError(`ai.message.created for ${messageId} follows no command that brought it in; only A2's control lane writes it`);
+/**
+* Where new steering for a turn goes in the inbox: right after the turn's
+* earlier steering, or first, so it hands off in the order it was sent.
+*/
+const steeringEnd = (items, turnId) => items.findLastIndex((item) => item.afterStepOf === turnId) + 1;
+/**
+* Whether an input steering a turn enters as context for later steering: the
+* run of inputs steering one turn is admitted together, and only its last
+* generating input starts the next turn.
+*/
+const steersOn = (item, rest) => {
+	if (item.afterStepOf === void 0) return false;
+	for (const next of rest) {
+		if (next.afterStepOf !== item.afterStepOf) return false;
+		if (next.generate) return true;
+	}
+	return false;
+};
+const initialControlState = () => ({
+	pendingStops: {},
+	inbox: {
+		paused: false,
+		items: []
+	},
+	active: null,
+	coordinator: {
+		closed: false,
+		queued: []
+	}
+});
+//#endregion
+export { unexplainedAdmission as a, steersOn as i, initialControlState as n, steeringEnd as r, STEERED_REASON as t };
+
+//# sourceMappingURL=ai-control-CvLbW10B.js.map

package/dist/ai-control-CvLbW10B.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-control-CvLbW10B.js","names":[],"sources":["../src/ai-control.ts"],"sourcesContent":["import type { UIMessage } from 'ai'\nimport type { AICoordinatorState } from './ai-coordinator.ts'\nimport type {\n  ApprovalRespondedPayload,\n  GenerationStartedPayload,\n  GenerationReason,\n  InputRequestedPayload,\n  InputRespondedPayload,\n  MessageInterruptedPayload,\n  RetryRequestedPayload,\n  ToolCalledPayload,\n  ToolResultPayload,\n} from './ai.ts'\n\n/**\n * An input in the queue or the active turn. Its content stays in the\n * `ai.control.requested` command that brought it, and in no other event.\n */\nexport type InputRef = {\n  id: string\n  role: UIMessage['role']\n  generate: boolean\n  afterStepOf?: string\n}\n\n/** A queued input with its content, as `AIState` shows it. */\nexport type InboxItem<M extends UIMessage = UIMessage> = InputRef & {\n  message: M\n}\n\nexport type ControlCommand<M extends UIMessage = UIMessage> =\n  | { action: 'send'; message: M; generate?: boolean }\n  | { action: 'edit'; message: M }\n  | { action: 'move'; inputId: string; beforeId: string | null }\n  | { action: 'remove'; inputId: string }\n  | {\n      action: 'send-now'\n      inputId: string\n      turnId: string | null\n      lastSeenIndex?: number\n    }\n  | { action: 'stop'; turnId: string; lastSeenIndex?: number }\n  | { action: 'steer'; turnId: string; message: M; lastSeenIndex?: number }\n  | { action: 'pause'; when: 'now' | 'after-turn' }\n  | { action: 'resume' }\n  | { action: 'tool-result'; result: ToolResultPayload }\n  | { action: 'approval'; response: ApprovalRespondedPayload }\n  | { action: 'input'; response: InputRespondedPayload }\n  | { action: 'request-input'; request: InputRequestedPayload }\n  | { action: 'retry'; request: RetryRequestedPayload }\n  | { action: 'interrupt'; request: MessageInterruptedPayload }\n\nexport type ControlReceipt = {\n  commandId: string\n  work?: true\n  outcome: 'applied' | 'rejected'\n  reason?:\n    | 'not-pending'\n    | 'role-mismatch'\n    | 'stale-turn'\n    | 'not-found'\n    | 'closed'\n    | 'stale-work'\n    | 'not-user-input'\n}\n\nexport type ActiveTurn = {\n  turnId: string\n  input: InputRef\n  phase:\n    | 'starting'\n    | 'generating'\n    | 'tools'\n    | 'waiting'\n    | 'failed'\n    | 'pausing'\n    | 'paused'\n}\n\nexport type ControlWork = {\n  id: string\n  version: number\n  settled: boolean\n  attempt?: number\n  facts?: string[]\n}\n\nexport type AIControlState = {\n  pendingStops: Record<string, string>\n  inbox: { paused: boolean; items: InputRef[] }\n  active:\n    | (ActiveTurn & {\n        version: number\n        suspended: boolean\n        model: ControlWork | null\n      })\n    | null\n  coordinator: AICoordinatorState\n}\n\nexport type WorkFact = { type: string; id: string; payload: unknown }\nexport type WorkReport = {\n  attempt: number\n  workId: string\n  turnId: string\n  version: number\n  kind: 'model' | 'tool'\n  settled: boolean\n  events: WorkFact[]\n}\n\nexport type ToolExecutionRequest = {\n  turnId: string\n  version: number\n  call: ToolCalledPayload\n  generation: GenerationStartedPayload\n}\n\n/**\n * The `ai.message.interrupted` reason A2 writes when steering ends a response\n * after a step; a harness's replay continues the turn on it. Reserved, so a\n * client's interruption can't carry it.\n */\nexport const STEERED_REASON = 'steered after step'\n\n/**\n * A fold met an admission no command explains. Only A2's control lane writes\n * `ai.message.created`, after the command that brought its input in.\n */\nexport const unexplainedAdmission = (messageId: string): TypeError =>\n  new TypeError(\n    `ai.message.created for ${messageId} follows no command that brought it in; only A2's control lane writes it`,\n  )\n\n/**\n * Where new steering for a turn goes in the inbox: right after the turn's\n * earlier steering, or first, so it hands off in the order it was sent.\n */\nexport const steeringEnd = (\n  items: readonly InputRef[],\n  turnId: string,\n): number => items.findLastIndex((item) => item.afterStepOf === turnId) + 1\n\n/**\n * Whether an input steering a turn enters as context for later steering: the\n * run of inputs steering one turn is admitted together, and only its last\n * generating input starts the next turn.\n */\nexport const steersOn = (\n  item: InputRef,\n  rest: readonly InputRef[],\n): boolean => {\n  if (item.afterStepOf === undefined) return false\n  for (const next of rest) {\n    if (next.afterStepOf !== item.afterStepOf) return false\n    if (next.generate) return true\n  }\n  return false\n}\n\nexport const initialControlState = (): AIControlState => ({\n  pendingStops: {},\n  inbox: { paused: false, items: [] },\n  active: null,\n  coordinator: { closed: false, queued: [] },\n})\n\nexport type ControlChange = {\n  path: (string | number)[]\n  value?: unknown\n  remove?: true\n  splice?: { index: number; deleteCount: number; items: unknown[] }\n  move?: { from: number; to: number }\n}\n\nexport type ControlCommit = {\n  changes: ControlChange[]\n  view: {\n    turnId: string | null\n    version: number | null\n    phase: ActiveTurn['phase'] | null\n    paused: boolean\n    closed: boolean\n    requestId: string | null\n    requestReason: GenerationReason | null\n    sourceGenerationId: string | null\n    responseMessageId: string | null\n  }\n}\n"],"mappings":";;;;;;AA2HA,MAAa,iBAAiB;;;;;AAM9B,MAAa,wBAAwB,8BACnC,IAAI,UACF,0BAA0B,UAAU,yEACtC;;;;;AAMF,MAAa,eACX,OACA,WACW,MAAM,eAAe,SAAS,KAAK,gBAAgB,MAAM,IAAI;;;;;;AAO1E,MAAa,YACX,MACA,SACY;CACZ,IAAI,KAAK,gBAAgB,KAAA,GAAW,OAAO;CAC3C,KAAK,MAAM,QAAQ,MAAM;EACvB,IAAI,KAAK,gBAAgB,KAAK,aAAa,OAAO;EAClD,IAAI,KAAK,UAAU,OAAO;CAC5B;CACA,OAAO;AACT;AAEA,MAAa,6BAA6C;CACxD,cAAc,CAAC;CACf,OAAO;EAAE,QAAQ;EAAO,OAAO,CAAC;CAAE;CAClC,QAAQ;CACR,aAAa;EAAE,QAAQ;EAAO,QAAQ,CAAC;CAAE;AAC3C"}

package/dist/ai-fx.d.ts

@@ -1,4 +1,4 @@
-import { t as Harness } from "./ai-harness-DvsPeJeB.js";
+import { t as Harness } from "./ai-harness-CV6rXbB3.js";
 //#region src/ai-fx.d.ts
 /**
  * The FX harness. Every model call FX makes is one durable step; A2 rebuilds

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

@@ -1 +1 @@
-{"version":3,"file":"ai-fx.d.ts","names":[],"sources":["../src/ai-fx.ts"],"mappings":";;;;;;iBAwCgB,MAAM"}
+{"version":3,"file":"ai-fx.d.ts","names":[],"sources":["../src/ai-fx.ts"],"mappings":";;;;;;iBA2CgB,MAAM"}