@koda-sl/baker-cli 0.481.0-dev.2d33e194f → 0.495.0-dev.c2b64ccca

package/dist/generate-LWSAKRIT.js

@@ -0,0 +1,263 @@
+import {
+  IMAGE_MODEL_IDS,
+  IMAGE_QUALITIES,
+  IMAGE_SIZES,
+  resolveLibraryImageIds
+} from "./chunk-FP3GNJN2.js";
+import {
+  awaitBatch,
+  batchHints,
+  projectBatch,
+  resolveMaxWaitMs,
+  waitingHint
+} from "./chunk-2MT3AWDE.js";
+import {
+  failStudioCommand
+} from "./chunk-YNOJN5Z6.js";
+import "./chunk-DGUYFROS.js";
+import "./chunk-2C36DHQH.js";
+import {
+  DEFAULT_IMAGE_GENERATE_MODEL,
+  MODEL_REGISTRY,
+  canonicalModelId,
+  maxInputReferences
+} from "./chunk-QK5PEHFX.js";
+import "./chunk-3FFJYMKM.js";
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-OSWCEDFE.js";
+import "./chunk-D53AAUG4.js";
+import "./chunk-FZKUUI3F.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4WYEGE4N.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/studio/generate.ts
+import { defineCommand } from "citty";
+var MODEL_LIST = IMAGE_MODEL_IDS;
+var DEFAULT_MAX_WAIT_MS = 24e4;
+registerSchema({
+  command: "studio.generate",
+  description: "Start here to make an image. Opens a Studio batch: the images are ingested into the media library as they render and the whole batch shows up in the dashboard Studio for the client, labelled with this conversation. Default model google/gemini-3.1-flash-image \u2014 fast, reference editing, extreme aspect ratios. --reference is the biggest quality lever: pass library image ids, local file paths, and/or image URLs to ground the render in real imagery.",
+  args: {
+    prompt: {
+      type: "string",
+      description: "What to generate \u2014 full art direction, not a keyword. Length caps are per model (Recraft 10,000 characters, gpt-image 32,000, Gemini publishes none) and a --skill or --brand block counts toward them; `baker studio models` has the number.",
+      required: true
+    },
+    model: {
+      type: "string",
+      description: `Model (default google/gemini-3.1-flash-image). They accept genuinely different things \u2014 check with \`baker studio models\` rather than assuming. One of: ${MODEL_LIST.join(", ")}`,
+      required: false,
+      enum: MODEL_LIST
+    },
+    "aspect-ratio": {
+      type: "string",
+      // Snapped, not refused: ask for the ad shape you want and the backend
+      // moves it to the nearest one the chosen model renders (gpt-image-2 has no
+      // 4:5, so a 4:5 request becomes 3:4 rather than failing).
+      description: "Aspect ratio, e.g. 1:1 (default), 16:9, 9:16, 4:5, 3:2 \u2014 Gemini flash also does 1:4 / 8:1. Snapped to the nearest shape the chosen model renders, so ask for the ad format you want (4:5 on gpt-image-2 or Recraft becomes 3:4, neither renders it). Must be width:height.",
+      required: false
+    },
+    count: { type: "number", description: "Takes to render, 1-8 (default 1)", required: false, default: 1 },
+    avatar: {
+      type: "string",
+      description: "Cast one of the company's avatars by short name (e.g. marta). Grounds the render on their identity sheet and reuses their subject description verbatim \u2014 do this instead of passing the sheet through --reference, which skips both and leaves the batch unattributed. `baker avatars list` shows who there is.",
+      required: false
+    },
+    reference: {
+      type: "string",
+      description: "Comma-separated visual references, in order: library image ids, local file paths, and/or image URLs. Paths and URLs are added to the media library first, so the reference is reusable and the client can see what grounded the render. How many are allowed is per model \u2014 Gemini takes 14, gpt-image 16, Recraft exactly 1.",
+      required: false
+    },
+    skill: {
+      type: "string",
+      description: "Craft direction by id (run `baker studio skills`), e.g. product-pack-shot, ugc-selfie-hook",
+      required: false
+    },
+    brand: {
+      type: "boolean",
+      description: "Append the company palette and visual style. Off by default \u2014 you are writing the art direction yourself and a brand block appended after it fights what you just specified.",
+      required: false,
+      default: false
+    },
+    "image-size": {
+      type: "string",
+      // No default: left unset the provider picks the pixels from the ratio.
+      // gpt-image-2 has no resolution setting at all and REFUSES this flag.
+      description: `Output resolution \u2014 only on models that have one (gpt-image-2 and Recraft have none and REFUSE this). The tiers differ per model: Lite renders 1K only, Pro 1K-4K, Gemini flash also 0.5K. One of: ${IMAGE_SIZES.join(", ")}`,
+      required: false,
+      enum: IMAGE_SIZES
+    },
+    quality: {
+      type: "string",
+      description: `Rendering quality \u2014 the OpenAI models only; every Gemini tier and Recraft REFUSE it. One of: ${IMAGE_QUALITIES.join(", ")}`,
+      required: false,
+      enum: IMAGE_QUALITIES
+    },
+    strength: { type: "number", description: "Recraft vector only: vectorization strength 0-1", required: false },
+    "rgb-colors": {
+      type: "string",
+      description: 'Recraft only: JSON array of [r,g,b] palette triples, each channel a whole number 0-255, e.g. "[[10,10,10],[255,80,0]]"',
+      required: false
+    },
+    "bg-rgb": {
+      type: "string",
+      description: 'Recraft only: JSON [r,g,b] background colour, e.g. "[255,255,255]"',
+      required: false
+    },
+    wait: {
+      type: "string",
+      description: "Pass false to get the batch id back immediately instead of waiting for the takes",
+      required: false,
+      default: "true"
+    },
+    "max-wait": {
+      type: "number",
+      description: "Max ms to wait for the takes (default 240000). 0 returns the id immediately.",
+      required: false,
+      default: DEFAULT_MAX_WAIT_MS
+    },
+    full: { type: "boolean", description: "Include settings, references and attribution", required: false }
+  }
+});
+function parseJsonArg(raw, flag) {
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new ApiError("VALIDATION_ERROR", `--${flag} must be valid JSON (got: ${raw})`);
+  }
+}
+function referenceLimitFor(model) {
+  const chosen = model ?? DEFAULT_IMAGE_GENERATE_MODEL;
+  const max = maxInputReferences("image_generate", chosen);
+  if (max === void 0) return void 0;
+  const label = MODEL_REGISTRY.image_generate[canonicalModelId(chosen)]?.label ?? chosen;
+  return {
+    max,
+    refuse: (count) => max === 1 ? `${label} takes exactly one reference image \u2014 you passed ${count}. Pick the one that matters, or switch to a model that reads several.` : `${label} takes up to ${max} reference images \u2014 you passed ${count}. Drop the weakest ones.`
+  };
+}
+async function effectiveModel(pinned, skillId, fetchSkills = () => apiGet("/api/studio/skills")) {
+  if (pinned || !skillId) return pinned;
+  try {
+    const { skills } = await fetchSkills();
+    return skills.find((skill) => skill.id === skillId)?.defaults.model;
+  } catch {
+    return void 0;
+  }
+}
+function buildGenerateBody(args, prompt) {
+  const body = { prompt };
+  if (args.model) body.model = args.model;
+  if (args["aspect-ratio"]) body.aspectRatio = args["aspect-ratio"];
+  if (args.count !== void 0 && args.count !== "") body.count = Number(args.count);
+  if (args.avatar) body.avatar = args.avatar;
+  if (args.skill) body.skillId = args.skill;
+  if (args.brand) body.useBrand = true;
+  if (args["image-size"]) body.imageSize = args["image-size"];
+  if (args.quality) body.quality = args.quality;
+  if (args.strength !== void 0 && args.strength !== "") body.strength = Number(args.strength);
+  if (args["rgb-colors"]) {
+    body.rgbColors = parseJsonArg(args["rgb-colors"], "rgb-colors");
+  }
+  if (args["bg-rgb"]) {
+    body.backgroundRgbColor = parseJsonArg(
+      args["bg-rgb"],
+      "bg-rgb"
+    );
+  }
+  return body;
+}
+var generateCommand = defineCommand({
+  meta: {
+    name: "generate",
+    description: "Start here to make an image. Renders 1-8 takes of one brief, ingests each into the media library as it lands, and shows the batch in the dashboard Studio next to the ones the client ran.\n\nModel choice: google/gemini-3.1-flash-image (default \u2014 fast, best at editing a reference and at extreme ratios), google/gemini-3-pro-image (highest fidelity, slower), openai/gpt-image-2 (photoreal and the cleanest in-image text \u2014 no --image-size, no 4:5 / 5:4), recraft/recraft-v4.1-pro-vector (vector/flat marks with palette control).\n\n--reference is the biggest quality lever there is: a real logo, product shot, Pinterest pin or sandbox screenshot beats any amount of adjectives.\n\nExamples:\n  baker studio generate 'matte black bottle on wet marble, hard studio light, 35mm' --aspect-ratio 3:2 --count 3\n  baker studio generate 'this bottle on a sunlit kitchen counter' --reference './src/brand/product.png,https://\u2026/kitchen.jpg'\n  baker studio generate 'founder-style selfie, kitchen background, natural light' --skill ugc-selfie-hook\n  baker studio generate 'flat geometric mascot, brand palette' --model recraft/recraft-v4.1-pro-vector --rgb-colors '[[10,10,10],[255,80,0]]'"
+  },
+  args: {
+    avatar: {
+      type: "string",
+      description: "Cast an avatar by short name \u2014 grounds the image on their identity sheet",
+      required: false
+    },
+    prompt: { type: "positional", description: "What to generate", required: false },
+    model: { type: "string", description: "Model id (default google/gemini-3.1-flash-image)", required: false },
+    "aspect-ratio": { type: "string", description: "Aspect ratio (default 1:1)", required: false },
+    count: { type: "string", description: "Takes to render, 1-8 (default 1)", required: false },
+    reference: {
+      type: "string",
+      description: "Comma-separated library image ids, local file paths, and/or image URLs",
+      required: false
+    },
+    skill: { type: "string", description: "Craft direction id (`baker studio skills`)", required: false },
+    brand: { type: "boolean", description: "Append the company palette and style", required: false },
+    "image-size": {
+      type: "string",
+      description: `Output resolution, models that have one only: ${IMAGE_SIZES.join(" | ")}`,
+      required: false
+    },
+    quality: {
+      type: "string",
+      description: `Rendering quality, models that honour it only: ${IMAGE_QUALITIES.join(" | ")}`,
+      required: false
+    },
+    strength: { type: "string", description: "Recraft vectorization strength 0-1", required: false },
+    "rgb-colors": { type: "string", description: "Recraft palette JSON", required: false },
+    "bg-rgb": { type: "string", description: "Recraft background JSON", required: false },
+    wait: { type: "string", description: "false to return the batch id immediately", required: false },
+    "max-wait": { type: "string", description: "Max ms to wait (default 240000, 0 = no wait)", required: false },
+    full: { type: "boolean", description: "Include settings, references and attribution", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const prompt = args.prompt;
+      if (!prompt) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "A prompt is required" } });
+        process.exit(1);
+      }
+      const body = buildGenerateBody(args, prompt);
+      if (args.reference) {
+        const model = await effectiveModel(body.model, body.skillId);
+        const { imageIds } = await resolveLibraryImageIds(args.reference, referenceLimitFor(model));
+        if (imageIds.length > 0) body.referenceImageIds = imageIds;
+      }
+      const start = await apiPost("/api/studio/generate", body);
+      const maxWaitMs = resolveMaxWaitMs(args.wait, args["max-wait"], DEFAULT_MAX_WAIT_MS);
+      if (maxWaitMs === 0) {
+        writeJson({
+          ok: true,
+          data: start,
+          hints: [`Rendering ${start.count} take(s). Read them with \`baker studio get ${start.generationId}\`.`]
+        });
+        return;
+      }
+      const outcome = await awaitBatch(start.generationId, maxWaitMs);
+      if (outcome.kind !== "settled") {
+        writeJson({
+          ok: true,
+          data: { ...start, status: "running" },
+          hints: [waitingHint(outcome, start.generationId, maxWaitMs)]
+        });
+        return;
+      }
+      writeJson({
+        ok: true,
+        data: projectBatch(outcome.generation, args.full === true),
+        hints: batchHints(outcome.generation)
+      });
+    } catch (error) {
+      failStudioCommand(error, { withFix: true });
+    }
+  }
+});
+export {
+  buildGenerateBody,
+  effectiveModel,
+  generateCommand,
+  referenceLimitFor
+};
+//# sourceMappingURL=generate-LWSAKRIT.js.map

package/dist/generate-LWSAKRIT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/studio/generate.ts"],"sourcesContent":["import type { StudioGenerateRequest, StudioSkillsResponse, StudioStartResponse } from \"@baker/api\";\nimport {\n  canonicalModelId,\n  DEFAULT_IMAGE_GENERATE_MODEL,\n  MODEL_REGISTRY,\n  maxInputReferences,\n} from \"@baker/canvas-contract\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiGet, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { awaitBatch, batchHints, projectBatch, resolveMaxWaitMs, waitingHint } from \"./batch.ts\";\nimport { failStudioCommand } from \"./errors.ts\";\nimport { IMAGE_MODEL_IDS, IMAGE_QUALITIES, IMAGE_SIZES } from \"./modelOptions.ts\";\nimport { type ReferenceLimit, resolveLibraryImageIds } from \"./references.ts\";\n\nconst MODEL_LIST = IMAGE_MODEL_IDS;\n\n/** Images settle in well under a minute each; four in parallel rarely need more. */\nconst DEFAULT_MAX_WAIT_MS = 240_000;\n\nregisterSchema({\n  command: \"studio.generate\",\n  description:\n    \"Start here to make an image. Opens a Studio batch: the images are ingested into the media library as they render and the whole batch shows up in the dashboard Studio for the client, labelled with this conversation. Default model google/gemini-3.1-flash-image — fast, reference editing, extreme aspect ratios. --reference is the biggest quality lever: pass library image ids, local file paths, and/or image URLs to ground the render in real imagery.\",\n  args: {\n    prompt: {\n      type: \"string\",\n      description:\n        \"What to generate — full art direction, not a keyword. Length caps are per model (Recraft 10,000 characters, gpt-image 32,000, Gemini publishes none) and a --skill or --brand block counts toward them; `baker studio models` has the number.\",\n      required: true,\n    },\n    model: {\n      type: \"string\",\n      description: `Model (default google/gemini-3.1-flash-image). They accept genuinely different things — check with \\`baker studio models\\` rather than assuming. One of: ${MODEL_LIST.join(\", \")}`,\n      required: false,\n      enum: MODEL_LIST,\n    },\n    \"aspect-ratio\": {\n      type: \"string\",\n      // Snapped, not refused: ask for the ad shape you want and the backend\n      // moves it to the nearest one the chosen model renders (gpt-image-2 has no\n      // 4:5, so a 4:5 request becomes 3:4 rather than failing).\n      description:\n        \"Aspect ratio, e.g. 1:1 (default), 16:9, 9:16, 4:5, 3:2 — Gemini flash also does 1:4 / 8:1. Snapped to the nearest shape the chosen model renders, so ask for the ad format you want (4:5 on gpt-image-2 or Recraft becomes 3:4, neither renders it). Must be width:height.\",\n      required: false,\n    },\n    count: { type: \"number\", description: \"Takes to render, 1-8 (default 1)\", required: false, default: 1 },\n    avatar: {\n      type: \"string\",\n      description:\n        \"Cast one of the company's avatars by short name (e.g. marta). Grounds the render on their identity sheet and reuses their subject description verbatim — do this instead of passing the sheet through --reference, which skips both and leaves the batch unattributed. `baker avatars list` shows who there is.\",\n      required: false,\n    },\n    reference: {\n      type: \"string\",\n      description:\n        \"Comma-separated visual references, in order: library image ids, local file paths, and/or image URLs. Paths and URLs are added to the media library first, so the reference is reusable and the client can see what grounded the render. How many are allowed is per model — Gemini takes 14, gpt-image 16, Recraft exactly 1.\",\n      required: false,\n    },\n    skill: {\n      type: \"string\",\n      description: \"Craft direction by id (run `baker studio skills`), e.g. product-pack-shot, ugc-selfie-hook\",\n      required: false,\n    },\n    brand: {\n      type: \"boolean\",\n      description:\n        \"Append the company palette and visual style. Off by default — you are writing the art direction yourself and a brand block appended after it fights what you just specified.\",\n      required: false,\n      default: false,\n    },\n    \"image-size\": {\n      type: \"string\",\n      // No default: left unset the provider picks the pixels from the ratio.\n      // gpt-image-2 has no resolution setting at all and REFUSES this flag.\n      description: `Output resolution — only on models that have one (gpt-image-2 and Recraft have none and REFUSE this). The tiers differ per model: Lite renders 1K only, Pro 1K-4K, Gemini flash also 0.5K. One of: ${IMAGE_SIZES.join(\", \")}`,\n      required: false,\n      enum: IMAGE_SIZES,\n    },\n    quality: {\n      type: \"string\",\n      description: `Rendering quality — the OpenAI models only; every Gemini tier and Recraft REFUSE it. One of: ${IMAGE_QUALITIES.join(\", \")}`,\n      required: false,\n      enum: IMAGE_QUALITIES,\n    },\n    strength: { type: \"number\", description: \"Recraft vector only: vectorization strength 0-1\", required: false },\n    \"rgb-colors\": {\n      type: \"string\",\n      description:\n        'Recraft only: JSON array of [r,g,b] palette triples, each channel a whole number 0-255, e.g. \"[[10,10,10],[255,80,0]]\"',\n      required: false,\n    },\n    \"bg-rgb\": {\n      type: \"string\",\n      description: 'Recraft only: JSON [r,g,b] background colour, e.g. \"[255,255,255]\"',\n      required: false,\n    },\n    wait: {\n      type: \"string\",\n      description: \"Pass false to get the batch id back immediately instead of waiting for the takes\",\n      required: false,\n      default: \"true\",\n    },\n    \"max-wait\": {\n      type: \"number\",\n      description: \"Max ms to wait for the takes (default 240000). 0 returns the id immediately.\",\n      required: false,\n      default: DEFAULT_MAX_WAIT_MS,\n    },\n    full: { type: \"boolean\", description: \"Include settings, references and attribution\", required: false },\n  },\n});\n\nfunction parseJsonArg(raw: string, flag: string): unknown {\n  try {\n    return JSON.parse(raw);\n  } catch {\n    throw new ApiError(\"VALIDATION_ERROR\", `--${flag} must be valid JSON (got: ${raw})`);\n  }\n}\n\n/**\n * The reference cap of the model this batch will actually use — read from the\n * same registry the backend validates against, so the two cannot disagree.\n * A model with no published cap gets no local gate: inventing a ceiling refuses\n * a render that would have worked, which is the more expensive mistake.\n */\nexport function referenceLimitFor(model: string | undefined): ReferenceLimit | undefined {\n  const chosen = model ?? DEFAULT_IMAGE_GENERATE_MODEL;\n  const max = maxInputReferences(\"image_generate\", chosen);\n  if (max === undefined) return undefined;\n  const label = MODEL_REGISTRY.image_generate[canonicalModelId(chosen)]?.label ?? chosen;\n  return {\n    max,\n    refuse: (count) =>\n      max === 1\n        ? `${label} takes exactly one reference image — you passed ${count}. Pick the one that matters, or switch to a model that reads several.`\n        : `${label} takes up to ${max} reference images — you passed ${count}. Drop the weakest ones.`,\n  };\n}\n\n/**\n * The model this batch will really run on.\n *\n * A skill carries its own default model, and it wins whenever the caller did not\n * pin one — `--skill brand-icon` alone renders on Recraft, which takes exactly\n * ONE reference where the default Gemini takes fourteen. Gating on the default\n * would let three references upload and then be refused by the backend, naming a\n * model the caller never chose: the precise waste the local check exists to\n * prevent. Only asked when it can change the answer, so the common paths still\n * cost no extra call.\n */\nexport async function effectiveModel(\n  pinned: string | undefined,\n  skillId: string | undefined,\n  fetchSkills: () => Promise<StudioSkillsResponse> = () => apiGet<StudioSkillsResponse>(\"/api/studio/skills\"),\n): Promise<string | undefined> {\n  if (pinned || !skillId) return pinned;\n  try {\n    const { skills } = await fetchSkills();\n    return skills.find((skill) => skill.id === skillId)?.defaults.model;\n  } catch {\n    // An unknown skill or an unreachable list is not this command's failure to\n    // report — the backend refuses both with a better message. Fall through to\n    // the default cap rather than blocking a render that would have worked.\n    return undefined;\n  }\n}\n\nexport function buildGenerateBody(args: Record<string, unknown>, prompt: string): StudioGenerateRequest {\n  const body: StudioGenerateRequest = { prompt };\n  if (args.model) body.model = args.model as StudioGenerateRequest[\"model\"];\n  if (args[\"aspect-ratio\"]) body.aspectRatio = args[\"aspect-ratio\"] as string;\n  if (args.count !== undefined && args.count !== \"\") body.count = Number(args.count);\n  if (args.avatar) body.avatar = args.avatar as string;\n  if (args.skill) body.skillId = args.skill as string;\n  if (args.brand) body.useBrand = true;\n  if (args[\"image-size\"]) body.imageSize = args[\"image-size\"] as string;\n  if (args.quality) body.quality = args.quality as StudioGenerateRequest[\"quality\"];\n  // `!== undefined`, not truthiness: `--strength 0` is a real value.\n  if (args.strength !== undefined && args.strength !== \"\") body.strength = Number(args.strength);\n  if (args[\"rgb-colors\"]) {\n    body.rgbColors = parseJsonArg(args[\"rgb-colors\"] as string, \"rgb-colors\") as StudioGenerateRequest[\"rgbColors\"];\n  }\n  if (args[\"bg-rgb\"]) {\n    body.backgroundRgbColor = parseJsonArg(\n      args[\"bg-rgb\"] as string,\n      \"bg-rgb\",\n    ) as StudioGenerateRequest[\"backgroundRgbColor\"];\n  }\n  return body;\n}\n\nexport const generateCommand = defineCommand({\n  meta: {\n    name: \"generate\",\n    description:\n      \"Start here to make an image. Renders 1-8 takes of one brief, ingests each into the media library as it lands, and shows the batch in the dashboard Studio next to the ones the client ran.\\n\\nModel choice: google/gemini-3.1-flash-image (default — fast, best at editing a reference and at extreme ratios), google/gemini-3-pro-image (highest fidelity, slower), openai/gpt-image-2 (photoreal and the cleanest in-image text — no --image-size, no 4:5 / 5:4), recraft/recraft-v4.1-pro-vector (vector/flat marks with palette control).\\n\\n--reference is the biggest quality lever there is: a real logo, product shot, Pinterest pin or sandbox screenshot beats any amount of adjectives.\\n\\nExamples:\\n  baker studio generate 'matte black bottle on wet marble, hard studio light, 35mm' --aspect-ratio 3:2 --count 3\\n  baker studio generate 'this bottle on a sunlit kitchen counter' --reference './src/brand/product.png,https://…/kitchen.jpg'\\n  baker studio generate 'founder-style selfie, kitchen background, natural light' --skill ugc-selfie-hook\\n  baker studio generate 'flat geometric mascot, brand palette' --model recraft/recraft-v4.1-pro-vector --rgb-colors '[[10,10,10],[255,80,0]]'\",\n  },\n  args: {\n    avatar: {\n      type: \"string\",\n      description: \"Cast an avatar by short name — grounds the image on their identity sheet\",\n      required: false,\n    },\n    prompt: { type: \"positional\", description: \"What to generate\", required: false },\n    model: { type: \"string\", description: \"Model id (default google/gemini-3.1-flash-image)\", required: false },\n    \"aspect-ratio\": { type: \"string\", description: \"Aspect ratio (default 1:1)\", required: false },\n    count: { type: \"string\", description: \"Takes to render, 1-8 (default 1)\", required: false },\n    reference: {\n      type: \"string\",\n      description: \"Comma-separated library image ids, local file paths, and/or image URLs\",\n      required: false,\n    },\n    skill: { type: \"string\", description: \"Craft direction id (`baker studio skills`)\", required: false },\n    brand: { type: \"boolean\", description: \"Append the company palette and style\", required: false },\n    \"image-size\": {\n      type: \"string\",\n      description: `Output resolution, models that have one only: ${IMAGE_SIZES.join(\" | \")}`,\n      required: false,\n    },\n    quality: {\n      type: \"string\",\n      description: `Rendering quality, models that honour it only: ${IMAGE_QUALITIES.join(\" | \")}`,\n      required: false,\n    },\n    strength: { type: \"string\", description: \"Recraft vectorization strength 0-1\", required: false },\n    \"rgb-colors\": { type: \"string\", description: \"Recraft palette JSON\", required: false },\n    \"bg-rgb\": { type: \"string\", description: \"Recraft background JSON\", required: false },\n    wait: { type: \"string\", description: \"false to return the batch id immediately\", required: false },\n    \"max-wait\": { type: \"string\", description: \"Max ms to wait (default 240000, 0 = no wait)\", required: false },\n    full: { type: \"boolean\", description: \"Include settings, references and attribution\", required: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const prompt = args.prompt as string | undefined;\n      if (!prompt) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"A prompt is required\" } });\n        process.exit(1);\n      }\n\n      const body = buildGenerateBody(args, prompt);\n      if (args.reference) {\n        const model = await effectiveModel(body.model, body.skillId);\n        const { imageIds } = await resolveLibraryImageIds(args.reference as string, referenceLimitFor(model));\n        if (imageIds.length > 0) body.referenceImageIds = imageIds;\n      }\n\n      const start = await apiPost<StudioStartResponse>(\"/api/studio/generate\", body);\n      const maxWaitMs = resolveMaxWaitMs(args.wait, args[\"max-wait\"], DEFAULT_MAX_WAIT_MS);\n      if (maxWaitMs === 0) {\n        writeJson({\n          ok: true,\n          data: start,\n          hints: [`Rendering ${start.count} take(s). Read them with \\`baker studio get ${start.generationId}\\`.`],\n        });\n        return;\n      }\n\n      const outcome = await awaitBatch(start.generationId, maxWaitMs);\n      if (outcome.kind !== \"settled\") {\n        writeJson({\n          ok: true,\n          data: { ...start, status: \"running\" },\n          hints: [waitingHint(outcome, start.generationId, maxWaitMs)],\n        });\n        return;\n      }\n\n      writeJson({\n        ok: true,\n        data: projectBatch(outcome.generation, args.full === true),\n        hints: batchHints(outcome.generation),\n      });\n    } catch (error) {\n      failStudioCommand(error, { withFix: true });\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/get-5OEDAT2Q.js

@@ -0,0 +1,63 @@
+import {
+  ApiError,
+  apiGet,
+  validateConvexId
+} from "./chunk-OSWCEDFE.js";
+import "./chunk-D53AAUG4.js";
+import "./chunk-FZKUUI3F.js";
+import {
+  registerSchema,
+  testimonialNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-4WYEGE4N.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/get.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "testimonials.get",
+  description: "Get a single testimonial by ID",
+  args: {
+    id: { type: "string", description: "Testimonial ID", required: true }
+  }
+});
+var getCommand = defineCommand({
+  meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
+  args: {
+    id: { type: "positional", description: "Testimonial ID", required: false },
+    "testimonial-id": { type: "string", description: "Testimonial ID (alternative to positional)", required: false },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["testimonial-id"];
+      if (!id) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Testimonial ID is required" } });
+        process.exit(1);
+      }
+      validateConvexId(id);
+      const data = await apiGet("/api/testimonials/get", { id });
+      writeOutput(
+        { ok: true, data },
+        args.output || "json",
+        args.fields ? args.fields.split(",") : void 0,
+        args.full,
+        testimonialNormalizer
+      );
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  getCommand
+};
+//# sourceMappingURL=get-5OEDAT2Q.js.map

package/dist/get-7WEE5V7M.js

@@ -0,0 +1,56 @@
+import {
+  buildGetHints,
+  failApi,
+  failValidation
+} from "./chunk-ZO4GMUO3.js";
+import "./chunk-MV2J73HP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-I2DNBEV6.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-OSWCEDFE.js";
+import "./chunk-D53AAUG4.js";
+import "./chunk-FZKUUI3F.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4WYEGE4N.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/get.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.get",
+  description: "Get a single action with tags, blockers, blocked-by, and active-chat info.",
+  args: {
+    id: { type: "string", description: "Action ID", required: true }
+  }
+});
+var getCommand = defineCommand({
+  meta: { name: "get", description: "Get a single action by ID. Example: baker actions get <action-id>" },
+  args: {
+    id: { type: "positional", description: "Action ID", required: false },
+    "action-id": { type: "string", description: "Action ID (alternative to positional)", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["action-id"];
+      if (!id) {
+        failValidation("Action ID is required.");
+      }
+      validateConvexId(id);
+      const response = await apiPost("/api/actions/get", { actionId: id });
+      const hints = buildGetHints(response.data);
+      writeJson(hints.length > 0 ? { ...response, hints } : response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  getCommand
+};
+//# sourceMappingURL=get-7WEE5V7M.js.map

package/dist/get-DXGJSEZZ.js

@@ -0,0 +1,63 @@
+import {
+  ApiError,
+  apiGet,
+  validateConvexId
+} from "./chunk-OSWCEDFE.js";
+import "./chunk-D53AAUG4.js";
+import "./chunk-FZKUUI3F.js";
+import {
+  registerSchema,
+  videoNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-4WYEGE4N.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/get.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "videos.get",
+  description: "Get a single video by ID",
+  args: {
+    id: { type: "string", description: "Video ID", required: true }
+  }
+});
+var getCommand = defineCommand({
+  meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
+  args: {
+    id: { type: "positional", description: "Video ID", required: false },
+    "video-id": { type: "string", description: "Video ID (alternative to positional)", required: false },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["video-id"];
+      if (!id) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Video ID is required" } });
+        process.exit(1);
+      }
+      validateConvexId(id);
+      const data = await apiGet("/api/videos/get", { id });
+      writeOutput(
+        { ok: true, data },
+        args.output || "json",
+        args.fields ? args.fields.split(",") : void 0,
+        args.full,
+        videoNormalizer
+      );
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  getCommand
+};
+//# sourceMappingURL=get-DXGJSEZZ.js.map

package/dist/get-GQWOLALT.js

@@ -0,0 +1,59 @@
+import {
+  batchHints,
+  projectBatch
+} from "./chunk-2MT3AWDE.js";
+import {
+  failStudioCommand
+} from "./chunk-YNOJN5Z6.js";
+import {
+  apiGet
+} from "./chunk-OSWCEDFE.js";
+import "./chunk-D53AAUG4.js";
+import "./chunk-FZKUUI3F.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4WYEGE4N.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/studio/get.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "studio.get",
+  description: "Read one Studio batch: every take, where it lives, and why a take is missing. This is how you pick up a batch that was still rendering when the start command returned.",
+  args: {
+    "generation-id": { type: "string", description: "Batch id from `generate` / `animate`", required: true },
+    full: { type: "boolean", description: "Include settings, references and attribution", required: false }
+  }
+});
+var getCommand = defineCommand({
+  meta: {
+    name: "get",
+    description: "Read one Studio batch \u2014 the takes, their urls, whether each is in the library, and the reason for any that failed.\n\nExample: baker studio get j57abc123def456ghi789\nExample: baker studio get j57abc123def456ghi789 --full"
+  },
+  args: {
+    "generation-id": { type: "positional", description: "Batch id", required: false },
+    full: { type: "boolean", description: "Include settings, references and attribution", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const generationId = args["generation-id"];
+      if (!generationId) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "A batch id is required" } });
+        process.exit(1);
+      }
+      const { generation } = await apiGet(`/api/studio/generations/${generationId}`);
+      writeJson({
+        ok: true,
+        data: projectBatch(generation, args.full === true),
+        hints: batchHints(generation)
+      });
+    } catch (error) {
+      failStudioCommand(error);
+    }
+  }
+});
+export {
+  getCommand
+};
+//# sourceMappingURL=get-GQWOLALT.js.map

package/dist/get-W7F4FOAR.js

@@ -0,0 +1,92 @@
+import {
+  waitForSheet
+} from "./chunk-WN4KX7GE.js";
+import {
+  avatarRowNormalizer,
+  castingHints,
+  failAvatarApi,
+  failValidation
+} from "./chunk-TQUNJFGF.js";
+import {
+  readAvatars
+} from "./chunk-AN7CMLYY.js";
+import "./chunk-OSWCEDFE.js";
+import "./chunk-D53AAUG4.js";
+import "./chunk-FZKUUI3F.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-4WYEGE4N.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/avatars/get.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "avatars.get",
+  description: "Read one avatar by handle \u2014 the command you run before casting it. Returns its status (only `ready` can be cast), the identity sheet URL every render must be grounded on via --reference, and the subject description that goes into the prompt verbatim. Add --full for the whole written profile (persona, speech, motion, wardrobe, setting, guardrails, voice, source photos).",
+  args: {
+    handle: { type: "string", description: 'Avatar handle, e.g. "marta" (lowercase, dashes)', required: true },
+    full: {
+      type: "boolean",
+      description: "Return the whole written profile, not just the casting essentials",
+      required: false,
+      default: false
+    }
+  }
+});
+var getCommand = defineCommand({
+  meta: {
+    name: "get",
+    description: "Read one avatar by handle: status, identity sheet URL for --reference, and the subject description to reuse verbatim. Example: baker avatars get marta --full"
+  },
+  args: {
+    handle: { type: "positional", description: "Avatar handle", required: false },
+    "avatar-handle": { type: "string", description: "Avatar handle (alternative to positional)", required: false },
+    full: { type: "boolean", description: "Include the whole written profile", required: false, default: false },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    wait: {
+      type: "boolean",
+      description: "Block until the identity sheet has settled (up to 90s), instead of returning while it is still building. Use it when the NEXT thing you do needs this avatar \u2014 a clip, a still, anything with --avatar. Without it you get the current status and have to come back; with it the command returns the moment it is ready. Never write your own sleep/poll loop around this.",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    const handle = (args.handle || args["avatar-handle"])?.trim();
+    if (!handle) {
+      failValidation("An avatar handle is required, e.g. `baker avatars get marta`. Run `baker avatars list` first.");
+    }
+    try {
+      const params = { handle };
+      if (args.full) params.full = "1";
+      let avatar = await readAvatars("/api/avatars/get", params);
+      if (args.wait) {
+        avatar = await waitForSheet(
+          avatar,
+          () => readAvatars("/api/avatars/get", params)
+        );
+      }
+      const hints = castingHints(avatar);
+      const format = args.output || "json";
+      if (format === "json") {
+        writeJson({ ok: true, data: avatar, hints });
+        return;
+      }
+      writeOutput(
+        { ok: true, data: avatar },
+        format,
+        args.fields ? args.fields.split(",") : void 0,
+        Boolean(args.full),
+        avatarRowNormalizer
+      );
+    } catch (err) {
+      failAvatarApi(err, handle);
+    }
+  }
+});
+export {
+  getCommand
+};
+//# sourceMappingURL=get-W7F4FOAR.js.map