@koda-sl/baker-cli 0.357.0 → 0.359.0-dev.5dbf6338c

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`.
@@ -5289,7 +5292,7 @@ Every run gets its own directory:
 - Naming: `<node_id>__<slot>[__<index>].<ext>`.
 - `_final.<ext>` is a copy of whichever node the top-level `output` points at.
 - `manifest.json` is what `baker canvas inspect` reads — duration, cache hit/miss, asset refs, errors.
-- Default root is `./canvas/`. Override with `--outputs-dir`.
+- Default root is `canvas/` at the workspace root (the nearest folder with a `package.json` above the canvas file), whichever directory you run from. Override with `--outputs-dir`.
 
 ---
 
@@ -5301,7 +5304,7 @@ Cache key:
 sha256(canonical({ node_id, node_version, params, input_hashes, cache_salt, extras }))
 ```
 
-- Entries live in `./canvas/.cache/` (index + content-addressed blobs).
+- Entries live in `canvas/.cache/` at the workspace root (index + content-addressed blobs).
 - Cache hits re-materialize asset files into the new run dir instantly; misses execute the node and write a new entry atomically.
 - `hyperframe_*` folds a recursive sha256 of the composition directory into `extras` — edit any file in `my-composition/` and the cache busts automatically. No version bump needed.
 - If computing `extras` fails (e.g. the composition directory is unreadable), the node fails with that error — it never falls back to a partial cache key, so stale results can't be served silently.
@@ -5396,8 +5399,8 @@ Validate, then execute the graph. Blocks until done. Logs one line per node. Ret
 
 | Flag | Default | Effect |
 |---|---|---|
-| `--cache-dir <path>` | `./canvas/.cache` | Where content-addressed bytes + cache index live. |
-| `--outputs-dir <path>` | `./canvas` | Root for per-run output directories. |
+| `--cache-dir <path>` | `<workspace root>/canvas/.cache` | Where content-addressed bytes + cache index live. |
+| `--outputs-dir <path>` | `<workspace root>/canvas` | Root for per-run output directories. |
 | `--run-id <id>` | auto ULID | Override the generated run id. |
 | `--cache-policy <policy>` | `read_write` | `read_write`, `bypass`, or `read_only`. |
 | `--concurrency <n>` | `5` (or `BAKER_CANVAS_CONCURRENCY`) | Max nodes executing at once within a layer. |

package/canvas/avocado-tutorial.json

@@ -74,7 +74,7 @@
         "transcript": "$ref:transcribe.transcript"
       },
       "params": {
-        "composition": "./packages/cli/canvas/tiktok-captions-composition",
+        "composition": "./tiktok-captions-composition",
         "words_per_group": 3,
         "font_size": 72,
         "text_color": "#ffffff",

package/canvas/hello-world-overlay.json

@@ -22,7 +22,7 @@
         "background": "$ref:person_image.images#0"
       },
       "params": {
-        "composition": "./packages/cli/canvas/hello-world-composition",
+        "composition": "./hello-world-composition",
         "text": "HELLO WORLD!!",
         "font_size": 128,
         "text_color": "#ffffff",

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

@@ -20,9 +20,9 @@ import {
   shouldEscalate
 } from "./chunk-2OKSJNLA.js";
 
-// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js
+// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/index.js
 var require_safe_stable_stringify = __commonJS({
-  "../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js"(exports, module) {
+  "../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/index.js"(exports, module) {
     "use strict";
     var { hasOwnProperty } = Object.prototype;
     var stringify = configure2();
@@ -1114,7 +1114,7 @@ function resolveAdaptFormats(params) {
   return params.formats ?? [];
 }
 
-// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/esm/wrapper.js
+// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/esm/wrapper.js
 var import__ = __toESM(require_safe_stable_stringify(), 1);
 var configure = import__.default.configure;
 var wrapper_default = import__.default;
@@ -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-K2IKLMCM.js.map