@okostream/mcp 0.13.0 → 0.13.1

package/dist/server.js

@@ -116291,7 +116291,7 @@ function sanitizeScopes(scopes) {
 }
 
 // build/version.js
-var OKO_MCP_VERSION = "0.13.0";
+var OKO_MCP_VERSION = "0.13.1";
 
 // build/auth.js
 var state = null;
@@ -119908,13 +119908,16 @@ function registerLifecycleTools(server2) {
 
 // build/tools/live.js
 var CHAT_LIVE_SETTINGS = ["mode", "slowModeMs", "automodEnabled", "allowViewerLinks"];
+async function writeChatControl(eventId, mode) {
+  await update(ref(rtdb, `events/${eventId}/ctrl`), { chatMode: mode, chatVisible: null });
+}
 function registerLiveTools(server2) {
   server2.registerTool("oko_get_live_state", {
     title: "Get live state",
     description: toolDescription({
       summary: "Read main RTDB live controls, aggregate analytics, and chat settings for an event.",
       args: ["eventId: event to inspect."],
-      returns: "eventId, agg metrics, ctrl live overrides, and chat settings (mode, slowModeMs, automodEnabled, allowViewerLinks, plus accepting \u2014 whether message intake is open right now, as the server enforces it).",
+      returns: "eventId, agg metrics, ctrl live overrides, and chat settings (mode, slowModeMs, automodEnabled, allowViewerLinks, plus accepting \u2014 whether message intake is open right now, as the server enforces it). ctrl.chatMode is the live control for message intake: public, off, or absent (then the event's starting state blocks.chat.intake applies and accepting shows the result).",
       examples: ["Use during a webinar before changing live block visibility or starting/ending sessions."],
       notes: [
         "Live state does not carry the event team: to see who has access to an event and with which permissions, use oko_list_workspace_access on the event's workspace."
@@ -119949,7 +119952,7 @@ function registerLiveTools(server2) {
       returns: "eventId, block, and effective override value.",
       examples: ["Use visible=false to hide the CTA live; use visible=null to return to setup defaults."],
       notes: [
-        "block=chat with visible=false PAUSES message input: viewers keep seeing the chat history but cannot send. It does not hide the chat panel.",
+        "block=chat controls MESSAGE SENDING, never the panel: visible=true OPENS sending (same as oko_set_chat_mode mode=public), visible=false PAUSES it (mode=off \u2014 viewers keep seeing the history but cannot send), visible=null returns the chat to its starting state (blocks.chat.intake). The panel itself is blocks.chat.enabled in oko_configure_blocks.",
         "Chat is the only block whose override the SERVER enforces: it is written as the chat mode and mirrored into the chat security rules, so a paused chat refuses messages from every client. The other four overrides are page presentation only \u2014 they change what viewers see, not what the server accepts.",
         "Live overrides sit on top of setup: a block disabled in setup (oko_configure_blocks enabled=false) stays absent whatever the override; visible=null returns an enabled block to its setup default. Use overrides for the live show, setup toggles for permanent changes."
       ]
@@ -119974,7 +119977,8 @@ function registerLiveTools(server2) {
       cards: setupBlocks.cards?.enabled === true,
       placeholder: setupBlocks.video?.placeholder?.enabled === true
     };
-    const hints = setupEnabled[block] ? [visible === null ? "Override removed: the block follows its setup visibility again." : `Live override applied on top of setup; visible=null returns the ${block} block to its setup default.`] : [`The ${block} block is disabled in setup, so this live override has no visible effect until it is enabled (${block === "cards" ? "oko_configure_cards enabled=true" : "oko_configure_blocks"}).`];
+    const chatHint = visible === null ? "Live control cleared: message intake follows the starting state (blocks.chat.intake)." : visible ? "Message sending is open (chat mode public); the panel was not touched." : "Message sending is paused (chat mode off); history stays visible, the panel was not touched.";
+    const hints = !setupEnabled[block] ? [`The ${block} block is disabled in setup, so this live override has no visible effect until it is enabled (${block === "cards" ? "oko_configure_cards enabled=true" : "oko_configure_blocks"}).`] : block === "chat" ? [chatHint] : [visible === null ? "Override removed: the block follows its setup visibility again." : `Live override applied on top of setup; visible=null returns the ${block} block to its setup default.`];
     const paths = {
       chat: "chatVisible",
       banner: "bannerVisible",
@@ -119983,16 +119987,7 @@ function registerLiveTools(server2) {
       placeholder: "placeholderVisible"
     };
     if (block === "chat") {
-      const modeRef = ref(rtdb, `events/${eventId}/ctrl/chatMode`);
-      const patch = { chatVisible: null };
-      if (visible === null || visible === false) {
-        patch.chatMode = visible === false ? "off" : null;
-      } else {
-        const current = await get(modeRef);
-        if (current.val() === "off")
-          patch.chatMode = null;
-      }
-      await update(ref(rtdb, `events/${eventId}/ctrl`), patch);
+      await writeChatControl(eventId, visible === null ? null : visible ? "public" : "off");
       return textResult({ eventId, block, visible, hints });
     }
     const target = ref(rtdb, `events/${eventId}/ctrl/${paths[block]}`);
@@ -120077,7 +120072,7 @@ function registerLiveTools(server2) {
       examples: ['Use mode="off" to pause a chat storm; use mode="public" to reopen.'],
       notes: [
         '\u{1F534} "Turn off the chat" means one of TWO different things. THIS tool stops new messages: the panel stays on the page, history stays readable, nothing changes for the audience except the input. The other one \u2014 oko_configure_blocks with chat.enabled=false \u2014 HIDES the whole panel (history is kept for 90 days and returns when re-enabled), which is a page-layout decision, not a live-show one. When the organizer says "turn off the chat", "close the chat", "stop the chat", "mute the chat", "disable chat" during or after a webinar, they almost always mean THIS tool. Ask before hiding the panel.',
-        'This is the full replacement for the legacy pause via oko_set_block_visibility(block="chat"): prefer oko_set_chat_mode.',
+        'oko_set_block_visibility(block="chat") writes this same state (visible=true \u2192 public, false \u2192 off, null \u2192 starting state); prefer this tool for the chat, it says what it does.',
         "There are no other levels: the server has exactly two states, sending open or closed. History is always visible; the mode never restricts who can read or hides anyone's messages."
       ]
     }),
@@ -120095,7 +120090,7 @@ function registerLiveTools(server2) {
     const { uid } = await authed(["live:control"]);
     await readEvent(eventId, uid, "live");
     requireConfirm(confirm, "oko_set_chat_mode", { eventId, mode });
-    await update(ref(rtdb, `events/${eventId}/ctrl`), { chatMode: mode, chatVisible: null });
+    await writeChatControl(eventId, mode);
     return textResult({ eventId, mode });
   });
   server2.registerTool("oko_force_viewer_reload", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okostream/mcp",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "description": "Control OKO Stream webinars from Claude, Codex, and other MCP clients.",
   "license": "UNLICENSED",
   "author": {