@koda-sl/baker-cli 0.477.0-dev.55c09e3e8 → 0.477.0

package/dist/sticker-2JQUC7XO.js

@@ -0,0 +1,94 @@
+import {
+  ApiError,
+  apiPost
+} from "./chunk-7ANWFQEA.js";
+import "./chunk-KODTY7PB.js";
+import "./chunk-H5CGVMQW.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-ANYMWCST.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/sticker.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.sticker",
+  description: "Search Giphy stickers \u2014 transparent-background overlays for ad creative.",
+  args: {
+    query: { type: "string", description: "Search query (omit when --trending)", required: false },
+    trending: {
+      type: "boolean",
+      description: "Return the trending stickers feed instead of running a query",
+      required: false,
+      default: false
+    },
+    limit: { type: "number", description: "Max results (default 20, max 50)", required: false, default: 20 },
+    rating: {
+      type: "string",
+      description: "Content rating: g | pg | pg-13 | r (default pg)",
+      required: false
+    },
+    lang: { type: "string", description: "ISO 639-1 language code, e.g. en, es", required: false },
+    "auto-ingest": {
+      type: "number",
+      description: "Auto-ingest top N hits (default 0 \u2014 browse-style)",
+      required: false,
+      default: 0
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint applied to ingested stickers (overrides Giphy title/alt)",
+      required: false
+    }
+  }
+});
+var stickerCommand = defineCommand({
+  meta: {
+    name: "sticker",
+    description: "Search Giphy's sticker corpus \u2014 transparent-background WebPs / GIFs ideal for overlaying on ad creative (Meta, TikTok, Stories). Same Giphy free API as `baker images gif`; results carry WebP + GIF + MP4 URLs in providerMeta.\n\nExample: baker images sticker 'thumbs up' --limit 10\nExample: baker images sticker celebration --rating g --auto-ingest 3\nExample: baker images sticker --trending --limit 25"
+  },
+  args: {
+    query: { type: "positional", description: "Search query (omit with --trending)", required: false },
+    trending: { type: "boolean", description: "Trending feed", required: false },
+    limit: { type: "string", description: "Max results", required: false },
+    rating: { type: "string", description: "Content rating", required: false },
+    lang: { type: "string", description: "Language code", required: false },
+    "auto-ingest": { type: "string", description: "Auto-ingest top N", required: false },
+    context: { type: "string", description: "Description context hint applied to ingested stickers", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const query = args.query;
+      const trending = args.trending === true;
+      if (!query && !trending) {
+        writeJson({
+          ok: false,
+          error: { code: "VALIDATION_ERROR", message: "Query is required unless --trending is set" }
+        });
+        process.exit(1);
+      }
+      const body = {};
+      if (query) body.query = query;
+      if (trending) body.trending = true;
+      if (args.limit) body.limit = Number(args.limit);
+      if (args.rating) body.rating = args.rating;
+      if (args.lang) body.lang = args.lang;
+      if (args["auto-ingest"]) body.autoIngest = Number(args["auto-ingest"]);
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/sticker", body);
+      writeJson({ ok: true, data });
+    } 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 {
+  stickerCommand
+};
+//# sourceMappingURL=sticker-2JQUC7XO.js.map

package/dist/stock-W3SNJCBV.js

@@ -0,0 +1,179 @@
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  activeFilterFlags,
+  emptyResultHints
+} from "./chunk-Q6ULQMWG.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-7ANWFQEA.js";
+import "./chunk-KODTY7PB.js";
+import "./chunk-H5CGVMQW.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-ANYMWCST.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/stock.ts
+import { defineCommand } from "citty";
+var STOCK_ERROR_FIX = {
+  action: "use_different_resource",
+  explanation: "Switch provider instead of retrying stock search. Stock search is one of several image sources. Run `baker images find <query> --sources library,pinterest,google` (`--sources` is required \u2014 `find` alone searches the library only) or `baker studio generate` to make the asset. Never sleep-and-retry this command \u2014 the CLI already backs off on rate limits. If no image can be sourced, continue the rest of the task with a placeholder rather than aborting it."
+};
+registerSchema({
+  command: "images.stock",
+  description: "Stock search across the free libraries \u2014 Pexels photos plus Pixabay photos, illustrations and vectors. The previous provider's --license, --ai, --people and --order do not exist here: everything both libraries hold is free for commercial use with no attribution, neither indexes AI-generated content separately, neither has a people filter (name the person in the query instead), and both sort by relevance only.",
+  args: {
+    query: { type: "string", description: "Search query", required: true },
+    type: {
+      type: "string",
+      description: "Content type: photo (default, both libraries) | illustration | vector (Pixabay only)",
+      required: false,
+      enum: ["photo", "illustration", "vector"]
+    },
+    orientation: {
+      type: "string",
+      description: "landscape | portrait | square (square searches Pexels only \u2014 Pixabay has no square)",
+      required: false,
+      enum: ["landscape", "portrait", "square"]
+    },
+    size: {
+      type: "string",
+      description: "Minimum resolution: large (24MP) | medium (12MP) | small (4MP)",
+      required: false,
+      enum: ["large", "medium", "small"]
+    },
+    color: {
+      type: "string",
+      description: "Colour filter \u2014 a name (red, turquoise, black, \u2026) searches both libraries; a hex code such as '#0a0a0a' searches Pexels only",
+      required: false
+    },
+    locale: {
+      type: "string",
+      description: "Locale of the search terms, e.g. 'es-ES' or 'de-DE' \u2014 Pexels matches translated tags",
+      required: false
+    },
+    limit: { type: "number", description: "Max results (1-80, default 10)", required: false, default: 10 },
+    page: { type: "number", description: "Page number for pagination", required: false },
+    "auto-ingest": {
+      type: "number",
+      description: `Auto-ingest top N hits (0-${AUTO_INGEST_MAX.stock}, default 0) and return Baker-owned URLs on ingested hits`,
+      required: false,
+      default: 0
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint applied to every auto-ingested hit (overrides the library's own alt text or tags)",
+      required: false
+    }
+  }
+});
+function buildStockRequest(query, args) {
+  const body = { query };
+  if (args.type) body.contentType = args.type;
+  if (args.orientation) body.orientation = args.orientation;
+  if (args.size) body.size = args.size;
+  if (args.color) body.color = args.color;
+  if (args.locale) body.locale = args.locale;
+  if (args.limit) body.limit = Number(args.limit);
+  if (args.page) body.page = Number(args.page);
+  if (args["auto-ingest"]) body.autoIngest = Number(args["auto-ingest"]);
+  if (args.context) body.descriptionContext = args.context;
+  return body;
+}
+function partialLibraryHints(errors, hitCount) {
+  if (!errors || errors.length === 0) return [];
+  const sources = errors.map((e) => e.source);
+  const names = sources.join(", ");
+  if (hitCount === 0) {
+    const failed = sources.length === 1 ? `${sources[0]} did not answer` : `none of ${names} answered`;
+    return [
+      `Stock search did not run \u2014 ${failed}. This is an outage, not an empty result: do not re-run it with a different query or flags, and report that stock search is unavailable. Source the asset another way (\`baker images find <query> --sources library,pinterest,google\`) or \`baker studio generate\`.`
+    ];
+  }
+  return [
+    `These results are partial: ${names} did not answer, so they come from the remaining library alone. Treat a thin result as unproven rather than as "stock does not have this", and report the outage rather than re-running the search.`
+  ];
+}
+var stockCommand = defineCommand({
+  meta: {
+    name: "stock",
+    description: "Stock search across the free libraries \u2014 Pexels photographs plus Pixabay photographs, illustrations and vectors. No per-request cost. With --auto-ingest, ingested hits return Baker-owned URLs.\n\nExamples:\n  baker images stock 'minimalist office'\n  baker images stock 'hero photo of a kitchen' --orientation landscape --size large\n  baker images stock 'flat office workers' --type illustration\n  baker images stock 'leaf outline mark' --type vector\n  baker images stock 'smiling carpenter portrait' --orientation portrait"
+  },
+  args: {
+    query: { type: "positional", description: "Search query", required: false },
+    type: { type: "string", description: "photo|illustration|vector", required: false },
+    orientation: { type: "string", description: "landscape|portrait|square", required: false },
+    size: { type: "string", description: "Minimum resolution: large|medium|small", required: false },
+    color: { type: "string", description: "Colour name or hex code", required: false },
+    locale: { type: "string", description: "Locale of the search terms, e.g. es-ES", required: false },
+    limit: { type: "string", description: "Max results (1-80)", required: false },
+    page: { type: "string", description: "Page number", required: false },
+    "auto-ingest": {
+      type: "string",
+      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.stock}) and return Baker-owned URLs on ingested hits`,
+      required: false
+    },
+    context: { type: "string", description: "Description context hint applied to auto-ingested hits", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const query = args.query;
+      if (!query) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Query is required" } });
+        process.exit(1);
+      }
+      if (args["auto-ingest"] !== void 0) {
+        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.stock);
+        if (!parsed.ok) {
+          writeJson({
+            ok: false,
+            error: {
+              code: "VALIDATION_ERROR",
+              message: parsed.message,
+              fix: {
+                action: "retry_with_changes",
+                explanation: `Re-run with --auto-ingest in 0-${AUTO_INGEST_MAX.stock}.`
+              }
+            }
+          });
+          process.exit(1);
+        }
+      }
+      const data = await apiPost("/api/images/stock", buildStockRequest(query, args));
+      const outage = (data.errors?.length ?? 0) > 0 && data.hits.length === 0;
+      const hints = [
+        ...partialLibraryHints(data.errors, data.hits.length),
+        ...outage ? [] : emptyResultHints({
+          provider: "stock",
+          hitCount: data.hits.length,
+          activeFilters: activeFilterFlags(args, ["type", "orientation", "size", "color", "locale"])
+        })
+      ];
+      writeJson({ ok: true, data, ...hints.length ? { hints } : {} });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({
+          ok: false,
+          error: {
+            code: err.code,
+            message: err.message,
+            fix: STOCK_ERROR_FIX
+          }
+        });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  partialLibraryHints,
+  stockCommand
+};
+//# sourceMappingURL=stock-W3SNJCBV.js.map

package/dist/studio-2GAZ6QOH.js

@@ -0,0 +1,49 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/studio/index.ts
+import { defineCommand } from "citty";
+var studioCommand = defineCommand({
+  meta: {
+    name: "studio",
+    description: `Make new imagery and clips. Every batch is recorded and shows up in the dashboard Studio for the client to review, labelled with this conversation.
+
+Make something:
+  baker studio generate <prompt> [--reference ids,paths,urls] [--model \u2026] [--aspect-ratio \u2026] [--count N]
+                                        Render 1-8 takes of one still; each is ingested into the media library as it lands
+  baker studio animate <prompt> --image <id|path|url,\u2026>
+                                        Turn a still into a clip \u2014 the prompt describes MOVEMENT, not the look
+  baker studio skills                   Craft directions you can pass to --skill
+  baker studio improve <prompt>         Sharpen a rough brief (use it for the CLIENT's words, not your own)
+
+Know what you can ask for:
+  baker studio models [--kind video] [--model <id>]
+                                        Per model: shapes, resolutions, clip lengths, prompt cap, reference limit, every knob
+
+Review and pick:
+  baker studio get <generationId>       One batch: every take, its url, whether it is in the library, why one failed
+  baker studio list [--kind image|video] [--all]
+                                        Recent batches for this conversation (--all = the whole company)
+  baker studio keep <generationId> --slot N
+                                        Mark the keeper. Stars an image; INGESTS a clip into the video library
+
+Three rules worth remembering:
+  - --reference is the biggest quality lever there is. Ground a render in a real logo, product shot or mood image.
+  - A clip is not usable anywhere until it is kept. Unkept takes are never ingested.
+  - The models disagree about what they accept, and a setting the chosen model does not have is REFUSED rather than ignored. Run baker studio models to answer "can this one do that".
+Full guide: __tooling__/docs/tools/baker/studio.md`
+  },
+  subCommands: {
+    generate: () => import("./generate-3MC7WDL2.js").then((m) => m.generateCommand),
+    animate: () => import("./animate-3H3TL3N6.js").then((m) => m.animateCommand),
+    get: () => import("./get-BK4MBGQF.js").then((m) => m.getCommand),
+    list: () => import("./list-TG6LBHCV.js").then((m) => m.listCommand),
+    keep: () => import("./keep-5NFHEILH.js").then((m) => m.keepCommand),
+    models: () => import("./models-TYRVCPS2.js").then((m) => m.modelsCommand),
+    skills: () => import("./skills-WRKEF2Q4.js").then((m) => m.skillsCommand),
+    improve: () => import("./improve-U2RA5DPI.js").then((m) => m.improveCommand)
+  }
+});
+export {
+  studioCommand
+};
+//# sourceMappingURL=studio-2GAZ6QOH.js.map

package/dist/sync-4LHVBFMZ.js

@@ -0,0 +1,265 @@
+import {
+  parseXApiError
+} from "./chunk-M6UNISGO.js";
+import {
+  resolveXAccountId,
+  resolveXAccountTimezone
+} from "./chunk-LOTQBFUP.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson
+} from "./chunk-AAF7HL4I.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-7ANWFQEA.js";
+import "./chunk-KODTY7PB.js";
+import "./chunk-H5CGVMQW.js";
+import {
+  registerSchema
+} from "./chunk-ANYMWCST.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/stats/sync.ts
+import { defineCommand } from "citty";
+
+// src/commands/ads/x/presets.ts
+var X_STATS_PRESETS = [
+  {
+    name: "campaign-engagement-7d",
+    description: "Campaign-level engagements + impressions over the last 7 days, daily granularity",
+    entity: "CAMPAIGN",
+    metricGroups: ["ENGAGEMENT"],
+    granularity: "DAY",
+    defaultDays: 7,
+    placement: "ALL_ON_TWITTER"
+  },
+  {
+    name: "campaign-spend-30d",
+    description: "Campaign-level billed engagements + spend over the last 30 days, daily",
+    entity: "CAMPAIGN",
+    metricGroups: ["BILLING"],
+    granularity: "DAY",
+    defaultDays: 30,
+    placement: "ALL_ON_TWITTER"
+  },
+  {
+    name: "tweet-performance-7d",
+    description: "Promoted tweet engagement + media metrics over the last 7 days, daily",
+    entity: "PROMOTED_TWEET",
+    metricGroups: ["ENGAGEMENT", "MEDIA"],
+    granularity: "DAY",
+    defaultDays: 7,
+    placement: "ALL_ON_TWITTER"
+  },
+  {
+    name: "video-performance-30d",
+    description: "Promoted tweet video views/CTAs + engagement over the last 30 days, daily",
+    entity: "PROMOTED_TWEET",
+    metricGroups: ["VIDEO", "ENGAGEMENT"],
+    granularity: "DAY",
+    defaultDays: 30,
+    placement: "ALL_ON_TWITTER"
+  },
+  {
+    name: "line-item-conversions-30d",
+    description: "Line item web conversions + billing over the last 30 days, daily",
+    entity: "LINE_ITEM",
+    metricGroups: ["WEB_CONVERSION", "BILLING"],
+    granularity: "DAY",
+    defaultDays: 30,
+    placement: "ALL_ON_TWITTER"
+  }
+];
+function getPreset(name) {
+  return X_STATS_PRESETS.find((p) => p.name === name);
+}
+function isoSeconds(d) {
+  return `${d.toISOString().slice(0, 19)}Z`;
+}
+function isoHourFloor(daysAgo, now = /* @__PURE__ */ new Date()) {
+  const d = new Date(now);
+  d.setUTCMilliseconds(0);
+  d.setUTCSeconds(0);
+  d.setUTCMinutes(0);
+  d.setUTCDate(d.getUTCDate() - daysAgo);
+  return isoSeconds(d);
+}
+function wallClockAsUtc(instant, timeZone) {
+  const parts = new Intl.DateTimeFormat("en-US", {
+    timeZone,
+    hour12: false,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit"
+  }).formatToParts(instant);
+  const read = (type) => Number(parts.find((p) => p.type === type)?.value ?? "0");
+  const hour = read("hour") % 24;
+  return Date.UTC(read("year"), read("month") - 1, read("day"), hour, read("minute"), read("second"));
+}
+function accountMidnightIso(daysAgo, timeZone, now = /* @__PURE__ */ new Date()) {
+  const localNow = new Date(wallClockAsUtc(now, timeZone));
+  const target = Date.UTC(localNow.getUTCFullYear(), localNow.getUTCMonth(), localNow.getUTCDate() - daysAgo, 0, 0, 0);
+  let instant = target;
+  for (let i = 0; i < 2; i++) {
+    instant = target - (wallClockAsUtc(new Date(instant), timeZone) - instant);
+  }
+  return isoSeconds(new Date(instant));
+}
+
+// src/commands/ads/x/stats/sync.ts
+registerSchema({
+  command: "ads.x.statsSync",
+  description: "Synchronous analytics for an X Ads account (max 7 days). Use --preset for common queries or pass --entity, --entity-ids (CSV, max 20), --metric-groups (CSV), --start-time, --end-time, --granularity (DAY|HOUR|TOTAL), --placement (ALL_ON_TWITTER|PUBLISHER_NETWORK).",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    preset: { type: "string", description: "Use a stats preset (see --list-presets)", required: false },
+    "list-presets": { type: "boolean", description: "List available presets and exit", required: false },
+    days: { type: "string", description: "Override preset days (max 7)", required: false },
+    entity: { type: "string", description: "CAMPAIGN | LINE_ITEM | PROMOTED_TWEET | ...", required: false },
+    "entity-ids": { type: "string", description: "CSV of entity IDs (max 20)", required: false },
+    "start-time": { type: "string", description: "ISO 8601 hour-aligned start", required: false },
+    "end-time": { type: "string", description: "ISO 8601 hour-aligned end", required: false },
+    granularity: { type: "string", description: "TOTAL | DAY | HOUR", required: false },
+    "metric-groups": {
+      type: "string",
+      description: "CSV: ENGAGEMENT,BILLING,VIDEO,MEDIA,WEB_CONVERSION,MOBILE_CONVERSION,LIFE_TIME_VALUE_MOBILE_CONVERSION",
+      required: false
+    },
+    placement: { type: "string", description: "ALL_ON_TWITTER | PUBLISHER_NETWORK", required: false },
+    country: { type: "string", description: "Country filter (mobile_conversion only)", required: false },
+    platform: { type: "string", description: "Platform filter (mobile_conversion only)", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+function parseCsv(v) {
+  if (typeof v !== "string" || v.length === 0) return void 0;
+  const parts = v.split(",").map((s) => s.trim()).filter(Boolean);
+  return parts.length > 0 ? parts : void 0;
+}
+var SYNC_MAX_DAYS = 7;
+function resolveQueryFromArgs(args, timeZone) {
+  let entity = args.entity;
+  let metricGroups = parseCsv(args["metric-groups"]);
+  let granularity = args.granularity ?? "DAY";
+  let placement = args.placement ?? "ALL_ON_TWITTER";
+  let startTime = args["start-time"];
+  let endTime = args["end-time"];
+  const hints = [];
+  if (args.preset) {
+    const preset = getPreset(args.preset);
+    if (!preset) {
+      return { error: `Unknown preset '${args.preset}'. Run with --list-presets to see options.` };
+    }
+    entity ??= preset.entity;
+    metricGroups ??= preset.metricGroups;
+    granularity = args.granularity ?? preset.granularity;
+    placement = args.placement ?? preset.placement;
+    const requested = args.days ? Number(args.days) : preset.defaultDays;
+    const days = Math.min(SYNC_MAX_DAYS, Math.max(1, requested));
+    if (requested > SYNC_MAX_DAYS) {
+      hints.push(
+        `Sync stats cover at most ${SYNC_MAX_DAYS} days, so '${preset.name}' was shortened to the last ${days}. For the full window run: baker ads x stats job --entity ${entity} --entity-ids <ids> --metric-groups ${metricGroups?.join(",")} --start-time <start> --end-time <end>`
+      );
+    }
+    const floor = granularity === "DAY" ? (d) => accountMidnightIso(d, timeZone) : isoHourFloor;
+    startTime ??= floor(days);
+    endTime ??= floor(0);
+  }
+  const entityIds = parseCsv(args["entity-ids"]);
+  if (!entity || !metricGroups || metricGroups.length === 0 || !startTime || !endTime || !entityIds) {
+    return {
+      error: "stats sync requires entity, entity-ids, metric-groups, start-time, end-time. Use --preset for defaults."
+    };
+  }
+  return { entity, metricGroups, granularity, placement, startTime, endTime, entityIds, hints };
+}
+async function runSync(args, accountId, q) {
+  const useCache = !args["no-cache"];
+  const body = {
+    accountId,
+    entity: q.entity,
+    entityIds: q.entityIds,
+    startTime: q.startTime,
+    endTime: q.endTime,
+    granularity: q.granularity,
+    metricGroups: q.metricGroups,
+    placement: q.placement,
+    country: args.country ?? void 0,
+    platform: args.platform ?? void 0,
+    skipCache: !useCache || void 0
+  };
+  const cacheKey = `stats-sync:${JSON.stringify(body)}`;
+  if (useCache) {
+    const cached = cacheGet("x-stats", cacheKey);
+    if (cached) {
+      writeAdsJson({ ok: true, data: cached.data, cached: true, ...q.hints.length ? { hints: q.hints } : {} });
+      return;
+    }
+  }
+  try {
+    const data = await apiPost("/api/ads/x/stats", body);
+    if (useCache) {
+      cacheSet("x-stats", cacheKey, data, 60 * 60 * 1e3);
+    }
+    writeAdsJson({ ok: true, data, ...q.hints.length ? { hints: q.hints } : {} });
+  } 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 statsSyncCommand = defineCommand({
+  meta: {
+    name: "sync",
+    description: `Synchronous X Ads analytics (max 7-day window).
+
+Examples:
+  baker ads x stats sync --preset campaign-engagement-7d --account-id 18ce53xyz --entity-ids abc,def
+  baker ads x stats sync --account-id 18ce53xyz --entity LINE_ITEM --entity-ids abc \\
+    --start-time 2026-05-01T00:00:00Z --end-time 2026-05-07T00:00:00Z \\
+    --metric-groups ENGAGEMENT,BILLING --granularity DAY
+  baker ads x stats sync --list-presets`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    preset: { type: "string", description: "Stats preset name", required: false },
+    "list-presets": { type: "boolean", description: "List presets and exit", required: false },
+    days: { type: "string", description: "Override days (1\u20137)", required: false },
+    entity: { type: "string", description: "Entity type", required: false },
+    "entity-ids": { type: "string", description: "CSV of entity IDs", required: false },
+    "start-time": { type: "string", description: "ISO 8601 start", required: false },
+    "end-time": { type: "string", description: "ISO 8601 end", required: false },
+    granularity: { type: "string", description: "Granularity", required: false },
+    "metric-groups": { type: "string", description: "Metric groups CSV", required: false },
+    placement: { type: "string", description: "Placement", required: false },
+    country: { type: "string", description: "Country filter", required: false },
+    platform: { type: "string", description: "Platform filter", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  },
+  run: async ({ args }) => {
+    if (args["list-presets"]) {
+      writeAdsJson({ ok: true, data: X_STATS_PRESETS });
+      return;
+    }
+    const accountId = await resolveXAccountId(args);
+    const timeZone = await resolveXAccountTimezone(accountId, args);
+    const resolved = resolveQueryFromArgs(args, timeZone);
+    if ("error" in resolved) {
+      writeAdsJson({ ok: false, error: { code: "INVALID_PARAMETER", message: resolved.error } });
+      process.exit(1);
+    }
+    await runSync(args, accountId, resolved);
+  }
+});
+export {
+  statsSyncCommand
+};
+//# sourceMappingURL=sync-4LHVBFMZ.js.map

package/dist/sync-NAJQQ6NQ.js

@@ -0,0 +1,54 @@
+import {
+  reportError
+} from "./chunk-NRRNY3TZ.js";
+import {
+  mediaSourcesSyncRequestSchema
+} from "./chunk-GXDLWBOY.js";
+import {
+  apiPost
+} from "./chunk-7ANWFQEA.js";
+import "./chunk-KODTY7PB.js";
+import "./chunk-H5CGVMQW.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-ANYMWCST.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/media-sources/sync.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "media-sources.sync",
+  description: "Import a connected source's new posts now. Runs in the background; only posts not yet in the library are fetched.",
+  args: {
+    key: { type: "string", description: "Source key from `media-sources list`, e.g. tiktok:acme", required: true }
+  }
+});
+var syncCommand = defineCommand({
+  meta: {
+    name: "sync",
+    description: "Import a source's new posts now.\n\nExample: baker media-sources sync tiktok:acme"
+  },
+  args: { key: { type: "positional", description: "Source key, e.g. tiktok:acme", required: true } },
+  run: async ({ args }) => {
+    const parsed = mediaSourcesSyncRequestSchema.safeParse({ key: String(args.key ?? "") });
+    if (!parsed.success) {
+      writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: parsed.error.issues[0]?.message ?? "" } });
+      process.exit(1);
+    }
+    try {
+      const data = await apiPost("/api/media-sources/sync", parsed.data);
+      writeJson({
+        ok: true,
+        data,
+        hints: data.started ? void 0 : ["An import was already running for this source; nothing new was started."]
+      });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  syncCommand
+};
+//# sourceMappingURL=sync-NAJQQ6NQ.js.map