clay-server 4.0.0-beta.2 → 4.0.0-beta.21

package/lib/project.js

@@ -9,6 +9,7 @@ var runtimeEnv = require("./runtime-env");
 var { createTerminalManager } = require("./terminal-manager");
 var { createNotesManager } = require("./notes");
 var { fetchLatestVersion, fetchVersion, isNewer } = require("./updater");
+var updateSnooze = require("./update-snooze");
 var { execFileSync, spawn } = require("child_process");
 var usersModule = require("./users");
 var { resolveOsUserInfo, fsAsUser, grantProjectAccess } = require("./os-users");
@@ -42,6 +43,7 @@ var { attachEmail: attachEmailModule } = require("./project-email");
 var { attachSessionSpawn } = require("./project-session-spawn");
 var { attachDelegatedSession } = require("./project-delegated-session");
 var { attachDelegatedFollowUp } = require("./project-delegated-follow-up");
+var { attachCapsuleTurn } = require("./project-capsule-turn");
 var workspaceSessionRef = require("./workspace-query-service").sessionRef;
 var { attachSessionPair } = require("./project-session-pair");
 var { attachSessionHandoff } = require("./project-session-handoff");
@@ -49,8 +51,12 @@ var { attachSessionNotes, composeSystemPrompts } = require("./project-session-no
 var { attachSessionDocument } = require("./project-session-document");
 var { attachCapsuleCatalog } = require("./project-capsule-catalog");
 var { attachProjectWorkspaceQuery } = require("./project-workspace-query");
+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 toolControlMcp = require("./tool-control-mcp-server");
+var capsuleFloor = require("./capsule-display-floor");
 var toolLlm = require("./tool-llm");
 // project-notifications is attached globally in server.js, passed via opts.notificationsModule
 
@@ -61,6 +67,10 @@ function createMateToolControlMcp(adapter, config) {
       var manifests = config.list(config.userId) || [];
       var tools = [];
       for (var i = 0; i < manifests.length; i++) {
+        // Skills go dark when the declarative Display floor does, so a Capsule
+        // the human cannot operate is never listed to a Mate either. The guard
+        // validates the Capsule's own Display tree, not a claim about it.
+        if (!capsuleFloor.hasUsableFloor(manifests[i])) continue;
         tools.push({
           id: manifests[i].id,
           name: manifests[i].name,
@@ -205,6 +215,7 @@ function createProjectContext(opts) {
   var updateChannel = opts.updateChannel || "stable";
   var osUsers = opts.osUsers || false;
   var projectOwnerId = opts.projectOwnerId || null;
+  var projectKnowledgeId = opts.projectKnowledgeId || null;
   var worktreeMeta = opts.worktreeMeta || null; // { parentSlug, branch, external }
   var isMate = opts.isMate || false;
   var mateId = opts.mateId || (isMate ? path.basename(cwd) : null);
@@ -395,6 +406,49 @@ function createProjectContext(opts) {
     }
   }
 
+  // Update version metadata goes only to admin-grade connections, and only to
+  // those not currently snoozing this exact version. Both decisions come from
+  // update-snooze.js; this loop owns nothing but the client set.
+  function broadcastUpdateAvailable(version) {
+    if (!version) return;
+    var now = Date.now();
+    var payload = JSON.stringify({ type: "update_available", version: version });
+    for (var ws of clients) {
+      if (ws.readyState !== 1) continue;
+      if (!updateSnooze.isUpdateAdmin(ws, usersModule)) continue;
+      var key = updateSnooze.userKeyFor(ws, usersModule);
+      if (updateSnooze.isSnoozed(key, version, now)) continue;
+      ws.send(payload);
+    }
+  }
+
+  // The install lifecycle frame. Every client needs it, because the daemon is
+  // about to restart and the UI blocks the screen — but only admin-grade
+  // connections get the version with it. Non-admins get the same frame minus
+  // the metadata, so behaviour is unchanged for them and nothing leaks.
+  function broadcastUpdateStarted(version) {
+    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;
+      ws.send(updateSnooze.isUpdateAdmin(ws, usersModule) ? withVersion : withoutVersion);
+    }
+  }
+
+  // Tell every live connection of one user that a snooze took effect, so the
+  // banner clears on their other devices too rather than only where it was
+  // dismissed. Scoped by the same server-derived key the snooze was stored
+  // under, never by anything in a payload.
+  function sendToUpdateUser(userKey, obj) {
+    if (!userKey) return;
+    var data = JSON.stringify(obj);
+    for (var ws of clients) {
+      if (ws.readyState !== 1) continue;
+      if (updateSnooze.userKeyFor(ws, usersModule) !== userKey) continue;
+      ws.send(data);
+    }
+  }
+
   function broadcastClientCount() {
     var msg = { type: "client_count", count: clients.size };
     if (usersModule.isMultiUser()) {
@@ -624,6 +678,31 @@ function createProjectContext(opts) {
     isMate: isMate,
     mateId: mateId,
   });
+  var _logFeedbackDelivery = attachProjectLogFeedbackDelivery({
+    sm: sm,
+    getSdk: function () { return sdk; },
+    onProcessingChanged: onProcessingChanged,
+    getLinuxUserForSession: getLinuxUserForSession,
+  });
+  var _projectLogs = attachProjectLogs({
+    service: opts.projectLogsService || null,
+    sm: sm,
+    projectSlug: slug,
+    getProjectOwnerId: function () { return projectOwnerId; },
+    isMate: isMate,
+    mateId: mateId,
+    sendTo: sendTo,
+    getClients: function () { return clients; },
+    onFeedback: _logFeedbackDelivery.deliver,
+  });
+  var _mateKnowledge = attachProjectMateKnowledge({
+    service: opts.mateKnowledgeService || null,
+    sm: sm,
+    projectSlug: slug,
+    getProjectOwnerId: function () { return projectOwnerId; },
+    isMate: isMate,
+    mateId: mateId,
+  });
 
   // The SDK bridge is created after local MCP servers. Session spawning uses
   // a getter so tool handlers see the initialized bridge when they run.
@@ -739,6 +818,27 @@ function createProjectContext(opts) {
       }
     }
 
+    // Project Logs. Project sessions get the project-scoped set; Mate projects
+    // get the read-only cross-project set only when the Mate registry confirms
+    // authoritative builtin Clay.
+    try {
+      var projectLogsMcpConfig = _projectLogs.createMcpServer(adapter, null);
+      if (projectLogsMcpConfig) servers[projectLogsMcpConfig.name || "clay-logs"] = projectLogsMcpConfig;
+    } catch (e) {
+      console.error("[project] Failed to create clay-logs MCP server:", e.message);
+    }
+
+    // Mate Knowledge. Mate projects only; the registry decides whether this is
+    // one Mate's own scope or authoritative Clay's cross-Mate read view.
+    if (isMate) {
+      try {
+        var mateKnowledgeMcpConfig = _mateKnowledge.createMcpServer(adapter, null);
+        if (mateKnowledgeMcpConfig) servers[mateKnowledgeMcpConfig.name || "clay-knowledge"] = mateKnowledgeMcpConfig;
+      } catch (e) {
+        console.error("[project] Failed to create clay-knowledge MCP server:", e.message);
+      }
+    }
+
     // Session-bound access to the source of a handoff (main projects only).
     if (!isMate) {
       try {
@@ -903,6 +1003,24 @@ function createProjectContext(opts) {
         }
         continue;
       }
+      if (name === "clay-logs" && forSession) {
+        try {
+          var boundLogs = _projectLogs.createMcpServer(adapter, forSession);
+          if (boundLogs) { filtered[name] = boundLogs; hasAny = true; }
+        } catch (e) {
+          console.error("[project] Failed to bind clay-logs MCP server:", e.message);
+        }
+        continue;
+      }
+      if (name === "clay-knowledge" && forSession) {
+        try {
+          var boundKnowledge = _mateKnowledge.createMcpServer(adapter, forSession);
+          if (boundKnowledge) { filtered[name] = boundKnowledge; hasAny = true; }
+        } catch (e) {
+          console.error("[project] Failed to bind clay-knowledge MCP server:", e.message);
+        }
+        continue;
+      }
       if (name === "clay-tools" && forSession) {
         try {
           var boundToolControl = createToolControlMcpServer();
@@ -992,6 +1110,9 @@ function createProjectContext(opts) {
     clayPort: serverPort,
     clayTls: serverTls,
     clayAuthToken: serverAuthToken,
+    getWorkerPermissionRouter: function () {
+      return isMate ? null : _sessionPair.workerPermission;
+    },
     onProcessingChanged: onProcessingChanged,
     onTurnDone: function (session, preview) {
       if (isMate) digestDmTurn(session, preview);
@@ -1021,6 +1142,8 @@ function createProjectContext(opts) {
         _sessionHandoff.getSystemPrompt(session),
         _sessionDocument.getSystemPrompt(session),
         _capsuleCatalog.getSystemPrompt(session),
+        _projectLogs.getSystemPrompt(session),
+        _mateKnowledge.getSystemPrompt(session),
       ]);
     },
     getRuntimeEnv: getRuntimeEnvForSession,
@@ -1035,7 +1158,9 @@ function createProjectContext(opts) {
         .concat(_debateProposal.getToolDefs(session))
         .concat(_mateCreationProposal.getToolDefs(session))
         .concat(_workspaceQuery.getDynamicToolDefs(session))
-        .concat(_workspaceQuery.getHistoryDynamicToolDefs(session));
+        .concat(_workspaceQuery.getHistoryDynamicToolDefs(session))
+        .concat(_projectLogs.getDynamicToolDefs(session))
+        .concat(_mateKnowledge.getDynamicToolDefs(session));
     },
   });
 
@@ -1081,7 +1206,7 @@ function createProjectContext(opts) {
     fetchVersion(updateChannel).then(function (v) {
       if (v && isNewer(v, currentVersion)) {
         latestVersion = v;
-        if (broadcast) sendToAdmins({ type: "update_available", version: v });
+        if (broadcast) broadcastUpdateAvailable(v);
       }
     }).catch(function (e) {
       console.error("[project] Background version check failed:", e.message || e);
@@ -1169,6 +1294,12 @@ function createProjectContext(opts) {
   }
 
   function handleMessage(ws, msg) {
+    // --- Keep-alive (delegated to project-connection.js) ---
+    // Answered before any routing so a ping can never be forwarded elsewhere.
+    // _connection is assigned later in this factory than the other modules, so
+    // the reference is guarded rather than assumed.
+    if (_connection && _connection.handleKeepaliveMessage(ws, msg)) return;
+
     if (ws._clayHomeDebateSlug && ws._clayHomeDebateSlug !== slug && /^debate_(hand_raise|comment|stop|conclude_response|user_floor_response)$/.test(msg.type || "") && opts.getProject) {
       var homeDebateCtx = opts.getProject(ws._clayHomeDebateSlug);
       if (homeDebateCtx) homeDebateCtx.handleMessage(ws, msg);
@@ -1188,11 +1319,11 @@ function createProjectContext(opts) {
       if (typeof opts.onDmMessage === "function") opts.onDmMessage(ws, msg);
       return;
     }
-    if (msg.type === "home_clay_ask" || msg.type === "home_clay_session_resolve") {
+    if (msg.type === "home_clay_ask" || msg.type === "home_clay_session_resolve" || msg.type === "home_clay_log_resolve") {
       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") {
+    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 (typeof opts.onDmMessage === "function") {
         opts.onDmMessage(ws, msg, slug);
       }
@@ -1266,6 +1397,9 @@ function createProjectContext(opts) {
     // --- Knowledge file management (delegated to project-knowledge.js) ---
     if (_knowledge.handleKnowledgeMessage(ws, msg)) return;
 
+    // --- Project Logs (delegated to project-logs.js) ---
+    if (_projectLogs.handleLogsMessage(ws, msg)) return;
+
     // --- Notifications (delegated to project-notifications.js) ---
     if (_notifications.handleNotificationMessage(ws, msg)) return;
 
@@ -1468,6 +1602,9 @@ function createProjectContext(opts) {
     send: send,
     sendTo: sendTo,
     sendToAdmins: sendToAdmins,
+    broadcastUpdateAvailable: broadcastUpdateAvailable,
+    broadcastUpdateStarted: broadcastUpdateStarted,
+    sendToUpdateUser: sendToUpdateUser,
     sendToSession: sendToSession,
     sendToSessionOthers: sendToSessionOthers,
     opts: opts,
@@ -1477,6 +1614,7 @@ function createProjectContext(opts) {
     matesModule: matesModule,
     pushModule: pushModule,
     getSessionForWs: getSessionForWs,
+    onHumanPairStop: function (session) { return _sessionPair.handleHumanStop(session); },
     getLinuxUserForSession: getLinuxUserForSession,
     ensureProjectAccessForSession: ensureProjectAccessForSession,
     getOsUserInfoForWs: getOsUserInfoForWs,
@@ -1530,6 +1668,16 @@ function createProjectContext(opts) {
       return _models.resolveConfiguredModel({ _clayUser: user || null }, "standard");
     },
   });
+  var _capsuleTurn = attachCapsuleTurn({
+    sm: sm,
+    getSdk: function () { return sdk; },
+    getLinuxUserForSession: getLinuxUserForSession,
+    isMultiUser: function () { return usersModule.isMultiUser(); },
+    resolveModel: function (principal) {
+      var user = principal && principal.userId ? usersModule.findUserById(principal.userId) : null;
+      return _models.resolveConfiguredModel({ _clayUser: user || null }, "standard");
+    },
+  });
   var _delegatedFollowUp = attachDelegatedFollowUp({
     sm: sm,
     getSdk: function () { return sdk; },
@@ -1546,6 +1694,13 @@ function createProjectContext(opts) {
 
   // --- User message handler (delegated to project-user-message.js) ---
   var _userMessage = attachUserMessage({
+    // Exact live pair state decides whether a session is Driver-operated; the
+    // handler never infers the role from the message.
+    isDriverOperatedSession: function (session) {
+      if (isMate || !_sessionPair.workerPermission) return false;
+      return _sessionPair.workerPermission.isDriverOperated(session);
+    },
+    beginHumanPairTurn: function (session) { return _sessionPair.beginHumanTurn(session); },
     cwd: cwd,
     slug: slug,
     isMate: isMate,
@@ -1610,6 +1765,7 @@ function createProjectContext(opts) {
     getOsUserInfoForWs: getOsUserInfoForWs,
     getOsUserInfoForLinuxUser: getOsUserInfoForLinuxUser,
     getLinuxUserForSession: getLinuxUserForSession,
+    refreshVendorAuthEverywhere: opts.refreshVendorAuthEverywhere,
   });
 
   // --- Filesystem handler (delegated to project-filesystem.js) ---
@@ -1733,6 +1889,10 @@ function createProjectContext(opts) {
           for (var wqti = 0; wqti < workspaceTools.length; wqti++) tools.push(workspaceTools[wqti]);
           var historyTools = _workspaceQuery.getHistoryBridgeTools(boundSession, normalizeToolSchema);
           for (var cht = 0; cht < historyTools.length; cht++) tools.push(historyTools[cht]);
+          var logsTools = _projectLogs.getBridgeTools(boundSession, normalizeToolSchema);
+          for (var plti = 0; plti < logsTools.length; plti++) tools.push(logsTools[plti]);
+          var knowledgeTools = _mateKnowledge.getBridgeTools(boundSession, normalizeToolSchema);
+          for (var mkti = 0; mkti < knowledgeTools.length; mkti++) tools.push(knowledgeTools[mkti]);
         }
 
         if (sessionOnly) return Promise.resolve(tools);
@@ -1748,7 +1908,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") continue;
+            if (inAppNames[i] === "clay-debate" || inAppNames[i] === "clay-mate-creation" || inAppNames[i] === "clay-workspace" || inAppNames[i] === "clay-history" || inAppNames[i] === "clay-logs" || inAppNames[i] === "clay-knowledge") continue;
             extractServerTools(inAppNames[i], localMcp[inAppNames[i]]);
           }
         }
@@ -1811,7 +1971,13 @@ function createProjectContext(opts) {
         if (boundSession && serverName === "clay-history") {
           return _workspaceQuery.callHistoryBridgeTool(boundSession, toolName, args);
         }
-        if (serverName === "clay-sessions" || serverName === "clay-notes" || serverName === "clay-handoff" || serverName === "clay-documents" || serverName === "clay-debate" || serverName === "clay-mate-creation" || serverName === "clay-workspace" || serverName === "clay-history") {
+        if (boundSession && serverName === "clay-logs") {
+          return _projectLogs.callBridgeTool(boundSession, toolName, args);
+        }
+        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-debate" || serverName === "clay-mate-creation" || serverName === "clay-workspace" || serverName === "clay-history" || serverName === "clay-logs" || serverName === "clay-knowledge") {
           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));
@@ -2023,6 +2189,7 @@ function createProjectContext(opts) {
       isProcessing: hasProcessing,
       pendingPermissions: pendingPermCount,
       projectOwnerId: projectOwnerId,
+      projectKnowledgeId: projectKnowledgeId,
     };
     if (isMate) {
       status.isMate = true;
@@ -2032,6 +2199,9 @@ function createProjectContext(opts) {
       status.isWorktree = true;
       status.parentSlug = worktreeMeta.parentSlug;
       status.branch = worktreeMeta.branch;
+      status.changeSetId = worktreeMeta.changeSetId || null;
+      status.baseCommit = worktreeMeta.baseCommit || null;
+      status.headCommit = worktreeMeta.headCommit || null;
       status.worktreeExternal = worktreeMeta.external === true;
     }
     if (usersModule.isMultiUser()) {
@@ -2130,6 +2300,7 @@ function createProjectContext(opts) {
     createDelegatedSession: _delegatedSession.createDelegatedSession,
     inspectDelegatedFollowUp: _delegatedFollowUp.inspectDelegatedFollowUp,
     dispatchDelegatedFollowUp: _delegatedFollowUp.dispatchDelegatedFollowUp,
+    deliverCapsuleTurn: _capsuleTurn.deliverCapsuleTurn,
     unregisterHomeDebateClient: function (ws) { homeDebateClients.delete(ws); },
     handleHomeDebateProposalResponse: function (ws, msg, session) { return _debateProposal.handleHomeMessage(ws, msg, session); },
     handleHomeMateCreationProposalResponse: function (ws, msg, session) { return _mateCreationProposal.handleHomeMessage(ws, msg, session); },
@@ -2141,6 +2312,7 @@ function createProjectContext(opts) {
     listKnowledgeFiles: _knowledge.listKnowledgeFiles,
     refreshCapsuleCatalog: _capsuleCatalog.refreshSessions,
     getNotificationsModule: function () { return _notifications; },
+    refreshVendorAuth: _vendorLogin.refreshVendorAuth,
     getSchedules: _loop.getSchedules,
     importSchedule: _loop.importSchedule,
     removeSchedule: _loop.removeSchedule,

package/lib/public/app.js

@@ -1,5 +1,5 @@
 import { avatarUrl, userAvatarUrl, mateAvatarUrl } from './modules/avatar.js';
-import { showToast, copyToClipboard, escapeHtml } from './modules/utils.js';
+import { showToast, escapeHtml } from './modules/utils.js';
 import { refreshIcons, iconHtml } from './modules/icons.js';
 import { renderMarkdown, highlightCodeBlocks, renderMermaidBlocks, closeMermaidModal, parseEmojis } from './modules/markdown.js';
 import { initSidebar, updatePageTitle, spawnDustParticles } from './modules/sidebar.js';
@@ -27,9 +27,11 @@ import { initInput, clearPendingImages, handleInputSync, autoResize, builtinComm
 import { initQrCode, triggerShare } from './modules/qrcode.js';
 import { initFileBrowser, loadRootDirectory, refreshTree, handleFsList, handleFsRead, handleDirChanged, refreshIfOpen, handleFileChanged, handleFileHistory, handleGitDiff, handleFileAt, getPendingNavigate, closeFileViewer, resetFileBrowser } from './modules/filebrowser.js';
 import { initGitPanel } from './modules/git-panel.js';
+import { initWorkerPaneLock } from './modules/worker-pane-lock.js';
 import { initTerminal, openTerminal, closeTerminal, resetTerminals, handleTermList, handleTermCreated, handleTermOutput, handleTermResized, handleTermExited, handleTermClosed, sendTerminalCommand } from './modules/terminal.js';
 import { initContextSources, updateTerminalList, updateBrowserTabList, handleContextSourcesState, getActiveSources, hasActiveSources } from './modules/context-sources.js';
-import { initStickyNotes, handleNotesList, handleNoteCreated, handleNoteUpdated, handleNoteDeleted, openArchive, closeArchive, isArchiveOpen, hideNotes, showNotes, isNotesVisible, createNote } from './modules/sticky-notes.js';
+import { initStickyNotes, handleNotesList, handleNoteCreated, handleNoteUpdated, handleNoteDeleted, hideNotes, showNotes, isNotesVisible, createNote, setBrowserRefresh } from './modules/sticky-notes.js';
+import { initNotesBrowser, openNotesBrowser, closeNotesBrowser, isNotesBrowserOpen, renderNotesBrowser, registerExclusiveClosers } 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';
@@ -42,6 +44,7 @@ import { initSTT } from './modules/stt.js';
 import { initProfile, getProfileLang } from './modules/profile.js';
 import { initUserSettings } from './modules/user-settings.js';
 import { initToolPalettes } from './modules/tool-palette.js';
+import { initProjectLogs, closeProjectLogs } from './modules/project-logs.js';
 import { initProjectSwitcher } from './modules/project-switcher.js';
 import { initSplitView } from './modules/split-view.js';
 import { initPaneBridge } from './modules/pane-bridge.js';
@@ -64,7 +67,8 @@ import { initCursors, handleRemoteCursorMove as _curHandleRemoteCursorMove, hand
 import { initFavicon, updateFavicon as _favUpdateFavicon, setSendBtnMode as _favSetSendBtnMode, blinkIO as _favBlinkIO, blinkSessionDot as _favBlinkSessionDot, updateCrossProjectBlink as _favUpdateCrossProjectBlink, startUrgentBlink as _favStartUrgentBlink, stopUrgentBlink as _favStopUrgentBlink, setActivity as _favSetActivity } from './modules/app-favicon.js';
 import { initHeader, closeSessionInfoPopover as _hdrCloseSessionInfoPopover, updateHistorySentinel as _hdrUpdateHistorySentinel, requestMoreHistory as _hdrRequestMoreHistory, prependOlderHistory as _hdrPrependOlderHistory } from './modules/app-header.js';
 import { initSessionActions } from './modules/session-actions.js';
-import { initMisc, flushPendingExtMessages, showImageModal as _miscShowImageModal, closeImageModal as _miscCloseImageModal, showPasteModal as _miscShowPasteModal, closePasteModal as _miscClosePasteModal, showConfirm as _miscShowConfirm, hideConfirm as _miscHideConfirm, showForceChangePinOverlay as _miscShowForceChangePinOverlay, sendExtensionCommand as _miscSendExtensionCommand, handleExtensionResult as _miscHandleExtensionResult } from './modules/app-misc.js';
+import { initMisc, flushPendingExtMessages, showImageModal as _miscShowImageModal, closeImageModal as _miscCloseImageModal, showConfirm as _miscShowConfirm, hideConfirm as _miscHideConfirm, showForceChangePinOverlay as _miscShowForceChangePinOverlay, sendExtensionCommand as _miscSendExtensionCommand, handleExtensionResult as _miscHandleExtensionResult } from './modules/app-misc.js';
+import { showPasteModal } from './modules/paste-modal.js';
 import { initSkillInstall, requireSkills as _siRequireSkills, handleSkillInstallWs as _siHandleSkillInstallWs } from './modules/app-skills-install.js';
 import { initDebateUi, showDebateConcludeConfirm as _debShowDebateConcludeConfirm, exitDebateConcludeMode as _debExitDebateConcludeMode, handleDebateConcludeSend as _debHandleDebateConcludeSend, showDebateEndedMode as _debShowDebateEndedMode, exitDebateEndedMode as _debExitDebateEndedMode, showDebateUserFloor as _debShowDebateUserFloor, exitDebateFloorMode as _debExitDebateFloorMode, handleDebateFloorSend as _debHandleDebateFloorSend, renderDebateUserFloorDone as _debRenderDebateUserFloorDone, showDebateSticky as _debShowDebateSticky, showDebateBottomBar as _debShowDebateBottomBar, removeDebateBottomBar as _debRemoveDebateBottomBar, sendDebateStickyComment as _debSendDebateStickyComment, updateDebateRound as _debUpdateDebateRound } from './modules/app-debate-ui.js';
 import { initLoopUi, updateLoopInputVisibility as _loopUpdateLoopInputVisibility, updateLoopButton as _loopUpdateLoopButton, showLoopBanner as _loopShowLoopBanner, updateLoopBanner as _loopUpdateLoopBanner, updateRalphBars as _loopUpdateRalphBars, showRalphCraftingBar as _loopShowRalphCraftingBar, showRalphApprovalBar as _loopShowRalphApprovalBar, updateRalphApprovalStatus as _loopUpdateRalphApprovalStatus, openRalphPreviewModal as _loopOpenRalphPreviewModal, showExecModal as _loopShowExecModal, closeExecModal as _loopCloseExecModal, updateExecModalStatus as _loopUpdateExecModalStatus } from './modules/app-loop-ui.js';
@@ -203,16 +207,6 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
   }
 
   // Modal close handlers (replaces inline onclick)
-  $("paste-modal").querySelector(".confirm-backdrop").addEventListener("click", function() {
-    $("paste-modal").classList.add("hidden");
-  });
-  $("paste-modal").querySelector(".paste-modal-close").addEventListener("click", function() {
-    $("paste-modal").classList.add("hidden");
-  });
-  $("paste-modal").querySelector(".paste-modal-copy").addEventListener("click", function() {
-    var body = $("paste-modal-body");
-    if (body) copyToClipboard(body.textContent, "Copied to clipboard");
-  });
   $("mermaid-modal").querySelector(".confirm-backdrop").addEventListener("click", closeMermaidModal);
   $("mermaid-modal").querySelector(".mermaid-modal-btn[title='Close']").addEventListener("click", closeMermaidModal);
   $("image-modal").querySelector(".confirm-backdrop").addEventListener("click", closeImageModal);
@@ -260,9 +254,7 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
   // --- Header session rename, session info popover -> modules/app-header.js
   function closeSessionInfoPopover() { _hdrCloseSessionInfoPopover(); }
 
-  // --- Modals (confirm, paste) -> modules/app-misc.js
-  function showPasteModal(text) { _miscShowPasteModal(text); }
-  function closePasteModal() { _miscClosePasteModal(); }
+  // --- Confirmation modal -> modules/app-misc.js
   function showConfirm(text, onConfirm, okLabel, destructive) { _miscShowConfirm(text, onConfirm, okLabel, destructive); }
   function hideConfirm() { _miscHideConfirm(); }
 
@@ -297,6 +289,7 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     isHeadlessMode: false,
     savedMainSlug: null,
     connected: false,
+    pendingOutboundMessages: [],
     homeChatMateId: null,
     homeChatSessionId: null,
     homeChatSessionModel: null,
@@ -327,7 +320,27 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     dockWidth: null,
     dockHasActivity: false,
     dockActivityToolId: null,
+    projectLogsOpen: false,
+    projectLogsWide: false,
+    projectLogsFullscreen: false,
+    projectLogsEntries: [],
+    projectLogsSelectedRef: null,
+    projectLogsView: 'list',
+    projectLogsCategory: '',
+    projectLogsContextMode: '',
+    projectLogsIsWorktree: false,
+    projectLogsListScroll: 0,
+    projectLogsListRequestId: null,
+    projectLogsReadRequestId: null,
+    projectLogsCommentRequestId: null,
+    projectLogsCommentStatusEl: null,
+    projectLogsDeleteRequestId: null,
+    projectLogsCanDelete: false,
+    projectLogsUnread: 0,
+    projectLogsSeenRevisions: {},
     installedTools: [],
+    capsulesEnabled: false,
+    capsulesPreferenceLoaded: false,
     homeToolRegistryLoaded: false,
     toolScanErrors: [],
 
@@ -480,6 +493,7 @@ 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();
   initSidebar(sidebarCtx);
   var wsGetter = function () { return _getWsRef(); };
   initMateSidebar(wsGetter);
@@ -772,7 +786,7 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     if (isHomeHubVisible()) hideHomeHub();
     if (newSlug && newSlug !== store.get('currentSlug')) {
       resetFileBrowser();
-      closeArchive();
+      closeNotesBrowser();
       if (isSchedulerOpen()) closeScheduler();
       resetScheduler(newSlug);
       store.set({ currentSlug: newSlug });
@@ -944,8 +958,8 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
       if (!_perms.fileBrowser) {
         var fbBtn = document.getElementById("file-browser-btn");
         if (fbBtn) fbBtn.style.display = "none";
-        var gitBtn = document.getElementById("git-sidebar-btn");
-        if (gitBtn) gitBtn.style.display = "none";
+        var gitPlacardEl = document.getElementById("git-placard");
+        if (gitPlacardEl) gitPlacardEl.style.display = "none";
       }
       if (!_perms.skills) {
         var sBtn = document.getElementById("skills-btn");
@@ -954,10 +968,10 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
         if (msBtn) msBtn.style.display = "none";
       }
       if (!_perms.scheduledTasks) {
-        var schBtn = document.getElementById("scheduler-btn");
+        var schBtn = document.getElementById("home-scheduler-btn");
         if (schBtn) schBtn.style.display = "none";
-        var mateSchBtn = document.getElementById("mate-scheduler-btn");
-        if (mateSchBtn) mateSchBtn.style.display = "none";
+        var schToolBtn = document.getElementById("scheduler-btn");
+        if (schToolBtn) schToolBtn.style.display = "none";
       }
       if (!_perms.createProject) {
         var addProjBtn = document.getElementById("icon-strip-add");
@@ -1036,6 +1050,7 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     fileViewerEl: $("file-viewer"),
   });
   initGitPanel();
+  initWorkerPaneLock();
 
   // --- Terminal ---
   initTerminal({
@@ -1088,17 +1103,24 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
   }
 
   // --- Sticky Notes ---
-  initStickyNotes({
-    get ws() { return _getWsRef(); },
-    get connected() { return store.get('connected'); },
-  });
+  // The canvas reads the socket from ws-ref and the connection flag from the
+  // store directly, so it needs no injected context.
+  initStickyNotes();
+  initNotesBrowser();
+  // The browser refreshes from note messages without the canvas module having
+  // to import it, which would be a cycle.
+  setBrowserRefresh(function () { if (isNotesBrowserOpen()) renderNotesBrowser(); });
+  // Opening the browser claims the single right workbench slot. Registered here
+  // so the browser module never imports the other tools.
+  registerExclusiveClosers([closeProjectLogs, closeScheduler, closeFileViewer, closeTerminal]);
 
   // --- Sticky Notes sidebar button (create new note) ---
   var stickyNotesSidebarBtn = $("sticky-notes-sidebar-btn");
   if (stickyNotesSidebarBtn) {
     stickyNotesSidebarBtn.addEventListener("click", function () {
+      closeProjectLogs();
       if (isSchedulerOpen()) closeScheduler();
-      if (isArchiveOpen()) closeArchive();
+      if (isNotesBrowserOpen()) closeNotesBrowser();
       showNotes();
       createNote();
     });
@@ -1109,22 +1131,23 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
   if (stickyNotesBadge) {
     stickyNotesBadge.addEventListener("click", function (e) {
       e.stopPropagation();
+      closeProjectLogs();
       if (isSchedulerOpen()) closeScheduler();
-      if (isArchiveOpen()) {
-        closeArchive();
+      if (isNotesBrowserOpen()) {
+        closeNotesBrowser();
       } else {
-        openArchive();
+        openNotesBrowser();
       }
     });
   }
 
-  // Close archive / scheduler panel when switching to other sidebar panels
+  // Close the notes browser / scheduler panel when switching to other sidebar panels
   var fileBrowserBtn = $("file-browser-btn");
-  var gitSidebarBtn = $("git-sidebar-btn");
+  var gitPlacardMoreBtn = $("git-placard-more");
   var terminalSidebarBtn = $("terminal-sidebar-btn");
-  if (fileBrowserBtn) fileBrowserBtn.addEventListener("click", function () { if (isArchiveOpen()) closeArchive(); if (isSchedulerOpen()) closeScheduler(); });
-  if (gitSidebarBtn) gitSidebarBtn.addEventListener("click", function () { if (isArchiveOpen()) closeArchive(); if (isSchedulerOpen()) closeScheduler(); });
-  if (terminalSidebarBtn) terminalSidebarBtn.addEventListener("click", function () { if (isArchiveOpen()) closeArchive(); if (isSchedulerOpen()) closeScheduler(); });
+  if (fileBrowserBtn) fileBrowserBtn.addEventListener("click", function () { closeProjectLogs(); if (isNotesBrowserOpen()) closeNotesBrowser(); if (isSchedulerOpen()) closeScheduler(); });
+  if (gitPlacardMoreBtn) gitPlacardMoreBtn.addEventListener("click", function () { closeProjectLogs(); if (isNotesBrowserOpen()) closeNotesBrowser(); if (isSchedulerOpen()) closeScheduler(); });
+  if (terminalSidebarBtn) terminalSidebarBtn.addEventListener("click", function () { closeProjectLogs(); if (isNotesBrowserOpen()) closeNotesBrowser(); if (isSchedulerOpen()) closeScheduler(); });
 
   // --- Ralph Loop UI (delegated to app-loop-ui.js + app-loop-wizard.js) ---
   function updateLoopInputVisibility(loop) { _loopUpdateLoopInputVisibility(loop); }

package/lib/public/css/admin.css

@@ -651,7 +651,7 @@
 }
 
 /* --- Session visibility indicator --- */
-.session-private-icon {
+.session-shared-icon {
   display: inline-flex;
   align-items: center;
   margin-right: 4px;
@@ -659,7 +659,7 @@
   vertical-align: middle;
 }
 
-.session-private-icon svg {
+.session-shared-icon svg {
   width: 12px;
   height: 12px;
 }