@koda-sl/baker-cli 0.568.0 → 0.569.0-dev.1b455b3fe

package/dist/conversion-writes-MUD7WJDH.js

@@ -0,0 +1,122 @@
+import {
+  compact,
+  lowerArg,
+  schemaArgs,
+  stageChatgptOp
+} from "./chunk-BPDIY5CF.js";
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptRead
+} from "./chunk-3JOGDGGP.js";
+import "./chunk-MK4HCMEA.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/conversion-writes.ts
+import { defineCommand } from "citty";
+var REFERENCE = CHATGPT_ADS_REFERENCE.conversions;
+var CREATE_ARGS = {
+  name: {
+    type: "string",
+    description: "What the conversion is called in reports, e.g. Quote requests",
+    required: true
+  },
+  event: {
+    type: "string",
+    description: "lead_created, appointment_scheduled, registration_completed, order_created, checkout_started, items_added, contents_viewed, page_viewed, subscription_created, trial_started \u2014 or custom",
+    required: true
+  },
+  "custom-name": {
+    type: "string",
+    description: "With --event custom: the exact event name the site sends (1\u201364 letters, digits, _ or -)"
+  },
+  pixel: {
+    type: "string",
+    description: "The pixel it counts from \u2014 its Pixel ID, its source id, or a pixel staged in this chat (chatgpt_temp_\u2026). Default: the account's only pixel"
+  }
+};
+function conversionCreateOp(args) {
+  return {
+    kind: "conversionEvent.create",
+    payload: compact({
+      name: args.name,
+      eventType: lowerArg(args.event),
+      customEventName: args["custom-name"],
+      sourceId: args.pixel
+    })
+  };
+}
+registerSchema({
+  command: "ads.chatgpt.conversions.create",
+  description: "Stage a conversion \u2014 one event from the account's pixel that ChatGPT Ads counts, standard or custom. Applies when the chat is published; it can never be deleted, and only ChatGPT Ads Manager can rename it. A custom one only measures; a conversions campaign optimises for a standard one.",
+  args: schemaArgs(CREATE_ARGS)
+});
+var conversionsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a conversion (applies when the chat is published).
+
+Examples:
+  baker ads chatgpt conversions create --name "Leads" --event lead_created
+  baker ads chatgpt conversions create --name "Quote requests" --event custom --custom-name quote_requested`
+  },
+  args: CREATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(conversionCreateOp(args), REFERENCE, (staged) => [
+      `Measure it on a campaign with --conversion-event-ids ${staged.ref} (campaigns create or update).`,
+      "After the publish, trigger the event on the live page and confirm it arrives with `baker ads chatgpt conversions events`."
+    ]);
+  }
+});
+var EVENTS_ARGS = {
+  pixel: { type: "string", description: "Pixel ID or source id (default: the account's only pixel)" }
+};
+registerSchema({
+  command: "ads.chatgpt.conversions.events",
+  description: "The events a pixel delivered to ChatGPT Ads in about the last 15 minutes \u2014 type, custom name, browser or server, when. Proof the site sends them, not attribution: trigger one on the page first.",
+  args: schemaArgs(EVENTS_ARGS)
+});
+function eventHints(recent) {
+  if (recent.events.length === 0) {
+    return [
+      "Nothing arrived in the last 15 minutes. Trigger the event on the live page (load it, submit the form), then read again \u2014 the stream keeps only about 15 minutes."
+    ];
+  }
+  return [];
+}
+var conversionsEventsCommand = defineCommand({
+  meta: {
+    name: "events",
+    description: `What the pixel sent in about the last 15 minutes \u2014 check a conversion really arrives.
+
+Examples:
+  baker ads chatgpt conversions events
+  baker ads chatgpt conversions events --pixel 2bow4Axzw2JK7H44AfsLeY`
+  },
+  args: EVENTS_ARGS,
+  run: async ({ args }) => {
+    await runChatgptRead(
+      REFERENCE,
+      () => apiGet(
+        "/api/ads/chatgpt/conversions/events",
+        typeof args.pixel === "string" && args.pixel ? { pixel: args.pixel } : void 0
+      ),
+      eventHints
+    );
+  }
+});
+export {
+  conversionCreateOp,
+  conversionsCreateCommand,
+  conversionsEventsCommand
+};
+//# sourceMappingURL=conversion-writes-MUD7WJDH.js.map

package/dist/conversions-B7HR6JMC.js

@@ -0,0 +1,140 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-34MZGC2Y.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-MK4HCMEA.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-GO6ISZUZ.js";
+import "./chunk-YOHGEF2N.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-IMS53EQU.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/conversions.ts
+import { defineCommand } from "citty";
+var DAY_MS = 864e5;
+function healthOf(rules) {
+  const enabled = rules.filter((r) => r.enabled !== false);
+  const capi = enabled.filter((r) => r.conversionMethod === "CONVERSIONS_API");
+  const pixel = enabled.filter((r) => r.conversionMethod?.startsWith("INSIGHT_TAG"));
+  const staleCapi = capi.filter(
+    (r) => !r.lastConversionReportedAt || Date.now() - r.lastConversionReportedAt > 7 * DAY_MS
+  );
+  const longView = enabled.filter(
+    (r) => r.viewThroughAttributionWindowSize !== void 0 && r.viewThroughAttributionWindowSize > 7
+  );
+  const leads = enabled.filter((r) => r.type === "LEAD");
+  const wrongDedup = leads.filter((r) => r.countingMethod && r.countingMethod !== "ONE_TIME_EACH_MEMBER");
+  return {
+    totalRules: rules.length,
+    enabledRules: enabled.length,
+    capiRules: capi.length,
+    pixelRules: pixel.length,
+    hasLeadEvent: leads.length > 0,
+    hasPurchaseEvent: enabled.some((r) => r.type === "PURCHASE"),
+    staleCapiRules: staleCapi,
+    longViewWindow: longView,
+    wrongLeadDedup: wrongDedup
+  };
+}
+var listCmd = defineCommand({
+  meta: {
+    name: "list",
+    description: `List conversion rules on the account.`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/conversions", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var healthCmd = defineCommand({
+  meta: {
+    name: "health",
+    description: `5-point Insight Tag / CAPI health check (playbook \xA707).
+
+Surfaces:
+  - Are rules enabled?
+  - Do we have at least one LEAD or PURCHASE event?
+  - Do CAPI rules show recent activity (\u22647 days)?
+  - Is the view-through window \u22647 days?
+  - Do LEAD rules use ONE_TIME_EACH_MEMBER de-dup?`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/conversions", params);
+      writeAdsJson({ ok: true, data: healthOf(data) });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var conversionsCommand = defineCommand({
+  meta: {
+    name: "conversions",
+    description: `Conversion rules \u2014 Insight Tag and Conversions API.
+
+Subcommands:
+  list                \u2014 every rule on the account
+  health              \u2014 playbook \xA707 5-point health check
+  create / update     \u2014 stage a conversion-rule write (applies on chat publish)
+  associate-campaign / dissociate-campaign
+                      \u2014 which ad sets a rule counts for (its own LinkedIn record, not a field on the rule)
+  upload              \u2014 stage CRM / offline conversions (deals won, qualified leads) into a Conversions API rule`
+  },
+  subCommands: {
+    list: listCmd,
+    health: healthCmd,
+    create: () => import("./write-commands-HFP5KLYZ.js").then((m) => m.conversionsCreateCommand),
+    update: () => import("./write-commands-HFP5KLYZ.js").then((m) => m.conversionsUpdateCommand),
+    "associate-campaign": () => import("./write-commands-HFP5KLYZ.js").then((m) => m.conversionsAssociateCommand),
+    "dissociate-campaign": () => import("./write-commands-HFP5KLYZ.js").then((m) => m.conversionsDissociateCommand),
+    upload: () => import("./write-commands-HFP5KLYZ.js").then((m) => m.conversionsUploadCommand)
+  }
+});
+export {
+  conversionsCommand
+};
+//# sourceMappingURL=conversions-B7HR6JMC.js.map

package/dist/conversions-WU7DNFF7.js

@@ -0,0 +1,78 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-3JOGDGGP.js";
+import "./chunk-MK4HCMEA.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/conversions.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.chatgpt.conversions",
+  description: "What the connected ChatGPT Ads account measures: its pixels (with the pixel id a landing page installs) and its conversion events (standard type, attribution window, sources, the campaigns using each).",
+  args: {}
+});
+function conversionHints(conversions) {
+  const hints = [];
+  if (conversions.pixels === null) {
+    hints.push(
+      "ChatGPT Ads does not let this account list its pixels through the API. The pixel id is in Ads Manager \u2192 Conversions."
+    );
+  } else if (conversions.pixels.length === 0) {
+    hints.push(
+      "No pixel yet: without one on the landing pages, ChatGPT Ads counts no conversions and cannot optimise for them."
+    );
+  }
+  if (conversions.events.filter((event) => !event.archived).length === 0) {
+    hints.push(
+      "No conversion is defined, so no campaign measures or optimises for one. Stage one with `baker ads chatgpt conversions create`."
+    );
+  }
+  return hints;
+}
+var conversionsListCommand = defineCommand({
+  meta: { name: "list", description: "Pixels and conversions. Example: baker ads chatgpt conversions" },
+  args: {},
+  run: async () => {
+    await runChatgptListRead(
+      CHATGPT_ADS_REFERENCE.conversions,
+      "/api/ads/chatgpt/conversions",
+      void 0,
+      conversionHints
+    );
+  }
+});
+var conversionsCommand = defineCommand({
+  meta: {
+    name: "conversions",
+    description: `What a ChatGPT Ads account measures \u2014 its pixels and conversions \u2014 define a new conversion, and check the pixel's events arrive.
+
+Examples:
+  baker ads chatgpt conversions
+  baker ads chatgpt conversions create --name "Quote requests" --event custom --custom-name quote_requested
+  baker ads chatgpt conversions events
+  baker ads chatgpt conversions report --ids cmpn_123 --days 30   \u2014 click-through and view-through`
+  },
+  subCommands: {
+    list: conversionsListCommand,
+    create: () => import("./conversion-writes-MUD7WJDH.js").then((m) => m.conversionsCreateCommand),
+    events: () => import("./conversion-writes-MUD7WJDH.js").then((m) => m.conversionsEventsCommand),
+    report: () => import("./conversion-report-E35RCZU7.js").then((m) => m.conversionsReportCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it after the matched subcommand.
+  args: {},
+  default: "list"
+});
+export {
+  conversionHints,
+  conversionsCommand
+};
+//# sourceMappingURL=conversions-WU7DNFF7.js.map

package/dist/copy-writes-R7VYSZXC.js

@@ -0,0 +1,171 @@
+import {
+  command
+} from "./chunk-L7UD57TV.js";
+import {
+  bareAccountId,
+  failWriteValidation,
+  parseDateFlag,
+  requireTarget,
+  stageOp,
+  upper
+} from "./chunk-ZOCAGPS5.js";
+import "./chunk-GC5P4KWY.js";
+import "./chunk-GDFJOCDO.js";
+import "./chunk-7TVVYP7K.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-LZR7LSYO.js";
+import "./chunk-55AX6DOP.js";
+import "./chunk-MX5NQAK6.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-4H6XLX7E.js";
+import "./chunk-QALAJNBG.js";
+import "./chunk-MK4HCMEA.js";
+import "./chunk-Y5PNLB24.js";
+import "./chunk-N3PASNUA.js";
+import "./chunk-E56V3RFO.js";
+import "./chunk-EL3TDR5S.js";
+import "./chunk-G6U45QD3.js";
+import "./chunk-X6U3B6YK.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/copy-writes.ts
+var STATUS_WORDS = {
+  PAUSED: "PAUSED",
+  ACTIVE: "ACTIVE",
+  INHERITED: "INHERITED_FROM_SOURCE",
+  INHERITED_FROM_SOURCE: "INHERITED_FROM_SOURCE",
+  SAME: "INHERITED_FROM_SOURCE"
+};
+var RENAME_WORDS = {
+  TOP: "ONLY_TOP_LEVEL_RENAME",
+  ONLY_TOP_LEVEL_RENAME: "ONLY_TOP_LEVEL_RENAME",
+  DEEP: "DEEP_RENAME",
+  ALL: "DEEP_RENAME",
+  DEEP_RENAME: "DEEP_RENAME",
+  NONE: "NO_RENAME",
+  NO_RENAME: "NO_RENAME"
+};
+function mapped(words, value, flag, allowed) {
+  const key = upper(value);
+  if (key === void 0) {
+    return void 0;
+  }
+  const word = words[key];
+  if (!word) {
+    failWriteValidation(`${flag} takes ${allowed}`);
+  }
+  return word;
+}
+function copyPayloadFromFlags(level, args) {
+  const payload = {
+    source_id: args.id,
+    status_option: mapped(STATUS_WORDS, args.status, "--status", "PAUSED, ACTIVE or INHERITED"),
+    rename_strategy: mapped(RENAME_WORDS, args.rename, "--rename", "top, deep or none"),
+    rename_prefix: args["rename-prefix"],
+    rename_suffix: args["rename-suffix"]
+  };
+  if (level !== "ad") {
+    payload.deep_copy = args.deep === true ? true : void 0;
+    payload.start_time = parseDateFlag(args.start, "--start");
+    payload.end_time = parseDateFlag(args.end, "--end");
+  }
+  if (level === "adSet") {
+    payload.campaign_id = args["to-campaign"];
+  }
+  if (level === "ad") {
+    payload.adset_id = args["to-adset"];
+  }
+  return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== void 0));
+}
+var accountArg = { type: "string", description: "Meta ad account ID (act_123)" };
+var naming = {
+  status: {
+    type: "string",
+    description: "PAUSED (default) | ACTIVE \u2014 the copy delivers and spends once published | INHERITED \u2014 the original's"
+  },
+  rename: {
+    type: "string",
+    description: "top (default: only the copied object is renamed) | deep (its ad sets and ads too) | none"
+  },
+  "rename-prefix": { type: "string", description: "Put this before each renamed name" },
+  "rename-suffix": {
+    type: "string",
+    description: `Put this after each renamed name instead of Meta's " - Copy" (in the account's language)`
+  }
+};
+var schedule = {
+  start: { type: "string", description: "When the copied ad sets start (ISO date or datetime); else the original's" },
+  end: { type: "string", description: "When the copied ad sets end; else the original's" }
+};
+var WHEN_TO_COPY = `copy is Meta's own copy: it keeps everything Meta holds \u2014 creatives, placements, every setting Baker cannot read back \u2014 and, with --deep, everything underneath. Use \`duplicate\` instead when the copy must differ in the same step (a new name, budget or targeting); or copy, then change the copy by its ref (\`adsets update <ref> --daily-budget 30\`), which applies once Meta has made it.`;
+function copyArgs(level, label) {
+  const args = {
+    id: { type: "positional", description: `${label} id to copy (a published one)`, required: true },
+    "account-id": accountArg
+  };
+  if (level !== "ad") {
+    const children = level === "campaign" ? "ad sets and ads" : "ads";
+    args.deep = { type: "boolean", description: `Copy its ${children} too (Meta copies at most 51 ads in one go)` };
+  }
+  if (level === "adSet") {
+    args["to-campaign"] = {
+      type: "string",
+      description: "Campaign id or meta_temp_* ref to put the copy in; else beside the original"
+    };
+  }
+  if (level === "ad") {
+    args["to-adset"] = {
+      type: "string",
+      description: "Ad set id or meta_temp_* ref to put the copy in; else beside the original"
+    };
+  }
+  Object.assign(args, naming, level === "ad" ? {} : schedule);
+  return args;
+}
+function copyCommand(level, input) {
+  return command({
+    schema: `ads.meta.${input.family}.copy`,
+    name: "copy",
+    description: `Stage Meta's own copy of a ${input.label}${level === "ad" ? "" : " (with --deep, of everything under it)"}, paused unless --status. Prints a meta_temp_* ref for the copy that later changes in this chat can name. ${WHEN_TO_COPY}
+Example: ${input.extra}`,
+    schemaDescription: `Stage a copy of a Meta ${input.label} through Meta's copies edge \u2014 applied at publish; the copy's ref resolves to its new id.`,
+    args: copyArgs(level, input.label),
+    run: async (args) => {
+      requireTarget(args, input.label);
+      await stageOp({
+        kind: `${level}.copy`,
+        accountId: await bareAccountId(args),
+        payload: copyPayloadFromFlags(level, args)
+      });
+    }
+  });
+}
+var campaignsCopyCommand = copyCommand("campaign", {
+  family: "campaigns",
+  label: "campaign",
+  extra: 'baker ads meta campaigns copy 6123 --deep --rename-suffix " \u2013 Q4" --start 2026-11-01'
+});
+var adSetsCopyCommand = copyCommand("adSet", {
+  family: "adsets",
+  label: "ad set",
+  extra: "baker ads meta adsets copy 6124 --deep --to-campaign meta_temp_ab12"
+});
+var adsCopyCommand = copyCommand("ad", {
+  family: "ads",
+  label: "ad",
+  extra: "baker ads meta ads copy 6125 --to-adset 6130"
+});
+export {
+  adSetsCopyCommand,
+  adsCopyCommand,
+  campaignsCopyCommand,
+  copyPayloadFromFlags
+};
+//# sourceMappingURL=copy-writes-R7VYSZXC.js.map

package/dist/copy-writes-R7VYSZXC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/copy-writes.ts"],"sourcesContent":["import type { ArgsDef, CommandDef } from \"citty\";\nimport { command } from \"./asset-writes.ts\";\nimport { bareAccountId, failWriteValidation, parseDateFlag, requireTarget, stageOp, upper } from \"./write-shared.ts\";\n\n/**\n * `campaigns|adsets|ads copy` — Meta's own copy (`POST /{id}/copies`), staged\n * until publish. Meta builds the copy from everything it holds, so it keeps\n * what Baker cannot read back or write; `duplicate` is the other tool, for a\n * copy whose fields change in the same step.\n */\n\ntype Level = \"campaign\" | \"adSet\" | \"ad\";\n\nconst STATUS_WORDS: Record<string, string> = {\n  PAUSED: \"PAUSED\",\n  ACTIVE: \"ACTIVE\",\n  INHERITED: \"INHERITED_FROM_SOURCE\",\n  INHERITED_FROM_SOURCE: \"INHERITED_FROM_SOURCE\",\n  SAME: \"INHERITED_FROM_SOURCE\",\n};\n\nconst RENAME_WORDS: Record<string, string> = {\n  TOP: \"ONLY_TOP_LEVEL_RENAME\",\n  ONLY_TOP_LEVEL_RENAME: \"ONLY_TOP_LEVEL_RENAME\",\n  DEEP: \"DEEP_RENAME\",\n  ALL: \"DEEP_RENAME\",\n  DEEP_RENAME: \"DEEP_RENAME\",\n  NONE: \"NO_RENAME\",\n  NO_RENAME: \"NO_RENAME\",\n};\n\nfunction mapped(words: Record<string, string>, value: unknown, flag: string, allowed: string): string | undefined {\n  const key = upper(value);\n  if (key === undefined) {\n    return undefined;\n  }\n  const word = words[key];\n  if (!word) {\n    failWriteValidation(`${flag} takes ${allowed}`);\n  }\n  return word;\n}\n\n/** The staged copy payload from the command's flags. */\nexport function copyPayloadFromFlags(level: Level, args: Record<string, unknown>): Record<string, unknown> {\n  const payload: Record<string, unknown> = {\n    source_id: args.id,\n    status_option: mapped(STATUS_WORDS, args.status, \"--status\", \"PAUSED, ACTIVE or INHERITED\"),\n    rename_strategy: mapped(RENAME_WORDS, args.rename, \"--rename\", \"top, deep or none\"),\n    rename_prefix: args[\"rename-prefix\"],\n    rename_suffix: args[\"rename-suffix\"],\n  };\n  if (level !== \"ad\") {\n    payload.deep_copy = args.deep === true ? true : undefined;\n    payload.start_time = parseDateFlag(args.start, \"--start\");\n    payload.end_time = parseDateFlag(args.end, \"--end\");\n  }\n  if (level === \"adSet\") {\n    payload.campaign_id = args[\"to-campaign\"];\n  }\n  if (level === \"ad\") {\n    payload.adset_id = args[\"to-adset\"];\n  }\n  return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== undefined));\n}\n\nconst accountArg = { type: \"string\", description: \"Meta ad account ID (act_123)\" } as const;\nconst naming = {\n  status: {\n    type: \"string\",\n    description: \"PAUSED (default) | ACTIVE — the copy delivers and spends once published | INHERITED — the original's\",\n  },\n  rename: {\n    type: \"string\",\n    description: \"top (default: only the copied object is renamed) | deep (its ad sets and ads too) | none\",\n  },\n  \"rename-prefix\": { type: \"string\", description: \"Put this before each renamed name\" },\n  \"rename-suffix\": {\n    type: \"string\",\n    description: \"Put this after each renamed name instead of Meta's \\\" - Copy\\\" (in the account's language)\",\n  },\n} as const;\nconst schedule = {\n  start: { type: \"string\", description: \"When the copied ad sets start (ISO date or datetime); else the original's\" },\n  end: { type: \"string\", description: \"When the copied ad sets end; else the original's\" },\n} as const;\n\nconst WHEN_TO_COPY = `copy is Meta's own copy: it keeps everything Meta holds — creatives, placements, every setting Baker cannot read back — and, with --deep, everything underneath. Use \\`duplicate\\` instead when the copy must differ in the same step (a new name, budget or targeting); or copy, then change the copy by its ref (\\`adsets update <ref> --daily-budget 30\\`), which applies once Meta has made it.`;\n\ntype ArgSpec = { type: string; description: string; required?: boolean };\n\nfunction copyArgs(level: Level, label: string): Record<string, ArgSpec> {\n  const args: Record<string, ArgSpec> = {\n    id: { type: \"positional\", description: `${label} id to copy (a published one)`, required: true },\n    \"account-id\": accountArg,\n  };\n  if (level !== \"ad\") {\n    const children = level === \"campaign\" ? \"ad sets and ads\" : \"ads\";\n    args.deep = { type: \"boolean\", description: `Copy its ${children} too (Meta copies at most 51 ads in one go)` };\n  }\n  if (level === \"adSet\") {\n    args[\"to-campaign\"] = {\n      type: \"string\",\n      description: \"Campaign id or meta_temp_* ref to put the copy in; else beside the original\",\n    };\n  }\n  if (level === \"ad\") {\n    args[\"to-adset\"] = {\n      type: \"string\",\n      description: \"Ad set id or meta_temp_* ref to put the copy in; else beside the original\",\n    };\n  }\n  Object.assign(args, naming, level === \"ad\" ? {} : schedule);\n  return args;\n}\n\nfunction copyCommand(level: Level, input: { family: string; label: string; extra: string }): CommandDef<ArgsDef> {\n  return command({\n    schema: `ads.meta.${input.family}.copy`,\n    name: \"copy\",\n    description: `Stage Meta's own copy of a ${input.label}${level === \"ad\" ? \"\" : \" (with --deep, of everything under it)\"}, paused unless --status. Prints a meta_temp_* ref for the copy that later changes in this chat can name. ${WHEN_TO_COPY}\nExample: ${input.extra}`,\n    schemaDescription: `Stage a copy of a Meta ${input.label} through Meta's copies edge — applied at publish; the copy's ref resolves to its new id.`,\n    args: copyArgs(level, input.label),\n    run: async (args) => {\n      requireTarget(args, input.label);\n      await stageOp({\n        kind: `${level}.copy`,\n        accountId: await bareAccountId(args),\n        payload: copyPayloadFromFlags(level, args),\n      });\n    },\n  });\n}\n\nexport const campaignsCopyCommand = copyCommand(\"campaign\", {\n  family: \"campaigns\",\n  label: \"campaign\",\n  extra: 'baker ads meta campaigns copy 6123 --deep --rename-suffix \" – Q4\" --start 2026-11-01',\n});\nexport const adSetsCopyCommand = copyCommand(\"adSet\", {\n  family: \"adsets\",\n  label: \"ad set\",\n  extra: \"baker ads meta adsets copy 6124 --deep --to-campaign meta_temp_ab12\",\n});\nexport const adsCopyCommand = copyCommand(\"ad\", {\n  family: \"ads\",\n  label: \"ad\",\n  extra: \"baker ads meta ads copy 6125 --to-adset 6130\",\n});\n"],"mappings":"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","names":[]}

package/dist/create-EL47XN73.js

@@ -0,0 +1,135 @@
+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-LJYXGUQ3.js";
+import "./chunk-WR5Y64OE.js";
+import "./chunk-YOHGEF2N.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-IMS53EQU.js";
+import {
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import {
+  requireChatId
+} from "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.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-EL47XN73.js.map