@koda-sl/baker-cli 0.469.0-dev.42f26270e → 0.470.0

package/dist/changes-34C3JC5T.js

@@ -0,0 +1,135 @@
+import {
+  getFieldDescriptions
+} from "./chunk-JPK34QPS.js";
+import {
+  parseApiError,
+  resolveChangesWindow
+} from "./chunk-336H47XX.js";
+import {
+  CHANGE_SCOPE_MAX_DAYS,
+  DEFAULT_CHANGE_DAYS
+} from "./chunk-7VHPAGPK.js";
+import {
+  getManagerIdForCustomer,
+  resolveCustomerId,
+  writeAdsJson,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-JM7C6OHU.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-CK5ZNZ3I.js";
+import "./chunk-7QDVAEB6.js";
+import "./chunk-NVBBZPJP.js";
+import {
+  registerSchema
+} from "./chunk-KCA5CDCU.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/changes.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.google.changes",
+  description: "Read the account's change history. --scope detail (default) shows what changed and to what value, back 30 days; --scope summary shows which resources changed, back 90 days.",
+  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
+    },
+    days: {
+      type: "string",
+      description: `Lookback days (default: ${DEFAULT_CHANGE_DAYS}). Max ${CHANGE_SCOPE_MAX_DAYS.detail} with --scope detail, ${CHANGE_SCOPE_MAX_DAYS.summary} with --scope summary. Google keeps nothing older behind any API.`,
+      required: false,
+      default: DEFAULT_CHANGE_DAYS
+    },
+    scope: {
+      type: "string",
+      description: `detail|summary (default: detail). detail = old/new values plus who made the change, ${CHANGE_SCOPE_MAX_DAYS.detail} days. summary = which resources were added, changed or removed, ${CHANGE_SCOPE_MAX_DAYS.summary} days, without values.`,
+      required: false,
+      default: "detail"
+    },
+    "resource-type": {
+      type: "string",
+      description: "Filter by type: CAMPAIGN, CAMPAIGN_CRITERION, AD_GROUP, AD_GROUP_AD, AD_GROUP_CRITERION. CAMPAIGN_CRITERION covers campaign-level negatives, location and audience exclusions.",
+      required: false
+    },
+    limit: { type: "string", description: "Max change events (default: 50, max: 1000)", required: false, default: 50 },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
+  }
+});
+var changesCommand = defineCommand({
+  meta: {
+    name: "changes",
+    description: `Read the change history of a Google Ads account.
+
+Google keeps account history in two layers, and neither reaches past 90 days:
+  --scope detail  (default)  what changed, old \u2192 new value, who changed it   \u2014 last ${CHANGE_SCOPE_MAX_DAYS.detail} days
+  --scope summary            which resources were added, changed or removed  \u2014 last ${CHANGE_SCOPE_MAX_DAYS.summary} days
+
+For anything older, infer it from performance instead \u2014 a monthly spend trend per
+campaign shows what started or stopped, just not who did it.
+
+Examples:
+  baker ads google changes --customer-id 1234567890
+  baker ads google changes --customer-id 1234567890 --days 14 --resource-type CAMPAIGN
+  baker ads google changes --customer-id 1234567890 --days 60 --scope summary`
+  },
+  args: {
+    "customer-id": { type: "string", description: "Google Ads customer ID", required: false },
+    days: { type: "string", description: `Lookback days (default ${DEFAULT_CHANGE_DAYS})`, required: false },
+    scope: { type: "string", description: "detail (30 days) or summary (90 days)", required: false },
+    "resource-type": { type: "string", description: "Filter by resource type", required: false },
+    limit: { type: "string", description: "Max results (default 50)", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const customerId = await resolveCustomerId(args);
+    const window = resolveChangesWindow({
+      days: args.days ? Number(args.days) : void 0,
+      scope: args.scope
+    });
+    if (!window.ok) {
+      writeJsonEnvelope({ ok: false, error: { ...window.error, retryable: false } });
+      process.exit(1);
+      return;
+    }
+    const body = {
+      customerId,
+      days: window.days,
+      scope: window.scope,
+      limit: args.limit ? Number(args.limit) : 50
+    };
+    const managerId = getManagerIdForCustomer(customerId);
+    if (managerId) body.managerId = managerId;
+    if (args["resource-type"]) body.resourceType = args["resource-type"];
+    if (args["no-cache"]) body.skipCache = true;
+    try {
+      const data = await apiPost("/api/ads/google/changes", body);
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(data, format);
+        return;
+      }
+      const first = data[0];
+      const fields = first ? Object.keys(first) : [];
+      const fieldDescs = getFieldDescriptions(fields);
+      writeJsonEnvelope({ ok: true, data, fields: fieldDescs, hints: window.hints });
+    } 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 {
+  changesCommand
+};
+//# sourceMappingURL=changes-34C3JC5T.js.map

package/dist/chatgpt-AFGIOAME.js

@@ -0,0 +1,47 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/index.ts
+import { defineCommand } from "citty";
+var chatgptCommand = defineCommand({
+  meta: {
+    name: "chatgpt",
+    description: `ChatGPT Ads (OpenAI's ads inside ChatGPT) \u2014 read the connected account, its campaigns, ad groups and ads, and how they perform; stage changes that apply when the chat is published.
+
+Start here:
+  baker ads chatgpt account                          \u2014 currency, timezone, and whether reviews let anything serve
+  baker ads chatgpt insights                         \u2014 last 7 days, one row per campaign
+
+Examples:
+  baker ads chatgpt campaigns
+  baker ads chatgpt ad-groups --campaign-id cmpn_123
+  baker ads chatgpt ads --ad-group-id adgrp_123
+  baker ads chatgpt conversions                      \u2014 pixels and conversion events
+  baker ads chatgpt insights --days 30 --granularity daily --segment country
+  baker ads chatgpt campaigns create --name "Spring push" --objective clicks --daily-budget 20
+  baker ads chatgpt draft                            \u2014 what this chat has staged
+
+Writes never reach ChatGPT Ads mid-chat: create, update, pause, resume and archive stage
+changes on this chat, and they apply when the chat is published.
+
+One company connects one ChatGPT Ads account, so there is no account id to pass.
+Full guide: __tooling__/docs/tools/baker/ads-chatgpt.md`
+  },
+  subCommands: {
+    account: () => import("./account-6T75UGYA.js").then((m) => m.accountCommand),
+    campaigns: () => import("./campaigns-JQZFTNQF.js").then((m) => m.campaignsCommand),
+    "ad-groups": () => import("./ad-groups-CVLW3F3R.js").then((m) => m.adGroupsCommand),
+    ads: () => import("./ads-RWEYWL3Y.js").then((m) => m.adsCommand),
+    conversions: () => import("./conversions-NJVDR3PI.js").then((m) => m.conversionsCommand),
+    pixels: () => import("./pixels-FJXN7Y72.js").then((m) => m.pixelsCommand),
+    audiences: () => import("./audiences-PXM6ESZ2.js").then((m) => m.audiencesCommand),
+    catalogs: () => import("./catalogs-ELVO3NV5.js").then((m) => m.catalogsCommand),
+    history: () => import("./history-XJT62Y5T.js").then((m) => m.historyCommand),
+    insights: () => import("./insights-F7EVUCLZ.js").then((m) => m.insightsCommand),
+    locations: () => import("./locations-Y3HTPKUX.js").then((m) => m.locationsCommand),
+    draft: () => import("./draft-3GO4Q6RU.js").then((m) => m.draftCommand)
+  }
+});
+export {
+  chatgptCommand
+};
+//# sourceMappingURL=chatgpt-AFGIOAME.js.map

package/dist/chats-DNLK6TTQ.js

@@ -0,0 +1,262 @@
+import {
+  failApi
+} from "./chunk-PYPILVCC.js";
+import "./chunk-WXC3I4CT.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-CK5ZNZ3I.js";
+import "./chunk-7QDVAEB6.js";
+import {
+  getEnv
+} from "./chunk-NVBBZPJP.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-KCA5CDCU.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/chats/index.ts
+import { defineCommand } from "citty";
+var STATUS_GROUPS = ["active", "archived", "all"];
+var REPO_SURFACES = ["knowledge", "company", "brand", "landings", "flows", "creatives"];
+function parseBoundedInt(raw, name, min, max) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  const value = Number.parseInt(raw, 10);
+  if (Number.isNaN(value) || value < min || value > max) {
+    throw new Error(`--${name} must be an integer between ${min} and ${max}`);
+  }
+  return value;
+}
+registerSchema({
+  command: "chats.list",
+  description: "Start here: list other Sessions on this account (newest first) so you can reuse what was done before. Each row shows the Session id, title, status, and a count of what it produced (creatives, landings, actions, flows, reports\u2026). Then drill in with `baker chats view <id>`, `baker chats transcript <id>`, or `baker chats diff <id>`. Read-only.",
+  args: {
+    status: { type: "string", description: "Filter: active|archived|all (default: all)", required: false },
+    limit: { type: "string", description: "Max Sessions to return, 1-100 (default: 20)", required: false },
+    full: { type: "boolean", description: "Include each Session's full change list", required: false, default: false }
+  }
+});
+var listCommand = defineCommand({
+  meta: { name: "list", description: "List other Sessions on this account, newest first." },
+  args: {
+    status: { type: "string", description: "Filter: active|archived|all (default: all)", required: false },
+    limit: { type: "string", description: "Max Sessions (1-100, default 20)", required: false },
+    full: { type: "boolean", description: "Include each Session's full change list", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = {};
+      if (args.status) {
+        if (!STATUS_GROUPS.includes(args.status)) {
+          throw new Error(`--status must be one of: ${STATUS_GROUPS.join("|")}`);
+        }
+        body.status = args.status;
+      }
+      const limit = parseBoundedInt(args.limit, "limit", 1, 100);
+      if (limit !== void 0) {
+        body.limit = limit;
+      }
+      if (args.full) {
+        body.full = true;
+      }
+      const selfChatId = getEnv().BAKER_CHAT_ID;
+      if (selfChatId) {
+        body.excludeChatId = selfChatId;
+      }
+      const response = await apiPost("/api/chats/list", body);
+      writeJson({
+        ...response,
+        meta: { count: response.data.chats.length },
+        ...response.data.chats.length === 0 ? { hints: ["No Sessions matched. Widen with --status all or a larger --limit."] } : {
+          hints: [
+            "Drill in: `baker chats view <id>` for outputs, `chats transcript <id>` for the conversation, `chats diff <id>` for the real file changes."
+          ]
+        }
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+registerSchema({
+  command: "chats.view",
+  description: "Inspect one Session's FULL picture of what it changed \u2014 the unified `effects`: git content (landings, creatives, flows, knowledge, brand), plus DB-only effects that never touch the repo \u2014 Actions, Scheduled agents, Tags, Tag Manager, Google Analytics, ad-platform writes, the funnel (`funnel`: which steps it added, changed or removed, and which ways in it added or removed in `triggersAdded`/`triggersRemoved`), what counts as a conversion (`conversions`), conversion sends, event sources, and every other staged or already-applied change (`otherChanges`: A/B tests, recipes, library images) \u2014 each resolved to real detail (names, descriptions, priorities, tag types, ad operations) and, once published, its `outcome`. Also `publish` (what each external surface actually did, with the provider's own error), `activity` (the chat's own timeline: status changes, publish start/fail, workspace recoveries, timeouts), `usage` (per-thread cost and the Session's token totals), the kickoff (how it was asked), threads, and commits. Effects are `staged` (in-progress draft) or applied. A completed Session is NOT proof its external changes landed \u2014 read `publish`. Use after `baker chats list` to decide whether to reuse it. Read-only.",
+  args: {
+    id: { type: "positional", description: "The Session id (from `baker chats list`)", required: true },
+    full: {
+      type: "boolean",
+      description: "Untruncated effect lists and full activity metadata (compact caps each list at 25)",
+      required: false,
+      default: false
+    }
+  }
+});
+var viewCommand = defineCommand({
+  meta: {
+    name: "view",
+    description: "Inspect one Session's full effects \u2014 git content + actions/tags/ads, kickoff, commits."
+  },
+  args: {
+    id: { type: "positional", description: "The Session id", required: true },
+    full: { type: "boolean", description: "Include full detail", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const response = await apiPost("/api/chats/view", {
+        chatId: args.id,
+        ...args.full ? { full: true } : {}
+      });
+      const hints = [];
+      if (response.data.publish && !response.data.publish.complete) {
+        const failed = response.data.publish.failedTotal;
+        hints.push(
+          `This Session's publish left ${failed} change${failed === 1 ? "" : "s"} behind \u2014 see \`publish.surfaces\` for the platform's own words. Do not report those changes as live.`
+        );
+      }
+      if (response.data.diffAvailable) {
+        hints.push("See the real file-level diff of the git content with `baker chats diff <id> --full`.");
+      } else if (response.data.status === "in_progress" || response.data.status === "publishing") {
+        hints.push(
+          "This Session is still in progress \u2014 read its current file changes with `baker chats diff <id> --live`."
+        );
+      }
+      hints.push("Read the conversation with `baker chats transcript <id>`.");
+      writeJson({ ...response, hints });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+registerSchema({
+  command: "chats.transcript",
+  description: "Read another Session's conversation (user + agent turns), most-recent first-capped. Use to see exactly how a past request was phrased and iterated before replaying it for a new goal. Compact truncates long messages; add --full for verbatim text. Read-only.",
+  args: {
+    id: { type: "positional", description: "The Session id", required: true },
+    limit: { type: "string", description: "Max messages to return, 1-1000 (default: 100)", required: false },
+    full: {
+      type: "boolean",
+      description: "Return verbatim (untruncated) message text",
+      required: false,
+      default: false
+    }
+  }
+});
+var transcriptCommand = defineCommand({
+  meta: { name: "transcript", description: "Read another Session's conversation." },
+  args: {
+    id: { type: "positional", description: "The Session id", required: true },
+    limit: { type: "string", description: "Max messages (1-1000, default 100)", required: false },
+    full: { type: "boolean", description: "Verbatim message text", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = { chatId: args.id };
+      const limit = parseBoundedInt(args.limit, "limit", 1, 1e3);
+      if (limit !== void 0) {
+        body.limit = limit;
+      }
+      if (args.full) {
+        body.full = true;
+      }
+      const response = await apiPost("/api/chats/transcript", body);
+      writeJson({
+        ...response,
+        meta: { count: response.data.entries.length },
+        ...response.data.truncated ? { hints: ["Older messages were dropped to fit --limit. Raise --limit to see more."] } : {}
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+registerSchema({
+  command: "chats.diff",
+  description: "See the real file-level changes a Session made (landings, creatives, brand, flows, knowledge). Published Sessions read from git; for an in-progress (unpublished) Session pass --live to read its changes straight from its running workspace. Without --live, an unpublished Session returns available:false \u2014 use `baker chats view` for the staged summary. Compact lists changed files with +/- counts; add --full for the actual diff text. Read-only.",
+  args: {
+    id: { type: "positional", description: "The Session id", required: true },
+    surface: {
+      type: "string",
+      description: "Filter to one surface: knowledge|company|brand|landings|flows|creatives",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "Include the unified-diff patch text per file",
+      required: false,
+      default: false
+    },
+    live: {
+      type: "boolean",
+      description: "For an in-progress Session, read its changes from the live workspace (slower; resumes the paused Runtime). Ignored for published Sessions.",
+      required: false,
+      default: false
+    }
+  }
+});
+var diffCommand = defineCommand({
+  meta: { name: "diff", description: "See a published Session's real file-level changes." },
+  args: {
+    id: { type: "positional", description: "The Session id", required: true },
+    surface: {
+      type: "string",
+      description: "Filter: knowledge|company|brand|landings|flows|creatives",
+      required: false
+    },
+    full: { type: "boolean", description: "Include the diff patch text per file", required: false, default: false },
+    live: {
+      type: "boolean",
+      description: "Read an in-progress Session's changes from its live workspace (slower)",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = { chatId: args.id };
+      if (args.surface) {
+        if (!REPO_SURFACES.includes(args.surface)) {
+          throw new Error(`--surface must be one of: ${REPO_SURFACES.join("|")}`);
+        }
+        body.surface = args.surface;
+      }
+      if (args.full) {
+        body.full = true;
+      }
+      if (args.live) {
+        body.live = true;
+      }
+      const response = await apiPost("/api/chats/diff", body);
+      writeJson({
+        ...response,
+        meta: { count: response.data.files.length },
+        ...!response.data.available && response.data.reason ? { hints: [response.data.reason] } : {},
+        ...response.data.available && !args.full && response.data.files.length > 0 ? { hints: ["Add --full to read the actual diff text for each file."] } : {}
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var chatsCommand = defineCommand({
+  meta: {
+    name: "chats",
+    description: `Inspect other Sessions on this account (read-only): list them, view what they produced, read their conversation, and see their real file changes \u2014 so you can reuse past work for a new goal.
+Full guide: __tooling__/docs/tools/baker/chats.md`
+  },
+  subCommands: {
+    list: listCommand,
+    view: viewCommand,
+    transcript: transcriptCommand,
+    diff: diffCommand
+  }
+});
+export {
+  chatsCommand
+};
+//# sourceMappingURL=chats-DNLK6TTQ.js.map

package/dist/chunk-2EINLGUZ.js

@@ -0,0 +1,207 @@
+import {
+  nodeParamsPreview
+} from "./chunk-32JOLCMG.js";
+import {
+  creativeSlugFromCanvasPath,
+  parseDefinitionSeriesPlace,
+  parseDefinitionSourceFields,
+  parseDefinitionStrategyFields
+} from "./chunk-MSJKALUF.js";
+import {
+  prepareCanvas
+} from "./chunk-WNTVBUVI.js";
+import {
+  BackendClient
+} from "./chunk-UE2RCK6D.js";
+import {
+  nodeDependencies
+} from "./chunk-3GGDOCKZ.js";
+import {
+  requireCredentialsFromEnv
+} from "./chunk-W6ZA67TV.js";
+
+// src/commands/canvas/sync-definition.ts
+import { readdir, readFile, stat } from "fs/promises";
+import path from "path";
+import { parseDocument } from "yaml";
+import { defineCommand } from "citty";
+
+// src/commands/canvas/definition-graph.ts
+var MAX_NODES = 300;
+var PREVIEWABLE_INGEST_EXPECTS = /* @__PURE__ */ new Set(["image"]);
+function nodeInputPreviewUrl(type, params) {
+  if (type !== "ingest" || !params || typeof params !== "object") return void 0;
+  const p = params;
+  if (p.source !== "url" || typeof p.url !== "string") return void 0;
+  if (!/^https?:\/\//i.test(p.url)) return void 0;
+  if (typeof p.expect === "string" && !PREVIEWABLE_INGEST_EXPECTS.has(p.expect)) return void 0;
+  return p.url;
+}
+function canvasToDefinitionGraph(canvas) {
+  const rawNodes = canvas?.nodes;
+  if (!Array.isArray(rawNodes)) return null;
+  const parsed = [];
+  for (const raw of rawNodes) {
+    const id = raw?.id;
+    const type = raw?.type;
+    if (typeof id !== "string" || typeof type !== "string") continue;
+    parsed.push({ id, type, inputs: raw.inputs, params: raw.params });
+    if (parsed.length >= MAX_NODES) break;
+  }
+  if (parsed.length === 0) return null;
+  const ids = new Set(parsed.map((n) => n.id));
+  const nodes = parsed.map(({ id, type, inputs, params }) => {
+    const deps = nodeDependencies({ id, inputs, params }, ids);
+    deps.delete(id);
+    const depList = [...deps];
+    const paramsPreview = nodeParamsPreview(params, depList);
+    const base = { id, type };
+    if (depList.length > 0) base.deps = depList;
+    if (paramsPreview) base.paramsPreview = paramsPreview;
+    const inputPreviewUrl = nodeInputPreviewUrl(type, params);
+    if (inputPreviewUrl) base.inputPreviewUrl = inputPreviewUrl;
+    return base;
+  });
+  const rawOutput = canvas?.output;
+  const outNode = rawOutput?.node;
+  const outSlot = rawOutput?.output;
+  const output = typeof outNode === "string" && typeof outSlot === "string" ? { node: outNode, output: outSlot } : void 0;
+  return { nodes, output };
+}
+
+// src/commands/canvas/sync-definition.ts
+function buildDefinitionSyncPayload(input, graph, chatId) {
+  const { canvas: _canvas, ...fields } = input;
+  return Object.fromEntries([
+    ...Object.entries(fields).filter(([, v]) => v !== void 0),
+    ["graph", graph],
+    ["chatId", chatId]
+  ]);
+}
+async function readDefinitionSourceFields(canvasPath) {
+  try {
+    return parseDefinitionSourceFields(await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8"));
+  } catch {
+    return {};
+  }
+}
+async function readDefinitionTitle(canvasPath) {
+  try {
+    const raw = await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8");
+    const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
+    const doc = match ? parseDocument(match[1] ?? "") : null;
+    const title = doc && doc.errors.length === 0 ? doc.get("title") : void 0;
+    return typeof title === "string" && title.trim() ? title.trim() : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function readDefinitionStrategyFields(canvasPath) {
+  try {
+    return parseDefinitionStrategyFields(await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8"));
+  } catch {
+    return {};
+  }
+}
+async function readDefinitionSeriesPlace(canvasPath) {
+  try {
+    return parseDefinitionSeriesPlace(await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8")) ?? {};
+  } catch {
+    return {};
+  }
+}
+async function syncCreativeDefinitionBestEffort(input) {
+  const chatId = process.env.BAKER_CHAT_ID;
+  if (!chatId) return;
+  const graph = canvasToDefinitionGraph(input.canvas);
+  if (!graph || graph.nodes.length === 0) return;
+  try {
+    const creds = requireCredentialsFromEnv();
+    const client = new BackendClient({ baseUrl: creds.url, apiKey: creds.apiKey });
+    await client.syncCreativeDefinition(buildDefinitionSyncPayload(input, graph, chatId));
+    process.stdout.write(`[definition] synced workflow graph (${graph.nodes.length} nodes) \u2014 view it in the dashboard
+`);
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    process.stderr.write(`[warn] workflow graph not synced (${msg})
+`);
+  }
+}
+async function resolveCanvasPath(inputPath) {
+  const resolved = path.resolve(inputPath);
+  let dir = resolved;
+  try {
+    if ((await stat(resolved)).isFile()) {
+      if (resolved.endsWith(".canvas.json")) return resolved;
+      dir = path.dirname(resolved);
+    }
+  } catch {
+    dir = resolved.endsWith(".canvas.json") ? path.dirname(resolved) : resolved;
+  }
+  let entries;
+  try {
+    entries = await readdir(dir);
+  } catch {
+    return null;
+  }
+  const canvases = entries.filter((name) => name.endsWith(".canvas.json"));
+  const slug = creativeSlugFromCanvasPath(`${dir}/x/`);
+  const chosen = (slug ? canvases.find((name) => name === `${slug}.canvas.json`) : void 0) ?? canvases[0];
+  return chosen ? path.join(dir, chosen) : null;
+}
+var syncDefinitionCommand = defineCommand({
+  meta: {
+    name: "sync-definition",
+    description: "Push a creative's current node-graph + input thumbnails to the dashboard without rendering. The graph has the creative's blueprint applied (prompt.json and scenes/*.json edits), exactly as `run` would render it, without changing any file. Runs automatically when you edit a creative's canvas.json or prompt.json."
+  },
+  args: {
+    file: {
+      type: "positional",
+      required: true,
+      description: "A path under src/creatives/<slug>/ (the .canvas.json, its prompt.json, or the folder)"
+    },
+    title: {
+      type: "boolean",
+      description: "Also record the title its _definition.md gives. Only for a creative just made from another (a series ad, a translation), never on an edit re-sync."
+    }
+  },
+  async run({ args }) {
+    const canvasPath = await resolveCanvasPath(String(args.file));
+    if (!canvasPath) {
+      return;
+    }
+    const slug = creativeSlugFromCanvasPath(canvasPath);
+    if (!slug) return;
+    let canvas;
+    let sourceSha;
+    try {
+      const prepared = await prepareCanvas(canvasPath, { write: false });
+      canvas = prepared.fileGraph;
+      sourceSha = prepared.sourceSha;
+    } catch {
+      return;
+    }
+    const title = args.title ? await readDefinitionTitle(canvasPath) : void 0;
+    await syncCreativeDefinitionBestEffort({
+      slug,
+      canvas,
+      sourceSha,
+      ...title ? { title } : {},
+      ...await readDefinitionSourceFields(canvasPath),
+      ...await readDefinitionStrategyFields(canvasPath),
+      ...await readDefinitionSeriesPlace(canvasPath)
+    });
+  }
+});
+
+export {
+  buildDefinitionSyncPayload,
+  readDefinitionSourceFields,
+  readDefinitionTitle,
+  readDefinitionStrategyFields,
+  readDefinitionSeriesPlace,
+  syncCreativeDefinitionBestEffort,
+  resolveCanvasPath,
+  syncDefinitionCommand
+};
+//# sourceMappingURL=chunk-2EINLGUZ.js.map