@koda-sl/baker-cli 0.498.0 → 0.500.0

package/dist/create-XKGV6TEW.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-3LFPQSSC.js";
+import "./chunk-ASRS37QE.js";
+import "./chunk-5MSRVAUZ.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-ERSL4WZT.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-XKGV6TEW.js.map

package/dist/create-Y44CPUE4.js

@@ -0,0 +1,208 @@
+import {
+  buildProfilePatch
+} from "./chunk-IJMWEO4P.js";
+import {
+  chatIdFromEnv,
+  creationHints,
+  failAvatarApi,
+  failValidation,
+  parseFaceChoice
+} from "./chunk-OLQSKCMO.js";
+import {
+  writeAvatars
+} from "./chunk-WHBFXR6F.js";
+import {
+  AVATAR_HANDLE_PATTERN
+} from "./chunk-5MSRVAUZ.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-ERSL4WZT.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/avatars/create.ts
+import { defineCommand } from "citty";
+function parseImageIds(value) {
+  if (typeof value !== "string") return void 0;
+  const ids = value.split(",").map((id) => id.trim()).filter((id) => id.length > 0);
+  return ids.length > 0 ? [...new Set(ids)] : void 0;
+}
+registerSchema({
+  command: "avatars.create",
+  description: 'Cast a new avatar \u2014 a reusable AI presenter this company can put in images and video. Start here: `baker avatars create --name "Marta" --subject "woman in her early 40s, shoulder-length dark hair, warm brown eyes, light olive skin"`. --subject is the identity: describe ONE person plainly (age, build, hair, skin, face) with no scene, no lighting and no wardrobe, because it is copied word for word into every prompt that renders them. Two kinds: invented from your description (default), or built from photographs of a real person (--source-image with --likeness-confirmed, which is the company stating it may use that person\'s image in advertising). For a real person the copy NAMES \u2014 a testimonial author, the founder, a team member \u2014 use `baker avatars research "<name>, <role> at <company>" --create` instead: it finds their photos and builds the avatar itself. Returns immediately with status `generating` \u2014 the identity sheet is a ~30s render that settles in the background.',
+  args: {
+    name: { type: "string", description: 'Display name, e.g. "Marta"', required: true },
+    handle: {
+      type: "string",
+      description: 'Mention handle (lowercase, dashes), e.g. "marta". Derived from the name when omitted.',
+      required: false
+    },
+    subject: {
+      type: "string",
+      description: "The identity, reused verbatim in every render: one person, plainly described (age, build, hair, skin, face). No scene, no lighting, no camera, no wardrobe \u2014 those belong in the render prompt or in --wardrobe/--setting.",
+      required: true
+    },
+    persona: { type: "string", description: "Who they are on camera \u2014 role, attitude, energy", required: false },
+    speech: { type: "string", description: "How they speak \u2014 pace, register, verbal habits", required: false },
+    accent: {
+      type: "string",
+      description: `Where their VOICE is from, as a place: 'Spanish from Spain, Madrid accent', 'Mexican Spanish', 'British English, London'. Name the region \u2014 an adjective like 'clear Spanish accent' is read by the video model as NO accent, and the clip comes out sounding like nowhere. Default to the language the USER is writing to you in, always: they are describing an ad for their own market, and an avatar that answers them in another language is unusable however good it looks. Never take this from how the person LOOKS \u2014 'aspecto europeo', 'Nordic', 'Mediterranean' describe a face and belong in --subject. Read literally, that mistake shipped an ad for a Spanish client with --accent "German", and the clip came back spoken in German.`,
+      required: false
+    },
+    motion: { type: "string", description: "Body language and gesture in video", required: false },
+    wardrobe: { type: "string", description: "Default outfit when the brief does not name one", required: false },
+    setting: {
+      type: "string",
+      description: 'Where they are in their own life ("her small kitchen in Madrid on a weekday morning") \u2014 their casting photo is taken there, and renders use it when the brief leaves the surroundings open. Always fill it: a face with no world comes back looking like a studio headshot.',
+      required: false
+    },
+    guardrails: {
+      type: "string",
+      description: 'Comma-separated things this avatar must never do, e.g. "no competitor logos, no medical claims"',
+      required: false
+    },
+    "source-image": {
+      type: "string",
+      description: "Comma-separated library image ids (up to 6) of photographs of a REAL person to build the likeness from. Requires --likeness-confirmed. Source them with `baker images upload`/`library` first.",
+      required: false
+    },
+    "likeness-confirmed": {
+      type: "boolean",
+      description: "The company's statement that it may use this real person's image in advertising. Required with --source-image. Pass it when the user gave you the photos, or the person is someone the company features in its own marketing (its founder, its team, a customer quoted by name) \u2014 that request is the statement; there is no separate question to ask.",
+      required: false
+    },
+    face: {
+      type: "string",
+      description: "Who picks the face, for an invented avatar: 'ask' (default) blocks on the user through `request_avatar_casting`, 'auto' keeps the one this build casts and asks nobody. Use 'auto' only when there is no one to answer \u2014 a Schedule, a batch, an explicit \"do it yourself\" \u2014 because a person who is there almost always wants this choice.",
+      required: false
+    },
+    output: {
+      type: "string",
+      description: "Output format. Only `json`, which is what this returns anyway \u2014 accepted because `avatars list` and `avatars get` take it, so reaching for it here is the obvious guess.",
+      required: false,
+      default: "json"
+    }
+  }
+});
+var createCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: 'Cast a new avatar (reusable AI presenter). Example: baker avatars create --name "Marta" --subject "woman in her early 40s, shoulder-length dark hair, light olive skin, warm open face" --persona "friendly product expert". Returns while the identity sheet is still building.'
+  },
+  args: {
+    name: { type: "string", description: "Display name", required: false },
+    handle: { type: "string", description: "Mention handle (derived from the name when omitted)", required: false },
+    subject: { type: "string", description: "The person, plainly described \u2014 reused verbatim", required: false },
+    persona: { type: "string", description: "Who they are on camera", required: false },
+    speech: { type: "string", description: "How they speak", required: false },
+    accent: {
+      type: "string",
+      description: "Where their voice is FROM \u2014 name the region, e.g. 'Spanish from Spain, Madrid accent'",
+      required: false
+    },
+    motion: { type: "string", description: "Body language in video", required: false },
+    wardrobe: { type: "string", description: "Default outfit", required: false },
+    setting: { type: "string", description: "Default surroundings", required: false },
+    guardrails: { type: "string", description: "Comma-separated things they must never do", required: false },
+    "source-image": {
+      type: "string",
+      description: "Comma-separated library image ids of a real person (needs --likeness-confirmed)",
+      required: false
+    },
+    "likeness-confirmed": {
+      type: "boolean",
+      description: "The company may use this real person's image in advertising",
+      required: false,
+      default: false
+    },
+    face: {
+      type: "string",
+      description: "Who picks the face of an invented avatar: 'ask' (default, blocks on the user) or 'auto' (asks nobody)",
+      required: false
+    },
+    output: {
+      type: "string",
+      description: "Output format \u2014 `json` only, which is what this returns anyway",
+      required: false,
+      default: "json"
+    }
+  },
+  run: async ({ args }) => {
+    const name = args.name?.trim();
+    if (!name) {
+      failValidation('--name is required, e.g. `baker avatars create --name "Marta" --subject "\u2026"`.');
+    }
+    const profile = buildProfilePatch(args);
+    const subjectDescription = profile.subjectDescription;
+    if (!subjectDescription) {
+      failValidation(
+        "--subject is required: it is the identity every render of this avatar is built from, and it is copied into each prompt word for word.",
+        {
+          action: "describe_the_person",
+          explanation: 'Write one person, plainly: age range, build, hair, skin, face, anything distinctive. No scene, no lighting, no camera, no wardrobe. Good: "woman in her early 40s, shoulder-length dark brown hair, light olive skin, warm open face, slight smile lines". Bad: "confident businesswoman in a sunlit office". If the user described a real person and you have their photos, pass --source-image with --likeness-confirmed instead of inventing the description; if they are named but you have no photos, run `baker avatars research "<name>, <role> at <company>" --create`.'
+        }
+      );
+    }
+    const handle = args.handle?.trim().toLowerCase();
+    if (handle && !AVATAR_HANDLE_PATTERN.test(handle)) {
+      failValidation(
+        `--handle "${handle}" is not usable. Use lowercase letters, numbers and dashes, starting with a letter \u2014 "maria-founder", not "Maria Founder". Leave it off to have one derived from the name.`
+      );
+    }
+    const output = args.output?.trim().toLowerCase();
+    if (output && output !== "json") {
+      failValidation(
+        `\`--output ${output}\` is not a format \`baker avatars create\` produces \u2014 it returns JSON and nothing else. Drop the flag, or pass \`--output json\`. \`baker avatars list\` and \`baker avatars get\` are the ones that also render \`files\` and \`md\`.`
+      );
+    }
+    const faceChoice = parseFaceChoice(args.face);
+    if (faceChoice === null) {
+      failValidation(
+        `--face "${String(args.face)}" is not a mode. Use --face ask to let the user pick the face, or --face auto to keep the one this build casts.`,
+        {
+          action: "pick_a_mode",
+          explanation: "Drop the flag entirely if a person is in the conversation \u2014 that is --face ask, and it is what they almost always want. Pass --face auto only when nobody is there to answer: a Schedule, a batch run, or the user telling you to do it without them."
+        }
+      );
+    }
+    const sourceImageIds = parseImageIds(args["source-image"]);
+    const likenessConfirmed = Boolean(args["likeness-confirmed"]);
+    if (sourceImageIds && !likenessConfirmed) {
+      failValidation(
+        "Building an avatar from photographs of a real person needs --likeness-confirmed: the company has to state that it may use that person's image in its advertising.",
+        {
+          action: "confirm_the_likeness",
+          explanation: 'Photos the user handed you, or of someone the company features in its own marketing (its founder, its team, a customer it quotes by name), come with that statement: re-run the same command with --likeness-confirmed. If the person is named in the copy and you have no photos, use `baker avatars research "<name>, <role> at <company>" --create` instead. Only if the user said they may NOT use this person\'s image, drop --source-image and cast an invented presenter from --subject \u2014 do not abandon the wider job over it.'
+        }
+      );
+    }
+    try {
+      const body = {
+        name,
+        ...handle ? { handle } : {},
+        profile: { ...profile, subjectDescription },
+        ...sourceImageIds ? { sourceImageIds, likenessConfirmed: true } : {},
+        ...chatIdFromEnv() ? { chatId: chatIdFromEnv() } : {},
+        // Sent so the backend can hold the sheet until the chosen portrait exists —
+        // otherwise it fuses one from a face nobody picked and pays for it twice.
+        faceChoice
+      };
+      const data = await writeAvatars("/api/avatars", body);
+      writeJson({ ok: true, data, hints: creationHints({ ...data, faceChoice }, body.profile) });
+    } catch (err) {
+      failAvatarApi(err, handle);
+    }
+  }
+});
+export {
+  createCommand
+};
+//# sourceMappingURL=create-Y44CPUE4.js.map

package/dist/creatives-P5MX2AZL.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-FSVESR44.js").then((m) => m.briefCommand),
+    ideas: () => import("./ideas-S2UXZSFB.js").then((m) => m.ideasCommand),
+    make: () => import("./make-GLGNEOK6.js").then((m) => m.makeCommand),
+    translate: () => import("./translate-7W7O6W3J.js").then((m) => m.translateCommand),
+    learn: () => import("./learn-POJ5ORBK.js").then((m) => m.learnCommand),
+    feedback: () => import("./feedback-UDTPDCMS.js").then((m) => m.feedbackCommand),
+    rules: () => import("./rules-Y3BH7SO5.js").then((m) => m.rulesCommand),
+    check: () => import("./check-TA3HM2QA.js").then((m) => m.checkCommand),
+    select: () => import("./select-QSGZYOFV.js").then((m) => m.selectCommand),
+    publish: () => import("./publish-H7UGB5IP.js").then((m) => m.publishCommand),
+    performance: () => import("./performance-PIB2AXKO.js").then((m) => m.performanceCommand)
+  }
+});
+export {
+  creativesCommand
+};
+//# sourceMappingURL=creatives-P5MX2AZL.js.map

package/dist/creatives-RF3AG7HW.js

@@ -0,0 +1,89 @@
+import {
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-B2POVFR2.js";
+import "./chunk-Y2JZX6JB.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-AGBBTTKA.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/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-S7AX24WF.js").then((m) => m.adCreativesCreateCommand),
+    update: () => import("./write-commands-S7AX24WF.js").then((m) => m.adCreativesUpdateCommand),
+    delete: () => import("./asset-writes-IE3HUPWM.js").then((m) => m.creativesDeleteCommand)
+  },
+  // `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-RF3AG7HW.js.map