clay-server 5.1.0-beta.1 → 6.0.0-beta.1

package/lib/project.js

@@ -1,3 +1,4 @@
+var handleProjectDebateControl = require("./project-debate-workspace").handleProjectDebateControl;
 var fs = require("fs");
 var path = require("path");
 var os = require("os");
@@ -421,9 +422,13 @@ function createProjectContext(opts) {
     });
   }
 
+  function canReceiveMate(ws) {
+    return !isMate || !usersModule.isMultiUser() || !!(ws && ws._clayUser && projectOwnerId && ws._clayUser.id === projectOwnerId);
+  }
+
   function send(obj) {
     for (var ws of clients) {
-      if (ws.readyState !== 1) continue;
+      if (ws.readyState !== 1 || !canReceiveMate(ws)) continue;
       var payload = obj;
       if (obj && obj.type === "info") {
         var infoUserId = ws._clayUser ? ws._clayUser.id : null;
@@ -438,7 +443,7 @@ function createProjectContext(opts) {
   }
 
   function sendTo(ws, obj) {
-    if (ws.readyState !== 1) return;
+    if (ws.readyState !== 1 || !canReceiveMate(ws)) return;
     var payload = obj;
     if (obj && (obj.type === "loop_registry_updated" || obj.type === "hub_schedules")) {
       var userId = ws._clayUser ? ws._clayUser.id : null;
@@ -464,7 +469,7 @@ function createProjectContext(opts) {
     var now = Date.now();
     var payload = JSON.stringify({ type: "update_available", version: version });
     for (var ws of clients) {
-      if (ws.readyState !== 1) continue;
+      if (ws.readyState !== 1 || !canReceiveMate(ws)) continue;
       if (!updateSnooze.isUpdateAdmin(ws, usersModule)) continue;
       var key = updateSnooze.userKeyFor(ws, usersModule);
       if (updateSnooze.isSnoozed(key, version, now)) continue;
@@ -480,7 +485,7 @@ function createProjectContext(opts) {
     var withVersion = JSON.stringify({ type: "update_started", version: version || "" });
     var withoutVersion = JSON.stringify({ type: "update_started" });
     for (var ws of clients) {
-      if (ws.readyState !== 1) continue;
+      if (ws.readyState !== 1 || !canReceiveMate(ws)) continue;
       ws.send(updateSnooze.isUpdateAdmin(ws, usersModule) ? withVersion : withoutVersion);
     }
   }
@@ -493,7 +498,7 @@ function createProjectContext(opts) {
     if (!userKey) return;
     var data = JSON.stringify(obj);
     for (var ws of clients) {
-      if (ws.readyState !== 1) continue;
+      if (ws.readyState !== 1 || !canReceiveMate(ws)) continue;
       if (updateSnooze.userKeyFor(ws, usersModule) !== userKey) continue;
       ws.send(data);
     }
@@ -528,27 +533,33 @@ function createProjectContext(opts) {
   function sendToOthers(sender, obj) {
     var data = JSON.stringify(obj);
     for (var ws of clients) {
-      if (ws !== sender && ws.readyState === 1) ws.send(data);
+      if (ws !== sender && ws.readyState === 1 && canReceiveMate(ws)) ws.send(data);
     }
   }
 
+  function canReceiveYou(ws, sessionId) {
+    var session = sm.sessions.get(sessionId);
+    return !session || !session.userKnowledgeOwnerId || !usersModule.isMultiUser()
+      || !!(ws._clayUser && ws._clayUser.id === session.userKnowledgeOwnerId);
+  }
+
   function sendToSession(sessionId, obj) {
     var data = JSON.stringify(obj);
     for (var ws of clients) {
-      if (ws.readyState === 1 && ws._clayActiveSession === sessionId) {
+      if (ws.readyState === 1 && canReceiveMate(ws) && canReceiveYou(ws, sessionId) && ws._clayActiveSession === sessionId) {
         ws.send(data);
       }
     }
     homeDebateClients.forEach(function (ws) {
       if (ws.readyState !== 1) { homeDebateClients.delete(ws); return; }
-      if (!clients.has(ws) && ws._clayHomeDebateSlug === slug && ws._clayActiveSession === sessionId) ws.send(data);
+      if (canReceiveMate(ws) && canReceiveYou(ws, sessionId) && !clients.has(ws) && ws._clayHomeDebateSlug === slug && ws._clayActiveSession === sessionId) ws.send(data);
     });
   }
 
   function sendToSessionOthers(sender, sessionId, obj) {
     var data = JSON.stringify(obj);
     for (var ws of clients) {
-      if (ws !== sender && ws.readyState === 1 && ws._clayActiveSession === sessionId) {
+      if (ws !== sender && ws.readyState === 1 && canReceiveMate(ws) && canReceiveYou(ws, sessionId) && ws._clayActiveSession === sessionId) {
         ws.send(data);
       }
     }
@@ -589,6 +600,7 @@ function createProjectContext(opts) {
   // --- Session manager ---
   var _gitAttribution = null;
   var sm = createSessionManager({
+    isMate: isMate,
     cwd: cwd,
     send: send,
     sendTo: sendTo,
@@ -814,7 +826,7 @@ function createProjectContext(opts) {
     sm: sm, resolveDefaultAi: opts.resolveDefaultAi, getSdk: function () { return sdk; },
     getLinuxUserForSession: getLinuxUserForSession, osUsers: osUsers,
     getProjectAccess: function () {
-      if (isMate) return { visibility: "private", ownerId: projectOwnerId || null, allowedUsers: [] };
+      if (isMate) return { isMate: true, visibility: "private", ownerId: projectOwnerId || null, allowedUsers: [] };
       return opts.getProjectAccess ? opts.getProjectAccess() : { visibility: "public", ownerId: projectOwnerId || null };
     },
     ensureProjectAccessForSession: ensureProjectAccessForSession,
@@ -870,6 +882,10 @@ function createProjectContext(opts) {
       return !usersModule.isMultiUser() || !!(ws._clayUser && ws._clayUser.id === session.ownerId);
     },
   });
+  var _userKnowledge = require('./project-user-knowledge').attachProjectUserKnowledge({
+    service: opts.userKnowledgeService, schedule: opts.scheduleUserKnowledge, slug: slug, sendTo: sendTo,
+    isMultiUser: function () { return usersModule.isMultiUser(); }
+  });
   var _mateKnowledge = attachProjectMateKnowledge({
     service: opts.mateKnowledgeService || null,
     sm: sm,
@@ -1002,6 +1018,7 @@ function createProjectContext(opts) {
     isMultiUser: usersModule.isMultiUser,
     getProjectOwnerId: function () { return projectOwnerId; },
     recordSessionEvent: function (session, event) { sm.sendAndRecord(session, event); },
+    persistSession: function (session) { return sm.saveSessionFile(session); },
     getVendorModelCatalog: function (ws, vendor) { return _models.getVendorCatalog(ws, vendor); },
     createReadyMate: opts.createReadyMate,
   });
@@ -1052,6 +1069,7 @@ function createProjectContext(opts) {
     // get the read-only cross-project set only when the Mate registry confirms
     // authoritative builtin Clay.
     try {
+      if (opts.userKnowledgeService) servers['clay-you'] = _userKnowledge.createMcpServer(adapter, null);
       var linearMcpConfig = _sessionLinear.createMcpServer(adapter, null);
       if (linearMcpConfig) servers['clay-linear'] = linearMcpConfig;
       var githubMcpConfig = _sessionGithub.createMcpServer(adapter, null);
@@ -1222,6 +1240,11 @@ function createProjectContext(opts) {
     var hasAny = false;
     for (var i = 0; i < keys.length; i++) {
       var name = keys[i];
+      if (forSession && forSession.youCurator && name !== 'clay-you') continue;
+      if (name === 'clay-you') {
+        if (forSession) { filtered[name] = _userKnowledge.createMcpServer(adapter, forSession); hasAny = true; }
+        continue;
+      }
       if (name === "clay-browser" && !extConnected) continue;
       if (name === "clay-email" && !emailAvailable) continue;
       if (name === "clay-workspace" && forSession) {
@@ -1421,6 +1444,7 @@ function createProjectContext(opts) {
       return false;
     },
     getSessionSystemPrompt: function (session) {
+      if (session.youCurator) return _userKnowledge.getSystemPrompt(session);
       return composeSystemPrompts([
         _sessionPair.getSystemPrompt(session),
         _sessionNotes.getSystemPrompt(session),
@@ -1435,6 +1459,7 @@ function createProjectContext(opts) {
         _sessionLinear.getSystemPrompt(session),
         _scheduledTasks ? _scheduledTasks.getSystemPrompt(session) : "",
         _mateKnowledge.getSystemPrompt(session),
+        _userKnowledge.getSystemPrompt(session),
         _autonomousRun ? _autonomousRun.getSystemPrompt(session) : "",
       ]);
     },
@@ -1443,6 +1468,7 @@ function createProjectContext(opts) {
       return _askUser.createHandler(session)(request, respond);
     },
     getSessionToolDefs: function (session) {
+      if (session.youCurator) return _userKnowledge.getDynamicToolDefs(session);
       return _sessionPair.getToolDefs(session)
         .concat(_sessionNotes.getToolDefs(session))
         .concat(_sessionHandoff.getToolDefs(session))
@@ -1458,6 +1484,7 @@ function createProjectContext(opts) {
         .concat(_sessionGithub.getDynamicToolDefs(session))
         .concat(_sessionLinear.getDynamicToolDefs(session))
         .concat(_mateKnowledge.getDynamicToolDefs(session))
+        .concat(opts.userKnowledgeService ? _userKnowledge.getDynamicToolDefs(session) : [])
         .concat(_loopInterview ? _loopInterview.getToolDefs(session) : [])
         .concat(_scheduledTasks ? _scheduledTasks.getToolDefs(session) : [])
         .concat(_scheduledTaskExecution ? _scheduledTaskExecution.getToolDefs(session) : [])
@@ -1526,7 +1553,7 @@ function createProjectContext(opts) {
     onProcessingChanged: onProcessingChanged,
     ensureProjectAccessForSession: ensureProjectAccessForSession,
     getProjectAccess: function () {
-      if (isMate) return { visibility: "private", ownerId: projectOwnerId || null, allowedUsers: [] };
+      if (isMate) return { isMate: true, visibility: "private", ownerId: projectOwnerId || null, allowedUsers: [] };
       return opts.getProjectAccess ? opts.getProjectAccess() : { visibility: "public", ownerId: projectOwnerId || null };
     },
     canAccessProjectSlug: opts.canAccessProjectSlug || function () { return !usersModule.isMultiUser(); },
@@ -1763,7 +1790,7 @@ function createProjectContext(opts) {
       if (typeof opts.onDmMessage === "function") opts.onDmMessage(ws, msg, slug);
       return;
     }
-    if (msg.type === "project_assignment_response" || msg.type === "dm_open" || msg.type === "dm_send" || msg.type === "dm_list" || msg.type === "dm_typing" || msg.type === "dm_add_favorite" || msg.type === "dm_remove_favorite" || msg.type === "mate_create" || msg.type === "mate_list" || msg.type === "mate_delete" || msg.type === "mate_update" || msg.type === "mate_readd_builtin" || msg.type === "mate_list_available_builtins" || msg.type === "email_accounts_list" || msg.type === "email_account_add" || msg.type === "email_account_remove" || msg.type === "email_account_test" || msg.type === "home_debates_list" || msg.type === "home_mate_present" || msg.type === "home_mate_open" || msg.type === "home_mate_sessions_list" || msg.type === "home_mate_session_open" || msg.type === "home_mate_send" || msg.type === "home_mate_new_session" || msg.type === "home_mate_debate_plan" || msg.type === "home_debate_proposal_response" || msg.type === "home_mate_creation_plan" || msg.type === "home_mate_creation_proposal_response" || msg.type === "home_mate_close" || msg.type === "home_mate_memory_list" || msg.type === "home_mate_knowledge_list" || msg.type === "home_mate_models_get" || msg.type === "home_mate_model_set" || msg.type === "home_dock_get" || msg.type === "home_dock_set" || msg.type === "home_surface_get" || msg.type === "home_surface_set" || msg.type === "tools_list" || msg.type === "tool_get" || msg.type === "tool_install" || msg.type === "tool_remove" || msg.type === "tool_storage_op" || msg.type === "tool_llm_op" || msg.type === "tool_llm_config_get" || msg.type === "tool_control_response" || msg.type === "tool_source_get" || msg.type === "tool_mate_access_set" || msg.type === "tool_server_control" || msg.type === "tool_frame_url") {
+    if (msg.type === "project_assignment_response" || msg.type === "dm_open" || msg.type === "dm_send" || msg.type === "dm_list" || msg.type === "dm_typing" || msg.type === "dm_add_favorite" || msg.type === "dm_remove_favorite" || msg.type === "mate_create" || msg.type === "mate_list" || msg.type === "mate_delete" || msg.type === "mate_update" || msg.type === "mate_instructions_get" || msg.type === "mate_instructions_set" || msg.type === "mate_readd_builtin" || msg.type === "mate_list_available_builtins" || msg.type === "email_accounts_list" || msg.type === "email_account_add" || msg.type === "email_account_remove" || msg.type === "email_account_test" || msg.type === "home_debates_list" || msg.type === "home_mate_present" || msg.type === "home_mate_open" || msg.type === "home_mate_sessions_list" || msg.type === "home_mate_session_open" || msg.type === "home_mate_send" || msg.type === "home_mate_new_session" || msg.type === "home_mate_debate_plan" || msg.type === "home_debate_proposal_response" || msg.type === "home_mate_creation_plan" || msg.type === "home_mate_creation_proposal_response" || msg.type === "home_mate_close" || msg.type === "home_mate_memory_list" || msg.type === "home_mate_knowledge_list" || msg.type === "home_mate_models_get" || msg.type === "home_mate_model_set" || msg.type === "home_dock_get" || msg.type === "home_dock_set" || msg.type === "home_surface_get" || msg.type === "home_surface_set" || msg.type === "tools_list" || msg.type === "tool_get" || msg.type === "tool_install" || msg.type === "tool_remove" || msg.type === "tool_storage_op" || msg.type === "tool_llm_op" || msg.type === "tool_llm_config_get" || msg.type === "tool_control_response" || msg.type === "tool_source_get" || msg.type === "tool_mate_access_set" || msg.type === "tool_server_control" || msg.type === "tool_frame_url") {
       if (typeof opts.onDmMessage === "function") {
         opts.onDmMessage(ws, msg, slug);
       }
@@ -1801,6 +1828,7 @@ function createProjectContext(opts) {
     }
 
     // --- Debate ---
+    if (handleProjectDebateControl(ws, msg, getSessionForWs(ws), _debate, sendTo)) return;
     if (msg.type === "debate_start") {
       handleDebateStart(ws, msg);
       return;
@@ -1838,6 +1866,7 @@ function createProjectContext(opts) {
     if (_knowledge.handleKnowledgeMessage(ws, msg)) return;
 
     // --- Project Logs (delegated to project-logs.js) ---
+    if (opts.userKnowledgeService && _userKnowledge.handleMessage(ws, msg)) return;
     if (_projectLogs.handleLogsMessage(ws, msg)) return;
     if (_issues.handleMessage(ws, msg)) return;
     if (_sessionGithub.handleMessage(ws, msg)) return;
@@ -2072,6 +2101,7 @@ function createProjectContext(opts) {
     pushModule: pushModule,
     getSessionForWs: getSessionForWs,
     resolveDefaultAi: opts.resolveDefaultAi,
+    resolveMateSessionDefaults: opts.resolveMateSessionDefaults,
     getVendorAvailability: function (ws) { return _models.getVendorAvailability(ws); },
     canCreateScheduledTaskInterview: function (ws, session) { return !!(_scheduledTasks && _scheduledTasks.canCreateInterview(ws, session)); },
     canStartScheduledTaskInterview: function (ws, session) { return !!(_scheduledTasks && _scheduledTasks.canStartInterview(ws, session)); },
@@ -2104,7 +2134,7 @@ function createProjectContext(opts) {
     cancelScheduledMessage: cancelScheduledMessage,
     sendScheduledMessageNow: sendScheduledMessageNow,
     getProjectOwnerId: function () { return projectOwnerId; },
-    setProjectOwnerId: function (id) { projectOwnerId = id; },
+    setProjectOwnerId: function (id) { if (!isMate) projectOwnerId = id; },
     getUpdateChannel: function () { return updateChannel; },
     setUpdateChannel: function (ch) { updateChannel = ch; },
     getLatestVersion: function () { return latestVersion; },
@@ -2347,6 +2377,7 @@ function createProjectContext(opts) {
           }
         }
 
+        if (boundSession && boundSession.youCurator) return Promise.resolve(_userKnowledge.getBridgeTools(boundSession, normalizeToolSchema));
         if (boundSession) {
           var queryTools = queryToolBridge.listTools(queryGeneration);
           for (var qti = 0; qti < queryTools.length; qti++) tools.push(queryTools[qti]);
@@ -2411,6 +2442,10 @@ function createProjectContext(opts) {
           tools = tools.concat(_issues.getBridgeTools(boundSession, normalizeToolSchema));
           tools = tools.concat(_sessionGithub.getBridgeTools(boundSession, normalizeToolSchema));
           tools = tools.concat(_sessionLinear.getBridgeTools(boundSession, normalizeToolSchema));
+          if (opts.userKnowledgeService) {
+            var youTools = _userKnowledge.getBridgeTools(boundSession, normalizeToolSchema);
+            for (var yti = 0; yti < youTools.length; yti++) tools.push(youTools[yti]);
+          }
           var logsTools = _projectLogs.getBridgeTools(boundSession, normalizeToolSchema);
           for (var plti = 0; plti < logsTools.length; plti++) tools.push(logsTools[plti]);
           var knowledgeTools = _mateKnowledge.getBridgeTools(boundSession, normalizeToolSchema);
@@ -2439,7 +2474,7 @@ function createProjectContext(opts) {
             // Debate tools were added above only when this request had an
             // exact session. Never duplicate them or advertise the static,
             // intentionally unbound proposal server.
-            if (inAppNames[i] === "clay-debate" || inAppNames[i] === "clay-mate-creation" || inAppNames[i] === "clay-workspace" || inAppNames[i] === "clay-history" || inAppNames[i] === "clay-github" || inAppNames[i] === "clay-linear" || inAppNames[i] === "clay-issues" || inAppNames[i] === "clay-logs" || inAppNames[i] === "clay-knowledge") continue;
+            if (inAppNames[i] === "clay-debate" || inAppNames[i] === "clay-mate-creation" || inAppNames[i] === "clay-workspace" || inAppNames[i] === "clay-history" || inAppNames[i] === "clay-github" || inAppNames[i] === "clay-linear" || inAppNames[i] === "clay-issues" || inAppNames[i] === "clay-logs" || inAppNames[i] === "clay-knowledge" || inAppNames[i] === "clay-you") continue;
             extractServerTools(inAppNames[i], localMcp[inAppNames[i]]);
           }
         }
@@ -2459,6 +2494,8 @@ function createProjectContext(opts) {
         if (sessionOnly && !sessionQueryValid()) {
           return Promise.reject(new Error("Session tool unavailable or older query: " + serverName + "/" + toolName));
         }
+        if (boundSession && boundSession.youCurator && serverName !== 'clay-you') return Promise.reject(new Error('Clay review only permits User Knowledge tools.'));
+        if (boundSession && serverName === 'clay-you') return _userKnowledge.callBridgeTool(boundSession, toolName, args);
         var queryCall = queryToolBridge.callTool(queryGeneration, serverName, toolName, args);
         if (queryCall) return queryCall;
         if (boundSession && serverName === "clay-sessions") {
@@ -2538,7 +2575,7 @@ function createProjectContext(opts) {
         if (boundSession && serverName === "clay-knowledge") {
           return _mateKnowledge.callBridgeTool(boundSession, toolName, args);
         }
-        if (serverName === "clay-sessions" || serverName === "clay-notes" || serverName === "clay-handoff" || serverName === "clay-documents" || serverName === "clay-shared-browser" || serverName === "clay-debate" || serverName === "clay-mate-creation" || serverName === "clay-workspace" || serverName === "clay-history" || serverName === "clay-github" || serverName === "clay-linear" || serverName === "clay-issues" || serverName === "clay-logs" || serverName === "clay-knowledge") {
+        if (serverName === "clay-sessions" || serverName === "clay-notes" || serverName === "clay-handoff" || serverName === "clay-documents" || serverName === "clay-shared-browser" || serverName === "clay-debate" || serverName === "clay-mate-creation" || serverName === "clay-workspace" || serverName === "clay-history" || serverName === "clay-github" || serverName === "clay-linear" || serverName === "clay-issues" || serverName === "clay-logs" || serverName === "clay-knowledge" || serverName === "clay-you") {
           return Promise.reject(new Error("Session-bound tool requires a valid Clay session: " + serverName + "/" + toolName));
         }
         if (sessionOnly) return Promise.reject(new Error("Session tool not found: " + serverName + "/" + toolName));
@@ -2597,6 +2634,8 @@ function createProjectContext(opts) {
     cwd: cwd,
     slug: slug,
     isMate: isMate,
+    mateId: mateId,
+    mateDisplayName: opts.mateDisplayName || "",
     osUsers: osUsers,
     debug: debug,
     dangerouslySkipPermissions: dangerouslySkipPermissions,
@@ -2632,7 +2671,7 @@ function createProjectContext(opts) {
     stopFileWatch: stopFileWatch,
     stopAllDirWatches: stopAllDirWatches,
     getProjectOwnerId: function () { return projectOwnerId; },
-    setProjectOwnerId: function (id) { projectOwnerId = id; },
+    setProjectOwnerId: function (id) { if (!isMate) projectOwnerId = id; },
     getLatestVersion: function () { return latestVersion; },
     getTitle: function () { return title; },
     getProject: function () { return project; },
@@ -2799,7 +2838,7 @@ function createProjectContext(opts) {
 
   function setTitle(newTitle) {
     title = newTitle || null;
-    send({ type: "info", cwd: cwd, slug: slug, project: title || project, version: currentVersion, debug: !!debug, osUsers: osUsers, lanHost: lanHost, projectCount: getProjectCount(), projects: getProjectList(), projectOwnerId: projectOwnerId });
+    send({ type: "info", cwd: cwd, slug: slug, project: title || project, version: currentVersion, debug: !!debug, osUsers: osUsers, lanHost: lanHost, projectCount: getProjectCount(), projects: getProjectList(), projectOwnerId: projectOwnerId, isMate: isMate, mateId: isMate ? mateId : null, mateDisplayName: isMate ? (opts.mateDisplayName || title || project || "Mate") : "" });
   }
 
   function setIcon(newIcon) {
@@ -2868,6 +2907,7 @@ function createProjectContext(opts) {
     isMcpBridgeAuthenticated: function (req) {
       return !!(req && req.headers && req.headers["x-clay-bridge-token"] && req.headers["x-clay-bridge-token"] === mcpBridgeToken);
     },
+    getYouLinuxUser: getLinuxUserForSession,
     getStatus: getStatus,
     getSessionManager: function () { return sm; },
     createDelegatedSession: _delegatedSession.createDelegatedSession,
@@ -2885,6 +2925,7 @@ function createProjectContext(opts) {
     getVendorModelAvailability: _models.getVendorAvailability,
     getMemoryState: _memory.readMemoryState,
     listKnowledgeFiles: _knowledge.listKnowledgeFiles,
+    getKnowledgeDbService: function () { return _knowledge.databases; },
     refreshCapsuleCatalog: _capsuleCatalog.refreshSessions,
     getNotificationsModule: function () { return _notifications; },
     refreshVendorAuth: _vendorLogin.refreshVendorAuth,
@@ -2893,7 +2934,7 @@ function createProjectContext(opts) {
     removeSchedule: _loop.removeSchedule,
     setTitle: setTitle,
     setIcon: setIcon,
-    setProjectOwner: function (ownerId) { projectOwnerId = ownerId; },
+    setProjectOwner: function (ownerId) { if (!isMate) projectOwnerId = ownerId; },
     getProjectOwner: function () { return projectOwnerId; },
     getToolLlmConfig: function (ws, alias) {
       return _toolLlmRuntime.getConfiguration(ws, alias);

package/lib/public/app.js

@@ -25,6 +25,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 { 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';
@@ -41,17 +42,21 @@ import { initStickyNotes, handleNotesList, handleNoteCreated, handleNoteUpdated,
 import { initNotesBrowser, openNotesBrowser, closeNotesBrowser, isNotesBrowserOpen, renderNotesBrowser } from './modules/sticky-notes-browser.js';
 import { initTheme, getThemeColor, getComputedVar, onThemeChange, getCurrentTheme, getChatLayout } from './modules/theme.js';
 import { initTools, resetToolState, saveToolState, restoreToolState, renderAskUserQuestion, markAskUserAnswered, renderPermissionRequest, markPermissionResolved, markPermissionCancelled, renderElicitationRequest, markElicitationResolved, renderPlanBanner, renderPlanCard, handleTodoWrite, handleTaskCreate, handleTaskUpdate, startThinking, appendThinking, stopThinking, resetThinkingGroup, createToolItem, updateToolExecuting, updateToolResult, markAllToolsDone, addTurnMeta, resetTurnMetaCost, enableMainInput, getTools, getPlanContent, setPlanContent, isPlanFilePath, getTodoTools, updateSubagentActivity, addSubagentToolEntry, markSubagentDone, updateSubagentProgress, initSubagentStop, closeToolGroup, removeToolFromGroup } from './modules/tools.js';
-import { initServerSettings, updateSettingsStats, updateDaemonConfig, handleSetPinResult, handleKeepAwakeChanged, handleAutoContinueChanged, handleRestartResult, handleShutdownResult, handleSharedEnv, handleSharedEnvSaved, handleGlobalClaudeMdRead, handleGlobalClaudeMdWrite } from './modules/server-settings.js';
-import { initProjectSettings, handleInstructionsRead, handleInstructionsWrite, handleProjectEnv, handleProjectEnvSaved, isProjectSettingsOpen, handleProjectSharedEnv, handleProjectSharedEnvSaved, handleProjectOwnerChanged } from './modules/project-settings.js';
+import { initServerSettings, updateSettingsStats, updateDaemonConfig, handleSetPinResult, handleKeepAwakeChanged, handleAutoContinueChanged, handleRestartResult, handleShutdownResult, handleSharedEnv, handleSharedEnvSaved } from './modules/server-settings.js';
+import { initProjectSettings } from './modules/project-settings.js';
 import { initSkills, handleSkillInstalled, handleSkillUninstalled } from './modules/skills.js';
 import { initMcp } from './modules/mcp-ui.js';
 import { initScheduler, resetScheduler, handleLoopRegistryUpdated, handleScheduleRunStarted, handleScheduleRunFinished, handleLoopScheduled, openSchedulerToTab, isSchedulerOpen, closeScheduler, enterCraftingMode, exitCraftingMode, handleLoopRegistryFiles, getUpcomingSchedules } from './modules/scheduler.js';
 import { initScheduledTasks, closeScheduledTasks } from './modules/scheduled-tasks.js';
+import { initDebatesWorkbench } from './modules/debates-workbench.js';
 import { initPlaybook, openPlaybook, getPlaybooks, getPlaybookForTip, isCompleted as isPlaybookCompleted } from './modules/playbook.js';
 import { initSTT } from './modules/stt.js';
 import { initProfile, getProfileLang } from './modules/profile.js';
+import { initAccountIsland } from './modules/account-island.js';
 import { initUserSettings } from './modules/user-settings.js';
 import { initToolPalettes } from './modules/tool-palette.js';
+import { initYou } from './modules/you.js';
+import { initYouActivity } from './modules/you-activity.js';
 import { initProjectLogs, closeProjectLogs } from './modules/project-logs.js';
 import { initProjectSwitcher } from './modules/project-switcher.js';
 import { initSplitView } from './modules/split-view.js';
@@ -65,9 +70,6 @@ import { initShellCommand } from './modules/shell-command.js';
 import { initConnection, connect as _connConnect, setStatus as _connSetStatus, scheduleReconnect as _connScheduleReconnect, cancelReconnect as _connCancelReconnect } from './modules/app-connection.js';
 import { processMessage as _msgProcessMessage } from './modules/app-messages.js';
 import { getWs as _getWsRef, setWs as _setWsRef } from './modules/ws-ref.js';
-import { initHomeHub, showHomeHub as _hubShowHomeHub, hideHomeHub as _hubHideHomeHub, isHomeHubVisible, renderHomeMateSwitcher, updateHomeIconBadge } from './modules/app-home-hub.js';
-import { initHomeSidebar } from './modules/home-sidebar.js';
-import { openHomeMateAction } from './modules/home-mate-chat.js';
 import { initProjectsHub, showProjectsHub, hideProjectsHub } from './modules/projects-hub.js';
 import { initHomeSurfaceBoot } from './modules/home-surface-boot.js';
 import { rememberHomePrimarySurface } from './modules/home-surface.js';
@@ -88,6 +90,10 @@ import { initPendingMessageQueue } from './modules/pending-message-queue.js';
 import { initAppNotifications, handleNotificationsState as _notifHandleState, handleNotificationCreated as _notifHandleCreated, handleNotificationDismissed as _notifHandleDismissed, handleNotificationDismissedAll as _notifHandleDismissedAll } from './modules/app-notifications.js';
 import { initHeaderTuiFont } from './modules/header-tui-font.js';
 import { createStore, store } from './modules/store.js';
+import { initProjectMateNavigation } from './modules/project-mate-navigation.js';
+import { initProjectMateCreationWorkspace } from './modules/project-mate-creation-workspace.js';
+import { initProjectDebatePlanningWorkspace } from './modules/project-debate-planning-workspace.js';
+import { initProjectSessionNavigation } from './modules/project-session-navigation.js';
 import { initPanels, updateConfigChip as _panUpdateConfigChip, getModelEffortLevels as _panGetModelEffortLevels, accumulateUsage as _panAccumulateUsage, updateUsagePanel as _panUpdateUsagePanel, resetUsage as _panResetUsage, toggleUsagePanel as _panToggleUsagePanel, formatTokens as _panFormatTokens, updateStatusPanel as _panUpdateStatusPanel, requestProcessStats as _panRequestProcessStats, toggleStatusPanel as _panToggleStatusPanel, accumulateContext as _panAccumulateContext, updateContextPanel as _panUpdateContextPanel, resetContext as _panResetContext, resetContextData as _panResetContextData, minimizeContext as _panMinimizeContext, expandContext as _panExpandContext, toggleContextPanel as _panToggleContextPanel, getContextView as _panGetContextView, renderCtxPopover as _panRenderCtxPopover, hideCtxPopover as _panHideCtxPopover, formatBytes as _panFormatBytes, formatUptime as _panFormatUptime, getModelSupportsEffort as _panGetModelSupportsEffort, getSessionUsage, setSessionUsage, getContextData, setContextData, setContextView as _panSetContextView, applyContextView as _panApplyContextView } from './modules/app-panels.js';
 import { initProjects, updateProjectList as _projUpdateProjectList, renderProjectList as _projRenderProjectList, renderTopbarPresence as _projRenderTopbarPresence, switchProject as _projSwitchProject, resetClientState as _projResetClientState, confirmRemoveProject as _projConfirmRemoveProject, handleRemoveProjectCheckResult as _projHandleRemoveProjectCheckResult, handleRemoveProjectResult as _projHandleRemoveProjectResult, openAddProjectModal as _projOpenAddProjectModal, closeAddProjectModal as _projCloseAddProjectModal, handleBrowseDirResult as _projHandleBrowseDirResult, handleAddProjectResult as _projHandleAddProjectResult, handleCloneProgress as _projHandleCloneProgress, showUpdateAvailable as _projShowUpdateAvailable, getCachedProjects, setCachedProjects, getCachedProjectCount, getCachedRemovedProjects, setCachedRemovedProjects } from './modules/app-projects.js';
 import { initRendering, addToMessages as _renAddToMessages, scrollToBottom as _renScrollToBottom, forceScrollToBottom as _renForceScrollToBottom, addUserMessage as _renAddUserMessage, getMsgTime as _renGetMsgTime, shouldGroupMessage as _renShouldGroupMessage, ensureAssistantBlock as _renEnsureAssistantBlock, addCopyHandler as _renAddCopyHandler, appendDelta as _renAppendDelta, flushStreamBuffer as _renFlushStreamBuffer, finalizeAssistantBlock as _renFinalizeAssistantBlock, addSystemMessage as _renAddSystemMessage, addConflictMessage as _renAddConflictMessage, addContextOverflowMessage as _renAddContextOverflowMessage, showClaudePreThinking as _renShowClaudePreThinking, showMatePreThinking as _renShowMatePreThinking, removeMatePreThinking as _renRemoveMatePreThinking, showSuggestionChips as _renShowSuggestionChips, hideSuggestionChips as _renHideSuggestionChips, getGhostSuggestion as _renGetGhostSuggestion, getTurnCounter, setTurnCounter, getPrependAnchor, setPrependAnchor, getActivityEl, setActivityEl, getIsUserScrolledUp, setIsUserScrolledUp, getStickyBottom, armStickyBottom, disarmStickyBottom } from './modules/app-rendering.js';
@@ -148,11 +154,12 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
 
 
   // --- Home Hub (delegated to app-home-hub.js) ---
-  function showHomeHub(fromHistory) { _hubShowHomeHub(fromHistory); }
-  function hideHomeHub() { _hubHideHomeHub(); }
+  function showHomeHub(fromHistory) { showProjectsHub(fromHistory); }
+  function hideHomeHub() {}
+  function isHomeHubVisible() { return false; }
   function startClayMateCreation() {
-    showHomeHub();
-    openHomeMateAction("mate");
+    var add = document.getElementById('icon-strip-add');
+    if (add) add.click();
   }
 
   // --- DM (delegated to app-dm.js) ---
@@ -273,6 +280,8 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     sharedBrowser: null,
     sharedBrowsers: [],
     mcpSkillsWorkbench: {},
+    mateKnowledgeWorkspaces: {},
+    mateColorSave: null,
     mcpConnections: { screen: "list", servers: [], search: "", loaded: false },
     sharedBrowserOpen: false,
     sharedBrowserUi: {},
@@ -314,12 +323,55 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     githubWorkProject: null,
     githubWorkRefresh: null,
     activeProjectSlug: null,
+    activeProjectMateId: null,
+    activeProjectMateName: '',
+    activeSessionMateId: null,
+    activeSessionMateName: '',
     sessionActivatedProjectSlug: null,
     sessionListProjectSlug: null,
     splitGroupsProjectSlug: null,
     socketPath: null,
     pendingHomeProjectSlug: null,
     homeProjectEmptyVisible: false,
+    homeShellVisible: false,
+    projectMateFilterMode: 'all',
+    projectMateFilterTurns: 0,
+    projectMateFilterActivated: false,
+    projectMateCreationActive: false,
+    projectMateCreationMateId: null,
+    projectMateCreationSessionId: null,
+    projectMateCreationRequestId: null,
+    projectMateCreationPendingStart: false,
+    projectMateCreationAwaitingHistory: false,
+    projectMateCreationAwaitingMateList: false,
+    projectMateCreationHistoryReady: false,
+    projectMateCreationLocalId: null,
+    projectMateCreationMessages: [],
+    projectMateCreationPendingMateId: null,
+    projectDebatePlanningActive: false,
+    projectDebatePlanningMateId: null,
+    projectDebatePlanningSessionId: null,
+    projectDebatePlanningLocalId: null,
+    projectDebatePlanningRequestId: null,
+    projectDebatePlanningPendingStart: false,
+    projectDebatePlanningAwaitingHistory: false,
+    projectDebatePlanningAwaitingMateList: false,
+    projectDebatePlanningHistoryReady: false,
+    projectDebatePlanningTopic: "",
+    projectDebatePlanningMessages: [],
+    projectDebatePlanningError: "",
+    projectDebatePlanningRetryable: false,
+    debatesWorkbenchStatus: "idle",
+    debatesWorkbenchRequestId: null,
+    debatesWorkbenchItems: [],
+    debatesWorkbenchError: "",
+    debatesWorkbenchFilter: "all",
+    debatesWorkbenchCreating: false,
+    debatesWorkbenchWide: false,
+    debatesWorkbenchFullscreen: false,
+    debatesWorkbenchScrollTop: 0,
+    pendingDebateNavigation: null,
+    pendingProjectSessionNavigation: null,
     projectsHubVisible: false,
     projectsHubMarkup: null,
     projectsHubList: [],
@@ -387,6 +439,7 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     fileViewerOpenRevision: 0,
     cursorSharingEnabled: false,
     cursorSharingHydrated: false,
+    cursorSharingPending: null,
     pendingOutboundMessages: [],
     pendingMessageQueue: { projectSlug: null, sessionId: null, revision: 0, paused: false, items: [], loading: false, error: "" },
     pendingMessageQueueRecovery: false,
@@ -426,6 +479,9 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     dockWidth: null,
     dockHasActivity: false,
     dockActivityToolId: null,
+    you: {},
+    youActivity: {},
+    youSequence: 0,
     projectLogsOpen: false,
     projectLogsWide: false,
     projectLogsFullscreen: false,
@@ -498,7 +554,7 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     cachedMatesList: [],
     cachedDmFavorites: [],
     cachedAvailableBuiltins: [],
-    projectMateDmsEnabled: false,
+    projectMateDmsEnabled: true,
     returningFromMateDm: false,
     pendingMateInterview: null,
     pendingTermCommand: null,
@@ -546,10 +602,6 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     vendorInfo: {},
     // Rate-limit data is projected only for the displayed session/vendor.
     rateLimitState: {},
-    // How Claude sessions open: "gui" (default) or "tui". The server sends
-    // claude_open_mode_changed on connect; this seeds it beforehand so the
-    // new-session menu doesn't flash the TUI-only entry.
-    claudeOpenMode: "gui",
     currentMode: "default",
     effectivePermissionMode: null,
     permissionCapabilities: { auto: false, mcpOverride: false },
@@ -655,14 +707,18 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
   // mcp-ui.js / etc.) attach click handlers by ID.
   initToolPalettes();
   initProjectLogs();
+  initYou();
+  initYouActivity();
   initIssues();
   initIssuesContext();
   initIssueLinks();
   initScheduledTasks();
+  initDebatesWorkbench();
   initSidebar(sidebarCtx);
   var wsGetter = function () { return _getWsRef(); };
   initMateSidebar(wsGetter);
   initMateKnowledge(wsGetter);
+  initMateKnowledgeWorkbench();
   initMateMemory(wsGetter, { onShow: function () { hideKnowledge(); hideNotes(); } });
   initCommandPalette({
     switchProject: function (slug) { switchProject(slug); },
@@ -936,7 +992,7 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     var m = location.pathname.match(/^\/p\/([a-z0-9_-]+)/);
     var newSlug = m ? m[1] : null;
     if (!newSlug) {
-      showHomeHub(true);
+      showProjectsHub(true);
       return;
     }
     rememberHomePrimarySurface("project", newSlug);
@@ -1073,9 +1129,7 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
 
   // --- Admin (multi-user mode) ---
   // isMultiUserMode, isHeadlessMode, myUserId -> store
-  initAdmin({
-    get projectList() { return getCachedProjects(); },
-  });
+  initAdmin();
   fetch("/api/me").then(function (r) { return r.json(); }).then(function (d) {
     if (d.multiUser) {
       store.set({ isMultiUserMode: true });
@@ -1096,6 +1150,7 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     }
     initCursorToggle();
     initDefaultAi();
+    initAccountIsland();
     // Apply RBAC UI gating
     var _perms = store.get('permissions');
     if (_perms) {
@@ -1156,35 +1211,10 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
   });
 
   // --- Server Settings ---
-  initServerSettings({
-    get ws() { return _getWsRef(); },
-    get projectName() { return store.get('projectName'); },
-    get currentSlug() { return store.get('currentSlug'); },
-    wsPath: wsPath,
-    get currentModels() { return store.get('currentModels'); },
-    set currentModels(v) { store.set({ currentModels: v }); },
-    get currentModel() { return store.get('currentModel'); },
-    get currentMode() { return store.get('currentMode'); },
-    get currentEffort() { return store.get('currentEffort'); },
-    get currentBetas() { return store.get('currentBetas'); },
-    get currentThinking() { return store.get('currentThinking'); },
-    get currentThinkingBudget() { return store.get('currentThinkingBudget'); },
-    setContextView: function (v) { _panSetContextView(v); },
-    applyContextView: function (v) { _panApplyContextView(v); },
-  });
+  initServerSettings();
 
   // --- Project Settings ---
-  initProjectSettings({
-    get ws() { return _getWsRef(); },
-    get connected() { return store.get('connected'); },
-    get currentModels() { return store.get('currentModels'); },
-    get currentModel() { return store.get('currentModel'); },
-    get currentMode() { return store.get('currentMode'); },
-    get currentEffort() { return store.get('currentEffort'); },
-    get currentBetas() { return store.get('currentBetas'); },
-    get currentThinking() { return store.get('currentThinking'); },
-    get currentThinkingBudget() { return store.get('currentThinkingBudget'); },
-  }, getEmojiCategories());
+  initProjectSettings(getEmojiCategories());
 
   // --- QR code ---
   initQrCode();
@@ -1332,18 +1362,6 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
   function handleSkillInstallWs(msg) { _siHandleSkillInstallWs(msg); }
 
 
-  // Debate button in mate sidebar (only visible in DM mode)
-  var debateBtn = document.getElementById("mate-debate-btn");
-  if (debateBtn) {
-    debateBtn.addEventListener("click", function () {
-      var contextMessages = dmMessageCache.map(function (m) {
-        return { text: m.text, isMate: m.from !== store.get('myUserId') };
-      });
-      openDebateModal({ dmContext: contextMessages });
-    });
-  }
-
-
   // --- Debate UI (delegated to app-debate-ui.js) ---
   // debateStickyState, debateHandRaiseOpen, debateFloorMode, debateConcludeMode, debateEndedMode -> modules/app-debate-ui.js
   function showDebateConcludeConfirm(msg) { _debShowDebateConcludeConfirm(msg); }
@@ -1408,23 +1426,13 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
   initProjects();
 
   // --- Home Hub module ---
-  initHomeHub();
-  initHomeSidebar();
+  initProjectMateNavigation();
+  initProjectSessionNavigation();
+  initProjectMateCreationWorkspace();
+  initProjectDebatePlanningWorkspace();
   initProjectsHub();
   initHomeSurfaceBoot();
 
-  // Mates live on the home hub now, so keep that pane and the C button
-  // badge in sync with the mate list, unread DMs, and mention activity.
-  store.subscribe(function (state, prev) {
-    if (state.cachedMatesList !== prev.cachedMatesList || state.dmUnread !== prev.dmUnread) {
-      renderHomeMateSwitcher();
-      updateHomeIconBadge();
-    }
-  });
-  onMentionActiveChange(function () {
-    renderHomeMateSwitcher();
-  });
-  updateHomeIconBadge();
 
   // --- DM module ---
   initDm();