@koda-sl/baker-cli 0.386.0 → 0.387.0-dev.3bafd569e

package/dist/chunk-HYXKRNRV.js

@@ -0,0 +1,176 @@
+import {
+  metaDraftOpInputSchema
+} from "./chunk-KBS5GH4T.js";
+import {
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-TPXI2GCW.js";
+import {
+  adCopyHints,
+  booleanWordPositionalError,
+  capabilityFix
+} from "./chunk-6I7SYEYN.js";
+import {
+  withHints
+} from "./chunk-D5FY4FAK.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-BVM5IRZW.js";
+import {
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import {
+  requireChatId
+} from "./chunk-O6QKCJE4.js";
+
+// src/commands/ads/meta/write-shared.ts
+import { readFileSync } from "fs";
+function bareAccountId(args) {
+  return resolveAccountIdArg(args).replace(/^act_/, "");
+}
+function failWriteValidation(message) {
+  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function refuseDeleteByUpdate(payload, group) {
+  if (payload.status === "DELETED") {
+    failWriteValidation(
+      `update does not delete \u2014 deleting is permanent. Use \`baker ads meta ${group} delete <id>\` if the user asked to delete; otherwise pause or archive.`
+    );
+  }
+}
+function loadJsonFileArg(path) {
+  if (typeof path !== "string" || path.length === 0) {
+    return {};
+  }
+  const inline = /^\s*\{/.test(path);
+  const source = inline ? "inline JSON" : path;
+  try {
+    const parsed = JSON.parse(inline ? path : readFileSync(path, "utf8"));
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+      failWriteValidation(`${source} must contain a JSON object`);
+    }
+    return parsed;
+  } catch (err) {
+    if (err instanceof SyntaxError) {
+      failWriteValidation(`${source} 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 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 USD)`);
+  }
+  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 listFlag(value) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    return void 0;
+  }
+  const items = value.split(",").map((item) => item.trim()).filter(Boolean);
+  return items.length > 0 ? items : void 0;
+}
+function upper(value) {
+  return typeof value === "string" && value.length > 0 ? value.toUpperCase() : void 0;
+}
+function numberFlag(value, flag) {
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
+  }
+  const n = Number(value);
+  if (!Number.isFinite(n)) {
+    failWriteValidation(`${flag} must be a number`);
+  }
+  return n;
+}
+function requireTarget(args, entity) {
+  const inverted = booleanWordPositionalError(args, entity);
+  if (inverted !== void 0) {
+    failWriteValidation(inverted);
+  }
+  const positional = Array.isArray(args._) ? args._[0] : void 0;
+  const target = args.id ?? args.target ?? args.ref ?? positional;
+  if (typeof target !== "string" || target.length === 0) {
+    failWriteValidation(`pass the ${entity} id as the positional argument`);
+  }
+  return target;
+}
+async function stageOp(raw) {
+  const preflight = metaDraftOpInputSchema.safeParse(raw);
+  if (!preflight.success) {
+    const fields = preflight.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message }));
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: "VALIDATION_ERROR",
+        message: fields.map((field) => field.path ? `${field.path}: ${field.message}` : field.message).join("; "),
+        fields,
+        fix: capabilityFix("meta-ads")
+      }
+    });
+    process.exit(1);
+  }
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/ads/meta/draft/stage", { chatId, op: preflight.data });
+    const copyHints = await adCopyHints(preflight.data);
+    writeJsonEnvelope(withHints(response, copyHints));
+  } catch (err) {
+    handleMetaError(err);
+  }
+}
+async function stageStatusChange(input) {
+  await stageOp({
+    kind: input.kind,
+    accountId: input.accountId,
+    target: input.target,
+    payload: { status: input.status }
+  });
+}
+
+export {
+  bareAccountId,
+  failWriteValidation,
+  refuseDeleteByUpdate,
+  loadJsonFileArg,
+  mergePayload,
+  parseMoneyFlag,
+  parseDateFlag,
+  listFlag,
+  upper,
+  numberFlag,
+  requireTarget,
+  stageOp,
+  stageStatusChange
+};
+//# sourceMappingURL=chunk-HYXKRNRV.js.map

package/dist/chunk-HYXKRNRV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/write-shared.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { type MetaDraftStageResponse, metaDraftOpInputSchema } from \"@baker/api/ads-meta\";\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 { handleMetaError, resolveAccountIdArg } from \"./shared.ts\";\n\n/**\n * Shared plumbing for the staged Meta write commands. Writes NEVER hit Meta\n * directly: every command stages an op against this chat's draft\n * (`/api/ads/meta/draft/stage`), the dashboard shows it as a pending Meta\n * change, and it applies when the chat is published.\n */\n\n/** Backend account ids are bare numeric — strip the `act_` prefix resolveAccountIdArg adds. */\nexport function bareAccountId(args: Record<string, unknown>): string {\n  return resolveAccountIdArg(args).replace(/^act_/, \"\");\n}\n\nexport function failWriteValidation(message: string): never {\n  writeJsonEnvelope({ ok: false, error: { code: \"VALIDATION_ERROR\", message } });\n  process.exit(1);\n}\n\n/** Deleting is permanent, so it only stages through `delete`, whose description carries that warning. */\nexport function refuseDeleteByUpdate(payload: Record<string, unknown>, group: \"campaigns\" | \"adsets\" | \"ads\"): void {\n  if (payload.status === \"DELETED\") {\n    failWriteValidation(\n      `update does not delete — deleting is permanent. Use \\`baker ads meta ${group} delete <id>\\` if the user asked to delete; otherwise pause or archive.`,\n    );\n  }\n}\n\n/**\n * `--file`: a JSON file path, or the JSON itself when it starts with `{` — the shape Google's\n * `--file` already takes and the one an agent writes first for a short payload (a customer list of\n * a few people).\n */\nexport function loadJsonFileArg(path: unknown): Record<string, unknown> {\n  if (typeof path !== \"string\" || path.length === 0) {\n    return {};\n  }\n  const inline = /^\\s*\\{/.test(path);\n  const source = inline ? \"inline JSON\" : path;\n  try {\n    const parsed = JSON.parse(inline ? path : readFileSync(path, \"utf8\")) as unknown;\n    if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      failWriteValidation(`${source} must contain a JSON object`);\n    }\n    return parsed as Record<string, unknown>;\n  } catch (err) {\n    if (err instanceof SyntaxError) {\n      failWriteValidation(`${source} 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\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    // Meta 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 USD)`);\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\n/** Split a comma-separated flag into a trimmed, non-empty array. */\nexport function listFlag(value: unknown): string[] | undefined {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    return undefined;\n  }\n  const items = value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n  return items.length > 0 ? items : undefined;\n}\n\nexport function upper(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.length > 0 ? value.toUpperCase() : undefined;\n}\n\nexport function numberFlag(value: unknown, flag: string): number | undefined {\n  if (value === undefined || value === null || value === \"\") {\n    return undefined;\n  }\n  const n = Number(value);\n  if (!Number.isFinite(n)) {\n    failWriteValidation(`${flag} must be a number`);\n  }\n  return n;\n}\n\n/**\n * Accepts whichever positional the command declared (`id`, `target`, `ref`) or the raw positional.\n *\n * `--flag false` is refused first: citty turns it into the flag set to TRUE plus a stray positional,\n * so on `campaigns duplicate 6123 --replace false` the copy stages AND the live original is staged\n * for pause — the opposite of what was typed, with an \"ok\" receipt. This is the only place on this\n * surface that reads positionals, and every target-taking command goes through it.\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 positional = Array.isArray(args._) ? args._[0] : undefined;\n  const target = args.id ?? args.target ?? args.ref ?? positional;\n  if (typeof target !== \"string\" || target.length === 0) {\n    failWriteValidation(`pass the ${entity} id as the positional argument`);\n  }\n  return target;\n}\n\ninterface StageEnvelope extends Record<string, unknown> {\n  ok: true;\n  data: MetaDraftStageResponse;\n}\n\n/**\n * Preflight-validates the op against the shared `@baker/api/ads-meta` contract\n * (same schema the backend enforces), then stages it. Prints the staged\n * envelope — ref, mode (always `live`: publishing reaches the real ad account),\n * summary, warnings.\n */\nexport async function stageOp(raw: Record<string, unknown>): Promise<void> {\n  const preflight = metaDraftOpInputSchema.safeParse(raw);\n  if (!preflight.success) {\n    const fields = preflight.error.issues.map((issue) => ({ path: issue.path.join(\".\"), message: issue.message }));\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(\"meta-ads\"),\n      },\n    });\n    process.exit(1);\n  }\n  try {\n    const chatId = requireChatId();\n    const response = await apiPost<StageEnvelope>(\"/api/ads/meta/draft/stage\", { chatId, op: preflight.data });\n    const copyHints = await adCopyHints(preflight.data);\n    writeJsonEnvelope(withHints(response, copyHints));\n  } catch (err) {\n    handleMetaError(err);\n  }\n}\n\nexport async function stageStatusChange(input: {\n  kind: \"campaign.update\" | \"adSet.update\" | \"adCreative.update\" | \"ad.update\" | \"customAudience.update\";\n  accountId: string;\n  target: string;\n  status: \"ACTIVE\" | \"PAUSED\" | \"ARCHIVED\" | \"DELETED\";\n}): Promise<void> {\n  await stageOp({\n    kind: input.kind,\n    accountId: input.accountId,\n    target: input.target,\n    payload: { status: input.status },\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-I3DIZWN5.js

@@ -0,0 +1,97 @@
+import {
+  JEV_MODEL,
+  askJev
+} from "./chunk-MGKHFGLV.js";
+
+// src/engine/lib/remembered-nouls.ts
+import { createHash } from "crypto";
+import { readFile } from "fs/promises";
+
+// src/engine/lib/file-lock.ts
+import { randomUUID } from "crypto";
+import { mkdir, rename, rm, stat, writeFile } from "fs/promises";
+import path from "path";
+var LOCK_STALE_MS = 1e4;
+var LOCK_WAIT_MS = 20;
+async function updateLockedFile(file, change) {
+  await mkdir(path.dirname(file), { recursive: true });
+  const lock = `${file}.lock`;
+  await acquireLock(lock);
+  try {
+    const temp = `${file}.${process.pid}.${randomUUID()}.tmp`;
+    await writeFile(temp, await change(), "utf8");
+    await rename(temp, file);
+  } finally {
+    await rm(lock, { force: true });
+  }
+}
+async function acquireLock(lock) {
+  for (; ; ) {
+    try {
+      await writeFile(lock, String(process.pid), { flag: "wx" });
+      return;
+    } catch (e) {
+      if (e.code !== "EEXIST") throw e;
+    }
+    const held = await stat(lock).catch(() => null);
+    if (held && Date.now() - held.mtimeMs > LOCK_STALE_MS) await rm(lock, { force: true });
+    await new Promise((resolve) => setTimeout(resolve, LOCK_WAIT_MS));
+  }
+}
+
+// src/engine/lib/remembered-nouls.ts
+var PER_REQUEST = 200;
+var MAX_REMEMBERED = 2e4;
+function keyOf(question) {
+  return createHash("sha256").update(JSON.stringify([JEV_MODEL, question.instructions])).digest("hex").slice(0, 32);
+}
+async function remembered(file) {
+  const parsed = await readFile(file, "utf8").then(JSON.parse, () => ({}));
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
+  return Object.fromEntries(
+    Object.entries(parsed).filter((e) => typeof e[1] === "number")
+  );
+}
+async function rememberedNouls(questions, opts) {
+  if (questions.length === 0) return [];
+  const keys = questions.map(keyOf);
+  const known = opts.file ? await remembered(opts.file) : {};
+  const missing = [...new Set(keys.filter((k) => known[k] === void 0))];
+  const byKey = new Map(questions.map((q, i) => [keys[i], q]));
+  const batches = [];
+  for (let i = 0; i < missing.length; i += PER_REQUEST) batches.push(missing.slice(i, i + PER_REQUEST));
+  const answered = await Promise.all(
+    batches.map((batch) => opts.ask(batch.flatMap((k) => byKey.get(k) ?? [])).catch(() => null))
+  );
+  if (answered.some((a) => a === null || a.length === 0)) return null;
+  const fresh = {};
+  batches.forEach((batch, b) => {
+    batch.forEach((k, i) => {
+      const answer = answered[b]?.[i];
+      if (answer !== void 0) fresh[k] = answer;
+    });
+  });
+  const all = { ...known, ...fresh };
+  const file = opts.file;
+  if (file && missing.length > 0) {
+    await updateLockedFile(file, async () => {
+      const kept = Object.entries({ ...await remembered(file), ...fresh }).slice(-MAX_REMEMBERED);
+      return JSON.stringify(Object.fromEntries(kept));
+    }).catch(() => void 0);
+  }
+  const answers = keys.map((k) => all[k]);
+  return answers.every((a) => a !== void 0) ? answers : null;
+}
+function jevAsker(onSpend) {
+  return (questions) => askJev(questions, onSpend);
+}
+function rememberedJev(file, onSpend) {
+  const ask = jevAsker(onSpend);
+  return (questions) => rememberedNouls(questions, { ask, file });
+}
+
+export {
+  updateLockedFile,
+  rememberedJev
+};
+//# sourceMappingURL=chunk-I3DIZWN5.js.map

package/dist/chunk-I3DIZWN5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/engine/lib/remembered-nouls.ts","../src/engine/lib/file-lock.ts"],"sourcesContent":["/**\n * Yes/no answers from the decision model (Jev, `askJev`), asked in batches and remembered by\n * question, so the same text asked the same question gets the same answer on every run. A gate\n * that counts findings (the landing critique's block count, an idea's warnings) must not flip\n * because Jev answered 0.69 one run and 0.71 the next.\n */\nimport { createHash } from \"node:crypto\";\nimport { readFile } from \"node:fs/promises\";\nimport { askJev, JEV_MODEL } from \"../nodes/local/lib/jev.ts\";\nimport type { ReviewUsage } from \"../nodes/local/lib/render-review.ts\";\nimport { updateLockedFile } from \"./file-lock.ts\";\n\nexport type NoulQuestion = { instructions: Record<string, string> };\n/** Each question's probability, in order, or null when no answer came back. */\nexport type AskNouls = (questions: readonly NoulQuestion[]) => Promise<number[] | null>;\n\n/** Several hundred fit in one request at the same latency; this keeps each well inside Jev's context. */\nconst PER_REQUEST = 200;\n/** The file never grows past this many answers; the oldest are dropped first. */\nconst MAX_REMEMBERED = 20_000;\n\nfunction keyOf(question: NoulQuestion): string {\n  return createHash(\"sha256\")\n    .update(JSON.stringify([JEV_MODEL, question.instructions]))\n    .digest(\"hex\")\n    .slice(0, 32);\n}\n\nasync function remembered(file: string): Promise<Record<string, number>> {\n  const parsed: unknown = await readFile(file, \"utf8\").then(JSON.parse, () => ({}));\n  if (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) return {};\n  return Object.fromEntries(\n    Object.entries(parsed as Record<string, unknown>).filter((e): e is [string, number] => typeof e[1] === \"number\"),\n  );\n}\n\n/**\n * The probability each statement is true, in order: from `file` when asked before, else from\n * `ask`, in requests of `PER_REQUEST` sent at once. Null when any request failed, so the caller\n * takes its fallback for the whole decision rather than half of it. Never throws.\n */\nexport async function rememberedNouls(\n  questions: readonly NoulQuestion[],\n  opts: { ask: AskNouls; file?: string },\n): Promise<number[] | null> {\n  if (questions.length === 0) return [];\n  const keys = questions.map(keyOf);\n  const known = opts.file ? await remembered(opts.file) : {};\n  const missing = [...new Set(keys.filter((k) => known[k] === undefined))];\n  const byKey = new Map(questions.map((q, i) => [keys[i], q]));\n  const batches: string[][] = [];\n  for (let i = 0; i < missing.length; i += PER_REQUEST) batches.push(missing.slice(i, i + PER_REQUEST));\n  const answered = await Promise.all(\n    batches.map((batch) => opts.ask(batch.flatMap((k) => byKey.get(k) ?? [])).catch(() => null)),\n  );\n  if (answered.some((a) => a === null || a.length === 0)) return null;\n  const fresh: Record<string, number> = {};\n  batches.forEach((batch, b) => {\n    batch.forEach((k, i) => {\n      const answer = answered[b]?.[i];\n      if (answer !== undefined) fresh[k] = answer;\n    });\n  });\n  const all = { ...known, ...fresh };\n  const file = opts.file;\n  if (file && missing.length > 0) {\n    // Read again under the lock: another caller sharing the file may have written its answers since.\n    await updateLockedFile(file, async () => {\n      const kept = Object.entries({ ...(await remembered(file)), ...fresh }).slice(-MAX_REMEMBERED);\n      return JSON.stringify(Object.fromEntries(kept));\n    }).catch(() => undefined);\n  }\n  const answers = keys.map((k) => all[k]);\n  return answers.every((a): a is number => a !== undefined) ? answers : null;\n}\n\n/** The real decision model, its spend reported to `onSpend`. */\nexport function jevAsker(onSpend?: (usage: ReviewUsage) => void): AskNouls {\n  return (questions) => askJev(questions, onSpend);\n}\n\n/** The real decision model behind the answers kept in `file`: what every CLI caller asks through. */\nexport function rememberedJev(file: string, onSpend?: (usage: ReviewUsage) => void): AskNouls {\n  const ask = jevAsker(onSpend);\n  return (questions) => rememberedNouls(questions, { ask, file });\n}\n","/**\n * Change a JSON file that several processes (or several calls in one) update at once: read,\n * change and write it whole under a lock file, through a temp file renamed into place, so no\n * writer erases another's entries and no reader sees half a file.\n */\nimport { randomUUID } from \"node:crypto\";\nimport { mkdir, rename, rm, stat, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nconst LOCK_STALE_MS = 10_000;\nconst LOCK_WAIT_MS = 20;\n\n/** Run `change` with `file` locked, and write what it returns as the file's whole new content. */\nexport async function updateLockedFile(file: string, change: () => Promise<string>): Promise<void> {\n  await mkdir(path.dirname(file), { recursive: true });\n  const lock = `${file}.lock`;\n  await acquireLock(lock);\n  try {\n    const temp = `${file}.${process.pid}.${randomUUID()}.tmp`;\n    await writeFile(temp, await change(), \"utf8\");\n    await rename(temp, file);\n  } finally {\n    await rm(lock, { force: true });\n  }\n}\n\nasync function acquireLock(lock: string): Promise<void> {\n  for (;;) {\n    try {\n      await writeFile(lock, String(process.pid), { flag: \"wx\" });\n      return;\n    } catch (e) {\n      if ((e as NodeJS.ErrnoException).code !== \"EEXIST\") throw e;\n    }\n    // A process that died holding the lock leaves it behind: a lock this old is no one's.\n    const held = await stat(lock).catch(() => null);\n    if (held && Date.now() - held.mtimeMs > LOCK_STALE_MS) await rm(lock, { force: true });\n    await new Promise((resolve) => setTimeout(resolve, LOCK_WAIT_MS));\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-IJMWEO4P.js

@@ -0,0 +1,57 @@
+// src/commands/avatars/profile.ts
+var TEXT_FIELDS = [
+  ["subject", "subjectDescription"],
+  ["persona", "persona"],
+  ["speech", "speech"],
+  ["accent", "accent"],
+  ["motion", "motion"],
+  ["wardrobe", "wardrobe"],
+  ["setting", "setting"]
+];
+function parseGuardrails(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  return [
+    ...new Set(
+      value.split(",").map((rule) => rule.trim()).filter((rule) => rule.length > 0)
+    )
+  ];
+}
+function buildProfilePatch(args) {
+  const patch = {};
+  for (const [flag, field] of TEXT_FIELDS) {
+    const value = args[flag];
+    if (typeof value === "string") {
+      Object.assign(patch, { [field]: value.trim() });
+    }
+  }
+  const guardrails = parseGuardrails(args.guardrails);
+  if (guardrails) {
+    patch.guardrails = guardrails;
+  }
+  return patch;
+}
+function hasProfileEdit(patch) {
+  return Object.keys(patch).length > 0;
+}
+function mergeProfile(current, patch) {
+  const merged = { ...current };
+  for (const [key, value] of Object.entries(patch)) {
+    if (value.length === 0) {
+      if (key !== "subjectDescription") {
+        delete merged[key];
+      }
+      continue;
+    }
+    Object.assign(merged, { [key]: value });
+  }
+  return merged;
+}
+
+export {
+  buildProfilePatch,
+  hasProfileEdit,
+  mergeProfile
+};
+//# sourceMappingURL=chunk-IJMWEO4P.js.map

package/dist/chunk-IJMWEO4P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/avatars/profile.ts"],"sourcesContent":["import type { AvatarProfile } from \"@baker/api\";\n\n/**\n * A partial edit of an avatar's written profile.\n *\n * `update` sends the profile whole — the backend replaces it rather than\n * merging — so an agent that passes `--persona` alone would wipe the subject\n * description, which is the one field the identity depends on. The CLI reads\n * the stored profile first and merges this patch over it.\n */\nexport type AvatarProfilePatch = Partial<AvatarProfile>;\n\n/** Written-profile flags, in the order they read on the command line. */\nexport const PROFILE_FLAGS = [\n  \"subject\",\n  \"persona\",\n  \"speech\",\n  \"accent\",\n  \"motion\",\n  \"wardrobe\",\n  \"setting\",\n  \"guardrails\",\n] as const;\n\ntype AvatarProfileTextField = Exclude<keyof AvatarProfile, \"guardrails\">;\n\nconst TEXT_FIELDS: ReadonlyArray<[flag: string, field: AvatarProfileTextField]> = [\n  [\"subject\", \"subjectDescription\"],\n  [\"persona\", \"persona\"],\n  [\"speech\", \"speech\"],\n  [\"accent\", \"accent\"],\n  [\"motion\", \"motion\"],\n  [\"wardrobe\", \"wardrobe\"],\n  [\"setting\", \"setting\"],\n];\n\n/**\n * Split a `--guardrails \"never a, never b\"` flag into single rules.\n *\n * Returns undefined when the flag was omitted so the caller can tell \"leave the\n * stored rules alone\" from \"clear them\" (an empty string).\n */\nexport function parseGuardrails(value: unknown): string[] | undefined {\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n  return [\n    ...new Set(\n      value\n        .split(\",\")\n        .map((rule) => rule.trim())\n        .filter((rule) => rule.length > 0),\n    ),\n  ];\n}\n\n/** Read the profile flags a caller actually passed. Omitted flags stay absent. */\nexport function buildProfilePatch(args: Record<string, unknown>): AvatarProfilePatch {\n  const patch: AvatarProfilePatch = {};\n  for (const [flag, field] of TEXT_FIELDS) {\n    const value = args[flag];\n    if (typeof value === \"string\") {\n      Object.assign(patch, { [field]: value.trim() });\n    }\n  }\n  const guardrails = parseGuardrails(args.guardrails);\n  if (guardrails) {\n    patch.guardrails = guardrails;\n  }\n  return patch;\n}\n\nexport function hasProfileEdit(patch: AvatarProfilePatch): boolean {\n  return Object.keys(patch).length > 0;\n}\n\n/**\n * Merge a patch over the stored profile. An empty value clears the field it\n * names — except `subjectDescription`, which the identity sheet was fused from\n * and can only ever be replaced, never removed (`update` rejects the empty\n * flag outright, so this is the second line of defence).\n */\nexport function mergeProfile(current: AvatarProfile, patch: AvatarProfilePatch): AvatarProfile {\n  const merged: AvatarProfile = { ...current };\n  for (const [key, value] of Object.entries(patch) as [keyof AvatarProfile, string | string[]][]) {\n    if (value.length === 0) {\n      if (key !== \"subjectDescription\") {\n        delete merged[key];\n      }\n      continue;\n    }\n    Object.assign(merged, { [key]: value });\n  }\n  return merged;\n}\n"],"mappings":";AA0BA,IAAM,cAA4E;AAAA,EAChF,CAAC,WAAW,oBAAoB;AAAA,EAChC,CAAC,WAAW,SAAS;AAAA,EACrB,CAAC,UAAU,QAAQ;AAAA,EACnB,CAAC,UAAU,QAAQ;AAAA,EACnB,CAAC,UAAU,QAAQ;AAAA,EACnB,CAAC,YAAY,UAAU;AAAA,EACvB,CAAC,WAAW,SAAS;AACvB;AAQO,SAAS,gBAAgB,OAAsC;AACpE,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,GAAG,IAAI;AAAA,MACL,MACG,MAAM,GAAG,EACT,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,EACzB,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC;AAAA,IACrC;AAAA,EACF;AACF;AAGO,SAAS,kBAAkB,MAAmD;AACnF,QAAM,QAA4B,CAAC;AACnC,aAAW,CAAC,MAAM,KAAK,KAAK,aAAa;AACvC,UAAM,QAAQ,KAAK,IAAI;AACvB,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO,OAAO,OAAO,EAAE,CAAC,KAAK,GAAG,MAAM,KAAK,EAAE,CAAC;AAAA,IAChD;AAAA,EACF;AACA,QAAM,aAAa,gBAAgB,KAAK,UAAU;AAClD,MAAI,YAAY;AACd,UAAM,aAAa;AAAA,EACrB;AACA,SAAO;AACT;AAEO,SAAS,eAAe,OAAoC;AACjE,SAAO,OAAO,KAAK,KAAK,EAAE,SAAS;AACrC;AAQO,SAAS,aAAa,SAAwB,OAA0C;AAC7F,QAAM,SAAwB,EAAE,GAAG,QAAQ;AAC3C,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAiD;AAC9F,QAAI,MAAM,WAAW,GAAG;AACtB,UAAI,QAAQ,sBAAsB;AAChC,eAAO,OAAO,GAAG;AAAA,MACnB;AACA;AAAA,IACF;AACA,WAAO,OAAO,QAAQ,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC;AAAA,EACxC;AACA,SAAO;AACT;","names":[]}