@koda-sl/baker-cli 0.545.0-dev.2a6beac48 → 0.546.0

package/dist/publish-IINRY5CV.js

@@ -0,0 +1,344 @@
+import {
+  advanceDefinitionStatus,
+  definitionPathFor
+} from "./chunk-3ACMDRSE.js";
+import {
+  defaultVideoApiDeps,
+  detectVideoContentType,
+  isVideoFile,
+  uploadLocalVideo,
+  videoProcessingTimeoutMs,
+  waitForPlayableVideo
+} from "./chunk-WUGTZHFI.js";
+import {
+  defaultImageApiDeps,
+  detectImageContentType,
+  imageProcessingTimeoutMs,
+  publishImageAsCreative,
+  uploadImageBytes,
+  uploadLocalImage,
+  waitForReadyImage
+} from "./chunk-EMCTUCCJ.js";
+import {
+  fetchRunRecord
+} from "./chunk-TB2EO2SY.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-BGT5ZA4L.js";
+import {
+  sha256Hex
+} from "./chunk-SYLPRIFM.js";
+import "./chunk-XBR7TSZN.js";
+import "./chunk-DGUN7FUH.js";
+import "./chunk-CMXTQ4PS.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  ApiError
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import {
+  optionalChatId
+} from "./chunk-E54435XT.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WCIS4FZH.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. `--output json` is the output format, never a cover.",
+    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-IINRY5CV.js.map

package/dist/query-FT2BA3WH.js

@@ -0,0 +1,62 @@
+import {
+  buildFileSummary,
+  buildQueryEnvelope,
+  completenessWarnings,
+  effectiveRowLimit,
+  keywordServingOptions,
+  missingFieldWarnings,
+  missingFieldWarningsFor,
+  outputResults,
+  pageCacheKey,
+  parseQueryLimit,
+  parseSelectedFields,
+  queryCommand,
+  queryPageSize,
+  resolveGaqlInput,
+  resultColumns,
+  runQuery,
+  servingScopeWarnings,
+  shouldReadCache,
+  summariseWarnings,
+  unobservedFields,
+  unobservedSelectedFields,
+  unwrittenColumnWarnings,
+  warningLines
+} from "./chunk-PXGR3VGW.js";
+import "./chunk-Y2FAUFWK.js";
+import "./chunk-JPK34QPS.js";
+import "./chunk-JLLGXYOZ.js";
+import "./chunk-SNWFM2DB.js";
+import "./chunk-MGWAZXY6.js";
+import "./chunk-MSMTG6OC.js";
+import "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  buildFileSummary,
+  buildQueryEnvelope,
+  completenessWarnings,
+  effectiveRowLimit,
+  keywordServingOptions,
+  missingFieldWarnings,
+  missingFieldWarningsFor,
+  outputResults,
+  pageCacheKey,
+  parseQueryLimit,
+  parseSelectedFields,
+  queryCommand,
+  queryPageSize,
+  resolveGaqlInput,
+  resultColumns,
+  runQuery,
+  servingScopeWarnings,
+  shouldReadCache,
+  summariseWarnings,
+  unobservedFields,
+  unobservedSelectedFields,
+  unwrittenColumnWarnings,
+  warningLines
+};
+//# sourceMappingURL=query-FT2BA3WH.js.map

package/dist/read-7ZFZAJSQ.js

@@ -0,0 +1,141 @@
+import {
+  TAG_MANAGER_TIMEOUT_MS,
+  handleError
+} from "./chunk-V2XA5SIO.js";
+import "./chunk-D5FY4FAK.js";
+import {
+  connectedResourceHints
+} from "./chunk-P4NSJS54.js";
+import {
+  AVAILABLE_ARG,
+  writeAvailableAccounts
+} from "./chunk-USVTT74J.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-MGWAZXY6.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import {
+  registerSchema
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/tag-manager/read.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "tagManager.containers",
+  description: "List the Google Tag Manager containers this company selected. There can be several, and Baker may read and change all of them. Start here to confirm which containers you are managing.",
+  args: { available: AVAILABLE_ARG }
+});
+registerSchema({
+  command: "tagManager.read",
+  description: "Read what is currently inside a Tag Manager container: tags, triggers, variables, folders and enabled built-in variables. Start here before proposing any change, so you edit what exists instead of duplicating it. Pass --container when the company connected more than one. Compact by default; pass --full for raw Tag Manager objects.",
+  args: {
+    container: {
+      type: "string",
+      description: "Numeric container id (optional only when one container is connected)",
+      required: false
+    },
+    workspace: { type: "string", description: "Workspace id (defaults to the default workspace)", required: false },
+    entities: {
+      type: "string",
+      description: "Comma-separated subset: tag,trigger,variable,folder,builtInVariable",
+      required: false
+    },
+    full: { type: "boolean", description: "Include the raw Tag Manager object for each entity", required: false }
+  }
+});
+function containersHints(containers, unavailableContainers = []) {
+  const hints = connectedResourceHints({
+    plural: "Tag Manager containers",
+    singular: "Tag Manager container",
+    flag: "--container",
+    resources: containers.map((container) => ({
+      id: container.containerId,
+      label: `${container.publicId} \xB7 ${container.name}`
+    }))
+  });
+  if (unavailableContainers.length > 0) {
+    const [available] = containers;
+    if (containers.length === 1 && available) {
+      hints.length = 0;
+      hints.push(
+        `Use --container ${available.containerId} for ${available.publicId} (${available.name}); another selected container cannot be opened.`
+      );
+    }
+    hints.push(
+      `Tag Manager cannot open ${unavailableContainers.map((container) => `${container.publicId} (${container.name})`).join(", ")}. Ask the user to reconnect with a Google account that has access to these containers.`
+    );
+  }
+  return hints;
+}
+var containersCommand = defineCommand({
+  meta: {
+    name: "containers",
+    description: `List Tag Manager containers selected by this company.
+
+Start here:
+  baker tag-manager containers
+  baker tag-manager containers --available   # every container the login reaches, selected or not`
+  },
+  args: { available: AVAILABLE_ARG },
+  run: async ({ args }) => {
+    if (args.available) return writeAvailableAccounts("google-tag-manager", handleError);
+    try {
+      const data = await apiGet("/api/tag-manager/containers");
+      writeJsonEnvelope({ ok: true, data, hints: containersHints(data.containers, data.unavailableContainers) });
+    } catch (err) {
+      handleError(err);
+    }
+  }
+});
+var readCommand = defineCommand({
+  meta: {
+    name: "read",
+    description: `Read the current contents of the Tag Manager container \u2014 always do this before staging changes.
+
+Examples:
+  baker tag-manager read
+  baker tag-manager read --entities tag,trigger
+  baker tag-manager read --full`
+  },
+  args: {
+    container: { type: "string", description: "Numeric container id", required: false },
+    workspace: { type: "string", description: "Workspace id", required: false },
+    entities: { type: "string", description: "Comma-separated entity subset", required: false },
+    full: { type: "boolean", description: "Include raw Tag Manager objects", required: false }
+  },
+  run: async ({ args }) => {
+    const entities = typeof args.entities === "string" && args.entities.length > 0 ? args.entities.split(",").map((entry) => entry.trim()) : void 0;
+    try {
+      const data = await apiPost(
+        "/api/tag-manager/read",
+        { containerId: args.container, workspaceId: args.workspace, entities, full: args.full === true },
+        { timeoutMs: TAG_MANAGER_TIMEOUT_MS }
+      );
+      const hints = [
+        `This is container ${data.container.containerId} ${data.container.publicId} (${data.container.name}). Stage changes for it with --container ${data.container.containerId}.`
+      ];
+      if (data.publicationWarning) hints.push(data.publicationWarning);
+      if (data.installedContainerMismatch) {
+        hints.push(data.installedContainerMismatch);
+      }
+      hints.push(
+        "Reference an existing trigger or variable by its numeric id or {{Name}}. To reference something you are staging in this same chat, use its gtm_temp_* ref and the executor resolves it at publish."
+      );
+      writeJsonEnvelope({ ok: true, data, hints });
+    } catch (err) {
+      handleError(err);
+    }
+  }
+});
+export {
+  containersCommand,
+  containersHints,
+  readCommand
+};
+//# sourceMappingURL=read-7ZFZAJSQ.js.map

package/dist/reddit-GN7JTUT4.js

@@ -0,0 +1,29 @@
+import {
+  findSubreddits,
+  redditCommand,
+  searchReddit,
+  subredditsFromArgs
+} from "./chunk-FWXYITXH.js";
+import "./chunk-FWMPRDJX.js";
+import "./chunk-W4W3F3P7.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-CMXTQ4PS.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MSMTG6OC.js";
+import "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  findSubreddits,
+  redditCommand,
+  searchReddit,
+  subredditsFromArgs
+};
+//# sourceMappingURL=reddit-GN7JTUT4.js.map

package/dist/refresh-GG3YE2OV.js

@@ -0,0 +1,97 @@
+import {
+  reportError
+} from "./chunk-NPJRACA2.js";
+import {
+  adLibraryRefreshRequestSchema
+} from "./chunk-CMXTQ4PS.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  apiPost
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/refresh.ts
+import { defineCommand } from "citty";
+function refreshEnvelope(data) {
+  if (data.queued) {
+    return {
+      ok: true,
+      data,
+      hints: [
+        "Re-scrape started \u2014 new ads arrive over the next minutes. Check progress with `baker winning-ads following`; carry on with the ads already there meanwhile."
+      ]
+    };
+  }
+  if (data.collecting) {
+    return {
+      ok: true,
+      data,
+      hints: [
+        `${data.label}'s ads are still being collected from the follow or the last refresh, so there is nothing to refresh yet. Check progress with \`baker winning-ads following\` and use what is there meanwhile.`
+      ]
+    };
+  }
+  if (data.nextAllowedAt !== void 0) {
+    const next = new Date(data.nextAllowedAt).toISOString();
+    return {
+      ok: false,
+      error: {
+        code: "RATE_LIMITED",
+        message: `${data.label} was refreshed less than 6 hours ago.`,
+        fix: `Use the ads already collected for ${data.label}; it can be refreshed again after ${next}. Do not retry before then.`
+      }
+    };
+  }
+  return {
+    ok: true,
+    data,
+    hints: ["Nothing new to look for on this brand right now; its ads are already up to date."]
+  };
+}
+registerSchema({
+  command: "winning-ads.refresh",
+  description: "Re-scrape a brand this company follows so its newest ads land in the library. At most once every 6 hours per brand, and not while its ads are still being collected; it costs a fresh scrape, so use it only when the user wants the latest ads.",
+  args: {
+    advertiser: { type: "string", description: "Advertiser id of a followed brand (from `following`)", required: true }
+  }
+});
+var refreshCommand = defineCommand({
+  meta: {
+    name: "refresh",
+    description: "Re-scrape a followed brand for its newest ads (at most once every 6 hours). Example: baker winning-ads refresh adv_123"
+  },
+  args: {
+    advertiser: { type: "positional", description: "Advertiser id of a followed brand", required: true }
+  },
+  run: async ({ args }) => {
+    const parsed = adLibraryRefreshRequestSchema.safeParse({ advertiser_id: String(args.advertiser ?? "") });
+    if (!parsed.success) {
+      writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: parsed.error.issues[0]?.message ?? "" } });
+      process.exit(1);
+    }
+    try {
+      const envelope = refreshEnvelope(await apiPost("/api/ad-library/refresh", parsed.data));
+      writeJson(envelope);
+      if (!envelope.ok) process.exit(1);
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  refreshCommand,
+  refreshEnvelope
+};
+//# sourceMappingURL=refresh-GG3YE2OV.js.map