clay-server 3.7.0 → 3.8.0-beta.2

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/os-users.js

@@ -98,7 +98,7 @@ function resolveOsUserInfo(username) {
 
 /**
  * Run a file system operation as a specific OS user via a helper subprocess.
- * op: "list", "read", "write", "stat"
+ * op: "list", "read", "write", "read_binary", "mkdir", "copy", "stat"
  * args: operation-specific arguments
  * osUserInfo: { uid, gid } from resolveOsUserInfo
  * Returns the result object or throws.
@@ -164,6 +164,22 @@ function fsAsUser(op, args, osUserInfo) {
       "fs.writeFileSync(f, content, 'utf8');",
       "process.stdout.write(JSON.stringify({ ok: true }));",
     ].join(" ");
+  } else if (op === "mkdir") {
+    script = [
+      "var fs = require('fs');",
+      "var dir = " + JSON.stringify(args.dir) + ";",
+      "fs.mkdirSync(dir, { recursive: true });",
+      "process.stdout.write(JSON.stringify({ ok: true }));",
+    ].join(" ");
+  } else if (op === "copy") {
+    script = [
+      "var fs = require('fs');",
+      "var source = " + JSON.stringify(args.source) + ";",
+      "var file = " + JSON.stringify(args.file) + ";",
+      "var overwrite = " + JSON.stringify(!!args.overwrite) + ";",
+      "fs.copyFileSync(source, file, overwrite ? 0 : fs.constants.COPYFILE_EXCL);",
+      "process.stdout.write(JSON.stringify({ ok: true }));",
+    ].join(" ");
   } else {
     throw new Error("Unknown fsAsUser operation: " + op);
   }

package/lib/project-http.js

@@ -41,7 +41,7 @@ function parseJsonBody(req) {
  * ctx fields:
  *   cwd, slug, project, sm, send, sendTo, imagesDir, osUsers, pushModule,
  *   safePath, safeAbsPath, getOsUserInfoForReq, sendExtensionCommandAny,
- *   _extToken, _browserTabList
+ *   saveGeneratedImageToProject, _extToken, _browserTabList
  */
 function attachHTTP(ctx) {
   var cwd = ctx.cwd;
@@ -51,6 +51,7 @@ function attachHTTP(ctx) {
   var gitAttribution = ctx.gitAttribution;
   var send = ctx.send;
   var imagesDir = ctx.imagesDir;
+  var saveGeneratedImageToProject = ctx.saveGeneratedImageToProject;
   var osUsers = ctx.osUsers;
   var pushModule = ctx.pushModule;
   var safePath = ctx.safePath;
@@ -122,6 +123,38 @@ function attachHTTP(ctx) {
       return true;
     }
 
+    // Copy a generated image from Clay's session storage into the project.
+    if (req.method === "POST" && urlPath === "/api/generated-image/save") {
+      if (usersModule.isMultiUser()) {
+        var imageSaveUser = req._clayUser;
+        var imageSavePermissions = imageSaveUser ? usersModule.getEffectivePermissions(imageSaveUser, osUsers) : null;
+        if (!imageSavePermissions || !imageSavePermissions.fileBrowser) {
+          res.writeHead(403, { "Content-Type": "application/json" });
+          res.end('{"error":"File browser access is not permitted"}');
+          return true;
+        }
+      }
+      parseJsonBody(req).then(function (body) {
+        if (typeof saveGeneratedImageToProject !== "function") {
+          res.writeHead(501, { "Content-Type": "application/json" });
+          res.end('{"error":"Generated image saving is not available"}');
+          return;
+        }
+        var result = saveGeneratedImageToProject(
+          body.fileName,
+          body.path,
+          !!body.overwrite,
+          getOsUserInfoForReq(req)
+        );
+        res.writeHead(result.ok ? 200 : (result.status || 500), { "Content-Type": "application/json" });
+        res.end(JSON.stringify(result));
+      }).catch(function () {
+        res.writeHead(400, { "Content-Type": "application/json" });
+        res.end('{"error":"Invalid JSON body"}');
+      });
+      return true;
+    }
+
     // File upload
     if (req.method === "POST" && urlPath === "/api/upload") {
       parseJsonBody(req).then(function (body) {

package/lib/project-image.js

@@ -12,13 +12,98 @@ var execFileSync = require("child_process").execFileSync;
 function attachImage(ctx) {
   var cwd = ctx.cwd;
   var slug = ctx.slug;
+  var fsAsUser = ctx.fsAsUser;
 
   // --- Chat image storage ---
   var _imgConfig = require("./config");
   var _imgUtils = require("./utils");
   var _imagesBaseDir = path.join(_imgConfig.CONFIG_DIR, "images");
   var _imagesEncodedCwd = _imgUtils.encodeCwd(cwd);
-  var imagesDir = path.join(_imagesBaseDir, _imagesEncodedCwd);
+  var imagesDir = ctx.imagesDir || path.join(_imagesBaseDir, _imagesEncodedCwd);
+
+  function isWithin(base, candidate) {
+    return candidate === base || candidate.indexOf(base + path.sep) === 0;
+  }
+
+  function saveGeneratedImageToProject(fileName, requestedPath, overwrite, osUserInfo) {
+    if (typeof fileName !== "string" || !/^\d+-[a-f0-9]+\.\w+$/.test(fileName)) {
+      return { ok: false, status: 400, error: "Invalid generated image" };
+    }
+    if (typeof requestedPath !== "string" || !requestedPath.trim() || requestedPath.length > 500) {
+      return { ok: false, status: 400, error: "Enter a project path" };
+    }
+
+    var sourcePath = path.join(imagesDir, fileName);
+    var sourceExt = path.extname(fileName).toLowerCase();
+    var targetPath = requestedPath.trim();
+    if (path.isAbsolute(targetPath)) {
+      return { ok: false, status: 400, error: "Use a project-relative path" };
+    }
+    var targetExt = path.extname(targetPath).toLowerCase();
+    if (targetExt !== sourceExt) {
+      return { ok: false, status: 400, error: "Keep the " + sourceExt + " file extension" };
+    }
+
+    var projectRoot;
+    var targetAbs;
+    try {
+      projectRoot = fs.realpathSync(cwd);
+      targetAbs = path.resolve(projectRoot, targetPath);
+    } catch (e) {
+      return { ok: false, status: 400, error: "Project path is not available" };
+    }
+    if (targetAbs === projectRoot || !isWithin(projectRoot, targetAbs)) {
+      return { ok: false, status: 403, error: "Path must stay inside the project" };
+    }
+
+    try {
+      var sourceReal = fs.realpathSync(sourcePath);
+      var imagesRoot = fs.realpathSync(imagesDir);
+      if (!isWithin(imagesRoot, sourceReal) || !fs.statSync(sourceReal).isFile()) {
+        return { ok: false, status: 404, error: "Generated image not found" };
+      }
+
+      var parentDir = path.dirname(targetAbs);
+      var existingParent = parentDir;
+      while (!fs.existsSync(existingParent) && existingParent !== projectRoot) {
+        existingParent = path.dirname(existingParent);
+      }
+      var realExistingParent = fs.realpathSync(existingParent);
+      if (!isWithin(projectRoot, realExistingParent)) {
+        return { ok: false, status: 403, error: "Path must stay inside the project" };
+      }
+      if (osUserInfo && typeof fsAsUser === "function") {
+        fsAsUser("mkdir", { dir: parentDir }, osUserInfo);
+      } else {
+        fs.mkdirSync(parentDir, { recursive: true });
+      }
+      var realParent = fs.realpathSync(parentDir);
+      if (!isWithin(projectRoot, realParent)) {
+        return { ok: false, status: 403, error: "Path must stay inside the project" };
+      }
+      if (fs.existsSync(targetAbs)) {
+        if (fs.lstatSync(targetAbs).isSymbolicLink()) {
+          return { ok: false, status: 403, error: "Symbolic link targets cannot be replaced" };
+        }
+        if (!overwrite) {
+          return { ok: false, status: 409, error: "A file already exists at this path" };
+        }
+      }
+
+      if (osUserInfo && typeof fsAsUser === "function") {
+        fsAsUser("copy", { source: sourceReal, file: targetAbs, overwrite: !!overwrite }, osUserInfo);
+      } else {
+        fs.copyFileSync(sourceReal, targetAbs, overwrite ? 0 : fs.constants.COPYFILE_EXCL);
+      }
+      try { fs.chmodSync(targetAbs, 0o644); } catch (e2) {}
+      return { ok: true, path: path.relative(projectRoot, targetAbs).split(path.sep).join("/") };
+    } catch (e) {
+      if (e && e.code === "EEXIST") {
+        return { ok: false, status: 409, error: "A file already exists at this path" };
+      }
+      return { ok: false, status: 500, error: "Could not save the generated image" };
+    }
+  }
 
   // Convert imageRefs in history entries to images with URLs for the client
   function hydrateImageRefs(entry) {
@@ -89,6 +174,7 @@ function attachImage(ctx) {
     imagesDir: imagesDir,
     hydrateImageRefs: hydrateImageRefs,
     saveImageFile: saveImageFile,
+    saveGeneratedImageToProject: saveGeneratedImageToProject,
   };
 }
 

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-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.js

@@ -187,7 +187,7 @@ function createProjectContext(opts) {
   // Do NOT write to .claude-local/settings.json -- the SDK reads that too, causing duplicate spawns.
 
   // --- Image engine (delegated to project-image.js) ---
-  var _image = attachImage({ cwd: cwd, slug: slug });
+  var _image = attachImage({ cwd: cwd, slug: slug, fsAsUser: fsAsUser });
   var imagesDir = _image.imagesDir;
   var hydrateImageRefs = _image.hydrateImageRefs;
   var saveImageFile = _image.saveImageFile;
@@ -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 || "",
       });
     }
@@ -1632,6 +1633,7 @@ function createProjectContext(opts) {
     gitAttribution: _gitAttribution,
     send: send,
     imagesDir: imagesDir,
+    saveGeneratedImageToProject: _image.saveGeneratedImageToProject,
     osUsers: osUsers,
     pushModule: pushModule,
     safePath: safePath,
@@ -1826,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);
+}