@productbrain/mcp 0.0.1-beta.12525 → 0.0.1-beta.12545

package/dist/{chunk-AZT7HBBK.js → chunk-ATVNWS2Z.js}

@@ -962,6 +962,15 @@ function authorityRecovery(refusal) {
   }
   return typeof refusal?.requiredAction === "string" ? refusal.requiredAction : void 0;
 }
+function askNextLine(refusal) {
+  const seat = refusal?.routeTarget;
+  if (typeof seat?.roleEntryId !== "string" || refusal?.wayIn !== void 0 || refusal?.boundKey === true || refusal?.heldByAgent === true) return null;
+  return 'Next: `question action=create text="<your ask>"`.';
+}
+function returnedRefusal(refusal, fallback, clean = (s) => s) {
+  const fix = authorityRecovery(refusal) ?? (typeof refusal.requiredAction === "string" ? refusal.requiredAction : fallback);
+  return { message: `Refused: ${clean(refusal.reason)}`, recovery: [fix, askNextLine(refusal)].filter(Boolean).join("\n") };
+}
 function acceptPromptOf(details) {
   const found = details?.find((d) => typeof d?.acceptRefusal === "object");
   return typeof found?.acceptRefusal?.prompt === "string" ? found.acceptRefusal.prompt : null;
@@ -992,24 +1001,6 @@ function roleRetireNextLine(details) {
 function acceptCall(entryId, replaces) {
   return `\`entries action=accept entryId="${entryId}"${replaces ? ` replaces="${replaces}" reason="<why>"` : ""}\``;
 }
-var GateError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "GateError";
-  }
-};
-var BackendError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "BackendError";
-  }
-};
-var ValidationError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "ValidationError";
-  }
-};
 var PASS_SESSION_ID = "Call `session action=start`, then pass the sessionId it returns as `sessionId` on every write: the connection does not remember your session between calls.";
 var WORKSPACE_CLOSED = "WORKSPACE_CLOSED";
 var GATE_PATTERNS = [
@@ -1041,20 +1032,6 @@ function orientationRefusal(err) {
 }
 function classifyError(err) {
   const message = err instanceof Error ? err.message : String(err);
-  if (err instanceof GateError) {
-    return {
-      code: "PERMISSION_DENIED",
-      message,
-      recovery: "Check permissions or use a readwrite API key.",
-      availableActions: [{ tool: "workspace", description: "Check key scope", parameters: { action: "whoami" } }]
-    };
-  }
-  if (err instanceof BackendError) {
-    return { code: "BACKEND_ERROR", message, recovery: "Retry the operation or check backend health." };
-  }
-  if (err instanceof ValidationError) {
-    return { code: "VALIDATION_ERROR", message };
-  }
   const mcpErr = asKernelCallError(err);
   if (mcpErr) {
     const { code: convexCode, fn, cleanMessage, missingRequiredFields, fieldErrors } = mcpErr;
@@ -1085,13 +1062,8 @@ ${next2}` : cleanMessage, mcpErr.details),
       };
     }
     if (convexCode?.startsWith("AUTHZ_")) {
-      return {
-        code: "PERMISSION_DENIED",
-        fn,
-        message: cleanMessage,
-        recovery: "Check permissions or use a readwrite API key.",
-        availableActions: [{ tool: "workspace", description: "Check key scope", parameters: { action: "whoami" } }]
-      };
+      const recovery2 = authorityRecovery(mcpErr.details?.[0]);
+      return { code: "PERMISSION_DENIED", fn, message: cleanMessage, ...recovery2 ? { recovery: recovery2 } : {} };
     }
     if (convexCode === "WORKSPACE_SLUG_TAKEN" || convexCode === "PERSON_ALREADY_EXISTS") {
       return {
@@ -1109,11 +1081,12 @@ ${next2}` : cleanMessage, mcpErr.details),
         code: "rate-limited",
         fn,
         message: cleanMessage,
-        recovery: `Rate limit hit for this API key. ${wait}, then retry the same call unchanged \u2014 it is safe to retry.`
+        recovery: `Rate limit hit for this API key. ${wait}, then retry the same call unchanged; it is safe to retry.`
       };
     }
     const next = spineNextLine(mcpErr.details);
-    const recovery = next ?? authorityRecovery(mcpErr.details?.[0]);
+    const authority = mcpErr.details?.[0];
+    const recovery = next ?? ([authorityRecovery(authority), askNextLine(authority)].filter(Boolean).join("\n") || void 0);
     const said = recovery && !next ? cleanMessage.replace(/\s*\n\s*/g, " ") : cleanMessage;
     return { code: convexCode, fn, message: withAcceptPrompt(recovery ? `${said}${next ? "\n" : " "}${recovery}` : cleanMessage, mcpErr.details), ...recovery ? { recovery } : {} };
   }
@@ -1127,7 +1100,7 @@ ${next2}` : cleanMessage, mcpErr.details),
     return {
       code: "GATEWAY_TIMEOUT",
       message,
-      recovery: mayHaveLanded ? "The server was reachable and may have completed this write \u2014 verify before retrying, since a blind retry can duplicate it." : "The server was reachable but did not answer in time. Nothing was written \u2014 safe to retry."
+      recovery: mayHaveLanded ? "The server was reachable and may have completed this write. Verify before retrying: a blind retry can duplicate it." : "The server was reachable but did not answer in time. Nothing was written, so it is safe to retry."
     };
   }
   if (/network error|fetch failed|ECONNREFUSED|ETIMEDOUT/i.test(message)) {
@@ -1640,7 +1613,7 @@ function requireActiveSession() {
   const lc = sessionLifecycle();
   if (!lc.agentSessionId) {
     throw new Error(
-      "Active session required (SOS-iszqu7). Call `session action=start` then `orient` first."
+      "Session required for this read."
     );
   }
 }
@@ -1729,6 +1702,7 @@ export {
   formatInviteSentence,
   ORGANISATION_VALIDATION_REFUSALS,
   authorityRecovery,
+  returnedRefusal,
   withAcceptPrompt,
   acceptCall,
   PASS_SESSION_ID,
@@ -1774,4 +1748,4 @@ export {
   appUrl,
   apiKeysUrl
 };
-//# sourceMappingURL=chunk-AZT7HBBK.js.map
+//# sourceMappingURL=chunk-ATVNWS2Z.js.map