@koda-sl/baker-cli 0.510.0 → 0.512.0-dev.8a743a629

package/dist/chunk-IZABOTZR.js

@@ -0,0 +1,429 @@
+import {
+  agentProfile
+} from "./chunk-ASRS37QE.js";
+import {
+  AUTO_PUBLISH_REFUSAL,
+  MAX_AI_CONDITION_CHARS,
+  TRIGGER_KINDS,
+  TRIGGER_KIND_IDS,
+  TRIGGER_TARGETS,
+  TRIGGER_TARGET_FIELDS,
+  TRIGGER_TARGET_FIELD_IDS,
+  firstTimes,
+  isTriggerKind,
+  parseConditionsExpression
+} from "./chunk-7D7YRHN3.js";
+import {
+  ApiError,
+  validateConvexId
+} from "./chunk-X7VQFLHI.js";
+import {
+  getEnv
+} from "./chunk-LGK7UWBN.js";
+import {
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+
+// src/commands/scheduled-agents/shared.ts
+var TEMP_SCHEDULED_AGENT_PREFIX = "temp_agent_";
+var TEMP_ID_PREFIX = "temp_";
+function writeOk(data, hints) {
+  writeJson({ ok: true, data: data ?? null, ...hints && hints.length > 0 ? { hints } : {} });
+}
+function failValidation(message) {
+  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function failApi(err) {
+  if (err instanceof ApiError) {
+    writeJson({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  if (err instanceof Error) {
+    writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: err.message } });
+    process.exit(1);
+  }
+  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+var AUTO_PUBLISH_ARG = {
+  "auto-publish": {
+    type: "string",
+    description: "Not available to the agent: publishing every run unreviewed is switched on by the user, on the item, after this chat is published. Passing it is refused and tells you what to ask them.",
+    required: false
+  }
+};
+function refuseAutoPublish(args) {
+  if (args["auto-publish"] === void 0) {
+    return;
+  }
+  writeJson({
+    ok: false,
+    error: {
+      code: "FORBIDDEN",
+      message: AUTO_PUBLISH_REFUSAL,
+      fix: {
+        action: "ask_user",
+        explanation: 'Run the command again without --auto-publish. After this chat is published, ask the user to open the item in Scheduled agents and switch on "Publish its work on its own" under "When a run finishes" \u2014 until then each run waits for their review.'
+      }
+    }
+  });
+  process.exit(1);
+}
+function isTempScheduledAgentId(id) {
+  return id.startsWith(TEMP_SCHEDULED_AGENT_PREFIX);
+}
+function isOtherTempId(id) {
+  return id.startsWith(TEMP_ID_PREFIX) && !isTempScheduledAgentId(id);
+}
+function validateScheduledAgentRef(ref) {
+  if (isOtherTempId(ref)) {
+    failValidation(`Scheduled agent temp IDs must start with ${TEMP_SCHEDULED_AGENT_PREFIX}.`);
+  }
+  if (!isTempScheduledAgentId(ref)) {
+    validateConvexId(ref);
+  }
+}
+var TRIGGER_ARG_DESCRIPTION = `What makes this run. ${TRIGGER_KIND_IDS.map(
+  (id) => `${id}: ${TRIGGER_KINDS[id].description}`
+).join(" ")} For the two time ones, pass --cron or --run-at instead and the kind is implied.`;
+var TRIGGER_KIND_LIST = [...TRIGGER_KIND_IDS];
+var NARROWING_DESCRIPTIONS = {
+  eventName: "With --trigger event.received: only this event name (a source's name, or one your site sends). Omit it to run on any event.",
+  toolkit: "With --trigger app.event (required): the connected tool, by its slug \u2014 gmail, slack, googlesheets.",
+  account: "With --trigger app.event (required): which connected account of that tool, by id (a tool can be connected more than once).",
+  appEvent: "With --trigger app.event (required): what happens in the tool, by the tool's own id \u2014 GMAIL_NEW_GMAIL_MESSAGE. `targets --field appEvent --app <tool>` lists them with the settings each needs.",
+  provider: "With --trigger connection.created, connection.removed or connection.needs_reconnect: only this tool (google-ads, hubspot, meta, or a connected tool's slug such as slack). Omit it for any tool.",
+  flowId: "With --trigger form.submitted or flow.step.submitted: which Form, by slug. Omit it on form.submitted for any Form.",
+  stepId: "With --trigger flow.step.submitted: which step of that Form, by id \u2014 `targets --field stepId --form <slug>` lists them by name.",
+  page: "With --trigger landing.created or landing.published: only this page, by slug. Omit it for any page.",
+  tag: "With --trigger task.created, task.claimed, task.completed, landing.created or landing.published: only ones carrying this tag. Omit it for any.",
+  experimentId: 'With --trigger experiment.decided, experiment.ended or experiment.concluded: only this test. Omit it for any test. Not for experiment.started \u2014 narrow that with --when "page = <page>".',
+  taskId: "With --trigger task.claimed or task.completed: only this Task, by id (a temp_ id of a Task staged in this chat works too). Omit it for any Task.",
+  agentId: "With --trigger session.published, session.publish_failed or session.publish_incomplete: only the runs of this scheduled agent, by id (a temp_agent_ id staged in this chat works too). Omit it for any agent's work.",
+  platform: "With --trigger session.publish_incomplete: only when this platform's changes did not all land \u2014 google-ads, meta-ads, linkedin-ads, x-ads, chatgpt-ads, tag-manager, ga4 or shopify. Omit it for any.",
+  collection: "With --trigger knowledge.updated: only this Knowledge collection. Omit it for any of them.",
+  sourceId: "With --trigger review.received: only reviews from this review source, by id. Omit it for any source.",
+  advertiserId: "With --trigger advertiser.new_ads: only this followed advertiser, by id. Omit it for any of them.",
+  adAccount: "With --trigger ad_alert.opened, ad_alert.claimed, ad_alert.fixed or ad_alert.closed: only alerts on this ad account, as <platform>:<ad account id> (meta:123). Omit it for any account.",
+  alertRule: 'With --trigger ad_alert.opened, ad_alert.claimed, ad_alert.fixed or ad_alert.closed: only this kind of alert, by the rule `baker ads performance attention` names (budget_cut, efficiency_degraded, tracking_broke). Omit it for any. Narrow by severity with --when "severity = critical".',
+  socialAccount: "With --trigger social.post_published: only posts by this followed account, by its key (linkedin:in/jacintofleta, instagram:nike \u2014 `baker media-sources list`). Omit it for any account.",
+  personRole: "With --trigger social.post_published: only posts by people with this role \u2014 ceo, founder, cto, cmo, head_of_sales, sales, marketing, employee, creator. Omit it for any account, pages included."
+};
+var NARROWING_ARGS = {
+  ...Object.fromEntries(
+    TRIGGER_TARGET_FIELD_IDS.map((field) => [
+      TRIGGER_TARGET_FIELDS[field].flag,
+      {
+        type: "string",
+        description: `${NARROWING_DESCRIPTIONS[field]} \`baker scheduled-agents targets --trigger <kind> --field ${field}\` lists the values.`,
+        required: false
+      }
+    ])
+  ),
+  config: {
+    type: "string",
+    description: `With --trigger app.event: the event's own settings as a JSON object \u2014 they filter inside the tool, before anything is sent. A Gmail search ('{"query":"from:ana@acme.com"}'), a label, a Slack channel, a GitHub repository ('{"owner":"acme","repo":"site"}'). \`targets --field appEvent --app <tool> --event <id>\` lists each setting with its examples.`,
+    required: false
+  }
+};
+function validateRunAt(runAt) {
+  if (!runAt.endsWith("Z")) {
+    failValidation("--run-at must be an ISO UTC timestamp ending in Z.");
+  }
+  const parsed = Date.parse(runAt);
+  if (!Number.isFinite(parsed)) {
+    failValidation("--run-at must be a valid ISO timestamp.");
+  }
+  if (parsed <= Date.now()) {
+    failValidation(
+      `--run-at ${runAt} has already passed. A one-off item only runs at a time still to come \u2014 pass a later ISO UTC timestamp, and check which timezone you converted from if you worked it out from a local time.`
+    );
+  }
+}
+function buildTriggerBody(args, options) {
+  const cron = args.cron;
+  const runAt = args["run-at"];
+  const timezone = args.timezone;
+  const kind = args.trigger;
+  const given = [cron, runAt, kind].filter(Boolean).length;
+  if (given > 1) {
+    failValidation("--cron, --run-at and --trigger are mutually exclusive.");
+  }
+  refuseNarrowingWithoutKind(args, kind, given);
+  if (runAt) {
+    validateRunAt(runAt);
+    return { runAt, ...timezone ? { timezone } : {} };
+  }
+  if (cron) {
+    return { cron, ...timezone ? { timezone } : {} };
+  }
+  if (kind) {
+    return { trigger: triggerFromFlags(kind, args), ...timezone ? { timezone } : {} };
+  }
+  if (timezone && !options.required) {
+    return { timezone };
+  }
+  if (options.required) {
+    failValidation(
+      `A trigger is required. Pass --cron or --run-at for a time-based one, or --trigger with one of: ${TRIGGER_KIND_IDS.join(", ")}.`
+    );
+  }
+  return void 0;
+}
+function flagText(args, key) {
+  const value = args[key];
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function refuseMisusedKinds(kind, args) {
+  if (kind === "time.once") {
+    failValidation("Use --run-at for a one-off, rather than --trigger time.once.");
+  }
+  if (kind === "time.cron") {
+    failValidation("Use --cron for a repeating schedule, rather than --trigger time.cron.");
+  }
+  if (kind === "experiment.started" && flagText(args, "experiment")) {
+    failValidation(
+      'A test that exists has already started, so --experiment never fires on experiment.started. Leave it off and add --when "page = <page>" to watch one page.'
+    );
+  }
+}
+function refuseStrayFlags(kind, args) {
+  const allowed = new Set(TRIGGER_TARGETS[kind].map((target) => TRIGGER_TARGET_FIELDS[target.field].flag));
+  const stray = TRIGGER_TARGET_FIELD_IDS.map((field) => TRIGGER_TARGET_FIELDS[field].flag).filter(
+    (flag) => !allowed.has(flag) && flagText(args, flag) !== void 0 && !(kind === "experiment.started" && flag === "experiment")
+  );
+  if (stray.length === 0) {
+    return;
+  }
+  failValidation(
+    `${stray.map((flag) => `--${flag}`).join(", ")} does not narrow ${kind}. ${allowed.size > 0 ? `It can be pointed with ${[...allowed].map((flag) => `--${flag}`).join(", ")}.` : "It runs every time it happens \u2014 narrow it with --when rules over its payload instead."}`
+  );
+}
+var NARROWING_FLAGS = [...TRIGGER_TARGET_FIELD_IDS.map((field) => TRIGGER_TARGET_FIELDS[field].flag), "config"];
+function refuseNarrowingWithoutKind(args, kind, given) {
+  if (kind) {
+    return;
+  }
+  const stray = NARROWING_FLAGS.filter((flag) => flagText(args, flag) !== void 0);
+  if (stray.length === 0) {
+    return;
+  }
+  const flags = stray.map((flag) => `--${flag}`).join(", ");
+  failValidation(
+    given > 0 ? `${flags} does not narrow --cron or --run-at: a time trigger runs every time it comes round. Use --trigger <kind> with ${flags} instead, or leave ${flags} off.` : `${flags} narrows a trigger, and no trigger was given. Pass --trigger <kind> too \u2014 the item's whole trigger, with ${flags} \u2014 or leave ${flags} off.`
+  );
+}
+function configFromFlag(kind, args) {
+  const config = flagText(args, "config");
+  if (!config) {
+    return {};
+  }
+  if (kind !== "app.event") {
+    failValidation("--config is only for --trigger app.event: the settings of what happens in the tool.");
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(config);
+  } catch {
+    parsed = null;
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    failValidation(`--config must be a JSON object, e.g. '{"labelIds":"INBOX"}'.`);
+  }
+  return { configJson: config };
+}
+function withoutMetaActPrefix(adAccount) {
+  return adAccount.replace(/^meta:act_/i, "meta:");
+}
+function triggerFromFlags(kind, args) {
+  if (!isTriggerKind(kind)) {
+    failValidation(`--trigger must be one of: ${TRIGGER_KIND_IDS.join(", ")}.`);
+  }
+  refuseMisusedKinds(kind, args);
+  refuseStrayFlags(kind, args);
+  const narrowings = {};
+  for (const { field, required } of TRIGGER_TARGETS[kind]) {
+    const value = flagText(args, TRIGGER_TARGET_FIELDS[field].flag);
+    if (value) {
+      narrowings[field] = field === "adAccount" ? withoutMetaActPrefix(value) : value;
+    } else if (required) {
+      failValidation(
+        `--trigger ${kind} needs --${TRIGGER_TARGET_FIELDS[field].flag}. \`baker scheduled-agents targets --trigger ${kind} --field ${field}\` lists what it can be.`
+      );
+    }
+  }
+  return { kind, ...narrowings, ...configFromFlag(kind, args) };
+}
+function parseOccurrences(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  if (typeof raw !== "string") {
+    failValidation("--occurrences must be a comma-separated list of whole numbers, e.g. 1 or 1,3.");
+  }
+  const parts = raw.split(",").map((part) => part.trim()).filter((part) => part.length > 0);
+  const numbers = parts.map((part) => Number(part));
+  if (numbers.length === 0 || numbers.some((n) => !Number.isInteger(n) || n <= 0)) {
+    failValidation("--occurrences must be a comma-separated list of whole numbers above zero, e.g. 1 or 1,3.");
+  }
+  return numbers;
+}
+function parseBooleanFlag(raw, flagName) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  if (raw === true || raw === "true") {
+    return true;
+  }
+  if (raw === false || raw === "false") {
+    return false;
+  }
+  failValidation(`${flagName} must be true or false.`);
+}
+var REACTION_ARGS = {
+  when: {
+    type: "string",
+    description: "Only run when what arrived passes these rules: `<field> <operator> <value>` joined by AND or by OR (either case). Fields are the trigger's payload fields (`baker scheduled-agents triggers --trigger <kind>` lists them; a webhook's are whatever was posted; an app.event's are what `targets --field appEvent --app <tool> --event <id>` says it sends). Operators: =, !=, contains, does not contain, starts with, ends with, >, <, >=, <=, in (comma list), exists, missing. Example: --when \"deal.stage = won AND amount > 10000\". A payload that fails is not counted and starts nothing. `none` clears the rules.",
+    required: false
+  },
+  "ai-check": {
+    type: "string",
+    description: 'Only run when AI judges that what arrived meets this condition, in plain words \u2014 for what no --when rule can say: --ai-check "the person writes on behalf of a company, not as a student or for personal use". Checked after --when, on what passed it; a turned-down arrival is not counted and starts nothing, and shows in `history` with its score. Say the boundary cases ("a freelancer counts as a company"). Emails and phones are hidden from it, as from the run \u2014 an email domain is a --when rule. Not for a time-based start (--cron, --run-at). `none` removes it.',
+    required: false
+  },
+  times: {
+    type: "string",
+    description: "Only the first N times it fires (and its --when rules pass), then never again. `--times 1` is only the first time. Shorthand for --occurrences 1,2,\u2026,N.",
+    required: false
+  },
+  payload: {
+    type: "string",
+    description: "include (default) or omit. Whether the run's first message carries what arrived \u2014 the posted body, the event's properties, the Form's answers (emails and phones masked). Place single values in --prompt with {{payload.<field>}} instead; those are filled either way.",
+    required: false
+  },
+  cooldown: {
+    type: "string",
+    description: "At most one run per this many minutes, however often it fires. 0 removes it.",
+    required: false
+  }
+};
+var SLACK_ARG = {
+  slack: {
+    type: "string",
+    description: "Tell each run in Slack: `here` (the Slack conversation this chat came from), `me` (a direct message to the person in this chat), `#channel` (a channel linked to this company), or `off`. Each run opens its own thread there and Baker reports on it: what it found, what it needs, whether to publish.",
+    required: false
+  }
+};
+function companiesArg(profile = agentProfile()) {
+  return profile === "organization" ? {
+    companies: {
+      type: "string",
+      description: "The companies whose events it hears, by id, comma-separated (`baker organization companies` lists them), or `all`. Left out, it hears every company, including ones added later. Only on a trigger that happens in a company; one company's Form, page or tag is a --when rule instead.",
+      required: false
+    }
+  } : {};
+}
+function companiesBody(args) {
+  return typeof args.companies === "string" && args.companies.trim().length > 0 ? { companies: args.companies.trim() } : {};
+}
+function slackBody(args) {
+  return typeof args.slack === "string" && args.slack.trim().length > 0 ? { slack: args.slack.trim() } : {};
+}
+function wholeNumber(raw, flag, { min }) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  const value = Number(raw);
+  if (!Number.isInteger(value) || value < min) {
+    failValidation(`${flag} must be a whole number of at least ${min}.`);
+  }
+  return value;
+}
+function reactionBody(args) {
+  const occurrences = occurrencesFromFlags(args);
+  const when = whenFromFlag(args.when);
+  const includePayload = payloadFromFlag(args.payload);
+  const cooldownMinutes = wholeNumber(args.cooldown, "--cooldown", { min: 0 });
+  const aiCondition = aiCheckFromFlag(args["ai-check"]);
+  return {
+    ...occurrences !== void 0 ? { occurrences } : {},
+    ...when !== void 0 ? { when } : {},
+    ...aiCondition !== void 0 ? { aiCondition } : {},
+    ...includePayload !== void 0 ? { includePayload } : {},
+    ...cooldownMinutes !== void 0 ? { cooldownMinutes } : {}
+  };
+}
+function occurrencesFromFlags(args) {
+  const times = wholeNumber(args.times, "--times", { min: 1 });
+  const occurrences = parseOccurrences(args.occurrences);
+  if (times !== void 0 && occurrences !== void 0) {
+    failValidation("Pass --times or --occurrences, not both \u2014 --times 3 is --occurrences 1,2,3.");
+  }
+  return times !== void 0 ? firstTimes(times) : occurrences;
+}
+function whenFromFlag(raw) {
+  if (typeof raw !== "string") {
+    return void 0;
+  }
+  const text = raw.trim();
+  if (text.length === 0 || text.toLowerCase() === "none") {
+    return "none";
+  }
+  const parsed = parseConditionsExpression(text);
+  if (!parsed.ok) {
+    failValidation(parsed.error);
+  }
+  return text;
+}
+function aiCheckFromFlag(raw) {
+  if (typeof raw !== "string") {
+    return void 0;
+  }
+  const text = raw.trim();
+  if (text.length === 0 || text.toLowerCase() === "none") {
+    return "none";
+  }
+  if (text.length > MAX_AI_CONDITION_CHARS) {
+    failValidation(
+      `--ai-check is at most ${MAX_AI_CONDITION_CHARS} characters: say the condition, not the job. The job goes in --prompt.`
+    );
+  }
+  return text;
+}
+function payloadFromFlag(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  if (raw !== "include" && raw !== "omit") {
+    failValidation("--payload must be include or omit.");
+  }
+  return raw === "include";
+}
+function chatBody() {
+  const id = getEnv().BAKER_CHAT_ID;
+  return id ? { chatId: id } : {};
+}
+
+export {
+  writeOk,
+  failValidation,
+  failApi,
+  AUTO_PUBLISH_ARG,
+  refuseAutoPublish,
+  isTempScheduledAgentId,
+  validateScheduledAgentRef,
+  TRIGGER_ARG_DESCRIPTION,
+  TRIGGER_KIND_LIST,
+  NARROWING_ARGS,
+  buildTriggerBody,
+  parseBooleanFlag,
+  REACTION_ARGS,
+  SLACK_ARG,
+  companiesArg,
+  companiesBody,
+  slackBody,
+  reactionBody,
+  chatBody
+};
+//# sourceMappingURL=chunk-IZABOTZR.js.map

package/dist/chunk-IZABOTZR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/scheduled-agents/shared.ts"],"sourcesContent":["import {\n  AUTO_PUBLISH_REFUSAL,\n  firstTimes,\n  isTriggerKind,\n  MAX_AI_CONDITION_CHARS,\n  parseConditionsExpression,\n  TRIGGER_KIND_IDS,\n  TRIGGER_KINDS,\n  TRIGGER_TARGET_FIELD_IDS,\n  TRIGGER_TARGET_FIELDS,\n  TRIGGER_TARGETS,\n  type TriggerKind,\n  type TriggerTargetField,\n} from \"@baker/api\";\nimport { type AgentProfile, agentProfile } from \"../../agent-profile.ts\";\nimport { ApiError, validateConvexId } from \"../../client.ts\";\nimport { getEnv } from \"../../env.ts\";\nimport { writeJson } from \"../../output.ts\";\n\nconst TEMP_SCHEDULED_AGENT_PREFIX = \"temp_agent_\";\nconst TEMP_ID_PREFIX = \"temp_\";\n\nexport function writeOk<T = null>(data?: T, hints?: string[]): void {\n  writeJson({ ok: true, data: (data ?? null) as T, ...(hints && hints.length > 0 ? { hints } : {}) });\n}\n\nexport function failValidation(message: string): never {\n  writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message } });\n  process.exit(1);\n}\n\nexport function failApi(err: unknown): never {\n  if (err instanceof ApiError) {\n    writeJson({ ok: false, error: { code: err.code, message: err.message } });\n    process.exit(1);\n  }\n  if (err instanceof Error) {\n    writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: err.message } });\n    process.exit(1);\n  }\n  writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n  process.exit(1);\n}\n\n/**\n * `--auto-publish`, declared only to be refused. The dashboard's \"Publish its\n * work on its own\" is a standing authorization only a person can grant, and\n * citty drops a flag it does not declare — an agent asking for it would stage\n * the item and believe the switch was on.\n */\nexport const AUTO_PUBLISH_ARG = {\n  \"auto-publish\": {\n    type: \"string\" as const,\n    description:\n      \"Not available to the agent: publishing every run unreviewed is switched on by the user, on the item, after this chat is published. Passing it is refused and tells you what to ask them.\",\n    required: false,\n  },\n};\n\nexport function refuseAutoPublish(args: Record<string, unknown>): void {\n  if (args[\"auto-publish\"] === undefined) {\n    return;\n  }\n  writeJson({\n    ok: false,\n    error: {\n      code: \"FORBIDDEN\",\n      message: AUTO_PUBLISH_REFUSAL,\n      fix: {\n        action: \"ask_user\",\n        explanation:\n          'Run the command again without --auto-publish. After this chat is published, ask the user to open the item in Scheduled agents and switch on \"Publish its work on its own\" under \"When a run finishes\" — until then each run waits for their review.',\n      },\n    },\n  });\n  process.exit(1);\n}\n\nexport function isTempScheduledAgentId(id: string): boolean {\n  return id.startsWith(TEMP_SCHEDULED_AGENT_PREFIX);\n}\n\nfunction isOtherTempId(id: string): boolean {\n  return id.startsWith(TEMP_ID_PREFIX) && !isTempScheduledAgentId(id);\n}\n\nexport function validateScheduledAgentRef(ref: string): void {\n  if (isOtherTempId(ref)) {\n    failValidation(`Scheduled agent temp IDs must start with ${TEMP_SCHEDULED_AGENT_PREFIX}.`);\n  }\n  if (!isTempScheduledAgentId(ref)) {\n    validateConvexId(ref);\n  }\n}\n\n/**\n * Every trigger, named for the agent reading `--help` or `baker schema`.\n *\n * Built from `@baker/api`, which the backend and the dashboard read too, so the\n * wording the CLI puts in front of the agent is the wording the product puts in\n * front of the marketer. The CLI kept a hand-copy of the old modes for exactly\n * one release and it had already drifted.\n */\nexport const TRIGGER_ARG_DESCRIPTION = `What makes this run. ${TRIGGER_KIND_IDS.map(\n  (id) => `${id}: ${TRIGGER_KINDS[id].description}`,\n).join(\" \")} For the two time ones, pass --cron or --run-at instead and the kind is implied.`;\n\nexport const TRIGGER_KIND_LIST = [...TRIGGER_KIND_IDS];\n\n/**\n * The narrowing flags, in one place because `create` and `update` both take all\n * of them and a flag added to one and not the other is a trigger an agent can\n * set and then never change.\n */\nconst NARROWING_DESCRIPTIONS: Record<TriggerTargetField, string> = {\n  eventName:\n    \"With --trigger event.received: only this event name (a source's name, or one your site sends). Omit it to run on any event.\",\n  toolkit: \"With --trigger app.event (required): the connected tool, by its slug — gmail, slack, googlesheets.\",\n  account:\n    \"With --trigger app.event (required): which connected account of that tool, by id (a tool can be connected more than once).\",\n  appEvent:\n    \"With --trigger app.event (required): what happens in the tool, by the tool's own id — GMAIL_NEW_GMAIL_MESSAGE. `targets --field appEvent --app <tool>` lists them with the settings each needs.\",\n  provider:\n    \"With --trigger connection.created, connection.removed or connection.needs_reconnect: only this tool (google-ads, hubspot, meta, or a connected tool's slug such as slack). Omit it for any tool.\",\n  flowId:\n    \"With --trigger form.submitted or flow.step.submitted: which Form, by slug. Omit it on form.submitted for any Form.\",\n  stepId:\n    \"With --trigger flow.step.submitted: which step of that Form, by id — `targets --field stepId --form <slug>` lists them by name.\",\n  page: \"With --trigger landing.created or landing.published: only this page, by slug. Omit it for any page.\",\n  tag: \"With --trigger task.created, task.claimed, task.completed, landing.created or landing.published: only ones carrying this tag. Omit it for any.\",\n  experimentId:\n    'With --trigger experiment.decided, experiment.ended or experiment.concluded: only this test. Omit it for any test. Not for experiment.started — narrow that with --when \"page = <page>\".',\n  taskId:\n    \"With --trigger task.claimed or task.completed: only this Task, by id (a temp_ id of a Task staged in this chat works too). Omit it for any Task.\",\n  agentId:\n    \"With --trigger session.published, session.publish_failed or session.publish_incomplete: only the runs of this scheduled agent, by id (a temp_agent_ id staged in this chat works too). Omit it for any agent's work.\",\n  platform:\n    \"With --trigger session.publish_incomplete: only when this platform's changes did not all land — google-ads, meta-ads, linkedin-ads, x-ads, chatgpt-ads, tag-manager, ga4 or shopify. Omit it for any.\",\n  collection: \"With --trigger knowledge.updated: only this Knowledge collection. Omit it for any of them.\",\n  sourceId: \"With --trigger review.received: only reviews from this review source, by id. Omit it for any source.\",\n  advertiserId: \"With --trigger advertiser.new_ads: only this followed advertiser, by id. Omit it for any of them.\",\n  adAccount:\n    \"With --trigger ad_alert.opened, ad_alert.claimed, ad_alert.fixed or ad_alert.closed: only alerts on this ad account, as <platform>:<ad account id> (meta:123). Omit it for any account.\",\n  alertRule:\n    'With --trigger ad_alert.opened, ad_alert.claimed, ad_alert.fixed or ad_alert.closed: only this kind of alert, by the rule `baker ads performance attention` names (budget_cut, efficiency_degraded, tracking_broke). Omit it for any. Narrow by severity with --when \"severity = critical\".',\n  socialAccount:\n    \"With --trigger social.post_published: only posts by this followed account, by its key (linkedin:in/jacintofleta, instagram:nike — `baker media-sources list`). Omit it for any account.\",\n  personRole:\n    \"With --trigger social.post_published: only posts by people with this role — ceo, founder, cto, cmo, head_of_sales, sales, marketing, employee, creator. Omit it for any account, pages included.\",\n};\n\n/**\n * One flag per thing a trigger can be pointed at, read off the same table the\n * dashboard's picker offers. `baker scheduled-agents targets` lists the values\n * each one takes, so no flag needs an id the agent has to guess.\n */\nexport const NARROWING_ARGS = {\n  ...(Object.fromEntries(\n    TRIGGER_TARGET_FIELD_IDS.map((field) => [\n      TRIGGER_TARGET_FIELDS[field].flag,\n      {\n        type: \"string\" as const,\n        description: `${NARROWING_DESCRIPTIONS[field]} \\`baker scheduled-agents targets --trigger <kind> --field ${field}\\` lists the values.`,\n        required: false,\n      },\n    ]),\n  ) as Record<string, { type: \"string\"; description: string; required: false }>),\n  config: {\n    type: \"string\" as const,\n    description:\n      'With --trigger app.event: the event\\'s own settings as a JSON object — they filter inside the tool, before anything is sent. A Gmail search (\\'{\"query\":\"from:ana@acme.com\"}\\'), a label, a Slack channel, a GitHub repository (\\'{\"owner\":\"acme\",\"repo\":\"site\"}\\'). `targets --field appEvent --app <tool> --event <id>` lists each setting with its examples.',\n    required: false,\n  },\n};\n\n/**\n * A one-off run time, checked before it can be staged.\n *\n * A time that has already been overtaken cannot run, and until this existed\n * nothing said so: the backend took it, the change list showed the item, and\n * Publish created it switched off. Caught here it costs a round trip and the\n * user can still be asked what time they meant — converting a local time to UTC\n * the wrong way round is how it usually gets there.\n */\nfunction validateRunAt(runAt: string): void {\n  if (!runAt.endsWith(\"Z\")) {\n    failValidation(\"--run-at must be an ISO UTC timestamp ending in Z.\");\n  }\n  const parsed = Date.parse(runAt);\n  if (!Number.isFinite(parsed)) {\n    failValidation(\"--run-at must be a valid ISO timestamp.\");\n  }\n  if (parsed <= Date.now()) {\n    failValidation(\n      `--run-at ${runAt} has already passed. A one-off item only runs at a time still to come — pass a later ISO UTC timestamp, and check which timezone you converted from if you worked it out from a local time.`,\n    );\n  }\n}\n\nexport type TriggerBody =\n  | { cron: string; timezone?: string }\n  | { runAt: string; timezone?: string }\n  | { trigger: Record<string, unknown>; timezone?: string }\n  | { timezone: string };\n\n/**\n * The trigger a command is asking for, from the flags that name one.\n *\n * `--cron` and `--run-at` stay as the shorthands for the two time kinds: they\n * are what an agent reaches for and what every installed CLI already sends.\n * Everything else arrives as `--trigger <kind>` plus at most one narrowing flag,\n * so adding a kind is one entry in `@baker/api` and one case here.\n */\nexport function buildTriggerBody(\n  args: Record<string, unknown>,\n  options: { required: boolean },\n): TriggerBody | undefined {\n  const cron = args.cron as string | undefined;\n  const runAt = args[\"run-at\"] as string | undefined;\n  const timezone = args.timezone as string | undefined;\n  const kind = args.trigger as string | undefined;\n\n  const given = [cron, runAt, kind].filter(Boolean).length;\n  if (given > 1) {\n    failValidation(\"--cron, --run-at and --trigger are mutually exclusive.\");\n  }\n  refuseNarrowingWithoutKind(args, kind, given);\n  if (runAt) {\n    validateRunAt(runAt);\n    return { runAt, ...(timezone ? { timezone } : {}) };\n  }\n  if (cron) {\n    return { cron, ...(timezone ? { timezone } : {}) };\n  }\n  if (kind) {\n    return { trigger: triggerFromFlags(kind, args), ...(timezone ? { timezone } : {}) };\n  }\n  if (timezone && !options.required) {\n    // The item keeps its trigger; the backend applies the new timezone to it.\n    return { timezone };\n  }\n  if (options.required) {\n    failValidation(\n      `A trigger is required. Pass --cron or --run-at for a time-based one, or --trigger with one of: ${TRIGGER_KIND_IDS.join(\", \")}.`,\n    );\n  }\n  return undefined;\n}\n\nfunction flagText(args: Record<string, unknown>, key: string): string | undefined {\n  const value = args[key];\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\n/**\n * The two time kinds have their own flags, and `--trigger time.cron` with no\n * cadence is the mistake that would otherwise be accepted and then refused by\n * the backend, one round trip later. And a test that exists has already\n * started, so naming one on `experiment.started` can never fire.\n */\nfunction refuseMisusedKinds(kind: TriggerKind, args: Record<string, unknown>): void {\n  if (kind === \"time.once\") {\n    failValidation(\"Use --run-at for a one-off, rather than --trigger time.once.\");\n  }\n  if (kind === \"time.cron\") {\n    failValidation(\"Use --cron for a repeating schedule, rather than --trigger time.cron.\");\n  }\n  if (kind === \"experiment.started\" && flagText(args, \"experiment\")) {\n    failValidation(\n      'A test that exists has already started, so --experiment never fires on experiment.started. Leave it off and add --when \"page = <page>\" to watch one page.',\n    );\n  }\n}\n\n/** A narrowing flag the kind does not take would be silently dropped — the item would fire on everything. */\nfunction refuseStrayFlags(kind: TriggerKind, args: Record<string, unknown>): void {\n  const allowed = new Set(TRIGGER_TARGETS[kind].map((target) => TRIGGER_TARGET_FIELDS[target.field].flag));\n  const stray = TRIGGER_TARGET_FIELD_IDS.map((field) => TRIGGER_TARGET_FIELDS[field].flag).filter(\n    (flag) =>\n      !allowed.has(flag) &&\n      flagText(args, flag) !== undefined &&\n      !(kind === \"experiment.started\" && flag === \"experiment\"),\n  );\n  if (stray.length === 0) {\n    return;\n  }\n  failValidation(\n    `${stray.map((flag) => `--${flag}`).join(\", \")} does not narrow ${kind}. ${\n      allowed.size > 0\n        ? `It can be pointed with ${[...allowed].map((flag) => `--${flag}`).join(\", \")}.`\n        : \"It runs every time it happens — narrow it with --when rules over its payload instead.\"\n    }`,\n  );\n}\n\n/** Every flag that only means something beside `--trigger <kind>`. */\nconst NARROWING_FLAGS = [...TRIGGER_TARGET_FIELD_IDS.map((field) => TRIGGER_TARGET_FIELDS[field].flag), \"config\"];\n\n/**\n * A narrowing flag with no `--trigger` to narrow would be dropped without a\n * word — `update <id> --page pricing` succeeding and still firing on every page.\n */\nfunction refuseNarrowingWithoutKind(args: Record<string, unknown>, kind: string | undefined, given: number): void {\n  if (kind) {\n    return;\n  }\n  const stray = NARROWING_FLAGS.filter((flag) => flagText(args, flag) !== undefined);\n  if (stray.length === 0) {\n    return;\n  }\n  const flags = stray.map((flag) => `--${flag}`).join(\", \");\n  failValidation(\n    given > 0\n      ? `${flags} does not narrow --cron or --run-at: a time trigger runs every time it comes round. Use --trigger <kind> with ${flags} instead, or leave ${flags} off.`\n      : `${flags} narrows a trigger, and no trigger was given. Pass --trigger <kind> too — the item's whole trigger, with ${flags} — or leave ${flags} off.`,\n  );\n}\n\n/** An `app.event`'s own settings, checked to be a JSON object before the round trip. */\nfunction configFromFlag(kind: TriggerKind, args: Record<string, unknown>): { configJson?: string } {\n  const config = flagText(args, \"config\");\n  if (!config) {\n    return {};\n  }\n  if (kind !== \"app.event\") {\n    failValidation(\"--config is only for --trigger app.event: the settings of what happens in the tool.\");\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(config);\n  } catch {\n    parsed = null;\n  }\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    failValidation(`--config must be a JSON object, e.g. '{\"labelIds\":\"INBOX\"}'.`);\n  }\n  return { configJson: config };\n}\n\n/** The narrowing flags a kind takes, refused when they do not belong to it or one it needs is missing. */\n/** Ad accounts are stored by bare id (`meta:123`); Meta writes them `act_123`, so that spelling is taken too. */\nfunction withoutMetaActPrefix(adAccount: string): string {\n  return adAccount.replace(/^meta:act_/i, \"meta:\");\n}\n\nfunction triggerFromFlags(kind: string, args: Record<string, unknown>): Record<string, unknown> {\n  if (!isTriggerKind(kind)) {\n    failValidation(`--trigger must be one of: ${TRIGGER_KIND_IDS.join(\", \")}.`);\n  }\n  refuseMisusedKinds(kind, args);\n  refuseStrayFlags(kind, args);\n  const narrowings: Record<string, string> = {};\n  for (const { field, required } of TRIGGER_TARGETS[kind]) {\n    const value = flagText(args, TRIGGER_TARGET_FIELDS[field].flag);\n    if (value) {\n      narrowings[field] = field === \"adAccount\" ? withoutMetaActPrefix(value) : value;\n    } else if (required) {\n      failValidation(\n        `--trigger ${kind} needs --${TRIGGER_TARGET_FIELDS[field].flag}. \\`baker scheduled-agents targets --trigger ${kind} --field ${field}\\` lists what it can be.`,\n      );\n    }\n  }\n  // `webhook.received`, `brand.updated`, `creative.created`: the kind is the\n  // whole of it. The webhook's address is reserved when it is staged and comes\n  // back in the response.\n  return { kind, ...narrowings, ...configFromFlag(kind, args) };\n}\n\n/**\n * Which firings actually run it, 1-based: `--occurrences 1` is \"only the first\n * time this ever happens\".\n */\nexport function parseOccurrences(raw: unknown): number[] | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  if (typeof raw !== \"string\") {\n    failValidation(\"--occurrences must be a comma-separated list of whole numbers, e.g. 1 or 1,3.\");\n  }\n  const parts = raw\n    .split(\",\")\n    .map((part) => part.trim())\n    .filter((part) => part.length > 0);\n  const numbers = parts.map((part) => Number(part));\n  if (numbers.length === 0 || numbers.some((n) => !Number.isInteger(n) || n <= 0)) {\n    failValidation(\"--occurrences must be a comma-separated list of whole numbers above zero, e.g. 1 or 1,3.\");\n  }\n  return numbers;\n}\n\nexport function parseBooleanFlag(raw: unknown, flagName: string): boolean | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  if (raw === true || raw === \"true\") {\n    return true;\n  }\n  if (raw === false || raw === \"false\") {\n    return false;\n  }\n  failValidation(`${flagName} must be true or false.`);\n}\n\n/**\n * How the item reacts once woken, beyond what wakes it — shared by `create` and\n * `update` for the same reason `NARROWING_ARGS` is.\n */\nexport const REACTION_ARGS = {\n  when: {\n    type: \"string\" as const,\n    description:\n      \"Only run when what arrived passes these rules: `<field> <operator> <value>` joined by AND or by OR (either case). Fields are the trigger's payload fields (`baker scheduled-agents triggers --trigger <kind>` lists them; a webhook's are whatever was posted; an app.event's are what `targets --field appEvent --app <tool> --event <id>` says it sends). Operators: =, !=, contains, does not contain, starts with, ends with, >, <, >=, <=, in (comma list), exists, missing. Example: --when \\\"deal.stage = won AND amount > 10000\\\". A payload that fails is not counted and starts nothing. `none` clears the rules.\",\n    required: false,\n  },\n  \"ai-check\": {\n    type: \"string\" as const,\n    description:\n      'Only run when AI judges that what arrived meets this condition, in plain words — for what no --when rule can say: --ai-check \"the person writes on behalf of a company, not as a student or for personal use\". Checked after --when, on what passed it; a turned-down arrival is not counted and starts nothing, and shows in `history` with its score. Say the boundary cases (\"a freelancer counts as a company\"). Emails and phones are hidden from it, as from the run — an email domain is a --when rule. Not for a time-based start (--cron, --run-at). `none` removes it.',\n    required: false,\n  },\n  times: {\n    type: \"string\" as const,\n    description:\n      \"Only the first N times it fires (and its --when rules pass), then never again. `--times 1` is only the first time. Shorthand for --occurrences 1,2,…,N.\",\n    required: false,\n  },\n  payload: {\n    type: \"string\" as const,\n    description:\n      \"include (default) or omit. Whether the run's first message carries what arrived — the posted body, the event's properties, the Form's answers (emails and phones masked). Place single values in --prompt with {{payload.<field>}} instead; those are filled either way.\",\n    required: false,\n  },\n  cooldown: {\n    type: \"string\" as const,\n    description: \"At most one run per this many minutes, however often it fires. 0 removes it.\",\n    required: false,\n  },\n};\n\n/**\n * Where each run is told in Slack (docs/adr/0010-scheduled-agents-report-in-slack.md).\n * The run opens its own thread there and Baker's Slack agent reports on it.\n */\nexport const SLACK_ARG = {\n  slack: {\n    type: \"string\" as const,\n    description:\n      \"Tell each run in Slack: `here` (the Slack conversation this chat came from), `me` (a direct message to the person in this chat), `#channel` (a channel linked to this company), or `off`. Each run opens its own thread there and Baker reports on it: what it found, what it needs, whether to publish.\",\n    required: false,\n  },\n};\n\n/**\n * `--companies`, for the organization's own Scheduled agents and nobody else's:\n * a company's agent hears its own company, so it is never shown the flag.\n * Passed anyway, it reaches Baker, which refuses it on a company's item.\n */\nexport function companiesArg(\n  profile: AgentProfile = agentProfile(),\n): Record<string, { type: \"string\"; description: string; required: false }> {\n  return profile === \"organization\"\n    ? {\n        companies: {\n          type: \"string\" as const,\n          description:\n            \"The companies whose events it hears, by id, comma-separated (`baker organization companies` lists them), or `all`. Left out, it hears every company, including ones added later. Only on a trigger that happens in a company; one company's Form, page or tag is a --when rule instead.\",\n          required: false,\n        },\n      }\n    : {};\n}\n\n/** The `--companies` choice for the request body, as written; Baker checks the ids against the organization. */\nexport function companiesBody(args: Record<string, unknown>): { companies?: string } {\n  return typeof args.companies === \"string\" && args.companies.trim().length > 0\n    ? { companies: args.companies.trim() }\n    : {};\n}\n\n/** The `--slack` choice for the request body, as the person wrote it; Baker resolves it. */\nexport function slackBody(args: Record<string, unknown>): { slack?: string } {\n  return typeof args.slack === \"string\" && args.slack.trim().length > 0 ? { slack: args.slack.trim() } : {};\n}\n\n/** A whole number from a flag, or a refusal naming the flag. */\nfunction wholeNumber(raw: unknown, flag: string, { min }: { min: number }): number | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  const value = Number(raw);\n  if (!Number.isInteger(value) || value < min) {\n    failValidation(`${flag} must be a whole number of at least ${min}.`);\n  }\n  return value;\n}\n\nexport interface ReactionBody {\n  occurrences?: number[];\n  when?: string;\n  aiCondition?: string;\n  includePayload?: boolean;\n  cooldownMinutes?: number;\n}\n\n/**\n * The reaction flags as the API reads them. `--when` is checked here and sent\n * as written: the backend parses the same language with the same code, so the\n * text on the wire is the text the agent wrote.\n */\nexport function reactionBody(args: Record<string, unknown>): ReactionBody {\n  const occurrences = occurrencesFromFlags(args);\n  const when = whenFromFlag(args.when);\n  const includePayload = payloadFromFlag(args.payload);\n  const cooldownMinutes = wholeNumber(args.cooldown, \"--cooldown\", { min: 0 });\n  const aiCondition = aiCheckFromFlag(args[\"ai-check\"]);\n  return {\n    ...(occurrences !== undefined ? { occurrences } : {}),\n    ...(when !== undefined ? { when } : {}),\n    ...(aiCondition !== undefined ? { aiCondition } : {}),\n    ...(includePayload !== undefined ? { includePayload } : {}),\n    ...(cooldownMinutes !== undefined ? { cooldownMinutes } : {}),\n  };\n}\n\nfunction occurrencesFromFlags(args: Record<string, unknown>): number[] | undefined {\n  const times = wholeNumber(args.times, \"--times\", { min: 1 });\n  const occurrences = parseOccurrences(args.occurrences);\n  if (times !== undefined && occurrences !== undefined) {\n    failValidation(\"Pass --times or --occurrences, not both — --times 3 is --occurrences 1,2,3.\");\n  }\n  return times !== undefined ? firstTimes(times) : occurrences;\n}\n\nfunction whenFromFlag(raw: unknown): string | undefined {\n  if (typeof raw !== \"string\") {\n    return undefined;\n  }\n  const text = raw.trim();\n  if (text.length === 0 || text.toLowerCase() === \"none\") {\n    return \"none\";\n  }\n  const parsed = parseConditionsExpression(text);\n  if (!parsed.ok) {\n    failValidation(parsed.error);\n  }\n  return text;\n}\n\nfunction aiCheckFromFlag(raw: unknown): string | undefined {\n  if (typeof raw !== \"string\") {\n    return undefined;\n  }\n  const text = raw.trim();\n  if (text.length === 0 || text.toLowerCase() === \"none\") {\n    return \"none\";\n  }\n  if (text.length > MAX_AI_CONDITION_CHARS) {\n    failValidation(\n      `--ai-check is at most ${MAX_AI_CONDITION_CHARS} characters: say the condition, not the job. The job goes in --prompt.`,\n    );\n  }\n  return text;\n}\n\nfunction payloadFromFlag(raw: unknown): boolean | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  if (raw !== \"include\" && raw !== \"omit\") {\n    failValidation(\"--payload must be include or omit.\");\n  }\n  return raw === \"include\";\n}\n\n/**\n * The chat this turn belongs to, when the sandbox knows. The backend reads who\n * sent its latest message and lists that person's own connections beside the\n * company's — a personal inbox is theirs to listen to, and nobody else's.\n */\nexport function chatBody(): { chatId?: string } {\n  const id = getEnv().BAKER_CHAT_ID;\n  return id ? { chatId: id } : {};\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-KMMQLWNC.js

@@ -0,0 +1,139 @@
+import {
+  brandVerificationHints
+} from "./chunk-IVIJJXXT.js";
+import {
+  OUTPUT_ARGS,
+  writeProviderHits
+} from "./chunk-ESQX7SRQ.js";
+import {
+  emptyResultHints
+} from "./chunk-Q6ULQMWG.js";
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+
+// src/commands/images/logo.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.logo",
+  description: "Brand logo lookup via Brandfetch. Auto-ingests by default. Returns `brandMatch` \u2014 Brandfetch's own verdict on whose brand the domain is (confirmed | mismatch | unverified). Branch on it: `mismatch` means the mark is another company's, so do not place it. `confirmed` verifies the record, not the artwork \u2014 read the ingested row back to check the mark itself.",
+  args: {
+    domain: { type: "string", description: "Brand domain (e.g. stripe.com)", required: true },
+    variant: { type: "string", description: "icon | logo | symbol", required: false },
+    "auto-ingest": {
+      type: "number",
+      description: `Ingest top N hits (0-${AUTO_INGEST_MAX.logo}). Defaults to 1 (the first variant). Brandfetch resolves at most ${AUTO_INGEST_MAX.logo} variants, so ${AUTO_INGEST_MAX.logo} ingests every one. Keep it at 1+ \u2014 the ingested row is the only way to check the mark is the brand you asked for.`,
+      required: false
+    },
+    "no-auto-ingest": {
+      type: "boolean",
+      description: "Skip auto-ingest (equivalent to --auto-ingest 0). Leaves the returned mark unverifiable.",
+      required: false,
+      default: false
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint applied to ingested logo variants (e.g. 'Stripe \u2014 payments integration partner', 'Acme competitor brand mark')",
+      required: false
+    },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
+  }
+});
+var logoCommand = defineCommand({
+  meta: {
+    name: "logo",
+    description: "Brand logo via Brandfetch. Returns up to 5 variants (icon, light/dark logo, light/dark symbol) plus `brandMatch`. Auto-ingests the first variant.\n\nStart here: check `brandMatch.verdict`.\n  mismatch   \u2192 the mark belongs to `brandMatch.name`, a different company. Do not place it.\n  unverified \u2192 nothing confirmed whose logo this is. Treat as unchecked.\n  confirmed  \u2192 Brandfetch has this brand's record. That verifies the record, NOT the artwork \u2014 a confirmed domain has served another company's logo before.\n\n\u26A0 Whatever the verdict, read the ingested row back with `baker images get <imageId>` and check `textInImage`/`subject` before placing it. That is the only check that looks at the mark.\n\nExample: baker images logo stripe.com --variant logo"
+  },
+  args: {
+    domain: { type: "positional", description: "Brand domain", required: false },
+    variant: { type: "string", description: "icon|logo|symbol", required: false },
+    "auto-ingest": {
+      type: "string",
+      description: `Ingest top N (0-${AUTO_INGEST_MAX.logo}, default 1)`,
+      required: false
+    },
+    "no-auto-ingest": { type: "boolean", description: "Skip auto-ingest", required: false },
+    context: { type: "string", description: "Description context hint applied to ingested logos", required: false },
+    ...OUTPUT_ARGS
+  },
+  run: async ({ args }) => {
+    try {
+      const domain = args.domain;
+      if (!domain) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Domain is required" } });
+        process.exit(1);
+      }
+      const body = { domain };
+      if (args.variant) body.variant = args.variant;
+      if (args["auto-ingest"] !== void 0) {
+        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.logo);
+        if (!parsed.ok) {
+          writeJson({
+            ok: false,
+            error: {
+              code: "VALIDATION_ERROR",
+              message: parsed.message,
+              fix: {
+                action: "retry_with_changes",
+                explanation: `Brandfetch resolves at most ${AUTO_INGEST_MAX.logo} variants for a domain, so --auto-ingest ${AUTO_INGEST_MAX.logo} already ingests every one. Re-run with a value in 0-${AUTO_INGEST_MAX.logo}.`
+              }
+            }
+          });
+          process.exit(1);
+        }
+        body.autoIngest = parsed.value;
+      } else if (args["no-auto-ingest"]) {
+        body.autoIngest = 0;
+      }
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/logo", body);
+      const hints = [
+        // `brandMatch` is Brandfetch's own answer to whose brand this domain is,
+        // so the warning can now be graded instead of fired blind: loud on a
+        // mismatch, honest about what a confirmation does and does not cover.
+        ...brandVerificationHints({
+          domain,
+          ingested: data.ingested,
+          hitCount: data.hits.length,
+          brandMatch: data.brandMatch
+        }),
+        ...emptyResultHints({ provider: "logo", hitCount: data.hits.length, activeFilters: [], subject: domain })
+      ];
+      writeProviderHits(data, data.hits, args, hints);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+async function fetchBrandLogo(domain) {
+  try {
+    const body = { domain, variant: "logo" };
+    const data = await apiPost("/api/images/logo", body);
+    if (data?.brandMatch?.verdict === "mismatch") return null;
+    return data?.ingested?.[0]?.imageUrl ?? data?.hits?.find((h) => h.imageUrl)?.imageUrl ?? null;
+  } catch {
+    return null;
+  }
+}
+
+export {
+  logoCommand,
+  fetchBrandLogo
+};
+//# sourceMappingURL=chunk-KMMQLWNC.js.map