@aglyn/plugins-ai 1.0.0-beta.250 → 1.0.0-beta.252

package/src/lib/runtime/ai-dev-env.d.ts

@@ -22,6 +22,7 @@
  * system module into a server that will never use one. Every answer is `off`
  * in a deployed server.
  */
+import type { AiEffort } from '../providers/contract';
 export type AiDevReplayMode = 'off' | 'replay' | 'refresh';
 /** The variable that turns the replay cache on, off, or to refresh. */
 export declare const AI_REPLAY_ENV = "AGLYN_AI_REPLAY";
@@ -34,6 +35,17 @@ export declare const AI_LIVE_LAUNCHER_ENV = "AI_EVAL_LIVE_LAUNCHER";
 export type AiDevEnv = Readonly<Record<string, string | undefined>>;
 /** Whether this process is a deployed server, where no development layer may run. */
 export declare function aiIsDeployedRuntime(env?: AiDevEnv): boolean;
+/** The variable every live spec is started with. */
+export declare const AI_LIVE_RUN_ENV = "AGLYN_LIVE_AI";
+/**
+ * Whether this process is a development run that asked for the live
+ * provider: through the launcher, or a live spec started with
+ * `AGLYN_LIVE_AI=1` (AGL-3781). Every development layer is on by default in
+ * such a run — a live spec started without the launcher's mark used to send
+ * every request again, at the five-minute cache and full price — and each can
+ * still be turned off by its own variable.
+ */
+export declare function aiUnderLiveRun(env?: AiDevEnv): boolean;
 /** The replay mode this process runs under; `off` in any deployed server. */
 export declare function aiDevReplayMode(env?: AiDevEnv): AiDevReplayMode;
 /**
@@ -49,5 +61,29 @@ export declare function aiDevCacheTtl(env?: AiDevEnv): '1h' | undefined;
 export declare function aiWarnIfReplayAskedInDeployment(env?: AiDevEnv): void;
 /** The variable that turns batch mode on (`runtime/ai-live-batch.ts`). */
 export declare const AI_LIVE_BATCH_ENV = "AGLYN_LIVE_AI_BATCH";
-/** Whether this process batches its live requests. */
+/**
+ * Whether this process batches its live requests: what `AGLYN_LIVE_AI_BATCH`
+ * says, and in a live run that says nothing, yes (AGL-3781). Nobody waits on
+ * an eval's answers, and a batch is half price on every token, cache reads
+ * and writes included; `AGLYN_LIVE_AI_BATCH=0` is for the quick single run an
+ * iteration wants back in seconds.
+ */
 export declare function aiLiveBatchWanted(env?: AiDevEnv): boolean;
+/**
+ * The most a batched live run may take: the adapter waits up to an hour on
+ * each batch, and a run's requests go as a few batches one after another —
+ * the answers, their re-asks, the grades. A spec that timed out would keep
+ * none of the answers it already paid for, so the bound is the worst case.
+ */
+export declare const AI_LIVE_BATCH_TIMEOUT_MS: number;
+/** A live spec's timeout: `baseMs`, or the batched run's when this run batches. */
+export declare function aiLiveTimeoutMs(baseMs: number, env?: AiDevEnv): number;
+/**
+ * The variable an effort A/B names its arm with (AGL-3781): a step kind's
+ * effort for this run, as `job.form:medium,job.text:low`, or `*:medium` for
+ * every kind. A development run only, so the defaults stay where production
+ * runs them until a recorded round shows a lower effort holds.
+ */
+export declare const AI_EFFORT_ARM_ENV = "AGLYN_AI_EFFORT";
+/** The effort this development run's A/B arm asks `step` at, or `undefined` for the step's own. */
+export declare function aiDevEffortFor(step: string | undefined, env?: AiDevEnv): AiEffort | undefined;

package/src/lib/runtime/ai-dev-env.js

@@ -27,8 +27,18 @@
 /** Whether this process is a deployed server, where no development layer may run. */ export function aiIsDeployedRuntime(env = process.env) {
     return env['NODE_ENV'] === 'production' || env['VERCEL_ENV'] === 'production' || env['VERCEL_ENV'] === 'preview' || Boolean(env['K_SERVICE']);
 }
-/** Whether this process is a development run that asked for the live provider through the launcher. */ function underLiveLauncher(env) {
-    return Boolean(env[AI_LIVE_LAUNCHER_ENV]);
+/** The variable every live spec is started with. */ export const AI_LIVE_RUN_ENV = 'AGLYN_LIVE_AI';
+/**
+ * Whether this process is a development run that asked for the live
+ * provider: through the launcher, or a live spec started with
+ * `AGLYN_LIVE_AI=1` (AGL-3781). Every development layer is on by default in
+ * such a run — a live spec started without the launcher's mark used to send
+ * every request again, at the five-minute cache and full price — and each can
+ * still be turned off by its own variable.
+ */ export function aiUnderLiveRun(env = process.env) {
+    var _env_AI_LIVE_RUN_ENV;
+    if (aiIsDeployedRuntime(env)) return false;
+    return Boolean(env[AI_LIVE_LAUNCHER_ENV]) || String((_env_AI_LIVE_RUN_ENV = env[AI_LIVE_RUN_ENV]) != null ? _env_AI_LIVE_RUN_ENV : '').trim() === '1';
 }
 /** The replay mode this process runs under; `off` in any deployed server. */ export function aiDevReplayMode(env = process.env) {
     var _env_AI_REPLAY_ENV;
@@ -37,7 +47,7 @@
     if (raw === 'refresh') return 'refresh';
     if (raw === '1' || raw === 'on' || raw === 'true' || raw === 'replay') return 'replay';
     if (raw === '0' || raw === 'off' || raw === 'false') return 'off';
-    return underLiveLauncher(env) ? 'replay' : 'off';
+    return aiUnderLiveRun(env) ? 'replay' : 'off';
 }
 /**
  * The prompt-cache lifetime a development run asks for. An agent re-runs a
@@ -53,7 +63,7 @@
     const raw = String((_env_AI_DEV_CACHE_TTL_ENV = env[AI_DEV_CACHE_TTL_ENV]) != null ? _env_AI_DEV_CACHE_TTL_ENV : '').trim().toLowerCase();
     if (raw === '1h') return '1h';
     if (raw === '5m') return undefined;
-    return underLiveLauncher(env) ? '1h' : undefined;
+    return aiUnderLiveRun(env) ? '1h' : undefined;
 }
 /** A deployed server that was handed the variable says so once, and runs without it. */ let warnedDeployed = false;
 export function aiWarnIfReplayAskedInDeployment(env = process.env) {
@@ -63,10 +73,53 @@ export function aiWarnIfReplayAskedInDeployment(env = process.env) {
     console.error(`[ai] ${AI_REPLAY_ENV} / ${AI_DEV_CACHE_TTL_ENV} are development-only and are ignored in a deployed server`);
 }
 /** The variable that turns batch mode on (`runtime/ai-live-batch.ts`). */ export const AI_LIVE_BATCH_ENV = 'AGLYN_LIVE_AI_BATCH';
-/** Whether this process batches its live requests. */ export function aiLiveBatchWanted(env = process.env) {
+/**
+ * Whether this process batches its live requests: what `AGLYN_LIVE_AI_BATCH`
+ * says, and in a live run that says nothing, yes (AGL-3781). Nobody waits on
+ * an eval's answers, and a batch is half price on every token, cache reads
+ * and writes included; `AGLYN_LIVE_AI_BATCH=0` is for the quick single run an
+ * iteration wants back in seconds.
+ */ export function aiLiveBatchWanted(env = process.env) {
     var _env_AI_LIVE_BATCH_ENV;
     if (aiIsDeployedRuntime(env)) return false;
-    return /^(?:1|true|yes|on)$/i.test(String((_env_AI_LIVE_BATCH_ENV = env[AI_LIVE_BATCH_ENV]) != null ? _env_AI_LIVE_BATCH_ENV : '').trim());
+    const raw = String((_env_AI_LIVE_BATCH_ENV = env[AI_LIVE_BATCH_ENV]) != null ? _env_AI_LIVE_BATCH_ENV : '').trim();
+    if (/^(?:1|true|yes|on)$/i.test(raw)) return true;
+    if (/^(?:0|false|no|off)$/i.test(raw)) return false;
+    return aiUnderLiveRun(env);
+}
+/**
+ * The most a batched live run may take: the adapter waits up to an hour on
+ * each batch, and a run's requests go as a few batches one after another —
+ * the answers, their re-asks, the grades. A spec that timed out would keep
+ * none of the answers it already paid for, so the bound is the worst case.
+ */ export const AI_LIVE_BATCH_TIMEOUT_MS = 5 * 60 * 60000;
+/** A live spec's timeout: `baseMs`, or the batched run's when this run batches. */ export function aiLiveTimeoutMs(baseMs, env = process.env) {
+    return aiLiveBatchWanted(env) ? Math.max(baseMs, AI_LIVE_BATCH_TIMEOUT_MS) : baseMs;
+}
+/**
+ * The variable an effort A/B names its arm with (AGL-3781): a step kind's
+ * effort for this run, as `job.form:medium,job.text:low`, or `*:medium` for
+ * every kind. A development run only, so the defaults stay where production
+ * runs them until a recorded round shows a lower effort holds.
+ */ export const AI_EFFORT_ARM_ENV = 'AGLYN_AI_EFFORT';
+const AI_EFFORT_LEVELS = [
+    'low',
+    'medium',
+    'high'
+];
+/** The effort this development run's A/B arm asks `step` at, or `undefined` for the step's own. */ export function aiDevEffortFor(step, env = process.env) {
+    var _env_AI_EFFORT_ARM_ENV;
+    if (aiIsDeployedRuntime(env)) return undefined;
+    const raw = String((_env_AI_EFFORT_ARM_ENV = env[AI_EFFORT_ARM_ENV]) != null ? _env_AI_EFFORT_ARM_ENV : '').trim();
+    if (!raw) return undefined;
+    let fallback;
+    for (const pair of raw.split(',')){
+        const [kind, level] = pair.split(':').map((part)=>part.trim());
+        if (!AI_EFFORT_LEVELS.includes(level)) continue;
+        if (kind === step) return level;
+        if (kind === '*') fallback = level;
+    }
+    return fallback;
 }
 
 //# sourceMappingURL=ai-dev-env.js.map

package/src/lib/runtime/ai-dev-env.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/runtime/ai-dev-env.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Which development layers this process runs (AGL-3660): the replay cache,\n * the hour-long prompt cache and batch mode, each read from the environment.\n * Kept apart from `ai-dev-replay.ts`, which reads and writes files, so the\n * runtime asks these questions on every request without loading a file\n * system module into a server that will never use one. Every answer is `off`\n * in a deployed server.\n */\n\nexport type AiDevReplayMode = 'off' | 'replay' | 'refresh'\n\n/** The variable that turns the replay cache on, off, or to refresh. */\nexport const AI_REPLAY_ENV = 'AGLYN_AI_REPLAY'\n/** Where the answers are kept, when not under the repository's `.cache/ai-replay`. */\nexport const AI_REPLAY_DIR_ENV = 'AGLYN_AI_REPLAY_DIR'\n/** The prompt-cache lifetime a development run asks for: `1h` or `5m`. */\nexport const AI_DEV_CACHE_TTL_ENV = 'AGLYN_AI_CACHE_TTL'\n/** The mark the live-eval launcher leaves, which `jest.setup.js` also reads. */\nexport const AI_LIVE_LAUNCHER_ENV = 'AI_EVAL_LIVE_LAUNCHER'\n\nexport type AiDevEnv = Readonly<Record<string, string | undefined>>\n\n/** Whether this process is a deployed server, where no development layer may run. */\nexport function aiIsDeployedRuntime(env: AiDevEnv = process.env): boolean {\n  return (\n    env['NODE_ENV'] === 'production' ||\n    env['VERCEL_ENV'] === 'production' ||\n    env['VERCEL_ENV'] === 'preview' ||\n    Boolean(env['K_SERVICE'])\n  )\n}\n\n/** Whether this process is a development run that asked for the live provider through the launcher. */\nfunction underLiveLauncher(env: AiDevEnv): boolean {\n  return Boolean(env[AI_LIVE_LAUNCHER_ENV])\n}\n\n/** The replay mode this process runs under; `off` in any deployed server. */\nexport function aiDevReplayMode(env: AiDevEnv = process.env): AiDevReplayMode {\n  if (aiIsDeployedRuntime(env)) return 'off'\n  const raw = String(env[AI_REPLAY_ENV] ?? '').trim().toLowerCase()\n  if (raw === 'refresh') return 'refresh'\n  if (raw === '1' || raw === 'on' || raw === 'true' || raw === 'replay') return 'replay'\n  if (raw === '0' || raw === 'off' || raw === 'false') return 'off'\n  return underLiveLauncher(env) ? 'replay' : 'off'\n}\n\n/**\n * The prompt-cache lifetime a development run asks for. An agent re-runs a\n * live eval every ten to forty minutes while it iterates, which is past the\n * default five-minute entry and inside an hour, so under the launcher the\n * breakpoints ask for the hour: the second run reads the prefix the first one\n * wrote instead of writing it again. Production keeps the default — its\n * steps run a minute apart on the beat, inside five minutes — and never reads\n * this: `undefined` there.\n */\nexport function aiDevCacheTtl(env: AiDevEnv = process.env): '1h' | undefined {\n  if (aiIsDeployedRuntime(env)) return undefined\n  const raw = String(env[AI_DEV_CACHE_TTL_ENV] ?? '').trim().toLowerCase()\n  if (raw === '1h') return '1h'\n  if (raw === '5m') return undefined\n  return underLiveLauncher(env) ? '1h' : undefined\n}\n\n/** A deployed server that was handed the variable says so once, and runs without it. */\nlet warnedDeployed = false\nexport function aiWarnIfReplayAskedInDeployment(env: AiDevEnv = process.env): void {\n  if (warnedDeployed || !aiIsDeployedRuntime(env)) return\n  if (!env[AI_REPLAY_ENV] && !env[AI_DEV_CACHE_TTL_ENV]) return\n  warnedDeployed = true\n  console.error(\n    `[ai] ${AI_REPLAY_ENV} / ${AI_DEV_CACHE_TTL_ENV} are development-only and are ignored in a deployed server`,\n  )\n}\n\n/** The variable that turns batch mode on (`runtime/ai-live-batch.ts`). */\nexport const AI_LIVE_BATCH_ENV = 'AGLYN_LIVE_AI_BATCH'\n\n/** Whether this process batches its live requests. */\nexport function aiLiveBatchWanted(env: AiDevEnv = process.env): boolean {\n  if (aiIsDeployedRuntime(env)) return false\n  return /^(?:1|true|yes|on)$/i.test(String(env[AI_LIVE_BATCH_ENV] ?? '').trim())\n}\n"],"names":["AI_REPLAY_ENV","AI_REPLAY_DIR_ENV","AI_DEV_CACHE_TTL_ENV","AI_LIVE_LAUNCHER_ENV","aiIsDeployedRuntime","env","process","Boolean","underLiveLauncher","aiDevReplayMode","raw","String","trim","toLowerCase","aiDevCacheTtl","undefined","warnedDeployed","aiWarnIfReplayAskedInDeployment","console","error","AI_LIVE_BATCH_ENV","aiLiveBatchWanted","test"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;CAOC,GAID,qEAAqE,GACrE,OAAO,MAAMA,gBAAgB,kBAAiB;AAC9C,oFAAoF,GACpF,OAAO,MAAMC,oBAAoB,sBAAqB;AACtD,wEAAwE,GACxE,OAAO,MAAMC,uBAAuB,qBAAoB;AACxD,8EAA8E,GAC9E,OAAO,MAAMC,uBAAuB,wBAAuB;AAI3D,mFAAmF,GACnF,OAAO,SAASC,oBAAoBC,MAAgBC,QAAQD,GAAG;IAC7D,OACEA,GAAG,CAAC,WAAW,KAAK,gBACpBA,GAAG,CAAC,aAAa,KAAK,gBACtBA,GAAG,CAAC,aAAa,KAAK,aACtBE,QAAQF,GAAG,CAAC,YAAY;AAE5B;AAEA,qGAAqG,GACrG,SAASG,kBAAkBH,GAAa;IACtC,OAAOE,QAAQF,GAAG,CAACF,qBAAqB;AAC1C;AAEA,2EAA2E,GAC3E,OAAO,SAASM,gBAAgBJ,MAAgBC,QAAQD,GAAG;QAEtCA;IADnB,IAAID,oBAAoBC,MAAM,OAAO;IACrC,MAAMK,MAAMC,QAAON,qBAAAA,GAAG,CAACL,cAAc,YAAlBK,qBAAsB,IAAIO,IAAI,GAAGC,WAAW;IAC/D,IAAIH,QAAQ,WAAW,OAAO;IAC9B,IAAIA,QAAQ,OAAOA,QAAQ,QAAQA,QAAQ,UAAUA,QAAQ,UAAU,OAAO;IAC9E,IAAIA,QAAQ,OAAOA,QAAQ,SAASA,QAAQ,SAAS,OAAO;IAC5D,OAAOF,kBAAkBH,OAAO,WAAW;AAC7C;AAEA;;;;;;;;CAQC,GACD,OAAO,SAASS,cAAcT,MAAgBC,QAAQD,GAAG;QAEpCA;IADnB,IAAID,oBAAoBC,MAAM,OAAOU;IACrC,MAAML,MAAMC,QAAON,4BAAAA,GAAG,CAACH,qBAAqB,YAAzBG,4BAA6B,IAAIO,IAAI,GAAGC,WAAW;IACtE,IAAIH,QAAQ,MAAM,OAAO;IACzB,IAAIA,QAAQ,MAAM,OAAOK;IACzB,OAAOP,kBAAkBH,OAAO,OAAOU;AACzC;AAEA,sFAAsF,GACtF,IAAIC,iBAAiB;AACrB,OAAO,SAASC,gCAAgCZ,MAAgBC,QAAQD,GAAG;IACzE,IAAIW,kBAAkB,CAACZ,oBAAoBC,MAAM;IACjD,IAAI,CAACA,GAAG,CAACL,cAAc,IAAI,CAACK,GAAG,CAACH,qBAAqB,EAAE;IACvDc,iBAAiB;IACjBE,QAAQC,KAAK,CACX,CAAC,KAAK,EAAEnB,cAAc,GAAG,EAAEE,qBAAqB,0DAA0D,CAAC;AAE/G;AAEA,wEAAwE,GACxE,OAAO,MAAMkB,oBAAoB,sBAAqB;AAEtD,oDAAoD,GACpD,OAAO,SAASC,kBAAkBhB,MAAgBC,QAAQD,GAAG;QAEjBA;IAD1C,IAAID,oBAAoBC,MAAM,OAAO;IACrC,OAAO,uBAAuBiB,IAAI,CAACX,QAAON,yBAAAA,GAAG,CAACe,kBAAkB,YAAtBf,yBAA0B,IAAIO,IAAI;AAC9E"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/runtime/ai-dev-env.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Which development layers this process runs (AGL-3660): the replay cache,\n * the hour-long prompt cache and batch mode, each read from the environment.\n * Kept apart from `ai-dev-replay.ts`, which reads and writes files, so the\n * runtime asks these questions on every request without loading a file\n * system module into a server that will never use one. Every answer is `off`\n * in a deployed server.\n */\n\nimport type { AiEffort } from '../providers/contract'\n\nexport type AiDevReplayMode = 'off' | 'replay' | 'refresh'\n\n/** The variable that turns the replay cache on, off, or to refresh. */\nexport const AI_REPLAY_ENV = 'AGLYN_AI_REPLAY'\n/** Where the answers are kept, when not under the repository's `.cache/ai-replay`. */\nexport const AI_REPLAY_DIR_ENV = 'AGLYN_AI_REPLAY_DIR'\n/** The prompt-cache lifetime a development run asks for: `1h` or `5m`. */\nexport const AI_DEV_CACHE_TTL_ENV = 'AGLYN_AI_CACHE_TTL'\n/** The mark the live-eval launcher leaves, which `jest.setup.js` also reads. */\nexport const AI_LIVE_LAUNCHER_ENV = 'AI_EVAL_LIVE_LAUNCHER'\n\nexport type AiDevEnv = Readonly<Record<string, string | undefined>>\n\n/** Whether this process is a deployed server, where no development layer may run. */\nexport function aiIsDeployedRuntime(env: AiDevEnv = process.env): boolean {\n  return (\n    env['NODE_ENV'] === 'production' ||\n    env['VERCEL_ENV'] === 'production' ||\n    env['VERCEL_ENV'] === 'preview' ||\n    Boolean(env['K_SERVICE'])\n  )\n}\n\n/** The variable every live spec is started with. */\nexport const AI_LIVE_RUN_ENV = 'AGLYN_LIVE_AI'\n\n/**\n * Whether this process is a development run that asked for the live\n * provider: through the launcher, or a live spec started with\n * `AGLYN_LIVE_AI=1` (AGL-3781). Every development layer is on by default in\n * such a run — a live spec started without the launcher's mark used to send\n * every request again, at the five-minute cache and full price — and each can\n * still be turned off by its own variable.\n */\nexport function aiUnderLiveRun(env: AiDevEnv = process.env): boolean {\n  if (aiIsDeployedRuntime(env)) return false\n  return Boolean(env[AI_LIVE_LAUNCHER_ENV]) || String(env[AI_LIVE_RUN_ENV] ?? '').trim() === '1'\n}\n\n/** The replay mode this process runs under; `off` in any deployed server. */\nexport function aiDevReplayMode(env: AiDevEnv = process.env): AiDevReplayMode {\n  if (aiIsDeployedRuntime(env)) return 'off'\n  const raw = String(env[AI_REPLAY_ENV] ?? '').trim().toLowerCase()\n  if (raw === 'refresh') return 'refresh'\n  if (raw === '1' || raw === 'on' || raw === 'true' || raw === 'replay') return 'replay'\n  if (raw === '0' || raw === 'off' || raw === 'false') return 'off'\n  return aiUnderLiveRun(env) ? 'replay' : 'off'\n}\n\n/**\n * The prompt-cache lifetime a development run asks for. An agent re-runs a\n * live eval every ten to forty minutes while it iterates, which is past the\n * default five-minute entry and inside an hour, so under the launcher the\n * breakpoints ask for the hour: the second run reads the prefix the first one\n * wrote instead of writing it again. Production keeps the default — its\n * steps run a minute apart on the beat, inside five minutes — and never reads\n * this: `undefined` there.\n */\nexport function aiDevCacheTtl(env: AiDevEnv = process.env): '1h' | undefined {\n  if (aiIsDeployedRuntime(env)) return undefined\n  const raw = String(env[AI_DEV_CACHE_TTL_ENV] ?? '').trim().toLowerCase()\n  if (raw === '1h') return '1h'\n  if (raw === '5m') return undefined\n  return aiUnderLiveRun(env) ? '1h' : undefined\n}\n\n/** A deployed server that was handed the variable says so once, and runs without it. */\nlet warnedDeployed = false\nexport function aiWarnIfReplayAskedInDeployment(env: AiDevEnv = process.env): void {\n  if (warnedDeployed || !aiIsDeployedRuntime(env)) return\n  if (!env[AI_REPLAY_ENV] && !env[AI_DEV_CACHE_TTL_ENV]) return\n  warnedDeployed = true\n  console.error(\n    `[ai] ${AI_REPLAY_ENV} / ${AI_DEV_CACHE_TTL_ENV} are development-only and are ignored in a deployed server`,\n  )\n}\n\n/** The variable that turns batch mode on (`runtime/ai-live-batch.ts`). */\nexport const AI_LIVE_BATCH_ENV = 'AGLYN_LIVE_AI_BATCH'\n\n/**\n * Whether this process batches its live requests: what `AGLYN_LIVE_AI_BATCH`\n * says, and in a live run that says nothing, yes (AGL-3781). Nobody waits on\n * an eval's answers, and a batch is half price on every token, cache reads\n * and writes included; `AGLYN_LIVE_AI_BATCH=0` is for the quick single run an\n * iteration wants back in seconds.\n */\nexport function aiLiveBatchWanted(env: AiDevEnv = process.env): boolean {\n  if (aiIsDeployedRuntime(env)) return false\n  const raw = String(env[AI_LIVE_BATCH_ENV] ?? '').trim()\n  if (/^(?:1|true|yes|on)$/i.test(raw)) return true\n  if (/^(?:0|false|no|off)$/i.test(raw)) return false\n  return aiUnderLiveRun(env)\n}\n\n/**\n * The most a batched live run may take: the adapter waits up to an hour on\n * each batch, and a run's requests go as a few batches one after another —\n * the answers, their re-asks, the grades. A spec that timed out would keep\n * none of the answers it already paid for, so the bound is the worst case.\n */\nexport const AI_LIVE_BATCH_TIMEOUT_MS = 5 * 60 * 60_000\n\n/** A live spec's timeout: `baseMs`, or the batched run's when this run batches. */\nexport function aiLiveTimeoutMs(baseMs: number, env: AiDevEnv = process.env): number {\n  return aiLiveBatchWanted(env) ? Math.max(baseMs, AI_LIVE_BATCH_TIMEOUT_MS) : baseMs\n}\n\n/**\n * The variable an effort A/B names its arm with (AGL-3781): a step kind's\n * effort for this run, as `job.form:medium,job.text:low`, or `*:medium` for\n * every kind. A development run only, so the defaults stay where production\n * runs them until a recorded round shows a lower effort holds.\n */\nexport const AI_EFFORT_ARM_ENV = 'AGLYN_AI_EFFORT'\n\nconst AI_EFFORT_LEVELS: readonly AiEffort[] = ['low', 'medium', 'high']\n\n/** The effort this development run's A/B arm asks `step` at, or `undefined` for the step's own. */\nexport function aiDevEffortFor(step: string | undefined, env: AiDevEnv = process.env): AiEffort | undefined {\n  if (aiIsDeployedRuntime(env)) return undefined\n  const raw = String(env[AI_EFFORT_ARM_ENV] ?? '').trim()\n  if (!raw) return undefined\n  let fallback: AiEffort | undefined\n  for (const pair of raw.split(',')) {\n    const [kind, level] = pair.split(':').map((part) => part.trim())\n    if (!AI_EFFORT_LEVELS.includes(level as AiEffort)) continue\n    if (kind === step) return level as AiEffort\n    if (kind === '*') fallback = level as AiEffort\n  }\n  return fallback\n}\n"],"names":["AI_REPLAY_ENV","AI_REPLAY_DIR_ENV","AI_DEV_CACHE_TTL_ENV","AI_LIVE_LAUNCHER_ENV","aiIsDeployedRuntime","env","process","Boolean","AI_LIVE_RUN_ENV","aiUnderLiveRun","String","trim","aiDevReplayMode","raw","toLowerCase","aiDevCacheTtl","undefined","warnedDeployed","aiWarnIfReplayAskedInDeployment","console","error","AI_LIVE_BATCH_ENV","aiLiveBatchWanted","test","AI_LIVE_BATCH_TIMEOUT_MS","aiLiveTimeoutMs","baseMs","Math","max","AI_EFFORT_ARM_ENV","AI_EFFORT_LEVELS","aiDevEffortFor","step","fallback","pair","split","kind","level","map","part","includes"],"mappings":"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"}

package/src/lib/runtime/ai-doctrine-validators.js

@@ -4473,7 +4473,9 @@ function slugKey(slug) {
     layout: 64,
     firstSection: 44,
     laterSection: 20,
-    listing: 3
+    // A page's listing, on the fast tier at the platform's markup since
+    // AGL-3781 (3 credits at Claude Haiku 4.5's cost before).
+    listing: 1
 };
 /**
  * The most sections a Free job fits in `FREE_AI_TASTE_CREDITS_PER_MONTH` at