experimental-a2 0.14.1 → 0.16.0

package/CHANGELOG.md

@@ -1,5 +1,86 @@
 # Changelog
 
+## 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
+
+- 197b719: Add `idempotentId(...parts: string[])` to derive stable UUIDv8 event IDs from
+  ordered strings in server and browser code. Existing IDs and automatic ID
+  generation are unchanged.
+
 ## 0.14.1
 
 ### Patch 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
 /**