experimental-a2 0.6.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## 0.8.0
+
+### Minor Changes
+
+- d8f2793: Make handler state reads event-relative. `ctx.session.state(reducer)` now folds
+  through the triggering event, so concurrent appends do not change what retries
+  observe. Pass `{ through: 'latest' }` for an intentional live read, or a numeric
+  `through` for an inclusive boundary.
+
+  A2 now keeps one reducer snapshot head plus only the historical checkpoints
+  currently referenced by unfinished handler events. Completion and
+  dead-lettering release those references and collect orphan history atomically.
+  Root reads and handler latest reads do not retain historical checkpoints. There
+  are no retention knobs.
+
+  AI handlers now recheck cancellation immediately before invoking a tool or
+  model, so work canceled during asynchronous prompt or instruction resolution
+  does not cross an external execution boundary.
+
+## 0.7.0
+
+### Minor Changes
+
+- eaf38cd: Replace the `experimental-a2/http` adapter and `handle(server, options)` with a
+  bound `server.fetch(request, options?)` method. Unprotected framework routes can
+  now export `server.fetch` directly, while protected routes pass a request-scoped
+  `authorize` callback over typed stream, history, and push operations.
+
+  WebSocket upgrades are supplied through the per-request `upgradeWebSocket`
+  capability. Each socket subscription and push is authorized independently;
+  physical upgrade authentication remains the application's responsibility.
+  Invocation deadlines and `waitUntil` remain ambient platform capabilities.
+
+  Remove the `experimental-a2/http` entry point, its before/after hooks, public
+  transport helpers, and legacy push validation surface. Scheduler callbacks now
+  use the configured scheduler's `handler(...servers)` method directly.
+
+  Remove the Devtools dashboard, protocol, capture format, CLI, testing helpers,
+  and store inspection capability. Redis no longer maintains the global session
+  index that existed only for Devtools discovery.
+
 ## 0.6.0
 
 ### Minor Changes

package/dist/ai-server.d.ts

@@ -1,6 +1,6 @@
 import { a as EventDefs, r as ContractEvent } from "./contract-jIfaR085.js";
-import { d as PushValidationContext, g as ServerOptions, n as A2Server } from "./server-DpvjhdoE.js";
-import { l as AgentToolContext, o as AgentDefinition, r as AIState, t as AIEventDefs, u as AgentToolEventDefs } from "./ai-D_PGS-JR.js";
+import { n as A2Server, p as ServerOptions } from "./server-DjPhHnbI.js";
+import { AIEventDefs, AIState, AgentDefinition, AgentToolContext, AgentToolEventDefs } from "./ai.js";
 import { Instructions, LanguageModel, TextStreamPart, 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];
@@ -38,7 +38,6 @@ type AISDKStepSettings<T extends ToolSet$1> = Partial<Omit<StreamTextOptions<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;
@@ -100,7 +99,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" | "validatePush"> & {
+type CreateAgentServerOptions<M extends UIMessage, D extends AIEventDefs<M> & EventDefs, T extends ToolSet = ToolSet> = CreateHandlersOptions<M, D, T> & Omit<ServerOptions<D>, "contract" | "handlers"> & {
   handlers?: ServerOptions<D>["handlers"];
 };
 /** Run `fn` with `ctx` as the ambient tool handler context, for direct tool tests. */
@@ -113,5 +112,5 @@ 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, AgentMessageMetadata, AgentResolverContext, CompactionPolicy, CreateAgentServerOptions, CreateHandlersOptions, type Instructions, type LanguageModel, Resolvable, type ToolSet, createAgentServer, createHandlers, runWithHandlerContext, validateAgentPush };
+export { AgentGenerate, AgentGenerateContext, AgentGenerationSettings, AgentMessageMetadata, AgentResolverContext, CompactionPolicy, CreateAgentServerOptions, CreateHandlersOptions, type Instructions, type LanguageModel, Resolvable, type ToolSet, createAgentServer, createHandlers, runWithHandlerContext };
 //# sourceMappingURL=ai-server.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ai-server.d.ts","names":[],"sources":["../src/ai-sdk-step.ts","../src/ai-server.ts"],"mappings":";;;;;KAiBK,kBAAkB,UAAU,aAAW,kBAAkB,WAAW;KAKpE,iBAAiB,UAAU,sBAE5B,KACE,QAAQ,kBAAkB;KAI3B;KAmBA;KASA,iBAAiB,UAAU,yBACpB,WAAW,IAAI,KAAK,EAAE;KAG7B,aAAa,UAAU,WAAS,gBAAgB,kBAAkB,MACrE,YAAY,kBAAkB,GAAG,cAAa,aAAa,qBACvD;KAGD,qBAAqB,UAAU,aAAW,KAC7C,aAAa;WAGJ,OAAO,iBAAiB;;KAG9B,yBAAyB,UAAU,aAAW,KACjD,aAAa;WAGJ,OAAO,iBAAiB;;KAG9B,mBAAmB,UAAU,OAAO,iBAAiB;KAErD,yBAAyB,UAAU,aAAW,YACjD,kBAAkB;KAGf,yBAAyB,UAAU,cACtC,SAAS,KAAK,WAAW,yBAAyB;EAChD,OAAO,iBAAiB;MAEvB,WAAW,yBAAyB;KAEpC,2BAA2B,UAAU,aAAW,YACnD,kBAAkB;KAGf,oBAAoB,UAAU,aAAW,QAC5C,2BAA2B,QACvB;KAGD,oBAAoB,UAAU,cACjC,SAAS,KAAK,WAAW,oBAAoB;EAC3C,OAAO,iBAAiB;MAEvB,WAAW,oBAAoB;;KAGxB,kBAAkB,UAAU,aAAW,QACjD,KACE,kBAAkB,IAClB,8BAA8B;EAGhC,UAAU,iBAAiB;EAC3B,UAAU,mBAAmB,qBAAqB;EAClD,uBAAuB,mBAAmB,qBAAqB;EAC/D,cAAc,mBAAmB,yBAAyB;EAC1D,2BAA2B,mBAAmB,yBAAyB;EACvE,iBAAiB,yBAAyB;EAC1C,8BAA8B,yBAAyB;EACvD,yBACE,oBAAoB,KAAK,MAAM,oBAAoB;;;;iBC3DvC,kBAAkB,SAAS;KA0C/B,qBACV,UAAU,WACV,UAAU,YAAY,KAAK,WAC3B,UAAU;EAEV,SAAS,cAAc;EACvB;EACA;EACA;EACA,UAAU;EACV,OAAO,QAAQ;EACf,SAAS,cAAc;EACvB,QAAQ;EACR,OAAO;EACP,OAAO;EACP,eAAe;EACf,YAAY,wBAAwB;;KAG1B,cACV,UAAU,WACV,UAAU,YAAY,KAAK,WAC3B,UAAU,YAEV,SAAS,qBAAqB,GAAG,GAAG,OACjC,eAAe,kBAAkB,QAAQ,eAAe;KAExD,kBAAkB,UAAU,aAC/B,UAAU,gBAAgB,YAAY;KAE5B,qBACV,UAAU,WACV,UAAU,YAAY,KAAK,WAC3B,UAAU,YAEV,SAAS,qBAAqB,GAAG,GAAG;EAAO,MAAM,eAAe;MAC7D,kBAAkB;KAEX,qBACV,UAAU,WACV,UAAU,YAAY,KAAK;EAE3B,OAAO,cAAc;EACrB,OAAO,QAAQ;EACf,SAAS,cAAc;EACvB,QAAQ;;KAGE,WAAW,GAAG,KAAK,MAAM,SAAS,MAAM,IAAI,QAAQ;KAEpD,iBACV,UAAU,WACV,UAAU,YAAY,KAAK;EAE3B,cACE,SAAS,qBAAqB,GAAG;IAAO,UAAU;gBACvC;EACb,QACE,SAAS,qBAAqB,GAAG;IAAO,UAAU;MACjD,MAAM,QAAQ;;KAGP,wBAAwB,UAAU,WAAW,kBAAkB;KAE/D,sBACV,UAAU,WACV,UAAU,YAAY,KAAK,WAC3B,UAAU,UAAU;EAEpB,OAAO,gBAAgB,GAAG;;EAE1B,OAAO,WAAW,eAAe,qBAAqB,GAAG;EACzD,QAAQ;EACR,eAAe,WACb,0BACA,qBAAqB,GAAG;;EAG1B,aAAa,wBAAwB;;;;EAIrC;;EAEA,kBAAkB,qBAAqB,GAAG,GAAG;;;;;EAK7C,WAAW,cAAc,GAAG,GAAG;EAC/B,aAAa,iBAAiB,GAAG;;EAEjC;IAAa;IAAoB;;;KAGvB,yBACV,UAAU,WACV,UAAU,YAAY,KAAK,WAC3B,UAAU,UAAU,WAClB,sBAAsB,GAAG,GAAG,KAC9B,KAAK,cAAc;EACjB,WAAW,cAAc;;;iBA2Bb,sBAAsB,UAAU,oBAAoB,GAClE,KAAK,iBAAiB,IACtB,UAAU,IACT;;;;;iBA2hBa,eACd,UAAU,WACV,UAAU,YAAY,KAAK,WAC3B,UAAU,UAAU,SAEpB,SAAS,sBAAsB,GAAG,GAAG,KACpC,YAAY,cAAc;;iBAk4Bb,kBACd,UAAU,WACV,UAAU,YAAY,KAAK,WAC3B,UAAU,UAAU,SACpB,SAAS,yBAAyB,GAAG,GAAG,KAAK,SAAS"}
+{"version":3,"file":"ai-server.d.ts","names":[],"sources":["../src/ai-sdk-step.ts","../src/ai-server.ts"],"mappings":";;;;;KAiBK,kBAAkB,UAAU,aAAW,kBAAkB,WAAW;KAKpE,iBAAiB,UAAU,sBAE5B,KACE,QAAQ,kBAAkB;KAI3B;KAmBA;KASA,iBAAiB,UAAU,yBACpB,WAAW,IAAI,KAAK,EAAE;KAG7B,aAAa,UAAU,WAAS,gBAAgB,kBAAkB,MACrE,YAAY,kBAAkB,GAAG,cAAa,aAAa,qBACvD;KAGD,qBAAqB,UAAU,aAAW,KAC7C,aAAa;WAGJ,OAAO,iBAAiB;;KAG9B,yBAAyB,UAAU,aAAW,KACjD,aAAa;WAGJ,OAAO,iBAAiB;;KAG9B,mBAAmB,UAAU,OAAO,iBAAiB;KAErD,yBAAyB,UAAU,aAAW,YACjD,kBAAkB;KAGf,yBAAyB,UAAU,cACtC,SAAS,KAAK,WAAW,yBAAyB;EAChD,OAAO,iBAAiB;MAEvB,WAAW,yBAAyB;KAEpC,2BAA2B,UAAU,aAAW,YACnD,kBAAkB;KAGf,oBAAoB,UAAU,aAAW,QAC5C,2BAA2B,QACvB;KAGD,oBAAoB,UAAU,cACjC,SAAS,KAAK,WAAW,oBAAoB;EAC3C,OAAO,iBAAiB;MAEvB,WAAW,oBAAoB;;KAGxB,kBAAkB,UAAU,aAAW,QACjD,KACE,kBAAkB,IAClB,8BAA8B;EAGhC,UAAU,iBAAiB;EAC3B,UAAU,mBAAmB,qBAAqB;EAClD,uBAAuB,mBAAmB,qBAAqB;EAC/D,cAAc,mBAAmB,yBAAyB;EAC1D,2BAA2B,mBAAmB,yBAAyB;EACvE,iBAAiB,yBAAyB;EAC1C,8BAA8B,yBAAyB;EACvD,yBACE,oBAAoB,KAAK,MAAM,oBAAoB;;;;KCd3C,qBACV,UAAU,WACV,UAAU,YAAY,KAAK,WAC3B,UAAU;EAEV,SAAS,cAAc;EACvB;EACA;EACA;EACA,UAAU;EACV,OAAO,QAAQ;EACf,SAAS,cAAc;EACvB,QAAQ;EACR,OAAO;EACP,OAAO;EACP,eAAe;EACf,YAAY,wBAAwB;;KAG1B,cACV,UAAU,WACV,UAAU,YAAY,KAAK,WAC3B,UAAU,YAEV,SAAS,qBAAqB,GAAG,GAAG,OACjC,eAAe,kBAAkB,QAAQ,eAAe;KAExD,kBAAkB,UAAU,aAC/B,UAAU,gBAAgB,YAAY;KAE5B,qBACV,UAAU,WACV,UAAU,YAAY,KAAK,WAC3B,UAAU,YAEV,SAAS,qBAAqB,GAAG,GAAG;EAAO,MAAM,eAAe;MAC7D,kBAAkB;KAEX,qBACV,UAAU,WACV,UAAU,YAAY,KAAK;EAE3B,OAAO,cAAc;EACrB,OAAO,QAAQ;EACf,SAAS,cAAc;EACvB,QAAQ;;KAGE,WAAW,GAAG,KAAK,MAAM,SAAS,MAAM,IAAI,QAAQ;KAEpD,iBACV,UAAU,WACV,UAAU,YAAY,KAAK;EAE3B,cACE,SAAS,qBAAqB,GAAG;IAAO,UAAU;gBACvC;EACb,QACE,SAAS,qBAAqB,GAAG;IAAO,UAAU;MACjD,MAAM,QAAQ;;KAGP,wBAAwB,UAAU,WAAW,kBAAkB;KAE/D,sBACV,UAAU,WACV,UAAU,YAAY,KAAK,WAC3B,UAAU,UAAU;EAEpB,OAAO,gBAAgB,GAAG;;EAE1B,OAAO,WAAW,eAAe,qBAAqB,GAAG;EACzD,QAAQ;EACR,eAAe,WACb,0BACA,qBAAqB,GAAG;;EAG1B,aAAa,wBAAwB;;;;EAIrC;;EAEA,kBAAkB,qBAAqB,GAAG,GAAG;;;;;EAK7C,WAAW,cAAc,GAAG,GAAG;EAC/B,aAAa,iBAAiB,GAAG;;EAEjC;IAAa;IAAoB;;;KAGvB,yBACV,UAAU,WACV,UAAU,YAAY,KAAK,WAC3B,UAAU,UAAU,WAClB,sBAAsB,GAAG,GAAG,KAC9B,KAAK,cAAc;EACjB,WAAW,cAAc;;;iBA2Bb,sBAAsB,UAAU,oBAAoB,GAClE,KAAK,iBAAiB,IACtB,UAAU,IACT;;;;;iBA2hBa,eACd,UAAU,WACV,UAAU,YAAY,KAAK,WAC3B,UAAU,UAAU,SAEpB,SAAS,sBAAsB,GAAG,GAAG,KACpC,YAAY,cAAc;;iBAm5Bb,kBACd,UAAU,WACV,UAAU,YAAY,KAAK,WAC3B,UAAU,UAAU,SACpB,SAAS,yBAAyB,GAAG,GAAG,KAAK,SAAS"}

package/dist/ai-server.js

@@ -1,6 +1,6 @@
 import { t as A2Error } from "./errors-BQuJpe82.js";
-import { m as installAmbientToolScopeStorage, p as consumeSchedulerSendFailure } from "./internal-DstsI6Re.js";
-import { t as createServer } from "./server-Duw6MVlB.js";
+import { f as consumeSchedulerSendFailure, p as installAmbientToolScopeStorage } from "./internal-DRXJ56EI.js";
+import { r as setServerFetchHooks, t as createServer } from "./server-B2XNevQA.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { convertToModelMessages, stepCountIs, streamText, toUIMessageStream } from "ai";
 //#region src/ai-sdk-step.ts
@@ -278,7 +278,7 @@ const continuationReady = (state) => {
 * `createHandlers()` exposes the ordinary A2 handler table;
 * `createAgentServer()` is its batteries-included assembly with createServer.
 */
-function validateAgentPush(context) {
+function validateAgentIngress(context) {
 	const rejected = context.events.find((event) => {
 		if (event.type !== "ai.message.created") return !(event.type === "ai.approval.responded" || event.type === "ai.input.responded" || event.type === "ai.message.interrupted" || event.type === "ai.retry.requested");
 		const payload = event.payload;
@@ -674,9 +674,9 @@ function createHandlers(options) {
 			}
 		};
 	};
-	const scheduleNext = async (ctx) => requestForNextMessage((await ctx.session.state(coordinator)).state);
+	const scheduleNext = async (ctx) => requestForNextMessage((await ctx.session.state(coordinator, { through: "latest" })).state);
 	const continueIfReady = async (ctx, generationId) => {
-		const state = (await ctx.session.state(coordinator)).state;
+		const state = (await ctx.session.state(coordinator, { through: "latest" })).state;
 		const response = state.response;
 		if (response?.generation?.generationId !== generationId) return;
 		const input = response.inputResponse;
@@ -805,6 +805,7 @@ function createHandlers(options) {
 		const execute = tools[call.toolName]?.execute;
 		if (execute === void 0) return resultEvent(call, "execution:error", { error: `Tool '${call.toolName}' has no server executor` });
 		const messages = await promptMessages(ctx.event.sessionId, call, ctx.session.history);
+		if (ctx.signal.aborted) return;
 		const scope = {
 			contract: options.agent.contract,
 			context: ctx
@@ -812,7 +813,7 @@ function createHandlers(options) {
 		return toolScopeStorage.run(scope, () => runToolExecution(ctx, call, execute, messages));
 	};
 	const handleToolCall = async (ctx) => {
-		const response = (await ctx.session.state(coordinator)).state.response;
+		const response = (await ctx.session.state(coordinator, { through: "latest" })).state.response;
 		const current = response?.calls.find((candidate) => candidate.index === ctx.event.index);
 		if (current === void 0 || response?.generation?.generationId !== ctx.event.payload.generationId || response.failure !== void 0 || current.terminal || current.approval !== void 0) return;
 		if (current.call.providerExecuted === true) {
@@ -822,7 +823,7 @@ function createHandlers(options) {
 		return executeTool(ctx, current.call);
 	};
 	const handleApproval = async (ctx) => {
-		const response = (await ctx.session.state(coordinator)).state.response;
+		const response = (await ctx.session.state(coordinator, { through: "latest" })).state.response;
 		const current = response?.calls.find((candidate) => candidate.approval?.approvalId === ctx.event.payload.approvalId && candidate.approval.messageId === ctx.event.payload.messageId && candidate.approval.generationId === ctx.event.payload.generationId && candidate.responseIndex === ctx.event.index);
 		if (current === void 0 || response?.generation?.generationId !== current.call.generationId || response.failure !== void 0 || current.terminal) return;
 		if (current.call.providerExecuted === true) {
@@ -836,7 +837,7 @@ function createHandlers(options) {
 		const history = await ctx.session.history();
 		const requestId = ctx.event.id;
 		const request = ctx.event.payload;
-		const coordinatorState = (await ctx.session.state(coordinator)).state;
+		const coordinatorState = (await ctx.session.state(coordinator, { through: "latest" })).state;
 		if (coordinatorState.closed || coordinatorState.response?.activeRequestId !== requestId) return;
 		if (history.some((event) => {
 			if (event.type === "ai.generation.completed") return event.payload.requestId === requestId;
@@ -919,7 +920,7 @@ function createHandlers(options) {
 			payload: started
 		});
 		await ctx.session.append("generation-start", ...startEvents);
-		const startedCoordinatorState = (await ctx.session.state(coordinator)).state;
+		const startedCoordinatorState = (await ctx.session.state(coordinator, { through: "latest" })).state;
 		if (startedCoordinatorState.response?.activeRequestId !== requestId || startedCoordinatorState.response.generation?.generationId !== generationId) return;
 		const promptCoordinatorState = {
 			...coordinatorStateAt(history),
@@ -962,13 +963,14 @@ function createHandlers(options) {
 				};
 			}
 		}
-		const currentState = (await ctx.session.state(options.agent.reducer)).state;
-		const currentCoordinatorState = (await ctx.session.state(coordinator)).state;
+		const currentState = (await ctx.session.state(options.agent.reducer, { through: "latest" })).state;
+		const currentCoordinatorState = (await ctx.session.state(coordinator, { through: "latest" })).state;
 		const generationMessages = activeContextMessages(currentState, currentCoordinatorState);
 		promptCache.set(promptCacheKey(ctx.event.sessionId, generationId), convertToModelMessages(generationMessages, { tools }));
 		let pendingToolCalls = [];
 		try {
 			const resolvedInstructions = options.instructions === void 0 ? void 0 : await resolve(options.instructions, resolverContext);
+			if (ctx.signal.aborted) return;
 			const generateContext = {
 				request: ctx.event,
 				requestId,
@@ -1083,7 +1085,7 @@ function createHandlers(options) {
 		return scheduleNext(ctx);
 	};
 	const handleRetry = async (ctx) => {
-		const response = (await ctx.session.state(coordinator)).state.response;
+		const response = (await ctx.session.state(coordinator, { through: "latest" })).state.response;
 		if (response?.status !== "failed" || response.rootMessageId !== ctx.event.payload.messageId || response.responseMessageId !== ctx.event.payload.responseMessageId) return;
 		return {
 			type: "ai.generation.requested",
@@ -1096,7 +1098,7 @@ function createHandlers(options) {
 		};
 	};
 	const handleInputResponse = async (ctx) => {
-		const response = (await ctx.session.state(coordinator)).state.response;
+		const response = (await ctx.session.state(coordinator, { through: "latest" })).state.response;
 		if (response?.responseMessageId !== ctx.event.payload.messageId || response.inputResponse?.index !== ctx.event.index || response.inputResponse.generationId !== ctx.event.payload.generationId || response.inputResponse.inputId !== ctx.event.payload.inputId) return;
 		await continueIfReady(ctx, ctx.event.payload.generationId);
 	};
@@ -1186,17 +1188,18 @@ function createAgentServer(options) {
 		...compaction === void 0 ? {} : { compaction },
 		...progress === void 0 ? {} : { progress }
 	});
-	return createServer({
+	const server = createServer({
 		...serverOptions,
 		contract: definition.contract,
 		handlers: {
 			...builtIns,
 			...handlers
-		},
-		validatePush: validateAgentPush
+		}
 	});
+	setServerFetchHooks(server, { validateIngress: validateAgentIngress });
+	return server;
 }
 //#endregion
-export { createAgentServer, createHandlers, runWithHandlerContext, validateAgentPush };
+export { createAgentServer, createHandlers, runWithHandlerContext };
 
 //# sourceMappingURL=ai-server.js.map