experimental-a2 0.6.0 → 0.8.0

package/dist/ai-D_PGS-JR.d.ts

@@ -1,334 +0,0 @@
-import { a as EventDefs, h as StandardSchemaV1, n as Contract, p as Reducer, t as AppendInput } from "./contract-jIfaR085.js";
-import { s as HandlerContext } from "./server-DpvjhdoE.js";
-import { FinishReason, JSONValue, LanguageModelUsage, UIMessage as UIMessage$1, UIMessageChunk as UIMessageChunk$1 } from "ai";
-//#region src/ai.d.ts
-type AgentStatus = "idle" | "generating" | "waiting" | "failed" | "closed";
-type GenerationReason = "message" | "tool" | "input" | "retry";
-type SessionCreatedPayload = {
-  metadata?: JSONValue;
-};
-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;
-};
-type MessageCompletedPayload = {
-  messageId: string;
-};
-type MessageInterruption = {
-  messageId: string;
-  reason?: string;
-  /** Last confirmed event-log index visible to the interrupter. */
-  lastSeenIndex?: number;
-};
-type MessageInterruptedPayload = MessageInterruption & ({
-  generationId: string;
-  requestId?: never;
-} | {
-  requestId: string;
-  generationId?: never;
-});
-type GenerationRequestedPayload = {
-  messageId: string;
-  reason: GenerationReason;
-  responseMessageId?: string;
-};
-type RetryGenerationOptions = {
-  messageId: string;
-  responseMessageId: string;
-  retryId: string;
-};
-type RetryRequestedPayload = RetryGenerationOptions;
-type GenerationStartedPayload = {
-  requestId: string;
-  messageId: string;
-  generationId: string;
-  responseMessageId: string;
-  attempt: number;
-  model: string;
-};
-type GenerationProgressPayload = {
-  requestId: string;
-  messageId: string;
-  generationId: string;
-  responseMessageId: string;
-  sequence: number;
-  chunks: UIMessageChunk$1[];
-};
-type GenerationCompletedPayload = {
-  requestId: string;
-  messageId: string;
-  generationId: string;
-  responseMessageId: string;
-  finishReason?: FinishReason;
-  usage?: LanguageModelUsage;
-};
-type GenerationFailedPayload = {
-  requestId: string;
-  messageId: string;
-  generationId: string;
-  responseMessageId: string;
-  error: string;
-  /** True when a later attempt replaced an incomplete attempt. */
-  superseded?: boolean;
-  stepLimit?: boolean;
-};
-type ToolCalledPayload = {
-  requestId: string;
-  messageId: string;
-  generationId: string;
-  toolCallId: string;
-  toolName: string;
-  input: unknown;
-  dynamic?: boolean;
-  providerExecuted?: boolean;
-  supportsDeferredResults?: boolean;
-  providerMetadata?: unknown;
-  toolMetadata?: unknown;
-  title?: string;
-};
-type ToolResultPayload = {
-  requestId: string;
-  messageId: string;
-  generationId: string;
-  toolCallId: string;
-  toolName?: string;
-  input?: unknown;
-  rawInput?: unknown;
-  output?: unknown;
-  error?: string;
-  denied?: boolean;
-  preliminary?: boolean;
-  phase?: "input" | "execution";
-  dynamic?: boolean;
-  providerExecuted?: boolean;
-  providerMetadata?: unknown;
-  toolMetadata?: unknown;
-};
-type ApprovalRequestedPayload = {
-  messageId: string;
-  generationId: string;
-  approvalId: string;
-  toolCallId: string;
-  isAutomatic?: boolean;
-  signature?: string;
-};
-type ApprovalRespondedPayload = {
-  messageId: string;
-  generationId: string;
-  approvalId: string;
-  approved: boolean;
-  reason?: string;
-};
-type InputRequestedPayload = {
-  messageId: string;
-  generationId: string;
-  inputId: string;
-  name: string;
-  question?: JSONValue;
-};
-type InputRespondedPayload = {
-  messageId: string;
-  generationId: string;
-  inputId: string;
-  name: string;
-  value: JSONValue;
-};
-type CompactionRequestedPayload = {
-  generationId: string;
-  throughMessageId: string;
-};
-type CompactionCompletedPayload<M extends UIMessage$1> = {
-  generationId: string;
-  throughMessageId: string;
-  messages: M[];
-  retainedMessageIds?: string[];
-};
-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.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>;
-  "ai.generation.failed": StandardSchemaV1<GenerationFailedPayload>;
-  "ai.tool.called": StandardSchemaV1<ToolCalledPayload>;
-  "ai.tool.result": StandardSchemaV1<ToolResultPayload>;
-  "ai.approval.requested": StandardSchemaV1<ApprovalRequestedPayload>;
-  "ai.approval.responded": StandardSchemaV1<ApprovalRespondedPayload>;
-  "ai.input.requested": StandardSchemaV1<InputRequestedPayload>;
-  "ai.input.responded": StandardSchemaV1<InputRespondedPayload>;
-  "ai.compaction.requested": StandardSchemaV1<CompactionRequestedPayload>;
-  "ai.compaction.completed": StandardSchemaV1<CompactionCompletedPayload<M>>;
-};
-type ActiveGeneration = GenerationStartedPayload;
-type ActiveGenerationProjection<M extends UIMessage$1 = UIMessage$1> = {
-  generationId: string;
-  responseMessageId: string;
-  /** Log index of the completed model step while its response remains interruptible. */
-  completionIndex?: number;
-  baseMessage?: M;
-  baseCompaction?: CompactionState<M> | null;
-  batches: Array<{
-    index: number;
-    chunks: UIMessageChunk$1[];
-  }>;
-  baseTools: ToolActivity[];
-  toolEvents: Array<{
-    index: number;
-    type: "ai.tool.called";
-    payload: ToolCalledPayload;
-  } | {
-    index: number;
-    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;
-type ToolActivity = {
-  requestId: string;
-  messageId: string;
-  generationId: string;
-  toolCallId: string;
-  toolName?: string;
-  input?: unknown;
-  rawInput?: unknown;
-  output?: unknown;
-  error?: string;
-  preliminary?: boolean;
-  phase?: "input" | "execution";
-  dynamic?: boolean;
-  providerExecuted?: boolean;
-  callProviderMetadata?: unknown;
-  resultProviderMetadata?: unknown;
-  toolMetadata?: unknown;
-  title?: string;
-  status: "running" | "completed" | "failed" | "denied";
-};
-type CompactionState<M extends UIMessage$1> = {
-  status: "running" | "completed";
-  generationId: string;
-  throughMessageId: string;
-  messages?: M[];
-  retainedMessageIds?: string[];
-};
-type GenerationUsage = {
-  generationId: string;
-  usage: LanguageModelUsage;
-};
-type AIState<M extends UIMessage$1 = UIMessage$1> = {
-  session: {
-    created: boolean;
-    metadata?: JSONValue;
-  };
-  messages: M[];
-  status: AgentStatus;
-  activeGeneration: ActiveGeneration | null;
-  activeRequestId: string | null;
-  activeResponseMessageId: string | null;
-  activeProjection: ActiveGenerationProjection<M> | null;
-  responseGenerationIds: Record<string, string>;
-  terminalRequestIds?: Record<string, true>;
-  terminalGenerations?: Record<string, "completed" | "failed" | "interrupted" | "superseded">;
-  pendingApprovals: PendingApproval[];
-  pendingInputs: PendingInput[];
-  tools: ToolActivity[];
-  compaction: CompactionState<M> | null;
-  usage: GenerationUsage[];
-  error: string | null;
-};
-type AgentDefinition<M extends UIMessage$1 = UIMessage$1, D extends EventDefs = AIEventDefs<M>> = {
-  readonly contract: Contract<D>;
-  readonly reducer: Reducer<D, AIState<M>>;
-};
-type AgentToolEventDefs = EventDefs & Pick<AIEventDefs, "ai.tool.called" | "ai.approval.responded">;
-/** The durable handler context supplied when A2 executes a local AI tool. */
-type AgentToolContext<D extends AgentToolEventDefs> = HandlerContext<D, "ai.tool.called"> | HandlerContext<D, "ai.approval.responded">;
-type AgentOptions<M extends UIMessage$1, E extends EventDefs> = {
-  name: string;
-  events?: E;
-  /** Optional stricter schema for custom UIMessage metadata/data/tool types. */
-  messageSchema?: StandardSchemaV1<M>;
-  /** Snapshot identity. Bump when application-level projection semantics change. */
-  reducerName?: string;
-};
-type AIMessageFrom<D extends EventDefs> = D extends Record<"ai.message.created", infer S extends StandardSchemaV1> ? StandardSchemaV1.InferOutput<S> extends MessageCreatedPayload<infer M extends UIMessage$1> ? M : UIMessage$1 : UIMessage$1;
-declare function createEvents<M extends UIMessage$1 = UIMessage$1>(options?: {
-  messageSchema?: StandardSchemaV1<M>;
-}): AIEventDefs<M>;
-declare const events: AIEventDefs<UIMessage$1>;
-/** Pure projection of the built-in AI protocol. Unknown extension events are ignored. */
-declare function reduceAIState<M extends UIMessage$1>(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$1 = UIMessage$1>(history: readonly {
-  type: string;
-  payload: unknown;
-  index: number;
-}[]): M[];
-/** Build the standard AI state projection for any contract containing the protocol. */
-declare function createReducer<D extends EventDefs>(options: {
-  contract: Contract<D>;
-  name?: string;
-}): Reducer<D, AIState<AIMessageFrom<D>>>;
-type ProtocolInput<M extends UIMessage$1, K extends keyof AIEventDefs<M> & string> = AppendInput<Pick<AIEventDefs<M>, K>>;
-type AIInputs = {
-  /** Record a message. User messages schedule unless generate is false. */
-  message<M extends UIMessage$1>(message: M, options?: {
-    generate?: boolean;
-  }): ProtocolInput<M, "ai.message.created">[];
-  /** Record a message without requesting a generation. */
-  seed<M extends UIMessage$1>(message: M): ProtocolInput<M, "ai.message.created">[];
-  /** Answer an AI SDK tool approval. The tool barrier owns continuation. */
-  approval(response: ApprovalRespondedPayload): ProtocolInput<UIMessage$1, "ai.approval.responded">[];
-  /** Answer an application-defined input request. */
-  input(response: InputRespondedPayload): ProtocolInput<UIMessage$1, "ai.input.responded">[];
-  /** Record an application-defined request for input. */
-  requestInput(request: InputRequestedPayload): ProtocolInput<UIMessage$1, "ai.input.requested">[];
-  /** Request a fresh attempt for a failed response. */
-  retry(options: RetryGenerationOptions): ProtocolInput<UIMessage$1, "ai.retry.requested">[];
-  /** Interrupt the active response for a message. */
-  interrupt(interruption: MessageInterruptedPayload): ProtocolInput<UIMessage$1, "ai.message.interrupted">[];
-};
-/** Pure append inputs for the built-in AI protocol. */
-declare const inputs: AIInputs;
-/**
- * Read the durable handler context ambient to the current AI tool
- * execution. A2 runs each local tool's `execute` inside this scope, so
- * plain AI SDK `tool()` definitions reach their `event`, `attempt`,
- * `session`, and `signal` without an A2-specific wrapper. The agent (or
- * contract) argument carries the event types and is verified against
- * the executing server's contract.
- */
-declare function handlerContext<D extends AgentToolEventDefs>(agentOrContract: Contract<D> | {
-  readonly contract: Contract<D>;
-}): AgentToolContext<D>;
-/**
- * Define an agent: built-in AI protocol + application events and one state
- * reducer. The result is isomorphic.
- */
-declare function agent<M extends UIMessage$1 = UIMessage$1, E extends EventDefs = Record<never, never>>(options: AgentOptions<M, E>): AgentDefinition<M, AIEventDefs<M> & E>;
-//#endregion
-export { MessageInterruptedPayload as A, UIMessage$1 as B, GenerationUsage as C, LanguageModelUsage as D, JSONValue as E, SessionClosedPayload as F, deriveUIMessages as G, agent as H, SessionCreatedPayload as I, inputs as J, events as K, ToolActivity as L, PendingInput as M, RetryGenerationOptions as N, MessageCompletedPayload as O, RetryRequestedPayload as P, ToolCalledPayload as R, GenerationStartedPayload as S, InputRespondedPayload as T, createEvents as U, UIMessageChunk$1 as V, createReducer as W, reduceAIState as Y, GenerationCompletedPayload as _, ActiveGenerationProjection as a, GenerationReason as b, AgentStatus as c, ApprovalRequestedPayload as d, ApprovalRespondedPayload as f, FinishReason as g, CompactionState as h, ActiveGeneration as i, PendingApproval as j, MessageCreatedPayload as k, AgentToolContext as l, CompactionRequestedPayload as m, AIInputs as n, AgentDefinition as o, CompactionCompletedPayload as p, handlerContext as q, AIState as r, AgentOptions as s, AIEventDefs as t, AgentToolEventDefs as u, GenerationFailedPayload as v, InputRequestedPayload as w, GenerationRequestedPayload as x, GenerationProgressPayload as y, ToolResultPayload as z };
-//# sourceMappingURL=ai-D_PGS-JR.d.ts.map

package/dist/ai-D_PGS-JR.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai-D_PGS-JR.d.ts","names":[],"sources":["../src/ai.ts"],"mappings":"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"}