@anvia/client 1.6.0 → 1.8.0

package/dist/streams-BXxF27Hp.js

@@ -0,0 +1,156 @@
+// src/transport/streams.ts
+/** A malformed JSONL line or SSE data payload that could not be parsed as JSON. */
+var EventStreamParseError = class extends Error {
+	format;
+	/** The raw JSONL line or joined SSE `data` payload. */
+	raw;
+	/** 1-based physical line number of the malformed JSONL line. */
+	line;
+	/** SSE event name of the malformed frame. */
+	event;
+	/** SSE last event ID in effect when the malformed frame was dispatched. */
+	lastEventId;
+	constructor(options) {
+		super(`Malformed ${options.format === "sse" ? "SSE" : "JSONL"} frame: invalid JSON.`, { cause: options.cause });
+		this.name = "EventStreamParseError";
+		this.format = options.format;
+		this.raw = options.raw;
+		this.line = options.line;
+		this.event = options.event;
+		this.lastEventId = options.lastEventId;
+	}
+};
+async function* readJsonlStream(stream, options = {}) {
+	let lineNumber = 0;
+	for await (const line of readLines(stream)) {
+		lineNumber += 1;
+		const raw = line.trim();
+		if (raw.length === 0) continue;
+		const parsed = parseJson(raw, options, () => ({
+			format: "jsonl",
+			raw,
+			line: lineNumber
+		}));
+		if (parsed.ok) yield parsed.value;
+	}
+}
+async function* readSseStream(stream, options = {}) {
+	for await (const frame of readSseFrames(stream, options)) yield frame.data;
+}
+async function* readSseFrames(stream, options = {}) {
+	let data = [];
+	let event = "";
+	let lastEventId = "";
+	let retry;
+	function dispatch() {
+		const raw = data.join("\n");
+		const name = event === "" ? "message" : event;
+		const hasData = data.length > 0;
+		data = [];
+		event = "";
+		if (!hasData || raw.trim().length === 0) return void 0;
+		const parsed = parseJson(raw, options, () => ({
+			format: "sse",
+			raw,
+			event: name,
+			lastEventId
+		}));
+		if (!parsed.ok) return void 0;
+		const frame = {
+			data: parsed.value,
+			event: name,
+			lastEventId
+		};
+		if (retry !== void 0) frame.retry = retry;
+		return frame;
+	}
+	for await (const line of readLines(stream)) {
+		if (line === "") {
+			const frame = dispatch();
+			if (frame !== void 0) yield frame;
+			continue;
+		}
+		if (line.startsWith(":")) continue;
+		const separator = line.indexOf(":");
+		const field = separator === -1 ? line : line.slice(0, separator);
+		let value = separator === -1 ? "" : line.slice(separator + 1);
+		if (value.startsWith(" ")) value = value.slice(1);
+		if (field === "data") data.push(value);
+		else if (field === "event") event = value;
+		else if (field === "id") {
+			if (!value.includes("\0")) lastEventId = value;
+		} else if (field === "retry") {
+			if (/^\d+$/.test(value)) retry = Number(value);
+		}
+	}
+	const frame = dispatch();
+	if (frame !== void 0) yield frame;
+}
+/** Splits a byte stream into lines terminated by CRLF, LF, or a bare CR. */
+async function* readLines(stream) {
+	const reader = stream.getReader();
+	const decoder = new TextDecoder();
+	let buffer = "";
+	let skipLeadingLf = false;
+	let completed = false;
+	function* split(text) {
+		let chunk = text;
+		if (skipLeadingLf && chunk.length > 0) {
+			skipLeadingLf = false;
+			if (chunk.startsWith("\n")) chunk = chunk.slice(1);
+		}
+		let start = 0;
+		let index = buffer.length;
+		buffer += chunk;
+		for (; index < buffer.length; index += 1) {
+			const char = buffer.charCodeAt(index);
+			if (char !== 10 && char !== 13) continue;
+			yield buffer.slice(start, index);
+			if (char === 13) {
+				if (index + 1 === buffer.length) skipLeadingLf = true;
+				else if (buffer.charCodeAt(index + 1) === 10) index += 1;
+			}
+			start = index + 1;
+		}
+		buffer = buffer.slice(start);
+	}
+	try {
+		while (true) {
+			const next = await reader.read();
+			if (next.done) {
+				completed = true;
+				break;
+			}
+			yield* split(decoder.decode(next.value, { stream: true }));
+		}
+		yield* split(decoder.decode());
+		if (buffer.length > 0) yield buffer;
+	} finally {
+		if (!completed) await cancelReader(reader);
+		reader.releaseLock();
+	}
+}
+function parseJson(raw, options, details) {
+	try {
+		return {
+			ok: true,
+			value: JSON.parse(raw)
+		};
+	} catch (cause) {
+		const error = new EventStreamParseError({
+			...details(),
+			cause
+		});
+		options.onParseError?.(error);
+		if (options.strict === true) throw error;
+		return { ok: false };
+	}
+}
+async function cancelReader(reader) {
+	try {
+		await reader.cancel();
+	} catch {}
+}
+export { readSseStream as i, readJsonlStream as n, readSseFrames as r, EventStreamParseError as t };
+
+//# sourceMappingURL=streams-BXxF27Hp.js.map

package/dist/streams-BXxF27Hp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams-BXxF27Hp.js","names":[],"sources":["../src/transport/streams.ts"],"sourcesContent":["import type { EventStreamFormat } from \"./types\";\n\n/** A malformed JSONL line or SSE data payload that could not be parsed as JSON. */\nexport class EventStreamParseError extends Error {\n  readonly format: EventStreamFormat;\n  /** The raw JSONL line or joined SSE `data` payload. */\n  readonly raw: string;\n  /** 1-based physical line number of the malformed JSONL line. */\n  readonly line: number | undefined;\n  /** SSE event name of the malformed frame. */\n  readonly event: string | undefined;\n  /** SSE last event ID in effect when the malformed frame was dispatched. */\n  readonly lastEventId: string | undefined;\n\n  constructor(options: {\n    format: EventStreamFormat;\n    raw: string;\n    cause: unknown;\n    line?: number;\n    event?: string;\n    lastEventId?: string;\n  }) {\n    super(`Malformed ${options.format === \"sse\" ? \"SSE\" : \"JSONL\"} frame: invalid JSON.`, {\n      cause: options.cause,\n    });\n    this.name = \"EventStreamParseError\";\n    this.format = options.format;\n    this.raw = options.raw;\n    this.line = options.line;\n    this.event = options.event;\n    this.lastEventId = options.lastEventId;\n  }\n}\n\nexport type EventStreamReadOptions = {\n  /**\n   * Receives frames whose payload is not valid JSON. Malformed frames are skipped and the\n   * stream continues. Throwing from this callback aborts the stream with that error.\n   */\n  onParseError?: (error: EventStreamParseError) => void;\n  /** Throw the parse error instead of skipping malformed frames. */\n  strict?: boolean;\n};\n\n/** A dispatched Server-Sent Event with its parsed JSON payload. */\nexport type SseFrame<TEvent> = {\n  data: TEvent;\n  /** Event name from the `event:` field, `\"message\"` when absent. */\n  event: string;\n  /** Last event ID set by an `id:` field in this or an earlier frame, `\"\"` when none. */\n  lastEventId: string;\n  /** Most recent valid `retry:` reconnection time in milliseconds. */\n  retry?: number;\n};\n\nexport async function* readJsonlStream<TEvent>(\n  stream: ReadableStream<Uint8Array>,\n  options: EventStreamReadOptions = {},\n): AsyncIterable<TEvent> {\n  let lineNumber = 0;\n  for await (const line of readLines(stream)) {\n    lineNumber += 1;\n    const raw = line.trim();\n    if (raw.length === 0) continue;\n    const parsed = parseJson(raw, options, () => ({ format: \"jsonl\", raw, line: lineNumber }));\n    if (parsed.ok) yield parsed.value as TEvent;\n  }\n}\n\nexport async function* readSseStream<TEvent>(\n  stream: ReadableStream<Uint8Array>,\n  options: EventStreamReadOptions = {},\n): AsyncIterable<TEvent> {\n  for await (const frame of readSseFrames<TEvent>(stream, options)) yield frame.data;\n}\n\nexport async function* readSseFrames<TEvent>(\n  stream: ReadableStream<Uint8Array>,\n  options: EventStreamReadOptions = {},\n): AsyncIterable<SseFrame<TEvent>> {\n  let data: string[] = [];\n  let event = \"\";\n  let lastEventId = \"\";\n  let retry: number | undefined;\n\n  function dispatch(): SseFrame<TEvent> | undefined {\n    const raw = data.join(\"\\n\");\n    const name = event === \"\" ? \"message\" : event;\n    const hasData = data.length > 0;\n    data = [];\n    event = \"\";\n    // Whitespace-only payloads (for example `data:` heartbeats) carry no JSON event.\n    if (!hasData || raw.trim().length === 0) return undefined;\n    const parsed = parseJson(raw, options, () => ({\n      format: \"sse\",\n      raw,\n      event: name,\n      lastEventId,\n    }));\n    if (!parsed.ok) return undefined;\n    const frame: SseFrame<TEvent> = { data: parsed.value as TEvent, event: name, lastEventId };\n    if (retry !== undefined) frame.retry = retry;\n    return frame;\n  }\n\n  for await (const line of readLines(stream)) {\n    if (line === \"\") {\n      const frame = dispatch();\n      if (frame !== undefined) yield frame;\n      continue;\n    }\n    if (line.startsWith(\":\")) continue;\n    const separator = line.indexOf(\":\");\n    const field = separator === -1 ? line : line.slice(0, separator);\n    let value = separator === -1 ? \"\" : line.slice(separator + 1);\n    if (value.startsWith(\" \")) value = value.slice(1);\n    if (field === \"data\") {\n      data.push(value);\n    } else if (field === \"event\") {\n      event = value;\n    } else if (field === \"id\") {\n      if (!value.includes(\"\\0\")) lastEventId = value;\n    } else if (field === \"retry\") {\n      if (/^\\d+$/.test(value)) retry = Number(value);\n    }\n  }\n  // Leniently dispatch a final event that was not followed by a blank line.\n  const frame = dispatch();\n  if (frame !== undefined) yield frame;\n}\n\n/** Splits a byte stream into lines terminated by CRLF, LF, or a bare CR. */\nasync function* readLines(stream: ReadableStream<Uint8Array>): AsyncIterable<string> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n  let skipLeadingLf = false;\n  let completed = false;\n\n  function* split(text: string): Iterable<string> {\n    let chunk = text;\n    if (skipLeadingLf && chunk.length > 0) {\n      skipLeadingLf = false;\n      if (chunk.startsWith(\"\\n\")) chunk = chunk.slice(1);\n    }\n    let start = 0;\n    let index = buffer.length;\n    buffer += chunk;\n    for (; index < buffer.length; index += 1) {\n      const char = buffer.charCodeAt(index);\n      if (char !== 10 && char !== 13) continue;\n      yield buffer.slice(start, index);\n      if (char === 13) {\n        if (index + 1 === buffer.length) skipLeadingLf = true;\n        else if (buffer.charCodeAt(index + 1) === 10) index += 1;\n      }\n      start = index + 1;\n    }\n    buffer = buffer.slice(start);\n  }\n\n  try {\n    while (true) {\n      const next = await reader.read();\n      if (next.done) {\n        completed = true;\n        break;\n      }\n      yield* split(decoder.decode(next.value, { stream: true }));\n    }\n    yield* split(decoder.decode());\n    if (buffer.length > 0) yield buffer;\n  } finally {\n    if (!completed) await cancelReader(reader);\n    reader.releaseLock();\n  }\n}\n\nfunction parseJson(\n  raw: string,\n  options: EventStreamReadOptions,\n  details: () => Omit<ConstructorParameters<typeof EventStreamParseError>[0], \"cause\">,\n): { ok: true; value: unknown } | { ok: false } {\n  try {\n    return { ok: true, value: JSON.parse(raw) };\n  } catch (cause) {\n    const error = new EventStreamParseError({ ...details(), cause });\n    options.onParseError?.(error);\n    if (options.strict === true) throw error;\n    return { ok: false };\n  }\n}\n\nasync function cancelReader(reader: ReadableStreamDefaultReader<Uint8Array>): Promise<void> {\n  try {\n    await reader.cancel();\n  } catch {\n    // The request may already have been aborted by its owner.\n  }\n}\n"],"mappings":"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"}

package/dist/transport/index.d.ts

@@ -1,91 +1,2 @@
-type EventStreamFormat = "jsonl" | "sse";
-type EventTransportSendOptions<TRequest> = {
-    request: TRequest;
-    abortSignal?: AbortSignal;
-    headers?: HeadersInit;
-};
-type EventTransport<TRequest, TEvent> = {
-    send(options: EventTransportSendOptions<TRequest>): AsyncIterable<TEvent>;
-};
-
-/** A malformed JSONL line or SSE data payload that could not be parsed as JSON. */
-declare class EventStreamParseError extends Error {
-    readonly format: EventStreamFormat;
-    /** The raw JSONL line or joined SSE `data` payload. */
-    readonly raw: string;
-    /** 1-based physical line number of the malformed JSONL line. */
-    readonly line: number | undefined;
-    /** SSE event name of the malformed frame. */
-    readonly event: string | undefined;
-    /** SSE last event ID in effect when the malformed frame was dispatched. */
-    readonly lastEventId: string | undefined;
-    constructor(options: {
-        format: EventStreamFormat;
-        raw: string;
-        cause: unknown;
-        line?: number;
-        event?: string;
-        lastEventId?: string;
-    });
-}
-type EventStreamReadOptions = {
-    /**
-     * Receives frames whose payload is not valid JSON. Malformed frames are skipped and the
-     * stream continues. Throwing from this callback aborts the stream with that error.
-     */
-    onParseError?: (error: EventStreamParseError) => void;
-    /** Throw the parse error instead of skipping malformed frames. */
-    strict?: boolean;
-};
-/** A dispatched Server-Sent Event with its parsed JSON payload. */
-type SseFrame<TEvent> = {
-    data: TEvent;
-    /** Event name from the `event:` field, `"message"` when absent. */
-    event: string;
-    /** Last event ID set by an `id:` field in this or an earlier frame, `""` when none. */
-    lastEventId: string;
-    /** Most recent valid `retry:` reconnection time in milliseconds. */
-    retry?: number;
-};
-declare function readJsonlStream<TEvent>(stream: ReadableStream<Uint8Array>, options?: EventStreamReadOptions): AsyncIterable<TEvent>;
-declare function readSseStream<TEvent>(stream: ReadableStream<Uint8Array>, options?: EventStreamReadOptions): AsyncIterable<TEvent>;
-declare function readSseFrames<TEvent>(stream: ReadableStream<Uint8Array>, options?: EventStreamReadOptions): AsyncIterable<SseFrame<TEvent>>;
-
-type FetchEventStreamOptions = Omit<RequestInit, "headers"> & {
-    input: string | URL | Request;
-    format?: EventStreamFormat | "auto";
-    fetch?: typeof fetch;
-    headers?: HeadersInit;
-    validateResponse?: (response: Response) => void;
-    onParseError?: EventStreamReadOptions["onParseError"];
-};
-declare class EventStreamHttpError extends Error {
-    readonly response: Response;
-    readonly body: string;
-    constructor(response: Response, body: string);
-}
-declare function fetchEventStream<TEvent>(options: FetchEventStreamOptions): AsyncIterable<TEvent>;
-
-type EventTransportContext<TRequest> = EventTransportSendOptions<TRequest>;
-type EventTransportBodyContext<TRequest> = Omit<EventTransportContext<TRequest>, "headers"> & {
-    headers: Headers;
-};
-type CreateFetchEventTransportOptions<TRequest, TEvent> = {
-    endpoint: string | URL | ((context: EventTransportContext<TRequest>) => string | URL);
-    method?: string;
-    format?: EventStreamFormat | "auto";
-    fetch?: typeof fetch;
-    headers?: HeadersInit | ((context: EventTransportContext<TRequest>) => HeadersInit | Promise<HeadersInit>);
-    body?: (context: EventTransportBodyContext<TRequest>) => BodyInit | null | undefined | Promise<BodyInit | null | undefined>;
-    init?: Omit<RequestInit, "body" | "headers" | "method" | "signal">;
-    mapEvent?: (event: unknown) => TEvent;
-    validateResponse?: (response: Response) => void;
-    /** Receives malformed frames that were skipped instead of aborting the stream. */
-    onParseError?: FetchEventStreamOptions["onParseError"];
-};
-declare function createFetchEventTransport<TRequest, TEvent = unknown>(options: CreateFetchEventTransportOptions<TRequest, TEvent>): EventTransport<TRequest, TEvent>;
-declare function createDirectEventTransport<TRequest, TEvent>(options: {
-    handler(context: EventTransportContext<TRequest>): AsyncIterable<TEvent>;
-}): EventTransport<TRequest, TEvent>;
-
-export { type CreateFetchEventTransportOptions, type EventStreamFormat, EventStreamHttpError, EventStreamParseError, type EventStreamReadOptions, type EventTransport, type EventTransportSendOptions, type FetchEventStreamOptions, type SseFrame, createDirectEventTransport, createFetchEventTransport, fetchEventStream, readJsonlStream, readSseFrames, readSseStream };
+import { a as FetchEventStreamOptions, c as EventStreamReadOptions, d as readSseFrames, f as readSseStream, h as EventTransportSendOptions, i as EventStreamHttpError, l as SseFrame, m as EventTransport, n as createDirectEventTransport, o as fetchEventStream, p as EventStreamFormat, r as createFetchEventTransport, s as EventStreamParseError, t as CreateFetchEventTransportOptions, u as readJsonlStream } from "../event-transport-rXxwo4BK.js";
+export { type CreateFetchEventTransportOptions, type EventStreamFormat, EventStreamHttpError, EventStreamParseError, type EventStreamReadOptions, type EventTransport, type EventTransportSendOptions, type FetchEventStreamOptions, type SseFrame, createDirectEventTransport, createFetchEventTransport, fetchEventStream, readJsonlStream, readSseFrames, readSseStream };

package/dist/transport/index.js

@@ -1,23 +1,3 @@
-import {
-  EventStreamHttpError,
-  createDirectEventTransport,
-  createFetchEventTransport,
-  fetchEventStream
-} from "../chunk-RK5U6WVJ.js";
-import {
-  EventStreamParseError,
-  readJsonlStream,
-  readSseFrames,
-  readSseStream
-} from "../chunk-PD72KNCV.js";
-export {
-  EventStreamHttpError,
-  EventStreamParseError,
-  createDirectEventTransport,
-  createFetchEventTransport,
-  fetchEventStream,
-  readJsonlStream,
-  readSseFrames,
-  readSseStream
-};
-//# sourceMappingURL=index.js.map
+import { i as fetchEventStream, n as createFetchEventTransport, r as EventStreamHttpError, t as createDirectEventTransport } from "../event-transport-CcP1zaST.js";
+import { i as readSseStream, n as readJsonlStream, r as readSseFrames, t as EventStreamParseError } from "../streams-BXxF27Hp.js";
+export { EventStreamHttpError, EventStreamParseError, createDirectEventTransport, createFetchEventTransport, fetchEventStream, readJsonlStream, readSseFrames, readSseStream };

package/dist/types-Bt4tUcST.d.ts

@@ -0,0 +1,348 @@
+import { CompletionSource, ContextUsage, ImageDetail, JsonObject, JsonValue, Message, ProviderToolCall, ReasoningContentType, ReasoningDetail, ToolResultContentPart, Usage } from "@anvia/core/completion";
+import { AgentInteractionRequest, AgentInteractionResponse } from "@anvia/core/agent/interactions";
+import { GuardrailDecisionRecord } from "@anvia/core/guardrails";
+import { MemoryCompactionInfo } from "@anvia/core/memory";
+declare const CLIENT_STREAM_PROTOCOL: "anvia.client.v3";
+type ClientDataMap = Record<string, JsonValue>;
+type ClientMetadata = JsonObject;
+type ClientDataSchema<T extends JsonValue = JsonValue> = {
+  safeParse(value: unknown): {
+    success: true;
+    data: T;
+  } | {
+    success: false;
+    error?: unknown;
+  };
+};
+type ClientDataSchemas<TData extends ClientDataMap> = { [Name in keyof TData]: ClientDataSchema<TData[Name]>; };
+type ClientMetadataSchema<TMetadata extends JsonObject = JsonObject> = ClientDataSchema<TMetadata>;
+type UIMessageRole = "system" | "user" | "assistant" | "tool";
+type ClientStreamError = {
+  name?: string;
+  message: string;
+  code?: string;
+  retryable?: boolean;
+  details?: JsonValue;
+};
+type UIError = ClientStreamError;
+type UIMessageGeneration = {
+  runId?: string;
+  status?: "completed" | "blocked" | "suspended" | "cancelled" | "error";
+  usage?: Usage;
+  contextUsage?: ContextUsage;
+  trace?: {
+    observer: string;
+    traceId?: string;
+    observationId?: string;
+  };
+  memoryCompaction?: MemoryCompactionInfo;
+};
+type UIMessage<Metadata extends JsonObject = JsonObject, Data extends ClientDataMap = ClientDataMap> = Readonly<{
+  id: string;
+  role: UIMessageRole;
+  parts: readonly UIMessagePart<Data>[];
+  modelMessageId?: string;
+  metadata?: Metadata;
+  generation?: UIMessageGeneration;
+}>;
+type UIAttachment = {
+  id: string;
+  type: "image" | "document" | "file";
+  name?: string;
+  mediaType?: string;
+  url?: string;
+  data?: string;
+  text?: string;
+  detail?: ImageDetail;
+  metadata?: JsonValue;
+};
+type CreateUIAttachment = Omit<UIAttachment, "id"> & {
+  id?: string;
+};
+type UIDataPart<Data extends ClientDataMap> = { [Name in keyof Data & string]: {
+  id: string;
+  type: "data";
+  name: Name;
+  data: Data[Name];
+}; }[keyof Data & string];
+type UIToolMessagePartBase = {
+  id: string;
+  type: "tool";
+  toolName: string;
+  toolCallId: string;
+  callId?: string;
+  internalCallId?: string;
+  turn?: number;
+  signature?: string;
+};
+type UIToolMessagePart = (UIToolMessagePartBase & {
+  state: "input-streaming";
+  input: string;
+}) | (UIToolMessagePartBase & {
+  state: "input-available";
+  input: JsonValue;
+}) | (UIToolMessagePartBase & {
+  state: "output-available";
+  input: JsonValue;
+  output: JsonValue;
+  resultContent?: readonly ToolResultContentPart[];
+}) | (UIToolMessagePartBase & {
+  state: "error";
+  input: JsonValue;
+  error: UIError;
+});
+type UIMessagePart<Data extends ClientDataMap = ClientDataMap> = {
+  id: string;
+  type: "text";
+  text: string;
+  signature?: string;
+} | {
+  id: string;
+  type: "reasoning";
+  text: string;
+  reasoningId?: string;
+  content?: readonly ReasoningDetail[];
+} | UIToolMessagePart | {
+  id: string;
+  type: "source";
+  source: CompletionSource;
+} | UIDataPart<Data> | {
+  id: string;
+  type: "attachment";
+  attachment: UIAttachment;
+} | {
+  id: string;
+  type: "error";
+  error: UIError;
+};
+type ClientStreamCursor = {
+  streamId: string;
+  after: number;
+};
+type ClientStreamRequest<Metadata extends JsonObject = JsonObject> = {
+  type: "messages";
+  messages: readonly Message[];
+  metadata?: Metadata;
+  resume?: ClientStreamCursor;
+} | {
+  type: "interaction_response";
+  interactionId: string;
+  response: AgentInteractionResponse;
+  metadata?: Metadata;
+  resume?: ClientStreamCursor;
+};
+type ClientCompletionRequest<Metadata extends JsonObject = JsonObject> = {
+  prompt: string;
+  metadata?: Metadata;
+};
+type ClientStreamScope = {
+  agentId?: string;
+  agentName?: string;
+  parentRunId?: string;
+  parentToolName?: string;
+  parentToolCallId?: string;
+  parentInternalToolCallId?: string;
+};
+type ClientInteraction = Readonly<{
+  request: AgentInteractionRequest;
+  runId: string;
+  status: "pending" | "responded" | "cancelled";
+}>;
+type ClientStreamEventBase = {
+  runId: string;
+  turn?: number;
+  scope?: ClientStreamScope;
+};
+type ClientDataEvent<TData extends ClientDataMap> = { [Name in keyof TData & string]: {
+  type: "data";
+  name: Name;
+  data: TData[Name];
+  transient?: boolean;
+}; }[keyof TData & string];
+type ClientStandardStreamEvent<Metadata extends JsonObject, Data extends ClientDataMap> = {
+  type: "run_start";
+  source: "completion" | "agent";
+  metadata?: Metadata;
+} | {
+  type: "turn_start";
+} | {
+  type: "generation_start";
+  model?: {
+    provider: string;
+    modelId: string;
+  };
+} | {
+  /** Discards an unfinished generation attempt while retaining message identity. */
+  type: "message_reset";
+  messageId: string;
+} | {
+  type: "message_start";
+  messageId: string;
+  role: "assistant";
+  metadata?: Metadata;
+} | {
+  type: "text_start";
+  messageId: string;
+  partId: string;
+} | {
+  type: "text_delta";
+  messageId: string;
+  partId: string;
+  delta: string;
+} | {
+  type: "text_end";
+  messageId: string;
+  partId: string;
+  text?: string;
+  signature?: string;
+} | {
+  type: "reasoning_start";
+  messageId: string;
+  partId: string;
+  reasoningId?: string;
+} | {
+  type: "reasoning_delta";
+  messageId: string;
+  partId: string;
+  delta: string;
+  contentType?: ReasoningContentType;
+  signature?: string;
+} | {
+  type: "reasoning_end";
+  messageId: string;
+  partId: string;
+  text?: string;
+  content?: readonly ReasoningDetail[];
+} | {
+  type: "tool_call_start";
+  messageId: string;
+  partId: string;
+  toolCallId: string;
+  callId?: string;
+  toolName?: string;
+} | {
+  type: "tool_call_delta";
+  messageId: string;
+  partId: string;
+  toolCallId: string;
+  callId?: string;
+  toolName?: string;
+  delta: string;
+  mode: "append" | "replace";
+  signature?: string;
+} | {
+  type: "tool_call_end";
+  messageId: string;
+  partId: string;
+  toolCallId: string;
+  callId?: string;
+  toolName: string;
+  input: JsonValue;
+  signature?: string;
+} | {
+  type: "tool_result";
+  messageId: string;
+  partId: string;
+  toolCallId: string;
+  callId?: string;
+  internalCallId?: string;
+  toolName: string;
+  input: JsonValue;
+  result: {
+    status: "success";
+    output: JsonValue;
+    content?: readonly ToolResultContentPart[];
+  } | {
+    status: "error";
+    error: ClientStreamError;
+  };
+} | {
+  type: "source";
+  messageId: string;
+  partId: string;
+  source: CompletionSource;
+} | {
+  type: "attachment";
+  messageId: string;
+  partId: string;
+  attachment: UIAttachment;
+} | {
+  type: "provider_tool_call";
+  toolCall: ProviderToolCall;
+} | {
+  type: "interaction";
+  interaction: AgentInteractionRequest;
+} | {
+  type: "guardrail_decision";
+  decision: GuardrailDecisionRecord;
+} | ({
+  type: "memory_compaction";
+} & MemoryCompactionInfo) | {
+  type: "message_end";
+  messageId: string;
+  modelMessageId?: string;
+  /** Authoritative model-authored parts after provider normalization and guardrails. */
+  parts?: readonly UIMessagePart<Data>[];
+  usage?: Usage;
+  contextUsage?: ContextUsage;
+  metadata?: Metadata;
+} | {
+  type: "turn_end";
+  usage?: Usage;
+  contextUsage?: ContextUsage;
+  firstDeltaMs?: number;
+} | {
+  type: "run_end";
+  status: "completed" | "blocked" | "suspended" | "cancelled" | "error";
+  text?: string;
+  output?: JsonValue;
+  usage?: Usage;
+  contextUsage?: ContextUsage;
+  trace?: {
+    observer: string;
+    traceId?: string;
+    observationId?: string;
+  };
+  memoryCompaction?: MemoryCompactionInfo;
+  metadata?: Metadata;
+} | {
+  type: "error";
+  error: ClientStreamError;
+  usage?: Usage;
+};
+type ClientStreamEvent<Metadata extends JsonObject = JsonObject, Data extends ClientDataMap = ClientDataMap> = ClientStreamEventBase & (ClientStandardStreamEvent<Metadata, Data> | ClientDataEvent<Data>);
+type ClientStream<Metadata extends JsonObject = JsonObject, Data extends ClientDataMap = ClientDataMap> = AsyncIterable<ClientStreamEvent<Metadata, Data>>;
+type ClientStreamFrame<Metadata extends JsonObject = JsonObject, Data extends ClientDataMap = ClientDataMap> = {
+  type: "stream_start";
+  protocol: typeof CLIENT_STREAM_PROTOCOL;
+  streamId: string;
+  eventId: 0;
+  resumable: boolean;
+} | {
+  type: "stream_event";
+  streamId: string;
+  eventId: number;
+  event: ClientStreamEvent<Metadata, Data>;
+} | {
+  type: "stream_end";
+  streamId: string;
+  eventId: number;
+  status: "completed" | "error" | "missing";
+};
+type ClientTransportSendOptions<TRequest> = {
+  request: TRequest;
+  abortSignal?: AbortSignal;
+  headers?: HeadersInit;
+  resume?: ClientStreamCursor;
+};
+type ClientTransport<TRequest = ClientStreamRequest, Data extends ClientDataMap = ClientDataMap, Metadata extends JsonObject = JsonObject> = {
+  readonly _types?: {
+    metadata: Metadata;
+    data: Data;
+  };
+  send(options: ClientTransportSendOptions<TRequest>): AsyncIterable<ClientStreamFrame<Metadata, Data>>;
+};
+type ClientErrorMapper = (error: unknown) => ClientStreamError;
+type ClientOutputMapper = (output: unknown) => JsonValue | undefined;
+export { UIMessage as C, UIToolMessagePart as D, UIMessageRole as E, UIError as S, UIMessagePart as T, ClientStreamScope as _, ClientDataSchemas as a, CreateUIAttachment as b, ClientMetadata as c, ClientStream as d, ClientStreamCursor as f, ClientStreamRequest as g, ClientStreamFrame as h, ClientDataSchema as i, ClientMetadataSchema as l, ClientStreamEvent as m, ClientCompletionRequest as n, ClientErrorMapper as o, ClientStreamError as p, ClientDataMap as r, ClientInteraction as s, CLIENT_STREAM_PROTOCOL as t, ClientOutputMapper as u, ClientTransport as v, UIMessageGeneration as w, UIAttachment as x, ClientTransportSendOptions as y };
+//# sourceMappingURL=types-Bt4tUcST.d.ts.map

package/dist/types-Bt4tUcST.d.ts.map

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