@okostream/mcp 0.14.1 → 0.14.2

package/dist/server.js

@@ -85972,6 +85972,13 @@ var SERVER_TIMESTAMP = {
 function serverTimestamp() {
   return SERVER_TIMESTAMP;
 }
+function increment(delta) {
+  return {
+    ".sv": {
+      "increment": delta
+    }
+  };
+}
 var TransactionResult = class {
   /** @hideconstructor */
   constructor(committed, snapshot) {
@@ -116300,7 +116307,7 @@ function sanitizeScopes(scopes) {
 }
 
 // build/version.js
-var OKO_MCP_VERSION = "0.14.1";
+var OKO_MCP_VERSION = "0.14.2";
 
 // build/auth.js
 var state = null;
@@ -116370,6 +116377,15 @@ var OkoAuthError = class extends Error {
     this.serverMessage = details.serverMessage;
   }
 };
+function transportFailure(error3) {
+  if (!(error3 instanceof Error))
+    return String(error3);
+  const cause = error3.cause;
+  if (!(cause instanceof Error))
+    return error3.message;
+  const code = cause.code;
+  return `${error3.message}: ${typeof code === "string" ? code : cause.message}`;
+}
 function versionField(value) {
   return typeof value === "string" && parseVersion(value) ? value.trim() : void 0;
 }
@@ -116403,8 +116419,8 @@ async function exchangeApiKey() {
       headers: { "content-type": "application/json" },
       body: JSON.stringify({ apiKey: env.apiKey, clientVersion: OKO_MCP_VERSION })
     });
-  } catch {
-    throw new OkoAuthError("unavailable", "OKO MCP could not reach the organizer authentication service. Check network access and reconnect.");
+  } catch (error3) {
+    throw new OkoAuthError("unavailable", `OKO MCP could not reach the organizer authentication service (${transportFailure(error3)}). Check network access and reconnect.`);
   }
   if (!response.ok) {
     const status = response.status;
@@ -116457,8 +116473,8 @@ var refreshSession = singleFlight(async () => {
   const exchanged = await exchangeApiKey();
   try {
     await signInWithCustomToken(auth, exchanged.customToken);
-  } catch {
-    throw new OkoAuthError("unavailable", "OKO MCP received an organizer session but could not initialize it. Reconnect and try again.");
+  } catch (error3) {
+    throw new OkoAuthError("unavailable", `OKO MCP received an organizer session but could not initialize it (${error3 instanceof Error ? error3.message : String(error3)}). Reconnect and try again.`);
   }
   state = {
     uid: exchanged.organizerUid,
@@ -118320,7 +118336,7 @@ function registerChatTools(server2) {
     description: toolDescription({
       summary: "Send a chat message as the authenticated organizer/moderator.",
       args: ["eventId: target event chat.", "text: message text, max 500 chars.", "name: display name, default OKO MCP.", "confirm: must be true."],
-      returns: "eventId, new messageId, and sent=true.",
+      returns: "eventId, new messageId, sent=true, and counted: whether the analytics chat message counter was updated (false comes with a hint; the message itself was still sent).",
       examples: ["Use for organizer announcements in chat after user confirms the exact text."]
     }),
     inputSchema: {
@@ -118348,8 +118364,17 @@ function registerChatTools(server2) {
       [`messages/${eventId}/${msgRef.key}`]: { text: messageText, uid, name: messageName, role, ts: timestamp },
       [`rate_limits/${eventId}/${uid}`]: { ts: timestamp, messageId: msgRef.key }
     });
-    await runTransaction(ref(rtdb, `events/${eventId}/agg/chatMessages`), (n) => (n ?? 0) + 1).catch(() => void 0);
-    return textResult({ eventId, messageId: msgRef.key, sent: true });
+    let counted = true;
+    const hints = [];
+    try {
+      await update(ref(rtdb), { [`events/${eventId}/agg/chatMessages`]: increment(1) });
+    } catch (error3) {
+      counted = false;
+      const reason = error3 instanceof Error ? error3.message : String(error3);
+      console.error(`[OKO MCP] chat message counter not updated for event ${eventId}: ${reason}`);
+      hints.push(`The message was sent, but the analytics chat message counter was not updated (${reason}). Analytics may show one message fewer. Do not resend the message.`);
+    }
+    return textResult({ eventId, messageId: msgRef.key, sent: true, counted, ...hints.length > 0 ? { hints } : {} });
   });
   server2.registerTool("oko_delete_chat_message", {
     title: "Delete chat message",
@@ -118565,7 +118590,7 @@ function eventRuntimeHint(runtime) {
 
 // build/tools/liveLayer.js
 var LIVE_FIELDS_HINT = "blocks.promoBanner.visibility, blocks.primaryCta.visibility, blocks.cards.visibility and blocks.video.placeholder.enabled are SETUP values. What viewers see right now is `live.<block>.visibleNow` \u2014 `decidedBy` says whether a live override (oko_set_block_visibility) or the setup default decided it. For the chat, `live.chat.accepting` is whether viewers can send a message right now; `blocks.chat.intake` is only the starting state. The live badge and the active analytics session are not resolved here: read oko_get_live_state (ctrl.liveBadge, ctrl.activeSessionId).";
-var LIVE_UNREADABLE_HINT = "blocks.*.visibility and .enabled above are SETUP values, not what viewers see now \u2014 and the live overrides could not be read with this key (they need analytics:read or live:control). Do not report a block as shown or hidden from these fields; read oko_get_live_state with a key that holds the scope.";
+var liveUnreadableHint = (reason) => `blocks.*.visibility and .enabled above are SETUP values, not what viewers see now \u2014 and the live overrides could not be read (${reason}; a key without analytics:read or live:control is always refused here). Do not report a block as shown or hidden from these fields; read oko_get_live_state with a key that holds the scope.`;
 function record2(value) {
   return value && typeof value === "object" ? value : {};
 }
@@ -118591,8 +118616,8 @@ async function readLiveLayer(eventId, data, nowMs) {
   let ctrl;
   try {
     ctrl = record2((await get(ref(rtdb, `events/${eventId}/ctrl`))).val());
-  } catch {
-    return { live: null, hints: [LIVE_UNREADABLE_HINT] };
+  } catch (error3) {
+    return { live: null, hints: [liveUnreadableHint(error3 instanceof Error ? error3.message : String(error3))] };
   }
   const banner = record2(blocks.promoBanner);
   const cta = record2(blocks.primaryCta);
@@ -118601,11 +118626,13 @@ async function readLiveLayer(eventId, data, nowMs) {
   const chat = record2(blocks.chat);
   const showAt = millis(banner.showAt);
   let accepting = null;
+  let acceptingUnread = "";
   try {
     const mode = (await get(ref(chatRtdb, `settings/${eventId}/mode`))).val();
     accepting = mode !== "off";
-  } catch {
+  } catch (error3) {
     accepting = null;
+    acceptingUnread = error3 instanceof Error ? error3.message : String(error3);
   }
   const live = {
     readAt: new Date(nowMs).toISOString(),
@@ -118617,7 +118644,7 @@ async function readLiveLayer(eventId, data, nowMs) {
   };
   const hints = [LIVE_FIELDS_HINT];
   if (accepting === null) {
-    hints.push("live.chat.accepting could not be read with this key; oko_get_live_state reports it when the key holds analytics:read.");
+    hints.push(`live.chat.accepting could not be read (${acceptingUnread}); oko_get_live_state reports it when the key holds analytics:read.`);
   }
   return { live, hints };
 }
@@ -120385,15 +120412,17 @@ async function assertSessionHasNothingToEnd(eventId, sessionId) {
   if (!sessionId)
     return;
   let read;
+  let readFailure = "";
   try {
     const snap = await get(ref(rtdb, `events/${eventId}/sessions/${sessionId}/baseline`));
     read = { ok: true, exists: snap.exists() };
-  } catch {
+  } catch (error3) {
     read = { ok: false };
+    readFailure = error3 instanceof Error ? error3.message : String(error3);
   }
   const refusal = sessionRepairRefusal(sessionRepairAction({ liveSessionBaseline: sessionBaselineFromRead(read) }));
   if (refusal)
-    throw new Error(refusal);
+    throw new Error(readFailure ? `${refusal} (read failed: ${readFailure})` : refusal);
 }
 async function attemptCleanup(path, run) {
   try {

package/package.json

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