@koda-sl/baker-cli 0.453.0-dev.faf35eacb → 0.454.0-dev.67ad219ab

package/dist/ga4-T3IODHS2.js

@@ -0,0 +1,55 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ga4/index.ts
+import { defineCommand } from "citty";
+var ga4Command = defineCommand({
+  meta: {
+    name: "ga4",
+    description: `Google Analytics 4. Report on a property, audit its config, and change what it measures.
+
+Start here:
+  baker ga4 properties                    \u2014 list accessible properties
+  baker ga4 config                        \u2014 what the property measures today (and whether Baker may change it)
+  baker ga4 query --list-presets          \u2014 see available report presets
+
+Report:
+  baker ga4 audit                                                    \u2014 full property health check
+  baker ga4 query --preset tracking-health                           \u2014 compare GA4 vs GAds data
+  baker ga4 query --dimensions "date" --metrics "sessions" --days 7  \u2014 free-form query
+
+Then stage changes (nothing is sent to Google Analytics until the chat completes):
+  baker ga4 key-event create --json '{"eventName":"generate_lead","countingMethod":"ONCE_PER_EVENT"}'
+  baker ga4 custom-event create --json '{"destinationEvent":"quote_request","eventConditions":[...]}'
+  baker ga4 custom-dimension create --json '{"parameterName":"plan_tier","displayName":"Plan tier","scope":"EVENT"}'
+  baker ga4 audience create --json '{"displayName":"Visited without demo", \u2026}'   \u2014 a group to retarget
+  baker ga4 property set --industry TECHNOLOGY                                   \u2014 benchmarking cohort
+  baker ga4 ads-link create --customer-id 123-456-7890                           \u2014 what makes audiences targetable
+  baker ga4 enhanced-measurement set --scrolls true --outbound-clicks true        \u2014 automatic events, no tag needed
+  baker ga4 draft list                    \u2014 review everything staged
+
+An applied change takes effect on the property immediately \u2014 there is no version to publish afterwards
+and no undo. Agree the changes with the user before the chat completes, not after.
+
+Full guide: __tooling__/docs/tools/baker/ga4.md`
+  },
+  subCommands: {
+    properties: () => import("./properties-6ME4XYT7.js").then((m) => m.propertiesCommand),
+    config: () => import("./config-ON2KUCQT.js").then((m) => m.configCommand),
+    audit: () => import("./audit-65M7ZYPF.js").then((m) => m.auditCommand),
+    query: () => import("./query-WC5I2S6Z.js").then((m) => m.queryCommand),
+    "key-event": () => import("./write-commands-VKKEGFTJ.js").then((m) => m.keyEventCommand),
+    "custom-dimension": () => import("./write-commands-VKKEGFTJ.js").then((m) => m.customDimensionCommand),
+    "custom-metric": () => import("./write-commands-VKKEGFTJ.js").then((m) => m.customMetricCommand),
+    "custom-event": () => import("./write-commands-VKKEGFTJ.js").then((m) => m.customEventCommand),
+    "data-retention": () => import("./write-commands-VKKEGFTJ.js").then((m) => m.dataRetentionCommand),
+    audience: () => import("./write-commands-VKKEGFTJ.js").then((m) => m.audienceCommand),
+    property: () => import("./write-commands-VKKEGFTJ.js").then((m) => m.propertyCommand),
+    "ads-link": () => import("./write-commands-VKKEGFTJ.js").then((m) => m.adsLinkCommand),
+    "enhanced-measurement": () => import("./write-commands-VKKEGFTJ.js").then((m) => m.enhancedMeasurementCommand),
+    draft: () => import("./draft-AGQGAQDL.js").then((m) => m.draftCommand)
+  }
+});
+export {
+  ga4Command
+};
+//# sourceMappingURL=ga4-T3IODHS2.js.map

package/dist/generate-VSAS3QA5.js

@@ -0,0 +1,262 @@
+import {
+  IMAGE_MODEL_IDS,
+  IMAGE_QUALITIES,
+  IMAGE_SIZES,
+  resolveLibraryImageIds
+} from "./chunk-K45KDAV7.js";
+import {
+  awaitBatch,
+  batchHints,
+  projectBatch,
+  resolveMaxWaitMs,
+  waitingHint
+} from "./chunk-AW2UE5AI.js";
+import {
+  failStudioCommand
+} from "./chunk-JXOPTOVM.js";
+import "./chunk-NJY65ACF.js";
+import "./chunk-B7COZ237.js";
+import {
+  DEFAULT_IMAGE_GENERATE_MODEL,
+  MODEL_REGISTRY,
+  maxInputReferences
+} from "./chunk-CAMX6OHF.js";
+import "./chunk-YYBQUXFX.js";
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-5WW456MW.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[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-VSAS3QA5.js.map

package/dist/get-77U4CN3V.js

@@ -0,0 +1,63 @@
+import {
+  ApiError,
+  apiGet,
+  validateConvexId
+} from "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import {
+  registerSchema,
+  videoNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-5WW456MW.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-77U4CN3V.js.map

package/dist/get-BNO4T5SH.js

@@ -0,0 +1,56 @@
+import {
+  buildGetHints,
+  failApi,
+  failValidation
+} from "./chunk-63VMGEZI.js";
+import "./chunk-IDYAVGCS.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-5WW456MW.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-BNO4T5SH.js.map

package/dist/get-IUS3RB5H.js

@@ -0,0 +1,92 @@
+import {
+  waitForSheet
+} from "./chunk-WN4KX7GE.js";
+import {
+  avatarRowNormalizer,
+  castingHints,
+  failAvatarApi,
+  failValidation
+} from "./chunk-2ACGDQ2P.js";
+import {
+  readAvatars
+} from "./chunk-XLNVBDP2.js";
+import "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-5WW456MW.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-IUS3RB5H.js.map

package/dist/get-QWEQMBGA.js

@@ -0,0 +1,59 @@
+import {
+  batchHints,
+  projectBatch
+} from "./chunk-AW2UE5AI.js";
+import {
+  failStudioCommand
+} from "./chunk-JXOPTOVM.js";
+import {
+  apiGet
+} from "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-5WW456MW.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-QWEQMBGA.js.map

package/dist/get-ST2ZAQR3.js

@@ -0,0 +1,61 @@
+import {
+  ApiError,
+  apiGet,
+  validateConvexId
+} from "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-5WW456MW.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/get.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.get",
+  description: "Get a single image by ID",
+  args: {
+    id: { type: "string", description: "Image ID", required: true }
+  }
+});
+var getCommand = defineCommand({
+  meta: { name: "get", description: "Get a single image by ID. Example: baker images get j571abc123" },
+  args: {
+    id: { type: "positional", description: "Image ID", required: false },
+    "image-id": { type: "string", description: "Image 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["image-id"];
+      if (!id) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Image ID is required" } });
+        process.exit(1);
+      }
+      validateConvexId(id);
+      const data = await apiGet("/api/images/get", { id });
+      writeOutput(
+        { ok: true, data },
+        args.output || "json",
+        args.fields ? args.fields.split(",") : void 0,
+        args.full
+      );
+    } 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-ST2ZAQR3.js.map