@koda-sl/baker-cli 0.453.0 → 0.454.0-dev.67ad219ab

package/dist/currency-UIK2FQKD.js

@@ -0,0 +1,88 @@
+import {
+  parseApiError
+} from "./chunk-BFBTBN66.js";
+import "./chunk-XCM6XWOB.js";
+import {
+  cacheGet,
+  cacheSet,
+  getManagerIdForCustomer,
+  resolveCustomerId,
+  writeAdsJson
+} from "./chunk-CWW5ITFK.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import {
+  registerSchema
+} from "./chunk-5WW456MW.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/currency.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.google.currency",
+  description: "Get the currency code for a Google Ads account. Returns currency_code, customer_id, account_name, and access_type. Call this before interpreting cost_micros values.",
+  args: {
+    "customer-id": {
+      type: "string",
+      description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
+      required: false
+    },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+var currencyCommand = defineCommand({
+  meta: {
+    name: "currency",
+    description: `Get account currency code. Use this to interpret metrics.cost_micros values.
+
+Examples:
+  baker ads google currency --customer-id 1234567890`
+  },
+  args: {
+    "customer-id": { type: "string", description: "Google Ads customer ID (10 digits)", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  },
+  run: async ({ args }) => {
+    const customerId = await resolveCustomerId(args);
+    const useCache = !args["no-cache"];
+    const cacheKey = `currency:${customerId}`;
+    if (useCache) {
+      const cached = cacheGet("accounts", cacheKey);
+      if (cached) {
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      const params = { "customer-id": customerId };
+      const managerId = getManagerIdForCustomer(customerId);
+      if (managerId) params["manager-id"] = managerId;
+      if (!useCache) params["skip-cache"] = "true";
+      const raw = await apiGet("/api/ads/google/currency", params);
+      const data = {
+        currency_code: raw.currencyCode,
+        customer_id: raw.customerId
+      };
+      if (useCache) {
+        cacheSet("accounts", cacheKey, data, 24 * 60 * 60 * 1e3);
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseApiError(err.message, "", customerId, err.code));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  currencyCommand
+};
+//# sourceMappingURL=currency-UIK2FQKD.js.map

package/dist/custom-conversions-NBZZO6CH.js

@@ -0,0 +1,125 @@
+import {
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-7P2Y7OQF.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-CWW5ITFK.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-UK4DUS6I.js";
+import {
+  apiGet
+} from "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import {
+  registerSchema
+} from "./chunk-5WW456MW.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/custom-conversions.ts
+import { defineCommand } from "citty";
+function compactCustomConversion(row) {
+  return {
+    id: row.id,
+    name: row.name,
+    custom_event_type: row.custom_event_type,
+    counts: row.rule_summary,
+    pixel_id: row.pixel?.id,
+    last_fired_time: row.last_fired_time,
+    ...row.is_archived ? { archived: true } : {},
+    ...row.is_unavailable ? { unavailable: true } : {}
+  };
+}
+function customConversionHints(rows) {
+  if (rows.length === 0) {
+    return [
+      "This account has no custom conversions. Optimize toward a standard pixel event instead (`--pixel-id` + `--custom-event-type`), or ask the user to create one in Events Manager."
+    ];
+  }
+  const hints = [
+    "To optimize an ad set toward one: `baker ads meta adsets create \u2026 --optimization-goal OFFSITE_CONVERSIONS --custom-conversion-id <id>`. Baker fills the pixel and the event category from the conversion \u2014 do not also pass --pixel-id or --custom-event-type."
+  ];
+  const neverFired = rows.filter((row) => !row.is_archived && !row.last_fired_time);
+  if (neverFired.length > 0) {
+    hints.push(
+      `${neverFired.length === 1 ? "This conversion has" : `${neverFired.length} of these have`} never fired (${neverFired.map((row) => row.name ?? row.id).join(
+        ", "
+      )}). Meta cannot optimize toward an event it has never seen, so an ad set pointed at one delivers without learning \u2014 check the rule matches a page the site actually serves before spending on it.`
+    );
+  }
+  return hints;
+}
+registerSchema({
+  command: "ads.meta.custom-conversions",
+  description: "List the Custom Conversions defined on a Meta ad account \u2014 the measurement objects a marketer sets up in Events Manager (a pixel event narrowed by a rule, e.g. 'PageView on /thank-you'). Start here whenever the user talks about their own conversions rather than a standard event: an ad set optimizes toward one with `adsets create --custom-conversion-id <id>`.",
+  args: {
+    "account-id": { type: "string", description: "Meta ad account ID (act_123)", required: false },
+    full: { type: "boolean", description: "Include the raw rule JSON, retention and creation times", required: false },
+    limit: { type: "string", description: "Max rows", required: false },
+    "no-cache": { type: "boolean", description: "Bypass the cache", required: false },
+    output: { type: "string", description: "json|csv", required: false, default: "json" }
+  }
+});
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  full: { type: "boolean", description: "Include the raw rule JSON, retention and creation times" },
+  limit: { type: "string", description: "Max rows" },
+  "no-cache": NO_CACHE_ARG,
+  output: { type: "string", description: "Output format", default: "json" }
+};
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List custom conversions. Runs by default when no subcommand is given. Example: baker ads meta custom-conversions --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const rows = await apiGet("/api/ads/meta/custom-conversions", params);
+      const data = args.full ? rows.map((row) => ({ ...row })) : rows.map((row) => ({ ...compactCustomConversion(row) }));
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeJsonEnvelope({ ok: true, data, hints: customConversionHints(rows) });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var customConversionsCommand = defineCommand({
+  meta: {
+    name: "custom-conversions",
+    description: `List the Custom Conversions on an ad account, or stage a new one \u2014 a pixel event narrowed by a rule, set up in Events Manager.
+Use this whenever the user says "my conversions" rather than naming a standard event: the id here is what an ad set optimizes toward.
+
+Examples:
+  baker ads meta custom-conversions --account-id act_123
+  baker ads meta custom-conversions --account-id act_123 --full   # raw rule JSON
+  baker ads meta custom-conversions create --name "Lead formulario" --pixel-id 9988 --custom-event-type LEAD --url-contains "/gracias"`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-WYET5424.js").then((m) => m.customConversionsCreateCommand)
+  },
+  // `args` stays even though the parent has no `run`: citty scans rawArgs for
+  // the subcommand name using THIS command's arg defs. `default` (not `run`)
+  // dispatches the bare invocation.
+  args: listArgs,
+  default: "list"
+});
+export {
+  compactCustomConversion,
+  customConversionHints,
+  customConversionsCommand
+};
+//# sourceMappingURL=custom-conversions-NBZZO6CH.js.map

package/dist/customers-NIAOEYND.js

@@ -0,0 +1,56 @@
+import {
+  FORCES,
+  INSIGHT_TYPES,
+  MAX_QUOTE_CHARS,
+  batchSources,
+  buildCustomersPrompt,
+  candidatesFrom,
+  customersCommand,
+  customersHints,
+  keepVerbatim,
+  planInsightWrites,
+  renderInsightFile,
+  researchCustomers,
+  sourcesFromPages,
+  sourcesFromReddit,
+  sourcesFromTestimonials
+} from "./chunk-SLE4FEFP.js";
+import "./chunk-LAHBXTKI.js";
+import "./chunk-ITQWQINC.js";
+import "./chunk-S5MBDWB3.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-RNHSGH44.js";
+import "./chunk-TIL76IDK.js";
+import "./chunk-CAMX6OHF.js";
+import "./chunk-BDI5INZA.js";
+import "./chunk-S2IOUC5B.js";
+import "./chunk-33F4O6OO.js";
+import "./chunk-YYBQUXFX.js";
+import "./chunk-IDYAVGCS.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import "./chunk-5WW456MW.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  FORCES,
+  INSIGHT_TYPES,
+  MAX_QUOTE_CHARS,
+  batchSources,
+  buildCustomersPrompt,
+  candidatesFrom,
+  customersCommand,
+  customersHints,
+  keepVerbatim,
+  planInsightWrites,
+  renderInsightFile,
+  researchCustomers,
+  sourcesFromPages,
+  sourcesFromReddit,
+  sourcesFromTestimonials
+};
+//# sourceMappingURL=customers-NIAOEYND.js.map

package/dist/decide-WPI5RC2Z.js

@@ -0,0 +1,199 @@
+import {
+  DECIDE_MAX_ITEMS,
+  DECIDE_MAX_ITEM_CHARS,
+  DECIDE_MAX_QUESTIONS,
+  decideRequestSchema
+} from "./chunk-IDYAVGCS.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-5WW456MW.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/decide/index.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+
+// src/commands/decide/hints.ts
+function decideHints(request, response) {
+  const hints = [];
+  if (request.items) {
+    for (const [name, question] of Object.entries(request.questions)) {
+      if (!question.question.includes("`item`")) {
+        hints.push(
+          `Question \`${name}\` never names \`item\`. Each item reaches Jev as \`item\` beside the question, and Jev reads literally: write "Does \`item\` \u2026?" so it judges the item, not the question.`
+        );
+      }
+    }
+  }
+  if (response.unanswered.length > 0) {
+    hints.push(
+      `${response.unanswered.length} item(s) went unanswered: ${response.unanswered.slice(0, 10).join(", ")}${response.unanswered.length > 10 ? ", \u2026" : ""}. Their answers are null. Keep the answered ones; show these as not tagged, or ask again with only these items. Never drop the rest.`
+    );
+  }
+  return hints;
+}
+
+// src/commands/decide/input.ts
+var looksInline = (value) => /^\s*[[{"]/.test(value);
+function parse(flag, text, from) {
+  try {
+    return { ok: true, value: JSON.parse(text) };
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    return { ok: false, message: `--${flag} is not valid JSON (${from}): ${reason}` };
+  }
+}
+function readJsonFlag(flag, value, source2) {
+  if (value === "-") return parse(flag, source2.stdin(), "stdin");
+  if (looksInline(value)) return parse(flag, value, "inline");
+  let text;
+  try {
+    text = source2.file(value);
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    return {
+      ok: false,
+      message: `--${flag}: cannot read ${value} (${reason}). Pass a JSON file path, inline JSON, or - for stdin`
+    };
+  }
+  return parse(flag, text, value);
+}
+function readStateFlag(value, source2) {
+  if (looksInline(value)) return parse("state", value, "inline");
+  let text;
+  try {
+    text = value === "-" ? source2.stdin() : source2.file(value);
+  } catch {
+    return { ok: true, value };
+  }
+  const json = parse("state", text, value);
+  return json.ok ? json : { ok: true, value: text };
+}
+
+// src/commands/decide/index.ts
+var ARGS = {
+  questions: {
+    type: "string",
+    description: 'Named questions, as inline JSON, a .json file or - (stdin): { "<name>": { "type": "noul", "question": "Does `item` offer a free trial?" } | { "type": "choice", "question": "\u2026", "options": { "<key>": "<what it means>" } } | { "type": "score", "question": "\u2026", "levels": ["<lowest>", "\u2026", "<highest>"] } }',
+    required: true
+  },
+  items: {
+    type: "string",
+    description: `Optional. The things to ask about, each its own question: [{ "id": "\u2026", "text": "\u2026" | { "<field>": "\u2026" } }] \u2014 inline JSON, a .json file or -. Up to ${DECIDE_MAX_ITEMS} items, ${DECIDE_MAX_ITEM_CHARS} characters each, ${DECIDE_MAX_QUESTIONS} questions (items \xD7 named questions) per call.`,
+    required: false
+  },
+  state: {
+    type: "string",
+    description: "Optional. What every question reads beside its item (context such as the brand or the brief) or, with no --items, the text being asked about: inline JSON, a file, - or plain text.",
+    required: false
+  },
+  full: {
+    type: "boolean",
+    description: "Also return every option's probability on Choices and Scores (default: the pick, its probability and confidence)",
+    required: false,
+    default: false
+  }
+};
+registerSchema({
+  command: "decide",
+  description: "Ask Jev, a decision model, typed questions about text and get typed answers with calibrated probabilities: a yes/no (noul), one option of your set (choice) or a level on a scale (score). With --items, every question is asked about every item (tag N ads, cluster them into your labels) in one call. Reads only; never writes, never generates text, text only (no images).",
+  args: ARGS
+});
+var source = {
+  file: (path) => readFileSync(path, "utf-8"),
+  stdin: () => readFileSync(0, "utf-8")
+};
+function fail(code, message, fix) {
+  writeJson({ ok: false, error: { code, message, fix } });
+  process.exit(1);
+}
+var INPUT_FIX = {
+  action: "fix_input",
+  explanation: "Correct the flag named in the message and run again. Run `baker schema decide` for the exact shapes; the family doc is __tooling__/docs/tools/baker/decide.md."
+};
+var SPLIT_FIX = {
+  action: "split_call",
+  explanation: `One call asks at most ${DECIDE_MAX_QUESTIONS} questions (items \xD7 named questions), ${DECIDE_MAX_ITEMS} items of ${DECIDE_MAX_ITEM_CHARS} characters. Split the items across calls, or trim each item to the fields the questions need.`
+};
+var DEGRADE_FIX = {
+  action: "degrade",
+  explanation: "The decision model did not answer. Do not abort the job: carry on without these answers (show the items untagged, skip the clustering) and say so in one line. Ask again once later; do not loop."
+};
+function readFlag(read) {
+  if (read && !read.ok) fail("VALIDATION_ERROR", read.message, INPUT_FIX);
+  return read?.value;
+}
+function readRequest(args) {
+  const questions = readFlag(readJsonFlag("questions", String(args.questions), source));
+  const items = readFlag(typeof args.items === "string" ? readJsonFlag("items", args.items, source) : void 0);
+  const state = readFlag(typeof args.state === "string" ? readStateFlag(args.state, source) : void 0);
+  const parsed = decideRequestSchema.safeParse({
+    questions,
+    ...items === void 0 ? {} : { items },
+    ...state === void 0 ? {} : { state },
+    full: args.full === true
+  });
+  if (parsed.success) return parsed.data;
+  const message = parsed.error.issues.slice(0, 5).map((issue) => `${issue.path.join(".") || "request"}: ${issue.message}`).join("; ");
+  const tooMany = parsed.error.issues.some((issue) => issue.path[0] === "items" && issue.path.at(-1) !== "id");
+  fail("VALIDATION_ERROR", message, tooMany ? SPLIT_FIX : INPUT_FIX);
+}
+function failRequest(err) {
+  const code = err instanceof ApiError ? err.code : "INTERNAL_ERROR";
+  const message = err instanceof Error ? err.message : "Unexpected error";
+  if (code === "UNAVAILABLE" || code === "TIMEOUT") fail(code, message, DEGRADE_FIX);
+  if (code === "VALIDATION_ERROR") fail(code, message, INPUT_FIX);
+  writeJson({ ok: false, error: { code, message } });
+  process.exit(1);
+}
+var decideCommand = defineCommand({
+  meta: {
+    name: "decide",
+    description: `Ask typed questions about text; get typed answers with a probability. Read-only, about $0.0001 and well under a second per call.
+
+Start here:
+  baker decide --questions '{"b2b":{"type":"noul","question":"Is \`message\` written for a business buyer?"}}' --state '{"message":"\u2026"}'
+
+Tag and cluster many items in one call (each item is asked every question):
+  baker decide --questions questions.json --items ads.json --state '{"advertiser":"Notion"}'
+    questions.json: {"free_trial":{"type":"noul","question":"Does \`item\` offer a free trial?"},
+                     "angle":{"type":"choice","question":"Which angle does \`item\` lead with?",
+                              "options":{"ai":"AI does the work","team":"Teams work together","other":"Anything else"}}}
+    ads.json:       [{"id":"1157351686","text":{"angle":"\u2026","summary":"\u2026"}}, \u2026]
+
+Answers: noul \u2192 {noul: P(yes)}; choice \u2192 {choice, probability, confidence}; score \u2192 {score, level, confidence}. --full adds every option's probability.
+Text only: describe an image in words (an ad's summary, angle, copy) \u2014 never pass a picture.
+Full guide: __tooling__/docs/tools/baker/decide.md`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    const request = readRequest(args);
+    try {
+      const data = await apiPost("/api/decide", request, { timeoutMs: 12e4 });
+      const hints = decideHints(request, data);
+      writeJson({
+        ok: true,
+        data,
+        ...data.items ? { meta: { count: data.items.length } } : {},
+        ...hints.length > 0 ? { hints } : {}
+      });
+    } catch (err) {
+      failRequest(err);
+    }
+  }
+});
+export {
+  decideCommand
+};
+//# sourceMappingURL=decide-WPI5RC2Z.js.map

package/dist/decide-WPI5RC2Z.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/decide/index.ts","../src/commands/decide/hints.ts","../src/commands/decide/input.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport {\n  DECIDE_MAX_ITEM_CHARS,\n  DECIDE_MAX_ITEMS,\n  DECIDE_MAX_QUESTIONS,\n  type DecideRequestParsed,\n  type DecideResponse,\n  decideRequestSchema,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { decideHints } from \"./hints.ts\";\nimport { type FlagRead, type InputSource, readJsonFlag, readStateFlag } from \"./input.ts\";\n\nconst ARGS = {\n  questions: {\n    type: \"string\",\n    description:\n      'Named questions, as inline JSON, a .json file or - (stdin): { \"<name>\": { \"type\": \"noul\", \"question\": \"Does `item` offer a free trial?\" } | { \"type\": \"choice\", \"question\": \"…\", \"options\": { \"<key>\": \"<what it means>\" } } | { \"type\": \"score\", \"question\": \"…\", \"levels\": [\"<lowest>\", \"…\", \"<highest>\"] } }',\n    required: true,\n  },\n  items: {\n    type: \"string\",\n    description: `Optional. The things to ask about, each its own question: [{ \"id\": \"…\", \"text\": \"…\" | { \"<field>\": \"…\" } }] — inline JSON, a .json file or -. Up to ${DECIDE_MAX_ITEMS} items, ${DECIDE_MAX_ITEM_CHARS} characters each, ${DECIDE_MAX_QUESTIONS} questions (items × named questions) per call.`,\n    required: false,\n  },\n  state: {\n    type: \"string\",\n    description:\n      \"Optional. What every question reads beside its item (context such as the brand or the brief) or, with no --items, the text being asked about: inline JSON, a file, - or plain text.\",\n    required: false,\n  },\n  full: {\n    type: \"boolean\",\n    description:\n      \"Also return every option's probability on Choices and Scores (default: the pick, its probability and confidence)\",\n    required: false,\n    default: false,\n  },\n} as const;\n\nregisterSchema({\n  command: \"decide\",\n  description:\n    \"Ask Jev, a decision model, typed questions about text and get typed answers with calibrated probabilities: a yes/no (noul), one option of your set (choice) or a level on a scale (score). With --items, every question is asked about every item (tag N ads, cluster them into your labels) in one call. Reads only; never writes, never generates text, text only (no images).\",\n  args: ARGS,\n});\n\nconst source: InputSource = {\n  file: (path) => readFileSync(path, \"utf-8\"),\n  stdin: () => readFileSync(0, \"utf-8\"),\n};\n\nfunction fail(code: string, message: string, fix: { action: string; explanation: string }): never {\n  writeJson({ ok: false, error: { code, message, fix } });\n  process.exit(1);\n}\n\nconst INPUT_FIX = {\n  action: \"fix_input\",\n  explanation:\n    \"Correct the flag named in the message and run again. Run `baker schema decide` for the exact shapes; the family doc is __tooling__/docs/tools/baker/decide.md.\",\n};\n\nconst SPLIT_FIX = {\n  action: \"split_call\",\n  explanation: `One call asks at most ${DECIDE_MAX_QUESTIONS} questions (items × named questions), ${DECIDE_MAX_ITEMS} items of ${DECIDE_MAX_ITEM_CHARS} characters. Split the items across calls, or trim each item to the fields the questions need.`,\n};\n\nconst DEGRADE_FIX = {\n  action: \"degrade\",\n  explanation:\n    \"The decision model did not answer. Do not abort the job: carry on without these answers (show the items untagged, skip the clustering) and say so in one line. Ask again once later; do not loop.\",\n};\n\nfunction readFlag(read: FlagRead | undefined): unknown {\n  if (read && !read.ok) fail(\"VALIDATION_ERROR\", read.message, INPUT_FIX);\n  return read?.value;\n}\n\n/** The request the flags describe, checked against the shared contract before anything is sent. */\nfunction readRequest(args: {\n  questions?: unknown;\n  items?: unknown;\n  state?: unknown;\n  full?: unknown;\n}): DecideRequestParsed {\n  const questions = readFlag(readJsonFlag(\"questions\", String(args.questions), source));\n  const items = readFlag(typeof args.items === \"string\" ? readJsonFlag(\"items\", args.items, source) : undefined);\n  const state = readFlag(typeof args.state === \"string\" ? readStateFlag(args.state, source) : undefined);\n  const parsed = decideRequestSchema.safeParse({\n    questions,\n    ...(items === undefined ? {} : { items }),\n    ...(state === undefined ? {} : { state }),\n    full: args.full === true,\n  });\n  if (parsed.success) return parsed.data;\n  const message = parsed.error.issues\n    .slice(0, 5)\n    .map((issue) => `${issue.path.join(\".\") || \"request\"}: ${issue.message}`)\n    .join(\"; \");\n  // Every size limit on the batch reports against `items` (a repeated id against its `id`); splitting fixes those.\n  const tooMany = parsed.error.issues.some((issue) => issue.path[0] === \"items\" && issue.path.at(-1) !== \"id\");\n  fail(\"VALIDATION_ERROR\", message, tooMany ? SPLIT_FIX : INPUT_FIX);\n}\n\nfunction failRequest(err: unknown): never {\n  const code = err instanceof ApiError ? err.code : \"INTERNAL_ERROR\";\n  const message = err instanceof Error ? err.message : \"Unexpected error\";\n  if (code === \"UNAVAILABLE\" || code === \"TIMEOUT\") fail(code, message, DEGRADE_FIX);\n  if (code === \"VALIDATION_ERROR\") fail(code, message, INPUT_FIX);\n  writeJson({ ok: false, error: { code, message } });\n  process.exit(1);\n}\n\nexport const decideCommand = defineCommand({\n  meta: {\n    name: \"decide\",\n    description: `Ask typed questions about text; get typed answers with a probability. Read-only, about $0.0001 and well under a second per call.\n\nStart here:\n  baker decide --questions '{\"b2b\":{\"type\":\"noul\",\"question\":\"Is \\`message\\` written for a business buyer?\"}}' --state '{\"message\":\"…\"}'\n\nTag and cluster many items in one call (each item is asked every question):\n  baker decide --questions questions.json --items ads.json --state '{\"advertiser\":\"Notion\"}'\n    questions.json: {\"free_trial\":{\"type\":\"noul\",\"question\":\"Does \\`item\\` offer a free trial?\"},\n                     \"angle\":{\"type\":\"choice\",\"question\":\"Which angle does \\`item\\` lead with?\",\n                              \"options\":{\"ai\":\"AI does the work\",\"team\":\"Teams work together\",\"other\":\"Anything else\"}}}\n    ads.json:       [{\"id\":\"1157351686\",\"text\":{\"angle\":\"…\",\"summary\":\"…\"}}, …]\n\nAnswers: noul → {noul: P(yes)}; choice → {choice, probability, confidence}; score → {score, level, confidence}. --full adds every option's probability.\nText only: describe an image in words (an ad's summary, angle, copy) — never pass a picture.\nFull guide: __tooling__/docs/tools/baker/decide.md`,\n  },\n  args: ARGS,\n  run: async ({ args }) => {\n    const request = readRequest(args);\n    try {\n      const data = await apiPost<DecideResponse>(\"/api/decide\", request, { timeoutMs: 120_000 });\n      const hints = decideHints(request, data);\n      writeJson({\n        ok: true,\n        data,\n        ...(data.items ? { meta: { count: data.items.length } } : {}),\n        ...(hints.length > 0 ? { hints } : {}),\n      });\n    } catch (err) {\n      failRequest(err);\n    }\n  },\n});\n","import type { DecideRequestParsed, DecideResponse } from \"@baker/api\";\n\n/** What the agent must not miss in a `baker decide` result. Pure. */\nexport function decideHints(request: DecideRequestParsed, response: DecideResponse): string[] {\n  const hints: string[] = [];\n  if (request.items) {\n    for (const [name, question] of Object.entries(request.questions)) {\n      if (!question.question.includes(\"`item`\")) {\n        hints.push(\n          `Question \\`${name}\\` never names \\`item\\`. Each item reaches Jev as \\`item\\` beside the question, and Jev reads literally: write \"Does \\`item\\` …?\" so it judges the item, not the question.`,\n        );\n      }\n    }\n  }\n  if (response.unanswered.length > 0) {\n    hints.push(\n      `${response.unanswered.length} item(s) went unanswered: ${response.unanswered.slice(0, 10).join(\", \")}${response.unanswered.length > 10 ? \", …\" : \"\"}. Their answers are null. Keep the answered ones; show these as not tagged, or ask again with only these items. Never drop the rest.`,\n    );\n  }\n  return hints;\n}\n","/**\n * The JSON a `baker decide` flag carries: written inline (what a published\n * Report passes, having no file or stdin to hand), a file path, or `-` for\n * stdin. Pure over `source`, so it is tested without touching the disk.\n */\nexport type InputSource = { file: (path: string) => string; stdin: () => string };\n\nexport type FlagRead = { ok: true; value: unknown } | { ok: false; message: string };\n\nconst looksInline = (value: string) => /^\\s*[[{\"]/.test(value);\n\nfunction parse(flag: string, text: string, from: string): FlagRead {\n  try {\n    return { ok: true, value: JSON.parse(text) };\n  } catch (error) {\n    const reason = error instanceof Error ? error.message : String(error);\n    return { ok: false, message: `--${flag} is not valid JSON (${from}): ${reason}` };\n  }\n}\n\n/** A JSON value from inline JSON, a file, or `-` (stdin). */\nexport function readJsonFlag(flag: string, value: string, source: InputSource): FlagRead {\n  if (value === \"-\") return parse(flag, source.stdin(), \"stdin\");\n  if (looksInline(value)) return parse(flag, value, \"inline\");\n  let text: string;\n  try {\n    text = source.file(value);\n  } catch (error) {\n    const reason = error instanceof Error ? error.message : String(error);\n    return {\n      ok: false,\n      message: `--${flag}: cannot read ${value} (${reason}). Pass a JSON file path, inline JSON, or - for stdin`,\n    };\n  }\n  return parse(flag, text, value);\n}\n\n/** `--state`: JSON stays JSON; a file or stdin that is not JSON is its text; any other value is the text itself. */\nexport function readStateFlag(value: string, source: InputSource): FlagRead {\n  if (looksInline(value)) return parse(\"state\", value, \"inline\");\n  let text: string;\n  try {\n    text = value === \"-\" ? source.stdin() : source.file(value);\n  } catch {\n    return { ok: true, value };\n  }\n  const json = parse(\"state\", text, value);\n  return json.ok ? json : { ok: true, value: text };\n}\n"],"mappings":"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","names":["source"]}

package/dist/delete-2LZGYUPS.js

@@ -0,0 +1,66 @@
+import {
+  reportError,
+  reportInvalid
+} from "./chunk-XUNG5I2P.js";
+import {
+  testimonialsDeleteRequestSchema
+} from "./chunk-IDYAVGCS.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  apiPost
+} from "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-5WW456MW.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/delete.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "testimonials.delete",
+  description: "Remove one testimonial from the library, with the images it brought in. Applies immediately and cannot be undone \u2014 confirm with the user first; --dry-run previews.",
+  args: {
+    id: { type: "string", description: "Testimonial id from `testimonials list|search`", required: true },
+    "dry-run": { type: "boolean", description: "Preview without removing", required: false, default: false }
+  }
+});
+var deleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: "Remove one testimonial (and its images) from the library. Applies immediately \u2014 confirm with the user first.\n\nExample: baker testimonials delete <testimonial-id> --dry-run"
+  },
+  args: {
+    id: { type: "positional", description: "Testimonial id from `testimonials list|search`", required: true },
+    "dry-run": { type: "boolean", description: "Preview without removing", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    const parsed = testimonialsDeleteRequestSchema.safeParse({ id: String(args.id ?? "") });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    if (args["dry-run"]) {
+      writeJson({ ok: true, dryRun: true, operation: "testimonials.delete", params: parsed.data });
+      return;
+    }
+    try {
+      const data = await apiPost("/api/testimonials/delete", parsed.data);
+      writeJson({
+        ok: true,
+        data,
+        hints: [
+          "Already removed: publishing or discarding this chat will not bring it back. If its review page is still a source, the next import can add it again \u2014 remove the source to stop that."
+        ]
+      });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  deleteCommand
+};
+//# sourceMappingURL=delete-2LZGYUPS.js.map

package/dist/delete-7YUYMN6C.js

@@ -0,0 +1,69 @@
+import {
+  failAvatarApi,
+  failValidation,
+  removalHints
+} from "./chunk-2ACGDQ2P.js";
+import {
+  writeAvatars
+} from "./chunk-XLNVBDP2.js";
+import "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-5WW456MW.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/avatars/delete.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "avatars.delete",
+  description: "Remove an avatar. Prefer --archive: it retires the avatar so it stops showing in the roster and must not be cast again, while past work and @handle mentions still resolve. Without --archive the avatar is gone for good and the mention resolves nowhere. Confirm with the user first \u2014 this is their cast, and it is not yours to retire. --dry-run previews.",
+  args: {
+    handle: { type: "string", description: "Handle of the avatar to remove", required: true },
+    archive: {
+      type: "boolean",
+      description: "Retire it instead of deleting it \u2014 past work keeps resolving. Prefer this.",
+      required: false,
+      default: false
+    },
+    "dry-run": { type: "boolean", description: "Preview without removing anything", required: false, default: false }
+  }
+});
+var deleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: "Remove an avatar. Prefer --archive (retire, past work still resolves) over a hard delete. Example: baker avatars delete marta --archive --dry-run"
+  },
+  args: {
+    handle: { type: "positional", description: "Handle of the avatar to remove", required: false },
+    "avatar-handle": { type: "string", description: "Handle (alternative to positional)", required: false },
+    archive: { type: "boolean", description: "Retire instead of deleting", required: false, default: false },
+    "dry-run": { type: "boolean", description: "Preview without removing", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    const handle = (args.handle || args["avatar-handle"])?.trim();
+    if (!handle) {
+      failValidation("An avatar handle is required, e.g. `baker avatars delete marta --archive`.");
+    }
+    const archive = Boolean(args.archive);
+    if (args["dry-run"]) {
+      writeJson({ ok: true, dryRun: true, operation: "avatars.delete", params: { handle, archive } });
+      return;
+    }
+    try {
+      const data = await writeAvatars("/api/avatars/delete", {
+        handle,
+        ...archive ? { archive } : {}
+      });
+      writeJson({ ok: true, data, hints: removalHints({ handle: data.handle, archived: data.archived }) });
+    } catch (err) {
+      failAvatarApi(err, handle, { operation: "remove" });
+    }
+  }
+});
+export {
+  deleteCommand
+};
+//# sourceMappingURL=delete-7YUYMN6C.js.map