@koda-sl/baker-cli 0.347.0 → 0.348.0-dev.78a35388f

package/README.md

@@ -304,7 +304,7 @@ Read it before interpreting any null. Field coverage is folded page by page on t
 }
 ```
 
-Never total or count from a response carrying it — re-run with `--all --limit 10000 --out data.csv` (the API accepts page sizes up to 10,000) and check the re-run came back without the warning. A read that returns one row by construction — `FROM customer` with no segment selected, such as `--preset account-summary` — has no page to fill, so it never carries `TRUNCATED_RESULTS`, nor `CONVERSION_MIX`, since one account-wide row has no campaigns to total or compare. Warnings reach every output format, so no `--output` choice can hide one:
+Never total or count from a response carrying it — re-run with `--all --limit 8192 --out data.csv` (one read returns at most 8,192 rows; split a bigger data set into narrower queries — a shorter date range or one campaign each) and check the re-run came back without the warning. A read that returns one row by construction — `FROM customer` with no segment selected, such as `--preset account-summary` — has no page to fill, so it never carries `TRUNCATED_RESULTS`, nor `CONVERSION_MIX`, since one account-wide row has no campaigns to total or compare. Warnings reach every output format, so no `--output` choice can hide one:
 
 | `--output` | Where warnings land |
 |------------|---------------------|
@@ -343,11 +343,11 @@ The same lines also go to stderr. A read with nothing to report prints none of i
 |-----------------|--------------------------------------------------------------|
 | `--customer-id` | Google Ads customer ID (10 digits, no dashes). Falls back to `BAKER_GOOGLE_ADS_CUSTOMER_ID` env var. |
 | `--preset`      | Named query template (see presets below)                     |
-| `--date-range`  | Override preset date range (LAST_7_DAYS, LAST_30_DAYS, etc.) |
+| `--date-range`  | Override preset date range: a Google literal (LAST_7_DAYS, LAST_30_DAYS, LAST_MONTH, etc.) or `BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'` — there is no LAST_90_DAYS |
 | `--include-paused` | Include paused entities in preset results. Off by default: presets return only actually-serving entities (enabled campaign **and** ad group **and** ad). Google Ads has no single serving flag, so the whole chain must be `ENABLED` for an entity to serve. |
-| `--limit`       | Max rows per page (default 200)                              |
+| `--limit`       | Max rows per page (default 200, at most 8,192)               |
 | `--cursor`      | Pagination cursor from previous response                     |
-| `--all`         | Auto-paginate all results. Exhausts the pages, not the statement's `LIMIT` — pair it with a `--limit` above the expected row count, and a read that still fills its cap is flagged `TRUNCATED_RESULTS` either way |
+| `--all`         | Auto-paginate all results. Exhausts the pages, not the statement's `LIMIT` — pair it with a `LIMIT` in the statement above the expected row count (at most 8,192 — split bigger reads into narrower queries), and a read that still fills its cap is flagged `TRUNCATED_RESULTS` either way |
 | `--out`         | Write data to file (format from extension: .csv, .jsonl, .json) |
 | `--append`      | Append to existing file (skip CSV headers)                   |
 | `--output`      | Output format: `json` \| `csv` \| `jsonl` \| `md`           |
@@ -391,6 +391,8 @@ The CLI rejects or automatically corrects common GAQL mistakes before hitting th
 | `shopping_performance_view.product_*` | Rewrites to `segments.product_*` | Field renamed |
 | `campaign.status = 'ACTIVE'` | Rewrites to `= 'ENABLED'` | Enum corrected |
 | `segments.conversion_action_name` with `metrics.cost_micros` | Rejects; split into separate conversion-action and spend queries | `INCOMPATIBLE_FIELDS` with `fix.action: "split_query"` |
+| `DURING` with a literal Google does not accept (`LAST_90_DAYS`, `LAST_12_MONTHS`, `THIS_YEAR` …) | Rejects before any request; `DURING` takes only `TODAY`, `YESTERDAY`, `LAST_7_DAYS`, `LAST_14_DAYS`, `LAST_30_DAYS`, `LAST_BUSINESS_WEEK`, `THIS_MONTH`, `LAST_MONTH`, `THIS_WEEK_SUN_TODAY`, `THIS_WEEK_MON_TODAY`, `LAST_WEEK_SUN_SAT`, `LAST_WEEK_MON_SUN` | `INVALID_DATE_RANGE`, with `fix.correctedCommand` spelling the same window as `BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'` |
+| `--limit` outside 1–8,192, or a statement `LIMIT` above 8,192 | Rejects before any request — one read returns at most 8,192 rows | `VALIDATION_ERROR` naming the cap and how to split a bigger read; a statement `LIMIT` also gets `fix.correctedCommand` at `LIMIT 8192` |
 | `FROM ad_group_criterion` without `negative` field | Warns | `"ad_group_criterion returns BOTH positive and negative keywords. Use --preset positive-keywords or negative-keywords."` |
 
 Auto-fixed queries proceed normally. Warnings appear in the response:
@@ -3924,8 +3926,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)
@@ -5228,8 +5231,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.
@@ -5549,11 +5552,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-4QG7SF4U.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 && !catalog.categories[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-4QG7SF4U.js.map