@okostream/mcp 0.12.10 → 0.12.11

package/dist/server.js

@@ -116291,7 +116291,7 @@ function sanitizeScopes(scopes) {
 }
 
 // build/version.js
-var OKO_MCP_VERSION = "0.12.10";
+var OKO_MCP_VERSION = "0.12.11";
 
 // build/auth.js
 var state = null;
@@ -117195,16 +117195,43 @@ async function updateCardImageInTransaction(eventId, cardId, patch) {
     });
   });
 }
-async function writeEventPatchWithCards(eventId, basePatch, buildItems) {
+function descendPath(root, segments) {
+  let current = root;
+  for (const segment of segments) {
+    if (current === null || typeof current !== "object")
+      return void 0;
+    current = current[segment];
+  }
+  return current;
+}
+function valueAfterPatch(fresh, patch, path) {
+  if (Object.prototype.hasOwnProperty.call(patch, path))
+    return patch[path];
+  const segments = path.split(".");
+  for (let cut = segments.length - 1; cut > 0; cut--) {
+    const ancestor = segments.slice(0, cut).join(".");
+    if (!Object.prototype.hasOwnProperty.call(patch, ancestor))
+      continue;
+    return descendPath(patch[ancestor], segments.slice(cut));
+  }
+  return descendPath(fresh, segments);
+}
+function scheduleMissesDate(sessionMode, eventDate) {
+  return sessionMode === "schedule" && !eventDate;
+}
+async function writeEventPatchWithCards(eventId, basePatch, buildItems, validate = null) {
   const eventRef = doc(firestore, "events", eventId);
   await runTransaction2(firestore, async (transaction) => {
     const snap = await transaction.get(eventRef);
     if (!snap.exists())
       throw new Error("Event not found.");
+    const fresh = snap.data();
     const patch = { ...basePatch };
     if (buildItems) {
-      patch["blocks.cards.items"] = buildItems(snap.data());
+      patch["blocks.cards.items"] = buildItems(fresh);
     }
+    if (validate)
+      validate(fresh, patch);
     if (Object.keys(patch).length === 0)
       return;
     transaction.update(eventRef, patch);
@@ -118425,6 +118452,9 @@ function validateEventSetup(eventId, event) {
   } else if (eventDateMs < Date.now() - 60 * 60 * 1e3) {
     add(warnings, "date_in_past", "meta.eventDate", "Configured webinar date appears to be in the past.");
   }
+  if (scheduleMissesDate(event.analyticsSessionMode, meta2.eventDate)) {
+    add(errors, "schedule_missing_date", "analyticsSessionMode", "Session mode is 'schedule' but meta.eventDate is empty, so OKO can never start or end the session automatically and the reminder is never sent. Set eventDate, or switch sessionMode to 'manual' \u2014 oko_update_event accepts both fields in one call.");
+  }
   const duplicateFormIds = /* @__PURE__ */ new Set();
   const seenFormIds = /* @__PURE__ */ new Set();
   forms.forEach((form, index) => {
@@ -118540,6 +118570,24 @@ function telegramBlocksPatch(args) {
     "telegram.channelIds": args.telegramChannelIds
   };
 }
+function assertScheduleHasDate(fresh, patch) {
+  const missing = scheduleMissesDate(valueAfterPatch(fresh, patch, "analyticsSessionMode"), valueAfterPatch(fresh, patch, "meta.eventDate"));
+  if (!missing)
+    return;
+  throw new Error("sessionMode 'schedule' requires meta.eventDate: without a date OKO can never start the session automatically. Set eventDate in the same call, or switch sessionMode to 'manual' in the same call to clear the date.");
+}
+function assertFormBindingsExist(fresh, patch) {
+  const formsAfterPatch = valueAfterPatch(fresh, patch, "forms");
+  const knownFormIds = new Set((Array.isArray(formsAfterPatch) ? formsAfterPatch : []).map((form) => typeof form?.id === "string" ? form.id : null).filter((id) => Boolean(id)));
+  for (const field2 of ["blocks.promoBanner.formId", "blocks.primaryCta.formId"]) {
+    if (!Object.prototype.hasOwnProperty.call(patch, field2))
+      continue;
+    const value = patch[field2];
+    if (typeof value === "string" && value && !knownFormIds.has(value)) {
+      throw new Error(`${field2}: form "${value}" not found in event.forms. Create the form in the same call (or beforehand) \u2014 a button bound to a missing form does nothing for viewers.`);
+    }
+  }
+}
 function configureBlocksScopes(args) {
   return Object.keys(telegramBlocksPatch(args)).length > 0 ? ["setup:write", "telegram:write"] : ["setup:write"];
 }
@@ -118719,7 +118767,8 @@ function registerEventTools(server2) {
       returns: "event id and the list of Firestore fields updated.",
       examples: ["Use for title/date/speaker/video edits; use oko_configure_blocks for blocks and forms."],
       notes: [
-        "sessionMode 'schedule' makes OKO start and end the analytics session automatically at eventDate for durationMinutes; 'manual' keeps the Start/End buttons and a Telegram reminder 10 minutes before eventDate. This is still an analytics session, not an event status."
+        "sessionMode 'schedule' makes OKO start and end the analytics session automatically at eventDate for durationMinutes; 'manual' keeps the Start/End buttons and a Telegram reminder 10 minutes before eventDate. This is still an analytics session, not an event status.",
+        "sessionMode 'schedule' and eventDate travel together: setting the mode without a date, or clearing the date while the mode stays, is refused. Change both in one call."
       ]
     }),
     inputSchema: {
@@ -118745,13 +118794,7 @@ function registerEventTools(server2) {
     if (requiredScopes.size === 0)
       throw new Error("Provide at least one field to update.");
     const { uid } = await authed([...requiredScopes]);
-    const current = await readEvent(args.eventId, uid, "edit");
-    if (args.sessionMode === "schedule") {
-      const dateAfterPatch = args.eventDate !== void 0 ? args.eventDate : current.meta?.eventDate ?? null;
-      if (!dateAfterPatch) {
-        throw new Error("sessionMode 'schedule' requires meta.eventDate: without a date OKO can never start the session automatically. Set eventDate in the same call, or keep sessionMode 'manual'.");
-      }
-    }
+    await readEvent(args.eventId, uid, "edit");
     const patch = {};
     if (args.title !== void 0)
       patch.title = args.title.trim();
@@ -118776,7 +118819,7 @@ function registerEventTools(server2) {
       patch.analyticsSessionMode = args.sessionMode;
     if (args.durationMinutes !== void 0)
       patch["meta.durationMinutes"] = args.durationMinutes;
-    await updateDoc(doc(firestore, "events", args.eventId), patch);
+    await writeEventPatchWithCards(args.eventId, patch, null, assertScheduleHasDate);
     return textResult({ id: args.eventId, updated: Object.keys(patch) });
   });
   server2.registerTool("oko_configure_blocks", {
@@ -118874,17 +118917,7 @@ function registerEventTools(server2) {
         }))
       }));
     Object.assign(patch, telegramPatch);
-    const formsAfterPatch = patch.forms ?? current.forms;
-    const knownFormIds = new Set((Array.isArray(formsAfterPatch) ? formsAfterPatch : []).map((form) => typeof form?.id === "string" ? form.id : null).filter((id) => Boolean(id)));
-    for (const [field2, value] of [
-      ["blocks.promoBanner.formId", patch["blocks.promoBanner.formId"]],
-      ["blocks.primaryCta.formId", patch["blocks.primaryCta.formId"]]
-    ]) {
-      if (typeof value === "string" && value && !knownFormIds.has(value)) {
-        throw new Error(`${field2}: form "${value}" not found in event.forms. Create the form in the same call (or beforehand) \u2014 a button bound to a missing form does nothing for viewers.`);
-      }
-    }
-    await updateDoc(doc(firestore, "events", args.eventId), patch);
+    await writeEventPatchWithCards(args.eventId, patch, null, assertFormBindingsExist);
     const hints = [];
     if (args.chat?.visibility !== void 0) {
       hints.push("blocks.chat.visibility was stored but the event page does not read it: the chat panel exists exactly when blocks.chat.enabled is true, and sending is opened or closed live with oko_set_chat_mode. Drop the field.");

package/package.json

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