smoltalk 0.6.0 → 0.7.0

package/dist/classes/message/UserMessage.d.ts

@@ -4,27 +4,88 @@ import { ChatCompletionMessageParam } from "openai/resources";
 import { Content } from "@google/genai";
 import { Message } from "ollama";
 import type { ResponseInputItem } from "openai/resources/responses/responses.js";
+import { UserContent, UserContentInput, UserContentPart } from "./contentParts.js";
 export declare const UserMessageJSONSchema: z.ZodObject<{
     role: z.ZodLiteral<"user">;
-    content: z.ZodString;
+    content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"bytes">;
+            data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+            mimeType: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"base64">;
+            base64: z.ZodString;
+            mimeType: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"path">;
+            path: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"url">;
+            url: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"providerFile">;
+            provider: z.ZodString;
+            id: z.ZodString;
+            uri: z.ZodOptional<z.ZodString>;
+            mimeType: z.ZodOptional<z.ZodString>;
+            expiresAt: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>], "kind">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"file">;
+        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"bytes">;
+            data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+            mimeType: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"base64">;
+            base64: z.ZodString;
+            mimeType: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"path">;
+            path: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"url">;
+            url: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"providerFile">;
+            provider: z.ZodString;
+            id: z.ZodString;
+            uri: z.ZodOptional<z.ZodString>;
+            mimeType: z.ZodOptional<z.ZodString>;
+            expiresAt: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>], "kind">;
+        filename: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">>]>;
     name: z.ZodOptional<z.ZodString>;
     rawData: z.ZodOptional<z.ZodAny>;
 }, z.core.$strip>;
 export type UserMessageJSON = z.infer<typeof UserMessageJSONSchema>;
 export declare class UserMessage extends BaseMessage implements MessageClass {
     _role: "user";
-    _content: string;
+    _content: UserContent;
     _name?: string;
     _rawData?: any;
-    constructor(content: string, options?: {
+    constructor(content: UserContentInput, options?: {
         name?: string;
         rawData?: any;
     });
     get content(): string;
-    set content(value: string);
+    set content(value: UserContentInput);
     get role(): "user";
     get name(): string | undefined;
     get rawData(): any;
+    /** The content parts array, or null when content is a plain string. */
+    getContentParts(): UserContentPart[] | null;
     toJSON(): UserMessageJSON;
     static fromJSON(json: unknown): UserMessage;
     toOpenAIMessage(): ChatCompletionMessageParam;
@@ -33,6 +94,6 @@ export declare class UserMessage extends BaseMessage implements MessageClass {
     toOllamaMessage(): Message;
     toAnthropicMessage(): {
         role: "user";
-        content: string;
+        content: string | any[];
     };
 }

package/dist/classes/message/UserMessage.js

@@ -1,9 +1,17 @@
 import { z } from "zod";
 import { BaseMessage } from "./BaseMessage.js";
 import { getLogger } from "../../util/logger.js";
+import { UserContentSchema, } from "./contentParts.js";
+import { refToBase64 } from "../../util/attachments.js";
+import { renderParts } from "./renderers/PartRenderer.js";
+import { OpenAIChatRenderer } from "./renderers/OpenAIChatRenderer.js";
+import { OpenAIResponsesRenderer } from "./renderers/OpenAIResponsesRenderer.js";
+import { GoogleRenderer } from "./renderers/GoogleRenderer.js";
+import { AnthropicRenderer } from "./renderers/AnthropicRenderer.js";
+import { JSONRenderer } from "./renderers/JSONRenderer.js";
 export const UserMessageJSONSchema = z.object({
     role: z.literal("user"),
-    content: z.string(),
+    content: UserContentSchema,
     name: z.string().optional(),
     rawData: z.any().optional(),
 });
@@ -14,15 +22,15 @@ export class UserMessage extends BaseMessage {
     _rawData;
     constructor(content, options = {}) {
         super();
-        this._content = content;
+        this._content = normalizeUserContent(content);
         this._name = options.name;
         this._rawData = options.rawData;
     }
     get content() {
-        return this._content;
+        return userContentToText(this._content);
     }
     set content(value) {
-        this._content = value;
+        this._content = normalizeUserContent(value);
     }
     get role() {
         return this._role;
@@ -33,10 +41,17 @@ export class UserMessage extends BaseMessage {
     get rawData() {
         return this._rawData;
     }
+    /** The content parts array, or null when content is a plain string. */
+    getContentParts() {
+        if (typeof this._content === "string") {
+            return null;
+        }
+        return this._content;
+    }
     toJSON() {
         return {
             role: this.role,
-            content: this.content,
+            content: serializeUserContentForJSON(this._content),
             name: this.name,
         };
     }
@@ -55,29 +70,93 @@ export class UserMessage extends BaseMessage {
         });
     }
     toOpenAIMessage() {
-        return {
-            role: this.role,
-            content: this.content,
-            name: this.name,
-        };
+        if (typeof this._content === "string") {
+            return { role: this.role, content: this._content, name: this.name };
+        }
+        const parts = renderParts(this._content, new OpenAIChatRenderer());
+        return { role: this.role, content: parts, name: this.name };
     }
     toOpenAIResponseInputItem() {
-        return {
-            type: "message",
-            role: "user",
-            content: this.content,
-        };
+        if (typeof this._content === "string") {
+            return { type: "message", role: "user", content: this._content };
+        }
+        const content = renderParts(this._content, new OpenAIResponsesRenderer());
+        return { type: "message", role: "user", content };
     }
     toGoogleMessage() {
-        return { role: this.role, parts: [{ text: this.content }] };
+        if (typeof this._content === "string") {
+            return { role: this.role, parts: [{ text: this._content }] };
+        }
+        const parts = renderParts(this._content, new GoogleRenderer());
+        return { role: this.role, parts };
     }
     toOllamaMessage() {
-        return {
-            role: this.role,
-            content: this.content,
-        };
+        if (typeof this._content === "string") {
+            return { role: this.role, content: this._content };
+        }
+        const texts = [];
+        const images = [];
+        for (const part of this._content) {
+            if (part.type === "text") {
+                texts.push(part.text);
+                continue;
+            }
+            if (part.type === "image") {
+                if (part.source.kind === "providerFile") {
+                    throw new Error("Ollama does not support provider file references.");
+                }
+                images.push(refToBase64(part.source).base64);
+                continue;
+            }
+            if (part.source.kind === "providerFile") {
+                throw new Error("Ollama does not support provider file references.");
+            }
+            getLogger().warn("Ollama does not support file attachments; dropping a file part.");
+        }
+        const message = { role: this.role, content: texts.join("\n") };
+        if (images.length > 0) {
+            message.images = images;
+        }
+        return message;
     }
     toAnthropicMessage() {
-        return { role: "user", content: this.content };
+        if (typeof this._content === "string") {
+            return { role: "user", content: this._content };
+        }
+        const blocks = renderParts(this._content, new AnthropicRenderer());
+        return { role: "user", content: blocks };
+    }
+}
+function normalizeUserContent(content) {
+    if (typeof content === "string") {
+        return content;
+    }
+    const parts = [];
+    for (const part of content) {
+        if (typeof part === "string") {
+            parts.push({ type: "text", text: part });
+        }
+        else {
+            parts.push(part);
+        }
+    }
+    return parts;
+}
+function userContentToText(content) {
+    if (typeof content === "string") {
+        return content;
+    }
+    const texts = [];
+    for (const part of content) {
+        if (part.type === "text") {
+            texts.push(part.text);
+        }
+    }
+    return texts.join("\n");
+}
+function serializeUserContentForJSON(content) {
+    if (typeof content === "string") {
+        return content;
     }
+    return renderParts(content, new JSONRenderer());
 }

package/dist/classes/message/contentParts.d.ts

@@ -0,0 +1,259 @@
+import { z } from "zod";
+import type { ImageRef } from "../../util/imageRef.js";
+export type TextPart = {
+    type: "text";
+    text: string;
+};
+export type ImagePart = {
+    type: "image";
+    source: AttachmentSource;
+};
+export type FilePart = {
+    type: "file";
+    source: AttachmentSource;
+    filename?: string;
+};
+export type UserContentPart = TextPart | ImagePart | FilePart;
+/** Normalized user-message content: a plain string or an array of typed parts. */
+export type UserContent = string | UserContentPart[];
+/** What callers may pass: a bare string element is sugar for a text part. */
+export type UserContentInput = string | Array<string | UserContentPart>;
+export declare const TextPartSchema: z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, z.core.$strip>;
+export declare const ImageRefSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"bytes">;
+    data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+    mimeType: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"base64">;
+    base64: z.ZodString;
+    mimeType: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"path">;
+    path: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"url">;
+    url: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>], "kind">;
+export type ProviderFileRef = {
+    kind: "providerFile";
+    provider: string;
+    id: string;
+    uri?: string;
+    mimeType?: string;
+    expiresAt?: number;
+};
+export declare const ProviderFileRefSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"providerFile">;
+    provider: z.ZodString;
+    id: z.ZodString;
+    uri: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type AttachmentSource = ImageRef | ProviderFileRef;
+export declare const AttachmentSourceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"bytes">;
+    data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+    mimeType: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"base64">;
+    base64: z.ZodString;
+    mimeType: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"path">;
+    path: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"url">;
+    url: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"providerFile">;
+    provider: z.ZodString;
+    id: z.ZodString;
+    uri: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>], "kind">;
+export declare const ImagePartSchema: z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"bytes">;
+        data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+        mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"base64">;
+        base64: z.ZodString;
+        mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        path: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"providerFile">;
+        provider: z.ZodString;
+        id: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        expiresAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>;
+export declare const FilePartSchema: z.ZodObject<{
+    type: z.ZodLiteral<"file">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"bytes">;
+        data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+        mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"base64">;
+        base64: z.ZodString;
+        mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        path: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"providerFile">;
+        provider: z.ZodString;
+        id: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        expiresAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>], "kind">;
+    filename: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const UserContentPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"bytes">;
+        data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+        mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"base64">;
+        base64: z.ZodString;
+        mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        path: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"providerFile">;
+        provider: z.ZodString;
+        id: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        expiresAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"file">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"bytes">;
+        data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+        mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"base64">;
+        base64: z.ZodString;
+        mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        path: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"providerFile">;
+        provider: z.ZodString;
+        id: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        expiresAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>], "kind">;
+    filename: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export declare const UserContentSchema: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"bytes">;
+        data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+        mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"base64">;
+        base64: z.ZodString;
+        mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        path: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"providerFile">;
+        provider: z.ZodString;
+        id: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        expiresAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"file">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"bytes">;
+        data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+        mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"base64">;
+        base64: z.ZodString;
+        mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        path: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"providerFile">;
+        provider: z.ZodString;
+        id: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        expiresAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>], "kind">;
+    filename: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">>]>;

package/dist/classes/message/contentParts.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+export const TextPartSchema = z.object({
+    type: z.literal("text"),
+    text: z.string(),
+});
+export const ImageRefSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("bytes"), data: z.instanceof(Uint8Array), mimeType: z.string() }),
+    z.object({ kind: z.literal("base64"), base64: z.string(), mimeType: z.string() }),
+    z.object({ kind: z.literal("path"), path: z.string(), mimeType: z.string().optional() }),
+    z.object({
+        kind: z.literal("url"),
+        url: z.string(),
+        mimeType: z.string().optional(),
+        timeoutMs: z.number().optional(),
+    }),
+]);
+export const ProviderFileRefSchema = z.object({
+    kind: z.literal("providerFile"),
+    provider: z.string(),
+    id: z.string(),
+    uri: z.string().optional(),
+    mimeType: z.string().optional(),
+    expiresAt: z.number().optional(),
+});
+// Compose from ImageRefSchema so future arms don't need mirroring here.
+export const AttachmentSourceSchema = z.discriminatedUnion("kind", [
+    ...ImageRefSchema.options,
+    ProviderFileRefSchema,
+]);
+export const ImagePartSchema = z.object({
+    type: z.literal("image"),
+    source: AttachmentSourceSchema,
+});
+export const FilePartSchema = z.object({
+    type: z.literal("file"),
+    source: AttachmentSourceSchema,
+    filename: z.string().optional(),
+});
+export const UserContentPartSchema = z.discriminatedUnion("type", [
+    TextPartSchema,
+    ImagePartSchema,
+    FilePartSchema,
+]);
+export const UserContentSchema = z.union([z.string(), z.array(UserContentPartSchema)]);

package/dist/classes/message/index.d.ts

@@ -8,7 +8,8 @@ import type { AssistantMessageJSON } from "./AssistantMessage.js";
 import type { DeveloperMessageJSON } from "./DeveloperMessage.js";
 import type { SystemMessageJSON } from "./SystemMessage.js";
 import type { ToolMessageJSON } from "./ToolMessage.js";
-import { CostEstimate, TextPart, TokenUsage } from "../../types.js";
+import { CostEstimate, TextPart, TokenUsage, UserContentInput, ImagePart, FilePart } from "../../types.js";
+import type { ImageRef } from "../../util/imageRef.js";
 export * from "./AssistantMessage.js";
 export * from "./BaseMessage.js";
 export * from "./DeveloperMessage.js";
@@ -16,10 +17,15 @@ export * from "./SystemMessage.js";
 export * from "./ToolMessage.js";
 export * from "./UserMessage.js";
 export declare function messageFromJSON(json: MessageJSON): Message;
-export declare function userMessage(content: string, options?: {
+export declare function userMessage(content: UserContentInput, options?: {
     name?: string;
     rawData?: any;
 }): UserMessage;
+export declare function textPart(text: string): TextPart;
+export declare function imagePart(source: ImageRef): ImagePart;
+export declare function filePart(source: ImageRef, options?: {
+    filename?: string;
+}): FilePart;
 export declare function assistantMessage(content: string | Array<TextPart> | null, options?: {
     name?: string;
     audio?: any | null;

package/dist/classes/message/index.js

@@ -28,6 +28,18 @@ export function messageFromJSON(json) {
 export function userMessage(content, options = {}) {
     return new UserMessage(content, options);
 }
+export function textPart(text) {
+    return { type: "text", text };
+}
+export function imagePart(source) {
+    return { type: "image", source };
+}
+export function filePart(source, options = {}) {
+    if (options.filename === undefined) {
+        return { type: "file", source };
+    }
+    return { type: "file", source, filename: options.filename };
+}
 export function assistantMessage(content, options = {}) {
     return new AssistantMessage(content, options);
 }

package/dist/classes/message/renderers/AnthropicRenderer.d.ts

@@ -0,0 +1,43 @@
+import type { PartRenderer } from "./PartRenderer.js";
+import type { TextPart, ImagePart, FilePart } from "../contentParts.js";
+/** Renders parts for the Anthropic Messages API. */
+export declare class AnthropicRenderer implements PartRenderer<any> {
+    text(part: TextPart): {
+        type: string;
+        text: string;
+    };
+    image(part: ImagePart): {
+        type: string;
+        source: {
+            type: string;
+            file_id: string;
+        };
+    } | {
+        type: string;
+        source: {
+            type: "url";
+            url: string;
+        } | {
+            type: "base64";
+            media_type: string;
+            data: string;
+        };
+    };
+    file(part: FilePart): {
+        type: string;
+        source: {
+            type: string;
+            file_id: string;
+        };
+    } | {
+        type: string;
+        source: {
+            type: "url";
+            url: string;
+        } | {
+            type: "base64";
+            media_type: string;
+            data: string;
+        };
+    };
+}

package/dist/classes/message/renderers/AnthropicRenderer.js

@@ -0,0 +1,19 @@
+import { anthropicSource } from "../../../util/attachments.js";
+/** Renders parts for the Anthropic Messages API. */
+export class AnthropicRenderer {
+    text(part) {
+        return { type: "text", text: part.text };
+    }
+    image(part) {
+        if (part.source.kind === "providerFile") {
+            return { type: "image", source: { type: "file", file_id: part.source.id } };
+        }
+        return { type: "image", source: anthropicSource(part.source) };
+    }
+    file(part) {
+        if (part.source.kind === "providerFile") {
+            return { type: "document", source: { type: "file", file_id: part.source.id } };
+        }
+        return { type: "document", source: anthropicSource(part.source) };
+    }
+}