@koda-sl/baker-cli 0.387.0 → 0.389.0-dev.8065ad8f0

package/dist/chunk-Z3ENMCFE.js

@@ -0,0 +1,94 @@
+// src/commands/landing/import-graph.ts
+import { readdir, readFile, stat } from "fs/promises";
+import path from "path";
+var SOURCE_EXT = /\.(astro|ts|tsx|js|jsx|mjs|cjs|vue|svelte)$/;
+var RESOLVE_CANDIDATES = [
+  "",
+  ".astro",
+  ".ts",
+  ".tsx",
+  ".js",
+  ".jsx",
+  ".mjs",
+  ".cjs",
+  "/index.astro",
+  "/index.ts",
+  "/index.js"
+];
+var IMPORT_RE = /(?<![A-Za-z0-9_$])(?:import|export)\s*(?:[\s\S]*?\bfrom\s*)?["']([^"']+)["']/g;
+var DYNAMIC_IMPORT_RE = /\bimport\s*\(\s*["']([^"']+)["']\s*\)/g;
+async function isFile(p) {
+  try {
+    return (await stat(p)).isFile();
+  } catch {
+    return false;
+  }
+}
+async function walkFiles(dir) {
+  let entries;
+  try {
+    entries = await readdir(dir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  const out = [];
+  for (const entry of entries) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name === "node_modules" || entry.name === "dist") continue;
+      out.push(...await walkFiles(full));
+    } else if (SOURCE_EXT.test(entry.name)) {
+      out.push(full);
+    }
+  }
+  return out;
+}
+async function resolveSpecifier(specifier, fromFile, root) {
+  const bare = specifier.split("?")[0] ?? "";
+  if (bare.includes("*")) return null;
+  let base;
+  if (bare.startsWith("/")) base = path.join(root, bare.slice(1));
+  else if (bare.startsWith(".")) base = path.resolve(path.dirname(fromFile), bare);
+  else return null;
+  for (const suffix of RESOLVE_CANDIDATES) {
+    const candidate = base + suffix;
+    if (SOURCE_EXT.test(candidate) && await isFile(candidate)) return candidate;
+  }
+  return null;
+}
+async function importedFiles(text, file, root) {
+  const out = [];
+  for (const re of [IMPORT_RE, DYNAMIC_IMPORT_RE]) {
+    for (const match of text.matchAll(re)) {
+      const spec = match[1];
+      if (spec === void 0) continue;
+      const target = await resolveSpecifier(spec, file, root);
+      if (target !== null) out.push(target);
+    }
+  }
+  return out;
+}
+async function landingGraphFiles(root, slug) {
+  const seen = /* @__PURE__ */ new Set();
+  const queue = await walkFiles(path.join(root, "src/pages", slug));
+  while (queue.length > 0) {
+    const file = queue.pop();
+    if (file === void 0 || seen.has(file)) continue;
+    let text;
+    try {
+      text = await readFile(file, "utf8");
+    } catch {
+      continue;
+    }
+    seen.add(file);
+    for (const target of await importedFiles(text, file, root)) {
+      if (!seen.has(target)) queue.push(target);
+    }
+  }
+  return new Set([...seen].map((abs) => path.relative(root, abs).split(path.sep).join("/")));
+}
+
+export {
+  landingGraphFiles
+};
+//# sourceMappingURL=chunk-Z3ENMCFE.js.map

package/dist/chunk-Z3ENMCFE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/landing/import-graph.ts"],"sourcesContent":["import type { Dirent } from \"node:fs\";\nimport { readdir, readFile, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/**\n * Which source files does a landing actually pull in?\n *\n * Pages share components since A/B tests shipped: a variant borrows the\n * control's sections and forks only the one under test. So a landing's source is\n * no longer \"this folder\" — the critic has to read the sections it renders\n * wherever they live, and the freshness fingerprint has to cover them or an edit\n * to a shared section leaves the borrowing page's sha unchanged and the quality\n * gate passes a page it never scored.\n *\n * MIRROR OF `apps/scaffold-template/__tooling__/checks/sdk/landing-import-graph.mjs`.\n * Neither can import the other — the CLI ships as a binary, the scaffold ships as\n * files — so they are two implementations of one rule, and\n * `scripts/__tests__/landing-source-version-parity.test.ts` runs both over one\n * fixture tree and fails when they disagree. Change one, change the other, and\n * let that test say whether you got it right.\n */\n\n/**\n * Files worth opening: source that ends up in the build. Gates both the\n * directory seed and every import target, so a landing that imports\n * `./_images/hero.png` never gets a binary read as UTF-8.\n */\nconst SOURCE_EXT = /\\.(astro|ts|tsx|js|jsx|mjs|cjs|vue|svelte)$/;\n\n/** Extension guesses for an extensionless specifier, in resolution order. */\nconst RESOLVE_CANDIDATES = [\n  \"\",\n  \".astro\",\n  \".ts\",\n  \".tsx\",\n  \".js\",\n  \".jsx\",\n  \".mjs\",\n  \".cjs\",\n  \"/index.astro\",\n  \"/index.ts\",\n  \"/index.js\",\n];\n\n/**\n * Static and dynamic import specifiers. Both boundaries are lookarounds rather\n * than character classes, because an inlined `<script>import{a}from\"./x\"</script>`\n * has no whitespace anywhere.\n */\nconst IMPORT_RE = /(?<![A-Za-z0-9_$])(?:import|export)\\s*(?:[\\s\\S]*?\\bfrom\\s*)?[\"']([^\"']+)[\"']/g;\nconst DYNAMIC_IMPORT_RE = /\\bimport\\s*\\(\\s*[\"']([^\"']+)[\"']\\s*\\)/g;\n\nasync function isFile(p: string): Promise<boolean> {\n  try {\n    return (await stat(p)).isFile();\n  } catch {\n    return false;\n  }\n}\n\n/** Every source file under `dir`, recursively. */\nasync function walkFiles(dir: string): Promise<string[]> {\n  let entries: Dirent[];\n  try {\n    entries = await readdir(dir, { withFileTypes: true });\n  } catch {\n    return [];\n  }\n  const out: string[] = [];\n  for (const entry of entries) {\n    const full = path.join(dir, entry.name);\n    if (entry.isDirectory()) {\n      if (entry.name === \"node_modules\" || entry.name === \"dist\") continue;\n      out.push(...(await walkFiles(full)));\n    } else if (SOURCE_EXT.test(entry.name)) {\n      out.push(full);\n    }\n  }\n  return out;\n}\n\n/** Resolve a relative or root-absolute specifier to a source file, else null. */\nasync function resolveSpecifier(specifier: string, fromFile: string, root: string): Promise<string | null> {\n  // Vite resolves a leading `/` from the project root; everything else that is\n  // not relative is a bare package specifier. A glob has no single target.\n  const bare = specifier.split(\"?\")[0] ?? \"\";\n  if (bare.includes(\"*\")) return null;\n\n  let base: string;\n  if (bare.startsWith(\"/\")) base = path.join(root, bare.slice(1));\n  else if (bare.startsWith(\".\")) base = path.resolve(path.dirname(fromFile), bare);\n  else return null;\n\n  for (const suffix of RESOLVE_CANDIDATES) {\n    const candidate = base + suffix;\n    if (SOURCE_EXT.test(candidate) && (await isFile(candidate))) return candidate;\n  }\n  return null;\n}\n\n/**\n * Every source file one landing pulls in, transitively, as repo-relative POSIX\n * paths.\n *\n * Seeded with the whole `src/pages/<slug>` directory rather than just\n * `index.astro`: co-located `_components/**` are imported from markup the\n * regexes do not always see.\n */\n/** Every source file `file`'s own text imports, resolved to absolute paths. */\nasync function importedFiles(text: string, file: string, root: string): Promise<string[]> {\n  const out: string[] = [];\n  for (const re of [IMPORT_RE, DYNAMIC_IMPORT_RE]) {\n    // `matchAll` clones the regex, so a shared global one carries no\n    // `lastIndex` between files.\n    for (const match of text.matchAll(re)) {\n      const spec = match[1];\n      if (spec === undefined) continue;\n      const target = await resolveSpecifier(spec, file, root);\n      if (target !== null) out.push(target);\n    }\n  }\n  return out;\n}\n\nexport async function landingGraphFiles(root: string, slug: string): Promise<Set<string>> {\n  const seen = new Set<string>();\n  const queue = await walkFiles(path.join(root, \"src/pages\", slug));\n\n  while (queue.length > 0) {\n    const file = queue.pop();\n    if (file === undefined || seen.has(file)) continue;\n\n    let text: string;\n    try {\n      text = await readFile(file, \"utf8\");\n    } catch {\n      continue;\n    }\n    seen.add(file);\n\n    for (const target of await importedFiles(text, file, root)) {\n      if (!seen.has(target)) queue.push(target);\n    }\n  }\n\n  return new Set([...seen].map((abs) => path.relative(root, abs).split(path.sep).join(\"/\")));\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-ZH7ZM3ZM.js

@@ -0,0 +1,125 @@
+import {
+  apiGet
+} from "./chunk-HREWXNTO.js";
+
+// src/commands/studio/batch.ts
+function projectBatch(generation, full) {
+  const compact = {
+    generationId: generation.generationId,
+    kind: generation.kind,
+    status: generation.status,
+    prompt: generation.prompt,
+    model: generation.model,
+    aspectRatio: generation.aspectRatio,
+    variants: generation.variants.map((variant) => ({
+      slot: variant.slot,
+      status: variant.status,
+      ...variant.imageId ? { imageId: variant.imageId } : {},
+      ...variant.videoId ? { videoId: variant.videoId } : {},
+      ...variant.url ? { url: variant.url } : {},
+      inLibrary: variant.inLibrary,
+      ...variant.error ? { error: variant.error } : {}
+    }))
+  };
+  if (!full) return compact;
+  return {
+    ...compact,
+    ...generation.skillId ? { skillId: generation.skillId } : {},
+    ...generation.imageSettings ? { imageSettings: generation.imageSettings } : {},
+    ...generation.clipSettings ? { clipSettings: generation.clipSettings } : {},
+    ...generation.referenceImageIds ? { referenceImageIds: generation.referenceImageIds } : {},
+    ...generation.chatId ? { chatId: generation.chatId } : {},
+    createdAt: generation.createdAt
+  };
+}
+function slotArg(candidates) {
+  return candidates.length === 1 ? `--slot ${candidates[0]?.slot}` : "--slot <n>";
+}
+function chooseFirst(candidates) {
+  return candidates.length === 1 ? "" : " Look at the takes and pick one \u2014 do not default to the first.";
+}
+function batchHints(generation) {
+  const id = generation.generationId;
+  if (generation.status === "running") {
+    return [
+      `Still rendering. Run \`baker studio get ${id}\` when you need the result \u2014 do not start the same batch again.`
+    ];
+  }
+  const hints = [];
+  const ready = generation.variants.filter((variant) => variant.status === "ready");
+  const failed = generation.variants.filter((variant) => variant.status === "failed");
+  if (generation.kind === "image" && ready.length > 0) {
+    hints.push(
+      'Every rendered image is already in the media library and searchable \u2014 `baker images library "<what it shows>"` finds it, and you can use its image id straight away.'
+    );
+    hints.push(
+      `Mark the take you are using: \`baker studio keep ${id} ${slotArg(ready)}\` stars it so the client reviews the right one.${chooseFirst(ready)}`
+    );
+  }
+  const unkeptClips = ready.filter((variant) => !variant.inLibrary);
+  if (generation.kind === "video" && unkeptClips.length > 0) {
+    hints.push(
+      `A clip is not usable anywhere \u2014 canvas, landing, ad \u2014 until you keep it. \`baker studio keep ${id} ${slotArg(unkeptClips)}\` puts it in the video library; takes nobody keeps are never ingested.${chooseFirst(unkeptClips)}`
+    );
+  }
+  if (generation.status === "partial" && failed.length > 0) {
+    hints.push(
+      `${failed.length === 1 ? "This take" : "These takes"} did not render \u2014 ${failed.map((variant) => `take ${variant.slot}: ${variant.error ?? "no reason given"}`).join("; ")}. Use the ones that did and carry on; do not re-run the whole batch.`
+    );
+  }
+  if (generation.status === "failed") {
+    hints.push(
+      `No take rendered \u2014 ${failed[0]?.error ?? "no reason given"}. Continue the job with a sourced or existing asset rather than stopping.`
+    );
+  }
+  return hints;
+}
+function waitingHint(outcome, generationId, maxWaitMs) {
+  const collect = `Run \`baker studio get ${generationId}\` to pick it up \u2014 the batch is still going, so do not start it again.`;
+  if (outcome.kind === "unreachable") {
+    return `The batch started and is rendering, but reading it back failed (${outcome.reason}). ${collect}`;
+  }
+  return `Still rendering after ${Math.round(maxWaitMs / 1e3)}s. ${collect}`;
+}
+var FALSEY_FLAG_VALUES = /* @__PURE__ */ new Set(["false", "0", "no", "off"]);
+function resolveMaxWaitMs(wait, maxWait, defaultMs) {
+  if (typeof wait === "string" && FALSEY_FLAG_VALUES.has(wait.trim().toLowerCase())) return 0;
+  if (wait === false) return 0;
+  if (maxWait === void 0 || maxWait === "") return defaultMs;
+  const parsed = Number(maxWait);
+  return Number.isFinite(parsed) && parsed >= 0 ? parsed : defaultMs;
+}
+var POLL_INTERVAL_MS = 3e3;
+var defaultPollDeps = {
+  get: async (generationId) => {
+    const response = await apiGet(`/api/studio/generations/${generationId}`);
+    return response.generation;
+  },
+  sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+};
+async function pollBatch(generationId, maxWaitMs, deps = defaultPollDeps) {
+  const deadline = Date.now() + maxWaitMs;
+  while (Date.now() < deadline) {
+    const generation = await deps.get(generationId);
+    if (generation.status !== "running") return generation;
+    await deps.sleep(POLL_INTERVAL_MS);
+  }
+  return null;
+}
+async function awaitBatch(generationId, maxWaitMs, deps = defaultPollDeps) {
+  try {
+    const generation = await pollBatch(generationId, maxWaitMs, deps);
+    return generation ? { kind: "settled", generation } : { kind: "still-running" };
+  } catch (error) {
+    return { kind: "unreachable", reason: error instanceof Error ? error.message : "the read failed" };
+  }
+}
+
+export {
+  projectBatch,
+  batchHints,
+  waitingHint,
+  resolveMaxWaitMs,
+  awaitBatch
+};
+//# sourceMappingURL=chunk-ZH7ZM3ZM.js.map

package/dist/chunk-ZH7ZM3ZM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/studio/batch.ts"],"sourcesContent":["import type { StudioGeneration, StudioGetResponse } from \"@baker/api\";\nimport { apiGet } from \"../../client.ts\";\n\n/**\n * Compact projection: what the agent needs to DECIDE what happened to a batch —\n * which takes rendered, where each one lives, and why a take is missing. The\n * settings echo, the reference list and the attribution are `--full` only,\n * because a four-take batch would otherwise repeat the whole request back.\n */\nexport function projectBatch(generation: StudioGeneration, full: boolean): Record<string, unknown> {\n  const compact: Record<string, unknown> = {\n    generationId: generation.generationId,\n    kind: generation.kind,\n    status: generation.status,\n    prompt: generation.prompt,\n    model: generation.model,\n    aspectRatio: generation.aspectRatio,\n    variants: generation.variants.map((variant) => ({\n      slot: variant.slot,\n      status: variant.status,\n      ...(variant.imageId ? { imageId: variant.imageId } : {}),\n      ...(variant.videoId ? { videoId: variant.videoId } : {}),\n      ...(variant.url ? { url: variant.url } : {}),\n      inLibrary: variant.inLibrary,\n      ...(variant.error ? { error: variant.error } : {}),\n    })),\n  };\n  if (!full) return compact;\n  return {\n    ...compact,\n    ...(generation.skillId ? { skillId: generation.skillId } : {}),\n    ...(generation.imageSettings ? { imageSettings: generation.imageSettings } : {}),\n    ...(generation.clipSettings ? { clipSettings: generation.clipSettings } : {}),\n    ...(generation.referenceImageIds ? { referenceImageIds: generation.referenceImageIds } : {}),\n    ...(generation.chatId ? { chatId: generation.chatId } : {}),\n    createdAt: generation.createdAt,\n  };\n}\n\n/**\n * The `--slot` argument to show in a keep hint.\n *\n * A hint carrying a complete, paste-ready command gets pasted — that is what a\n * hint is for. So it may only name a slot when there is no choice to make.\n * Naming the first ready take out of several turned \"keep the one you chose\"\n * into \"keep slot 0\", on every batch, which makes the star meaningless: the\n * client sees one starred take per batch whether or not anyone judged them.\n */\nfunction slotArg(candidates: { slot: number }[]): string {\n  return candidates.length === 1 ? `--slot ${candidates[0]?.slot}` : \"--slot <n>\";\n}\n\n/** Says out loud that the choice is the agent's, only when there is one. */\nfunction chooseFirst(candidates: unknown[]): string {\n  return candidates.length === 1 ? \"\" : \" Look at the takes and pick one — do not default to the first.\";\n}\n\n/**\n * What to do next with this batch.\n *\n * The two misuses worth spending a hint on: starting the same batch again while\n * it is still rendering, and treating a rendered clip as usable. A clip is only\n * ingested when it is kept, so an agent that hands the URL to a canvas is\n * pointing at something the library never took.\n */\nexport function batchHints(generation: StudioGeneration): string[] {\n  const id = generation.generationId;\n  if (generation.status === \"running\") {\n    return [\n      `Still rendering. Run \\`baker studio get ${id}\\` when you need the result — do not start the same batch again.`,\n    ];\n  }\n\n  const hints: string[] = [];\n  const ready = generation.variants.filter((variant) => variant.status === \"ready\");\n  const failed = generation.variants.filter((variant) => variant.status === \"failed\");\n\n  if (generation.kind === \"image\" && ready.length > 0) {\n    hints.push(\n      'Every rendered image is already in the media library and searchable — `baker images library \"<what it shows>\"` finds it, and you can use its image id straight away.',\n    );\n    hints.push(\n      `Mark the take you are using: \\`baker studio keep ${id} ${slotArg(ready)}\\` stars it so the client reviews the right one.${chooseFirst(ready)}`,\n    );\n  }\n\n  const unkeptClips = ready.filter((variant) => !variant.inLibrary);\n  if (generation.kind === \"video\" && unkeptClips.length > 0) {\n    hints.push(\n      `A clip is not usable anywhere — canvas, landing, ad — until you keep it. \\`baker studio keep ${id} ${slotArg(unkeptClips)}\\` puts it in the video library; takes nobody keeps are never ingested.${chooseFirst(unkeptClips)}`,\n    );\n  }\n\n  if (generation.status === \"partial\" && failed.length > 0) {\n    hints.push(\n      `${failed.length === 1 ? \"This take\" : \"These takes\"} did not render — ${failed\n        .map((variant) => `take ${variant.slot}: ${variant.error ?? \"no reason given\"}`)\n        .join(\"; \")}. Use the ones that did and carry on; do not re-run the whole batch.`,\n    );\n  }\n\n  if (generation.status === \"failed\") {\n    hints.push(\n      `No take rendered — ${failed[0]?.error ?? \"no reason given\"}. Continue the job with a sourced or existing asset rather than stopping.`,\n    );\n  }\n\n  return hints;\n}\n\n/**\n * What to tell a caller still holding a batch that has not settled — whether it\n * simply outlasted the wait, or the read stopped answering. Both end the same\n * way, and that ending is the point: the takes are paid for and still coming, so\n * collect them by id rather than starting again.\n */\nexport function waitingHint(outcome: BatchOutcome, generationId: string, maxWaitMs: number): string {\n  const collect = `Run \\`baker studio get ${generationId}\\` to pick it up — the batch is still going, so do not start it again.`;\n  if (outcome.kind === \"unreachable\") {\n    return `The batch started and is rendering, but reading it back failed (${outcome.reason}). ${collect}`;\n  }\n  return `Still rendering after ${Math.round(maxWaitMs / 1000)}s. ${collect}`;\n}\n\nconst FALSEY_FLAG_VALUES = new Set([\"false\", \"0\", \"no\", \"off\"]);\n\n/**\n * How long to hold the command open, in ms — 0 meaning \"return the id now\".\n *\n * Two ways to say the same thing because agents reach for both: `--wait false`\n * (don't block) and `--max-wait 0` (block for nothing).\n */\nexport function resolveMaxWaitMs(wait: unknown, maxWait: unknown, defaultMs: number): number {\n  if (typeof wait === \"string\" && FALSEY_FLAG_VALUES.has(wait.trim().toLowerCase())) return 0;\n  if (wait === false) return 0;\n  if (maxWait === undefined || maxWait === \"\") return defaultMs;\n  const parsed = Number(maxWait);\n  return Number.isFinite(parsed) && parsed >= 0 ? parsed : defaultMs;\n}\n\nconst POLL_INTERVAL_MS = 3_000;\n\nexport type PollDeps = {\n  get: (generationId: string) => Promise<StudioGeneration>;\n  sleep: (ms: number) => Promise<void>;\n};\n\nexport const defaultPollDeps: PollDeps = {\n  get: async (generationId) => {\n    const response = await apiGet<StudioGetResponse>(`/api/studio/generations/${generationId}`);\n    return response.generation;\n  },\n  sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),\n};\n\n/**\n * Poll until the batch stops running, or give up and hand the id back.\n *\n * Running out of patience is NOT a failure here: the batch is still rendering on\n * the backend and will land in the dashboard either way, so the honest answer is\n * the id plus \"pick it up with `baker studio get`\". Exiting non-zero would make a\n * slow provider look like a broken command and push the agent into re-running a\n * generation the company already paid for.\n */\nexport async function pollBatch(\n  generationId: string,\n  maxWaitMs: number,\n  deps: PollDeps = defaultPollDeps,\n): Promise<StudioGeneration | null> {\n  const deadline = Date.now() + maxWaitMs;\n  while (Date.now() < deadline) {\n    const generation = await deps.get(generationId);\n    if (generation.status !== \"running\") return generation;\n    await deps.sleep(POLL_INTERVAL_MS);\n  }\n  return null;\n}\n\n/** What became of a batch that was successfully STARTED — and therefore billed. */\nexport type BatchOutcome =\n  | { kind: \"settled\"; generation: StudioGeneration }\n  | { kind: \"still-running\" }\n  | { kind: \"unreachable\"; reason: string };\n\n/**\n * Wait for a started batch without ever throwing.\n *\n * Once the POST returns, the takes are rendering and the company has paid. A\n * read that fails after that point says nothing about the request — the batch is\n * fine, we just could not see it — so it must not surface as a refused start,\n * which is advice to change a setting and run the whole thing again. Losing the\n * `generationId` here is what turns one transient GET into a second charge.\n */\nexport async function awaitBatch(\n  generationId: string,\n  maxWaitMs: number,\n  deps: PollDeps = defaultPollDeps,\n): Promise<BatchOutcome> {\n  try {\n    const generation = await pollBatch(generationId, maxWaitMs, deps);\n    return generation ? { kind: \"settled\", generation } : { kind: \"still-running\" };\n  } catch (error) {\n    return { kind: \"unreachable\", reason: error instanceof Error ? error.message : \"the read failed\" };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-ZIXHS6AM.js

@@ -0,0 +1,42 @@
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+
+// src/lib/describeArgs.ts
+function describeTags(rawArgs, parsed) {
+  const given = repeatedValues(rawArgs, "tags", parsed);
+  if (given.length === 0) return void 0;
+  return given.flatMap((chunk) => chunk.split(",").map((tag) => tag.trim())).filter(Boolean);
+}
+function describeHints(noun, body) {
+  const search = noun === "images" ? "baker images library" : "baker videos search";
+  const hints = [];
+  if (body.description !== void 0) {
+    hints.push(
+      `The semantic index rebuilds in the background \u2014 a \`${search}\` run right now may still rank on the old description.`
+    );
+  }
+  if (body.tags !== void 0) {
+    hints.push(`--tags replaced the whole tag set. Run \`baker ${noun} get <id>\` first if you meant to add to it.`);
+  }
+  return hints.length > 0 ? hints : void 0;
+}
+function describeFields(args, rawArgs) {
+  const fields = {};
+  if (args.description) fields.description = args.description;
+  if (args.name) fields.name = args.name;
+  const tags = describeTags(rawArgs, args.tags);
+  if (tags !== void 0) fields.tags = tags;
+  return fields;
+}
+function describeErrorFix(code, noun) {
+  if (code !== "CONFLICT") return void 0;
+  return `Poll \`baker ${noun} get <id>\` until \`status\` reads "ready", then run this again. Do not retry immediately \u2014 the answer will not change until the analysis lands.`;
+}
+
+export {
+  describeHints,
+  describeFields,
+  describeErrorFix
+};
+//# sourceMappingURL=chunk-ZIXHS6AM.js.map

package/dist/chunk-ZIXHS6AM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/describeArgs.ts"],"sourcesContent":["import { repeatedValues } from \"./repeatedFlags.ts\";\n\n/**\n * The tag set a `describe` call was given, or `undefined` when the flag was\n * never passed.\n *\n * Both spellings land in the same place: `--tags a,b` and `--tags a --tags b`.\n * The repeated form has to be read off `rawArgs` because citty collapses a\n * repeated flag to its last value (see `repeatedFlags.ts`) — and on this\n * command that collapse is destructive rather than merely lossy, since the\n * write **replaces** the whole tag set. `--tags a --tags b` would have stored\n * `b` alone and reported success.\n *\n * An empty result is a real value, not a missing one: `--tags ,` clears the\n * set, which is the only way to say \"no tags\" once a wrong one is on the row.\n */\nexport function describeTags(rawArgs: readonly string[] | undefined, parsed: unknown): string[] | undefined {\n  const given = repeatedValues(rawArgs, \"tags\", parsed);\n  if (given.length === 0) return undefined;\n  return given.flatMap((chunk) => chunk.split(\",\").map((tag) => tag.trim())).filter(Boolean);\n}\n\n/**\n * The two things an agent gets wrong right after a `describe` call: searching\n * for the new wording immediately, and assuming `--tags` merged.\n */\nexport function describeHints(\n  noun: \"images\" | \"videos\",\n  body: { description?: string; tags?: string[] },\n): string[] | undefined {\n  // Named as the command the agent would actually run, not as the family —\n  // the two families do not spell their library search the same way.\n  const search = noun === \"images\" ? \"baker images library\" : \"baker videos search\";\n  const hints: string[] = [];\n  if (body.description !== undefined) {\n    hints.push(\n      `The semantic index rebuilds in the background — a \\`${search}\\` run right now may still rank on the old description.`,\n    );\n  }\n  if (body.tags !== undefined) {\n    hints.push(`--tags replaced the whole tag set. Run \\`baker ${noun} get <id>\\` first if you meant to add to it.`);\n  }\n  return hints.length > 0 ? hints : undefined;\n}\n\n/** The three fields a `describe` call may change, as the request carries them. */\nexport type DescribeFields = { name?: string; description?: string; tags?: string[] };\n\n/**\n * The fields a `describe` invocation is actually asking to change.\n *\n * A flag left off is absent rather than empty, because the mutation merges\n * against the stored row: sending `name: \"\"` for a flag the caller never typed\n * would blank it. `--description \"\"` is treated the same way — an empty string\n * is not a description anybody meant to write.\n */\nexport function describeFields(args: Record<string, unknown>, rawArgs: readonly string[] | undefined): DescribeFields {\n  const fields: DescribeFields = {};\n  if (args.description) fields.description = args.description as string;\n  if (args.name) fields.name = args.name as string;\n  const tags = describeTags(rawArgs, args.tags);\n  if (tags !== undefined) fields.tags = tags;\n  return fields;\n}\n\n/**\n * Remediation for the one refusal the agent can act on rather than report.\n *\n * `CONFLICT` means the row is still being analysed, and the analysis overwrites\n * `name` / `description` / `tags` when it lands — so an immediate retry cannot\n * succeed, and saying so is the difference between one wasted call and a loop.\n */\nexport function describeErrorFix(code: string, noun: \"images\" | \"videos\"): string | undefined {\n  if (code !== \"CONFLICT\") return undefined;\n  return `Poll \\`baker ${noun} get <id>\\` until \\`status\\` reads \"ready\", then run this again. Do not retry immediately — the answer will not change until the analysis lands.`;\n}\n"],"mappings":";;;;;AAgBO,SAAS,aAAa,SAAwC,QAAuC;AAC1G,QAAM,QAAQ,eAAe,SAAS,QAAQ,MAAM;AACpD,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,SAAO,MAAM,QAAQ,CAAC,UAAU,MAAM,MAAM,GAAG,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC,EAAE,OAAO,OAAO;AAC3F;AAMO,SAAS,cACd,MACA,MACsB;AAGtB,QAAM,SAAS,SAAS,WAAW,yBAAyB;AAC5D,QAAM,QAAkB,CAAC;AACzB,MAAI,KAAK,gBAAgB,QAAW;AAClC,UAAM;AAAA,MACJ,4DAAuD,MAAM;AAAA,IAC/D;AAAA,EACF;AACA,MAAI,KAAK,SAAS,QAAW;AAC3B,UAAM,KAAK,kDAAkD,IAAI,8CAA8C;AAAA,EACjH;AACA,SAAO,MAAM,SAAS,IAAI,QAAQ;AACpC;AAaO,SAAS,eAAe,MAA+B,SAAwD;AACpH,QAAM,SAAyB,CAAC;AAChC,MAAI,KAAK,YAAa,QAAO,cAAc,KAAK;AAChD,MAAI,KAAK,KAAM,QAAO,OAAO,KAAK;AAClC,QAAM,OAAO,aAAa,SAAS,KAAK,IAAI;AAC5C,MAAI,SAAS,OAAW,QAAO,OAAO;AACtC,SAAO;AACT;AASO,SAAS,iBAAiB,MAAc,MAA+C;AAC5F,MAAI,SAAS,WAAY,QAAO;AAChC,SAAO,gBAAgB,IAAI;AAC7B;","names":[]}

package/dist/chunk-ZLLJKSNS.js

@@ -0,0 +1,96 @@
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-HREWXNTO.js";
+
+// src/commands/images/api.ts
+import { readFile } from "fs/promises";
+import { basename, extname } from "path";
+var imageProcessingTimeoutMs = 18e4;
+var imageReadyPollIntervalMs = 2e3;
+var mimeMap = {
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".svg": "image/svg+xml",
+  ".avif": "image/avif"
+};
+var defaultImageApiDeps = {
+  readFile,
+  post: apiPost,
+  get: apiGet,
+  sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+};
+function detectImageContentType(filePath, opts = {}) {
+  const ext = extname(filePath).toLowerCase();
+  const contentType = mimeMap[ext];
+  if (!contentType || opts.allowedContentTypes && !opts.allowedContentTypes.includes(contentType)) {
+    throw new ApiError(
+      "VALIDATION_ERROR",
+      opts.unsupportedMessage ?? `Cannot detect content type for extension "${ext}". Use --content-type.`
+    );
+  }
+  return contentType;
+}
+async function uploadLocalImage(args, deps = defaultImageApiDeps) {
+  return uploadImageBytes(
+    {
+      bytes: await deps.readFile(args.file),
+      contentType: args.contentType,
+      // Only the bytes used to be sent, so "iso27001-badge.png" arrived as an
+      // anonymous blob. The describe pass treats this as a hint, not gospel.
+      originalFilename: basename(args.file),
+      source: args.source,
+      descriptionContext: args.descriptionContext
+    },
+    deps
+  );
+}
+function uploadImageBytes(args, deps = defaultImageApiDeps) {
+  const body = {
+    base64: args.bytes.toString("base64"),
+    contentType: args.contentType,
+    originalFilename: args.originalFilename
+  };
+  if (args.source) body.source = args.source;
+  if (args.descriptionContext) body.descriptionContext = args.descriptionContext;
+  return deps.post("/api/images/upload", body, { timeoutMs: imageProcessingTimeoutMs });
+}
+function getImage(deps, imageId) {
+  return deps.get("/api/images/get", { id: imageId });
+}
+function publishImageAsCreative(deps, args) {
+  return deps.post("/api/creatives/publish", args);
+}
+async function waitForReadyImage(deps, imageId, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? imageProcessingTimeoutMs;
+  const pollIntervalMs = opts.pollIntervalMs ?? imageReadyPollIntervalMs;
+  const deadline = Date.now() + timeoutMs;
+  let lastStatus = "unknown";
+  while (Date.now() <= deadline) {
+    const image = await getImage(deps, imageId);
+    lastStatus = image.status;
+    if (image.status === "ready") {
+      return image;
+    }
+    if (image.status === "error") {
+      throw new ApiError("IMAGE_PROCESSING_ERROR", "Image processing failed");
+    }
+    await deps.sleep(pollIntervalMs);
+  }
+  throw new ApiError("TIMEOUT", `Image was not ready before timeout; last status: ${lastStatus}`);
+}
+
+export {
+  imageProcessingTimeoutMs,
+  defaultImageApiDeps,
+  detectImageContentType,
+  uploadLocalImage,
+  uploadImageBytes,
+  publishImageAsCreative,
+  waitForReadyImage
+};
+//# sourceMappingURL=chunk-ZLLJKSNS.js.map

package/dist/chunk-ZLLJKSNS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/api.ts"],"sourcesContent":["import type { Buffer } from \"node:buffer\";\nimport { readFile } from \"node:fs/promises\";\nimport { basename, extname } from \"node:path\";\nimport type { ImageDoc, ImagesUploadResponse } from \"@baker/api\";\nimport { ApiError, apiGet, apiPost } from \"../../client.ts\";\n\nexport const imageProcessingTimeoutMs = 180_000;\nconst imageReadyPollIntervalMs = 2_000;\n\nconst mimeMap: Record<string, string> = {\n  \".png\": \"image/png\",\n  \".jpg\": \"image/jpeg\",\n  \".jpeg\": \"image/jpeg\",\n  \".gif\": \"image/gif\",\n  \".webp\": \"image/webp\",\n  \".svg\": \"image/svg+xml\",\n  \".avif\": \"image/avif\",\n};\n\nexport type ImageApiDeps = {\n  readFile: (path: string) => Promise<Buffer>;\n  post: typeof apiPost;\n  get: typeof apiGet;\n  sleep: (ms: number) => Promise<void>;\n};\n\nexport const defaultImageApiDeps: ImageApiDeps = {\n  readFile,\n  post: apiPost,\n  get: apiGet,\n  sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),\n};\n\nexport function detectImageContentType(\n  filePath: string,\n  opts: { allowedContentTypes?: readonly string[]; unsupportedMessage?: string } = {},\n): string {\n  const ext = extname(filePath).toLowerCase();\n  const contentType = mimeMap[ext];\n  if (!contentType || (opts.allowedContentTypes && !opts.allowedContentTypes.includes(contentType))) {\n    throw new ApiError(\n      \"VALIDATION_ERROR\",\n      opts.unsupportedMessage ?? `Cannot detect content type for extension \"${ext}\". Use --content-type.`,\n    );\n  }\n  return contentType;\n}\n\nexport async function uploadLocalImage(\n  args: { file: string; contentType: string; source?: string; descriptionContext?: string },\n  deps: ImageApiDeps = defaultImageApiDeps,\n): Promise<ImagesUploadResponse> {\n  return uploadImageBytes(\n    {\n      bytes: await deps.readFile(args.file),\n      contentType: args.contentType,\n      // Only the bytes used to be sent, so \"iso27001-badge.png\" arrived as an\n      // anonymous blob. The describe pass treats this as a hint, not gospel.\n      originalFilename: basename(args.file),\n      source: args.source,\n      descriptionContext: args.descriptionContext,\n    },\n    deps,\n  );\n}\n\n/** Upload image bytes that did not come from a local file (a run's persisted output). */\nexport function uploadImageBytes(\n  args: { bytes: Buffer; contentType: string; originalFilename: string; source?: string; descriptionContext?: string },\n  deps: Pick<ImageApiDeps, \"post\"> = defaultImageApiDeps,\n): Promise<ImagesUploadResponse> {\n  const body: Record<string, unknown> = {\n    base64: args.bytes.toString(\"base64\"),\n    contentType: args.contentType,\n    originalFilename: args.originalFilename,\n  };\n  if (args.source) body.source = args.source;\n  if (args.descriptionContext) body.descriptionContext = args.descriptionContext;\n  return deps.post<ImagesUploadResponse>(\"/api/images/upload\", body, { timeoutMs: imageProcessingTimeoutMs });\n}\n\nfunction getImage(deps: ImageApiDeps, imageId: string): Promise<ImageDoc> {\n  return deps.get<ImageDoc>(\"/api/images/get\", { id: imageId });\n}\n\ntype CreativeReference = {\n  type: \"creative\";\n  slug: string;\n  creativeId: string;\n  title: string;\n  asset: {\n    kind: \"static_image\";\n    imageId: string;\n    imageUrl: string;\n    storageKey?: string;\n    width?: number;\n    height?: number;\n    aspectRatio?: number;\n  };\n  imageUrl: string;\n  thumbnailUrl: string;\n  storageKey?: string;\n  sourceReferenceUrl?: string;\n  width?: number;\n  height?: number;\n  aspectRatio?: number;\n};\n\ntype PublishCreativeResponse = {\n  creativeId: string;\n  imageId: string;\n  reference: CreativeReference;\n};\n\nexport function publishImageAsCreative(\n  deps: ImageApiDeps,\n  args: {\n    imageId: string;\n    title: string;\n    sourceReferenceUrl?: string;\n    slug?: string;\n    runId?: string;\n    chatId?: string;\n  },\n): Promise<PublishCreativeResponse> {\n  return deps.post(\"/api/creatives/publish\", args);\n}\n\nexport async function waitForReadyImage(\n  deps: ImageApiDeps,\n  imageId: string,\n  opts: { timeoutMs?: number; pollIntervalMs?: number } = {},\n): Promise<ImageDoc> {\n  const timeoutMs = opts.timeoutMs ?? imageProcessingTimeoutMs;\n  const pollIntervalMs = opts.pollIntervalMs ?? imageReadyPollIntervalMs;\n  const deadline = Date.now() + timeoutMs;\n  let lastStatus = \"unknown\";\n  while (Date.now() <= deadline) {\n    const image = await getImage(deps, imageId);\n    lastStatus = image.status;\n    if (image.status === \"ready\") {\n      return image;\n    }\n    if (image.status === \"error\") {\n      throw new ApiError(\"IMAGE_PROCESSING_ERROR\", \"Image processing failed\");\n    }\n    await deps.sleep(pollIntervalMs);\n  }\n  throw new ApiError(\"TIMEOUT\", `Image was not ready before timeout; last status: ${lastStatus}`);\n}\n"],"mappings":";;;;;;;AACA,SAAS,gBAAgB;AACzB,SAAS,UAAU,eAAe;AAI3B,IAAM,2BAA2B;AACxC,IAAM,2BAA2B;AAEjC,IAAM,UAAkC;AAAA,EACtC,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,SAAS;AACX;AASO,IAAM,sBAAoC;AAAA,EAC/C;AAAA,EACA,MAAM;AAAA,EACN,KAAK;AAAA,EACL,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AACjE;AAEO,SAAS,uBACd,UACA,OAAiF,CAAC,GAC1E;AACR,QAAM,MAAM,QAAQ,QAAQ,EAAE,YAAY;AAC1C,QAAM,cAAc,QAAQ,GAAG;AAC/B,MAAI,CAAC,eAAgB,KAAK,uBAAuB,CAAC,KAAK,oBAAoB,SAAS,WAAW,GAAI;AACjG,UAAM,IAAI;AAAA,MACR;AAAA,MACA,KAAK,sBAAsB,6CAA6C,GAAG;AAAA,IAC7E;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAsB,iBACpB,MACA,OAAqB,qBACU;AAC/B,SAAO;AAAA,IACL;AAAA,MACE,OAAO,MAAM,KAAK,SAAS,KAAK,IAAI;AAAA,MACpC,aAAa,KAAK;AAAA;AAAA;AAAA,MAGlB,kBAAkB,SAAS,KAAK,IAAI;AAAA,MACpC,QAAQ,KAAK;AAAA,MACb,oBAAoB,KAAK;AAAA,IAC3B;AAAA,IACA;AAAA,EACF;AACF;AAGO,SAAS,iBACd,MACA,OAAmC,qBACJ;AAC/B,QAAM,OAAgC;AAAA,IACpC,QAAQ,KAAK,MAAM,SAAS,QAAQ;AAAA,IACpC,aAAa,KAAK;AAAA,IAClB,kBAAkB,KAAK;AAAA,EACzB;AACA,MAAI,KAAK,OAAQ,MAAK,SAAS,KAAK;AACpC,MAAI,KAAK,mBAAoB,MAAK,qBAAqB,KAAK;AAC5D,SAAO,KAAK,KAA2B,sBAAsB,MAAM,EAAE,WAAW,yBAAyB,CAAC;AAC5G;AAEA,SAAS,SAAS,MAAoB,SAAoC;AACxE,SAAO,KAAK,IAAc,mBAAmB,EAAE,IAAI,QAAQ,CAAC;AAC9D;AA+BO,SAAS,uBACd,MACA,MAQkC;AAClC,SAAO,KAAK,KAAK,0BAA0B,IAAI;AACjD;AAEA,eAAsB,kBACpB,MACA,SACA,OAAwD,CAAC,GACtC;AACnB,QAAM,YAAY,KAAK,aAAa;AACpC,QAAM,iBAAiB,KAAK,kBAAkB;AAC9C,QAAM,WAAW,KAAK,IAAI,IAAI;AAC9B,MAAI,aAAa;AACjB,SAAO,KAAK,IAAI,KAAK,UAAU;AAC7B,UAAM,QAAQ,MAAM,SAAS,MAAM,OAAO;AAC1C,iBAAa,MAAM;AACnB,QAAI,MAAM,WAAW,SAAS;AAC5B,aAAO;AAAA,IACT;AACA,QAAI,MAAM,WAAW,SAAS;AAC5B,YAAM,IAAI,SAAS,0BAA0B,yBAAyB;AAAA,IACxE;AACA,UAAM,KAAK,MAAM,cAAc;AAAA,EACjC;AACA,QAAM,IAAI,SAAS,WAAW,oDAAoD,UAAU,EAAE;AAChG;","names":[]}

package/dist/claim-LF6VQ7OR.js

@@ -0,0 +1,197 @@
+import {
+  failApi,
+  failValidation
+} from "./chunk-7THBBTJJ.js";
+import "./chunk-SMIENBNX.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-XX6ZMCY5.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import {
+  requireChatId
+} from "./chunk-O6QKCJE4.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/claim.ts
+import { defineCommand } from "citty";
+
+// src/commands/actions/skillCatalog.ts
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { dirname, join } from "path";
+var DESCRIPTION_MAX = 600;
+var SKILLS_SUBPATH = join(".claude", "skills");
+var EXCLUDED_SKILLS = /* @__PURE__ */ new Set(["actions"]);
+function stripQuotes(value) {
+  const trimmed = value.trim();
+  if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
+    return trimmed.slice(1, -1).replace(/\\"/g, '"').replace(/\\n/g, "\n");
+  }
+  if (trimmed.startsWith("'") && trimmed.endsWith("'")) {
+    return trimmed.slice(1, -1).replace(/''/g, "'");
+  }
+  return trimmed;
+}
+function extractFrontmatterLines(md) {
+  if (!md.startsWith("---")) return null;
+  const end = md.indexOf("\n---", 3);
+  if (end === -1) return null;
+  return md.slice(md.indexOf("\n", 3) + 1, end).split("\n");
+}
+var BLOCK_SCALAR = /^([|>])[+-]?$/;
+function collectBlockLines(lines, start) {
+  const collected = [];
+  for (let i = start; i < lines.length; i++) {
+    const line = lines[i] ?? "";
+    if (line.trim() === "") {
+      collected.push("");
+    } else if (/^\s/.test(line)) {
+      collected.push(line.trim());
+    } else {
+      break;
+    }
+  }
+  while (collected.length > 0 && collected.at(-1) === "") collected.pop();
+  return collected;
+}
+function foldLines(collected) {
+  const paragraphs = [];
+  let buffer = [];
+  for (const line of collected) {
+    if (line === "") {
+      if (buffer.length > 0) paragraphs.push(buffer.join(" "));
+      buffer = [];
+    } else {
+      buffer.push(line);
+    }
+  }
+  if (buffer.length > 0) paragraphs.push(buffer.join(" "));
+  return paragraphs.join("\n");
+}
+function readBlockScalar(lines, start, style) {
+  const collected = collectBlockLines(lines, start);
+  return style === "|" ? collected.join("\n") : foldLines(collected);
+}
+function readField(lines, field) {
+  for (let i = 0; i < lines.length; i++) {
+    const match = (lines[i] ?? "").match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+    if (!match || match[1] !== field) continue;
+    const inline = (match[2] ?? "").trim();
+    const scalar = inline.match(BLOCK_SCALAR);
+    if (scalar) {
+      return readBlockScalar(lines, i + 1, scalar[1]);
+    }
+    return stripQuotes(inline);
+  }
+  return null;
+}
+function parseSkillFrontmatter(md) {
+  const lines = extractFrontmatterLines(md);
+  if (!lines) return null;
+  const name = readField(lines, "name");
+  const description = readField(lines, "description");
+  if (!name || !description) return null;
+  const trimmed = description.length > DESCRIPTION_MAX ? `${description.slice(0, DESCRIPTION_MAX)}\u2026` : description;
+  return { name, description: trimmed };
+}
+function findSkillsDir(startDir) {
+  let dir = startDir;
+  for (; ; ) {
+    const candidate = join(dir, SKILLS_SUBPATH);
+    if (existsSync(candidate)) return candidate;
+    const parent = dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function readSkillCatalog(startDir) {
+  const skillsDir = findSkillsDir(startDir);
+  if (!skillsDir) return [];
+  const entries = [];
+  for (const dirent of readdirSync(skillsDir, { withFileTypes: true })) {
+    if (!dirent.isDirectory() || EXCLUDED_SKILLS.has(dirent.name)) continue;
+    const skillFile = join(skillsDir, dirent.name, "SKILL.md");
+    if (!existsSync(skillFile)) continue;
+    try {
+      const parsed = parseSkillFrontmatter(readFileSync(skillFile, "utf8"));
+      if (parsed) entries.push(parsed);
+    } catch {
+    }
+  }
+  return entries.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+// src/commands/actions/claim.ts
+registerSchema({
+  command: "actions.claim",
+  description: "Claim an action for the current chat (live \u2014 visible to other chats immediately). Claim only what you're actively working on now: it's required before `complete`, but NOT for `update` or `discard` (those stage without a claim). Returns action details plus a fast-model recommendation of which skills to load for the work (`recommendedSkills`) and a routing hint: load every skill that owns part of the work and the tool doc for each baker CLI family you'll use.",
+  args: {
+    id: { type: "string", description: "Action ID", required: true }
+  }
+});
+async function recommendSkills(actionId) {
+  const skills = readSkillCatalog(process.cwd());
+  if (skills.length === 0) return [];
+  const response = await apiPost("/api/actions/recommend-skills", {
+    actionId,
+    skills
+  });
+  return response.data.recommendations;
+}
+var ROUTING_HINT = "Actions often span several surfaces (a landing page plus a Google Ads change, a sheet pull plus an audience upload). Before starting, load EVERY skill that owns part of the work and read the tool doc (__tooling__/docs/tools/baker/<family>.md) for each baker CLI family you'll use. If the action references source material living in a connected tool (an email attachment, a call, a CRM record, a spreadsheet), reach for that tool too. If it describes recurring or future-dated work, it belongs on a schedule \u2014 see __tooling__/docs/tools/baker/scheduled-agents.md.";
+function buildHints(recommendations) {
+  if (recommendations.length === 0) {
+    return ["Review the action name, description, and tags above.", ROUTING_HINT];
+  }
+  return [
+    "Recommended skills for this action (load the ones you'll use):",
+    ...recommendations.map((r) => `  /${r.name} \u2014 ${r.reason}`),
+    "Suggestions come from the action's name/description/tags only \u2014 the work may need more.",
+    ROUTING_HINT
+  ];
+}
+var claimCommand = defineCommand({
+  meta: {
+    name: "claim",
+    description: "Claim an action so other chats see you're working on it. Required before `complete` (update and discard don't need a claim). Example: baker actions claim <action-id>"
+  },
+  args: {
+    id: { type: "positional", description: "Action ID", required: false },
+    "action-id": { type: "string", description: "Action ID", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["action-id"];
+      if (!id) {
+        failValidation("Action ID is required.");
+      }
+      validateConvexId(id);
+      const chatId = requireChatId();
+      const response = await apiPost("/api/actions/claim", {
+        actionId: id,
+        chatId
+      });
+      let recommendedSkills = [];
+      try {
+        recommendedSkills = await recommendSkills(id);
+      } catch {
+      }
+      const data = response.data ? { ...response.data, recommendedSkills } : response.data;
+      writeJson({ ok: response.ok, data, hints: buildHints(recommendedSkills) });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  claimCommand
+};
+//# sourceMappingURL=claim-LF6VQ7OR.js.map