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

package/lib/project-worker-conversation.js

@@ -0,0 +1,158 @@
+// Exact, read-only Split Worker transcript snapshots for an owning Driver.
+// This does not switch sessions or expose Worker controls.
+var provenance = require("./session-provenance");
+
+function attachProjectWorkerConversation(ctx) {
+  var sm = ctx.sm;
+  var users = ctx.usersModule;
+  var MAX_MESSAGES = 120;
+  var MAX_TEXT = 8000;
+  var MAX_PAGE_TEXT = 64000;
+
+  function send(ws, value) { ctx.sendTo(ws, value); }
+  function sessionForOrigin(origin) {
+    var found = null;
+    var ambiguous = false;
+    sm.sessions.forEach(function (session) {
+      if (session.sessionOriginId !== origin) return;
+      if (found && found !== session) ambiguous = true;
+      else if (!found) found = session;
+    });
+    return ambiguous ? null : found;
+  }
+  function actor(ws) {
+    if (!ws || !ctx.clients || !ctx.clients.has(ws) || ws._clayPaneActivation || ctx.isMate || !ctx.canAccessProject(ws)) return null;
+    var user = ws._clayUser && users.findUserById(ws._clayUser.id);
+    if (users.isMultiUser() && !user) return null;
+    if (ctx.osUsers && (!user || !user.linuxUser || !ctx.getOsUserInfoForWs({ _clayUser: user }))) return null;
+    return { id: user && user.id || null, linuxUser: ctx.osUsers && user ? user.linuxUser : null };
+  }
+  function exactPair(ws, msg, currentActor) {
+    if (!msg || typeof msg.parentSessionOriginId !== "string" || typeof msg.workerSessionOriginId !== "string" ||
+        !Number.isInteger(msg.generation) || msg.generation < 1) return null;
+    var driver = sessionForOrigin(msg.parentSessionOriginId), worker = sessionForOrigin(msg.workerSessionOriginId);
+    if (!driver || !worker || driver === worker || sm.sessions.get(driver.localId) !== driver || sm.sessions.get(worker.localId) !== worker) return null;
+    if (!ctx.canAccessSession(ws, driver) || !ctx.canAccessSession(ws, worker)) return null;
+    if ((driver.ownerId || null) !== (worker.ownerId || null) || currentActor.id !== (worker.ownerId || null)) return null;
+    var record = worker.sessionProvenance;
+    if (!record || record.kind !== "worker" || record.parentSessionOriginId !== driver.sessionOriginId || record.generation !== msg.generation) return null;
+    if (provenance.isWorker(driver) || !driver.sessionOriginId || !worker.sessionOriginId) return null;
+    if (ctx.osUsers) {
+      var driverLinux = ctx.getLinuxUserForSession(driver), workerLinux = ctx.getLinuxUserForSession(worker);
+      if (!driverLinux || driverLinux !== workerLinux || driverLinux !== currentActor.linuxUser) return null;
+    }
+    return { driver: driver, worker: worker };
+  }
+  // Share the exact owner/OS/provenance checks used by the human Worker reader.
+  function supervision(ws, driverOrigin) {
+    var user = actor(ws), driver = sessionForOrigin(driverOrigin);
+    if (!user || !driver || provenance.isWorker(driver) || (driver.ownerId || null) !== user.id || !ctx.canAccessSession(ws, driver)) throw new Error('Driver supervision access changed.');
+    if (ctx.osUsers && ctx.getLinuxUserForSession(driver) !== user.linuxUser) throw new Error('Driver OS identity changed.');
+    var linked = provenance.ownedWorkersByDriver(Array.from(sm.sessions.values()))[driver.localId] || [];
+    var group = ctx.getWorkerGroup && ctx.getWorkerGroup(driver.localId);
+    var splitRoles = require('./session-split-group-roles');
+    var roles = splitRoles.normalizePair(group && group.pair, group && group.members);
+    if (group && !roles.ok) throw new Error('Worker configuration is unavailable.');
+    var groupIdentity = JSON.stringify(group && [group.id, group.members, group.pair]);
+    var configured = roles.ok && roles.driverId === driver.localId ? roles.workerIds : [];
+    var bindings = linked.slice().sort(function (a, b) { return Number(configured.indexOf(b.localId) >= 0) - Number(configured.indexOf(a.localId) >= 0); }).slice(0, 100).map(function (worker) {
+      var input = { parentSessionOriginId: driverOrigin, workerSessionOriginId: worker.sessionOriginId, generation: worker.sessionProvenance.generation };
+      var pair = exactPair(ws, input, user);
+      if (!pair || pair.driver !== driver || pair.worker !== worker || worker.destroying || worker._pairGeneration != null && worker._pairGeneration !== input.generation) throw new Error('Exact Worker supervision identity is unavailable.');
+      return { input: input, worker: worker };
+    });
+    function revalidate() {
+      var latest = actor(ws);
+      if (!latest || latest.id !== user.id || latest.linuxUser !== user.linuxUser || sessionForOrigin(driverOrigin) !== driver) throw new Error('Driver supervision identity changed.');
+      if (!ctx.canAccessSession(ws, driver) || ctx.osUsers && ctx.getLinuxUserForSession(driver) !== user.linuxUser) throw new Error('Driver access or OS identity changed.');
+      var nextGroup = ctx.getWorkerGroup && ctx.getWorkerGroup(driver.localId);
+      if (JSON.stringify(nextGroup && [nextGroup.id, nextGroup.members, nextGroup.pair]) !== groupIdentity) throw new Error('Worker configuration changed.');
+      var nextLinked = provenance.ownedWorkersByDriver(Array.from(sm.sessions.values()))[driver.localId] || [];
+      if (linked.length !== nextLinked.length || linked.some(function (worker, i) { return worker !== nextLinked[i]; })) throw new Error('Linked Worker membership changed.');
+      bindings.forEach(function (binding) {
+        var pair = exactPair(ws, binding.input, latest);
+        if (!pair || pair.driver !== driver || pair.worker !== binding.worker || pair.worker.destroying || pair.worker._pairGeneration != null && pair.worker._pairGeneration !== binding.input.generation) throw new Error('Exact Worker generation changed.');
+      });
+    }
+    return { revalidate: revalidate, read: function () {
+      revalidate();
+      return { observedAt: Date.now(), limit: 100, truncated: linked.length > bindings.length, workers: bindings.map(function (binding) {
+        var worker = binding.worker;
+        if (worker._pairDelegation && !splitRoles.tokenMatchesWorker(worker, worker._pairDelegation)) throw new Error('Delegated Worker generation changed.');
+        var activity = require('./project-pair-lifecycle-status').activityStatus(worker);
+        return { id: worker.localId, sessionOriginId: worker.sessionOriginId, parentSessionOriginId: driverOrigin, generation: binding.input.generation,
+          association: configured.indexOf(worker.localId) >= 0 ? 'current' : 'archived',
+          runtime: require('./session-activity-state').currentState(worker), delegated: activity.delegated,
+          currentTaskId: activity.currentTaskId, interrupted: !!activity.interruption, lastTurnInterrupted: activity.lastTurnInterrupted };
+      }) };
+    } };
+  }
+  function textContent(value) {
+    if (typeof value === "string") return value;
+    if (!Array.isArray(value)) return "";
+    return value.map(function (part) { return part && typeof part.text === "string" ? part.text : ""; }).join("\n");
+  }
+  function toolIdentity(entry) {
+    var id = entry.id || entry.tool_use_id || entry.toolId;
+    var name = entry.toolName || entry.name;
+    return { toolId: typeof id === "string" && id.length <= 160 ? id : null,
+      toolName: typeof name === "string" ? name.slice(0, 120) : null };
+  }
+  function record(history, index) {
+    var entry = history[index] || {}, type = entry.type;
+    if (type === "user_message") return { role: "user", text: textContent(entry.text || entry.content) };
+    if (type === "delta" || type === "result" || type === "assistant_message") return { role: "assistant", text: textContent(entry.text || entry.content) };
+    if (type === "tool_start" || type === "tool_use") return Object.assign({ role: "tool", text: "Used " + (toolIdentity(entry).toolName || "tool") }, toolIdentity(entry));
+    if (type === "tool_result") return Object.assign({ role: "tool", text: textContent(entry.content) || "No recorded tool output.", isError: entry.is_error === true }, toolIdentity(entry));
+    return null;
+  }
+  function snapshot(history, before) {
+    var index, offset;
+    if (before && typeof before === "object" && Number.isInteger(before.index) && Number.isInteger(before.offset)) {
+      index = Math.min(before.index, history.length - 1); offset = Math.max(0, before.offset);
+    } else {
+      var end = Number.isInteger(before) && before >= 0 ? Math.min(before, history.length) : history.length;
+      index = end - 1;
+      var latest = index >= 0 ? record(history, index) : null;
+      offset = latest ? latest.text.length : 0;
+    }
+    var rows = [], budget = MAX_PAGE_TEXT, nextBefore = null;
+    while (index >= 0 && rows.length < MAX_MESSAGES && budget > 0) {
+      var item = record(history, index);
+      if (!item) { index -= 1; offset = index >= 0 && record(history, index) ? record(history, index).text.length : 0; continue; }
+      offset = Math.min(offset, item.text.length);
+      if (!item.text.length || !offset) { index -= 1; offset = index >= 0 && record(history, index) ? record(history, index).text.length : 0; continue; }
+      var metadataSize = (item.toolName || "").length + (item.toolId || "").length;
+      if (budget <= metadataSize) { nextBefore = { index: index, offset: offset }; break; }
+      var start = Math.max(0, offset - Math.min(MAX_TEXT, budget - metadataSize));
+      rows.push({ role: item.role, text: item.text.slice(start, offset), recordIndex: index, recordType: history[index].type,
+        start: start, end: offset, toolName: item.toolName || null, toolId: item.toolId || null, isError: item.isError === true });
+      budget -= offset - start + metadataSize;
+      if (start > 0) { nextBefore = { index: index, offset: start }; break; }
+      index -= 1;
+      if (index >= 0) { var prior = record(history, index); offset = prior ? prior.text.length : 0; }
+    }
+    rows.reverse();
+    if (!nextBefore && index >= 0) nextBefore = { index: index, offset: offset };
+    return { messages: rows, nextBefore: nextBefore, hasMore: nextBefore !== null };
+  }
+  function handleMessage(ws, msg) {
+    if (!msg || msg.type !== "split_worker_conversation_request") return false;
+    var requestId = typeof msg.requestId === "string" ? msg.requestId.slice(0, 160) : "";
+    var response = { type: "split_worker_conversation", requestId: requestId, pageBefore: msg.before == null ? null : msg.before,
+      parentSessionOriginId: msg.parentSessionOriginId || null, workerSessionOriginId: msg.workerSessionOriginId || null,
+      generation: msg.generation || null, messages: [], hasMore: false, nextBefore: null };
+    var current = actor(ws), pair = current && exactPair(ws, msg, current);
+    if (!requestId || !pair) response.error = "This Worker conversation is no longer available.";
+    else {
+      var before = msg.before == null ? pair.worker.history.length : msg.before;
+      if (!(Number.isInteger(before) && before >= 0) && !(before && typeof before === "object" && Number.isInteger(before.index) && Number.isInteger(before.offset) && before.index >= 0 && before.offset >= 0)) response.error = "Worker conversation page is invalid.";
+      else Object.assign(response, snapshot(pair.worker.history || [], before));
+    }
+    send(ws, response);
+    return true;
+  }
+  return { handleMessage: handleMessage, supervision: supervision };
+}
+
+module.exports = { attachProjectWorkerConversation: attachProjectWorkerConversation };

package/lib/project-worker-creation-proposal.js

@@ -50,9 +50,8 @@ function attachWorkerCreationProposal(ctx) {
     if (!roles || roles.driver !== session || roles.role.kind === "adhoc") {
       return { error: "The exact Driver/Split Worker membership is not eligible for another Worker." };
     }
-    if (roles.workers.length >= 2) return { error: "A Driver can have at most two Split Workers." };
-    if (roles.workers.length !== 1) return { error: "The existing Split Worker membership is invalid." };
-    if (!session.sessionOriginId || !roles.workers[0].sessionOriginId || !Number.isInteger(generationOf(roles.workers[0]))) {
+    if (roles.workers.length < 1) return { error: "The existing Split Worker membership is invalid." };
+    if (!session.sessionOriginId || roles.workers.some(function (worker) { return !worker.sessionOriginId || !Number.isInteger(generationOf(worker)); })) {
       return { error: "The exact Driver and Split Worker identities are not durable enough to add another Worker." };
     }
     return {
@@ -79,7 +78,7 @@ function attachWorkerCreationProposal(ctx) {
     var group = store.groupForMember(session.localId);
     if (!group || group.id !== snapshot.groupId || requireSameObject && group !== snapshot.group) return { ok: false };
     var roles = splitRoles.resolveLiveRoles(sm, group);
-    if (!roles || roles.role.kind === "adhoc" || roles.driver !== session || roles.role.workerIds.length !== 1 ||
+    if (!roles || roles.role.kind === "adhoc" || roles.driver !== session || roles.role.workerIds.length < 1 ||
         roles.role.workerIds.join(",") !== snapshot.workerIds.join(",")) return { ok: false };
     for (var i = 0; i < snapshot.workers.length; i++) {
       var expected = snapshot.workers[i];

package/lib/project-worker-proposal.js

@@ -463,7 +463,7 @@ function attachWorkerProposal(ctx) {
 
   function getSystemPrompt(session) {
     if (creationProposal.canMountProposal(session) && !isEligible(session)) {
-      return "This Driver may configure one additional Split Worker through propose_worker. With two Workers, pass workerId to every targeted partner, queue, interrupt, replacement, close, permission, and targeted status operation. Call partner_status without workerId to discover current Worker handles. Give each Worker independent file ownership and bounded work. Do not assign simultaneous overlapping file edits unless the work is explicitly separated, such as by distinct paths or worktrees.";
+      return "This Driver may configure additional Split Workers through propose_worker. With multiple Workers, pass workerId to every targeted partner, queue, interrupt, replacement, close, permission, and targeted status operation. Call partner_status without workerId to discover current Worker handles. Give each Worker independent file ownership and bounded work. Do not assign simultaneous overlapping file edits unless the work is explicitly separated, such as by distinct paths or worktrees.";
     }
     if (!isEligible(session) || !driverOrchestration.isHighTierDriverSession(session, sm)) return "";
     return "For implementation-heavy work, use propose_worker before substantial execution. Work is implementation-heavy when it spans multiple modules, crosses client/server/data boundaries, requires a migration, or contains independent investigation and execution. Do not skip delegation merely because you can implement it yourself; preserve the Driver for decomposition, runtime selection, judgment, review, and integration. The user's explicit request to work directly takes precedence, and work that must remain sequential in this session stays here. Recommend an exact available vendor, model, and effort, and give a concise recommendationRationale explaining why all three fit the task. Clay always records and shows the runtime configuration card. In full-access mode Clay may auto-accept that exact validated recommendation; otherwise it waits for the user's explicit choice. After posting, end the turn. If accepted, Clay creates the exact Driver/Split Worker pair and delegates the proposed task once. If declined, continue in this Driver session. Do not call send_to_partner while unpaired.";

package/lib/project-worker-removal.js

@@ -0,0 +1,101 @@
+var crypto = require('crypto');
+var provenance = require('./session-provenance');
+
+function active(worker) {
+  return !!(worker.isProcessing || worker._queryStarting || worker._responseRecoveryStopPending);
+}
+
+// Human socket endpoint only. Receipts expire after one minute and are never replayed.
+function attachWorkerRemoval(ctx) {
+  var receipts = new WeakMap();
+  function exact(ws, msg) {
+    if (ctx.isMate || !ctx.clients.has(ws) || ws.readyState !== 1 || ws._clayPaneActivation || msg.projectSlug !== ctx.slug) throw new Error('The project connection changed.');
+    var user = ws._clayUser && ctx.usersModule.findUserById(ws._clayUser.id);
+    if (ctx.usersModule.isMultiUser() && (!user || !ctx.usersModule.canAccessProject(user.id, ctx.getProjectAccess()))) throw new Error('Project access is unavailable.');
+    var owner = user && user.id || null;
+    if (msg.ownerId !== owner || !ctx.sessionDelete.hasDeletePermission(ws)) throw new Error('Worker removal is not permitted.');
+    var driver = ctx.sm.sessions.get(msg.driverId), worker = ctx.sm.sessions.get(msg.workerId);
+    if (!driver || !worker || driver === worker || driver.destroying || worker.destroying || driver.hidden || worker.hidden || provenance.isWorker(driver) ||
+        driver.sessionOriginId !== msg.driverOriginId || worker.sessionOriginId !== msg.workerOriginId ||
+        !msg.driverOriginId || !msg.workerOriginId || (driver.ownerId || null) !== owner || (worker.ownerId || null) !== owner) throw new Error('The exact Driver or Worker changed.');
+    var matches = 0;
+    ctx.sm.sessions.forEach(function (session) { if (session.sessionOriginId === msg.driverOriginId || session.sessionOriginId === msg.workerOriginId) matches++; });
+    var record = worker.sessionProvenance;
+    if (matches !== 2 || !record || record.kind !== 'worker' || record.parentSessionOriginId !== driver.sessionOriginId ||
+        !Number.isInteger(msg.generation) || msg.generation < 1 || record.generation !== msg.generation ||
+        worker._pairGeneration && worker._pairGeneration !== msg.generation) throw new Error('The Worker generation changed.');
+    if (ctx.osUsers) {
+      var linux = user && user.linuxUser;
+      if (!linux || !ctx.getOsUserInfoForWs(ws) || ctx.getLinuxUserForSession(driver) !== linux || ctx.getLinuxUserForSession(worker) !== linux) throw new Error('The OS identity changed.');
+    }
+    if (user && (!ctx.usersModule.getEffectivePermissions(user, ctx.osUsers).sessionDelete ||
+        !ctx.usersModule.canAccessSession(user.id, driver, ctx.getProjectAccess()))) throw new Error('Driver access or removal permission changed.');
+    var plan = ctx.sessionDelete.planDeletion(ws, [worker], ctx.getProjectAccess());
+    if (!plan.ok || plan.ids.length !== 1 || plan.ids[0] !== worker.localId) throw new Error(plan.error || 'The exact removal scope changed.');
+    return { driver: driver, worker: worker, plan: plan };
+  }
+  function respond(ws, msg, status, error, token) {
+    ctx.sendTo(ws, { type: 'split_worker_remove_result', requestId: msg.requestId, projectSlug: ctx.slug,
+      workerOriginId: msg.workerOriginId, generation: msg.generation, status: status, error: error || null, token: token || null });
+  }
+  async function perform(ws, msg, receipt) {
+    try {
+      var pair = exact(ws, msg), worker = pair.worker, driver = pair.driver;
+      if (receipt.driver && (receipt.driver !== driver || receipt.worker !== worker)) throw new Error('The reviewed sessions were replaced.');
+      if (receipt.confirmed && (receipt.query !== worker.queryInstance || receipt.delegation !== worker._pairDelegation ||
+          receipt.stopRevision !== worker._humanStopRevision || receipt.driverStopRevision !== driver._humanStopRevision)) throw new Error('The reviewed Worker execution changed.');
+      var sourceSession = ws._clayActiveSession;
+      if (receipt.sourceSession !== sourceSession) throw new Error('The source conversation changed.');
+      if (active(worker)) {
+        if (!receipt.confirmed) {
+          receipt.driver = driver; receipt.worker = worker; receipt.query = worker.queryInstance; receipt.delegation = worker._pairDelegation;
+          receipt.stopRevision = worker._humanStopRevision; receipt.driverStopRevision = driver._humanStopRevision;
+          receipt.token = crypto.randomUUID(); receipt.status = 'confirmation_required';
+          respond(ws, msg, receipt.status, null, receipt.token); return;
+        }
+        var runtime = worker.queryInstance, process = worker.worker;
+        ctx.actions.stop(worker, ws._clayUser || null);
+        var stopRevision = worker._humanStopRevision, driverRevision = driver._humanStopRevision;
+        var deadline = Date.now() + (ctx.stopTimeoutMs || 5000);
+        while (active(worker)) {
+          if (Date.now() >= deadline) throw new Error('Stop completion is unknown. The Worker session was retained.');
+          await new Promise(function (resolve) { setTimeout(resolve, 25); });
+          var current = exact(ws, msg);
+          if (receipt.cancelled || current.worker !== worker || current.driver !== driver || ws._clayActiveSession !== sourceSession ||
+              worker._humanStopRevision !== stopRevision || driver._humanStopRevision !== driverRevision ||
+              worker.queryInstance && worker.queryInstance !== runtime || worker.worker && worker.worker !== process) throw new Error('Removal interrupted by a changed execution or source. The session was retained.');
+        }
+      }
+      var finalPair = exact(ws, msg);
+      if (receipt.cancelled || finalPair.worker !== worker || finalPair.driver !== driver || ws._clayActiveSession !== sourceSession) throw new Error('Removal was cancelled or its target changed.');
+      ctx.sessionDelete.executeOwnedDeletion(finalPair.plan, { requireDurableRemoval: true });
+      if (ctx.sm.sessions.has(worker.localId)) throw new Error('Worker removal was not observed.');
+      receipt.status = 'removed'; respond(ws, msg, 'removed');
+    } catch (error) { receipt.status = 'failed'; respond(ws, msg, 'failed', error.message || String(error)); }
+  }
+  function handleMessage(ws, msg) {
+    if (!msg || msg.type !== 'split_worker_remove') return false;
+    if (typeof msg.requestId !== 'string' || !/^[a-zA-Z0-9_-]{1,100}$/.test(msg.requestId)) return true;
+    var records = receipts.get(ws);
+    if (!records) { records = new Map(); receipts.set(ws, records); }
+    records.forEach(function (value, key) { if (value.expires < Date.now() && value.status !== 'removing') records.delete(key); });
+    var receipt = records.get(msg.requestId);
+    var fingerprint = JSON.stringify([msg.projectSlug, msg.ownerId, msg.driverId, msg.driverOriginId, msg.workerId, msg.workerOriginId, msg.generation]);
+    if (msg.action === 'cancel') { if (receipt && receipt.fingerprint === fingerprint) receipt.cancelled = true; return true; }
+    if (receipt) {
+      if (receipt.status === 'removing' && receipt.fingerprint === fingerprint) return true;
+      if (msg.action !== 'confirm' || receipt.status !== 'confirmation_required' || receipt.expires < Date.now() || receipt.cancelled ||
+          receipt.fingerprint !== fingerprint || receipt.token !== msg.token) { respond(ws, msg, 'failed', 'This removal request is stale or already used.'); return true; }
+      receipt.confirmed = true;
+    } else {
+      if (msg.action !== 'request' || records.size >= 32) { respond(ws, msg, 'failed', 'Start a fresh removal request.'); return true; }
+      receipt = { fingerprint: fingerprint, sourceSession: ws._clayActiveSession, expires: Date.now() + 60000, confirmed: false };
+      records.set(msg.requestId, receipt);
+    }
+    receipt.status = 'removing';
+    receipt.promise = perform(ws, msg, receipt);
+    return true;
+  }
+  return { handleMessage: handleMessage, exact: exact };
+}
+module.exports = { attachWorkerRemoval: attachWorkerRemoval, active: active };

package/lib/project.js

@@ -71,6 +71,8 @@ var { attachProjectLogs } = require("./project-logs");
 var { attachProjectLogFeedbackDelivery } = require("./project-log-feedback-delivery");
 var { attachProjectMateKnowledge } = require("./project-mate-knowledge");
 var { attachSplitGroups } = require("./session-split-groups");
+var { attachProjectSplitViews } = require("./project-split-views");
+var { attachProjectWorkerConversation } = require("./project-worker-conversation");
 var multiWorkerFeature = require("./multi-worker-feature");
 var toolControlMcp = require("./tool-control-mcp-server");
 var capsuleFloor = require("./capsule-display-floor");
@@ -696,6 +698,24 @@ function createProjectContext(opts) {
       }
     },
   });
+  var _splitViews = attachProjectSplitViews({
+    sm: sm, slug: slug, clients: clients, sendTo: sendTo, usersModule: usersModule,
+    isMate: isMate, osUsers: osUsers,
+    canAccessProject: function (ws) { return _requestAccess.canAccessProject(ws, slug); },
+    canAccessSession: function (ws, session) { return _requestAccess.canReadSession(ws, session); },
+    getLinuxUserForSession: getLinuxUserForSession,
+    getOsUserInfoForWs: getOsUserInfoForWs,
+  });
+  var _workerConversation = attachProjectWorkerConversation({
+    getWorkerGroup: function (id) { return _splitGroups.store.groupForMember(id); },
+    sm: sm, slug: slug, clients: clients, sendTo: sendTo, usersModule: usersModule,
+    isMate: isMate,
+    canAccessProject: function (ws) { return _requestAccess.canAccessProject(ws, slug); },
+    canAccessSession: function (ws, session) { return _requestAccess.canReadSession(ws, session); },
+    osUsers: osUsers,
+    getLinuxUserForSession: getLinuxUserForSession,
+    getOsUserInfoForWs: getOsUserInfoForWs,
+  });
 
   var _projMode = typeof opts.onGetProjectDefaultMode === "function" ? opts.onGetProjectDefaultMode(slug) : null;
   var _srvMode = typeof opts.onGetServerDefaultMode === "function" ? opts.onGetServerDefaultMode() : null;
@@ -1859,7 +1879,7 @@ function createProjectContext(opts) {
     if (_studioPresentation.handleMessage(ws, msg)) return;
 
     // --- DM messages (delegated to server-level handler) ---
-    if (msg.type === "home_mate_question_response" || msg.type === "mate_context_prepare" || msg.type === "clay_ui_ready" || msg.type === "clay_navigation_claim" || msg.type === "clay_navigation_ack" || msg.type === "clay_navigation_rendered" || msg.type === "home_debate_question_response" || msg.type === "home_debate_control" || msg.type === "home_mate_creation_question_response" || msg.type === "default_ai_get" || msg.type === "default_ai_catalog_get" || msg.type === "default_ai_set" || msg.type === "default_vendor_get" || msg.type === "default_vendor_set" || msg.type === "context_view_get" || msg.type === "context_view_set" || msg.type === "cursor_sharing_get" || msg.type === "cursor_sharing_set") {
+    if (msg.type === "home_mate_question_response" || msg.type === "mate_context_prepare" || msg.type === "clay_ui_ready" || msg.type === "clay_view_observed" || msg.type === "clay_navigation_claim" || msg.type === "clay_navigation_ack" || msg.type === "clay_navigation_rendered" || msg.type === "home_debate_question_response" || msg.type === "home_debate_control" || msg.type === "home_mate_creation_question_response" || msg.type === "default_ai_get" || msg.type === "default_ai_catalog_get" || msg.type === "default_ai_set" || msg.type === "default_vendor_get" || msg.type === "default_vendor_set" || msg.type === "context_view_get" || msg.type === "context_view_set" || msg.type === "cursor_sharing_get" || msg.type === "cursor_sharing_set") {
       if (typeof opts.onDmMessage === "function") opts.onDmMessage(ws, msg, slug);
       return;
     }
@@ -1968,6 +1988,8 @@ function createProjectContext(opts) {
     if (_sessionHandoff.handleMessage(ws, msg)) return;
     if (_driverContinuation.handleMessage(ws, msg)) return;
     if (_splitGroups.handleMessage(ws, msg)) return;
+    if (_splitViews.handleMessage(ws, msg)) return;
+    if (_workerConversation.handleMessage(ws, msg)) return;
     if (_models.handleMessage(ws, msg)) return;
     if (_scheduledTasks.handleMessage(ws, msg)) return;
     if (_loopInterview.handleMessage(ws, msg)) return;
@@ -2155,6 +2177,7 @@ function createProjectContext(opts) {
   });
   sm.setSessionHydrator(_sessionSkillCatalog.hydrate);
   var _sessions = attachSessions({
+    onSessionFoldersChanged: function (accountId) { _splitViews.onFoldersChanged(accountId); },
     splitStore: _splitGroups.store,
     adapters: adapters,
     isPendingQueuePaused: function (session) { return _pendingMessageQueue.isPaused(session); },
@@ -2767,6 +2790,8 @@ function createProjectContext(opts) {
     _mcp: _mcp,
     _notifications: _notifications,
     _splitGroups: _splitGroups,
+    _splitViews: _splitViews,
+    _workerConversation: _workerConversation,
     _vendorLogin: _vendorLogin,
     autonomousRun: _autonomousRun,
     resolveSessionForView: _sessions.resolveSessionForView,
@@ -3031,6 +3056,8 @@ function createProjectContext(opts) {
     },
     cancelMateSchedule: function (session, record) { return _mateLifecycle.cancel(session, record); },
     getSessionManager: function () { return sm; },
+    getSplitViewControl: _splitViews.forConnection,
+    getViewWorkerSupervision: _workerConversation.supervision,
     createDelegatedSession: _delegatedSession.createDelegatedSession,
     refreshEnvironmentRuntime: function () { return sdk.refreshEnvironmentRuntime(); },
     getWorkspaceProductOperations: function () { return isMate ? null : _workspaceOperations; },

package/lib/public/app.js

@@ -1,3 +1,4 @@
+import { initializeAfterPaneReady } from './modules/pane-deferred-bootstrap.js';
 import { initStudioBridge } from './modules/clay-studio-bridge.js';
 import { initSharedBrowser } from './modules/shared-browser.js';
 import { initTopbarWorkbenchControls } from './modules/topbar-workbench-controls.js';
@@ -27,7 +28,7 @@ import {
 } from './modules/sidebar-mobile.js';
 import { initMateSidebar, showMateSidebar, hideMateSidebar, renderMateSessionList, updateMateSidebarProfile, handleMateSearchResults } from './modules/mate-sidebar.js';
 import { initMateKnowledge, requestKnowledgeList, renderKnowledgeList, handleKnowledgeContent, hideKnowledge } from './modules/mate-knowledge.js';
-import { initMateKnowledgeWorkbench } from './modules/mate-knowledge-workbench.js';
+import { initMateKnowledgeWorkbench } from './modules/knowledge-workbench-entry.js';
 import { initMateMemory, renderMemoryList, hideMemory } from './modules/mate-memory.js';
 import { initRewind, setRewindMode, showRewindModal, clearPendingRewindUuid, addRewindButton, onRewindComplete, onRewindError } from './modules/rewind.js';
 import { initNotifications, showDoneNotification, playDoneSound, isNotifAlertEnabled, isNotifSoundEnabled } from './modules/notifications.js';
@@ -114,6 +115,7 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
 // --- Base path for multi-project routing ---
   var bootParams = new URLSearchParams(location.search);
   var paneMode = bootParams.get("pane") === "1";
+  if (paneMode && typeof performance !== "undefined" && performance.mark) performance.mark("clay:app-evaluated");
   var paneSessionId = Number(bootParams.get("session"));
   if (!Number.isSafeInteger(paneSessionId) || paneSessionId < 1) paneSessionId = null;
   if (paneMode) document.body.classList.add("pane-mode");
@@ -307,6 +309,10 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     panePinPending: paneMode && !!paneSessionId,
     paneCommittedBinding: null, panePendingBinding: null, paneReady: false, paneSuspended: false,
     paneActivationGeneration: 0, paneActivationTimer: null, panePointerBinding: null, paneRichDrafts: {},
+    paneLayoutScrollLock: null,
+    paneLastUserScrollTop: null,
+    paneUserScrollIntent: null,
+    paneUserScrollRevision: 0,
     sessionRichDrafts: {},
     sessionActionEpoch: 0, composerUploadingCount: 0, deferredSessionSwitch: null,
     paneCallbackBinding: null, paneActionEvents: [], paneHeldKeys: {}, rewindAction: null, handoffAction: null,
@@ -317,6 +323,27 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     paneBindingSessions: [],
     splitPanes: null,
     splitGroups: [],
+    splitViewWorkerConversation: null,
+    splitViewWorkerRemoval: null,
+    projectSplitViews: [],
+    projectSplitViewRevision: 0,
+    projectSplitViewContextKey: null,
+    projectSplitViewHydrated: false,
+    projectSplitViewPending: null,
+    projectSplitViewError: "",
+    projectSplitViewActiveId: null,
+    projectSplitViewFocusedOrigin: null,
+    projectSplitViewPreviewTree: null,
+    projectSplitViewDrag: null,
+    splitViewOrganizationDrag: null,
+    projectSplitViewDividerDrag: null,
+    projectSplitViewTranscriptScroll: {},
+    projectSplitViewSuppressClick: null,
+    projectSplitViewSocketGeneration: 0,
+    projectSplitViewRequestSocket: null,
+    projectSplitViewRequestGeneration: null,
+    projectSplitViewRequestOwnerId: null,
+    projectSplitViewRequestSlug: null,
     sessionFolders: null,
     sessionFoldersSlug: null,
     sessionFolderCreate: null,
@@ -763,19 +790,12 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
   // buttons exist in the DOM when sidebar.js (and later terminal.js /
   // mcp-ui.js / etc.) attach click handlers by ID.
   initToolPalettes();
-  initProjectLogs();
-  initYou();
-  initYouActivity();
-  initIssues();
-  initIssuesContext();
-  initIssueLinks();
-  initScheduledTasks();
-  initDebatesWorkbench();
+  initializeAfterPaneReady([initProjectLogs, initYou, initYouActivity, initIssues, initIssuesContext, initIssueLinks, initScheduledTasks, initDebatesWorkbench]);
   initSidebar(sidebarCtx);
   var wsGetter = function () { return _getWsRef(); };
   initMateSidebar(wsGetter);
   initMateKnowledge(wsGetter);
-  initMateKnowledgeWorkbench();
+  initializeAfterPaneReady([initMateKnowledgeWorkbench]);
   initMateMemory(wsGetter, { onShow: function () { hideKnowledge(); hideNotes(); } });
   initCommandPalette({
     switchProject: function (slug) { switchProject(slug); },
@@ -1289,9 +1309,7 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     fileTreeEl: $("file-tree"),
     fileViewerEl: $("file-viewer"),
   });
-  initGitPanel();
-  initTopbarWorkbenchControls();
-  initSharedBrowser();
+  initializeAfterPaneReady([initGitPanel, initTopbarWorkbenchControls, initSharedBrowser]);
   initStudioBridge();
   initWorkerPaneLock();
   initPaneActivation();
@@ -1502,6 +1520,7 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
 
   // --- Init ---
   lucide.createIcons();
+  if (paneMode && typeof performance !== "undefined" && performance.mark) performance.mark("clay:bootstrap-complete");
   connect();
   if (slugMatch && location.hash === "#scheduler") {
     // Restore scheduler view after refresh

package/lib/public/css/base.css

@@ -278,6 +278,15 @@ html, body {
   overflow: hidden;
 }
 
+/* Seat the content corner inside the connected navigation/sidebar surround. */
+@media (min-width: 769px) {
+  body:not(.pane-mode) #main-area { background: var(--sidebar-bg); }
+  body:not(.pane-mode) #main-column {
+    background: var(--bg);
+    border-top-left-radius: 12px;
+  }
+}
+
 /* --- Main Panels (app + file-viewer + terminal side-by-side) --- */
 #main-panels {
   flex: 1;

package/lib/public/css/filebrowser.css

@@ -391,7 +391,6 @@
 /* --- Panel fullscreen --- */
 @media (min-width: 1024px) {
   /* Browser, Terminal and Files expand below the session title; see right-workbench.css. */
-  #main-column:has(.panel-fullscreen:not(.hidden):not(#shared-browser-panel, #terminal-container, #file-viewer)) > .title-bar-content { display: none; }
   #main-panels:has(.panel-fullscreen:not(.hidden)) > #app { display: none; }
 }
 @media (max-width: 1023px) {

package/lib/public/css/pane-header-controls.css

@@ -0,0 +1,100 @@
+/* Loading actions retain their place while their unavailable state is explicit. */
+.split-pane-header[data-pane-loading="true"] button {
+  opacity: .38;
+  color: var(--text-muted);
+  background: transparent;
+  box-shadow: none;
+  cursor: default;
+}
+.split-pane-header[data-pane-loading="true"] .split-pane-title { cursor: default; }
+
+/* Parent-owned search stays above Worker rows without moving the conversation. */
+.split-pane-search-popover {
+  position: absolute;
+  top: var(--split-pane-search-top, 28px);
+  right: 8px;
+  z-index: 20;
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  box-sizing: border-box;
+  width: min(420px, calc(100% - 16px));
+  padding: 5px 6px;
+  border: 1px solid var(--border);
+  border-top: 0;
+  border-radius: 0 0 8px 8px;
+  background: var(--bg-alt);
+  color: var(--text);
+  box-shadow: 0 3px 8px rgba(var(--shadow-rgb), .14);
+}
+.split-pane-search-popover[hidden] { display: none; }
+.split-pane-search-input {
+  flex: 1 1 120px;
+  width: 0;
+  min-width: 32px;
+  height: 26px;
+  box-sizing: border-box;
+  padding: 3px 7px;
+  border: 1px solid var(--border-subtle);
+  border-radius: 5px;
+  background: var(--bg);
+  color: var(--text);
+  font: inherit;
+  font-size: 12px;
+}
+.split-pane-search-input::placeholder { color: var(--text-muted); }
+.split-pane-search-count {
+  flex: 0 1 auto;
+  max-width: 72px;
+  overflow: hidden;
+  color: var(--text-muted);
+  font-size: 10px;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.split-pane-search-action {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex: 0 0 24px;
+  width: 24px;
+  height: 26px;
+  padding: 4px;
+  border: 0;
+  border-radius: 4px;
+  background: transparent;
+  color: var(--text-muted);
+  cursor: pointer;
+}
+.split-pane-search-action svg { width: 14px; height: 14px; }
+.split-pane-search-action:hover:not(:disabled) { background: var(--sidebar-hover); color: var(--text); }
+.split-pane-search-action:disabled { opacity: .45; cursor: default; }
+.split-pane-search-input:focus-visible,
+.split-pane-search-action:focus-visible,
+#sidebar-shell-expand-btn:focus-visible { outline: 2px solid var(--accent); outline-offset: -2px; }
+
+/* The shell remains reachable while its native conversation header is hidden. */
+#sidebar-shell-expand-btn {
+  display: none;
+  align-items: center;
+  justify-content: center;
+  width: 24px;
+  height: 24px;
+  padding: 4px;
+  border: 0;
+  border-radius: 5px;
+  background: transparent;
+  color: var(--text-secondary);
+  cursor: pointer;
+}
+#sidebar-shell-expand-btn svg { width: 16px; height: 16px; }
+#sidebar-shell-expand-btn:hover { background: var(--sidebar-hover); color: var(--text); }
+#sidebar-shell-expand-btn[hidden] { display: none; }
+@media (min-width: 769px) {
+  #layout.sidebar-collapsed #sidebar-shell-expand-btn:not([hidden]) { display: inline-flex; }
+}
+@media (pointer: coarse) {
+  .split-pane-search-input { height: 32px; font-size: 16px; }
+  .split-pane-search-action { flex-basis: 32px; width: 32px; height: 32px; }
+  #sidebar-shell-expand-btn { width: 28px; height: 28px; }
+}