@koda-sl/baker-cli 0.536.0 → 0.538.0-dev.fc2958a1d

package/dist/stats-3TAUG3Q3.js

@@ -0,0 +1,34 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/stats/index.ts
+import { defineCommand } from "citty";
+var statsCommand = defineCommand({
+  meta: {
+    name: "stats",
+    description: `X Ads analytics. Sync (\u22647 days, no segmentation) or async jobs (\u226490 days, segmentable).
+
+Subcommands:
+  sync         \u2014 synchronous stats (max 7 days). Cheapest, fastest.
+  job          \u2014 async stats job, end-to-end (creates + polls + downloads). Must run in the background.
+                 Use for ranges >7 days, segmented stats, or when sync limits are hit.
+  job-create   \u2014 low-level: create an async stats job and return the ID immediately
+  job-status   \u2014 low-level: poll job status / get the download URL
+
+Examples:
+  baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def
+  baker ads x stats job --account-id 18ce53xyz --entity CAMPAIGN \\
+    --entity-ids abc,def --start-time 2026-04-01T00:00:00Z \\
+    --end-time 2026-05-01T00:00:00Z --metric-groups ENGAGEMENT,BILLING
+  baker ads x stats job-status --account-id 18ce53xyz --job-id abc`
+  },
+  subCommands: {
+    sync: () => import("./sync-TJ7MGFIE.js").then((m) => m.statsSyncCommand),
+    job: () => import("./job-B6UEZLTA.js").then((m) => m.statsJobCommand),
+    "job-create": () => import("./job-create-WM27NOGZ.js").then((m) => m.statsJobCreateCommand),
+    "job-status": () => import("./job-status-6V7DVVYL.js").then((m) => m.statsJobStatusCommand)
+  }
+});
+export {
+  statsCommand
+};
+//# sourceMappingURL=stats-3TAUG3Q3.js.map

package/dist/status-BJH7ODU4.js

@@ -0,0 +1,65 @@
+import {
+  failApi,
+  failValidation
+} from "./chunk-XBMZNFN7.js";
+import "./chunk-XXS6SUVM.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-BNO3EFGR.js";
+import {
+  apiPost
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import {
+  getEnv
+} from "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/status.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.status",
+  description: "Resolve one or more Work Action refs by real action ID or temp_* ref in a single batch call. When BAKER_CHAT_ID is set, a temp_* ref still staged in THIS chat resolves to status 'draft' (not 'not_found') \u2014 staged ops only become published actions on chat publish.",
+  args: {
+    ref: {
+      type: "positional",
+      description: "One or more action refs: real action IDs or temp_* refs (space-separated)",
+      required: true
+    }
+  }
+});
+var statusCommand = defineCommand({
+  meta: {
+    name: "status",
+    description: "Resolve Work Action refs by real ID or temp_* ref. Example: baker actions status temp_hero jx123"
+  },
+  args: {
+    ref: { type: "positional", description: "Action ID or temp_* ref; accepts multiple refs", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const refs = [args.ref, ...Array.isArray(args._) ? args._ : []].filter((ref) => typeof ref === "string").map((ref) => ref.trim()).filter(Boolean);
+      if (refs.length === 0) {
+        failValidation("At least one action ref is required.");
+      }
+      const { BAKER_CHAT_ID } = getEnv();
+      const body = BAKER_CHAT_ID ? { refs, chatId: BAKER_CHAT_ID } : { refs };
+      const response = await apiPost("/api/actions/status", body);
+      writeJson(response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  statusCommand
+};
+//# sourceMappingURL=status-BJH7ODU4.js.map

package/dist/sticker-SH6VUPFR.js

@@ -0,0 +1,102 @@
+import {
+  OUTPUT_ARGS,
+  writeProviderHits
+} from "./chunk-35FLLWSQ.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/sticker.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.sticker",
+  description: "Search Giphy stickers \u2014 transparent-background overlays for ad creative.",
+  args: {
+    query: { type: "string", description: "Search query (omit when --trending)", required: false },
+    trending: {
+      type: "boolean",
+      description: "Return the trending stickers feed instead of running a query",
+      required: false,
+      default: false
+    },
+    limit: { type: "number", description: "Max results (default 20, max 50)", required: false, default: 20 },
+    rating: {
+      type: "string",
+      description: "Content rating: g | pg | pg-13 | r (default pg)",
+      required: false
+    },
+    lang: { type: "string", description: "ISO 639-1 language code, e.g. en, es", required: false },
+    "auto-ingest": {
+      type: "number",
+      description: "Auto-ingest top N hits (default 0 \u2014 browse-style)",
+      required: false,
+      default: 0
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint applied to ingested stickers (overrides Giphy title/alt)",
+      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 }
+  }
+});
+var stickerCommand = defineCommand({
+  meta: {
+    name: "sticker",
+    description: "Search Giphy's sticker corpus \u2014 transparent-background WebPs / GIFs ideal for overlaying on ad creative (Meta, TikTok, Stories). Same Giphy free API as `baker images gif`; results carry WebP + GIF + MP4 URLs in providerMeta.\n\nExample: baker images sticker 'thumbs up' --limit 10\nExample: baker images sticker celebration --rating g --auto-ingest 3\nExample: baker images sticker --trending --limit 25"
+  },
+  args: {
+    query: { type: "positional", description: "Search query (omit with --trending)", required: false },
+    trending: { type: "boolean", description: "Trending feed", required: false },
+    limit: { type: "string", description: "Max results", required: false },
+    rating: { type: "string", description: "Content rating", required: false },
+    lang: { type: "string", description: "Language code", required: false },
+    "auto-ingest": { type: "string", description: "Auto-ingest top N", required: false },
+    context: { type: "string", description: "Description context hint applied to ingested stickers", required: false },
+    ...OUTPUT_ARGS
+  },
+  run: async ({ args }) => {
+    try {
+      const query = args.query;
+      const trending = args.trending === true;
+      if (!query && !trending) {
+        writeJson({
+          ok: false,
+          error: { code: "VALIDATION_ERROR", message: "Query is required unless --trending is set" }
+        });
+        process.exit(1);
+      }
+      const body = {};
+      if (query) body.query = query;
+      if (trending) body.trending = true;
+      if (args.limit) body.limit = Number(args.limit);
+      if (args.rating) body.rating = args.rating;
+      if (args.lang) body.lang = args.lang;
+      if (args["auto-ingest"]) body.autoIngest = Number(args["auto-ingest"]);
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/sticker", body);
+      writeProviderHits(data, data.hits, args, []);
+    } 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 {
+  stickerCommand
+};
+//# sourceMappingURL=sticker-SH6VUPFR.js.map

package/dist/sticker-SH6VUPFR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/sticker.ts"],"sourcesContent":["import type { ImagesGiphyRequest, ImagesStickerResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { OUTPUT_ARGS, writeProviderHits } from \"./providerHits.ts\";\n\nregisterSchema({\n  command: \"images.sticker\",\n  description: \"Search Giphy stickers — transparent-background overlays for ad creative.\",\n  args: {\n    query: { type: \"string\", description: \"Search query (omit when --trending)\", required: false },\n    trending: {\n      type: \"boolean\",\n      description: \"Return the trending stickers feed instead of running a query\",\n      required: false,\n      default: false,\n    },\n    limit: { type: \"number\", description: \"Max results (default 20, max 50)\", required: false, default: 20 },\n    rating: {\n      type: \"string\",\n      description: \"Content rating: g | pg | pg-13 | r (default pg)\",\n      required: false,\n    },\n    lang: { type: \"string\", description: \"ISO 639-1 language code, e.g. en, es\", required: false },\n    \"auto-ingest\": {\n      type: \"number\",\n      description: \"Auto-ingest top N hits (default 0 — browse-style)\",\n      required: false,\n      default: 0,\n    },\n    context: {\n      type: \"string\",\n      description: \"Free-text hint applied to ingested stickers (overrides Giphy title/alt)\",\n      required: false,\n    },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: { type: \"boolean\", description: \"Include full metadata\", required: false, default: false },\n  },\n});\n\nexport const stickerCommand = defineCommand({\n  meta: {\n    name: \"sticker\",\n    description:\n      \"Search Giphy's sticker corpus — transparent-background WebPs / GIFs ideal for overlaying on ad creative (Meta, TikTok, Stories). Same Giphy free API as `baker images gif`; results carry WebP + GIF + MP4 URLs in providerMeta.\\n\\nExample: baker images sticker 'thumbs up' --limit 10\\nExample: baker images sticker celebration --rating g --auto-ingest 3\\nExample: baker images sticker --trending --limit 25\",\n  },\n  args: {\n    query: { type: \"positional\", description: \"Search query (omit with --trending)\", required: false },\n    trending: { type: \"boolean\", description: \"Trending feed\", required: false },\n    limit: { type: \"string\", description: \"Max results\", required: false },\n    rating: { type: \"string\", description: \"Content rating\", required: false },\n    lang: { type: \"string\", description: \"Language code\", required: false },\n    \"auto-ingest\": { type: \"string\", description: \"Auto-ingest top N\", required: false },\n    context: { type: \"string\", description: \"Description context hint applied to ingested stickers\", required: false },\n    ...OUTPUT_ARGS,\n  },\n  run: async ({ args }) => {\n    try {\n      const query = args.query as string | undefined;\n      const trending = args.trending === true;\n      if (!query && !trending) {\n        writeJson({\n          ok: false,\n          error: { code: \"VALIDATION_ERROR\", message: \"Query is required unless --trending is set\" },\n        });\n        process.exit(1);\n      }\n      const body: ImagesGiphyRequest = {};\n      if (query) body.query = query;\n      if (trending) body.trending = true;\n      if (args.limit) body.limit = Number(args.limit);\n      if (args.rating) body.rating = args.rating as ImagesGiphyRequest[\"rating\"];\n      if (args.lang) body.lang = args.lang as string;\n      if (args[\"auto-ingest\"]) body.autoIngest = Number(args[\"auto-ingest\"]);\n      if (args.context) body.descriptionContext = args.context as string;\n\n      const data = await apiPost<ImagesStickerResponse>(\"/api/images/sticker\", body);\n      writeProviderHits(data, data.hits, args as Record<string, unknown>, []);\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/stock-IICCY3IQ.js

@@ -0,0 +1,187 @@
+import {
+  activeFilterFlags,
+  emptyResultHints
+} from "./chunk-Q6ULQMWG.js";
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  OUTPUT_ARGS,
+  writeProviderHits
+} from "./chunk-35FLLWSQ.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/stock.ts
+import { defineCommand } from "citty";
+var STOCK_ERROR_FIX = {
+  action: "use_different_resource",
+  explanation: "Switch provider instead of retrying stock search. Stock search is one of several image sources. Run `baker images find <query> --sources library,pinterest,google` (`--sources` is required \u2014 `find` alone searches the library only) or `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.stock",
+  description: "Stock search across the free libraries \u2014 Pexels photos plus Pixabay photos, illustrations and vectors. The previous provider's --license, --ai, --people and --order do not exist here: everything both libraries hold is free for commercial use with no attribution, neither indexes AI-generated content separately, neither has a people filter (name the person in the query instead), and both sort by relevance only.",
+  args: {
+    query: { type: "string", description: "Search query", required: true },
+    type: {
+      type: "string",
+      description: "Content type: photo (default, both libraries) | illustration | vector (Pixabay only)",
+      required: false,
+      enum: ["photo", "illustration", "vector"]
+    },
+    orientation: {
+      type: "string",
+      description: "landscape | portrait | square (square searches Pexels only \u2014 Pixabay has no square)",
+      required: false,
+      enum: ["landscape", "portrait", "square"]
+    },
+    size: {
+      type: "string",
+      description: "Minimum resolution: large (24MP) | medium (12MP) | small (4MP)",
+      required: false,
+      enum: ["large", "medium", "small"]
+    },
+    color: {
+      type: "string",
+      description: "Colour filter \u2014 a name (red, turquoise, black, \u2026) searches both libraries; a hex code such as '#0a0a0a' searches Pexels only",
+      required: false
+    },
+    locale: {
+      type: "string",
+      description: "Locale of the search terms, e.g. 'es-ES' or 'de-DE' \u2014 Pexels matches translated tags",
+      required: false
+    },
+    limit: { type: "number", description: "Max results (1-80, default 10)", required: false, default: 10 },
+    page: { type: "number", description: "Page number for pagination", required: false },
+    "auto-ingest": {
+      type: "number",
+      description: `Auto-ingest top N hits (0-${AUTO_INGEST_MAX.stock}, 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 the library's own alt text or tags)",
+      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 }
+  }
+});
+function buildStockRequest(query, args) {
+  const body = { query };
+  if (args.type) body.contentType = args.type;
+  if (args.orientation) body.orientation = args.orientation;
+  if (args.size) body.size = args.size;
+  if (args.color) body.color = args.color;
+  if (args.locale) body.locale = args.locale;
+  if (args.limit) body.limit = Number(args.limit);
+  if (args.page) body.page = Number(args.page);
+  if (args["auto-ingest"]) body.autoIngest = Number(args["auto-ingest"]);
+  if (args.context) body.descriptionContext = args.context;
+  return body;
+}
+function partialLibraryHints(errors, hitCount) {
+  if (!errors || errors.length === 0) return [];
+  const sources = errors.map((e) => e.source);
+  const names = sources.join(", ");
+  if (hitCount === 0) {
+    const failed = sources.length === 1 ? `${sources[0]} did not answer` : `none of ${names} answered`;
+    return [
+      `Stock search did not run \u2014 ${failed}. This is an outage, not an empty result: do not re-run it with a different query or flags, and report that stock search is unavailable. Source the asset another way (\`baker images find <query> --sources library,pinterest,google\`) or \`baker studio generate\`.`
+    ];
+  }
+  return [
+    `These results are partial: ${names} did not answer, so they come from the remaining library alone. Treat a thin result as unproven rather than as "stock does not have this", and report the outage rather than re-running the search.`
+  ];
+}
+var stockCommand = defineCommand({
+  meta: {
+    name: "stock",
+    description: "Stock search across the free libraries \u2014 Pexels photographs plus Pixabay photographs, illustrations and vectors. No per-request cost. With --auto-ingest, ingested hits return Baker-owned URLs.\n\nExamples:\n  baker images stock 'minimalist office'\n  baker images stock 'hero photo of a kitchen' --orientation landscape --size large\n  baker images stock 'flat office workers' --type illustration\n  baker images stock 'leaf outline mark' --type vector\n  baker images stock 'smiling carpenter portrait' --orientation portrait"
+  },
+  args: {
+    query: { type: "positional", description: "Search query", required: false },
+    type: { type: "string", description: "photo|illustration|vector", required: false },
+    orientation: { type: "string", description: "landscape|portrait|square", required: false },
+    size: { type: "string", description: "Minimum resolution: large|medium|small", required: false },
+    color: { type: "string", description: "Colour name or hex code", required: false },
+    locale: { type: "string", description: "Locale of the search terms, e.g. es-ES", required: false },
+    limit: { type: "string", description: "Max results (1-80)", required: false },
+    page: { type: "string", description: "Page number", required: false },
+    "auto-ingest": {
+      type: "string",
+      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.stock}) and return Baker-owned URLs on ingested hits`,
+      required: false
+    },
+    context: { type: "string", description: "Description context hint applied to auto-ingested hits", required: false },
+    ...OUTPUT_ARGS
+  },
+  run: async ({ args }) => {
+    try {
+      const query = args.query;
+      if (!query) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Query is required" } });
+        process.exit(1);
+      }
+      if (args["auto-ingest"] !== void 0) {
+        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.stock);
+        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.stock}.`
+              }
+            }
+          });
+          process.exit(1);
+        }
+      }
+      const data = await apiPost("/api/images/stock", buildStockRequest(query, args));
+      const outage = (data.errors?.length ?? 0) > 0 && data.hits.length === 0;
+      const hints = [
+        ...partialLibraryHints(data.errors, data.hits.length),
+        ...outage ? [] : emptyResultHints({
+          provider: "stock",
+          hitCount: data.hits.length,
+          activeFilters: activeFilterFlags(args, ["type", "orientation", "size", "color", "locale"])
+        })
+      ];
+      writeProviderHits(data, data.hits, args, hints);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({
+          ok: false,
+          error: {
+            code: err.code,
+            message: err.message,
+            fix: STOCK_ERROR_FIX
+          }
+        });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  partialLibraryHints,
+  stockCommand
+};
+//# sourceMappingURL=stock-IICCY3IQ.js.map

package/dist/stock-IICCY3IQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/stock.ts"],"sourcesContent":["import type { ImagesStockRequest, ImagesStockResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { AUTO_INGEST_MAX, parseAutoIngest } from \"./autoIngest.ts\";\nimport { OUTPUT_ARGS, writeProviderHits } from \"./providerHits.ts\";\nimport { activeFilterFlags, emptyResultHints } from \"./searchHints.ts\";\n\nconst STOCK_ERROR_FIX = {\n  action: \"use_different_resource\",\n  explanation:\n    \"Switch provider instead of retrying stock search. Stock search is one of several image sources. Run `baker images find <query> --sources library,pinterest,google` (`--sources` is required — `find` alone searches the library only) or `baker studio generate` to make the asset. Never sleep-and-retry this command — 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.\",\n};\n\nregisterSchema({\n  command: \"images.stock\",\n  description:\n    \"Stock search across the free libraries — Pexels photos plus Pixabay photos, illustrations and vectors. \" +\n    \"The previous provider's --license, --ai, --people and --order do not exist here: everything both libraries hold is free \" +\n    \"for commercial use with no attribution, neither indexes AI-generated content separately, neither has a people filter \" +\n    \"(name the person in the query instead), and both sort by relevance only.\",\n  args: {\n    query: { type: \"string\", description: \"Search query\", required: true },\n    type: {\n      type: \"string\",\n      description: \"Content type: photo (default, both libraries) | illustration | vector (Pixabay only)\",\n      required: false,\n      enum: [\"photo\", \"illustration\", \"vector\"],\n    },\n    orientation: {\n      type: \"string\",\n      description: \"landscape | portrait | square (square searches Pexels only — Pixabay has no square)\",\n      required: false,\n      enum: [\"landscape\", \"portrait\", \"square\"],\n    },\n    size: {\n      type: \"string\",\n      description: \"Minimum resolution: large (24MP) | medium (12MP) | small (4MP)\",\n      required: false,\n      enum: [\"large\", \"medium\", \"small\"],\n    },\n    color: {\n      type: \"string\",\n      description:\n        \"Colour filter — a name (red, turquoise, black, …) searches both libraries; a hex code such as '#0a0a0a' searches Pexels only\",\n      required: false,\n    },\n    locale: {\n      type: \"string\",\n      description: \"Locale of the search terms, e.g. 'es-ES' or 'de-DE' — Pexels matches translated tags\",\n      required: false,\n    },\n    limit: { type: \"number\", description: \"Max results (1-80, default 10)\", required: false, default: 10 },\n    page: { type: \"number\", description: \"Page number for pagination\", required: false },\n    \"auto-ingest\": {\n      type: \"number\",\n      description: `Auto-ingest top N hits (0-${AUTO_INGEST_MAX.stock}, default 0) and return Baker-owned URLs on ingested hits`,\n      required: false,\n      default: 0,\n    },\n    context: {\n      type: \"string\",\n      description: \"Free-text hint applied to every auto-ingested hit (overrides the library's own alt text or tags)\",\n      required: false,\n    },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: { type: \"boolean\", description: \"Include full metadata\", required: false, default: false },\n  },\n});\n\n/** Assemble the search request body from CLI args, applying only the flags that were provided. */\nfunction buildStockRequest(query: string, args: Record<string, unknown>): ImagesStockRequest {\n  const body: ImagesStockRequest = { query };\n  if (args.type) body.contentType = args.type as ImagesStockRequest[\"contentType\"];\n  if (args.orientation) body.orientation = args.orientation as ImagesStockRequest[\"orientation\"];\n  if (args.size) body.size = args.size as ImagesStockRequest[\"size\"];\n  if (args.color) body.color = args.color as string;\n  if (args.locale) body.locale = args.locale as string;\n  if (args.limit) body.limit = Number(args.limit);\n  if (args.page) body.page = Number(args.page);\n  if (args[\"auto-ingest\"]) body.autoIngest = Number(args[\"auto-ingest\"]);\n  if (args.context) body.descriptionContext = args.context as string;\n  return body;\n}\n\n/**\n * A stock search spans two libraries and returns what it got.\n *\n * The two failures read differently and steer differently. If one library fails\n * the other still answers, so a thin result looks like a complete one and has to\n * be marked unproven. If *both* fail nothing was searched at all — and the\n * earlier version of this said the hits \"come from the other library alone\",\n * which named a library that had also failed and told the agent to trust a list\n * that was empty for a reason it never learned.\n */\nexport function partialLibraryHints(errors: ImagesStockResponse[\"errors\"], hitCount: number): string[] {\n  if (!errors || errors.length === 0) return [];\n  const sources = errors.map((e) => e.source);\n  const names = sources.join(\", \");\n  if (hitCount === 0) {\n    const failed = sources.length === 1 ? `${sources[0]} did not answer` : `none of ${names} answered`;\n    return [\n      `Stock search did not run — ${failed}. This is an outage, not an empty result: do not re-run it with a different query or flags, and report that stock search is unavailable. Source the asset another way (\\`baker images find <query> --sources library,pinterest,google\\`) or \\`baker studio generate\\`.`,\n    ];\n  }\n  return [\n    `These results are partial: ${names} did not answer, so they come from the remaining library alone. Treat a thin result as unproven rather than as \"stock does not have this\", and report the outage rather than re-running the search.`,\n  ];\n}\n\nexport const stockCommand = defineCommand({\n  meta: {\n    name: \"stock\",\n    description:\n      \"Stock search across the free libraries — Pexels photographs plus Pixabay photographs, illustrations and vectors. No per-request cost. With --auto-ingest, ingested hits return Baker-owned URLs.\\n\\nExamples:\\n  baker images stock 'minimalist office'\\n  baker images stock 'hero photo of a kitchen' --orientation landscape --size large\\n  baker images stock 'flat office workers' --type illustration\\n  baker images stock 'leaf outline mark' --type vector\\n  baker images stock 'smiling carpenter portrait' --orientation portrait\",\n  },\n  args: {\n    query: { type: \"positional\", description: \"Search query\", required: false },\n    type: { type: \"string\", description: \"photo|illustration|vector\", required: false },\n    orientation: { type: \"string\", description: \"landscape|portrait|square\", required: false },\n    size: { type: \"string\", description: \"Minimum resolution: large|medium|small\", required: false },\n    color: { type: \"string\", description: \"Colour name or hex code\", required: false },\n    locale: { type: \"string\", description: \"Locale of the search terms, e.g. es-ES\", required: false },\n    limit: { type: \"string\", description: \"Max results (1-80)\", required: false },\n    page: { type: \"string\", description: \"Page number\", required: false },\n    \"auto-ingest\": {\n      type: \"string\",\n      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.stock}) and return Baker-owned URLs on ingested hits`,\n      required: false,\n    },\n    context: { type: \"string\", description: \"Description context hint applied to auto-ingested hits\", required: false },\n    ...OUTPUT_ARGS,\n  },\n  run: async ({ args }) => {\n    try {\n      const query = args.query as string | undefined;\n      if (!query) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"Query is required\" } });\n        process.exit(1);\n      }\n      if (args[\"auto-ingest\"] !== undefined) {\n        const parsed = parseAutoIngest(args[\"auto-ingest\"], AUTO_INGEST_MAX.stock);\n        if (!parsed.ok) {\n          writeJson({\n            ok: false,\n            error: {\n              code: \"VALIDATION_ERROR\",\n              message: parsed.message,\n              fix: {\n                action: \"retry_with_changes\",\n                explanation: `Re-run with --auto-ingest in 0-${AUTO_INGEST_MAX.stock}.`,\n              },\n            },\n          });\n          process.exit(1);\n        }\n      }\n      const data = await apiPost<ImagesStockResponse>(\"/api/images/stock\", buildStockRequest(query, args));\n      // When no library answered, the search never ran. The zero-hit steering\n      // below diagnoses an empty result — it would blame the filters for an\n      // outage and tell the agent to drop them and retry, which is the exact\n      // opposite of what the outage hint just told it to do.\n      const outage = (data.errors?.length ?? 0) > 0 && data.hits.length === 0;\n      const hints = [\n        ...partialLibraryHints(data.errors, data.hits.length),\n        ...(outage\n          ? []\n          : emptyResultHints({\n              provider: \"stock\",\n              hitCount: data.hits.length,\n              activeFilters: activeFilterFlags(args, [\"type\", \"orientation\", \"size\", \"color\", \"locale\"]),\n            })),\n      ];\n      writeProviderHits(data, data.hits, args as Record<string, unknown>, hints);\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({\n          ok: false,\n          error: {\n            code: err.code,\n            message: err.message,\n            fix: STOCK_ERROR_FIX,\n          },\n        });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":"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","names":[]}