@bridge_gpt/mcp-server 0.2.62 → 0.2.65

package/build/bounded-wait.js

@@ -40,6 +40,33 @@
 import { MAX_CONSECUTIVE_POLL_FAILURES, MAX_PROBE_TIMEOUT_MS, MAX_POLL_JITTER_MS, defaultPollDelayMs, } from "./polling-policy.js";
 /** Hard ceiling on one wait window. Well inside the 900 s MCP client deadline. */
 export const MAX_BUDGET_MS = 240_000;
+/**
+ * Plain sentences for the server's closed terminal-reason tokens. An unknown
+ * token is printed as received, so a newer server's reason is never hidden.
+ */
+const TERMINAL_REASON_SENTENCES = {
+    lost_after_retries: "The server restarted during the run and gave up after its automatic retries.",
+    handler_failed: "The run failed on the server.",
+    expired: "The run expired on the server before it finished.",
+};
+/**
+ * Build the plain recovery message for a terminal outcome, or `null` when the
+ * server sent neither a reason nor a retry hint (the caller then keeps its
+ * existing wording exactly). `retry_hint` is printed verbatim.
+ */
+export function formatTerminalRecoveryMessage(detail) {
+    const reason = typeof detail?.reason === "string" ? detail.reason.trim() : "";
+    const retryHint = typeof detail?.retryHint === "string" ? detail.retryHint.trim() : "";
+    if (!reason && !retryHint)
+        return null;
+    const parts = [];
+    if (reason) {
+        parts.push(TERMINAL_REASON_SENTENCES[reason] ?? `The server reported: ${reason}.`);
+    }
+    if (retryHint)
+        parts.push(`Retry with: ${retryHint}`);
+    return parts.join(" ");
+}
 const monotonicNow = () => typeof performance !== "undefined" && typeof performance.now === "function"
     ? performance.now()
     : Date.now();
@@ -141,7 +168,11 @@ export async function boundedWait(options) {
                 }
             }
             else if (outcome.kind === "terminal") {
-                return { state: "error", reason: "UPSTREAM_TERMINAL" };
+                // Recovery detail is additive: it is attached only when the probe
+                // captured some, so a legacy terminal result keeps its exact shape.
+                return outcome.recovery
+                    ? { state: "error", reason: "UPSTREAM_TERMINAL", recovery: outcome.recovery }
+                    : { state: "error", reason: "UPSTREAM_TERMINAL" };
             }
             else if (outcome.kind === "malformed") {
                 return { state: "error", reason: "INVALID_RESPONSE" };