@koda-sl/baker-cli 0.495.0-dev.6b9c22aff → 0.495.0

package/dist/conversion-writes-GIGAZT4T.js

@@ -0,0 +1,120 @@
+import {
+  compact,
+  lowerArg,
+  schemaArgs,
+  stageChatgptOp
+} from "./chunk-F377KYIM.js";
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptRead
+} from "./chunk-ACDLKTUP.js";
+import "./chunk-2VIZ4UUZ.js";
+import {
+  apiGet
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  registerSchema
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/conversion-writes.ts
+import { defineCommand } from "citty";
+var REFERENCE = CHATGPT_ADS_REFERENCE.conversions;
+var CREATE_ARGS = {
+  name: {
+    type: "string",
+    description: "What the conversion is called in reports, e.g. Quote requests",
+    required: true
+  },
+  event: {
+    type: "string",
+    description: "lead_created, appointment_scheduled, registration_completed, order_created, checkout_started, items_added, contents_viewed, page_viewed, subscription_created, trial_started \u2014 or custom",
+    required: true
+  },
+  "custom-name": {
+    type: "string",
+    description: "With --event custom: the exact event name the site sends (1\u201364 letters, digits, _ or -)"
+  },
+  pixel: {
+    type: "string",
+    description: "The pixel it counts from \u2014 its Pixel ID, its source id, or a pixel staged in this chat (chatgpt_temp_\u2026). Default: the account's only pixel"
+  }
+};
+function conversionCreateOp(args) {
+  return {
+    kind: "conversionEvent.create",
+    payload: compact({
+      name: args.name,
+      eventType: lowerArg(args.event),
+      customEventName: args["custom-name"],
+      sourceId: args.pixel
+    })
+  };
+}
+registerSchema({
+  command: "ads.chatgpt.conversions.create",
+  description: "Stage a conversion \u2014 one event from the account's pixel that ChatGPT Ads counts, standard or custom. Applies when the chat is published; it can never be deleted, and only ChatGPT Ads Manager can rename it. A custom one only measures; a conversions campaign optimises for a standard one.",
+  args: schemaArgs(CREATE_ARGS)
+});
+var conversionsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a conversion (applies when the chat is published).
+
+Examples:
+  baker ads chatgpt conversions create --name "Leads" --event lead_created
+  baker ads chatgpt conversions create --name "Quote requests" --event custom --custom-name quote_requested`
+  },
+  args: CREATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(conversionCreateOp(args), REFERENCE, (staged) => [
+      `Measure it on a campaign with --conversion-event-ids ${staged.ref} (campaigns create or update).`,
+      "After the publish, trigger the event on the live page and confirm it arrives with `baker ads chatgpt conversions events`."
+    ]);
+  }
+});
+var EVENTS_ARGS = {
+  pixel: { type: "string", description: "Pixel ID or source id (default: the account's only pixel)" }
+};
+registerSchema({
+  command: "ads.chatgpt.conversions.events",
+  description: "The events a pixel delivered to ChatGPT Ads in about the last 15 minutes \u2014 type, custom name, browser or server, when. Proof the site sends them, not attribution: trigger one on the page first.",
+  args: schemaArgs(EVENTS_ARGS)
+});
+function eventHints(recent) {
+  if (recent.events.length === 0) {
+    return [
+      "Nothing arrived in the last 15 minutes. Trigger the event on the live page (load it, submit the form), then read again \u2014 the stream keeps only about 15 minutes."
+    ];
+  }
+  return [];
+}
+var conversionsEventsCommand = defineCommand({
+  meta: {
+    name: "events",
+    description: `What the pixel sent in about the last 15 minutes \u2014 check a conversion really arrives.
+
+Examples:
+  baker ads chatgpt conversions events
+  baker ads chatgpt conversions events --pixel 2bow4Axzw2JK7H44AfsLeY`
+  },
+  args: EVENTS_ARGS,
+  run: async ({ args }) => {
+    await runChatgptRead(
+      REFERENCE,
+      () => apiGet(
+        "/api/ads/chatgpt/conversions/events",
+        typeof args.pixel === "string" && args.pixel ? { pixel: args.pixel } : void 0
+      ),
+      eventHints
+    );
+  }
+});
+export {
+  conversionCreateOp,
+  conversionsCreateCommand,
+  conversionsEventsCommand
+};
+//# sourceMappingURL=conversion-writes-GIGAZT4T.js.map

package/dist/conversions-4JOTTFEH.js

@@ -0,0 +1,135 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-VB3XUR6A.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-2VIZ4UUZ.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-U6RONIJC.js";
+import "./chunk-DAO63OOP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiGet
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/conversions.ts
+import { defineCommand } from "citty";
+var DAY_MS = 864e5;
+function healthOf(rules) {
+  const enabled = rules.filter((r) => r.enabled !== false);
+  const capi = enabled.filter((r) => r.conversionMethod === "CONVERSIONS_API");
+  const pixel = enabled.filter((r) => r.conversionMethod === "PIXEL");
+  const staleCapi = capi.filter(
+    (r) => !r.lastConversionReportedAt || Date.now() - r.lastConversionReportedAt > 7 * DAY_MS
+  );
+  const longView = enabled.filter(
+    (r) => r.viewThroughAttributionWindowSize !== void 0 && r.viewThroughAttributionWindowSize > 7
+  );
+  const leads = enabled.filter((r) => r.type === "LEAD");
+  const wrongDedup = leads.filter((r) => r.countingMethod && r.countingMethod !== "ONE_TIME_EACH_MEMBER");
+  return {
+    totalRules: rules.length,
+    enabledRules: enabled.length,
+    capiRules: capi.length,
+    pixelRules: pixel.length,
+    hasLeadEvent: leads.length > 0,
+    hasPurchaseEvent: enabled.some((r) => r.type === "PURCHASE"),
+    staleCapiRules: staleCapi,
+    longViewWindow: longView,
+    wrongLeadDedup: wrongDedup
+  };
+}
+var listCmd = defineCommand({
+  meta: {
+    name: "list",
+    description: `List conversion rules on the account.`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/conversions", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var healthCmd = defineCommand({
+  meta: {
+    name: "health",
+    description: `5-point Insight Tag / CAPI health check (playbook \xA707).
+
+Surfaces:
+  - Are rules enabled?
+  - Do we have at least one LEAD or PURCHASE event?
+  - Do CAPI rules show recent activity (\u22647 days)?
+  - Is the view-through window \u22647 days?
+  - Do LEAD rules use ONE_TIME_EACH_MEMBER de-dup?`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/conversions", params);
+      writeAdsJson({ ok: true, data: healthOf(data) });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var conversionsCommand = defineCommand({
+  meta: {
+    name: "conversions",
+    description: `Conversion rules \u2014 Insight Tag and Conversions API.
+
+Subcommands:
+  list                \u2014 every rule on the account
+  health              \u2014 playbook \xA707 5-point health check
+  create / update     \u2014 stage a conversion-rule write (applies on chat publish)
+  associate-campaign / dissociate-campaign
+                      \u2014 which ad sets a rule counts for (its own LinkedIn record, not a field on the rule)`
+  },
+  subCommands: {
+    list: listCmd,
+    health: healthCmd,
+    create: () => import("./write-commands-QPDE4GWW.js").then((m) => m.conversionsCreateCommand),
+    update: () => import("./write-commands-QPDE4GWW.js").then((m) => m.conversionsUpdateCommand),
+    "associate-campaign": () => import("./write-commands-QPDE4GWW.js").then((m) => m.conversionsAssociateCommand),
+    "dissociate-campaign": () => import("./write-commands-QPDE4GWW.js").then((m) => m.conversionsDissociateCommand)
+  }
+});
+export {
+  conversionsCommand
+};
+//# sourceMappingURL=conversions-4JOTTFEH.js.map

package/dist/conversions-4JOTTFEH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/conversions.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeAdsJson, writeAdsOutput } from \"../output.ts\";\nimport { csvOrJson, handleLinkedinError, resolveAccountIdArg } from \"./shared.ts\";\n\ninterface ConversionRule {\n  id: string;\n  urn: string;\n  account: string;\n  name?: string;\n  type?: string;\n  enabled?: boolean;\n  conversionMethod?: string;\n  attributionType?: string;\n  postClickAttributionWindowSize?: number;\n  viewThroughAttributionWindowSize?: number;\n  associatedCampaigns?: string[];\n  countingMethod?: string;\n  lastConversionReportedAt?: number;\n}\n\nconst DAY_MS = 86_400_000;\n\nfunction healthOf(rules: ConversionRule[]): {\n  totalRules: number;\n  enabledRules: number;\n  capiRules: number;\n  pixelRules: number;\n  hasLeadEvent: boolean;\n  hasPurchaseEvent: boolean;\n  staleCapiRules: ConversionRule[];\n  longViewWindow: ConversionRule[];\n  wrongLeadDedup: ConversionRule[];\n} {\n  const enabled = rules.filter((r) => r.enabled !== false);\n  const capi = enabled.filter((r) => r.conversionMethod === \"CONVERSIONS_API\");\n  const pixel = enabled.filter((r) => r.conversionMethod === \"PIXEL\");\n  const staleCapi = capi.filter(\n    (r) => !r.lastConversionReportedAt || Date.now() - r.lastConversionReportedAt > 7 * DAY_MS,\n  );\n  const longView = enabled.filter(\n    (r) => r.viewThroughAttributionWindowSize !== undefined && r.viewThroughAttributionWindowSize > 7,\n  );\n  const leads = enabled.filter((r) => r.type === \"LEAD\");\n  const wrongDedup = leads.filter((r) => r.countingMethod && r.countingMethod !== \"ONE_TIME_EACH_MEMBER\");\n  return {\n    totalRules: rules.length,\n    enabledRules: enabled.length,\n    capiRules: capi.length,\n    pixelRules: pixel.length,\n    hasLeadEvent: leads.length > 0,\n    hasPurchaseEvent: enabled.some((r) => r.type === \"PURCHASE\"),\n    staleCapiRules: staleCapi,\n    longViewWindow: longView,\n    wrongLeadDedup: wrongDedup,\n  };\n}\n\nconst listCmd = defineCommand({\n  meta: {\n    name: \"list\",\n    description: `List conversion rules on the account.`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n    \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"json|csv|jsonl|md\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n      const data = await apiGet<ConversionRule[]>(\"/api/ads/linkedin/conversions\", params);\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(data as unknown as Array<Record<string, unknown>>, fmt);\n        return;\n      }\n      writeAdsJson({ ok: true, data });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n\nconst healthCmd = defineCommand({\n  meta: {\n    name: \"health\",\n    description: `5-point Insight Tag / CAPI health check (playbook §07).\n\nSurfaces:\n  - Are rules enabled?\n  - Do we have at least one LEAD or PURCHASE event?\n  - Do CAPI rules show recent activity (≤7 days)?\n  - Is the view-through window ≤7 days?\n  - Do LEAD rules use ONE_TIME_EACH_MEMBER de-dup?`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n    \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"json\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n      const data = await apiGet<ConversionRule[]>(\"/api/ads/linkedin/conversions\", params);\n      writeAdsJson({ ok: true, data: healthOf(data) });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n\nexport const conversionsCommand = defineCommand({\n  meta: {\n    name: \"conversions\",\n    description: `Conversion rules — Insight Tag and Conversions API.\n\nSubcommands:\n  list                — every rule on the account\n  health              — playbook §07 5-point health check\n  create / update     — stage a conversion-rule write (applies on chat publish)\n  associate-campaign / dissociate-campaign\n                      — which ad sets a rule counts for (its own LinkedIn record, not a field on the rule)`,\n  },\n  subCommands: {\n    list: listCmd,\n    health: healthCmd,\n    create: () => import(\"./write-commands.ts\").then((m) => m.conversionsCreateCommand),\n    update: () => import(\"./write-commands.ts\").then((m) => m.conversionsUpdateCommand),\n    \"associate-campaign\": () => import(\"./write-commands.ts\").then((m) => m.conversionsAssociateCommand),\n    \"dissociate-campaign\": () => import(\"./write-commands.ts\").then((m) => m.conversionsDissociateCommand),\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/conversions-CIJZLGII.js

@@ -0,0 +1,76 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-ACDLKTUP.js";
+import "./chunk-2VIZ4UUZ.js";
+import "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  registerSchema
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/conversions.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.chatgpt.conversions",
+  description: "What the connected ChatGPT Ads account measures: its pixels (with the pixel id a landing page installs) and its conversion events (standard type, attribution window, sources, the campaigns using each).",
+  args: {}
+});
+function conversionHints(conversions) {
+  const hints = [];
+  if (conversions.pixels === null) {
+    hints.push(
+      "ChatGPT Ads does not let this account list its pixels through the API. The pixel id is in Ads Manager \u2192 Conversions."
+    );
+  } else if (conversions.pixels.length === 0) {
+    hints.push(
+      "No pixel yet: without one on the landing pages, ChatGPT Ads counts no conversions and cannot optimise for them."
+    );
+  }
+  if (conversions.events.filter((event) => !event.archived).length === 0) {
+    hints.push(
+      "No conversion is defined, so no campaign measures or optimises for one. Stage one with `baker ads chatgpt conversions create`."
+    );
+  }
+  return hints;
+}
+var conversionsListCommand = defineCommand({
+  meta: { name: "list", description: "Pixels and conversions. Example: baker ads chatgpt conversions" },
+  args: {},
+  run: async () => {
+    await runChatgptListRead(
+      CHATGPT_ADS_REFERENCE.conversions,
+      "/api/ads/chatgpt/conversions",
+      void 0,
+      conversionHints
+    );
+  }
+});
+var conversionsCommand = defineCommand({
+  meta: {
+    name: "conversions",
+    description: `What a ChatGPT Ads account measures \u2014 its pixels and conversions \u2014 define a new conversion, and check the pixel's events arrive.
+
+Examples:
+  baker ads chatgpt conversions
+  baker ads chatgpt conversions create --name "Quote requests" --event custom --custom-name quote_requested
+  baker ads chatgpt conversions events
+  baker ads chatgpt conversions report --ids cmpn_123 --days 30   \u2014 click-through and view-through`
+  },
+  subCommands: {
+    list: conversionsListCommand,
+    create: () => import("./conversion-writes-GIGAZT4T.js").then((m) => m.conversionsCreateCommand),
+    events: () => import("./conversion-writes-GIGAZT4T.js").then((m) => m.conversionsEventsCommand),
+    report: () => import("./conversion-report-7JJ5L6WH.js").then((m) => m.conversionsReportCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it after the matched subcommand.
+  args: {},
+  default: "list"
+});
+export {
+  conversionHints,
+  conversionsCommand
+};
+//# sourceMappingURL=conversions-CIJZLGII.js.map

package/dist/create-2XYMBULY.js

@@ -0,0 +1,207 @@
+import {
+  buildProfilePatch
+} from "./chunk-IJMWEO4P.js";
+import {
+  chatIdFromEnv,
+  creationHints,
+  failAvatarApi,
+  failValidation,
+  parseFaceChoice
+} from "./chunk-BAXDNVT2.js";
+import {
+  writeAvatars
+} from "./chunk-QG4MW2V4.js";
+import {
+  AVATAR_HANDLE_PATTERN
+} from "./chunk-DAO63OOP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/avatars/create.ts
+import { defineCommand } from "citty";
+function parseImageIds(value) {
+  if (typeof value !== "string") return void 0;
+  const ids = value.split(",").map((id) => id.trim()).filter((id) => id.length > 0);
+  return ids.length > 0 ? [...new Set(ids)] : void 0;
+}
+registerSchema({
+  command: "avatars.create",
+  description: 'Cast a new avatar \u2014 a reusable AI presenter this company can put in images and video. Start here: `baker avatars create --name "Marta" --subject "woman in her early 40s, shoulder-length dark hair, warm brown eyes, light olive skin"`. --subject is the identity: describe ONE person plainly (age, build, hair, skin, face) with no scene, no lighting and no wardrobe, because it is copied word for word into every prompt that renders them. Two kinds: invented from your description (default), or built from photographs of a real person (--source-image with --likeness-confirmed, which is the company stating it may use that person\'s image in advertising). For a real person the copy NAMES \u2014 a testimonial author, the founder, a team member \u2014 use `baker avatars research "<name>, <role> at <company>" --create` instead: it finds their photos and builds the avatar itself. Returns immediately with status `generating` \u2014 the identity sheet is a ~30s render that settles in the background.',
+  args: {
+    name: { type: "string", description: 'Display name, e.g. "Marta"', required: true },
+    handle: {
+      type: "string",
+      description: 'Mention handle (lowercase, dashes), e.g. "marta". Derived from the name when omitted.',
+      required: false
+    },
+    subject: {
+      type: "string",
+      description: "The identity, reused verbatim in every render: one person, plainly described (age, build, hair, skin, face). No scene, no lighting, no camera, no wardrobe \u2014 those belong in the render prompt or in --wardrobe/--setting.",
+      required: true
+    },
+    persona: { type: "string", description: "Who they are on camera \u2014 role, attitude, energy", required: false },
+    speech: { type: "string", description: "How they speak \u2014 pace, register, verbal habits", required: false },
+    accent: {
+      type: "string",
+      description: `Where their VOICE is from, as a place: 'Spanish from Spain, Madrid accent', 'Mexican Spanish', 'British English, London'. Name the region \u2014 an adjective like 'clear Spanish accent' is read by the video model as NO accent, and the clip comes out sounding like nowhere. Default to the language the USER is writing to you in, always: they are describing an ad for their own market, and an avatar that answers them in another language is unusable however good it looks. Never take this from how the person LOOKS \u2014 'aspecto europeo', 'Nordic', 'Mediterranean' describe a face and belong in --subject. Read literally, that mistake shipped an ad for a Spanish client with --accent "German", and the clip came back spoken in German.`,
+      required: false
+    },
+    motion: { type: "string", description: "Body language and gesture in video", required: false },
+    wardrobe: { type: "string", description: "Default outfit when the brief does not name one", required: false },
+    setting: {
+      type: "string",
+      description: 'Where they are in their own life ("her small kitchen in Madrid on a weekday morning") \u2014 their casting photo is taken there, and renders use it when the brief leaves the surroundings open. Always fill it: a face with no world comes back looking like a studio headshot.',
+      required: false
+    },
+    guardrails: {
+      type: "string",
+      description: 'Comma-separated things this avatar must never do, e.g. "no competitor logos, no medical claims"',
+      required: false
+    },
+    "source-image": {
+      type: "string",
+      description: "Comma-separated library image ids (up to 6) of photographs of a REAL person to build the likeness from. Requires --likeness-confirmed. Source them with `baker images upload`/`library` first.",
+      required: false
+    },
+    "likeness-confirmed": {
+      type: "boolean",
+      description: "The company's statement that it may use this real person's image in advertising. Required with --source-image. Pass it when the user gave you the photos, or the person is someone the company features in its own marketing (its founder, its team, a customer quoted by name) \u2014 that request is the statement; there is no separate question to ask.",
+      required: false
+    },
+    face: {
+      type: "string",
+      description: "Who picks the face, for an invented avatar: 'ask' (default) blocks on the user through `request_avatar_casting`, 'auto' keeps the one this build casts and asks nobody. Use 'auto' only when there is no one to answer \u2014 a Schedule, a batch, an explicit \"do it yourself\" \u2014 because a person who is there almost always wants this choice.",
+      required: false
+    },
+    output: {
+      type: "string",
+      description: "Output format. Only `json`, which is what this returns anyway \u2014 accepted because `avatars list` and `avatars get` take it, so reaching for it here is the obvious guess.",
+      required: false,
+      default: "json"
+    }
+  }
+});
+var createCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: 'Cast a new avatar (reusable AI presenter). Example: baker avatars create --name "Marta" --subject "woman in her early 40s, shoulder-length dark hair, light olive skin, warm open face" --persona "friendly product expert". Returns while the identity sheet is still building.'
+  },
+  args: {
+    name: { type: "string", description: "Display name", required: false },
+    handle: { type: "string", description: "Mention handle (derived from the name when omitted)", required: false },
+    subject: { type: "string", description: "The person, plainly described \u2014 reused verbatim", required: false },
+    persona: { type: "string", description: "Who they are on camera", required: false },
+    speech: { type: "string", description: "How they speak", required: false },
+    accent: {
+      type: "string",
+      description: "Where their voice is FROM \u2014 name the region, e.g. 'Spanish from Spain, Madrid accent'",
+      required: false
+    },
+    motion: { type: "string", description: "Body language in video", required: false },
+    wardrobe: { type: "string", description: "Default outfit", required: false },
+    setting: { type: "string", description: "Default surroundings", required: false },
+    guardrails: { type: "string", description: "Comma-separated things they must never do", required: false },
+    "source-image": {
+      type: "string",
+      description: "Comma-separated library image ids of a real person (needs --likeness-confirmed)",
+      required: false
+    },
+    "likeness-confirmed": {
+      type: "boolean",
+      description: "The company may use this real person's image in advertising",
+      required: false,
+      default: false
+    },
+    face: {
+      type: "string",
+      description: "Who picks the face of an invented avatar: 'ask' (default, blocks on the user) or 'auto' (asks nobody)",
+      required: false
+    },
+    output: {
+      type: "string",
+      description: "Output format \u2014 `json` only, which is what this returns anyway",
+      required: false,
+      default: "json"
+    }
+  },
+  run: async ({ args }) => {
+    const name = args.name?.trim();
+    if (!name) {
+      failValidation('--name is required, e.g. `baker avatars create --name "Marta" --subject "\u2026"`.');
+    }
+    const profile = buildProfilePatch(args);
+    const subjectDescription = profile.subjectDescription;
+    if (!subjectDescription) {
+      failValidation(
+        "--subject is required: it is the identity every render of this avatar is built from, and it is copied into each prompt word for word.",
+        {
+          action: "describe_the_person",
+          explanation: 'Write one person, plainly: age range, build, hair, skin, face, anything distinctive. No scene, no lighting, no camera, no wardrobe. Good: "woman in her early 40s, shoulder-length dark brown hair, light olive skin, warm open face, slight smile lines". Bad: "confident businesswoman in a sunlit office". If the user described a real person and you have their photos, pass --source-image with --likeness-confirmed instead of inventing the description; if they are named but you have no photos, run `baker avatars research "<name>, <role> at <company>" --create`.'
+        }
+      );
+    }
+    const handle = args.handle?.trim().toLowerCase();
+    if (handle && !AVATAR_HANDLE_PATTERN.test(handle)) {
+      failValidation(
+        `--handle "${handle}" is not usable. Use lowercase letters, numbers and dashes, starting with a letter \u2014 "maria-founder", not "Maria Founder". Leave it off to have one derived from the name.`
+      );
+    }
+    const output = args.output?.trim().toLowerCase();
+    if (output && output !== "json") {
+      failValidation(
+        `\`--output ${output}\` is not a format \`baker avatars create\` produces \u2014 it returns JSON and nothing else. Drop the flag, or pass \`--output json\`. \`baker avatars list\` and \`baker avatars get\` are the ones that also render \`files\` and \`md\`.`
+      );
+    }
+    const faceChoice = parseFaceChoice(args.face);
+    if (faceChoice === null) {
+      failValidation(
+        `--face "${String(args.face)}" is not a mode. Use --face ask to let the user pick the face, or --face auto to keep the one this build casts.`,
+        {
+          action: "pick_a_mode",
+          explanation: "Drop the flag entirely if a person is in the conversation \u2014 that is --face ask, and it is what they almost always want. Pass --face auto only when nobody is there to answer: a Schedule, a batch run, or the user telling you to do it without them."
+        }
+      );
+    }
+    const sourceImageIds = parseImageIds(args["source-image"]);
+    const likenessConfirmed = Boolean(args["likeness-confirmed"]);
+    if (sourceImageIds && !likenessConfirmed) {
+      failValidation(
+        "Building an avatar from photographs of a real person needs --likeness-confirmed: the company has to state that it may use that person's image in its advertising.",
+        {
+          action: "confirm_the_likeness",
+          explanation: 'Photos the user handed you, or of someone the company features in its own marketing (its founder, its team, a customer it quotes by name), come with that statement: re-run the same command with --likeness-confirmed. If the person is named in the copy and you have no photos, use `baker avatars research "<name>, <role> at <company>" --create` instead. Only if the user said they may NOT use this person\'s image, drop --source-image and cast an invented presenter from --subject \u2014 do not abandon the wider job over it.'
+        }
+      );
+    }
+    try {
+      const body = {
+        name,
+        ...handle ? { handle } : {},
+        profile: { ...profile, subjectDescription },
+        ...sourceImageIds ? { sourceImageIds, likenessConfirmed: true } : {},
+        ...chatIdFromEnv() ? { chatId: chatIdFromEnv() } : {},
+        // Sent so the backend can hold the sheet until the chosen portrait exists —
+        // otherwise it fuses one from a face nobody picked and pays for it twice.
+        faceChoice
+      };
+      const data = await writeAvatars("/api/avatars", body);
+      writeJson({ ok: true, data, hints: creationHints({ ...data, faceChoice }, body.profile) });
+    } catch (err) {
+      failAvatarApi(err, handle);
+    }
+  }
+});
+export {
+  createCommand
+};
+//# sourceMappingURL=create-2XYMBULY.js.map