@stage5/lumine 0.2.49 → 0.2.50

package/lib/app-mcp/server.js

@@ -18,6 +18,22 @@ function delay(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
+function rethrowAppMcpSessionError(error) {
+  const message = String(error?.message || error);
+  if (
+    Number(error?.status || 0) === 404 &&
+    /MCP session not found/i.test(message) &&
+    !/restart the Lumine app-mcp driver/i.test(message)
+  ) {
+    const guided = new Error(
+      `${message}. Restart the Lumine app-mcp driver and reopen its new appUrl.`,
+    );
+    guided.status = error.status;
+    throw guided;
+  }
+  throw error;
+}
+
 function openApp(url) {
   const command =
     process.platform === "darwin"
@@ -144,7 +160,7 @@ async function callAppTool({
     sessionId,
     name,
     arguments: toolArguments,
-  });
+  }).catch(rethrowAppMcpSessionError);
   const callId = created?.call?.id;
   if (!callId) throw new Error("Twinkle did not create the app tool call.");
   const deadline = Date.now() + CALL_TIMEOUT_MS;
@@ -155,7 +171,7 @@ async function callAppTool({
       buildId,
       sessionId,
       callId,
-    });
+    }).catch(rethrowAppMcpSessionError);
     const call = payload?.call;
     if (call?.status === "completed") return call.result;
     if (call?.status === "failed") {
@@ -169,14 +185,16 @@ async function callAppTool({
     buildId,
     sessionId,
     callId,
-  });
+  }).catch(rethrowAppMcpSessionError);
   if (finalPayload?.call?.status === "completed") {
     return finalPayload.call.result;
   }
   if (finalPayload?.call?.status === "failed") {
     throw new Error(finalPayload.call.errorMessage || "App tool failed.");
   }
-  throw new Error("App tool call timed out. Keep the MCP app tab open.");
+  throw new Error(
+    "App tool call timed out. Reload the appUrl tab, or restart the Lumine app-mcp driver and reopen its new appUrl.",
+  );
 }
 
 async function handleMcpMessage({ line, options, auth, buildId, session, tools }) {

package/package.json

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