@koda-sl/baker-cli 0.567.0 → 0.569.0

package/dist/creatives-5EIDMQ66.js

@@ -0,0 +1,229 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg,
+  resolveStatusFilter,
+  statusesArgDescription
+} from "./chunk-W743FIEY.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-MK4HCMEA.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-GO6ISZUZ.js";
+import {
+  shapeListRows
+} from "./chunk-65Y3RCWP.js";
+import "./chunk-2Q7K4F4H.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/creatives.ts
+import { defineCommand } from "citty";
+function asRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function asString(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function creativeDestination(content) {
+  if (!content) return { format: "unknown" };
+  const reference = asString(content.reference);
+  if (reference) return { format: "post", postUrn: reference };
+  const textAd = asRecord(content.textAd);
+  if (textAd) return { format: "text", landingUrl: asString(textAd.landingPage) };
+  const spotlight = asRecord(content.spotlight);
+  if (spotlight) return { format: "spotlight", landingUrl: asString(spotlight.landingPage) };
+  if (asRecord(content.follower)) return { format: "follower" };
+  if (asRecord(content.jobs)) return { format: "jobs" };
+  return { format: "unknown" };
+}
+var COMPACT_COLUMNS = [
+  "id",
+  "urn",
+  "campaign",
+  "intendedStatus",
+  "isServing",
+  "reviewStatus",
+  "format",
+  "landingUrl",
+  "postUrn",
+  "leadForm",
+  "leadFormButton"
+];
+function leadFormUrn(destination) {
+  const id = destination?.match(/(\d+)$/)?.[1];
+  return id ? `urn:li:leadGenForm:${id}` : void 0;
+}
+function compactRow(row) {
+  const destination = creativeDestination(row.content);
+  const leadForm = leadFormUrn(row.leadgenCallToAction?.destination);
+  return {
+    id: row.id,
+    urn: row.urn,
+    campaign: row.campaign,
+    intendedStatus: row.intendedStatus,
+    isServing: row.isServing,
+    reviewStatus: row.reviewStatus,
+    format: destination.format,
+    ...destination.landingUrl ? { landingUrl: destination.landingUrl } : {},
+    ...destination.postUrn ? { postUrn: destination.postUrn } : {},
+    ...leadForm ? { leadForm, leadFormButton: row.leadgenCallToAction?.label } : {}
+  };
+}
+function unmappedShapeWarnings(rows, rawContentReturned) {
+  const unmapped = rows.filter((row) => row.content && creativeDestination(row.content).format === "unknown");
+  if (unmapped.length === 0) return [];
+  const remedy = rawContentReturned ? "Their raw content is in this response \u2014 read it directly; this command cannot resolve a destination for them." : "Re-read those with --full before drawing any conclusion about where they point.";
+  return [
+    {
+      code: "UNMAPPED_CREATIVE_CONTENT",
+      message: `${unmapped.length} of ${rows.length} creatives have a content shape this command can't read, so their destination is missing (ids: ${unmapped.slice(0, 5).map((row) => row.id).join(", ")}). ${remedy}`
+    }
+  ];
+}
+var listArgs = {
+  "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+  "account-urn": { type: "string", description: "Alias for --account-id" },
+  "campaign-id": { type: "string", description: "Filter by campaign ID" },
+  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
+  statuses: { type: "string", description: statusesArgDescription("creatives") },
+  fields: {
+    type: "string",
+    description: "CSV of dotted paths to return instead of the compact row, e.g. id,content.textAd.landingPage"
+  },
+  full: { type: "boolean", description: "Return the complete raw records, including the opaque 'content' block" },
+  limit: { type: "string", description: "Max rows (default: 500)" },
+  "no-cache": NO_CACHE_ARG,
+  output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+};
+var creativesListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List LinkedIn creatives (ads). Runs by default when no subcommand is given."
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      const statuses = resolveStatusFilter(args, "creatives");
+      if (statuses) params.statuses = statuses.join(",");
+      if (args["campaign-id"]) params["campaign-id"] = String(args["campaign-id"]);
+      if (args.limit) params.limit = String(args.limit);
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/creatives", params);
+      const shaped = shapeListRows(data, args, {
+        row: compactRow,
+        columns: COMPACT_COLUMNS
+      });
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(shaped.rows, fmt, shaped.fields, shaped.hints);
+        return;
+      }
+      const warnings = unmappedShapeWarnings(data, args.full === true);
+      writeJsonEnvelope({
+        ok: true,
+        data: shaped.rows,
+        ...warnings.length > 0 ? { warnings } : {},
+        ...shaped.hints ? { hints: shaped.hints } : {}
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var creativesGetCommand = defineCommand({
+  meta: {
+    name: "get",
+    description: `Read one ad as LinkedIn holds it: headline, intro text, landing URL, the lead gen form it opens, its review verdict (with rejection reasons) and why it is not serving (notServingBecause \u2014 e.g. FORM_HOLD, UNDER_REVIEW, CAMPAIGN_STOPPED).
+The listing can only name a post-based ad's post; this is where its headline and link come back.
+Example: baker ads linkedin creatives get 1584704523`
+  },
+  args: {
+    id: { type: "positional", description: "Creative id or urn:li:sponsoredCreative:N", required: true },
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const data = await apiGet("/api/ads/linkedin/creative", {
+        "account-id": accountId,
+        "creative-id": String(args.id)
+      });
+      writeJsonEnvelope({
+        ok: true,
+        data,
+        hints: [
+          `These are the stored fields, not what people see. To look at the ad as the feed shows it: baker ads linkedin preview ${String(args.id)} --account-id ${accountId}`
+        ]
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var creativesCommand = defineCommand({
+  meta: {
+    name: "creatives",
+    description: `List LinkedIn creatives (ads), or stage writes (create/update/pause/resume/duplicate).
+
+Defaults to ACTIVE intended-status. Pass --all-statuses or --statuses ACTIVE,PAUSED to widen.
+
+Rows are compact by default: id, urn, campaign, status, review status, format, and
+the resolved destination (landingUrl, or postUrn for post-based ads), and for a
+lead gen ad the form it opens (leadForm, leadFormButton). Use --fields
+for specific dotted paths, or --full for the complete raw records.
+
+Post-based ads (image, video, carousel, document, article, event, TLA) report a
+postUrn, not a landingUrl \u2014 their destination lives in the post itself.
+Use 'reviewStatus' to spot rejected/pending creatives during an audit.
+
+Write subcommands stage ops on this chat's draft \u2014 media comes from the Baker
+library and is uploaded to LinkedIn only at publish.
+
+Examples:
+  baker ads linkedin creatives --account-id 503001492
+  baker ads linkedin creatives --account-id 503001492 --fields id,intendedStatus,content.textAd.landingPage
+  baker ads linkedin creatives create --campaign 1234 --format image --image-id <bakerImageId> --intro "\u2026" --headline "Book a demo" --landing-url https://example.com --cta REQUEST_DEMO
+  baker ads linkedin creatives get 1584704523      # one ad: headline, landing URL, form, review, why not serving
+  baker ads linkedin creatives pause urn:li:sponsoredCreative:789`
+  },
+  subCommands: {
+    list: creativesListCommand,
+    get: creativesGetCommand,
+    create: () => import("./write-commands-UEQR7ZXO.js").then((m) => m.creativesCreateCommand),
+    update: () => import("./write-commands-UEQR7ZXO.js").then((m) => m.creativesUpdateCommand),
+    pause: () => import("./write-commands-UEQR7ZXO.js").then((m) => m.creativesPauseCommand),
+    resume: () => import("./write-commands-UEQR7ZXO.js").then((m) => m.creativesResumeCommand),
+    duplicate: () => import("./write-commands-UEQR7ZXO.js").then((m) => m.creativesDuplicateCommand),
+    delete: () => import("./write-commands-UEQR7ZXO.js").then((m) => m.creativesDeleteCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it *after* running
+  // the matched subcommand, so every write would also trigger a full live list.
+  // `args` stays here so citty's subcommand scan knows which flags take a value.
+  args: listArgs,
+  default: "list"
+});
+export {
+  compactRow,
+  creativeDestination,
+  creativesCommand,
+  unmappedShapeWarnings
+};
+//# sourceMappingURL=creatives-5EIDMQ66.js.map

package/dist/creatives-N7V2BSOW.js

@@ -0,0 +1,118 @@
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-RF3TP643.js";
+import {
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-7TVVYP7K.js";
+import "./chunk-QALAJNBG.js";
+import "./chunk-MK4HCMEA.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-GO6ISZUZ.js";
+import "./chunk-65Y3RCWP.js";
+import {
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/creatives.ts
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID (required if no --creative-id)" },
+  "creative-id": {
+    type: "string",
+    description: "One creative ID, or several comma-separated, read in one call: --creative-id 2394\u2026,2395\u2026"
+  },
+  "name-contains": {
+    type: "string",
+    description: "Only creatives whose name contains this text (any case), matched by Baker while it reads the account; --limit counts the matches. Start here to find a creative by name: --name-contains octubre"
+  },
+  limit: { type: "string", description: "Max rows (default 500)" },
+  "no-cache": NO_CACHE_ARG,
+  ...META_LIST_SHAPE_ARGS
+};
+registerMetaListSchema(
+  "creatives",
+  "List ad creatives, or read some by id, as a table by default: id, name, status, object_type, dynamic (the asset feed's optimization_type), body, title, description, link, cta, url_tags, image_hash, video_id, page_id, instagram_user_id, effective_object_story_id. Copy and assets are read from wherever the creative keeps them (top level, object_story_spec, its carousel cards or asset_feed_spec); a dynamic creative's variants and a carousel's cards come back as lists. Per-placement rules and enhancement toggles are --fields (asset_feed_spec.asset_customization_rules, degrees_of_freedom_spec) or --full. Start here: baker ads meta creatives --creative-id 2394\u2026,2395\u2026 --output json.",
+  listArgs
+);
+async function readCreatives(ids, skipCache) {
+  const rows = [];
+  for (const id of ids) {
+    rows.push(
+      await apiGet("/api/ads/meta/creatives", {
+        "creative-id": id,
+        ...skipCache ? { "skip-cache": "true" } : {}
+      })
+    );
+  }
+  return rows;
+}
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List ad creatives, or read some by ID. Runs by default when no subcommand is given. Example: baker ads meta creatives --creative-id 2394\u2026,2395\u2026"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    try {
+      const ids = (args["creative-id"] ?? "").split(",").map((id) => id.trim()).filter(Boolean);
+      let data;
+      if (ids.length > 0) {
+        data = await readCreatives(ids, Boolean(args["no-cache"]));
+      } else {
+        const params = { "account-id": await resolveAccountIdArg(args) };
+        if (args["name-contains"]) params["name-contains"] = args["name-contains"];
+        if (args.limit) params.limit = args.limit;
+        if (args["no-cache"]) params["skip-cache"] = "true";
+        data = await apiGet("/api/ads/meta/creatives", params);
+      }
+      writeMetaListRows("creatives", shapeMetaListRows("creatives", data, args), csvOrJson(args));
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var creativesCommand = defineCommand({
+  meta: {
+    name: "creatives",
+    description: `List ad creatives, fetch one by ID, or stage writes (create/update). Write subcommands stage ops on this chat's draft.
+
+Important: Meta creatives are effectively immutable once attached to an ad. Editing copy/image/CTA = create
+a new creative + repoint the ad (baker ads meta ads update <adId> --creative <ref>).
+
+Reads print a table by default: id, name, status, object_type, dynamic, body, title, description, link, cta,
+url_tags, image_hash, video_id, page_id, instagram_user_id, effective_object_story_id \u2014 read from wherever the
+creative keeps them; a dynamic creative's variants and a carousel's cards come back as lists. --fields (dotted paths) or --full for the rest.
+
+Examples:
+  baker ads meta creatives --account-id act_123 --name-contains octubre   \u2014 find creatives by name
+  baker ads meta creatives --creative-id 23842...,23843... --output json   # read several at once
+  baker ads meta creatives --creative-id 23842... --fields id,asset_feed_spec.asset_customization_rules --output json
+  baker ads meta creatives create --page 555 --message "Save now" --link https://x.com --image-hash abc\u2026 --cta SHOP_NOW`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-5OFOD7TE.js").then((m) => m.adCreativesCreateCommand),
+    update: () => import("./write-commands-5OFOD7TE.js").then((m) => m.adCreativesUpdateCommand),
+    delete: () => import("./asset-writes-DECROLE3.js").then((m) => m.creativesDeleteCommand)
+  },
+  // `args` stays even though the parent has no `run`: citty scans rawArgs for the
+  // subcommand name using THIS command's arg defs, so without them `--account-id act_1`
+  // would read `act_1` as a subcommand. `default` (not `run`) dispatches the bare
+  // invocation — citty falls through to `run` after a subcommand, double-executing it.
+  args: listArgs,
+  default: "list"
+});
+export {
+  creativesCommand
+};
+//# sourceMappingURL=creatives-N7V2BSOW.js.map

package/dist/creatives-QWNQDPNE.js

@@ -0,0 +1,58 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/index.ts
+import { defineCommand } from "citty";
+var creativesCommand = defineCommand({
+  meta: {
+    name: "creatives",
+    description: `Make ads from what customers said, read and record what the user thinks of each version, and save the approved ones.
+
+Making ads, in order:
+  baker creatives brief                 # one read: who sees the ads, what works, taste, customer quotes, ideas on file
+  baker creatives ideas                 # check and rank the ideas in src/creatives/_ideas/
+  baker creatives make <idea>           # one idea \u2192 one creative (reference picked and checked for you)
+  baker creatives translate --slug <ad> --to es-MX,pt-BR   # the same ad in other languages, one design
+  baker creatives learn                 # what each idea's ads did, written back onto the idea
+
+Before making or changing a creative, read the company's taste:
+  baker creatives feedback [--slug <slug>]
+
+The company's standing rules for every ad (BRAND.md's and the ones a person taught):
+  baker creatives rules list
+  baker creatives rules add --candidate <rc-\u2026>   # only after the person agreed it is a rule for every ad
+  baker creatives check                 # after a rule changes: which ads already made break it
+
+When the user reacts to a version in the chat (likes it, rejects it, asks for changes), record it:
+  baker creatives feedback record --slug <slug> --run <r_\u2026> --verdict approved|rejected [--reasons a,b] [--note "<their words>"]
+
+When they pick a version (or options inside it) to keep:
+  baker creatives select --slug <slug> --run <r_\u2026> [--options <label,\u2026>]
+
+Creative handoff:
+  baker creatives publish --title "Spring Offer Static Ad" --slug <slug> --run-id <r_\u2026> [--output 4:5]
+  baker creatives publish ./canvas/run/final.mp4 --title "Spring Offer Reel" --slug spring-offer --run-id <r_\u2026>
+
+Publishing an image uploads it to the Company image library, applies the official creative tag, and returns an image reference for chat previews. Publishing a video uploads it to the video library, waits until it plays, saves it on the creative (--slug required) and returns a video reference.
+
+How published creatives are doing in live Meta ads (results, fatigue, angle; hook and hold rate for videos):
+  baker creatives performance [--slug <slug>] [--days 30] [--full]
+Full guide: __tooling__/docs/tools/baker/creatives.md`
+  },
+  subCommands: {
+    brief: () => import("./brief-A5XFT6VH.js").then((m) => m.briefCommand),
+    ideas: () => import("./ideas-TT24LJR5.js").then((m) => m.ideasCommand),
+    make: () => import("./make-4XUB6RSF.js").then((m) => m.makeCommand),
+    translate: () => import("./translate-IPTYPZF6.js").then((m) => m.translateCommand),
+    learn: () => import("./learn-XNN3DGDF.js").then((m) => m.learnCommand),
+    feedback: () => import("./feedback-2YJ24NV7.js").then((m) => m.feedbackCommand),
+    rules: () => import("./rules-4A25K2P7.js").then((m) => m.rulesCommand),
+    check: () => import("./check-FQYDJ5RS.js").then((m) => m.checkCommand),
+    select: () => import("./select-MZ2U7U5U.js").then((m) => m.selectCommand),
+    publish: () => import("./publish-MDVPC77V.js").then((m) => m.publishCommand),
+    performance: () => import("./performance-PU4NHFUE.js").then((m) => m.performanceCommand)
+  }
+});
+export {
+  creativesCommand
+};
+//# sourceMappingURL=creatives-QWNQDPNE.js.map