@koda-sl/baker-cli 0.386.0-dev.4e118c09a → 0.386.0-dev.d6e55699d

package/dist/chunk-G7AFVTUS.js

@@ -0,0 +1,106 @@
+import {
+  cacheGet,
+  cacheSet,
+  handleConnectionError,
+  needsConnectionFix,
+  writeAdsJson
+} from "./chunk-BVM5IRZW.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-HREWXNTO.js";
+import {
+  getEnv
+} from "./chunk-O6QKCJE4.js";
+
+// src/commands/ads/x/output.ts
+var ACCOUNTS_CACHE_TTL_MS = 60 * 60 * 1e3;
+var NO_X_ACCOUNTS_EXPLANATION = "The X Ads connection is live, but X lists no ads accounts for it. That is usually an account X has not activated for advertising yet \u2014 most often one with no billing set up. It does not mean the connection failed, and reconnecting will not change it. An account X omits here still works everywhere else: take its id from the ads.x.com URL (ads.x.com/manager/<id>/\u2026) and pass --account-id <id>, or set BAKER_X_ADS_ACCOUNT_ID.";
+async function fetchXAccounts(useCache) {
+  if (useCache) {
+    const cached = cacheGet("x-accounts", "list");
+    if (cached) return cached.data;
+  }
+  const params = !useCache ? { "skip-cache": "true" } : void 0;
+  const data = await apiGet("/api/ads/x/accounts", params);
+  if (useCache) {
+    cacheSet("x-accounts", "list", data, ACCOUNTS_CACHE_TTL_MS);
+  }
+  return data;
+}
+async function resolveXAccountId(args) {
+  const fromArgs = args["account-id"];
+  const accountId = fromArgs || getEnv().BAKER_X_ADS_ACCOUNT_ID;
+  if (accountId) {
+    if (!/^[a-z0-9]+$/.test(accountId)) {
+      writeAdsJson({
+        ok: false,
+        error: {
+          code: "INVALID_ACCOUNT_ID",
+          message: "X Ads account ID must be a base36 string (lowercase letters and digits). Pass --account-id or set BAKER_X_ADS_ACCOUNT_ID."
+        }
+      });
+      process.exit(1);
+    }
+    return accountId;
+  }
+  const useCache = !args["no-cache"];
+  try {
+    const accounts = await fetchXAccounts(useCache);
+    const [single] = accounts;
+    if (accounts.length === 1 && single) {
+      process.stderr.write(`Using account "${single.name}" (${single.id})
+`);
+      return single.id;
+    }
+    if (accounts.length === 0) {
+      writeAdsJson({
+        ok: false,
+        error: {
+          code: "INVALID_ACCOUNT_ID",
+          message: NO_X_ACCOUNTS_EXPLANATION,
+          fix: { action: "reject", explanation: NO_X_ACCOUNTS_EXPLANATION },
+          retryable: false
+        }
+      });
+      process.exit(1);
+    }
+    const list = accounts.map((a) => `  ${a.id}  ${a.name}`).join("\n");
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "MULTIPLE_ACCOUNTS",
+        message: `Multiple X Ads accounts found. Pass --account-id or set BAKER_X_ADS_ACCOUNT_ID:
+${list}`
+      }
+    });
+    process.exit(1);
+  } catch (err) {
+    if (err instanceof ApiError && needsConnectionFix(err.code, err.message)) {
+      handleConnectionError("x_ads", err.message);
+    }
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "INVALID_ACCOUNT_ID",
+        message: "Could not auto-detect account. Pass --account-id or set BAKER_X_ADS_ACCOUNT_ID."
+      }
+    });
+    process.exit(1);
+  }
+}
+async function resolveXAccountTimezone(accountId, args) {
+  try {
+    const accounts = await fetchXAccounts(!args["no-cache"]);
+    return accounts.find((a) => a.id === accountId)?.timezone || "UTC";
+  } catch {
+    return "UTC";
+  }
+}
+
+export {
+  NO_X_ACCOUNTS_EXPLANATION,
+  resolveXAccountId,
+  resolveXAccountTimezone
+};
+//# sourceMappingURL=chunk-G7AFVTUS.js.map

package/dist/chunk-G7AFVTUS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/output.ts"],"sourcesContent":["import { ApiError, apiGet } from \"../../../client.ts\";\nimport { getEnv } from \"../../../env.ts\";\nimport { handleConnectionError, needsConnectionFix } from \"../../../error-handler.ts\";\nimport { cacheGet, cacheSet } from \"../cache.ts\";\nimport { writeAdsJson } from \"../output.ts\";\n\nexport interface XAccountInfo {\n  id: string;\n  name: string;\n  approval_status?: string;\n  timezone?: string;\n  currency?: string;\n}\n\nconst ACCOUNTS_CACHE_TTL_MS = 60 * 60 * 1000;\n\n/**\n * X serves `/accounts` from its own idea of an active advertiser account, and an account it\n * leaves out of that list still answers every child endpoint — campaigns, media, funding and\n * the rest all work when the id is named. So an empty list is a discovery problem, never a\n * broken grant, and telling the user to reconnect sends them round a loop that cannot help.\n */\nexport const NO_X_ACCOUNTS_EXPLANATION =\n  \"The X Ads connection is live, but X lists no ads accounts for it. That is usually an account \" +\n  \"X has not activated for advertising yet — most often one with no billing set up. It does not \" +\n  \"mean the connection failed, and reconnecting will not change it. An account X omits here still \" +\n  \"works everywhere else: take its id from the ads.x.com URL (ads.x.com/manager/<id>/…) and pass \" +\n  \"--account-id <id>, or set BAKER_X_ADS_ACCOUNT_ID.\";\n\nasync function fetchXAccounts(useCache: boolean): Promise<XAccountInfo[]> {\n  if (useCache) {\n    const cached = cacheGet<XAccountInfo[]>(\"x-accounts\", \"list\");\n    if (cached) return cached.data;\n  }\n  const params = !useCache ? { \"skip-cache\": \"true\" } : undefined;\n  const data = await apiGet<XAccountInfo[]>(\"/api/ads/x/accounts\", params);\n  if (useCache) {\n    cacheSet(\"x-accounts\", \"list\", data, ACCOUNTS_CACHE_TTL_MS);\n  }\n  return data;\n}\n\n/**\n * Resolve an X Ads account_id from either --account-id, BAKER_X_ADS_ACCOUNT_ID, or\n * (if exactly one account is connected) auto-detect.\n */\nexport async function resolveXAccountId(args: Record<string, unknown>): Promise<string> {\n  const fromArgs = args[\"account-id\"] as string | undefined;\n  const accountId = fromArgs || getEnv().BAKER_X_ADS_ACCOUNT_ID;\n  if (accountId) {\n    if (!/^[a-z0-9]+$/.test(accountId)) {\n      writeAdsJson({\n        ok: false,\n        error: {\n          code: \"INVALID_ACCOUNT_ID\",\n          message:\n            \"X Ads account ID must be a base36 string (lowercase letters and digits). Pass --account-id or set BAKER_X_ADS_ACCOUNT_ID.\",\n        },\n      });\n      process.exit(1);\n    }\n    return accountId;\n  }\n\n  const useCache = !args[\"no-cache\"];\n  try {\n    const accounts = await fetchXAccounts(useCache);\n    const [single] = accounts;\n    if (accounts.length === 1 && single) {\n      process.stderr.write(`Using account \"${single.name}\" (${single.id})\\n`);\n      return single.id;\n    }\n    if (accounts.length === 0) {\n      // Not a connection failure — see NO_X_ACCOUNTS_EXPLANATION.\n      writeAdsJson({\n        ok: false,\n        error: {\n          code: \"INVALID_ACCOUNT_ID\",\n          message: NO_X_ACCOUNTS_EXPLANATION,\n          fix: { action: \"reject\", explanation: NO_X_ACCOUNTS_EXPLANATION },\n          retryable: false,\n        },\n      });\n      process.exit(1);\n    }\n    const list = accounts.map((a) => `  ${a.id}  ${a.name}`).join(\"\\n\");\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: \"MULTIPLE_ACCOUNTS\",\n        message: `Multiple X Ads accounts found. Pass --account-id or set BAKER_X_ADS_ACCOUNT_ID:\\n${list}`,\n      },\n    });\n    process.exit(1);\n  } catch (err) {\n    if (err instanceof ApiError && needsConnectionFix(err.code, err.message)) {\n      handleConnectionError(\"x_ads\", err.message);\n    }\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: \"INVALID_ACCOUNT_ID\",\n        message: \"Could not auto-detect account. Pass --account-id or set BAKER_X_ADS_ACCOUNT_ID.\",\n      },\n    });\n    process.exit(1);\n  }\n}\n\n/**\n * The account's own timezone, which X Ads measures a DAY-granularity window against.\n * Falls back to UTC when the account cannot be read — X names the mismatch clearly enough.\n */\nexport async function resolveXAccountTimezone(accountId: string, args: Record<string, unknown>): Promise<string> {\n  try {\n    const accounts = await fetchXAccounts(!args[\"no-cache\"]);\n    return accounts.find((a) => a.id === accountId)?.timezone || \"UTC\";\n  } catch {\n    return \"UTC\";\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAcA,IAAM,wBAAwB,KAAK,KAAK;AAQjC,IAAM,4BACX;AAMF,eAAe,eAAe,UAA4C;AACxE,MAAI,UAAU;AACZ,UAAM,SAAS,SAAyB,cAAc,MAAM;AAC5D,QAAI,OAAQ,QAAO,OAAO;AAAA,EAC5B;AACA,QAAM,SAAS,CAAC,WAAW,EAAE,cAAc,OAAO,IAAI;AACtD,QAAM,OAAO,MAAM,OAAuB,uBAAuB,MAAM;AACvE,MAAI,UAAU;AACZ,aAAS,cAAc,QAAQ,MAAM,qBAAqB;AAAA,EAC5D;AACA,SAAO;AACT;AAMA,eAAsB,kBAAkB,MAAgD;AACtF,QAAM,WAAW,KAAK,YAAY;AAClC,QAAM,YAAY,YAAY,OAAO,EAAE;AACvC,MAAI,WAAW;AACb,QAAI,CAAC,cAAc,KAAK,SAAS,GAAG;AAClC,mBAAa;AAAA,QACX,IAAI;AAAA,QACJ,OAAO;AAAA,UACL,MAAM;AAAA,UACN,SACE;AAAA,QACJ;AAAA,MACF,CAAC;AACD,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,CAAC,KAAK,UAAU;AACjC,MAAI;AACF,UAAM,WAAW,MAAM,eAAe,QAAQ;AAC9C,UAAM,CAAC,MAAM,IAAI;AACjB,QAAI,SAAS,WAAW,KAAK,QAAQ;AACnC,cAAQ,OAAO,MAAM,kBAAkB,OAAO,IAAI,MAAM,OAAO,EAAE;AAAA,CAAK;AACtE,aAAO,OAAO;AAAA,IAChB;AACA,QAAI,SAAS,WAAW,GAAG;AAEzB,mBAAa;AAAA,QACX,IAAI;AAAA,QACJ,OAAO;AAAA,UACL,MAAM;AAAA,UACN,SAAS;AAAA,UACT,KAAK,EAAE,QAAQ,UAAU,aAAa,0BAA0B;AAAA,UAChE,WAAW;AAAA,QACb;AAAA,MACF,CAAC;AACD,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,UAAM,OAAO,SAAS,IAAI,CAAC,MAAM,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,IAAI;AAClE,iBAAa;AAAA,MACX,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,MAAM;AAAA,QACN,SAAS;AAAA,EAAoF,IAAI;AAAA,MACnG;AAAA,IACF,CAAC;AACD,YAAQ,KAAK,CAAC;AAAA,EAChB,SAAS,KAAK;AACZ,QAAI,eAAe,YAAY,mBAAmB,IAAI,MAAM,IAAI,OAAO,GAAG;AACxE,4BAAsB,SAAS,IAAI,OAAO;AAAA,IAC5C;AACA,iBAAa;AAAA,MACX,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,MAAM;AAAA,QACN,SAAS;AAAA,MACX;AAAA,IACF,CAAC;AACD,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;AAMA,eAAsB,wBAAwB,WAAmB,MAAgD;AAC/G,MAAI;AACF,UAAM,WAAW,MAAM,eAAe,CAAC,KAAK,UAAU,CAAC;AACvD,WAAO,SAAS,KAAK,CAAC,MAAM,EAAE,OAAO,SAAS,GAAG,YAAY;AAAA,EAC/D,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/chunk-GIW7ABMM.js

@@ -0,0 +1,74 @@
+import {
+  cacheGet,
+  cacheSet,
+  handleConnectionError,
+  needsConnectionFix,
+  writeJsonEnvelope
+} from "./chunk-BVM5IRZW.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-HREWXNTO.js";
+import {
+  getEnv
+} from "./chunk-O6QKCJE4.js";
+
+// src/commands/gsc/resolve.ts
+async function fetchSites(useCache = true) {
+  if (useCache) {
+    const cached = cacheGet("gsc-sites", "list");
+    if (cached) return cached.data;
+  }
+  const params = !useCache ? { "skip-cache": "true" } : void 0;
+  const data = await apiGet("/api/gsc/sites", params);
+  if (useCache) {
+    cacheSet("gsc-sites", "list", data, 60 * 60 * 1e3);
+  }
+  return data;
+}
+async function resolveSiteUrl(args) {
+  const fromArgs = args["site-url"];
+  const fromEnv = getEnv().BAKER_GSC_SITE_URL;
+  const siteUrl = fromArgs || fromEnv;
+  if (siteUrl) return siteUrl;
+  const useCache = !args["no-cache"];
+  try {
+    const sites = await fetchSites(useCache);
+    const [single] = sites;
+    if (sites.length === 1 && single) {
+      process.stderr.write(`Using site "${single.siteUrl}"
+`);
+      return single.siteUrl;
+    }
+    if (sites.length === 0) {
+      handleConnectionError("gsc");
+    }
+    const list = sites.map((s) => `  ${s.siteUrl}  (${s.permissionLevel})`).join("\n");
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: "MULTIPLE_SITES",
+        message: `Multiple sites found. Pass --site-url or set BAKER_GSC_SITE_URL:
+${list}`
+      }
+    });
+    process.exit(1);
+  } catch (err) {
+    if (err instanceof ApiError && needsConnectionFix(err.code, err.message)) {
+      handleConnectionError("gsc", err.message);
+    }
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: "RESOLUTION_ERROR",
+        message: "Could not auto-detect site. Pass --site-url or set BAKER_GSC_SITE_URL."
+      }
+    });
+    process.exit(1);
+  }
+}
+
+export {
+  resolveSiteUrl
+};
+//# sourceMappingURL=chunk-GIW7ABMM.js.map

package/dist/chunk-GIW7ABMM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/gsc/resolve.ts"],"sourcesContent":["import { ApiError, apiGet } from \"../../client.ts\";\nimport { getEnv } from \"../../env.ts\";\nimport { handleConnectionError, needsConnectionFix } from \"../../error-handler.ts\";\nimport { cacheGet, cacheSet } from \"../ads/cache.ts\";\nimport { writeJsonEnvelope } from \"../ads/output.ts\";\n\ninterface GscSite {\n  siteUrl: string;\n  permissionLevel: string;\n}\n\nasync function fetchSites(useCache = true): Promise<GscSite[]> {\n  if (useCache) {\n    const cached = cacheGet<GscSite[]>(\"gsc-sites\", \"list\");\n    if (cached) return cached.data;\n  }\n  const params = !useCache ? { \"skip-cache\": \"true\" } : undefined;\n  const data = await apiGet<GscSite[]>(\"/api/gsc/sites\", params);\n  if (useCache) {\n    cacheSet(\"gsc-sites\", \"list\", data, 60 * 60 * 1000);\n  }\n  return data;\n}\n\nexport async function resolveSiteUrl(args: Record<string, unknown>): Promise<string> {\n  const fromArgs = args[\"site-url\"] as string | undefined;\n  const fromEnv = getEnv().BAKER_GSC_SITE_URL;\n  const siteUrl = fromArgs || fromEnv;\n\n  if (siteUrl) return siteUrl;\n\n  const useCache = !args[\"no-cache\"];\n\n  try {\n    const sites = await fetchSites(useCache);\n    const [single] = sites;\n    if (sites.length === 1 && single) {\n      process.stderr.write(`Using site \"${single.siteUrl}\"\\n`);\n      return single.siteUrl;\n    }\n    if (sites.length === 0) {\n      handleConnectionError(\"gsc\");\n    }\n    const list = sites.map((s) => `  ${s.siteUrl}  (${s.permissionLevel})`).join(\"\\n\");\n    writeJsonEnvelope({\n      ok: false,\n      error: {\n        code: \"MULTIPLE_SITES\",\n        message: `Multiple sites found. Pass --site-url or set BAKER_GSC_SITE_URL:\\n${list}`,\n      },\n    });\n    process.exit(1);\n  } catch (err) {\n    // The listing call is the only thing that can throw here, so a 401/404 from\n    // it means the connection is missing — not that resolution is ambiguous.\n    if (err instanceof ApiError && needsConnectionFix(err.code, err.message)) {\n      handleConnectionError(\"gsc\", err.message);\n    }\n    writeJsonEnvelope({\n      ok: false,\n      error: {\n        code: \"RESOLUTION_ERROR\",\n        message: \"Could not auto-detect site. Pass --site-url or set BAKER_GSC_SITE_URL.\",\n      },\n    });\n    process.exit(1);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAWA,eAAe,WAAW,WAAW,MAA0B;AAC7D,MAAI,UAAU;AACZ,UAAM,SAAS,SAAoB,aAAa,MAAM;AACtD,QAAI,OAAQ,QAAO,OAAO;AAAA,EAC5B;AACA,QAAM,SAAS,CAAC,WAAW,EAAE,cAAc,OAAO,IAAI;AACtD,QAAM,OAAO,MAAM,OAAkB,kBAAkB,MAAM;AAC7D,MAAI,UAAU;AACZ,aAAS,aAAa,QAAQ,MAAM,KAAK,KAAK,GAAI;AAAA,EACpD;AACA,SAAO;AACT;AAEA,eAAsB,eAAe,MAAgD;AACnF,QAAM,WAAW,KAAK,UAAU;AAChC,QAAM,UAAU,OAAO,EAAE;AACzB,QAAM,UAAU,YAAY;AAE5B,MAAI,QAAS,QAAO;AAEpB,QAAM,WAAW,CAAC,KAAK,UAAU;AAEjC,MAAI;AACF,UAAM,QAAQ,MAAM,WAAW,QAAQ;AACvC,UAAM,CAAC,MAAM,IAAI;AACjB,QAAI,MAAM,WAAW,KAAK,QAAQ;AAChC,cAAQ,OAAO,MAAM,eAAe,OAAO,OAAO;AAAA,CAAK;AACvD,aAAO,OAAO;AAAA,IAChB;AACA,QAAI,MAAM,WAAW,GAAG;AACtB,4BAAsB,KAAK;AAAA,IAC7B;AACA,UAAM,OAAO,MAAM,IAAI,CAAC,MAAM,KAAK,EAAE,OAAO,MAAM,EAAE,eAAe,GAAG,EAAE,KAAK,IAAI;AACjF,sBAAkB;AAAA,MAChB,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,MAAM;AAAA,QACN,SAAS;AAAA,EAAqE,IAAI;AAAA,MACpF;AAAA,IACF,CAAC;AACD,YAAQ,KAAK,CAAC;AAAA,EAChB,SAAS,KAAK;AAGZ,QAAI,eAAe,YAAY,mBAAmB,IAAI,MAAM,IAAI,OAAO,GAAG;AACxE,4BAAsB,OAAO,IAAI,OAAO;AAAA,IAC1C;AACA,sBAAkB;AAAA,MAChB,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,MAAM;AAAA,QACN,SAAS;AAAA,MACX;AAAA,IACF,CAAC;AACD,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}

package/dist/chunk-GIWHHCD6.js

@@ -0,0 +1,145 @@
+// ../api/src/decide.ts
+import { z } from "zod";
+var DECIDE_MAX_QUESTIONS = 2e3;
+var DECIDE_MAX_NAMED_QUESTIONS = 40;
+var DECIDE_MAX_ITEMS = 500;
+var DECIDE_MAX_ITEM_CHARS = 4e3;
+var DECIDE_MAX_STATE_CHARS = 5e4;
+var DECIDE_MAX_OPTIONS = 255;
+var DECIDE_MAX_REQUEST_CHARS = 6e4;
+var LIMIT = { decideLimit: true };
+var questionText = z.string().trim().min(1, "a question cannot be empty").max(1e3);
+var optionKey = z.string().regex(/^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/, "option keys are short slugs: letters, digits, - and _");
+var decideQuestionSchema = z.discriminatedUnion("type", [
+  z.object({ type: z.literal("noul"), question: questionText }),
+  z.object({
+    type: z.literal("choice"),
+    question: questionText,
+    /** Option key → what it means, in words. Jev picks exactly one. */
+    options: z.record(optionKey, z.string().trim().min(1).max(300)).refine((options) => Object.keys(options).length >= 2, "a choice needs at least 2 options").refine(
+      (options) => Object.keys(options).length <= DECIDE_MAX_OPTIONS,
+      `a choice takes at most ${DECIDE_MAX_OPTIONS} options`
+    )
+  }),
+  z.object({
+    type: z.literal("score"),
+    question: questionText,
+    /** The levels in words, lowest first. */
+    levels: z.array(z.string().trim().min(1).max(300)).min(2).max(10).refine((levels) => new Set(levels).size === levels.length, "a score's levels must be different")
+  })
+]);
+var questionName = z.string().regex(/^[A-Za-z][A-Za-z0-9_]{0,47}$/, "question names are identifiers: a letter, then letters, digits or _");
+var jsonChars = (value) => JSON.stringify(value)?.length ?? 0;
+function decideQuestionChars(question, item) {
+  return jsonChars(item === void 0 ? question : { item, ...question });
+}
+var decideItemSchema = z.object({
+  id: z.string().trim().min(1).max(200),
+  /** The item's words, or its named fields (`{ "angle": "…", "summary": "…" }`). Text only. */
+  text: z.union([z.string().trim().min(1), z.record(z.string(), z.unknown())])
+}).superRefine((item, ctx) => {
+  const chars = jsonChars(item.text);
+  if (chars > DECIDE_MAX_ITEM_CHARS) {
+    ctx.addIssue({
+      code: "custom",
+      params: LIMIT,
+      path: ["text"],
+      message: `item "${item.id}" is ${chars} characters; one item takes at most ${DECIDE_MAX_ITEM_CHARS}`
+    });
+  }
+});
+var decideRequestSchema = z.object({
+  questions: z.record(questionName, decideQuestionSchema).refine((questions) => Object.keys(questions).length >= 1, "ask at least one question").refine((questions) => Object.keys(questions).length <= DECIDE_MAX_NAMED_QUESTIONS, {
+    message: `at most ${DECIDE_MAX_NAMED_QUESTIONS} named questions per call`,
+    params: LIMIT
+  }),
+  /** What every question reads beside its item (or on its own, with no items). */
+  state: z.union([z.string(), z.record(z.string(), z.unknown()), z.array(z.unknown())]).refine((state) => jsonChars(state) <= DECIDE_MAX_STATE_CHARS, {
+    message: `state is longer than ${DECIDE_MAX_STATE_CHARS} characters`,
+    params: LIMIT
+  }).optional(),
+  items: z.array(decideItemSchema).min(1).max(DECIDE_MAX_ITEMS).optional(),
+  /** Every option's probability on Choices and Scores, not only the pick's. */
+  full: z.boolean().default(false)
+}).superRefine((request, ctx) => {
+  const ids = /* @__PURE__ */ new Set();
+  for (const [index, item] of (request.items ?? []).entries()) {
+    if (ids.has(item.id)) {
+      ctx.addIssue({ code: "custom", path: ["items", index, "id"], message: `item id "${item.id}" appears twice` });
+      return;
+    }
+    ids.add(item.id);
+  }
+  const asked = Object.keys(request.questions).length * (request.items?.length ?? 1);
+  if (asked > DECIDE_MAX_QUESTIONS) {
+    ctx.addIssue({
+      code: "custom",
+      params: LIMIT,
+      path: ["items"],
+      message: `this call asks ${asked} questions (items \xD7 named questions); one call asks at most ${DECIDE_MAX_QUESTIONS}`
+    });
+    return;
+  }
+  const questions = Object.values(request.questions);
+  const stateChars = request.state === void 0 ? 0 : jsonChars(request.state);
+  const subjects = request.items ? request.items.map((item, index) => ({ id: item.id, text: item.text, index })) : [{ id: null }];
+  for (const subject of subjects) {
+    const chars = stateChars + questions.reduce((total, question) => total + decideQuestionChars(question, subject.text), 0);
+    if (chars <= DECIDE_MAX_REQUEST_CHARS) continue;
+    const what = subject.id === null ? "the questions" : `item "${subject.id}" with its ${questions.length} questions`;
+    ctx.addIssue({
+      code: "custom",
+      params: LIMIT,
+      path: subject.index === void 0 ? ["state"] : ["items", subject.index, "text"],
+      message: `${what} and the state come to ${chars} characters, and one request carries at most ${DECIDE_MAX_REQUEST_CHARS}: ask fewer questions per call, shorten the state, or trim the item`
+    });
+    return;
+  }
+});
+function isDecideLimitIssue(issue) {
+  if (issue.code === "too_big" && issue.path.length === 1 && issue.path[0] === "items") return true;
+  return issue.code === "custom" && issue.params?.decideLimit === true;
+}
+var probabilities = z.record(z.string(), z.number());
+var decideAnswerSchema = z.union([
+  z.object({ noul: z.number() }),
+  z.object({
+    choice: z.string(),
+    /** The pick's own probability. */
+    probability: z.number(),
+    /** How concentrated the distribution is; low means torn between options. */
+    confidence: z.number(),
+    probabilities: probabilities.optional()
+  }),
+  z.object({
+    /** The probability-weighted level, 0 = the first level; can land between levels. */
+    score: z.number(),
+    /** The level `score` rounds to, in words. */
+    level: z.string(),
+    confidence: z.number(),
+    probabilities: probabilities.optional()
+  })
+]);
+var answersByName = z.record(z.string(), decideAnswerSchema);
+var decideResponseSchema = z.object({
+  model: z.string(),
+  /** With no items: each named question's answer about `state`. */
+  answers: answersByName.optional(),
+  /** With items: each item's answers, in the order sent; `null` when Jev did not answer that item. */
+  items: z.array(z.object({ id: z.string(), answers: answersByName.nullable() })).optional(),
+  /** Ids of the items Jev did not answer (their request failed); the rest stand. */
+  unanswered: z.array(z.string()),
+  /** Jev requests the call was packed into (sent at once). */
+  requests: z.number(),
+  costUsd: z.number()
+});
+
+export {
+  DECIDE_MAX_QUESTIONS,
+  DECIDE_MAX_ITEMS,
+  DECIDE_MAX_ITEM_CHARS,
+  DECIDE_MAX_REQUEST_CHARS,
+  decideRequestSchema,
+  isDecideLimitIssue
+};
+//# sourceMappingURL=chunk-GIWHHCD6.js.map

package/dist/chunk-GIWHHCD6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../api/src/decide.ts"],"sourcesContent":["/**\n * `baker decide` — the wire contract for asking Jev (the decision model, see\n * docs/decision-model.md) typed questions about text and getting typed answers\n * back: a yes/no probability (Noul), one option of a set (Choice), or a level\n * on a scale (Score).\n *\n * Named questions are asked once about `state`, or — with `items` — once about\n * every item, each item inside its own question's instructions. The backend\n * packs the questions into as few Jev requests as fit and sends them at once.\n * Read-only: it decides, it never writes or generates anything.\n */\nimport { z } from \"zod\";\n\n/** Items × named questions in one call. Past it, split the items across calls. */\nexport const DECIDE_MAX_QUESTIONS = 2000;\nexport const DECIDE_MAX_NAMED_QUESTIONS = 40;\nexport const DECIDE_MAX_ITEMS = 500;\n/** One item's text (or its fields, as JSON). An ad's summary, angle and copy fit well within it. */\nexport const DECIDE_MAX_ITEM_CHARS = 4000;\n/** The shared `state`, as JSON. It goes in every request, so it leaves room there for the questions. */\nexport const DECIDE_MAX_STATE_CHARS = 50_000;\nexport const DECIDE_MAX_OPTIONS = 255;\n/** What one Jev request carries — the state and every question in it, items inside — under Jev's 32k-token context. */\nexport const DECIDE_MAX_REQUEST_CHARS = 60_000;\n\n/** Marks an issue a smaller call fixes (fewer items or questions, a shorter item or state), not a wrong one. */\nconst LIMIT = { decideLimit: true };\n\nconst questionText = z.string().trim().min(1, \"a question cannot be empty\").max(1000);\nconst optionKey = z\n  .string()\n  .regex(/^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/, \"option keys are short slugs: letters, digits, - and _\");\n\nconst decideQuestionSchema = z.discriminatedUnion(\"type\", [\n  z.object({ type: z.literal(\"noul\"), question: questionText }),\n  z.object({\n    type: z.literal(\"choice\"),\n    question: questionText,\n    /** Option key → what it means, in words. Jev picks exactly one. */\n    options: z\n      .record(optionKey, z.string().trim().min(1).max(300))\n      .refine((options) => Object.keys(options).length >= 2, \"a choice needs at least 2 options\")\n      .refine(\n        (options) => Object.keys(options).length <= DECIDE_MAX_OPTIONS,\n        `a choice takes at most ${DECIDE_MAX_OPTIONS} options`,\n      ),\n  }),\n  z.object({\n    type: z.literal(\"score\"),\n    question: questionText,\n    /** The levels in words, lowest first. */\n    levels: z\n      .array(z.string().trim().min(1).max(300))\n      .min(2)\n      .max(10)\n      .refine((levels) => new Set(levels).size === levels.length, \"a score's levels must be different\"),\n  }),\n]);\n\nexport type DecideQuestion = z.infer<typeof decideQuestionSchema>;\n\nconst questionName = z\n  .string()\n  .regex(/^[A-Za-z][A-Za-z0-9_]{0,47}$/, \"question names are identifiers: a letter, then letters, digits or _\");\n\nconst jsonChars = (value: unknown) => JSON.stringify(value)?.length ?? 0;\n\n/** One named question as one request carries it, with the item it is asked about. The budget `DECIDE_MAX_REQUEST_CHARS` counts. */\nexport function decideQuestionChars(question: DecideQuestion, item?: unknown): number {\n  return jsonChars(item === undefined ? question : { item, ...question });\n}\n\nconst decideItemSchema = z\n  .object({\n    id: z.string().trim().min(1).max(200),\n    /** The item's words, or its named fields (`{ \"angle\": \"…\", \"summary\": \"…\" }`). Text only. */\n    text: z.union([z.string().trim().min(1), z.record(z.string(), z.unknown())]),\n  })\n  .superRefine((item, ctx) => {\n    const chars = jsonChars(item.text);\n    if (chars > DECIDE_MAX_ITEM_CHARS) {\n      ctx.addIssue({\n        code: \"custom\",\n        params: LIMIT,\n        path: [\"text\"],\n        message: `item \"${item.id}\" is ${chars} characters; one item takes at most ${DECIDE_MAX_ITEM_CHARS}`,\n      });\n    }\n  });\n\nexport type DecideItem = z.infer<typeof decideItemSchema>;\n\nexport const decideRequestSchema = z\n  .object({\n    questions: z\n      .record(questionName, decideQuestionSchema)\n      .refine((questions) => Object.keys(questions).length >= 1, \"ask at least one question\")\n      .refine((questions) => Object.keys(questions).length <= DECIDE_MAX_NAMED_QUESTIONS, {\n        message: `at most ${DECIDE_MAX_NAMED_QUESTIONS} named questions per call`,\n        params: LIMIT,\n      }),\n    /** What every question reads beside its item (or on its own, with no items). */\n    state: z\n      .union([z.string(), z.record(z.string(), z.unknown()), z.array(z.unknown())])\n      .refine((state) => jsonChars(state) <= DECIDE_MAX_STATE_CHARS, {\n        message: `state is longer than ${DECIDE_MAX_STATE_CHARS} characters`,\n        params: LIMIT,\n      })\n      .optional(),\n    items: z.array(decideItemSchema).min(1).max(DECIDE_MAX_ITEMS).optional(),\n    /** Every option's probability on Choices and Scores, not only the pick's. */\n    full: z.boolean().default(false),\n  })\n  .superRefine((request, ctx) => {\n    const ids = new Set<string>();\n    for (const [index, item] of (request.items ?? []).entries()) {\n      if (ids.has(item.id)) {\n        ctx.addIssue({ code: \"custom\", path: [\"items\", index, \"id\"], message: `item id \"${item.id}\" appears twice` });\n        return;\n      }\n      ids.add(item.id);\n    }\n    const asked = Object.keys(request.questions).length * (request.items?.length ?? 1);\n    if (asked > DECIDE_MAX_QUESTIONS) {\n      ctx.addIssue({\n        code: \"custom\",\n        params: LIMIT,\n        path: [\"items\"],\n        message: `this call asks ${asked} questions (items × named questions); one call asks at most ${DECIDE_MAX_QUESTIONS}`,\n      });\n      return;\n    }\n    // Every question about one item goes in one request, beside the whole state: past the budget, no request can carry it.\n    const questions = Object.values(request.questions);\n    const stateChars = request.state === undefined ? 0 : jsonChars(request.state);\n    const subjects: { id: string | null; text?: unknown; index?: number }[] = request.items\n      ? request.items.map((item, index) => ({ id: item.id, text: item.text, index }))\n      : [{ id: null }];\n    for (const subject of subjects) {\n      const chars =\n        stateChars + questions.reduce((total, question) => total + decideQuestionChars(question, subject.text), 0);\n      if (chars <= DECIDE_MAX_REQUEST_CHARS) continue;\n      const what =\n        subject.id === null ? \"the questions\" : `item \"${subject.id}\" with its ${questions.length} questions`;\n      ctx.addIssue({\n        code: \"custom\",\n        params: LIMIT,\n        path: subject.index === undefined ? [\"state\"] : [\"items\", subject.index, \"text\"],\n        message: `${what} and the state come to ${chars} characters, and one request carries at most ${DECIDE_MAX_REQUEST_CHARS}: ask fewer questions per call, shorten the state, or trim the item`,\n      });\n      return;\n    }\n  });\n\n/** Whether a refusal is a size limit, which a smaller call fixes, rather than input that is wrong. */\nexport function isDecideLimitIssue(issue: z.core.$ZodIssue): boolean {\n  if (issue.code === \"too_big\" && issue.path.length === 1 && issue.path[0] === \"items\") return true;\n  return issue.code === \"custom\" && issue.params?.decideLimit === true;\n}\n\nexport type DecideRequest = z.input<typeof decideRequestSchema>;\nexport type DecideRequestParsed = z.output<typeof decideRequestSchema>;\n\nconst probabilities = z.record(z.string(), z.number());\n\nexport const decideAnswerSchema = z.union([\n  z.object({ noul: z.number() }),\n  z.object({\n    choice: z.string(),\n    /** The pick's own probability. */\n    probability: z.number(),\n    /** How concentrated the distribution is; low means torn between options. */\n    confidence: z.number(),\n    probabilities: probabilities.optional(),\n  }),\n  z.object({\n    /** The probability-weighted level, 0 = the first level; can land between levels. */\n    score: z.number(),\n    /** The level `score` rounds to, in words. */\n    level: z.string(),\n    confidence: z.number(),\n    probabilities: probabilities.optional(),\n  }),\n]);\n\nexport type DecideAnswer = z.infer<typeof decideAnswerSchema>;\n\nconst answersByName = z.record(z.string(), decideAnswerSchema);\n\nexport const decideResponseSchema = z.object({\n  model: z.string(),\n  /** With no items: each named question's answer about `state`. */\n  answers: answersByName.optional(),\n  /** With items: each item's answers, in the order sent; `null` when Jev did not answer that item. */\n  items: z.array(z.object({ id: z.string(), answers: answersByName.nullable() })).optional(),\n  /** Ids of the items Jev did not answer (their request failed); the rest stand. */\n  unanswered: z.array(z.string()),\n  /** Jev requests the call was packed into (sent at once). */\n  requests: z.number(),\n  costUsd: z.number(),\n});\n\nexport type DecideResponse = z.infer<typeof decideResponseSchema>;\n"],"mappings":"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","names":[]}