@anvia/client 1.0.0-rc.2 → 1.0.0-rc.4

package/README.md

@@ -9,13 +9,16 @@ import { completionToClientStream, parseClientStreamRequest } from "@anvia/clien
 import { streamCompletion } from "@anvia/core";
 
 const request = parseClientStreamRequest(await httpRequest.json());
+if (request.type !== "messages") throw new Error("This endpoint does not resume interactions.");
 const events = completionToClientStream({
   events: streamCompletion({ model, messages: request.messages }),
 });
 ```
 
 The request carries core `Message[]`; client-side `UIMessage[]` never crosses the server boundary.
-The response uses `ClientStreamEvent` records inside an always-framed `anvia.client.v2` stream.
+The response uses `ClientStreamEvent` records inside an always-framed `anvia.client.v3` stream.
+Agent endpoints accept either a `messages` request or an `interaction_response` request, while
+keeping the matching `AgentContinuation` exclusively on the server.
 
 ## Public API
 

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { AgentStreamEvent } from '@anvia/core/agent';
+import { AgentInteractionRequest, AgentInteractionResponse, AgentStreamEvent } from '@anvia/core/agent';
 import { JsonValue, JsonObject, ReasoningContentType, ReasoningDetail, ToolResultContentPart, CompletionSource, ImageDetail, ProviderToolCall, Usage, ContextUsage, Message, CompletionStreamEvent } from '@anvia/core/completion';
 import { GuardrailDecisionRecord } from '@anvia/core/guardrails';
 import { MemoryCompactionInfo } from '@anvia/core/memory';
 import { C as CreateFetchEventTransportOptions } from './event-transport-CC5RD-hT.js';
 
-declare const CLIENT_STREAM_PROTOCOL: "anvia.client.v2";
+declare const CLIENT_STREAM_PROTOCOL: "anvia.client.v3";
 type ClientDataMap = Record<string, JsonValue>;
 type ClientMetadata = JsonObject;
 type ClientDataSchema<T extends JsonValue = JsonValue> = {
@@ -31,7 +31,7 @@ type ClientStreamError = {
 type UIError = ClientStreamError;
 type UIMessageGeneration = {
     runId?: string;
-    status?: "completed" | "blocked" | "approval_required" | "cancelled" | "error";
+    status?: "completed" | "blocked" | "suspended" | "cancelled" | "error";
     usage?: Usage;
     contextUsage?: ContextUsage;
     trace?: {
@@ -116,9 +116,16 @@ type ClientStreamCursor = {
     streamId: string;
     after: number;
 };
-type ClientStreamRequest = {
+type ClientStreamRequest<Metadata extends JsonObject = JsonObject> = {
+    type: "messages";
     messages: readonly Message[];
-    metadata?: JsonObject;
+    metadata?: Metadata;
+    resume?: ClientStreamCursor;
+} | {
+    type: "interaction_response";
+    interactionId: string;
+    response: AgentInteractionResponse;
+    metadata?: Metadata;
     resume?: ClientStreamCursor;
 };
 type ClientCompletionRequest<Metadata extends JsonObject = JsonObject> = {
@@ -133,53 +140,11 @@ type ClientStreamScope = {
     parentToolCallId?: string;
     parentInternalToolCallId?: string;
 };
-type ClientToolApprovalStatus = "pending" | "approved" | "rejected" | "timed_out" | "cancelled";
-type ToolApproval = {
-    id: string;
-    runId?: string;
-    agentId?: string;
-    sessionId?: string;
-    toolName: string;
-    callId?: string;
-    internalCallId?: string;
-    input?: JsonValue;
-    status: ClientToolApprovalStatus;
-    requestedAt?: string;
-    resolvedAt?: string;
-    reason?: string;
-};
-type ToolQuestionStatus = "pending" | "answered" | "cancelled";
-type ToolQuestionChoice = {
-    label: string;
-    value: string;
-};
-type ToolQuestionPrompt = {
-    id: string;
-    question: string;
-    choices: ToolQuestionChoice[];
-};
-type ToolQuestionAnswer = {
-    questionId: string;
-    answer: string;
-    choice?: string;
-    custom?: boolean;
-};
-type ToolQuestion = {
-    id: string;
-    runId?: string;
-    agentId?: string;
-    sessionId?: string;
-    toolName: string;
-    callId?: string;
-    internalCallId?: string;
-    input?: JsonValue;
-    questions: ToolQuestionPrompt[];
-    status: ToolQuestionStatus;
-    requestedAt?: string;
-    answeredAt?: string;
-    cancelledAt?: string;
-    answers?: ToolQuestionAnswer[];
-};
+type ClientInteraction = Readonly<{
+    request: AgentInteractionRequest;
+    runId: string;
+    status: "pending" | "responded" | "cancelled";
+}>;
 type ClientStreamEventBase = {
     runId: string;
     turn?: number;
@@ -300,11 +265,8 @@ type ClientStandardStreamEvent<Metadata extends JsonObject, Data extends ClientD
     type: "provider_tool_call";
     toolCall: ProviderToolCall;
 } | {
-    type: "tool_approval";
-    approval: ToolApproval;
-} | {
-    type: "tool_question";
-    question: ToolQuestion;
+    type: "interaction";
+    interaction: AgentInteractionRequest;
 } | {
     type: "guardrail_decision";
     decision: GuardrailDecisionRecord;
@@ -326,7 +288,7 @@ type ClientStandardStreamEvent<Metadata extends JsonObject, Data extends ClientD
     firstDeltaMs?: number;
 } | {
     type: "run_end";
-    status: "completed" | "blocked" | "approval_required" | "cancelled" | "error";
+    status: "completed" | "blocked" | "suspended" | "cancelled" | "error";
     text?: string;
     output?: JsonValue;
     usage?: Usage;
@@ -458,4 +420,4 @@ declare function applyClientStreamEvent<Metadata extends JsonObject, Data extend
 declare function messageText<Metadata extends JsonObject, Data extends ClientDataMap>(message: UIMessage<Metadata, Data>): string;
 declare function assistantText<Metadata extends JsonObject, Data extends ClientDataMap>(messages: readonly UIMessage<Metadata, Data>[]): string;
 
-export { type AgentClientStreamContext, type AgentClientStreamOptions, CLIENT_STREAM_PROTOCOL, type ClientCompletionRequest, type ClientDataMap, type ClientDataSchema, type ClientDataSchemas, type ClientErrorMapper, type ClientMetadata, type ClientMetadataSchema, type ClientOutputMapper, ClientProtocolError, type ClientStream, type ClientStreamAdapterOptions, type ClientStreamCursor, type ClientStreamError, type ClientStreamEvent, type ClientStreamFrame, type ClientStreamRequest, type ClientStreamScope, type ClientToolApprovalStatus, type ClientTransport, type ClientTransportSendOptions, type CompletionClientStreamOptions, type CreateDirectClientTransportOptions, type CreateHttpClientTransportOptions, type CreateUIAttachment, type ToolApproval, type ToolQuestion, type ToolQuestionAnswer, type ToolQuestionChoice, type ToolQuestionPrompt, type ToolQuestionStatus, type UIAttachment, type UIError, type UIMessage, type UIMessageGeneration, type UIMessagePart, type UIMessageRole, type UIToolMessagePart, agentToClientStream, applyClientStreamEvent, assistantText, completionToClientStream, createClientId, createDirectClientTransport, createHttpClientTransport, customAgentEventsToClientStream, maskedClientError, messageText, messagesToUIMessages, normalizeClientError, parseClientStreamEvent, parseClientStreamFrame, parseClientStreamRequest, parseUIMessage, parseUIMessages, uiMessagesToMessages };
+export { type AgentClientStreamContext, type AgentClientStreamOptions, CLIENT_STREAM_PROTOCOL, type ClientCompletionRequest, type ClientDataMap, type ClientDataSchema, type ClientDataSchemas, type ClientErrorMapper, type ClientInteraction, type ClientMetadata, type ClientMetadataSchema, type ClientOutputMapper, ClientProtocolError, type ClientStream, type ClientStreamAdapterOptions, type ClientStreamCursor, type ClientStreamError, type ClientStreamEvent, type ClientStreamFrame, type ClientStreamRequest, type ClientStreamScope, type ClientTransport, type ClientTransportSendOptions, type CompletionClientStreamOptions, type CreateDirectClientTransportOptions, type CreateHttpClientTransportOptions, type CreateUIAttachment, type UIAttachment, type UIError, type UIMessage, type UIMessageGeneration, type UIMessagePart, type UIMessageRole, type UIToolMessagePart, agentToClientStream, applyClientStreamEvent, assistantText, completionToClientStream, createClientId, createDirectClientTransport, createHttpClientTransport, customAgentEventsToClientStream, maskedClientError, messageText, messagesToUIMessages, normalizeClientError, parseClientStreamEvent, parseClientStreamFrame, parseClientStreamRequest, parseUIMessage, parseUIMessages, uiMessagesToMessages };