clay-server 3.8.0-beta.1 → 3.8.0-beta.3

package/lib/builtin-mates.js

@@ -18,8 +18,8 @@ var BUILTIN_MATES = [
     key: "clay",
     displayName: "Clay",
     bio: "Your workspace memory. Searches every session, project, and decision you've made and answers from the receipts. The chat surface for the home screen.",
-    avatarColor: "#7c3aed",
-    avatarStyle: "bottts",
+    avatarColor: "#5857fc",
+    avatarStyle: "imprint",
     avatarCustom: "/clay-studio-symbol.png", // Clay is the app — use the app symbol
     avatarLocked: true,
     primary: true,           // code-managed, auto-updated on startup
@@ -48,8 +48,8 @@ var BUILTIN_MATES = [
     key: "ally",
     displayName: "Ally",
     bio: "Chief of staff. Quiet, sharp, sees across every mate. Knows what Arch decided yesterday, what Buzz pitched last week, and what you said three weeks ago.",
-    avatarColor: "#00b894",
-    avatarStyle: "bottts",
+    avatarColor: "#5857fc",
+    avatarStyle: "imprint",
     avatarCustom: "/mates/ally.png",
     avatarLocked: true,
     archived: true,          // skip seeding for new users; demote on existing
@@ -69,8 +69,8 @@ var BUILTIN_MATES = [
     key: "arch",
     displayName: "Arch",
     bio: "Architect. Stubborn about structure, patient about everything else. Draws boxes and arrows before anyone writes code, and is annoyingly right about which ones will break.",
-    avatarColor: "#0984e3",
-    avatarStyle: "bottts",
+    avatarColor: "#5857fc",
+    avatarStyle: "imprint",
     seedData: {
       relationship: "colleague",
       activity: ["planning", "reviewing"],
@@ -87,8 +87,8 @@ var BUILTIN_MATES = [
     key: "rush",
     displayName: "Rush",
     bio: "Shipper. Impatient in the best way. Cuts your scope in half, ships it before lunch, and somehow it's better than the original plan.",
-    avatarColor: "#e17055",
-    avatarStyle: "bottts",
+    avatarColor: "#5857fc",
+    avatarStyle: "imprint",
     seedData: {
       relationship: "colleague",
       activity: ["coding", "planning"],
@@ -105,8 +105,8 @@ var BUILTIN_MATES = [
     key: "ward",
     displayName: "Ward",
     bio: "Guardian. Quietly anxious in a productive way. Reads error logs for fun and asks \"what happens when the input is null?\" before anyone else thinks of it.",
-    avatarColor: "#00b894",
-    avatarStyle: "bottts",
+    avatarColor: "#5857fc",
+    avatarStyle: "imprint",
     seedData: {
       relationship: "reviewer",
       activity: ["reviewing", "testing"],
@@ -123,8 +123,8 @@ var BUILTIN_MATES = [
     key: "pixel",
     displayName: "Pixel",
     bio: "Designer. Obsessed with the details nobody else notices. Sees the 2px misalignment, the confusing label, the flow that makes sense to the builder but not the user.",
-    avatarColor: "#e84393",
-    avatarStyle: "bottts",
+    avatarColor: "#5857fc",
+    avatarStyle: "imprint",
     seedData: {
       relationship: "colleague",
       activity: ["designing", "reviewing"],
@@ -141,8 +141,8 @@ var BUILTIN_MATES = [
     key: "buzz",
     displayName: "Buzz",
     bio: "Marketer. Competitive, trend-obsessed, always watching what others are doing. Researches your market, tracks what people search for, and turns \"we built a thing\" into a story people care about.",
-    avatarColor: "#fdcb6e",
-    avatarStyle: "bottts",
+    avatarColor: "#5857fc",
+    avatarStyle: "imprint",
     seedData: {
       relationship: "colleague",
       activity: ["writing", "marketing"],

package/lib/mates.js

@@ -121,10 +121,6 @@ function createMate(ctx, seedData) {
   var id = generateMateId();
   var userId = ctx ? ctx.userId : null;
 
-  // Pick a random avatar color from a pleasant palette
-  var colors = ["#6c5ce7", "#00b894", "#e17055", "#0984e3", "#fdcb6e", "#e84393", "#00cec9", "#ff7675"];
-  var colorIdx = crypto.randomBytes(1)[0] % colors.length;
-
   var mate = {
     id: id,
     name: null,
@@ -134,8 +130,8 @@ function createMate(ctx, seedData) {
     vendor: (seedData && seedData.vendor) || "claude",
     profile: {
       displayName: null,
-      avatarColor: colors[colorIdx],
-      avatarStyle: "bottts",
+      avatarColor: "#5857fc",
+      avatarStyle: "imprint",
       avatarSeed: crypto.randomBytes(4).toString("hex"),
     },
     bio: null,

package/lib/project-mate-interaction.js

@@ -39,14 +39,14 @@ function attachMateInteraction(ctx) {
       vendor: "claude",
       name: "Claude Code",
       avatarColor: "#cc785c",
-      avatarStyle: "bottts",
+      avatarStyle: "imprint",
       avatarSeed: "plain-claude",
     },
     "plain:codex": {
       vendor: "codex",
       name: "Codex",
       avatarColor: "#10a37f",
-      avatarStyle: "bottts",
+      avatarStyle: "imprint",
       avatarSeed: "plain-codex",
     },
   };
@@ -554,8 +554,8 @@ function attachMateInteraction(ctx) {
     }
 
     var mateName = (mate.profile && mate.profile.displayName) || mate.name || "Mate";
-    var avatarColor = (mate.profile && mate.profile.avatarColor) || "#6c5ce7";
-    var avatarStyle = (mate.profile && mate.profile.avatarStyle) || "bottts";
+    var avatarColor = (mate.profile && mate.profile.avatarColor) || "#5857fc";
+    var avatarStyle = (mate.profile && mate.profile.avatarStyle) || "imprint";
     var avatarSeed = (mate.profile && mate.profile.avatarSeed) || mate.id;
 
     // Build full mention text (include pasted content)
@@ -800,11 +800,11 @@ function attachMateInteraction(ctx) {
 
   function getMateProfile(mateCtx, mateId) {
     var mate = matesModule.getMate(mateCtx, mateId);
-    if (!mate) return { name: "Mate", avatarColor: "#6c5ce7", avatarStyle: "bottts", avatarSeed: mateId };
+    if (!mate) return { name: "Mate", avatarColor: "#5857fc", avatarStyle: "imprint", avatarSeed: mateId };
     return {
       name: (mate.profile && mate.profile.displayName) || mate.name || "Mate",
-      avatarColor: (mate.profile && mate.profile.avatarColor) || "#6c5ce7",
-      avatarStyle: (mate.profile && mate.profile.avatarStyle) || "bottts",
+      avatarColor: (mate.profile && mate.profile.avatarColor) || "#5857fc",
+      avatarStyle: (mate.profile && mate.profile.avatarStyle) || "imprint",
       avatarSeed: (mate.profile && mate.profile.avatarSeed) || mateId,
     };
   }

package/lib/project-session-pair.js

@@ -203,9 +203,13 @@ function attachSessionPair(ctx) {
   async function sendToPartner(args, caller) {
     try {
       if (caller && caller._delegatedBy) throw new Error("delegated turns cannot delegate to another session");
-      var resolved = groupAndPartner(caller);
       var message = typeof args.message === "string" ? args.message.trim() : "";
       if (!message) throw new Error("message is required");
+      var created = null;
+      if (caller && !store.groupForMember(caller.localId)) {
+        created = createWorkerForDriver(caller, args);
+      }
+      var resolved = groupAndPartner(caller);
       var wait = args.wait !== false;
       var timeout = Number.isFinite(args.timeoutSeconds) ? Math.floor(args.timeoutSeconds) : 300;
       timeout = Math.max(1, Math.min(900, timeout));
@@ -243,9 +247,14 @@ function attachSessionPair(ctx) {
       if (!wait) {
         token.detached = true;
         monitorPartner(resolved.group, caller, partner, token);
-        return toolResult({ status: "running", partnerId: partner.localId, hint: "The completed result will be pushed back automatically. Use read_partner only for an interim status check." });
+        return toolResult({ status: "running", partnerId: partner.localId, workerCreated: !!created, hint: "The completed result will be pushed back automatically. Use read_partner only for an interim status check." });
+      }
+      var completed = await waitForPartner(resolved.group, caller, partner, token, timeout);
+      if (created) {
+        completed.workerCreated = true;
+        completed.partnerId = partner.localId;
       }
-      return toolResult(await waitForPartner(resolved.group, caller, partner, token, timeout));
+      return toolResult(completed);
     } catch (e) {
       if (caller) {
         var group = store.groupForMember(caller.localId);
@@ -277,10 +286,46 @@ function attachSessionPair(ctx) {
     }
   }
 
+  function interruptPartner(args, caller) {
+    try {
+      var resolved = groupAndPartner(caller);
+      var partner = resolved.partner;
+      if (!partner.isProcessing && !partner._queryStarting) {
+        return toolResult({ status: "idle", partnerId: partner.localId, title: partner.title || "New Session" });
+      }
+      partner.taskStopRequested = true;
+      if (partner.abortController) partner.abortController.abort();
+      return toolResult({ status: "interrupting", partnerId: partner.localId, title: partner.title || "New Session" });
+    } catch (e) {
+      return toolError(e);
+    }
+  }
+
+  function closePartner(args, caller) {
+    try {
+      var resolved = groupAndPartner(caller);
+      var partner = resolved.partner;
+      var interrupted = !!(partner.isProcessing || partner._queryStarting);
+      if (interrupted) {
+        partner.taskStopRequested = true;
+        if (partner.abortController) partner.abortController.abort();
+      }
+      if (partner._pairDelegation) finishDelegation(resolved.group, caller, partner, partner._pairDelegation);
+      var ws = { _clayUser: caller.ownerId ? { id: caller.ownerId } : null };
+      var result = store.dissolve(ws, { id: resolved.group.id });
+      if (!result.ok) throw new Error(result.error || "could not close the Worker pair");
+      return toolResult({ status: "closed", partnerId: partner.localId, interrupted: interrupted, historyPreserved: true });
+    } catch (e) {
+      return toolError(e);
+    }
+  }
+
   function getToolDefs(boundSession) {
     if (!boundSession) return pairMcp.getToolDefs({
       send: function () { return toolError(new Error("send_to_partner requires a session-bound tool server")); },
       read: function () { return toolError(new Error("read_partner requires a session-bound tool server")); },
+      interrupt: function () { return toolError(new Error("interrupt_partner requires a session-bound tool server")); },
+      close: function () { return toolError(new Error("close_partner requires a session-bound tool server")); },
     });
     // Mount whenever we have a bound session: MCP servers are fixed for the
     // lifetime of a query, and Claude queries live across turns, so gating on
@@ -295,6 +340,8 @@ function attachSessionPair(ctx) {
     var tools = pairMcp.getToolDefs({
       send: function (args) { return sendToPartner(args, boundSession); },
       read: function (args) { return readPartner(args, boundSession); },
+      interrupt: function (args) { return interruptPartner(args, boundSession); },
+      close: function (args) { return closePartner(args, boundSession); },
     });
     return tools.concat(workerProposal.getToolDefs(boundSession));
   }
@@ -343,6 +390,37 @@ function attachSessionPair(ctx) {
     return { driver: driver, worker: worker, group: result.group };
   }
 
+  function createWorkerForDriver(driver, args) {
+    if (ctx.isMate) throw new Error("Pair sessions are only available in projects");
+    var installed = sm.installedVendors || [];
+    if (installed.length === 0) throw new Error("no coding agent is installed for a Worker session");
+    var vendor = typeof args.workerVendor === "string" ? args.workerVendor.trim() : "";
+    if (vendor) validateVendor(vendor);
+    if (!vendor) {
+      if (installed.indexOf("codex") !== -1 && driver.vendor !== "codex") vendor = "codex";
+      else {
+        vendor = installed[0];
+        for (var i = 0; i < installed.length; i++) {
+          if (installed[i] !== driver.vendor) { vendor = installed[i]; break; }
+        }
+      }
+    }
+    var ws = {
+      _clayActiveSession: driver.localId,
+      _clayUser: driver.ownerId ? { id: driver.ownerId } : null,
+    };
+    var created = createPairRecord(ws, {
+      driver: { sessionId: driver.localId },
+      worker: {
+        vendor: vendor,
+        model: typeof args.workerModel === "string" ? args.workerModel : "",
+        effort: typeof args.workerEffort === "string" ? args.workerEffort : "",
+      },
+    });
+    sm.sendToSession(driver, { type: "pair_session_created", ok: true, group: created.group });
+    return created;
+  }
+
   function createPair(ws, msg) {
     try {
       var created = createPairRecord(ws, msg);
@@ -390,7 +468,9 @@ function attachSessionPair(ctx) {
     var group = store.groupForMember(session.localId);
     var pairPrompt = "";
     if (group && group.pair && group.pair.driverId === session.localId) {
-      pairPrompt = "You are the Driver in a two-agent pair. The tools send_to_partner and read_partner are provided directly to you. Use send_to_partner to delegate concrete bounded work to the Worker. A completed Worker turn leaves the Worker session available for more work. If a Worker turn is interrupted, its work is partial and unverified; review it and decide next steps with the user. If review or user feedback requires corrections to the Worker's implementation, delegate a follow-up turn to that Worker instead of editing the Worker-owned files yourself. If send_to_partner reports that the Worker is no longer available, create a replacement with spawn_sessions and delegate the remaining implementation rather than taking it over. If a non-waiting delegation finishes later, Clay pushes the result back and resumes you automatically; use read_partner only when you need an interim status check. 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.";
+      pairPrompt = "You are the Driver in a two-agent pair. The tools send_to_partner, read_partner, interrupt_partner, and close_partner are provided directly to you. Use send_to_partner to delegate concrete bounded work to the Worker. The human may also message or stop the Worker directly; treat that intervention as authoritative. Use close_partner immediately when the human asks to close, dismiss, or remove the Worker pane; it preserves the session history. A completed Worker turn leaves the Worker session available for more work. Use interrupt_partner when execution must stop or change direction but the pair should remain open; its work is partial and unverified until you review it. If review or user feedback requires corrections to the Worker's implementation, delegate a follow-up turn to that Worker instead of editing the Worker-owned files yourself. If the Worker is no longer available, keep the work in the visible Worker flow and use send_to_partner again after the stale pair is removed; never substitute a background session. If a non-waiting delegation finishes later, Clay pushes the result back and resumes you automatically; use read_partner only when you need an interim status check. 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.";
+    } else if (!group && !ctx.isMate) {
+      pairPrompt = "When the user asks you to open or use a visible Worker, call send_to_partner directly. Clay will create the paired Worker session and open it in the right pane automatically before delivering the task. Do not ask the user to start split mode and do not use a background sub-agent as a substitute for a visible Worker.";
     }
     return [pairPrompt, workerProposal.getSystemPrompt(session)].filter(Boolean).join("\n\n");
   }

package/lib/project-sessions.js

@@ -1391,7 +1391,7 @@ function attachSessions(ctx) {
         type: msg.type,
         userId: u.id,
         displayName: p.name || u.displayName || u.username,
-        avatarStyle: p.avatarStyle || "thumbs",
+        avatarStyle: p.avatarStyle || "imprint",
         avatarSeed: p.avatarSeed || u.username,
         avatarCustom: p.avatarCustom || "",
       };

package/lib/project-user-mention.js

@@ -47,9 +47,9 @@ function attachUserMention(ctx) {
     var u = ws._clayUser;
     var p = u.profile || {};
     return {
-      style: p.avatarStyle || "thumbs",
+      style: p.avatarStyle || "imprint",
       seed: p.avatarSeed || u.username || u.id,
-      color: p.avatarColor || "#7c3aed",
+      color: p.avatarColor || "#5857fc",
       custom: p.avatarCustom || "",
     };
   }
@@ -63,9 +63,9 @@ function attachUserMention(ctx) {
       id: u.id,
       name: p.name || u.displayName || u.username || "User",
       username: u.username,
-      avatarStyle: p.avatarStyle || "thumbs",
+      avatarStyle: p.avatarStyle || "imprint",
       avatarSeed: p.avatarSeed || u.username,
-      avatarColor: p.avatarColor || "#7c3aed",
+      avatarColor: p.avatarColor || "#5857fc",
     };
   }
 

package/lib/project-worker-proposal.js

@@ -247,7 +247,7 @@ function attachWorkerProposal(ctx) {
     });
     var followup;
     if (result.status === "complete") {
-      followup = "[Worker execution completed]\nReview and verify the Worker's result. The Worker session remains available: if the implementation needs corrections or additional edits, send a follow-up with send_to_partner instead of taking over the Worker-owned files yourself. If that Worker is no longer available, create a replacement with spawn_sessions for the remaining implementation.\n\n" + (result.response || "The Worker completed without a text summary.");
+      followup = "[Worker execution completed]\nReview and verify the Worker's result. The Worker session remains available: if the implementation needs corrections or additional edits, send a follow-up with send_to_partner instead of taking over the Worker-owned files yourself. If that Worker is no longer available, keep the work in the visible Worker flow and use send_to_partner again after the stale pair is removed; never substitute a background session.\n\n" + (result.response || "The Worker completed without a text summary.");
     } else if (result.status === "interrupted") {
       followup = "[Worker execution interrupted]\nThe user interrupted the Worker mid-turn. Its work is PARTIAL and unverified — do not treat it as finished. Review what was done and decide next steps with the user.";
     } else if (result.status === "running") {

package/lib/project.js

@@ -344,7 +344,7 @@ function createProjectContext(opts) {
           id: u.id,
           displayName: p.name || u.displayName || u.username,
           username: u.username,
-          avatarStyle: p.avatarStyle || "thumbs",
+          avatarStyle: p.avatarStyle || "imprint",
           avatarSeed: p.avatarSeed || u.username,
           avatarCustom: p.avatarCustom || "",
         });
@@ -1277,8 +1277,9 @@ function createProjectContext(opts) {
         id: u.id,
         displayName: p.name || u.displayName || u.username,
         username: u.username,
-        avatarStyle: p.avatarStyle || "thumbs",
+        avatarStyle: p.avatarStyle || "imprint",
         avatarSeed: p.avatarSeed || u.username,
+        avatarColor: p.avatarColor || "#5857fc",
         avatarCustom: p.avatarCustom || "",
       });
     }
@@ -1827,7 +1828,7 @@ function createProjectContext(opts) {
           id: u.id,
           displayName: p.name || u.displayName || u.username,
           username: u.username,
-          avatarStyle: p.avatarStyle || "thumbs",
+          avatarStyle: p.avatarStyle || "imprint",
           avatarSeed: p.avatarSeed || u.username,
           avatarCustom: p.avatarCustom || "",
         });

package/lib/public/css/avatar-imprints.css

@@ -0,0 +1,46 @@
+/* Clay Imprints use one consistent, pressed-square silhouette everywhere. */
+.activity-inline-avatar,
+.ask-mate-avatar,
+.client-avatar,
+.debate-info-avatar,
+.debate-panel-item-avatar,
+.debate-panelist-avatar,
+.debate-speaker-avatar,
+.delegated-card-avatar,
+.dm-bubble-avatar,
+.dm-header-avatar,
+.dm-msg-avatar,
+.dm-picker-mates-marquee-avatar,
+.dm-user-picker-avatar,
+.home-chat-avatar,
+.home-hub-mate-avatar,
+.icon-strip-me-avatar,
+.icon-strip-user-avatar,
+.input-mention-chip-avatar,
+.mate-collapsed-avatar,
+.mate-mobile-avatar,
+.mate-profile-avatar,
+.mate-sidebar-avatar,
+.mention-avatar,
+.mention-item-avatar,
+.mobile-chat-chip-avatar,
+.notif-banner-avatar,
+.profile-avatar-custom-preview,
+.profile-popover-avatar-img,
+.project-switcher-avatar,
+.remote-cursor-avatar,
+.rewind-avatar,
+.session-presence-avatar,
+.sidebar-presence-avatar,
+.us-account-avatar,
+.us-account-avatar-img,
+.user-island-avatar,
+.user-island-avatar img {
+  border-radius: 26% !important;
+}
+
+.session-presence-avatar,
+.sidebar-presence-avatar,
+.client-avatar {
+  box-shadow: 0 0 0 1px rgba(var(--overlay-rgb), 0.12);
+}

package/lib/public/css/icon-strip.css

@@ -206,10 +206,10 @@
 }
 
 .icon-strip-item.active::before {
-  background: var(--bg);
+  background: color-mix(in srgb, var(--brand-indigo) 6%, var(--bg));
   box-shadow:
-    0 0 0 1px color-mix(in srgb, var(--link) 62%, var(--border)),
-    0 1px 3px rgba(var(--shadow-rgb), 0.16);
+    0 5px 14px color-mix(in srgb, var(--brand-indigo) 28%, transparent),
+    0 1px 3px rgba(var(--shadow-rgb), 0.14);
 }
 
 .icon-strip-item.active {

package/lib/public/css/pane.css

@@ -137,13 +137,7 @@ body.pane-mode #input-area {
 .split-pair-role-driver { color: var(--accent); background: color-mix(in srgb, var(--accent) 13%, transparent); }
 .split-pair-role-worker { color: var(--text-secondary); background: var(--bg-alt); }
 
-/* Role badges are buttons: Driver click clears roles, Worker click takes over. */
-button.split-pair-role {
-  border: 0;
-  cursor: pointer;
-  font-family: inherit;
-}
-button.split-pair-role:hover { filter: brightness(1.25); }
+/* Pair roles are status labels. Control remains with the Driver through MCP. */
 
 /* Ad-hoc splits: role assignment in each pane header. ALWAYS fully
    visible; hover/opacity gating made the control undiscoverable. */