@stage5/lumine 0.2.64 → 0.2.66

package/lib/admin.js

@@ -171,6 +171,7 @@ export async function adminCommand(options) {
     scope: operation.mutates ? "build:write" : "build:read",
   });
   let runId = 0;
+  let runScope = null;
   let correctionSessionId = 0;
   let correctionSession = null;
   if (adminOperationRequiresRun(operation)) {
@@ -216,6 +217,10 @@ export async function adminCommand(options) {
       }
       throw noActiveRunError();
     }
+    if (selectedRun) {
+      runScope = canonicalAdminRunScope(selectedRun);
+      assertAdminOperationAllowedForRunScope({ operation, runScope });
+    }
     if (options.adminIdentity && (selectedRun || correctionSession)) {
       const requestedIdentity = parseIdentity(options.adminIdentity);
       const canonicalIdentity = correctionSession
@@ -289,18 +294,20 @@ export async function adminCommand(options) {
         runId,
         fetchPage: fetchOperation,
         transformPage: transformResult,
-        recordCoverage: async (coverage) =>
-          requestJson({
-            method: "POST",
-            url: `${options.apiUrl}/cli/admin/daily-runs/coverage`,
-            authToken: auth.token,
-            body: coverage,
-            headers: {
-              "x-lumine-admin-run-id": String(runId),
-              "x-lumine-idempotency-key": `cli:queue-coverage:${runId}:${adminValueFingerprint(coverage).slice(0, 32)}`,
-            },
-            timeoutMs: options.timeoutMs,
-          }),
+        recordCoverage: shouldRecordAdminQueueCoverage(runScope)
+          ? async (coverage) =>
+              requestJson({
+                method: "POST",
+                url: `${options.apiUrl}/cli/admin/daily-runs/coverage`,
+                authToken: auth.token,
+                body: coverage,
+                headers: {
+                  "x-lumine-admin-run-id": String(runId),
+                  "x-lumine-idempotency-key": `cli:queue-coverage:${runId}:${adminValueFingerprint(coverage).slice(0, 32)}`,
+                },
+                timeoutMs: options.timeoutMs,
+              })
+          : undefined,
       });
     } else {
       if (options.adminResume) {
@@ -355,7 +362,7 @@ export async function adminCommand(options) {
     assertAiEmailPolicySetResult({ operation, result });
   }
   if (operation.name === "daily-run.start") {
-    assertAdminTodoHandoffResult(result);
+    assertAdminTodoHandoffResult(result, operation.body.scope);
   }
   if (operation.name === "news.claim") {
     const artifacts = writeNewsClaimArtifacts({
@@ -449,7 +456,11 @@ async function finishAdminOutput({ options, operation, result }) {
     return result;
   }
   if (paginationStorage) {
-    await printSpooledAdminResult({ result, storage: paginationStorage });
+    await printSpooledAdminResult({
+      operation,
+      result,
+      storage: paginationStorage,
+    });
     return result;
   }
   printAdminResult({ operation, result });
@@ -693,6 +704,58 @@ export function resolveOperatorViewFilter({ operation, unviewed, viewed }) {
   );
 }
 
+function requestedOperatorViewFilter(options) {
+  return options.adminUnviewed
+    ? "unviewed"
+    : options.adminViewed
+      ? "viewed"
+      : null;
+}
+
+export function canonicalAdminRunScope(run) {
+  const raw = run?.runScope;
+  if (raw === undefined || raw === null || raw === "") return "full";
+  const scope = String(raw);
+  if (scope === "full" || scope === "featured") return scope;
+  throw cliValidationError("The API returned an invalid administrator run scope.");
+}
+
+export function shouldRecordAdminQueueCoverage(runScope) {
+  return runScope === "full";
+}
+
+const FEATURED_RUN_OPERATIONS = new Set([
+  "subjects.candidates",
+  "subject.get",
+  "subject.comments",
+  "subject.reveal",
+  "subject.feature",
+  "subject.unfeature",
+  "featured.list",
+  "featured.history",
+  "featured.add",
+  "featured.reorder",
+  "featured.rotate",
+  "daily-run.complete",
+  "daily-run.fail",
+]);
+
+export function assertAdminOperationAllowedForRunScope({
+  operation,
+  runScope,
+}) {
+  if (runScope !== "featured") return;
+  const subjectCommentAlias =
+    operation.name === "post.comments" &&
+    /^\/cli\/admin\/subjects\/\d+\/comments(?:\?|$)/.test(operation.path);
+  if (FEATURED_RUN_OPERATIONS.has(operation.name) || subjectCommentAlias) {
+    return;
+  }
+  throw cliValidationError(
+    `A Featured-only run does not authorize ${operation.name}. Complete or fail it before starting a full daily review.`,
+  );
+}
+
 function adminOperationRequiresRun(operation) {
   return (
     ![
@@ -1095,16 +1158,26 @@ export function parseAdminOperation(options) {
 
   if (namespace === "daily-run") {
     if (action === "start") {
+      const runScope = parseDailyRunScope(options.adminScope || "full");
+      const commentMode = parseCommentMode(options.commentMode || "off");
+      if (runScope === "featured" && commentMode !== "off") {
+        throw cliValidationError(
+          "A Featured-only run requires --comment-mode off.",
+        );
+      }
       return writeOperation(
         "daily-run.start",
         "POST",
-        "/cli/admin/daily-runs/start",
+        runScope === "featured"
+          ? "/cli/admin/daily-runs/start/featured"
+          : "/cli/admin/daily-runs/start",
         {
           identity: options.adminIdentity
             ? parseIdentity(options.adminIdentity)
             : undefined,
-          commentMode: parseCommentMode(options.commentMode || "off"),
-          runKey: options.runKey || defaultDailyRunKey(),
+          commentMode,
+          scope: runScope,
+          runKey: options.runKey || defaultDailyRunKey(runScope),
         },
       );
     }
@@ -1286,13 +1359,21 @@ export function parseAdminOperation(options) {
     if (action === "get") return subjectGetOperation(target, options);
     if (action === "comments") {
       const subjectId = parseSubjectId(target);
+      const operatorView = requestedOperatorViewFilter(options);
       return readOperation(
         "subject.comments",
         withQuery(`/cli/admin/subjects/${subjectId}/comments`, {
           cursor: options.adminCursor,
           limit: options.limit,
         }),
-        { pagination: { collectionKey: "comments" } },
+        {
+          pagination: {
+            collectionKey: "comments",
+            filters: {
+              ...(operatorView ? { operatorView } : {}),
+            },
+          },
+        },
       );
     }
     if (action === "reveal") {
@@ -1330,6 +1411,29 @@ export function parseAdminOperation(options) {
     if (action === "list") {
       return readOperation("featured.list", "/cli/admin/subjects/featured");
     }
+    if (action === "history") {
+      const subjectIds = parseFeaturedSubjectIds(
+        options.adminIds,
+        "--subject-ids",
+      );
+      return readOperation(
+        "featured.history",
+        withQuery("/cli/admin/subjects/featured/history", {
+          subjectIds: subjectIds.join(","),
+          cursor: options.adminCursor,
+          limit: options.limit,
+        }),
+        {
+          pagination: {
+            collectionKey: "events",
+            filters: { subjectIds },
+          },
+        },
+      );
+    }
+    if (action === "add") {
+      return featuredAddOperation(options);
+    }
     if (action === "reorder") {
       return featuredReorderOperation(options);
     }
@@ -1360,13 +1464,21 @@ export function parseAdminOperation(options) {
         parsedTarget.type === "subject"
           ? `/cli/admin/subjects/${parsedTarget.id}/comments`
           : `/cli/admin/posts/${parsedTarget.type}/${parsedTarget.id}/comments`;
+      const operatorView = requestedOperatorViewFilter(options);
       return readOperation(
         "post.comments",
         withQuery(path, {
           cursor: options.adminCursor,
           limit: options.limit,
         }),
-        { pagination: { collectionKey: "comments" } },
+        {
+          pagination: {
+            collectionKey: "comments",
+            filters: {
+              ...(operatorView ? { operatorView } : {}),
+            },
+          },
+        },
       );
     }
     if (action === "recommend") {
@@ -1784,6 +1896,7 @@ export function parseAdminOperation(options) {
 }
 
 function subjectsListOperation(options) {
+  const operatorView = requestedOperatorViewFilter(options);
   return readOperation(
     "subjects.candidates",
     withQuery("/cli/admin/subjects", {
@@ -1800,7 +1913,10 @@ function subjectsListOperation(options) {
         after: options.adminAfter
           ? parseAfterForCoverage(options.adminAfter)
           : null,
-        filters: { effort: options.adminEffort || "all" },
+        filters: {
+          effort: options.adminEffort || "all",
+          ...(operatorView ? { operatorView } : {}),
+        },
       },
     },
   );
@@ -1890,6 +2006,25 @@ function featuredReorderOperation(options) {
   );
 }
 
+function featuredAddOperation(options) {
+  const addIds = parseFeaturedSubjectIds(
+    options.adminIds,
+    "--subject-ids",
+  );
+  const postedAfter = String(options.adminPostedAfter || "").trim();
+  if (!postedAfter) {
+    throw cliValidationError(
+      "New Featured additions require --posted-after <ISO-8601-or-Unix-time>.",
+    );
+  }
+  return writeOperation(
+    "featured.add",
+    "POST",
+    "/cli/admin/subjects/featured/additions",
+    { addIds, postedAfter },
+  );
+}
+
 function featuredRotateOperation(options) {
   const removeIds = parseFeaturedSubjectIds(
     options.adminRemoveIds,
@@ -2151,12 +2286,40 @@ export function formatAdminJsonError(error) {
   };
 }
 
-export function assertAdminTodoHandoffResult(result) {
+export function assertAdminTodoHandoffResult(result, expectedRunScope = null) {
   const runId = Number(result?.data?.run?.id || 0);
+  const runScope = canonicalAdminRunScope(result?.data?.run);
+  if (expectedRunScope && runScope !== expectedRunScope) {
+    const error = cliValidationError(
+      `The API returned a ${runScope} run when the CLI requested ${expectedRunScope}.`,
+    );
+    error.code = "LUMINE_ADMIN_RUN_SCOPE_UNSUPPORTED";
+    throw error;
+  }
   const handoff = result?.data?.carryoverTodos;
+  if (runScope === "featured") {
+    if (
+      !runId ||
+      !handoff ||
+      handoff.included !== false ||
+      !Array.isArray(handoff.items) ||
+      handoff.items.length !== 0 ||
+      Number(handoff.count) !== 0 ||
+      handoff.surfacedForRunId !== null ||
+      Number(handoff.newlySurfacedCount) !== 0
+    ) {
+      const error = cliValidationError(
+        "The API did not confirm that carry-over telemetry was suppressed for the Featured-only run.",
+      );
+      error.code = "LUMINE_ADMIN_SCOPED_RUN_UNSUPPORTED";
+      throw error;
+    }
+    return handoff;
+  }
   if (
     !runId ||
     !handoff ||
+    handoff.included === false ||
     !Array.isArray(handoff.items) ||
     Number(handoff.count) !== handoff.items.length ||
     Number(handoff.surfacedForRunId) !== runId ||
@@ -2223,6 +2386,14 @@ function parseCommentMode(value) {
   return mode;
 }
 
+function parseDailyRunScope(value) {
+  const scope = String(value || "full").trim().toLowerCase();
+  if (!["full", "featured"].includes(scope)) {
+    throw cliValidationError("--scope must be full or featured.");
+  }
+  return scope;
+}
+
 function parseEscalationStatus(value) {
   const status = String(value || "")
     .trim()
@@ -2436,7 +2607,7 @@ function parseChoice(value, label, choices) {
   return normalized;
 }
 
-function defaultDailyRunKey() {
+function defaultDailyRunKey(runScope = "full") {
   const parts = new Intl.DateTimeFormat("en-CA", {
     timeZone: "Asia/Bangkok",
     year: "numeric",
@@ -2446,7 +2617,10 @@ function defaultDailyRunKey() {
   const value = Object.fromEntries(
     parts.map((part) => [part.type, part.value]),
   );
-  return `daily:${value.year}-${value.month}-${value.day}`;
+  const day = `${value.year}-${value.month}-${value.day}`;
+  return runScope === "full"
+    ? `daily:${day}`
+    : `scoped:${runScope}:${day}:${randomUUID()}`;
 }
 
 function cliValidationError(message) {
@@ -2650,10 +2824,16 @@ function printAdminMonthlyMediaCosts(monthlyMediaCosts) {
   );
 }
 
-async function printSpooledAdminResult({ result, storage }) {
+async function printSpooledAdminResult({ operation, result, storage }) {
   const data = result?.data || {};
   const count = Number(storage.candidateCount || 0);
-  if (storage.collectionKey === "subjects") {
+  if (operation.name === "featured.history") {
+    printFeaturedHistorySummary(data);
+    console.log(`${count} Featured history event(s):`);
+    await forEachPaginatedResultItem(result, async (event) => {
+      printFeaturedHistoryEvent(event);
+    });
+  } else if (storage.collectionKey === "subjects") {
     console.log(`${count} subject(s):`);
     await forEachPaginatedResultItem(result, async (subject) => {
       console.log(
@@ -2930,13 +3110,13 @@ function printAdminResult({ operation, result }) {
       console.log("No active delegated administrator daily run.");
       if (data.lastRun) {
         console.log(
-          `Last run #${data.lastRun.id}: ${data.lastRun.status}; identity ${data.lastRun.identity.key}; comments ${data.lastRun.commentMode}.`,
+          `Last run #${data.lastRun.id}: ${data.lastRun.status}; scope ${canonicalAdminRunScope(data.lastRun)}; identity ${data.lastRun.identity.key}; comments ${data.lastRun.commentMode}.`,
         );
       }
       return;
     }
     console.log(
-      `Run #${data.run.id}: ${data.run.status}; identity ${data.run.identity.key}; comments ${data.run.commentMode}.`,
+      `Run #${data.run.id}: ${data.run.status}; scope ${canonicalAdminRunScope(data.run)}; identity ${data.run.identity.key}; comments ${data.run.commentMode}.`,
     );
     if (data.scheduledDay && data.scheduledIdentity) {
       console.log(
@@ -2967,11 +3147,20 @@ function printAdminResult({ operation, result }) {
     );
     console.log(
       data.activeRun
-        ? `Active run #${data.activeRun.id}: ${data.activeRun.identity.key}; comments ${data.activeRun.commentMode}.`
+        ? `Active run #${data.activeRun.id}: scope ${canonicalAdminRunScope(data.activeRun)}; identity ${data.activeRun.identity.key}; comments ${data.activeRun.commentMode}.`
         : "No active delegated administrator daily run.",
     );
     return;
   }
+  if (operation.name === "featured.history") {
+    printFeaturedHistorySummary(data);
+    console.log(`${(data.events || []).length} Featured history event(s):`);
+    for (const event of data.events || []) {
+      printFeaturedHistoryEvent(event);
+    }
+    printPagination(data.pagination);
+    return;
+  }
   if (Array.isArray(data.subjects)) {
     console.log(`${data.subjects.length} subject(s):`);
     for (const subject of data.subjects) {
@@ -3138,6 +3327,32 @@ function printAdminResult({ operation, result }) {
   );
 }
 
+function printFeaturedHistorySummary(data) {
+  const coverage = data.coverage || {};
+  console.log(
+    coverage.complete
+      ? `Featured history coverage begins at ${coverage.startedAt}.`
+      : "Featured history coverage is not complete.",
+  );
+  for (const subject of data.subjects || []) {
+    const lifetime = subject.knownFeatured
+      ? "previously Featured"
+      : subject.neverFeatured === true
+        ? "never Featured"
+        : "history unknown";
+    console.log(
+      `#${subject.id} ${subject.title || "(untitled)"} — ${lifetime}${subject.featured?.member ? ` — current position ${subject.featured.order}` : ""}`,
+    );
+    console.log(`  ${subject.url}`);
+  }
+}
+
+function printFeaturedHistoryEvent(event) {
+  console.log(
+    `#${event.id} subject:${event.subjectId} ${event.action} ${event.fromPosition ?? "-"}->${event.toPosition ?? "-"} — ${event.operation}`,
+  );
+}
+
 function printTodoItems(items, heading) {
   console.log(`${heading}: ${items.length} item(s).`);
   for (const todo of items) {

package/lib/commands.js

@@ -2364,6 +2364,7 @@ export function parseArgs(args) {
     cursor: Math.max(0, Math.floor(Number(raw.cursor) || 0)),
     adminCursor: raw.cursor ? String(raw.cursor) : "",
     adminAfter: raw.after ? String(raw.after) : "",
+    adminPostedAfter: raw.postedAfter ? String(raw.postedAfter) : "",
     adminSinceRun: Boolean(raw.sinceRun),
     adminIncludeLegacy: Boolean(raw.includeLegacy),
     adminIncludePrivateEvidence: parseBoolean(
@@ -2457,6 +2458,7 @@ export function parseArgs(args) {
     adminUnviewed: Boolean(raw.unviewed),
     adminViewed: Boolean(raw.viewed),
     adminIdentity: raw.identity ? String(raw.identity) : "",
+    adminScope: raw.scope ? String(raw.scope) : "",
     commentMode: raw.commentMode ? String(raw.commentMode) : "",
     runKey: raw.runKey ? String(raw.runKey) : "",
     idempotencyKey: raw.idempotencyKey ? String(raw.idempotencyKey) : "",
@@ -2818,7 +2820,7 @@ export function printHelp() {
   lumine admin ai-bucket note set --bucket-id <id> --note <text> [--json]
   lumine admin ai-email-policy get --email <address> [--json]
   lumine admin ai-email-policy set --email <address> --mode <automatic|separate_accounts> --note <text> [--json]
-  lumine admin daily-run start [--identity zero|ciel|auto] [--comment-mode off|draft|post] [--run-key <key>] [--json]
+  lumine admin daily-run start [--scope full|featured] [--identity zero|ciel|auto] [--comment-mode off|draft|post] [--run-key <key>] [--json]
   lumine admin daily-run status|report|complete|fail [--reason <text>] [--json]
   lumine admin daily-run escalation add --target <target> --note <summary> [--severity attention|urgent] [--json]
   lumine admin escalation list [--status open|acknowledged|resolved|all] [--limit <number>] [--json]
@@ -2843,6 +2845,8 @@ export function printHelp() {
   lumine admin subject creator set-made-by-poster <subject-id> [--json]
   lumine admin subject feature|unfeature <subject-id> [--json]
   lumine admin featured list [--unviewed|--viewed] [--json]
+  lumine admin featured history --subject-ids <id,id,...> [--all --checkpoint <file> [--resume]] [--cursor <cursor>] [--json]
+  lumine admin featured add --subject-ids <id,id,...> --posted-after <ISO-8601-or-Unix-time> [--json]
   lumine admin featured reorder --subject-ids <id,id,...> [--json]
   lumine admin featured rotate --remove-subject-ids <id,id,...> --add-subject-ids <id,id,...> [--json]
   lumine admin post get <target> [--type subject|comment|aiStory|dailyReflection] [--json]
@@ -2913,6 +2917,7 @@ Examples:
   npx @stage5/lumine@latest thumbnail generate --model gpt-image-2 --yes
   npx @stage5/lumine@latest doctor runtime-assets --build 917 --json
   npx @stage5/lumine@latest admin daily-run start --identity auto --comment-mode off --json
+  npx @stage5/lumine@latest admin daily-run start --scope featured --identity auto --json
   npx @stage5/lumine@latest admin recommendations list --json
   npx @stage5/lumine@latest admin subjects candidates --effort unassigned --json
   npx @stage5/lumine@latest admin subject get 123 --include-comments --json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage5/lumine",
-  "version": "0.2.64",
+  "version": "0.2.66",
   "description": "Command line tools for launching Lumine builds on Twinkle.",
   "type": "module",
   "bin": {

package/sdk/BUILD_SDK_INDEX.md

@@ -1,8 +1,8 @@
 # Build SDK Index
 
-Version: 1.38.2
-Updated: 2026-08-27
-Generated: 2026-08-27T12:11:09.595Z
+Version: 1.39.0
+Updated: 2026-09-03
+Generated: 2026-09-03T04:17:20.106Z
 
 ## Notes
 - This SDK is injected into Build iframes via the Build preview/runtime.
@@ -256,8 +256,8 @@ files:read, media:read, media:write, live:read, live:write, user:read, users:rea
   - Unsubscribe the current viewer from Build notifications for a subject's new pages or updates.
 
 ### Twinkle.chess
-- async bestMove({ fen, depth?, skillLevel?, maxTimeMs?, timeoutMs? }) | scopes: none
-  - Returns: { success, move, bestMove, from, to, promotion, evaluation, depth, mate, error, engine }
+- async bestMove({ fen, depth?, skillLevel?, maxTimeMs?, timeoutMs?, multiPv? }) | scopes: none
+  - Returns: { success, move, bestMove, from, to, promotion, evaluation, depth, mate, lines: [{ rank, move, from, to, promotion, evaluation, mate, depth, pv }], error, engine }
   - Ask the parent-hosted Stockfish engine for the best move from a FEN position.
   - Always available in the build iframe.
   - Stockfish runs in a parent-managed worker with bounded depth, timeout, and serialized requests.
@@ -265,14 +265,18 @@ files:read, media:read, media:write, live:read, live:write, user:read, users:rea
   - skillLevel 20 defaults to the strongest bounded search budget.
   - maxTimeMs and timeoutMs are clamped between 500 and 60000 milliseconds.
   - This returns engine analysis only. Use app code or a chess rules library to validate legal moves, manage board state, detect game over, and render the board.
+  - multiPv (1-10, default 1) returns the top N moves as lines, ranked best first, all from the same search (a movetime stop can leave a line one iteration behind; keep the engine's rank order rather than re-sorting by score). Compare line evaluations against each other to grade a candidate move; do not compare evaluations from separate searches of different positions.
+  - evaluation and line evaluations are centipawns from the side to move's point of view; mate is a signed mate distance (positive = side to move mates).
   - Example: const result = await Twinkle.chess.bestMove({ fen: game.fen(), skillLevel: 8, maxTimeMs: 1000 });
 if (result.success) game.move({ from: result.from, to: result.to, promotion: result.promotion || undefined });
-- async evaluate({ fen, depth?, skillLevel?, maxTimeMs?, timeoutMs? }) | scopes: none
-  - Returns: { success, move, bestMove, from, to, promotion, evaluation, depth, mate, error, engine }
+- async evaluate({ fen, depth?, skillLevel?, maxTimeMs?, timeoutMs?, multiPv? }) | scopes: none
+  - Returns: { success, move, bestMove, from, to, promotion, evaluation, depth, mate, lines: [{ rank, move, from, to, promotion, evaluation, mate, depth, pv }], error, engine }
   - Analyze a FEN position and return Stockfish's current best move plus centipawn or mate evaluation.
   - Always available in the build iframe.
   - evaluation is the Stockfish centipawn score from the engine output when available; mate is the mate distance when Stockfish reports one.
   - Do not call this from a render loop, animation loop, or high-frequency polling path.
+  - multiPv (1-10, default 1) returns the top N moves as lines, ranked best first, all from the same search (a movetime stop can leave a line one iteration behind; keep the engine's rank order rather than re-sorting by score). Compare line evaluations against each other to grade a candidate move; do not compare evaluations from separate searches of different positions.
+  - evaluation and line evaluations are centipawns from the side to move's point of view; mate is a signed mate distance (positive = side to move mates).
   - Example: const analysis = await Twinkle.chess.evaluate({ fen: game.fen(), depth: 12 });
 console.log(analysis.bestMove, analysis.evaluation, analysis.mate);
 
@@ -463,11 +467,11 @@ const result = await Twinkle.ai.chat({ message, history: chatHistory, systemProm
   - Use this instead of asking Twinkle.ai.chat to return JSON.
   - expectedStructure must be a JSON object that describes the exact returned object shape.
   - mode is accepted as an alias for thinkingMode, and mid is accepted as an alias for medium.
-  - Omit model to use the normal Lite/Medium/High routing. model accepts gpt-5.6-sol, claude-opus-5, or claude-fable-5, and every explicit model must be paired with thinkingMode: 'high'; unknown model IDs reject instead of silently falling back.
+  - Omit model to use the normal Lite/Medium/High routing. model accepts gpt-5.6-sol, claude-opus-5, or claude-fable-5-1, and every explicit model must be paired with thinkingMode: 'high'; unknown model IDs reject instead of silently falling back.
   - thinkingMode low uses GPT-5.6 Luna and consumes the viewer's AI Energy from confirmed provider usage; its smaller model is usually cheaper than Medium or High.
   - thinkingMode medium uses Grok 4.6 with medium reasoning and consumes normal AI Energy.
   - thinkingMode high without model uses GPT-5.6 Sol with high reasoning and consumes high AI Energy. Explicit model: 'gpt-5.6-sol' selects Sol with xhigh reasoning at the same High AI Energy tier.
-  - claude-opus-5 uses Anthropic adaptive High thinking. claude-fable-5 uses Anthropic xhigh thinking and normally consumes more AI Energy for comparable token use. Both debit confirmed provider usage at the High tier.
+  - claude-opus-5 uses Anthropic adaptive High thinking. claude-fable-5-1 uses Anthropic xhigh thinking and normally consumes more AI Energy for comparable token use. Both debit confirmed provider usage at the High tier.
   - Pass onStatus, onReasoning, and/or onText to stream progress from the same structured generation. onStatus receives high-level phases such as thinking, searching_web, responding, validating, and completed.
   - onReasoning receives accumulated provider-supplied, app-visible reasoning summaries plus { done, delta, requestId, status }. A provider retry may replace the accumulated summary; treat each callback's first argument as the current source of truth. This callback never exposes hidden/private model chain-of-thought.
   - onText receives accumulated structured-output text plus { done, delta, requestId, status }. Partial output is intentionally incomplete and may include provider formatting; parse only when done is true, when the callback receives the canonical object serialized as JSON, and use the resolved object as the source of truth.