@koda-sl/baker-cli 0.464.0 → 0.466.0

package/dist/chunk-OON5SC7P.js

@@ -0,0 +1,94 @@
+import {
+  ApiError
+} from "./chunk-P5NYZ236.js";
+import {
+  writeJson
+} from "./chunk-MEBOQXW3.js";
+
+// src/commands/landing/inspiration/shared.ts
+var INSPIRATION_HINTS = {
+  adapt: "Reference only. Re-express this in the client's BRAND.md palette, type and imagery register. Reusing a headline, subhead or CTA verbatim is a Tier 0 message-match failure (references/gotchas.md).",
+  structureNotCopy: "Take the structural decision, not the furniture: what the eye hits first, the grid ratio, what was deliberately left out. Your copy must come from the client's own offer."
+};
+function favoritesScopeHints(health, resultCount) {
+  if (!health) return [];
+  const hints = [];
+  if (health.savedPages === 0) {
+    hints.push(
+      "This company hasn't saved any reference pages yet, so there is no taste profile to search \u2014 an empty result here says nothing about the library. Search the whole shared library with --scope all, or save a page the client admires with `baker landing inspiration add <url>`."
+    );
+    return hints;
+  }
+  if (health.failedPages > 0) {
+    const retryable = health.failedExamples.filter((example) => example.retryable).map((example) => example.url);
+    const permanent = health.failedExamples.filter((example) => !example.retryable).map((example) => example.url);
+    hints.push(
+      `${health.failedPages} of this company's ${health.savedPages} saved pages could not be read, so they hold no sections \u2014 only ${health.usablePages} are usable, which is why this result is thin. Search the whole library with --scope all.`
+    );
+    if (retryable.length > 0) {
+      hints.push(
+        `Worth another go: ${retryable.join(", ")} \u2014 run \`baker landing inspiration add <url>\` on one of them to study it again.`
+      );
+    }
+    if (permanent.length > 0) {
+      hints.push(`Not worth retrying \u2014 these sites refuse automated readers: ${permanent.join(", ")}.`);
+    }
+  }
+  if (health.studyingPages > 0) {
+    hints.push(
+      `${health.studyingPages} saved ${health.studyingPages === 1 ? "page is" : "pages are"} still being studied and will be searchable in a few minutes. Carry on; do not wait on them.`
+    );
+  }
+  if (resultCount === 0 && health.failedPages === 0 && health.studyingPages === 0) {
+    hints.push(
+      `Nothing in this company's ${health.usablePages} readable saved pages matches. The saved set is healthy, so this is the query, not the library \u2014 loosen the filters or search everything with --scope all.`
+    );
+  }
+  return hints;
+}
+function fidelityHint(fidelity) {
+  if (fidelity == null) return null;
+  if (fidelity >= 0.9) return null;
+  if (fidelity >= 0.75) {
+    return `Reproduction fidelity ${fidelity.toFixed(2)} \u2014 the markup is close but not exact. Trust the screenshot over the code.`;
+  }
+  return `Reproduction fidelity ${fidelity.toFixed(2)} \u2014 this section is scroll- or JS-driven and the extracted markup does NOT render like the original. Use the screenshot and the notes; treat the code as a hint only.`;
+}
+var STALE_COPY_AFTER_MS = 30 * 24 * 60 * 60 * 1e3;
+function staleCopyHint(studiedAt, filedUrl, now = Date.now()) {
+  if (!studiedAt || now - studiedAt < STALE_COPY_AFTER_MS) return null;
+  const date = new Date(studiedAt).toLocaleDateString("en-US", { month: "short", day: "numeric", timeZone: "UTC" });
+  return `This copy of the page was read on ${date}. If the user says the live page looks different, run: baker landing inspiration add ${filedUrl} --refresh`;
+}
+function reportError(error) {
+  if (error instanceof ApiError) {
+    writeJson({ ok: false, error: { code: error.code, message: error.message } });
+  } else {
+    writeJson({
+      ok: false,
+      error: { code: "UNKNOWN", message: error instanceof Error ? error.message : String(error) }
+    });
+  }
+  process.exit(1);
+}
+function splitList(value) {
+  if (!value) return void 0;
+  const parts = value.split(",").map((part) => part.trim()).filter(Boolean);
+  return parts.length > 0 ? parts : void 0;
+}
+function parseNumber(value) {
+  if (value === void 0 || value === "") return void 0;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+
+export {
+  INSPIRATION_HINTS,
+  favoritesScopeHints,
+  fidelityHint,
+  staleCopyHint,
+  reportError,
+  splitList,
+  parseNumber
+};
+//# sourceMappingURL=chunk-OON5SC7P.js.map

package/dist/chunk-OQCDLFGJ.js

@@ -0,0 +1,84 @@
+import {
+  findWorkspaceRoot
+} from "./chunk-DFWBCUKH.js";
+
+// src/commands/canvas/unbilled-spend.ts
+import { randomUUID } from "crypto";
+import { mkdir, readdir, readFile, rename, unlink, writeFile } from "fs/promises";
+import path from "path";
+import { z } from "zod";
+var DIR = "unbilled-spend";
+var Held = z.array(
+  z.object({ model: z.string(), inputTokens: z.number(), outputTokens: z.number(), costUsd: z.number() })
+);
+async function holdUnbilledSpend(cacheDir, usage) {
+  if (usage.length === 0) return;
+  const dir = path.join(cacheDir, DIR);
+  await mkdir(dir, { recursive: true });
+  await writeFile(path.join(dir, `${Date.now()}-${randomUUID()}.json`), JSON.stringify(usage), "utf8");
+}
+async function holdWorkspaceSpend(usage) {
+  const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+  await holdUnbilledSpend(path.join(root, "canvas", ".cache"), usage).catch(() => {
+  });
+}
+async function takeUnbilledSpend(cacheDir) {
+  const dir = path.join(cacheDir, DIR);
+  const files = await readdir(dir).catch(() => []);
+  const byModel = /* @__PURE__ */ new Map();
+  for (const file of files.filter((f) => f.endsWith(".json"))) {
+    const claimed = path.join(dir, `${file}.${randomUUID()}.taken`);
+    try {
+      await rename(path.join(dir, file), claimed);
+    } catch {
+      continue;
+    }
+    const parsed = Held.safeParse(await readFile(claimed, "utf8").then(JSON.parse, () => null).catch(() => null));
+    await unlink(claimed).catch(() => {
+    });
+    for (const call of parsed.success ? parsed.data : []) {
+      const sum = byModel.get(call.model);
+      byModel.set(
+        call.model,
+        sum ? {
+          model: call.model,
+          inputTokens: sum.inputTokens + call.inputTokens,
+          outputTokens: sum.outputTokens + call.outputTokens,
+          costUsd: sum.costUsd + call.costUsd
+        } : { ...call }
+      );
+    }
+  }
+  return [...byModel.values()];
+}
+async function sendBillingSpend(cacheDir, usage, send) {
+  try {
+    await send();
+    return null;
+  } catch (e) {
+    await holdUnbilledSpend(cacheDir, usage).catch(() => {
+    });
+    return e instanceof Error ? e.message : String(e);
+  }
+}
+function holdWhenSettled(cacheDir, spendOf) {
+  const pending = [];
+  return {
+    settled: (run, outputs) => {
+      pending.push(holdUnbilledSpend(cacheDir, spendOf(run, outputs)).catch(() => {
+      }));
+    },
+    drained: async () => {
+      await Promise.all(pending);
+    }
+  };
+}
+
+export {
+  holdUnbilledSpend,
+  holdWorkspaceSpend,
+  takeUnbilledSpend,
+  sendBillingSpend,
+  holdWhenSettled
+};
+//# sourceMappingURL=chunk-OQCDLFGJ.js.map

package/dist/chunk-OXXAZEQI.js

@@ -0,0 +1,84 @@
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-P5NYZ236.js";
+
+// src/commands/videos/api.ts
+import { readFile } from "fs/promises";
+import { basename, extname } from "path";
+var videoProcessingTimeoutMs = 18e4;
+var videoReadyPollIntervalMs = 3e3;
+var mimeMap = {
+  ".mp4": "video/mp4",
+  ".mov": "video/quicktime",
+  ".webm": "video/webm",
+  ".avi": "video/x-msvideo",
+  ".mkv": "video/x-matroska"
+};
+var defaultVideoApiDeps = {
+  readFile,
+  post: apiPost,
+  get: apiGet,
+  sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+  putFile: async (url, contentType, body) => {
+    const response = await fetch(url, { method: "PUT", headers: { "Content-Type": contentType }, body });
+    if (!response.ok) {
+      throw new ApiError("INTERNAL_ERROR", `Mux upload failed: HTTP ${response.status} ${response.statusText}`);
+    }
+  }
+};
+function isVideoFile(filePath) {
+  return mimeMap[extname(filePath).toLowerCase()] !== void 0;
+}
+function detectVideoContentType(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 uploadLocalVideo(args, deps = defaultVideoApiDeps) {
+  const { uploadUrl, videoId } = await deps.post("/api/videos/upload", {
+    originalFilename: basename(args.file),
+    descriptionContext: args.descriptionContext
+  });
+  await deps.putFile(uploadUrl, args.contentType, await deps.readFile(args.file));
+  return { videoId };
+}
+var PLAYABLE_STATUSES = /* @__PURE__ */ new Set(["uploaded", "processing", "ready"]);
+async function waitForPlayableVideo(deps, videoId, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? videoProcessingTimeoutMs;
+  const pollIntervalMs = opts.pollIntervalMs ?? videoReadyPollIntervalMs;
+  const deadline = Date.now() + timeoutMs;
+  let lastStatus = "unknown";
+  while (Date.now() <= deadline) {
+    const video = await deps.get("/api/videos/get", { id: videoId });
+    lastStatus = video.status;
+    if (video.muxPlaybackId && PLAYABLE_STATUSES.has(video.status)) {
+      return video;
+    }
+    if (video.status === "error") {
+      throw new ApiError(
+        "INTERNAL_ERROR",
+        "The video library could not process this file. Export it again as an MP4 (H.264) and retry."
+      );
+    }
+    await deps.sleep(pollIntervalMs);
+  }
+  throw new ApiError("TIMEOUT", `Video was not playable before timeout; last status: ${lastStatus}`);
+}
+
+export {
+  videoProcessingTimeoutMs,
+  defaultVideoApiDeps,
+  isVideoFile,
+  detectVideoContentType,
+  uploadLocalVideo,
+  waitForPlayableVideo
+};
+//# sourceMappingURL=chunk-OXXAZEQI.js.map

package/dist/chunk-P5NYZ236.js

@@ -0,0 +1,214 @@
+import {
+  debugLogHttp,
+  readBodyForLog
+} from "./chunk-7JB56IVP.js";
+import {
+  getEnv
+} from "./chunk-XMS5K54U.js";
+
+// src/client.ts
+var MAX_RATE_LIMIT_RETRIES = 3;
+var MAX_TOTAL_WAIT_MS = 2 * 60 * 1e3;
+async function fetchWithRateLimitRetry(url, init) {
+  let totalWaited = 0;
+  for (let attempt = 0; attempt <= MAX_RATE_LIMIT_RETRIES; attempt++) {
+    const response = await fetch(url, init);
+    if (response.status !== 429 || attempt >= MAX_RATE_LIMIT_RETRIES) {
+      return response;
+    }
+    const retryAfterHeader = response.headers.get("Retry-After");
+    const waitMs = retryAfterHeader ? Number(retryAfterHeader) * 1e3 : 2e3 * 2 ** attempt;
+    if (totalWaited + waitMs > MAX_TOTAL_WAIT_MS) {
+      return response;
+    }
+    totalWaited += waitMs;
+    await new Promise((resolve) => setTimeout(resolve, waitMs));
+  }
+  return fetch(url, init);
+}
+var ApiError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "ApiError";
+    this.code = code;
+  }
+};
+var CONVEX_ID_RE = /^[a-zA-Z0-9_]+$/;
+function hasControlCharacters(value) {
+  for (let i = 0; i < value.length; i++) {
+    const code = value.charCodeAt(i);
+    if (code < 32 && code !== 9 && code !== 10 && code !== 13) {
+      return true;
+    }
+  }
+  return false;
+}
+function validateStringValue(value) {
+  if (hasControlCharacters(value)) {
+    throw new ApiError("VALIDATION_ERROR", "String value contains invalid control characters");
+  }
+}
+function validateConvexId(id) {
+  if (!CONVEX_ID_RE.test(id)) {
+    throw new ApiError("VALIDATION_ERROR", `Invalid ID format: "${id}". Expected alphanumeric string.`);
+  }
+}
+function sanitizeParams(params) {
+  const sanitized = {};
+  for (const [key, value] of Object.entries(params)) {
+    validateStringValue(value);
+    sanitized[key] = value;
+  }
+  return sanitized;
+}
+function chatHeader() {
+  const { BAKER_CHAT_ID: chatId, BAKER_THREAD_ID: threadId } = getEnv();
+  return {
+    ...chatId ? { "x-baker-chat-id": chatId } : {},
+    ...threadId ? { "x-baker-thread-id": threadId } : {}
+  };
+}
+function mapHttpError(status) {
+  if (status === 401) {
+    return "UNAUTHORIZED";
+  }
+  if (status === 403) {
+    return "FORBIDDEN";
+  }
+  if (status === 404) {
+    return "NOT_FOUND";
+  }
+  if (status === 422 || status === 400) {
+    return "VALIDATION_ERROR";
+  }
+  if (status === 409) {
+    return "CONFLICT";
+  }
+  if (status === 429) {
+    return "RATE_LIMITED";
+  }
+  if (status === 503) {
+    return "UNAVAILABLE";
+  }
+  return "INTERNAL_ERROR";
+}
+async function handleResponse(response) {
+  const body = await response.text();
+  if (!response.ok) {
+    let message = `HTTP ${response.status}: ${response.statusText}`;
+    try {
+      const parsed = JSON.parse(body);
+      if (typeof parsed.error === "string") {
+        message = parsed.error;
+      } else if (parsed.error?.message) {
+        message = parsed.error.message;
+      } else if (parsed.message) {
+        message = parsed.message;
+      }
+    } catch {
+    }
+    throw new ApiError(mapHttpError(response.status), message);
+  }
+  try {
+    return JSON.parse(body);
+  } catch {
+    throw new ApiError("INTERNAL_ERROR", "Failed to parse API response as JSON");
+  }
+}
+async function apiGetWithHeaders(path, params) {
+  const env = getEnv();
+  const url = new URL(path, env.BAKER_API_URL);
+  if (params) {
+    const clean = sanitizeParams(params);
+    for (const [key, value] of Object.entries(clean)) {
+      url.searchParams.set(key, value);
+    }
+  }
+  const urlStr = url.toString();
+  const startedAt = Date.now();
+  let response;
+  try {
+    response = await fetchWithRateLimitRetry(urlStr, {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${env.BAKER_API_KEY}`,
+        Accept: "application/json",
+        ...chatHeader()
+      },
+      signal: AbortSignal.timeout(6e4)
+    });
+  } catch (err) {
+    debugLogHttp({ source: "cli", method: "GET", url: urlStr, durationMs: Date.now() - startedAt, error: err });
+    if (err instanceof Error && (err.name === "TimeoutError" || err.name === "AbortError")) {
+      throw new ApiError("TIMEOUT", "Request timed out after 60 seconds");
+    }
+    throw new ApiError("NETWORK_ERROR", `Request failed: ${err instanceof Error ? err.message : "Unknown error"}`);
+  }
+  debugLogHttp({
+    source: "cli",
+    method: "GET",
+    url: urlStr,
+    status: response.status,
+    ok: response.ok,
+    responseBody: await readBodyForLog(response),
+    durationMs: Date.now() - startedAt
+  });
+  return { data: await handleResponse(response), headers: response.headers };
+}
+async function apiGet(path, params) {
+  return (await apiGetWithHeaders(path, params)).data;
+}
+async function apiPost(path, body, opts) {
+  const env = getEnv();
+  const timeoutMs = opts?.timeoutMs ?? 6e4;
+  const urlStr = new URL(path, env.BAKER_API_URL).toString();
+  const startedAt = Date.now();
+  let response;
+  try {
+    response = await fetchWithRateLimitRetry(urlStr, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${env.BAKER_API_KEY}`,
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        ...chatHeader()
+      },
+      body: JSON.stringify(body),
+      signal: AbortSignal.timeout(timeoutMs)
+    });
+  } catch (err) {
+    debugLogHttp({
+      source: "cli",
+      method: "POST",
+      url: urlStr,
+      requestBody: body,
+      durationMs: Date.now() - startedAt,
+      error: err
+    });
+    if (err instanceof Error && (err.name === "TimeoutError" || err.name === "AbortError")) {
+      throw new ApiError("TIMEOUT", `Request timed out after ${Math.round(timeoutMs / 1e3)} seconds`);
+    }
+    throw new ApiError("NETWORK_ERROR", `Request failed: ${err instanceof Error ? err.message : "Unknown error"}`);
+  }
+  debugLogHttp({
+    source: "cli",
+    method: "POST",
+    url: urlStr,
+    requestBody: body,
+    status: response.status,
+    ok: response.ok,
+    responseBody: await readBodyForLog(response),
+    durationMs: Date.now() - startedAt
+  });
+  return handleResponse(response);
+}
+
+export {
+  ApiError,
+  validateConvexId,
+  apiGetWithHeaders,
+  apiGet,
+  apiPost
+};
+//# sourceMappingURL=chunk-P5NYZ236.js.map

package/dist/chunk-PFYZBCA4.js

@@ -0,0 +1,55 @@
+import {
+  ApiError
+} from "./chunk-P5NYZ236.js";
+import {
+  writeJson
+} from "./chunk-MEBOQXW3.js";
+
+// src/commands/media-sources/shared.ts
+function driveRefusalFix(input, code) {
+  if (!/drive\.google\.com/i.test(input) || code !== "BAD_REQUEST") return void 0;
+  return `A Google Drive folder is never added by link \u2014 don't retry. Call request_connection with platform "google-drive" and choose "media-folder": the card lets the user pick the folder in the chat (only the Baker team can for now; anyone else is told the team will set it up). A connected result carries the new source's mediaSourceKey; if it is declined, carry on with the rest of the task.`;
+}
+function reportError(err, input) {
+  if (err instanceof ApiError) {
+    const fix = input ? driveRefusalFix(input, err.code) : void 0;
+    writeJson({ ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } });
+    process.exit(1);
+  }
+  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+function halfState(half) {
+  if (!half) return null;
+  return {
+    status: half.syncStatus === "fetching" || half.syncStatus === "processing" ? "importing" : half.syncStatus,
+    stored: half.storedCount ?? 0,
+    ...half.pendingItems ? { pending: half.pendingItems } : {},
+    ...half.failedItems ? { failed: half.failedItems } : {},
+    ...half.lastSyncedAt ? { lastSyncedAt: new Date(half.lastSyncedAt).toISOString() } : {},
+    ...half.errorMessage ? { error: half.errorMessage } : {}
+  };
+}
+function compactSource(source) {
+  return {
+    key: source.key,
+    platform: source.platform,
+    label: source.label,
+    url: source.profileUrl,
+    autoSync: source.refreshInterval,
+    images: halfState(source.images),
+    videos: halfState(source.videos)
+  };
+}
+function isImporting(source) {
+  return [source.images, source.videos].some(
+    (half) => half?.syncStatus === "fetching" || half?.syncStatus === "processing"
+  );
+}
+
+export {
+  reportError,
+  compactSource,
+  isImporting
+};
+//# sourceMappingURL=chunk-PFYZBCA4.js.map

package/dist/chunk-PL5MOERB.js

@@ -0,0 +1,58 @@
+import {
+  readAvatars
+} from "./chunk-2PADYR7B.js";
+
+// src/commands/canvas/scaffold-static-ad-paths.ts
+import path from "path";
+function resolveScaffoldStaticAdPaths(rawFile, out, cwd = process.cwd(), slug) {
+  const file = rawFile.trim();
+  const imageIsUrl = /^https?:\/\//i.test(file);
+  const imageSource = imageIsUrl ? file : path.resolve(cwd, file);
+  const outPath = out ? path.resolve(cwd, out) : slug ? path.join(cwd, "src", "creatives", slug, `${slug}.canvas.json`) : imageIsUrl ? path.join(cwd, "static-ad.canvas.json") : path.join(path.dirname(imageSource), "static-ad.canvas.json");
+  const blueprintPath = path.join(path.dirname(outPath), "prompt.json");
+  const creativeDir = slug ? path.dirname(outPath) : null;
+  const definitionPath = creativeDir ? path.join(creativeDir, "_definition.md") : null;
+  const referencesDir = creativeDir ? path.join(creativeDir, "references") : null;
+  return { imageIsUrl, imageSource, outPath, blueprintPath, creativeDir, definitionPath, referencesDir };
+}
+var SCAFFOLD_SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
+var SCAFFOLD_SLUG_MAX_LENGTH = 100;
+function isValidScaffoldSlug(slug) {
+  return slug.length <= SCAFFOLD_SLUG_MAX_LENGTH && SCAFFOLD_SLUG_PATTERN.test(slug);
+}
+
+// src/commands/avatars/resolveCast.ts
+async function resolveCastAvatar(handle) {
+  try {
+    const avatar = await readAvatars("/api/avatars/get", { handle });
+    if (avatar.status && avatar.status !== "ready") {
+      return {
+        error: `Avatar \`${handle}\` is ${avatar.status}, not ready \u2014 \`baker avatars get ${handle} --wait\` returns the moment it is.`
+      };
+    }
+    if (!avatar.sheetUrl)
+      return { error: `Avatar \`${handle}\` has no identity sheet yet, so the ad cannot ground on their face.` };
+    return { sheetUrl: avatar.sheetUrl, subjectDescription: avatar.subjectDescription, handle };
+  } catch (e) {
+    return {
+      error: `Could not read avatar \`${handle}\`: ${e instanceof Error ? e.message : String(e)}. \`baker avatars list\` shows who there is.`
+    };
+  }
+}
+async function resolveCastAvatars(flag) {
+  const handles = String(flag ?? "").split(",").map((h) => h.trim()).filter(Boolean);
+  const avatars = [];
+  for (const handle of handles) {
+    const resolved = await resolveCastAvatar(handle);
+    if ("error" in resolved) return resolved;
+    avatars.push(resolved);
+  }
+  return { handles, avatars };
+}
+
+export {
+  resolveScaffoldStaticAdPaths,
+  isValidScaffoldSlug,
+  resolveCastAvatars
+};
+//# sourceMappingURL=chunk-PL5MOERB.js.map

package/dist/chunk-PM7ZSDKG.js

@@ -0,0 +1,98 @@
+import {
+  ApiError
+} from "./chunk-P5NYZ236.js";
+
+// src/commands/research/output.ts
+var RESEARCH_DATA_NOTE = "Estimates based on third-party SERP data \u2014 not exact figures. Use for directional insights, not precise measurement.";
+function writeResearchJson(envelope) {
+  process.stdout.write(`${JSON.stringify(envelope, null, 2)}
+`);
+}
+function toCsvRow(values) {
+  return values.map((v) => {
+    if (v.includes(",") || v.includes('"') || v.includes("\n")) {
+      return `"${v.replace(/"/g, '""')}"`;
+    }
+    return v;
+  }).join(",");
+}
+function flattenRow(row) {
+  const flat = {};
+  for (const [key, val] of Object.entries(row)) {
+    flat[key] = typeof val === "object" && val !== null ? JSON.stringify(val) : String(val ?? "");
+  }
+  return flat;
+}
+function writeCsv(data, fields) {
+  if (data.length === 0) return;
+  const cols = fields ?? Object.keys(data[0] ?? {});
+  process.stdout.write(`${toCsvRow(cols)}
+`);
+  for (const row of data) {
+    const flat = flattenRow(row);
+    process.stdout.write(`${toCsvRow(cols.map((f) => flat[f] ?? ""))}
+`);
+  }
+}
+function writeJsonl(data) {
+  for (const row of data) {
+    process.stdout.write(`${JSON.stringify(row)}
+`);
+  }
+}
+function writeMd(data, fields) {
+  if (data.length === 0) return;
+  const cols = fields ?? Object.keys(data[0] ?? {});
+  process.stdout.write(`| ${cols.join(" | ")} |
+`);
+  process.stdout.write(`| ${cols.map(() => "---").join(" | ")} |
+`);
+  for (const row of data) {
+    const flat = flattenRow(row);
+    process.stdout.write(`| ${cols.map((f) => markdownCell(flat[f] ?? "")).join(" | ")} |
+`);
+  }
+}
+function markdownCell(value) {
+  return value.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+}
+function writeResearchOutput(data, format, fields) {
+  switch (format) {
+    case "csv":
+      writeCsv(data, fields);
+      break;
+    case "jsonl":
+      writeJsonl(data);
+      break;
+    case "md":
+      writeMd(data, fields);
+      break;
+    default:
+      writeResearchJson({ ok: true, data });
+  }
+}
+function writeResearchHints(hints, format) {
+  if (format === "json") {
+    return;
+  }
+  for (const hint of hints) {
+    process.stderr.write(`${hint}
+`);
+  }
+}
+function handleResearchError(err, fixFor) {
+  const code = err instanceof ApiError ? err.code : "NETWORK_ERROR";
+  const message = err instanceof ApiError ? err.message : err instanceof Error ? err.message : "Unexpected error";
+  const fix = fixFor?.(code);
+  writeResearchJson({ ok: false, error: { code, message, ...fix ? { fix } : {} } });
+  process.exit(1);
+}
+
+export {
+  RESEARCH_DATA_NOTE,
+  writeResearchJson,
+  writeResearchOutput,
+  writeResearchHints,
+  handleResearchError
+};
+//# sourceMappingURL=chunk-PM7ZSDKG.js.map