@koda-sl/baker-cli 0.350.0 → 0.352.0-dev.09c54d90c

package/README.md

@@ -3927,8 +3927,9 @@ baker canvas sync-definition src/creatives/<slug>/
 # 3. Inspect a finished run (per-node timing, file list, optional video thumbs)
 baker canvas inspect <run_id>
 
-# 4. Discover what's available (all node types, all models, all compositions)
-baker canvas catalog | jq
+# 4. Discover what's available: a one-line index of every node, then one node's full schema
+baker canvas catalog
+baker canvas catalog --node video_generate
 
 # 5. Safely edit a node's prompt without hand-jq (UTF-8 safe — use --text-file for
 #    multi-line / accented copy; the edit is re-validated before it is written back)
@@ -4068,7 +4069,7 @@ The top-level `output` declares the canvas's final result — the engine returns
 
 Every node shares the envelope `{ id, type, inputs?, params? }`. `inputs` wires other nodes' output slots in; `params` configures the node. The validator enforces required input kinds and per-model param shape **before** anything is billed.
 
-`baker canvas catalog` prints the always-current machine-readable schema for every node and every model. The tables below mirror the catalog at time of write.
+`baker canvas catalog` prints a one-line index of every node; `baker canvas catalog --node <id>` prints that node's always-current machine-readable schema (params, inputs, outputs, every model), and `--full` prints every node's. The tables below mirror the catalog at time of write.
 
 In every table:
 
@@ -5231,8 +5232,8 @@ The tables above mirror `packages/canvas-contract/src/registry.ts` at the time o
 
 ```bash
 baker canvas catalog | jq '.categories | keys'
-baker canvas catalog | jq '.categories.image_generate[].id'
-baker canvas catalog | jq '.categories.video_generate[]'
+baker canvas catalog --node image_generate | jq '.entries[0].params'
+baker canvas catalog --node video_generate | jq '.entries[0].params'
 ```
 
 The validator surfaces unknown models / illegal aspect ratios / out-of-range params / missing required inputs with `did_you_mean` hints **before** the run starts.
@@ -5486,7 +5487,7 @@ Turn a source/inspiration image into a **runnable, self-validated static-ad canv
 2. **element selection** (`~google/gemini-flash-latest`) — picks the **main, identity-critical** elements (the brand logo, a showcased product, a trust badge) **plus any foreground/hero person or animal** — the emotional focal point — even a generic one, because a free-generated face/muzzle reads as AI and grows artifacts; the emotional hero always gets a real-reference slot. When the advertiser's logo appears in **more than one lockup** (a square/icon **mark** and a horizontal **wordmark**), each is emitted as its **own** element (e.g. `LOGO_MARK`, `LOGO_WORDMARK`) so you drop the right file in each slot instead of stretching one logo to cover both. The describe pass also records the ad's **typography** under a `fonts` block (each typeface's classification, a best-guess family, and its weight/case) so you know exactly what to drop at the brand-font slot. Background extras are dropped. Each element is stamped back onto its blueprint entry as a `reference_image` label so the JSON self-documents which slot grounds which subject.
 3. **global layout** (`~google/gemini-flash-latest`) — produces a structured `layout` block in `prompt.json`: the column/row grid, each region's `x_pct`/`y_pct` bounds, panel splits, background/shape, and every text block's relative size/weight/case/alignment. This is what gives the generator a precise composition to rebuild.
 
-It then scaffolds a canvas that ingests `prompt.json`, wires **one `[TODO]` ingest slot per detected element** (plus an optional brand-font → type-specimen) into `image_generate`, and wires the original image in for composition only. Each **person/animal hero** is additionally fused into a generated **multi-view reference sheet** (`image_reference_sheet`, a turnaround built from the one dropped photo) that the render grounds on instead of the lone flat snapshot — the same identity lock the video scaffold uses, so the face/muzzle stays consistent and artifact-free from a single reference. Pass `--skip-actor-sheets` to ground straight on the dropped photo. The canvas is validated before it's written. stdout returns `{ ok, canvas_path, prompt_path, models, aspect_ratio, placements, output_formats, layout_regions, stats, checklist }` — the **checklist** lists every real asset to drop in (and which heroes get a sheet).
+It then scaffolds a canvas that ingests `prompt.json`, wires **one `[TODO]` ingest slot per detected element** (plus an optional brand-font → type-specimen) into `image_generate`, and wires the original image in for composition only — left out of the render when it shows a person, because the generator copies that face whatever the prompt says (the blueprint's layout carries the composition instead). Each **animal hero** is additionally fused into a generated **multi-view reference sheet** (`image_reference_sheet`, a turnaround built from the one dropped photo) that the render grounds on instead of the lone flat snapshot — the same identity lock the video scaffold uses, so the muzzle stays consistent and artifact-free from a single reference. Pass `--skip-actor-sheets` to ground straight on the dropped photo. A **person hero**'s slot takes a company Avatar's identity sheet (`baker avatars`) and the render keeps that face, so it is never a found photo of a real person. The canvas is validated before it's written. stdout returns `{ ok, canvas_path, prompt_path, models, aspect_ratio, placements, output_formats, layout_regions, stats, checklist }` — the **checklist** lists every real asset to drop in (and which heroes get a sheet).
 
 **Automatic placement fan-out.** By default the canvas doesn't stop at one ratio: the hero renders once at the platform's primary ratio, then an `image_aspect_adapt` node recomposes it into that platform's full placement set, and the canvas `output` points at the adapted images. The placement set is derived from `--platform` (`meta` → 4:5 + 9:16, `google` → 1:1 + 4:5 + 16:9, `linkedin` → 1:1, `tiktok` → 9:16, `youtube` → 16:9); override it with `--placements <preset>` or disable it with `--placements none` for a single base ad. The hero ratio passes through the adapt node **free**; each other ratio is a billed recomposition — and because adaptation re-generates, every ratio should be eyeballed for text and brand-color fidelity before publish (`ad-formats.md` in the scaffold skill covers this).
 
@@ -5515,7 +5516,7 @@ baker canvas run ./static-ad.canvas.json
 | `--placements <preset\|none>` | derived from `--platform` | Override the fan-out set: `meta_feed`\|`meta_feed_stories`\|`meta_all`\|`linkedin`\|`google_demandgen`\|`tiktok`\|`youtube`, or `none` for a single base ad. |
 | `--aspect <ratio>` | inferred from the image, else `9:16` | Force the hero's aspect ratio (clamped into the placement set so it stays a free pass-through). |
 | `--skip-font` | off | Skip the brand-font → type-specimen slot. |
-| `--skip-actor-sheets` | off | Ground each person/animal on its lone dropped photo instead of a generated multi-view reference sheet. |
+| `--skip-actor-sheets` | off | Ground each animal hero on its lone dropped photo instead of a generated multi-view reference sheet. |
 
 Scaffolding runs (and bills) the two vision passes; **running** the result generates a billed image. `baker canvas validate` does not check that the `[TODO]` paths exist — supply the real files before `run`.
 
@@ -5552,11 +5553,18 @@ Resolves the run dir against `--outputs-dir` (default `./canvas`) or accepts an
 
 #### `baker canvas catalog`
 
-Prints the agent-facing node + composition catalog as JSON Schema. Every node has `id`, `version`, `location`, `category`, `summary`, `inputs`/`params`/`outputs` schemas, `cost_estimate_credits`, `runtime_estimate_seconds`, and (when present) `when_to_use`. Grouped by `category`. The `compositions` array enumerates every `@baker/*` composition with its full `meta.json`.
+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.
+- `--full` — every node's full entry (~160 KB).
+
+An unknown node or category exits 1 with `{ ok: false, error: { code: "NOT_FOUND", fix } }` naming the valid ones.
 
 ```bash
-baker canvas catalog | jq '.categories | keys'
-baker canvas catalog | jq '.compositions[].id'
+baker canvas catalog
+baker canvas catalog --node video_generate
+baker canvas catalog --category audio --full
 ```
 
 ---

package/dist/{chunk-YBD3W4M7.js → chunk-B7MLH3K6.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;
@@ -9605,6 +9605,83 @@ function generateCatalog(registry, opts = {}) {
       runtime_estimate_seconds: cost?.seconds_estimate
     };
   }).sort((a, b) => a.id.localeCompare(b.id));
+  return {
+    schema: "baker-canvas-catalog/2",
+    generated_at: opts.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+    categories: groupIds(entries),
+    entries
+  };
+}
+var INDEX_SUMMARY_MAX = 160;
+var sentences = new Intl.Segmenter("en", { granularity: "sentence" });
+function oneLine(summary) {
+  const first = sentences.segment(summary)[Symbol.iterator]().next().value?.segment.trim() ?? summary;
+  if (first.length <= INDEX_SUMMARY_MAX) return first;
+  const cut = first.slice(0, INDEX_SUMMARY_MAX);
+  const lastSpace = cut.lastIndexOf(" ");
+  return `${(lastSpace > 0 ? cut.slice(0, lastSpace) : cut).replace(/[\s,;:—-]+$/u, "")}\u2026`;
+}
+function listIds(value) {
+  return (value ?? "").split(",").map((id) => id.trim()).filter((id) => id.length > 0);
+}
+function catalogView(catalog, opts) {
+  const knownIds = catalog.entries.map((e) => e.id);
+  const knownCategories = Object.keys(catalog.categories);
+  if (opts.category !== void 0 && !knownCategories.includes(opts.category)) {
+    return {
+      ok: false,
+      error: {
+        code: "NOT_FOUND",
+        message: `No node category "${opts.category}".`,
+        fix: `Pass one of: ${knownCategories.join(", ")}.`
+      }
+    };
+  }
+  const requestedIds = listIds(opts.node);
+  if (opts.node !== void 0 && requestedIds.length === 0) {
+    return {
+      ok: false,
+      error: {
+        code: "VALIDATION_ERROR",
+        message: "--node needs a node id.",
+        fix: "Run `baker canvas catalog` for the ids, then pass one (or several, comma-separated)."
+      }
+    };
+  }
+  const unknownIds = requestedIds.filter((id) => !knownIds.includes(id));
+  if (unknownIds.length > 0) {
+    return {
+      ok: false,
+      error: {
+        code: "NOT_FOUND",
+        message: `No node named ${unknownIds.map((id) => `"${id}"`).join(", ")}.`,
+        fix: `Pass one of: ${knownIds.join(", ")}.`
+      }
+    };
+  }
+  const inCategory = (e) => opts.category === void 0 || e.category === opts.category;
+  const categories = opts.category === void 0 ? catalog.categories : { [opts.category]: catalog.categories[opts.category] ?? [] };
+  if (requestedIds.length > 0) {
+    const entries = catalog.entries.filter((e) => requestedIds.includes(e.id));
+    return { ok: true, schema: catalog.schema, categories: groupIds(entries), entries };
+  }
+  if (opts.full) {
+    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);
+  return {
+    ok: true,
+    schema: catalog.schema,
+    categories,
+    nodes,
+    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)."
+    ]
+  };
+}
+function groupIds(entries) {
   const categories = {};
   for (const e of entries) {
     let bucket = categories[e.category];
@@ -9614,12 +9691,7 @@ function generateCatalog(registry, opts = {}) {
     }
     bucket.push(e.id);
   }
-  return {
-    schema: "baker-canvas-catalog/2",
-    generated_at: opts.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
-    categories,
-    entries
-  };
+  return categories;
 }
 function safeCost(def) {
   if (!def.cost) return null;
@@ -9795,6 +9867,7 @@ export {
   durationSeconds,
   canonicalUrl,
   toModelSafeImage,
+  catalogView,
   BackendClient2,
   Engine2 as Engine,
   LocalAssetStore2 as LocalAssetStore,
@@ -9805,4 +9878,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-YBD3W4M7.js.map
+//# sourceMappingURL=chunk-B7MLH3K6.js.map