@particle-academy/prism 0.0.0

package/dist/value-objects/embeddings-usage.d.ts

@@ -0,0 +1,16 @@
+import type { JsonObject } from '../json.js';
+/**
+ * What an embeddings call cost.
+ *
+ * Separate from `Usage` rather than reusing it: an embeddings response has no
+ * completion tokens, and a shared type would report `completionTokens: 0` as
+ * though none had been generated rather than because the concept does not
+ * apply. Nullable for the same reason — a provider that reports nothing is
+ * different from one that reports zero.
+ */
+export declare class EmbeddingsUsage {
+    readonly tokens: number | null;
+    constructor(tokens: number | null);
+    toObject(): JsonObject;
+}
+//# sourceMappingURL=embeddings-usage.d.ts.map

package/dist/value-objects/embeddings-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings-usage.d.ts","sourceRoot":"","sources":["../../src/value-objects/embeddings-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;GAQG;AACH,qBAAa,eAAe;IACd,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;gBAArB,MAAM,EAAE,MAAM,GAAG,IAAI;IAE1C,QAAQ,IAAI,UAAU;CAGvB"}

package/dist/value-objects/embeddings-usage.js

@@ -0,0 +1,19 @@
+/**
+ * What an embeddings call cost.
+ *
+ * Separate from `Usage` rather than reusing it: an embeddings response has no
+ * completion tokens, and a shared type would report `completionTokens: 0` as
+ * though none had been generated rather than because the concept does not
+ * apply. Nullable for the same reason — a provider that reports nothing is
+ * different from one that reports zero.
+ */
+export class EmbeddingsUsage {
+    tokens;
+    constructor(tokens) {
+        this.tokens = tokens;
+    }
+    toObject() {
+        return { tokens: this.tokens };
+    }
+}
+//# sourceMappingURL=embeddings-usage.js.map

package/dist/value-objects/embeddings-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings-usage.js","sourceRoot":"","sources":["../../src/value-objects/embeddings-usage.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAe;IACL;IAArB,YAAqB,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAE9C,QAAQ;QACN,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACjC,CAAC;CACF"}

package/dist/value-objects/generated-audio.d.ts

@@ -0,0 +1,20 @@
+import type { JsonObject } from '../json.js';
+import { Audio } from './media/audio.js';
+/**
+ * Speech a provider generated.
+ *
+ * Extends `Audio`, so it answers the same questions every other payload does —
+ * `base64()`, `rawContent()`, `mimeType()`. It exists as its own type only
+ * because the reference has one, and because `type` (the provider's own format
+ * name, e.g. `mp3`) is not the same thing as a mime type and should not be
+ * quietly stored as one.
+ */
+export declare class GeneratedAudio extends Audio {
+    /** The provider's format name — `mp3`, `wav`, `opus`. Not a mime type. */
+    readonly type: string | null;
+    constructor(base64?: string | null, 
+    /** The provider's format name — `mp3`, `wav`, `opus`. Not a mime type. */
+    type?: string | null, mimeType?: string | null);
+    toObject(): JsonObject;
+}
+//# sourceMappingURL=generated-audio.d.ts.map

package/dist/value-objects/generated-audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-audio.d.ts","sourceRoot":"","sources":["../../src/value-objects/generated-audio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAGrC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;gBAF5B,MAAM,GAAE,MAAM,GAAG,IAAW;IAC5B,0EAA0E;IACjE,IAAI,GAAE,MAAM,GAAG,IAAW,EACnC,QAAQ,GAAE,MAAM,GAAG,IAAW;IAKvB,QAAQ,IAAI,UAAU;CAGhC"}

package/dist/value-objects/generated-audio.js

@@ -0,0 +1,23 @@
+import { Audio } from './media/audio.js';
+/**
+ * Speech a provider generated.
+ *
+ * Extends `Audio`, so it answers the same questions every other payload does —
+ * `base64()`, `rawContent()`, `mimeType()`. It exists as its own type only
+ * because the reference has one, and because `type` (the provider's own format
+ * name, e.g. `mp3`) is not the same thing as a mime type and should not be
+ * quietly stored as one.
+ */
+export class GeneratedAudio extends Audio {
+    type;
+    constructor(base64 = null, 
+    /** The provider's format name — `mp3`, `wav`, `opus`. Not a mime type. */
+    type = null, mimeType = null) {
+        super(null, base64, mimeType);
+        this.type = type;
+    }
+    toObject() {
+        return { ...super.toObject(), type: this.type };
+    }
+}
+//# sourceMappingURL=generated-audio.js.map

package/dist/value-objects/generated-audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-audio.js","sourceRoot":"","sources":["../../src/value-objects/generated-audio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAI5B;IAHX,YACE,SAAwB,IAAI;IAC5B,0EAA0E;IACjE,OAAsB,IAAI,EACnC,WAA0B,IAAI;QAE9B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAHrB,SAAI,GAAJ,IAAI,CAAsB;IAIrC,CAAC;IAEQ,QAAQ;QACf,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAClD,CAAC;CACF"}

package/dist/value-objects/generated-image.d.ts

@@ -0,0 +1,36 @@
+import type { JsonObject } from '../json.js';
+import { Image } from './media/image.js';
+/**
+ * An image a provider generated, and what it generated from.
+ *
+ * EXTENDS `Image` now that a Media base exists. It previously restated the
+ * url / base64 / mimeType triple itself, which was correct while it was the
+ * only binary type in the port and wrong the moment audio arrived — three
+ * standalone copies is how a package ends up with three answers to "is this a
+ * file". This was the first, so it moved first.
+ *
+ * What it adds is the one thing a generated image has and a supplied one does
+ * not: the prompt the provider actually used.
+ */
+export declare class GeneratedImage extends Image {
+    /**
+     * What the provider actually generated from.
+     *
+     * OpenAI rewrites prompts for safety and quality, often substantially. Kept
+     * because a caller comparing an image against its prompt is comparing it
+     * against THIS one, not the one they typed.
+     */
+    readonly revisedPrompt: string | null;
+    constructor(url?: string | null, base64?: string | null, 
+    /**
+     * What the provider actually generated from.
+     *
+     * OpenAI rewrites prompts for safety and quality, often substantially. Kept
+     * because a caller comparing an image against its prompt is comparing it
+     * against THIS one, not the one they typed.
+     */
+    revisedPrompt?: string | null, mimeType?: string | null);
+    hasRevisedPrompt(): boolean;
+    toObject(): JsonObject;
+}
+//# sourceMappingURL=generated-image.d.ts.map

package/dist/value-objects/generated-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-image.d.ts","sourceRoot":"","sources":["../../src/value-objects/generated-image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC;;;;;;;;;;;GAWG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAIrC;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;gBATrC,GAAG,GAAE,MAAM,GAAG,IAAW,EACzB,MAAM,GAAE,MAAM,GAAG,IAAW;IAC5B;;;;;;OAMG;IACM,aAAa,GAAE,MAAM,GAAG,IAAW,EAC5C,QAAQ,GAAE,MAAM,GAAG,IAAW;IAKhC,gBAAgB,IAAI,OAAO;IAIlB,QAAQ,IAAI,UAAU;CAGhC"}

package/dist/value-objects/generated-image.js

@@ -0,0 +1,35 @@
+import { Image } from './media/image.js';
+/**
+ * An image a provider generated, and what it generated from.
+ *
+ * EXTENDS `Image` now that a Media base exists. It previously restated the
+ * url / base64 / mimeType triple itself, which was correct while it was the
+ * only binary type in the port and wrong the moment audio arrived — three
+ * standalone copies is how a package ends up with three answers to "is this a
+ * file". This was the first, so it moved first.
+ *
+ * What it adds is the one thing a generated image has and a supplied one does
+ * not: the prompt the provider actually used.
+ */
+export class GeneratedImage extends Image {
+    revisedPrompt;
+    constructor(url = null, base64 = null, 
+    /**
+     * What the provider actually generated from.
+     *
+     * OpenAI rewrites prompts for safety and quality, often substantially. Kept
+     * because a caller comparing an image against its prompt is comparing it
+     * against THIS one, not the one they typed.
+     */
+    revisedPrompt = null, mimeType = null) {
+        super(url, base64, mimeType);
+        this.revisedPrompt = revisedPrompt;
+    }
+    hasRevisedPrompt() {
+        return this.revisedPrompt !== null;
+    }
+    toObject() {
+        return { ...super.toObject(), revised_prompt: this.revisedPrompt };
+    }
+}
+//# sourceMappingURL=generated-image.js.map

package/dist/value-objects/generated-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-image.js","sourceRoot":"","sources":["../../src/value-objects/generated-image.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAW5B;IAVX,YACE,MAAqB,IAAI,EACzB,SAAwB,IAAI;IAC5B;;;;;;OAMG;IACM,gBAA+B,IAAI,EAC5C,WAA0B,IAAI;QAE9B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAHpB,kBAAa,GAAb,aAAa,CAAsB;IAI9C,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC;IACrC,CAAC;IAEQ,QAAQ;QACf,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;IACrE,CAAC;CACF"}

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

@@ -0,0 +1,13 @@
+export { Text } from './media/text.js';
+export { AssistantMessage, SystemMessage, ToolResultMessage, UserMessage, messageFromObject, } from './messages/index.js';
+export type { Message, MessageType } from './messages/index.js';
+export { Artifact } from './artifact.js';
+export { Meta } from './meta.js';
+export { ProviderRateLimit } from './provider-rate-limit.js';
+export { ProviderTool } from './provider-tool.js';
+export { ToolCall } from './tool-call.js';
+export type { ToolCallArguments } from './tool-call.js';
+export { ToolResult } from './tool-result.js';
+export type { ToolResultValue } from './tool-result.js';
+export { Usage } from './usage.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/value-objects/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/value-objects/index.js

@@ -0,0 +1,10 @@
+export { Text } from './media/text.js';
+export { AssistantMessage, SystemMessage, ToolResultMessage, UserMessage, messageFromObject, } from './messages/index.js';
+export { Artifact } from './artifact.js';
+export { Meta } from './meta.js';
+export { ProviderRateLimit } from './provider-rate-limit.js';
+export { ProviderTool } from './provider-tool.js';
+export { ToolCall } from './tool-call.js';
+export { ToolResult } from './tool-result.js';
+export { Usage } from './usage.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/value-objects/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { JsonObject } from '../../json.js';
+import { Media } from './media.js';
+/** An audio payload — a recording to transcribe, or speech that was generated. */
+export declare class Audio extends Media {
+    readonly kind: "audio";
+    static fromObject(object: JsonObject): Audio;
+}
+//# sourceMappingURL=audio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../src/value-objects/media/audio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,kFAAkF;AAClF,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/audio.js

@@ -0,0 +1,9 @@
+import { Media } from './media.js';
+/** An audio payload — a recording to transcribe, or speech that was generated. */
+export class Audio extends Media {
+    kind = 'audio';
+    static fromObject(object) {
+        return Audio.restoreInto(new Audio(...Audio.constructorArgs(object)), object);
+    }
+}
+//# sourceMappingURL=audio.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../../src/value-objects/media/audio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,kFAAkF;AAClF,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/media/document.d.ts

@@ -0,0 +1,44 @@
+import type { JsonObject } from '../../json.js';
+import { Media } from './media.js';
+/**
+ * A document — a PDF, a text file, or text supplied directly as chunks.
+ *
+ * Two things a plain `Media` does not have, both because every provider that
+ * accepts a document asks for them:
+ *
+ *  - a TITLE, sent as `document_name` by Mistral, `filename` by OpenAI and
+ *    `title` by Anthropic;
+ *  - CHUNKS, pre-split text sent as a `content` source. Anthropic is the only
+ *    provider here that takes them.
+ *
+ * ONE DELIBERATE DIVERGENCE FROM THE REFERENCE. The reference threads the title
+ * through every factory as the SECOND positional argument — `Document::fromUrl(
+ * $url, $title)` — where the same position on the `Media` base means the mime
+ * type. So `Document::fromUrl($url, 'application/pdf')` silently sets the title
+ * to "application/pdf" and leaves the mime type unset. Inheriting that here
+ * would be inheriting a trap the type system cannot see, since both are
+ * `string`. The factories keep their base meaning and the title is set by
+ * {@link titled}, which cannot be confused with anything.
+ */
+export declare class Document extends Media {
+    #private;
+    readonly kind: "document";
+    /**
+     * A document supplied as pre-split text.
+     *
+     * Carries no bytes and no mime type — the chunks ARE the document. Only
+     * Anthropic accepts this form; the other two mappers reject it by name rather
+     * than sending an empty payload.
+     */
+    static fromChunks(chunks: readonly string[], title?: string | null): Document;
+    /** Text as a document, rather than as part of the prompt. */
+    static fromText(text: string, title?: string | null): Document;
+    static fromObject(object: JsonObject): Document;
+    /** Name this document for the provider. Returns itself, so it chains onto a factory. */
+    titled(title: string): this;
+    documentTitle(): string | null;
+    chunks(): readonly string[] | null;
+    isChunks(): boolean;
+    toObject(): JsonObject;
+}
+//# sourceMappingURL=document.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/value-objects/media/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,QAAS,SAAQ,KAAK;;IACjC,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAMpC;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,GAAG,QAAQ;IAOnF,6DAA6D;IAC7D,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,GAAG,QAAQ;IAMpE,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ;IAc/C,wFAAwF;IACxF,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM3B,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B,MAAM,IAAI,SAAS,MAAM,EAAE,GAAG,IAAI;IAIlC,QAAQ,IAAI,OAAO;IAIV,QAAQ,IAAI,UAAU;CAOhC"}

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

@@ -0,0 +1,75 @@
+import { Media } from './media.js';
+/**
+ * A document — a PDF, a text file, or text supplied directly as chunks.
+ *
+ * Two things a plain `Media` does not have, both because every provider that
+ * accepts a document asks for them:
+ *
+ *  - a TITLE, sent as `document_name` by Mistral, `filename` by OpenAI and
+ *    `title` by Anthropic;
+ *  - CHUNKS, pre-split text sent as a `content` source. Anthropic is the only
+ *    provider here that takes them.
+ *
+ * ONE DELIBERATE DIVERGENCE FROM THE REFERENCE. The reference threads the title
+ * through every factory as the SECOND positional argument — `Document::fromUrl(
+ * $url, $title)` — where the same position on the `Media` base means the mime
+ * type. So `Document::fromUrl($url, 'application/pdf')` silently sets the title
+ * to "application/pdf" and leaves the mime type unset. Inheriting that here
+ * would be inheriting a trap the type system cannot see, since both are
+ * `string`. The factories keep their base meaning and the title is set by
+ * {@link titled}, which cannot be confused with anything.
+ */
+export class Document extends Media {
+    kind = 'document';
+    #documentTitle = null;
+    #chunks = null;
+    /**
+     * A document supplied as pre-split text.
+     *
+     * Carries no bytes and no mime type — the chunks ARE the document. Only
+     * Anthropic accepts this form; the other two mappers reject it by name rather
+     * than sending an empty payload.
+     */
+    static fromChunks(chunks, title = null) {
+        const document = new Document();
+        document.#chunks = [...chunks];
+        return title === null ? document : document.titled(title);
+    }
+    /** Text as a document, rather than as part of the prompt. */
+    static fromText(text, title = null) {
+        const document = Document.fromRawContent(new TextEncoder().encode(text), 'text/plain');
+        return title === null ? document : document.titled(title);
+    }
+    static fromObject(object) {
+        const document = Document.restoreInto(new Document(...Document.constructorArgs(object)), object);
+        if (typeof object.document_title === 'string') {
+            document.titled(object.document_title);
+        }
+        if (Array.isArray(object.chunks)) {
+            document.#chunks = object.chunks.filter((chunk) => typeof chunk === 'string');
+        }
+        return document;
+    }
+    /** Name this document for the provider. Returns itself, so it chains onto a factory. */
+    titled(title) {
+        this.#documentTitle = title;
+        return this;
+    }
+    documentTitle() {
+        return this.#documentTitle;
+    }
+    chunks() {
+        return this.#chunks;
+    }
+    isChunks() {
+        return this.#chunks !== null;
+    }
+    toObject() {
+        return {
+            ...super.toObject(),
+            document_title: this.#documentTitle,
+            chunks: this.#chunks === null ? null : [...this.#chunks],
+        };
+    }
+}
+//# sourceMappingURL=document.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../../src/value-objects/media/document.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,GAAG,UAAmB,CAAC;IAEpC,cAAc,GAAkB,IAAI,CAAC;IAErC,OAAO,GAA6B,IAAI,CAAC;IAEzC;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,MAAyB,EAAE,QAAuB,IAAI;QACtE,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,QAAQ,CAAC,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;QAE/B,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED,6DAA6D;IAC7D,MAAM,CAAC,QAAQ,CAAC,IAAY,EAAE,QAAuB,IAAI;QACvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,cAAc,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;QAEvF,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAkB;QAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,GAAG,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAEjG,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;YAC9C,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;QACjG,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,wFAAwF;IACxF,MAAM,CAAC,KAAa;QAClB,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAE5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;IAC/B,CAAC;IAEQ,QAAQ;QACf,OAAO;YACL,GAAG,KAAK,CAAC,QAAQ,EAAE;YACnB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,MAAM,EAAE,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;SACzD,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,13 @@
+import type { JsonObject } from '../../json.js';
+import { Media } from './media.js';
+/**
+ * An image.
+ *
+ * Adds nothing to `Media` but a name, deliberately: an image and an audio file
+ * differ in what a provider does with them, not in what they are.
+ */
+export declare class Image extends Media {
+    readonly kind: "image";
+    static fromObject(object: JsonObject): Image;
+}
+//# sourceMappingURL=image.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../../src/value-objects/media/image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;;;GAKG;AACH,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/image.js

@@ -0,0 +1,14 @@
+import { Media } from './media.js';
+/**
+ * An image.
+ *
+ * Adds nothing to `Media` but a name, deliberately: an image and an audio file
+ * differ in what a provider does with them, not in what they are.
+ */
+export class Image extends Media {
+    kind = 'image';
+    static fromObject(object) {
+        return Image.restoreInto(new Image(...Image.constructorArgs(object)), object);
+    }
+}
+//# sourceMappingURL=image.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../../src/value-objects/media/image.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;;;GAKG;AACH,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/media/media.d.ts

@@ -0,0 +1,119 @@
+import type { JsonObject } from '../../json.js';
+/** The kinds of payload a message part can be, minus text. */
+export type MediaKind = 'image' | 'audio' | 'document' | 'video';
+/**
+ * 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 declare abstract class Media {
+    #private;
+    readonly url: string | null;
+    /**
+     * The discriminator in the serialized form, under the key `kind`.
+     *
+     * NOT `type`. `GeneratedAudio` already serializes `type` as the provider's
+     * own format name (`mp3`, `wav`), so a discriminator spelled `type` would be
+     * overwritten by it on exactly one subclass — the kind of collision that
+     * round-trips fine in every test that does not happen to use that class.
+     *
+     * A subclass of a subclass keeps its parent's kind: `GeneratedImage` is an
+     * `image`, and reading one back as `Image` loses only the revised prompt,
+     * which is not something a user message carries.
+     */
+    abstract readonly kind: MediaKind;
+    constructor(url?: string | null, base64?: string | null, mimeType?: string | null);
+    static fromFileId<T extends Media>(this: new () => T, fileId: string): T;
+    static fromUrl<T extends Media>(this: new (url?: string | null) => T, url: string, mimeType?: string | null): T;
+    static fromBase64<T extends Media>(this: new (url?: string | null, base64?: string | null, mimeType?: string | null) => T, base64: string, mimeType?: string | null): T;
+    static fromRawContent<T extends Media>(this: new () => T, content: Uint8Array, mimeType?: string | null): T;
+    /**
+     * 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<T extends Media>(this: new () => T, path: string, mimeType?: string | null): T;
+    /** Alias, matching the reference's spelling. */
+    static fromPath<T extends Media>(this: new () => T, path: string): T;
+    /** Name this payload for a provider that wants a filename. */
+    as(name: string): this;
+    filename(): string | null;
+    fileId(): string | null;
+    localPath(): string | null;
+    isFileId(): boolean;
+    isFile(): boolean;
+    isUrl(): boolean;
+    hasBase64(): boolean;
+    hasMimeType(): boolean;
+    hasRawContent(): boolean;
+    mimeType(): string | null;
+    rawContent(): Uint8Array | 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(): string | null;
+    /**
+     * 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.
+     */
+    fetch(): Promise<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(): JsonObject;
+    /**
+     * 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.
+     */
+    protected static restoreInto<T extends Media>(media: T, object: JsonObject): T;
+    /** The url, base64 and mime type a serialized payload carries, as constructor arguments. */
+    protected static constructorArgs(object: JsonObject): [string | null, string | null, string | null];
+    protected setRawContent(content: Uint8Array, mimeType: string | null): void;
+    protected setMimeType(mimeType: string): void;
+    protected setLocalPath(path: string): void;
+    protected setFileId(fileId: string): void;
+}
+export declare function guessMimeType(path: string): string | null;
+//# sourceMappingURL=media.d.ts.map

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

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