@particle-academy/prism 0.0.0

package/dist/value-objects/media/media.js

@@ -0,0 +1,267 @@
+import { readFileSync } from 'node:fs';
+import { extname } from 'node:path';
+import { PrismError } from '../../errors.js';
+/**
+ * A binary payload, however it was given to us.
+ *
+ * One type behind five ways of naming the same bytes — a url, a base64 string,
+ * a local file, raw content, or a provider-side file id. Subclasses add nothing
+ * but a name; `Image` and `Audio` differ in what a provider does with them, not
+ * in what they are.
+ *
+ * The alternative was three standalone classes each restating url / base64 /
+ * mimeType, which is how a package ends up with three subtly different answers
+ * to "is this a file". `GeneratedImage` was the first of those and is now
+ * `Image`'s sibling under this base.
+ *
+ * TWO DELIBERATE DIVERGENCES FROM THE REFERENCE, both recorded in the port gaps
+ * register:
+ *
+ *  - `fromStoragePath` is absent. It resolves through Laravel's filesystem, and
+ *    there is no equivalent here to resolve through.
+ *  - A url is NEVER fetched implicitly. The reference reads url content on
+ *    demand inside `rawContent()`, so touching a property performs an outbound
+ *    request; here `fetch()` is explicit and separate. A value object that
+ *    reaches the network when you read it turns a stored locator into a request
+ *    at replay time, which is the exact hazard prism-harness documents about
+ *    replaying threads.
+ */
+export class Media {
+    url;
+    #base64;
+    #mimeType;
+    #rawContent = null;
+    #localPath = null;
+    #fileId = null;
+    #filename = null;
+    constructor(url = null, base64 = null, mimeType = null) {
+        this.url = url;
+        this.#base64 = base64;
+        this.#mimeType = mimeType;
+    }
+    static fromFileId(fileId) {
+        const media = new this();
+        media.setFileId(fileId);
+        return media;
+    }
+    static fromUrl(url, mimeType = null) {
+        const media = new this(url);
+        if (mimeType !== null) {
+            media.setMimeType(mimeType);
+        }
+        return media;
+    }
+    static fromBase64(base64, mimeType = null) {
+        return new this(null, base64, mimeType);
+    }
+    static fromRawContent(content, mimeType = null) {
+        const media = new this();
+        media.setRawContent(content, mimeType);
+        return media;
+    }
+    /**
+     * Read a file from disk.
+     *
+     * Refuses an EMPTY file, matching the reference. A zero-byte upload is almost
+     * always a mistake upstream, and a provider's error for it is far less useful
+     * than one naming the path.
+     */
+    static fromLocalPath(path, mimeType = null) {
+        let content;
+        try {
+            // Same reason as base64 decoding: a plain Uint8Array, not a Buffer.
+            content = Uint8Array.from(readFileSync(path));
+        }
+        catch (cause) {
+            throw PrismError.unreadableMediaFile(path, cause);
+        }
+        if (content.byteLength === 0) {
+            throw PrismError.unreadableMediaFile(path, new Error('the file is empty'));
+        }
+        const media = new this();
+        media.setRawContent(content, mimeType ?? guessMimeType(path));
+        media.setLocalPath(path);
+        return media;
+    }
+    /** Alias, matching the reference's spelling. */
+    static fromPath(path) {
+        return this.fromLocalPath.call(this, path);
+    }
+    /** Name this payload for a provider that wants a filename. */
+    as(name) {
+        this.#filename = name;
+        return this;
+    }
+    filename() {
+        return this.#filename;
+    }
+    fileId() {
+        return this.#fileId;
+    }
+    localPath() {
+        return this.#localPath;
+    }
+    isFileId() {
+        return this.#fileId !== null;
+    }
+    isFile() {
+        return this.#localPath !== null;
+    }
+    isUrl() {
+        return this.url !== null;
+    }
+    hasBase64() {
+        return this.#base64 !== null || this.#rawContent !== null;
+    }
+    hasMimeType() {
+        return this.#mimeType !== null;
+    }
+    hasRawContent() {
+        return this.#rawContent !== null;
+    }
+    mimeType() {
+        return this.#mimeType;
+    }
+    rawContent() {
+        if (this.#rawContent !== null) {
+            return this.#rawContent;
+        }
+        if (this.#base64 !== null) {
+            // Copied into a plain Uint8Array rather than handed out as a Buffer.
+            // Buffer is a Uint8Array subclass, so returning one satisfies the type
+            // while leaking a Node-specific value that serialises differently — it
+            // JSON-encodes as `{type:'Buffer',data:[…]}`, which is not what a caller
+            // reading a `Uint8Array` expects to persist.
+            return Uint8Array.from(Buffer.from(this.#base64, 'base64'));
+        }
+        // A url is NOT fetched here. See the class docblock.
+        return null;
+    }
+    /**
+     * The payload as base64, or null when only a url or file id is known.
+     *
+     * Computed once and kept, because encoding a large file on every access is a
+     * cost a caller cannot see.
+     */
+    base64() {
+        if (this.#base64 !== null) {
+            return this.#base64;
+        }
+        if (this.#rawContent === null) {
+            return null;
+        }
+        this.#base64 = Buffer.from(this.#rawContent).toString('base64');
+        return this.#base64;
+    }
+    /**
+     * Fetch a url's bytes into this payload. EXPLICIT, never automatic.
+     *
+     * Separate from `rawContent()` so that reading a property never performs an
+     * outbound request — a stored locator becoming a request the moment something
+     * replays it is the hazard, not the fetch itself.
+     */
+    async fetch() {
+        if (this.url === null) {
+            throw PrismError.unfetchableMedia('this payload has no url');
+        }
+        const response = await globalThis.fetch(this.url);
+        if (!response.ok) {
+            throw PrismError.unfetchableMedia(`${this.url} responded ${response.status}`);
+        }
+        this.setRawContent(new Uint8Array(await response.arrayBuffer()), this.#mimeType ?? response.headers.get('content-type'));
+        return this;
+    }
+    /**
+     * The serialized form.
+     *
+     * `base64()`, not the base64 FIELD: a payload built from raw content or from
+     * a local file has bytes and an empty `#base64` until something asks for it,
+     * so reading the field would serialize a full image as `base64: null` and the
+     * round trip would silently return an empty one. Encoding here costs one pass
+     * over bytes the caller has already decided to persist.
+     */
+    toObject() {
+        return {
+            kind: this.kind,
+            url: this.url,
+            base64: this.base64(),
+            mime_type: this.#mimeType,
+            file_id: this.#fileId,
+            filename: this.#filename,
+        };
+    }
+    /**
+     * Put a serialized payload's fields back on a fresh instance.
+     *
+     * Protected and static so each subclass's own `fromObject` can call it
+     * without every one of them restating the five keys — and without the
+     * setters becoming public, which would make a value object mutable from
+     * anywhere for the sake of one code path.
+     *
+     * The local path is NOT restored: it names a file on the machine that
+     * serialized this, and a path that resolves to a different file elsewhere is
+     * worse than no path at all. The bytes travel as base64 instead.
+     */
+    static restoreInto(media, object) {
+        if (typeof object.file_id === 'string') {
+            media.setFileId(object.file_id);
+        }
+        if (typeof object.filename === 'string') {
+            media.as(object.filename);
+        }
+        return media;
+    }
+    /** The url, base64 and mime type a serialized payload carries, as constructor arguments. */
+    static constructorArgs(object) {
+        return [
+            typeof object.url === 'string' ? object.url : null,
+            typeof object.base64 === 'string' ? object.base64 : null,
+            typeof object.mime_type === 'string' ? object.mime_type : null,
+        ];
+    }
+    setRawContent(content, mimeType) {
+        this.#rawContent = content;
+        if (mimeType !== null) {
+            this.#mimeType = mimeType;
+        }
+    }
+    setMimeType(mimeType) {
+        this.#mimeType = mimeType;
+    }
+    setLocalPath(path) {
+        this.#localPath = path;
+    }
+    setFileId(fileId) {
+        this.#fileId = fileId;
+    }
+}
+/**
+ * Mime type from the file extension.
+ *
+ * The reference sniffs the CONTENT with finfo. Node has no equivalent without a
+ * dependency, and this package takes none — so the extension is the guess, and
+ * an unknown one returns null rather than a plausible default. `application/
+ * octet-stream` would be accepted by a provider and then rejected as the wrong
+ * kind of file, which is a worse failure than being asked for the type.
+ */
+const MIME_TYPES = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.pdf': 'application/pdf',
+    '.txt': 'text/plain',
+    '.md': 'text/markdown',
+    '.mp3': 'audio/mpeg',
+    '.mp4': 'video/mp4',
+    '.wav': 'audio/wav',
+    '.webm': 'audio/webm',
+    '.ogg': 'audio/ogg',
+    '.flac': 'audio/flac',
+    '.m4a': 'audio/mp4',
+};
+export function guessMimeType(path) {
+    return MIME_TYPES[extname(path).toLowerCase()] ?? null;
+}
+//# sourceMappingURL=media.js.map

package/dist/value-objects/media/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../../src/value-objects/media/media.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAK7C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAgB,KAAK;IA4Bd;IAbX,OAAO,CAAgB;IAEvB,SAAS,CAAgB;IAEzB,WAAW,GAAsB,IAAI,CAAC;IAEtC,UAAU,GAAkB,IAAI,CAAC;IAEjC,OAAO,GAAkB,IAAI,CAAC;IAE9B,SAAS,GAAkB,IAAI,CAAC;IAEhC,YACW,MAAqB,IAAI,EAClC,SAAwB,IAAI,EAC5B,WAA0B,IAAI;QAFrB,QAAG,GAAH,GAAG,CAAsB;QAIlC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,UAAU,CAAqC,MAAc;QAClE,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;QACzB,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAExB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,OAAO,CAAwD,GAAW,EAAE,WAA0B,IAAI;QAC/G,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;QAE5B,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,UAAU,CAEf,MAAc,EACd,WAA0B,IAAI;QAE9B,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,cAAc,CAAqC,OAAmB,EAAE,WAA0B,IAAI;QAC3G,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;QACzB,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAqC,IAAY,EAAE,WAA0B,IAAI;QACnG,IAAI,OAAmB,CAAC;QAExB,IAAI,CAAC;YACH,oEAAoE;YACpE,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,OAAO,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,UAAU,CAAC,mBAAmB,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;QACzB,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAEzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gDAAgD;IAChD,MAAM,CAAC,QAAQ,CAAqC,IAAY;QAC9D,OAAQ,IAAgC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAM,CAAC;IAC/E,CAAC;IAED,8DAA8D;IAC9D,EAAE,CAAC,IAAY;QACb,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;IAC/B,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC;IAClC,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC;IAC3B,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC;IAC5D,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;IACjC,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC;IACnC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,UAAU;QACR,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1B,qEAAqE;YACrE,uEAAuE;YACvE,uEAAuE;YACvE,yEAAyE;YACzE,6CAA6C;YAC7C,OAAO,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9D,CAAC;QAED,qDAAqD;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,MAAM;QACJ,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEhE,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,UAAU,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAElD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,UAAU,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,GAAG,cAAc,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,IAAI,CAAC,aAAa,CAChB,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,EAC5C,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CACvD,CAAC;QAEF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ;QACN,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,SAAS;SACzB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACO,MAAM,CAAC,WAAW,CAAkB,KAAQ,EAAE,MAAkB;QACxE,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACvC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACxC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,4FAA4F;IAClF,MAAM,CAAC,eAAe,CAAC,MAAkB;QACjD,OAAO;YACL,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;YAClD,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;YACxD,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;SAC/D,CAAC;IACJ,CAAC;IAES,aAAa,CAAC,OAAmB,EAAE,QAAuB;QAClE,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;QAE3B,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC5B,CAAC;IACH,CAAC;IAES,WAAW,CAAC,QAAgB;QACpC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAES,YAAY,CAAC,IAAY;QACjC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAES,SAAS,CAAC,MAAc;QAChC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,GAAqC;IACnD,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,eAAe;IACtB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;AACzD,CAAC"}

package/dist/value-objects/media/part.d.ts

@@ -0,0 +1,25 @@
+import type { JsonObject } from '../../json.js';
+import type { Media } from './media.js';
+import { Text } from './text.js';
+/**
+ * One part of a user turn: text, or a payload.
+ *
+ * `Media` rather than the four subclasses by name, so a payload type added
+ * later is a part without this union having to be edited to allow it.
+ */
+export type MessagePart = Text | Media;
+/**
+ * Rebuild a part from its serialized form.
+ *
+ * NO `kind` MEANS TEXT. That is the specified form rather than a tolerated one:
+ * a text part serializes as `{ text }` in this port, in `prism-py` and in the
+ * PHP reference alike, pinned by the conformance corpus — see {@link Text}. So
+ * every user message any consumer has already stored reads back unchanged, and
+ * a discriminator is only ever needed to tell the payload kinds apart from each
+ * other, which is the one thing their keys cannot do (an image, an audio file
+ * and a video serialize identically).
+ *
+ * @throws PrismError code `unknown_message_type`
+ */
+export declare function partFromObject(object: JsonObject): MessagePart;
+//# sourceMappingURL=part.d.ts.map

package/dist/value-objects/media/part.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"part.d.ts","sourceRoot":"","sources":["../../../src/value-objects/media/part.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAKhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,KAAK,CAAC;AAEvC;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAqB9D"}

package/dist/value-objects/media/part.js

@@ -0,0 +1,41 @@
+import { PrismError } from '../../errors.js';
+import { Audio } from './audio.js';
+import { Document } from './document.js';
+import { Image } from './image.js';
+import { Text } from './text.js';
+import { Video } from './video.js';
+/**
+ * Rebuild a part from its serialized form.
+ *
+ * NO `kind` MEANS TEXT. That is the specified form rather than a tolerated one:
+ * a text part serializes as `{ text }` in this port, in `prism-py` and in the
+ * PHP reference alike, pinned by the conformance corpus — see {@link Text}. So
+ * every user message any consumer has already stored reads back unchanged, and
+ * a discriminator is only ever needed to tell the payload kinds apart from each
+ * other, which is the one thing their keys cannot do (an image, an audio file
+ * and a video serialize identically).
+ *
+ * @throws PrismError code `unknown_message_type`
+ */
+export function partFromObject(object) {
+    switch (object.kind) {
+        case 'text':
+            return Text.fromObject(object);
+        case 'image':
+            return Image.fromObject(object);
+        case 'document':
+            return Document.fromObject(object);
+        case 'audio':
+            return Audio.fromObject(object);
+        case 'video':
+            return Video.fromObject(object);
+        case undefined:
+            if (typeof object.text === 'string') {
+                return Text.fromObject(object);
+            }
+            throw PrismError.unknownMessageType(`media part ${JSON.stringify(object)} (no \`kind\`, and no text to fall back to)`);
+        default:
+            throw PrismError.unknownMessageType(`media part of kind ${JSON.stringify(object.kind)}`);
+    }
+}
+//# sourceMappingURL=part.js.map

package/dist/value-objects/media/part.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"part.js","sourceRoot":"","sources":["../../../src/value-objects/media/part.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAUnC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAClC,KAAK,UAAU;YACb,OAAO,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACrC,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAClC,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAClC,KAAK,SAAS;YACZ,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpC,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACjC,CAAC;YAED,MAAM,UAAU,CAAC,kBAAkB,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,6CAA6C,CAAC,CAAC;QACzH;YACE,MAAM,UAAU,CAAC,kBAAkB,CAAC,sBAAsB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC"}

package/dist/value-objects/media/text.d.ts

@@ -0,0 +1,24 @@
+import type { JsonObject } from '../../json.js';
+/**
+ * A plain-text part of a user message.
+ *
+ * SERIALIZES AS `{ text }` AND NOTHING ELSE — no `kind` discriminator, unlike
+ * every other part. That asymmetry is deliberate and load-bearing: the
+ * conformance corpus pins this exact form (`rtp-0001`, and every row of
+ * `openai-text-response`), and the PHP reference emits it too, so a text part
+ * is one of the few places all three implementations are byte-identical.
+ * Adding a key for symmetry would take both ports out of parity with the
+ * reference on the only part type the reference can currently produce, and
+ * would make every message a consumer has already stored unreadable.
+ *
+ * A part carrying no `kind` therefore MEANS text, which is what
+ * {@link partFromObject} relies on.
+ */
+export declare class Text {
+    readonly text: string;
+    readonly kind: "text";
+    constructor(text: string);
+    toObject(): JsonObject;
+    static fromObject(object: JsonObject): Text;
+}
+//# sourceMappingURL=text.d.ts.map

package/dist/value-objects/media/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/value-objects/media/text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,IAAI;IAGH,QAAQ,CAAC,IAAI,EAAE,MAAM;IAFjC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;gBAEX,IAAI,EAAE,MAAM;IAEjC,QAAQ,IAAI,UAAU;IAItB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;CAO5C"}

package/dist/value-objects/media/text.js

@@ -0,0 +1,33 @@
+import { PrismError } from '../../errors.js';
+/**
+ * A plain-text part of a user message.
+ *
+ * SERIALIZES AS `{ text }` AND NOTHING ELSE — no `kind` discriminator, unlike
+ * every other part. That asymmetry is deliberate and load-bearing: the
+ * conformance corpus pins this exact form (`rtp-0001`, and every row of
+ * `openai-text-response`), and the PHP reference emits it too, so a text part
+ * is one of the few places all three implementations are byte-identical.
+ * Adding a key for symmetry would take both ports out of parity with the
+ * reference on the only part type the reference can currently produce, and
+ * would make every message a consumer has already stored unreadable.
+ *
+ * A part carrying no `kind` therefore MEANS text, which is what
+ * {@link partFromObject} relies on.
+ */
+export class Text {
+    text;
+    kind = 'text';
+    constructor(text) {
+        this.text = text;
+    }
+    toObject() {
+        return { text: this.text };
+    }
+    static fromObject(object) {
+        if (typeof object.text !== 'string') {
+            throw PrismError.unknownMessageType(`media part ${JSON.stringify(object)} (a text part needs a string \`text\`)`);
+        }
+        return new Text(object.text);
+    }
+}
+//# sourceMappingURL=text.js.map

package/dist/value-objects/media/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/value-objects/media/text.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,IAAI;IAGM;IAFZ,IAAI,GAAG,MAAe,CAAC;IAEhC,YAAqB,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAErC,QAAQ;QACN,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAkB;QAClC,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,UAAU,CAAC,kBAAkB,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,wCAAwC,CAAC,CAAC;QACpH,CAAC;QAED,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/value-objects/media/video.d.ts

@@ -0,0 +1,7 @@
+import type { JsonObject } from '../../json.js';
+import { Media } from './media.js';
+export declare class Video extends Media {
+    readonly kind: "video";
+    static fromObject(object: JsonObject): Video;
+}
+//# sourceMappingURL=video.d.ts.map

package/dist/value-objects/media/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../../../src/value-objects/media/video.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,qBAAa,KAAM,SAAQ,KAAK;IAC9B,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAEjC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK;CAG7C"}

package/dist/value-objects/media/video.js

@@ -0,0 +1,8 @@
+import { Media } from './media.js';
+export class Video extends Media {
+    kind = 'video';
+    static fromObject(object) {
+        return Video.restoreInto(new Video(...Video.constructorArgs(object)), object);
+    }
+}
+//# sourceMappingURL=video.js.map

package/dist/value-objects/media/video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../../../src/value-objects/media/video.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,OAAO,KAAM,SAAQ,KAAK;IACrB,IAAI,GAAG,OAAgB,CAAC;IAEjC,MAAM,CAAC,UAAU,CAAC,MAAkB;QAClC,OAAO,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAChF,CAAC;CACF"}

package/dist/value-objects/messages/assistant-message.d.ts

@@ -0,0 +1,26 @@
+import type { JsonObject } from '../../json.js';
+import { ToolCall } from '../tool-call.js';
+export declare class AssistantMessage {
+    readonly content: string;
+    readonly toolCalls: readonly ToolCall[];
+    readonly additionalContent: Readonly<JsonObject>;
+    /**
+     * Approval requests are carried verbatim rather than modelled: the approval
+     * feature is not part of this port, but dropping the key would change what
+     * `toObject()` emits relative to the reference, so it round-trips as raw
+     * JSON instead.
+     */
+    readonly toolApprovalRequests: readonly JsonObject[];
+    readonly type: "assistant";
+    constructor(content: string, toolCalls?: readonly ToolCall[], additionalContent?: Readonly<JsonObject>, 
+    /**
+     * Approval requests are carried verbatim rather than modelled: the approval
+     * feature is not part of this port, but dropping the key would change what
+     * `toObject()` emits relative to the reference, so it round-trips as raw
+     * JSON instead.
+     */
+    toolApprovalRequests?: readonly JsonObject[]);
+    toObject(): JsonObject;
+    static fromObject(object: JsonObject): AssistantMessage;
+}
+//# sourceMappingURL=assistant-message.d.ts.map

package/dist/value-objects/messages/assistant-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-message.d.ts","sourceRoot":"","sources":["../../../src/value-objects/messages/assistant-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,qBAAa,gBAAgB;IAIzB,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE;IACvC,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,UAAU,CAAC;IAChD;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,EAAE,SAAS,UAAU,EAAE;IAZtD,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;gBAG1B,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,SAAS,QAAQ,EAAO,EACnC,iBAAiB,GAAE,QAAQ,CAAC,UAAU,CAAM;IACrD;;;;;OAKG;IACM,oBAAoB,GAAE,SAAS,UAAU,EAAO;IAG3D,QAAQ,IAAI,UAAU;IAUtB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB;CAUxD"}

package/dist/value-objects/messages/assistant-message.js

@@ -0,0 +1,37 @@
+import { isJsonObject } from '../../json.js';
+import { ToolCall } from '../tool-call.js';
+export class AssistantMessage {
+    content;
+    toolCalls;
+    additionalContent;
+    toolApprovalRequests;
+    type = 'assistant';
+    constructor(content, toolCalls = [], additionalContent = {}, 
+    /**
+     * Approval requests are carried verbatim rather than modelled: the approval
+     * feature is not part of this port, but dropping the key would change what
+     * `toObject()` emits relative to the reference, so it round-trips as raw
+     * JSON instead.
+     */
+    toolApprovalRequests = []) {
+        this.content = content;
+        this.toolCalls = toolCalls;
+        this.additionalContent = additionalContent;
+        this.toolApprovalRequests = toolApprovalRequests;
+    }
+    toObject() {
+        return {
+            type: 'assistant',
+            content: this.content,
+            tool_calls: this.toolCalls.map((toolCall) => toolCall.toObject()),
+            additional_content: { ...this.additionalContent },
+            tool_approval_requests: this.toolApprovalRequests.map((request) => ({ ...request })),
+        };
+    }
+    static fromObject(object) {
+        return new AssistantMessage(typeof object.content === 'string' ? object.content : '', (Array.isArray(object.tool_calls) ? object.tool_calls : [])
+            .filter(isJsonObject)
+            .map((toolCall) => ToolCall.fromObject(toolCall)), isJsonObject(object.additional_content) ? object.additional_content : {}, (Array.isArray(object.tool_approval_requests) ? object.tool_approval_requests : []).filter(isJsonObject));
+    }
+}
+//# sourceMappingURL=assistant-message.js.map

package/dist/value-objects/messages/assistant-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-message.js","sourceRoot":"","sources":["../../../src/value-objects/messages/assistant-message.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,OAAO,gBAAgB;IAIhB;IACA;IACA;IAOA;IAZF,IAAI,GAAG,WAAoB,CAAC;IAErC,YACW,OAAe,EACf,YAAiC,EAAE,EACnC,oBAA0C,EAAE;IACrD;;;;;OAKG;IACM,uBAA8C,EAAE;QAThD,YAAO,GAAP,OAAO,CAAQ;QACf,cAAS,GAAT,SAAS,CAA0B;QACnC,sBAAiB,GAAjB,iBAAiB,CAA2B;QAO5C,yBAAoB,GAApB,oBAAoB,CAA4B;IACxD,CAAC;IAEJ,QAAQ;QACN,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACjE,kBAAkB,EAAE,EAAE,GAAG,IAAI,CAAC,iBAAiB,EAAE;YACjD,sBAAsB,EAAE,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;SACrF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAkB;QAClC,OAAO,IAAI,gBAAgB,CACzB,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EACxD,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;aACxD,MAAM,CAAC,YAAY,CAAC;aACpB,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,EACnD,YAAY,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,EACxE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CACzG,CAAC;IACJ,CAAC;CACF"}

package/dist/value-objects/messages/index.d.ts

@@ -0,0 +1,27 @@
+import type { JsonObject } from '../../json.js';
+import { AssistantMessage } from './assistant-message.js';
+import { SystemMessage } from './system-message.js';
+import { ToolResultMessage } from './tool-result-message.js';
+import { UserMessage } from './user-message.js';
+export { AssistantMessage } from './assistant-message.js';
+export { SystemMessage } from './system-message.js';
+export { ToolResultMessage } from './tool-result-message.js';
+export { UserMessage } from './user-message.js';
+/**
+ * The message union, discriminated on `type`.
+ *
+ * `type` is the same string each message's `toObject()` emits, so the
+ * discriminant and the serialized form cannot drift apart.
+ */
+export type Message = UserMessage | AssistantMessage | SystemMessage | ToolResultMessage;
+export type MessageType = Message['type'];
+/**
+ * Rebuild a message from its serialized form.
+ *
+ * The reference package has `toArray()` and no counterpart, which left every
+ * consumer to invent its own. This is the counterpart.
+ *
+ * @throws PrismError code `unknown_message_type`
+ */
+export declare function messageFromObject(object: JsonObject): Message;
+//# sourceMappingURL=index.d.ts.map

package/dist/value-objects/messages/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/value-objects/messages/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,gBAAgB,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAEzF,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE1C;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAa7D"}

package/dist/value-objects/messages/index.js

@@ -0,0 +1,32 @@
+import { PrismError } from '../../errors.js';
+import { AssistantMessage } from './assistant-message.js';
+import { SystemMessage } from './system-message.js';
+import { ToolResultMessage } from './tool-result-message.js';
+import { UserMessage } from './user-message.js';
+export { AssistantMessage } from './assistant-message.js';
+export { SystemMessage } from './system-message.js';
+export { ToolResultMessage } from './tool-result-message.js';
+export { UserMessage } from './user-message.js';
+/**
+ * Rebuild a message from its serialized form.
+ *
+ * The reference package has `toArray()` and no counterpart, which left every
+ * consumer to invent its own. This is the counterpart.
+ *
+ * @throws PrismError code `unknown_message_type`
+ */
+export function messageFromObject(object) {
+    switch (object.type) {
+        case 'user':
+            return UserMessage.fromObject(object);
+        case 'assistant':
+            return AssistantMessage.fromObject(object);
+        case 'system':
+            return SystemMessage.fromObject(object);
+        case 'tool_result':
+            return ToolResultMessage.fromObject(object);
+        default:
+            throw PrismError.unknownMessageType(String(object.type));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/value-objects/messages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/value-objects/messages/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAYhD;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxC,KAAK,WAAW;YACd,OAAO,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC1C,KAAK,aAAa;YAChB,OAAO,iBAAiB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC9C;YACE,MAAM,UAAU,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC"}

package/dist/value-objects/messages/system-message.d.ts

@@ -0,0 +1,9 @@
+import type { JsonObject } from '../../json.js';
+export declare class SystemMessage {
+    readonly content: string;
+    readonly type: "system";
+    constructor(content: string);
+    toObject(): JsonObject;
+    static fromObject(object: JsonObject): SystemMessage;
+}
+//# sourceMappingURL=system-message.d.ts.map

package/dist/value-objects/messages/system-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-message.d.ts","sourceRoot":"","sources":["../../../src/value-objects/messages/system-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,qBAAa,aAAa;IAGZ,QAAQ,CAAC,OAAO,EAAE,MAAM;IAFpC,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;gBAEb,OAAO,EAAE,MAAM;IAEpC,QAAQ,IAAI,UAAU;IAOtB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa;CAGrD"}

package/dist/value-objects/messages/system-message.js

@@ -0,0 +1,17 @@
+export class SystemMessage {
+    content;
+    type = 'system';
+    constructor(content) {
+        this.content = content;
+    }
+    toObject() {
+        return {
+            type: 'system',
+            content: this.content,
+        };
+    }
+    static fromObject(object) {
+        return new SystemMessage(typeof object.content === 'string' ? object.content : '');
+    }
+}
+//# sourceMappingURL=system-message.js.map

package/dist/value-objects/messages/system-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-message.js","sourceRoot":"","sources":["../../../src/value-objects/messages/system-message.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IAGH;IAFZ,IAAI,GAAG,QAAiB,CAAC;IAElC,YAAqB,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAExC,QAAQ;QACN,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAkB;QAClC,OAAO,IAAI,aAAa,CAAC,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;CACF"}

package/dist/value-objects/messages/tool-result-message.d.ts

@@ -0,0 +1,14 @@
+import type { JsonObject } from '../../json.js';
+import { ToolResult } from '../tool-result.js';
+export declare class ToolResultMessage {
+    readonly toolResults: readonly ToolResult[];
+    /** Carried verbatim; see the note on `AssistantMessage.toolApprovalRequests`. */
+    readonly toolApprovalResponses: readonly JsonObject[];
+    readonly type: "tool_result";
+    constructor(toolResults?: readonly ToolResult[], 
+    /** Carried verbatim; see the note on `AssistantMessage.toolApprovalRequests`. */
+    toolApprovalResponses?: readonly JsonObject[]);
+    toObject(): JsonObject;
+    static fromObject(object: JsonObject): ToolResultMessage;
+}
+//# sourceMappingURL=tool-result-message.d.ts.map

package/dist/value-objects/messages/tool-result-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-message.d.ts","sourceRoot":"","sources":["../../../src/value-objects/messages/tool-result-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,qBAAa,iBAAiB;IAI1B,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE;IAC3C,iFAAiF;IACjF,QAAQ,CAAC,qBAAqB,EAAE,SAAS,UAAU,EAAE;IALvD,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;gBAG5B,WAAW,GAAE,SAAS,UAAU,EAAO;IAChD,iFAAiF;IACxE,qBAAqB,GAAE,SAAS,UAAU,EAAO;IAG5D,QAAQ,IAAI,UAAU;IAQtB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,iBAAiB;CAQzD"}