@koda-sl/baker-cli 0.510.0 → 0.511.0-dev.2d26314a2

package/dist/generate-VBEY3N3L.js

@@ -0,0 +1,263 @@
+import {
+  IMAGE_MODEL_IDS,
+  IMAGE_QUALITIES,
+  IMAGE_SIZES,
+  resolveLibraryImageIds
+} from "./chunk-BDOYNGUL.js";
+import {
+  awaitBatch,
+  batchHints,
+  projectBatch,
+  resolveMaxWaitMs,
+  waitingHint
+} from "./chunk-OG6IHSQF.js";
+import {
+  failStudioCommand
+} from "./chunk-4KZMKI67.js";
+import "./chunk-B537ISAP.js";
+import "./chunk-MKTLZCRJ.js";
+import {
+  DEFAULT_IMAGE_GENERATE_MODEL,
+  MODEL_REGISTRY,
+  canonicalModelId,
+  maxInputReferences
+} from "./chunk-F3CZFUXZ.js";
+import "./chunk-PONLPYD7.js";
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.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-VBEY3N3L.js.map

package/dist/get-F6VFBT36.js

@@ -0,0 +1,57 @@
+import {
+  buildGetHints,
+  failApi,
+  failValidation
+} from "./chunk-STNKHWDE.js";
+import "./chunk-4CNR3MNJ.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-HNNCAJNF.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.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-F6VFBT36.js.map

package/dist/get-JHYQ4QXP.js

@@ -0,0 +1,80 @@
+import {
+  failApi,
+  failValidation,
+  isTempScheduledAgentId,
+  validateScheduledAgentRef
+} from "./chunk-UUCFUACM.js";
+import "./chunk-ASRS37QE.js";
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import "./chunk-4CNR3MNJ.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-HNNCAJNF.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  getEnv
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/scheduled-agents/get.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "scheduled-agents.get",
+  description: "Get a published scheduled agent, or one this chat has staged (temp_agent_*). A published one comes with runsAs: who each run acts as ({ name, personalTools, companyTools, notSignedIn? }) \u2014 the tools a run loads, which decides whether a job like reading someone's inbox can work. Its recentRuns and any draftOps this chat staged on it come with it.",
+  args: {
+    id: { type: "string", description: "Published scheduled agent ID or temp_agent_* draft ID", required: true },
+    chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
+  }
+});
+var getCommand = defineCommand({
+  meta: {
+    name: "get",
+    description: "Get a scheduled agent. Example: baker scheduled-agents get <id-or-temp_agent_id>"
+  },
+  args: {
+    id: { type: "positional", description: "Scheduled agent ID or temp_agent_* draft ID", required: false },
+    "scheduled-agent-id": {
+      type: "string",
+      description: "Scheduled agent ID (alternative to positional)",
+      required: false
+    },
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["scheduled-agent-id"];
+      if (!id) {
+        failValidation("Scheduled agent ID is required.");
+      }
+      validateScheduledAgentRef(id);
+      const env = getEnv();
+      const chatId = typeof args.chat === "string" && args.chat.length > 0 ? args.chat : env.BAKER_CHAT_ID;
+      if (isTempScheduledAgentId(id) && !chatId) {
+        failValidation("BAKER_CHAT_ID or --chat is required to get a staged scheduled agent ID.");
+      }
+      const body = { id };
+      if (chatId) {
+        body.chatId = chatId;
+      }
+      const response = await apiPost("/api/scheduled-agents/get", body);
+      writeJson(response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  getCommand
+};
+//# sourceMappingURL=get-JHYQ4QXP.js.map

package/dist/google-3BO7KNZ6.js

@@ -0,0 +1,136 @@
+import {
+  activeFilterFlags,
+  emptyResultHints
+} from "./chunk-Q6ULQMWG.js";
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/google.ts
+import { defineCommand } from "citty";
+var GOOGLE_ERROR_FIX = {
+  action: "use_different_resource",
+  explanation: "Generate the asset instead of retrying Google. Google is the last-resort image provider. Run `baker studio generate` to make the asset. Never sleep-and-retry this command \u2014 the CLI already backs off on rate limits. If no image can be sourced, continue the rest of the task with a placeholder rather than aborting it."
+};
+registerSchema({
+  command: "images.google",
+  description: "Google Images search via the official Custom Search JSON API. Unverified source \u2014 inspect before placing.",
+  args: {
+    query: { type: "string", description: "Search query", required: true },
+    type: {
+      type: "string",
+      description: "imgType: photo | clipart | lineart | stock | animated | face | news",
+      required: false
+    },
+    size: {
+      type: "string",
+      description: "imgSize: icon | small | medium | large | xlarge | xxlarge | huge",
+      required: false
+    },
+    color: {
+      type: "string",
+      description: "imgColorType: color | gray | mono | trans",
+      required: false
+    },
+    safe: { type: "string", description: "safe: off | active", required: false },
+    limit: { type: "number", description: "Max results (1-50, paginated 10 per call)", required: false, default: 10 },
+    "auto-ingest": {
+      type: "number",
+      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.google}, default 0) and return Baker-owned URLs on ingested hits`,
+      required: false,
+      default: 0
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint applied to every auto-ingested hit (overrides Google title)",
+      required: false
+    }
+  }
+});
+var googleCommand = defineCommand({
+  meta: {
+    name: "google",
+    description: "Google Images via the official Custom Search JSON API ($0.005/query, free 100/day). \u26A0 Source unverified \u2014 watermarks, low-res, mislabeled results are common. Use as last resort. With --auto-ingest, ingested hits return Baker-owned URLs.\n\nExample: baker images google 'industrial workshop' --type photo --size large --limit 20"
+  },
+  args: {
+    query: { type: "positional", description: "Search query", required: false },
+    type: { type: "string", description: "imgType filter", required: false },
+    size: { type: "string", description: "imgSize filter", required: false },
+    color: { type: "string", description: "imgColorType filter", required: false },
+    safe: { type: "string", description: "safe (off|active)", required: false },
+    limit: { type: "string", description: "Max results (1-50)", required: false },
+    "auto-ingest": {
+      type: "string",
+      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.google}) and return Baker-owned URLs on ingested hits`,
+      required: false
+    },
+    context: { type: "string", description: "Description context hint applied to auto-ingested hits", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const query = args.query;
+      if (!query) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Query is required" } });
+        process.exit(1);
+      }
+      const body = { query };
+      if (args.type) body.type = args.type;
+      if (args.size) body.size = args.size;
+      if (args.color) body.color = args.color;
+      if (args.safe) body.safe = args.safe;
+      if (args.limit) body.limit = Number(args.limit);
+      if (args["auto-ingest"] !== void 0) {
+        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.google);
+        if (!parsed.ok) {
+          writeJson({
+            ok: false,
+            error: {
+              code: "VALIDATION_ERROR",
+              message: parsed.message,
+              fix: {
+                action: "retry_with_changes",
+                explanation: `Re-run with --auto-ingest in 0-${AUTO_INGEST_MAX.google}.`
+              }
+            }
+          });
+          process.exit(1);
+        }
+        body.autoIngest = parsed.value;
+      }
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/google", body);
+      const hints = emptyResultHints({
+        provider: "google",
+        hitCount: data.hits.length,
+        activeFilters: activeFilterFlags(args, ["type", "size", "color", "safe"])
+      });
+      writeJson({ ok: true, data, ...hints.length ? { hints } : {} });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({
+          ok: false,
+          error: { code: err.code, message: err.message, fix: GOOGLE_ERROR_FIX }
+        });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  googleCommand
+};
+//# sourceMappingURL=google-3BO7KNZ6.js.map