@koda-sl/baker-cli 0.466.0 → 0.468.0

package/dist/crop-VCP2JLQL.js

@@ -0,0 +1,113 @@
+import {
+  atomicWrite,
+  isRemoteUrl,
+  readImageBuffer,
+  resolveOutputPath
+} from "./chunk-BCSOWRQL.js";
+import "./chunk-SSVZM3P6.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/crop.ts
+import { defineCommand } from "citty";
+
+// src/lib/image/crop-sprite.ts
+import sharp from "sharp";
+function cropSprite(input, region) {
+  return sharp(input).extract({
+    left: Math.round(region.x),
+    top: Math.round(region.y),
+    width: Math.round(region.width),
+    height: Math.round(region.height)
+  }).png().toBuffer();
+}
+
+// src/commands/images/crop.ts
+registerSchema({
+  command: "images.crop",
+  description: "Crop a rectangular region from a local image or remote URL. Coordinate-based extract.",
+  args: {
+    file: { type: "string", description: "Local file path or remote http(s) URL", required: true },
+    x: { type: "number", description: "Left coordinate (px)", required: true },
+    y: { type: "number", description: "Top coordinate (px)", required: true },
+    width: { type: "number", description: "Region width (px)", required: true },
+    height: { type: "number", description: "Region height (px)", required: true },
+    output: {
+      type: "string",
+      description: "Output path. Default: in-place for local files, ./crop.png for URLs.",
+      required: false
+    }
+  }
+});
+var ValidationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ValidationError";
+  }
+};
+function parseRegion(args) {
+  const result = { x: 0, y: 0, width: 0, height: 0 };
+  for (const key of ["x", "y", "width", "height"]) {
+    const raw = args[key];
+    const n = typeof raw === "number" ? raw : raw !== void 0 && raw !== "" ? Number(raw) : Number.NaN;
+    if (!Number.isFinite(n) || n < 0) {
+      throw new ValidationError(`--${key} must be a non-negative number`);
+    }
+    result[key] = n;
+  }
+  if (result.width === 0 || result.height === 0) {
+    throw new ValidationError("--width and --height must be > 0");
+  }
+  return result;
+}
+function emitError(err) {
+  if (err instanceof ValidationError) {
+    writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: err.message } });
+  } else {
+    const message = err instanceof Error ? err.message : "Unexpected error";
+    writeJson({ ok: false, error: { code: "IMAGE_PROCESSING_ERROR", message } });
+  }
+  process.exit(1);
+}
+var cropCommand = defineCommand({
+  meta: {
+    name: "crop",
+    description: "Crop a rectangular region from an image.\n\nExample: baker images crop sprite.png --x 0 --y 0 --width 64 --height 64 --output icon.png"
+  },
+  args: {
+    file: { type: "positional", description: "Local file path or remote http(s) URL", required: false },
+    x: { type: "string", description: "Left coordinate (px)", required: false },
+    y: { type: "string", description: "Top coordinate (px)", required: false },
+    width: { type: "string", description: "Region width (px)", required: false },
+    height: { type: "string", description: "Region height (px)", required: false },
+    output: { type: "string", description: "Output path", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const file = args.file;
+      if (!file) {
+        throw new ValidationError("file argument is required");
+      }
+      const region = parseRegion(args);
+      const outputArg = typeof args.output === "string" && args.output.length > 0 ? args.output : void 0;
+      const inputBuffer = await readImageBuffer(file);
+      const output = await cropSprite(inputBuffer, region);
+      const outputPath = isRemoteUrl(file) ? outputArg ?? "./crop.png" : await resolveOutputPath(file, outputArg, { multipleInputs: false, newExtension: ".png" });
+      await atomicWrite(outputPath, output);
+      writeJson({
+        ok: true,
+        data: { input: file, output: outputPath, sizeBytes: output.length, region }
+      });
+    } catch (err) {
+      emitError(err);
+    }
+  }
+});
+export {
+  cropCommand
+};
+//# sourceMappingURL=crop-VCP2JLQL.js.map

package/dist/currency-WYOIOGMW.js

@@ -0,0 +1,88 @@
+import {
+  parseApiError
+} from "./chunk-5ZQ7S2P2.js";
+import "./chunk-7VHPAGPK.js";
+import {
+  cacheGet,
+  cacheSet,
+  getManagerIdForCustomer,
+  resolveCustomerId,
+  writeAdsJson
+} from "./chunk-6SL6463H.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema
+} from "./chunk-D3RTGIT4.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-WYOIOGMW.js.map

package/dist/custom-conversions-CIU525HM.js

@@ -0,0 +1,125 @@
+import {
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-4R3QKEDV.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-6SL6463H.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-T64IRDKW.js";
+import {
+  apiGet
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema
+} from "./chunk-D3RTGIT4.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-IJ5IFHS6.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-CIU525HM.js.map

package/dist/customers-T2B4B3KL.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-4SEWHOAH.js";
+import "./chunk-RVFB5JDH.js";
+import "./chunk-YT74ZEVP.js";
+import "./chunk-JZP5IODJ.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-JF5LNI6O.js";
+import "./chunk-F3IVR3V3.js";
+import "./chunk-CHSNHVYF.js";
+import "./chunk-4KBWL7S4.js";
+import "./chunk-DJPCTTUN.js";
+import "./chunk-BJEW3LST.js";
+import "./chunk-SSVZM3P6.js";
+import "./chunk-WXC3I4CT.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import "./chunk-D3RTGIT4.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-T2B4B3KL.js.map

package/dist/decide-NFTEKQKC.js

@@ -0,0 +1,199 @@
+import {
+  DECIDE_MAX_ITEMS,
+  DECIDE_MAX_ITEM_CHARS,
+  DECIDE_MAX_QUESTIONS,
+  DECIDE_MAX_REQUEST_CHARS,
+  decideRequestSchema,
+  isDecideLimitIssue
+} from "./chunk-GIWHHCD6.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-D3RTGIT4.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)) {
+    const json2 = parse("state", value, "inline");
+    return json2.ok ? json2 : { ok: true, value };
+  }
+  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, and one request carries the state plus one item's questions in ${DECIDE_MAX_REQUEST_CHARS} characters. Split the items across calls, ask fewer named questions per call, or trim each item and the state to what 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("; ");
+  fail("VALIDATION_ERROR", message, parsed.error.issues.some(isDecideLimitIssue) ? 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-NFTEKQKC.js.map

package/dist/decide-NFTEKQKC.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  DECIDE_MAX_REQUEST_CHARS,\n  type DecideRequestParsed,\n  type DecideResponse,\n  decideRequestSchema,\n  isDecideLimitIssue,\n} from \"@baker/api/decide\";\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, and one request carries the state plus one item's questions in ${DECIDE_MAX_REQUEST_CHARS} characters. Split the items across calls, ask fewer named questions per call, or trim each item and the state to what 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  // A smaller call fixes a size limit; anything else is input to correct.\n  fail(\"VALIDATION_ERROR\", message, parsed.error.issues.some(isDecideLimitIssue) ? 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; inline, 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)) {\n    const json = parse(\"state\", value, \"inline\");\n    return json.ok ? json : { ok: true, value };\n  }\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":";;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,oBAAoB;AAW7B,SAAS,qBAAqB;;;ACRvB,SAAS,YAAY,SAA8B,UAAoC;AAC5F,QAAM,QAAkB,CAAC;AACzB,MAAI,QAAQ,OAAO;AACjB,eAAW,CAAC,MAAM,QAAQ,KAAK,OAAO,QAAQ,QAAQ,SAAS,GAAG;AAChE,UAAI,CAAC,SAAS,SAAS,SAAS,QAAQ,GAAG;AACzC,cAAM;AAAA,UACJ,cAAc,IAAI;AAAA,QACpB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,MAAI,SAAS,WAAW,SAAS,GAAG;AAClC,UAAM;AAAA,MACJ,GAAG,SAAS,WAAW,MAAM,6BAA6B,SAAS,WAAW,MAAM,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC,GAAG,SAAS,WAAW,SAAS,KAAK,aAAQ,EAAE;AAAA,IACtJ;AAAA,EACF;AACA,SAAO;AACT;;;ACXA,IAAM,cAAc,CAAC,UAAkB,YAAY,KAAK,KAAK;AAE7D,SAAS,MAAM,MAAc,MAAc,MAAwB;AACjE,MAAI;AACF,WAAO,EAAE,IAAI,MAAM,OAAO,KAAK,MAAM,IAAI,EAAE;AAAA,EAC7C,SAAS,OAAO;AACd,UAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACpE,WAAO,EAAE,IAAI,OAAO,SAAS,KAAK,IAAI,uBAAuB,IAAI,MAAM,MAAM,GAAG;AAAA,EAClF;AACF;AAGO,SAAS,aAAa,MAAc,OAAeA,SAA+B;AACvF,MAAI,UAAU,IAAK,QAAO,MAAM,MAAMA,QAAO,MAAM,GAAG,OAAO;AAC7D,MAAI,YAAY,KAAK,EAAG,QAAO,MAAM,MAAM,OAAO,QAAQ;AAC1D,MAAI;AACJ,MAAI;AACF,WAAOA,QAAO,KAAK,KAAK;AAAA,EAC1B,SAAS,OAAO;AACd,UAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACpE,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,SAAS,KAAK,IAAI,iBAAiB,KAAK,KAAK,MAAM;AAAA,IACrD;AAAA,EACF;AACA,SAAO,MAAM,MAAM,MAAM,KAAK;AAChC;AAGO,SAAS,cAAc,OAAeA,SAA+B;AAC1E,MAAI,YAAY,KAAK,GAAG;AACtB,UAAMC,QAAO,MAAM,SAAS,OAAO,QAAQ;AAC3C,WAAOA,MAAK,KAAKA,QAAO,EAAE,IAAI,MAAM,MAAM;AAAA,EAC5C;AACA,MAAI;AACJ,MAAI;AACF,WAAO,UAAU,MAAMD,QAAO,MAAM,IAAIA,QAAO,KAAK,KAAK;AAAA,EAC3D,QAAQ;AACN,WAAO,EAAE,IAAI,MAAM,MAAM;AAAA,EAC3B;AACA,QAAM,OAAO,MAAM,SAAS,MAAM,KAAK;AACvC,SAAO,KAAK,KAAK,OAAO,EAAE,IAAI,MAAM,OAAO,KAAK;AAClD;;;AFjCA,IAAM,OAAO;AAAA,EACX,WAAW;AAAA,IACT,MAAM;AAAA,IACN,aACE;AAAA,IACF,UAAU;AAAA,EACZ;AAAA,EACA,OAAO;AAAA,IACL,MAAM;AAAA,IACN,aAAa,2KAAuJ,gBAAgB,WAAW,qBAAqB,qBAAqB,oBAAoB;AAAA,IAC7P,UAAU;AAAA,EACZ;AAAA,EACA,OAAO;AAAA,IACL,MAAM;AAAA,IACN,aACE;AAAA,IACF,UAAU;AAAA,EACZ;AAAA,EACA,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,IACF,UAAU;AAAA,IACV,SAAS;AAAA,EACX;AACF;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AACR,CAAC;AAED,IAAM,SAAsB;AAAA,EAC1B,MAAM,CAAC,SAAS,aAAa,MAAM,OAAO;AAAA,EAC1C,OAAO,MAAM,aAAa,GAAG,OAAO;AACtC;AAEA,SAAS,KAAK,MAAc,SAAiB,KAAqD;AAChG,YAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,SAAS,IAAI,EAAE,CAAC;AACtD,UAAQ,KAAK,CAAC;AAChB;AAEA,IAAM,YAAY;AAAA,EAChB,QAAQ;AAAA,EACR,aACE;AACJ;AAEA,IAAM,YAAY;AAAA,EAChB,QAAQ;AAAA,EACR,aAAa,yBAAyB,oBAAoB,4CAAyC,gBAAgB,aAAa,qBAAqB,+EAA+E,wBAAwB;AAC9P;AAEA,IAAM,cAAc;AAAA,EAClB,QAAQ;AAAA,EACR,aACE;AACJ;AAEA,SAAS,SAAS,MAAqC;AACrD,MAAI,QAAQ,CAAC,KAAK,GAAI,MAAK,oBAAoB,KAAK,SAAS,SAAS;AACtE,SAAO,MAAM;AACf;AAGA,SAAS,YAAY,MAKG;AACtB,QAAM,YAAY,SAAS,aAAa,aAAa,OAAO,KAAK,SAAS,GAAG,MAAM,CAAC;AACpF,QAAM,QAAQ,SAAS,OAAO,KAAK,UAAU,WAAW,aAAa,SAAS,KAAK,OAAO,MAAM,IAAI,MAAS;AAC7G,QAAM,QAAQ,SAAS,OAAO,KAAK,UAAU,WAAW,cAAc,KAAK,OAAO,MAAM,IAAI,MAAS;AACrG,QAAM,SAAS,oBAAoB,UAAU;AAAA,IAC3C;AAAA,IACA,GAAI,UAAU,SAAY,CAAC,IAAI,EAAE,MAAM;AAAA,IACvC,GAAI,UAAU,SAAY,CAAC,IAAI,EAAE,MAAM;AAAA,IACvC,MAAM,KAAK,SAAS;AAAA,EACtB,CAAC;AACD,MAAI,OAAO,QAAS,QAAO,OAAO;AAClC,QAAM,UAAU,OAAO,MAAM,OAC1B,MAAM,GAAG,CAAC,EACV,IAAI,CAAC,UAAU,GAAG,MAAM,KAAK,KAAK,GAAG,KAAK,SAAS,KAAK,MAAM,OAAO,EAAE,EACvE,KAAK,IAAI;AAEZ,OAAK,oBAAoB,SAAS,OAAO,MAAM,OAAO,KAAK,kBAAkB,IAAI,YAAY,SAAS;AACxG;AAEA,SAAS,YAAY,KAAqB;AACxC,QAAM,OAAO,eAAe,WAAW,IAAI,OAAO;AAClD,QAAM,UAAU,eAAe,QAAQ,IAAI,UAAU;AACrD,MAAI,SAAS,iBAAiB,SAAS,UAAW,MAAK,MAAM,SAAS,WAAW;AACjF,MAAI,SAAS,mBAAoB,MAAK,MAAM,SAAS,SAAS;AAC9D,YAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,QAAQ,EAAE,CAAC;AACjD,UAAQ,KAAK,CAAC;AAChB;AAEO,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAef;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,UAAU,YAAY,IAAI;AAChC,QAAI;AACF,YAAM,OAAO,MAAM,QAAwB,eAAe,SAAS,EAAE,WAAW,KAAQ,CAAC;AACzF,YAAM,QAAQ,YAAY,SAAS,IAAI;AACvC,gBAAU;AAAA,QACR,IAAI;AAAA,QACJ;AAAA,QACA,GAAI,KAAK,QAAQ,EAAE,MAAM,EAAE,OAAO,KAAK,MAAM,OAAO,EAAE,IAAI,CAAC;AAAA,QAC3D,GAAI,MAAM,SAAS,IAAI,EAAE,MAAM,IAAI,CAAC;AAAA,MACtC,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,kBAAY,GAAG;AAAA,IACjB;AAAA,EACF;AACF,CAAC;","names":["source","json"]}