clay-server 5.2.1-beta.2 → 5.3.0-beta.1

package/lib/split-view-layout.js

@@ -0,0 +1,132 @@
+var MAX_SESSIONS = 8;
+var MIN_RATIO = 0.05;
+var MAX_RATIO = 0.95;
+var PRESETS = ["balanced", "columns", "rows", "grid", "main-left", "main-right"];
+
+function validOrigin(value) {
+  return typeof value === "string" && value.length > 0 && value.length <= 128 && /^[A-Za-z0-9_-]+$/.test(value);
+}
+
+function validateTree(tree, expectedOrigins) {
+  var origins = [];
+  var invalid = null;
+  function walk(node, depth) {
+    if (invalid) return;
+    if (!node || typeof node !== "object" || depth > MAX_SESSIONS) { invalid = "Layout tree is malformed"; return; }
+    if (Object.prototype.hasOwnProperty.call(node, "id")) {
+      if (Object.keys(node).length !== 1 || !validOrigin(node.id) || origins.indexOf(node.id) !== -1) {
+        invalid = "Layout leaves must have unique valid session origins"; return;
+      }
+      origins.push(node.id);
+      if (origins.length > MAX_SESSIONS) invalid = "A Split view can contain at most eight sessions";
+      return;
+    }
+    if (Object.keys(node).sort().join(",") !== "axis,left,ratio,right" ||
+        ["horizontal", "vertical"].indexOf(node.axis) === -1 || typeof node.ratio !== "number" ||
+        !Number.isFinite(node.ratio) || node.ratio < MIN_RATIO || node.ratio > MAX_RATIO) {
+      invalid = "Layout branch must have a valid axis and bounded ratio"; return;
+    }
+    walk(node.left, depth + 1); walk(node.right, depth + 1);
+  }
+  walk(tree, 0);
+  if (invalid) return { ok: false, error: invalid, origins: origins };
+  if (origins.length < 2 || origins.length > MAX_SESSIONS) return { ok: false, error: "A Split view requires two to eight sessions", origins: origins };
+  if (expectedOrigins) {
+    if (!Array.isArray(expectedOrigins) || expectedOrigins.length !== origins.length ||
+        expectedOrigins.some(function (id) { return !validOrigin(id) || origins.indexOf(id) === -1; })) {
+      return { ok: false, error: "Layout leaves must exactly match the selected sessions", origins: origins };
+    }
+  }
+  return { ok: true, origins: origins };
+}
+
+function validateName(name) {
+  if (typeof name !== "string") return { ok: false, error: "Split view name is required" };
+  var normalized = name.trim();
+  if (!normalized || normalized.length > 80) return { ok: false, error: "Split view name must be between 1 and 80 characters" };
+  return { ok: true, name: normalized };
+}
+
+function validatePreset(name) {
+  return PRESETS.indexOf(name) !== -1;
+}
+
+function removeLeaf(tree, originId) {
+  if (!tree || typeof tree !== "object") return tree;
+  if (Object.prototype.hasOwnProperty.call(tree, "id")) return tree.id === originId ? null : tree;
+  var left = removeLeaf(tree.left, originId), right = removeLeaf(tree.right, originId);
+  if (!left) return right;
+  if (!right) return left;
+  if (left === tree.left && right === tree.right) return tree;
+  return { axis: tree.axis, ratio: tree.ratio, left: left, right: right };
+}
+
+function leaf(id) { return { id: id }; }
+function chain(ids, axis) {
+  if (ids.length === 1) return leaf(ids[0]);
+  return { axis: axis, ratio: 1 / ids.length, left: leaf(ids[0]), right: chain(ids.slice(1), axis) };
+}
+function grid(ids) {
+  if (ids.length <= 2) return chain(ids, "horizontal");
+  var split = Math.ceil(ids.length / 2);
+  return { axis: "vertical", ratio: split / ids.length,
+    left: chain(ids.slice(0, split), "horizontal"), right: chain(ids.slice(split), "horizontal") };
+}
+function createPreset(origins, name) {
+  if (!Array.isArray(origins) || origins.length > MAX_SESSIONS ||
+      origins.some(function (id) { return !validOrigin(id); }) || new Set(origins).size !== origins.length) {
+    throw new TypeError("Preset input must contain zero to eight unique session origins");
+  }
+  if (!validatePreset(name)) throw new TypeError("Unknown Split view preset");
+  if (!origins.length) return null;
+  if (origins.length === 1) return leaf(origins[0]);
+  if (name === "columns") return chain(origins, "horizontal");
+  if (name === "rows") return chain(origins, "vertical");
+  if (name === "grid") return grid(origins);
+  if (name === "main-left" || name === "main-right") {
+    var main = leaf(origins[0]), rest = grid(origins.slice(1)), mainShare = origins.length === 2 ? 0.5 : 2 / 3;
+    return name === "main-left" ? { axis: "horizontal", ratio: mainShare, left: main, right: rest } : { axis: "horizontal", ratio: 1 - mainShare, left: rest, right: main };
+  }
+  if (origins.length <= 3) {
+    return { axis: "horizontal", ratio: 0.55, left: leaf(origins[0]), right: chain(origins.slice(1), "vertical") };
+  }
+  return grid(origins);
+}
+
+function validateViewShape(view) {
+  if (!view || typeof view !== "object" || typeof view.id !== "string" || !/^[A-Za-z0-9_-]{1,128}$/.test(view.id)) return { ok: false, error: "Split view identity is invalid" };
+  if (view.folderId != null && (typeof view.folderId !== 'string' || !/^[A-Za-z0-9_-]{1,128}$/.test(view.folderId))) return { ok: false, error: 'Invalid Split view folder' };
+  if (view.favorite !== undefined && typeof view.favorite !== 'boolean') return { ok: false, error: 'Invalid Split view favorite' };
+  var name = validateName(view.name);
+  if (!name.ok) return name;
+  if (view.nameMode != null && ["automatic", "custom"].indexOf(view.nameMode) === -1) return { ok: false, error: "Split view name mode is invalid" };
+  if (!Number.isInteger(view.revision) || view.revision < 1 || !validatePreset(view.layout)) return { ok: false, error: "Split view revision or layout is invalid" };
+  var refs = view.sessionRefs;
+  if (!Array.isArray(refs) || refs.length < 2 || refs.length > MAX_SESSIONS) return { ok: false, error: "A Split view requires two to eight sessions" };
+  var ids = [];
+  for (var i = 0; i < refs.length; i++) {
+    var ref = refs[i];
+    if (!ref || !validOrigin(ref.originId) || ids.indexOf(ref.originId) !== -1 ||
+        !(ref.ownerId === null || typeof ref.ownerId === "string") ||
+        !(ref.linuxUser === null || typeof ref.linuxUser === "string")) return { ok: false, error: "Split view session references are invalid" };
+    ids.push(ref.originId);
+  }
+  var tree = validateTree(view.tree, ids);
+  if (!tree.ok) return tree;
+  if (typeof view.activeSessionOriginId !== "string" || ids.indexOf(view.activeSessionOriginId) === -1) return { ok: false, error: "Active session must belong to the Split view" };
+  return { ok: true, name: name.name, origins: ids };
+}
+
+module.exports = {
+  MAX_SESSIONS: MAX_SESSIONS,
+  MIN_RATIO: MIN_RATIO,
+  MAX_RATIO: MAX_RATIO,
+  PRESETS: PRESETS.slice(),
+  validOrigin: validOrigin,
+  validateTree: validateTree,
+  validateName: validateName,
+  validatePreset: validatePreset,
+  removeLeaf: removeLeaf,
+  createPreset: createPreset,
+  validateViewShape: validateViewShape,
+};

package/lib/users-workbench-layout-preferences.js

@@ -0,0 +1,33 @@
+// Account UI preferences are excluded from canonical Clay controls.
+function validMode(mode) { return mode === 'overlay' || mode === 'docked'; }
+function attachWorkbenchLayoutPreferences(deps) {
+  var config = deps.configModule || require('./config');
+  function context(accountId) {
+    var data = deps.loadUsers();
+    var user = data.users.find(function (entry) { return entry.id === accountId; });
+    if (deps.isMultiUser() ? !user : accountId !== 'default') throw new Error('Account unavailable.');
+    var settings = deps.isMultiUser() ? null : config.loadConfig() || {};
+    return { data: data, user: user, settings: settings, saved: settings ? settings.workbenchLayoutPreference : user.workbenchLayoutPreference };
+  }
+  function value(accountId, saved) {
+    if (saved === undefined) return { accountId: accountId, mode: 'overlay', revision: 0 };
+    if (!saved || !validMode(saved.mode) || !Number.isSafeInteger(saved.revision) || saved.revision < 1) throw new Error('Invalid stored preference.');
+    return { accountId: accountId, mode: saved.mode, revision: saved.revision };
+  }
+  function get(accountId) { return value(accountId, context(accountId).saved); }
+  function set(accountId, mode, revision) {
+    if (!validMode(mode) || !Number.isSafeInteger(revision) || revision < 0) return { status: 400, error: 'Invalid workbench layout.' };
+    var current = context(accountId), prior = value(accountId, current.saved);
+    if (prior.revision !== revision) return { status: 409, error: 'Workbench layout changed elsewhere. Reload the preference and try again.' };
+    if (prior.mode === mode) return prior;
+    if (revision === Number.MAX_SAFE_INTEGER) throw new Error('Preference revision exhausted.');
+    var saved = { mode: mode, revision: revision + 1 };
+    if (current.settings) config.saveConfig(Object.assign({}, current.settings, { workbenchLayoutPreference: saved }));
+    else deps.saveUsers(Object.assign({}, current.data, { users: current.data.users.map(function (entry) {
+      return entry === current.user ? Object.assign({}, entry, { workbenchLayoutPreference: saved }) : entry;
+    }) }));
+    return value(accountId, saved);
+  }
+  return { get: get, set: set };
+}
+module.exports = { attachWorkbenchLayoutPreferences: attachWorkbenchLayoutPreferences };

package/lib/users.js

@@ -333,6 +333,7 @@ var createUser = creation.createUser;
 var createUserWithoutPin = creation.createUserWithoutPin;
 var permissions = attachPermissions({ loadUsers: loadUsers, saveUsers: saveUsers, findUserById: findUserById });
 var contextualClayPreferences = require("./users-contextual-clay-preferences").attachContextualClayPreferences({ loadUsers: loadUsers, saveUsers: saveUsers });
+var workbenchLayoutPreferences = require('./users-workbench-layout-preferences').attachWorkbenchLayoutPreferences({ loadUsers: loadUsers, saveUsers: saveUsers, isMultiUser: auth.isMultiUser });
 var preferences = attachPreferences({ loadUsers: loadUsers, saveUsers: saveUsers });
 var projectMateFilterPreferences = attachProjectMateFilterPreferences({ loadUsers: loadUsers, saveUsers: saveUsers });
 var homeDockPreferences = attachHomeDockPreferences({ loadUsers: loadUsers, saveUsers: saveUsers });
@@ -479,6 +480,8 @@ module.exports = {
   setToolPalette: setToolPalette,
   getTerminalFont: getTerminalFont,
   setTerminalFont: setTerminalFont,
+  getWorkbenchLayoutPreference: workbenchLayoutPreferences.get,
+  setWorkbenchLayoutPreference: workbenchLayoutPreferences.set,
   getContextualClayGeometry: contextualClayPreferences.getContextualClayGeometry,
   setContextualClayGeometry: contextualClayPreferences.setContextualClayGeometry,
   getHomeDockPreference: getHomeDockPreference,

package/lib/workspace-query-service.js

@@ -100,11 +100,7 @@ var projection = createProjection({
   sessionRef: sessionRef,
 });
 
-function sessionActivity(session) {
-  if (session.isProcessing) return "processing";
-  if (session.pendingPermissions && Object.keys(session.pendingPermissions).length > 0) return "waiting_for_approval";
-  return "idle";
-}
+var sessionActivity = require('./session-activity-state').sessionActivity;
 
 function attachWorkspaceQueryService(ctx) {
   var getProjects = ctx.getProjects;

package/lib/ws-schema.js

@@ -59,6 +59,17 @@ var schema = {
   "split_group_rename":       { direction: "c2s", handler: "lib/session-split-groups.js", description: "Rename a split group" },
   "split_group_dissolve":     { direction: "c2s", handler: "lib/session-split-groups.js", description: "Separate a split group without deleting its sessions" },
   "split_group_set_pair":     { direction: "c2s", handler: "lib/session-split-groups.js", description: "Assign Driver/Worker roles on a split group (driverId null clears them)" },
+  "project_split_views_request": { direction: "c2s", handler: "lib/project-split-views.js", description: "Request the current owner's persisted presentation Split views for this project" },
+  "project_split_view_create": { direction: "c2s", handler: "lib/project-split-views.js", description: "Create a revision-checked presentation Split view from exact project session origins" },
+  "project_split_view_update": { direction: "c2s", handler: "lib/project-split-views.js", description: "Update exact Split view membership, layout tree and active session at the current owner revision" },
+  "project_split_view_rename": { direction: "c2s", handler: "lib/project-split-views.js", description: "Rename an exact presentation Split view at the current owner revision" },
+  "project_split_view_separate": { direction: "c2s", handler: "lib/project-split-views.js", description: "Remove a presentation Split view without changing its sessions or Driver/Worker pairing" },
+  "project_split_view_organize": { direction: "c2s", handler: "lib/project-split-views.js", description: "Organize an exact saved Split view in a live personal folder and Favorites at current revisions" },
+  "project_split_view_move": { direction: "c2s", handler: "lib/project-split-views.js", description: "Atomically move one exact session between presentation Split views or into a standalone target" },
+  "split_worker_conversation_request": { direction: "c2s", handler: "lib/project-worker-conversation.js", description: "Read a bounded transcript page for one exact owned Split Worker generation without switching sessions" },
+  "split_worker_conversation": { direction: "s2c", handler: "lib/public/modules/split-view-workers.js", description: "Read-only transcript page correlated to its exact Driver, Worker, and generation" },
+  "split_worker_remove": { direction: "c2s", handler: "lib/project-worker-removal.js", description: "Remove one exact owned Worker session, with a single-use human Stop confirmation when active" },
+  "split_worker_remove_result": { direction: "s2c", handler: "lib/public/modules/split-view-worker-removal.js", description: "Correlated observed removal or confirmation/failure for an exact Worker generation" },
   "split_worker_close":       { direction: "c2s", handler: "lib/project-pair-worker-close.js", description: "Close one exact authenticated Worker generation while preserving its peer and session history" },
   "split_worker_close_result": { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Correlated result of an exact targeted Worker close" },
   "pair_session_options":     { direction: "c2s", handler: "lib/project-session-pair.js", description: "Request vendors/models for the pair-session dialog (response reuses the same type)" },
@@ -121,6 +132,8 @@ var schema = {
   "tui_transcript_state":     { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Assistant text index for a Claude TUI session (full replace; sent on request and after each new assistant message)" },
   "split_groups":             { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Full persistent split-group list for the current user" },
   "split_group_result":       { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Result of a split-group mutation" },
+  "project_split_views": { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Owner-scoped persisted presentation Split views for the current project" },
+  "project_split_view_result": { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Correlated presentation Split view mutation result" },
   "pair_session_created":     { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Result of pair_session_create; carries the new group" },
   "worker_proposal":          { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Recorded Split Worker creation/replacement runtime card with Driver rationale" },
   "worker_proposal_update":   { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Worker card lifecycle and manual/auto decision audit update" },
@@ -820,6 +833,8 @@ var schema = {
   "default_vendor_get":       { direction: "c2s", handler: "lib/server-default-vendor.js", description: "Read the authenticated user's New session vendor preference" },
   "default_vendor_set":       { direction: "c2s", handler: "lib/server-default-vendor.js", description: "Validate and persist the authenticated user's New session vendor preference" },
   "default_vendor_state":     { direction: "s2c", handler: "lib/public/modules/default-vendor.js", description: "Correlated or same-user-broadcast New session vendor preference" },
+  "clay_view_probe": { direction: "s2c", handler: "lib/public/modules/clay-split-view-screen.js", description: "Observe the exact owner window across stable frames" },
+  "clay_view_observed": { direction: "c2s", handler: "lib/server-owner-ui.js", description: "Bounded correlated view observation, not approval" },
   "clay_ui_ready":            { direction: "c2s", handler: "lib/server-owner-ui.js", description: "Advertise exact owner UI navigation support on this socket" },
   "clay_navigation_offer":    { direction: "s2c", handler: "lib/public/modules/clay-owner-navigation.js", description: "Offer one exact reviewed navigation to a selected owner connection" },
   "clay_navigation_claim":    { direction: "c2s", handler: "lib/server-owner-ui.js", description: "Claim an offered navigation with live source/target revalidation" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clay-server",
-  "version": "5.2.1-beta.2",
+  "version": "5.3.0-beta.1",
   "description": "Self-hosted team workspace for Claude Code and Codex. Multi-user, browser-based, with persistent AI mates.",
   "bin": {
     "clay-server": "./bin/cli.js"
@@ -9,7 +9,9 @@
     "dev": "node bin/cli.js --dev",
     "test": "node --test --test-force-exit --test-skip-pattern=\"^real sidebar (normal|long-turn):\" test/*.test.js",
     "semantic-release": "semantic-release",
-    "test:pane-performance": "node --test --test-force-exit test/pane-reuse-browser.test.js"
+    "test:pane-performance": "node --test --test-force-exit test/pane-reuse-browser.test.js",
+    "build:pane-assets": "node scripts/build-pane-assets.js",
+    "prepack": "npm run build:pane-assets"
   },
   "files": [
     "bin/",
@@ -86,6 +88,7 @@
   "devDependencies": {
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
-    "semantic-release": "^25.0.3"
+    "semantic-release": "^25.0.3",
+    "esbuild": "0.28.2"
   }
 }