@langchain/core 0.3.72 → 1.0.0-alpha.2

package/dist/messages/content/data.d.ts

@@ -0,0 +1,280 @@
+import { BaseContentBlock } from "./base.js";
+
+//#region src/messages/content/data.d.ts
+
+/**
+ * @deprecated
+ * Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+ */
+type ImageDetail = "auto" | "low" | "high";
+/**
+ * @deprecated
+ * Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+ */
+type MessageContentText = {
+  type: "text";
+  text: string;
+};
+/**
+ * @deprecated
+ * Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+ */
+type MessageContentImageUrl = {
+  type: "image_url";
+  image_url: string | {
+    url: string;
+    detail?: ImageDetail;
+  };
+};
+/**
+ * @deprecated
+ * Use {@link ContentBlock} instead.
+ */
+type MessageContentComplex = MessageContentText | MessageContentImageUrl
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+| (Record<string, any> & {
+  type?: "text" | "image_url" | string;
+})
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+| (Record<string, any> & {
+  type?: never;
+});
+type Data = never;
+// eslint-disable-next-line @typescript-eslint/no-namespace
+declare namespace Data {
+  /**
+   * @deprecated
+   * Use {@link ContentBlock.Multimodal.Data} instead
+   */
+  interface BaseDataContentBlock extends BaseContentBlock {
+    mime_type?: string;
+    metadata?: Record<string, unknown>;
+  }
+  /**
+   * @deprecated
+   * Use {@link ContentBlock.Multimodal.Data} instead
+   */
+  interface URLContentBlock extends BaseDataContentBlock {
+    type: "image" | "audio" | "file";
+    source_type: "url";
+    url: string;
+  }
+  /**
+   * @deprecated
+   * Use {@link ContentBlock.Multimodal.Data} instead
+   */
+  interface Base64ContentBlock extends BaseDataContentBlock {
+    type: "image" | "audio" | "file";
+    source_type: "base64";
+    data: string;
+  }
+  /**
+   * @deprecated
+   * Use {@link ContentBlock.Multimodal.Data} instead
+   */
+  interface PlainTextContentBlock extends BaseDataContentBlock {
+    type: "file" | "text";
+    source_type: "text";
+    text: string;
+  }
+  /**
+   * @deprecated
+   * Use {@link ContentBlock.Multimodal.Data} instead
+   */
+  interface IDContentBlock extends BaseDataContentBlock {
+    type: "image" | "audio" | "file";
+    source_type: "id";
+    id: string;
+  }
+  /**
+   * @deprecated
+   * Use {@link ContentBlock.Multimodal.Standard} instead
+   */
+  type DataContentBlock = URLContentBlock | Base64ContentBlock | PlainTextContentBlock | IDContentBlock;
+  /**
+   * @deprecated
+   * Use {@link ContentBlock.Multimodal.Standard} instead
+   */
+  type StandardImageBlock = (URLContentBlock | Base64ContentBlock | IDContentBlock) & {
+    type: "image";
+  };
+  /**
+   * @deprecated
+   * Use {@link ContentBlock.Multimodal.Standard} instead
+   */
+  type StandardAudioBlock = (URLContentBlock | Base64ContentBlock | IDContentBlock) & {
+    type: "audio";
+  };
+  /**
+   * @deprecated
+   * Use {@link ContentBlock.Multimodal.Standard} instead
+   */
+  type StandardFileBlock = (URLContentBlock | Base64ContentBlock | IDContentBlock | PlainTextContentBlock) & {
+    type: "file";
+  };
+  /**
+   * @deprecated
+   * Use {@link ContentBlock.Multimodal.Standard} instead
+   */
+  type StandardTextBlock = PlainTextContentBlock & {
+    type: "text";
+  };
+  /**
+   * @deprecated
+   * Use {@link ContentBlock.Multimodal.Data} instead
+   */
+  type DataContentBlockType = DataContentBlock["type"];
+}
+/**
+ * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+ */
+declare function isDataContentBlock(content_block: object): content_block is Data.DataContentBlock;
+/**
+ * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+ */
+declare function isURLContentBlock(content_block: object): content_block is Data.URLContentBlock;
+/**
+ * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+ */
+declare function isBase64ContentBlock(content_block: object): content_block is Data.Base64ContentBlock;
+/**
+ * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+ */
+declare function isPlainTextContentBlock(content_block: object): content_block is Data.PlainTextContentBlock;
+/**
+ * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+ */
+declare function isIDContentBlock(content_block: object): content_block is Data.IDContentBlock;
+/**
+ * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+ */
+declare function convertToOpenAIImageBlock(content_block: Data.URLContentBlock | Data.Base64ContentBlock): {
+  type: string;
+  image_url: {
+    url: string;
+  };
+};
+/**
+ * Utility function for ChatModelProviders. Parses a mime type into a type, subtype, and parameters.
+ *
+ * @param mime_type - The mime type to parse.
+ * @returns An object containing the type, subtype, and parameters.
+ *
+ * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+ */
+declare function parseMimeType(mime_type: string): {
+  type: string;
+  subtype: string;
+  parameters: Record<string, string>;
+};
+/**
+ * Utility function for ChatModelProviders. Parses a base64 data URL into a typed array or string.
+ *
+ * @param dataUrl - The base64 data URL to parse.
+ * @param asTypedArray - Whether to return the data as a typed array.
+ * @returns An object containing the parsed data and mime type, or undefined if the data URL is invalid.
+ *
+ * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+ */
+declare function parseBase64DataUrl({
+  dataUrl,
+  asTypedArray
+}: {
+  dataUrl: string;
+  asTypedArray: true;
+}): {
+  data: Uint8Array;
+  mime_type: string;
+} | undefined;
+/**
+ * Utility function for ChatModelProviders. Parses a base64 data URL into a typed array or string.
+ *
+ * @param dataUrl - The base64 data URL to parse.
+ * @param asTypedArray - Whether to return the data as a typed array.
+ * @returns The parsed data and mime type, or undefined if the data URL is invalid.
+ *
+ * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+ */
+declare function parseBase64DataUrl({
+  dataUrl,
+  asTypedArray
+}: {
+  dataUrl: string;
+  asTypedArray?: false;
+}): {
+  data: string;
+  mime_type: string;
+} | undefined;
+/**
+ * A bag of provider-specific content block types.
+ *
+ * Allows implementations of {@link StandardContentBlockConverter} and related to be defined only in
+ * terms of the types they support. Also allows for forward compatibility as the set of known
+ * standard types grows, as the set of types can be extended without breaking existing
+ * implementations of the aforementioned interfaces.
+ *
+ * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+ */
+type ProviderFormatTypes<TextFormat = unknown, ImageFormat = unknown, AudioFormat = unknown, FileFormat = unknown, VideoFormat = unknown> = {
+  text: TextFormat;
+  image: ImageFormat;
+  audio: AudioFormat;
+  file: FileFormat;
+  video: VideoFormat;
+};
+/**
+ * Utility interface for converting between standard and provider-specific data content blocks, to be
+ * used when implementing chat model providers.
+ *
+ * Meant to be used with {@link convertToProviderContentBlock} and
+ * {@link convertToStandardContentBlock} rather than being consumed directly.
+ *
+ * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+ */
+interface StandardContentBlockConverter<Formats extends Partial<ProviderFormatTypes>> {
+  /**
+   * The name of the provider type that corresponds to the provider-specific content block types
+   * that this converter supports.
+   */
+  providerName: string;
+  /**
+   * Convert from a standard image block to a provider's proprietary image block format.
+   * @param block - The standard image block to convert.
+   * @returns The provider image block.
+   */
+  fromStandardImageBlock?(block: Data.StandardImageBlock): Formats["image"];
+  /**
+   * Convert from a standard audio block to a provider's proprietary audio block format.
+   * @param block - The standard audio block to convert.
+   * @returns The provider audio block.
+   */
+  fromStandardAudioBlock?(block: Data.StandardAudioBlock): Formats["audio"];
+  /**
+   * Convert from a standard file block to a provider's proprietary file block format.
+   * @param block - The standard file block to convert.
+   * @returns The provider file block.
+   */
+  fromStandardFileBlock?(block: Data.StandardFileBlock): Formats["file"];
+  /**
+   * Convert from a standard text block to a provider's proprietary text block format.
+   * @param block - The standard text block to convert.
+   * @returns The provider text block.
+   */
+  fromStandardTextBlock?(block: Data.StandardTextBlock): Formats["text"];
+}
+/**
+ * Convert from a standard data content block to a provider's proprietary data content block format.
+ *
+ * Don't override this method. Instead, override the more specific conversion methods and use this
+ * method unmodified.
+ *
+ * @param block - The standard data content block to convert.
+ * @returns The provider data content block.
+ * @throws An error if the standard data content block type is not supported.
+ *
+ * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+ */
+declare function convertToProviderContentBlock<Formats extends Partial<ProviderFormatTypes>>(block: Data.DataContentBlock, converter: StandardContentBlockConverter<Formats>): Formats[keyof Formats];
+//#endregion
+export { Data, ImageDetail, MessageContentComplex, MessageContentImageUrl, MessageContentText, ProviderFormatTypes, StandardContentBlockConverter, convertToOpenAIImageBlock, convertToProviderContentBlock, isBase64ContentBlock, isDataContentBlock, isIDContentBlock, isPlainTextContentBlock, isURLContentBlock, parseBase64DataUrl, parseMimeType };
+//# sourceMappingURL=data.d.ts.map

package/dist/messages/content/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","names":["BaseContentBlock","ImageDetail","MessageContentText","MessageContentImageUrl","MessageContentComplex","Record","Data","BaseDataContentBlock","URLContentBlock","Base64ContentBlock","PlainTextContentBlock","IDContentBlock","DataContentBlock","isDataContentBlock","isURLContentBlock","isBase64ContentBlock","isPlainTextContentBlock","isIDContentBlock","convertToOpenAIImageBlock","parseMimeType","parseBase64DataUrl","dataUrl","asTypedArray","Uint8Array","ProviderFormatTypes","TextFormat","ImageFormat","AudioFormat","FileFormat","VideoFormat","StandardContentBlockConverter","Partial","StandardImageBlock","Formats","StandardAudioBlock","StandardFileBlock","StandardTextBlock","convertToProviderContentBlock"],"sources":["../../../src/messages/content/data.d.ts"],"sourcesContent":["import { BaseContentBlock } from \"./base.js\";\n/**\n * @deprecated\n * Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport type ImageDetail = \"auto\" | \"low\" | \"high\";\n/**\n * @deprecated\n * Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport type MessageContentText = {\n    type: \"text\";\n    text: string;\n};\n/**\n * @deprecated\n * Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport type MessageContentImageUrl = {\n    type: \"image_url\";\n    image_url: string | {\n        url: string;\n        detail?: ImageDetail;\n    };\n};\n/**\n * @deprecated\n * Use {@link ContentBlock} instead.\n */\nexport type MessageContentComplex = MessageContentText | MessageContentImageUrl\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\n | (Record<string, any> & {\n    type?: \"text\" | \"image_url\" | string;\n})\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\n | (Record<string, any> & {\n    type?: never;\n});\nexport type Data = never;\n// eslint-disable-next-line @typescript-eslint/no-namespace\nexport declare namespace Data {\n    /**\n     * @deprecated\n     * Use {@link ContentBlock.Multimodal.Data} instead\n     */\n    interface BaseDataContentBlock extends BaseContentBlock {\n        mime_type?: string;\n        metadata?: Record<string, unknown>;\n    }\n    /**\n     * @deprecated\n     * Use {@link ContentBlock.Multimodal.Data} instead\n     */\n    interface URLContentBlock extends BaseDataContentBlock {\n        type: \"image\" | \"audio\" | \"file\";\n        source_type: \"url\";\n        url: string;\n    }\n    /**\n     * @deprecated\n     * Use {@link ContentBlock.Multimodal.Data} instead\n     */\n    interface Base64ContentBlock extends BaseDataContentBlock {\n        type: \"image\" | \"audio\" | \"file\";\n        source_type: \"base64\";\n        data: string;\n    }\n    /**\n     * @deprecated\n     * Use {@link ContentBlock.Multimodal.Data} instead\n     */\n    interface PlainTextContentBlock extends BaseDataContentBlock {\n        type: \"file\" | \"text\";\n        source_type: \"text\";\n        text: string;\n    }\n    /**\n     * @deprecated\n     * Use {@link ContentBlock.Multimodal.Data} instead\n     */\n    interface IDContentBlock extends BaseDataContentBlock {\n        type: \"image\" | \"audio\" | \"file\";\n        source_type: \"id\";\n        id: string;\n    }\n    /**\n     * @deprecated\n     * Use {@link ContentBlock.Multimodal.Standard} instead\n     */\n    type DataContentBlock = URLContentBlock | Base64ContentBlock | PlainTextContentBlock | IDContentBlock;\n    /**\n     * @deprecated\n     * Use {@link ContentBlock.Multimodal.Standard} instead\n     */\n    type StandardImageBlock = (URLContentBlock | Base64ContentBlock | IDContentBlock) & {\n        type: \"image\";\n    };\n    /**\n     * @deprecated\n     * Use {@link ContentBlock.Multimodal.Standard} instead\n     */\n    type StandardAudioBlock = (URLContentBlock | Base64ContentBlock | IDContentBlock) & {\n        type: \"audio\";\n    };\n    /**\n     * @deprecated\n     * Use {@link ContentBlock.Multimodal.Standard} instead\n     */\n    type StandardFileBlock = (URLContentBlock | Base64ContentBlock | IDContentBlock | PlainTextContentBlock) & {\n        type: \"file\";\n    };\n    /**\n     * @deprecated\n     * Use {@link ContentBlock.Multimodal.Standard} instead\n     */\n    type StandardTextBlock = PlainTextContentBlock & {\n        type: \"text\";\n    };\n    /**\n     * @deprecated\n     * Use {@link ContentBlock.Multimodal.Data} instead\n     */\n    type DataContentBlockType = DataContentBlock[\"type\"];\n}\n/**\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport declare function isDataContentBlock(content_block: object): content_block is Data.DataContentBlock;\n/**\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport declare function isURLContentBlock(content_block: object): content_block is Data.URLContentBlock;\n/**\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport declare function isBase64ContentBlock(content_block: object): content_block is Data.Base64ContentBlock;\n/**\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport declare function isPlainTextContentBlock(content_block: object): content_block is Data.PlainTextContentBlock;\n/**\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport declare function isIDContentBlock(content_block: object): content_block is Data.IDContentBlock;\n/**\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport declare function convertToOpenAIImageBlock(content_block: Data.URLContentBlock | Data.Base64ContentBlock): {\n    type: string;\n    image_url: {\n        url: string;\n    };\n};\n/**\n * Utility function for ChatModelProviders. Parses a mime type into a type, subtype, and parameters.\n *\n * @param mime_type - The mime type to parse.\n * @returns An object containing the type, subtype, and parameters.\n *\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport declare function parseMimeType(mime_type: string): {\n    type: string;\n    subtype: string;\n    parameters: Record<string, string>;\n};\n/**\n * Utility function for ChatModelProviders. Parses a base64 data URL into a typed array or string.\n *\n * @param dataUrl - The base64 data URL to parse.\n * @param asTypedArray - Whether to return the data as a typed array.\n * @returns An object containing the parsed data and mime type, or undefined if the data URL is invalid.\n *\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport declare function parseBase64DataUrl({ dataUrl, asTypedArray }: {\n    dataUrl: string;\n    asTypedArray: true;\n}): {\n    data: Uint8Array;\n    mime_type: string;\n} | undefined;\n/**\n * Utility function for ChatModelProviders. Parses a base64 data URL into a typed array or string.\n *\n * @param dataUrl - The base64 data URL to parse.\n * @param asTypedArray - Whether to return the data as a typed array.\n * @returns The parsed data and mime type, or undefined if the data URL is invalid.\n *\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport declare function parseBase64DataUrl({ dataUrl, asTypedArray }: {\n    dataUrl: string;\n    asTypedArray?: false;\n}): {\n    data: string;\n    mime_type: string;\n} | undefined;\n/**\n * A bag of provider-specific content block types.\n *\n * Allows implementations of {@link StandardContentBlockConverter} and related to be defined only in\n * terms of the types they support. Also allows for forward compatibility as the set of known\n * standard types grows, as the set of types can be extended without breaking existing\n * implementations of the aforementioned interfaces.\n *\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport type ProviderFormatTypes<TextFormat = unknown, ImageFormat = unknown, AudioFormat = unknown, FileFormat = unknown, VideoFormat = unknown> = {\n    text: TextFormat;\n    image: ImageFormat;\n    audio: AudioFormat;\n    file: FileFormat;\n    video: VideoFormat;\n};\n/**\n * Utility interface for converting between standard and provider-specific data content blocks, to be\n * used when implementing chat model providers.\n *\n * Meant to be used with {@link convertToProviderContentBlock} and\n * {@link convertToStandardContentBlock} rather than being consumed directly.\n *\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport interface StandardContentBlockConverter<Formats extends Partial<ProviderFormatTypes>> {\n    /**\n     * The name of the provider type that corresponds to the provider-specific content block types\n     * that this converter supports.\n     */\n    providerName: string;\n    /**\n     * Convert from a standard image block to a provider's proprietary image block format.\n     * @param block - The standard image block to convert.\n     * @returns The provider image block.\n     */\n    fromStandardImageBlock?(block: Data.StandardImageBlock): Formats[\"image\"];\n    /**\n     * Convert from a standard audio block to a provider's proprietary audio block format.\n     * @param block - The standard audio block to convert.\n     * @returns The provider audio block.\n     */\n    fromStandardAudioBlock?(block: Data.StandardAudioBlock): Formats[\"audio\"];\n    /**\n     * Convert from a standard file block to a provider's proprietary file block format.\n     * @param block - The standard file block to convert.\n     * @returns The provider file block.\n     */\n    fromStandardFileBlock?(block: Data.StandardFileBlock): Formats[\"file\"];\n    /**\n     * Convert from a standard text block to a provider's proprietary text block format.\n     * @param block - The standard text block to convert.\n     * @returns The provider text block.\n     */\n    fromStandardTextBlock?(block: Data.StandardTextBlock): Formats[\"text\"];\n}\n/**\n * Convert from a standard data content block to a provider's proprietary data content block format.\n *\n * Don't override this method. Instead, override the more specific conversion methods and use this\n * method unmodified.\n *\n * @param block - The standard data content block to convert.\n * @returns The provider data content block.\n * @throws An error if the standard data content block type is not supported.\n *\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport declare function convertToProviderContentBlock<Formats extends Partial<ProviderFormatTypes>>(block: Data.DataContentBlock, converter: StandardContentBlockConverter<Formats>): Formats[keyof Formats];\n"],"mappings":"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"}

package/dist/messages/content/data.js

@@ -0,0 +1,137 @@
+//#region src/messages/content/data.ts
+/**
+* @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+*/
+function isDataContentBlock(content_block) {
+	return typeof content_block === "object" && content_block !== null && "type" in content_block && typeof content_block.type === "string" && "source_type" in content_block && (content_block.source_type === "url" || content_block.source_type === "base64" || content_block.source_type === "text" || content_block.source_type === "id");
+}
+/**
+* @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+*/
+function isURLContentBlock(content_block) {
+	return isDataContentBlock(content_block) && content_block.source_type === "url" && "url" in content_block && typeof content_block.url === "string";
+}
+/**
+* @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+*/
+function isBase64ContentBlock(content_block) {
+	return isDataContentBlock(content_block) && content_block.source_type === "base64" && "data" in content_block && typeof content_block.data === "string";
+}
+/**
+* @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+*/
+function isPlainTextContentBlock(content_block) {
+	return isDataContentBlock(content_block) && content_block.source_type === "text" && "text" in content_block && typeof content_block.text === "string";
+}
+/**
+* @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+*/
+function isIDContentBlock(content_block) {
+	return isDataContentBlock(content_block) && content_block.source_type === "id" && "id" in content_block && typeof content_block.id === "string";
+}
+/**
+* @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+*/
+function convertToOpenAIImageBlock(content_block) {
+	if (isDataContentBlock(content_block)) {
+		if (content_block.source_type === "url") return {
+			type: "image_url",
+			image_url: { url: content_block.url }
+		};
+		if (content_block.source_type === "base64") {
+			if (!content_block.mime_type) throw new Error("mime_type key is required for base64 data.");
+			const mime_type = content_block.mime_type;
+			return {
+				type: "image_url",
+				image_url: { url: `data:${mime_type};base64,${content_block.data}` }
+			};
+		}
+	}
+	throw new Error("Unsupported source type. Only 'url' and 'base64' are supported.");
+}
+/**
+* Utility function for ChatModelProviders. Parses a mime type into a type, subtype, and parameters.
+*
+* @param mime_type - The mime type to parse.
+* @returns An object containing the type, subtype, and parameters.
+*
+* @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+*/
+function parseMimeType(mime_type) {
+	const parts = mime_type.split(";")[0].split("/");
+	if (parts.length !== 2) throw new Error(`Invalid mime type: "${mime_type}" - does not match type/subtype format.`);
+	const type = parts[0].trim();
+	const subtype = parts[1].trim();
+	if (type === "" || subtype === "") throw new Error(`Invalid mime type: "${mime_type}" - type or subtype is empty.`);
+	const parameters = {};
+	for (const parameterKvp of mime_type.split(";").slice(1)) {
+		const parameterParts = parameterKvp.split("=");
+		if (parameterParts.length !== 2) throw new Error(`Invalid parameter syntax in mime type: "${mime_type}".`);
+		const key = parameterParts[0].trim();
+		const value = parameterParts[1].trim();
+		if (key === "") throw new Error(`Invalid parameter syntax in mime type: "${mime_type}".`);
+		parameters[key] = value;
+	}
+	return {
+		type,
+		subtype,
+		parameters
+	};
+}
+/**
+* Utility function for ChatModelProviders. Parses a base64 data URL into a typed array or string.
+*
+* @param dataUrl - The base64 data URL to parse.
+* @param asTypedArray - Whether to return the data as a typed array.
+* @returns The parsed data and mime type, or undefined if the data URL is invalid.
+*
+* @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+*/
+function parseBase64DataUrl({ dataUrl: data_url, asTypedArray = false }) {
+	const formatMatch = data_url.match(/^data:(\w+\/\w+);base64,([A-Za-z0-9+/]+=*)$/);
+	let mime_type;
+	if (formatMatch) {
+		mime_type = formatMatch[1].toLowerCase();
+		const data = asTypedArray ? Uint8Array.from(atob(formatMatch[2]), (c) => c.charCodeAt(0)) : formatMatch[2];
+		return {
+			mime_type,
+			data
+		};
+	}
+	return void 0;
+}
+/**
+* Convert from a standard data content block to a provider's proprietary data content block format.
+*
+* Don't override this method. Instead, override the more specific conversion methods and use this
+* method unmodified.
+*
+* @param block - The standard data content block to convert.
+* @returns The provider data content block.
+* @throws An error if the standard data content block type is not supported.
+*
+* @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.
+*/
+function convertToProviderContentBlock(block, converter) {
+	if (block.type === "text") {
+		if (!converter.fromStandardTextBlock) throw new Error(`Converter for ${converter.providerName} does not implement \`fromStandardTextBlock\` method.`);
+		return converter.fromStandardTextBlock(block);
+	}
+	if (block.type === "image") {
+		if (!converter.fromStandardImageBlock) throw new Error(`Converter for ${converter.providerName} does not implement \`fromStandardImageBlock\` method.`);
+		return converter.fromStandardImageBlock(block);
+	}
+	if (block.type === "audio") {
+		if (!converter.fromStandardAudioBlock) throw new Error(`Converter for ${converter.providerName} does not implement \`fromStandardAudioBlock\` method.`);
+		return converter.fromStandardAudioBlock(block);
+	}
+	if (block.type === "file") {
+		if (!converter.fromStandardFileBlock) throw new Error(`Converter for ${converter.providerName} does not implement \`fromStandardFileBlock\` method.`);
+		return converter.fromStandardFileBlock(block);
+	}
+	throw new Error(`Unable to convert content block type '${block.type}' to provider-specific format: not recognized.`);
+}
+
+//#endregion
+export { convertToOpenAIImageBlock, convertToProviderContentBlock, isBase64ContentBlock, isDataContentBlock, isIDContentBlock, isPlainTextContentBlock, isURLContentBlock, parseBase64DataUrl, parseMimeType };
+//# sourceMappingURL=data.js.map

package/dist/messages/content/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","names":["content_block: object","content_block: Data.URLContentBlock | Data.Base64ContentBlock","mime_type: string","parameters: Record<string, string>","mime_type: string | undefined","block: Data.DataContentBlock","converter: StandardContentBlockConverter<Formats>"],"sources":["../../../src/messages/content/data.ts"],"sourcesContent":["import { BaseContentBlock } from \"./base.js\";\n\n/**\n * @deprecated\n * Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport type ImageDetail = \"auto\" | \"low\" | \"high\";\n\n/**\n * @deprecated\n * Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport type MessageContentText = {\n  type: \"text\";\n  text: string;\n};\n\n/**\n * @deprecated\n * Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport type MessageContentImageUrl = {\n  type: \"image_url\";\n  image_url: string | { url: string; detail?: ImageDetail };\n};\n\n/**\n * @deprecated\n * Use {@link ContentBlock} instead.\n */\nexport type MessageContentComplex =\n  | MessageContentText\n  | MessageContentImageUrl\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  | (Record<string, any> & { type?: \"text\" | \"image_url\" | string })\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  | (Record<string, any> & { type?: never });\n\nexport type Data = never;\n\n// eslint-disable-next-line @typescript-eslint/no-namespace\nexport declare namespace Data {\n  /**\n   * @deprecated\n   * Use {@link ContentBlock.Multimodal.Data} instead\n   */\n  export interface BaseDataContentBlock extends BaseContentBlock {\n    mime_type?: string;\n    metadata?: Record<string, unknown>;\n  }\n\n  /**\n   * @deprecated\n   * Use {@link ContentBlock.Multimodal.Data} instead\n   */\n  export interface URLContentBlock extends BaseDataContentBlock {\n    type: \"image\" | \"audio\" | \"file\";\n    source_type: \"url\";\n    url: string;\n  }\n\n  /**\n   * @deprecated\n   * Use {@link ContentBlock.Multimodal.Data} instead\n   */\n  export interface Base64ContentBlock extends BaseDataContentBlock {\n    type: \"image\" | \"audio\" | \"file\";\n    source_type: \"base64\";\n    data: string;\n  }\n\n  /**\n   * @deprecated\n   * Use {@link ContentBlock.Multimodal.Data} instead\n   */\n  export interface PlainTextContentBlock extends BaseDataContentBlock {\n    type: \"file\" | \"text\";\n    source_type: \"text\";\n    text: string;\n  }\n\n  /**\n   * @deprecated\n   * Use {@link ContentBlock.Multimodal.Data} instead\n   */\n  export interface IDContentBlock extends BaseDataContentBlock {\n    type: \"image\" | \"audio\" | \"file\";\n    source_type: \"id\";\n    id: string;\n  }\n\n  /**\n   * @deprecated\n   * Use {@link ContentBlock.Multimodal.Standard} instead\n   */\n  export type DataContentBlock =\n    | URLContentBlock\n    | Base64ContentBlock\n    | PlainTextContentBlock\n    | IDContentBlock;\n\n  /**\n   * @deprecated\n   * Use {@link ContentBlock.Multimodal.Standard} instead\n   */\n  export type StandardImageBlock = (\n    | URLContentBlock\n    | Base64ContentBlock\n    | IDContentBlock\n  ) & {\n    type: \"image\";\n  };\n\n  /**\n   * @deprecated\n   * Use {@link ContentBlock.Multimodal.Standard} instead\n   */\n  export type StandardAudioBlock = (\n    | URLContentBlock\n    | Base64ContentBlock\n    | IDContentBlock\n  ) & {\n    type: \"audio\";\n  };\n\n  /**\n   * @deprecated\n   * Use {@link ContentBlock.Multimodal.Standard} instead\n   */\n  export type StandardFileBlock = (\n    | URLContentBlock\n    | Base64ContentBlock\n    | IDContentBlock\n    | PlainTextContentBlock\n  ) & {\n    type: \"file\";\n  };\n\n  /**\n   * @deprecated\n   * Use {@link ContentBlock.Multimodal.Standard} instead\n   */\n  export type StandardTextBlock = PlainTextContentBlock & {\n    type: \"text\";\n  };\n\n  /**\n   * @deprecated\n   * Use {@link ContentBlock.Multimodal.Data} instead\n   */\n  export type DataContentBlockType = DataContentBlock[\"type\"];\n}\n\n/**\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport function isDataContentBlock(\n  content_block: object\n): content_block is Data.DataContentBlock {\n  return (\n    typeof content_block === \"object\" &&\n    content_block !== null &&\n    \"type\" in content_block &&\n    typeof content_block.type === \"string\" &&\n    \"source_type\" in content_block &&\n    (content_block.source_type === \"url\" ||\n      content_block.source_type === \"base64\" ||\n      content_block.source_type === \"text\" ||\n      content_block.source_type === \"id\")\n  );\n}\n\n/**\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport function isURLContentBlock(\n  content_block: object\n): content_block is Data.URLContentBlock {\n  return (\n    isDataContentBlock(content_block) &&\n    content_block.source_type === \"url\" &&\n    \"url\" in content_block &&\n    typeof content_block.url === \"string\"\n  );\n}\n\n/**\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport function isBase64ContentBlock(\n  content_block: object\n): content_block is Data.Base64ContentBlock {\n  return (\n    isDataContentBlock(content_block) &&\n    content_block.source_type === \"base64\" &&\n    \"data\" in content_block &&\n    typeof content_block.data === \"string\"\n  );\n}\n\n/**\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport function isPlainTextContentBlock(\n  content_block: object\n): content_block is Data.PlainTextContentBlock {\n  return (\n    isDataContentBlock(content_block) &&\n    content_block.source_type === \"text\" &&\n    \"text\" in content_block &&\n    typeof content_block.text === \"string\"\n  );\n}\n\n/**\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport function isIDContentBlock(\n  content_block: object\n): content_block is Data.IDContentBlock {\n  return (\n    isDataContentBlock(content_block) &&\n    content_block.source_type === \"id\" &&\n    \"id\" in content_block &&\n    typeof content_block.id === \"string\"\n  );\n}\n\n/**\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport function convertToOpenAIImageBlock(\n  content_block: Data.URLContentBlock | Data.Base64ContentBlock\n) {\n  if (isDataContentBlock(content_block)) {\n    if (content_block.source_type === \"url\") {\n      return {\n        type: \"image_url\",\n        image_url: {\n          url: content_block.url,\n        },\n      };\n    }\n    if (content_block.source_type === \"base64\") {\n      if (!content_block.mime_type) {\n        throw new Error(\"mime_type key is required for base64 data.\");\n      }\n      const mime_type = content_block.mime_type;\n      return {\n        type: \"image_url\",\n        image_url: {\n          url: `data:${mime_type};base64,${content_block.data}`,\n        },\n      };\n    }\n  }\n  throw new Error(\n    \"Unsupported source type. Only 'url' and 'base64' are supported.\"\n  );\n}\n\n/**\n * Utility function for ChatModelProviders. Parses a mime type into a type, subtype, and parameters.\n *\n * @param mime_type - The mime type to parse.\n * @returns An object containing the type, subtype, and parameters.\n *\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport function parseMimeType(mime_type: string): {\n  type: string;\n  subtype: string;\n  parameters: Record<string, string>;\n} {\n  const parts = mime_type.split(\";\")[0].split(\"/\");\n  if (parts.length !== 2) {\n    throw new Error(\n      `Invalid mime type: \"${mime_type}\" - does not match type/subtype format.`\n    );\n  }\n\n  const type = parts[0].trim();\n  const subtype = parts[1].trim();\n\n  if (type === \"\" || subtype === \"\") {\n    throw new Error(\n      `Invalid mime type: \"${mime_type}\" - type or subtype is empty.`\n    );\n  }\n\n  const parameters: Record<string, string> = {};\n\n  for (const parameterKvp of mime_type.split(\";\").slice(1)) {\n    const parameterParts = parameterKvp.split(\"=\");\n    if (parameterParts.length !== 2) {\n      throw new Error(`Invalid parameter syntax in mime type: \"${mime_type}\".`);\n    }\n    const key = parameterParts[0].trim();\n    const value = parameterParts[1].trim();\n    if (key === \"\") {\n      throw new Error(`Invalid parameter syntax in mime type: \"${mime_type}\".`);\n    }\n\n    parameters[key] = value;\n  }\n\n  return {\n    type,\n    subtype,\n    parameters,\n  };\n}\n\n/**\n * Utility function for ChatModelProviders. Parses a base64 data URL into a typed array or string.\n *\n * @param dataUrl - The base64 data URL to parse.\n * @param asTypedArray - Whether to return the data as a typed array.\n * @returns An object containing the parsed data and mime type, or undefined if the data URL is invalid.\n *\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport function parseBase64DataUrl({\n  dataUrl,\n  asTypedArray,\n}: {\n  dataUrl: string;\n  asTypedArray: true;\n}): { data: Uint8Array; mime_type: string } | undefined;\n\n/**\n * Utility function for ChatModelProviders. Parses a base64 data URL into a typed array or string.\n *\n * @param dataUrl - The base64 data URL to parse.\n * @param asTypedArray - Whether to return the data as a typed array.\n * @returns The parsed data and mime type, or undefined if the data URL is invalid.\n *\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport function parseBase64DataUrl({\n  dataUrl,\n  asTypedArray,\n}: {\n  dataUrl: string;\n  asTypedArray?: false;\n}): { data: string; mime_type: string } | undefined;\n\n/**\n * Utility function for ChatModelProviders. Parses a base64 data URL into a typed array or string.\n *\n * @param dataUrl - The base64 data URL to parse.\n * @param asTypedArray - Whether to return the data as a typed array.\n * @returns The parsed data and mime type, or undefined if the data URL is invalid.\n *\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport function parseBase64DataUrl({\n  dataUrl: data_url,\n  asTypedArray = false,\n}: {\n  dataUrl: string;\n  asTypedArray?: boolean;\n}): { data: string | Uint8Array; mime_type: string } | undefined {\n  const formatMatch = data_url.match(\n    /^data:(\\w+\\/\\w+);base64,([A-Za-z0-9+/]+=*)$/\n  );\n  let mime_type: string | undefined;\n\n  if (formatMatch) {\n    mime_type = formatMatch[1].toLowerCase();\n    const data = asTypedArray\n      ? Uint8Array.from(atob(formatMatch[2]), (c) => c.charCodeAt(0))\n      : formatMatch[2];\n    return {\n      mime_type,\n      data,\n    };\n  }\n\n  return undefined;\n}\n\n/**\n * A bag of provider-specific content block types.\n *\n * Allows implementations of {@link StandardContentBlockConverter} and related to be defined only in\n * terms of the types they support. Also allows for forward compatibility as the set of known\n * standard types grows, as the set of types can be extended without breaking existing\n * implementations of the aforementioned interfaces.\n *\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport type ProviderFormatTypes<\n  TextFormat = unknown,\n  ImageFormat = unknown,\n  AudioFormat = unknown,\n  FileFormat = unknown,\n  VideoFormat = unknown\n> = {\n  text: TextFormat;\n  image: ImageFormat;\n  audio: AudioFormat;\n  file: FileFormat;\n  video: VideoFormat;\n};\n\n/**\n * Utility interface for converting between standard and provider-specific data content blocks, to be\n * used when implementing chat model providers.\n *\n * Meant to be used with {@link convertToProviderContentBlock} and\n * {@link convertToStandardContentBlock} rather than being consumed directly.\n *\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport interface StandardContentBlockConverter<\n  Formats extends Partial<ProviderFormatTypes>\n> {\n  /**\n   * The name of the provider type that corresponds to the provider-specific content block types\n   * that this converter supports.\n   */\n  providerName: string;\n\n  /**\n   * Convert from a standard image block to a provider's proprietary image block format.\n   * @param block - The standard image block to convert.\n   * @returns The provider image block.\n   */\n  fromStandardImageBlock?(block: Data.StandardImageBlock): Formats[\"image\"];\n\n  /**\n   * Convert from a standard audio block to a provider's proprietary audio block format.\n   * @param block - The standard audio block to convert.\n   * @returns The provider audio block.\n   */\n  fromStandardAudioBlock?(block: Data.StandardAudioBlock): Formats[\"audio\"];\n\n  /**\n   * Convert from a standard file block to a provider's proprietary file block format.\n   * @param block - The standard file block to convert.\n   * @returns The provider file block.\n   */\n  fromStandardFileBlock?(block: Data.StandardFileBlock): Formats[\"file\"];\n\n  /**\n   * Convert from a standard text block to a provider's proprietary text block format.\n   * @param block - The standard text block to convert.\n   * @returns The provider text block.\n   */\n  fromStandardTextBlock?(block: Data.StandardTextBlock): Formats[\"text\"];\n}\n\n/**\n * Convert from a standard data content block to a provider's proprietary data content block format.\n *\n * Don't override this method. Instead, override the more specific conversion methods and use this\n * method unmodified.\n *\n * @param block - The standard data content block to convert.\n * @returns The provider data content block.\n * @throws An error if the standard data content block type is not supported.\n *\n * @deprecated Don't use data content blocks. Use {@link ContentBlock.Multimodal.Data} instead.\n */\nexport function convertToProviderContentBlock<\n  Formats extends Partial<ProviderFormatTypes>\n>(\n  block: Data.DataContentBlock,\n  converter: StandardContentBlockConverter<Formats>\n): Formats[keyof Formats] {\n  if (block.type === \"text\") {\n    if (!converter.fromStandardTextBlock) {\n      throw new Error(\n        `Converter for ${converter.providerName} does not implement \\`fromStandardTextBlock\\` method.`\n      );\n    }\n    return converter.fromStandardTextBlock(block as Data.StandardTextBlock);\n  }\n  if (block.type === \"image\") {\n    if (!converter.fromStandardImageBlock) {\n      throw new Error(\n        `Converter for ${converter.providerName} does not implement \\`fromStandardImageBlock\\` method.`\n      );\n    }\n    return converter.fromStandardImageBlock(block as Data.StandardImageBlock);\n  }\n  if (block.type === \"audio\") {\n    if (!converter.fromStandardAudioBlock) {\n      throw new Error(\n        `Converter for ${converter.providerName} does not implement \\`fromStandardAudioBlock\\` method.`\n      );\n    }\n    return converter.fromStandardAudioBlock(block as Data.StandardAudioBlock);\n  }\n  if (block.type === \"file\") {\n    if (!converter.fromStandardFileBlock) {\n      throw new Error(\n        `Converter for ${converter.providerName} does not implement \\`fromStandardFileBlock\\` method.`\n      );\n    }\n    return converter.fromStandardFileBlock(block as Data.StandardFileBlock);\n  }\n  throw new Error(\n    `Unable to convert content block type '${block.type}' to provider-specific format: not recognized.`\n  );\n}\n"],"mappings":"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"}

package/dist/messages/content/index.cjs

@@ -0,0 +1,14 @@
+const require_tools = require('./tools.cjs');
+const require_multimodal = require('./multimodal.cjs');
+
+//#region src/messages/content/index.ts
+const KNOWN_BLOCK_TYPES$2 = [
+	"text",
+	"reasoning",
+	...require_tools.KNOWN_BLOCK_TYPES,
+	...require_multimodal.KNOWN_BLOCK_TYPES
+];
+
+//#endregion
+exports.KNOWN_BLOCK_TYPES = KNOWN_BLOCK_TYPES$2;
+//# sourceMappingURL=index.cjs.map

package/dist/messages/content/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["KNOWN_BLOCK_TYPES","KNOWN_TOOL_BLOCK_TYPES","KNOWN_MULTIMODAL_BLOCK_TYPES"],"sources":["../../../src/messages/content/index.ts"],"sourcesContent":["import type { BaseContentBlock } from \"./base.js\";\nimport {\n  KNOWN_BLOCK_TYPES as KNOWN_TOOL_BLOCK_TYPES,\n  type Tools,\n} from \"./tools.js\";\nimport {\n  KNOWN_BLOCK_TYPES as KNOWN_MULTIMODAL_BLOCK_TYPES,\n  type Multimodal,\n} from \"./multimodal.js\";\nimport { type Data } from \"./data.js\";\n\nexport type ContentBlock = BaseContentBlock;\n\nexport const KNOWN_BLOCK_TYPES = [\n  \"text\",\n  \"reasoning\",\n  ...KNOWN_TOOL_BLOCK_TYPES,\n  ...KNOWN_MULTIMODAL_BLOCK_TYPES,\n];\n\n// eslint-disable-next-line @typescript-eslint/no-namespace\nexport declare namespace ContentBlock {\n  /**\n   * Annotation for citing data from a document.\n   */\n  export interface Citation {\n    /**\n     * Type of the content block\n     */\n    readonly type: \"citation\";\n    /**\n     * Source type for the citation.\n     */\n    source?: string;\n    /**\n     * URL of the document source\n     */\n    url?: string;\n    /**\n     * Source document title.\n     *\n     * For example, the page title for a web page or the title of a paper.\n     */\n    title?: string;\n    /**\n     * Start index of the **response text** for which the annotation applies.\n     *\n     * @see {Text}\n     */\n    startIndex?: number;\n    /**\n     * End index of the **response text** for which the annotation applies.\n     *\n     * @see {Text}\n     */\n    endIndex?: number;\n    /**\n     * Excerpt of source text being cited.\n     */\n    citedText?: string;\n  }\n\n  /**\n   * Text output from a LLM.\n   *\n   * This typically represents the main text content of a message, such as the response\n   * from a language model or the text of a user message.\n   */\n  export interface Text extends ContentBlock {\n    /**\n     * Type of the content block\n     */\n    readonly type: \"text\";\n    /**\n     * Block text.\n     */\n    text: string;\n    /**\n     * Index of block in aggregate response. Used during streaming.\n     */\n    index?: number;\n    /**\n     * Citations and other annotations.\n     */\n    annotations?: Array<Citation | BaseContentBlock>;\n  }\n\n  /**\n   * Reasoning output from a LLM.\n   */\n  export interface Reasoning extends ContentBlock {\n    /**\n     * Type of the content block\n     */\n    readonly type: \"reasoning\";\n    /**\n     * Reasoning text.\n     *\n     * Either the thought summary or the raw reasoning text itself.\n     * This is often parsed from `<think>` tags in the model's response.\n     */\n    reasoning: string;\n    /**\n     * Index of block in aggregate response. Used during streaming.\n     */\n    index?: number;\n  }\n\n  export { Tools };\n  export { Multimodal };\n  export { Data };\n\n  export type Standard =\n    | Text\n    | Reasoning\n    | Tools.Standard\n    | Multimodal.Standard;\n}\n"],"mappings":";;;;AAaA,MAAaA,sBAAoB;CAC/B;CACA;CACA,GAAGC;CACH,GAAGC;AACJ"}

package/dist/messages/content/index.d.cts

@@ -0,0 +1,101 @@
+import { BaseContentBlock } from "./base.cjs";
+import { Tools } from "./tools.cjs";
+import { Multimodal } from "./multimodal.cjs";
+import { Data } from "./data.cjs";
+
+//#region src/messages/content/index.d.ts
+type ContentBlock = BaseContentBlock;
+declare const KNOWN_BLOCK_TYPES: string[];
+// eslint-disable-next-line @typescript-eslint/no-namespace
+declare namespace ContentBlock {
+  /**
+   * Annotation for citing data from a document.
+   */
+  export interface Citation {
+    /**
+     * Type of the content block
+     */
+    readonly type: "citation";
+    /**
+     * Source type for the citation.
+     */
+    source?: string;
+    /**
+     * URL of the document source
+     */
+    url?: string;
+    /**
+     * Source document title.
+     *
+     * For example, the page title for a web page or the title of a paper.
+     */
+    title?: string;
+    /**
+     * Start index of the **response text** for which the annotation applies.
+     *
+     * @see {Text}
+     */
+    startIndex?: number;
+    /**
+     * End index of the **response text** for which the annotation applies.
+     *
+     * @see {Text}
+     */
+    endIndex?: number;
+    /**
+     * Excerpt of source text being cited.
+     */
+    citedText?: string;
+  }
+  /**
+   * Text output from a LLM.
+   *
+   * This typically represents the main text content of a message, such as the response
+   * from a language model or the text of a user message.
+   */
+  export interface Text extends ContentBlock {
+    /**
+     * Type of the content block
+     */
+    readonly type: "text";
+    /**
+     * Block text.
+     */
+    text: string;
+    /**
+     * Index of block in aggregate response. Used during streaming.
+     */
+    index?: number;
+    /**
+     * Citations and other annotations.
+     */
+    annotations?: Array<Citation | BaseContentBlock>;
+  }
+  /**
+   * Reasoning output from a LLM.
+   */
+  export interface Reasoning extends ContentBlock {
+    /**
+     * Type of the content block
+     */
+    readonly type: "reasoning";
+    /**
+     * Reasoning text.
+     *
+     * Either the thought summary or the raw reasoning text itself.
+     * This is often parsed from `<think>` tags in the model's response.
+     */
+    reasoning: string;
+    /**
+     * Index of block in aggregate response. Used during streaming.
+     */
+    index?: number;
+  }
+  export { Tools };
+  export { Multimodal };
+  export { Data };
+  export type Standard = Text | Reasoning | Tools.Standard | Multimodal.Standard;
+}
+//#endregion
+export { ContentBlock, KNOWN_BLOCK_TYPES };
+//# sourceMappingURL=index.d.cts.map

package/dist/messages/content/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":["BaseContentBlock","Tools","Multimodal","Data","ContentBlock","KNOWN_BLOCK_TYPES","Citation","Array","Text","Reasoning","Standard"],"sources":["../../../src/messages/content/index.d.ts"],"sourcesContent":["import type { BaseContentBlock } from \"./base.js\";\nimport { type Tools } from \"./tools.js\";\nimport { type Multimodal } from \"./multimodal.js\";\nimport { type Data } from \"./data.js\";\nexport type ContentBlock = BaseContentBlock;\nexport declare const KNOWN_BLOCK_TYPES: string[];\n// eslint-disable-next-line @typescript-eslint/no-namespace\nexport declare namespace ContentBlock {\n    /**\n     * Annotation for citing data from a document.\n     */\n    export interface Citation {\n        /**\n         * Type of the content block\n         */\n        readonly type: \"citation\";\n        /**\n         * Source type for the citation.\n         */\n        source?: string;\n        /**\n         * URL of the document source\n         */\n        url?: string;\n        /**\n         * Source document title.\n         *\n         * For example, the page title for a web page or the title of a paper.\n         */\n        title?: string;\n        /**\n         * Start index of the **response text** for which the annotation applies.\n         *\n         * @see {Text}\n         */\n        startIndex?: number;\n        /**\n         * End index of the **response text** for which the annotation applies.\n         *\n         * @see {Text}\n         */\n        endIndex?: number;\n        /**\n         * Excerpt of source text being cited.\n         */\n        citedText?: string;\n    }\n    /**\n     * Text output from a LLM.\n     *\n     * This typically represents the main text content of a message, such as the response\n     * from a language model or the text of a user message.\n     */\n    export interface Text extends ContentBlock {\n        /**\n         * Type of the content block\n         */\n        readonly type: \"text\";\n        /**\n         * Block text.\n         */\n        text: string;\n        /**\n         * Index of block in aggregate response. Used during streaming.\n         */\n        index?: number;\n        /**\n         * Citations and other annotations.\n         */\n        annotations?: Array<Citation | BaseContentBlock>;\n    }\n    /**\n     * Reasoning output from a LLM.\n     */\n    export interface Reasoning extends ContentBlock {\n        /**\n         * Type of the content block\n         */\n        readonly type: \"reasoning\";\n        /**\n         * Reasoning text.\n         *\n         * Either the thought summary or the raw reasoning text itself.\n         * This is often parsed from `<think>` tags in the model's response.\n         */\n        reasoning: string;\n        /**\n         * Index of block in aggregate response. Used during streaming.\n         */\n        index?: number;\n    }\n    export { Tools };\n    export { Multimodal };\n    export { Data };\n    export type Standard = Text | Reasoning | Tools.Standard | Multimodal.Standard;\n}\n"],"mappings":";;;;;;KAIYI,YAAAA,GAAeJ;cACNK;AADrB;AACqBA,kBAEID,YAAAA,CAFuB;EAEvBA;;;EA8DW,OAAGJ,UAAAA,QAAAA,CAAAA;IAAjBO;;;IAsBTN,SAAAA,IAAAA,EAAAA,UAAAA;IACAC;;;IAEqBO,MAAAA,CAAAA,EAAAA,MAAAA;IAAYR;;AAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAzChDG;;;;;;;;;;;;;;;;kBAgBZG,MAAMD,WAAWN;;;;;qCAKAI;;;;;;;;;;;;;;;;;WAiB1BH;WACAC;WACAC;yBACcK,OAAOC,YAAYR,KAAAA,CAAMS,WAAWR,UAAAA,CAAWQ"}