experimental-a2 0.0.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog
 
+## 0.2.0
+
+### Minor Changes
+
+- 056cf86: Add `session.append.dispatch(...events)` to persist events and hand pending
+  handler work directly to configured recovery instead of starting it inline.
+
+## 0.1.0
+
+### Minor Changes
+
+- 6a1fb4c: Run each AI SDK model step as one durable A2 generation and execute ready tools
+  concurrently. Keep approvals, tool results, retries, queued user turns, and the
+  single continuation barrier recoverable through the event log.
+- 48e3b58: Add `experimental-a2/devtools/server`, a read-only HTTP dashboard over durable event,
+  processing, failure, and snapshot metadata. Serve the complete browser UI and
+  live SSE invalidations from one authenticated handler without a client package
+  or separate datastore.
+- 78a9c3f: Persist atomic same-session causes plus event claim, write-once completion, and
+  failure summaries inside existing log operations.
+- 352be59: Run handlers concurrently by default with durable per-event claims. Add
+  session-scoped `lane` ordering, atomic handler returns for one event or an
+  event batch, and a shared `ctx.session` interface with reducer-state reads and
+  named immediate appends.
+- 3ca23b1: Add the extensible `experimental-a2/ai` agent protocol and the AI SDK-backed `experimental-a2/ai/server`
+  runtime. Let `createReact` bind a shared client whose stable live session
+  identities carry optimistic state across route handoffs and accept
+  server-rendered event history for a complete first paint. Keep an optimistic
+  agent interruption terminal when in-flight generation events arrive after it.
+
+### Patch Changes
+
+- 5679f4f: Retry lazy log and recovery initialization after transient failures while still
+  deduplicating concurrent attempts. Serialize Postgres schema creation across
+  serverless instances so racing cold starts cannot poison a warm instance.
+- 167371a: Publish A2 temporarily as `experimental-a2` and update every public import
+  path to match.
+- 0cb72af: Settle event types without registered handlers atomically during append. Skip
+  drains, leases, and recovery messages when a session has no pending handler
+  work, while preserving append-driven healing for older handled events. Custom
+  log adapters now return `{ events, hasPending }` from `A2Log.append()` so this
+  decision is part of the atomic append operation.
+
 Notable changes to the `experimental-a2` package. The telemetry span/attribute
 catalogue (see the API reference) is treated as a contract: renames and
 additions are breaking for dashboards and are called out here.

package/dist/ai-server.browser.js

@@ -1,4 +1,4 @@
 //#region src/ai-server.browser.ts
-/** a2/ai/server is server-only; agent definitions live in a2/ai. */
-throw new Error("a2/ai/server is server-only — a client bundle imported it. Import agent from a2/ai in browser code instead.");
+/** experimental-a2/ai/server is server-only; agent definitions live in experimental-a2/ai. */
+throw new Error("experimental-a2/ai/server is server-only — a client bundle imported it. Import agent from experimental-a2/ai in browser code instead.");
 //#endregion

package/dist/ai-server.d.ts

@@ -1,8 +1,18 @@
-import { i as EventDefs, r as ContractEvent } from "./contract-DL8btVd9.js";
+import { a as EventDefs, r as ContractEvent } from "./contract-C_3dIIEU.js";
 import { AIEventDefs, AIState, AgentDefinition } from "./ai.js";
-import { A2Server, ServerOptions } from "./server.js";
-import { Instructions, LanguageModel, ToolLoopAgentSettings, ToolSet, UIMessage, UIMessageChunk } from "ai";
+import { A2Server, PushValidationContext, ServerOptions } from "./server.js";
+import { Instructions, LanguageModel, ToolSet, ToolSet as ToolSet$1, UIMessage, UIMessageChunk, streamText } from "ai";
+//#region src/ai-sdk-step.d.ts
+type StreamTextOptions<T extends ToolSet$1> = Parameters<typeof streamText<T>>[0];
+type ModelStepTimeout<T extends ToolSet$1> = number | Omit<Exclude<StreamTextOptions<T>["timeout"], number | undefined>, "toolMs" | "tools">;
+type ControlledStreamTextSetting = "_internal" | "abortSignal" | "instructions" | "messages" | "model" | "onToolExecutionEnd" | "onToolExecutionStart" | "experimental_onToolCallFinish" | "experimental_onToolCallStart" | "experimental_sandbox" | "experimental_toolCallers" | "experimental_toolApprovalSecret" | "prompt" | "prepareStep" | "stopWhen" | "system" | "tools" | "toolsContext";
+/** AI SDK streamText settings that remain meaningful for one durable step. */
+type AISDKStepSettings<T extends ToolSet$1> = Partial<Omit<StreamTextOptions<T>, ControlledStreamTextSetting | "timeout">> & {
+  timeout?: ModelStepTimeout<T>;
+};
+//#endregion
 //#region src/ai-server.d.ts
+declare function validateAgentPush(context: PushValidationContext): void;
 type AgentGenerateContext<M extends UIMessage, D extends AIEventDefs<M> & EventDefs, T extends ToolSet> = {
   request: ContractEvent<D, "ai.generation.requested">;
   requestId: string;
@@ -33,15 +43,17 @@ type CompactionPolicy<M extends UIMessage, D extends AIEventDefs<M> & EventDefs>
     messages: M[];
   }): M[] | Promise<M[]>;
 };
-type AgentGenerationSettings<T extends ToolSet> = Partial<Omit<ToolLoopAgentSettings<never, T>, "id" | "model" | "tools" | "instructions" | "callOptionsSchema" | "prepareCall">>;
+type AgentGenerationSettings<T extends ToolSet> = AISDKStepSettings<T>;
 type CreateHandlersOptions<M extends UIMessage, D extends AIEventDefs<M> & EventDefs, T extends ToolSet = ToolSet> = {
   agent: AgentDefinition<M, D>;
   /** AI SDK model string or provider model, optionally resolved per generation. */
   model: Resolvable<LanguageModel, AgentResolverContext<M, D>>;
   tools?: T;
   instructions?: Resolvable<Instructions | undefined, AgentResolverContext<M, D>>;
-  /** Passed to AI SDK's ToolLoopAgent. */
+  /** Settings for each one-step AI SDK streamText call. */
   generation?: AgentGenerationSettings<T>;
+  /** Maximum model steps in one assistant response. Defaults to 20. */
+  maxSteps?: number;
   /** Replace model generation with an AI SDK UI message chunk stream. */
   generate?: AgentGenerate<M, D, T>;
   compaction?: CompactionPolicy<M, D>;
@@ -51,7 +63,7 @@ type CreateHandlersOptions<M extends UIMessage, D extends AIEventDefs<M> & Event
     maxDelayMs?: number;
   };
 };
-type CreateAgentServerOptions<M extends UIMessage, D extends AIEventDefs<M> & EventDefs, T extends ToolSet = ToolSet> = CreateHandlersOptions<M, D, T> & Omit<ServerOptions<D>, "contract" | "handlers"> & {
+type CreateAgentServerOptions<M extends UIMessage, D extends AIEventDefs<M> & EventDefs, T extends ToolSet = ToolSet> = CreateHandlersOptions<M, D, T> & Omit<ServerOptions<D>, "contract" | "handlers" | "validatePush"> & {
   handlers?: ServerOptions<D>["handlers"];
 };
 /**
@@ -62,4 +74,4 @@ declare function createHandlers<M extends UIMessage, D extends AIEventDefs<M> &
 /** Assemble an A2 server with the built-in agent handlers and app extensions. */
 declare function createAgentServer<M extends UIMessage, D extends AIEventDefs<M> & EventDefs, T extends ToolSet = ToolSet>(options: CreateAgentServerOptions<M, D, T>): A2Server<D>;
 //#endregion
-export { AgentGenerate, AgentGenerateContext, AgentGenerationSettings, AgentResolverContext, CompactionPolicy, CreateAgentServerOptions, CreateHandlersOptions, type Instructions, type LanguageModel, Resolvable, type ToolLoopAgentSettings, type ToolSet, createAgentServer, createHandlers };
+export { AgentGenerate, AgentGenerateContext, AgentGenerationSettings, AgentResolverContext, CompactionPolicy, CreateAgentServerOptions, CreateHandlersOptions, type Instructions, type LanguageModel, Resolvable, type ToolSet, createAgentServer, createHandlers, validateAgentPush };