@koda-sl/baker-cli 0.476.0 → 0.481.0-dev.2d33e194f

package/dist/create-PITWGVAS.js

@@ -0,0 +1,130 @@
+import {
+  AUTO_PUBLISH_ARG,
+  NARROWING_ARGS,
+  REACTION_ARGS,
+  SLACK_ARG,
+  TRIGGER_ARG_DESCRIPTION,
+  TRIGGER_KIND_LIST,
+  buildTriggerBody,
+  failApi,
+  failValidation,
+  reactionBody,
+  refuseAutoPublish,
+  slackBody
+} from "./chunk-LFZTGIPJ.js";
+import "./chunk-OI7KSXZM.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-I2DNBEV6.js";
+import {
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import {
+  requireChatId
+} from "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4DM6OAQ6.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, in full. This IS the job \u2014 nothing else is resolved when it fires. Write it as you would write a message to an agent.",
+      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,
+    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 },
+    template: {
+      type: "string",
+      description: "Start from one of Baker's recipes, by its id from `baker scheduled-agents templates --list`. The recipe's brief is **copied** onto the item, so the person who owns it can read and edit exactly what it will do; anything you pass in --prompt is appended after it. Editing the recipe later does not change an item already built from it.",
+      required: 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, in full", 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,
+    timezone: { type: "string", description: "IANA timezone override", required: false },
+    disabled: { type: "boolean", description: "Create it switched off", required: false, default: false },
+    template: { type: "string", description: "Recipe id to start from", required: false },
+    ...AUTO_PUBLISH_ARG
+  },
+  run: async ({ args }) => {
+    try {
+      refuseAutoPublish(args);
+      const name = args.name;
+      const description = args.description;
+      const prompt = args.prompt;
+      const template = typeof args.template === "string" ? args.template.trim() : "";
+      if (!name || name.trim().length === 0) {
+        failValidation("--name is required.");
+      }
+      if (!description || description.trim().length === 0) {
+        failValidation("--description is required.");
+      }
+      if (template.length === 0 && (!prompt || prompt.trim().length === 0)) {
+        failValidation("--prompt is required: it is the whole of what a run does. Or pass --template to copy a brief.");
+      }
+      const trigger = buildTriggerBody(args, { required: true });
+      const reaction = reactionBody(args);
+      const body = {
+        chatId: requireChatId(),
+        name,
+        description,
+        enabled: !args.disabled,
+        ...trigger,
+        ...prompt ? { prompt } : {},
+        ...reaction,
+        ...slackBody(args),
+        ...template.length > 0 ? { templateId: template } : {}
+      };
+      const response = await apiPost("/api/scheduled-agents/create", body);
+      writeJson(response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  createCommand
+};
+//# sourceMappingURL=create-PITWGVAS.js.map

package/dist/create-PITWGVAS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/scheduled-agents/create.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { requireChatId } from \"../../env.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport {\n  AUTO_PUBLISH_ARG,\n  buildTriggerBody,\n  failApi,\n  failValidation,\n  NARROWING_ARGS,\n  REACTION_ARGS,\n  reactionBody,\n  refuseAutoPublish,\n  SLACK_ARG,\n  slackBody,\n  TRIGGER_ARG_DESCRIPTION,\n  TRIGGER_KIND_LIST,\n} from \"./shared.ts\";\n\nregisterSchema({\n  command: \"scheduled-agents.create\",\n  description:\n    \"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.\",\n  args: {\n    name: { type: \"string\", description: \"What a person will call it in the list\", required: true },\n    description: { type: \"string\", description: \"One line under the name. Not read by the run.\", required: true },\n    prompt: {\n      type: \"string\",\n      description:\n        \"What the run does, in full. This IS the job — nothing else is resolved when it fires. Write it as you would write a message to an agent.\",\n      required: true,\n    },\n    cron: { type: \"string\", description: \"5-field cron expression; implies --trigger time.cron\", required: false },\n    \"run-at\": {\n      type: \"string\",\n      description:\n        \"Run once at this ISO UTC timestamp ending in Z; implies --trigger time.once. Must still be in the future — a time that has passed is refused.\",\n      required: false,\n    },\n    trigger: { type: \"string\", description: TRIGGER_ARG_DESCRIPTION, required: false, enum: TRIGGER_KIND_LIST },\n    ...NARROWING_ARGS,\n    occurrences: {\n      type: \"string\",\n      description:\n        \"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.\",\n      required: false,\n    },\n    ...REACTION_ARGS,\n    ...SLACK_ARG,\n    timezone: { type: \"string\", description: \"IANA timezone override; defaults to Company Timezone\", required: false },\n    disabled: { type: \"boolean\", description: \"Create it switched off\", required: false, default: false },\n    template: {\n      type: \"string\",\n      description:\n        \"Start from one of Baker's recipes, by its id from `baker scheduled-agents templates --list`. The recipe's brief is **copied** onto the item, so the person who owns it can read and edit exactly what it will do; anything you pass in --prompt is appended after it. Editing the recipe later does not change an item already built from it.\",\n      required: false,\n    },\n  },\n});\n\nexport const createCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description:\n      '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',\n  },\n  args: {\n    name: { type: \"string\", description: \"What a person will call it\", required: false },\n    description: { type: \"string\", description: \"One line under the name\", required: false },\n    prompt: { type: \"string\", description: \"What the run does, in full\", required: false },\n    cron: { type: \"string\", description: \"5-field cron expression\", required: false },\n    \"run-at\": { type: \"string\", description: \"ISO UTC timestamp ending in Z, still in the future\", required: false },\n    trigger: { type: \"string\", description: `One of: ${TRIGGER_KIND_LIST.join(\", \")}`, required: false },\n    ...NARROWING_ARGS,\n    occurrences: { type: \"string\", description: \"Only these firings, e.g. 1 or 1,3\", required: false },\n    ...REACTION_ARGS,\n    ...SLACK_ARG,\n    timezone: { type: \"string\", description: \"IANA timezone override\", required: false },\n    disabled: { type: \"boolean\", description: \"Create it switched off\", required: false, default: false },\n    template: { type: \"string\", description: \"Recipe id to start from\", required: false },\n\n    ...AUTO_PUBLISH_ARG,\n  },\n  run: async ({ args }) => {\n    try {\n      refuseAutoPublish(args);\n      const name = args.name as string | undefined;\n      const description = args.description as string | undefined;\n      const prompt = args.prompt as string | undefined;\n      const template = typeof args.template === \"string\" ? args.template.trim() : \"\";\n      if (!name || name.trim().length === 0) {\n        failValidation(\"--name is required.\");\n      }\n      if (!description || description.trim().length === 0) {\n        failValidation(\"--description is required.\");\n      }\n      // A recipe brings its own brief, so `--prompt` is what this company adds to\n      // it rather than the whole job. Without one there is nothing to run.\n      if (template.length === 0 && (!prompt || prompt.trim().length === 0)) {\n        failValidation(\"--prompt is required: it is the whole of what a run does. Or pass --template to copy a brief.\");\n      }\n      const trigger = buildTriggerBody(args, { required: true });\n      const reaction = reactionBody(args);\n      const body: Record<string, unknown> = {\n        chatId: requireChatId(),\n        name,\n        description,\n        enabled: !args.disabled,\n        ...trigger,\n        ...(prompt ? { prompt } : {}),\n        ...reaction,\n        ...slackBody(args),\n        ...(template.length > 0 ? { templateId: template } : {}),\n      };\n      const response = await apiPost<{ ok: true; data: { tempId: string } }>(\"/api/scheduled-agents/create\", body);\n      writeJson(response);\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/create-XLZYNFKN.js

@@ -0,0 +1,235 @@
+import {
+  holdWorkspaceSpend
+} from "./chunk-VHMNSO2B.js";
+import "./chunk-65BQAJMH.js";
+import {
+  askJev
+} from "./chunk-6GFJFTG6.js";
+import "./chunk-NAMEFVWL.js";
+import "./chunk-GT4UFORX.js";
+import "./chunk-CECS3DHZ.js";
+import {
+  ACTION_PRIORITIES,
+  buildCreateHints,
+  failApi,
+  failValidation,
+  generateTempId,
+  parsePriority,
+  parseTagList
+} from "./chunk-NORAJYUI.js";
+import {
+  actionTempIdSchema
+} from "./chunk-OI7KSXZM.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-I2DNBEV6.js";
+import {
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import {
+  requireChatId
+} from "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/create.ts
+import { defineCommand } from "citty";
+
+// src/commands/actions/advisory.ts
+var EXECUTABLE_SURFACES = [
+  "ask-user",
+  "analysis",
+  "ads-write",
+  "tag-manager",
+  "site-tags",
+  "landing",
+  "flow"
+];
+var SCHEDULED_HINT = 'This reads as recurring/scheduled work. If it should run on a cadence or a future date, create a Scheduled agent instead \u2014 baker scheduled-agents create --cron "0 9 * * MON" (or --run-at, or --trigger for a reaction rather than a clock; guide: `__tooling__/docs/tools/baker/scheduled-agents.md`). Do not capture "set up a schedule" as a Work Action.';
+var SURFACES = {
+  "ask-user": {
+    questions: [
+      "Does `task` say the work cannot go ahead until the client or user gives or confirms one specific value, such as a production domain, an account ID or credentials? Work that is blocked for any other reason is not."
+    ],
+    hint: "This is a missing input, not blocked work. Ask for it with AskUserQuestion (one question), then do the work in the same turn \u2014 filing the Task AND asking the question is the same request twice."
+  },
+  analysis: {
+    questions: [
+      "Is the work `task` names itself an investigation: to audit, review, analyse, verify, check, document or research something, where the result is a finding rather than a change?"
+    ],
+    hint: "This names the analysis itself \u2014 investigating, auditing and documenting are work you do now, not work you file. Run it in this chat and deliver the finding; a Task is for a fix something genuinely blocks (bar: `__tooling__/docs/tools/baker/actions.md`)."
+  },
+  "ads-write": {
+    // The platform often goes unnamed ("6 new WhatsApp campaigns" are Google Ads campaigns).
+    questions: [
+      "Is `task` a change to the settings of paid ad campaigns or ad sets: location targeting, ad schedule, audiences or audience signals, bids, tracking URL templates or final URLs?",
+      "Is `task` setting, applying, raising, lowering or capping the budget of paid ad campaigns or ad sets? Approving a budget is not.",
+      "Is `task` a change to what paid ads say or show: ad copy, search ad (RSA) headlines or descriptions, display paths, claims in the ads, callouts, sitelinks, structured snippets or other ad extensions?",
+      "Is `task` a change to the keywords of paid search campaigns: adding keywords, match types or negative keywords? Work that needs another company's permission first is not.",
+      "Is `task` pausing, launching, enabling, duplicating, pruning, reweighting or restructuring paid ad campaigns, ad sets or ads, or labelling them? Getting a decision or an approval is not."
+    ],
+    hint: "This is an ad-platform change the write surface covers \u2014 stage it now with `baker ads google|meta|linkedin` and it applies at publish (guides: `__tooling__/docs/tools/baker/ads-google.md`, `__tooling__/docs/tools/baker/ads-meta.md`, `__tooling__/docs/tools/baker/ads-linkedin.md`). Staging is not going live."
+  },
+  "tag-manager": {
+    questions: [
+      "Is `task` a change inside the Google Tag Manager container: its tags, triggers, variables, data layer events, consent settings, GA4 events or conversion measurement? Server-side tagging, or hosting, is not."
+    ],
+    hint: "This is a change inside the GTM container \u2014 `baker tag-manager` stages it now and it applies at publish (guide: `__tooling__/docs/tools/baker/tag-manager.md`). Stage it instead of filing it, and if several container fixes really are blocked, they belong in ONE Task, not one per finding."
+  },
+  "site-tags": {
+    questions: [
+      "Is `task` installing, configuring or removing a tracking script, pixel or tag on the website pages (a Meta pixel and its Conversions API events, Clarity, Hotjar, a HubSpot tracking code, a LinkedIn Insight tag)? A server-side setup on the company's own domain is not."
+    ],
+    hint: "This is a tag or script on the site \u2014 it goes through the `request_tag_input` approval form in this chat, which also collects any secret values (guide: `__tooling__/docs/tools/baker/tags.md`). Show the form instead of filing a Task."
+  },
+  landing: {
+    questions: [
+      "Is `task` building or editing a page of the website or a landing page: its copy, hero, headline, sections or layout? A headline of an ad, or a page only mentioned as the cause of another problem, is not."
+    ],
+    hint: "This is a page change \u2014 build it in this chat with the `/landing` skill. Only file it if something outside the page blocks the work."
+  },
+  flow: {
+    questions: ["Is `task` changing how a form behaves: its steps, branching logic, or the redirect after it is sent?"],
+    hint: "This is form behaviour \u2014 change it in this chat with the `/flow-builder` skill. Only file it if something outside the form blocks the work."
+  }
+};
+var SCHEDULED_QUESTIONS = [
+  "Does `task` ask for work to be done again and again on a schedule (every day, every week, each Monday, monthly)? A month or period that only says what the work is about is not.",
+  "Does `task` ask to be reminded, or for work to be done, at a later date or moment (before a launch, on a given day)? A month or date that only names the period the work is about is not."
+];
+var ROUTING_BANDS = { scheduled: 0.5, surface: 0.5 };
+var jevTaskJudge = async (task) => {
+  const groups = [
+    SCHEDULED_QUESTIONS,
+    ...EXECUTABLE_SURFACES.map((s) => SURFACES[s].questions)
+  ];
+  const spent = [];
+  const answers = await askJev(
+    groups.flat().map((question) => ({ instructions: { task, question } })),
+    (usage) => spent.push(usage)
+  );
+  await holdWorkspaceSpend(spent);
+  if (answers === null) return null;
+  let next = 0;
+  const [scheduled = 0, ...surfaces] = groups.map((group) => Math.max(...group.map(() => answers[next++] ?? 0)));
+  return {
+    scheduled,
+    surfaces: Object.fromEntries(EXECUTABLE_SURFACES.map((s, i) => [s, surfaces[i] ?? 0]))
+  };
+};
+function hintFor(reading) {
+  if (reading.scheduled >= ROUTING_BANDS.scheduled) return { kind: "scheduled", hint: SCHEDULED_HINT };
+  if (reading.surfaces["ask-user"] >= ROUTING_BANDS.surface) {
+    return { kind: "executable", surface: "ask-user", hint: SURFACES["ask-user"].hint };
+  }
+  let best = null;
+  for (const surface of EXECUTABLE_SURFACES) {
+    const p = reading.surfaces[surface];
+    if (p >= ROUTING_BANDS.surface && (best === null || p > best.p)) best = { surface, p };
+  }
+  return best ? { kind: "executable", surface: best.surface, hint: SURFACES[best.surface].hint } : null;
+}
+function taskText(name, description) {
+  return description.trim() ? `${name.trim()}
+
+${description.trim()}` : name.trim();
+}
+async function advisoryHint(name, description, judge) {
+  const reading = await judge(taskText(name, description)).catch(() => null);
+  return reading === null ? null : hintFor(reading);
+}
+
+// src/commands/actions/create.ts
+registerSchema({
+  command: "actions.create",
+  description: "Stage creation of a new action (applies when the chat is published). Returns a tempId you can use to link in the same draft. Pass --tags (REQUIRED \u2014 run `baker actions tags list` for the taxonomy) and --priority (one of urgent|high|medium|low \u2014 drives the dependency-aware 'Do first' ordering). After creating, check if this action blocks or is blocked by other actions and wire dependencies with `baker actions link`.",
+  args: {
+    name: { type: "string", description: "Action name (short, action-verb, \u22646 words)", required: true },
+    description: {
+      type: "string",
+      description: "Context-complete description in markdown: what / why / where / done-when. Use `##` headings for those sections, `-` bullets for lists of items, and `**bold**` for the figures that drive the decision. Anything longer than a couple of sentences needs headings \u2014 it is read in a narrow panel.",
+      required: false
+    },
+    tags: {
+      type: "string",
+      description: "Comma-separated tag slugs (e.g. google-ads,audit-finding). Must be known \u2014 see `baker actions tags list`.",
+      required: false
+    },
+    priority: {
+      type: "string",
+      description: `User priority for the do-first ordering. One of: ${ACTION_PRIORITIES.join(", ")}.`,
+      required: false
+    },
+    "temp-id": {
+      type: "string",
+      description: "Custom tempId \u2014 must start with `temp_` (e.g. temp_hero_copy). Auto-generated if omitted; omitting it is fine.",
+      required: false
+    }
+  }
+});
+var createCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: 'Stage a new action. Applies when the chat is published. Example: baker actions create --name "Build hero"'
+  },
+  args: {
+    name: { type: "string", description: "Action name", required: false },
+    description: { type: "string", description: "Description", required: false, default: "" },
+    tags: { type: "string", description: "Comma-separated tag slugs (see `baker actions tags list`)", required: false },
+    priority: { type: "string", description: `User priority: ${ACTION_PRIORITIES.join("|")}`, required: false },
+    "temp-id": { type: "string", description: "Optional custom tempId (must start with `temp_`)", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const name = args.name;
+      if (!name || name.trim().length === 0) {
+        failValidation("--name is required.");
+      }
+      const customTempId = args["temp-id"];
+      if (customTempId) {
+        const parsed = actionTempIdSchema.safeParse(customTempId);
+        if (!parsed.success) {
+          failValidation(parsed.error.issues[0]?.message ?? "Invalid --temp-id.");
+        }
+      }
+      const chatId = requireChatId();
+      const tempId = customTempId || generateTempId();
+      const tags = parseTagList(args.tags);
+      const priority = parsePriority(args.priority, { allowClear: false });
+      const description = args.description ?? "";
+      const [response, advisory] = await Promise.all([
+        apiPost("/api/actions/create", {
+          chatId,
+          tempId,
+          name,
+          description,
+          ...tags ? { tags } : {},
+          ...priority !== void 0 && priority !== null ? { priority } : {}
+        }),
+        advisoryHint(name, description, jevTaskJudge)
+      ]);
+      writeJson({
+        ...response,
+        hints: buildCreateHints({
+          advisory,
+          description,
+          tempId,
+          tags,
+          prioritySet: priority !== void 0,
+          draftCreateCount: response.data.draftCreateCount ?? 0
+        })
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  createCommand
+};
+//# sourceMappingURL=create-XLZYNFKN.js.map

package/dist/creatives-O3444SBT.js

@@ -0,0 +1,182 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg,
+  resolveStatusFilter,
+  statusesArgDescription
+} from "./chunk-LMHVLUD4.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-LHNL6JM2.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-DL2W4N7J.js";
+import {
+  shapeListRows
+} from "./chunk-KIGGMKAE.js";
+import "./chunk-OI7KSXZM.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-I2DNBEV6.js";
+import {
+  apiGet
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import "./chunk-4DM6OAQ6.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"
+];
+function compactRow(row) {
+  const destination = creativeDestination(row.content);
+  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 } : {}
+  };
+}
+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 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). 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 pause urn:li:sponsoredCreative:789`
+  },
+  subCommands: {
+    list: creativesListCommand,
+    create: () => import("./write-commands-OYMWOFEY.js").then((m) => m.creativesCreateCommand),
+    update: () => import("./write-commands-OYMWOFEY.js").then((m) => m.creativesUpdateCommand),
+    pause: () => import("./write-commands-OYMWOFEY.js").then((m) => m.creativesPauseCommand),
+    resume: () => import("./write-commands-OYMWOFEY.js").then((m) => m.creativesResumeCommand),
+    duplicate: () => import("./write-commands-OYMWOFEY.js").then((m) => m.creativesDuplicateCommand)
+  },
+  // 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 {
+  creativeDestination,
+  creativesCommand,
+  unmappedShapeWarnings
+};
+//# sourceMappingURL=creatives-O3444SBT.js.map

package/dist/creatives-ONKKGW5T.js

@@ -0,0 +1,87 @@
+import {
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-O3LHCQ7Q.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-LHNL6JM2.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-DL2W4N7J.js";
+import {
+  apiGet
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import "./chunk-4DM6OAQ6.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: "Single creative ID" },
+  limit: { type: "string", description: "Max rows (default 500)" },
+  "no-cache": NO_CACHE_ARG,
+  output: { type: "string", description: "Output format", default: "json" }
+};
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List ad creatives, or fetch one by ID. Runs by default when no subcommand is given. Example: baker ads meta creatives --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    try {
+      const params = {};
+      if (args["creative-id"]) {
+        params["creative-id"] = args["creative-id"];
+      } else {
+        const accountId = resolveAccountIdArg(args);
+        params["account-id"] = accountId;
+      }
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/creatives", params);
+      const fmt = csvOrJson(args);
+      if (Array.isArray(data) && fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } 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>).
+
+Examples:
+  baker ads meta creatives --account-id act_123
+  baker ads meta creatives --creative-id 23842...   # fetch one
+  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-5TJ3LQ5F.js").then((m) => m.adCreativesCreateCommand),
+    update: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adCreativesUpdateCommand)
+  },
+  // `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-ONKKGW5T.js.map