agenthub-multiagent-mcp 1.72.0 → 1.74.0

package/dist/zohoSendOutcome.d.ts

@@ -0,0 +1,13 @@
+/**
+ * True when the call may have been carried out although it did not succeed:
+ * the server said so (`zoho_outcome_unknown`), something in front of the server
+ * answered instead of AgentHub (a 502/503/504 with no AgentHub error code), or
+ * no answer arrived at all (network error, client timeout).
+ *
+ * AgentHub's own coded errors are definite answers and pass through, including
+ * its coded 502s (`reply_recipients_unavailable`, `zoho_error`) and `504
+ * zoho_timeout`, which means nothing was saved.
+ */
+export declare function isUnknownSendOutcome(err: unknown): boolean;
+export declare function unknownSendOutcomeError(mailbox: string, mode: "draft" | "send", cause: unknown): Error;
+//# sourceMappingURL=zohoSendOutcome.d.ts.map

package/dist/zohoSendOutcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zohoSendOutcome.d.ts","sourceRoot":"","sources":["../src/zohoSendOutcome.ts"],"names":[],"mappings":"AAYA;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAQ1D;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,CAQtG"}

package/dist/zohoSendOutcome.js

@@ -0,0 +1,37 @@
+// fix-zoho-send-write-deadline (AGHUB-2108) — a zoho_send_email call whose
+// answer was lost.
+//
+// On 2026-10-30 the server saved a 9-attachment draft and the caller got
+// nginx's 502: the answer was lost, not the work. Reporting that as a plain
+// failure invites a retry, which saves a second draft or, with mode=send, sends
+// the email twice. When the outcome is unknown, say so.
+import { AgentHubApiError } from "./client.js";
+const GATEWAY_STATUSES = new Set([502, 503, 504]);
+/**
+ * True when the call may have been carried out although it did not succeed:
+ * the server said so (`zoho_outcome_unknown`), something in front of the server
+ * answered instead of AgentHub (a 502/503/504 with no AgentHub error code), or
+ * no answer arrived at all (network error, client timeout).
+ *
+ * AgentHub's own coded errors are definite answers and pass through, including
+ * its coded 502s (`reply_recipients_unavailable`, `zoho_error`) and `504
+ * zoho_timeout`, which means nothing was saved.
+ */
+export function isUnknownSendOutcome(err) {
+    if (err instanceof AgentHubApiError) {
+        if (err.code === "zoho_outcome_unknown")
+            return true;
+        return err.code === "" && GATEWAY_STATUSES.has(err.status);
+    }
+    // Anything else thrown by the request is a transport failure or timeout:
+    // the server may have received and run the call.
+    return err instanceof Error;
+}
+export function unknownSendOutcomeError(mailbox, mode, cause) {
+    const what = mode === "send" ? "the email may have been sent" : "the draft may have been saved";
+    const detail = cause instanceof Error ? cause.message : String(cause);
+    return new Error(`Outcome unknown: no answer reached this call, so ${what} in ${mailbox}. ` +
+        `Check its Drafts and Sent folders (zoho_search on the subject) before retrying; ` +
+        `retrying blindly can create a duplicate draft or send the email twice. (${detail})`);
+}
+//# sourceMappingURL=zohoSendOutcome.js.map

package/dist/zohoSendOutcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zohoSendOutcome.js","sourceRoot":"","sources":["../src/zohoSendOutcome.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,mBAAmB;AACnB,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,gFAAgF;AAChF,wDAAwD;AAExD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,IAAI,GAAG,YAAY,gBAAgB,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,IAAI,KAAK,sBAAsB;YAAE,OAAO,IAAI,CAAC;QACrD,OAAO,GAAG,CAAC,IAAI,KAAK,EAAE,IAAI,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7D,CAAC;IACD,yEAAyE;IACzE,iDAAiD;IACjD,OAAO,GAAG,YAAY,KAAK,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAe,EAAE,IAAsB,EAAE,KAAc;IAC7F,MAAM,IAAI,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,+BAA+B,CAAC;IAChG,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtE,OAAO,IAAI,KAAK,CACd,oDAAoD,IAAI,OAAO,OAAO,IAAI;QACxE,kFAAkF;QAClF,2EAA2E,MAAM,GAAG,CACvF,CAAC;AACJ,CAAC"}

package/dist/zohoSendOutcome.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=zohoSendOutcome.test.d.ts.map

package/dist/zohoSendOutcome.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zohoSendOutcome.test.d.ts","sourceRoot":"","sources":["../src/zohoSendOutcome.test.ts"],"names":[],"mappings":""}

package/dist/zohoSendOutcome.test.js

@@ -0,0 +1,58 @@
+import { describe, it, expect, afterEach } from "vitest";
+import { AgentHubApiError, requestTimeoutMs, DEFAULT_TIMEOUT_MS, ZOHO_SEND_TIMEOUT_MS } from "./client.js";
+import { isUnknownSendOutcome, unknownSendOutcomeError } from "./zohoSendOutcome.js";
+// fix-zoho-send-write-deadline (AGHUB-2108). A zoho_send_email call whose
+// answer was lost may have saved the draft or sent the email. Reporting it as a
+// plain failure invites a retry that duplicates it.
+afterEach(() => {
+    delete process.env.AGENTHUB_REQUEST_TIMEOUT_MS;
+});
+describe("isUnknownSendOutcome", () => {
+    it("treats the proxy's own 502/503/504 (no AgentHub code) as unknown", () => {
+        for (const status of [502, 503, 504]) {
+            const err = new AgentHubApiError(`HTTP ${status} from POST /zoho/send: non-JSON response: <html>`, status, "");
+            expect(isUnknownSendOutcome(err)).toBe(true);
+        }
+    });
+    it("treats the server's zoho_outcome_unknown as unknown", () => {
+        expect(isUnknownSendOutcome(new AgentHubApiError("Zoho did not answer", 504, "zoho_outcome_unknown"))).toBe(true);
+    });
+    it("treats a network error or client timeout as unknown", () => {
+        expect(isUnknownSendOutcome(new TypeError("fetch failed"))).toBe(true);
+        expect(isUnknownSendOutcome(new Error("POST /zoho/send timed out after 70000ms"))).toBe(true);
+    });
+    it("passes AgentHub's coded errors through", () => {
+        expect(isUnknownSendOutcome(new AgentHubApiError("x", 502, "reply_recipients_unavailable"))).toBe(false);
+        expect(isUnknownSendOutcome(new AgentHubApiError("x", 502, "zoho_error"))).toBe(false);
+        expect(isUnknownSendOutcome(new AgentHubApiError("x", 504, "zoho_timeout"))).toBe(false);
+        expect(isUnknownSendOutcome(new AgentHubApiError("x", 403, "recipient_not_allowed"))).toBe(false);
+        expect(isUnknownSendOutcome(new AgentHubApiError("x", 500, ""))).toBe(false);
+    });
+});
+describe("unknownSendOutcomeError", () => {
+    it("says what may have happened and to check before retrying", () => {
+        const draft = unknownSendOutcomeError("sumit@contetial.com", "draft", new Error("HTTP 502")).message;
+        expect(draft).toMatch(/outcome unknown/i);
+        expect(draft).toMatch(/may have been saved/);
+        expect(draft).toMatch(/Drafts and Sent/);
+        expect(draft).toMatch(/before retrying/);
+        expect(draft).toContain("HTTP 502");
+        const send = unknownSendOutcomeError("admin@contetial.com", "send", new Error("x")).message;
+        expect(send).toMatch(/may have been sent/);
+    });
+});
+describe("zoho send request timeout", () => {
+    it("outlasts the server's 55s send budget", () => {
+        expect(ZOHO_SEND_TIMEOUT_MS).toBeGreaterThan(55_000);
+        expect(requestTimeoutMs("/zoho/send")).toBe(ZOHO_SEND_TIMEOUT_MS);
+    });
+    it("is not lowered by a smaller general override", () => {
+        process.env.AGENTHUB_REQUEST_TIMEOUT_MS = "20000";
+        expect(requestTimeoutMs("/zoho/send")).toBe(ZOHO_SEND_TIMEOUT_MS);
+        expect(requestTimeoutMs("/messages")).toBe(20_000);
+    });
+    it("leaves other paths on the default", () => {
+        expect(requestTimeoutMs("/zoho/messages")).toBe(DEFAULT_TIMEOUT_MS);
+    });
+});
+//# sourceMappingURL=zohoSendOutcome.test.js.map

package/dist/zohoSendOutcome.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zohoSendOutcome.test.js","sourceRoot":"","sources":["../src/zohoSendOutcome.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenthub-multiagent-mcp",
-  "version": "1.72.0",
+  "version": "1.74.0",
   "description": "MCP server for AgentHub multi-agent communication",
   "type": "module",
   "main": "dist/index.js",

package/skills/catalog.json

@@ -92,8 +92,10 @@
       "name": "zoho-mail",
       "description": "Read and reply to email in a registered Zoho mailbox: find the message, read its attachments, and save a threaded Reply-All draft with files attached, then verify what was saved. Written after a 2026-10-30 bid draft lost its attachments, cc and thread.",
       "category": "skill",
-      "current_hash": "017cd03e191c847ade9b21fa356faf3bbe96515942f1580360394820dc29af55",
-      "prior_hashes": []
+      "current_hash": "972be83d5d7ae1dcb6434ba7802cdee941d4e7bd9c45add0ca16a5a6b533c2c1",
+      "prior_hashes": [
+        "017cd03e191c847ade9b21fa356faf3bbe96515942f1580360394820dc29af55"
+      ]
     }
   ]
 }

package/skills/manifest.json

@@ -56,7 +56,8 @@
     },
     "skills/zoho-mail/SKILL.md": {
       "hashes": [
-        "017cd03e191c847ade9b21fa356faf3bbe96515942f1580360394820dc29af55"
+        "017cd03e191c847ade9b21fa356faf3bbe96515942f1580360394820dc29af55",
+        "972be83d5d7ae1dcb6434ba7802cdee941d4e7bd9c45add0ca16a5a6b533c2c1"
       ]
     }
   }

package/skills/skills/zoho-mail/SKILL.md

@@ -110,5 +110,7 @@ its id; the human deletes it in Zoho web so it is never sent by mistake.
 | `502 reply_recipients_unavailable` | Zoho did not return the original's headers for Reply-All | Retry once; otherwise pass `to`/`cc` explicitly from `zoho_read_message` |
 | `422 reply_draft_unsupported` | Zoho did not confirm the reply was saved as a draft | Stop and report; do not retry as `send` |
 | `429 send_cap_exceeded` | Daily send cap reached | Stop; tell your human |
+| `Outcome unknown: …` (also `504 zoho_outcome_unknown`, a bare gateway 502/504, a timeout) | The answer was lost: the draft **may have been saved**, or with `mode=send` the email **may have been sent** | **Do not retry yet.** `zoho_search` the subject in Drafts and Sent; retry only if it is in neither. Report what you found |
+| `504 zoho_timeout` | Zoho did not answer an attachment upload; nothing was saved or sent | Retry once; then send fewer or smaller files |
 
 Full reference: `zoho-mail-connector-guide`.