@koda-sl/baker-cli 0.386.0-dev.8b1f99042 → 0.386.0-dev.d6e55699d

package/dist/url-options-PCZEQE66.js

@@ -0,0 +1,130 @@
+import {
+  mappingCommandFor,
+  proposeMappingFromTemplate
+} from "./chunk-FYWWTMXP.js";
+import "./chunk-EDLZGTGN.js";
+import {
+  parseApiError
+} from "./chunk-V5GSRREZ.js";
+import {
+  urlOptionsHints
+} from "./chunk-WIRBRCTJ.js";
+import {
+  getManagerIdForCustomer,
+  resolveCustomerId,
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-BVM5IRZW.js";
+import "./chunk-JAYT43KX.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/url-options.ts
+import { defineCommand } from "citty";
+
+// src/commands/ads/google/mapping-hints.ts
+function observedTemplates(report) {
+  const values = [
+    report.account.final_url_suffix,
+    report.account.tracking_url_template,
+    ...[...report.campaigns.overrides, ...report.ad_groups.overrides, ...report.ads.overrides].flatMap((entity) => [
+      entity.final_url_suffix,
+      entity.tracking_url_template
+    ])
+  ];
+  return values.flatMap((value) => value.state === "set" ? [value.value] : []);
+}
+function mappingHints(report) {
+  const proposed = {};
+  const unexplained = /* @__PURE__ */ new Map();
+  for (const template of observedTemplates(report)) {
+    const proposal = proposeMappingFromTemplate(template, "google");
+    Object.assign(proposed, proposal.proposed);
+    for (const param of proposal.unexplained) unexplained.set(param.name, param.value);
+  }
+  const hints = [];
+  const command = mappingCommandFor("google", proposed);
+  if (command !== "") {
+    hints.push(
+      `These URLs carry campaign parameters Baker does not read yet: ${Object.keys(proposed).join(", ")}. Until it is told, their values are not stored at all \u2014 only that the name appeared \u2014 so every keyword and campaign breakdown for this account will come back empty rather than wrong. The placeholders say what each one is, so run: ${command}`
+    );
+  }
+  if (unexplained.size > 0) {
+    const named = [...unexplained].map(([name, value]) => `${name}=${value}`).join(", ");
+    hints.push(
+      `These carry something no placeholder explains: ${named}. Do not guess \u2014 if it is a dimension, map it by name with \`baker analytics map --platform google --set <name>=<role>\`; if it is a session token or a cache buster, \`=ignore\` stops it being listed as something to deal with.`
+    );
+  }
+  return hints;
+}
+
+// src/commands/ads/google/url-options.ts
+registerSchema({
+  command: "ads.google.url-options",
+  description: "Report the Google Ads URL/tracking options in force at every level: the account-level final URL suffix and tracking template, plus every campaign, ad group and ad that overrides them. Every value is tagged set | not_set | not_read, so an unread level is never mistaken for an unset one. Read this before answering any UTM / tracking-parameter question. Compact by default: only overriding campaigns are listed; --full lists every campaign read.",
+  args: {
+    "customer-id": {
+      type: "string",
+      description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "List every campaign read, including those with no override of their own.",
+      required: false
+    },
+    "no-cache": { type: "boolean", description: "Skip the read cache", required: false }
+  }
+});
+var urlOptionsCommand = defineCommand({
+  meta: {
+    name: "url-options",
+    description: `Show the URL/tracking options in force \u2014 account-level final URL suffix and tracking template, plus the campaigns, ad groups and ads that override them (the most specific level wins).
+
+Start here for any "add utm_\u2026 / tracking parameter / agency tag" question: it tells you which level already carries one.
+Each value is tagged: set | not_set (Google carries no value there) | not_read (never observed \u2014 NOT a finding).
+Judgment on which level to use and what to put in it: /google-ads-playbook \u2192 18-naming-utm.md.
+
+Examples:
+  baker ads google url-options --customer-id 1234567890
+  baker ads google url-options --customer-id 1234567890 --full`
+  },
+  args: {
+    "customer-id": { type: "string", description: "Google Ads customer ID (10 digits)", required: false },
+    full: { type: "boolean", description: "List every campaign read, not only the overriding ones", required: false },
+    "no-cache": { type: "boolean", description: "Skip the read cache", required: false }
+  },
+  run: async ({ args }) => {
+    const customerId = await resolveCustomerId(args);
+    try {
+      const managerId = getManagerIdForCustomer(customerId);
+      const data = await apiPost("/api/ads/google/url-options", {
+        customerId,
+        ...managerId ? { managerId } : {},
+        ...args.full ? { full: true } : {},
+        ...args["no-cache"] ? { skipCache: true } : {}
+      });
+      const hints = [...urlOptionsHints(data), ...mappingHints(data)];
+      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseApiError(err.message, "", customerId, err.code));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  urlOptionsCommand
+};
+//# sourceMappingURL=url-options-PCZEQE66.js.map

package/dist/url-options-PCZEQE66.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/url-options.ts","../src/commands/ads/google/mapping-hints.ts"],"sourcesContent":["import { type GoogleUrlOptionsResponse, urlOptionsHints } from \"@baker/api/ads-google\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { getManagerIdForCustomer } from \"../cache.ts\";\nimport { resolveCustomerId, writeAdsJson, writeJsonEnvelope } from \"../output.ts\";\nimport { parseApiError } from \"./error-parser.ts\";\nimport { mappingHints } from \"./mapping-hints.ts\";\n\nregisterSchema({\n  command: \"ads.google.url-options\",\n  description:\n    \"Report the Google Ads URL/tracking options in force at every level: the account-level final URL suffix and tracking template, plus every campaign, ad group and ad that overrides them. Every value is tagged set | not_set | not_read, so an unread level is never mistaken for an unset one. Read this before answering any UTM / tracking-parameter question. Compact by default: only overriding campaigns are listed; --full lists every campaign read.\",\n  args: {\n    \"customer-id\": {\n      type: \"string\",\n      description: \"Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.\",\n      required: false,\n    },\n    full: {\n      type: \"boolean\",\n      description: \"List every campaign read, including those with no override of their own.\",\n      required: false,\n    },\n    \"no-cache\": { type: \"boolean\", description: \"Skip the read cache\", required: false },\n  },\n});\n\nexport const urlOptionsCommand = defineCommand({\n  meta: {\n    name: \"url-options\",\n    description: `Show the URL/tracking options in force — account-level final URL suffix and tracking template, plus the campaigns, ad groups and ads that override them (the most specific level wins).\n\nStart here for any \"add utm_… / tracking parameter / agency tag\" question: it tells you which level already carries one.\nEach value is tagged: set | not_set (Google carries no value there) | not_read (never observed — NOT a finding).\nJudgment on which level to use and what to put in it: /google-ads-playbook → 18-naming-utm.md.\n\nExamples:\n  baker ads google url-options --customer-id 1234567890\n  baker ads google url-options --customer-id 1234567890 --full`,\n  },\n  args: {\n    \"customer-id\": { type: \"string\", description: \"Google Ads customer ID (10 digits)\", required: false },\n    full: { type: \"boolean\", description: \"List every campaign read, not only the overriding ones\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip the read cache\", required: false },\n  },\n  run: async ({ args }) => {\n    const customerId = await resolveCustomerId(args);\n    try {\n      const managerId = getManagerIdForCustomer(customerId);\n      const data = await apiPost<GoogleUrlOptionsResponse>(\"/api/ads/google/url-options\", {\n        customerId,\n        ...(managerId ? { managerId } : {}),\n        ...(args.full ? { full: true } : {}),\n        ...(args[\"no-cache\"] ? { skipCache: true } : {}),\n      });\n      const hints = [...urlOptionsHints(data), ...mappingHints(data)];\n      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        // `err.code` is what tells `parseApiError` a missing Google Ads connection\n        // apart from a fixable query error. Dropped, a never-connected account gets\n        // the query-correction path instead — and since the query here is empty, the\n        // \"add a LIMIT\" rule matches and hands the agent a `correctedCommand` it is\n        // told to run, sending it off to execute an empty GAQL query instead of\n        // asking the user to connect.\n        writeAdsJson(parseApiError(err.message, \"\", customerId, err.code));\n        process.exit(1);\n      }\n      writeAdsJson({ ok: false, error: { code: \"NETWORK_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n","/**\n * The bridge between a Google tracking template and Baker's reading of it.\n *\n * These two facts sat one command apart and nothing joined them: `url-options`\n * reports that the account's URLs carry `searchword={keyword}`, and\n * `baker analytics map` is what makes Baker read `searchword` as a keyword.\n * Until it is told, the values are not stored at all — only the fact that the\n * name appeared — so every keyword report for that account is empty and reads\n * as \"this campaign brought no keywords\" rather than \"nobody has said what\n * `searchword` is\".\n *\n * The template is the client's own answer, already written down, so this is\n * naming what arrives rather than proposing a change to their account — which\n * `baker analytics` refuses to do and this does not do either.\n */\nimport type { GoogleUrlOptionsResponse } from \"@baker/api/ads-google\";\nimport type { AdParamRole } from \"@baker/api/analytics\";\nimport { mappingCommandFor, proposeMappingFromTemplate } from \"@baker/api/analytics\";\n\n/** Every template and suffix this report actually observed, at any level. */\nfunction observedTemplates(report: GoogleUrlOptionsResponse): string[] {\n  const values = [\n    report.account.final_url_suffix,\n    report.account.tracking_url_template,\n    ...[...report.campaigns.overrides, ...report.ad_groups.overrides, ...report.ads.overrides].flatMap((entity) => [\n      entity.final_url_suffix,\n      entity.tracking_url_template,\n    ]),\n  ];\n  return values.flatMap((value) => (value.state === \"set\" ? [value.value] : []));\n}\n\nexport function mappingHints(report: GoogleUrlOptionsResponse): string[] {\n  const proposed: Record<string, AdParamRole> = {};\n  const unexplained = new Map<string, string>();\n\n  for (const template of observedTemplates(report)) {\n    const proposal = proposeMappingFromTemplate(template, \"google\");\n    Object.assign(proposed, proposal.proposed);\n    for (const param of proposal.unexplained) unexplained.set(param.name, param.value);\n  }\n\n  const hints: string[] = [];\n  const command = mappingCommandFor(\"google\", proposed);\n  if (command !== \"\") {\n    hints.push(\n      `These URLs carry campaign parameters Baker does not read yet: ${Object.keys(proposed).join(\", \")}. Until it is told, their values are not stored at all — only that the name appeared — so every keyword and campaign breakdown for this account will come back empty rather than wrong. The placeholders say what each one is, so run: ${command}`,\n    );\n  }\n  if (unexplained.size > 0) {\n    const named = [...unexplained].map(([name, value]) => `${name}=${value}`).join(\", \");\n    hints.push(\n      `These carry something no placeholder explains: ${named}. Do not guess — if it is a dimension, map it by name with \\`baker analytics map --platform google --set <name>=<role>\\`; if it is a session token or a cache buster, \\`=ignore\\` stops it being listed as something to deal with.`,\n    );\n  }\n  return hints;\n}\n"],"mappings":"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","names":[]}

package/dist/url-params-DV37GEQF.js

@@ -0,0 +1,98 @@
+import {
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-PAHLJMC3.js";
+import {
+  writeAdsJson
+} from "./chunk-BVM5IRZW.js";
+import {
+  LINKEDIN_TRACKING_PARAMS_AD_SET_MAX
+} from "./chunk-KRIK2JR4.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-JAYT43KX.js";
+import {
+  apiGet
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/url-params.ts
+import { defineCommand } from "citty";
+var urlParamsCommand = defineCommand({
+  meta: {
+    name: "url-params",
+    description: `Read the URL tracking parameters in effect \u2014 the ad account's, optionally every ad set's, and the keys set at BOTH (which LinkedIn appends twice).
+
+Start here before setting UTMs on an ad set: whatever the account already carries is appended on top of it.
+
+Examples:
+  baker ads linkedin url-params                                  \u2014 the ad account's parameters
+  baker ads linkedin url-params --ad-sets                        \u2014 plus every ad set's, and the collisions
+  baker ads linkedin url-params --campaign-ids 123456,789012     \u2014 plus just those ad sets'
+  baker ads linkedin url-params --ad-sets --collisions-only      \u2014 just what would land twice`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    "ad-sets": {
+      type: "boolean",
+      description: `Also read every ad set's parameters (one call each, first ${LINKEDIN_TRACKING_PARAMS_AD_SET_MAX})`
+    },
+    "campaign-ids": { type: "string", description: "Comma-separated ad set ids to read instead of all of them" },
+    "collisions-only": { type: "boolean", description: "Report only the keys set at more than one level" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["campaign-ids"]) params["campaign-ids"] = String(args["campaign-ids"]);
+      if (args["ad-sets"]) params["all-ad-sets"] = "true";
+      const data = await apiGet("/api/ads/linkedin/url-params", params);
+      const examinedAdSets = Boolean(args["ad-sets"] || args["campaign-ids"]);
+      const notes = hints(data, examinedAdSets);
+      writeAdsJson({
+        ok: true,
+        data: args["collisions-only"] ? { collisions: data.collisions, adSetCoverage: data.adSetCoverage } : data,
+        ...notes.length > 0 ? { hints: notes } : {}
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+function hints(data, examinedAdSets) {
+  const out = [];
+  if (data.unreadable.length > 0) {
+    out.push(
+      `could NOT read ${data.unreadable.map((entry) => entry.level === "account" ? "the ad account" : `ad set ${entry.id}`).join(", ")} \u2014 treat that as unknown, not as empty. Do not stage url-params against it: either it does not exist, or it holds parameters this write would replace unseen. First reason: ${data.unreadable[0]?.reason ?? "unknown"}`
+    );
+  }
+  if (data.collisions.length > 0) {
+    out.push(
+      `${data.collisions.map((c) => c.key).join(", ")} set at BOTH the account and an ad set \u2014 LinkedIn appends both, so each lands twice in the served URL. Clear it at one level with \`account url-params\` or \`campaigns url-params --clear\`.`
+    );
+  }
+  if (data.adSetCoverage?.capped) {
+    out.push(
+      `only ${data.adSetCoverage.examined} of ${data.adSetCoverage.total} ad sets were read \u2014 the collisions above cover those, not the rest. Narrow with --campaign-ids to check the others.`
+    );
+  }
+  if (!examinedAdSets) {
+    out.push("only the ad account was read \u2014 pass --ad-sets to find keys an ad set sets on top of these");
+  }
+  const allAnswered = data.unreadable.length === 0;
+  const nothingSet = data.account.state === "not_set" && data.adSets.every((adSet) => adSet.state === "not_set");
+  if (allAnswered && nothingSet) {
+    out.push("nothing is tagged \u2014 set the constants once with `baker ads linkedin account url-params`");
+  }
+  return out;
+}
+export {
+  hints,
+  urlParamsCommand
+};
+//# sourceMappingURL=url-params-DV37GEQF.js.map

package/dist/url-params-DV37GEQF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/url-params.ts"],"sourcesContent":["import { LINKEDIN_TRACKING_PARAMS_AD_SET_MAX, type LinkedinTrackingParametersResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeAdsJson } from \"../output.ts\";\nimport { handleLinkedinError, resolveAccountIdArg } from \"./shared.ts\";\n\n/**\n * Reads what is set today, at both levels. Its reason to exist is the one thing\n * the write commands cannot tell you: LinkedIn CONCATENATES the ad account's\n * tracking parameters with each ad set's, so a key set at both lands in the\n * served URL twice — and nothing surfaces that until a report comes back split\n * across two values of the same parameter.\n *\n * Account-only by default: there is no batch read for `adTrackingParameters`,\n * so every ad set costs its own call against the same rate limit the staged\n * writes use. `--ad-sets` opts into the sweep.\n */\nexport const urlParamsCommand = defineCommand({\n  meta: {\n    name: \"url-params\",\n    description: `Read the URL tracking parameters in effect — the ad account's, optionally every ad set's, and the keys set at BOTH (which LinkedIn appends twice).\n\nStart here before setting UTMs on an ad set: whatever the account already carries is appended on top of it.\n\nExamples:\n  baker ads linkedin url-params                                  — the ad account's parameters\n  baker ads linkedin url-params --ad-sets                        — plus every ad set's, and the collisions\n  baker ads linkedin url-params --campaign-ids 123456,789012     — plus just those ad sets'\n  baker ads linkedin url-params --ad-sets --collisions-only      — just what would land twice`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n    \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n    \"ad-sets\": {\n      type: \"boolean\",\n      description: `Also read every ad set's parameters (one call each, first ${LINKEDIN_TRACKING_PARAMS_AD_SET_MAX})`,\n    },\n    \"campaign-ids\": { type: \"string\", description: \"Comma-separated ad set ids to read instead of all of them\" },\n    \"collisions-only\": { type: \"boolean\", description: \"Report only the keys set at more than one level\" },\n  },\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      if (args[\"campaign-ids\"]) params[\"campaign-ids\"] = String(args[\"campaign-ids\"]);\n      if (args[\"ad-sets\"]) params[\"all-ad-sets\"] = \"true\";\n      const data = await apiGet<LinkedinTrackingParametersResponse>(\"/api/ads/linkedin/url-params\", params);\n      const examinedAdSets = Boolean(args[\"ad-sets\"] || args[\"campaign-ids\"]);\n      const notes = hints(data, examinedAdSets);\n      writeAdsJson({\n        ok: true,\n        data: args[\"collisions-only\"] ? { collisions: data.collisions, adSetCoverage: data.adSetCoverage } : data,\n        ...(notes.length > 0 ? { hints: notes } : {}),\n      });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n\n/**\n * A partial sweep reporting no collisions is the failure this guards: it reads\n * identically to a clean account, so say which of the two it is.\n */\nexport function hints(data: LinkedinTrackingParametersResponse, examinedAdSets: boolean): string[] {\n  const out: string[] = [];\n  // First, and before anything that could be read as a fact about the account:\n  // a level that could not be read carries no information, and every other\n  // line below would otherwise describe it as empty. The wording covers both\n  // reasons a level lands here — the read failed, or the id names nothing —\n  // because the conclusion is the same and only one of them is knowable here.\n  if (data.unreadable.length > 0) {\n    out.push(\n      `could NOT read ${data.unreadable.map((entry) => (entry.level === \"account\" ? \"the ad account\" : `ad set ${entry.id}`)).join(\", \")} — treat that as unknown, not as empty. Do not stage url-params against it: either it does not exist, or it holds parameters this write would replace unseen. First reason: ${data.unreadable[0]?.reason ?? \"unknown\"}`,\n    );\n  }\n  if (data.collisions.length > 0) {\n    out.push(\n      `${data.collisions.map((c) => c.key).join(\", \")} set at BOTH the account and an ad set — LinkedIn appends both, so each lands twice in the served URL. Clear it at one level with \\`account url-params\\` or \\`campaigns url-params --clear\\`.`,\n    );\n  }\n  if (data.adSetCoverage?.capped) {\n    out.push(\n      `only ${data.adSetCoverage.examined} of ${data.adSetCoverage.total} ad sets were read — the collisions above cover those, not the rest. Narrow with --campaign-ids to check the others.`,\n    );\n  }\n  if (!examinedAdSets) {\n    out.push(\"only the ad account was read — pass --ad-sets to find keys an ad set sets on top of these\");\n  }\n  // \"Nothing is tagged\" is a claim about the account, so it may only be made\n  // when every level examined actually answered.\n  const allAnswered = data.unreadable.length === 0;\n  const nothingSet = data.account.state === \"not_set\" && data.adSets.every((adSet) => adSet.state === \"not_set\");\n  if (allAnswered && nothingSet) {\n    out.push(\"nothing is tagged — set the constants once with `baker ads linkedin account url-params`\");\n  }\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAgBvB,IAAM,mBAAmB,cAAc;AAAA,EAC5C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASf;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,kDAAkD;AAAA,IAC/F,eAAe,EAAE,MAAM,UAAU,aAAa,yBAAyB;AAAA,IACvE,WAAW;AAAA,MACT,MAAM;AAAA,MACN,aAAa,6DAA6D,mCAAmC;AAAA,IAC/G;AAAA,IACA,gBAAgB,EAAE,MAAM,UAAU,aAAa,4DAA4D;AAAA,IAC3G,mBAAmB,EAAE,MAAM,WAAW,aAAa,kDAAkD;AAAA,EACvG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,YAAY,oBAAoB,IAAI;AAC1C,QAAI;AACF,YAAM,SAAiC,EAAE,cAAc,UAAU;AACjE,UAAI,KAAK,cAAc,EAAG,QAAO,cAAc,IAAI,OAAO,KAAK,cAAc,CAAC;AAC9E,UAAI,KAAK,SAAS,EAAG,QAAO,aAAa,IAAI;AAC7C,YAAM,OAAO,MAAM,OAA2C,gCAAgC,MAAM;AACpG,YAAM,iBAAiB,QAAQ,KAAK,SAAS,KAAK,KAAK,cAAc,CAAC;AACtE,YAAM,QAAQ,MAAM,MAAM,cAAc;AACxC,mBAAa;AAAA,QACX,IAAI;AAAA,QACJ,MAAM,KAAK,iBAAiB,IAAI,EAAE,YAAY,KAAK,YAAY,eAAe,KAAK,cAAc,IAAI;AAAA,QACrG,GAAI,MAAM,SAAS,IAAI,EAAE,OAAO,MAAM,IAAI,CAAC;AAAA,MAC7C,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;AAMM,SAAS,MAAM,MAA0C,gBAAmC;AACjG,QAAM,MAAgB,CAAC;AAMvB,MAAI,KAAK,WAAW,SAAS,GAAG;AAC9B,QAAI;AAAA,MACF,kBAAkB,KAAK,WAAW,IAAI,CAAC,UAAW,MAAM,UAAU,YAAY,mBAAmB,UAAU,MAAM,EAAE,EAAG,EAAE,KAAK,IAAI,CAAC,oLAA+K,KAAK,WAAW,CAAC,GAAG,UAAU,SAAS;AAAA,IAC1V;AAAA,EACF;AACA,MAAI,KAAK,WAAW,SAAS,GAAG;AAC9B,QAAI;AAAA,MACF,GAAG,KAAK,WAAW,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAAA,IACjD;AAAA,EACF;AACA,MAAI,KAAK,eAAe,QAAQ;AAC9B,QAAI;AAAA,MACF,QAAQ,KAAK,cAAc,QAAQ,OAAO,KAAK,cAAc,KAAK;AAAA,IACpE;AAAA,EACF;AACA,MAAI,CAAC,gBAAgB;AACnB,QAAI,KAAK,gGAA2F;AAAA,EACtG;AAGA,QAAM,cAAc,KAAK,WAAW,WAAW;AAC/C,QAAM,aAAa,KAAK,QAAQ,UAAU,aAAa,KAAK,OAAO,MAAM,CAAC,UAAU,MAAM,UAAU,SAAS;AAC7G,MAAI,eAAe,YAAY;AAC7B,QAAI,KAAK,8FAAyF;AAAA,EACpG;AACA,SAAO;AACT;","names":[]}

package/dist/use-U4HG2NF3.js

@@ -0,0 +1,95 @@
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/use.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.use",
+  description: "Ingest a URL and wait for the library record to be ready.",
+  args: {
+    url: { type: "string", description: "Image URL", required: true },
+    source: { type: "string", description: "Image source enum", required: false, default: "uploaded" },
+    "max-wait": { type: "number", description: "Max wait ms", required: false, default: 3e4 },
+    context: {
+      type: "string",
+      description: "Free-text hint passed to Gemini describe to bias the generated description and tags",
+      required: false
+    },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
+  }
+});
+var POLL_INTERVAL_MS = 1500;
+function emitReady(ingestResult, doc, args) {
+  const format = typeof args.output === "string" && args.output.length > 0 ? args.output : "json";
+  const fields = typeof args.fields === "string" && args.fields.length > 0 ? args.fields.split(",") : void 0;
+  writeOutput(
+    { ok: true, data: format === "json" ? { ...ingestResult, image: doc } : doc },
+    format,
+    fields,
+    args.full === true
+  );
+}
+var useCommand = defineCommand({
+  meta: {
+    name: "use",
+    description: "Sugar over `ingest`: download \u2192 store \u2192 wait until describe + embed complete \u2192 return ready library record.\n\nExample: baker images use https://cdn.example.com/hero.png --source uploaded"
+  },
+  args: {
+    url: { type: "positional", description: "Image URL", required: false },
+    source: { type: "string", description: "Source enum", required: false },
+    "max-wait": { type: "string", description: "Max wait ms (default 30000)", required: false },
+    context: { type: "string", description: "Description context hint", required: false },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const url = args.url;
+      if (!url) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "URL is required" } });
+        process.exit(1);
+      }
+      const source = args.source ?? "uploaded";
+      const maxWait = args["max-wait"] ? Number(args["max-wait"]) : 3e4;
+      const ingestBody = { url, source };
+      if (args.context) ingestBody.descriptionContext = args.context;
+      const ingestResult = await apiPost("/api/images/ingest", ingestBody);
+      const start = Date.now();
+      while (Date.now() - start < maxWait) {
+        const doc = await apiGet("/api/images/get", { id: ingestResult.imageId });
+        if (doc.status === "ready" || doc.status === "error") {
+          emitReady(ingestResult, doc, args);
+          return;
+        }
+        await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+      }
+      writeJson({ ok: false, error: { code: "TIMEOUT", message: `Image not ready within ${maxWait}ms` } });
+      process.exit(1);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  useCommand
+};
+//# sourceMappingURL=use-U4HG2NF3.js.map

package/dist/use-U4HG2NF3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/use.ts"],"sourcesContent":["import type { ImageDoc, ImagesIngestRequest, ImagesIngestResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiGet, apiPost } from \"../../client.ts\";\nimport { type OutputFormat, writeJson, writeOutput } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\n\nregisterSchema({\n  command: \"images.use\",\n  description: \"Ingest a URL and wait for the library record to be ready.\",\n  args: {\n    url: { type: \"string\", description: \"Image URL\", required: true },\n    source: { type: \"string\", description: \"Image source enum\", required: false, default: \"uploaded\" },\n    \"max-wait\": { type: \"number\", description: \"Max wait ms\", required: false, default: 30000 },\n    context: {\n      type: \"string\",\n      description: \"Free-text hint passed to Gemini describe to bias the generated description and tags\",\n      required: false,\n    },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: { type: \"boolean\", description: \"Include full metadata\", required: false, default: false },\n  },\n});\n\nconst POLL_INTERVAL_MS = 1500;\n\n/**\n * `json` keeps the ingest result alongside the finished row, which is the shape\n * callers already parse. The table formats tabulate the row itself — the ingest\n * result is three scalars with no columns worth printing.\n */\nfunction emitReady(ingestResult: ImagesIngestResponse, doc: ImageDoc, args: Record<string, unknown>): void {\n  const format = typeof args.output === \"string\" && args.output.length > 0 ? (args.output as OutputFormat) : \"json\";\n  const fields = typeof args.fields === \"string\" && args.fields.length > 0 ? args.fields.split(\",\") : undefined;\n  writeOutput(\n    { ok: true, data: format === \"json\" ? { ...ingestResult, image: doc } : doc },\n    format,\n    fields,\n    args.full === true,\n  );\n}\n\nexport const useCommand = defineCommand({\n  meta: {\n    name: \"use\",\n    description:\n      \"Sugar over `ingest`: download → store → wait until describe + embed complete → return ready library record.\\n\\nExample: baker images use https://cdn.example.com/hero.png --source uploaded\",\n  },\n  args: {\n    url: { type: \"positional\", description: \"Image URL\", required: false },\n    source: { type: \"string\", description: \"Source enum\", required: false },\n    \"max-wait\": { type: \"string\", description: \"Max wait ms (default 30000)\", required: false },\n    context: { type: \"string\", description: \"Description context hint\", required: false },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: { type: \"boolean\", description: \"Include full metadata\", required: false, default: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const url = args.url as string | undefined;\n      if (!url) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"URL is required\" } });\n        process.exit(1);\n      }\n      const source = (args.source as string | undefined) ?? \"uploaded\";\n      const maxWait = args[\"max-wait\"] ? Number(args[\"max-wait\"]) : 30000;\n\n      const ingestBody: ImagesIngestRequest = { url, source: source as ImagesIngestRequest[\"source\"] };\n      if (args.context) ingestBody.descriptionContext = args.context as string;\n      const ingestResult = await apiPost<ImagesIngestResponse>(\"/api/images/ingest\", ingestBody);\n\n      const start = Date.now();\n      while (Date.now() - start < maxWait) {\n        const doc = await apiGet<ImageDoc>(\"/api/images/get\", { id: ingestResult.imageId });\n        if (doc.status === \"ready\" || doc.status === \"error\") {\n          emitReady(ingestResult, doc, args as Record<string, unknown>);\n          return;\n        }\n        await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));\n      }\n      writeJson({ ok: false, error: { code: \"TIMEOUT\", message: `Image not ready within ${maxWait}ms` } });\n      process.exit(1);\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/validate-5AV4FJZ5.js

@@ -0,0 +1,91 @@
+import {
+  outputRatioWarningsFor
+} from "./chunk-ASL7JFBD.js";
+import {
+  exitOnPrepareError,
+  prepareCanvas
+} from "./chunk-QKE7GXZ7.js";
+import "./chunk-SLB46MSS.js";
+import "./chunk-RGIXQEGJ.js";
+import "./chunk-YULENNA7.js";
+import "./chunk-KAHMADFH.js";
+import "./chunk-V5HDRJQW.js";
+import "./chunk-I3DIZWN5.js";
+import "./chunk-AUSKKFVH.js";
+import "./chunk-HDHWIEJJ.js";
+import {
+  defaultRegistry,
+  validateCanvasDeep
+} from "./chunk-KZUHRZ2C.js";
+import "./chunk-66USKCVY.js";
+import "./chunk-SHTESUB6.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-U6VRBDNQ.js";
+import "./chunk-CAMX6OHF.js";
+import "./chunk-XQ3CCNJD.js";
+import "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import "./chunk-MGKHFGLV.js";
+import "./chunk-U7BBXM67.js";
+import "./chunk-DX4GIDO7.js";
+import "./chunk-CZENWCBS.js";
+import "./chunk-KRIK2JR4.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-JAYT43KX.js";
+import "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/validate.ts
+import path from "path";
+import { defineCommand } from "citty";
+var validateCommand = defineCommand({
+  meta: {
+    name: "validate",
+    description: "Validate a canvas JSON file (no execution). Brings the canvas up to date with its prompt.json first (prompt.json and, for a video, scenes/*.json edits are written into the canvas, exactly as `run` does), then checks it: a per-node cost preview, each node's deep validators (composition meta checks for hyperframe_render/_snapshot), and each generator prompt measured with its {{slots}} filled against the model's character cap (PROMPT_OVER_MODEL_LIMIT)."
+  },
+  args: { file: { type: "positional", required: true, description: "Path to canvas JSON" } },
+  async run({ args }) {
+    const filePath = path.resolve(String(args.file));
+    let prepared;
+    try {
+      prepared = await prepareCanvas(filePath, { gate: true, log: (line) => process.stderr.write(`${line}
+`) });
+    } catch (e) {
+      exitOnPrepareError(e);
+    }
+    const result = await validateCanvasDeep(prepared.canvas, defaultRegistry());
+    if (!result.ok) {
+      process.stderr.write(`${JSON.stringify({ ok: false, error: { code: "validation", issues: result.issues } }, null, 2)}
+`);
+      process.exit(2);
+      return;
+    }
+    process.stdout.write(
+      `${JSON.stringify(
+        {
+          ok: true,
+          total_nodes: result.canvas.nodes.length,
+          estimated_credits: result.estimatedCredits,
+          cost_preview: result.perNodeCredits ?? [],
+          style_projection: prepared.projections.style,
+          scene_projection: prepared.projections.scenes,
+          canvas_updated: prepared.written,
+          normalized_paths: prepared.rewrites,
+          warnings: [...result.warnings ?? [], ...await outputRatioWarningsFor(prepared.canvas, filePath)]
+        },
+        null,
+        2
+      )}
+`
+    );
+  }
+});
+export {
+  validateCommand
+};
+//# sourceMappingURL=validate-5AV4FJZ5.js.map

package/dist/validate-5AV4FJZ5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/validate.ts"],"sourcesContent":["import path from \"node:path\";\nimport { defineCommand } from \"citty\";\nimport { defaultRegistry, validateCanvasDeep } from \"../../engine/index.ts\";\nimport { outputRatioWarningsFor } from \"./output-ratio.ts\";\nimport { exitOnPrepareError, type PreparedCanvas, prepareCanvas } from \"./prepare-canvas.ts\";\n\nexport const validateCommand = defineCommand({\n  meta: {\n    name: \"validate\",\n    description:\n      \"Validate a canvas JSON file (no execution). Brings the canvas up to date with its prompt.json first (prompt.json and, for a video, scenes/*.json edits are written into the canvas, exactly as `run` does), then checks it: a per-node cost preview, each node's deep validators (composition meta checks for hyperframe_render/_snapshot), and each generator prompt measured with its {{slots}} filled against the model's character cap (PROMPT_OVER_MODEL_LIMIT).\",\n  },\n  args: { file: { type: \"positional\", required: true, description: \"Path to canvas JSON\" } },\n  async run({ args }) {\n    const filePath = path.resolve(String(args.file));\n    let prepared: PreparedCanvas;\n    try {\n      prepared = await prepareCanvas(filePath, { gate: true, log: (line) => process.stderr.write(`${line}\\n`) });\n    } catch (e) {\n      exitOnPrepareError(e);\n    }\n\n    const result = await validateCanvasDeep(prepared.canvas, defaultRegistry());\n    if (!result.ok) {\n      process.stderr.write(`${JSON.stringify({ ok: false, error: { code: \"validation\", issues: result.issues } }, null, 2)}\\n`);\n      process.exit(2);\n      return;\n    }\n\n    // Warnings are advisory: the canvas is valid and runnable, so exit 0. They flag\n    // likely-wrong-but-legal config (a missing element reference, a scene span past the\n    // assigned model's cap) the operator should review before billing.\n    process.stdout.write(\n      `${JSON.stringify(\n        {\n          ok: true,\n          total_nodes: result.canvas.nodes.length,\n          estimated_credits: result.estimatedCredits,\n          cost_preview: result.perNodeCredits ?? [],\n          style_projection: prepared.projections.style,\n          scene_projection: prepared.projections.scenes,\n          canvas_updated: prepared.written,\n          normalized_paths: prepared.rewrites,\n          warnings: [...(result.warnings ?? []), ...(await outputRatioWarningsFor(prepared.canvas, filePath))],\n        },\n        null,\n        2,\n      )}\\n`,\n    );\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAKvB,IAAM,kBAAkB,cAAc;AAAA,EAC3C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,UAAU,MAAM,aAAa,sBAAsB,EAAE;AAAA,EACzF,MAAM,IAAI,EAAE,KAAK,GAAG;AAClB,UAAM,WAAW,KAAK,QAAQ,OAAO,KAAK,IAAI,CAAC;AAC/C,QAAI;AACJ,QAAI;AACF,iBAAW,MAAM,cAAc,UAAU,EAAE,MAAM,MAAM,KAAK,CAAC,SAAS,QAAQ,OAAO,MAAM,GAAG,IAAI;AAAA,CAAI,EAAE,CAAC;AAAA,IAC3G,SAAS,GAAG;AACV,yBAAmB,CAAC;AAAA,IACtB;AAEA,UAAM,SAAS,MAAM,mBAAmB,SAAS,QAAQ,gBAAgB,CAAC;AAC1E,QAAI,CAAC,OAAO,IAAI;AACd,cAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,cAAc,QAAQ,OAAO,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA,CAAI;AACxH,cAAQ,KAAK,CAAC;AACd;AAAA,IACF;AAKA,YAAQ,OAAO;AAAA,MACb,GAAG,KAAK;AAAA,QACN;AAAA,UACE,IAAI;AAAA,UACJ,aAAa,OAAO,OAAO,MAAM;AAAA,UACjC,mBAAmB,OAAO;AAAA,UAC1B,cAAc,OAAO,kBAAkB,CAAC;AAAA,UACxC,kBAAkB,SAAS,YAAY;AAAA,UACvC,kBAAkB,SAAS,YAAY;AAAA,UACvC,gBAAgB,SAAS;AAAA,UACzB,kBAAkB,SAAS;AAAA,UAC3B,UAAU,CAAC,GAAI,OAAO,YAAY,CAAC,GAAI,GAAI,MAAM,uBAAuB,SAAS,QAAQ,QAAQ,CAAE;AAAA,QACrG;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAAA;AAAA,IACH;AAAA,EACF;AACF,CAAC;","names":[]}