veryfront 0.1.558 → 0.1.560

package/esm/src/chat/protocol.d.ts

@@ -5,17 +5,21 @@
  * by AG-UI-aligned chat clients, hooks, and adapters.
  */
 export type ChatPartState = "streaming" | "done";
+/** Chat message part that carries text. */
 export interface ChatTextPart {
     type: "text";
     text: string;
     state?: ChatPartState;
 }
+/** Chat message part that carries reasoning text. */
 export interface ChatReasoningPart {
     type: "reasoning";
     text: string;
     state?: ChatPartState;
 }
+/** State for chat tool. */
 export type ChatToolState = "input-streaming" | "input-available" | "output-streaming" | "output-available" | "output-error";
+/** Public API contract for chat tool part. */
 export interface ChatToolPart<NAME extends string = string, INPUT = unknown, OUTPUT = unknown> {
     type: `tool-${NAME}`;
     toolCallId: string;
@@ -25,6 +29,7 @@ export interface ChatToolPart<NAME extends string = string, INPUT = unknown, OUT
     output?: OUTPUT;
     errorText?: string;
 }
+/** Chat message part that carries a tool result. */
 export interface ChatToolResultPart<RESULT = unknown> {
     type: "tool-result";
     toolCallId: string;
@@ -32,6 +37,7 @@ export interface ChatToolResultPart<RESULT = unknown> {
     result: RESULT;
     isError?: boolean;
 }
+/** Public API contract for chat dynamic tool part. */
 export interface ChatDynamicToolPart {
     type: "dynamic-tool";
     toolCallId: string;
@@ -41,11 +47,14 @@ export interface ChatDynamicToolPart {
     output?: unknown;
     errorText?: string;
 }
+/** Public API contract for chat step part. */
 export interface ChatStepPart {
     type: "step-start" | "step-end";
     stepIndex: number;
 }
+/** Public API contract for chat message part. */
 export type ChatMessagePart = ChatTextPart | ChatReasoningPart | ChatToolPart | ChatToolResultPart | ChatDynamicToolPart | ChatStepPart;
+/** Message shape for chat. */
 export interface ChatMessage {
     id: string;
     role: "system" | "user" | "assistant";
@@ -53,23 +62,27 @@ export interface ChatMessage {
     metadata?: Record<string, unknown>;
     createdAt?: Date | string;
 }
+/** Public API contract for chat message metadata usage. */
 export interface ChatMessageMetadataUsage {
     inputTokens?: number;
     outputTokens?: number;
     reasoningTokens?: number;
     cachedInputTokens?: number;
 }
+/** Public API contract for child run audit tool call. */
 export interface ChildRunAuditToolCall {
     toolName: string;
     toolCallId: string;
     input?: unknown;
 }
+/** Result returned from child run audit tool. */
 export interface ChildRunAuditToolResult {
     toolName: string;
     toolCallId: string;
     input: unknown;
     output: unknown;
 }
+/** Public API contract for child run audit. */
 export interface ChildRunAudit {
     status: "completed" | "failed" | "cancelled" | "stopped";
     description?: string;
@@ -80,6 +93,7 @@ export interface ChildRunAudit {
     terminalErrorCode?: string | null;
     terminalErrorMessage?: string | null;
 }
+/** Public API contract for chat message metadata. */
 export interface ChatMessageMetadata {
     createdAt?: string;
     isStopped?: boolean;
@@ -94,11 +108,14 @@ export interface ChatMessageMetadata {
     childRunAudit?: ChildRunAudit;
     usage?: ChatMessageMetadataUsage;
 }
+/** Public API contract for chat finish reason. */
 export type ChatFinishReason = "stop" | "length" | "tool-calls" | "content-filter" | "error" | "other";
+/** Public API contract for chat stream event base. */
 type ChatStreamEventBase = {
     providerExecuted?: boolean;
     dynamic?: boolean;
 };
+/** Event emitted for chat stream. */
 export type ChatStreamEvent = {
     type: "start";
     messageId?: string;
@@ -192,6 +209,7 @@ export type ChatStreamEvent = {
     type: "error";
     errorText: string;
 };
+/** Public API contract for message lifecycle chunk. */
 type MessageLifecycleChunk<TMessageMetadata> = {
     type: "start";
     messageId?: string;
@@ -204,26 +222,33 @@ type MessageLifecycleChunk<TMessageMetadata> = {
     type: "message-metadata";
     messageMetadata: TMessageMetadata;
 };
+/** Public API contract for ID chunk. */
 type IdChunk<TType extends string> = {
     type: TType;
     id: string;
 };
+/** Public API contract for ID delta chunk. */
 type IdDeltaChunk<TType extends string> = IdChunk<TType> & {
     delta: string;
 };
+/** Public API contract for tool call chunk. */
 type ToolCallChunk<TType extends string> = {
     type: TType;
     toolCallId: string;
 };
+/** Public API contract for named tool call chunk. */
 type NamedToolCallChunk<TType extends string> = ToolCallChunk<TType> & {
     toolName: string;
 };
+/** Public API contract for tool input chunk. */
 type ToolInputChunk<TType extends string> = NamedToolCallChunk<TType> & {
     input: unknown;
 };
+/** Public API contract for tool error chunk. */
 type ToolErrorChunk<TType extends string> = ToolCallChunk<TType> & {
     errorText: string;
 };
+/** Public API contract for chat UI message chunk. */
 export type ChatUiMessageChunk<TMessageMetadata = ChatMessageMetadata> = MessageLifecycleChunk<TMessageMetadata> | {
     type: "start-step";
 } | {

package/esm/src/chat/protocol.d.ts.map

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

package/esm/src/chat/provider-errors.d.ts

@@ -1,8 +1,10 @@
+/** Error shape for parsed provider. */
 export interface ParsedProviderError {
     code: string;
     message: string;
     status?: number;
 }
+/** Result returned from safe JSON parse. */
 export type SafeJsonParseResult = {
     ok: true;
     value: unknown;
@@ -10,8 +12,12 @@ export type SafeJsonParseResult = {
     ok: false;
     error: Error;
 };
+/** Parse JSON safely without throwing. */
 export declare function safeJsonParse(value: string): SafeJsonParseResult;
+/** Parses known problem body. */
 export declare function parseKnownProblemBody(body: unknown): ParsedProviderError | null;
+/** Message shape for is credit limit. */
 export declare function isCreditLimitMessage(normalizedMessage: string): boolean;
+/** Error shape for parse provider. */
 export declare function parseProviderError(error: unknown): ParsedProviderError;
 //# sourceMappingURL=provider-errors.d.ts.map

package/esm/src/chat/provider-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-errors.d.ts","sourceRoot":"","sources":["../../../src/src/chat/provider-errors.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAWD,MAAM,MAAM,mBAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAE7F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAMhE;AAOD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CA0B/E;AAED,wBAAgB,oBAAoB,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAOvE;AAgFD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAEtE"}
+{"version":3,"file":"provider-errors.d.ts","sourceRoot":"","sources":["../../../src/src/chat/provider-errors.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,yBAAyB,CAAC;AAEjC,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAWD,4CAA4C;AAC5C,MAAM,MAAM,mBAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAE7F,0CAA0C;AAC1C,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAMhE;AAOD,iCAAiC;AACjC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CA0B/E;AAED,yCAAyC;AACzC,wBAAgB,oBAAoB,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAOvE;AAgFD,sCAAsC;AACtC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAEtE"}

package/esm/src/chat/provider-errors.js

@@ -1,3 +1,4 @@
+/** Error shape for parsed provider. */
 const DEFAULT_EXTERNAL_SERVICE_ERROR = {
     code: "EXTERNAL_SERVICE_ERROR",
     message: "LLM provider service error",
@@ -5,6 +6,7 @@ const DEFAULT_EXTERNAL_SERVICE_ERROR = {
 function isErrorRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+/** Parse JSON safely without throwing. */
 export function safeJsonParse(value) {
     try {
         return { ok: true, value: JSON.parse(value) };
@@ -17,6 +19,7 @@ function parseErrorJson(value) {
     const parsed = safeJsonParse(value);
     return parsed.ok ? parsed.value : null;
 }
+/** Parses known problem body. */
 export function parseKnownProblemBody(body) {
     if (!isErrorRecord(body)) {
         return null;
@@ -40,6 +43,7 @@ export function parseKnownProblemBody(body) {
     }
     return null;
 }
+/** Message shape for is credit limit. */
 export function isCreditLimitMessage(normalizedMessage) {
     return (normalizedMessage.includes("credit limit") ||
         normalizedMessage.includes("insufficient credits") ||
@@ -109,6 +113,7 @@ function extractResponseBody(error) {
     }
     return undefined;
 }
+/** Error shape for parse provider. */
 export function parseProviderError(error) {
     return parseProviderErrorInner(error, new WeakSet());
 }

package/esm/src/chat/stream-watchdog.d.ts

@@ -1,15 +1,20 @@
 import "../../_dnt.polyfills.js";
 import * as dntShim from "../../_dnt.shims.js";
 import type { ChatUiMessageChunk, MessageMetadata } from "./types.js";
+/** Default value for chat stream idle timeout ms. */
 export declare const DEFAULT_CHAT_STREAM_IDLE_TIMEOUT_MS = 120000;
+/** Default value for chat stream tool running timeout ms. */
 export declare const DEFAULT_CHAT_STREAM_TOOL_RUNNING_TIMEOUT_MS = 300000;
+/** Public API contract for chat stream watchdog phase. */
 export type ChatStreamWatchdogPhase = "response_pending" | "tool_input_streaming" | "tool_running" | "post_tool_idle";
+/** State for chat stream watchdog. */
 export type ChatStreamWatchdogState = {
     phase: ChatStreamWatchdogPhase;
     timeoutMs: number;
     toolCallId?: string;
     toolName?: string;
 };
+/** Options accepted by chat stream watchdog. */
 export type ChatStreamWatchdogOptions = {
     idleTimeoutMs?: number;
     toolRunningTimeoutMs?: number;
@@ -17,17 +22,23 @@ export type ChatStreamWatchdogOptions = {
     setTimeoutFn?: typeof dntShim.setTimeout;
     clearTimeoutFn?: typeof globalThis.clearTimeout;
 };
+/** Error shape for chat stream idle timeout. */
 export declare class ChatStreamIdleTimeoutError extends Error {
     readonly state: ChatStreamWatchdogState;
     constructor(state: ChatStreamWatchdogState);
 }
+/** State for create chat stream watchdog. */
 export declare function createChatStreamWatchdogState(phase: ChatStreamWatchdogPhase, metadata?: {
     toolCallId?: string;
     toolName?: string;
 }, options?: Pick<Required<ChatStreamWatchdogOptions>, "idleTimeoutMs" | "toolRunningTimeoutMs">): ChatStreamWatchdogState;
+/** Check whether a long-running tool is active. */
 export declare function isLongRunningToolRunning(current: ChatStreamWatchdogState, longRunningToolNames: ReadonlySet<string>): boolean;
+/** State for get next chat stream watchdog. */
 export declare function getNextChatStreamWatchdogState(currentState: ChatStreamWatchdogState, chunk: ChatUiMessageChunk<MessageMetadata>, options?: ChatStreamWatchdogOptions): ChatStreamWatchdogState;
+/** Check whether a chunk only carries heartbeat metadata. */
 export declare function isHeartbeatOnlyMetadataChunk(chunk: ChatUiMessageChunk<MessageMetadata>): boolean;
+/** Create chat stream watchdog. */
 export declare function createChatStreamWatchdog(options?: ChatStreamWatchdogOptions): {
     signal: AbortSignal;
     readonly lastTimeoutState: ChatStreamWatchdogState | null;

package/esm/src/chat/stream-watchdog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-watchdog.d.ts","sourceRoot":"","sources":["../../../src/src/chat/stream-watchdog.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEtE,eAAO,MAAM,mCAAmC,SAAU,CAAC;AAC3D,eAAO,MAAM,2CAA2C,SAAU,CAAC;AAEnE,MAAM,MAAM,uBAAuB,GAC/B,kBAAkB,GAClB,sBAAsB,GACtB,cAAc,GACd,gBAAgB,CAAC;AAErB,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,OAAO,OAAO,CAAC,UAAU,CAAC;IACzC,cAAc,CAAC,EAAE,OAAO,UAAU,CAAC,YAAY,CAAC;CACjD,CAAC;AAEF,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;gBAE5B,KAAK,EAAE,uBAAuB;CAU3C;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,CAAC,EAAE;IACT,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,EACD,OAAO,GAAE,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,eAAe,GAAG,sBAAsB,CAG1F,GACA,uBAAuB,CAOzB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,uBAAuB,EAChC,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,GACxC,OAAO,CAMT;AAED,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,uBAAuB,EACrC,KAAK,EAAE,kBAAkB,CAAC,eAAe,CAAC,EAC1C,OAAO,CAAC,EAAE,yBAAyB,GAClC,uBAAuB,CA+DzB;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,kBAAkB,CAAC,eAAe,CAAC,GAAG,OAAO,CAEhG;AAED,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,yBAAyB;;+BAsChD,uBAAuB,GAAG,IAAI;mBAGvC,kBAAkB,CAAC,eAAe,CAAC;;EAgBrD"}
+{"version":3,"file":"stream-watchdog.d.ts","sourceRoot":"","sources":["../../../src/src/chat/stream-watchdog.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEtE,qDAAqD;AACrD,eAAO,MAAM,mCAAmC,SAAU,CAAC;AAC3D,6DAA6D;AAC7D,eAAO,MAAM,2CAA2C,SAAU,CAAC;AAEnE,0DAA0D;AAC1D,MAAM,MAAM,uBAAuB,GAC/B,kBAAkB,GAClB,sBAAsB,GACtB,cAAc,GACd,gBAAgB,CAAC;AAErB,sCAAsC;AACtC,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,yBAAyB,GAAG;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,OAAO,OAAO,CAAC,UAAU,CAAC;IACzC,cAAc,CAAC,EAAE,OAAO,UAAU,CAAC,YAAY,CAAC;CACjD,CAAC;AAEF,gDAAgD;AAChD,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;gBAE5B,KAAK,EAAE,uBAAuB;CAU3C;AAED,6CAA6C;AAC7C,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,CAAC,EAAE;IACT,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,EACD,OAAO,GAAE,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,eAAe,GAAG,sBAAsB,CAG1F,GACA,uBAAuB,CAOzB;AAED,mDAAmD;AACnD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,uBAAuB,EAChC,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,GACxC,OAAO,CAMT;AAED,+CAA+C;AAC/C,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,uBAAuB,EACrC,KAAK,EAAE,kBAAkB,CAAC,eAAe,CAAC,EAC1C,OAAO,CAAC,EAAE,yBAAyB,GAClC,uBAAuB,CA+DzB;AAED,6DAA6D;AAC7D,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,kBAAkB,CAAC,eAAe,CAAC,GAAG,OAAO,CAEhG;AAED,mCAAmC;AACnC,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,yBAAyB;;+BAsChD,uBAAuB,GAAG,IAAI;mBAGvC,kBAAkB,CAAC,eAAe,CAAC;;EAgBrD"}

package/esm/src/chat/stream-watchdog.js

@@ -1,7 +1,10 @@
 import "../../_dnt.polyfills.js";
 import * as dntShim from "../../_dnt.shims.js";
+/** Default value for chat stream idle timeout ms. */
 export const DEFAULT_CHAT_STREAM_IDLE_TIMEOUT_MS = 120_000;
+/** Default value for chat stream tool running timeout ms. */
 export const DEFAULT_CHAT_STREAM_TOOL_RUNNING_TIMEOUT_MS = 300_000;
+/** Error shape for chat stream idle timeout. */
 export class ChatStreamIdleTimeoutError extends Error {
     state;
     constructor(state) {
@@ -15,6 +18,7 @@ export class ChatStreamIdleTimeoutError extends Error {
         this.state = state;
     }
 }
+/** State for create chat stream watchdog. */
 export function createChatStreamWatchdogState(phase, metadata, options = {
     idleTimeoutMs: DEFAULT_CHAT_STREAM_IDLE_TIMEOUT_MS,
     toolRunningTimeoutMs: DEFAULT_CHAT_STREAM_TOOL_RUNNING_TIMEOUT_MS,
@@ -26,11 +30,13 @@ export function createChatStreamWatchdogState(phase, metadata, options = {
         ...(metadata?.toolName ? { toolName: metadata.toolName } : {}),
     };
 }
+/** Check whether a long-running tool is active. */
 export function isLongRunningToolRunning(current, longRunningToolNames) {
     return (current.phase === "tool_running" &&
         typeof current.toolName === "string" &&
         longRunningToolNames.has(current.toolName));
 }
+/** State for get next chat stream watchdog. */
 export function getNextChatStreamWatchdogState(currentState, chunk, options) {
     const resolvedOptions = resolveChatStreamWatchdogOptions(options);
     switch (chunk.type) {
@@ -72,9 +78,11 @@ export function getNextChatStreamWatchdogState(currentState, chunk, options) {
                 : createChatStreamWatchdogState("response_pending", undefined, resolvedOptions);
     }
 }
+/** Check whether a chunk only carries heartbeat metadata. */
 export function isHeartbeatOnlyMetadataChunk(chunk) {
     return chunk.type === "message-metadata" && Object.keys(chunk.messageMetadata ?? {}).length === 0;
 }
+/** Create chat stream watchdog. */
 export function createChatStreamWatchdog(options) {
     const resolvedOptions = resolveChatStreamWatchdogOptions(options);
     const controller = new AbortController();

package/esm/src/chat/types.d.ts

@@ -1,25 +1,33 @@
 import type { ChatMessageMetadata, ChatMessageMetadataUsage, ChatUiMessageChunk, ChildRunAudit, ChildRunAuditToolCall, ChildRunAuditToolResult } from "./protocol.js";
 import type { InferSchema } from "../extensions/schema/index.js";
+/** File extensions that chat uploads can inline as text. */
 export declare const textFileExtensions: readonly [".txt", ".md", ".json", ".xml", ".html", ".css", ".js", ".mjs", ".cjs", ".ts", ".mts", ".cts", ".jsx", ".tsx", ".py", ".java", ".cpp", ".c", ".h", ".php", ".rb", ".go", ".rs", ".swift", ".kt", ".scala", ".sh", ".yaml", ".yml", ".toml", ".ini", ".cfg", ".conf", ".sql", ".csv"];
+/** Image media types that chat uploads can display natively. */
 export declare const imageFileTypes: readonly ["image/png", "image/jpeg", "image/jpg", "image/gif", "image/webp", "image/bmp", "image/tiff"];
+/** Public API contract for chat UI message role. */
 export type ChatUiMessageRole = "system" | "user" | "assistant";
+/** Public API contract for chat text UI part. */
 export type ChatTextUiPart = {
     type: "text";
     text: string;
 };
+/** Public API contract for chat reasoning UI part. */
 export type ChatReasoningUiPart = {
     type: "reasoning";
     text: string;
 };
+/** Public API contract for chat step start UI part. */
 export type ChatStepStartUiPart = {
     type: "step-start";
 };
+/** Public API contract for chat source URL UI part. */
 export type ChatSourceUrlUiPart = {
     type: "source-url";
     sourceId: string;
     url: string;
     title?: string;
 };
+/** Public API contract for chat source document UI part. */
 export type ChatSourceDocumentUiPart = {
     type: "source-document";
     sourceId: string;
@@ -27,17 +35,21 @@ export type ChatSourceDocumentUiPart = {
     mediaType?: string;
     filename?: string;
 };
+/** Public API contract for chat file UI part. */
 export type ChatFileUiPart = {
     type: "file";
     mediaType: string;
     url: string;
     filename?: string;
 };
+/** File UI part enriched with upload metadata. */
 export type FileUIPartWithUpload = ChatFileUiPart & {
     uploadId?: string;
     uploadPath?: string;
 };
+/** State for chat tool part. */
 export type ChatToolPartState = "pending" | "input-streaming" | "input-available" | "approval-requested" | "approval-responded" | "output-available" | "output-error" | "output-denied" | "error" | "completed";
+/** Public API contract for chat tool part base. */
 type ChatToolPartBase = {
     toolCallId: string;
     input: unknown;
@@ -51,36 +63,45 @@ type ChatToolPartBase = {
         id: string;
     };
 };
+/** Tool UI part for a runtime-selected tool name. */
 export type ChatDynamicToolUiPart = ChatToolPartBase & {
     type: "dynamic-tool";
     toolName: string;
 };
+/** Tool UI part keyed by a static tool type. */
 export type ChatNamedToolUiPart = ChatToolPartBase & {
     type: `tool-${string}` | "tool_call";
     toolName?: string;
 };
+/** Chat UI part that carries custom data chunks. */
 export type ChatDataUiPart = {
     type: `data-${string}`;
     data: unknown;
 };
+/** Public API contract for chat UI message part. */
 export type ChatUiMessagePart = ChatTextUiPart | ChatReasoningUiPart | ChatStepStartUiPart | ChatSourceUrlUiPart | ChatSourceDocumentUiPart | FileUIPartWithUpload | ChatDynamicToolUiPart | ChatNamedToolUiPart | ChatDataUiPart;
+/** Message shape for chat UI. */
 export interface ChatUiMessage<TMessageMetadata = ChatMessageMetadata> {
     id: string;
     role: ChatUiMessageRole;
     parts: ChatUiMessagePart[];
     metadata?: TMessageMetadata;
 }
+/** JSON-compatible value used in chat tool output. */
 type JsonValue = string | number | boolean | null | JsonValue[] | {
     [key: string]: JsonValue;
 };
+/** Provider model message part that carries text. */
 export type ChatModelTextPart = {
     type: "text";
     text: string;
 };
+/** Provider model message part that carries reasoning text. */
 export type ChatModelReasoningPart = {
     type: "reasoning";
     text: string;
 };
+/** Public API contract for chat model file part. */
 export type ChatModelFilePart = {
     type: "file" | "image";
     mediaType: string;
@@ -90,6 +111,7 @@ export type ChatModelFilePart = {
     uploadId?: string;
     uploadPath?: string;
 };
+/** Provider model message part that carries a tool call. */
 export type ChatToolCallPart = {
     type: "tool-call";
     toolCallId: string;
@@ -97,6 +119,7 @@ export type ChatToolCallPart = {
     input: Record<string, unknown>;
     providerExecuted?: boolean;
 };
+/** Output from chat tool result. */
 export type ChatToolResultOutput = {
     type: "json";
     value: JsonValue;
@@ -107,6 +130,7 @@ export type ChatToolResultOutput = {
     type: "error-text";
     value: string;
 };
+/** Provider model message part that carries a tool result. */
 export type ChatToolResultPart = {
     type: "tool-result";
     toolCallId: string;
@@ -114,30 +138,39 @@ export type ChatToolResultPart = {
     output: ChatToolResultOutput;
     providerOptions?: unknown;
 };
+/** Public API contract for chat user content part. */
 export type ChatUserContentPart = ChatModelTextPart | ChatModelFilePart;
+/** Public API contract for chat assistant content part. */
 export type ChatAssistantContentPart = ChatModelTextPart | ChatModelReasoningPart | ChatModelFilePart | ChatToolCallPart | ChatToolResultPart;
+/** Message shape for chat system. */
 export type ChatSystemMessage = {
     role: "system";
     content: string;
     providerOptions?: Record<string, unknown>;
 };
+/** Message shape for chat user. */
 export type ChatUserMessage = {
     role: "user";
     content: string | ChatUserContentPart[];
 };
+/** Message shape for chat assistant. */
 export type ChatAssistantMessage = {
     role: "assistant";
     content: string | ChatAssistantContentPart[];
 };
+/** Message shape for chat tool. */
 export type ChatToolMessage = {
     role: "tool";
     content: ChatToolResultPart[];
 };
+/** Message shape for provider model. */
 export type ProviderModelMessage = ChatSystemMessage | ChatUserMessage | ChatAssistantMessage | ChatToolMessage;
 /**
  * @deprecated Use ProviderModelMessage for provider-facing model payloads.
  */
+/** Message shape for chat model. */
 export type ChatModelMessage = ProviderModelMessage;
+/** Public API contract for durable root run descriptor. */
 export interface DurableRootRunDescriptor {
     runId: string;
     messageId: string;
@@ -147,15 +180,18 @@ export interface DurableRootRunDescriptor {
     parentRunId?: string;
     spawnedFromToolCallId?: string;
 }
+/** Public API contract for chat runtime overrides. */
 export interface ChatRuntimeOverrides {
     allowedTools?: string[];
     thinking?: false | number;
     maxSteps?: number;
 }
+/** Public API contract for project file. */
 export interface ProjectFile {
     path: string;
     content: string;
 }
+/** Public API contract for project file list item. */
 export interface ProjectFileListItem {
     id: string;
     path: string;
@@ -163,6 +199,7 @@ export interface ProjectFileListItem {
     size: number;
     updated_at: string;
 }
+/** Public API contract for uploaded file reference. */
 export interface UploadedFileReference {
     name: string;
     mediaType: string;
@@ -171,20 +208,25 @@ export interface UploadedFileReference {
     url?: string;
     size?: number;
 }
+/** Zod schema for get chat request context. */
 export declare const getChatRequestContextSchema: () => import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
     conversationId: import("../internal-agents/schema.js").Schema<string | undefined>;
     projectId: import("../internal-agents/schema.js").Schema<string | null>;
     branchId: import("../internal-agents/schema.js").Schema<string | null>;
     environmentContext: import("../internal-agents/schema.js").Schema<string | undefined>;
 }>>;
-/** @deprecated Use getChatRequestContextSchema() */
+/** Schema for chat request context.
+ * @deprecated Use getChatRequestContextSchema()
+ */
 export declare const chatRequestContextSchema: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
     conversationId: import("../internal-agents/schema.js").Schema<string | undefined>;
     projectId: import("../internal-agents/schema.js").Schema<string | null>;
     branchId: import("../internal-agents/schema.js").Schema<string | null>;
     environmentContext: import("../internal-agents/schema.js").Schema<string | undefined>;
 }>>;
+/** Context for chat request. */
 export type ChatRequestContext = InferSchema<ReturnType<typeof getChatRequestContextSchema>>;
+/** Zod schema for get message metadata. */
 export declare const getMessageMetadataSchema: () => import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
     createdAt: import("../internal-agents/schema.js").Schema<string | undefined>;
     isStopped: import("../internal-agents/schema.js").Schema<boolean | undefined>;
@@ -222,7 +264,9 @@ export declare const getMessageMetadataSchema: () => import("../internal-agents/
         cachedInputTokens: import("../internal-agents/schema.js").Schema<number | undefined>;
     }> | undefined>;
 }>>;
-/** @deprecated Use getMessageMetadataSchema() */
+/** Schema for message metadata.
+ * @deprecated Use getMessageMetadataSchema()
+ */
 export declare const messageMetadataSchema: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
     createdAt: import("../internal-agents/schema.js").Schema<string | undefined>;
     isStopped: import("../internal-agents/schema.js").Schema<boolean | undefined>;
@@ -260,12 +304,19 @@ export declare const messageMetadataSchema: import("../internal-agents/schema.js
         cachedInputTokens: import("../internal-agents/schema.js").Schema<number | undefined>;
     }> | undefined>;
 }>>;
+/** Zod schema for get chat UI message role. */
 export declare const getChatUiMessageRoleSchema: () => import("../internal-agents/schema.js").Schema<string>;
-/** @deprecated Use getChatUiMessageRoleSchema() */
+/** Schema for chat ui message role.
+ * @deprecated Use getChatUiMessageRoleSchema()
+ */
 export declare const chatUiMessageRoleSchema: import("../internal-agents/schema.js").Schema<string>;
+/** Zod schema for get chat tool part state. */
 export declare const getChatToolPartStateSchema: () => import("../internal-agents/schema.js").Schema<string>;
-/** @deprecated Use getChatToolPartStateSchema() */
+/** Schema for chat tool part state.
+ * @deprecated Use getChatToolPartStateSchema()
+ */
 export declare const chatToolPartStateSchema: import("../internal-agents/schema.js").Schema<string>;
+/** Zod schema for get chat UI message part. */
 export declare const getChatUiMessagePartSchema: () => import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
     type: import("../internal-agents/schema.js").Schema<"text">;
     text: import("../internal-agents/schema.js").Schema<string>;
@@ -328,7 +379,9 @@ export declare const getChatUiMessagePartSchema: () => import("../internal-agent
     type: import("../internal-agents/schema.js").Schema<`data-${string}`>;
     data: import("../internal-agents/schema.js").Schema<unknown>;
 }>>;
-/** @deprecated Use getChatUiMessagePartSchema() */
+/** Schema for chat ui message part.
+ * @deprecated Use getChatUiMessagePartSchema()
+ */
 export declare const chatUiMessagePartSchema: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
     type: import("../internal-agents/schema.js").Schema<"text">;
     text: import("../internal-agents/schema.js").Schema<string>;
@@ -391,6 +444,7 @@ export declare const chatUiMessagePartSchema: import("../internal-agents/schema.
     type: import("../internal-agents/schema.js").Schema<`data-${string}`>;
     data: import("../internal-agents/schema.js").Schema<unknown>;
 }>>;
+/** Zod schema for get chat UI message. */
 export declare const getChatUiMessageSchema: () => import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
     id: import("../internal-agents/schema.js").Schema<string>;
     role: import("../internal-agents/schema.js").Schema<string>;
@@ -494,7 +548,9 @@ export declare const getChatUiMessageSchema: () => import("../internal-agents/sc
         }> | undefined>;
     }> | undefined>;
 }>>;
-/** @deprecated Use getChatUiMessageSchema() */
+/** Schema for chat ui message.
+ * @deprecated Use getChatUiMessageSchema()
+ */
 export declare const chatUiMessageSchema: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
     id: import("../internal-agents/schema.js").Schema<string>;
     role: import("../internal-agents/schema.js").Schema<string>;
@@ -598,6 +654,7 @@ export declare const chatUiMessageSchema: import("../internal-agents/schema.js")
         }> | undefined>;
     }> | undefined>;
 }>>;
+/** Zod schema for get chat UI messages. */
 export declare const getChatUiMessagesSchema: () => import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
     id: import("../internal-agents/schema.js").Schema<string>;
     role: import("../internal-agents/schema.js").Schema<string>;
@@ -701,7 +758,9 @@ export declare const getChatUiMessagesSchema: () => import("../internal-agents/s
         }> | undefined>;
     }> | undefined>;
 }>[]>;
-/** @deprecated Use getChatUiMessagesSchema() */
+/** Schema for chat ui messages.
+ * @deprecated Use getChatUiMessagesSchema()
+ */
 export declare const chatUiMessagesSchema: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
     id: import("../internal-agents/schema.js").Schema<string>;
     role: import("../internal-agents/schema.js").Schema<string>;
@@ -805,10 +864,15 @@ export declare const chatUiMessagesSchema: import("../internal-agents/schema.js"
         }> | undefined>;
     }> | undefined>;
 }>[]>;
+/** Check whether a file is an image. */
 export declare function isImageFile(type: string | undefined): boolean;
+/** Check whether a file is a supported image upload. */
 export declare function isValidImageFile(type: string): boolean;
+/** Check whether a file supports text preview. */
 export declare function isTextPreviewFile(name: string | undefined, type: string | undefined): boolean;
+/** Normalizes inline attachment media type. */
 export declare function normalizeInlineAttachmentMediaType(filename: string | undefined, mediaType: string | undefined): string;
+/** Builds data file annotation. */
 export declare function buildDataFileAnnotation(refs: UploadedFileReference[]): string;
 export type { ChatMessageMetadata, ChatMessageMetadata as MessageMetadata, ChatMessageMetadataUsage, ChatUiMessageChunk, ChildRunAudit, ChildRunAuditToolCall, ChildRunAuditToolResult, };
 //# sourceMappingURL=types.d.ts.map