@koda-sl/baker-cli 0.570.0 → 0.571.0-dev.6a3439a0a

package/dist/create-FDNMIVFX.js

@@ -0,0 +1,62 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-YAINUFSC.js";
+import "./chunk-6DSPB6YA.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-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/tags/create.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.tags.create",
+  description: "Create a company custom action tag, minting a new slug usable with --tags. The name is slugified (lowercased, spaces\u2192hyphens). Use when no existing tag fits the work.",
+  args: {
+    slug: { type: "string", description: "Tag name/slug (e.g. pmax, retargeting)", required: true },
+    description: { type: "string", description: "What this tag means", required: false }
+  }
+});
+var tagsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: 'Create a custom action tag. Example: baker actions tags create --slug pmax --description "Performance Max work"'
+  },
+  args: {
+    slug: { type: "string", description: "Tag name/slug", required: false },
+    description: { type: "string", description: "Description", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const slug = args.slug;
+      if (!slug || slug.trim().length === 0) {
+        failValidation("--slug is required.");
+      }
+      const response = await apiPost("/api/actions/tags/create", {
+        name: slug,
+        description: args.description
+      });
+      writeOk(response.data);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  tagsCreateCommand
+};
+//# sourceMappingURL=create-FDNMIVFX.js.map

package/dist/create-X2QM7GA7.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-3KUNRKNV.js";
+import "./chunk-XA76OGSL.js";
+import "./chunk-6DSPB6YA.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-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import {
+  requireChatId
+} from "./chunk-B64KJW5C.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NXNOXZGB.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-X2QM7GA7.js.map

package/dist/creatives-K2AAW6EL.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-6DV2PKAU.js").then((m) => m.briefCommand),
+    ideas: () => import("./ideas-SMSEXKIA.js").then((m) => m.ideasCommand),
+    make: () => import("./make-QAFKU6WO.js").then((m) => m.makeCommand),
+    translate: () => import("./translate-WKOXFZTQ.js").then((m) => m.translateCommand),
+    learn: () => import("./learn-BESXWXEN.js").then((m) => m.learnCommand),
+    feedback: () => import("./feedback-WAC6S42V.js").then((m) => m.feedbackCommand),
+    rules: () => import("./rules-66IGR2KA.js").then((m) => m.rulesCommand),
+    check: () => import("./check-BOKLY5WG.js").then((m) => m.checkCommand),
+    select: () => import("./select-5ZD7FVBT.js").then((m) => m.selectCommand),
+    publish: () => import("./publish-S2Z4EF4H.js").then((m) => m.publishCommand),
+    performance: () => import("./performance-HYSTXLTS.js").then((m) => m.performanceCommand)
+  }
+});
+export {
+  creativesCommand
+};
+//# sourceMappingURL=creatives-K2AAW6EL.js.map

package/dist/creatives-SNYN4KIM.js

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