@koda-sl/baker-cli 0.513.0 → 0.514.0

package/dist/promoted-tweet-writes-Y6BBOWDL.js

@@ -0,0 +1,183 @@
+import {
+  csvArg,
+  requireTargets,
+  stageAccountId,
+  stageXOp,
+  stageXOps
+} from "./chunk-OR6KVLI5.js";
+import "./chunk-FIN4ZXGJ.js";
+import "./chunk-7NF73SCB.js";
+import "./chunk-ZRP7Y2DM.js";
+import {
+  TARGETING_OPERATORS,
+  TARGETING_TYPES
+} from "./chunk-PC3FJEZH.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-46YLDIQG.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/promoted-tweet-writes.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.promotedTweets.create",
+  description: "Stage promoting one or more existing posts in an X ad group. Takes post (tweet) ids \u2014 the numeric id from the post's URL, not a base36 ads id.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "line-item-id": {
+      type: "string",
+      description: "Ad group id, or an x_temp_* ref staged in this draft",
+      required: true
+    },
+    "tweet-ids": { type: "string", description: "CSV of post ids", required: true }
+  }
+});
+var promotedTweetsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage promoting posts in an ad group (applies when the chat is published).
+
+Example:
+  baker ads x promoted-tweets create --line-item-id wiee9 --tweet-ids 2042198488033661285`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "line-item-id": { type: "string", description: "Ad group id or x_temp_* ref", required: true },
+    "tweet-ids": { type: "string", description: "CSV of post ids", required: true }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOp({
+      kind: "promotedTweet.create",
+      accountId,
+      payload: { lineItemId: args["line-item-id"], tweetIds: csvArg(args["tweet-ids"]) ?? [] }
+    });
+  }
+});
+registerSchema({
+  command: "ads.x.promotedTweets.remove",
+  description: "Stage removing one or more promoted posts. X has no pause for these \u2014 removal is the only way to stop one serving, and it cannot be undone (re-promoting creates a new association).",
+  args: {
+    ids: { type: "string", description: "Promoted-post ids, comma-separated", required: true },
+    "account-id": { type: "string", description: "X Ads account ID", required: false }
+  }
+});
+var promotedTweetsRemoveCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: `Stage removing promoted posts. Cannot be undone.
+
+Example:
+  baker ads x promoted-tweets remove ayyorn,ayyoro`
+  },
+  args: {
+    ids: { type: "positional", description: "Promoted-post ids, comma-separated", required: true },
+    "account-id": { type: "string", description: "X Ads account ID" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOps(
+      requireTargets(args, "ids").map((id) => ({
+        kind: "promotedTweet.remove",
+        accountId,
+        target: id,
+        payload: {}
+      }))
+    );
+  }
+});
+registerSchema({
+  command: "ads.x.targetingCriteria.create",
+  description: `Stage one targeting criterion on an X ad group. One op per value, because X stores each criterion as its own entity. Look values up first with \`baker ads x targeting-constants\`.
+Types: ${TARGETING_TYPES.join(", ")}. Operators: ${TARGETING_OPERATORS.join(" (include) | ")} (exclude).`,
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "line-item-id": { type: "string", description: "Ad group id, or an x_temp_* ref", required: true },
+    type: { type: "string", description: TARGETING_TYPES.join(" | "), required: true },
+    value: {
+      type: "string",
+      description: "Targeting value \u2014 from `targeting-constants` for the lookup types",
+      required: true
+    },
+    operator: { type: "string", description: "EQ to include (default), NE to exclude", required: false }
+  }
+});
+var targetingCriteriaCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage one targeting criterion on an ad group.
+
+Examples:
+  baker ads x targeting-criteria create --line-item-id wiee9 --type LOCATION --value 96683cc9126741d1
+  baker ads x targeting-criteria create --line-item-id wiee9 --type INTEREST --value 25 --operator NE`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "line-item-id": { type: "string", description: "Ad group id or x_temp_* ref", required: true },
+    type: { type: "string", description: TARGETING_TYPES.join(" | "), required: true },
+    value: { type: "string", description: "Targeting value", required: true },
+    operator: { type: "string", description: "EQ (include) | NE (exclude)" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOp({
+      kind: "targetingCriteria.create",
+      accountId,
+      payload: {
+        lineItemId: args["line-item-id"],
+        targetingType: args.type,
+        targetingValue: args.value,
+        ...args.operator ? { operatorType: args.operator } : {}
+      }
+    });
+  }
+});
+registerSchema({
+  command: "ads.x.targetingCriteria.remove",
+  description: "Stage removing one or more targeting criteria from an X ad group.",
+  args: {
+    ids: { type: "string", description: "Targeting criterion ids, comma-separated", required: true },
+    "account-id": { type: "string", description: "X Ads account ID", required: false }
+  }
+});
+var targetingCriteriaRemoveCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: `Stage removing targeting criteria.
+
+Example:
+  baker ads x targeting-criteria remove 1dmtken`
+  },
+  args: {
+    ids: { type: "positional", description: "Targeting criterion ids, comma-separated", required: true },
+    "account-id": { type: "string", description: "X Ads account ID" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOps(
+      requireTargets(args, "ids").map((id) => ({
+        kind: "targetingCriteria.remove",
+        accountId,
+        target: id,
+        payload: {}
+      }))
+    );
+  }
+});
+export {
+  promotedTweetsCreateCommand,
+  promotedTweetsRemoveCommand,
+  targetingCriteriaCreateCommand,
+  targetingCriteriaRemoveCommand
+};
+//# sourceMappingURL=promoted-tweet-writes-Y6BBOWDL.js.map

package/dist/promoted-tweet-writes-Y6BBOWDL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/promoted-tweet-writes.ts"],"sourcesContent":["import { TARGETING_OPERATORS, TARGETING_TYPES } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { csvArg, requireTargets, stageAccountId, stageXOp, stageXOps } from \"./write-shared.ts\";\n\n/**\n * Staged ad and targeting writes.\n *\n * \"Promoted tweet\" is X's name for the association between a post and an ad\n * group — the thing X Ads Manager calls an ad. There is no pause: the only way\n * to stop one serving is to remove the association, which leaves the post itself\n * untouched.\n */\n\nregisterSchema({\n  command: \"ads.x.promotedTweets.create\",\n  description:\n    \"Stage promoting one or more existing posts in an X ad group. Takes post (tweet) ids — the numeric id from the post's URL, not a base36 ads id.\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    \"line-item-id\": {\n      type: \"string\",\n      description: \"Ad group id, or an x_temp_* ref staged in this draft\",\n      required: true,\n    },\n    \"tweet-ids\": { type: \"string\", description: \"CSV of post ids\", required: true },\n  },\n});\n\nexport const promotedTweetsCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage promoting posts in an ad group (applies when the chat is published).\n\nExample:\n  baker ads x promoted-tweets create --line-item-id wiee9 --tweet-ids 2042198488033661285`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\" },\n    \"line-item-id\": { type: \"string\", description: \"Ad group id or x_temp_* ref\", required: true },\n    \"tweet-ids\": { type: \"string\", description: \"CSV of post ids\", required: true },\n  },\n  run: async ({ args }) => {\n    const accountId = await stageAccountId(args);\n    await stageXOp({\n      kind: \"promotedTweet.create\",\n      accountId,\n      payload: { lineItemId: args[\"line-item-id\"], tweetIds: csvArg(args[\"tweet-ids\"]) ?? [] },\n    });\n  },\n});\n\nregisterSchema({\n  command: \"ads.x.promotedTweets.remove\",\n  description:\n    \"Stage removing one or more promoted posts. X has no pause for these — removal is the only way to stop one serving, and it cannot be undone (re-promoting creates a new association).\",\n  args: {\n    ids: { type: \"string\", description: \"Promoted-post ids, comma-separated\", required: true },\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n  },\n});\n\nexport const promotedTweetsRemoveCommand = defineCommand({\n  meta: {\n    name: \"remove\",\n    description: `Stage removing promoted posts. Cannot be undone.\n\nExample:\n  baker ads x promoted-tweets remove ayyorn,ayyoro`,\n  },\n  args: {\n    ids: { type: \"positional\", description: \"Promoted-post ids, comma-separated\", required: true },\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\" },\n  },\n  run: async ({ args }) => {\n    const accountId = await stageAccountId(args);\n    await stageXOps(\n      requireTargets(args, \"ids\").map((id) => ({\n        kind: \"promotedTweet.remove\",\n        accountId,\n        target: id,\n        payload: {},\n      })),\n    );\n  },\n});\n\nregisterSchema({\n  command: \"ads.x.targetingCriteria.create\",\n  description: `Stage one targeting criterion on an X ad group. One op per value, because X stores each criterion as its own entity. Look values up first with \\`baker ads x targeting-constants\\`.\nTypes: ${TARGETING_TYPES.join(\", \")}. Operators: ${TARGETING_OPERATORS.join(\" (include) | \")} (exclude).`,\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    \"line-item-id\": { type: \"string\", description: \"Ad group id, or an x_temp_* ref\", required: true },\n    type: { type: \"string\", description: TARGETING_TYPES.join(\" | \"), required: true },\n    value: {\n      type: \"string\",\n      description: \"Targeting value — from `targeting-constants` for the lookup types\",\n      required: true,\n    },\n    operator: { type: \"string\", description: \"EQ to include (default), NE to exclude\", required: false },\n  },\n});\n\nexport const targetingCriteriaCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage one targeting criterion on an ad group.\n\nExamples:\n  baker ads x targeting-criteria create --line-item-id wiee9 --type LOCATION --value 96683cc9126741d1\n  baker ads x targeting-criteria create --line-item-id wiee9 --type INTEREST --value 25 --operator NE`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\" },\n    \"line-item-id\": { type: \"string\", description: \"Ad group id or x_temp_* ref\", required: true },\n    type: { type: \"string\", description: TARGETING_TYPES.join(\" | \"), required: true },\n    value: { type: \"string\", description: \"Targeting value\", required: true },\n    operator: { type: \"string\", description: \"EQ (include) | NE (exclude)\" },\n  },\n  run: async ({ args }) => {\n    const accountId = await stageAccountId(args);\n    await stageXOp({\n      kind: \"targetingCriteria.create\",\n      accountId,\n      payload: {\n        lineItemId: args[\"line-item-id\"],\n        targetingType: args.type,\n        targetingValue: args.value,\n        ...(args.operator ? { operatorType: args.operator } : {}),\n      },\n    });\n  },\n});\n\nregisterSchema({\n  command: \"ads.x.targetingCriteria.remove\",\n  description: \"Stage removing one or more targeting criteria from an X ad group.\",\n  args: {\n    ids: { type: \"string\", description: \"Targeting criterion ids, comma-separated\", required: true },\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n  },\n});\n\nexport const targetingCriteriaRemoveCommand = defineCommand({\n  meta: {\n    name: \"remove\",\n    description: `Stage removing targeting criteria.\n\nExample:\n  baker ads x targeting-criteria remove 1dmtken`,\n  },\n  args: {\n    ids: { type: \"positional\", description: \"Targeting criterion ids, comma-separated\", required: true },\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\" },\n  },\n  run: async ({ args }) => {\n    const accountId = await stageAccountId(args);\n    await stageXOps(\n      requireTargets(args, \"ids\").map((id) => ({\n        kind: \"targetingCriteria.remove\",\n        accountId,\n        target: id,\n        payload: {},\n      })),\n    );\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/promoted-tweets-RJT53DRM.js

@@ -0,0 +1,119 @@
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-7NF73SCB.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/promoted-tweets.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.promotedTweets",
+  description: "List promoted tweets for an X Ads account. Returns id, line_item_id, tweet_id, approval_status. Filter by line-item-ids (CSV).",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+    "with-deleted": { type: "boolean", description: "Include deleted", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+var promotedTweetsListCommand = defineCommand({
+  meta: {
+    name: "promoted-tweets",
+    description: `List X Ads promoted tweets.
+
+Examples:
+  baker ads x promoted-tweets --account-id 18ce53xyz --line-item-ids abc,def`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+    "with-deleted": { type: "boolean", description: "Include deleted", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const useCache = !args["no-cache"];
+    const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    const cacheKey = `promoted-tweets:${accountId}:${today}:${args["line-item-ids"] ?? ""}:${args["with-deleted"] ? "1" : "0"}`;
+    if (useCache) {
+      const cached = cacheGet("x-account-data", cacheKey);
+      if (cached) {
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      const params = { "account-id": accountId };
+      if (args["line-item-ids"]) params["line-item-ids"] = args["line-item-ids"];
+      if (args["with-deleted"]) params["with-deleted"] = "true";
+      if (!useCache) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/x/promoted-tweets", params);
+      if (useCache) {
+        cacheSet("x-account-data", cacheKey, data, 60 * 60 * 1e3);
+      }
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(data, format);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+var promotedTweetsCommand = defineCommand({
+  meta: {
+    name: "promoted-tweets",
+    description: `Promoted posts \u2014 the association between a post and an ad group, which X Ads Manager calls an ad.
+
+There is no pause: removing the association is the only way to stop one serving,
+and it cannot be undone (re-promoting creates a new one). The post itself is
+never touched.
+
+Examples:
+  baker ads x promoted-tweets
+  baker ads x promoted-tweets create --line-item-id wiee9 --tweet-ids 2042198488033661285
+  baker ads x promoted-tweets remove ayyorn`
+  },
+  subCommands: {
+    list: promotedTweetsListCommand,
+    create: () => import("./promoted-tweet-writes-Y6BBOWDL.js").then((m) => m.promotedTweetsCreateCommand),
+    remove: () => import("./promoted-tweet-writes-Y6BBOWDL.js").then((m) => m.promotedTweetsRemoveCommand)
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs" },
+    "with-deleted": { type: "boolean", description: "Include deleted" },
+    "no-cache": { type: "boolean", description: "Skip cache" },
+    output: { type: "string", description: "Format: json|csv|md", default: "json" }
+  },
+  default: "list"
+});
+export {
+  promotedTweetsCommand
+};
+//# sourceMappingURL=promoted-tweets-RJT53DRM.js.map

package/dist/publish-IOTMJCCY.js

@@ -0,0 +1,344 @@
+import {
+  advanceDefinitionStatus,
+  definitionPathFor
+} from "./chunk-3ACMDRSE.js";
+import {
+  defaultVideoApiDeps,
+  detectVideoContentType,
+  isVideoFile,
+  uploadLocalVideo,
+  videoProcessingTimeoutMs,
+  waitForPlayableVideo
+} from "./chunk-SKXXSTNM.js";
+import {
+  defaultImageApiDeps,
+  detectImageContentType,
+  imageProcessingTimeoutMs,
+  publishImageAsCreative,
+  uploadImageBytes,
+  uploadLocalImage,
+  waitForReadyImage
+} from "./chunk-MKTLZCRJ.js";
+import {
+  fetchRunRecord
+} from "./chunk-FLWDFPXE.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-EJGAJHLB.js";
+import {
+  sha256Hex
+} from "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import "./chunk-PC3FJEZH.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-46YLDIQG.js";
+import {
+  ApiError
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  optionalChatId
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/publish.ts
+import { Buffer } from "buffer";
+import { defineCommand } from "citty";
+var creativeContentTypes = ["image/png", "image/jpeg", "image/webp"];
+var creativeVideoContentTypes = ["video/mp4", "video/quicktime", "video/webm"];
+var UNSUPPORTED_CREATIVE_FILE = "Unsupported creative file extension. Use PNG, JPG or WebP for an image, MP4, MOV or WebM for a video.";
+var DESCRIPTION = `Save a finished creative to Baker Creatives and return a creative reference: a static image (PNG/JPG/WebP) or a finished video render (MP4/MOV/WebM).
+Start here:
+  baker creatives publish ./canvas/r_01K\u2026/final_4x5.png --title "Spring Offer" --slug spring-offer --run-id r_01K\u2026
+  baker creatives publish --title "Spring Offer" --slug spring-offer --run-id r_01K\u2026 --output 4:5
+  baker creatives publish ./canvas/r_01K\u2026/final.mp4 --title "Spring Offer Reel" --slug spring-offer --run-id r_01K\u2026
+With --run-id and no file, every size the run made is saved to the library as one set, the lead size first, and the lead is the creative's cover (--output picks another cover); \`sizes\` names each size's image id. A video goes to the company's video library first and is saved once it plays (up to 3 minutes); it needs the file and --slug. Choose and save the finished version yourself, including in the turn that rendered it. Saving pins that version without recording user approval or putting an ad live. An image publish marks the creative's _definition.md published.`;
+var ARGS = {
+  file: {
+    type: "string",
+    description: "Local creative file: PNG/JPG/WebP image or MP4/MOV/WebM video. Optional for an image with --run-id: the run's saved output is used instead.",
+    required: false
+  },
+  title: { type: "string", description: "Human title for the creative output", required: true },
+  context: { type: "string", description: "Optional describe context for the image asset", required: false },
+  sourceReferenceUrl: {
+    type: "string",
+    description: "Optional URL of the original reference ad",
+    required: false
+  },
+  slug: {
+    type: "string",
+    description: "Creative slug (src/creatives/<slug>/). Attaches the image or video to that creative's row. Required for a video",
+    required: false
+  },
+  runId: {
+    type: "string",
+    description: "Canvas run id (r_\u2026) of the finished generation to pin as published",
+    required: false
+  },
+  output: {
+    type: "string",
+    description: "With --run-id and no file: which of the run's sizes is the creative's cover, by label (e.g. 9:16), slot, or number (1 = first). Every size is saved either way; default the lead.",
+    required: false
+  }
+};
+registerSchema({ command: "creatives.publish", description: DESCRIPTION, args: ARGS });
+var SIZES_HINT = "Each size is its own image: on Meta, stage the 4:5 for Feed and the 9:16 for Stories and Reels (one ad, asset_customization_rules); LinkedIn takes the 1:1.";
+function detectCreativeContentType(filePath) {
+  return detectImageContentType(filePath, {
+    allowedContentTypes: creativeContentTypes,
+    unsupportedMessage: UNSUPPORTED_CREATIVE_FILE
+  });
+}
+function chatIdFromEnv() {
+  return optionalChatId();
+}
+function parseOptionalUrl(value) {
+  if (value === void 0 || value.trim() === "") {
+    return void 0;
+  }
+  try {
+    return new URL(value).toString();
+  } catch {
+    throw new ApiError("VALIDATION_ERROR", "--source-reference-url must be a valid URL");
+  }
+}
+async function downloadBytes(url) {
+  const res = await fetch(url);
+  if (!res.ok) throw new ApiError("UNAVAILABLE", `Could not read the run's output (${res.status} ${res.statusText})`);
+  return Buffer.from(await res.arrayBuffer());
+}
+function runImages(run) {
+  if (run.status !== "completed") {
+    throw new ApiError(
+      "VALIDATION_ERROR",
+      `Run ${run.runId} did not finish (${run.status}), so it has no result to publish. Finish the run first, or pass the image file.`
+    );
+  }
+  const finals = run.finalOutputs.filter((o) => typeof o.url === "string");
+  if (finals.some((o) => !creativeContentTypes.some((t) => t === o.mime))) {
+    throw new ApiError(
+      "VALIDATION_ERROR",
+      `Run ${run.runId} made a video, not a still image. Publish the video file: baker creatives publish ./canvas/${run.runId}/<file>.mp4 --slug <slug> --run-id ${run.runId}.`
+    );
+  }
+  return finals;
+}
+function describeOutputs(outputs) {
+  return outputs.map((o, i) => `${i + 1}: ${o.label ?? o.slot}`).join(", ");
+}
+var MASTER_NODE = "master";
+function leadFirst(run, images) {
+  const master = new Set(
+    run.nodes.filter((n) => n.nodeId === MASTER_NODE).flatMap((n) => n.outputs.map((o) => o.sha256))
+  );
+  const at = images.findIndex((o) => master.has(o.sha256));
+  return at > 0 ? [images[at], ...images.filter((_, i) => i !== at)] : [...images];
+}
+function orderedOutputs(run, choice) {
+  const images = leadFirst(run, runImages(run));
+  if (images.length === 0) {
+    throw new ApiError(
+      "VALIDATION_ERROR",
+      `Run ${run.runId} has no saved image to publish. Pass the image file instead.`
+    );
+  }
+  if (choice === void 0) return { outputs: images, cover: 0 };
+  const wanted = choice.trim();
+  const byNumber = /^\d+$/.test(wanted) ? Number(wanted) - 1 : -1;
+  const cover = images[byNumber] ? byNumber : images.findIndex((o) => o.label === wanted || o.slot === wanted);
+  if (cover < 0) {
+    throw new ApiError("VALIDATION_ERROR", `Run ${run.runId} has no output "${wanted}" (${describeOutputs(images)}).`);
+  }
+  return { outputs: images, cover };
+}
+var EXTENSION = { "image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp" };
+async function uploadRunOutputs(args, deps) {
+  const run = await fetchRunRecord(args.runId, deps.post);
+  if (!run) {
+    throw new ApiError(
+      "NOT_FOUND",
+      `No run "${args.runId}" in this company's run history. Pass the image file instead.`
+    );
+  }
+  const { outputs, cover } = orderedOutputs(run, args.output);
+  const sizes = [];
+  for (const [index, chosen] of outputs.entries()) {
+    const bytes = await (deps.download ?? downloadBytes)(String(chosen.url));
+    if (sha256Hex(bytes) !== chosen.sha256) {
+      throw new ApiError(
+        "VALIDATION_ERROR",
+        `The saved output of run ${run.runId} does not match its recorded fingerprint`
+      );
+    }
+    const name = (chosen.label ?? chosen.slot).replace(/[^a-z0-9.-]+/gi, "_");
+    const { imageId } = await uploadImageBytes(
+      {
+        bytes,
+        contentType: chosen.mime,
+        originalFilename: `${run.runId}-${name}${EXTENSION[chosen.mime] ?? ""}`,
+        source: "ai_generated",
+        descriptionContext: args.descriptionContext,
+        ...outputs.length > 1 ? {
+          group: {
+            key: `creative:${args.slug ?? "run"}:${run.runId}`,
+            kind: "creative_sizes",
+            index,
+            size: outputs.length,
+            title: args.title
+          }
+        } : {}
+      },
+      deps
+    );
+    sizes.push({ format: chosen.label ?? chosen.slot, imageId });
+  }
+  return { imageId: sizes[cover]?.imageId ?? "", sizes };
+}
+async function publishCreative(args, deps = defaultImageApiDeps) {
+  const title = args.title.trim();
+  if (!title) {
+    throw new ApiError("VALIDATION_ERROR", "--title is required");
+  }
+  const sourceReferenceUrl = parseOptionalUrl(args.sourceReferenceUrl);
+  const descriptionContext = args.context ?? `Static ad creative: ${title}`;
+  let upload;
+  if (args.file) {
+    upload = await uploadLocalImage(
+      {
+        file: args.file,
+        contentType: detectCreativeContentType(args.file),
+        source: "ai_generated",
+        descriptionContext
+      },
+      deps
+    );
+  } else if (args.runId) {
+    upload = await uploadRunOutputs(
+      {
+        runId: args.runId,
+        output: args.output,
+        descriptionContext,
+        ...args.slug ? { slug: args.slug } : {},
+        title
+      },
+      deps
+    );
+  } else {
+    throw new ApiError("VALIDATION_ERROR", "Pass the image file, or --run-id to save the run's own output");
+  }
+  await waitForReadyImage(deps, upload.imageId, { timeoutMs: imageProcessingTimeoutMs });
+  const saved = await publishImageAsCreative(deps, {
+    imageId: upload.imageId,
+    title,
+    sourceReferenceUrl,
+    slug: args.slug,
+    runId: args.runId,
+    // Attribute the publish to the driving chat (injected by the bridge).
+    chatId: chatIdFromEnv()
+  });
+  const result = upload.sizes && upload.sizes.length > 1 ? { ...saved, sizes: upload.sizes } : saved;
+  if (args.slug && args.runId) {
+    const cwd = process.cwd();
+    const root = deps.workspaceRoot ?? findWorkspaceRoot(cwd) ?? cwd;
+    const status = await advanceDefinitionStatus(definitionPathFor(root, args.slug), "published");
+    if (status === "updated") return { ...result, definitionStatus: "published" };
+  }
+  return result;
+}
+async function publishVideoCreative(args, deps = defaultVideoApiDeps) {
+  const title = args.title.trim();
+  if (!title) {
+    throw new ApiError("VALIDATION_ERROR", "--title is required");
+  }
+  const slug = args.slug?.trim();
+  if (!slug) {
+    throw new ApiError(
+      "VALIDATION_ERROR",
+      "--slug is required for a video: name the creative (src/creatives/<slug>/) this render belongs to"
+    );
+  }
+  const sourceReferenceUrl = parseOptionalUrl(args.sourceReferenceUrl);
+  const contentType = detectVideoContentType(args.file, {
+    allowedContentTypes: creativeVideoContentTypes,
+    unsupportedMessage: UNSUPPORTED_CREATIVE_FILE
+  });
+  const { videoId } = await uploadLocalVideo(
+    { file: args.file, contentType, descriptionContext: args.context ?? `Video ad creative: ${title}` },
+    deps
+  );
+  await waitForPlayableVideo(deps, videoId, { timeoutMs: videoProcessingTimeoutMs });
+  const body = { videoId, title, slug };
+  if (args.runId) body.runId = args.runId;
+  if (sourceReferenceUrl) body.sourceReferenceUrl = sourceReferenceUrl;
+  const chatId = chatIdFromEnv();
+  if (chatId) body.chatId = chatId;
+  return deps.post("/api/creatives/publish-video", body);
+}
+var publishCommand = defineCommand({
+  meta: { name: "publish", description: DESCRIPTION },
+  // Checked in `run` rather than by citty, so a missing value answers with the JSON envelope.
+  args: { ...ARGS, file: { ...ARGS.file, type: "positional" }, title: { ...ARGS.title, required: false } },
+  run: async ({ args }) => {
+    try {
+      const file = args.file;
+      const title = args.title;
+      const runId = args.runId;
+      if (!file && !runId) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: "Image or video path is required (or --run-id to save the run's own image)"
+          }
+        });
+        process.exit(1);
+      }
+      if (!title) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "--title is required" } });
+        process.exit(1);
+      }
+      const publishArgs = {
+        file: file || void 0,
+        title,
+        context: args.context,
+        sourceReferenceUrl: args.sourceReferenceUrl,
+        slug: args.slug,
+        runId
+      };
+      if (file && isVideoFile(file)) {
+        writeJson(await publishVideoCreative({ ...publishArgs, file }));
+        return;
+      }
+      const data = await publishCreative({
+        ...publishArgs,
+        output: args.output
+      });
+      writeJson({ ok: true, data, ...data.sizes ? { hints: [SIZES_HINT] } : {} });
+    } 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 {
+  detectCreativeContentType,
+  publishCommand,
+  publishCreative,
+  publishVideoCreative
+};
+//# sourceMappingURL=publish-IOTMJCCY.js.map