@melaya/runner 1.1.25 → 1.1.27

package/dist/assistantHost.py

@@ -426,6 +426,39 @@ def _log(msg: str) -> None:
         pass
 
 
+# Failures the user can act on, told apart from the ones only we can. The runner
+# already writes a full traceback to stderr; this builds the ONE line that reaches
+# the panel, so it has to carry the exception type when the message is empty and
+# stay readable when it is not.
+_FRIENDLY_TURN_ERRORS = (
+    ("timeout", "The model did not respond in time. Try again, or pick a different model."),
+    ("timed out", "The model did not respond in time. Try again, or pick a different model."),
+    ("connection", "Could not reach the model provider from this machine. Check the network and try again."),
+    ("resolve", "Could not reach the model provider from this machine. Check the network and try again."),
+    ("refused", "The model provider refused the connection from this machine."),
+    ("ssl", "The connection to the model provider could not be secured on this machine."),
+)
+
+
+def _turn_error_message(exc: BaseException) -> str:
+    """One line for the panel. Falls back to the exception TYPE, never to nothing."""
+    raw = str(exc).strip()
+    name = type(exc).__name__
+    probe = (raw or name).lower()
+    for needle, friendly in _FRIENDLY_TURN_ERRORS:
+        if needle in probe:
+            detail = ": " + raw[:200] if raw else ""
+            return friendly + " (" + name + detail + ")"
+    if raw:
+        return raw[:500]
+    # Empty message: the type is all there is, and it is genuinely useful -
+    # TimeoutError and ConnectionResetError point at different fixes.
+    return (
+        "The assistant turn failed with " + name + " and no further detail. "
+        "The full traceback is in the runner log."
+    )
+
+
 def _extract_text(result) -> str:
     """Pull the final assistant text out of an agentscope reply Msg."""
     if result is None:
@@ -907,7 +940,14 @@ def _run_turn(agent, turn_id: str, message: str, browser_turn: bool = False) ->
     except Exception as exc:
         _log("turn error:\n" + traceback.format_exc())
         _stream["turnId"] = ""
-        _emit(turn_id, "error", message=str(exc) or "assistant turn failed")
+        # NEVER surface a bare "assistant turn failed". That fallback fired only
+        # when str(exc) was EMPTY - exactly the case where the exception TYPE is
+        # the sole remaining clue, and it was being discarded. Several of the
+        # likeliest failures here stringify to nothing at all (asyncio.TimeoutError,
+        # httpx.ReadTimeout, ConnectionResetError), so the panel showed a message
+        # that named neither what broke nor where. Reported 2026-09-03: two turns
+        # in a row with no cause anywhere on screen.
+        _emit(turn_id, "error", message=_turn_error_message(exc))
         _emit(turn_id, "done")
         return
 
@@ -921,7 +961,10 @@ def _run_turn(agent, turn_id: str, message: str, browser_turn: bool = False) ->
     if result is _WALLCLOCK:
         _stream["turnId"] = ""
         _log("browser turn wall-clock budget exceeded")
-        _emit(turn_id, "error", message="browser_turn_wallclock_exceeded")
+        _emit(turn_id, "error", message=(
+            "This browser task ran past its time budget and was stopped. "
+            "Ask again with a narrower step, or split it into two."
+        ))
         _emit(turn_id, "done")
         return
 
@@ -988,7 +1031,7 @@ def main() -> int:
         agent = _build_agent()
     except Exception as exc:
         _log("boot failed:\n" + traceback.format_exc())
-        _emit("", "error", message=f"assistant host failed to start: {exc}")
+        _emit("", "error", message="The assistant could not start on this runner. " + _turn_error_message(exc))
         return 1
     # Capture the freshly-built BASE system prompt (before any static context is
     # folded in) so each turn can deterministically rebuild base + persona.

package/dist/browserGrantVerify.js

@@ -143,10 +143,16 @@ export function loadPinnedPublicKeysFromEnv() {
 // Verifier
 // ---------------------------------------------------------------------
 export const DEFAULT_CLOCK_TOLERANCE_SECONDS = 30;
-/** Sanity ceiling: matches the server's MAX_TTL_SECONDS. A "valid"
- *  token claiming a longer life than the issuer can mint is forged or
- *  corrupt, so it is rejected regardless of signature. */
-const MAX_LIFETIME_SECONDS = 900;
+/** Sanity ceiling: MUST match the server's MAX_TTL_SECONDS
+ *  (server/src/services/browser/browserGrant.ts). A "valid" token claiming a
+ *  longer life than the issuer can mint is forged or corrupt, so it is
+ *  rejected regardless of signature.
+ *
+ *  Raised 900s -> 4h alongside the server. Because this half ships in the
+ *  runner, a server deployed ahead of a runner republish would mint grants
+ *  this rejects with claims_invalid — publish the runner before, or at the
+ *  same time as, the server change. */
+const MAX_LIFETIME_SECONDS = 4 * 60 * 60;
 function b64urlJson(part, what) {
     let buf;
     try {

package/dist/connection.js

@@ -1478,7 +1478,7 @@ export async function connect(opts) {
     socket.on("runner:assistant_turn", async (payload) => {
         const s = activeAssistants.get(String(payload.sessionId || ""));
         if (!s) {
-            socket.emit("runner:assistant_event", { sessionId: payload.sessionId, turnId: payload.turnId, kind: "error", message: "session_not_found" });
+            socket.emit("runner:assistant_event", { sessionId: payload.sessionId, turnId: payload.turnId, kind: "error", message: "The assistant session on your runner is gone (it most likely restarted). Send the message again to start a fresh one." });
             return;
         }
         // Generation gate (defense-in-depth): refuse to serve a turn stamped with a
@@ -1487,7 +1487,7 @@ export async function connect(opts) {
         // triggers the server's clean re-boot path. Backward-compatible: a turn with
         // no generation (older server) is served as before.
         if (payload.generation != null && Number(payload.generation) !== s.generation) {
-            socket.emit("runner:assistant_event", { sessionId: payload.sessionId, turnId: payload.turnId, kind: "error", message: "session_not_found" });
+            socket.emit("runner:assistant_event", { sessionId: payload.sessionId, turnId: payload.turnId, kind: "error", message: "The assistant session on your runner is gone (it most likely restarted). Send the message again to start a fresh one." });
             return;
         }
         s.lastActivity = Date.now();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melaya/runner",
-  "version": "1.1.25",
+  "version": "1.1.27",
   "description": "Run Melaya AI pipelines locally with your own LM Studio or Ollama models",
   "license": "UNLICENSED",
   "private": false,