experimental-a2 0.0.0 → 0.2.0

package/dist/ai.d.ts

@@ -1,8 +1,8 @@
-import { i as EventDefs, l as StandardSchemaV1, n as Contract, s as Reducer, t as AppendInput } from "./contract-DL8btVd9.js";
+import { a as EventDefs, c as Reducer, n as Contract, t as AppendInput, u as StandardSchemaV1 } from "./contract-C_3dIIEU.js";
 import { FinishReason, JSONValue, LanguageModelUsage, UIMessage, UIMessageChunk } from "ai";
 //#region src/ai.d.ts
 type AgentStatus = "idle" | "generating" | "waiting" | "failed" | "closed";
-type GenerationReason = "message" | "approval" | "input" | "retry";
+type GenerationReason = "message" | "tool" | "input" | "retry";
 type SessionCreatedPayload = {
   metadata?: JSONValue;
 };
@@ -32,6 +32,7 @@ type RetryGenerationOptions = {
   responseMessageId: string;
   retryId: string;
 };
+type RetryRequestedPayload = RetryGenerationOptions;
 type GenerationStartedPayload = {
   requestId: string;
   messageId: string;
@@ -64,6 +65,7 @@ type GenerationFailedPayload = {
   error: string;
   /** True when a later attempt replaced an incomplete attempt. */
   superseded?: boolean;
+  stepLimit?: boolean;
 };
 type ToolCalledPayload = {
   requestId: string;
@@ -74,6 +76,7 @@ type ToolCalledPayload = {
   input: unknown;
   dynamic?: boolean;
   providerExecuted?: boolean;
+  supportsDeferredResults?: boolean;
   providerMetadata?: unknown;
   toolMetadata?: unknown;
   title?: string;
@@ -106,19 +109,21 @@ type ApprovalRequestedPayload = {
 };
 type ApprovalRespondedPayload = {
   messageId: string;
+  generationId: string;
   approvalId: string;
   approved: boolean;
   reason?: string;
 };
 type InputRequestedPayload = {
   messageId: string;
-  generationId?: string;
+  generationId: string;
   inputId: string;
   name: string;
   question?: JSONValue;
 };
 type InputRespondedPayload = {
   messageId: string;
+  generationId: string;
   inputId: string;
   name: string;
   value: JSONValue;
@@ -131,6 +136,7 @@ type CompactionCompletedPayload<M extends UIMessage> = {
   generationId: string;
   throughMessageId: string;
   messages: M[];
+  retainedMessageIds?: string[];
 };
 type AIEventDefs<M extends UIMessage = UIMessage> = {
   "ai.session.created": StandardSchemaV1<SessionCreatedPayload>;
@@ -139,6 +145,7 @@ type AIEventDefs<M extends UIMessage = UIMessage> = {
   "ai.message.completed": StandardSchemaV1<MessageCompletedPayload>;
   "ai.message.interrupted": StandardSchemaV1<MessageInterruptedPayload>;
   "ai.generation.requested": StandardSchemaV1<GenerationRequestedPayload>;
+  "ai.retry.requested": StandardSchemaV1<RetryRequestedPayload>;
   "ai.generation.started": StandardSchemaV1<GenerationStartedPayload>;
   "ai.generation.progress": StandardSchemaV1<GenerationProgressPayload>;
   "ai.generation.completed": StandardSchemaV1<GenerationCompletedPayload>;
@@ -171,6 +178,15 @@ type ActiveGenerationProjection<M extends UIMessage = UIMessage> = {
     type: "ai.tool.result";
     payload: ToolResultPayload;
   }>;
+  approvalEvents: Array<{
+    index: number;
+    type: "ai.approval.requested";
+    payload: ApprovalRequestedPayload;
+  } | {
+    index: number;
+    type: "ai.approval.responded";
+    payload: ApprovalRespondedPayload;
+  }>;
 };
 type PendingApproval = ApprovalRequestedPayload;
 type PendingInput = InputRequestedPayload;
@@ -199,6 +215,7 @@ type CompactionState<M extends UIMessage> = {
   generationId: string;
   throughMessageId: string;
   messages?: M[];
+  retainedMessageIds?: string[];
 };
 type GenerationUsage = {
   generationId: string;
@@ -212,7 +229,10 @@ type AIState<M extends UIMessage = UIMessage> = {
   messages: M[];
   status: AgentStatus;
   activeGeneration: ActiveGeneration | null;
+  activeRequestId: string | null;
+  activeResponseMessageId: string | null;
   activeProjection: ActiveGenerationProjection<M> | null;
+  responseGenerationIds: Record<string, string>;
   pendingApprovals: PendingApproval[];
   pendingInputs: PendingInput[];
   tools: ToolActivity[];
@@ -242,6 +262,7 @@ declare function reduceAIState<M extends UIMessage>(state: AIState<M>, event: {
   type: string;
   payload: unknown;
   index: number;
+  id?: string;
 }): AIState<M>;
 /** Derive AI SDK UI messages directly from an A2 event history. */
 declare function deriveUIMessages<M extends UIMessage = UIMessage>(history: readonly {
@@ -256,18 +277,18 @@ declare function createReducer<D extends EventDefs>(options: {
 }): Reducer<D, AIState<AIMessageFrom<D>>>;
 type ProtocolInput<M extends UIMessage, K extends keyof AIEventDefs<M> & string> = AppendInput<Pick<AIEventDefs<M>, K>>;
 type AIInputs = {
-  /** Record a message; user messages request an assistant generation. */
-  message<M extends UIMessage>(message: M): ProtocolInput<M, "ai.message.created" | "ai.generation.requested">[];
+  /** Record a message. The server schedules user messages in arrival order. */
+  message<M extends UIMessage>(message: M): ProtocolInput<M, "ai.message.created">[];
   /** Record a message without requesting a generation. */
   seed<M extends UIMessage>(message: M): ProtocolInput<M, "ai.message.created">[];
-  /** Answer an AI SDK tool approval and request continuation. */
-  approval(response: ApprovalRespondedPayload): ProtocolInput<UIMessage, "ai.approval.responded" | "ai.generation.requested">[];
-  /** Answer an application-defined input request and request continuation. */
-  input(response: InputRespondedPayload): ProtocolInput<UIMessage, "ai.input.responded" | "ai.generation.requested">[];
+  /** Answer an AI SDK tool approval. The tool barrier owns continuation. */
+  approval(response: ApprovalRespondedPayload): ProtocolInput<UIMessage, "ai.approval.responded">[];
+  /** Answer an application-defined input request. */
+  input(response: InputRespondedPayload): ProtocolInput<UIMessage, "ai.input.responded">[];
   /** Record an application-defined request for input. */
   requestInput(request: InputRequestedPayload): ProtocolInput<UIMessage, "ai.input.requested">[];
   /** Request a fresh attempt for a failed response. */
-  retry(options: RetryGenerationOptions): ProtocolInput<UIMessage, "ai.generation.requested">[];
+  retry(options: RetryGenerationOptions): ProtocolInput<UIMessage, "ai.retry.requested">[];
   /** Interrupt the active response for a message. */
   interrupt(interruption: MessageInterruptedPayload): ProtocolInput<UIMessage, "ai.message.interrupted">[];
 };
@@ -279,4 +300,4 @@ declare const inputs: AIInputs;
  */
 declare function agent<M extends UIMessage = UIMessage, E extends EventDefs = Record<never, never>>(options: AgentOptions<M, E>): AgentDefinition<M, AIEventDefs<M> & E>;
 //#endregion
-export { AIEventDefs, AIInputs, AIState, ActiveGeneration, ActiveGenerationProjection, AgentDefinition, AgentOptions, AgentStatus, ApprovalRequestedPayload, ApprovalRespondedPayload, CompactionCompletedPayload, CompactionRequestedPayload, CompactionState, type FinishReason, GenerationCompletedPayload, GenerationFailedPayload, GenerationProgressPayload, GenerationReason, GenerationRequestedPayload, GenerationStartedPayload, GenerationUsage, InputRequestedPayload, InputRespondedPayload, type JSONValue, type LanguageModelUsage, MessageCompletedPayload, MessageCreatedPayload, MessageInterruptedPayload, PendingApproval, PendingInput, RetryGenerationOptions, SessionClosedPayload, SessionCreatedPayload, ToolActivity, ToolCalledPayload, ToolResultPayload, type UIMessage, type UIMessageChunk, agent, createEvents, createReducer, deriveUIMessages, events, inputs, reduceAIState };
+export { AIEventDefs, AIInputs, AIState, ActiveGeneration, ActiveGenerationProjection, AgentDefinition, AgentOptions, AgentStatus, ApprovalRequestedPayload, ApprovalRespondedPayload, CompactionCompletedPayload, CompactionRequestedPayload, CompactionState, type FinishReason, GenerationCompletedPayload, GenerationFailedPayload, GenerationProgressPayload, GenerationReason, GenerationRequestedPayload, GenerationStartedPayload, GenerationUsage, InputRequestedPayload, InputRespondedPayload, type JSONValue, type LanguageModelUsage, MessageCompletedPayload, MessageCreatedPayload, MessageInterruptedPayload, PendingApproval, PendingInput, RetryGenerationOptions, RetryRequestedPayload, SessionClosedPayload, SessionCreatedPayload, ToolActivity, ToolCalledPayload, ToolResultPayload, type UIMessage, type UIMessageChunk, agent, createEvents, createReducer, deriveUIMessages, events, inputs, reduceAIState };