@koda-sl/baker-cli 0.493.0 → 0.495.0-dev.6b9c22aff

package/dist/create-UUEWQUPT.js

@@ -0,0 +1,132 @@
+import {
+  AUTO_PUBLISH_ARG,
+  NARROWING_ARGS,
+  REACTION_ARGS,
+  SLACK_ARG,
+  TRIGGER_ARG_DESCRIPTION,
+  TRIGGER_KIND_LIST,
+  buildTriggerBody,
+  companiesArg,
+  companiesBody,
+  failApi,
+  failValidation,
+  reactionBody,
+  refuseAutoPublish,
+  slackBody
+} from "./chunk-D3SHD4KA.js";
+import "./chunk-3B5LPK6D.js";
+import "./chunk-JGM4WGC2.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-NAA4CKZZ.js";
+import {
+  apiPost
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import {
+  requireChatId
+} from "./chunk-57KKVDDR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/scheduled-agents/create.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "scheduled-agents.create",
+  description: "Stage a scheduled agent: a trigger and a prompt. Applies when the chat is published and returns a temp_agent_* ID. Start here: `baker scheduled-agents triggers` lists everything that can start one.",
+  args: {
+    name: { type: "string", description: "What a person will call it in the list", required: true },
+    description: { type: "string", description: "One line under the name. Not read by the run.", required: true },
+    prompt: {
+      type: "string",
+      description: "What the run does. This IS the job \u2014 nothing else is resolved when it fires. Five to eight schematic lines: `Goal:` the outcome; `Tools:` each tool tagged (@[Google Ads](integration:google-ads), @[Gmail](mcp:gmail), /skill); numbered steps with the exact `baker` commands and flags; `Report:` what to hand back and how far to go. Worked examples: scheduled-agents.md \u2192 Typical scheduled agents.",
+      required: true
+    },
+    cron: { type: "string", description: "5-field cron expression; implies --trigger time.cron", required: false },
+    "run-at": {
+      type: "string",
+      description: "Run once at this ISO UTC timestamp ending in Z; implies --trigger time.once. Must still be in the future \u2014 a time that has passed is refused.",
+      required: false
+    },
+    trigger: { type: "string", description: TRIGGER_ARG_DESCRIPTION, required: false, enum: TRIGGER_KIND_LIST },
+    ...NARROWING_ARGS,
+    occurrences: {
+      type: "string",
+      description: "Run only on these firings of the trigger, 1-based and comma-separated. `1` is only the first time it ever happens. Omit it to run every time.",
+      required: false
+    },
+    ...REACTION_ARGS,
+    ...SLACK_ARG,
+    ...companiesArg(),
+    timezone: { type: "string", description: "IANA timezone override; defaults to Company Timezone", required: false },
+    disabled: { type: "boolean", description: "Create it switched off", required: false, default: false }
+  }
+});
+var createCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: 'Stage a scheduled agent. Examples: baker scheduled-agents create --name "Weekly report" --description "..." --prompt "..." --cron "0 9 * * MON" | baker scheduled-agents create --name "Chase a new lead" --description "..." --prompt "Research {{payload.answers.company}} and draft a reply" --trigger form.submitted --form quote | baker scheduled-agents create --name "Big deals" --description "..." --prompt "..." --trigger webhook.received --when "deal.stage = won AND deal.amount > 10000" --times 3'
+  },
+  args: {
+    name: { type: "string", description: "What a person will call it", required: false },
+    description: { type: "string", description: "One line under the name", required: false },
+    prompt: {
+      type: "string",
+      description: "What the run does: a few lines naming the exact commands",
+      required: false
+    },
+    cron: { type: "string", description: "5-field cron expression", required: false },
+    "run-at": { type: "string", description: "ISO UTC timestamp ending in Z, still in the future", required: false },
+    trigger: { type: "string", description: `One of: ${TRIGGER_KIND_LIST.join(", ")}`, required: false },
+    ...NARROWING_ARGS,
+    occurrences: { type: "string", description: "Only these firings, e.g. 1 or 1,3", required: false },
+    ...REACTION_ARGS,
+    ...SLACK_ARG,
+    ...companiesArg(),
+    timezone: { type: "string", description: "IANA timezone override", required: false },
+    disabled: { type: "boolean", description: "Create it switched off", required: false, default: false },
+    ...AUTO_PUBLISH_ARG
+  },
+  run: async ({ args }) => {
+    try {
+      refuseAutoPublish(args);
+      const name = args.name;
+      const description = args.description;
+      const prompt = args.prompt;
+      if (!name || name.trim().length === 0) {
+        failValidation("--name is required.");
+      }
+      if (!description || description.trim().length === 0) {
+        failValidation("--description is required.");
+      }
+      if (!prompt || prompt.trim().length === 0) {
+        failValidation("--prompt is required: it is the whole of what a run does.");
+      }
+      const trigger = buildTriggerBody(args, { required: true });
+      const reaction = reactionBody(args);
+      const body = {
+        chatId: requireChatId(),
+        name,
+        description,
+        enabled: !args.disabled,
+        ...trigger,
+        prompt,
+        ...reaction,
+        ...slackBody(args),
+        ...companiesBody(args)
+      };
+      const response = await apiPost("/api/scheduled-agents/create", body);
+      writeJson(response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  createCommand
+};
+//# sourceMappingURL=create-UUEWQUPT.js.map

package/dist/creatives-EEDDL3VG.js

@@ -0,0 +1,220 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg,
+  resolveStatusFilter,
+  statusesArgDescription
+} from "./chunk-PGD7USOH.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-2VIZ4UUZ.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-U6RONIJC.js";
+import {
+  shapeListRows
+} from "./chunk-65Y3RCWP.js";
+import "./chunk-JGM4WGC2.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-NAA4CKZZ.js";
+import {
+  apiGet
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import "./chunk-QANGHND7.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 });
+    } 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-PPR7G4UN.js").then((m) => m.creativesCreateCommand),
+    update: () => import("./write-commands-PPR7G4UN.js").then((m) => m.creativesUpdateCommand),
+    pause: () => import("./write-commands-PPR7G4UN.js").then((m) => m.creativesPauseCommand),
+    resume: () => import("./write-commands-PPR7G4UN.js").then((m) => m.creativesResumeCommand),
+    duplicate: () => import("./write-commands-PPR7G4UN.js").then((m) => m.creativesDuplicateCommand),
+    delete: () => import("./write-commands-PPR7G4UN.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-EEDDL3VG.js.map

package/dist/creatives-EEDDL3VG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/creatives.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { shapeListRows } from \"../list-rows.ts\";\nimport { writeAdsOutput, writeJsonEnvelope } from \"../output.ts\";\nimport type { AdsWarning } from \"../types.ts\";\nimport {\n  csvOrJson,\n  handleLinkedinError,\n  resolveAccountIdArg,\n  resolveStatusFilter,\n  statusesArgDescription,\n} from \"./shared.ts\";\n\ninterface LinkedinCreativeRow {\n  id: string;\n  urn: string;\n  account: string;\n  campaign?: string;\n  intendedStatus?: string;\n  isServing?: boolean;\n  reviewStatus?: string;\n  type?: string;\n  content?: Record<string, unknown>;\n  leadgenCallToAction?: { destination?: string; label?: string };\n  createdAt?: number;\n}\n\n/**\n * The shape of a creative's `content` depends on its format, and LinkedIn wraps\n * each one differently. Callers overwhelmingly want one thing from it — where\n * the ad sends people — so resolve that here instead of making every reader\n * re-learn the union.\n *\n * Post-based ads (image, video, carousel, document, article, event, TLA) only\n * carry a post reference: their destination lives inside the post and is not\n * readable — or writable — through the ads API.\n */\nexport interface CreativeDestination {\n  format: string;\n  landingUrl?: string;\n  postUrn?: string;\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\nfunction asString(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\nexport function creativeDestination(content: Record<string, unknown> | undefined): CreativeDestination {\n  if (!content) return { format: \"unknown\" };\n\n  const reference = asString(content.reference);\n  if (reference) return { format: \"post\", postUrn: reference };\n\n  const textAd = asRecord(content.textAd);\n  if (textAd) return { format: \"text\", landingUrl: asString(textAd.landingPage) };\n\n  const spotlight = asRecord(content.spotlight);\n  if (spotlight) return { format: \"spotlight\", landingUrl: asString(spotlight.landingPage) };\n\n  if (asRecord(content.follower)) return { format: \"follower\" };\n  if (asRecord(content.jobs)) return { format: \"jobs\" };\n\n  return { format: \"unknown\" };\n}\n\n/**\n * Every column a compact row can carry, in order. `compactRow` omits the destination\n * keys it has no value for, so the tabular writers cannot infer the header from a row:\n * a first row that is post-based would drop `landingUrl` from every later row.\n */\nconst COMPACT_COLUMNS = [\n  \"id\",\n  \"urn\",\n  \"campaign\",\n  \"intendedStatus\",\n  \"isServing\",\n  \"reviewStatus\",\n  \"format\",\n  \"landingUrl\",\n  \"postUrn\",\n  \"leadForm\",\n  \"leadFormButton\",\n] as const;\n\n/** LinkedIn hands the creative's form back as `urn:li:adForm:N`; every other command names it `urn:li:leadGenForm:N`. */\nfunction leadFormUrn(destination: string | undefined): string | undefined {\n  const id = destination?.match(/(\\d+)$/)?.[1];\n  return id ? `urn:li:leadGenForm:${id}` : undefined;\n}\n\n/** The fields worth spending context on by default — everything else needs --fields or --full. */\nexport function compactRow(row: LinkedinCreativeRow): Record<string, unknown> {\n  const destination = creativeDestination(row.content);\n  const leadForm = leadFormUrn(row.leadgenCallToAction?.destination);\n  return {\n    id: row.id,\n    urn: row.urn,\n    campaign: row.campaign,\n    intendedStatus: row.intendedStatus,\n    isServing: row.isServing,\n    reviewStatus: row.reviewStatus,\n    format: destination.format,\n    ...(destination.landingUrl ? { landingUrl: destination.landingUrl } : {}),\n    ...(destination.postUrn ? { postUrn: destination.postUrn } : {}),\n    ...(leadForm ? { leadForm, leadFormButton: row.leadgenCallToAction?.label } : {}),\n  };\n}\n\n/**\n * `content` crosses the wire as an unvalidated bag, so if LinkedIn renames a\n * wrapper key nothing else in the stack would notice — the destination would\n * just quietly stop resolving. Counting the shapes this mapper couldn't read is\n * the cheapest signal that the contract moved.\n */\nexport function unmappedShapeWarnings(rows: LinkedinCreativeRow[], rawContentReturned: boolean): AdsWarning[] {\n  const unmapped = rows.filter((row) => row.content && creativeDestination(row.content).format === \"unknown\");\n  if (unmapped.length === 0) return [];\n  // Under --full the caller already holds the raw `content`, so \"re-read with\n  // --full\" is a dead end — point them at what they are already holding.\n  const remedy = rawContentReturned\n    ? \"Their raw content is in this response — read it directly; this command cannot resolve a destination for them.\"\n    : \"Re-read those with --full before drawing any conclusion about where they point.\";\n  return [\n    {\n      code: \"UNMAPPED_CREATIVE_CONTENT\",\n      message: `${unmapped.length} of ${rows.length} creatives have a content shape this command can't read, so their destination is missing (ids: ${unmapped\n        .slice(0, 5)\n        .map((row) => row.id)\n        .join(\", \")}). ${remedy}`,\n    },\n  ];\n}\n\nconst listArgs = {\n  \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n  \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n  \"campaign-id\": { type: \"string\", description: \"Filter by campaign ID\" },\n  \"all-statuses\": { type: \"boolean\", description: \"Drop the default ACTIVE filter\" },\n  statuses: { type: \"string\", description: statusesArgDescription(\"creatives\") },\n  fields: {\n    type: \"string\",\n    description: \"CSV of dotted paths to return instead of the compact row, e.g. id,content.textAd.landingPage\",\n  },\n  full: { type: \"boolean\", description: \"Return the complete raw records, including the opaque 'content' block\" },\n  limit: { type: \"string\", description: \"Max rows (default: 500)\" },\n  \"no-cache\": NO_CACHE_ARG,\n  output: { type: \"string\", description: \"json|csv|jsonl|md\", default: \"json\" },\n} as const;\n\nconst creativesListCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description: \"List LinkedIn creatives (ads). Runs by default when no subcommand is given.\",\n  },\n  args: listArgs,\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      const statuses = resolveStatusFilter(args, \"creatives\");\n      if (statuses) params.statuses = statuses.join(\",\");\n      if (args[\"campaign-id\"]) params[\"campaign-id\"] = String(args[\"campaign-id\"]);\n      if (args.limit) params.limit = String(args.limit);\n      if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n\n      const data = await apiGet<LinkedinCreativeRow[]>(\"/api/ads/linkedin/creatives\", params);\n      const shaped = shapeListRows(data, args as Record<string, unknown>, {\n        row: compactRow,\n        columns: COMPACT_COLUMNS,\n      });\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(shaped.rows, fmt, shaped.fields, shaped.hints);\n        return;\n      }\n      const warnings = unmappedShapeWarnings(data, args.full === true);\n      writeJsonEnvelope({\n        ok: true,\n        data: shaped.rows,\n        ...(warnings.length > 0 ? { warnings } : {}),\n        ...(shaped.hints ? { hints: shaped.hints } : {}),\n      });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n\nconst creativesGetCommand = defineCommand({\n  meta: {\n    name: \"get\",\n    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 — e.g. FORM_HOLD, UNDER_REVIEW, CAMPAIGN_STOPPED).\nThe listing can only name a post-based ad's post; this is where its headline and link come back.\nExample: baker ads linkedin creatives get 1584704523`,\n  },\n  args: {\n    id: { type: \"positional\", description: \"Creative id or urn:li:sponsoredCreative:N\", required: true },\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n    \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n  },\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    try {\n      const data = await apiGet<Record<string, unknown>>(\"/api/ads/linkedin/creative\", {\n        \"account-id\": accountId,\n        \"creative-id\": String(args.id),\n      });\n      writeJsonEnvelope({ ok: true, data });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n\nexport const creativesCommand = defineCommand({\n  meta: {\n    name: \"creatives\",\n    description: `List LinkedIn creatives (ads), or stage writes (create/update/pause/resume/duplicate).\n\nDefaults to ACTIVE intended-status. Pass --all-statuses or --statuses ACTIVE,PAUSED to widen.\n\nRows are compact by default: id, urn, campaign, status, review status, format, and\nthe resolved destination (landingUrl, or postUrn for post-based ads), and for a\nlead gen ad the form it opens (leadForm, leadFormButton). Use --fields\nfor specific dotted paths, or --full for the complete raw records.\n\nPost-based ads (image, video, carousel, document, article, event, TLA) report a\npostUrn, not a landingUrl — their destination lives in the post itself.\nUse 'reviewStatus' to spot rejected/pending creatives during an audit.\n\nWrite subcommands stage ops on this chat's draft — media comes from the Baker\nlibrary and is uploaded to LinkedIn only at publish.\n\nExamples:\n  baker ads linkedin creatives --account-id 503001492\n  baker ads linkedin creatives --account-id 503001492 --fields id,intendedStatus,content.textAd.landingPage\n  baker ads linkedin creatives create --campaign 1234 --format image --image-id <bakerImageId> --intro \"…\" --headline \"Book a demo\" --landing-url https://example.com --cta REQUEST_DEMO\n  baker ads linkedin creatives get 1584704523      # one ad: headline, landing URL, form, review, why not serving\n  baker ads linkedin creatives pause urn:li:sponsoredCreative:789`,\n  },\n  subCommands: {\n    list: creativesListCommand,\n    get: creativesGetCommand,\n    create: () => import(\"./write-commands.ts\").then((m) => m.creativesCreateCommand),\n    update: () => import(\"./write-commands.ts\").then((m) => m.creativesUpdateCommand),\n    pause: () => import(\"./write-commands.ts\").then((m) => m.creativesPauseCommand),\n    resume: () => import(\"./write-commands.ts\").then((m) => m.creativesResumeCommand),\n    duplicate: () => import(\"./write-commands.ts\").then((m) => m.creativesDuplicateCommand),\n    delete: () => import(\"./write-commands.ts\").then((m) => m.creativesDeleteCommand),\n  },\n  // A parent must never declare `run`: citty falls through to it *after* running\n  // the matched subcommand, so every write would also trigger a full live list.\n  // `args` stays here so citty's subcommand scan knows which flags take a value.\n  args: listArgs,\n  default: \"list\",\n});\n"],"mappings":"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","names":[]}

package/dist/creatives-UK4VITNW.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-DVFCPBR3.js").then((m) => m.briefCommand),
+    ideas: () => import("./ideas-AX7S3NCG.js").then((m) => m.ideasCommand),
+    make: () => import("./make-VQDUKVPB.js").then((m) => m.makeCommand),
+    translate: () => import("./translate-2XRHDWSC.js").then((m) => m.translateCommand),
+    learn: () => import("./learn-M4UHA476.js").then((m) => m.learnCommand),
+    feedback: () => import("./feedback-S5LHJYZD.js").then((m) => m.feedbackCommand),
+    rules: () => import("./rules-AUAJUM2T.js").then((m) => m.rulesCommand),
+    check: () => import("./check-XHK2HVD2.js").then((m) => m.checkCommand),
+    select: () => import("./select-PM7JUDQY.js").then((m) => m.selectCommand),
+    publish: () => import("./publish-PODZKJHW.js").then((m) => m.publishCommand),
+    performance: () => import("./performance-PCZHQCZ5.js").then((m) => m.performanceCommand)
+  }
+});
+export {
+  creativesCommand
+};
+//# sourceMappingURL=creatives-UK4VITNW.js.map