@koda-sl/baker-cli 0.357.0 → 0.358.0

package/README.md

@@ -5082,8 +5082,11 @@ Cast an ElevenLabs voice from a natural-language description (e.g. a blueprint's
 |---|---|---|---|
 | `description` | string | yes | the casting brief |
 | `gender` / `age` / `accent` / `language` | string | no | structured hints that sharpen the ranking |
+| `voice_id` | string | no | a voice already chosen — skips the ranking and emits it as-is |
 | `limit` | number | no | how many `candidates` to return (default 5) |
 
+`language` is strict: when no voice on the account speaks it, the node fails (`voice_language_unavailable`) before anything downstream is voiced. `gender` is strict within that language unless nobody there has it — then it is dropped and `baker canvas run` prints a `[warn]` naming the voice cast instead.
+
 **Outputs** — `voice_id` (text, bare id) + `candidates` (json, ranked shortlist). Wire `voice_id` into a `tts` node: set `inputs.voice_ref: $ref:<this>.voice_id` and `params.voice: "{{voice_ref}}"` — the engine splices the id in at run time.
 
 **Cost** — free (voice listing). Generation is billed under `tts`/`dialogue`.

package/dist/{chunk-H3SAAHZA.js → chunk-AI4HWQVN.js}

@@ -5191,6 +5191,7 @@ var Engine = class {
         outputs[node.id] = hit.outputs;
         await this.materializeNodeOutputs(node.id, hit.outputs, writer);
         this.log(`[exec    ] ${node.id.padEnd(20)} ${node.type.padEnd(20)} cached`);
+        this.logOutputWarnings(node.id, hit.outputs);
         return { cached: true, credits: 0, durationMs: Date.now() - cacheT0 };
       }
     }
@@ -5233,8 +5234,18 @@ var Engine = class {
     }
     await this.materializeNodeOutputs(node.id, outputsObj, writer);
     this.log(`[exec    ] ${node.id.padEnd(20)} ${node.type.padEnd(20)} fresh (${(elapsed / 1e3).toFixed(1)}s)`);
+    this.logOutputWarnings(node.id, outputsObj);
     return { cached: false, credits, durationMs: elapsed };
   }
+  /**
+   * Print the warnings a node left on its outputs' metadata — a `voice_select` that
+   * could not honor the requested gender, say. Left in the metadata alone they were
+   * read only after the render was paid for and somebody listened. Printed on a
+   * cached replay too: the output still carries the compromise.
+   */
+  logOutputWarnings(nodeId, outputs) {
+    for (const warning of outputWarnings(outputs)) this.log(`[warn    ] ${nodeId}: ${warning}`);
+  }
   async materializeNodeOutputs(nodeId, outputs, writer) {
     for (const [name, value] of Object.entries(outputs)) {
       if (isAssetRef(value)) {
@@ -5279,6 +5290,16 @@ var Engine = class {
     return await fix(inputs);
   }
 };
+function refWarnings(ref) {
+  if (!isAssetRef(ref)) return [];
+  const warnings = ref.metadata?.warnings;
+  if (!Array.isArray(warnings)) return [];
+  return warnings.filter((w) => typeof w === "string" && w.length > 0);
+}
+function outputWarnings(outputs) {
+  const refs = Object.values(outputs).flatMap((value) => Array.isArray(value) ? value : [value]);
+  return [...new Set(refs.flatMap(refWarnings))];
+}
 function resolveRegenerateToken(node, forced, runId) {
   if (forced?.has(node.id)) return `run:${runId}`;
   if (node.regenerate !== void 0) return `node:${String(node.regenerate)}`;
@@ -9563,10 +9584,14 @@ var voiceSelectNode = delegated({
   // to move with it: the cache key is built from this string, so entries written under
   // 1.0.0 kept replaying the broken shape long after the fix was deployed. A node whose
   // OUTPUT shape changes has to bump, not only one whose behaviour does.
-  version: "1.1.0",
+  // 1.2.0: `language` is a hard constraint — a language no voice on the account speaks
+  // fails the node instead of casting a voice of another language, and a gender nobody
+  // in the language has is relaxed with a printed warning. Bumped so a 1.1.0 cache entry
+  // holding a wrong-language cast stops replaying.
+  version: "1.2.0",
   category: "audio",
   summary: 'Cast an ElevenLabs voice from a natural-language description (e.g. "warm, authoritative female narrator, American accent"). Lists the account\'s voices and ranks them against the brief, emitting the best `voice_id` as a bare-string text asset plus a ranked `candidates` JSON.',
-  when_to_use: 'Use to turn a voice description (e.g. from a `video_deconstruct` blueprint\'s `voice_description`) into a usable ElevenLabs voice id, then feed it into a `tts` node by wiring `inputs.voice_ref: $ref:<this>.voice_id` and setting `params.voice: "{{voice_ref}}"` \u2014 the engine splices the id in at run time. Review `candidates` (json) to pick a different voice. Optional `gender`/`age`/`accent`/`language` hints sharpen the ranking.',
+  when_to_use: 'Use to turn a voice description (e.g. from a `video_deconstruct` blueprint\'s `voice_description`) into a usable ElevenLabs voice id, then feed it into a `tts` node by wiring `inputs.voice_ref: $ref:<this>.voice_id` and setting `params.voice: "{{voice_ref}}"` \u2014 the engine splices the id in at run time. Review `candidates` (json) to pick a different voice. Optional `gender`/`age`/`accent`/`language` hints sharpen the ranking. `language` is strict: when no voice on the account speaks it the node fails before anything is voiced (add a voice in that language, or pass its `voice_id`). A `gender` nobody in that language has is dropped and `baker canvas run` prints a `[warn]` naming the voice cast instead.',
   inputs: z34.object({}).loose(),
   params: z34.object({
     description: z34.string().min(1),
@@ -9879,4 +9904,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-H3SAAHZA.js.map
+//# sourceMappingURL=chunk-AI4HWQVN.js.map