@koda-sl/baker-cli 0.531.0 → 0.534.0-dev.911a80433

package/dist/currency-UVT3HEZT.js

@@ -0,0 +1,88 @@
+import {
+  parseApiError
+} from "./chunk-OI2CKYAQ.js";
+import "./chunk-IZABTTW5.js";
+import {
+  cacheGet,
+  cacheSet,
+  getManagerIdForCustomer,
+  resolveCustomerId,
+  writeAdsJson
+} from "./chunk-LV7EU6HM.js";
+import "./chunk-MUS2UTWU.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema
+} from "./chunk-HZPTQRX6.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-UVT3HEZT.js.map

package/dist/custom-conversions-7MZFTHUM.js

@@ -0,0 +1,128 @@
+import {
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-IQWFJEA3.js";
+import "./chunk-QALAJNBG.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-LV7EU6HM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-NLW25WW3.js";
+import {
+  apiGet
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema
+} from "./chunk-HZPTQRX6.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 stage one: `baker ads meta custom-conversions create --name \u2026 --pixel-id \u2026 --custom-event-type LEAD --url-contains /thank-you`."
+    ];
+  }
+  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 = await 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-W3UN6F4Y.js").then((m) => m.customConversionsCreateCommand),
+    update: () => import("./asset-writes-CUF25BLM.js").then((m) => m.customConversionsUpdateCommand),
+    delete: () => import("./asset-writes-CUF25BLM.js").then((m) => m.customConversionsDeleteCommand)
+  },
+  // `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-7MZFTHUM.js.map

package/dist/customers-VJ3TXILQ.js

@@ -0,0 +1,59 @@
+import {
+  FORCES,
+  INSIGHT_TYPES,
+  MAX_QUOTE_CHARS,
+  batchSources,
+  buildCustomersPrompt,
+  candidatesFrom,
+  customersCommand,
+  customersHints,
+  keepVerbatim,
+  planInsightWrites,
+  renderInsightFile,
+  researchCustomers,
+  sourcesFromPages,
+  sourcesFromReddit,
+  sourcesFromTestimonials
+} from "./chunk-2PC26XRF.js";
+import "./chunk-E3FMS5DA.js";
+import "./chunk-WEQZ563U.js";
+import "./chunk-QPPQXU3U.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-AGU4KGT6.js";
+import "./chunk-R5LRBDEM.js";
+import "./chunk-DGZYZWMK.js";
+import "./chunk-F3CZFUXZ.js";
+import "./chunk-SVNH6P7O.js";
+import "./chunk-YJYKSMLF.js";
+import "./chunk-L763CNKH.js";
+import "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import "./chunk-HZPTQRX6.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-VJ3TXILQ.js.map

package/dist/decide-OPCCKAIT.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-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-HZPTQRX6.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-OPCCKAIT.js.map

package/dist/delete-3H377GOM.js

@@ -0,0 +1,67 @@
+import {
+  failApi,
+  failValidation,
+  validateScheduledAgentRef,
+  writeOk
+} from "./chunk-KUM36NSV.js";
+import "./chunk-VCOIFNYH.js";
+import "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import {
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import {
+  requireChatId
+} from "./chunk-VPF5A7CM.js";
+import {
+  registerSchema
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/scheduled-agents/delete.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "scheduled-agents.delete",
+  description: "Stage deletion of a published scheduled agent, or cancel one this chat staged (temp_agent_*).",
+  args: {
+    id: { type: "string", description: "Published scheduled agent ID or temp_agent_* draft ID", required: true }
+  }
+});
+var deleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: "Stage a scheduled agent deletion. Example: baker scheduled-agents delete <id-or-temp_agent_id>"
+  },
+  args: {
+    id: { type: "positional", description: "Scheduled agent ID or temp_agent_* draft ID", required: false },
+    "scheduled-agent-id": {
+      type: "string",
+      description: "Scheduled agent ID (alternative to positional)",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["scheduled-agent-id"];
+      if (!id) {
+        failValidation("Scheduled agent ID is required.");
+      }
+      validateScheduledAgentRef(id);
+      await apiPost("/api/scheduled-agents/delete", { chatId: requireChatId(), id });
+      writeOk();
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  deleteCommand
+};
+//# sourceMappingURL=delete-3H377GOM.js.map

package/dist/delete-EH3XL26Z.js

@@ -0,0 +1,57 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-7MY3QHGA.js";
+import "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import {
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/tags/delete.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.tags.delete",
+  description: "Delete a company custom action tag by slug. Built-in default tags cannot be deleted. Existing actions keep the slug (it just stops appearing in the taxonomy).",
+  args: {
+    slug: { type: "string", description: "Custom tag slug to delete", required: true }
+  }
+});
+var tagsDeleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: "Delete a custom action tag. Example: baker actions tags delete --slug pmax"
+  },
+  args: {
+    slug: { type: "string", description: "Custom tag slug", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const slug = args.slug;
+      if (!slug || slug.trim().length === 0) {
+        failValidation("--slug is required.");
+      }
+      await apiPost("/api/actions/tags/delete", { name: slug });
+      writeOk();
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  tagsDeleteCommand
+};
+//# sourceMappingURL=delete-EH3XL26Z.js.map

package/dist/delete-GKQTDOZF.js

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