@koda-sl/baker-cli 0.468.0 → 0.469.0

package/dist/chunk-NGYBZYXK.js

@@ -1,363 +0,0 @@
-import {
-  MAX_VIDEO_INGEST_BYTES,
-  MAX_VIDEO_INGEST_SECONDS,
-  directDedupeKey,
-  downloadTimeoutMs,
-  isDirectMediaUrl,
-  isDrmProtected,
-  isRegionBlocked,
-  isToolingOrBlockFailure,
-  refuseByDuration,
-  resolveIngestSource,
-  worthDownloadingInstead
-} from "./chunk-FKOECEVC.js";
-import {
-  YtDlpError,
-  canonicalUrl,
-  durationSeconds,
-  isAudioOnly,
-  isVimeoAuthFailure,
-  probeYtDlp,
-  runYtDlp,
-  ytDlpBlockSignal
-} from "./chunk-BJEW3LST.js";
-import {
-  videosIngestRequestSchema
-} from "./chunk-WXC3I4CT.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-MMOTJIV6.js";
-import {
-  captureVimeoCookie,
-  isProxyFailure
-} from "./chunk-YPCVPDU7.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-D3RTGIT4.js";
-
-// src/commands/videos/ingest.ts
-import { mkdtemp, rm, stat } from "fs/promises";
-import { tmpdir } from "os";
-import path from "path";
-import { defineCommand } from "citty";
-
-// src/lib/streamUpload.ts
-import { createHash } from "crypto";
-import { createReadStream } from "fs";
-import { Readable } from "stream";
-import { pipeline } from "stream/promises";
-async function hashFile(filePath) {
-  const hash = createHash("sha256");
-  await pipeline(createReadStream(filePath), hash);
-  return hash.digest("hex");
-}
-async function putFileStreamed(args) {
-  const body = Readable.toWeb(createReadStream(args.filePath));
-  return await fetch(args.putUrl, {
-    method: "PUT",
-    body,
-    headers: {
-      "Content-Type": args.contentType,
-      "Content-Length": String(args.sizeBytes)
-    },
-    duplex: "half"
-  });
-}
-
-// src/commands/videos/ingest.ts
-registerSchema({
-  command: "videos.ingest",
-  description: "Add a video to the library from a URL \u2014 a direct file, or a YouTube/TikTok/Vimeo page.",
-  args: {
-    url: { type: "string", description: "Video URL (direct file or a watch/post page)", required: true },
-    source: { type: "string", description: "Provenance: url | youtube", required: false },
-    "external-id": { type: "string", description: "Provider asset id (deduped on)", required: false },
-    "external-url": { type: "string", description: "Canonical page URL", required: false },
-    download: {
-      type: "boolean",
-      description: "Force the download path instead of letting Baker fetch the URL directly",
-      required: false,
-      default: false
-    },
-    country: {
-      type: "string",
-      description: "Two-letter country to fetch from (e.g. US, DE, JP) \u2014 use when a video is blocked in your region",
-      required: false
-    },
-    context: {
-      type: "string",
-      description: "What you know that the video cannot show \u2014 the campaign, whether the person on camera is a real customer, what it is for. Highest-leverage flag here: it is what makes the clip findable later.",
-      required: false
-    },
-    "dry-run": { type: "boolean", description: "Preview the operation without executing", required: false }
-  }
-});
-var ingestCommand = defineCommand({
-  meta: {
-    name: "ingest",
-    description: "Add a video to the library from a URL. A direct file URL is handed straight to Baker, which fetches it. A page URL (YouTube, TikTok, Vimeo, Instagram) is downloaded here first, then uploaded \u2014 and a direct URL that Baker cannot fetch falls back to that same path automatically.\n\nExample: baker videos ingest https://www.youtube.com/watch?v=abc123"
-  },
-  args: {
-    url: { type: "positional", description: "Video URL", required: false },
-    source: { type: "string", description: "Provenance: url | youtube", required: false },
-    "external-id": { type: "string", description: "Provider asset id", required: false },
-    "external-url": { type: "string", description: "Canonical page URL", required: false },
-    download: { type: "boolean", description: "Force the download path", required: false, default: false },
-    country: { type: "string", description: "Two-letter country to fetch from, e.g. US", required: false },
-    context: {
-      type: "string",
-      description: "Context for the analysis \u2014 campaign, who is on camera, intended use",
-      required: false
-    },
-    "dry-run": { type: "boolean", description: "Preview without executing", required: false, default: false }
-  },
-  run: ({ args }) => runVideoIngest({
-    url: args.url,
-    source: args.source,
-    externalId: args["external-id"],
-    externalUrl: args["external-url"],
-    forceDownload: args.download === true,
-    country: args.country,
-    context: args.context,
-    dryRun: args["dry-run"] === true
-  })
-});
-async function runVideoIngest(opts) {
-  const url = opts.url;
-  if (!url) {
-    writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "URL is required" } });
-    process.exit(1);
-  }
-  const direct = !opts.forceDownload && isDirectMediaUrl(url);
-  const country = opts.country?.trim() || void 0;
-  const args = {
-    url,
-    source: resolveIngestSource(opts.source, url),
-    externalId: opts.externalId,
-    // Deliberately NOT pre-filled with the pasted URL. Doing so shadowed the
-    // canonical URL the probe resolves (`?? canonicalUrl(...)` below could never
-    // run), so the same video filed under a different `externalUrl` depending on
-    // whether the link was copied from a share sheet, a shorts page or the
-    // address bar. `downloadThenIngest` falls back to `args.url` when the probe
-    // resolves nothing, which is the value this used to hard-code.
-    externalUrl: opts.externalUrl,
-    descriptionContext: opts.context?.trim() || void 0
-  };
-  const validation = videosIngestRequestSchema.safeParse({ ...args, url });
-  if (!validation.success) {
-    const problem = validation.error.issues[0];
-    writeJson({
-      ok: false,
-      error: {
-        code: "VALIDATION_ERROR",
-        message: problem ? `${problem.path.join(".") || "request"}: ${problem.message}` : "Invalid request"
-      }
-    });
-    process.exit(1);
-  }
-  if (opts.dryRun) {
-    reportDryRun(args, direct, country);
-    return;
-  }
-  try {
-    const data = await ingestByRoute(args, direct, country);
-    writeJson({ ok: true, data, hints: ingestHints(data) });
-  } catch (err) {
-    reportIngestFailure(err);
-  }
-}
-function ingestHints(data) {
-  if (data.reducedQuality !== true) return void 0;
-  return [
-    "Added, but at standard quality (360p): the site refused to release the full-quality file and this was the best it would hand over. Tell the user \u2014 the clip is in the library and usable, it is just not high-resolution. If they need the crisp version, ask them for the original file and use `baker videos upload <file>`."
-  ];
-}
-function reportDryRun(args, direct, country) {
-  writeJson({
-    ok: true,
-    dryRun: true,
-    operation: "videos.ingest",
-    params: {
-      url: args.url,
-      source: args.source,
-      // Known up front on the direct route, because it is derived from the URL
-      // alone. The download route's key comes from the probe, which a dry run
-      // does not perform, so there it stays null rather than becoming a guess.
-      externalId: args.externalId ?? (direct ? directDedupeKey(args.source, args.url) : null),
-      // A page URL's canonical form is only known after the probe, which a dry
-      // run does not perform — so this is null rather than a guess.
-      externalUrl: args.externalUrl ?? null,
-      direct,
-      country: country ?? null,
-      descriptionContext: args.descriptionContext ?? null
-    }
-  });
-}
-async function ingestByRoute(args, direct, country) {
-  if (!direct) {
-    return { ...await downloadThenIngest(args, country), via: "download" };
-  }
-  try {
-    const externalId = args.externalId ?? directDedupeKey(args.source, args.url);
-    return { ...await ingestUrl({ ...args, externalId }), via: "direct" };
-  } catch (err) {
-    if (!(err instanceof ApiError) || !worthDownloadingInstead(err.code)) throw err;
-    return { ...await downloadThenIngest(args, country), via: "download", fallbackFrom: err.message };
-  }
-}
-function reportYtDlpFailure(err) {
-  const detail = `${err.stderrTail} ${err.message}`;
-  if (isProxyFailure(ytDlpBlockSignal(detail))) {
-    fail(
-      "Couldn't download that video: our connection to the internet was refused.",
-      "This is Baker's egress proxy, not the link \u2014 its credentials look wrong or expired. The link is probably fine. Report it; retrying won't help until the proxy is fixed."
-    );
-  }
-  if (isDrmProtected(detail)) {
-    fail(
-      "That video is copy-protected, so it can't be added to the library.",
-      "The publisher encrypted this one against downloading. Nothing will change that \u2014 not retrying, not a different region. Ask whoever owns the video for the original file and add it with `baker videos upload <file>`."
-    );
-  }
-  if (isVimeoAuthFailure(detail)) {
-    fail(
-      "Vimeo wouldn't hand over that video \u2014 Baker isn't signed in to Vimeo.",
-      "Vimeo now refuses anonymous downloads entirely, so this needs a signed-in session and the one Baker holds has either expired or was never set. Nothing is wrong with the link. Report it so the Vimeo cookie can be refreshed; meanwhile download the file and use `baker videos upload <file>`."
-    );
-  }
-  if (isRegionBlocked(detail)) {
-    fail(
-      `That video isn't available in the region we're fetching from. ${err.stderrTail || err.message}`,
-      "Re-run with `--country <two-letter code>` for a country where the video plays \u2014 e.g. `--country US`. Pick the one the video belongs to (the uploader's country is the usual answer); each attempt costs a paid connection, so choose rather than work through the list."
-    );
-  }
-  fail(
-    `Couldn't download that video. ${err.stderrTail || err.message}`,
-    isToolingOrBlockFailure(detail) ? "The site wouldn't hand over the video \u2014 usually the downloader being out of date against a site that changed, or the request being blocked. Retrying won't help, and the link is probably fine. Report it so the tool can be updated; meanwhile download the file and use `baker videos upload <file>`." : "Check the link is public and playable. Private or age-restricted videos can't be downloaded \u2014 download the file yourself and use `baker videos upload <file>`."
-  );
-}
-function fail(message, fix, code = "INGEST_FAILED") {
-  writeJson({ ok: false, error: { code, message, fix } });
-  process.exit(1);
-}
-function reportIngestFailure(err) {
-  if (err instanceof ApiError) {
-    writeJson({ ok: false, error: { code: err.code, message: err.message } });
-    process.exit(1);
-  }
-  if (err instanceof YtDlpError) reportYtDlpFailure(err);
-  const detail = err instanceof Error ? err.message : String(err);
-  if (detail.includes("timed out after")) {
-    fail(
-      "That video took too long to download and was stopped part-way.",
-      "Long or slow-serving videos can outrun the download window. Try a shorter clip, or download this one yourself and use `baker videos upload <file>`.",
-      "INTERNAL_ERROR"
-    );
-  }
-  fail(
-    `Couldn't add that video. ${detail}`,
-    "This is a fault on Baker's side, not a problem with the link. Report it.",
-    "INTERNAL_ERROR"
-  );
-}
-function dedupeKey(args, info) {
-  const id = typeof info.id === "string" ? info.id : void 0;
-  if (!id) return void 0;
-  if (info.extractor === "generic") return `${args.source}:${canonicalUrl(info) ?? args.url}`;
-  return `${args.source}:${id}`;
-}
-function ingestUrl(args) {
-  const body = {
-    url: args.url,
-    source: args.source
-  };
-  if (args.externalId) body.externalId = args.externalId;
-  if (args.externalUrl) body.externalUrl = args.externalUrl;
-  if (args.descriptionContext) body.descriptionContext = args.descriptionContext;
-  return apiPost("/api/videos/ingest", body);
-}
-async function downloadThenIngest(args, country) {
-  const vimeoCookie = captureVimeoCookie();
-  const workDir = await mkdtemp(path.join(tmpdir(), "videos-ingest-"));
-  try {
-    const probe = await probeYtDlp({ url: args.url, country, vimeoCookie, cookieDir: workDir });
-    if (isAudioOnly(probe.info)) {
-      throw new ApiError(
-        "VALIDATION_ERROR",
-        "That link is audio, not video, so it can't go in the video library. Music and podcast links have no picture to store."
-      );
-    }
-    const tooLong = refuseByDuration(durationSeconds(probe.info), MAX_VIDEO_INGEST_SECONDS);
-    if (tooLong) {
-      throw new ApiError("VALIDATION_ERROR", tooLong);
-    }
-    const externalId = args.externalId ?? dedupeKey(args, probe.info);
-    const { filePath, tier, reducedQuality } = await runYtDlp({
-      url: args.url,
-      audioOnly: false,
-      workDir,
-      // Deliberately uncapped: take the best the site will release and let Mux
-      // decide what to serve. The 1080p ceiling this replaces was reasoning
-      // about the wrong cost — it saved download bytes by throwing away source
-      // pixels *before* the one system that can make renditions from them ever
-      // saw them, so a 4K master became a 1080p master permanently, for
-      // everything the library is ever asked to do with that clip afterwards.
-      // Downscaling is Mux's job and it is cheap; re-acquiring a master is not.
-      country,
-      vimeoCookie,
-      // Budgeted from the probed length, so the duration we accept and the time
-      // we allow to fetch it cannot drift apart.
-      timeoutMs: downloadTimeoutMs(durationSeconds(probe.info))
-    });
-    const stats = await stat(filePath);
-    if (stats.size > MAX_VIDEO_INGEST_BYTES) {
-      throw new ApiError(
-        "VALIDATION_ERROR",
-        `That video is ${(stats.size / 1024 ** 3).toFixed(1)} GB, over the ${Math.round(MAX_VIDEO_INGEST_BYTES / 1024 ** 3)} GB limit for this route.`
-      );
-    }
-    const publicUrl = await uploadToAssetStore(filePath, stats.size);
-    return {
-      ...await ingestUrl({
-        ...args,
-        url: publicUrl,
-        externalId,
-        externalUrl: args.externalUrl ?? canonicalUrl(probe.info) ?? args.url
-      }),
-      egress: tier,
-      // Named in the result for the same reason `egress` is: a geo-targeted exit
-      // is a deliberate, billable choice and must not be invisible afterwards.
-      ...country ? { country } : {},
-      // Third member of the same family. The site refused the good formats and
-      // the download quietly took the one it would release, which is the right
-      // call — but a clip that is 360p because of that must say so here, or the
-      // only way to find out is to watch it.
-      ...reducedQuality ? { reducedQuality: true } : {}
-    };
-  } finally {
-    await rm(workDir, { recursive: true, force: true }).catch(() => {
-    });
-  }
-}
-async function uploadToAssetStore(filePath, sizeBytes) {
-  const sha256 = await hashFile(filePath);
-  const { putUrl, publicUrl } = await apiPost("/api/canvas/assets/presign", {
-    sha256,
-    mime: "video/mp4",
-    purpose: "source"
-  });
-  const putRes = await putFileStreamed({ putUrl, filePath, contentType: "video/mp4", sizeBytes });
-  if (!putRes.ok) {
-    throw new ApiError("INTERNAL_ERROR", `Storing the downloaded video failed: HTTP ${putRes.status}`);
-  }
-  return publicUrl;
-}
-
-export {
-  ingestCommand,
-  runVideoIngest,
-  ingestHints
-};
-//# sourceMappingURL=chunk-NGYBZYXK.js.map

package/dist/chunk-NIGGMK7L.js

@@ -1,125 +0,0 @@
-import {
-  apiGet
-} from "./chunk-MMOTJIV6.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-NIGGMK7L.js.map

package/dist/chunk-P72PL3UG.js

@@ -1,23 +0,0 @@
-import {
-  creativesRunResponseSchema
-} from "./chunk-WXC3I4CT.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-MMOTJIV6.js";
-
-// src/commands/canvas/run-history.ts
-async function fetchRunRecord(runId, post = apiPost) {
-  try {
-    const response = await post("/api/creatives/run", { runId });
-    return creativesRunResponseSchema.parse(response).data;
-  } catch (e) {
-    if (e instanceof ApiError && e.code === "NOT_FOUND") return null;
-    throw e;
-  }
-}
-
-export {
-  fetchRunRecord
-};
-//# sourceMappingURL=chunk-P72PL3UG.js.map

package/dist/chunk-PC56KVAD.js

@@ -1,74 +0,0 @@
-import {
-  cacheGet,
-  cacheSet,
-  handleConnectionError,
-  needsConnectionFix,
-  writeJsonEnvelope
-} from "./chunk-6SL6463H.js";
-import {
-  ApiError,
-  apiGet
-} from "./chunk-MMOTJIV6.js";
-import {
-  getEnv
-} from "./chunk-YPCVPDU7.js";
-
-// src/commands/ga4/resolve.ts
-async function fetchProperties(useCache = true) {
-  if (useCache) {
-    const cached = cacheGet("ga4-properties", "list");
-    if (cached) return cached.data;
-  }
-  const params = !useCache ? { "skip-cache": "true" } : void 0;
-  const data = await apiGet("/api/ga4/properties", params);
-  if (useCache) {
-    cacheSet("ga4-properties", "list", data, 60 * 60 * 1e3);
-  }
-  return data;
-}
-async function resolvePropertyId(args) {
-  const fromArgs = args["property-id"];
-  const fromEnv = getEnv().BAKER_GA4_PROPERTY_ID;
-  const propertyId = fromArgs || fromEnv;
-  if (propertyId) return propertyId;
-  const useCache = !args["no-cache"];
-  try {
-    const properties = await fetchProperties(useCache);
-    const [single] = properties;
-    if (properties.length === 1 && single) {
-      process.stderr.write(`Using property "${single.name}" (${single.externalId})
-`);
-      return single.externalId;
-    }
-    if (properties.length === 0) {
-      handleConnectionError("ga4");
-    }
-    const list = properties.map((p) => `  ${p.externalId}  ${p.name}`).join("\n");
-    writeJsonEnvelope({
-      ok: false,
-      error: {
-        code: "MULTIPLE_PROPERTIES",
-        message: `Multiple properties found. Pass --property-id or set BAKER_GA4_PROPERTY_ID:
-${list}`
-      }
-    });
-    process.exit(1);
-  } catch (err) {
-    if (err instanceof ApiError && needsConnectionFix(err.code, err.message)) {
-      handleConnectionError("ga4", err.message);
-    }
-    writeJsonEnvelope({
-      ok: false,
-      error: {
-        code: "RESOLUTION_ERROR",
-        message: "Could not auto-detect property. Pass --property-id or set BAKER_GA4_PROPERTY_ID."
-      }
-    });
-    process.exit(1);
-  }
-}
-
-export {
-  resolvePropertyId
-};
-//# sourceMappingURL=chunk-PC56KVAD.js.map