@koda-sl/baker-cli 0.567.0 → 0.569.0-dev.1b455b3fe

package/dist/stock-RZH4SEGS.js

@@ -1,212 +0,0 @@
-import {
-  parseRequestFlags
-} from "./chunk-4N3Y5QWW.js";
-import {
-  AUTO_INGEST_MAX,
-  parseAutoIngest
-} from "./chunk-KKJ4KJCW.js";
-import {
-  activeFilterFlags,
-  emptyResultHints
-} from "./chunk-Q6ULQMWG.js";
-import {
-  OUTPUT_ARGS,
-  writeProviderHits
-} from "./chunk-KNA3OWJC.js";
-import "./chunk-I7OJZ7QE.js";
-import {
-  imagesStockRequestSchema
-} from "./chunk-LXOTNL65.js";
-import "./chunk-QV6AST5T.js";
-import "./chunk-WCU362Z6.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import "./chunk-R7XDGNZD.js";
-import "./chunk-XHWHBGKX.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-QEREDRZO.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-CCYZJMZ7.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 request = parseRequestFlags(imagesStockRequestSchema, buildStockRequest(query, args), {
-        contentType: "--type",
-        orientation: "--orientation",
-        size: "--size",
-        limit: "--limit",
-        page: "--page"
-      });
-      if (!request.ok) {
-        writeJson(request.envelope);
-        process.exit(1);
-      }
-      const data = await apiPost("/api/images/stock", request.data);
-      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-RZH4SEGS.js.map

package/dist/studies-5G67ODR2.js

@@ -1,250 +0,0 @@
-import {
-  adStudyFromWire,
-  cellObjects,
-  unixSeconds
-} from "./chunk-GDFJOCDO.js";
-import {
-  handleMetaError,
-  resolveAccountIdArg
-} from "./chunk-5H6N36LS.js";
-import "./chunk-QALAJNBG.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-RBCO3C3Q.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-GO6ISZUZ.js";
-import {
-  apiGet
-} from "./chunk-QEREDRZO.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import {
-  registerSchema
-} from "./chunk-CCYZJMZ7.js";
-import "./chunk-YQSBHWOI.js";
-
-// ../api/src/ads-meta/adStudyDescription.ts
-var MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
-function adStudyTime(seconds) {
-  const date = new Date(seconds * 1e3);
-  const hh = String(date.getUTCHours()).padStart(2, "0");
-  const mm = String(date.getUTCMinutes()).padStart(2, "0");
-  return `${date.getUTCDate()} ${MONTHS[date.getUTCMonth()]} ${date.getUTCFullYear()}, ${hh}:${mm} UTC`;
-}
-function daysLabel(seconds) {
-  const days = Math.round(seconds / 86400 * 10) / 10;
-  return `${days} ${days === 1 ? "day" : "days"}`;
-}
-function quoted(id, names) {
-  const name = names[id];
-  return name ? `"${name}"` : id;
-}
-function cellWords(cell, names) {
-  const [noun, ids] = cell.ads ? ["ad", cell.ads] : cell.adsets ? ["ad set", cell.adsets] : ["campaign", cell.campaigns ?? []];
-  const plural = ids.length > 1 ? `${noun}s` : noun;
-  const runs = ids.length > 0 ? ` (${plural} ${ids.map((id) => quoted(id, names)).join(", ")})` : "";
-  const share = cell.control_percentage === void 0 ? `${cell.treatment_percentage}%` : `${cell.treatment_percentage}% see the ads, ${cell.control_percentage}% held out`;
-  return `${cell.name}${runs} ${share}`;
-}
-var STUDY_KIND = {
-  SPLIT_TEST: "Split test",
-  LIFT: "Lift study",
-  SPLIT_TEST_V2: "Creative test"
-};
-function primaryObjective(objectives) {
-  if (!objectives || objectives.length === 0) {
-    return void 0;
-  }
-  return objectives.find((objective) => objective.is_primary === true) ?? objectives[0];
-}
-var SOURCE_NOUN = {
-  adspixels: "pixel",
-  applications: "app",
-  offsite_datasets: "dataset"
-};
-function sourceWords(objective, names) {
-  const words = [];
-  for (const key of ["adspixels", "applications", "offsite_datasets"]) {
-    for (const source of objective[key] ?? []) {
-      const events = source.event_names?.join(" or ") ?? "any event";
-      words.push(`${events} on ${SOURCE_NOUN[key]} ${quoted(source.id, names)}`);
-    }
-  }
-  for (const source of objective.customconversions ?? []) {
-    words.push(`custom conversion ${quoted(source.id, names)}`);
-  }
-  return words;
-}
-function measuringWords(objectives, names) {
-  const primary = primaryObjective(objectives);
-  if (!primary) {
-    return "cost per result on the campaigns' objective";
-  }
-  const sources = sourceWords(primary, names);
-  return `cost per "${primary.name}"${sources.length > 0 ? ` (${sources.join(", ")})` : ""}`;
-}
-function measuringPhrase(type, primary, measuring) {
-  if (type === "LIFT") return `measuring the lift in ${primary ? `"${primary.name}"` : "results"}`;
-  return `measuring ${primary ? `cost per "${primary.name}"` : measuring}`;
-}
-function describeAdStudy(study, { names = {} } = {}) {
-  const versions = study.cells && study.cells.length > 0 ? study.cells.map((cell) => cellWords(cell, names)).join(" vs ") : void 0;
-  const measuring = measuringWords(study.objectives, names);
-  const primary = primaryObjective(study.objectives);
-  const others = (study.objectives ?? []).filter((objective) => objective !== primary);
-  const alsoMeasured = others.length > 0 ? others.map((objective) => `"${objective.name}"`).join(", ") : void 0;
-  const hasSchedule = study.start_time !== void 0 && study.end_time !== void 0;
-  const length = hasSchedule ? daysLabel((study.end_time ?? 0) - (study.start_time ?? 0)) : void 0;
-  const schedule = hasSchedule ? `${adStudyTime(study.start_time ?? 0)} \u2192 ${adStudyTime(study.end_time ?? 0)} \xB7 ${length}` : void 0;
-  const confidence = study.confidence_level !== void 0 ? `${Math.round(study.confidence_level * 100)}%` : void 0;
-  const parts = [
-    versions,
-    measuringPhrase(study.type, primary, measuring),
-    length,
-    confidence ? `${confidence} confidence` : void 0
-  ].filter((part) => part !== void 0);
-  const kind = STUDY_KIND[study.type ?? "SPLIT_TEST"] ?? "Split test";
-  return { sentence: `${kind}: ${parts.join(", ")}`, versions, measuring, alsoMeasured, schedule, confidence };
-}
-
-// src/commands/ads/meta/studies.ts
-import { defineCommand } from "citty";
-function studyState(row, nowSeconds) {
-  if (row.canceled_time) return "cancelled";
-  const start = unixSeconds(row.start_time) ?? 0;
-  const end = unixSeconds(row.end_time) ?? Number.POSITIVE_INFINITY;
-  if (nowSeconds < start) return "scheduled";
-  return nowSeconds < end ? "running" : "ended";
-}
-function compactStudy(row, nowSeconds) {
-  const study = adStudyFromWire(row);
-  const words = describeAdStudy(study, { names: study.names });
-  return {
-    id: study.id,
-    name: study.name,
-    state: studyState(row, nowSeconds),
-    compares: words.versions,
-    ...study.start_time !== void 0 ? { starts: adStudyTime(study.start_time) } : {},
-    ...study.end_time !== void 0 ? { ends: adStudyTime(study.end_time) } : {},
-    ...row.results_first_available_date ? { results_from: row.results_first_available_date } : {}
-  };
-}
-function studyDetail(row, nowSeconds) {
-  const study = adStudyFromWire(row);
-  const measures = (row.objectives?.data ?? []).map((objective) => ({
-    id: objective.id,
-    name: objective.name,
-    primary: objective.is_primary === true,
-    ...objective.results !== void 0 ? { results: objective.results } : {}
-  }));
-  return {
-    ...compactStudy(row, nowSeconds),
-    ...study.description ? { description: study.description } : {},
-    versions: study.cells.map((cell) => ({
-      cell_id: cell.id,
-      name: cell.name,
-      share: `${cell.treatment_percentage}%`,
-      runs: cellObjects(cell).map((id) => ({ id, name: study.names[id] })),
-      level: cell.ads ? "ad" : cell.adsets ? "ad set" : "campaign"
-    })),
-    measures
-  };
-}
-function studyHints(detail) {
-  const state = detail.state;
-  if (state === "scheduled") {
-    return [
-      "Not started: it can still be re-timed, re-split (`studies update --split <cell_id>=60 \u2026`) or deleted. Results appear once it runs."
-    ];
-  }
-  const measures = detail.measures ?? [];
-  const hasResults = measures.some((measure) => measure.results !== void 0);
-  return [
-    hasResults ? "Meta's verdict is in each measure's results, with its confidence. Report a winner only when Meta names one at the test's confidence level; otherwise say the versions performed alike." : "No results yet \u2014 Meta publishes them once the test has gathered enough. Compare per-version delivery meanwhile with `baker ads meta insights --object <ad set or campaign id>`, and do not call a winner from it.",
-    state === "running" ? "Running: its split and start are fixed; it can be renamed, its end moved, ended now (`studies end`) or deleted (results and all)." : "Over. Read the per-version numbers with `baker ads meta insights --object <id>` for the period it ran."
-  ];
-}
-registerSchema({
-  command: "ads.meta.studies",
-  description: "Meta A/B tests (ad studies) whose versions run in an ad account \u2014 what each compares, when it runs and its state (scheduled, running, ended). --study-id reads one: every version with its cell id and share, and each measure with Meta's results. --business-id lists every test on a Business. Stage new ones with `studies create`.",
-  args: {
-    "account-id": { type: "string", description: "Meta ad account ID (act_123)", required: false },
-    "business-id": { type: "string", description: "List every test on this Business instead", required: false },
-    "study-id": { type: "string", description: "One test: its versions and results", required: false },
-    full: { type: "boolean", description: "The tests as Meta returns them", required: false },
-    "no-cache": { type: "boolean", description: "Bypass the cache", required: false }
-  }
-});
-var listArgs = {
-  "account-id": { type: "string", description: "Meta ad account ID" },
-  "business-id": { type: "string", description: "List every test on this Business instead" },
-  "study-id": { type: "string", description: "Read one test: versions, cell ids, results" },
-  full: { type: "boolean", description: "The tests as Meta returns them" },
-  "no-cache": NO_CACHE_ARG
-};
-async function read(path, params, noCache) {
-  if (noCache) params["skip-cache"] = "true";
-  return await apiGet(path, params);
-}
-var listCommand = defineCommand({
-  meta: {
-    name: "list",
-    description: "List A/B tests. Runs by default. Example: baker ads meta studies --account-id act_123 \xB7 one test: baker ads meta studies --study-id 6123"
-  },
-  args: listArgs,
-  run: async ({ args }) => {
-    const now = Math.floor(Date.now() / 1e3);
-    try {
-      if (args["study-id"]) {
-        const row = await read(
-          "/api/ads/meta/study-results",
-          { "study-id": String(args["study-id"]) },
-          args["no-cache"]
-        );
-        const detail = studyDetail(row, now);
-        writeJsonEnvelope({ ok: true, data: args.full ? row : detail, hints: studyHints(detail) });
-        return;
-      }
-      const params = args["business-id"] ? { "business-id": String(args["business-id"]) } : { "account-id": await resolveAccountIdArg(args) };
-      const rows = await read("/api/ads/meta/studies", params, args["no-cache"]);
-      const hints = rows.length === 0 ? [
-        "No A/B tests. To set one up: duplicate the ad set (`adsets duplicate`), change ONE thing on the copy, then `studies create --adsets <original>,<copy>`."
-      ] : ["`studies --study-id <id>` reads one test's versions and results."];
-      writeJsonEnvelope({ ok: true, data: args.full ? rows : rows.map((row) => compactStudy(row, now)), hints });
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-var studiesCommand = defineCommand({
-  meta: {
-    name: "studies",
-    description: `Meta A/B tests (ad studies): Meta splits one audience between versions \u2014 ad sets or campaigns \u2014 so each person sees one, and calls the winner.
-Not Baker's own page experiments (\`baker experiment\`), which test landing pages.
-
-Examples:
-  baker ads meta studies --account-id act_123                    # tests on this account and their state
-  baker ads meta studies --study-id 6123                          # versions, cell ids, Meta's results
-  baker ads meta studies create --name "Broad vs lookalike" --adsets 6123,6124 --start 2026-10-20T08:00Z --days 14 --confidence 90
-  baker ads meta studies update 6123 --end 2026-11-10T08:00Z
-  baker ads meta studies end 6123 | delete 6123`
-  },
-  subCommands: {
-    list: listCommand,
-    create: () => import("./study-writes-34BJFZAZ.js").then((m) => m.studiesCreateCommand),
-    update: () => import("./study-writes-34BJFZAZ.js").then((m) => m.studiesUpdateCommand),
-    end: () => import("./study-writes-34BJFZAZ.js").then((m) => m.studiesEndCommand),
-    delete: () => import("./study-writes-34BJFZAZ.js").then((m) => m.studiesDeleteCommand)
-  },
-  args: listArgs,
-  default: "list"
-});
-export {
-  compactStudy,
-  studiesCommand,
-  studyDetail,
-  studyHints,
-  studyState
-};
-//# sourceMappingURL=studies-5G67ODR2.js.map

package/dist/studio-D2OMFCZZ.js

@@ -1,49 +0,0 @@
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/studio/index.ts
-import { defineCommand } from "citty";
-var studioCommand = defineCommand({
-  meta: {
-    name: "studio",
-    description: `Make new imagery and clips. Every batch is recorded and shows up in the dashboard Studio for the client to review, labelled with this conversation.
-
-Make something:
-  baker studio generate <prompt> [--reference ids,paths,urls] [--model \u2026] [--aspect-ratio \u2026] [--count N]
-                                        Render 1-8 takes of one still; each is ingested into the media library as it lands
-  baker studio animate <prompt> --image <id|path|url,\u2026>
-                                        Turn a still into a clip \u2014 the prompt describes MOVEMENT, not the look
-  baker studio skills                   Craft directions you can pass to --skill
-  baker studio improve <prompt>         Sharpen a rough brief (use it for the CLIENT's words, not your own)
-
-Know what you can ask for:
-  baker studio models [--kind video] [--model <id>]
-                                        Per model: shapes, resolutions, clip lengths, prompt cap, reference limit, every knob
-
-Review and pick:
-  baker studio get <generationId>       One batch: every take, its url, whether it is in the library, why one failed
-  baker studio list [--kind image|video] [--all]
-                                        Recent batches for this conversation (--all = the whole company)
-  baker studio keep <generationId> --slot N
-                                        Mark the keeper. Stars an image; INGESTS a clip into the video library
-
-Three rules worth remembering:
-  - --reference is the biggest quality lever there is. Ground a render in a real logo, product shot or mood image.
-  - A clip is not usable anywhere until it is kept. Unkept takes are never ingested.
-  - The models disagree about what they accept, and a setting the chosen model does not have is REFUSED rather than ignored. Run baker studio models to answer "can this one do that".
-Full guide: __tooling__/docs/tools/baker/studio.md`
-  },
-  subCommands: {
-    generate: () => import("./generate-VGGXTZBP.js").then((m) => m.generateCommand),
-    animate: () => import("./animate-WS63CZ3Y.js").then((m) => m.animateCommand),
-    get: () => import("./get-42V7UTNF.js").then((m) => m.getCommand),
-    list: () => import("./list-BQWHFEWY.js").then((m) => m.listCommand),
-    keep: () => import("./keep-I6FLGJH4.js").then((m) => m.keepCommand),
-    models: () => import("./models-SITHUNAA.js").then((m) => m.modelsCommand),
-    skills: () => import("./skills-PDHUHP2T.js").then((m) => m.skillsCommand),
-    improve: () => import("./improve-NWFQI63B.js").then((m) => m.improveCommand)
-  }
-});
-export {
-  studioCommand
-};
-//# sourceMappingURL=studio-D2OMFCZZ.js.map