@futdevpro/nts-dynamo 1.15.258 → 1.15.263

package/build/_collections/get-environment-settings.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-environment-settings.util.d.ts","sourceRoot":"","sources":["../../src/_collections/get-environment-settings.util.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AAElG,wBAAgB,6BAA6B,IAAI,0BAA0B,CA6C1E"}
+{"version":3,"file":"get-environment-settings.util.d.ts","sourceRoot":"","sources":["../../src/_collections/get-environment-settings.util.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AAElG,wBAAgB,6BAA6B,IAAI,0BAA0B,CA8C1E"}

package/build/_collections/get-environment-settings.util.js

@@ -29,11 +29,11 @@ function DyNTS_getEnvironment_settings() {
             project: process.env.OPENAI_PROJECT,
             ttsApiKey: process.env.OPENAI_TTS_API_KEY,
         },
-        /* elevenLabs: {
-          apiKey: process.env.ELEVENLABS_API_KEY,
+        elevenLabs: {
+            apiKey: process.env.ELEVENLABS_API_KEY,
+            environment: process.env.ELEVENLABS_ENVIRONMENT,
         },
-    
-        clickup: {
+        /* clickup: {
           apiKey: process.env.CLICKUP_API_KEY,
           workspaceId: process.env.CLICKUP_WORKSPACE_ID,
           spaceId: process.env.CLICKUP_SPACE_ID,

package/build/_collections/get-environment-settings.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-environment-settings.util.js","sourceRoot":"","sources":["../../src/_collections/get-environment-settings.util.ts"],"names":[],"mappings":";;AAMA,sEA6CC;;AAnDD,uDAAiC;AAEjC,sDAAiG;AAIjG,SAAgB,6BAA6B;IAC3C,MAAM,CAAC,MAAM,EAAE,CAAC;IAEhB,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,iCAAoB,CAAC,KAAK,CAAC;IAE3G,GAAG,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;IAE9B,IAAI,CAAC,qCAAwB,CAAC,QAAQ,CAAC,GAA2B,CAAC,EAAE,CAAC;QACpE,qBAAQ,CAAC,KAAK,CAAC,yBAAyB,GAAG,8BAA8B,CAAC,CAAC;QAC3E,GAAG,GAAG,iCAAoB,CAAC,KAAK,CAAC;IACnC,CAAC;IAED,OAAO;QACL,WAAW,EAAE,qCAAwB,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAA2B,CAAC,CAAC,CAAC;YACvF,OAAO,CAAC,GAAG,CAAC,GAA2B,CAAC,CAAC;YACzC,iCAAoB,CAAC,KAAK;QAG5B,OAAO,EAAE;YACP,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;YACrC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;YACpC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB;YAC3C,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB;SAC9C;QAED,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS;QAExD,MAAM,EAAE;YACN,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;YAClC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;YAC7C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;YACnC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;SAC1C;QAED;;;;;;;;;aASK;KACN,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-environment-settings.util.js","sourceRoot":"","sources":["../../src/_collections/get-environment-settings.util.ts"],"names":[],"mappings":";;AAMA,sEA8CC;;AApDD,uDAAiC;AAEjC,sDAAiG;AAIjG,SAAgB,6BAA6B;IAC3C,MAAM,CAAC,MAAM,EAAE,CAAC;IAEhB,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,iCAAoB,CAAC,KAAK,CAAC;IAE3G,GAAG,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;IAE9B,IAAI,CAAC,qCAAwB,CAAC,QAAQ,CAAC,GAA2B,CAAC,EAAE,CAAC;QACpE,qBAAQ,CAAC,KAAK,CAAC,yBAAyB,GAAG,8BAA8B,CAAC,CAAC;QAC3E,GAAG,GAAG,iCAAoB,CAAC,KAAK,CAAC;IACnC,CAAC;IAED,OAAO;QACL,WAAW,EAAE,qCAAwB,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAA2B,CAAC,CAAC,CAAC;YACvF,OAAO,CAAC,GAAG,CAAC,GAA2B,CAAC,CAAC;YACzC,iCAAoB,CAAC,KAAK;QAG5B,OAAO,EAAE;YACP,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;YACrC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;YACpC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB;YAC3C,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB;SAC9C;QAED,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS;QAExD,MAAM,EAAE;YACN,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;YAClC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;YAC7C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;YACnC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;SAC1C;QAED,UAAU,EAAE;YACV,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;YACtC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB;SAChD;QAED;;;;;aAKK;KACN,CAAC;AACJ,CAAC"}

package/build/_models/interfaces/environment-settings.interface.d.ts

@@ -31,5 +31,14 @@ export interface DyNTS_Environment_Settings {
         project: string;
         ttsApiKey: string;
     };
+    /**
+     * this is the elevenlabs settings of the system
+     */
+    elevenLabs?: {
+        /** `ELEVENLABS_API_KEY` */
+        apiKey: string;
+        /** `ELEVENLABS_ENVIRONMENT`: global (default) | us | eu-residency | india-residency | singapore-residency */
+        environment?: string;
+    };
 }
 //# sourceMappingURL=environment-settings.interface.d.ts.map

package/build/_models/interfaces/environment-settings.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"environment-settings.interface.d.ts","sourceRoot":"","sources":["../../../src/_models/interfaces/environment-settings.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAI7D,MAAM,WAAW,0BAA0B;IACzC;;;;;;;OAOG;IACH,WAAW,EAAE,oBAAoB,CAAC;IAElC;;OAEG;IACH,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CAmBH"}
+{"version":3,"file":"environment-settings.interface.d.ts","sourceRoot":"","sources":["../../../src/_models/interfaces/environment-settings.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAI7D,MAAM,WAAW,0BAA0B;IACzC;;;;;;;OAOG;IACH,WAAW,EAAE,oBAAoB,CAAC;IAElC;;OAEG;IACH,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF;;OAEG;IACH,UAAU,CAAC,EAAE;QACX,2BAA2B;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,6GAA6G;QAC7G,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CAYH"}

package/build/_modules/media-gen/_collections/elevenlabs-region.util.d.ts

@@ -0,0 +1,22 @@
+/** The ElevenLabs environments the provider documents. Anything else is refused rather than guessed at. */
+export type DyNTS_ElevenLabs_Environment = 'global' | 'us' | 'eu-residency' | 'india-residency' | 'singapore-residency';
+/**
+ * ElevenLabs region resolution: the environment name → the API host.
+ *
+ * The host table is the one `dynamo-cli` already runs in production (`DyCLI_MAP_ElevenLabsRegion_Util`),
+ * carried here unchanged, because the engine layer needs it too. A residency environment exists so the audio
+ * never leaves the region - so an unknown environment is an ERROR, never a silent fall back to the global host.
+ */
+export declare class DyNTS_ElevenLabsRegion_Util {
+    /** Host per environment. */
+    private static readonly baseUrls;
+    /**
+     * Accepts only the documented environments; `undefined` means `global`.
+     *
+     * @param value The raw value, typically `process.env.ELEVENLABS_ENVIRONMENT`.
+     */
+    static resolveEnvironment(value: string | undefined): DyNTS_ElevenLabs_Environment;
+    /** The API host of one environment. */
+    static getBaseUrl(environment: DyNTS_ElevenLabs_Environment): string;
+}
+//# sourceMappingURL=elevenlabs-region.util.d.ts.map

package/build/_modules/media-gen/_collections/elevenlabs-region.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-region.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_collections/elevenlabs-region.util.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,MAAM,MAAM,4BAA4B,GACpC,QAAQ,GACR,IAAI,GACJ,cAAc,GACd,iBAAiB,GACjB,qBAAqB,CAAC;AAE1B;;;;;;GAMG;AACH,qBAAa,2BAA2B;IAEtC,4BAA4B;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAM9B;IAEF;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,4BAA4B;IAqBlF,uCAAuC;IACvC,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,4BAA4B,GAAG,MAAM;CAGrE"}

package/build/_modules/media-gen/_collections/elevenlabs-region.util.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_ElevenLabsRegion_Util = void 0;
+/**
+ * ElevenLabs region resolution: the environment name → the API host.
+ *
+ * The host table is the one `dynamo-cli` already runs in production (`DyCLI_MAP_ElevenLabsRegion_Util`),
+ * carried here unchanged, because the engine layer needs it too. A residency environment exists so the audio
+ * never leaves the region - so an unknown environment is an ERROR, never a silent fall back to the global host.
+ */
+class DyNTS_ElevenLabsRegion_Util {
+    /** Host per environment. */
+    static baseUrls = {
+        global: 'https://api.elevenlabs.io',
+        us: 'https://api.us.elevenlabs.io',
+        'eu-residency': 'https://api.eu.residency.elevenlabs.io',
+        'india-residency': 'https://api.in.residency.elevenlabs.io',
+        'singapore-residency': 'https://api.sg.residency.elevenlabs.io',
+    };
+    /**
+     * Accepts only the documented environments; `undefined` means `global`.
+     *
+     * @param value The raw value, typically `process.env.ELEVENLABS_ENVIRONMENT`.
+     */
+    static resolveEnvironment(value) {
+        switch (value) {
+            case undefined:
+            case 'global':
+                return 'global';
+            case 'us':
+                return 'us';
+            case 'eu-residency':
+                return 'eu-residency';
+            case 'india-residency':
+                return 'india-residency';
+            case 'singapore-residency':
+                return 'singapore-residency';
+            default:
+                throw new Error(`DyNTS_ElevenLabsRegion_Util: unsupported ElevenLabs environment '${value}'. `
+                    + `Supported: ${Object.keys(DyNTS_ElevenLabsRegion_Util.baseUrls).join(', ')}.`);
+        }
+    }
+    /** The API host of one environment. */
+    static getBaseUrl(environment) {
+        return DyNTS_ElevenLabsRegion_Util.baseUrls[environment];
+    }
+}
+exports.DyNTS_ElevenLabsRegion_Util = DyNTS_ElevenLabsRegion_Util;
+//# sourceMappingURL=elevenlabs-region.util.js.map

package/build/_modules/media-gen/_collections/elevenlabs-region.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-region.util.js","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_collections/elevenlabs-region.util.ts"],"names":[],"mappings":";;;AAQA;;;;;;GAMG;AACH,MAAa,2BAA2B;IAEtC,4BAA4B;IACpB,MAAM,CAAU,QAAQ,GAAiD;QAC/E,MAAM,EAAE,2BAA2B;QACnC,EAAE,EAAE,8BAA8B;QAClC,cAAc,EAAE,wCAAwC;QACxD,iBAAiB,EAAE,wCAAwC;QAC3D,qBAAqB,EAAE,wCAAwC;KAChE,CAAC;IAEF;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAyB;QACjD,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,SAAS,CAAC;YACf,KAAK,QAAQ;gBACX,OAAO,QAAQ,CAAC;YAClB,KAAK,IAAI;gBACP,OAAO,IAAI,CAAC;YACd,KAAK,cAAc;gBACjB,OAAO,cAAc,CAAC;YACxB,KAAK,iBAAiB;gBACpB,OAAO,iBAAiB,CAAC;YAC3B,KAAK,qBAAqB;gBACxB,OAAO,qBAAqB,CAAC;YAC/B;gBACE,MAAM,IAAI,KAAK,CACb,oEAAoE,KAAK,KAAK;sBAC5E,cAAc,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAChF,CAAC;QACN,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,MAAM,CAAC,UAAU,CAAC,WAAyC;QACzD,OAAO,2BAA2B,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC3D,CAAC;;AAxCH,kEAyCC"}

package/build/_modules/media-gen/_collections/media-gen-prompt.util.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Placeholder handling for media-generation prompt templates.
+ *
+ * A template marks an input as `Đ{key}` - the marker the master-prompter flow runner already uses
+ * (`PromptKeys_Util`), so its templates work unchanged. A key may contain any character except `}`.
+ */
+export declare class DyNTS_MediaGen_Prompt_Util {
+    /** `Đ{` + one or more non-`}` characters + `}`. Only used via `matchAll` / `replace`, which share no state. */
+    private static readonly placeholderPattern;
+    /**
+     * The distinct keys a template references, in first-appearance order.
+     */
+    static getKeys(template: string): string[];
+    /**
+     * Fills every placeholder of `template` from `values`, and returns the exact prompt.
+     *
+     * Refuses - naming EVERY offending key at once - when a referenced key has no own value (absent, `undefined`,
+     * `null` or an empty string) or holds an object or function. A prompt with a hole in it still costs a paid call
+     * and produces a wrong asset; and an object would silently render as `[object Object]`, which the
+     * master-prompter donor measured happening in a real prompt.
+     */
+    static fill(template: string, values: Record<string, unknown>): string;
+}
+//# sourceMappingURL=media-gen-prompt.util.d.ts.map

package/build/_modules/media-gen/_collections/media-gen-prompt.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-gen-prompt.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_collections/media-gen-prompt.util.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,0BAA0B;IAErC,+GAA+G;IAC/G,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAErE;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAY1C;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CA8BvE"}

package/build/_modules/media-gen/_collections/media-gen-prompt.util.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_MediaGen_Prompt_Util = void 0;
+/**
+ * Placeholder handling for media-generation prompt templates.
+ *
+ * A template marks an input as `Đ{key}` - the marker the master-prompter flow runner already uses
+ * (`PromptKeys_Util`), so its templates work unchanged. A key may contain any character except `}`.
+ */
+class DyNTS_MediaGen_Prompt_Util {
+    /** `Đ{` + one or more non-`}` characters + `}`. Only used via `matchAll` / `replace`, which share no state. */
+    static placeholderPattern = /Đ\{([^}]+)\}/g;
+    /**
+     * The distinct keys a template references, in first-appearance order.
+     */
+    static getKeys(template) {
+        const keys = [];
+        for (const match of template.matchAll(DyNTS_MediaGen_Prompt_Util.placeholderPattern)) {
+            if (!keys.includes(match[1])) {
+                keys.push(match[1]);
+            }
+        }
+        return keys;
+    }
+    /**
+     * Fills every placeholder of `template` from `values`, and returns the exact prompt.
+     *
+     * Refuses - naming EVERY offending key at once - when a referenced key has no own value (absent, `undefined`,
+     * `null` or an empty string) or holds an object or function. A prompt with a hole in it still costs a paid call
+     * and produces a wrong asset; and an object would silently render as `[object Object]`, which the
+     * master-prompter donor measured happening in a real prompt.
+     */
+    static fill(template, values) {
+        if (!template) {
+            throw new Error('DyNTS_MediaGen_Prompt_Util: the prompt template is empty.');
+        }
+        const keys = DyNTS_MediaGen_Prompt_Util.getKeys(template);
+        const missing = keys.filter((key) => {
+            const value = Object.prototype.hasOwnProperty.call(values, key) ? values[key] : undefined;
+            return value === undefined || value === null || value === '';
+        });
+        const notText = keys.filter((key) => {
+            const value = Object.prototype.hasOwnProperty.call(values, key) ? values[key] : undefined;
+            return value !== null && (typeof value === 'object' || typeof value === 'function');
+        });
+        if (missing.length || notText.length) {
+            throw new Error('DyNTS_MediaGen_Prompt_Util: the prompt template cannot be filled.'
+                + (missing.length ? ` No value for: ${missing.join(', ')}.` : '')
+                + (notText.length ? ` Not a text value (object or function): ${notText.join(', ')}.` : ''));
+        }
+        return template.replace(DyNTS_MediaGen_Prompt_Util.placeholderPattern, (placeholder, key) => String(values[key]));
+    }
+}
+exports.DyNTS_MediaGen_Prompt_Util = DyNTS_MediaGen_Prompt_Util;
+//# sourceMappingURL=media-gen-prompt.util.js.map

package/build/_modules/media-gen/_collections/media-gen-prompt.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-gen-prompt.util.js","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_collections/media-gen-prompt.util.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,MAAa,0BAA0B;IAErC,+GAA+G;IACvG,MAAM,CAAU,kBAAkB,GAAW,eAAe,CAAC;IAErE;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,QAAgB;QAC7B,MAAM,IAAI,GAAa,EAAE,CAAC;QAE1B,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,0BAA0B,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACrF,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,CAAC,QAAgB,EAAE,MAA+B;QAC3D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,IAAI,GAAa,0BAA0B,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpE,MAAM,OAAO,GAAa,IAAI,CAAC,MAAM,CAAC,CAAC,GAAW,EAAW,EAAE;YAC7D,MAAM,KAAK,GAAY,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAEnG,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QAC/D,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAa,IAAI,CAAC,MAAM,CAAC,CAAC,GAAW,EAAW,EAAE;YAC7D,MAAM,KAAK,GAAY,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAEnG,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CACb,mEAAmE;kBACjE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;kBAC/D,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,2CAA2C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAC3F,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,OAAO,CACrB,0BAA0B,CAAC,kBAAkB,EAC7C,CAAC,WAAmB,EAAE,GAAW,EAAU,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAClE,CAAC;IACJ,CAAC;;AAzDH,gEA0DC"}

package/build/_modules/media-gen/_models/elevenlabs-settings.interface.d.ts

@@ -0,0 +1,18 @@
+/** The HTTP call an ElevenLabs adapter makes - injectable, so specs assert the request without a network or a key. */
+export type DyNTS_ElevenLabs_Fetch = (url: string, init: RequestInit) => Promise<Response>;
+/**
+ * Settings of the ElevenLabs adapters. Every field is optional; what is left out is read from the environment
+ * AT CALL TIME, so a rotated key or a changed region takes effect without rebuilding the adapter.
+ */
+export interface DyNTS_ElevenLabs_Settings {
+    /** API key. Falls back to `ELEVENLABS_API_KEY`. */
+    apiKey?: string;
+    /**
+     * Environment: `global` (default), `us`, `eu-residency`, `india-residency`, `singapore-residency`.
+     * Falls back to `ELEVENLABS_ENVIRONMENT`. An unknown value is refused, never mapped to the global host.
+     */
+    environment?: string;
+    /** HTTP implementation. Defaults to the global `fetch`. */
+    fetchImpl?: DyNTS_ElevenLabs_Fetch;
+}
+//# sourceMappingURL=elevenlabs-settings.interface.d.ts.map

package/build/_modules/media-gen/_models/elevenlabs-settings.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-settings.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_models/elevenlabs-settings.interface.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,MAAM,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE3F;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC"}

package/build/_modules/media-gen/_models/elevenlabs-settings.interface.js

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

package/build/_modules/media-gen/_models/elevenlabs-settings.interface.js.map

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

package/build/_modules/media-gen/_models/media-gen-operation.type.d.ts

@@ -0,0 +1,9 @@
+/**
+ * What a media-generation adapter can be asked to do - the registry's second key.
+ *
+ * A string union, not an enum, like `DyNTS_AI_EmbeddingProviderKey`: adapters and callers pass plain ids.
+ * The set covers the master-prompter provider table (`textToImage`, `imageTo3D`, `textTo3D`, `textToSpeech`)
+ * plus the two operations the `dc media-*` commands already serve (`image-edit`, `speech-to-text`).
+ */
+export type DyNTS_MediaGen_Operation = 'text-to-image' | 'image-edit' | 'text-to-speech' | 'speech-to-text' | 'image-to-3d' | 'text-to-3d';
+//# sourceMappingURL=media-gen-operation.type.d.ts.map

package/build/_modules/media-gen/_models/media-gen-operation.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-gen-operation.type.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_models/media-gen-operation.type.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAChC,eAAe,GACf,YAAY,GACZ,gBAAgB,GAChB,gBAAgB,GAChB,aAAa,GACb,YAAY,CAAC"}

package/build/_modules/media-gen/_models/media-gen-operation.type.js

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

package/build/_modules/media-gen/_models/media-gen-operation.type.js.map

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

package/build/_modules/media-gen/_services/elevenlabs-speak.control-service.d.ts

@@ -0,0 +1,23 @@
+import { DyFM_AI_Speech_Request, DyFM_AI_Speech_Response } from '@futdevpro/fsm-dynamo/ai';
+import { DyNTS_ElevenLabs_ServiceBase } from './elevenlabs.service-base';
+import { DyNTS_MediaGen_Operation } from '../_models/media-gen-operation.type';
+/**
+ * ElevenLabs text-to-speech adapter.
+ *
+ * Request shape verified against the provider's API reference (2026-09-14): `POST /v1/text-to-speech/{voice_id}`,
+ * `xi-api-key` header, `output_format` query parameter, JSON body `{ text, model_id }`, binary audio response.
+ * The same shape `dc media-speech` already sends.
+ */
+export declare class DyNTS_ElevenLabs_Speak_ControlService extends DyNTS_ElevenLabs_ServiceBase<DyFM_AI_Speech_Request, DyFM_AI_Speech_Response> {
+    /** The provider's documented default output format (API reference, 2026-09-14). */
+    static readonly defaultFormat: string;
+    readonly operations: readonly DyNTS_MediaGen_Operation[];
+    static getInstance(): DyNTS_ElevenLabs_Speak_ControlService;
+    /**
+     * Speaks `request.text` with `request.voice`, and returns the audio as base64 with the media type the provider
+     * reported. A voice is REQUIRED: the provider has no meaningful default, and a silently picked one would be a
+     * choice the caller never made.
+     */
+    generate(operation: DyNTS_MediaGen_Operation, request: DyFM_AI_Speech_Request, issuer: string): Promise<DyFM_AI_Speech_Response>;
+}
+//# sourceMappingURL=elevenlabs-speak.control-service.d.ts.map

package/build/_modules/media-gen/_services/elevenlabs-speak.control-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-speak.control-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/elevenlabs-speak.control-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAE3F,OAAO,EAA+B,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACtG,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAE/E;;;;;;GAMG;AACH,qBAAa,qCACX,SAAQ,4BAA4B,CAAC,sBAAsB,EAAE,uBAAuB,CAAC;IAErF,mFAAmF;IACnF,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAmB;IAExD,QAAQ,CAAC,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAwB;IAEhF,MAAM,CAAC,WAAW,IAAI,qCAAqC;IAI3D;;;;OAIG;IACG,QAAQ,CACZ,SAAS,EAAE,wBAAwB,EACnC,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,uBAAuB,CAAC;CAuCpC"}

package/build/_modules/media-gen/_services/elevenlabs-speak.control-service.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_ElevenLabs_Speak_ControlService = void 0;
+const elevenlabs_service_base_1 = require("./elevenlabs.service-base");
+/**
+ * ElevenLabs text-to-speech adapter.
+ *
+ * Request shape verified against the provider's API reference (2026-09-14): `POST /v1/text-to-speech/{voice_id}`,
+ * `xi-api-key` header, `output_format` query parameter, JSON body `{ text, model_id }`, binary audio response.
+ * The same shape `dc media-speech` already sends.
+ */
+class DyNTS_ElevenLabs_Speak_ControlService extends elevenlabs_service_base_1.DyNTS_ElevenLabs_ServiceBase {
+    /** The provider's documented default output format (API reference, 2026-09-14). */
+    static defaultFormat = 'mp3_44100_128';
+    operations = ['text-to-speech'];
+    static getInstance() {
+        return DyNTS_ElevenLabs_Speak_ControlService.getSingletonInstance();
+    }
+    /**
+     * Speaks `request.text` with `request.voice`, and returns the audio as base64 with the media type the provider
+     * reported. A voice is REQUIRED: the provider has no meaningful default, and a silently picked one would be a
+     * choice the caller never made.
+     */
+    async generate(operation, request, issuer) {
+        this.assertOperation(operation, issuer);
+        if (!request.text) {
+            throw this.invalidRequest('The text to speak is empty.', issuer);
+        }
+        if (!request.voice) {
+            throw this.invalidRequest('A voice id is required: the provider has no default voice.', issuer);
+        }
+        const connection = this.connection(issuer);
+        const format = request.format ?? DyNTS_ElevenLabs_Speak_ControlService.defaultFormat;
+        const url = `${connection.baseUrl}/v1/text-to-speech/${encodeURIComponent(request.voice)}`
+            + `?output_format=${encodeURIComponent(format)}`;
+        const response = await connection.doFetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'xi-api-key': connection.apiKey },
+            body: JSON.stringify({ text: request.text, model_id: request.model }),
+        });
+        await this.failOnHttpError(response, url, issuer);
+        const audio = Buffer.from(await response.arrayBuffer());
+        if (!audio.length) {
+            throw this.invalidRequest(`ElevenLabs returned an empty audio body (${url}).`, issuer);
+        }
+        return {
+            provider: this.provider,
+            model: request.model,
+            audio: {
+                mimeType: response.headers.get('content-type') ?? 'application/octet-stream',
+                base64: audio.toString('base64'),
+            },
+            format: format,
+        };
+    }
+}
+exports.DyNTS_ElevenLabs_Speak_ControlService = DyNTS_ElevenLabs_Speak_ControlService;
+//# sourceMappingURL=elevenlabs-speak.control-service.js.map

package/build/_modules/media-gen/_services/elevenlabs-speak.control-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-speak.control-service.js","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/elevenlabs-speak.control-service.ts"],"names":[],"mappings":";;;AAEA,uEAAsG;AAGtG;;;;;;GAMG;AACH,MAAa,qCACX,SAAQ,sDAA6E;IAErF,mFAAmF;IACnF,MAAM,CAAU,aAAa,GAAW,eAAe,CAAC;IAE/C,UAAU,GAAwC,CAAE,gBAAgB,CAAE,CAAC;IAEhF,MAAM,CAAC,WAAW;QAChB,OAAO,qCAAqC,CAAC,oBAAoB,EAAE,CAAC;IACtE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CACZ,SAAmC,EACnC,OAA+B,EAC/B,MAAc;QAEd,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAExC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,cAAc,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,cAAc,CAAC,4DAA4D,EAAE,MAAM,CAAC,CAAC;QAClG,CAAC;QAED,MAAM,UAAU,GAAgC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxE,MAAM,MAAM,GAAW,OAAO,CAAC,MAAM,IAAI,qCAAqC,CAAC,aAAa,CAAC;QAC7F,MAAM,GAAG,GAAW,GAAG,UAAU,CAAC,OAAO,sBAAsB,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;cAC9F,kBAAkB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAa,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE;YACvD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,CAAC,MAAM,EAAE;YAChF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;SACtE,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAElD,MAAM,KAAK,GAAW,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QAEhE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,cAAc,CAAC,4CAA4C,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;QACzF,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE;gBACL,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,0BAA0B;gBAC5E,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;aACjC;YACD,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC;;AA3DH,sFA4DC"}

package/build/_modules/media-gen/_services/elevenlabs-transcribe.control-service.d.ts

@@ -0,0 +1,23 @@
+import { DyFM_AI_Transcription_Request, DyFM_AI_Transcription_Response } from '@futdevpro/fsm-dynamo/ai';
+import { DyNTS_ElevenLabs_ServiceBase } from './elevenlabs.service-base';
+import { DyNTS_MediaGen_Operation } from '../_models/media-gen-operation.type';
+/**
+ * ElevenLabs speech-to-text adapter.
+ *
+ * Request shape verified against the provider's API reference (2026-09-14): `POST /v1/speech-to-text`,
+ * `xi-api-key` header, `multipart/form-data` with the required `model_id`, the audio as `file`, and an optional
+ * `language_code`; the JSON response carries `text` and `language_code`.
+ * ⚠️ `dc media-speech` deliberately did not build this path, because no working call existed to copy - this
+ * adapter is built from the reference and exercised by specs; no live call has been made yet.
+ */
+export declare class DyNTS_ElevenLabs_Transcribe_ControlService extends DyNTS_ElevenLabs_ServiceBase<DyFM_AI_Transcription_Request, DyFM_AI_Transcription_Response> {
+    readonly operations: readonly DyNTS_MediaGen_Operation[];
+    static getInstance(): DyNTS_ElevenLabs_Transcribe_ControlService;
+    /** Reads a field of an unknown JSON value without assuming its shape. */
+    private static readField;
+    /**
+     * Transcribes `request.audio`, and returns the transcript with the language the provider reported.
+     */
+    generate(operation: DyNTS_MediaGen_Operation, request: DyFM_AI_Transcription_Request, issuer: string): Promise<DyFM_AI_Transcription_Response>;
+}
+//# sourceMappingURL=elevenlabs-transcribe.control-service.d.ts.map

package/build/_modules/media-gen/_services/elevenlabs-transcribe.control-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-transcribe.control-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/elevenlabs-transcribe.control-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAEzG,OAAO,EAA+B,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACtG,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAE/E;;;;;;;;GAQG;AACH,qBAAa,0CACX,SAAQ,4BAA4B,CAAC,6BAA6B,EAAE,8BAA8B,CAAC;IAEnG,QAAQ,CAAC,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAwB;IAEhF,MAAM,CAAC,WAAW,IAAI,0CAA0C;IAIhE,yEAAyE;IACzE,OAAO,CAAC,MAAM,CAAC,SAAS;IAIxB;;OAEG;IACG,QAAQ,CACZ,SAAS,EAAE,wBAAwB,EACnC,OAAO,EAAE,6BAA6B,EACtC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,8BAA8B,CAAC;CA8C3C"}

package/build/_modules/media-gen/_services/elevenlabs-transcribe.control-service.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_ElevenLabs_Transcribe_ControlService = void 0;
+const elevenlabs_service_base_1 = require("./elevenlabs.service-base");
+/**
+ * ElevenLabs speech-to-text adapter.
+ *
+ * Request shape verified against the provider's API reference (2026-09-14): `POST /v1/speech-to-text`,
+ * `xi-api-key` header, `multipart/form-data` with the required `model_id`, the audio as `file`, and an optional
+ * `language_code`; the JSON response carries `text` and `language_code`.
+ * ⚠️ `dc media-speech` deliberately did not build this path, because no working call existed to copy - this
+ * adapter is built from the reference and exercised by specs; no live call has been made yet.
+ */
+class DyNTS_ElevenLabs_Transcribe_ControlService extends elevenlabs_service_base_1.DyNTS_ElevenLabs_ServiceBase {
+    operations = ['speech-to-text'];
+    static getInstance() {
+        return DyNTS_ElevenLabs_Transcribe_ControlService.getSingletonInstance();
+    }
+    /** Reads a field of an unknown JSON value without assuming its shape. */
+    static readField(json, key) {
+        return json !== null && typeof json === 'object' ? Reflect.get(json, key) : undefined;
+    }
+    /**
+     * Transcribes `request.audio`, and returns the transcript with the language the provider reported.
+     */
+    async generate(operation, request, issuer) {
+        this.assertOperation(operation, issuer);
+        if (!request.audio?.base64) {
+            throw this.invalidRequest('The audio to transcribe is empty.', issuer);
+        }
+        const connection = this.connection(issuer);
+        const url = `${connection.baseUrl}/v1/speech-to-text`;
+        const form = new FormData();
+        form.append('model_id', request.model);
+        form.append('file', new Blob([new Uint8Array(Buffer.from(request.audio.base64, 'base64'))], { type: request.audio.mimeType }), request.audio.name ?? 'audio');
+        if (request.language) {
+            form.append('language_code', request.language);
+        }
+        const response = await connection.doFetch(url, {
+            method: 'POST',
+            headers: { 'xi-api-key': connection.apiKey },
+            body: form,
+        });
+        await this.failOnHttpError(response, url, issuer);
+        const json = await response.json();
+        const text = DyNTS_ElevenLabs_Transcribe_ControlService.readField(json, 'text');
+        const language = DyNTS_ElevenLabs_Transcribe_ControlService.readField(json, 'language_code');
+        if (typeof text !== 'string') {
+            throw this.invalidRequest(`ElevenLabs returned no transcript text (${url}).`, issuer);
+        }
+        return {
+            provider: this.provider,
+            model: request.model,
+            text: text,
+            ...(typeof language === 'string' ? { language: language } : {}),
+            rawResponse: json,
+        };
+    }
+}
+exports.DyNTS_ElevenLabs_Transcribe_ControlService = DyNTS_ElevenLabs_Transcribe_ControlService;
+//# sourceMappingURL=elevenlabs-transcribe.control-service.js.map

package/build/_modules/media-gen/_services/elevenlabs-transcribe.control-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-transcribe.control-service.js","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/elevenlabs-transcribe.control-service.ts"],"names":[],"mappings":";;;AAEA,uEAAsG;AAGtG;;;;;;;;GAQG;AACH,MAAa,0CACX,SAAQ,sDAA2F;IAE1F,UAAU,GAAwC,CAAE,gBAAgB,CAAE,CAAC;IAEhF,MAAM,CAAC,WAAW;QAChB,OAAO,0CAA0C,CAAC,oBAAoB,EAAE,CAAC;IAC3E,CAAC;IAED,yEAAyE;IACjE,MAAM,CAAC,SAAS,CAAC,IAAa,EAAE,GAAW;QACjD,OAAO,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,SAAmC,EACnC,OAAsC,EACtC,MAAc;QAEd,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAExC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,cAAc,CAAC,mCAAmC,EAAE,MAAM,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,UAAU,GAAgC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxE,MAAM,GAAG,GAAW,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC;QAC9D,MAAM,IAAI,GAAa,IAAI,QAAQ,EAAE,CAAC;QAEtC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CACT,MAAM,EACN,IAAI,IAAI,CAAC,CAAE,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,EAC3G,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAC9B,CAAC;QAEF,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,QAAQ,GAAa,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE;YACvD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,YAAY,EAAE,UAAU,CAAC,MAAM,EAAE;YAC5C,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAElD,MAAM,IAAI,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAY,0CAA0C,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzF,MAAM,QAAQ,GAAY,0CAA0C,CAAC,SAAS,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QAEtG,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,cAAc,CAAC,2CAA2C,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;QACxF,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,IAAI;YACV,GAAG,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;CACF;AAnED,gGAmEC"}

package/build/_modules/media-gen/_services/elevenlabs.service-base.d.ts

@@ -0,0 +1,33 @@
+import { DyFM_Error } from '@futdevpro/fsm-dynamo';
+import { DyNTS_ElevenLabs_Fetch, DyNTS_ElevenLabs_Settings } from '../_models/elevenlabs-settings.interface';
+import { DyNTS_MediaGen_Operation } from '../_models/media-gen-operation.type';
+import { DyNTS_MediaGen_ServiceBase } from './media-gen.service-base';
+/** What one ElevenLabs call needs, resolved at call time. */
+export interface DyNTS_ElevenLabs_Connection {
+    baseUrl: string;
+    apiKey: string;
+    doFetch: DyNTS_ElevenLabs_Fetch;
+}
+/**
+ * Shared part of the ElevenLabs adapters: connection resolution and HTTP error reporting.
+ *
+ * Every refusal happens BEFORE the paid call: an unknown environment, a missing key, an operation the adapter
+ * does not serve. The key travels only in the `xi-api-key` header, so the URLs recorded in errors carry no secret.
+ */
+export declare abstract class DyNTS_ElevenLabs_ServiceBase<T_Request, T_Response> extends DyNTS_MediaGen_ServiceBase<T_Request, T_Response> {
+    readonly provider: string;
+    protected readonly settings: DyNTS_ElevenLabs_Settings;
+    constructor(settings?: DyNTS_ElevenLabs_Settings);
+    /** Refuses an operation this adapter does not declare. */
+    protected assertOperation(operation: DyNTS_MediaGen_Operation, issuer: string): void;
+    /** Resolves the host, the key and the HTTP implementation for one call. */
+    protected connection(issuer: string): DyNTS_ElevenLabs_Connection;
+    /**
+     * Throws a detailed error for a non-2xx response. A 401 is named: its repeatedly hit cause is a key ID or
+     * a hint pasted instead of the full secret, which looks like a valid credential.
+     */
+    protected failOnHttpError(response: Response, url: string, issuer: string): Promise<void>;
+    /** A refusal of the caller's request, reported with this adapter's error settings. */
+    protected invalidRequest(message: string, issuer: string): DyFM_Error;
+}
+//# sourceMappingURL=elevenlabs.service-base.d.ts.map

package/build/_modules/media-gen/_services/elevenlabs.service-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.service-base.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/elevenlabs.service-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAInD,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAC7G,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE,6DAA6D;AAC7D,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAED;;;;;GAKG;AACH,8BAAsB,4BAA4B,CAAC,SAAS,EAAE,UAAU,CACtE,SAAQ,0BAA0B,CAAC,SAAS,EAAE,UAAU,CAAC;IAEzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAgB;IAEzC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;gBAE3C,QAAQ,GAAE,yBAA8B;IAKpD,0DAA0D;IAC1D,SAAS,CAAC,eAAe,CAAC,SAAS,EAAE,wBAAwB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAepF,2EAA2E;IAC3E,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,2BAA2B;IAkCjE;;;OAGG;cACa,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB/F,sFAAsF;IACtF,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU;CAMtE"}

package/build/_modules/media-gen/_services/elevenlabs.service-base.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_ElevenLabs_ServiceBase = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const elevenlabs_region_util_1 = require("../_collections/elevenlabs-region.util");
+const media_gen_service_base_1 = require("./media-gen.service-base");
+/**
+ * Shared part of the ElevenLabs adapters: connection resolution and HTTP error reporting.
+ *
+ * Every refusal happens BEFORE the paid call: an unknown environment, a missing key, an operation the adapter
+ * does not serve. The key travels only in the `xi-api-key` header, so the URLs recorded in errors carry no secret.
+ */
+class DyNTS_ElevenLabs_ServiceBase extends media_gen_service_base_1.DyNTS_MediaGen_ServiceBase {
+    provider = 'elevenlabs';
+    settings;
+    constructor(settings = {}) {
+        super();
+        this.settings = settings;
+    }
+    /** Refuses an operation this adapter does not declare. */
+    assertOperation(operation, issuer) {
+        if (!this.operations.includes(operation)) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('generate', new Error(`${this.constructor.name} does not serve '${operation}'. It serves: ${this.operations.join(', ')}.`), issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MG-EL-OP`,
+            });
+        }
+    }
+    /** Resolves the host, the key and the HTTP implementation for one call. */
+    connection(issuer) {
+        let environment;
+        try {
+            environment = elevenlabs_region_util_1.DyNTS_ElevenLabsRegion_Util.resolveEnvironment(this.settings.environment ?? process.env.ELEVENLABS_ENVIRONMENT);
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('connection', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MG-EL-ENV`,
+            });
+        }
+        const apiKey = this.settings.apiKey ?? process.env.ELEVENLABS_API_KEY;
+        if (!apiKey) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('connection', new Error('Missing ElevenLabs API key: pass settings.apiKey or set ELEVENLABS_API_KEY.'), issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MG-EL-KEY`,
+            });
+        }
+        return {
+            baseUrl: elevenlabs_region_util_1.DyNTS_ElevenLabsRegion_Util.getBaseUrl(environment),
+            apiKey: apiKey,
+            doFetch: this.settings.fetchImpl ?? ((url, init) => fetch(url, init)),
+        };
+    }
+    /**
+     * Throws a detailed error for a non-2xx response. A 401 is named: its repeatedly hit cause is a key ID or
+     * a hint pasted instead of the full secret, which looks like a valid credential.
+     */
+    async failOnHttpError(response, url, issuer) {
+        if (response.ok) {
+            return;
+        }
+        const detail = await response.text().catch(() => '');
+        const hint = response.status === 401
+            ? ' (invalid_api_key - use the full secret shown once at key creation, not a key ID or hint)'
+            : '';
+        throw new fsm_dynamo_1.DyFM_Error({
+            ...this.getDefaultErrorSettings('generate', new Error(`ElevenLabs HTTP ${response.status}${hint}: ${detail.slice(0, 500)}`), issuer),
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MG-EL-HTTP`,
+            additionalContent: {
+                status: response.status,
+                url: url,
+            },
+        });
+    }
+    /** A refusal of the caller's request, reported with this adapter's error settings. */
+    invalidRequest(message, issuer) {
+        return new fsm_dynamo_1.DyFM_Error({
+            ...this.getDefaultErrorSettings('generate', new Error(message), issuer),
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MG-EL-REQ`,
+        });
+    }
+}
+exports.DyNTS_ElevenLabs_ServiceBase = DyNTS_ElevenLabs_ServiceBase;
+//# sourceMappingURL=elevenlabs.service-base.js.map

package/build/_modules/media-gen/_services/elevenlabs.service-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.service-base.js","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/elevenlabs.service-base.ts"],"names":[],"mappings":"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"}

package/build/_modules/media-gen/_services/media-gen.registry.d.ts

@@ -0,0 +1,35 @@
+import { DyNTS_MediaGen_Operation } from '../_models/media-gen-operation.type';
+import { DyNTS_MediaGen_ServiceBase } from './media-gen.service-base';
+/** One registered pair, as `entries()` lists it. */
+export interface DyNTS_MediaGen_RegistryEntry {
+    provider: string;
+    operation: DyNTS_MediaGen_Operation;
+}
+/**
+ * The two-key registry: provider × operation → adapter.
+ *
+ * Generalised from the master-prompter `generationProviders` table (`ProviderType × AiModelType`). An instance
+ * rather than a module-level constant: a product registers the adapters it ships, and a test builds its own
+ * registry without touching global state.
+ */
+export declare class DyNTS_MediaGen_Registry {
+    private readonly services;
+    /**
+     * Registers an adapter under every operation it declares.
+     *
+     * Refuses an adapter that declares no operation (it could never be resolved), and a second, different adapter
+     * for a pair that is already taken - a silent replacement would hide which adapter actually serves the call.
+     * Registering the same instance again is a no-op.
+     */
+    register(service: DyNTS_MediaGen_ServiceBase<unknown, unknown>): void;
+    /**
+     * The adapter serving `operation` for `provider`. When there is none, the error says what IS available:
+     * the provider's operations if the provider is known, otherwise the providers serving the operation.
+     */
+    resolve(provider: string, operation: DyNTS_MediaGen_Operation): DyNTS_MediaGen_ServiceBase<unknown, unknown>;
+    /**
+     * Every registered provider × operation pair, in registration order.
+     */
+    entries(): DyNTS_MediaGen_RegistryEntry[];
+}
+//# sourceMappingURL=media-gen.registry.d.ts.map

package/build/_modules/media-gen/_services/media-gen.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-gen.registry.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/media-gen.registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE,oDAAoD;AACpD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,wBAAwB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,qBAAa,uBAAuB;IAElC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CACb;IAEZ;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI;IA2BrE;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,wBAAwB,GAAG,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC;IA2B5G;;OAEG;IACH,OAAO,IAAI,4BAA4B,EAAE;CAW1C"}

package/build/_modules/media-gen/_services/media-gen.registry.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_MediaGen_Registry = void 0;
+/**
+ * The two-key registry: provider × operation → adapter.
+ *
+ * Generalised from the master-prompter `generationProviders` table (`ProviderType × AiModelType`). An instance
+ * rather than a module-level constant: a product registers the adapters it ships, and a test builds its own
+ * registry without touching global state.
+ */
+class DyNTS_MediaGen_Registry {
+    services = new Map();
+    /**
+     * Registers an adapter under every operation it declares.
+     *
+     * Refuses an adapter that declares no operation (it could never be resolved), and a second, different adapter
+     * for a pair that is already taken - a silent replacement would hide which adapter actually serves the call.
+     * Registering the same instance again is a no-op.
+     */
+    register(service) {
+        if (!service.operations.length) {
+            throw new Error(`DyNTS_MediaGen_Registry: ${service.constructor.name} (provider '${service.provider}') declares no operations.`);
+        }
+        const byOperation = this.services.get(service.provider) ?? new Map();
+        for (const operation of service.operations) {
+            const existing = byOperation.get(operation);
+            if (existing && existing !== service) {
+                throw new Error(`DyNTS_MediaGen_Registry: '${operation}' of provider '${service.provider}' is already served by `
+                    + `${existing.constructor.name}; registering ${service.constructor.name} would silently replace it.`);
+            }
+        }
+        for (const operation of service.operations) {
+            byOperation.set(operation, service);
+        }
+        this.services.set(service.provider, byOperation);
+    }
+    /**
+     * The adapter serving `operation` for `provider`. When there is none, the error says what IS available:
+     * the provider's operations if the provider is known, otherwise the providers serving the operation.
+     */
+    resolve(provider, operation) {
+        const service = this.services.get(provider)?.get(operation);
+        if (service) {
+            return service;
+        }
+        const providerOperations = [...(this.services.get(provider)?.keys() ?? [])];
+        if (providerOperations.length) {
+            throw new Error(`DyNTS_MediaGen_Registry: provider '${provider}' does not serve '${operation}'. `
+                + `It serves: ${providerOperations.join(', ')}.`);
+        }
+        const operationProviders = this.entries()
+            .filter((entry) => entry.operation === operation)
+            .map((entry) => entry.provider);
+        throw new Error(`DyNTS_MediaGen_Registry: no provider '${provider}' is registered. `
+            + `'${operation}' is served by: ${operationProviders.length ? operationProviders.join(', ') : 'no provider'}.`);
+    }
+    /**
+     * Every registered provider × operation pair, in registration order.
+     */
+    entries() {
+        const entries = [];
+        for (const [provider, byOperation] of this.services) {
+            for (const operation of byOperation.keys()) {
+                entries.push({ provider: provider, operation: operation });
+            }
+        }
+        return entries;
+    }
+}
+exports.DyNTS_MediaGen_Registry = DyNTS_MediaGen_Registry;
+//# sourceMappingURL=media-gen.registry.js.map

package/build/_modules/media-gen/_services/media-gen.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-gen.registry.js","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/media-gen.registry.ts"],"names":[],"mappings":"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"}

package/build/_modules/media-gen/_services/media-gen.service-base.d.ts

@@ -0,0 +1,30 @@
+import { DyNTS_SingletonService } from '../../../_services/base/singleton.service';
+import { DyNTS_MediaGen_Operation } from '../_models/media-gen-operation.type';
+/**
+ * Base of one media-generation provider adapter (OpenAI Images, ElevenLabs, Leonardo, Meshy, Synexa, ...).
+ *
+ * Generalised from the master-prompter `Generation_ServiceBase`. Two things are left out on purpose:
+ * - the flow-run coupling (step connectors, flow nodes) - a request object replaces it;
+ * - the token-cost methods - cost accounting stays in the product that sells the credits (K-9).
+ *
+ * What remains is what every adapter needs: who it is, which operations it serves, the call itself, and
+ * prompt assembly from a `Đ{key}` template. Capability is data: `operations` is what the registry indexes,
+ * so an adapter that cannot edit simply does not list `image-edit`, and a caller asking for it is told what
+ * the adapter CAN do.
+ */
+export declare abstract class DyNTS_MediaGen_ServiceBase<T_Request, T_Response> extends DyNTS_SingletonService {
+    /** Stable provider id (e.g. `openai`, `elevenlabs`) - the registry's first key. */
+    abstract readonly provider: string;
+    /** The operations this adapter serves - the registry's second key. Must match what `generate` handles. */
+    abstract readonly operations: readonly DyNTS_MediaGen_Operation[];
+    /**
+     * Performs one generation.
+     */
+    abstract generate(operation: DyNTS_MediaGen_Operation, request: T_Request, issuer: string): Promise<T_Response>;
+    /**
+     * Assembles the exact prompt from a `Đ{key}` template (see `DyNTS_MediaGen_Prompt_Util.fill`), and reports
+     * a failure with this adapter's error settings.
+     */
+    protected assemblePrompt(template: string, values: Record<string, unknown>, issuer: string): string;
+}
+//# sourceMappingURL=media-gen.service-base.d.ts.map

package/build/_modules/media-gen/_services/media-gen.service-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-gen.service-base.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/media-gen.service-base.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAEnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAE/E;;;;;;;;;;;GAWG;AACH,8BAAsB,0BAA0B,CAAC,SAAS,EAAE,UAAU,CAAE,SAAQ,sBAAsB;IAEpG,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAEnC,0GAA0G;IAC1G,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAElE;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,wBAAwB,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAE/G;;;OAGG;IACH,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;CAepG"}

package/build/_modules/media-gen/_services/media-gen.service-base.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_MediaGen_ServiceBase = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const singleton_service_1 = require("../../../_services/base/singleton.service");
+const media_gen_prompt_util_1 = require("../_collections/media-gen-prompt.util");
+/**
+ * Base of one media-generation provider adapter (OpenAI Images, ElevenLabs, Leonardo, Meshy, Synexa, ...).
+ *
+ * Generalised from the master-prompter `Generation_ServiceBase`. Two things are left out on purpose:
+ * - the flow-run coupling (step connectors, flow nodes) - a request object replaces it;
+ * - the token-cost methods - cost accounting stays in the product that sells the credits (K-9).
+ *
+ * What remains is what every adapter needs: who it is, which operations it serves, the call itself, and
+ * prompt assembly from a `Đ{key}` template. Capability is data: `operations` is what the registry indexes,
+ * so an adapter that cannot edit simply does not list `image-edit`, and a caller asking for it is told what
+ * the adapter CAN do.
+ */
+class DyNTS_MediaGen_ServiceBase extends singleton_service_1.DyNTS_SingletonService {
+    /**
+     * Assembles the exact prompt from a `Đ{key}` template (see `DyNTS_MediaGen_Prompt_Util.fill`), and reports
+     * a failure with this adapter's error settings.
+     */
+    assemblePrompt(template, values, issuer) {
+        try {
+            return media_gen_prompt_util_1.DyNTS_MediaGen_Prompt_Util.fill(template, values);
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('assemblePrompt', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MG-AP0`,
+                additionalContent: {
+                    provider: this.provider,
+                    keys: media_gen_prompt_util_1.DyNTS_MediaGen_Prompt_Util.getKeys(template ?? ''),
+                    providedKeys: Object.keys(values ?? {}),
+                },
+            });
+        }
+    }
+}
+exports.DyNTS_MediaGen_ServiceBase = DyNTS_MediaGen_ServiceBase;
+//# sourceMappingURL=media-gen.service-base.js.map

package/build/_modules/media-gen/_services/media-gen.service-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-gen.service-base.js","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/media-gen.service-base.ts"],"names":[],"mappings":";;;AAAA,sDAAmD;AAEnD,uFAAoF;AACpF,iFAAmF;AACnF,iFAAmF;AAGnF;;;;;;;;;;;GAWG;AACH,MAAsB,0BAAkD,SAAQ,0CAAsB;IAapG;;;OAGG;IACO,cAAc,CAAC,QAAgB,EAAE,MAA+B,EAAE,MAAc;QACxF,IAAI,CAAC;YACH,OAAO,kDAA0B,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,uBAAU,CAAC;gBACnB,GAAG,IAAI,CAAC,uBAAuB,CAAC,gBAAgB,EAAE,KAAK,EAAE,MAAM,CAAC;gBAChE,SAAS,EAAE,GAAG,6CAAqB,CAAC,mBAAmB,eAAe;gBACtE,iBAAiB,EAAE;oBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,IAAI,EAAE,kDAA0B,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;oBACxD,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;iBACxC;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAhCD,gEAgCC"}

package/build/_modules/media-gen/index.d.ts

@@ -0,0 +1,10 @@
+export * from './_models/elevenlabs-settings.interface';
+export * from './_models/media-gen-operation.type';
+export * from './_collections/elevenlabs-region.util';
+export * from './_collections/media-gen-prompt.util';
+export * from './_services/media-gen.service-base';
+export * from './_services/media-gen.registry';
+export * from './_services/elevenlabs.service-base';
+export * from './_services/elevenlabs-speak.control-service';
+export * from './_services/elevenlabs-transcribe.control-service';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/media-gen/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/media-gen/index.ts"],"names":[],"mappings":"AAUA,cAAc,yCAAyC,CAAC;AACxD,cAAc,oCAAoC,CAAC;AAGnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AAGrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,mDAAmD,CAAC"}

package/build/_modules/media-gen/index.js

@@ -0,0 +1,22 @@
+"use strict";
+//
+// Media generation module (media-generation hyperplan, MP-5)
+//
+// The provider-independent generation engine: an adapter base class and the provider × operation registry.
+// Cost accounting is deliberately NOT here - it stays in the product that sells the credits.
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// MODELS
+tslib_1.__exportStar(require("./_models/elevenlabs-settings.interface"), exports);
+tslib_1.__exportStar(require("./_models/media-gen-operation.type"), exports);
+// COLLECTIONS
+tslib_1.__exportStar(require("./_collections/elevenlabs-region.util"), exports);
+tslib_1.__exportStar(require("./_collections/media-gen-prompt.util"), exports);
+// SERVICES
+tslib_1.__exportStar(require("./_services/media-gen.service-base"), exports);
+tslib_1.__exportStar(require("./_services/media-gen.registry"), exports);
+tslib_1.__exportStar(require("./_services/elevenlabs.service-base"), exports);
+tslib_1.__exportStar(require("./_services/elevenlabs-speak.control-service"), exports);
+tslib_1.__exportStar(require("./_services/elevenlabs-transcribe.control-service"), exports);
+//# sourceMappingURL=index.js.map

package/build/_modules/media-gen/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/media-gen/index.ts"],"names":[],"mappings":";AACA,EAAE;AACF,6DAA6D;AAC7D,EAAE;AACF,2GAA2G;AAC3G,6FAA6F;AAC7F,EAAE;;;AAGF,SAAS;AACT,kFAAwD;AACxD,6EAAmD;AAEnD,cAAc;AACd,gFAAsD;AACtD,+EAAqD;AAErD,WAAW;AACX,6EAAmD;AACnD,yEAA+C;AAC/C,8EAAoD;AACpD,uFAA6D;AAC7D,4FAAkE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.258",
+  "version": "01.15.263",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",
@@ -294,6 +294,12 @@
       "module": "./build/_modules/test-email-sink/index.js",
       "types": "./build/_modules/test-email-sink/index.d.ts",
       "typings": "./build/_modules/test-email-sink/index.d.ts"
+    },
+    "./media-gen": {
+      "default": "./build/_modules/media-gen/index.js",
+      "module": "./build/_modules/media-gen/index.js",
+      "types": "./build/_modules/media-gen/index.d.ts",
+      "typings": "./build/_modules/media-gen/index.d.ts"
     }
   },
   "typesVersions": {
@@ -399,6 +405,9 @@
       ],
       "test-email-sink": [
         "build/_modules/test-email-sink/index.d.ts"
+      ],
+      "media-gen": [
+        "build/_modules/media-gen/index.d.ts"
       ]
     }
   },
@@ -415,7 +424,7 @@
     "@anthropic-ai/sdk": "~0.39.0",
     "@modelcontextprotocol/sdk": "~1.29.0",
     "better-sqlite3": "~12.4.1",
-    "@futdevpro/fsm-dynamo": "1.20.38",
+    "@futdevpro/fsm-dynamo": "1.20.42",
     "@types/express": "4.17.21",
     "@types/geoip-lite": "~1.4.4",
     "@types/node": "~24.1.0",
@@ -454,7 +463,7 @@
     }
   },
   "devDependencies": {
-    "@futdevpro/fsm-dynamo": "1.20.38",
+    "@futdevpro/fsm-dynamo": "1.20.42",
     "@futdevpro/dynamo-eslint": "1.20.18",
     "@discordjs/opus": "^0.10.0",
     "@discordjs/voice": "^0.18.0",