veryfront 0.1.558 → 0.1.560

package/esm/src/chat/conversation.js

@@ -1,4 +1,5 @@
 import { defineSchema, lazySchema } from "../schemas/index.js";
+/** Zod schema for get message part. */
 export const getMessagePartSchema = defineSchema((v) => v.discriminatedUnion("type", [
     v.object({ type: v.literal("text"), text: v.string() }),
     v.object({
@@ -47,14 +48,23 @@ export const getMessagePartSchema = defineSchema((v) => v.discriminatedUnion("ty
     }),
     v.object({ type: v.literal("data"), name: v.string(), value: v.unknown() }),
 ]));
-/** @deprecated Use getMessagePartSchema() */
+/** Schema for message part.
+ * @deprecated Use getMessagePartSchema()
+ */
 export const messagePartSchema = lazySchema(getMessagePartSchema);
+/** Zod schema for get conversation type. */
 export const getConversationTypeSchema = defineSchema((v) => v.enum(["chat", "agent_task", "support", "channel", "project_agent"]));
-/** @deprecated Use getConversationTypeSchema() */
+/** Schema for conversation type.
+ * @deprecated Use getConversationTypeSchema()
+ */
 export const conversationTypeSchema = lazySchema(getConversationTypeSchema);
+/** Zod schema for get message status. */
 export const getMessageStatusSchema = defineSchema((v) => v.enum(["pending", "streaming", "completed", "error", "failed", "cancelled", "stopped"]));
-/** @deprecated Use getMessageStatusSchema() */
+/** Schema for message status.
+ * @deprecated Use getMessageStatusSchema()
+ */
 export const messageStatusSchema = lazySchema(getMessageStatusSchema);
+/** Zod schema for get API conversation. */
 export const getApiConversationSchema = defineSchema((v) => v.object({
     id: v.string(),
     projectId: v.string().nullable().optional(),
@@ -71,8 +81,11 @@ export const getApiConversationSchema = defineSchema((v) => v.object({
     createdAt: v.string(),
     updatedAt: v.string(),
 }));
-/** @deprecated Use getApiConversationSchema() */
+/** Schema for API conversation.
+ * @deprecated Use getApiConversationSchema()
+ */
 export const apiConversationSchema = lazySchema(getApiConversationSchema);
+/** Zod schema for get API message. */
 export const getApiMessageSchema = defineSchema((v) => v.object({
     id: v.string(),
     conversationId: v.string(),
@@ -92,16 +105,22 @@ export const getApiMessageSchema = defineSchema((v) => v.object({
     createdAt: v.string(),
     updatedAt: v.string().nullable(),
 }));
-/** @deprecated Use getApiMessageSchema() */
+/** Schema for API message.
+ * @deprecated Use getApiMessageSchema()
+ */
 export const apiMessageSchema = lazySchema(getApiMessageSchema);
+/** Shared UUID pattern value. */
 export const UUID_PATTERN = /\b[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\b/i;
+/** Check whether a value is a UUID. */
 export function isUuid(value) {
     return typeof value === "string" && UUID_PATTERN.test(value);
 }
+/** Extract upload ID. */
 export function extractUploadId(url) {
     const match = url.match(UUID_PATTERN);
     return match ? match[0] : null;
 }
+/** State for map tool. */
 export function mapToolState(sdkState) {
     switch (sdkState) {
         case "input-streaming":
@@ -120,9 +139,11 @@ export function mapToolState(sdkState) {
             return "pending";
     }
 }
+/** Record shape for is. */
 export function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+/** Return string field. */
 export function getStringField(value, field, fallback) {
     if (!isRecord(value) || typeof value[field] !== "string") {
         return fallback;
@@ -143,6 +164,7 @@ function getNonEmptyStringField(value, key) {
 function toRecord(value) {
     return isRecord(value) ? Object.fromEntries(Object.entries(value)) : {};
 }
+/** Stringify unknown helper. */
 export function stringifyUnknown(value) {
     if (typeof value === "string")
         return value;
@@ -154,14 +176,17 @@ export function stringifyUnknown(value) {
         return String(value);
     }
 }
+/** Check whether a chat part is a custom data part. */
 export function isDataUiPart(part) {
     return part.type.startsWith("data-") && "data" in part;
 }
+/** Check whether a chat part is a tool UI part. */
 export function isToolUiPart(part) {
     return ((part.type === "dynamic-tool" || part.type.startsWith("tool-")) &&
         typeof getOptionalStringField(part, "toolCallId") === "string" &&
         typeof getOptionalStringField(part, "state") === "string");
 }
+/** Return UI tool name. */
 export function getUiToolName(part) {
     const explicitToolName = getOptionalStringField(part, "toolName");
     if (explicitToolName) {
@@ -169,6 +194,7 @@ export function getUiToolName(part) {
     }
     return part.type.startsWith("tool-") ? part.type.replace(/^tool-/, "") : undefined;
 }
+/** Push tool parts. */
 export function pushToolParts(parts, toolName, toolCallId, state, part) {
     const input = toRecord(part.input);
     const isErroredState = state === "output-error" || state === "error" || state === "output-denied";
@@ -220,6 +246,7 @@ function pushFileConversationPart(parts, part) {
         ...(part.url ? { url: part.url } : {}),
     });
 }
+/** Message shape for to conversation parts from UI. */
 export function toConversationPartsFromUiMessage(message) {
     const parts = [];
     for (const part of message.parts) {
@@ -280,12 +307,15 @@ function isToolComplete(part) {
     return part.state === "output-available" || part.state === "output-error" ||
         part.state === "output-denied";
 }
+/** Check whether incomplete tool parts is present. */
 export function hasIncompleteToolParts(message) {
     return message.parts.some((part) => isToolUiPart(part) && !isToolComplete(part));
 }
+/** Mark incomplete tool parts as stopped. */
 export function markIncompleteToolPartsAsStopped(message) {
     return markIncompleteToolPartsAsErrored(message, "Stopped by user");
 }
+/** Mark incomplete tool parts as errored. */
 export function markIncompleteToolPartsAsErrored(message, errorText) {
     let mutated = false;
     const parts = message.parts.map((part) => {
@@ -323,24 +353,29 @@ function markToolPartAsErrored(part, errorText) {
         errorText,
     };
 }
+/** Check whether a value is a tool-call part. */
 export function isToolCallPart(value) {
     return (isRecord(value) &&
         value.type === "tool-call" &&
         typeof value.toolCallId === "string" &&
         typeof value.toolName === "string");
 }
+/** Check whether a value is a tool-result part. */
 export function isToolResultPart(value) {
     return (isRecord(value) &&
         value.type === "tool-result" &&
         typeof value.toolCallId === "string" &&
         typeof value.toolName === "string");
 }
+/** Check whether a value is a text part. */
 export function isTextPart(value) {
     return isRecord(value) && value.type === "text" && typeof value.text === "string";
 }
+/** Check whether a value is a reasoning part. */
 export function isReasoningPart(value) {
     return isRecord(value) && value.type === "reasoning" && typeof value.text === "string";
 }
+/** Message shape for extract text from. */
 export function extractTextFromMessage(message) {
     if (!message || !message.content)
         return "";
@@ -642,6 +677,7 @@ function convertAssistantMessage(message) {
     flushAssistantMessage(deferredAssistantContent);
     return messages;
 }
+/** Convert UI messages to provider model messages. */
 export function convertUiMessagesToProviderModelMessages(messages) {
     return messages.flatMap((message) => {
         switch (message.role) {
@@ -659,4 +695,5 @@ export function convertUiMessagesToProviderModelMessages(messages) {
 /**
  * @deprecated Use convertUiMessagesToProviderModelMessages for provider-facing model payloads.
  */
+/** Shared convert UI messages to model messages value. */
 export const convertUiMessagesToModelMessages = convertUiMessagesToProviderModelMessages;

package/esm/src/chat/final-step-fallback.d.ts

@@ -1,18 +1,24 @@
 import type { ChatUiMessage, ChatUiMessageChunk, MessageMetadata } from "./types.js";
+/** Default value for stream promise timeout ms. */
 export declare const DEFAULT_STREAM_PROMISE_TIMEOUT_MS = 10000;
+/** Public API contract for chat fallback part. */
 export type ChatFallbackPart = ChatUiMessage["parts"][number];
+/** Public API contract for chat part. */
 type ChatPart = ChatFallbackPart;
+/** Public API contract for final step tool call. */
 export interface FinalStepToolCall {
     toolCallId: string;
     toolName: string;
     input: unknown;
 }
+/** Result returned from final step tool. */
 export interface FinalStepToolResult {
     toolCallId: string;
     toolName: string;
     input: unknown;
     output: unknown;
 }
+/** State for fallback tool chunk. */
 export interface FallbackToolChunkState {
     startedToolCallIds: ReadonlySet<string>;
     inputAvailableToolCallIds: ReadonlySet<string>;
@@ -20,29 +26,43 @@ export interface FallbackToolChunkState {
     outputErrorToolCallIds?: ReadonlySet<string>;
     outputDeniedToolCallIds?: ReadonlySet<string>;
 }
+/** Error shape for final step terminal. */
 interface FinalStepTerminalError {
     code: string;
     message: string;
 }
+/** Return last stream step. */
 export declare function getLastStreamStep(result: {
     steps: PromiseLike<readonly unknown[]>;
 }, timeoutMs?: number): Promise<unknown | null>;
+/** Return stream steps. */
 export declare function getStreamSteps(result: {
     steps: PromiseLike<readonly unknown[]>;
 }, timeoutMs?: number): Promise<{
     steps: readonly unknown[];
     lastStep: unknown | null;
 }>;
+/** Extract final step finish reason. */
 export declare function extractFinalStepFinishReason(step: unknown): string | null;
+/** Extract final step text. */
 export declare function extractFinalStepText(step: unknown): string;
+/** Extract final step tool calls. */
 export declare function extractFinalStepToolCalls(step: unknown): FinalStepToolCall[];
+/** Extract final step tool results. */
 export declare function extractFinalStepToolResults(step: unknown): FinalStepToolResult[];
+/** Error shape for extract final step terminal. */
 export declare function extractFinalStepTerminalError(step: unknown): FinalStepTerminalError | null;
+/** Builds fallback UI message parts. */
 export declare function buildFallbackUiMessageParts(step: unknown): ChatPart[];
+/** Append missing fallback text part. */
 export declare function appendMissingFallbackTextPart(parts: readonly ChatPart[], step: unknown): ChatPart[];
+/** Builds fallback UI message chunks. */
 export declare function buildFallbackUiMessageChunks(step: unknown, messageId: string): ChatUiMessageChunk<MessageMetadata>[];
+/** Builds missing fallback tool chunks. */
 export declare function buildMissingFallbackToolChunks(step: unknown, state?: Partial<FallbackToolChunkState>): ChatUiMessageChunk<MessageMetadata>[];
+/** Builds missing fallback tool chunks from parts. */
 export declare function buildMissingFallbackToolChunksFromParts(parts: readonly ChatPart[], state?: Partial<FallbackToolChunkState>): ChatUiMessageChunk<MessageMetadata>[];
+/** Builds missing fallback text chunks. */
 export declare function buildMissingFallbackTextChunks(parts: readonly ChatPart[], step: unknown, messageId: string): ChatUiMessageChunk<MessageMetadata>[];
 export {};
 //# sourceMappingURL=final-step-fallback.d.ts.map

package/esm/src/chat/final-step-fallback.d.ts.map

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

package/esm/src/chat/final-step-fallback.js

@@ -4,6 +4,7 @@ function toToolInput(value) {
     return isRecord(value) ? Object.fromEntries(Object.entries(value)) : {};
 }
 const STREAM_PROMISE_TIMEOUT_TOKEN = Symbol("stream-promise-timeout");
+/** Default value for stream promise timeout ms. */
 export const DEFAULT_STREAM_PROMISE_TIMEOUT_MS = 10_000;
 function isToolUiPart(part) {
     return isRecord(part) && typeof Reflect.get(part, "toolCallId") === "string" && "state" in part;
@@ -531,26 +532,31 @@ async function resolveStreamPromiseWithTimeout(promise, timeoutMs, fallback) {
         }
     }
 }
+/** Return last stream step. */
 export async function getLastStreamStep(result, timeoutMs = DEFAULT_STREAM_PROMISE_TIMEOUT_MS) {
     const steps = await resolveStreamPromiseWithTimeout(result.steps, timeoutMs, []);
     return steps.at(-1) ?? null;
 }
+/** Return stream steps. */
 export async function getStreamSteps(result, timeoutMs = DEFAULT_STREAM_PROMISE_TIMEOUT_MS) {
     const steps = await resolveStreamPromiseWithTimeout(result.steps, timeoutMs, []);
     return { steps, lastStep: steps.at(-1) ?? null };
 }
+/** Extract final step finish reason. */
 export function extractFinalStepFinishReason(step) {
     if (!isRecord(step) || typeof step.finishReason !== "string") {
         return null;
     }
     return step.finishReason;
 }
+/** Extract final step text. */
 export function extractFinalStepText(step) {
     if (isRecord(step) && typeof step.text === "string" && step.text.trim().length > 0) {
         return step.text.trim();
     }
     return extractTextFromResponseMessages(step);
 }
+/** Extract final step tool calls. */
 export function extractFinalStepToolCalls(step) {
     if (!isRecord(step) || !Array.isArray(step.toolCalls)) {
         return [];
@@ -569,6 +575,7 @@ export function extractFinalStepToolCalls(step) {
         ];
     });
 }
+/** Extract final step tool results. */
 export function extractFinalStepToolResults(step) {
     if (!isRecord(step) || !Array.isArray(step.toolResults)) {
         return [];
@@ -604,6 +611,7 @@ function parseProblemBody(body) {
     }
     return { code: match.code, message: match.message };
 }
+/** Error shape for extract final step terminal. */
 export function extractFinalStepTerminalError(step) {
     const responseBody = parseFinalStepResponseBody(step);
     if (responseBody == null) {
@@ -618,6 +626,7 @@ export function extractFinalStepTerminalError(step) {
     }
     return parseProblemBody(responseBody);
 }
+/** Builds fallback UI message parts. */
 export function buildFallbackUiMessageParts(step) {
     return buildFallbackUiMessagePartsFromInput({
         step,
@@ -626,6 +635,7 @@ export function buildFallbackUiMessageParts(step) {
         extractFinalStepToolResults,
     });
 }
+/** Append missing fallback text part. */
 export function appendMissingFallbackTextPart(parts, step) {
     return appendMissingFallbackTextPartFromInput({
         parts,
@@ -633,6 +643,7 @@ export function appendMissingFallbackTextPart(parts, step) {
         extractFinalStepText,
     });
 }
+/** Builds fallback UI message chunks. */
 export function buildFallbackUiMessageChunks(step, messageId) {
     const chunks = buildMissingFallbackToolChunks(step);
     const text = extractFinalStepText(step);
@@ -653,6 +664,7 @@ export function buildFallbackUiMessageChunks(step, messageId) {
     }
     return chunks;
 }
+/** Builds missing fallback tool chunks. */
 export function buildMissingFallbackToolChunks(step, state) {
     return buildMissingFallbackToolChunksFromInput({
         step,
@@ -661,12 +673,14 @@ export function buildMissingFallbackToolChunks(step, state) {
         extractFinalStepToolResults,
     });
 }
+/** Builds missing fallback tool chunks from parts. */
 export function buildMissingFallbackToolChunksFromParts(parts, state) {
     if (parts.length === 0 && (!state || Object.keys(state).length === 0)) {
         return [];
     }
     return buildMissingFallbackToolChunksFromPartsFromInput(parts, state);
 }
+/** Builds missing fallback text chunks. */
 export function buildMissingFallbackTextChunks(parts, step, messageId) {
     return buildMissingFallbackTextChunksFromInput({
         parts,

package/esm/src/chat/hosted-ui-chunk-mapping.d.ts

@@ -1,4 +1,5 @@
 import type { ChatMessageMetadata, ChatUiMessageChunk } from "./protocol.js";
+/** Options accepted by hosted UI chunk mapping. */
 export type HostedUiChunkMappingOptions = {
     messageId?: string | null;
     reasoningMessageId?: string | null;
@@ -20,6 +21,7 @@ export type HostedStreamSourcePart = {
     title?: string;
     filename?: string;
 };
+/** Public API contract for hosted stream part for UI chunk mapping. */
 export type HostedStreamPartForUiChunkMapping = {
     type: "start";
 } | {
@@ -107,5 +109,6 @@ export type HostedStreamPartForUiChunkMapping = {
 } | {
     type: "raw";
 };
+/** Map hosted stream part to chat UI chunks. */
 export declare function mapHostedStreamPartToChatUiChunks(part: HostedStreamPartForUiChunkMapping, options?: HostedUiChunkMappingOptions): ChatUiMessageChunk<ChatMessageMetadata>[];
 //# sourceMappingURL=hosted-ui-chunk-mapping.d.ts.map

package/esm/src/chat/hosted-ui-chunk-mapping.d.ts.map

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

package/esm/src/chat/hosted-ui-chunk-mapping.js

@@ -56,6 +56,7 @@ function mapToolErrorPartToUiChunks(part, onError) {
         },
     ];
 }
+/** Map hosted stream part to chat UI chunks. */
 export function mapHostedStreamPartToChatUiChunks(part, options = {}) {
     const onError = options.onError ?? defaultOnError;
     const sendReasoning = options.sendReasoning ?? true;

package/esm/src/chat/message-prep.d.ts

@@ -1,26 +1,44 @@
 import { type ChatUiMessage, type ProviderModelMessage } from "./types.js";
+/** Estimate tokens. */
 export declare function estimateTokens(value: unknown): number;
+/** Compress turn. */
 export declare function compressTurn(messages: ProviderModelMessage[], startIdx: number, endIdx: number): ProviderModelMessage[];
+/** Enforce token budget with turn compression. */
 export declare function enforceTokenBudgetWithTurnCompression(messages: ProviderModelMessage[], budget: number, overhead: number): ProviderModelMessage[];
+/** Check whether the model supports the file media type. */
 export declare function isModelSupportedFileMediaType(mediaType: string): boolean;
+/** Normalizes message file part media types. */
 export declare function normalizeMessageFilePartMediaTypes(messages: ChatUiMessage[]): ChatUiMessage[];
+/** Rewrite unsupported file parts as annotations. */
 export declare function rewriteUnsupportedFilePartsAsAnnotations(messages: ChatUiMessage[]): ChatUiMessage[];
+/** Strip pending tool parts. */
 export declare function stripPendingToolParts(messages: ChatUiMessage[]): ChatUiMessage[];
+/** Sanitize provider model messages. */
 export declare function sanitizeProviderModelMessages(messages: ProviderModelMessage[]): ProviderModelMessage[];
 /**
  * @deprecated Use sanitizeProviderModelMessages for provider-facing model payloads.
  */
+/** Shared sanitize model messages value. */
 export declare const sanitizeModelMessages: typeof sanitizeProviderModelMessages;
+/** Prepare provider model messages from UI messages. */
 export declare function prepareProviderModelMessagesFromUiMessages(messages: ChatUiMessage[]): ProviderModelMessage[];
+/** Mask old tool outputs. */
 export declare function maskOldToolOutputs(messages: ProviderModelMessage[]): ProviderModelMessage[];
+/** Repair tool pairs. */
 export declare function repairToolPairs(messages: ProviderModelMessage[]): ProviderModelMessage[];
+/** Estimate overhead. */
 export declare function estimateOverhead(instructions: unknown, toolCount: number): number;
+/** Ensure tool call inputs helper. */
 export declare function ensureToolCallInputs(messages: ProviderModelMessage[]): ProviderModelMessage[];
+/** Compact for step. */
 export declare function compactForStep(messages: ProviderModelMessage[], overhead?: number): ProviderModelMessage[];
+/** Dedupe tool history. */
 export declare function dedupeToolHistory(messages: ProviderModelMessage[]): ProviderModelMessage[];
+/** Enforce token budget. */
 export declare function enforceTokenBudget(messages: ProviderModelMessage[], budget?: number, overhead?: number): ProviderModelMessage[];
 /**
  * @deprecated Use prepareProviderModelMessagesFromUiMessages for provider-facing model payloads.
  */
+/** Shared prepare model messages from UI messages value. */
 export declare const prepareModelMessagesFromUiMessages: typeof prepareProviderModelMessagesFromUiMessages;
 //# sourceMappingURL=message-prep.d.ts.map

package/esm/src/chat/message-prep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-prep.d.ts","sourceRoot":"","sources":["../../../src/src/chat/message-prep.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AAQjC,OAAO,EAKL,KAAK,aAAa,EAGlB,KAAK,oBAAoB,EAE1B,MAAM,YAAY,CAAC;AAIpB,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAErD;AAOD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,oBAAoB,EAAE,EAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,oBAAoB,EAAE,CAiCxB;AAqCD,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,oBAAoB,EAAE,EAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,oBAAoB,EAAE,CAiExB;AA+BD,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAGxE;AAED,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAwB7F;AAED,wBAAgB,wCAAwC,CACtD,QAAQ,EAAE,aAAa,EAAE,GACxB,aAAa,EAAE,CAmDjB;AAiBD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAiBhF;AA6CD,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,oBAAoB,EAAE,GAC/B,oBAAoB,EAAE,CAwBxB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,sCAAgC,CAAC;AAYnE,wBAAgB,0CAA0C,CACxD,QAAQ,EAAE,aAAa,EAAE,GACxB,oBAAoB,EAAE,CAcxB;AA4FD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,oBAAoB,EAAE,CAsE3F;AAWD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,oBAAoB,EAAE,CA4IxF;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGjF;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,oBAAoB,EAAE,CA4B7F;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,oBAAoB,EAAE,EAChC,QAAQ,GAAE,MAAU,GACnB,oBAAoB,EAAE,CAexB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,oBAAoB,EAAE,CA0D1F;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,oBAAoB,EAAE,EAChC,MAAM,GAAE,MAA6B,EACrC,QAAQ,GAAE,MAAU,GACnB,oBAAoB,EAAE,CAMxB;AAED;;GAEG;AACH,eAAO,MAAM,kCAAkC,mDAA6C,CAAC"}
+{"version":3,"file":"message-prep.d.ts","sourceRoot":"","sources":["../../../src/src/chat/message-prep.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AAQjC,OAAO,EAKL,KAAK,aAAa,EAGlB,KAAK,oBAAoB,EAE1B,MAAM,YAAY,CAAC;AAIpB,uBAAuB;AACvB,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAErD;AAOD,qBAAqB;AACrB,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,oBAAoB,EAAE,EAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,oBAAoB,EAAE,CAiCxB;AAqCD,kDAAkD;AAClD,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,oBAAoB,EAAE,EAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,oBAAoB,EAAE,CAiExB;AA+BD,4DAA4D;AAC5D,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAGxE;AAED,gDAAgD;AAChD,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAwB7F;AAED,qDAAqD;AACrD,wBAAgB,wCAAwC,CACtD,QAAQ,EAAE,aAAa,EAAE,GACxB,aAAa,EAAE,CAmDjB;AAiBD,gCAAgC;AAChC,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAiBhF;AA6CD,wCAAwC;AACxC,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,oBAAoB,EAAE,GAC/B,oBAAoB,EAAE,CAwBxB;AAED;;GAEG;AACH,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,sCAAgC,CAAC;AAYnE,wDAAwD;AACxD,wBAAgB,0CAA0C,CACxD,QAAQ,EAAE,aAAa,EAAE,GACxB,oBAAoB,EAAE,CAcxB;AA4FD,6BAA6B;AAC7B,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,oBAAoB,EAAE,CAsE3F;AAWD,yBAAyB;AACzB,wBAAgB,eAAe,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,oBAAoB,EAAE,CA4IxF;AAED,yBAAyB;AACzB,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGjF;AAED,sCAAsC;AACtC,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,oBAAoB,EAAE,CA4B7F;AAED,wBAAwB;AACxB,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,oBAAoB,EAAE,EAChC,QAAQ,GAAE,MAAU,GACnB,oBAAoB,EAAE,CAexB;AAED,2BAA2B;AAC3B,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,oBAAoB,EAAE,CA0D1F;AAED,4BAA4B;AAC5B,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,oBAAoB,EAAE,EAChC,MAAM,GAAE,MAA6B,EACrC,QAAQ,GAAE,MAAU,GACnB,oBAAoB,EAAE,CAMxB;AAED;;GAEG;AACH,4DAA4D;AAC5D,eAAO,MAAM,kCAAkC,mDAA6C,CAAC"}

package/esm/src/chat/message-prep.js

@@ -1,6 +1,7 @@
 import { convertUiMessagesToProviderModelMessages, getStringField, isReasoningPart, isToolCallPart, isToolResultPart, } from "./conversation.js";
 import { buildDataFileAnnotation, normalizeInlineAttachmentMediaType, } from "./types.js";
 const CHARS_PER_TOKEN = 4;
+/** Estimate tokens. */
 export function estimateTokens(value) {
     return Math.ceil(JSON.stringify(value ?? "").length / CHARS_PER_TOKEN);
 }
@@ -9,6 +10,7 @@ function truncate(text, maxLen) {
         return text;
     return `${text.slice(0, maxLen)}…`;
 }
+/** Compress turn. */
 export function compressTurn(messages, startIdx, endIdx) {
     let userQuery = "";
     const toolNames = [];
@@ -68,6 +70,7 @@ function collectTurns(messages) {
     }
     return turns;
 }
+/** Enforce token budget with turn compression. */
 export function enforceTokenBudgetWithTurnCompression(messages, budget, overhead) {
     const effectiveBudget = budget - overhead;
     let totalTokens = messages.reduce((sum, message) => sum + estimateTokens(message.content), 0);
@@ -149,10 +152,12 @@ function tryParseJson(value) {
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+/** Check whether the model supports the file media type. */
 export function isModelSupportedFileMediaType(mediaType) {
     return mediaType.startsWith("image/") || mediaType === "application/pdf" ||
         mediaType === "text/plain";
 }
+/** Normalizes message file part media types. */
 export function normalizeMessageFilePartMediaTypes(messages) {
     return messages.map((message) => {
         if (!message.parts.some((part) => part.type === "file")) {
@@ -174,6 +179,7 @@ export function normalizeMessageFilePartMediaTypes(messages) {
         return { ...message, parts };
     });
 }
+/** Rewrite unsupported file parts as annotations. */
 export function rewriteUnsupportedFilePartsAsAnnotations(messages) {
     return messages.map((message) => {
         if (message.parts.length === 0) {
@@ -231,6 +237,7 @@ function isPendingToolPart(part) {
     }
     return part.type === "dynamic-tool" || part.type === "tool_call" || part.type.startsWith("tool-");
 }
+/** Strip pending tool parts. */
 export function stripPendingToolParts(messages) {
     return messages.flatMap((message) => {
         if (message.role !== "assistant" || message.parts.length === 0) {
@@ -287,6 +294,7 @@ function cleanContent(content) {
     const hasSubstantiveContent = content.some((part) => isKeepableModelPart(part, false));
     return content.filter((part) => isKeepableModelPart(part, hasSubstantiveContent));
 }
+/** Sanitize provider model messages. */
 export function sanitizeProviderModelMessages(messages) {
     const result = [];
     for (const message of messages) {
@@ -317,6 +325,7 @@ export function sanitizeProviderModelMessages(messages) {
 /**
  * @deprecated Use sanitizeProviderModelMessages for provider-facing model payloads.
  */
+/** Shared sanitize model messages value. */
 export const sanitizeModelMessages = sanitizeProviderModelMessages;
 function filterValidMessages(messages) {
     return messages.filter((message) => {
@@ -330,6 +339,7 @@ function filterValidMessages(messages) {
         return true;
     });
 }
+/** Prepare provider model messages from UI messages. */
 export function prepareProviderModelMessagesFromUiMessages(messages) {
     const validMessages = messages.filter((message) => message && typeof message === "object" && "role" in message);
     const normalizedMessages = normalizeMessageFilePartMediaTypes(validMessages);
@@ -422,6 +432,7 @@ function wrapToolResultOutput(original, newValue) {
     }
     return original;
 }
+/** Mask old tool outputs. */
 export function maskOldToolOutputs(messages) {
     let lastUserIdx = -1;
     for (let i = messages.length - 1; i >= 0; i--) {
@@ -492,6 +503,7 @@ function createSyntheticToolResult(toolCallId, toolName) {
         output: { type: "text", value: "[tool result unavailable]" },
     };
 }
+/** Repair tool pairs. */
 export function repairToolPairs(messages) {
     const result = [...messages];
     let mutated = false;
@@ -599,10 +611,12 @@ export function repairToolPairs(messages) {
     }
     return mutated ? result : messages;
 }
+/** Estimate overhead. */
 export function estimateOverhead(instructions, toolCount) {
     const instructionTokens = estimateTokens(instructions);
     return instructionTokens + toolCount * TOKENS_PER_TOOL;
 }
+/** Ensure tool call inputs helper. */
 export function ensureToolCallInputs(messages) {
     let mutated = false;
     const result = messages.map((msg) => {
@@ -627,6 +641,7 @@ export function ensureToolCallInputs(messages) {
     });
     return mutated ? result : messages;
 }
+/** Compact for step. */
 export function compactForStep(messages, overhead = 0) {
     const compacted = enforceTokenBudget(maskOldToolOutputs(messages), DEFAULT_TOKEN_BUDGET, overhead);
     let end = compacted.length;
@@ -636,6 +651,7 @@ export function compactForStep(messages, overhead = 0) {
     const trimmed = end < compacted.length ? compacted.slice(0, end) : compacted;
     return ensureToolCallInputs(repairToolPairs(dedupeToolHistory(trimmed)));
 }
+/** Dedupe tool history. */
 export function dedupeToolHistory(messages) {
     const seenToolCallIds = new Set();
     const seenToolResultIds = new Set();
@@ -697,6 +713,7 @@ export function dedupeToolHistory(messages) {
     }
     return mutated ? deduped : messages;
 }
+/** Enforce token budget. */
 export function enforceTokenBudget(messages, budget = DEFAULT_TOKEN_BUDGET, overhead = 0) {
     if (messages.length === 0) {
         return messages;
@@ -706,4 +723,5 @@ export function enforceTokenBudget(messages, budget = DEFAULT_TOKEN_BUDGET, over
 /**
  * @deprecated Use prepareProviderModelMessagesFromUiMessages for provider-facing model payloads.
  */
+/** Shared prepare model messages from UI messages value. */
 export const prepareModelMessagesFromUiMessages = prepareProviderModelMessagesFromUiMessages;