@futdevpro/fsm-dynamo 1.20.40 → 1.20.43

package/build/_modules/ai/_collections/ai-media-provenance.util.d.ts

@@ -0,0 +1,22 @@
+import { DyFM_AI_MediaProvenance_Record } from '../_models/ai-media-provenance.interface';
+/**
+ * Chain-depth rules of the media provenance contract.
+ *
+ * A generation made from a previous generation's output loses quality, and its provenance stops pointing at
+ * anything a person made - so consumers ban such chains, and an explicit override may allow a bounded number
+ * of steps. The depth arithmetic lives here once, so every writer records, and every reader checks, the same
+ * number. It is the rule `dc media-image` already applies (dynamo-cli `DyCLI_MIG_Provenance_Util`).
+ */
+export declare class DyFM_AI_MediaProvenance_Util {
+    /**
+     * The chain depth a new output gets: 0 when none of its inputs is a recorded generation (a prompt-only
+     * generation, or an edit of originals), otherwise the deepest generated input's depth + 1.
+     * A generated input recorded without `chainDepth` counts as a first generation (depth 0).
+     */
+    static nextChainDepth(generatedInputs: DyFM_AI_MediaProvenance_Record[]): number;
+    /**
+     * True when using `generatedInput` as an input would create a chain deeper than `maxChainDepth`.
+     */
+    static exceedsChainLimit(generatedInput: DyFM_AI_MediaProvenance_Record, maxChainDepth: number): boolean;
+}
+//# sourceMappingURL=ai-media-provenance.util.d.ts.map

package/build/_modules/ai/_collections/ai-media-provenance.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-media-provenance.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_collections/ai-media-provenance.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,0CAA0C,CAAC;AAE1F;;;;;;;GAOG;AACH,qBAAa,4BAA4B;IAEvC;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,eAAe,EAAE,8BAA8B,EAAE,GAAG,MAAM;IAQhF;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,cAAc,EAAE,8BAA8B,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO;CAGzG"}

package/build/_modules/ai/_collections/ai-media-provenance.util.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_AI_MediaProvenance_Util = void 0;
+/**
+ * Chain-depth rules of the media provenance contract.
+ *
+ * A generation made from a previous generation's output loses quality, and its provenance stops pointing at
+ * anything a person made - so consumers ban such chains, and an explicit override may allow a bounded number
+ * of steps. The depth arithmetic lives here once, so every writer records, and every reader checks, the same
+ * number. It is the rule `dc media-image` already applies (dynamo-cli `DyCLI_MIG_Provenance_Util`).
+ */
+class DyFM_AI_MediaProvenance_Util {
+    /**
+     * The chain depth a new output gets: 0 when none of its inputs is a recorded generation (a prompt-only
+     * generation, or an edit of originals), otherwise the deepest generated input's depth + 1.
+     * A generated input recorded without `chainDepth` counts as a first generation (depth 0).
+     */
+    static nextChainDepth(generatedInputs) {
+        return generatedInputs.reduce((depth, input) => Math.max(depth, (input.chainDepth ?? 0) + 1), 0);
+    }
+    /**
+     * True when using `generatedInput` as an input would create a chain deeper than `maxChainDepth`.
+     */
+    static exceedsChainLimit(generatedInput, maxChainDepth) {
+        return (generatedInput.chainDepth ?? 0) + 1 > maxChainDepth;
+    }
+}
+exports.DyFM_AI_MediaProvenance_Util = DyFM_AI_MediaProvenance_Util;
+//# sourceMappingURL=ai-media-provenance.util.js.map

package/build/_modules/ai/_collections/ai-media-provenance.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-media-provenance.util.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_collections/ai-media-provenance.util.ts"],"names":[],"mappings":";;;AAEA;;;;;;;GAOG;AACH,MAAa,4BAA4B;IAEvC;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,eAAiD;QACrE,OAAO,eAAe,CAAC,MAAM,CAC3B,CAAC,KAAa,EAAE,KAAqC,EAAU,EAAE,CAC/D,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAC9C,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,cAA8C,EAAE,aAAqB;QAC5F,OAAO,CAAC,cAAc,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC;IAC9D,CAAC;CACF;AArBD,oEAqBC"}

package/build/_modules/ai/_models/ai-image-request.interface.d.ts

@@ -0,0 +1,34 @@
+import { DyFM_AI_MediaFile } from './ai-media-file.interface';
+/**
+ * Provider-independent image generation request.
+ *
+ * The optional knobs use the vocabulary `dc media-image` already sends (dynamo-cli `DyCLI_MIG_GenerateRequest`),
+ * and they stay strings on purpose: their accepted values are provider-specific (`1024x1024`, `high`,
+ * `transparent`), and the provider adapter - not this contract - is the place that knows them.
+ */
+export interface DyFM_AI_ImageGeneration_Request {
+    /** The exact prompt - also what provenance records. */
+    prompt: string;
+    model: string;
+    /** The identity the call is made for. */
+    issuer: string;
+    /** Image dimensions, provider vocabulary (e.g. `1024x1024`). */
+    size?: string;
+    /** Rendering quality, provider vocabulary (e.g. `high`). */
+    quality?: string;
+    /** Background handling, provider vocabulary (e.g. `transparent`). */
+    background?: string;
+    /** Output encoding (e.g. `png`). */
+    format?: string;
+    debugLog?: boolean;
+}
+/**
+ * Image edit request: a generation request plus the input images it works from.
+ */
+export interface DyFM_AI_ImageEdit_Request extends DyFM_AI_ImageGeneration_Request {
+    /** Input images. More than one only where the provider supports composition. */
+    images: DyFM_AI_MediaFile[];
+    /** Optional RGBA mask; transparent pixels mark the editable region. */
+    mask?: DyFM_AI_MediaFile;
+}
+//# sourceMappingURL=ai-image-request.interface.d.ts.map

package/build/_modules/ai/_models/ai-image-request.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-image-request.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-image-request.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,WAAW,+BAA+B;IAC9C,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,+BAA+B;IAChF,gFAAgF;IAChF,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,uEAAuE;IACvE,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B"}

package/build/_modules/ai/_models/ai-image-request.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ai-image-request.interface.js.map

package/build/_modules/ai/_models/ai-image-request.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-image-request.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-image-request.interface.ts"],"names":[],"mappings":""}

package/build/_modules/ai/_models/ai-image-response.interface.d.ts

@@ -0,0 +1,17 @@
+import { DyFM_AI_MediaFile } from './ai-media-file.interface';
+/**
+ * Provider-independent result of an image generation or edit.
+ */
+export interface DyFM_AI_Image_Response {
+    /** The provider that served the call (e.g. `openai`) - recorded, because a default can change. */
+    provider: string;
+    /** The model the provider used, when it says. Provenance records it. */
+    model?: string;
+    /** The produced images, in the order the provider returned them. */
+    images: DyFM_AI_MediaFile[];
+    /** Present only where the provider reports usage that can be priced. */
+    estimatedCostUSD?: number;
+    /** Provider-specific raw response. */
+    rawResponse?: unknown;
+}
+//# sourceMappingURL=ai-image-response.interface.d.ts.map

package/build/_modules/ai/_models/ai-image-response.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-image-response.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-image-response.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,kGAAkG;IAClG,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/build/_modules/ai/_models/ai-image-response.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ai-image-response.interface.js.map

package/build/_modules/ai/_models/ai-image-response.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-image-response.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-image-response.interface.ts"],"names":[],"mappings":""}

package/build/_modules/ai/_models/ai-media-file.interface.d.ts

@@ -0,0 +1,15 @@
+/**
+ * One media payload carried in memory - an input image, a generated image, an audio clip.
+ *
+ * Base64 rather than a path: this contract crosses process and machine boundaries (browser, server, CLI), and
+ * a file path means nothing on the other side. A CLI that works with files reads and writes them at its edge.
+ */
+export interface DyFM_AI_MediaFile {
+    /** File name only, when the payload has one (multipart uploads, provenance inputs). */
+    name?: string;
+    /** IANA media type, e.g. `image/png` or `audio/mpeg`. */
+    mimeType: string;
+    /** The bytes, base64-encoded. */
+    base64: string;
+}
+//# sourceMappingURL=ai-media-file.interface.d.ts.map

package/build/_modules/ai/_models/ai-media-file.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-media-file.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-media-file.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/build/_modules/ai/_models/ai-media-file.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ai-media-file.interface.js.map

package/build/_modules/ai/_models/ai-media-file.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-media-file.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-media-file.interface.ts"],"names":[],"mappings":""}

package/build/_modules/ai/_models/ai-media-provenance.interface.d.ts

@@ -0,0 +1,60 @@
+/**
+ * One input a generated media file was derived from (e.g. the source images of an edit), identified by hash.
+ */
+export interface DyFM_AI_MediaProvenance_Input {
+    /** File name only - inputs may live outside the registry's folder, so no path is claimed. */
+    name: string;
+    /** SHA-256 of the input file (hex). */
+    sha256: string;
+}
+/**
+ * Immutable provenance record of one generated media file (image, speech, ...).
+ *
+ * Carries what a reproduction needs: output hash · exact prompt · reference list · model · parameters ·
+ * input hashes · timestamp · chain depth.
+ *
+ * Mirrors, field for field, the v2 record `dc media-image` already writes into `prompt-provenance.json`
+ * (`DyCLI_MIP_ProvenanceEntry`, schema version 2): a record the CLI wrote is a valid value of this
+ * contract, and a record built against this contract passes the CLI's strict key allowlist. Renaming or
+ * adding a required field here would break that reader - add optional fields behind a schema version.
+ */
+export interface DyFM_AI_MediaProvenance_Record {
+    /** The generated file, as the registry records it. */
+    sourceFile: string;
+    /** SHA-256 of the generated output (hex). */
+    sha256: string;
+    /** The tool that produced the file (e.g. `dc media-image`). */
+    generator: string;
+    /** The exact prompt sent to the provider - never a paraphrase. */
+    prompt: string;
+    /** Reference files the prompt pointed the provider at. */
+    referenceFiles?: string[];
+    /** ISO-8601 timestamp of the generation. Optional only for retrospective records. */
+    generatedAt?: string;
+    /** `native` when written at generation time, `retrospective` when reconstructed afterwards. */
+    recordOrigin?: 'native' | 'retrospective';
+    /** Pixel size of an image output. */
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+    /** v2: the provider model that produced the file. */
+    model?: string;
+    /** v2: the request parameters that shaped the output (size, quality, voice, ...). */
+    parameters?: Record<string, string | number | boolean>;
+    /** v2: the inputs the output was derived from, by hash. */
+    inputs?: DyFM_AI_MediaProvenance_Input[];
+    /**
+     * v2: generations deep - 0 for a prompt-only generation or an edit of an original, otherwise the
+     * deepest generated input + 1. A chain ban reads this, so a record without it cannot vouch for itself.
+     */
+    chainDepth?: number;
+    /** v2: true only when a chain ban was explicitly overridden for this output. */
+    chainOverride?: boolean;
+}
+/** A media provenance registry file (`prompt-provenance.json`). */
+export interface DyFM_AI_MediaProvenance_Registry {
+    schemaVersion: number;
+    entries: DyFM_AI_MediaProvenance_Record[];
+}
+//# sourceMappingURL=ai-media-provenance.interface.d.ts.map

package/build/_modules/ai/_models/ai-media-provenance.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-media-provenance.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-media-provenance.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,8BAA8B;IAC7C,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,YAAY,CAAC,EAAE,QAAQ,GAAG,eAAe,CAAC;IAC1C,qCAAqC;IACrC,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAE/C,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACvD,2DAA2D;IAC3D,MAAM,CAAC,EAAE,6BAA6B,EAAE,CAAC;IACzC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,mEAAmE;AACnE,MAAM,WAAW,gCAAgC;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,8BAA8B,EAAE,CAAC;CAC3C"}

package/build/_modules/ai/_models/ai-media-provenance.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ai-media-provenance.interface.js.map

package/build/_modules/ai/_models/ai-media-provenance.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-media-provenance.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-media-provenance.interface.ts"],"names":[],"mappings":""}

package/build/_modules/ai/_models/ai-model3d-request.interface.d.ts

@@ -0,0 +1,23 @@
+import { DyFM_AI_MediaFile } from './ai-media-file.interface';
+/**
+ * Provider-independent 3D model generation request - text-to-3D (`prompt`) or image-to-3D (`image`).
+ *
+ * One contract for both operations: which input a provider needs is the adapter's to check, and a missing one
+ * is refused before the paid call.
+ */
+export interface DyFM_AI_Model3D_Request {
+    model: string;
+    /** The identity the call is made for. */
+    issuer: string;
+    /** Text-to-3D prompt, or a texturing prompt where an image-to-3D provider supports one. */
+    prompt?: string;
+    /** Image-to-3D source image. */
+    image?: DyFM_AI_MediaFile;
+    /**
+     * The file formats to return (e.g. `['glb']`). The adapter downloads only these - a model is large, and a
+     * provider can offer half a dozen formats. Left out: the adapter's documented primary format.
+     */
+    formats?: string[];
+    debugLog?: boolean;
+}
+//# sourceMappingURL=ai-model3d-request.interface.d.ts.map

package/build/_modules/ai/_models/ai-model3d-request.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model3d-request.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-model3d-request.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,2FAA2F;IAC3F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/build/_modules/ai/_models/ai-model3d-request.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ai-model3d-request.interface.js.map

package/build/_modules/ai/_models/ai-model3d-request.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model3d-request.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-model3d-request.interface.ts"],"names":[],"mappings":""}

package/build/_modules/ai/_models/ai-model3d-response.interface.d.ts

@@ -0,0 +1,17 @@
+import { DyFM_AI_MediaFile } from './ai-media-file.interface';
+/**
+ * Provider-independent result of a 3D model generation.
+ */
+export interface DyFM_AI_Model3D_Response {
+    /** The provider that served the call (e.g. `meshy`). */
+    provider: string;
+    /** The model the provider used, when it says. Provenance records it. */
+    model?: string;
+    /** The model files, one per returned format; each `name` carries its extension (e.g. `model.glb`). */
+    files: DyFM_AI_MediaFile[];
+    /** A preview image, where the provider renders one. */
+    thumbnail?: DyFM_AI_MediaFile;
+    /** Provider-specific raw response. */
+    rawResponse?: unknown;
+}
+//# sourceMappingURL=ai-model3d-response.interface.d.ts.map

package/build/_modules/ai/_models/ai-model3d-response.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model3d-response.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-model3d-response.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sGAAsG;IACtG,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,uDAAuD;IACvD,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,sCAAsC;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/build/_modules/ai/_models/ai-model3d-response.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ai-model3d-response.interface.js.map

package/build/_modules/ai/_models/ai-model3d-response.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model3d-response.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-model3d-response.interface.ts"],"names":[],"mappings":""}

package/build/_modules/ai/_models/ai-speech-request.interface.d.ts

@@ -0,0 +1,31 @@
+import { DyFM_AI_MediaFile } from './ai-media-file.interface';
+/**
+ * Provider-independent text-to-speech request, in the vocabulary `dc media-speech` already sends
+ * (dynamo-cli `DyCLI_MSP_SpeakRequest`).
+ */
+export interface DyFM_AI_Speech_Request {
+    /** The text to speak. */
+    text: string;
+    model: string;
+    /** The identity the call is made for. */
+    issuer: string;
+    /** Provider voice id. A provider that requires one refuses rather than picking silently. */
+    voice?: string;
+    /** Provider output format token (e.g. `mp3`, `mp3_44100_128`). */
+    format?: string;
+    debugLog?: boolean;
+}
+/**
+ * Provider-independent speech-to-text request (dynamo-cli `DyCLI_MSP_TranscribeRequest`).
+ */
+export interface DyFM_AI_Transcription_Request {
+    /** The audio to transcribe. */
+    audio: DyFM_AI_MediaFile;
+    model: string;
+    /** The identity the call is made for. */
+    issuer: string;
+    /** BCP-47-ish language hint. Providers that auto-detect may ignore it. */
+    language?: string;
+    debugLog?: boolean;
+}
+//# sourceMappingURL=ai-speech-request.interface.d.ts.map

package/build/_modules/ai/_models/ai-speech-request.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-speech-request.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-speech-request.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,+BAA+B;IAC/B,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/build/_modules/ai/_models/ai-speech-request.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ai-speech-request.interface.js.map

package/build/_modules/ai/_models/ai-speech-request.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-speech-request.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-speech-request.interface.ts"],"names":[],"mappings":""}

package/build/_modules/ai/_models/ai-speech-response.interface.d.ts

@@ -0,0 +1,32 @@
+import { DyFM_AI_MediaFile } from './ai-media-file.interface';
+/**
+ * Provider-independent result of a text-to-speech call.
+ */
+export interface DyFM_AI_Speech_Response {
+    /** The provider that served the call (e.g. `elevenlabs`). */
+    provider: string;
+    /** The model the provider used, when it says. Provenance records it. */
+    model?: string;
+    /** The produced audio. */
+    audio: DyFM_AI_MediaFile;
+    /** The format token actually sent to the provider. */
+    format: string;
+    /** Provider-specific raw response. */
+    rawResponse?: unknown;
+}
+/**
+ * Provider-independent result of a speech-to-text call.
+ */
+export interface DyFM_AI_Transcription_Response {
+    /** The provider that served the call (e.g. `openai`). */
+    provider: string;
+    /** The model the provider used, when it says. */
+    model?: string;
+    /** The transcript. */
+    text: string;
+    /** The language the provider reported, where it reports one. */
+    language?: string;
+    /** Provider-specific raw response. */
+    rawResponse?: unknown;
+}
+//# sourceMappingURL=ai-speech-response.interface.d.ts.map

package/build/_modules/ai/_models/ai-speech-response.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-speech-response.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-speech-response.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,KAAK,EAAE,iBAAiB,CAAC;IACzB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/build/_modules/ai/_models/ai-speech-response.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ai-speech-response.interface.js.map

package/build/_modules/ai/_models/ai-speech-response.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-speech-response.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-speech-response.interface.ts"],"names":[],"mappings":""}

package/build/_modules/ai/index.d.ts

@@ -1,3 +1,4 @@
+export * from './_collections/ai-media-provenance.util';
 export * from './_collections/ai-model-ref.util';
 export * from './_collections/ai-model-registry.util';
 export * from './_enums/ai-provider.enum';
@@ -7,6 +8,12 @@ export * from './_models/ai-call-settings.interface';
 export * from './_models/ai-config.interface';
 export * from './_models/ai-embedding-request.interface';
 export * from './_models/ai-embedding-response.interface';
+export * from './_models/ai-image-request.interface';
+export * from './_models/ai-image-response.interface';
+export * from './_models/ai-media-file.interface';
+export * from './_models/ai-media-provenance.interface';
+export * from './_models/ai-model3d-request.interface';
+export * from './_models/ai-model3d-response.interface';
 export * from './_models/ai-llm-request.interface';
 export * from './_models/ai-llm-response.interface';
 export * from './_models/ai-message.interface';
@@ -15,6 +22,8 @@ export * from './_models/ai-model-info.interface';
 export * from './_models/ai-model-settings-schema.interface';
 export * from './_models/ai-provider-capabilities.interface';
 export * from './_models/ai-settings.interface';
+export * from './_models/ai-speech-request.interface';
+export * from './_models/ai-speech-response.interface';
 export * from './_models/ai-tool.interface';
 export * from './_models/ai-tool-call.interface';
 export * from './_models/ai-tool-result.interface';

package/build/_modules/ai/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/ai/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AAGtD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,mCAAmC,CAAC;AAClD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iDAAiD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/ai/index.ts"],"names":[],"mappings":"AACA,cAAc,yCAAyC,CAAC;AACxD,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AAGtD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,mCAAmC,CAAC;AAClD,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,mCAAmC,CAAC;AAClD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iDAAiD,CAAC"}

package/build/_modules/ai/index.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 // COLLECTIONS
+tslib_1.__exportStar(require("./_collections/ai-media-provenance.util"), exports);
 tslib_1.__exportStar(require("./_collections/ai-model-ref.util"), exports);
 tslib_1.__exportStar(require("./_collections/ai-model-registry.util"), exports);
 // ENUMS
@@ -13,6 +14,12 @@ tslib_1.__exportStar(require("./_models/ai-call-settings.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-config.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-embedding-request.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-embedding-response.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-image-request.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-image-response.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-media-file.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-media-provenance.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-model3d-request.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-model3d-response.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-llm-request.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-llm-response.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-message.interface"), exports);
@@ -21,6 +28,8 @@ tslib_1.__exportStar(require("./_models/ai-model-info.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-model-settings-schema.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-provider-capabilities.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-settings.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-speech-request.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-speech-response.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-tool.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-tool-call.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-tool-result.interface"), exports);

package/build/_modules/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/ai/index.ts"],"names":[],"mappings":";;;AAAA,cAAc;AACd,2EAAiD;AACjD,gFAAsD;AAEtD,QAAQ;AACR,oEAA0C;AAC1C,sEAA4C;AAC5C,wEAA8C;AAE9C,SAAS;AACT,+EAAqD;AACrD,wEAA8C;AAC9C,mFAAyD;AACzD,oFAA0D;AAC1D,6EAAmD;AACnD,8EAAoD;AACpD,yEAA+C;AAC/C,oFAA0D;AAC1D,4EAAkD;AAClD,uFAA6D;AAC7D,uFAA6D;AAC7D,0EAAgD;AAChD,sEAA4C;AAC5C,2EAAiD;AACjD,6EAAmD;AACnD,yEAA+C;AAC/C,0FAAgE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/ai/index.ts"],"names":[],"mappings":";;;AAAA,cAAc;AACd,kFAAwD;AACxD,2EAAiD;AACjD,gFAAsD;AAEtD,QAAQ;AACR,oEAA0C;AAC1C,sEAA4C;AAC5C,wEAA8C;AAE9C,SAAS;AACT,+EAAqD;AACrD,wEAA8C;AAC9C,mFAAyD;AACzD,oFAA0D;AAC1D,+EAAqD;AACrD,gFAAsD;AACtD,4EAAkD;AAClD,kFAAwD;AACxD,iFAAuD;AACvD,kFAAwD;AACxD,6EAAmD;AACnD,8EAAoD;AACpD,yEAA+C;AAC/C,oFAA0D;AAC1D,4EAAkD;AAClD,uFAA6D;AAC7D,uFAA6D;AAC7D,0EAAgD;AAChD,gFAAsD;AACtD,iFAAuD;AACvD,sEAA4C;AAC5C,2EAAiD;AACjD,6EAAmD;AACnD,yEAA+C;AAC/C,0FAAgE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fsm-dynamo",
-  "version": "1.20.40",
+  "version": "1.20.43",
   "description": "Full Stack Model Collection for Dynamic (NodeJS-Typescript) Framework called Dynamo, by Future Development Ltd.",
   "DyBu_settings": {
     "packageType": "full-stack-package",