@okostream/mcp 0.12.7 → 0.12.8

package/dist/server.js

@@ -116224,7 +116224,7 @@ function sanitizeScopes(scopes) {
 }
 
 // build/version.js
-var OKO_MCP_VERSION = "0.12.7";
+var OKO_MCP_VERSION = "0.12.8";
 
 // build/auth.js
 var state = null;
@@ -116348,29 +116348,40 @@ async function exchangeApiKey() {
     latestVersion: typeof data.latestVersion === "string" && parseVersion(data.latestVersion) ? data.latestVersion.trim() : null
   };
 }
-async function ensureAuth(requiredScopes = []) {
+function singleFlight(run) {
+  let inFlight = null;
+  return () => {
+    inFlight ??= run().finally(() => {
+      inFlight = null;
+    });
+    return inFlight;
+  };
+}
+var refreshSession = singleFlight(async () => {
   const now = Date.now();
-  if (!state || now > state.expiresAt - 5 * 60 * 1e3 || !auth.currentUser) {
-    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.");
-    }
-    state = {
-      uid: exchanged.organizerUid,
-      scopes: exchanged.scopes,
-      expiresAt: now + exchanged.expiresIn * 1e3
-    };
-    if (exchanged.latestVersion)
-      recordLatestPublishedVersion(exchanged.latestVersion);
+  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.");
   }
+  state = {
+    uid: exchanged.organizerUid,
+    scopes: exchanged.scopes,
+    expiresAt: now + exchanged.expiresIn * 1e3
+  };
+  if (exchanged.latestVersion)
+    recordLatestPublishedVersion(exchanged.latestVersion);
+  return state;
+});
+async function ensureAuth(requiredScopes = []) {
+  const current = state && Date.now() <= state.expiresAt - 5 * 60 * 1e3 && auth.currentUser ? state : await refreshSession();
   for (const scope of requiredScopes) {
-    if (!state.scopes.includes(scope)) {
+    if (!current.scopes.includes(scope)) {
       throw new OkoScopeError(scope);
     }
   }
-  return state;
+  return current;
 }
 function currentScopes() {
   return state?.scopes ?? [];
@@ -116665,6 +116676,27 @@ async function responseBufferWithLimit(response, maxBytes) {
   }
   return Buffer.concat(chunks, total);
 }
+function shareLinkHint(url) {
+  let host = "";
+  try {
+    host = new URL(url).hostname.toLowerCase();
+  } catch {
+    return "";
+  }
+  if (host === "drive.google.com" || host === "docs.google.com") {
+    return " This is a Google Drive page, not the file: share it as 'anyone with the link' and use https://drive.google.com/uc?export=download&id=<fileId>, or download the file and pass source.path.";
+  }
+  if (host.endsWith("disk.yandex.ru") || host.endsWith("disk.yandex.com") || host === "yadi.sk" || host.endsWith("disk.360.yandex.ru")) {
+    return " This is a Yandex Disk page, not the file: use the direct download link from the page (\u0421\u043A\u0430\u0447\u0430\u0442\u044C \u2192 copy link), or download the file and pass source.path.";
+  }
+  if (host === "dropbox.com" || host.endsWith(".dropbox.com")) {
+    return " This is a Dropbox page: replace ?dl=0 with ?dl=1 in the link, or download the file and pass source.path.";
+  }
+  if (host.endsWith("onedrive.live.com") || host === "1drv.ms" || host.endsWith("sharepoint.com")) {
+    return " This is a OneDrive page: use its direct download link, or download the file and pass source.path.";
+  }
+  return " Use a direct link to the image file (right-click the image \u2192 copy image address), or download the file and pass source.path.";
+}
 async function readRemoteImage(rawUrl, redirects = 0) {
   if (redirects > REMOTE_IMAGE_MAX_REDIRECTS) {
     throw new Error("Image URL has too many redirects.");
@@ -116697,7 +116729,7 @@ async function readRemoteImage(rawUrl, redirects = 0) {
     }
     const contentType = (response.headers.get("content-type") ?? "").split(";")[0]?.trim().toLowerCase();
     if (!contentType || !contentType.startsWith("image/")) {
-      throw new Error("Image URL must return Content-Type image/*.");
+      throw new Error(`Image URL must return Content-Type image/* (got ${contentType || "none"}).${shareLinkHint(rawUrl)}`);
     }
     if (!ALLOWED_REMOTE_IMAGE_TYPES.has(contentType)) {
       throw new Error(`Image URL Content-Type ${contentType} is not supported. Use JPEG, PNG, WEBP, GIF, or AVIF.`);
@@ -116760,6 +116792,12 @@ function serverFetchRefusal(error3) {
   if (code === "functions/invalid-argument" && message.includes("Image payload is empty or too large")) {
     return { reason: "server_without_url_support", message: "The OKO server release in use does not fetch URLs yet." };
   }
+  if (code === "functions/deadline-exceeded") {
+    return { reason: "server_timeout", message: "The OKO server did not finish fetching the URL within its time limit." };
+  }
+  if (code === "functions/internal") {
+    return { reason: "server_error", message: message && message !== "internal" ? message : "The OKO server failed while fetching the URL." };
+  }
   return null;
 }
 var SERVER_FETCH_NOTE = "Image fetched by the OKO server directly from the URL; this machine's network was not involved.";
@@ -118358,7 +118396,10 @@ function registerEventTools(server2) {
       summary: "Read one OKO event visible to the organizer.",
       args: ["eventId: OKO event document id."],
       returns: "full event document fields plus id and public event URL.",
-      examples: ["Use after oko_create_webinar to verify setup and return the event URL to the user."]
+      examples: ["Use after oko_create_webinar to verify setup and return the event URL to the user."],
+      notes: [
+        "blocks.chat.mode is a legacy field written by older cabinet versions and read by nothing; chat visibility is blocks.chat.visibility (always | hidden). Ignore mode."
+      ]
     }),
     inputSchema: { eventId: eventIdField },
     outputSchema: eventOutputSchema,
@@ -120474,7 +120515,7 @@ function registerWorkspaceTools(server2) {
     description: toolDescription({
       summary: "Accept a workspace invite code for the authenticated organizer.",
       args: ["code: invite code from /invite/{code}.", "confirm: must be true."],
-      returns: "success plus workspace id/name returned by OKO CF19.",
+      returns: "success, workspace id/name, and keptExistingPermissions: true when the organizer was already a member \u2014 an invite never changes existing permissions; the owner changes them with oko_update_workspace_member.",
       examples: ["Use when the organizer wants to join a workspace from an invite code."]
     }),
     inputSchema: {
@@ -120483,6 +120524,7 @@ function registerWorkspaceTools(server2) {
     },
     outputSchema: external_exports.object({
       success: external_exports.boolean(),
+      keptExistingPermissions: external_exports.boolean().optional(),
       workspace: external_exports.object({ id: external_exports.string(), name: external_exports.string() }).passthrough()
     }).passthrough(),
     annotations: writeTool

package/package.json

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