@koda-sl/baker-cli 0.353.0-dev.5340e1062 → 0.353.0-dev.5d1d795f9

package/README.md

@@ -5057,8 +5057,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`.
@@ -5553,7 +5556,7 @@ Resolves the run dir against `--outputs-dir` (default `./canvas`) or accepts an
 
 #### `baker canvas catalog`
 
-Prints the agent-facing node catalog. By default it is a compact index (a few KB): `categories` (category → node ids), `nodes` (node id → one line) and `compositions` (the Hyperframes compositions the CLI ships: `id`, `title` and the absolute `dir` to copy from), plus `hints`. `compositions` is left out once `--node` or `--category` narrows the call. Ask for full JSON Schemas by name:
+Prints the agent-facing node catalog. By default it is a compact index (a few KB): `categories` (category → node ids) and `nodes` (node id → one line), plus `hints`. Ask for full JSON Schemas by name:
 
 - `--node <id>[,<id>…]` — those nodes' full entries: `id`, `version`, `location`, `category`, `summary`, `when_to_use`, `inputs`/`params`/`outputs` schemas, `cost_estimate_credits`, `runtime_estimate_seconds`.
 - `--category <name>` — narrow the index to one category; add `--full` for that category's full entries.
@@ -5565,7 +5568,6 @@ An unknown node or category exits 1 with `{ ok: false, error: { code: "NOT_FOUND
 baker canvas catalog
 baker canvas catalog --node video_generate
 baker canvas catalog --category audio --full
-baker canvas catalog | jq '.compositions[].id'
 ```
 
 ---

package/dist/{chunk-Q2VR3FVM.js → chunk-PHHQLFY3.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),
@@ -9609,8 +9634,7 @@ function generateCatalog(registry, opts = {}) {
     schema: "baker-canvas-catalog/2",
     generated_at: opts.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
     categories: groupIds(entries),
-    entries,
-    compositions: opts.compositions ?? []
+    entries
   };
 }
 var INDEX_SUMMARY_MAX = 160;
@@ -9666,15 +9690,8 @@ function catalogView(catalog, opts) {
     const entries = catalog.entries.filter((e) => requestedIds.includes(e.id));
     return { ok: true, schema: catalog.schema, categories: groupIds(entries), entries };
   }
-  const compositions = opts.category === void 0 ? { compositions: catalog.compositions } : {};
   if (opts.full) {
-    return {
-      ok: true,
-      schema: catalog.schema,
-      categories,
-      entries: catalog.entries.filter(inCategory),
-      ...compositions
-    };
+    return { ok: true, schema: catalog.schema, categories, entries: catalog.entries.filter(inCategory) };
   }
   const nodes = {};
   for (const e of catalog.entries.filter(inCategory)) nodes[e.id] = oneLine(e.summary);
@@ -9683,13 +9700,9 @@ function catalogView(catalog, opts) {
     schema: catalog.schema,
     categories,
     nodes,
-    ...compositions,
     hints: [
       "One node's params, inputs, outputs, models and when to use it: baker canvas catalog --node <id> (comma-separate several).",
-      "Every schema in a category: --category <name> --full. Every node: --full (large; prefer --node).",
-      ...opts.category === void 0 ? [
-        "compositions: ready-made motion graphics. Copy one's `dir` next to your canvas, then point a hyperframe_render or hyperframe_snapshot `params.composition` at the copy; its meta.json lists the params."
-      ] : []
+      "Every schema in a category: --category <name> --full. Every node: --full (large; prefer --node)."
     ]
   };
 }
@@ -9879,7 +9892,6 @@ export {
   durationSeconds,
   canonicalUrl,
   toModelSafeImage,
-  loadCompositionMeta,
   catalogView,
   BackendClient2,
   Engine2 as Engine,
@@ -9891,4 +9903,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-Q2VR3FVM.js.map
+//# sourceMappingURL=chunk-PHHQLFY3.js.map