@stage5/lumine 0.2.35 → 0.2.37

package/lib/admin.js

@@ -4,19 +4,17 @@ import { assertAuthScope, resolveAuth } from "./auth.js";
 import { requestJson } from "./http.js";
 
 const MAX_EDITORIAL_FILE_BYTES = 256 * 1024;
-const MAX_COMPOSED_COMMENT_FILE_BYTES = 64 * 1024;
-const MAX_COMPOSED_COMMENT_LENGTH = 10_000;
+const MAX_COMPOSED_TEXT_FILE_BYTES = 64 * 1024;
+const MAX_COMPOSED_TEXT_LENGTH = 10_000;
 const MAX_NOTABLE_NOTE_LENGTH = 2_000;
 
-// Operator-composed persona comment text (plain UTF-8, not JSON). The agent
-// writes the comment in the bot's persona itself; the server never invokes
+// Operator-composed persona text (plain UTF-8, not JSON). The agent writes
+// the content in the bot's persona itself; the server never invokes
 // its model and no AI Energy is spent.
-function readComposedCommentFile(filePath) {
+function readComposedTextFile(filePath) {
   const normalizedPath = String(filePath || "").trim();
   if (!normalizedPath) {
-    throw cliValidationError(
-      "Pass composed comment text with --file <comment.md>.",
-    );
+    throw cliValidationError("Pass composed text with --file <file.md>.");
   }
   let contents;
   try {
@@ -24,18 +22,18 @@ function readComposedCommentFile(filePath) {
   } catch {
     throw cliValidationError(`Could not read ${normalizedPath}.`);
   }
-  if (Buffer.byteLength(contents, "utf8") > MAX_COMPOSED_COMMENT_FILE_BYTES) {
-    throw cliValidationError("The composed comment file must be under 64KB.");
+  if (Buffer.byteLength(contents, "utf8") > MAX_COMPOSED_TEXT_FILE_BYTES) {
+    throw cliValidationError("The composed text file must be under 64KB.");
   }
   const normalized = contents.trim();
   if (!normalized) {
     throw cliValidationError(
-      `${normalizedPath} is empty; a composed comment needs text.`,
+      `${normalizedPath} is empty; composed text is required.`,
     );
   }
-  if (normalized.length > MAX_COMPOSED_COMMENT_LENGTH) {
+  if (normalized.length > MAX_COMPOSED_TEXT_LENGTH) {
     throw cliValidationError(
-      `A composed comment must be at most ${MAX_COMPOSED_COMMENT_LENGTH} characters.`,
+      `Composed text must be at most ${MAX_COMPOSED_TEXT_LENGTH} characters.`,
     );
   }
   return normalized;
@@ -401,6 +399,17 @@ export function parseAdminOperation(options) {
   }
 
   if (namespace === "ai-bucket" || namespace === "ai-buckets") {
+    if (action === "create") {
+      return writeOperation(
+        "ai-bucket.create",
+        "POST",
+        "/cli/admin/ai-buckets",
+        {
+          label: parseAiBucketLabel(options.adminLabel),
+          note: parseAiBucketNote(options.note),
+        },
+      );
+    }
     const bucketId = parseRequiredInteger(
       options.adminBucketId,
       "AI bucket ID",
@@ -424,22 +433,11 @@ export function parseAdminOperation(options) {
       );
     }
     if (action === "note" && target === "set") {
-      const note = String(options.note || "").trim();
-      if (!note) {
-        throw cliValidationError(
-          "Pass the quota-only context with --note <text>.",
-        );
-      }
-      if (note.length > 255) {
-        throw cliValidationError(
-          "An AI bucket note can be at most 255 characters.",
-        );
-      }
       return writeOperation(
         "ai-bucket.note.set",
         "PUT",
         `/cli/admin/ai-buckets/${bucketId}/note`,
-        { note },
+        { note: parseAiBucketNote(options.note) },
       );
     }
   }
@@ -724,6 +722,17 @@ export function parseAdminOperation(options) {
     );
   }
 
+  if (namespace === "announcement" && action === "post") {
+    return writeOperation(
+      "announcement.post",
+      "POST",
+      "/cli/admin/announcements",
+      {
+        content: readComposedTextFile(options.adminFile),
+      },
+    );
+  }
+
   if (namespace === "chat" && action === "send") {
     const rawTarget = String(target || "").trim();
     if (!rawTarget) {
@@ -735,7 +744,7 @@ export function parseAdminOperation(options) {
     // the bot's voice; the server never invokes a model for it.
     return writeOperation("chat.send", "POST", "/cli/admin/chat-messages", {
       target: rawTarget,
-      content: readComposedCommentFile(options.adminFile),
+      content: readComposedTextFile(options.adminFile),
     });
   }
 
@@ -821,7 +830,7 @@ export function parseAdminOperation(options) {
             ? parseIdentity(options.adminIdentity)
             : undefined,
           ...(options.adminFile
-            ? { content: readComposedCommentFile(options.adminFile) }
+            ? { content: readComposedTextFile(options.adminFile) }
             : {}),
           ...(reviewedBuildVersionId ? { reviewedBuildVersionId } : {}),
           ...(buildReviewMethod ? { buildReviewMethod } : {}),
@@ -849,7 +858,7 @@ export function parseAdminOperation(options) {
         "comment.edit",
         "PUT",
         `/cli/admin/comments/${commentId}`,
-        { content: readComposedCommentFile(options.adminFile) },
+        { content: readComposedTextFile(options.adminFile) },
       );
     }
     if (action === "post") {
@@ -868,7 +877,7 @@ export function parseAdminOperation(options) {
   }
 
   throw cliValidationError(
-    "Usage: lumine admin identity|daily-run|recommendations|builds|post|subjects|subject|featured|comment|chat|news|audit|brief|bot-output|notable ...",
+    "Usage: lumine admin identity|daily-run|recommendations|builds|post|subjects|subject|featured|comment|announcement|chat|news|audit|brief|bot-output|notable ...",
   );
 }
 
@@ -1181,6 +1190,32 @@ function parseOrderedIds(value) {
   return ids;
 }
 
+function parseAiBucketLabel(value) {
+  const label = String(value || "").trim();
+  if (!label) {
+    throw cliValidationError("Pass the bucket name with --label <name>.");
+  }
+  if (label.length > 120) {
+    throw cliValidationError("An AI bucket name can be at most 120 characters.");
+  }
+  return label;
+}
+
+function parseAiBucketNote(value) {
+  const note = String(value || "").trim();
+  if (!note) {
+    throw cliValidationError(
+      "Pass the quota-only context with --note <text>.",
+    );
+  }
+  if (note.length > 255) {
+    throw cliValidationError(
+      "An AI bucket note can be at most 255 characters.",
+    );
+  }
+  return note;
+}
+
 function parseAiBucketUserIds(value) {
   const raw = String(value || "").trim();
   if (!raw) {

package/lib/commands.js

@@ -2173,6 +2173,7 @@ export function parseArgs(args) {
         ? String(raw.ids)
         : "",
     adminBucketId: raw.bucketId ? String(raw.bucketId) : "",
+    adminLabel: raw.label ? String(raw.label) : "",
     adminUserIds: raw.userIds ? String(raw.userIds) : "",
     adminType: raw.type ? String(raw.type) : "",
     adminKind: raw.kind ? String(raw.kind) : "",
@@ -2513,6 +2514,7 @@ export function printHelp() {
   lumine thumbnail generate ["<prompt>"] --model <gpt-image-2|nano-banana>
   lumine doctor runtime-assets
   lumine admin identity list|status|use <zero|ciel|auto> [--json]
+  lumine admin ai-bucket create --label <name> --note <text> [--json]
   lumine admin ai-bucket get --bucket-id <id> [--json]
   lumine admin ai-bucket accounts add --bucket-id <id> --user-ids <id,id,...> [--note <text>] [--json]
   lumine admin ai-bucket note set --bucket-id <id> --note <text> [--json]
@@ -2539,6 +2541,7 @@ export function printHelp() {
   lumine admin comment edit <comment-id> --file <comment.md> [--json]
   lumine admin brief [--days <1..30>] [--json]
   lumine admin bot-output [--days <1..30>] [--json]
+  lumine admin announcement post --file <announcement.md> [--json]
   lumine admin chat send <user-id|username> --file <message.md> [--json]
   lumine admin notable add <user-id|username> --note <text> [--json]
   lumine admin audit [list] [--run current|last|<run-id>] [--target <target>] [--actions <a,b>] [--full] [--cursor <cursor>] [--json]
@@ -2616,6 +2619,7 @@ Options:
   --level <1|2|3>       Admin subject effort level
   --subject-ids <ids>   Complete ordered Featured subject IDs
   --bucket-id <id>      Unbanned AI identity bucket for account consolidation
+  --label <name>        Name for a new unbanned AI identity bucket
   --user-ids <ids>      Explicit user IDs for an AI bucket batch (up to 500)
   --type <type>         Admin target: subject, comment, build, aiStory, or dailyReflection
   --kind recommend      Admin recommendation queue kind
@@ -2623,7 +2627,7 @@ Options:
   --reward-twinkles 3   Pair a recommendation with exactly 3 Twinkles
   --twinkles 3          Give exactly 3 Twinkles through the normal economy
   --draft-id <id>       Canonical delegated comment draft ID
-  --file <path>         Editorial JSON or composed comment text file
+  --file <path>         Editorial JSON or composed text file
   --reviewed-version <id> Published Build artifact version actually reviewed
   --reviewed-via <method> Build review method: runtime or code
   --reason <text>       Reason when marking an admin run failed

package/package.json

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

package/sdk/BUILD_SDK_INDEX.md

@@ -2,7 +2,7 @@
 
 Version: 1.32.0
 Updated: 2026-08-02
-Generated: 2026-08-11T04:29:29.082Z
+Generated: 2026-08-13T00:13:49.827Z
 
 ## Notes
 - This SDK is injected into Build iframes via the Build preview/runtime.
@@ -287,7 +287,7 @@ console.log(analysis.bestMove, analysis.evaluation, analysis.mate);
   - Returns: { text, response, model, webSearch, aiUsagePolicy }
   - Generate text with the default Lumine text model, optionally using live web search and streaming text updates through onText.
   - Signed-in viewers only.
-  - Uses Grok 4.5 by default.
+  - Uses Grok 4.6 by default.
   - Each successful text generation consumes AI Energy from the signed-in viewer.
   - history must be an array of { role: 'user' | 'assistant', content: string }. Twinkle.ai.chat does not read a text field.
   - The server keeps the latest 12 valid history entries.
@@ -307,7 +307,7 @@ const result = await Twinkle.ai.chat({ message, history: chatHistory, systemProm
   - 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.
   - 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.5 with medium reasoning and consumes normal AI Energy.
+  - thinkingMode medium uses Grok 4.6 with medium reasoning and consumes normal AI Energy.
   - thinkingMode high uses GPT-5.6 Sol with high reasoning and consumes high AI Energy.
   - When AI Energy is empty, Low, Medium, and High all reject before new provider work; there is no free fallback mode.
   - Live web search is enabled by default in Medium and High modes. Pass webSearch: false to disable it for the app. Low/Lite Mode remains tool-free; explicitly forcing webSearch: true in Low Mode returns an error.
@@ -353,7 +353,7 @@ const result = await Twinkle.ai.chat({ message, history: chatHistory, systemProm
   - Pass onText/onStatus for streaming dialogue. Omit callbacks for non-streaming dialogue where the promise resolves with the final response.
   - Inside Build character chat, thinkingMode low uses Lite Mode: Zero and Ciel both use GPT-5.6 Luna with reasoning disabled; confirmed provider usage consumes the viewer's AI Energy and is usually cheaper than High.
   - Inside Build character chat, thinkingMode medium uses the same normal chat model routing: Zero and Ciel both use GPT-5.6 Luna with reasoning disabled and normal AI Energy.
-  - Inside Build character chat, thinkingMode high uses Think Hard chat routing and high AI Energy: Zero uses Grok 4.5 with high reasoning and Ciel uses GPT-5.6 Terra with high reasoning.
+  - Inside Build character chat, thinkingMode high uses Think Hard chat routing and high AI Energy: Zero uses Grok 4.6 with high reasoning and Ciel uses GPT-5.6 Terra with high reasoning.
   - When AI Energy is empty, Low, Medium, and High all reject before new provider work; there is no free fallback mode.
   - Pass roomContext as a short shared scene transcript so Zero and Ciel can know what happened in the same room.
   - includeWebsiteContext defaults to true. Set includeWebsiteContext: false for in-world NPC dialogue that should only use Zero/Ciel's basic character identity plus your scene/instructions.

package/sdk/LUMINE_ADMIN.md

@@ -55,6 +55,8 @@ AI identity buckets are private operator bookkeeping, not a Zero/Ciel public
 action. They therefore do not require or attach to a delegated daily run:
 
 ```bash
+lumine admin ai-bucket create --label Lemon \
+  --note "Quota accounting only; not a moderation flag." --json
 lumine admin ai-bucket get --bucket-id 10 --json
 lumine admin ai-bucket accounts add --bucket-id 10 \
   --user-ids 3127,13037,15410,16288 \
@@ -63,6 +65,13 @@ lumine admin ai-bucket note set --bucket-id 10 \
   --note "Quota accounting only; not a moderation flag." --json
 ```
 
+`create` inserts a new unbanned quota bucket through the same helper the
+management page uses. `--label` is required (at most 120 characters). `--note`
+is required and follows the same 255-character quota-context rule as
+`note set`. It cannot create a banned bucket, copy an existing one, or infer
+members. The response returns the canonical bucket, including its id for
+later `get` / `accounts add` / `note set` calls.
+
 `accounts add` accepts 1-500 unique positive user IDs, preflights the complete
 batch before writing, adds the canonical user and durable verified-email rules,
 re-attributes current-day AI usage, and returns the canonical bucket members.
@@ -73,11 +82,12 @@ Lumine audit log; no public bot identity is involved.
 canonical bucket. Use it to distinguish quota bookkeeping from moderation;
 the note itself changes no access, ban, or identity rules.
 
-This surface intentionally accepts only an existing **unbanned** bucket. It
-cannot ban accounts, block signup, add IP/device/risk-key rules, or infer an
-account family. Identification remains a human/LLM evidence judgment and must
-be explicitly requested by Mikey; routine administrator runs still escalate
-suspected alternate accounts and never auto-enforce.
+This surface is quota bookkeeping only. It cannot ban accounts, block signup,
+add IP/device/risk-key rules, or infer an account family. Identification
+remains a human/LLM evidence judgment and must be explicitly requested by
+Mikey; routine administrator runs still escalate suspected alternate accounts
+and never auto-enforce. `accounts add` and `note set` still accept only an
+existing **unbanned** bucket.
 
 ## Editorial priorities
 
@@ -1611,6 +1621,30 @@ Ordinary warm follow-ups (checking on a member the bots already know after
 something the run surfaced) are within a run's judgment, sparingly, and are
 always reported in the run report.
 
+## Official announcements
+
+```bash
+lumine admin announcement post --file announcement.md --json
+```
+
+The run's selected bot posts one composed message to General's announcement
+subchannel (`channelId` 2, `subchannelId` 2). This is the public official
+board, not a DM and not a Home comment. Mechanics:
+
+- requires the `chat:post` scope of a comment-mode `post` run;
+- composed-only (`--file`, same 10,000-character limit as `chat send`);
+- authors as Zero or Ciel only — the ordinary chat post route and the
+  announcement socket relay now treat those two IDs as allowed announcement
+  authors, same as management-level 3 humans;
+- persists through the ordinary `msg_chats` insert (channel lock +
+  visibility restore), writes the Twinkle Newspaper `announcement:<messageId>`
+  event, and relays `new_chat_message` on General. No bot socket, session, or
+  presence;
+- audited as `announcement.post` and idempotent per request key.
+
+Use this only when Mikey asks for an official announcement. Do not treat a
+management run as a standing license to post there.
+
 ## Audit history
 
 ```bash