@koda-sl/baker-cli 0.510.0 → 0.511.0-dev.2d26314a2

package/dist/create-WFQJ4INC.js

@@ -0,0 +1,133 @@
+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-UUCFUACM.js";
+import "./chunk-ASRS37QE.js";
+import "./chunk-4CNR3MNJ.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-HNNCAJNF.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  requireChatId
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.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-WFQJ4INC.js.map

package/dist/creatives-GUB46RDL.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-K4VBTIE7.js").then((m) => m.briefCommand),
+    ideas: () => import("./ideas-3U3A4EN6.js").then((m) => m.ideasCommand),
+    make: () => import("./make-LQCMYG5L.js").then((m) => m.makeCommand),
+    translate: () => import("./translate-BBL55D4V.js").then((m) => m.translateCommand),
+    learn: () => import("./learn-BWUPJSSS.js").then((m) => m.learnCommand),
+    feedback: () => import("./feedback-YUNGXAZX.js").then((m) => m.feedbackCommand),
+    rules: () => import("./rules-6HFOBVKB.js").then((m) => m.rulesCommand),
+    check: () => import("./check-NTXU4MFW.js").then((m) => m.checkCommand),
+    select: () => import("./select-56BHOXBY.js").then((m) => m.selectCommand),
+    publish: () => import("./publish-4NGQYOBU.js").then((m) => m.publishCommand),
+    performance: () => import("./performance-3XVX6WRF.js").then((m) => m.performanceCommand)
+  }
+});
+export {
+  creativesCommand
+};
+//# sourceMappingURL=creatives-GUB46RDL.js.map

package/dist/creatives-QHV5PM2O.js

@@ -0,0 +1,221 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg,
+  resolveStatusFilter,
+  statusesArgDescription
+} from "./chunk-LOQYUZ5H.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-AGBBTTKA.js";
+import {
+  shapeListRows
+} from "./chunk-65Y3RCWP.js";
+import "./chunk-4CNR3MNJ.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-HNNCAJNF.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.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-XKW222IN.js").then((m) => m.creativesCreateCommand),
+    update: () => import("./write-commands-XKW222IN.js").then((m) => m.creativesUpdateCommand),
+    pause: () => import("./write-commands-XKW222IN.js").then((m) => m.creativesPauseCommand),
+    resume: () => import("./write-commands-XKW222IN.js").then((m) => m.creativesResumeCommand),
+    duplicate: () => import("./write-commands-XKW222IN.js").then((m) => m.creativesDuplicateCommand),
+    delete: () => import("./write-commands-XKW222IN.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-QHV5PM2O.js.map