@koda-sl/baker-cli 0.350.0 → 0.351.0

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.
@@ -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-4HRJQGVW.js}

@@ -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-4HRJQGVW.js.map