@copilotkit/shared 0.0.0-main-20260406172622 → 0.0.0-main-20260407183406

package/CHANGELOG.md

@@ -1,10 +1,11 @@
 # @copilotkit/shared
 
-## 0.0.0-main-20260406172622
+## 0.0.0-main-20260407183406
 
 ### Minor Changes
 
 - 1ceb963: refactor: consolidate V1/V2 packages into flat @copilotkit/\* structure
+- 5289791: feat: add multimodal attachment support to the builtin agent
 
 ### Patch Changes
 

package/dist/attachments/types.d.cts

@@ -0,0 +1,54 @@
+import { InputContentDataSource, InputContentUrlSource } from "@ag-ui/core";
+
+//#region src/attachments/types.d.ts
+interface AttachmentUploadDataResult {
+  type: "data";
+  value: string;
+  mimeType: string;
+  /** Custom metadata to include in the InputContent part (merged with auto-generated metadata like filename). */
+  metadata?: Record<string, unknown>;
+}
+interface AttachmentUploadUrlResult {
+  type: "url";
+  value: string;
+  mimeType?: string;
+  /** Custom metadata to include in the InputContent part (merged with auto-generated metadata like filename). */
+  metadata?: Record<string, unknown>;
+}
+type AttachmentUploadResult = AttachmentUploadDataResult | AttachmentUploadUrlResult;
+type AttachmentUploadErrorReason = "file-too-large" | "invalid-type" | "upload-failed";
+interface AttachmentUploadError {
+  /** Why the upload failed. */
+  reason: AttachmentUploadErrorReason;
+  /** The file that failed to upload. */
+  file: File;
+  /** Human-readable error message. */
+  message: string;
+}
+interface AttachmentsConfig {
+  /** Enable file attachments in the chat input */
+  enabled: boolean;
+  /** MIME type filter for the file input, default all files */
+  accept?: string;
+  /** Maximum file size in bytes, default 20MB (20 * 1024 * 1024) */
+  maxSize?: number;
+  /** Custom upload handler. Return an InputContentSource with optional metadata. */
+  onUpload?: (file: File) => AttachmentUploadResult | Promise<AttachmentUploadResult>;
+  /** Called when an attachment fails validation or upload. Use this to show a toast or inline error. */
+  onUploadFailed?: (error: AttachmentUploadError) => void;
+}
+type AttachmentModality = "image" | "audio" | "video" | "document";
+interface Attachment {
+  id: string;
+  type: AttachmentModality;
+  source: InputContentDataSource | InputContentUrlSource;
+  filename?: string;
+  size?: number;
+  status: "uploading" | "ready";
+  thumbnail?: string;
+  /** Custom metadata from onUpload, included in the InputContent part. */
+  metadata?: Record<string, unknown>;
+}
+//#endregion
+export { Attachment, AttachmentModality, AttachmentUploadError, AttachmentUploadErrorReason, AttachmentUploadResult, AttachmentsConfig };
+//# sourceMappingURL=types.d.cts.map

package/dist/attachments/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/attachments/types.ts"],"mappings":";;;UAKiB,0BAAA;EACf,IAAA;EACA,KAAA;EACA,QAAA;;EAEA,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,yBAAA;EACf,IAAA;EACA,KAAA;EACA,QAAA;EANiB;EAQjB,QAAA,GAAW,MAAA;AAAA;AAAA,KAGD,sBAAA,GACR,0BAAA,GACA,yBAAA;AAAA,KAEQ,2BAAA;AAAA,UAKK,qBAAA;EAhBf;EAkBA,MAAA,EAAQ,2BAAA;EAhBR;EAkBA,IAAA,EAAM,IAAA;EAhBK;EAkBX,OAAA;AAAA;AAAA,UAGe,iBAAA;EAlBiB;EAoBhC,OAAA;EAnBE;EAqBF,MAAA;EAlBU;EAoBV,OAAA;;EAEA,QAAA,IACE,IAAA,EAAM,IAAA,KACH,sBAAA,GAAyB,OAAA,CAAQ,sBAAA;EAxBD;EA0BrC,cAAA,IAAkB,KAAA,EAAO,qBAAA;AAAA;AAAA,KAGf,kBAAA;AAAA,UAEK,UAAA;EACf,EAAA;EACA,IAAA,EAAM,kBAAA;EACN,MAAA,EAAQ,sBAAA,GAAyB,qBAAA;EACjC,QAAA;EACA,IAAA;EACA,MAAA;EACA,SAAA;EAxBe;EA0Bf,QAAA,GAAW,MAAA;AAAA"}

package/dist/attachments/types.d.mts

@@ -0,0 +1,54 @@
+import { InputContentDataSource, InputContentUrlSource } from "@ag-ui/core";
+
+//#region src/attachments/types.d.ts
+interface AttachmentUploadDataResult {
+  type: "data";
+  value: string;
+  mimeType: string;
+  /** Custom metadata to include in the InputContent part (merged with auto-generated metadata like filename). */
+  metadata?: Record<string, unknown>;
+}
+interface AttachmentUploadUrlResult {
+  type: "url";
+  value: string;
+  mimeType?: string;
+  /** Custom metadata to include in the InputContent part (merged with auto-generated metadata like filename). */
+  metadata?: Record<string, unknown>;
+}
+type AttachmentUploadResult = AttachmentUploadDataResult | AttachmentUploadUrlResult;
+type AttachmentUploadErrorReason = "file-too-large" | "invalid-type" | "upload-failed";
+interface AttachmentUploadError {
+  /** Why the upload failed. */
+  reason: AttachmentUploadErrorReason;
+  /** The file that failed to upload. */
+  file: File;
+  /** Human-readable error message. */
+  message: string;
+}
+interface AttachmentsConfig {
+  /** Enable file attachments in the chat input */
+  enabled: boolean;
+  /** MIME type filter for the file input, default all files */
+  accept?: string;
+  /** Maximum file size in bytes, default 20MB (20 * 1024 * 1024) */
+  maxSize?: number;
+  /** Custom upload handler. Return an InputContentSource with optional metadata. */
+  onUpload?: (file: File) => AttachmentUploadResult | Promise<AttachmentUploadResult>;
+  /** Called when an attachment fails validation or upload. Use this to show a toast or inline error. */
+  onUploadFailed?: (error: AttachmentUploadError) => void;
+}
+type AttachmentModality = "image" | "audio" | "video" | "document";
+interface Attachment {
+  id: string;
+  type: AttachmentModality;
+  source: InputContentDataSource | InputContentUrlSource;
+  filename?: string;
+  size?: number;
+  status: "uploading" | "ready";
+  thumbnail?: string;
+  /** Custom metadata from onUpload, included in the InputContent part. */
+  metadata?: Record<string, unknown>;
+}
+//#endregion
+export { Attachment, AttachmentModality, AttachmentUploadError, AttachmentUploadErrorReason, AttachmentUploadResult, AttachmentsConfig };
+//# sourceMappingURL=types.d.mts.map

package/dist/attachments/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/attachments/types.ts"],"mappings":";;;UAKiB,0BAAA;EACf,IAAA;EACA,KAAA;EACA,QAAA;;EAEA,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,yBAAA;EACf,IAAA;EACA,KAAA;EACA,QAAA;EANiB;EAQjB,QAAA,GAAW,MAAA;AAAA;AAAA,KAGD,sBAAA,GACR,0BAAA,GACA,yBAAA;AAAA,KAEQ,2BAAA;AAAA,UAKK,qBAAA;EAhBf;EAkBA,MAAA,EAAQ,2BAAA;EAhBR;EAkBA,IAAA,EAAM,IAAA;EAhBK;EAkBX,OAAA;AAAA;AAAA,UAGe,iBAAA;EAlBiB;EAoBhC,OAAA;EAnBE;EAqBF,MAAA;EAlBU;EAoBV,OAAA;;EAEA,QAAA,IACE,IAAA,EAAM,IAAA,KACH,sBAAA,GAAyB,OAAA,CAAQ,sBAAA;EAxBD;EA0BrC,cAAA,IAAkB,KAAA,EAAO,qBAAA;AAAA;AAAA,KAGf,kBAAA;AAAA,UAEK,UAAA;EACf,EAAA;EACA,IAAA,EAAM,kBAAA;EACN,MAAA,EAAQ,sBAAA,GAAyB,qBAAA;EACjC,QAAA;EACA,IAAA;EACA,MAAA;EACA,SAAA;EAxBe;EA0Bf,QAAA,GAAW,MAAA;AAAA"}

package/dist/attachments/utils.cjs

@@ -0,0 +1,134 @@
+
+//#region src/attachments/utils.ts
+const DEFAULT_MAX_SIZE = 20 * 1024 * 1024;
+/**
+* Derive the attachment modality from a MIME type string.
+*/
+function getModalityFromMimeType(mimeType) {
+	if (mimeType.startsWith("image/")) return "image";
+	if (mimeType.startsWith("audio/")) return "audio";
+	if (mimeType.startsWith("video/")) return "video";
+	return "document";
+}
+/**
+* Format a byte count as a human-readable file size string.
+*/
+function formatFileSize(bytes) {
+	if (bytes < 1024) return `${bytes} B`;
+	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+	return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+/**
+* Check if a file exceeds the maximum allowed size.
+*/
+function exceedsMaxSize(file, maxSize = DEFAULT_MAX_SIZE) {
+	return file.size > maxSize;
+}
+/**
+* Read a File as a base64 string (without the data URL prefix).
+*/
+function readFileAsBase64(file) {
+	return new Promise((resolve, reject) => {
+		const reader = new FileReader();
+		reader.onload = (e) => {
+			const base64 = (e.target?.result)?.split(",")[1];
+			if (base64) resolve(base64);
+			else reject(/* @__PURE__ */ new Error("Failed to read file as base64"));
+		};
+		reader.onerror = reject;
+		reader.readAsDataURL(file);
+	});
+}
+/**
+* Generate a thumbnail data URL from a video file by capturing a frame near the start (at 0.1s).
+* Returns undefined if thumbnail generation fails or if called outside a browser environment.
+*/
+function generateVideoThumbnail(file) {
+	if (typeof document === "undefined") return Promise.resolve(void 0);
+	return new Promise((resolve) => {
+		let resolved = false;
+		const video = document.createElement("video");
+		const canvas = document.createElement("canvas");
+		const url = URL.createObjectURL(file);
+		const cleanup = (result) => {
+			if (resolved) return;
+			resolved = true;
+			URL.revokeObjectURL(url);
+			resolve(result);
+		};
+		const timeout = setTimeout(() => {
+			console.warn(`[CopilotKit] generateVideoThumbnail: timed out for file "${file.name}"`);
+			cleanup(void 0);
+		}, 1e4);
+		video.preload = "metadata";
+		video.muted = true;
+		video.playsInline = true;
+		video.onloadeddata = () => {
+			video.currentTime = .1;
+		};
+		video.onseeked = () => {
+			clearTimeout(timeout);
+			canvas.width = video.videoWidth;
+			canvas.height = video.videoHeight;
+			const ctx = canvas.getContext("2d");
+			if (ctx) {
+				ctx.drawImage(video, 0, 0);
+				cleanup(canvas.toDataURL("image/jpeg", .7));
+			} else {
+				console.warn("[CopilotKit] generateVideoThumbnail: could not get 2d canvas context");
+				cleanup(void 0);
+			}
+		};
+		video.onerror = () => {
+			clearTimeout(timeout);
+			console.warn(`[CopilotKit] generateVideoThumbnail: video element error for file "${file.name}"`);
+			cleanup(void 0);
+		};
+		video.src = url;
+	});
+}
+/**
+* Check if a file's MIME type matches an accept filter string.
+* Handles file extensions (e.g. ".pdf"), MIME wildcards ("image/*"), and comma-separated lists.
+*/
+function matchesAcceptFilter(file, accept) {
+	if (!accept || accept === "*/*") return true;
+	return accept.split(",").map((f) => f.trim()).some((filter) => {
+		if (filter.startsWith(".")) return (file.name ?? "").toLowerCase().endsWith(filter.toLowerCase());
+		if (filter.endsWith("/*")) {
+			const prefix = filter.slice(0, -2);
+			return file.type.startsWith(prefix + "/");
+		}
+		return file.type === filter;
+	});
+}
+/**
+* Convert an InputContentSource to a usable URL string.
+* For data sources, returns a base64 data URL; for URL sources, returns the URL directly.
+*/
+function getSourceUrl(source) {
+	if (source.type === "url") return source.value;
+	return `data:${source.mimeType};base64,${source.value}`;
+}
+/**
+* Return a short human-readable label for a document MIME type (e.g. "PDF", "DOC").
+*/
+function getDocumentIcon(mimeType) {
+	if (mimeType.includes("pdf")) return "PDF";
+	if (mimeType.includes("sheet") || mimeType.includes("excel")) return "XLS";
+	if (mimeType.includes("presentation") || mimeType.includes("powerpoint")) return "PPT";
+	if (mimeType.includes("word") || mimeType.includes("document")) return "DOC";
+	if (mimeType.includes("text/")) return "TXT";
+	return "FILE";
+}
+
+//#endregion
+exports.exceedsMaxSize = exceedsMaxSize;
+exports.formatFileSize = formatFileSize;
+exports.generateVideoThumbnail = generateVideoThumbnail;
+exports.getDocumentIcon = getDocumentIcon;
+exports.getModalityFromMimeType = getModalityFromMimeType;
+exports.getSourceUrl = getSourceUrl;
+exports.matchesAcceptFilter = matchesAcceptFilter;
+exports.readFileAsBase64 = readFileAsBase64;
+//# sourceMappingURL=utils.cjs.map

package/dist/attachments/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","names":[],"sources":["../../src/attachments/utils.ts"],"sourcesContent":["import type { AttachmentModality } from \"./types\";\nimport type { InputContentSource } from \"../types/message\";\n\nconst DEFAULT_MAX_SIZE = 20 * 1024 * 1024; // 20MB\n\n/**\n * Derive the attachment modality from a MIME type string.\n */\nexport function getModalityFromMimeType(mimeType: string): AttachmentModality {\n  if (mimeType.startsWith(\"image/\")) return \"image\";\n  if (mimeType.startsWith(\"audio/\")) return \"audio\";\n  if (mimeType.startsWith(\"video/\")) return \"video\";\n  return \"document\";\n}\n\n/**\n * Format a byte count as a human-readable file size string.\n */\nexport function formatFileSize(bytes: number): string {\n  if (bytes < 1024) return `${bytes} B`;\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;\n  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;\n}\n\n/**\n * Check if a file exceeds the maximum allowed size.\n */\nexport function exceedsMaxSize(\n  file: File,\n  maxSize: number = DEFAULT_MAX_SIZE,\n): boolean {\n  return file.size > maxSize;\n}\n\n/**\n * Read a File as a base64 string (without the data URL prefix).\n */\nexport function readFileAsBase64(file: File): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const reader = new FileReader();\n    reader.onload = (e) => {\n      const result = e.target?.result as string;\n      const base64 = result?.split(\",\")[1];\n      if (base64) {\n        resolve(base64);\n      } else {\n        reject(new Error(\"Failed to read file as base64\"));\n      }\n    };\n    reader.onerror = reject;\n    reader.readAsDataURL(file);\n  });\n}\n\n/**\n * Generate a thumbnail data URL from a video file by capturing a frame near the start (at 0.1s).\n * Returns undefined if thumbnail generation fails or if called outside a browser environment.\n */\nexport function generateVideoThumbnail(\n  file: File,\n): Promise<string | undefined> {\n  if (typeof document === \"undefined\") {\n    return Promise.resolve(undefined);\n  }\n  return new Promise((resolve) => {\n    let resolved = false;\n    const video = document.createElement(\"video\");\n    const canvas = document.createElement(\"canvas\");\n    const url = URL.createObjectURL(file);\n\n    const cleanup = (result: string | undefined) => {\n      if (resolved) return;\n      resolved = true;\n      URL.revokeObjectURL(url);\n      resolve(result);\n    };\n\n    const timeout = setTimeout(() => {\n      console.warn(\n        `[CopilotKit] generateVideoThumbnail: timed out for file \"${file.name}\"`,\n      );\n      cleanup(undefined);\n    }, 10000);\n\n    video.preload = \"metadata\";\n    video.muted = true;\n    video.playsInline = true;\n\n    video.onloadeddata = () => {\n      video.currentTime = 0.1;\n    };\n\n    video.onseeked = () => {\n      clearTimeout(timeout);\n      canvas.width = video.videoWidth;\n      canvas.height = video.videoHeight;\n      const ctx = canvas.getContext(\"2d\");\n      if (ctx) {\n        ctx.drawImage(video, 0, 0);\n        const thumbnail = canvas.toDataURL(\"image/jpeg\", 0.7);\n        cleanup(thumbnail);\n      } else {\n        console.warn(\n          \"[CopilotKit] generateVideoThumbnail: could not get 2d canvas context\",\n        );\n        cleanup(undefined);\n      }\n    };\n\n    video.onerror = () => {\n      clearTimeout(timeout);\n      console.warn(\n        `[CopilotKit] generateVideoThumbnail: video element error for file \"${file.name}\"`,\n      );\n      cleanup(undefined);\n    };\n\n    video.src = url;\n  });\n}\n\n/**\n * Check if a file's MIME type matches an accept filter string.\n * Handles file extensions (e.g. \".pdf\"), MIME wildcards (\"image/*\"), and comma-separated lists.\n */\nexport function matchesAcceptFilter(file: File, accept: string): boolean {\n  if (!accept || accept === \"*/*\") return true;\n\n  const filters = accept.split(\",\").map((f) => f.trim());\n  return filters.some((filter) => {\n    if (filter.startsWith(\".\")) {\n      return (file.name ?? \"\").toLowerCase().endsWith(filter.toLowerCase());\n    }\n    if (filter.endsWith(\"/*\")) {\n      const prefix = filter.slice(0, -2);\n      return file.type.startsWith(prefix + \"/\");\n    }\n    return file.type === filter;\n  });\n}\n\n/**\n * Convert an InputContentSource to a usable URL string.\n * For data sources, returns a base64 data URL; for URL sources, returns the URL directly.\n */\nexport function getSourceUrl(source: InputContentSource): string {\n  if (source.type === \"url\") {\n    return source.value;\n  }\n  return `data:${source.mimeType};base64,${source.value}`;\n}\n\n/**\n * Return a short human-readable label for a document MIME type (e.g. \"PDF\", \"DOC\").\n */\nexport function getDocumentIcon(mimeType: string): string {\n  if (mimeType.includes(\"pdf\")) return \"PDF\";\n  if (mimeType.includes(\"sheet\") || mimeType.includes(\"excel\")) return \"XLS\";\n  if (mimeType.includes(\"presentation\") || mimeType.includes(\"powerpoint\"))\n    return \"PPT\";\n  if (mimeType.includes(\"word\") || mimeType.includes(\"document\")) return \"DOC\";\n  if (mimeType.includes(\"text/\")) return \"TXT\";\n  return \"FILE\";\n}\n"],"mappings":"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"}

package/dist/attachments/utils.d.cts

@@ -0,0 +1,42 @@
+import { InputContentSource } from "../types/message.cjs";
+import { AttachmentModality } from "./types.cjs";
+
+//#region src/attachments/utils.d.ts
+/**
+ * Derive the attachment modality from a MIME type string.
+ */
+declare function getModalityFromMimeType(mimeType: string): AttachmentModality;
+/**
+ * Format a byte count as a human-readable file size string.
+ */
+declare function formatFileSize(bytes: number): string;
+/**
+ * Check if a file exceeds the maximum allowed size.
+ */
+declare function exceedsMaxSize(file: File, maxSize?: number): boolean;
+/**
+ * Read a File as a base64 string (without the data URL prefix).
+ */
+declare function readFileAsBase64(file: File): Promise<string>;
+/**
+ * Generate a thumbnail data URL from a video file by capturing a frame near the start (at 0.1s).
+ * Returns undefined if thumbnail generation fails or if called outside a browser environment.
+ */
+declare function generateVideoThumbnail(file: File): Promise<string | undefined>;
+/**
+ * Check if a file's MIME type matches an accept filter string.
+ * Handles file extensions (e.g. ".pdf"), MIME wildcards ("image/*"), and comma-separated lists.
+ */
+declare function matchesAcceptFilter(file: File, accept: string): boolean;
+/**
+ * Convert an InputContentSource to a usable URL string.
+ * For data sources, returns a base64 data URL; for URL sources, returns the URL directly.
+ */
+declare function getSourceUrl(source: InputContentSource): string;
+/**
+ * Return a short human-readable label for a document MIME type (e.g. "PDF", "DOC").
+ */
+declare function getDocumentIcon(mimeType: string): string;
+//#endregion
+export { exceedsMaxSize, formatFileSize, generateVideoThumbnail, getDocumentIcon, getModalityFromMimeType, getSourceUrl, matchesAcceptFilter, readFileAsBase64 };
+//# sourceMappingURL=utils.d.cts.map

package/dist/attachments/utils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.cts","names":[],"sources":["../../src/attachments/utils.ts"],"mappings":";;;;;;AAQA;iBAAgB,uBAAA,CAAwB,QAAA,WAAmB,kBAAA;;;;iBAU3C,cAAA,CAAe,KAAA;;;;iBASf,cAAA,CACd,IAAA,EAAM,IAAA,EACN,OAAA;AAFF;;;AAAA,iBAUgB,gBAAA,CAAiB,IAAA,EAAM,IAAA,GAAO,OAAA;;;;;iBAqB9B,sBAAA,CACd,IAAA,EAAM,IAAA,GACL,OAAA;AAvBH;;;;AAAA,iBAwFgB,mBAAA,CAAoB,IAAA,EAAM,IAAA,EAAM,MAAA;;;;;iBAoBhC,YAAA,CAAa,MAAA,EAAQ,kBAAA;;;;iBAUrB,eAAA,CAAgB,QAAA"}

package/dist/attachments/utils.d.mts

@@ -0,0 +1,42 @@
+import { InputContentSource } from "../types/message.mjs";
+import { AttachmentModality } from "./types.mjs";
+
+//#region src/attachments/utils.d.ts
+/**
+ * Derive the attachment modality from a MIME type string.
+ */
+declare function getModalityFromMimeType(mimeType: string): AttachmentModality;
+/**
+ * Format a byte count as a human-readable file size string.
+ */
+declare function formatFileSize(bytes: number): string;
+/**
+ * Check if a file exceeds the maximum allowed size.
+ */
+declare function exceedsMaxSize(file: File, maxSize?: number): boolean;
+/**
+ * Read a File as a base64 string (without the data URL prefix).
+ */
+declare function readFileAsBase64(file: File): Promise<string>;
+/**
+ * Generate a thumbnail data URL from a video file by capturing a frame near the start (at 0.1s).
+ * Returns undefined if thumbnail generation fails or if called outside a browser environment.
+ */
+declare function generateVideoThumbnail(file: File): Promise<string | undefined>;
+/**
+ * Check if a file's MIME type matches an accept filter string.
+ * Handles file extensions (e.g. ".pdf"), MIME wildcards ("image/*"), and comma-separated lists.
+ */
+declare function matchesAcceptFilter(file: File, accept: string): boolean;
+/**
+ * Convert an InputContentSource to a usable URL string.
+ * For data sources, returns a base64 data URL; for URL sources, returns the URL directly.
+ */
+declare function getSourceUrl(source: InputContentSource): string;
+/**
+ * Return a short human-readable label for a document MIME type (e.g. "PDF", "DOC").
+ */
+declare function getDocumentIcon(mimeType: string): string;
+//#endregion
+export { exceedsMaxSize, formatFileSize, generateVideoThumbnail, getDocumentIcon, getModalityFromMimeType, getSourceUrl, matchesAcceptFilter, readFileAsBase64 };
+//# sourceMappingURL=utils.d.mts.map

package/dist/attachments/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../../src/attachments/utils.ts"],"mappings":";;;;;;AAQA;iBAAgB,uBAAA,CAAwB,QAAA,WAAmB,kBAAA;;;;iBAU3C,cAAA,CAAe,KAAA;;;;iBASf,cAAA,CACd,IAAA,EAAM,IAAA,EACN,OAAA;AAFF;;;AAAA,iBAUgB,gBAAA,CAAiB,IAAA,EAAM,IAAA,GAAO,OAAA;;;;;iBAqB9B,sBAAA,CACd,IAAA,EAAM,IAAA,GACL,OAAA;AAvBH;;;;AAAA,iBAwFgB,mBAAA,CAAoB,IAAA,EAAM,IAAA,EAAM,MAAA;;;;;iBAoBhC,YAAA,CAAa,MAAA,EAAQ,kBAAA;;;;iBAUrB,eAAA,CAAgB,QAAA"}

package/dist/attachments/utils.mjs

@@ -0,0 +1,126 @@
+//#region src/attachments/utils.ts
+const DEFAULT_MAX_SIZE = 20 * 1024 * 1024;
+/**
+* Derive the attachment modality from a MIME type string.
+*/
+function getModalityFromMimeType(mimeType) {
+	if (mimeType.startsWith("image/")) return "image";
+	if (mimeType.startsWith("audio/")) return "audio";
+	if (mimeType.startsWith("video/")) return "video";
+	return "document";
+}
+/**
+* Format a byte count as a human-readable file size string.
+*/
+function formatFileSize(bytes) {
+	if (bytes < 1024) return `${bytes} B`;
+	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+	return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+/**
+* Check if a file exceeds the maximum allowed size.
+*/
+function exceedsMaxSize(file, maxSize = DEFAULT_MAX_SIZE) {
+	return file.size > maxSize;
+}
+/**
+* Read a File as a base64 string (without the data URL prefix).
+*/
+function readFileAsBase64(file) {
+	return new Promise((resolve, reject) => {
+		const reader = new FileReader();
+		reader.onload = (e) => {
+			const base64 = (e.target?.result)?.split(",")[1];
+			if (base64) resolve(base64);
+			else reject(/* @__PURE__ */ new Error("Failed to read file as base64"));
+		};
+		reader.onerror = reject;
+		reader.readAsDataURL(file);
+	});
+}
+/**
+* Generate a thumbnail data URL from a video file by capturing a frame near the start (at 0.1s).
+* Returns undefined if thumbnail generation fails or if called outside a browser environment.
+*/
+function generateVideoThumbnail(file) {
+	if (typeof document === "undefined") return Promise.resolve(void 0);
+	return new Promise((resolve) => {
+		let resolved = false;
+		const video = document.createElement("video");
+		const canvas = document.createElement("canvas");
+		const url = URL.createObjectURL(file);
+		const cleanup = (result) => {
+			if (resolved) return;
+			resolved = true;
+			URL.revokeObjectURL(url);
+			resolve(result);
+		};
+		const timeout = setTimeout(() => {
+			console.warn(`[CopilotKit] generateVideoThumbnail: timed out for file "${file.name}"`);
+			cleanup(void 0);
+		}, 1e4);
+		video.preload = "metadata";
+		video.muted = true;
+		video.playsInline = true;
+		video.onloadeddata = () => {
+			video.currentTime = .1;
+		};
+		video.onseeked = () => {
+			clearTimeout(timeout);
+			canvas.width = video.videoWidth;
+			canvas.height = video.videoHeight;
+			const ctx = canvas.getContext("2d");
+			if (ctx) {
+				ctx.drawImage(video, 0, 0);
+				cleanup(canvas.toDataURL("image/jpeg", .7));
+			} else {
+				console.warn("[CopilotKit] generateVideoThumbnail: could not get 2d canvas context");
+				cleanup(void 0);
+			}
+		};
+		video.onerror = () => {
+			clearTimeout(timeout);
+			console.warn(`[CopilotKit] generateVideoThumbnail: video element error for file "${file.name}"`);
+			cleanup(void 0);
+		};
+		video.src = url;
+	});
+}
+/**
+* Check if a file's MIME type matches an accept filter string.
+* Handles file extensions (e.g. ".pdf"), MIME wildcards ("image/*"), and comma-separated lists.
+*/
+function matchesAcceptFilter(file, accept) {
+	if (!accept || accept === "*/*") return true;
+	return accept.split(",").map((f) => f.trim()).some((filter) => {
+		if (filter.startsWith(".")) return (file.name ?? "").toLowerCase().endsWith(filter.toLowerCase());
+		if (filter.endsWith("/*")) {
+			const prefix = filter.slice(0, -2);
+			return file.type.startsWith(prefix + "/");
+		}
+		return file.type === filter;
+	});
+}
+/**
+* Convert an InputContentSource to a usable URL string.
+* For data sources, returns a base64 data URL; for URL sources, returns the URL directly.
+*/
+function getSourceUrl(source) {
+	if (source.type === "url") return source.value;
+	return `data:${source.mimeType};base64,${source.value}`;
+}
+/**
+* Return a short human-readable label for a document MIME type (e.g. "PDF", "DOC").
+*/
+function getDocumentIcon(mimeType) {
+	if (mimeType.includes("pdf")) return "PDF";
+	if (mimeType.includes("sheet") || mimeType.includes("excel")) return "XLS";
+	if (mimeType.includes("presentation") || mimeType.includes("powerpoint")) return "PPT";
+	if (mimeType.includes("word") || mimeType.includes("document")) return "DOC";
+	if (mimeType.includes("text/")) return "TXT";
+	return "FILE";
+}
+
+//#endregion
+export { exceedsMaxSize, formatFileSize, generateVideoThumbnail, getDocumentIcon, getModalityFromMimeType, getSourceUrl, matchesAcceptFilter, readFileAsBase64 };
+//# sourceMappingURL=utils.mjs.map

package/dist/attachments/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","names":[],"sources":["../../src/attachments/utils.ts"],"sourcesContent":["import type { AttachmentModality } from \"./types\";\nimport type { InputContentSource } from \"../types/message\";\n\nconst DEFAULT_MAX_SIZE = 20 * 1024 * 1024; // 20MB\n\n/**\n * Derive the attachment modality from a MIME type string.\n */\nexport function getModalityFromMimeType(mimeType: string): AttachmentModality {\n  if (mimeType.startsWith(\"image/\")) return \"image\";\n  if (mimeType.startsWith(\"audio/\")) return \"audio\";\n  if (mimeType.startsWith(\"video/\")) return \"video\";\n  return \"document\";\n}\n\n/**\n * Format a byte count as a human-readable file size string.\n */\nexport function formatFileSize(bytes: number): string {\n  if (bytes < 1024) return `${bytes} B`;\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;\n  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;\n}\n\n/**\n * Check if a file exceeds the maximum allowed size.\n */\nexport function exceedsMaxSize(\n  file: File,\n  maxSize: number = DEFAULT_MAX_SIZE,\n): boolean {\n  return file.size > maxSize;\n}\n\n/**\n * Read a File as a base64 string (without the data URL prefix).\n */\nexport function readFileAsBase64(file: File): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const reader = new FileReader();\n    reader.onload = (e) => {\n      const result = e.target?.result as string;\n      const base64 = result?.split(\",\")[1];\n      if (base64) {\n        resolve(base64);\n      } else {\n        reject(new Error(\"Failed to read file as base64\"));\n      }\n    };\n    reader.onerror = reject;\n    reader.readAsDataURL(file);\n  });\n}\n\n/**\n * Generate a thumbnail data URL from a video file by capturing a frame near the start (at 0.1s).\n * Returns undefined if thumbnail generation fails or if called outside a browser environment.\n */\nexport function generateVideoThumbnail(\n  file: File,\n): Promise<string | undefined> {\n  if (typeof document === \"undefined\") {\n    return Promise.resolve(undefined);\n  }\n  return new Promise((resolve) => {\n    let resolved = false;\n    const video = document.createElement(\"video\");\n    const canvas = document.createElement(\"canvas\");\n    const url = URL.createObjectURL(file);\n\n    const cleanup = (result: string | undefined) => {\n      if (resolved) return;\n      resolved = true;\n      URL.revokeObjectURL(url);\n      resolve(result);\n    };\n\n    const timeout = setTimeout(() => {\n      console.warn(\n        `[CopilotKit] generateVideoThumbnail: timed out for file \"${file.name}\"`,\n      );\n      cleanup(undefined);\n    }, 10000);\n\n    video.preload = \"metadata\";\n    video.muted = true;\n    video.playsInline = true;\n\n    video.onloadeddata = () => {\n      video.currentTime = 0.1;\n    };\n\n    video.onseeked = () => {\n      clearTimeout(timeout);\n      canvas.width = video.videoWidth;\n      canvas.height = video.videoHeight;\n      const ctx = canvas.getContext(\"2d\");\n      if (ctx) {\n        ctx.drawImage(video, 0, 0);\n        const thumbnail = canvas.toDataURL(\"image/jpeg\", 0.7);\n        cleanup(thumbnail);\n      } else {\n        console.warn(\n          \"[CopilotKit] generateVideoThumbnail: could not get 2d canvas context\",\n        );\n        cleanup(undefined);\n      }\n    };\n\n    video.onerror = () => {\n      clearTimeout(timeout);\n      console.warn(\n        `[CopilotKit] generateVideoThumbnail: video element error for file \"${file.name}\"`,\n      );\n      cleanup(undefined);\n    };\n\n    video.src = url;\n  });\n}\n\n/**\n * Check if a file's MIME type matches an accept filter string.\n * Handles file extensions (e.g. \".pdf\"), MIME wildcards (\"image/*\"), and comma-separated lists.\n */\nexport function matchesAcceptFilter(file: File, accept: string): boolean {\n  if (!accept || accept === \"*/*\") return true;\n\n  const filters = accept.split(\",\").map((f) => f.trim());\n  return filters.some((filter) => {\n    if (filter.startsWith(\".\")) {\n      return (file.name ?? \"\").toLowerCase().endsWith(filter.toLowerCase());\n    }\n    if (filter.endsWith(\"/*\")) {\n      const prefix = filter.slice(0, -2);\n      return file.type.startsWith(prefix + \"/\");\n    }\n    return file.type === filter;\n  });\n}\n\n/**\n * Convert an InputContentSource to a usable URL string.\n * For data sources, returns a base64 data URL; for URL sources, returns the URL directly.\n */\nexport function getSourceUrl(source: InputContentSource): string {\n  if (source.type === \"url\") {\n    return source.value;\n  }\n  return `data:${source.mimeType};base64,${source.value}`;\n}\n\n/**\n * Return a short human-readable label for a document MIME type (e.g. \"PDF\", \"DOC\").\n */\nexport function getDocumentIcon(mimeType: string): string {\n  if (mimeType.includes(\"pdf\")) return \"PDF\";\n  if (mimeType.includes(\"sheet\") || mimeType.includes(\"excel\")) return \"XLS\";\n  if (mimeType.includes(\"presentation\") || mimeType.includes(\"powerpoint\"))\n    return \"PPT\";\n  if (mimeType.includes(\"word\") || mimeType.includes(\"document\")) return \"DOC\";\n  if (mimeType.includes(\"text/\")) return \"TXT\";\n  return \"FILE\";\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -11,6 +11,7 @@ const require_index$1 = require('./constants/index.cjs');
 const require_package = require('./package.cjs');
 const require_telemetry_client = require('./telemetry/telemetry-client.cjs');
 const require_standard_schema = require('./standard-schema.cjs');
+const require_utils = require('./attachments/utils.cjs');
 const require_logger = require('./logger.cjs');
 const require_finalize_events = require('./finalize-events.cjs');
 const require_transcription_errors = require('./transcription-errors.cjs');
@@ -72,9 +73,15 @@ exports.convertJsonSchemaToZodSchema = require_json_schema.convertJsonSchemaToZo
 exports.createLicenseContextValue = createLicenseContextValue;
 exports.dataToUUID = require_random_id.dataToUUID;
 exports.ensureStructuredError = require_errors.ensureStructuredError;
+exports.exceedsMaxSize = require_utils.exceedsMaxSize;
 exports.executeConditions = require_conditions.executeConditions;
 exports.finalizeRunEvents = require_finalize_events.finalizeRunEvents;
+exports.formatFileSize = require_utils.formatFileSize;
+exports.generateVideoThumbnail = require_utils.generateVideoThumbnail;
+exports.getDocumentIcon = require_utils.getDocumentIcon;
+exports.getModalityFromMimeType = require_utils.getModalityFromMimeType;
 exports.getPossibleVersionMismatch = require_errors.getPossibleVersionMismatch;
+exports.getSourceUrl = require_utils.getSourceUrl;
 exports.getZodParameters = require_json_schema.getZodParameters;
 exports.isMacOS = require_index.isMacOS;
 exports.isStructuredCopilotKitError = require_errors.isStructuredCopilotKitError;
@@ -84,6 +91,7 @@ exports.jsonSchemaToActionParameters = require_json_schema.jsonSchemaToActionPar
 exports.logCopilotKitPlatformMessage = require_console_styling.logCopilotKitPlatformMessage;
 exports.logStyled = require_console_styling.logStyled;
 exports.logger = require_logger.logger;
+exports.matchesAcceptFilter = require_utils.matchesAcceptFilter;
 exports.parseJson = require_index.parseJson;
 exports.partialJSONParse = require_index.partialJSONParse;
 exports.phoenixExponentialBackoff = require_index.phoenixExponentialBackoff;
@@ -91,6 +99,7 @@ exports.publicApiKeyRequired = require_console_styling.publicApiKeyRequired;
 exports.randomId = require_random_id.randomId;
 exports.randomUUID = require_random_id.randomUUID;
 exports.readBody = require_requests.readBody;
+exports.readFileAsBase64 = require_utils.readFileAsBase64;
 exports.safeParseToolArgs = require_index.safeParseToolArgs;
 exports.schemaToJsonSchema = require_standard_schema.schemaToJsonSchema;
 exports.styledConsole = require_console_styling.styledConsole;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["export * from \"./types\";\nexport * from \"./utils\";\nexport * from \"./constants\";\nexport * from \"./telemetry\";\nexport * from \"./standard-schema\";\n\nexport { logger } from \"./logger\";\nexport { finalizeRunEvents } from \"./finalize-events\";\n\nexport {\n  TranscriptionErrorCode,\n  TranscriptionErrors,\n  type TranscriptionErrorResponse,\n} from \"./transcription-errors\";\n\nimport * as packageJson from \"../package.json\";\nexport const COPILOTKIT_VERSION = packageJson.version;\n\n// Re-export only types from license-verifier (types are erased at compile time,\n// so they don't pull in the Node-only `crypto` dependency into client bundles).\n// Server-side packages (e.g. @copilotkit/runtime) should import runtime functions\n// like createLicenseChecker and getLicenseWarningHeader directly from\n// @copilotkit/license-verifier.\nexport type {\n  LicenseContextValue,\n  LicenseChecker,\n  LicenseStatus,\n  LicensePayload,\n  LicenseFeatures,\n  LicenseTier,\n  LicenseOwner,\n  LicenseMode,\n} from \"@copilotkit/license-verifier\";\n\n/**\n * Client-safe license context factory.\n *\n * When status is null (no token provided), all features return true\n * (unlicensed = unrestricted, with branding). This is inlined here to\n * avoid importing the full license-verifier bundle (which depends on\n * Node's `crypto`) into browser bundles.\n */\nexport function createLicenseContextValue(status: null): {\n  status: null;\n  license: null;\n  checkFeature: (feature: string) => boolean;\n  getLimit: (feature: string) => number | null;\n} {\n  return {\n    status: null,\n    license: null,\n    checkFeature: () => true,\n    getLimit: () => null,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAgBA,MAAa;;;;;;;;;AA0Bb,SAAgB,0BAA0B,QAKxC;AACA,QAAO;EACL,QAAQ;EACR,SAAS;EACT,oBAAoB;EACpB,gBAAgB;EACjB"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["export * from \"./types\";\nexport * from \"./utils\";\nexport * from \"./constants\";\nexport * from \"./telemetry\";\nexport * from \"./standard-schema\";\nexport * from \"./attachments\";\n\nexport { logger } from \"./logger\";\nexport { finalizeRunEvents } from \"./finalize-events\";\n\nexport {\n  TranscriptionErrorCode,\n  TranscriptionErrors,\n  type TranscriptionErrorResponse,\n} from \"./transcription-errors\";\n\nimport * as packageJson from \"../package.json\";\nexport const COPILOTKIT_VERSION = packageJson.version;\n\n// Re-export only types from license-verifier (types are erased at compile time,\n// so they don't pull in the Node-only `crypto` dependency into client bundles).\n// Server-side packages (e.g. @copilotkit/runtime) should import runtime functions\n// like createLicenseChecker and getLicenseWarningHeader directly from\n// @copilotkit/license-verifier.\nexport type {\n  LicenseContextValue,\n  LicenseChecker,\n  LicenseStatus,\n  LicensePayload,\n  LicenseFeatures,\n  LicenseTier,\n  LicenseOwner,\n  LicenseMode,\n} from \"@copilotkit/license-verifier\";\n\n/**\n * Client-safe license context factory.\n *\n * When status is null (no token provided), all features return true\n * (unlicensed = unrestricted, with branding). This is inlined here to\n * avoid importing the full license-verifier bundle (which depends on\n * Node's `crypto`) into browser bundles.\n */\nexport function createLicenseContextValue(status: null): {\n  status: null;\n  license: null;\n  checkFeature: (feature: string) => boolean;\n  getLimit: (feature: string) => number | null;\n} {\n  return {\n    status: null,\n    license: null,\n    checkFeature: () => true,\n    getLimit: () => null,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAiBA,MAAa;;;;;;;;;AA0Bb,SAAgB,0BAA0B,QAKxC;AACA,QAAO;EACL,QAAQ;EACR,SAAS;EACT,oBAAoB;EACpB,gBAAgB;EACjB"}

package/dist/index.d.cts

@@ -3,7 +3,7 @@ import { Action, MappedParameterTypes, Parameter } from "./types/action.cjs";
 import { CopilotCloudConfig } from "./types/copilot-cloud-config.cjs";
 import { PartialBy, RequiredBy } from "./types/utility.cjs";
 import { CopilotErrorEvent, CopilotErrorHandler, CopilotRequestContext } from "./types/error.cjs";
-import { AIMessage, ActivityMessage, DeveloperMessage, ImageData, Message, ReasoningMessage, Role, SystemMessage, ToolCall, ToolResult, UserMessage } from "./types/message.cjs";
+import { AIMessage, ActivityMessage, AudioInputPart, DeveloperMessage, DocumentInputPart, ImageData, ImageInputPart, InputContent, InputContentDataSource, InputContentSource, InputContentUrlSource, Message, ReasoningMessage, Role, SystemMessage, TextInputPart, ToolCall, ToolResult, UserMessage, VideoInputPart } from "./types/message.cjs";
 import { BaseCondition, ComparisonCondition, ComparisonRule, Condition, ExistenceCondition, ExistenceRule, LogicalCondition, LogicalRule, Rule, executeConditions } from "./utils/conditions.cjs";
 import { ConsoleColors, ConsoleStyles, logCopilotKitPlatformMessage, logStyled, publicApiKeyRequired, styledConsole } from "./utils/console-styling.cjs";
 import { BANNER_ERROR_NAMES, COPILOT_CLOUD_ERROR_NAMES, ConfigurationError, CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitMisuseError, CopilotKitRemoteEndpointDiscoveryError, CopilotKitVersionMismatchError, ERROR_CONFIG, ERROR_NAMES, ErrorVisibility, MissingPublicApiKeyError, ResolvedCopilotKitError, Severity, UpgradeRequiredError, ensureStructuredError, getPossibleVersionMismatch, isStructuredCopilotKitError } from "./utils/errors.cjs";
@@ -15,6 +15,8 @@ import { isMacOS, parseJson, partialJSONParse, phoenixExponentialBackoff, safePa
 import { AG_UI_CHANNEL_EVENT, COPILOT_CLOUD_API_URL, COPILOT_CLOUD_CHAT_URL, COPILOT_CLOUD_PUBLIC_API_KEY_HEADER, COPILOT_CLOUD_VERSION, DEFAULT_AGENT_ID } from "./constants/index.cjs";
 import { TelemetryClient, isTelemetryDisabled } from "./telemetry/telemetry-client.cjs";
 import { InferSchemaOutput, SchemaToJsonSchemaOptions, StandardJSONSchemaV1, StandardSchemaV1, schemaToJsonSchema } from "./standard-schema.cjs";
+import { Attachment, AttachmentModality, AttachmentUploadError, AttachmentUploadErrorReason, AttachmentUploadResult, AttachmentsConfig } from "./attachments/types.cjs";
+import { exceedsMaxSize, formatFileSize, generateVideoThumbnail, getDocumentIcon, getModalityFromMimeType, getSourceUrl, matchesAcceptFilter, readFileAsBase64 } from "./attachments/utils.cjs";
 import { logger } from "./logger.cjs";
 import { finalizeRunEvents } from "./finalize-events.cjs";
 import { TranscriptionErrorCode, TranscriptionErrorResponse, TranscriptionErrors } from "./transcription-errors.cjs";
@@ -37,5 +39,5 @@ declare function createLicenseContextValue(status: null): {
   getLimit: (feature: string) => number | null;
 };
 //#endregion
-export { AG_UI_CHANNEL_EVENT, AIMessage, Action, ActivityMessage, AgentDescription, AssistantMessage, BANNER_ERROR_NAMES, BaseCondition, COPILOTKIT_VERSION, COPILOT_CLOUD_API_URL, COPILOT_CLOUD_CHAT_URL, COPILOT_CLOUD_ERROR_NAMES, COPILOT_CLOUD_PUBLIC_API_KEY_HEADER, COPILOT_CLOUD_VERSION, CoAgentStateRenderHandler, CoAgentStateRenderHandlerArguments, ComparisonCondition, ComparisonRule, Condition, ConfigurationError, ConsoleColors, ConsoleStyles, CopilotCloudConfig, CopilotErrorEvent, CopilotErrorHandler, CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitMisuseError, CopilotKitRemoteEndpointDiscoveryError, CopilotKitVersionMismatchError, CopilotRequestContext, DEFAULT_AGENT_ID, DeveloperMessage, ERROR_CONFIG, ERROR_NAMES, ErrorVisibility, ExistenceCondition, ExistenceRule, FunctionCallHandler, FunctionCallHandlerArguments, FunctionDefinition, ImageData, InferSchemaOutput, IntelligenceRuntimeInfo, JSONSchema, JSONSchemaArray, JSONSchemaBoolean, JSONSchemaNumber, JSONSchemaObject, JSONSchemaString, JSONValue, type LicenseChecker, type LicenseContextValue, type LicenseFeatures, type LicenseMode, type LicenseOwner, type LicensePayload, type LicenseStatus, type LicenseTier, LogicalCondition, LogicalRule, MappedParameterTypes, MaybePromise, Message, MissingPublicApiKeyError, NonEmptyRecord, Parameter, PartialBy, RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, ReasoningMessage, RequiredBy, ResolvedCopilotKitError, Role, Rule, RuntimeInfo, RuntimeLicenseStatus, RuntimeMode, SchemaToJsonSchemaOptions, Severity, StandardJSONSchemaV1, StandardSchemaV1, SystemMessage, TelemetryClient, ToolCall, ToolDefinition, ToolResult, TranscriptionErrorCode, type TranscriptionErrorResponse, TranscriptionErrors, UpgradeRequiredError, UserMessage, actionParametersToJsonSchema, convertJsonSchemaToZodSchema, createLicenseContextValue, dataToUUID, ensureStructuredError, executeConditions, finalizeRunEvents, getPossibleVersionMismatch, getZodParameters, isMacOS, isStructuredCopilotKitError, isTelemetryDisabled, isValidUUID, jsonSchemaToActionParameters, logCopilotKitPlatformMessage, logStyled, logger, parseJson, partialJSONParse, phoenixExponentialBackoff, publicApiKeyRequired, randomId, randomUUID, readBody, safeParseToolArgs, schemaToJsonSchema, styledConsole, tryMap };
+export { AG_UI_CHANNEL_EVENT, AIMessage, Action, ActivityMessage, AgentDescription, AssistantMessage, Attachment, AttachmentModality, AttachmentUploadError, AttachmentUploadErrorReason, AttachmentUploadResult, AttachmentsConfig, AudioInputPart, BANNER_ERROR_NAMES, BaseCondition, COPILOTKIT_VERSION, COPILOT_CLOUD_API_URL, COPILOT_CLOUD_CHAT_URL, COPILOT_CLOUD_ERROR_NAMES, COPILOT_CLOUD_PUBLIC_API_KEY_HEADER, COPILOT_CLOUD_VERSION, CoAgentStateRenderHandler, CoAgentStateRenderHandlerArguments, ComparisonCondition, ComparisonRule, Condition, ConfigurationError, ConsoleColors, ConsoleStyles, CopilotCloudConfig, CopilotErrorEvent, CopilotErrorHandler, CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitMisuseError, CopilotKitRemoteEndpointDiscoveryError, CopilotKitVersionMismatchError, CopilotRequestContext, DEFAULT_AGENT_ID, DeveloperMessage, DocumentInputPart, ERROR_CONFIG, ERROR_NAMES, ErrorVisibility, ExistenceCondition, ExistenceRule, FunctionCallHandler, FunctionCallHandlerArguments, FunctionDefinition, ImageData, ImageInputPart, InferSchemaOutput, InputContent, InputContentDataSource, InputContentSource, InputContentUrlSource, IntelligenceRuntimeInfo, JSONSchema, JSONSchemaArray, JSONSchemaBoolean, JSONSchemaNumber, JSONSchemaObject, JSONSchemaString, JSONValue, type LicenseChecker, type LicenseContextValue, type LicenseFeatures, type LicenseMode, type LicenseOwner, type LicensePayload, type LicenseStatus, type LicenseTier, LogicalCondition, LogicalRule, MappedParameterTypes, MaybePromise, Message, MissingPublicApiKeyError, NonEmptyRecord, Parameter, PartialBy, RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, ReasoningMessage, RequiredBy, ResolvedCopilotKitError, Role, Rule, RuntimeInfo, RuntimeLicenseStatus, RuntimeMode, SchemaToJsonSchemaOptions, Severity, StandardJSONSchemaV1, StandardSchemaV1, SystemMessage, TelemetryClient, TextInputPart, ToolCall, ToolDefinition, ToolResult, TranscriptionErrorCode, type TranscriptionErrorResponse, TranscriptionErrors, UpgradeRequiredError, UserMessage, VideoInputPart, actionParametersToJsonSchema, convertJsonSchemaToZodSchema, createLicenseContextValue, dataToUUID, ensureStructuredError, exceedsMaxSize, executeConditions, finalizeRunEvents, formatFileSize, generateVideoThumbnail, getDocumentIcon, getModalityFromMimeType, getPossibleVersionMismatch, getSourceUrl, getZodParameters, isMacOS, isStructuredCopilotKitError, isTelemetryDisabled, isValidUUID, jsonSchemaToActionParameters, logCopilotKitPlatformMessage, logStyled, logger, matchesAcceptFilter, parseJson, partialJSONParse, phoenixExponentialBackoff, publicApiKeyRequired, randomId, randomUUID, readBody, readFileAsBase64, safeParseToolArgs, schemaToJsonSchema, styledConsole, tryMap };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;cAgBa,kBAAA;;;;;;;;;iBA0BG,yBAAA,CAA0B,MAAA;EACxC,MAAA;EACA,OAAA;EACA,YAAA,GAAe,OAAA;EACf,QAAA,GAAW,OAAA;AAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;cAiBa,kBAAA;;;;;;;;;iBA0BG,yBAAA,CAA0B,MAAA;EACxC,MAAA;EACA,OAAA;EACA,YAAA,GAAe,OAAA;EACf,QAAA,GAAW,OAAA;AAAA"}