@koda-sl/baker-cli 0.571.0 → 0.572.0-dev.61ba69c66

package/dist/chunk-VF3W7CI7.js

@@ -0,0 +1,325 @@
+import {
+  ApiError,
+  apiGet
+} from "./chunk-UUDWZIDC.js";
+import {
+  getEnv,
+  optionalTargetCompany
+} from "./chunk-6LUDG5AB.js";
+
+// src/error-handler.ts
+var REQUEST_CONNECTION_PLATFORM = {
+  google_ads: "google-ads",
+  ga4: "google-analytics",
+  gsc: "google-search-console",
+  linkedin_ads: "linkedin",
+  meta_ads: "meta",
+  x_ads: "x-ads"
+};
+var PLATFORM_NAME = {
+  google_ads: "Google Ads",
+  ga4: "Google Analytics 4",
+  gsc: "Google Search Console",
+  x_ads: "X Ads",
+  meta_ads: "Meta Ads",
+  linkedin_ads: "LinkedIn Ads"
+};
+function connectionFixExplanation(platform, originalMessage) {
+  const name = PLATFORM_NAME[platform];
+  const slug = REQUEST_CONNECTION_PLATFORM[platform];
+  if (optionalTargetCompany()) {
+    return `${name} is not connected for that company. It can only be connected in that company's own workspace, never with \`request_connection\` from here. Show that company as not connected for ${name} and carry on with the others.`;
+  }
+  if (originalMessage !== void 0 && SIGN_IN_ENDED.test(originalMessage)) {
+    return `${name} is connected, but its sign-in no longer works (it expired, or was revoked on the platform) \u2014 this is not a Baker error, and retrying later cannot fix it: only the user signing in again can. Call the \`request_connection\` tool now with { platform: "${slug}", reason } \u2014 the card offers Reconnect. If that call fails, give the exact route: dashboard \u2192 Brain \u2192 Integrations \u2192 Platforms \u2192 ${name} \u2192 Reconnect. Then carry on with the rest of the task and say what stays unavailable until it is reconnected.`;
+  }
+  return `${name} is not connected for this company (or no account has been picked). Don't send the user to Settings or end the turn here \u2014 call the \`request_connection\` tool with { platform: "${slug}", reason } and they connect and pick their accounts from inside the chat. If the \`request_connection\` call fails, say so plainly and give the exact route: dashboard \u2192 Brain \u2192 Integrations \u2192 Platforms \u2192 ${name}. Then carry on with the rest of the task and say what stays unavailable until it is connected.`;
+}
+var SIGN_IN_ENDED = /connection expired|must reconnect/i;
+function handleConnectionError(platform, originalMessage) {
+  const platformName = PLATFORM_NAME[platform];
+  const alternative = {
+    google_ads: "keywords-for-site or research advertisers",
+    ga4: "lighthouse for page performance",
+    gsc: "keywords-for-site or research keyword-gap",
+    x_ads: "research advertisers",
+    meta_ads: "research advertisers or research keyword-ideas",
+    linkedin_ads: "research advertisers (LinkedIn Ad Library) or research keyword-ideas"
+  }[platform];
+  const code = {
+    google_ads: "NO_GOOGLE_ADS_CONNECTION",
+    ga4: "NO_GA4_CONNECTION",
+    gsc: "NO_GSC_CONNECTION",
+    x_ads: "NO_X_ADS_CONNECTION",
+    meta_ads: "NO_META_ADS_CONNECTION",
+    linkedin_ads: "NO_LINKEDIN_ADS_CONNECTION"
+  }[platform];
+  const envelope = {
+    ok: false,
+    error: {
+      code,
+      message: originalMessage || `No ${platformName} connection found for this company.`,
+      fix: optionalTargetCompany() ? { action: "continue_without", explanation: connectionFixExplanation(platform) } : {
+        action: "request_connection",
+        explanation: `${connectionFixExplanation(platform, originalMessage)} (Optional fallback for estimated external insights: 'baker research ${alternative}'.)`
+      },
+      retryable: false
+    }
+  };
+  writeJsonEnvelope(envelope);
+  process.exit(1);
+}
+function isNotConnectedError(code, message) {
+  if (code !== "NOT_FOUND" && code !== "UNAUTHORIZED" && code !== "FORBIDDEN") {
+    return false;
+  }
+  return /no .* connection found|not connected|no .* (selected|picked)|is not in .* connected/i.test(message);
+}
+function needsConnectionFix(code, message) {
+  if (code === "UNAUTHORIZED") {
+    return true;
+  }
+  return isNotConnectedError(code, message);
+}
+function isOrganizationReadRefusal(message) {
+  return message.startsWith("The organization workspace only reads its companies");
+}
+
+// src/commands/ads/cache.ts
+import { createHash } from "crypto";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+function cacheDir() {
+  const company = optionalTargetCompany()?.replace(/[^a-zA-Z0-9_]/g, "");
+  return join(homedir(), ".baker", "cache", "ads", ...company ? ["company", company] : []);
+}
+function ensureDir(dir) {
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+function hashKey(key) {
+  return createHash("sha256").update(key).digest("hex").slice(0, 16);
+}
+function cachePath(category, key) {
+  const dir = join(cacheDir(), category);
+  ensureDir(dir);
+  return join(dir, `${hashKey(key)}.json`);
+}
+function cacheGet(category, key) {
+  const path = cachePath(category, key);
+  if (!existsSync(path)) {
+    return null;
+  }
+  try {
+    const raw = readFileSync(path, "utf-8");
+    const entry = JSON.parse(raw);
+    if (entry.expiresAt < Date.now()) {
+      rmSync(path, { force: true });
+      return null;
+    }
+    return entry;
+  } catch {
+    rmSync(path, { force: true });
+    return null;
+  }
+}
+function cacheSet(category, key, data, ttlMs, fields) {
+  const path = cachePath(category, key);
+  const entry = {
+    expiresAt: Date.now() + ttlMs,
+    data,
+    fields
+  };
+  writeFileSync(path, JSON.stringify(entry), "utf-8");
+}
+var HOUR = 60 * 60 * 1e3;
+var MINUTE = 60 * 1e3;
+function getQueryTtl(query) {
+  const upper = query.toUpperCase();
+  if (upper.includes("TODAY")) {
+    return 15 * MINUTE;
+  }
+  if (upper.includes("LAST_7_DAYS") || upper.includes("LAST_14_DAYS")) {
+    return 1 * HOUR;
+  }
+  return 6 * HOUR;
+}
+function buildQueryCacheKey(customerId, query) {
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  return `${customerId}:${today}:${query.trim().replace(/\s+/g, " ")}`;
+}
+function getManagerIdForCustomer(customerId) {
+  const cached = cacheGet("accounts", "list");
+  if (!cached) return void 0;
+  const account = cached.data.find((a) => a.id === customerId);
+  if (account?.access_type === "managed") return account.manager_id;
+  return void 0;
+}
+
+// src/commands/ads/output.ts
+function writeAdsJson(envelope) {
+  process.stdout.write(`${JSON.stringify(envelope, null, 2)}
+`);
+}
+function writeJsonEnvelope(envelope) {
+  process.stdout.write(`${JSON.stringify(envelope, null, 2)}
+`);
+}
+var TABLE_OUTPUT_FORMATS = ["json", "csv", "jsonl", "md"];
+function outputFormatRefusal(format, supported) {
+  if (supported.includes(format)) return null;
+  const list = supported.length > 1 ? `${supported.slice(0, -1).join(", ")} or ${supported.at(-1)}` : supported.join("");
+  return `--output ${format} is not supported \u2014 use ${list}`;
+}
+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 writeWhole(lines) {
+  process.stdout.write(`${lines.join("\n")}
+`);
+}
+function writeAdsCsv(data, fields) {
+  if (data.length === 0) return;
+  const cols = fields ?? Object.keys(data[0] ?? {});
+  const lines = [toCsvRow(cols)];
+  for (const row of data) {
+    const flat = flattenRow(row);
+    lines.push(toCsvRow(cols.map((f) => flat[f] ?? "")));
+  }
+  writeWhole(lines);
+}
+function writeAdsJsonl(data) {
+  if (data.length === 0) return;
+  writeWhole(data.map((row) => JSON.stringify(row)));
+}
+function mdCell(value) {
+  return value.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+}
+function writeAdsMd(data, fields) {
+  if (data.length === 0) return;
+  const cols = fields ?? Object.keys(data[0] ?? {});
+  const lines = [`| ${cols.join(" | ")} |`, `| ${cols.map(() => "---").join(" | ")} |`];
+  for (const row of data) {
+    const flat = flattenRow(row);
+    lines.push(`| ${cols.map((f) => mdCell(flat[f] ?? "")).join(" | ")} |`);
+  }
+  writeWhole(lines);
+}
+function writeAdsOutput(data, format, fields, hints = []) {
+  switch (format) {
+    case "csv":
+      writeAdsCsv(data, fields);
+      break;
+    case "jsonl":
+      writeAdsJsonl(data);
+      break;
+    case "md":
+      writeAdsMd(data, fields);
+      break;
+    default:
+      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
+      return;
+  }
+  for (const hint of hints) process.stderr.write(`${hint}
+`);
+}
+async function fetchAccounts(useCache = true) {
+  if (useCache) {
+    const cached = cacheGet("accounts", "list");
+    if (cached) return cached.data;
+  }
+  const params = !useCache ? { "skip-cache": "true" } : void 0;
+  const data = await apiGet("/api/ads/google/accounts", params);
+  if (useCache) {
+    cacheSet("accounts", "list", data, 60 * 60 * 1e3);
+  }
+  return data;
+}
+async function resolveCustomerId(args) {
+  const fromArgs = args["customer-id"];
+  const customerId = fromArgs || getEnv().BAKER_GOOGLE_ADS_CUSTOMER_ID;
+  if (customerId) {
+    if (!/^\d{10}$/.test(customerId)) {
+      writeAdsJson({
+        ok: false,
+        error: {
+          code: "INVALID_CUSTOMER_ID",
+          message: "Customer ID must be exactly 10 digits without dashes. Pass --customer-id or set BAKER_GOOGLE_ADS_CUSTOMER_ID."
+        }
+      });
+      process.exit(1);
+    }
+    return customerId;
+  }
+  const useCache = !args["no-cache"];
+  try {
+    const accounts = await fetchAccounts(useCache);
+    const [single] = accounts;
+    if (accounts.length === 1 && single) {
+      const answersInJson = (args.output ?? "json") === "json" || Boolean(args.out);
+      if (!answersInJson) process.stderr.write(`Using account "${single.name}" (${single.id})
+`);
+      return single.id;
+    }
+    if (accounts.length === 0) {
+      handleConnectionError("google_ads");
+    }
+    const list = accounts.map((a) => `  ${a.id}  ${a.name}`).join("\n");
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "MULTIPLE_ACCOUNTS",
+        message: `Multiple accounts found. Pass --customer-id or set BAKER_GOOGLE_ADS_CUSTOMER_ID:
+${list}`
+      }
+    });
+    process.exit(1);
+  } catch (err) {
+    if (err instanceof ApiError && isNotConnectedError(err.code, err.message)) {
+      handleConnectionError("google_ads", err.message);
+    }
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "INVALID_CUSTOMER_ID",
+        message: "Could not auto-detect account. Pass --customer-id or set BAKER_GOOGLE_ADS_CUSTOMER_ID."
+      }
+    });
+    process.exit(1);
+  }
+}
+
+export {
+  cacheGet,
+  cacheSet,
+  getQueryTtl,
+  buildQueryCacheKey,
+  getManagerIdForCustomer,
+  writeAdsJson,
+  writeJsonEnvelope,
+  TABLE_OUTPUT_FORMATS,
+  outputFormatRefusal,
+  toCsvRow,
+  writeAdsOutput,
+  resolveCustomerId,
+  connectionFixExplanation,
+  handleConnectionError,
+  isNotConnectedError,
+  needsConnectionFix,
+  isOrganizationReadRefusal
+};
+//# sourceMappingURL=chunk-VF3W7CI7.js.map

package/dist/chunk-VHOOAQY4.js

@@ -0,0 +1,169 @@
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-ASJMLTMX.js";
+import {
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-VF3W7CI7.js";
+import {
+  X_DRAFT_BATCH_MAX,
+  xDraftOpInputSchema
+} from "./chunk-YOHGEF2N.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-UUDWZIDC.js";
+import {
+  requireChatId
+} from "./chunk-6LUDG5AB.js";
+
+// src/commands/ads/x/write-shared.ts
+function failWriteValidation(message) {
+  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function failPreflight(fields) {
+  writeJsonEnvelope({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: fields.map((f) => f.path ? `${f.path}: ${f.message}` : f.message).join("; "),
+      fields,
+      fix: {
+        action: "reject",
+        explanation: "Fix the named fields and stage again. Nothing was staged \u2014 the draft is exactly as it was before this call."
+      }
+    }
+  });
+  process.exit(1);
+}
+function handleXWriteError(err, accountId) {
+  if (err instanceof ApiError) {
+    writeAdsJson(parseXApiError(err.message, accountId));
+    process.exit(1);
+  }
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+function decimalPlaces(value) {
+  const [mantissa, exponent] = String(value).trim().split(/e/i);
+  const written = (mantissa?.split(".")[1] ?? "").length;
+  return Math.max(0, written - (exponent ? Number(exponent) : 0));
+}
+function parseXMoney(value) {
+  if (value === void 0 || value === "") {
+    return { ok: true, micros: void 0 };
+  }
+  const amount = Number(value);
+  if (!Number.isFinite(amount) || amount <= 0) {
+    return { ok: false, reason: "must be a positive amount, for example 12.50" };
+  }
+  if (decimalPlaces(value) > 6) {
+    return { ok: false, reason: "is finer than X can express \u2014 it takes whole micros" };
+  }
+  return { ok: true, micros: Math.round(amount * 1e6) };
+}
+function microsFromArg(value, flag) {
+  const parsed = parseXMoney(value);
+  if (!parsed.ok) {
+    failWriteValidation(`${flag} ${parsed.reason}`);
+  }
+  return parsed.micros;
+}
+function csvArg(value) {
+  if (typeof value !== "string" || value.length === 0) {
+    return void 0;
+  }
+  const parts = value.split(",").map((s) => s.trim()).filter(Boolean);
+  return parts.length > 0 ? parts : void 0;
+}
+function compact(payload) {
+  return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== void 0));
+}
+function batchNudge(data) {
+  const count = data?.sameKindStaged;
+  if (!count) {
+    return [];
+  }
+  return [
+    `${count} other change${count === 1 ? "" : "s"} of this kind and payload ${count === 1 ? "is" : "are"} already staged \u2014 pass every id to one call (\`--ids a,b,c\`) instead of one call each.`
+  ];
+}
+async function stageXOp(raw, hints) {
+  const preflight = xDraftOpInputSchema.safeParse(raw);
+  if (!preflight.success) {
+    failPreflight(preflight.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message })));
+  }
+  const accountId = String(raw.accountId ?? "\u2014");
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/ads/x/draft/stage", { chatId, op: preflight.data });
+    const allHints = [...batchNudge(response.data), ...hints ?? []];
+    writeJsonEnvelope(allHints.length > 0 ? { ...response, hints: allHints } : response);
+  } catch (err) {
+    handleXWriteError(err, accountId);
+  }
+}
+async function stageXOps(rawOps, hints) {
+  if (rawOps.length === 1 && rawOps[0]) {
+    await stageXOp(rawOps[0], hints);
+    return;
+  }
+  if (rawOps.length > X_DRAFT_BATCH_MAX) {
+    failWriteValidation(`at most ${X_DRAFT_BATCH_MAX} changes can be staged in one call`);
+  }
+  const ops = [];
+  for (const [index, raw] of rawOps.entries()) {
+    const preflight = xDraftOpInputSchema.safeParse(raw);
+    if (!preflight.success) {
+      failPreflight(
+        preflight.error.issues.map((issue) => ({
+          path: `ops[${index}]${issue.path.length > 0 ? `.${issue.path.join(".")}` : ""}`,
+          message: issue.message
+        }))
+      );
+    }
+    ops.push(preflight.data);
+  }
+  const accountId = String(rawOps[0]?.accountId ?? "\u2014");
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/ads/x/draft/stage-batch", { chatId, ops });
+    writeJsonEnvelope(hints && hints.length > 0 ? { ...response, hints } : response);
+  } catch (err) {
+    handleXWriteError(err, accountId);
+  }
+}
+async function stageAccountId(args) {
+  return await resolveXAccountId(args);
+}
+function requireTarget(args, name) {
+  const value = args[name];
+  if (typeof value !== "string" || value.length === 0) {
+    failWriteValidation(`${name} is required`);
+  }
+  return value;
+}
+function requireTargets(args, name) {
+  const ids = csvArg(args[name]);
+  if (!ids) {
+    failWriteValidation(`${name} is required \u2014 pass one or more ids, comma-separated`);
+  }
+  return ids;
+}
+
+export {
+  failWriteValidation,
+  microsFromArg,
+  csvArg,
+  compact,
+  stageXOp,
+  stageXOps,
+  stageAccountId,
+  requireTarget,
+  requireTargets
+};
+//# sourceMappingURL=chunk-VHOOAQY4.js.map

package/dist/chunk-VK2VC6A2.js

@@ -0,0 +1,25 @@
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-UUDWZIDC.js";
+
+// src/commands/avatars/transport.ts
+function unwrap(response) {
+  if (response.ok === false || response.data === void 0) {
+    throw new ApiError("INTERNAL_ERROR", response.error?.message ?? "The avatars service returned an unusable answer");
+  }
+  return response.data;
+}
+async function readAvatars(path, params) {
+  return unwrap(await apiGet(path, params));
+}
+async function writeAvatars(path, body, opts) {
+  return unwrap(await apiPost(path, body, opts));
+}
+
+export {
+  readAvatars,
+  writeAvatars
+};
+//# sourceMappingURL=chunk-VK2VC6A2.js.map

package/dist/chunk-WWPRSJOS.js

@@ -0,0 +1,94 @@
+import {
+  ApiError
+} from "./chunk-UUDWZIDC.js";
+import {
+  writeJson
+} from "./chunk-6V4UAC5I.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-WWPRSJOS.js.map