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

package/dist/chunk-OFFAMC5H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/avatars/casting.ts","../src/commands/avatars/failures.ts"],"sourcesContent":["import type { AvatarLikeness, AvatarStatus, AvatarSummary } from \"@baker/api\";\nimport { optionalChatId } from \"../../env.ts\";\n\n/** What an avatar has to look like before it can be put on screen. */\nexport interface CastingSubject {\n  handle: string;\n  status: AvatarStatus;\n  sheetUrl?: string;\n  errorMessage?: string;\n  /** Parked on a face the user has not picked. `generating` with nothing rendering. */\n  needsFace?: boolean;\n}\n\n// Observed failure, end to end: the agent cast an avatar, gave it a voice, then\n// rendered two clips by PASTING the subject description into the prompt and\n// leaving `--avatar` off. Every hint here used to teach exactly that shape, so\n// the rule now leads with the flag and only then explains the words.\nconst CAST_FLAG_RULE =\n  \"Cast with `--avatar <handle>` on `baker studio generate`, `baker studio animate`, `baker canvas scaffold-ad`, `baker canvas scaffold-static-ad` and `baker canvas scaffold-video`. Don't hand-roll it by pasting `subjectDescription` into the prompt or by passing the sheet through `--reference` — both render something that merely resembles them. `--avatar` is also the only thing that carries their accent and delivery into a clip. An avatar has no pinned voice by design (ADR 0005): the video model renders the voice, and the region on their profile is the only thing steering it — without the flag the clip is performed flat, in whatever accent the model picks on its own. `baker canvas scaffold-video` casts only their face: a reproduced video keeps the source ad's accent direction, so never tell the user it speaks in theirs.\";\n\nconst VERBATIM_RULE =\n  \"When you do write the description yourself — a hand-built canvas node, a landing image, anywhere `--avatar` does not exist — copy `subjectDescription` verbatim, word for word. Re-phrasing it per generation is the other reason a face drifts across a set.\";\n\n// ByteDance's filter refuses photoreal human faces, AI-generated ones included,\n// so a presenter clip routed to Seedance is a paid refusal every time.\nconst VIDEO_ROUTING =\n  \"In video, a photoreal presenter renders on `google/veo-3.1` (or `google/veo-3.1-fast`), never `bytedance/seedance-2.0` — it refuses photoreal human faces, AI-generated ones included. Reproducing a video the user gave you: `baker canvas scaffold-video … --avatar <handle> --real-face`.\";\n\n/**\n * What the agent should do next with this avatar, keyed off its status.\n *\n * The two lines that matter on a ready avatar are the same two things that make\n * a face hold still across a set: ground on the identity sheet, and reuse the\n * subject description word for word.\n */\nexport function castingHints(avatar: CastingSubject): string[] {\n  // Before the building hint, and deliberately loud. `generating` normally means a\n  // render is running, so every piece of advice below reads as \"come back in a moment\"\n  // — and an agent that acts on it here waits out a deadline on work that has not\n  // started. Observed end to end: two 90s `--wait` calls against this exact state, then\n  // a delete and a recreate with `--face auto`, which took the choice off the user\n  // while the four portraits were still on their screen.\n  if (avatar.status === \"generating\" && avatar.needsFace) {\n    return [\n      `The user is picking @${avatar.handle}'s face right now — portraits are on their screen and nothing renders until they answer. There is NOTHING to wait for and nothing to check: do not poll, do not block on it, do not ask about the face in a question of your own, and do not delete or recreate this avatar. Whatever you do next simply runs after they have chosen.`,\n    ];\n  }\n\n  if (avatar.status === \"generating\") {\n    return [\n      `Still building — a ~30s render that settles on its own, and this avatar is castable only once it reads \\`ready\\`. If the next thing you do needs it (a clip, a still, anything with --avatar), block on it: \\`baker avatars get ${avatar.handle} --wait\\` returns the moment it is ready. Otherwise do other work first and read it back with \\`baker avatars get ${avatar.handle}\\`. Never write your own sleep or poll loop, and never end the turn waiting — the user would have to come back and tell you it is ready.`,\n    ];\n  }\n\n  if (avatar.status === \"error\") {\n    return [\n      `The identity sheet could not be built${avatar.errorMessage ? `: ${avatar.errorMessage}` : \"\"}. This avatar cannot be cast. Sharpen the subject description (one person, plain description, no scene) and rebuild: \\`baker avatars update ${avatar.handle} --subject \"…\" --regenerate-sheet\\`.`,\n    ];\n  }\n\n  if (avatar.status === \"archived\") {\n    return [\n      `Retired. Work that already used it still resolves, but do not cast it into anything new — \\`baker avatars list\\` shows the roster you can cast from.`,\n    ];\n  }\n\n  if (!avatar.sheetUrl) {\n    return [\n      `No identity sheet on this avatar yet, so there is nothing to ground a render on. Re-read it with \\`baker avatars get ${avatar.handle}\\`; if it stays this way, rebuild the sheet with \\`baker avatars update ${avatar.handle} --regenerate-sheet\\`.`,\n    ];\n  }\n\n  return [\n    `Ready to cast: \\`baker studio generate \"<your scene>\" --avatar ${avatar.handle}\\` for a still, \\`baker studio animate \"<the motion, and the line they say>\" --avatar ${avatar.handle}\\` for a clip.`,\n    CAST_FLAG_RULE,\n    VERBATIM_RULE,\n    VIDEO_ROUTING,\n  ];\n}\n\n/**\n * One line of the roster.\n *\n * `subjectDescription` is deliberately absent: it has to reach a prompt word for\n * word, and a list is exactly where a long description gets skimmed, wrapped, or\n * half-copied. `baker avatars get <handle>` is the one place it is read.\n */\nexport function rosterRow(avatar: AvatarSummary): Record<string, unknown> {\n  return {\n    handle: avatar.handle,\n    name: avatar.name,\n    status: avatar.status,\n    likeness: avatar.likeness,\n    sheetUrl: avatar.sheetUrl ?? null,\n    avatarId: avatar.avatarId,\n    ...(avatar.errorMessage ? { errorMessage: avatar.errorMessage } : {}),\n  };\n}\n\n/** Next steps after reading the roster. */\n/**\n * The chat this command is running inside, when it is running inside one.\n *\n * Attribution is best-effort: a direct caller outside a chat still works, it just isn't\n * tied to a Session. Shared with the roster, which uses it to say which avatar the\n * current conversation is about.\n */\nexport function chatIdFromEnv(): string | undefined {\n  return optionalChatId();\n}\n\nexport function rosterHints(\n  roster: ReadonlyArray<{ handle: string; status: AvatarStatus; fromThisChat?: boolean }>,\n  statusFilter: string | undefined,\n): string[] {\n  if (roster.length === 0) {\n    return [\n      statusFilter\n        ? `No avatars with status \"${statusFilter}\". Drop \\`--status\\` to see the whole roster.`\n        : `No avatars yet — and retired ones are hidden unless you pass \\`--status archived\\`. Cast a new presenter with \\`baker avatars create --name \"…\" --subject \"…\"\\`.`,\n    ];\n  }\n\n  // Leads the list, because the roster is the moment the agent picks who to use and the\n  // rest of it is noise at that moment. Observed: the user had just chosen a face for an\n  // avatar in this conversation, and the agent came back offering two from earlier chats\n  // and asking which one to use — a question they had already answered by picking.\n  const mine = roster.filter((avatar) => avatar.fromThisChat).map((avatar) => avatar.handle);\n  const hints = mine.length\n    ? [\n        `@${mine[0]} was made in this conversation${\n          mine.length > 1\n            ? ` (with ${mine\n                .slice(1)\n                .map((h) => `@${h}`)\n                .join(\", \")})`\n            : \"\"\n        } — that is the avatar this chat is about, and the user chose its face. Use it. The others belong to earlier conversations: only reach for one if the user names it, and never ask which to use when the answer is the one you just cast.`,\n      ]\n    : [];\n  // Says what `CAST_FLAG_RULE` says, because this is the hint read at the moment the\n  // agent picks who to use. It used to hand back \"the identity sheet URL for\n  // `--reference`\" — the exact hand-rolled shape that rule bans — and an agent that\n  // lists the roster and then casts never reads the rule itself.\n  hints.push(\n    \"Casting one of these? Cast them with `--avatar <handle>` on `baker studio generate` / `baker studio animate` — that flag carries their face AND their accent. `baker avatars get <handle>` returns the written profile behind it; the roster leaves the description out on purpose, because it must never be read half-way.\",\n  );\n  const building = roster.filter((avatar) => avatar.status === \"generating\").map((avatar) => avatar.handle);\n  if (building.length > 0) {\n    hints.push(\n      `Still building, not castable yet: ${building.join(\", \")}. Check with \\`baker avatars get ${building[0]}\\` after your next piece of work.`,\n    );\n  }\n  const failed = roster.filter((avatar) => avatar.status === \"error\").map((avatar) => avatar.handle);\n  if (failed.length > 0) {\n    hints.push(\n      `Could not be built: ${failed.join(\", \")}. Read why with \\`baker avatars get ${failed[0]}\\`, then rebuild with \\`baker avatars update ${failed[0]} --subject \"…\" --regenerate-sheet\\`.`,\n    );\n  }\n  return hints;\n}\n\n/** The parts of a profile that describe a PERFORMANCE rather than a photograph. */\nexport interface AvatarPerformanceProfile {\n  persona?: string;\n  speech?: string;\n  accent?: string;\n  motion?: string;\n  wardrobe?: string;\n  setting?: string;\n}\n\n/**\n * Warn when an avatar was cast on a bare description.\n *\n * A subject description alone is enough to keep a FACE consistent and nothing\n * else, so every clip built on it comes back stiff and generic — the fields that\n * tell a video model how this person moves, dresses and stands are simply absent\n * from the render.\n *\n * Measured on one avatar, same sheet, same 5s brief, inter-frame motion averaged\n * over the clip: a bare profile with a flat prompt scored 1.28; adding a real\n * motion brief took it to 3.28; filling `motion`/`persona`/`speech`/`wardrobe`/\n * `setting` as well reached 4.91 — 3.8x the movement, for text that costs\n * nothing. The prompt is the bigger lever of the two, but the profile is the one\n * that keeps paying out on every future clip instead of just this one.\n */\nexport function thinProfileHint(profile: AvatarPerformanceProfile | undefined, handle: string): string | null {\n  const missing = ([\"motion\", \"persona\", \"speech\", \"accent\", \"wardrobe\", \"setting\"] as const).filter(\n    (field) => !profile?.[field]?.trim(),\n  );\n  if (missing.length === 0) return null;\n  return `MISSING ${missing.map((field) => `--${field}`).join(\" \")}. A bare subject description holds the face still and nothing else, so clips of @${handle} come out stiff and generic — measured, filling these in nearly doubled the movement in the same brief. --accent is the one nobody guesses and the only one that fails silently: it decides the LANGUAGE and accent the avatar speaks in, in every clip. Name the region whose language the USER is writing to you in (\"Spanish from Spain, Madrid accent\") — \"Spanish\" on its own renders as no accent at all, and a region taken from how the person LOOKS (\"European\", \"Nordic\") renders as that region's language: an ad for a Spanish client shipped with --accent \"German\" and came back spoken in German. The user almost certainly told you how this person talks and carries themselves; put it in: \\`baker avatars update ${handle} ${missing.map((field) => `--${field} \"…\"`).join(\" \")}\\`.`;\n}\n\n/**\n * Who picks the avatar's face.\n *\n * `ask` blocks on the user; `auto` lets the build cast one and keep it. Both are real\n * modes, not a default and a fallback: a scheduled agent rendering overnight has nobody to ask,\n * and blocking there would park the run until it times out.\n */\nexport type FaceChoice = \"ask\" | \"auto\";\n\n/**\n * Read `--face`. Null for a value this does not know.\n *\n * Defaulting to `ask` rather than `auto` is the deliberate half: an unasked face is\n * silent — the avatar comes back ready and looks finished, and nothing about it says the\n * user was skipped. A blocked turn is loud, and a person who is there can answer it.\n */\nexport function parseFaceChoice(raw: string | undefined): FaceChoice | null {\n  if (raw === undefined) return \"ask\";\n  const value = raw.trim().toLowerCase();\n  if (value === \"ask\" || value === \"auto\") return value;\n  return null;\n}\n\n/** Next steps straight after casting a new avatar — it is never ready yet. */\nexport function creationHints(\n  created: { handle: string; status: AvatarStatus; likeness: AvatarLikeness; faceChoice?: FaceChoice },\n  profile?: AvatarPerformanceProfile,\n): string[] {\n  const thin = thinProfileHint(profile, created.handle);\n  // First, ahead of everything — including \"still building, come back later\", which is\n  // true and is also the hint an agent acts on. Left to that one it goes off and does\n  // other work, and when it does want the user to choose a face it invents a question of\n  // its own: four text options, no portraits, a choice nobody can actually make. The\n  // sheet this avatar is building right now is fused from a face nobody has seen.\n  const casting =\n    created.likeness === \"synthetic\" && created.faceChoice === \"auto\"\n      ? [\n          `No one was asked about this face — \\`--face auto\\` cast it and it is kept. Do not tell the user they chose it, and do not offer them a pick you are not going to run. If this should have been theirs, say so and create it again with \\`--face ask\\`.`,\n        ]\n      : created.likeness === \"synthetic\"\n        ? [\n            `The user is being shown real portraits of @${created.handle} right now, and the turn waits for them to pick — this happens on its own, triggered by the command you just ran. The picker is already showing, so don't call request_avatar_casting, don't ask about the face in a question of your own, and don't wait or poll: whatever you do next simply runs after they have chosen — or, if they have not picked within 30 seconds of the faces appearing, after the first face is kept for them (then never say they chose it). Say what you created, then carry on with what the user asked for: when that was only the avatar, or they said to stop after it, stop there and render nothing.`,\n          ]\n        : [];\n  const hints = [\n    ...casting,\n    ...(thin ? [thin] : []),\n    ...castingHints({ handle: created.handle, status: created.status }),\n    `Once it is ready, cast it with \\`--avatar ${created.handle}\\` on \\`baker studio generate\\` / \\`baker studio animate\\` — that flag is what grounds the render on its identity sheet and, for a clip, what carries their accent and delivery into the read.`,\n  ];\n  if (created.likeness === \"licensed\") {\n    hints.push(\n      \"This avatar carries a real person's likeness, used on the company's confirmation that it may appear in their advertising. Keep it out of any creative that would misrepresent them, and out of claims they did not make.\",\n    );\n  }\n  return hints;\n}\n\n/** Next steps after an edit — mostly about keeping sheet and description in sync. */\nexport function updateHints(update: {\n  avatar: CastingSubject;\n  subjectChanged: boolean;\n  regeneratedSheet: boolean;\n  previousHandle: string;\n}): string[] {\n  const hints: string[] = [];\n  if (update.previousHandle !== update.avatar.handle) {\n    hints.push(\n      `Renamed to @${update.avatar.handle}. @${update.previousHandle} no longer resolves — update anything that mentioned it.`,\n    );\n  }\n\n  if (update.regeneratedSheet) {\n    hints.push(\n      `Rebuilding the identity sheet (~30s). The avatar is back to building and cannot be cast until \\`baker avatars get ${update.avatar.handle}\\` shows \\`ready\\` — and the sheet URL changes, so drop any \\`--reference\\` you were reusing and read the new one.`,\n    );\n    return hints;\n  }\n\n  if (update.subjectChanged) {\n    hints.push(\n      `MISSING --regenerate-sheet. You changed the subject description but the identity sheet still shows the person you described before, so the words and the face no longer match and every new render will drift. Re-run: \\`baker avatars update ${update.avatar.handle} --regenerate-sheet\\` (a ~30s rebuild, billed).`,\n    );\n    return hints;\n  }\n\n  hints.push(...castingHints(update.avatar));\n  return hints;\n}\n\n/** Next steps after retiring or deleting an avatar. */\nexport function removalHints(removal: { handle: string; archived: boolean }): string[] {\n  if (removal.archived) {\n    return [\n      `Retired @${removal.handle}. Work that already used it still resolves and its images stay as they are; it no longer shows in \\`baker avatars list\\` and must not be cast into anything new.`,\n    ];\n  }\n  return [\n    `Deleted @${removal.handle} for good. The mention no longer resolves anywhere — creatives that already rendered keep their images, but nothing new can be grounded on this identity. \\`--archive\\` is the reversible option next time.`,\n  ];\n}\n\n/**\n * Flatten one avatar for `--output md|files`, which can only print scalars.\n * JSON output is untouched — it already carries the shape the API returned.\n */\nexport function avatarRowNormalizer(record: Record<string, unknown>): Record<string, unknown> {\n  const flat: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(record)) {\n    if (Array.isArray(value)) {\n      flat[key] = value.join(\"; \");\n      continue;\n    }\n    if (value !== null && typeof value === \"object\") {\n      for (const [nested, nestedValue] of Object.entries(value as Record<string, unknown>)) {\n        flat[nested] = Array.isArray(nestedValue) ? nestedValue.join(\"; \") : nestedValue;\n      }\n      continue;\n    }\n    flat[key] = value;\n  }\n  return flat;\n}\n","import { ApiError } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\n\ntype Remediation = { action: string; explanation: string } & Record<string, unknown>;\n\nexport function failValidation(message: string, fix?: Remediation): never {\n  writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message, ...(fix ? { fix } : {}) } });\n  process.exit(1);\n}\n\n/**\n * The remedy for a failed avatar call, when there is one.\n *\n * An unknown handle and a taken one are the two failures the agent can act on, and each\n * has exactly one right move — which is the point: left with a bare message it invents a\n * third. A taken handle became a silent rename (\"Elena\" already existed from an earlier\n * chat, so it created \"Marta\"), which left the user reading about one avatar and looking\n * at another.\n */\n/** Which call failed. A CONFLICT means two different things on create and on remove. */\nexport interface AvatarFailureContext {\n  operation?: \"remove\";\n}\n\nexport function avatarFailureFix(\n  err: ApiError,\n  handle?: string,\n  context: AvatarFailureContext = {},\n): Remediation | undefined {\n  if (err.code === \"NOT_FOUND\") {\n    return {\n      action: \"list_avatars\",\n      explanation: `Run \\`baker avatars list\\` to see which avatars this company has${handle ? ` — \"${handle}\" is not one of them` : \"\"}. Handles are lowercase letters, numbers and dashes (\"maria-founder\", not \"Maria Founder\"). If the roster is empty, create the avatar first with \\`baker avatars create\\`. Do not abandon the wider job over this — carry on without the avatar and say so.`,\n    };\n  }\n  // A removal is refused for one reason only: the user is choosing this avatar's face.\n  // Falling through to the handle-collision remedy below answered that with \"use the\n  // existing avatar\", which is both wrong and an invitation to go find another one.\n  if (err.code === \"CONFLICT\" && context.operation === \"remove\") {\n    return {\n      action: \"wait_for_the_user\",\n      explanation: `Do not remove or recreate${handle ? ` @${handle}` : \" this avatar\"} — wait. The portraits are on the user's screen and the turn continues once they answer. If you think the faces are wrong, say so in your reply and let them turn all four down; that recasts the same avatar from what they tell you was missing, and keeps everything already pointing at it.`,\n    };\n  }\n  if (err.code === \"CONFLICT\" && handle) {\n    return {\n      action: \"use_the_existing_avatar\",\n      explanation: `@${handle} already exists in this company — avatars belong to the company, not to a chat, so one made in an earlier conversation is still here and still castable. If it is the person you want, use it as it is: \\`--avatar ${handle}\\`. Read it first with \\`baker avatars get ${handle} --full\\` and say who they already are. Do not create the same person under a second name: the user would be told about one avatar and handed another, and the company ends up with duplicates nobody chose a face for. If you genuinely need a different person, ask the user what to call them.`,\n    };\n  }\n  return undefined;\n}\n\n/**\n * Report a failed avatar call.\n */\nexport function failAvatarApi(err: unknown, handle?: string, context: AvatarFailureContext = {}): never {\n  if (err instanceof ApiError) {\n    const fix = avatarFailureFix(err, handle, context);\n    writeJson({ ok: false, error: { code: err.code, message: err.message, ...(fix ? { fix } : {}) } });\n    process.exit(1);\n  }\n  if (err instanceof Error) {\n    writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: err.message } });\n    process.exit(1);\n  }\n  writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n  process.exit(1);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-P4NSJS54.js

@@ -0,0 +1,20 @@
+// src/connected-resources.ts
+function listed(resources) {
+  return resources.map((resource) => resource.label ? `${resource.id} (${resource.label})` : resource.id).join("; ");
+}
+function connectedResourceHints({ plural, singular, flag, resources }) {
+  if (resources.length === 0) {
+    return [];
+  }
+  if (resources.length === 1) {
+    return [`This company connected one ${singular}: ${listed(resources)}. Commands use it unless you pass ${flag}.`];
+  }
+  return [
+    `This company connected ${resources.length} ${plural}: ${listed(resources)}. Each command works on one, so pass ${flag} \u2014 nothing is picked for you. A question about the whole business covers all ${resources.length}: answering from one and reporting it as the total is wrong.`
+  ];
+}
+
+export {
+  connectedResourceHints
+};
+//# sourceMappingURL=chunk-P4NSJS54.js.map

package/dist/chunk-P4NSJS54.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/connected-resources.ts"],"sourcesContent":["/**\n * What an agent must be told about what a company actually connected.\n *\n * Every connection picker is multi-select — GA4 properties, Search Console\n * sites, ad accounts, Tag Manager containers — so \"the property\" is an\n * assumption, not a fact. Two failures follow from that assumption, and this\n * hint heads off both: a command that names no resource is refused (each one\n * works on a single resource, and nothing is picked for the agent), and an\n * answer built from whichever came back first gets reported as the whole\n * business. The list rides along with the hint so the agent can act on it\n * without a second call.\n */\n\nexport interface ConnectedResource {\n  /** What the flag takes: property id, customer id, site url, container id. */\n  id: string;\n  /** How the user knows it. */\n  label?: string;\n}\n\nexport interface ConnectedResourceHintSpec {\n  /** Plural noun in the user's words: \"GA4 properties\", \"Google Ads accounts\". */\n  plural: string;\n  /** Singular of the same noun. */\n  singular: string;\n  /** The flag that names one: \"--property-id\", \"--customer-id\". */\n  flag: string;\n  resources: ConnectedResource[];\n}\n\nfunction listed(resources: ConnectedResource[]): string {\n  return resources.map((resource) => (resource.label ? `${resource.id} (${resource.label})` : resource.id)).join(\"; \");\n}\n\nexport function connectedResourceHints({ plural, singular, flag, resources }: ConnectedResourceHintSpec): string[] {\n  if (resources.length === 0) {\n    return [];\n  }\n  if (resources.length === 1) {\n    return [`This company connected one ${singular}: ${listed(resources)}. Commands use it unless you pass ${flag}.`];\n  }\n  return [\n    `This company connected ${resources.length} ${plural}: ${listed(resources)}. Each command works on one, so pass ` +\n      `${flag} — nothing is picked for you. A question about the whole business covers all ${resources.length}: ` +\n      \"answering from one and reporting it as the total is wrong.\",\n  ];\n}\n"],"mappings":";AA8BA,SAAS,OAAO,WAAwC;AACtD,SAAO,UAAU,IAAI,CAAC,aAAc,SAAS,QAAQ,GAAG,SAAS,EAAE,KAAK,SAAS,KAAK,MAAM,SAAS,EAAG,EAAE,KAAK,IAAI;AACrH;AAEO,SAAS,uBAAuB,EAAE,QAAQ,UAAU,MAAM,UAAU,GAAwC;AACjH,MAAI,UAAU,WAAW,GAAG;AAC1B,WAAO,CAAC;AAAA,EACV;AACA,MAAI,UAAU,WAAW,GAAG;AAC1B,WAAO,CAAC,8BAA8B,QAAQ,KAAK,OAAO,SAAS,CAAC,qCAAqC,IAAI,GAAG;AAAA,EAClH;AACA,SAAO;AAAA,IACL,0BAA0B,UAAU,MAAM,IAAI,MAAM,KAAK,OAAO,SAAS,CAAC,wCACrE,IAAI,qFAAgF,UAAU,MAAM;AAAA,EAE3G;AACF;","names":[]}

package/dist/chunk-P5T7OZKV.js

@@ -0,0 +1,26 @@
+import {
+  DEFAULT_VIDEO_GENERATE_MODEL,
+  clipAudioMode,
+  spokenWordsIn
+} from "./chunk-CAMX6OHF.js";
+
+// src/commands/studio/avatarModel.ts
+function pinnedModelHint(input) {
+  if (!input.avatar || !input.model) return null;
+  if (input.model === DEFAULT_VIDEO_GENERATE_MODEL) return null;
+  const speaks = input.generateAudio ?? true;
+  if (!speaks) return null;
+  return `You pinned --model ${input.model} on a speaking avatar. Without it this clip routes to ${DEFAULT_VIDEO_GENERATE_MODEL}, which was chosen for exactly this case: the better picture, both orientations, and audio always on. Drop --model unless the user asked for a specific one \u2014 and note ${input.model} may not take the length or the reference you are counting on.`;
+}
+function silentModelHint(model, prompt) {
+  if (!model || !prompt) return null;
+  if (clipAudioMode(model) !== "never") return null;
+  if (spokenWordsIn(prompt) === 0) return null;
+  return `${model} renders no audio \u2014 the line in this prompt will be mouthed and never heard. For a shot where someone speaks use ${DEFAULT_VIDEO_GENERATE_MODEL} (audio always on), or alibaba/wan-3.0 past 10 seconds. Keep this model for shots with no voice in them.`;
+}
+
+export {
+  pinnedModelHint,
+  silentModelHint
+};
+//# sourceMappingURL=chunk-P5T7OZKV.js.map

package/dist/chunk-P5T7OZKV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/studio/avatarModel.ts"],"sourcesContent":["import { clipAudioMode, DEFAULT_VIDEO_GENERATE_MODEL, spokenWordsIn } from \"@baker/canvas-contract\";\n\n/**\n * Pinning a model on a speaking avatar, which the routing had already decided better.\n *\n * A cast avatar with sound routes to Gemini Omni on purpose: it is the better picture, it\n * renders both orientations, and its audio is always on — which is what a talking clip\n * needs. Pin something else and that decision is discarded silently.\n *\n * Observed: the agent pinned `google/veo-3.1` unasked. Veo takes a first frame but no\n * reference, and renders 4, 6 or 8 seconds only — so its first attempt, at 15 seconds,\n * was refused outright. Nothing in the docs pointed there; it simply assumed.\n */\nexport function pinnedModelHint(input: { avatar?: string; model?: string; generateAudio?: boolean }): string | null {\n  if (!input.avatar || !input.model) return null;\n  if (input.model === DEFAULT_VIDEO_GENERATE_MODEL) return null;\n  const speaks = input.generateAudio ?? true;\n  if (!speaks) return null;\n  return `You pinned --model ${input.model} on a speaking avatar. Without it this clip routes to ${DEFAULT_VIDEO_GENERATE_MODEL}, which was chosen for exactly this case: the better picture, both orientations, and audio always on. Drop --model unless the user asked for a specific one — and note ${input.model} may not take the length or the reference you are counting on.`;\n}\n\n/**\n * A spoken line handed to a model that renders picture only.\n *\n * Runway and both Groks carry no audio at all. The line still gets mouthed — the take\n * looks almost right, and the silence is discovered by watching it, after paying. The\n * Studio now prints \"No sound\" for these; this is the same fact where the agent works.\n */\nexport function silentModelHint(model: string | undefined, prompt: string | undefined): string | null {\n  if (!model || !prompt) return null;\n  if (clipAudioMode(model) !== \"never\") return null;\n  if (spokenWordsIn(prompt) === 0) return null;\n  return `${model} renders no audio — the line in this prompt will be mouthed and never heard. For a shot where someone speaks use ${DEFAULT_VIDEO_GENERATE_MODEL} (audio always on), or alibaba/wan-3.0 past 10 seconds. Keep this model for shots with no voice in them.`;\n}\n"],"mappings":";;;;;;;AAaO,SAAS,gBAAgB,OAAoF;AAClH,MAAI,CAAC,MAAM,UAAU,CAAC,MAAM,MAAO,QAAO;AAC1C,MAAI,MAAM,UAAU,6BAA8B,QAAO;AACzD,QAAM,SAAS,MAAM,iBAAiB;AACtC,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,sBAAsB,MAAM,KAAK,yDAAyD,4BAA4B,+KAA0K,MAAM,KAAK;AACpT;AASO,SAAS,gBAAgB,OAA2B,QAA2C;AACpG,MAAI,CAAC,SAAS,CAAC,OAAQ,QAAO;AAC9B,MAAI,cAAc,KAAK,MAAM,QAAS,QAAO;AAC7C,MAAI,cAAc,MAAM,MAAM,EAAG,QAAO;AACxC,SAAO,GAAG,KAAK,yHAAoH,4BAA4B;AACjK;","names":[]}

package/dist/chunk-PAHLJMC3.js

@@ -0,0 +1,175 @@
+import {
+  handleConnectionError,
+  needsConnectionFix,
+  writeAdsJson
+} from "./chunk-BVM5IRZW.js";
+import {
+  LINKEDIN_SEARCH_STATUSES,
+  unsupportedLinkedinSearchStatuses
+} from "./chunk-KRIK2JR4.js";
+import {
+  ApiError
+} from "./chunk-HREWXNTO.js";
+import {
+  MissingChatIdError,
+  getEnv
+} from "./chunk-O6QKCJE4.js";
+
+// src/commands/ads/linkedin/shared.ts
+var DAY_MS = 864e5;
+function handleLinkedinError(err) {
+  if (err instanceof ApiError) {
+    if (needsConnectionFix(err.code, err.message)) {
+      handleConnectionError("linkedin_ads", err.message);
+    }
+    if (isNoAccountsSelectedError(err.code, err.message)) {
+      handleConnectionError("linkedin_ads", err.message);
+    }
+    const explanation = explainLinkedinError(err);
+    const envelope = {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: {
+          action: explanation.action,
+          explanation: explanation.message,
+          correctedCommand: explanation.correctedCommand
+        },
+        retryable: err.code === "RATE_LIMITED" || err.code === "UNAVAILABLE" || err.code === "INTERNAL_ERROR"
+      }
+    };
+    writeAdsJson(envelope);
+    process.exit(1);
+  }
+  writeAdsJson(unexpectedErrorEnvelope(err));
+  process.exit(1);
+}
+function unexpectedErrorEnvelope(err) {
+  if (err instanceof MissingChatIdError) {
+    return {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: {
+          action: "reject",
+          explanation: "LinkedIn changes are staged in a chat and this run has none. Don't retry: carry on with the rest of the job and tell the user this change couldn't be staged from here."
+        },
+        retryable: false
+      }
+    };
+  }
+  const message = err instanceof Error ? err.message : "Unexpected error";
+  return { ok: false, error: { code: "NETWORK_ERROR", message } };
+}
+function isNoAccountsSelectedError(code, message) {
+  return code === "VALIDATION_ERROR" && /no linkedin ad accounts selected/i.test(message);
+}
+function explainLinkedinError(err) {
+  const lower = err.message.toLowerCase();
+  if (err.code === "VALIDATION_ERROR" && lower.includes("granularity") && lower.includes("daily")) {
+    return {
+      action: "retry_with_flag",
+      message: "LinkedIn rejects DAILY granularity when pivoting on demographic dims (job-title, company, etc.). Re-run with --granularity ALL or MONTHLY.",
+      correctedCommand: void 0
+    };
+  }
+  if (err.code === "RATE_LIMITED") {
+    return {
+      action: "wait_and_retry",
+      message: "Hit a LinkedIn throttle. The CLI already backs off automatically \u2014 if you see this you've exhausted the retry budget. Wait ~60s and retry."
+    };
+  }
+  if (err.code === "INTERNAL_ERROR" && lower.includes("deprecat")) {
+    return {
+      action: "reject",
+      message: "LinkedIn-Version header is deprecated. The backend constant LINKEDIN_API_VERSION needs to be bumped \u2014 file an issue or update the constant."
+    };
+  }
+  return { action: "reject", message: err.message };
+}
+var LI_ACCOUNT_ID_RE = /^(urn:li:sponsoredAccount:)?\d+$/;
+function resolveAccountIdArg(args) {
+  const fromArgs = args["account-id"] ?? args["account-urn"];
+  const id = fromArgs || getEnv().BAKER_LINKEDIN_AD_ACCOUNT_ID;
+  if (!id) {
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "MISSING_ACCOUNT_ID",
+        message: "Pass --account-id (numeric) or --account-urn (urn:li:sponsoredAccount:N), or set BAKER_LINKEDIN_AD_ACCOUNT_ID. Run `baker ads linkedin accounts` to find IDs."
+      }
+    });
+    process.exit(1);
+  }
+  if (!LI_ACCOUNT_ID_RE.test(id)) {
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "INVALID_ACCOUNT_ID",
+        message: `Invalid LinkedIn account ID "${id}". Expected numeric or urn:li:sponsoredAccount:N.`
+      }
+    });
+    process.exit(1);
+  }
+  return id.startsWith("urn:") ? id.split(":").pop() ?? id : id;
+}
+function todayIso() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+function daysAgoIso(days) {
+  return new Date(Date.now() - days * DAY_MS).toISOString().slice(0, 10);
+}
+function csvOrJson(args) {
+  return args.output ?? "json";
+}
+function statusesArgDescription(level) {
+  return `CSV of statuses (${LINKEDIN_SEARCH_STATUSES[level].join(",")})`;
+}
+function statusFilterError(level, statuses) {
+  const unsupported = unsupportedLinkedinSearchStatuses(level, statuses);
+  if (unsupported.length === 0) {
+    return null;
+  }
+  const accepted = LINKEDIN_SEARCH_STATUSES[level].join(",");
+  return {
+    ok: false,
+    error: {
+      code: "INVALID_STATUS",
+      message: `LinkedIn does not accept status ${unsupported.join(", ")} for this listing.`,
+      fix: {
+        action: "retry_with_flag",
+        explanation: `Re-run with --statuses from ${accepted}, or --all-statuses to drop the filter.`
+      },
+      retryable: false
+    }
+  };
+}
+function resolveStatusFilter(args, level) {
+  if (args["all-statuses"]) {
+    return void 0;
+  }
+  const explicit = args.statuses;
+  if (!explicit) {
+    return ["ACTIVE"];
+  }
+  const statuses = explicit.split(",").map((s) => s.trim().toUpperCase()).filter(Boolean);
+  const error = statusFilterError(level, statuses);
+  if (error) {
+    writeAdsJson(error);
+    process.exit(1);
+  }
+  return statuses;
+}
+
+export {
+  handleLinkedinError,
+  resolveAccountIdArg,
+  todayIso,
+  daysAgoIso,
+  csvOrJson,
+  statusesArgDescription,
+  resolveStatusFilter
+};
+//# sourceMappingURL=chunk-PAHLJMC3.js.map

package/dist/chunk-PAHLJMC3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/shared.ts"],"sourcesContent":["import { LINKEDIN_SEARCH_STATUSES, type LinkedinSearchLevel, unsupportedLinkedinSearchStatuses } from \"@baker/api\";\nimport { ApiError } from \"../../../client.ts\";\nimport { getEnv, MissingChatIdError } from \"../../../env.ts\";\nimport { handleConnectionError, needsConnectionFix } from \"../../../error-handler.ts\";\nimport { writeAdsJson } from \"../output.ts\";\nimport type { AdsErrorEnvelope } from \"../types.ts\";\n\nconst DAY_MS = 86_400_000;\n\n/**\n * Map LinkedIn-flavored API errors into the shared CLI error envelope. The\n * backend already maps LinkedIn `serviceErrorCode` → tagged HTTP status, so by\n * the time we get here we just need to attach an actionable `fix` and exit.\n */\nexport function handleLinkedinError(err: unknown): never {\n  if (err instanceof ApiError) {\n    if (needsConnectionFix(err.code, err.message)) {\n      handleConnectionError(\"linkedin_ads\", err.message);\n    }\n    if (isNoAccountsSelectedError(err.code, err.message)) {\n      handleConnectionError(\"linkedin_ads\", err.message);\n    }\n    const explanation = explainLinkedinError(err);\n    const envelope: AdsErrorEnvelope = {\n      ok: false,\n      error: {\n        code: err.code,\n        message: err.message,\n        fix: {\n          action: explanation.action,\n          explanation: explanation.message,\n          correctedCommand: explanation.correctedCommand,\n        },\n        retryable: err.code === \"RATE_LIMITED\" || err.code === \"UNAVAILABLE\" || err.code === \"INTERNAL_ERROR\",\n      },\n    };\n    writeAdsJson(envelope);\n    process.exit(1);\n  }\n  writeAdsJson(unexpectedErrorEnvelope(err));\n  process.exit(1);\n}\n\n/**\n * Any failure that is not an API answer. A missing chat id gets its own code\n * and a fix — no retry can supply it — and anything else reads as the network.\n */\nexport function unexpectedErrorEnvelope(err: unknown): {\n  ok: false;\n  error: Pick<AdsErrorEnvelope[\"error\"], \"code\" | \"message\"> &\n    Partial<Pick<AdsErrorEnvelope[\"error\"], \"fix\" | \"retryable\">>;\n} {\n  if (err instanceof MissingChatIdError) {\n    return {\n      ok: false,\n      error: {\n        code: err.code,\n        message: err.message,\n        fix: {\n          action: \"reject\",\n          explanation:\n            \"LinkedIn changes are staged in a chat and this run has none. Don't retry: carry on with the rest of the job and tell the user this change couldn't be staged from here.\",\n        },\n        retryable: false,\n      },\n    };\n  }\n  const message = err instanceof Error ? err.message : \"Unexpected error\";\n  return { ok: false, error: { code: \"NETWORK_ERROR\", message } };\n}\n\n/**\n * \"No ad accounts selected\" comes back as a 400 (→ VALIDATION_ERROR), which\n * reads like a bad flag but is really an unfinished connection: the user has to\n * pick their accounts again. Route it to the connect flow, not flag advice.\n */\nexport function isNoAccountsSelectedError(code: string, message: string): boolean {\n  return code === \"VALIDATION_ERROR\" && /no linkedin ad accounts selected/i.test(message);\n}\n\nfunction explainLinkedinError(err: ApiError): {\n  action: AdsErrorEnvelope[\"error\"][\"fix\"][\"action\"];\n  message: string;\n  correctedCommand?: string;\n} {\n  const lower = err.message.toLowerCase();\n  if (err.code === \"VALIDATION_ERROR\" && lower.includes(\"granularity\") && lower.includes(\"daily\")) {\n    return {\n      action: \"retry_with_flag\",\n      message:\n        \"LinkedIn rejects DAILY granularity when pivoting on demographic dims (job-title, company, etc.). Re-run with --granularity ALL or MONTHLY.\",\n      correctedCommand: undefined,\n    };\n  }\n  if (err.code === \"RATE_LIMITED\") {\n    return {\n      action: \"wait_and_retry\",\n      message:\n        \"Hit a LinkedIn throttle. The CLI already backs off automatically — if you see this you've exhausted the retry budget. Wait ~60s and retry.\",\n    };\n  }\n  if (err.code === \"INTERNAL_ERROR\" && lower.includes(\"deprecat\")) {\n    return {\n      action: \"reject\",\n      message:\n        \"LinkedIn-Version header is deprecated. The backend constant LINKEDIN_API_VERSION needs to be bumped — file an issue or update the constant.\",\n    };\n  }\n  return { action: \"reject\", message: err.message };\n}\n\nconst LI_ACCOUNT_ID_RE = /^(urn:li:sponsoredAccount:)?\\d+$/;\n\n/** Pull the default LinkedIn ad account ID from `--account-id` arg or env. */\nexport function resolveAccountIdArg(args: Record<string, unknown>): string {\n  const fromArgs = (args[\"account-id\"] as string | undefined) ?? (args[\"account-urn\"] as string | undefined);\n  const id = fromArgs || getEnv().BAKER_LINKEDIN_AD_ACCOUNT_ID;\n  if (!id) {\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: \"MISSING_ACCOUNT_ID\",\n        message:\n          \"Pass --account-id (numeric) or --account-urn (urn:li:sponsoredAccount:N), or set BAKER_LINKEDIN_AD_ACCOUNT_ID. Run `baker ads linkedin accounts` to find IDs.\",\n      },\n    });\n    process.exit(1);\n  }\n  if (!LI_ACCOUNT_ID_RE.test(id)) {\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: \"INVALID_ACCOUNT_ID\",\n        message: `Invalid LinkedIn account ID \"${id}\". Expected numeric or urn:li:sponsoredAccount:N.`,\n      },\n    });\n    process.exit(1);\n  }\n  return id.startsWith(\"urn:\") ? (id.split(\":\").pop() ?? id) : id;\n}\n\nexport function todayIso(): string {\n  return new Date().toISOString().slice(0, 10);\n}\n\nexport function daysAgoIso(days: number): string {\n  return new Date(Date.now() - days * DAY_MS).toISOString().slice(0, 10);\n}\n\nexport function csvOrJson(args: Record<string, unknown>): string {\n  return (args.output as string | undefined) ?? \"json\";\n}\n\n/** The `--statuses` help line, listing exactly what LinkedIn accepts at this level. */\nexport function statusesArgDescription(level: LinkedinSearchLevel): string {\n  return `CSV of statuses (${LINKEDIN_SEARCH_STATUSES[level].join(\",\")})`;\n}\n\n/**\n * One status LinkedIn does not know fails the whole listing, so refuse it here\n * with the accepted values instead of forwarding LinkedIn's enum error.\n */\nexport function statusFilterError(level: LinkedinSearchLevel, statuses: readonly string[]): AdsErrorEnvelope | null {\n  const unsupported = unsupportedLinkedinSearchStatuses(level, statuses);\n  if (unsupported.length === 0) {\n    return null;\n  }\n  const accepted = LINKEDIN_SEARCH_STATUSES[level].join(\",\");\n  return {\n    ok: false,\n    error: {\n      code: \"INVALID_STATUS\",\n      message: `LinkedIn does not accept status ${unsupported.join(\", \")} for this listing.`,\n      fix: {\n        action: \"retry_with_flag\",\n        explanation: `Re-run with --statuses from ${accepted}, or --all-statuses to drop the filter.`,\n      },\n      retryable: false,\n    },\n  };\n}\n\n/**\n * Default to ACTIVE-only on listings — almost always what an AI agent or human\n * glance wants. `--all-statuses` widens; `--statuses ACTIVE,PAUSED` overrides.\n */\nexport function resolveStatusFilter(args: Record<string, unknown>, level: LinkedinSearchLevel): string[] | undefined {\n  if (args[\"all-statuses\"]) {\n    return undefined;\n  }\n  const explicit = args.statuses as string | undefined;\n  if (!explicit) {\n    return [\"ACTIVE\"];\n  }\n  const statuses = explicit\n    .split(\",\")\n    .map((s) => s.trim().toUpperCase())\n    .filter(Boolean);\n  const error = statusFilterError(level, statuses);\n  if (error) {\n    writeAdsJson(error);\n    process.exit(1);\n  }\n  return statuses;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAOA,IAAM,SAAS;AAOR,SAAS,oBAAoB,KAAqB;AACvD,MAAI,eAAe,UAAU;AAC3B,QAAI,mBAAmB,IAAI,MAAM,IAAI,OAAO,GAAG;AAC7C,4BAAsB,gBAAgB,IAAI,OAAO;AAAA,IACnD;AACA,QAAI,0BAA0B,IAAI,MAAM,IAAI,OAAO,GAAG;AACpD,4BAAsB,gBAAgB,IAAI,OAAO;AAAA,IACnD;AACA,UAAM,cAAc,qBAAqB,GAAG;AAC5C,UAAM,WAA6B;AAAA,MACjC,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,MAAM,IAAI;AAAA,QACV,SAAS,IAAI;AAAA,QACb,KAAK;AAAA,UACH,QAAQ,YAAY;AAAA,UACpB,aAAa,YAAY;AAAA,UACzB,kBAAkB,YAAY;AAAA,QAChC;AAAA,QACA,WAAW,IAAI,SAAS,kBAAkB,IAAI,SAAS,iBAAiB,IAAI,SAAS;AAAA,MACvF;AAAA,IACF;AACA,iBAAa,QAAQ;AACrB,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,eAAa,wBAAwB,GAAG,CAAC;AACzC,UAAQ,KAAK,CAAC;AAChB;AAMO,SAAS,wBAAwB,KAItC;AACA,MAAI,eAAe,oBAAoB;AACrC,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,MAAM,IAAI;AAAA,QACV,SAAS,IAAI;AAAA,QACb,KAAK;AAAA,UACH,QAAQ;AAAA,UACR,aACE;AAAA,QACJ;AAAA,QACA,WAAW;AAAA,MACb;AAAA,IACF;AAAA,EACF;AACA,QAAM,UAAU,eAAe,QAAQ,IAAI,UAAU;AACrD,SAAO,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,iBAAiB,QAAQ,EAAE;AAChE;AAOO,SAAS,0BAA0B,MAAc,SAA0B;AAChF,SAAO,SAAS,sBAAsB,oCAAoC,KAAK,OAAO;AACxF;AAEA,SAAS,qBAAqB,KAI5B;AACA,QAAM,QAAQ,IAAI,QAAQ,YAAY;AACtC,MAAI,IAAI,SAAS,sBAAsB,MAAM,SAAS,aAAa,KAAK,MAAM,SAAS,OAAO,GAAG;AAC/F,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,SACE;AAAA,MACF,kBAAkB;AAAA,IACpB;AAAA,EACF;AACA,MAAI,IAAI,SAAS,gBAAgB;AAC/B,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,SACE;AAAA,IACJ;AAAA,EACF;AACA,MAAI,IAAI,SAAS,oBAAoB,MAAM,SAAS,UAAU,GAAG;AAC/D,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,SACE;AAAA,IACJ;AAAA,EACF;AACA,SAAO,EAAE,QAAQ,UAAU,SAAS,IAAI,QAAQ;AAClD;AAEA,IAAM,mBAAmB;AAGlB,SAAS,oBAAoB,MAAuC;AACzE,QAAM,WAAY,KAAK,YAAY,KAA6B,KAAK,aAAa;AAClF,QAAM,KAAK,YAAY,OAAO,EAAE;AAChC,MAAI,CAAC,IAAI;AACP,iBAAa;AAAA,MACX,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,MAAM;AAAA,QACN,SACE;AAAA,MACJ;AAAA,IACF,CAAC;AACD,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,MAAI,CAAC,iBAAiB,KAAK,EAAE,GAAG;AAC9B,iBAAa;AAAA,MACX,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,MAAM;AAAA,QACN,SAAS,gCAAgC,EAAE;AAAA,MAC7C;AAAA,IACF,CAAC;AACD,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,SAAO,GAAG,WAAW,MAAM,IAAK,GAAG,MAAM,GAAG,EAAE,IAAI,KAAK,KAAM;AAC/D;AAEO,SAAS,WAAmB;AACjC,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,MAAM,GAAG,EAAE;AAC7C;AAEO,SAAS,WAAW,MAAsB;AAC/C,SAAO,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE;AACvE;AAEO,SAAS,UAAU,MAAuC;AAC/D,SAAQ,KAAK,UAAiC;AAChD;AAGO,SAAS,uBAAuB,OAAoC;AACzE,SAAO,oBAAoB,yBAAyB,KAAK,EAAE,KAAK,GAAG,CAAC;AACtE;AAMO,SAAS,kBAAkB,OAA4B,UAAsD;AAClH,QAAM,cAAc,kCAAkC,OAAO,QAAQ;AACrE,MAAI,YAAY,WAAW,GAAG;AAC5B,WAAO;AAAA,EACT;AACA,QAAM,WAAW,yBAAyB,KAAK,EAAE,KAAK,GAAG;AACzD,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,MACL,MAAM;AAAA,MACN,SAAS,mCAAmC,YAAY,KAAK,IAAI,CAAC;AAAA,MAClE,KAAK;AAAA,QACH,QAAQ;AAAA,QACR,aAAa,+BAA+B,QAAQ;AAAA,MACtD;AAAA,MACA,WAAW;AAAA,IACb;AAAA,EACF;AACF;AAMO,SAAS,oBAAoB,MAA+B,OAAkD;AACnH,MAAI,KAAK,cAAc,GAAG;AACxB,WAAO;AAAA,EACT;AACA,QAAM,WAAW,KAAK;AACtB,MAAI,CAAC,UAAU;AACb,WAAO,CAAC,QAAQ;AAAA,EAClB;AACA,QAAM,WAAW,SACd,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,EACjC,OAAO,OAAO;AACjB,QAAM,QAAQ,kBAAkB,OAAO,QAAQ;AAC/C,MAAI,OAAO;AACT,iBAAa,KAAK;AAClB,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,SAAO;AACT;","names":[]}

package/dist/chunk-PBVLPFJ6.js

@@ -0,0 +1,169 @@
+import {
+  parseXApiError
+} from "./chunk-M6UNISGO.js";
+import {
+  resolveXAccountId
+} from "./chunk-G7AFVTUS.js";
+import {
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-BVM5IRZW.js";
+import {
+  X_DRAFT_BATCH_MAX,
+  xDraftOpInputSchema
+} from "./chunk-KRIK2JR4.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import {
+  requireChatId
+} from "./chunk-O6QKCJE4.js";
+
+// src/commands/ads/x/write-shared.ts
+function failWriteValidation(message) {
+  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function failPreflight(fields) {
+  writeJsonEnvelope({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: fields.map((f) => f.path ? `${f.path}: ${f.message}` : f.message).join("; "),
+      fields,
+      fix: {
+        action: "reject",
+        explanation: "Fix the named fields and stage again. Nothing was staged \u2014 the draft is exactly as it was before this call."
+      }
+    }
+  });
+  process.exit(1);
+}
+function handleXWriteError(err, accountId) {
+  if (err instanceof ApiError) {
+    writeAdsJson(parseXApiError(err.message, accountId));
+    process.exit(1);
+  }
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+function decimalPlaces(value) {
+  const [mantissa, exponent] = String(value).trim().split(/e/i);
+  const written = (mantissa?.split(".")[1] ?? "").length;
+  return Math.max(0, written - (exponent ? Number(exponent) : 0));
+}
+function parseXMoney(value) {
+  if (value === void 0 || value === "") {
+    return { ok: true, micros: void 0 };
+  }
+  const amount = Number(value);
+  if (!Number.isFinite(amount) || amount <= 0) {
+    return { ok: false, reason: "must be a positive amount, for example 12.50" };
+  }
+  if (decimalPlaces(value) > 6) {
+    return { ok: false, reason: "is finer than X can express \u2014 it takes whole micros" };
+  }
+  return { ok: true, micros: Math.round(amount * 1e6) };
+}
+function microsFromArg(value, flag) {
+  const parsed = parseXMoney(value);
+  if (!parsed.ok) {
+    failWriteValidation(`${flag} ${parsed.reason}`);
+  }
+  return parsed.micros;
+}
+function csvArg(value) {
+  if (typeof value !== "string" || value.length === 0) {
+    return void 0;
+  }
+  const parts = value.split(",").map((s) => s.trim()).filter(Boolean);
+  return parts.length > 0 ? parts : void 0;
+}
+function compact(payload) {
+  return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== void 0));
+}
+function batchNudge(data) {
+  const count = data?.sameKindStaged;
+  if (!count) {
+    return [];
+  }
+  return [
+    `${count} other change${count === 1 ? "" : "s"} of this kind and payload ${count === 1 ? "is" : "are"} already staged \u2014 pass every id to one call (\`--ids a,b,c\`) instead of one call each.`
+  ];
+}
+async function stageXOp(raw, hints) {
+  const preflight = xDraftOpInputSchema.safeParse(raw);
+  if (!preflight.success) {
+    failPreflight(preflight.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message })));
+  }
+  const accountId = String(raw.accountId ?? "\u2014");
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/ads/x/draft/stage", { chatId, op: preflight.data });
+    const allHints = [...batchNudge(response.data), ...hints ?? []];
+    writeJsonEnvelope(allHints.length > 0 ? { ...response, hints: allHints } : response);
+  } catch (err) {
+    handleXWriteError(err, accountId);
+  }
+}
+async function stageXOps(rawOps, hints) {
+  if (rawOps.length === 1 && rawOps[0]) {
+    await stageXOp(rawOps[0], hints);
+    return;
+  }
+  if (rawOps.length > X_DRAFT_BATCH_MAX) {
+    failWriteValidation(`at most ${X_DRAFT_BATCH_MAX} changes can be staged in one call`);
+  }
+  const ops = [];
+  for (const [index, raw] of rawOps.entries()) {
+    const preflight = xDraftOpInputSchema.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);
+  }
+  const accountId = String(rawOps[0]?.accountId ?? "\u2014");
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/ads/x/draft/stage-batch", { chatId, ops });
+    writeJsonEnvelope(hints && hints.length > 0 ? { ...response, hints } : response);
+  } catch (err) {
+    handleXWriteError(err, accountId);
+  }
+}
+async function stageAccountId(args) {
+  return await resolveXAccountId(args);
+}
+function requireTarget(args, name) {
+  const value = args[name];
+  if (typeof value !== "string" || value.length === 0) {
+    failWriteValidation(`${name} is required`);
+  }
+  return value;
+}
+function requireTargets(args, name) {
+  const ids = csvArg(args[name]);
+  if (!ids) {
+    failWriteValidation(`${name} is required \u2014 pass one or more ids, comma-separated`);
+  }
+  return ids;
+}
+
+export {
+  failWriteValidation,
+  microsFromArg,
+  csvArg,
+  compact,
+  stageXOp,
+  stageXOps,
+  stageAccountId,
+  requireTarget,
+  requireTargets
+};
+//# sourceMappingURL=chunk-PBVLPFJ6.js.map

package/dist/chunk-PBVLPFJ6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/write-shared.ts"],"sourcesContent":["import {\n  X_DRAFT_BATCH_MAX,\n  type XDraftStageBatchResponse,\n  type XDraftStageResponse,\n  xDraftOpInputSchema,\n} from \"@baker/api\";\nimport { ApiError, apiPost } from \"../../../client.ts\";\nimport { requireChatId } from \"../../../env.ts\";\nimport { writeAdsJson, writeJsonEnvelope } from \"../output.ts\";\nimport { parseXApiError } from \"./error-parser.ts\";\nimport { resolveXAccountId } from \"./output.ts\";\n\n/**\n * Shared plumbing for the staged X write commands.\n *\n * Writes NEVER reach X directly: every command stages an op against this chat's\n * draft (`/api/ads/x/draft/stage`), the dashboard shows it as a pending X\n * change, and it applies only when the chat is published.\n */\n\nexport function failWriteValidation(message: string): never {\n  writeJsonEnvelope({ ok: false, error: { code: \"VALIDATION_ERROR\", message } });\n  process.exit(1);\n}\n\nfunction failPreflight(fields: Array<{ path: string; message: string }>): never {\n  writeJsonEnvelope({\n    ok: false,\n    error: {\n      code: \"VALIDATION_ERROR\",\n      message: fields.map((f) => (f.path ? `${f.path}: ${f.message}` : f.message)).join(\"; \"),\n      fields,\n      fix: {\n        action: \"reject\",\n        explanation:\n          \"Fix the named fields and stage again. Nothing was staged — the draft is exactly as it was before this call.\",\n      },\n    },\n  });\n  process.exit(1);\n}\n\nexport function handleXWriteError(err: unknown, accountId: string): never {\n  if (err instanceof ApiError) {\n    writeAdsJson(parseXApiError(err.message, accountId));\n    process.exit(1);\n  }\n  writeAdsJson({ ok: false, error: { code: \"NETWORK_ERROR\", message: \"Unexpected error\" } });\n  process.exit(1);\n}\n\n/**\n * Digits after the decimal point, read off the written amount rather than\n * measured on the product.\n *\n * Exponent form is what makes this worth a helper: `String(0.0000005)` is\n * `\"5e-7\"`, whose mantissa has no decimals at all.\n */\nfunction decimalPlaces(value: unknown): number {\n  const [mantissa, exponent] = String(value).trim().split(/e/i);\n  const written = (mantissa?.split(\".\")[1] ?? \"\").length;\n  return Math.max(0, written - (exponent ? Number(exponent) : 0));\n}\n\nexport type XMoneyParse = { ok: true; micros: number | undefined } | { ok: false; reason: string };\n\n/**\n * Money on X is integer micros of the account currency, and the CLI takes the\n * human amount so nobody has to count zeros. Rejecting a fraction of a micro\n * here is what keeps the staged payload byte-identical to the request X gets.\n *\n * The precision test counts the decimals the caller wrote instead of comparing\n * `amount * 1e6` against its rounding. That comparison needed a tolerance, and\n * any absolute one is wrong somewhere: `1e-6` is finer than a double's own\n * spacing once the product passes 2^34, so `--total-budget 16384.01` — a whole\n * number of cents — was refused as finer than X can express. Counting decimals\n * is exact at every magnitude and needs no tolerance at all.\n */\nexport function parseXMoney(value: unknown): XMoneyParse {\n  if (value === undefined || value === \"\") {\n    return { ok: true, micros: undefined };\n  }\n  const amount = Number(value);\n  if (!Number.isFinite(amount) || amount <= 0) {\n    return { ok: false, reason: \"must be a positive amount, for example 12.50\" };\n  }\n  if (decimalPlaces(value) > 6) {\n    return { ok: false, reason: \"is finer than X can express — it takes whole micros\" };\n  }\n  return { ok: true, micros: Math.round(amount * 1_000_000) };\n}\n\nexport function microsFromArg(value: unknown, flag: string): number | undefined {\n  const parsed = parseXMoney(value);\n  if (!parsed.ok) {\n    failWriteValidation(`${flag} ${parsed.reason}`);\n  }\n  return parsed.micros;\n}\n\nexport function csvArg(value: unknown): string[] | undefined {\n  if (typeof value !== \"string\" || value.length === 0) {\n    return undefined;\n  }\n  const parts = value\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter(Boolean);\n  return parts.length > 0 ? parts : undefined;\n}\n\n/** Drop undefined keys so an omitted flag never stages as an explicit value. */\nexport function compact(payload: Record<string, unknown>): Record<string, unknown> {\n  return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== undefined));\n}\n\ninterface StageEnvelope extends Record<string, unknown> {\n  ok: true;\n  data: XDraftStageResponse;\n}\n\n/**\n * The nudge to pass every id in one call instead of looping. Gated on\n * `sameKindStaged`, which the backend only sets for a command that really does\n * take an id list — a nudge pointed at a single-id command fails when obeyed.\n */\nfunction batchNudge(data: XDraftStageResponse | undefined): string[] {\n  const count = data?.sameKindStaged;\n  if (!count) {\n    return [];\n  }\n  return [\n    `${count} other change${count === 1 ? \"\" : \"s\"} of this kind and payload ${count === 1 ? \"is\" : \"are\"} already staged — pass every id to one call (\\`--ids a,b,c\\`) instead of one call each.`,\n  ];\n}\n\nexport async function stageXOp(raw: Record<string, unknown>, hints?: string[]): Promise<void> {\n  const preflight = xDraftOpInputSchema.safeParse(raw);\n  if (!preflight.success) {\n    failPreflight(preflight.error.issues.map((issue) => ({ path: issue.path.join(\".\"), message: issue.message })));\n  }\n  const accountId = String(raw.accountId ?? \"—\");\n  try {\n    const chatId = requireChatId();\n    const response = await apiPost<StageEnvelope>(\"/api/ads/x/draft/stage\", { chatId, op: preflight.data });\n    const allHints = [...batchNudge(response.data), ...(hints ?? [])];\n    writeJsonEnvelope(allHints.length > 0 ? { ...response, hints: allHints } : response);\n  } catch (err) {\n    handleXWriteError(err, accountId);\n  }\n}\n\ninterface StageBatchEnvelope extends Record<string, unknown> {\n  ok: true;\n  data: XDraftStageBatchResponse;\n}\n\n/**\n * Stage several ops as ONE request — all-or-nothing on the backend, one\n * rate-limit hit instead of one per id. A single op falls through to the plain\n * stage path so its envelope, amend behaviour and hints stay identical.\n */\nexport async function stageXOps(rawOps: Array<Record<string, unknown>>, hints?: string[]): Promise<void> {\n  if (rawOps.length === 1 && rawOps[0]) {\n    await stageXOp(rawOps[0], hints);\n    return;\n  }\n  if (rawOps.length > X_DRAFT_BATCH_MAX) {\n    failWriteValidation(`at most ${X_DRAFT_BATCH_MAX} changes can be staged in one call`);\n  }\n  const ops: unknown[] = [];\n  for (const [index, raw] of rawOps.entries()) {\n    const preflight = xDraftOpInputSchema.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  const accountId = String(rawOps[0]?.accountId ?? \"—\");\n  try {\n    const chatId = requireChatId();\n    const response = await apiPost<StageBatchEnvelope>(\"/api/ads/x/draft/stage-batch\", { chatId, ops });\n    writeJsonEnvelope(hints && hints.length > 0 ? { ...response, hints } : response);\n  } catch (err) {\n    handleXWriteError(err, accountId);\n  }\n}\n\n/** The account every staged write is scoped to. */\nexport async function stageAccountId(args: Record<string, unknown>): Promise<string> {\n  return await resolveXAccountId(args);\n}\n\n/** One required positional id. */\nexport function requireTarget(args: Record<string, unknown>, name: string): string {\n  const value = args[name];\n  if (typeof value !== \"string\" || value.length === 0) {\n    failWriteValidation(`${name} is required`);\n  }\n  return value;\n}\n\n/**\n * A comma-separated list of ids, for the commands that apply one payload to\n * many entities. Reading `process.argv` is deliberate for repeated flags\n * elsewhere in this CLI; here a single `--ids a,b,c` is the contract, so the\n * citty value is enough and there is nothing to lose.\n */\nexport function requireTargets(args: Record<string, unknown>, name: string): string[] {\n  const ids = csvArg(args[name]);\n  if (!ids) {\n    failWriteValidation(`${name} is required — pass one or more ids, comma-separated`);\n  }\n  return ids;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-PFBQERWX.js

@@ -0,0 +1,10 @@
+// src/commands/chat-arg.ts
+var CHAT_READ_ARG = {
+  type: "string",
+  description: "Read another chat's staged changes instead of this one's. Start here when asked to redo, reapply or explain what an earlier chat did \u2014 its changes are kept verbatim, including what happened to each one on publish. Never retype an earlier chat's work from a summary."
+};
+
+export {
+  CHAT_READ_ARG
+};
+//# sourceMappingURL=chunk-PFBQERWX.js.map

package/dist/chunk-PFBQERWX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/chat-arg.ts"],"sourcesContent":["/**\n * The `--chat` flag every draft-read command shares.\n *\n * A staged change is kept exactly as it was written, and it outlives the chat that wrote it — so\n * \"redo what that chat did\" is a read, not a reconstruction. One definition rather than seven so\n * the flag means the same thing on Google, Meta, LinkedIn, Tag Manager, Tasks, tags and schedules.\n *\n * Read commands only. Anything that stages, amends or discards keeps using `requireChatId`.\n */\nexport const CHAT_READ_ARG = {\n  type: \"string\",\n  description:\n    \"Read another chat's staged changes instead of this one's. Start here when asked to redo, reapply or explain what an earlier chat did — its changes are kept verbatim, including what happened to each one on publish. Never retype an earlier chat's work from a summary.\",\n} as const;\n"],"mappings":";AASO,IAAM,gBAAgB;AAAA,EAC3B,MAAM;AAAA,EACN,aACE;AACJ;","names":[]}

package/dist/chunk-Q6ULQMWG.js

@@ -0,0 +1,41 @@
+// src/commands/images/searchHints.ts
+var SUBJECT_PLACEHOLDER = {
+  stock: "<query>",
+  google: "<query>",
+  library: "<query>",
+  find: "<query>",
+  logo: "<domain>",
+  icon: "<name>"
+};
+var FALLBACK = {
+  stock: () => "Still empty \u2192 `baker images find <query> --sources library,pinterest,google` (one call across the providers stock does not cover \u2014 `--sources` is required, `find` alone searches the library only) or `baker studio generate` to make the asset. Do not re-run this search with reshuffled flags.",
+  google: () => "Still empty \u2192 `baker studio generate` to make the asset. Google is the last-resort provider; there is nothing below it to retry.",
+  // The library is step 1 of the sourcing recipe, so its empty result is the
+  // most common one an agent hits — and the one that previously steered nowhere.
+  library: () => "The library does not hold this yet \u2014 that is a normal starting state, not a failure. Source it externally, which also files it into the library for next time: `baker images find <query> --sources library,pexels,pixabay,pinterest,google` for a broad sweep, `baker images stock <query>` for photography or `--type vector` for artwork, `baker images logo <domain>` for a brand mark, or `baker studio generate` to make it. Do not re-run this search with reshuffled filters.",
+  find: () => "`find` searches only the sources you name \u2014 with no `--sources` it searches the library alone, which is the usual cause of an empty fanout. Re-run as `baker images find <query> --sources library,pexels,pixabay,pinterest,google`. If that is still empty, `baker studio generate` makes the asset.",
+  logo: (subject) => `Brandfetch does not know this domain \u2014 that is normal for small or recently renamed brands, and is not a failure. Pull the mark off the brand's own site instead: \`baker images extract https://${subject}\`. For a tech or product mark also try \`baker images icon <name> --set logos\`.`,
+  icon: (subject) => `No icon matched. Iconify is set-scoped, so the set is usually the problem, not the name: retry with \`baker images icon ${subject} --set lucide\` (UI glyphs), \`--set simple-icons\` or \`--set logos\` (brand marks), \`--set devicon\` (tech stack). Still nothing \u2192 \`baker images stock ${subject} --type vector\`, then \`baker studio generate\` with the vector model.`
+};
+function emptyResultHints({ provider, hitCount, activeFilters, subject }) {
+  if (hitCount > 0) {
+    return [];
+  }
+  const hints = [];
+  if (activeFilters.length > 0) {
+    hints.push(
+      `No hits. Drop the filters before touching the query \u2014 ${activeFilters.join(", ")} narrowed this search and filter combinations are the usual cause of an empty result.`
+    );
+  }
+  hints.push(FALLBACK[provider](subject && subject.length > 0 ? subject : SUBJECT_PLACEHOLDER[provider]));
+  return hints;
+}
+function activeFilterFlags(args, candidates) {
+  return candidates.filter((flag) => args[flag] !== void 0 && args[flag] !== "").map((flag) => `--${flag}`);
+}
+
+export {
+  emptyResultHints,
+  activeFilterFlags
+};
+//# sourceMappingURL=chunk-Q6ULQMWG.js.map

package/dist/chunk-Q6ULQMWG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/searchHints.ts"],"sourcesContent":["/**\n * Zero-hit steering for the single-provider image searches.\n *\n * A provider search that returns nothing gives the agent no signal about WHY,\n * so it re-runs the same query with reshuffled flags until it gives up — the\n * dominant time sink in image sourcing. These hints name the two real exits:\n * drop the filters that narrowed the search, then leave the provider entirely.\n */\n\nexport type ImageSearchProvider = \"stock\" | \"google\" | \"library\" | \"find\" | \"logo\" | \"icon\";\n\ninterface EmptyResultInput {\n  provider: ImageSearchProvider;\n  hitCount: number;\n  activeFilters: string[];\n  /** What was searched for — a domain for `logo`, an icon name for `icon`.\n   * Interpolated into the exit route so the agent gets a runnable command\n   * rather than a shape to fill in. */\n  subject?: string;\n}\n\n/** Stand-in when the caller passes no subject, so the hint still reads as a command. */\nconst SUBJECT_PLACEHOLDER: Record<ImageSearchProvider, string> = {\n  stock: \"<query>\",\n  google: \"<query>\",\n  library: \"<query>\",\n  find: \"<query>\",\n  logo: \"<domain>\",\n  icon: \"<name>\",\n};\n\nconst FALLBACK: Record<ImageSearchProvider, (subject: string) => string> = {\n  stock: () =>\n    \"Still empty → `baker images find <query> --sources library,pinterest,google` (one call across the providers stock does not cover — `--sources` is required, `find` alone searches the library only) or `baker studio generate` to make the asset. Do not re-run this search with reshuffled flags.\",\n  google: () =>\n    \"Still empty → `baker studio generate` to make the asset. Google is the last-resort provider; there is nothing below it to retry.\",\n  // The library is step 1 of the sourcing recipe, so its empty result is the\n  // most common one an agent hits — and the one that previously steered nowhere.\n  library: () =>\n    \"The library does not hold this yet — that is a normal starting state, not a failure. Source it externally, which also files it into the library for next time: `baker images find <query> --sources library,pexels,pixabay,pinterest,google` for a broad sweep, `baker images stock <query>` for photography or `--type vector` for artwork, `baker images logo <domain>` for a brand mark, or `baker studio generate` to make it. Do not re-run this search with reshuffled filters.\",\n  find: () =>\n    \"`find` searches only the sources you name — with no `--sources` it searches the library alone, which is the usual cause of an empty fanout. Re-run as `baker images find <query> --sources library,pexels,pixabay,pinterest,google`. If that is still empty, `baker studio generate` makes the asset.\",\n  logo: (subject) =>\n    `Brandfetch does not know this domain — that is normal for small or recently renamed brands, and is not a failure. Pull the mark off the brand's own site instead: \\`baker images extract https://${subject}\\`. For a tech or product mark also try \\`baker images icon <name> --set logos\\`.`,\n  icon: (subject) =>\n    `No icon matched. Iconify is set-scoped, so the set is usually the problem, not the name: retry with \\`baker images icon ${subject} --set lucide\\` (UI glyphs), \\`--set simple-icons\\` or \\`--set logos\\` (brand marks), \\`--set devicon\\` (tech stack). Still nothing → \\`baker images stock ${subject} --type vector\\`, then \\`baker studio generate\\` with the vector model.`,\n};\n\nexport function emptyResultHints({ provider, hitCount, activeFilters, subject }: EmptyResultInput): string[] {\n  if (hitCount > 0) {\n    return [];\n  }\n  const hints: string[] = [];\n  if (activeFilters.length > 0) {\n    hints.push(\n      `No hits. Drop the filters before touching the query — ${activeFilters.join(\", \")} narrowed this search and filter combinations are the usual cause of an empty result.`,\n    );\n  }\n  hints.push(FALLBACK[provider](subject && subject.length > 0 ? subject : SUBJECT_PLACEHOLDER[provider]));\n  return hints;\n}\n\n/** The flags the caller actually passed, in the agent's own vocabulary. */\nexport function activeFilterFlags(args: Record<string, unknown>, candidates: string[]): string[] {\n  return candidates.filter((flag) => args[flag] !== undefined && args[flag] !== \"\").map((flag) => `--${flag}`);\n}\n"],"mappings":";AAsBA,IAAM,sBAA2D;AAAA,EAC/D,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AACR;AAEA,IAAM,WAAqE;AAAA,EACzE,OAAO,MACL;AAAA,EACF,QAAQ,MACN;AAAA;AAAA;AAAA,EAGF,SAAS,MACP;AAAA,EACF,MAAM,MACJ;AAAA,EACF,MAAM,CAAC,YACL,yMAAoM,OAAO;AAAA,EAC7M,MAAM,CAAC,YACL,2HAA2H,OAAO,mKAA8J,OAAO;AAC3S;AAEO,SAAS,iBAAiB,EAAE,UAAU,UAAU,eAAe,QAAQ,GAA+B;AAC3G,MAAI,WAAW,GAAG;AAChB,WAAO,CAAC;AAAA,EACV;AACA,QAAM,QAAkB,CAAC;AACzB,MAAI,cAAc,SAAS,GAAG;AAC5B,UAAM;AAAA,MACJ,8DAAyD,cAAc,KAAK,IAAI,CAAC;AAAA,IACnF;AAAA,EACF;AACA,QAAM,KAAK,SAAS,QAAQ,EAAE,WAAW,QAAQ,SAAS,IAAI,UAAU,oBAAoB,QAAQ,CAAC,CAAC;AACtG,SAAO;AACT;AAGO,SAAS,kBAAkB,MAA+B,YAAgC;AAC/F,SAAO,WAAW,OAAO,CAAC,SAAS,KAAK,IAAI,MAAM,UAAa,KAAK,IAAI,MAAM,EAAE,EAAE,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE;AAC7G;","names":[]}