veryfront 0.1.285 → 0.1.286

package/esm/deno.d.ts

@@ -14,6 +14,7 @@ declare namespace _default {
         "./chat": string;
         "./chat/ag-ui": string;
         "./chat/protocol": string;
+        "./chat/types": string;
         "./markdown": string;
         "./mdx": string;
         "./agent": string;
@@ -52,6 +53,7 @@ declare namespace _default {
         "veryfront/chat": string;
         "veryfront/chat/ag-ui": string;
         "veryfront/chat/protocol": string;
+        "veryfront/chat/types": string;
         "veryfront/markdown": string;
         "veryfront/mdx": string;
         "veryfront/fs": string;

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.285",
+    "version": "0.1.286",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "workspace": [
@@ -34,6 +34,7 @@ export default {
         "./chat": "./src/chat/index.ts",
         "./chat/ag-ui": "./src/chat/ag-ui.ts",
         "./chat/protocol": "./src/chat/protocol.ts",
+        "./chat/types": "./src/chat/types.ts",
         "./markdown": "./src/markdown/index.ts",
         "./mdx": "./src/mdx/index.ts",
         "./agent": "./src/agent/index.ts",
@@ -72,6 +73,7 @@ export default {
         "veryfront/chat": "./src/chat/index.ts",
         "veryfront/chat/ag-ui": "./src/chat/ag-ui.ts",
         "veryfront/chat/protocol": "./src/chat/protocol.ts",
+        "veryfront/chat/types": "./src/chat/types.ts",
         "veryfront/markdown": "./src/markdown/index.ts",
         "veryfront/mdx": "./src/mdx/index.ts",
         "veryfront/fs": "./src/fs/index.ts",

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

@@ -0,0 +1,189 @@
+import type { ChatMessageMetadata, ChatMessageMetadataUsage, ChatUiMessageChunk, ChildRunAudit, ChildRunAuditToolCall, ChildRunAuditToolResult } from "./protocol.js";
+import { z } from "zod";
+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"];
+export declare const imageFileTypes: readonly ["image/png", "image/jpeg", "image/jpg", "image/gif", "image/webp", "image/bmp", "image/tiff"];
+export type ChatUiMessageRole = "system" | "user" | "assistant";
+export type ChatTextUiPart = {
+    type: "text";
+    text: string;
+};
+export type ChatReasoningUiPart = {
+    type: "reasoning";
+    text: string;
+};
+export type ChatStepStartUiPart = {
+    type: "step-start";
+};
+export type ChatSourceUrlUiPart = {
+    type: "source-url";
+    sourceId: string;
+    url: string;
+    title?: string;
+};
+export type ChatSourceDocumentUiPart = {
+    type: "source-document";
+    sourceId: string;
+    title: string;
+    mediaType?: string;
+    filename?: string;
+};
+export type ChatFileUiPart = {
+    type: "file";
+    mediaType: string;
+    url: string;
+    filename?: string;
+};
+export type FileUIPartWithUpload = ChatFileUiPart & {
+    uploadId?: string;
+    uploadPath?: string;
+};
+export type ChatToolPartState = "pending" | "input-streaming" | "input-available" | "approval-requested" | "approval-responded" | "output-available" | "output-error" | "output-denied" | "error" | "completed";
+type ChatToolPartBase = {
+    toolCallId: string;
+    input: unknown;
+    state: ChatToolPartState;
+    title?: string;
+    providerExecuted?: boolean;
+    callProviderMetadata?: Record<string, unknown>;
+    output?: unknown;
+    errorText?: string;
+    approval?: {
+        id: string;
+    };
+};
+export type ChatDynamicToolUiPart = ChatToolPartBase & {
+    type: "dynamic-tool";
+    toolName: string;
+};
+export type ChatNamedToolUiPart = ChatToolPartBase & {
+    type: `tool-${string}` | "tool_call";
+    toolName?: string;
+};
+export type ChatDataUiPart = {
+    type: `data-${string}`;
+    data: unknown;
+};
+export type ChatUiMessagePart = ChatTextUiPart | ChatReasoningUiPart | ChatStepStartUiPart | ChatSourceUrlUiPart | ChatSourceDocumentUiPart | FileUIPartWithUpload | ChatDynamicToolUiPart | ChatNamedToolUiPart | ChatDataUiPart;
+export interface ChatUiMessage<TMessageMetadata = ChatMessageMetadata> {
+    id: string;
+    role: ChatUiMessageRole;
+    parts: ChatUiMessagePart[];
+    metadata?: TMessageMetadata;
+}
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type ChatModelTextPart = {
+    type: "text";
+    text: string;
+};
+export type ChatModelReasoningPart = {
+    type: "reasoning";
+    text: string;
+};
+export type ChatModelFilePart = {
+    type: "file" | "image";
+    mediaType: string;
+    data?: string;
+    url?: string;
+    filename?: string;
+    uploadId?: string;
+    uploadPath?: string;
+};
+export type ChatToolCallPart = {
+    type: "tool-call";
+    toolCallId: string;
+    toolName: string;
+    input: Record<string, unknown>;
+    providerExecuted?: boolean;
+};
+export type ChatToolResultOutput = {
+    type: "json";
+    value: JsonValue;
+} | {
+    type: "text";
+    value: string;
+} | {
+    type: "error-text";
+    value: string;
+};
+export type ChatToolResultPart = {
+    type: "tool-result";
+    toolCallId: string;
+    toolName: string;
+    output: ChatToolResultOutput;
+    providerOptions?: unknown;
+};
+export type ChatUserContentPart = ChatModelTextPart | ChatModelFilePart;
+export type ChatAssistantContentPart = ChatModelTextPart | ChatModelReasoningPart | ChatModelFilePart | ChatToolCallPart | ChatToolResultPart;
+export type ChatSystemMessage = {
+    role: "system";
+    content: string;
+    providerOptions?: Record<string, unknown>;
+};
+export type ChatUserMessage = {
+    role: "user";
+    content: string | ChatUserContentPart[];
+};
+export type ChatAssistantMessage = {
+    role: "assistant";
+    content: string | ChatAssistantContentPart[];
+};
+export type ChatToolMessage = {
+    role: "tool";
+    content: ChatToolResultPart[];
+};
+export type ChatModelMessage = ChatSystemMessage | ChatUserMessage | ChatAssistantMessage | ChatToolMessage;
+export interface DurableRootRunDescriptor {
+    runId: string;
+    messageId: string;
+    latestEventId?: number;
+    latestExternalEventSequence?: number;
+    parentConversationId?: string;
+    parentRunId?: string;
+    spawnedFromToolCallId?: string;
+}
+export interface ChatRuntimeOverrides {
+    allowedTools?: string[];
+    thinking?: false | number;
+    maxSteps?: number;
+}
+export interface ProjectFile {
+    path: string;
+    content: string;
+}
+export interface ProjectFileListItem {
+    id: string;
+    path: string;
+    type: string;
+    size: number;
+    updated_at: string;
+}
+export interface UploadedFileReference {
+    name: string;
+    mediaType: string;
+    uploadId?: string;
+    path?: string;
+    url?: string;
+    size?: number;
+}
+export declare const chatRequestContextSchema: z.ZodObject<{
+    conversationId: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodNullable<z.ZodString>;
+    branchId: z.ZodNullable<z.ZodString>;
+    environmentContext: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ChatRequestContext = z.infer<typeof chatRequestContextSchema>;
+export declare const messageMetadataSchema: z.ZodType<ChatMessageMetadata>;
+export declare const chatUiMessageRoleSchema: z.ZodType<ChatUiMessageRole>;
+export declare const chatToolPartStateSchema: z.ZodType<ChatToolPartState>;
+export declare const chatUiMessagePartSchema: z.ZodType<ChatUiMessagePart>;
+export declare const chatUiMessageSchema: z.ZodType<ChatUiMessage>;
+export declare const chatUiMessagesSchema: z.ZodArray<z.ZodType<ChatUiMessage<ChatMessageMetadata>, unknown, z.core.$ZodTypeInternals<ChatUiMessage<ChatMessageMetadata>, unknown>>>;
+export declare function isImageFile(type: string | undefined): boolean;
+export declare function isValidImageFile(type: string): boolean;
+export declare function isTextPreviewFile(name: string | undefined, type: string | undefined): boolean;
+export declare function normalizeInlineAttachmentMediaType(filename: string | undefined, mediaType: string | undefined): string;
+export declare function buildDataFileAnnotation(refs: UploadedFileReference[]): string;
+export type { ChatMessageMetadata, ChatMessageMetadata as MessageMetadata, ChatMessageMetadataUsage, ChatUiMessageChunk, ChildRunAudit, ChildRunAuditToolCall, ChildRunAuditToolResult, };
+//# sourceMappingURL=types.d.ts.map

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

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

package/esm/src/chat/types.js

@@ -0,0 +1,294 @@
+import { z } from "zod";
+const NATIVE_TEXT_ATTACHMENT_EXTENSIONS = [
+    ".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",
+];
+export const textFileExtensions = [...NATIVE_TEXT_ATTACHMENT_EXTENSIONS, ".csv"];
+export const imageFileTypes = [
+    "image/png",
+    "image/jpeg",
+    "image/jpg",
+    "image/gif",
+    "image/webp",
+    "image/bmp",
+    "image/tiff",
+];
+const INLINE_TEXT_MEDIA_TYPE = "text/plain";
+const INLINE_BINARY_MEDIA_TYPE = "application/octet-stream";
+const INLINE_PDF_MEDIA_TYPE = "application/pdf";
+export const chatRequestContextSchema = z
+    .object({
+    conversationId: z.string().optional(),
+    projectId: z.string().nullable(),
+    branchId: z.string().nullable(),
+    environmentContext: z.string().optional(),
+})
+    .strict();
+const childRunAuditStatusSchema = z.enum([
+    "completed",
+    "failed",
+    "cancelled",
+    "stopped",
+]);
+const childRunAuditToolCallSchema = z
+    .object({
+    toolName: z.string(),
+    toolCallId: z.string(),
+    input: z.unknown().optional(),
+})
+    .strict();
+const childRunAuditToolResultSchema = z
+    .object({
+    toolName: z.string(),
+    toolCallId: z.string(),
+    input: z.unknown(),
+    output: z.unknown(),
+})
+    .strict();
+const childRunAuditSchema = z
+    .object({
+    status: childRunAuditStatusSchema,
+    description: z.string().optional(),
+    steps: z.number().optional(),
+    durationMs: z.number().optional(),
+    toolCalls: z.array(childRunAuditToolCallSchema).optional(),
+    toolResults: z.array(childRunAuditToolResultSchema).optional(),
+    terminalErrorCode: z.string().nullable().optional(),
+    terminalErrorMessage: z.string().nullable().optional(),
+})
+    .strict();
+const messageMetadataUsageSchema = z
+    .object({
+    inputTokens: z.number().optional(),
+    outputTokens: z.number().optional(),
+    reasoningTokens: z.number().optional(),
+    cachedInputTokens: z.number().optional(),
+})
+    .strict();
+export const messageMetadataSchema = z
+    .object({
+    createdAt: z.string().optional(),
+    isStopped: z.boolean().optional(),
+    isCompleted: z.boolean().optional(),
+    completedAt: z.string().optional(),
+    agentId: z.string().optional(),
+    agentName: z.string().optional(),
+    conversationId: z.string().optional(),
+    modelId: z.string().optional(),
+    runId: z.string().optional(),
+    streamingMessageId: z.string().optional(),
+    childRunAudit: childRunAuditSchema.optional(),
+    usage: messageMetadataUsageSchema.optional(),
+})
+    .strict();
+const nonEmptyStringSchema = z.string().min(1);
+export const chatUiMessageRoleSchema = z.enum([
+    "system",
+    "user",
+    "assistant",
+]);
+export const chatToolPartStateSchema = z.enum([
+    "pending",
+    "input-streaming",
+    "input-available",
+    "approval-requested",
+    "approval-responded",
+    "output-available",
+    "output-error",
+    "output-denied",
+    "error",
+    "completed",
+]);
+const toolApprovalSchema = z
+    .object({
+    id: nonEmptyStringSchema,
+})
+    .strict();
+const toolPartBaseSchema = z
+    .object({
+    toolCallId: nonEmptyStringSchema,
+    input: z.unknown(),
+    state: chatToolPartStateSchema,
+    title: nonEmptyStringSchema.optional(),
+    providerExecuted: z.boolean().optional(),
+    callProviderMetadata: z.record(z.string(), z.unknown()).optional(),
+    output: z.unknown().optional(),
+    errorText: nonEmptyStringSchema.optional(),
+    approval: toolApprovalSchema.optional(),
+})
+    .strip();
+const chatTextUiPartSchema = z
+    .object({
+    type: z.literal("text"),
+    text: z.string(),
+})
+    .strip();
+const chatReasoningUiPartSchema = z
+    .object({
+    type: z.literal("reasoning"),
+    text: z.string(),
+})
+    .strip();
+const chatStepStartUiPartSchema = z
+    .object({
+    type: z.literal("step-start"),
+})
+    .strip();
+const chatSourceUrlUiPartSchema = z
+    .object({
+    type: z.literal("source-url"),
+    sourceId: nonEmptyStringSchema,
+    url: nonEmptyStringSchema,
+    title: z.string().optional(),
+})
+    .strip();
+const chatSourceDocumentUiPartSchema = z
+    .object({
+    type: z.literal("source-document"),
+    sourceId: nonEmptyStringSchema,
+    title: nonEmptyStringSchema,
+    mediaType: nonEmptyStringSchema.optional(),
+    filename: nonEmptyStringSchema.optional(),
+})
+    .strip();
+const chatFileUiPartBaseSchema = z
+    .object({
+    type: z.literal("file"),
+    mediaType: nonEmptyStringSchema,
+    url: nonEmptyStringSchema,
+    filename: nonEmptyStringSchema.optional(),
+})
+    .strip();
+const fileUiPartWithUploadSchema = chatFileUiPartBaseSchema.extend({
+    uploadId: nonEmptyStringSchema.optional(),
+    uploadPath: nonEmptyStringSchema.optional(),
+});
+const chatDynamicToolUiPartSchema = toolPartBaseSchema.extend({
+    type: z.literal("dynamic-tool"),
+    toolName: nonEmptyStringSchema,
+});
+const chatNamedToolTypeSchema = z.custom((value) => typeof value === "string" && (value === "tool_call" || /^tool-.+$/u.test(value)));
+const chatNamedToolUiPartSchema = toolPartBaseSchema.extend({
+    type: chatNamedToolTypeSchema,
+    toolName: nonEmptyStringSchema.optional(),
+});
+const chatDataUiPartTypeSchema = z.custom((value) => typeof value === "string" && /^data-.+$/u.test(value));
+const chatDataUiPartSchema = z
+    .object({
+    type: chatDataUiPartTypeSchema,
+    data: z.unknown(),
+})
+    .strip();
+export const chatUiMessagePartSchema = z.union([
+    chatTextUiPartSchema,
+    chatReasoningUiPartSchema,
+    chatStepStartUiPartSchema,
+    chatSourceUrlUiPartSchema,
+    chatSourceDocumentUiPartSchema,
+    fileUiPartWithUploadSchema,
+    chatDynamicToolUiPartSchema,
+    chatNamedToolUiPartSchema,
+    chatDataUiPartSchema,
+]);
+export const chatUiMessageSchema = z
+    .object({
+    id: nonEmptyStringSchema,
+    role: chatUiMessageRoleSchema,
+    parts: z.array(chatUiMessagePartSchema),
+    metadata: messageMetadataSchema.optional(),
+})
+    .strip();
+export const chatUiMessagesSchema = z.array(chatUiMessageSchema);
+function hasExtension(filename, extensions) {
+    const normalizedFilename = filename?.toLowerCase() ?? "";
+    return extensions.some((extension) => normalizedFilename.endsWith(extension));
+}
+function isNativeTextAttachmentFile(filename) {
+    return hasExtension(filename, NATIVE_TEXT_ATTACHMENT_EXTENSIONS);
+}
+function preferNativeTextAttachmentMediaType(filename, fallbackMediaType) {
+    return isNativeTextAttachmentFile(filename) ? INLINE_TEXT_MEDIA_TYPE : fallbackMediaType;
+}
+function isTextMediaType(type) {
+    return type?.startsWith("text/") ?? false;
+}
+function isInlinePreviewMediaType(mediaType) {
+    return isTextMediaType(mediaType) || isImageFile(mediaType) ||
+        mediaType === INLINE_PDF_MEDIA_TYPE;
+}
+export function isImageFile(type) {
+    return type?.startsWith("image/") ?? false;
+}
+export function isValidImageFile(type) {
+    if (type.length === 0) {
+        return false;
+    }
+    return imageFileTypes.some((imageFileType) => imageFileType === type);
+}
+export function isTextPreviewFile(name, type) {
+    return isTextMediaType(type) || hasExtension(name, textFileExtensions);
+}
+export function normalizeInlineAttachmentMediaType(filename, mediaType) {
+    if (!mediaType) {
+        return preferNativeTextAttachmentMediaType(filename, INLINE_BINARY_MEDIA_TYPE);
+    }
+    if (isInlinePreviewMediaType(mediaType)) {
+        return mediaType;
+    }
+    return preferNativeTextAttachmentMediaType(filename, mediaType);
+}
+function escapeXmlAttr(value) {
+    return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+export function buildDataFileAnnotation(refs) {
+    if (refs.length === 0)
+        return "";
+    const fileTags = refs
+        .map((ref) => {
+        const attrs = [`name="${escapeXmlAttr(ref.name)}"`];
+        if (ref.uploadId)
+            attrs.push(`upload_id="${escapeXmlAttr(ref.uploadId)}"`);
+        if (ref.path)
+            attrs.push(`path="${escapeXmlAttr(ref.path)}"`);
+        if (typeof ref.size === "number")
+            attrs.push(`size="${ref.size}"`);
+        if (ref.url)
+            attrs.push(`url="${escapeXmlAttr(ref.url)}"`);
+        attrs.push(`type="${escapeXmlAttr(ref.mediaType)}"`);
+        return `<file ${attrs.join(" ")} />`;
+    })
+        .join("\n");
+    return `\n\n<uploaded_files>\n${fileTags}\n</uploaded_files>`;
+}

package/esm/src/utils/version-constant.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.285";
+export declare const VERSION = "0.1.286";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.285";
+export const VERSION = "0.1.286";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.285",
+  "version": "0.1.286",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -57,6 +57,10 @@
       "import": "./esm/src/chat/protocol.js",
       "types": "./esm/src/chat/protocol.d.ts"
     },
+    "./chat/types": {
+      "import": "./esm/src/chat/types.js",
+      "types": "./esm/src/chat/types.d.ts"
+    },
     "./markdown": {
       "import": "./esm/src/markdown/index.js",
       "types": "./esm/src/markdown/index.d.ts"

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.285",
+  "version": "0.1.286",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [
@@ -34,6 +34,7 @@ export default {
     "./chat": "./src/chat/index.ts",
     "./chat/ag-ui": "./src/chat/ag-ui.ts",
     "./chat/protocol": "./src/chat/protocol.ts",
+    "./chat/types": "./src/chat/types.ts",
     "./markdown": "./src/markdown/index.ts",
     "./mdx": "./src/mdx/index.ts",
     "./agent": "./src/agent/index.ts",
@@ -72,6 +73,7 @@ export default {
     "veryfront/chat": "./src/chat/index.ts",
     "veryfront/chat/ag-ui": "./src/chat/ag-ui.ts",
     "veryfront/chat/protocol": "./src/chat/protocol.ts",
+    "veryfront/chat/types": "./src/chat/types.ts",
     "veryfront/markdown": "./src/markdown/index.ts",
     "veryfront/mdx": "./src/mdx/index.ts",
     "veryfront/fs": "./src/fs/index.ts",

package/src/src/chat/types.ts

@@ -0,0 +1,602 @@
+import "../../_dnt.polyfills.js";
+import type {
+  ChatMessageMetadata,
+  ChatMessageMetadataUsage,
+  ChatUiMessageChunk,
+  ChildRunAudit,
+  ChildRunAuditToolCall,
+  ChildRunAuditToolResult,
+} from "./protocol.js";
+import { z } from "zod";
+
+const NATIVE_TEXT_ATTACHMENT_EXTENSIONS = [
+  ".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",
+] as const;
+
+export const textFileExtensions = [...NATIVE_TEXT_ATTACHMENT_EXTENSIONS, ".csv"] as const;
+
+export const imageFileTypes = [
+  "image/png",
+  "image/jpeg",
+  "image/jpg",
+  "image/gif",
+  "image/webp",
+  "image/bmp",
+  "image/tiff",
+] as const;
+
+const INLINE_TEXT_MEDIA_TYPE = "text/plain";
+const INLINE_BINARY_MEDIA_TYPE = "application/octet-stream";
+const INLINE_PDF_MEDIA_TYPE = "application/pdf";
+
+export type ChatUiMessageRole = "system" | "user" | "assistant";
+
+export type ChatTextUiPart = {
+  type: "text";
+  text: string;
+};
+
+export type ChatReasoningUiPart = {
+  type: "reasoning";
+  text: string;
+};
+
+export type ChatStepStartUiPart = {
+  type: "step-start";
+};
+
+export type ChatSourceUrlUiPart = {
+  type: "source-url";
+  sourceId: string;
+  url: string;
+  title?: string;
+};
+
+export type ChatSourceDocumentUiPart = {
+  type: "source-document";
+  sourceId: string;
+  title: string;
+  mediaType?: string;
+  filename?: string;
+};
+
+export type ChatFileUiPart = {
+  type: "file";
+  mediaType: string;
+  url: string;
+  filename?: string;
+};
+
+export type FileUIPartWithUpload = ChatFileUiPart & {
+  uploadId?: string;
+  uploadPath?: string;
+};
+
+export type ChatToolPartState =
+  | "pending"
+  | "input-streaming"
+  | "input-available"
+  | "approval-requested"
+  | "approval-responded"
+  | "output-available"
+  | "output-error"
+  | "output-denied"
+  | "error"
+  | "completed";
+
+type ChatToolPartBase = {
+  toolCallId: string;
+  input: unknown;
+  state: ChatToolPartState;
+  title?: string;
+  providerExecuted?: boolean;
+  callProviderMetadata?: Record<string, unknown>;
+  output?: unknown;
+  errorText?: string;
+  approval?: {
+    id: string;
+  };
+};
+
+export type ChatDynamicToolUiPart = ChatToolPartBase & {
+  type: "dynamic-tool";
+  toolName: string;
+};
+
+export type ChatNamedToolUiPart = ChatToolPartBase & {
+  type: `tool-${string}` | "tool_call";
+  toolName?: string;
+};
+
+export type ChatDataUiPart = {
+  type: `data-${string}`;
+  data: unknown;
+};
+
+export type ChatUiMessagePart =
+  | ChatTextUiPart
+  | ChatReasoningUiPart
+  | ChatStepStartUiPart
+  | ChatSourceUrlUiPart
+  | ChatSourceDocumentUiPart
+  | FileUIPartWithUpload
+  | ChatDynamicToolUiPart
+  | ChatNamedToolUiPart
+  | ChatDataUiPart;
+
+export interface ChatUiMessage<TMessageMetadata = ChatMessageMetadata> {
+  id: string;
+  role: ChatUiMessageRole;
+  parts: ChatUiMessagePart[];
+  metadata?: TMessageMetadata;
+}
+
+type JsonValue = string | number | boolean | null | JsonValue[] | { [key: string]: JsonValue };
+
+export type ChatModelTextPart = {
+  type: "text";
+  text: string;
+};
+
+export type ChatModelReasoningPart = {
+  type: "reasoning";
+  text: string;
+};
+
+export type ChatModelFilePart = {
+  type: "file" | "image";
+  mediaType: string;
+  data?: string;
+  url?: string;
+  filename?: string;
+  uploadId?: string;
+  uploadPath?: string;
+};
+
+export type ChatToolCallPart = {
+  type: "tool-call";
+  toolCallId: string;
+  toolName: string;
+  input: Record<string, unknown>;
+  providerExecuted?: boolean;
+};
+
+export type ChatToolResultOutput =
+  | {
+    type: "json";
+    value: JsonValue;
+  }
+  | {
+    type: "text";
+    value: string;
+  }
+  | {
+    type: "error-text";
+    value: string;
+  };
+
+export type ChatToolResultPart = {
+  type: "tool-result";
+  toolCallId: string;
+  toolName: string;
+  output: ChatToolResultOutput;
+  providerOptions?: unknown;
+};
+
+export type ChatUserContentPart = ChatModelTextPart | ChatModelFilePart;
+export type ChatAssistantContentPart =
+  | ChatModelTextPart
+  | ChatModelReasoningPart
+  | ChatModelFilePart
+  | ChatToolCallPart
+  | ChatToolResultPart;
+
+export type ChatSystemMessage = {
+  role: "system";
+  content: string;
+  providerOptions?: Record<string, unknown>;
+};
+
+export type ChatUserMessage = {
+  role: "user";
+  content: string | ChatUserContentPart[];
+};
+
+export type ChatAssistantMessage = {
+  role: "assistant";
+  content: string | ChatAssistantContentPart[];
+};
+
+export type ChatToolMessage = {
+  role: "tool";
+  content: ChatToolResultPart[];
+};
+
+export type ChatModelMessage =
+  | ChatSystemMessage
+  | ChatUserMessage
+  | ChatAssistantMessage
+  | ChatToolMessage;
+
+export interface DurableRootRunDescriptor {
+  runId: string;
+  messageId: string;
+  latestEventId?: number;
+  latestExternalEventSequence?: number;
+  parentConversationId?: string;
+  parentRunId?: string;
+  spawnedFromToolCallId?: string;
+}
+
+export interface ChatRuntimeOverrides {
+  allowedTools?: string[];
+  thinking?: false | number;
+  maxSteps?: number;
+}
+
+export interface ProjectFile {
+  path: string;
+  content: string;
+}
+
+export interface ProjectFileListItem {
+  id: string;
+  path: string;
+  type: string;
+  size: number;
+  updated_at: string;
+}
+
+export interface UploadedFileReference {
+  name: string;
+  mediaType: string;
+  uploadId?: string;
+  path?: string;
+  url?: string;
+  size?: number;
+}
+
+export const chatRequestContextSchema = z
+  .object({
+    conversationId: z.string().optional(),
+    projectId: z.string().nullable(),
+    branchId: z.string().nullable(),
+    environmentContext: z.string().optional(),
+  })
+  .strict();
+
+export type ChatRequestContext = z.infer<typeof chatRequestContextSchema>;
+
+const childRunAuditStatusSchema: z.ZodType<ChildRunAudit["status"]> = z.enum([
+  "completed",
+  "failed",
+  "cancelled",
+  "stopped",
+]);
+
+const childRunAuditToolCallSchema: z.ZodType<ChildRunAuditToolCall> = z
+  .object({
+    toolName: z.string(),
+    toolCallId: z.string(),
+    input: z.unknown().optional(),
+  })
+  .strict();
+
+const childRunAuditToolResultSchema: z.ZodType<ChildRunAuditToolResult> = z
+  .object({
+    toolName: z.string(),
+    toolCallId: z.string(),
+    input: z.unknown(),
+    output: z.unknown(),
+  })
+  .strict();
+
+const childRunAuditSchema: z.ZodType<ChildRunAudit> = z
+  .object({
+    status: childRunAuditStatusSchema,
+    description: z.string().optional(),
+    steps: z.number().optional(),
+    durationMs: z.number().optional(),
+    toolCalls: z.array(childRunAuditToolCallSchema).optional(),
+    toolResults: z.array(childRunAuditToolResultSchema).optional(),
+    terminalErrorCode: z.string().nullable().optional(),
+    terminalErrorMessage: z.string().nullable().optional(),
+  })
+  .strict();
+
+const messageMetadataUsageSchema: z.ZodType<ChatMessageMetadataUsage> = z
+  .object({
+    inputTokens: z.number().optional(),
+    outputTokens: z.number().optional(),
+    reasoningTokens: z.number().optional(),
+    cachedInputTokens: z.number().optional(),
+  })
+  .strict();
+
+export const messageMetadataSchema: z.ZodType<ChatMessageMetadata> = z
+  .object({
+    createdAt: z.string().optional(),
+    isStopped: z.boolean().optional(),
+    isCompleted: z.boolean().optional(),
+    completedAt: z.string().optional(),
+    agentId: z.string().optional(),
+    agentName: z.string().optional(),
+    conversationId: z.string().optional(),
+    modelId: z.string().optional(),
+    runId: z.string().optional(),
+    streamingMessageId: z.string().optional(),
+    childRunAudit: childRunAuditSchema.optional(),
+    usage: messageMetadataUsageSchema.optional(),
+  })
+  .strict();
+
+const nonEmptyStringSchema = z.string().min(1);
+
+export const chatUiMessageRoleSchema: z.ZodType<ChatUiMessageRole> = z.enum([
+  "system",
+  "user",
+  "assistant",
+]);
+
+export const chatToolPartStateSchema: z.ZodType<ChatToolPartState> = z.enum([
+  "pending",
+  "input-streaming",
+  "input-available",
+  "approval-requested",
+  "approval-responded",
+  "output-available",
+  "output-error",
+  "output-denied",
+  "error",
+  "completed",
+]);
+
+const toolApprovalSchema = z
+  .object({
+    id: nonEmptyStringSchema,
+  })
+  .strict();
+
+const toolPartBaseSchema = z
+  .object({
+    toolCallId: nonEmptyStringSchema,
+    input: z.unknown(),
+    state: chatToolPartStateSchema,
+    title: nonEmptyStringSchema.optional(),
+    providerExecuted: z.boolean().optional(),
+    callProviderMetadata: z.record(z.string(), z.unknown()).optional(),
+    output: z.unknown().optional(),
+    errorText: nonEmptyStringSchema.optional(),
+    approval: toolApprovalSchema.optional(),
+  })
+  .strip();
+
+const chatTextUiPartSchema: z.ZodType<ChatTextUiPart> = z
+  .object({
+    type: z.literal("text"),
+    text: z.string(),
+  })
+  .strip();
+
+const chatReasoningUiPartSchema: z.ZodType<ChatReasoningUiPart> = z
+  .object({
+    type: z.literal("reasoning"),
+    text: z.string(),
+  })
+  .strip();
+
+const chatStepStartUiPartSchema: z.ZodType<ChatStepStartUiPart> = z
+  .object({
+    type: z.literal("step-start"),
+  })
+  .strip();
+
+const chatSourceUrlUiPartSchema: z.ZodType<ChatSourceUrlUiPart> = z
+  .object({
+    type: z.literal("source-url"),
+    sourceId: nonEmptyStringSchema,
+    url: nonEmptyStringSchema,
+    title: z.string().optional(),
+  })
+  .strip();
+
+const chatSourceDocumentUiPartSchema: z.ZodType<ChatSourceDocumentUiPart> = z
+  .object({
+    type: z.literal("source-document"),
+    sourceId: nonEmptyStringSchema,
+    title: nonEmptyStringSchema,
+    mediaType: nonEmptyStringSchema.optional(),
+    filename: nonEmptyStringSchema.optional(),
+  })
+  .strip();
+
+const chatFileUiPartBaseSchema = z
+  .object({
+    type: z.literal("file"),
+    mediaType: nonEmptyStringSchema,
+    url: nonEmptyStringSchema,
+    filename: nonEmptyStringSchema.optional(),
+  })
+  .strip();
+
+const fileUiPartWithUploadSchema: z.ZodType<FileUIPartWithUpload> = chatFileUiPartBaseSchema.extend(
+  {
+    uploadId: nonEmptyStringSchema.optional(),
+    uploadPath: nonEmptyStringSchema.optional(),
+  },
+);
+
+const chatDynamicToolUiPartSchema: z.ZodType<ChatDynamicToolUiPart> = toolPartBaseSchema.extend({
+  type: z.literal("dynamic-tool"),
+  toolName: nonEmptyStringSchema,
+});
+
+const chatNamedToolTypeSchema: z.ZodType<ChatNamedToolUiPart["type"]> = z.custom<
+  ChatNamedToolUiPart["type"]
+>((value) => typeof value === "string" && (value === "tool_call" || /^tool-.+$/u.test(value)));
+
+const chatNamedToolUiPartSchema: z.ZodType<ChatNamedToolUiPart> = toolPartBaseSchema.extend({
+  type: chatNamedToolTypeSchema,
+  toolName: nonEmptyStringSchema.optional(),
+});
+
+const chatDataUiPartTypeSchema: z.ZodType<ChatDataUiPart["type"]> = z.custom<
+  ChatDataUiPart["type"]
+>((value) => typeof value === "string" && /^data-.+$/u.test(value));
+
+const chatDataUiPartSchema: z.ZodType<ChatDataUiPart> = z
+  .object({
+    type: chatDataUiPartTypeSchema,
+    data: z.unknown(),
+  })
+  .strip();
+
+export const chatUiMessagePartSchema: z.ZodType<ChatUiMessagePart> = z.union([
+  chatTextUiPartSchema,
+  chatReasoningUiPartSchema,
+  chatStepStartUiPartSchema,
+  chatSourceUrlUiPartSchema,
+  chatSourceDocumentUiPartSchema,
+  fileUiPartWithUploadSchema,
+  chatDynamicToolUiPartSchema,
+  chatNamedToolUiPartSchema,
+  chatDataUiPartSchema,
+]);
+
+export const chatUiMessageSchema: z.ZodType<ChatUiMessage> = z
+  .object({
+    id: nonEmptyStringSchema,
+    role: chatUiMessageRoleSchema,
+    parts: z.array(chatUiMessagePartSchema),
+    metadata: messageMetadataSchema.optional(),
+  })
+  .strip();
+
+export const chatUiMessagesSchema = z.array(chatUiMessageSchema);
+
+function hasExtension(filename: string | undefined, extensions: readonly string[]) {
+  const normalizedFilename = filename?.toLowerCase() ?? "";
+  return extensions.some((extension) => normalizedFilename.endsWith(extension));
+}
+
+function isNativeTextAttachmentFile(filename: string | undefined) {
+  return hasExtension(filename, NATIVE_TEXT_ATTACHMENT_EXTENSIONS);
+}
+
+function preferNativeTextAttachmentMediaType(
+  filename: string | undefined,
+  fallbackMediaType: string,
+) {
+  return isNativeTextAttachmentFile(filename) ? INLINE_TEXT_MEDIA_TYPE : fallbackMediaType;
+}
+
+function isTextMediaType(type: string | undefined) {
+  return type?.startsWith("text/") ?? false;
+}
+
+function isInlinePreviewMediaType(mediaType: string) {
+  return isTextMediaType(mediaType) || isImageFile(mediaType) ||
+    mediaType === INLINE_PDF_MEDIA_TYPE;
+}
+
+export function isImageFile(type: string | undefined) {
+  return type?.startsWith("image/") ?? false;
+}
+
+export function isValidImageFile(type: string) {
+  if (type.length === 0) {
+    return false;
+  }
+
+  return imageFileTypes.some((imageFileType) => imageFileType === type);
+}
+
+export function isTextPreviewFile(name: string | undefined, type: string | undefined) {
+  return isTextMediaType(type) || hasExtension(name, textFileExtensions);
+}
+
+export function normalizeInlineAttachmentMediaType(
+  filename: string | undefined,
+  mediaType: string | undefined,
+) {
+  if (!mediaType) {
+    return preferNativeTextAttachmentMediaType(filename, INLINE_BINARY_MEDIA_TYPE);
+  }
+
+  if (isInlinePreviewMediaType(mediaType)) {
+    return mediaType;
+  }
+
+  return preferNativeTextAttachmentMediaType(filename, mediaType);
+}
+
+function escapeXmlAttr(value: string): string {
+  return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(
+    />/g,
+    "&gt;",
+  );
+}
+
+export function buildDataFileAnnotation(refs: UploadedFileReference[]): string {
+  if (refs.length === 0) return "";
+
+  const fileTags = refs
+    .map((ref) => {
+      const attrs = [`name="${escapeXmlAttr(ref.name)}"`];
+
+      if (ref.uploadId) attrs.push(`upload_id="${escapeXmlAttr(ref.uploadId)}"`);
+      if (ref.path) attrs.push(`path="${escapeXmlAttr(ref.path)}"`);
+      if (typeof ref.size === "number") attrs.push(`size="${ref.size}"`);
+      if (ref.url) attrs.push(`url="${escapeXmlAttr(ref.url)}"`);
+
+      attrs.push(`type="${escapeXmlAttr(ref.mediaType)}"`);
+
+      return `<file ${attrs.join(" ")} />`;
+    })
+    .join("\n");
+
+  return `\n\n<uploaded_files>\n${fileTags}\n</uploaded_files>`;
+}
+
+export type {
+  ChatMessageMetadata,
+  ChatMessageMetadata as MessageMetadata,
+  ChatMessageMetadataUsage,
+  ChatUiMessageChunk,
+  ChildRunAudit,
+  ChildRunAuditToolCall,
+  ChildRunAuditToolResult,
+};

package/src/src/utils/version-constant.ts

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.285";
+export const VERSION = "0.1.286";