@koda-sl/baker-cli 0.386.0-dev.4e118c09a → 0.386.0-dev.d6e55699d

package/dist/chunk-M4PPFVYL.js

@@ -0,0 +1,346 @@
+import {
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-PAHLJMC3.js";
+import {
+  adCopyHints,
+  booleanWordPositionalError,
+  capabilityFix
+} from "./chunk-6I7SYEYN.js";
+import {
+  withHints
+} from "./chunk-D5FY4FAK.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-BVM5IRZW.js";
+import {
+  LINKEDIN_DRAFT_BATCH_MAX,
+  linkedinDraftOpInputSchema
+} from "./chunk-KRIK2JR4.js";
+import {
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import {
+  requireChatId
+} from "./chunk-O6QKCJE4.js";
+
+// src/commands/ads/linkedin/write-shared.ts
+import { createHash } from "crypto";
+import { readFileSync } from "fs";
+var TOTAL_BUDGET_HELP = "Lifetime budget \u2014 on something already running it must exceed spend to date, or LinkedIn rejects it";
+function bareAccountId(args) {
+  const raw = resolveAccountIdArg(args);
+  return raw.replace(/^urn:li:sponsoredAccount:/, "").replace(/^sponsoredAccount:/, "");
+}
+function failWriteValidation(message) {
+  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function loadJsonFileArg(path) {
+  if (typeof path !== "string" || path.length === 0) {
+    return {};
+  }
+  try {
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+      failWriteValidation(`${path} must contain a JSON object`);
+    }
+    return parsed;
+  } catch (err) {
+    if (err instanceof SyntaxError) {
+      failWriteValidation(`${path} is not valid JSON: ${err.message}`);
+    }
+    throw err;
+  }
+}
+function mergePayload(file, flags) {
+  const merged = { ...file };
+  for (const [key, value] of Object.entries(flags)) {
+    if (value !== void 0) {
+      merged[key] = value;
+    }
+  }
+  return merged;
+}
+function loadPatchArg(args) {
+  const file = typeof args.file === "string" && args.file.length > 0 ? args.file : void 0;
+  const inline = typeof args.patch === "string" && args.patch.length > 0 ? args.patch : void 0;
+  if (Boolean(file) === Boolean(inline)) {
+    failWriteValidation("pass exactly one of --file <patch.json> or --patch '<json>'");
+  }
+  if (file) {
+    return loadJsonFileArg(file);
+  }
+  try {
+    const parsed = JSON.parse(inline);
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+      failWriteValidation("--patch must be a JSON object");
+    }
+    return parsed;
+  } catch (err) {
+    if (err instanceof SyntaxError) {
+      failWriteValidation(`--patch is not valid JSON: ${err.message}`);
+    }
+    throw err;
+  }
+}
+function parseMoneyFlag(amount, currency, flag) {
+  if (amount === void 0 || amount === null || amount === "") {
+    return void 0;
+  }
+  if (currency === void 0 || currency === null || currency === "") {
+    return { amount: String(amount) };
+  }
+  if (typeof currency !== "string" || currency.length !== 3) {
+    failWriteValidation(`${flag} got an invalid --currency (expected a 3-letter code like EUR)`);
+  }
+  return { amount: String(amount), currencyCode: currency.toUpperCase() };
+}
+function parseDateFlag(value, flag) {
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
+  }
+  const raw = String(value);
+  if (/^\d{10,}$/.test(raw)) {
+    return Number(raw);
+  }
+  const parsed = Date.parse(raw);
+  if (Number.isNaN(parsed)) {
+    failWriteValidation(`${flag} must be an ISO date (2026-07-10) or epoch milliseconds`);
+  }
+  return parsed;
+}
+function parseOnOffFlag(value, flag) {
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
+  }
+  const raw = String(value).toLowerCase();
+  if (raw === "on" || raw === "true") {
+    return true;
+  }
+  if (raw === "off" || raw === "false") {
+    return false;
+  }
+  failWriteValidation(`${flag} must be on|off`);
+}
+function parseLocaleFlag(value) {
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
+  }
+  const match = /^([a-z]{2})[_-]([A-Za-z]{2})$/.exec(String(value));
+  if (!match) {
+    failWriteValidation("--locale must look like en_US (language_COUNTRY)");
+  }
+  return { language: match[1], country: match[2].toUpperCase() };
+}
+function loadTargetingFileArg(path) {
+  if (typeof path !== "string" || path.length === 0) {
+    return void 0;
+  }
+  const parsed = loadJsonFileArg(path);
+  const criteria = parsed.targetingCriteria ?? parsed;
+  if (!criteria.include) {
+    failWriteValidation(
+      `${path} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
+    );
+  }
+  return criteria;
+}
+function sha256Lower(value) {
+  return createHash("sha256").update(value.trim().toLowerCase()).digest("hex");
+}
+function parseCsvLine(line) {
+  const cells = [];
+  let current = "";
+  let inQuotes = false;
+  for (let i = 0; i < line.length; i++) {
+    const char = line[i];
+    if (inQuotes) {
+      if (char === '"' && line[i + 1] === '"') {
+        current += '"';
+        i++;
+      } else if (char === '"') {
+        inQuotes = false;
+      } else {
+        current += char;
+      }
+    } else if (char === '"') {
+      inQuotes = true;
+    } else if (char === ",") {
+      cells.push(current);
+      current = "";
+    } else {
+      current += char;
+    }
+  }
+  cells.push(current);
+  return cells.map((cell) => cell.trim());
+}
+function parseListFileArg(path, maxRows) {
+  if (typeof path !== "string" || path.length === 0) {
+    return void 0;
+  }
+  const raw = readFileSync(path, "utf8");
+  const lines = raw.split(/\r?\n/).filter((line) => line.trim().length > 0);
+  if (lines.length < 2) {
+    failWriteValidation(`${path} needs a header row and at least one data row`);
+  }
+  const columns = parseCsvLine(lines[0]).map((column) => column.trim());
+  const rows = [];
+  for (const line of lines.slice(1)) {
+    const cells = parseCsvLine(line);
+    const row = {};
+    columns.forEach((column, index) => {
+      const value = cells[index] ?? "";
+      if (!value) {
+        return;
+      }
+      row[column] = column.toLowerCase() === "email" ? sha256Lower(value) : value;
+    });
+    if (Object.keys(row).length > 0) {
+      rows.push(row);
+    }
+  }
+  if (rows.length > maxRows) {
+    failWriteValidation(`${path} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
+  }
+  return { columns, rows };
+}
+function failPreflight(fields) {
+  writeJsonEnvelope({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: fields.map((field) => field.path ? `${field.path}: ${field.message}` : field.message).join("; "),
+      fields,
+      fix: capabilityFix("linkedin-ads")
+    }
+  });
+  process.exit(1);
+}
+var BATCH_NUDGE = "This command takes several ids at once \u2014 pass them comma-separated or with --ids-file instead of one call per id.";
+function batchNudge(data) {
+  return data.sameKindStaged === void 0 ? [] : [BATCH_NUDGE];
+}
+async function stageOp(raw, hints) {
+  const preflight = linkedinDraftOpInputSchema.safeParse(raw);
+  if (!preflight.success) {
+    failPreflight(preflight.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message })));
+  }
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/ads/linkedin/draft/stage", {
+      chatId,
+      op: preflight.data
+    });
+    const allHints = [...batchNudge(response.data), ...hints ?? [], ...await adCopyHints(preflight.data)];
+    writeJsonEnvelope(withHints(response, allHints));
+  } catch (err) {
+    handleLinkedinError(err);
+  }
+}
+async function stageLinkedinOps(rawOps, hints) {
+  if (rawOps.length === 1 && rawOps[0]) {
+    await stageOp(rawOps[0], hints);
+    return;
+  }
+  const ops = [];
+  for (const [index, raw] of rawOps.entries()) {
+    const preflight = linkedinDraftOpInputSchema.safeParse(raw);
+    if (!preflight.success) {
+      failPreflight(
+        preflight.error.issues.map((issue) => ({
+          path: `ops[${index}]${issue.path.length > 0 ? `.${issue.path.join(".")}` : ""}`,
+          message: issue.message
+        }))
+      );
+    }
+    ops.push(preflight.data);
+  }
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/ads/linkedin/draft/stage-batch", { chatId, ops });
+    const allHints = [...hints ?? [], ...await adCopyHints(ops)];
+    writeJsonEnvelope(withHints(response, allHints));
+  } catch (err) {
+    handleLinkedinError(err);
+  }
+}
+async function stageStatusChange(input) {
+  const payload = input.kind === "creative.update" ? { intendedStatus: input.status } : { status: input.status };
+  await stageLinkedinOps(
+    input.targets.map((target) => ({ kind: input.kind, accountId: input.accountId, target, payload }))
+  );
+}
+function requireTarget(args, entity) {
+  const inverted = booleanWordPositionalError(args, entity);
+  if (inverted !== void 0) {
+    failWriteValidation(inverted);
+  }
+  const positionals = readPositionals(args);
+  const target = args.id ?? args.target ?? args.ref ?? positionals[0];
+  if (typeof target !== "string" || target.length === 0) {
+    failWriteValidation(`pass the ${entity} id or URN as the positional argument`);
+  }
+  if (positionals.length > 1 || splitIdList(target).length > 1) {
+    failWriteValidation(
+      `this command takes one ${entity} id \u2014 run it once per id. Only pause/resume/archive and 'creatives update' accept several ids in one call.`
+    );
+  }
+  return target;
+}
+function readPositionals(args) {
+  if (!Array.isArray(args._)) {
+    return [];
+  }
+  return args._.filter((value) => typeof value === "string" && value.length > 0);
+}
+function splitIdList(raw) {
+  return raw.split(",").map((id) => id.trim()).filter(Boolean);
+}
+function idsFileEntries(path) {
+  if (typeof path !== "string" || path.length === 0) {
+    return [];
+  }
+  return readFileSync(path, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).flatMap(splitIdList);
+}
+function requireTargets(args, entity) {
+  const positionals = readPositionals(args);
+  const named = [args.id, args.target, args.ref].filter(
+    (value) => typeof value === "string" && value.length > 0
+  );
+  const fromArgs = positionals.length > 0 ? positionals : named;
+  const targets = [.../* @__PURE__ */ new Set([...fromArgs.flatMap(splitIdList), ...idsFileEntries(args["ids-file"])])];
+  if (targets.length === 0) {
+    failWriteValidation(
+      `pass the ${entity} id or URN as the positional argument (comma-separated for several), or --ids-file <path>`
+    );
+  }
+  if (targets.length > LINKEDIN_DRAFT_BATCH_MAX) {
+    failWriteValidation(
+      `${targets.length} ids exceeds the batch limit of ${LINKEDIN_DRAFT_BATCH_MAX} \u2014 split the list`
+    );
+  }
+  return targets;
+}
+
+export {
+  TOTAL_BUDGET_HELP,
+  bareAccountId,
+  failWriteValidation,
+  loadJsonFileArg,
+  mergePayload,
+  loadPatchArg,
+  parseMoneyFlag,
+  parseDateFlag,
+  parseOnOffFlag,
+  parseLocaleFlag,
+  loadTargetingFileArg,
+  parseListFileArg,
+  stageOp,
+  stageLinkedinOps,
+  stageStatusChange,
+  requireTarget,
+  requireTargets
+};
+//# sourceMappingURL=chunk-M4PPFVYL.js.map

package/dist/chunk-M4PPFVYL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/write-shared.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { readFileSync } from \"node:fs\";\nimport {\n  LINKEDIN_DRAFT_BATCH_MAX,\n  type LinkedinDraftStageBatchResponse,\n  type LinkedinDraftStageResponse,\n  linkedinDraftOpInputSchema,\n} from \"@baker/api\";\nimport { apiPost } from \"../../../client.ts\";\nimport { requireChatId } from \"../../../env.ts\";\nimport { capabilityFix } from \"../../capabilities/fix.ts\";\nimport { booleanWordPositionalError } from \"../boolean-word-positional.ts\";\nimport { adCopyHints } from \"../copy-hints.ts\";\nimport { withHints } from \"../hints.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { handleLinkedinError, resolveAccountIdArg } from \"./shared.ts\";\n\n/**\n * Shared plumbing for the staged write commands. Writes NEVER hit LinkedIn\n * directly: every command stages an op against this chat's draft\n * (`/api/ads/linkedin/draft/stage`), the dashboard shows it as a pending\n * LinkedIn change, and it applies when the chat is published.\n */\n\n/**\n * LinkedIn rejects a lifetime budget at or below what the entity has already\n * spent, so the flag needs the constraint wherever it is offered — the same\n * text on every surface (`--help` and `baker schema`) so the two can't drift.\n */\nexport const TOTAL_BUDGET_HELP =\n  \"Lifetime budget — on something already running it must exceed spend to date, or LinkedIn rejects it\";\n\nexport function bareAccountId(args: Record<string, unknown>): string {\n  const raw = resolveAccountIdArg(args);\n  return raw.replace(/^urn:li:sponsoredAccount:/, \"\").replace(/^sponsoredAccount:/, \"\");\n}\n\nexport function failWriteValidation(message: string): never {\n  writeJsonEnvelope({ ok: false, error: { code: \"VALIDATION_ERROR\", message } });\n  process.exit(1);\n}\n\nexport function loadJsonFileArg(path: unknown): Record<string, unknown> {\n  if (typeof path !== \"string\" || path.length === 0) {\n    return {};\n  }\n  try {\n    const parsed = JSON.parse(readFileSync(path, \"utf8\")) as unknown;\n    if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      failWriteValidation(`${path} must contain a JSON object`);\n    }\n    return parsed as Record<string, unknown>;\n  } catch (err) {\n    if (err instanceof SyntaxError) {\n      failWriteValidation(`${path} is not valid JSON: ${err.message}`);\n    }\n    throw err;\n  }\n}\n\n/** Flags override file keys — the file is the base, flags are the overrides. */\nexport function mergePayload(file: Record<string, unknown>, flags: Record<string, unknown>): Record<string, unknown> {\n  const merged: Record<string, unknown> = { ...file };\n  for (const [key, value] of Object.entries(flags)) {\n    if (value !== undefined) {\n      merged[key] = value;\n    }\n  }\n  return merged;\n}\n\n/**\n * The `draft amend` patch: exactly one of `--file <path>` (JSON file) or `--patch '<json>'`\n * (inline string), and it must parse to a JSON object — RFC-7386 merge-patch needs an object to\n * merge, and a stray array/scalar would silently no-op or replace the whole payload.\n */\nexport function loadPatchArg(args: Record<string, unknown>): Record<string, unknown> {\n  const file = typeof args.file === \"string\" && args.file.length > 0 ? args.file : undefined;\n  const inline = typeof args.patch === \"string\" && args.patch.length > 0 ? args.patch : undefined;\n  if (Boolean(file) === Boolean(inline)) {\n    failWriteValidation(\"pass exactly one of --file <patch.json> or --patch '<json>'\");\n  }\n  if (file) {\n    return loadJsonFileArg(file);\n  }\n  try {\n    const parsed = JSON.parse(inline as string) as unknown;\n    if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      failWriteValidation(\"--patch must be a JSON object\");\n    }\n    return parsed as Record<string, unknown>;\n  } catch (err) {\n    if (err instanceof SyntaxError) {\n      failWriteValidation(`--patch is not valid JSON: ${err.message}`);\n    }\n    throw err;\n  }\n}\n\nexport function parseMoneyFlag(\n  amount: unknown,\n  currency: unknown,\n  flag: string,\n): { amount: string; currencyCode?: string } | undefined {\n  if (amount === undefined || amount === null || amount === \"\") {\n    return undefined;\n  }\n  if (currency === undefined || currency === null || currency === \"\") {\n    // LinkedIn ad accounts are single-currency — the backend fills it in.\n    return { amount: String(amount) };\n  }\n  if (typeof currency !== \"string\" || currency.length !== 3) {\n    failWriteValidation(`${flag} got an invalid --currency (expected a 3-letter code like EUR)`);\n  }\n  return { amount: String(amount), currencyCode: currency.toUpperCase() };\n}\n\n/** Accepts ISO dates (2026-07-10), ISO datetimes, or epoch millis. */\nexport function parseDateFlag(value: unknown, flag: string): number | undefined {\n  if (value === undefined || value === null || value === \"\") {\n    return undefined;\n  }\n  const raw = String(value);\n  if (/^\\d{10,}$/.test(raw)) {\n    return Number(raw);\n  }\n  const parsed = Date.parse(raw);\n  if (Number.isNaN(parsed)) {\n    failWriteValidation(`${flag} must be an ISO date (2026-07-10) or epoch milliseconds`);\n  }\n  return parsed;\n}\n\nexport function parseOnOffFlag(value: unknown, flag: string): boolean | undefined {\n  if (value === undefined || value === null || value === \"\") {\n    return undefined;\n  }\n  const raw = String(value).toLowerCase();\n  if (raw === \"on\" || raw === \"true\") {\n    return true;\n  }\n  if (raw === \"off\" || raw === \"false\") {\n    return false;\n  }\n  failWriteValidation(`${flag} must be on|off`);\n}\n\nexport function parseLocaleFlag(value: unknown): { country: string; language: string } | undefined {\n  if (value === undefined || value === null || value === \"\") {\n    return undefined;\n  }\n  const match = /^([a-z]{2})[_-]([A-Za-z]{2})$/.exec(String(value));\n  if (!match) {\n    failWriteValidation(\"--locale must look like en_US (language_COUNTRY)\");\n  }\n  return { language: match[1] as string, country: (match[2] as string).toUpperCase() };\n}\n\nexport function loadTargetingFileArg(path: unknown): Record<string, unknown> | undefined {\n  if (typeof path !== \"string\" || path.length === 0) {\n    return undefined;\n  }\n  const parsed = loadJsonFileArg(path);\n  // Accept either the bare criteria object or a { targetingCriteria } wrapper.\n  const criteria = (parsed.targetingCriteria as Record<string, unknown> | undefined) ?? parsed;\n  if (!criteria.include) {\n    failWriteValidation(\n      `${path} must contain targeting criteria with an \"include\" block (see baker schema ads.linkedin.campaigns.create)`,\n    );\n  }\n  return criteria;\n}\n\nfunction sha256Lower(value: string): string {\n  return createHash(\"sha256\").update(value.trim().toLowerCase()).digest(\"hex\");\n}\n\nfunction parseCsvLine(line: string): string[] {\n  const cells: string[] = [];\n  let current = \"\";\n  let inQuotes = false;\n  for (let i = 0; i < line.length; i++) {\n    const char = line[i];\n    if (inQuotes) {\n      if (char === '\"' && line[i + 1] === '\"') {\n        current += '\"';\n        i++;\n      } else if (char === '\"') {\n        inQuotes = false;\n      } else {\n        current += char;\n      }\n    } else if (char === '\"') {\n      inQuotes = true;\n    } else if (char === \",\") {\n      cells.push(current);\n      current = \"\";\n    } else {\n      current += char;\n    }\n  }\n  cells.push(current);\n  return cells.map((cell) => cell.trim());\n}\n\nexport interface ParsedList {\n  columns: string[];\n  rows: Array<Record<string, string>>;\n}\n\n/**\n * Parses a header-first CSV into row objects. Email columns are SHA-256\n * hashed here so raw addresses never leave the machine or sit in the draft.\n */\nexport function parseListFileArg(path: unknown, maxRows: number): ParsedList | undefined {\n  if (typeof path !== \"string\" || path.length === 0) {\n    return undefined;\n  }\n  const raw = readFileSync(path, \"utf8\");\n  const lines = raw.split(/\\r?\\n/).filter((line) => line.trim().length > 0);\n  if (lines.length < 2) {\n    failWriteValidation(`${path} needs a header row and at least one data row`);\n  }\n  const columns = parseCsvLine(lines[0] as string).map((column) => column.trim());\n  const rows: Array<Record<string, string>> = [];\n  for (const line of lines.slice(1)) {\n    const cells = parseCsvLine(line);\n    const row: Record<string, string> = {};\n    columns.forEach((column, index) => {\n      const value = cells[index] ?? \"\";\n      if (!value) {\n        return;\n      }\n      row[column] = column.toLowerCase() === \"email\" ? sha256Lower(value) : value;\n    });\n    if (Object.keys(row).length > 0) {\n      rows.push(row);\n    }\n  }\n  if (rows.length > maxRows) {\n    failWriteValidation(`${path} has ${rows.length} rows — the inline limit is ${maxRows}. Split the list.`);\n  }\n  return { columns, rows };\n}\n\ninterface StageEnvelope extends Record<string, unknown> {\n  ok: true;\n  data: LinkedinDraftStageResponse;\n}\n\n/** Structured preflight failure — the agent learns WHICH field (and, in a batch, which op) is wrong. */\nfunction failPreflight(fields: Array<{ path: string; message: string }>): never {\n  writeJsonEnvelope({\n    ok: false,\n    error: {\n      code: \"VALIDATION_ERROR\",\n      message: fields.map((field) => (field.path ? `${field.path}: ${field.message}` : field.message)).join(\"; \"),\n      fields,\n      fix: capabilityFix(\"linkedin-ads\"),\n    },\n  });\n  process.exit(1);\n}\n\n/**\n * The agent is staging one id per call for a kind it has already staged in this\n * draft — the exact loop these commands' id lists exist to replace.\n */\nconst BATCH_NUDGE =\n  \"This command takes several ids at once — pass them comma-separated or with --ids-file instead of one call per id.\";\n\nfunction batchNudge(data: LinkedinDraftStageResponse): string[] {\n  return data.sameKindStaged === undefined ? [] : [BATCH_NUDGE];\n}\n\n/**\n * Preflight-validates the op against the shared `@baker/api` contract (same\n * schema the backend enforces), then stages it. Prints the staged envelope —\n * ref, mode (always `live`: publishing reaches the real ad account), summary,\n * warnings.\n */\nexport async function stageOp(raw: Record<string, unknown>, hints?: string[]): Promise<void> {\n  const preflight = linkedinDraftOpInputSchema.safeParse(raw);\n  if (!preflight.success) {\n    failPreflight(preflight.error.issues.map((issue) => ({ path: issue.path.join(\".\"), message: issue.message })));\n  }\n  try {\n    const chatId = requireChatId();\n    const response = await apiPost<StageEnvelope>(\"/api/ads/linkedin/draft/stage\", {\n      chatId,\n      op: preflight.data,\n    });\n    const allHints = [...batchNudge(response.data), ...(hints ?? []), ...(await adCopyHints(preflight.data))];\n    writeJsonEnvelope(withHints(response, allHints));\n  } catch (err) {\n    handleLinkedinError(err);\n  }\n}\n\ninterface StageBatchEnvelope extends Record<string, unknown> {\n  ok: true;\n  data: LinkedinDraftStageBatchResponse;\n}\n\n/**\n * Stage several ops as ONE request (`/stage-batch`) — all-or-nothing on the\n * backend, one rate-limit hit instead of one per id. A single op falls through to\n * the plain stage path so its envelope, its amend behaviour and its hints stay\n * exactly as before.\n */\nexport async function stageLinkedinOps(rawOps: Array<Record<string, unknown>>, hints?: string[]): Promise<void> {\n  if (rawOps.length === 1 && rawOps[0]) {\n    await stageOp(rawOps[0], hints);\n    return;\n  }\n  const ops: unknown[] = [];\n  for (const [index, raw] of rawOps.entries()) {\n    const preflight = linkedinDraftOpInputSchema.safeParse(raw);\n    if (!preflight.success) {\n      failPreflight(\n        preflight.error.issues.map((issue) => ({\n          path: `ops[${index}]${issue.path.length > 0 ? `.${issue.path.join(\".\")}` : \"\"}`,\n          message: issue.message,\n        })),\n      );\n    }\n    ops.push(preflight.data);\n  }\n  try {\n    const chatId = requireChatId();\n    const response = await apiPost<StageBatchEnvelope>(\"/api/ads/linkedin/draft/stage-batch\", { chatId, ops });\n    const allHints = [...(hints ?? []), ...(await adCopyHints(ops))];\n    writeJsonEnvelope(withHints(response, allHints));\n  } catch (err) {\n    handleLinkedinError(err);\n  }\n}\n\nexport async function stageStatusChange(input: {\n  kind: \"campaignGroup.update\" | \"campaign.update\" | \"creative.update\";\n  accountId: string;\n  targets: string[];\n  status: \"ACTIVE\" | \"PAUSED\" | \"ARCHIVED\";\n}): Promise<void> {\n  const payload = input.kind === \"creative.update\" ? { intendedStatus: input.status } : { status: input.status };\n  await stageLinkedinOps(\n    input.targets.map((target) => ({ kind: input.kind, accountId: input.accountId, target, payload })),\n  );\n}\n\n/**\n * Reads the target from whichever positional the command declared. Commands\n * name it `id` (entity writes) or `ref` (draft show/amend), and citty also\n * leaves every positional in `args._` — so we accept all three rather than\n * making the receipt depend on one command's arg name.\n *\n * `--flag false` is refused BEFORE the one-id check below, which would otherwise\n * blame the stray word on a second id: on `campaigns url-params 123456 --clear\n * false` that sends the agent back with `--clear` alone, which is TRUE again and\n * wipes every tracking parameter on a live ad set.\n */\nexport function requireTarget(args: Record<string, unknown>, entity: string): string {\n  const inverted = booleanWordPositionalError(args, entity);\n  if (inverted !== undefined) {\n    failWriteValidation(inverted);\n  }\n  const positionals = readPositionals(args);\n  const target = args.id ?? args.target ?? args.ref ?? positionals[0];\n  if (typeof target !== \"string\" || target.length === 0) {\n    failWriteValidation(`pass the ${entity} id or URN as the positional argument`);\n  }\n  // This command applies one payload to one id. Accepting the first of several and\n  // dropping the rest would report success for work it never staged, so say so.\n  if (positionals.length > 1 || splitIdList(target).length > 1) {\n    failWriteValidation(\n      `this command takes one ${entity} id — run it once per id. Only pause/resume/archive and 'creatives update' accept several ids in one call.`,\n    );\n  }\n  return target;\n}\n\n/** Every positional citty left in `_`, as strings. Numeric ids arrive as strings via `node:util parseArgs`. */\nfunction readPositionals(args: Record<string, unknown>): string[] {\n  if (!Array.isArray(args._)) {\n    return [];\n  }\n  return args._.filter((value): value is string => typeof value === \"string\" && value.length > 0);\n}\n\n/** Ids in the positional: `123,456` or `urn:li:sponsoredCreative:1, urn:…:2` (URNs never contain commas). */\nfunction splitIdList(raw: string): string[] {\n  return raw\n    .split(\",\")\n    .map((id) => id.trim())\n    .filter(Boolean);\n}\n\n/**\n * `--ids-file` lines: one id per line, or comma-separated on a line — the agent\n * writes whichever is convenient. Blank lines and `#` comments are skipped.\n */\nfunction idsFileEntries(path: unknown): string[] {\n  if (typeof path !== \"string\" || path.length === 0) {\n    return [];\n  }\n  return readFileSync(path, \"utf8\")\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0 && !line.startsWith(\"#\"))\n    .flatMap(splitIdList);\n}\n\n/**\n * Every id a write command was invoked with: **all** positionals (each of which may\n * itself be comma-separated) plus `--ids-file` lines, deduped in first-seen order.\n * One id stages exactly as before; several stage as one batch.\n *\n * All positionals, not just the first: an agent writing `creatives pause 111 222 333`\n * — space-separated, as most CLIs accept — used to stage one op and be told `ok: true`,\n * so it believed three ads were paused.\n */\nexport function requireTargets(args: Record<string, unknown>, entity: string): string[] {\n  // `args._` is the superset: citty copies the FIRST positional into the declared\n  // arg (`id`/`ref`) but leaves every positional in `_`. Reading the named arg alone\n  // is what dropped ids 2..n. The named arg is the fallback for a command that ever\n  // declares its id as a flag instead, where `_` would be empty.\n  const positionals = readPositionals(args);\n  const named = [args.id, args.target, args.ref].filter(\n    (value): value is string => typeof value === \"string\" && value.length > 0,\n  );\n  const fromArgs = positionals.length > 0 ? positionals : named;\n  const targets = [...new Set([...fromArgs.flatMap(splitIdList), ...idsFileEntries(args[\"ids-file\"])])];\n  if (targets.length === 0) {\n    failWriteValidation(\n      `pass the ${entity} id or URN as the positional argument (comma-separated for several), or --ids-file <path>`,\n    );\n  }\n  if (targets.length > LINKEDIN_DRAFT_BATCH_MAX) {\n    failWriteValidation(\n      `${targets.length} ids exceeds the batch limit of ${LINKEDIN_DRAFT_BATCH_MAX} — split the list`,\n    );\n  }\n  return targets;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-M6UNISGO.js

@@ -0,0 +1,66 @@
+// src/commands/ads/x/error-parser.ts
+function mapXErrorCode(message) {
+  if (/UNAUTHORIZED_ACCESS|authentication/i.test(message)) return "AUTH_ERROR";
+  if (/UNAUTHORIZED_CLIENT_APPLICATION/i.test(message)) return "PERMISSION_DENIED";
+  if (/ACCOUNT_NOT_FOUND|NOT_FOUND/i.test(message)) return "ACCOUNT_NOT_FOUND";
+  if (/CAMPAIGN_NOT_FOUND/i.test(message)) return "CAMPAIGN_NOT_FOUND";
+  if (/LINE_ITEM_NOT_FOUND/i.test(message)) return "LINE_ITEM_NOT_FOUND";
+  if (/MEDIA_NOT_FOUND|TWEET_NOT_FOUND|TAILORED_AUDIENCE_NOT_FOUND/i.test(message)) return "RESOURCE_NOT_FOUND";
+  if (/TOO_MANY_REQUESTS|TWEET_RATE_LIMIT_EXCEEDED|rate.*limit/i.test(message)) return "QUOTA_EXCEEDED";
+  if (/SPEND_EXCEEDS_BUDGET/i.test(message)) return "BUDGET_EXCEEDED";
+  if (/INVALID_PARAMETER|MISSING_PARAMETER|EXCLUSIVE_PARAMETERS|INCLUSIVE_PARAMETERS/i.test(message))
+    return "INVALID_PARAMETER";
+  if (/SERVICE_UNAVAILABLE|OVER_CAPACITY|INTERNAL_ERROR/i.test(message)) return "SERVICE_UNAVAILABLE";
+  if (/CANCELLED_REQUEST|timeout|DEADLINE_EXCEEDED/i.test(message)) return "TIMEOUT";
+  return "API_ERROR";
+}
+function isRetryable(code) {
+  return code === "QUOTA_EXCEEDED" || code === "TIMEOUT" || code === "SERVICE_UNAVAILABLE";
+}
+function getRetryDelay(code) {
+  if (code === "QUOTA_EXCEEDED") return 6e4;
+  if (code === "SERVICE_UNAVAILABLE") return 15e3;
+  if (code === "TIMEOUT") return 5e3;
+  return void 0;
+}
+function parseXApiError(errorMessage, accountId) {
+  const code = mapXErrorCode(errorMessage);
+  return {
+    ok: false,
+    error: {
+      code,
+      message: errorMessage,
+      fix: {
+        action: code === "AUTH_ERROR" ? "authenticate" : code === "PERMISSION_DENIED" ? "authenticate" : isRetryable(code) ? "wait_and_retry" : "reject",
+        explanation: explainFix(code, accountId, errorMessage)
+      },
+      retryable: isRetryable(code),
+      retryAfterMs: getRetryDelay(code)
+    }
+  };
+}
+function explainFix(code, accountId, message) {
+  switch (code) {
+    case "AUTH_ERROR":
+      return "Token rejected by X. Reconnect the X Ads provider in Baker dashboard settings.";
+    case "PERMISSION_DENIED":
+      return "App not authorized for this resource. Verify Ads API access at ads.x.com/help and reconnect the provider.";
+    case "ACCOUNT_NOT_FOUND":
+      return `Account ${accountId} not accessible. Run 'baker ads x accounts' to list visible accounts.`;
+    case "QUOTA_EXCEEDED":
+      return "X Ads rate limit exceeded. Wait until the x-rate-limit-reset window passes and retry.";
+    case "INVALID_PARAMETER":
+      return `Invalid parameter sent to X Ads API: ${message}`;
+    case "BUDGET_EXCEEDED":
+      return "Spend exceeds available budget on the funding instrument.";
+    case "SERVICE_UNAVAILABLE":
+      return "X Ads API is temporarily unavailable. Retry after a short backoff.";
+    default:
+      return `Unrecognized X Ads error \u2014 verify request shape against X Ads API docs (${code}).`;
+  }
+}
+
+export {
+  parseXApiError
+};
+//# sourceMappingURL=chunk-M6UNISGO.js.map

package/dist/chunk-M6UNISGO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/error-parser.ts"],"sourcesContent":["import type { AdsErrorEnvelope } from \"../types.ts\";\n\nfunction mapXErrorCode(message: string): string {\n  if (/UNAUTHORIZED_ACCESS|authentication/i.test(message)) return \"AUTH_ERROR\";\n  if (/UNAUTHORIZED_CLIENT_APPLICATION/i.test(message)) return \"PERMISSION_DENIED\";\n  if (/ACCOUNT_NOT_FOUND|NOT_FOUND/i.test(message)) return \"ACCOUNT_NOT_FOUND\";\n  if (/CAMPAIGN_NOT_FOUND/i.test(message)) return \"CAMPAIGN_NOT_FOUND\";\n  if (/LINE_ITEM_NOT_FOUND/i.test(message)) return \"LINE_ITEM_NOT_FOUND\";\n  if (/MEDIA_NOT_FOUND|TWEET_NOT_FOUND|TAILORED_AUDIENCE_NOT_FOUND/i.test(message)) return \"RESOURCE_NOT_FOUND\";\n  if (/TOO_MANY_REQUESTS|TWEET_RATE_LIMIT_EXCEEDED|rate.*limit/i.test(message)) return \"QUOTA_EXCEEDED\";\n  if (/SPEND_EXCEEDS_BUDGET/i.test(message)) return \"BUDGET_EXCEEDED\";\n  if (/INVALID_PARAMETER|MISSING_PARAMETER|EXCLUSIVE_PARAMETERS|INCLUSIVE_PARAMETERS/i.test(message))\n    return \"INVALID_PARAMETER\";\n  if (/SERVICE_UNAVAILABLE|OVER_CAPACITY|INTERNAL_ERROR/i.test(message)) return \"SERVICE_UNAVAILABLE\";\n  if (/CANCELLED_REQUEST|timeout|DEADLINE_EXCEEDED/i.test(message)) return \"TIMEOUT\";\n  return \"API_ERROR\";\n}\n\nfunction isRetryable(code: string): boolean {\n  return code === \"QUOTA_EXCEEDED\" || code === \"TIMEOUT\" || code === \"SERVICE_UNAVAILABLE\";\n}\n\nfunction getRetryDelay(code: string): number | undefined {\n  if (code === \"QUOTA_EXCEEDED\") return 60_000;\n  if (code === \"SERVICE_UNAVAILABLE\") return 15_000;\n  if (code === \"TIMEOUT\") return 5_000;\n  return undefined;\n}\n\nexport function parseXApiError(errorMessage: string, accountId: string): AdsErrorEnvelope {\n  const code = mapXErrorCode(errorMessage);\n  return {\n    ok: false,\n    error: {\n      code,\n      message: errorMessage,\n      fix: {\n        action:\n          code === \"AUTH_ERROR\"\n            ? \"authenticate\"\n            : code === \"PERMISSION_DENIED\"\n              ? \"authenticate\"\n              : isRetryable(code)\n                ? \"wait_and_retry\"\n                : \"reject\",\n        explanation: explainFix(code, accountId, errorMessage),\n      },\n      retryable: isRetryable(code),\n      retryAfterMs: getRetryDelay(code),\n    },\n  };\n}\n\nfunction explainFix(code: string, accountId: string, message: string): string {\n  switch (code) {\n    case \"AUTH_ERROR\":\n      return \"Token rejected by X. Reconnect the X Ads provider in Baker dashboard settings.\";\n    case \"PERMISSION_DENIED\":\n      return \"App not authorized for this resource. Verify Ads API access at ads.x.com/help and reconnect the provider.\";\n    case \"ACCOUNT_NOT_FOUND\":\n      return `Account ${accountId} not accessible. Run 'baker ads x accounts' to list visible accounts.`;\n    case \"QUOTA_EXCEEDED\":\n      return \"X Ads rate limit exceeded. Wait until the x-rate-limit-reset window passes and retry.\";\n    case \"INVALID_PARAMETER\":\n      return `Invalid parameter sent to X Ads API: ${message}`;\n    case \"BUDGET_EXCEEDED\":\n      return \"Spend exceeds available budget on the funding instrument.\";\n    case \"SERVICE_UNAVAILABLE\":\n      return \"X Ads API is temporarily unavailable. Retry after a short backoff.\";\n    default:\n      return `Unrecognized X Ads error — verify request shape against X Ads API docs (${code}).`;\n  }\n}\n"],"mappings":";AAEA,SAAS,cAAc,SAAyB;AAC9C,MAAI,sCAAsC,KAAK,OAAO,EAAG,QAAO;AAChE,MAAI,mCAAmC,KAAK,OAAO,EAAG,QAAO;AAC7D,MAAI,+BAA+B,KAAK,OAAO,EAAG,QAAO;AACzD,MAAI,sBAAsB,KAAK,OAAO,EAAG,QAAO;AAChD,MAAI,uBAAuB,KAAK,OAAO,EAAG,QAAO;AACjD,MAAI,+DAA+D,KAAK,OAAO,EAAG,QAAO;AACzF,MAAI,2DAA2D,KAAK,OAAO,EAAG,QAAO;AACrF,MAAI,wBAAwB,KAAK,OAAO,EAAG,QAAO;AAClD,MAAI,iFAAiF,KAAK,OAAO;AAC/F,WAAO;AACT,MAAI,oDAAoD,KAAK,OAAO,EAAG,QAAO;AAC9E,MAAI,+CAA+C,KAAK,OAAO,EAAG,QAAO;AACzE,SAAO;AACT;AAEA,SAAS,YAAY,MAAuB;AAC1C,SAAO,SAAS,oBAAoB,SAAS,aAAa,SAAS;AACrE;AAEA,SAAS,cAAc,MAAkC;AACvD,MAAI,SAAS,iBAAkB,QAAO;AACtC,MAAI,SAAS,sBAAuB,QAAO;AAC3C,MAAI,SAAS,UAAW,QAAO;AAC/B,SAAO;AACT;AAEO,SAAS,eAAe,cAAsB,WAAqC;AACxF,QAAM,OAAO,cAAc,YAAY;AACvC,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,MACL;AAAA,MACA,SAAS;AAAA,MACT,KAAK;AAAA,QACH,QACE,SAAS,eACL,iBACA,SAAS,sBACP,iBACA,YAAY,IAAI,IACd,mBACA;AAAA,QACV,aAAa,WAAW,MAAM,WAAW,YAAY;AAAA,MACvD;AAAA,MACA,WAAW,YAAY,IAAI;AAAA,MAC3B,cAAc,cAAc,IAAI;AAAA,IAClC;AAAA,EACF;AACF;AAEA,SAAS,WAAW,MAAc,WAAmB,SAAyB;AAC5E,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,WAAW,SAAS;AAAA,IAC7B,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,wCAAwC,OAAO;AAAA,IACxD,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO,gFAA2E,IAAI;AAAA,EAC1F;AACF;","names":[]}

package/dist/chunk-MGKHFGLV.js

@@ -0,0 +1,75 @@
+import {
+  openRouterKey
+} from "./chunk-O6QKCJE4.js";
+
+// src/engine/nodes/local/lib/jev.ts
+import { z } from "zod";
+var JEV_MODEL = "typesafe/jev-1.13";
+var ENDPOINT = "https://openrouter.ai/api/v1/systemone";
+var TIMEOUT_MS = 2500;
+var Reply = z.object({
+  answers: z.record(z.string(), z.object({ noul: z.number() })),
+  usage: z.object({ cost: z.number() }).optional()
+});
+var Answer = z.union([
+  z.object({ choice: z.string(), probabilities: z.record(z.string(), z.number()), confidence: z.number() }),
+  z.object({ noul: z.number() })
+]);
+var AnswersReply = z.object({
+  answers: z.record(z.string(), z.unknown()),
+  usage: z.object({ cost: z.number() }).optional()
+});
+function readAnswers(body, ids) {
+  const parsed = AnswersReply.safeParse(body);
+  if (!parsed.success) return null;
+  const answers = [];
+  for (const id of ids) {
+    const answer = Answer.safeParse(parsed.data.answers[id]);
+    if (!answer.success) return null;
+    answers.push(
+      "choice" in answer.data ? { choice: answer.data.choice, probabilities: answer.data.probabilities, confidence: answer.data.confidence } : { noul: answer.data.noul }
+    );
+  }
+  return { answers, costUsd: parsed.data.usage?.cost ?? 0 };
+}
+async function askJevQuestions(questions, onSpend) {
+  const key = openRouterKey();
+  if (questions.length === 0) return [];
+  if (!key) return null;
+  const ids = questions.map((_, i) => `q${i}`);
+  try {
+    const response = await fetch(ENDPOINT, {
+      method: "POST",
+      headers: { authorization: `Bearer ${key}`, "content-type": "application/json" },
+      body: JSON.stringify({
+        model: JEV_MODEL,
+        state: {},
+        questions: Object.fromEntries(questions.map((q, i) => [ids[i], q]))
+      }),
+      signal: AbortSignal.timeout(TIMEOUT_MS)
+    });
+    if (!response.ok) return null;
+    const read = readAnswers(await response.json(), ids);
+    if (!read) return null;
+    onSpend?.({ model: JEV_MODEL, inputTokens: 0, outputTokens: 0, costUsd: read.costUsd });
+    return read.answers;
+  } catch {
+    return null;
+  }
+}
+async function askJev(questions, onSpend) {
+  const answers = await askJevQuestions(
+    questions.map((q) => ({ type: "noul", instructions: q.instructions })),
+    onSpend
+  );
+  if (!answers) return null;
+  const nouls = answers.flatMap((a) => "noul" in a ? [a.noul] : []);
+  return nouls.length === answers.length ? nouls : null;
+}
+
+export {
+  JEV_MODEL,
+  askJevQuestions,
+  askJev
+};
+//# sourceMappingURL=chunk-MGKHFGLV.js.map

package/dist/chunk-MGKHFGLV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/engine/nodes/local/lib/jev.ts"],"sourcesContent":["/**\n * Jev, the decision model (TypeSafe's, served by OpenRouter at `/api/v1/systemone`): the CLI's\n * one boundary module for it. It reads text and answers typed questions with a probability;\n * it writes nothing. See docs/decision-model.md for when it is the right tool and the call shape.\n */\nimport { z } from \"zod\";\nimport { openRouterKey } from \"../../../../env.ts\";\nimport type { ReviewUsage } from \"./render-review.ts\";\n\n/** Pinned: the thresholds its callers act on were measured against this version. */\nexport const JEV_MODEL = \"typesafe/jev-1.13\";\nconst ENDPOINT = \"https://openrouter.ai/api/v1/systemone\";\n/** Several times its p50 (about 0.3 s): a decision that cannot come back this fast is the caller's fallback. */\nconst TIMEOUT_MS = 2_500;\n\nconst Reply = z.object({\n  answers: z.record(z.string(), z.object({ noul: z.number() })),\n  usage: z.object({ cost: z.number() }).optional(),\n});\n\n/** Each yes/no answer to `ids`, in order, and the call's cost; null when the reply does not answer them all. Pure. */\nexport function readNouls(body: unknown, ids: readonly string[]): { answers: number[]; costUsd: number } | null {\n  const parsed = Reply.safeParse(body);\n  if (!parsed.success) return null;\n  const answers = ids.map((id) => parsed.data.answers[id]?.noul);\n  if (answers.some((a) => a === undefined)) return null;\n  return { answers: answers as number[], costUsd: parsed.data.usage?.cost ?? 0 };\n}\n\n/** One question: a yes/no statement (Noul), or one option of `criteria`, keyed by option (Choice). */\nexport type JevQuestion =\n  | { type: \"noul\"; instructions: Record<string, string> }\n  | { type: \"choice\"; instructions: Record<string, string>; criteria: Record<string, string> };\n\n/** A Noul's probability of yes, or a Choice's pick with the probability of every option. */\nexport type JevAnswer =\n  | { noul: number }\n  | { choice: string; probabilities: Record<string, number>; confidence: number };\n\nconst Answer = z.union([\n  z.object({ choice: z.string(), probabilities: z.record(z.string(), z.number()), confidence: z.number() }),\n  z.object({ noul: z.number() }),\n]);\nconst AnswersReply = z.object({\n  answers: z.record(z.string(), z.unknown()),\n  usage: z.object({ cost: z.number() }).optional(),\n});\n\n/** Each answer to `ids`, in order, and the call's cost; null when the reply does not answer them all. Pure. */\nexport function readAnswers(body: unknown, ids: readonly string[]): { answers: JevAnswer[]; costUsd: number } | null {\n  const parsed = AnswersReply.safeParse(body);\n  if (!parsed.success) return null;\n  const answers: JevAnswer[] = [];\n  for (const id of ids) {\n    const answer = Answer.safeParse(parsed.data.answers[id]);\n    if (!answer.success) return null;\n    answers.push(\n      \"choice\" in answer.data\n        ? { choice: answer.data.choice, probabilities: answer.data.probabilities, confidence: answer.data.confidence }\n        : { noul: answer.data.noul },\n    );\n  }\n  return { answers, costUsd: parsed.data.usage?.cost ?? 0 };\n}\n\n/**\n * Every answer, in order (one request, whatever the mix of Nouls and Choices), or null when Jev\n * could not answer: no key, a timeout, an outage. There is no route to fall back to, so the\n * caller decides what null means.\n */\nexport async function askJevQuestions(\n  questions: readonly JevQuestion[],\n  onSpend?: (usage: ReviewUsage) => void,\n): Promise<JevAnswer[] | null> {\n  const key = openRouterKey();\n  if (questions.length === 0) return [];\n  if (!key) return null;\n  const ids = questions.map((_, i) => `q${i}`);\n  try {\n    const response = await fetch(ENDPOINT, {\n      method: \"POST\",\n      headers: { authorization: `Bearer ${key}`, \"content-type\": \"application/json\" },\n      body: JSON.stringify({\n        model: JEV_MODEL,\n        state: {},\n        questions: Object.fromEntries(questions.map((q, i) => [ids[i], q])),\n      }),\n      signal: AbortSignal.timeout(TIMEOUT_MS),\n    });\n    if (!response.ok) return null;\n    const read = readAnswers(await response.json(), ids);\n    if (!read) return null;\n    onSpend?.({ model: JEV_MODEL, inputTokens: 0, outputTokens: 0, costUsd: read.costUsd });\n    return read.answers;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * The probability that each statement is true, in order (a Noul each, one request), or null when\n * Jev could not answer: no key, a timeout, an outage. There is no route to fall back to, so the\n * caller decides what null means.\n */\nexport async function askJev(\n  questions: ReadonlyArray<{ instructions: Record<string, string> }>,\n  onSpend?: (usage: ReviewUsage) => void,\n): Promise<number[] | null> {\n  const answers = await askJevQuestions(\n    questions.map((q) => ({ type: \"noul\", instructions: q.instructions })),\n    onSpend,\n  );\n  if (!answers) return null;\n  const nouls = answers.flatMap((a) => (\"noul\" in a ? [a.noul] : []));\n  return nouls.length === answers.length ? nouls : null;\n}\n"],"mappings":"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","names":[]}