clay-server 4.3.0-beta.4 → 4.3.0-beta.5

package/lib/session-pair-mcp-server.js

@@ -19,7 +19,7 @@ function getToolDefs(handlers, options) {
       description: "Delegate one concrete follow-up task to the existing visible Split Worker. This tool is exposed only after the user has configured and accepted an exact pair. A completed turn does not end the Split Worker session: reuse the same Split Worker for follow-up implementation and corrections instead of taking over its work. Detached completions are pushed back automatically. A delegated turn cannot delegate back, so keep orchestration one hop deep.",
       inputSchema: buildShape({
         message: { type: "string", description: "The complete task or question for the partner." },
-        wait: { type: "boolean", description: "Wait for the partner's turn to finish. Defaults to true." },
+        wait: { type: "boolean", description: "Wait for the partner's turn to finish. Defaults to false; set true for an explicit blocking wait." },
         timeoutSeconds: { type: "number", description: "Maximum wait in seconds, from 1 to 900. Defaults to 300." },
         operationId: { type: "string", description: "Optional stable id for this delegation. Reusing it within the same human turn returns the original operation instead of sending twice." },
         taskId: { type: "string", description: "Optional stable task id for generation and completion correlation." },
@@ -28,7 +28,7 @@ function getToolDefs(handlers, options) {
     },
     {
       name: "read_partner",
-      description: "Read the Split Worker's current status and recent conversation turns, plus the same bounded capacity report partner_status returns. Use this for an interim check after a non-waiting delegation or timeout; completed results are pushed automatically.",
+      description: "Read the Split Worker's current status and recent conversation turns, plus the same bounded capacity report partner_status returns. Use only for a requested status, concrete failure or stall diagnosis, or capacity/queue decision; do not poll routinely. Completed results are pushed automatically.",
       inputSchema: buildShape({
         lastTurns: { type: "number", description: "Number of recent user-message-delimited turns, from 0 to 5. Use 0 for status only. Defaults to 1." },
       }),

package/lib/session-pair-prompts.js

@@ -76,7 +76,13 @@ var DRIVER_CORE = [
   "ambiguous and a visible pair exists, prefer the visible Split Worker. If review or user feedback requires",
   "corrections to the Split Worker's implementation, delegate a follow-up turn to that Split Worker instead of",
   "editing its files yourself. If a non-waiting delegation finishes later, Clay pushes the result back and",
-  "resumes you automatically. You also decide the Split Worker's tool-permission requests when they arise;",
+  "resumes you automatically. send_to_partner returns immediately by default; set wait to true only when you",
+  "explicitly need the final result in the same tool call. Do useful independent work after a non-waiting",
+  "delegation, then yield for Clay's automatic completion callback; do not poll read_partner or partner_status,",
+  "or sleep while waiting. Use those reads only for a user-requested status, concrete failure or stall diagnosis,",
+  "capacity/reuse decision, or exact queue inspection before mutation. Do not send the same correction as both",
+  "a live message and a queued task; consolidate review feedback into one bounded follow-up. You also decide",
+  "the Split Worker's tool-permission requests when they arise;",
   "approve only what falls inside the task the user authorized. Integrate and verify the final outcome. Do not",
   "search the project for implementations of these tools, and do not delegate work that must be performed",
   "sequentially in this same session.",

package/lib/sessions.js

@@ -230,7 +230,7 @@ function createSessionManager(opts) {
   }
 
   function appendToSessionFile(session, obj) {
-    if (!session.cliSessionId) return;
+    if (!session.cliSessionId) return true;
     session.lastActivity = Date.now();
     try {
       var afPath = sessionFilePath(session.cliSessionId);
@@ -238,8 +238,10 @@ function createSessionManager(opts) {
       if (process.platform !== "win32") {
         try { fs.chmodSync(afPath, 0o600); } catch (chmodErr) {}
       }
+      return true;
     } catch(e) {
       console.error("[session] Failed to append to session file:", e.message);
+      return false;
     }
   }
 
@@ -1031,7 +1033,7 @@ function createSessionManager(opts) {
     var outgoingObj = clientObj || obj;
     if (!outgoingObj._ts) outgoingObj._ts = obj._ts;
     session.history.push(obj);
-    appendToSessionFile(session, obj);
+    if (appendToSessionFile(session, obj) === false) return false;
     // Per-session out-of-band subscribers mirror mate session events into
     // a parallel UI without joining the project's
     // ws clients set). Subscribers receive the same obj that goes to ws
@@ -1087,6 +1089,33 @@ function createSessionManager(opts) {
     }
     // Notify server for cross-project unread tracking
     if (obj.type === "done") onSessionDone(session);
+    return true;
+  }
+
+  function sendAndRecordDurably(session, obj, clientObj) {
+    if (!session || !session.cliSessionId) return false;
+    var saved;
+    try { saved = doSendAndRecord(session, obj, clientObj); }
+    catch (error) {
+      var exact = JSON.stringify(obj);
+      if (hasDurableSessionRecord(session, function (record) { return JSON.stringify(record) === exact; })) return true;
+      if (session.history[session.history.length - 1] === obj) session.history.pop();
+      throw error;
+    }
+    if (saved === false && session.history[session.history.length - 1] === obj) session.history.pop();
+    return saved === true;
+  }
+
+  function hasDurableSessionRecord(session, predicate) {
+    if (!session || !session.cliSessionId || typeof predicate !== "function") return false;
+    try {
+      var lines = fs.readFileSync(sessionFilePath(session.cliSessionId), "utf8").split("\n");
+      for (var i = lines.length - 1; i >= 0; i--) {
+        if (!lines[i]) continue;
+        try { if (predicate(JSON.parse(lines[i]))) return true; } catch (error) {}
+      }
+    } catch (error) {}
+    return false;
   }
 
   function resumeSession(cliSessionId, opts, targetWs) {
@@ -1384,6 +1413,8 @@ function createSessionManager(opts) {
     saveSessionFile: saveSessionFile,
     appendToSessionFile: appendToSessionFile,
     sendAndRecord: doSendAndRecord,
+    sendAndRecordDurably: sendAndRecordDurably,
+    hasDurableSessionRecord: hasDurableSessionRecord,
     subscribeSession: function (localId, cb) {
       var session = sessions.get(localId);
       if (!session) return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clay-server",
-  "version": "4.3.0-beta.4",
+  "version": "4.3.0-beta.5",
   "description": "Self-hosted team workspace for Claude Code and Codex. Multi-user, browser-based, with persistent AI mates.",
   "bin": {
     "clay-server": "./bin/cli.js"