clay-server 4.0.0-beta.16 → 4.0.0-beta.18

package/lib/public/modules/project-logs.js

@@ -6,9 +6,9 @@
 // record, and Back returns to the list with the query, filter, and scroll
 // position intact.
 //
-// People read and comment. Canonical entries are created and revised only by
-// this project's agent sessions through the clay-logs MCP tools, so this
-// module has no create or edit affordance at all.
+// People read and comment, and project owners may delete. Canonical entries
+// are created and revised only by this project's agent sessions through the
+// clay-logs MCP tools, so this module has no create or edit affordance.
 
 import { store } from './store.js';
 import { getWs } from './ws-ref.js';
@@ -18,14 +18,17 @@ import { closeScheduler } from './scheduler.js';
 import { closeNotesBrowser } from './sticky-notes-browser.js';
 import { closeFileViewer } from './filebrowser.js';
 import { closeTerminal } from './terminal.js';
-import { renderFilter, renderList, renderDetail } from './project-logs-render.js';
+import { renderFilter, renderContextFilter, renderList, renderDetail } from './project-logs-render.js';
 
 var panel = null;
 var listEl = null;
 var detailEl = null;
 var searchEl = null;
 var filterEl = null;
+var contextFilterEl = null;
 var backBtn = null;
+var deleteDialog = null;
+var pendingDeleteEntry = null;
 var searchTimer = null;
 var requestCounter = 0;
 
@@ -93,17 +96,32 @@ function ensurePanel() {
     '</header>' +
     '<div id="project-logs-toolbar" class="project-logs-toolbar">' +
       '<label class="project-logs-search"><i data-lucide="search"></i><input id="project-logs-search" type="search" placeholder="Search logs" autocomplete="off"></label>' +
+      '<div id="project-logs-context-filter-slot"></div>' +
       '<div id="project-logs-filter-slot"></div>' +
     '</div>' +
     '<div id="project-logs-list" class="project-logs-list" role="list"></div>' +
-    '<main id="project-logs-detail" class="project-logs-detail hidden"></main>';
+    '<main id="project-logs-detail" class="project-logs-detail hidden"></main>' +
+    '<div id="project-log-delete-dialog" class="project-log-delete-dialog hidden" role="dialog" aria-modal="true" aria-labelledby="project-log-delete-heading">' +
+      '<div class="project-log-delete-dialog-card">' +
+        '<h2 id="project-log-delete-heading">Delete this log?</h2>' +
+        '<p>This removes the entry from the project ledger. It cannot be restored in the app.</p>' +
+        '<p class="project-log-delete-dialog-title"></p>' +
+        '<p class="project-log-delete-dialog-status" role="status"></p>' +
+        '<div class="project-log-delete-dialog-actions">' +
+          '<button type="button" data-action="cancel">Cancel</button>' +
+          '<button type="button" class="danger" data-action="delete">Delete log</button>' +
+        '</div>' +
+      '</div>' +
+    '</div>';
   panels.appendChild(panel);
 
   listEl = panel.querySelector("#project-logs-list");
   detailEl = panel.querySelector("#project-logs-detail");
   searchEl = panel.querySelector("#project-logs-search");
   filterEl = panel.querySelector("#project-logs-filter-slot");
+  contextFilterEl = panel.querySelector("#project-logs-context-filter-slot");
   backBtn = panel.querySelector("#project-logs-back");
+  deleteDialog = panel.querySelector("#project-log-delete-dialog");
 
   panel.querySelector("#project-logs-close").addEventListener("click", closeProjectLogs);
   backBtn.addEventListener("click", showList);
@@ -117,6 +135,14 @@ function ensurePanel() {
     if (searchTimer) clearTimeout(searchTimer);
     searchTimer = setTimeout(requestList, 180);
   });
+  deleteDialog.querySelector('[data-action="cancel"]').addEventListener("click", closeDeleteDialog);
+  deleteDialog.querySelector('[data-action="delete"]').addEventListener("click", confirmDelete);
+  deleteDialog.addEventListener("click", function (event) {
+    if (event.target === deleteDialog) closeDeleteDialog();
+  });
+  deleteDialog.addEventListener("keydown", function (event) {
+    if (event.key === "Escape") closeDeleteDialog();
+  });
   refreshIcons();
 }
 
@@ -159,7 +185,48 @@ function showDetail(entry) {
   detailEl.classList.remove("hidden");
   detailEl.scrollTop = 0;
   backBtn.classList.remove("hidden");
-  renderDetail(detailEl, entry, { onComment: submitComment });
+  renderDetail(detailEl, entry, {
+    onComment: submitComment,
+    onDelete: openDeleteDialog,
+    canDelete: store.get('projectLogsCanDelete') === true,
+  });
+}
+
+function openDeleteDialog(entry) {
+  if (!deleteDialog || !entry || store.get('projectLogsCanDelete') !== true) return;
+  pendingDeleteEntry = entry;
+  deleteDialog.querySelector(".project-log-delete-dialog-title").textContent = entry.title || "Untitled log";
+  deleteDialog.querySelector(".project-log-delete-dialog-status").textContent = "";
+  deleteDialog.querySelector('[data-action="delete"]').disabled = false;
+  deleteDialog.querySelector('[data-action="cancel"]').disabled = false;
+  deleteDialog.classList.remove("hidden");
+  deleteDialog.querySelector('[data-action="cancel"]').focus();
+}
+
+function closeDeleteDialog(force) {
+  if (!deleteDialog) return;
+  if (!force && store.get('projectLogsDeleteRequestId')) return;
+  deleteDialog.classList.add("hidden");
+  pendingDeleteEntry = null;
+  store.set({ projectLogsDeleteRequestId: null });
+}
+
+function confirmDelete() {
+  if (!pendingDeleteEntry || !deleteDialog) return;
+  var requestId = nextRequestId("delete-log");
+  var status = deleteDialog.querySelector(".project-log-delete-dialog-status");
+  var button = deleteDialog.querySelector('[data-action="delete"]');
+  var cancelButton = deleteDialog.querySelector('[data-action="cancel"]');
+  store.set({ projectLogsDeleteRequestId: requestId });
+  button.disabled = true;
+  cancelButton.disabled = true;
+  status.textContent = "Deleting...";
+  if (!send({ type: "project_log_delete", requestId: requestId, ref: pendingDeleteEntry.ref })) {
+    button.disabled = false;
+    cancelButton.disabled = false;
+    store.set({ projectLogsDeleteRequestId: null });
+    status.textContent = "Logs are unavailable while disconnected.";
+  }
 }
 
 // --- Requests ------------------------------------------------------------
@@ -176,6 +243,7 @@ function requestList() {
     requestId: requestId,
     query: searchEl ? searchEl.value.trim() : "",
     category: store.get('projectLogsCategory') || "",
+    contextMode: store.get('projectLogsContextMode') || "",
   })) {
     if (listEl) {
       listEl.removeAttribute("aria-busy");
@@ -206,6 +274,11 @@ function applyFilter(category) {
   requestList();
 }
 
+function applyContextFilter(contextMode) {
+  store.set({ projectLogsContextMode: contextMode || "project" });
+  requestList();
+}
+
 // --- Lifecycle -----------------------------------------------------------
 
 export function initProjectLogs() {
@@ -227,10 +300,14 @@ export function initProjectLogs() {
       projectLogsSelectedRef: null,
       projectLogsView: "list",
       projectLogsCategory: "",
+      projectLogsContextMode: "",
+      projectLogsIsWorktree: false,
       projectLogsListScroll: 0,
       projectLogsListRequestId: null,
       projectLogsReadRequestId: null,
       projectLogsCommentRequestId: null,
+      projectLogsDeleteRequestId: null,
+      projectLogsCanDelete: false,
       projectLogsUnread: 0,
       projectLogsSeenRevisions: {}
     });
@@ -259,11 +336,19 @@ export function openProjectLogs() {
   requestList();
 }
 
+export function openProjectLog(ref) {
+  if (typeof ref !== "string" || !/^log:[A-Za-z0-9_-]{24}$/.test(ref)) return false;
+  openProjectLogs();
+  requestEntry(ref);
+  return true;
+}
+
 export function closeProjectLogs() {
   if (!store.get('projectLogsOpen')) return;
   if (panel) {
     panel.classList.add("hidden");
   }
+  closeDeleteDialog(true);
   // Fullscreen is always dropped on close so the next open is a bounded pane
   // and never silently hides the conversation.
   applyWindowState(store.get('projectLogsWide'), false);
@@ -276,21 +361,31 @@ export function closeProjectLogs() {
 
 export function handleProjectLogsState(msg) {
   if (msg.requestId && msg.requestId !== store.get('projectLogsListRequestId')) return;
-  store.set({ projectLogsEntries: msg.entries || [] });
+  var contextMode = msg.contextMode || store.get('projectLogsContextMode') || (msg.isWorktree ? "current" : "project");
+  store.set({
+    projectLogsEntries: msg.entries || [],
+    projectLogsCanDelete: msg.canDelete === true,
+    projectLogsContextMode: contextMode,
+    projectLogsIsWorktree: msg.isWorktree === true,
+  });
   if (!listEl) return;
   listEl.removeAttribute("aria-busy");
   if (filterEl && Array.isArray(msg.categories)) {
     renderFilter(filterEl, msg.categories, store.get('projectLogsCategory'), applyFilter);
   }
-  var isFiltered = !!((searchEl && searchEl.value.trim()) || store.get('projectLogsCategory'));
+  if (contextFilterEl) {
+    renderContextFilter(contextFilterEl, contextMode, msg.isWorktree === true, applyContextFilter);
+  }
+  var isFiltered = !!((searchEl && searchEl.value.trim()) || store.get('projectLogsCategory') || contextMode !== "project");
   renderList(listEl, msg.entries || [], requestEntry,
-    isFiltered ? "No entries match this search or category." : "No logs yet. This project's agent sessions record decisions and work here.");
+    isFiltered ? "No entries match the current scope, search, or category." : "No logs yet. This project's agent sessions record decisions and work here.");
   if (store.get('projectLogsView') !== "detail") listEl.scrollTop = store.get('projectLogsListScroll') || 0;
 }
 
 export function handleProjectLogEntry(msg) {
   if (msg.requestId && msg.requestId !== store.get('projectLogsReadRequestId')) return;
   if (!msg.entry) return;
+  store.set({ projectLogsCanDelete: msg.canDelete === true });
   showDetail(msg.entry);
 }
 
@@ -300,18 +395,45 @@ export function handleProjectLogCommented(msg) {
   // The comment is a proposal, not a change, so say so plainly rather than
   // leaving the composer reading "Posting..." forever.
   var pendingStatus = store.get('projectLogsCommentStatusEl');
-  if (pendingStatus) pendingStatus.textContent = "Awaiting Project Driver review";
+  if (pendingStatus) pendingStatus.textContent = msg.reviewQueued
+    ? "Project Driver is reviewing..."
+    : "Awaiting Project Driver review";
   store.set({ projectLogsCommentStatusEl: null });
   // Re-render the open entry so the new comment and its attribution appear,
   // then refresh the ledger so the comment count is current.
   showDetail(msg.entry);
+  if (msg.reviewQueued && detailEl) {
+    var badges = detailEl.querySelectorAll(".project-log-comment-status-badge");
+    if (badges.length > 0) badges[badges.length - 1].textContent = "Project Driver is reviewing";
+  }
+  requestList();
+}
+
+export function handleProjectLogCommentReviewed(msg) {
+  if (!msg || !msg.ref || !store.get('projectLogsOpen')) return;
+  if (store.get('projectLogsView') === "detail" && msg.ref === store.get('projectLogsSelectedRef')) {
+    requestEntry(msg.ref);
+    return;
+  }
+  requestList();
+}
+
+export function handleProjectLogDeleted(msg) {
+  if (msg.requestId && msg.requestId !== store.get('projectLogsDeleteRequestId')) return;
+  closeDeleteDialog(true);
+  showList();
   requestList();
+  showToast("Log deleted.");
 }
 
 // A canonical revision landed. This marks the explicit button only; it never
 // opens, reveals, focuses, or scrolls the pane.
 export function handleProjectLogUpdated(msg) {
   noteCanonicalUpdate(msg);
+  if (msg.op === "delete" && msg.ref === store.get('projectLogsSelectedRef')) {
+    closeDeleteDialog(true);
+    showList();
+  }
   // Refresh the ledger only when it is already on screen, so the row moves to
   // the top the moment its canonical update arrives.
   if (store.get('projectLogsOpen') && store.get('projectLogsView') !== "detail") requestList();
@@ -321,12 +443,19 @@ export function handleProjectLogsError(msg) {
   var pending = [
     store.get('projectLogsListRequestId'),
     store.get('projectLogsReadRequestId'),
-    store.get('projectLogsCommentRequestId')
+    store.get('projectLogsCommentRequestId'),
+    store.get('projectLogsDeleteRequestId')
   ];
   if (msg.requestId && pending.indexOf(msg.requestId) === -1) return;
   if (msg.requestId && msg.requestId === store.get('projectLogsListRequestId') && listEl) {
     listEl.removeAttribute("aria-busy");
     renderList(listEl, [], requestEntry, "The ledger could not be loaded. Try opening Logs again.");
   }
+  if (msg.requestId && msg.requestId === store.get('projectLogsDeleteRequestId') && deleteDialog) {
+    store.set({ projectLogsDeleteRequestId: null });
+    deleteDialog.querySelector('[data-action="delete"]').disabled = false;
+    deleteDialog.querySelector('[data-action="cancel"]').disabled = false;
+    deleteDialog.querySelector(".project-log-delete-dialog-status").textContent = msg.message || "The log could not be deleted.";
+  }
   showToast(msg.message || "Project Logs could not complete the request.", "error");
 }

package/lib/public/modules/sidebar-session-hierarchy.js

@@ -55,6 +55,10 @@ export function hierarchyItemMatches(item, matchIds) {
   return true;
 }
 
+export function isDesktopHierarchyToggleEvent(event) {
+  return !!(event && event.target && typeof event.target.closest === "function" && event.target.closest(".session-driver-toggle"));
+}
+
 function expanded(surface, key, workers, matchIds) {
   var state = expansionBySurface[surface];
   if (state.has(key)) return state.get(key);
@@ -93,20 +97,25 @@ export function renderDesktopDriverHierarchy(root, renderSession, rerender, matc
   control.setAttribute("aria-controls", childrenId);
   control.setAttribute("aria-label", (isExpanded ? "Collapse" : "Expand") + " Workers for " + (root.driver.title || "New Session"));
   control.innerHTML = iconHtml("chevron-right");
+  var children = document.createElement("div");
+  children.id = childrenId;
+  children.className = "session-worker-children";
+  children.setAttribute("role", "group");
+  children.setAttribute("aria-label", "Workers for " + (root.driver.title || "New Session"));
+  children.hidden = !isExpanded;
   control.addEventListener("click", function (event) {
     event.preventDefault();
     event.stopPropagation();
-    toggle("desktop", key, isExpanded, rerender);
+    var nextExpanded = !isExpanded;
+    expansionBySurface.desktop.set(key, nextExpanded);
+    control.setAttribute("aria-expanded", String(nextExpanded));
+    control.setAttribute("aria-label", (nextExpanded ? "Collapse" : "Expand") + " Workers for " + (root.driver.title || "New Session"));
+    children.hidden = !nextExpanded;
+    isExpanded = nextExpanded;
   });
   row.insertBefore(control, row.firstChild);
   wrapper.appendChild(row);
 
-  var children = document.createElement("div");
-  children.id = childrenId;
-  children.className = "session-worker-children";
-  children.setAttribute("role", "group");
-  children.setAttribute("aria-label", "Workers for " + (root.driver.title || "New Session"));
-  children.hidden = !isExpanded;
   var current = currentWorkerIds();
   for (var i = 0; i < root.workers.length; i++) {
     if (!visibleWorker(root.workers[i], root.driver, matchIds)) continue;

package/lib/public/modules/sidebar-sessions.js

@@ -18,6 +18,7 @@ import { groupedSessionIds } from './split-group-helpers.js';
 import { openPairDialog } from './split-pair-ui.js';
 import {
   hierarchyItemMatches,
+  isDesktopHierarchyToggleEvent,
   prepareSidebarHierarchy,
   renderDesktopDriverHierarchy,
   renderDesktopOrphanHierarchy
@@ -1333,7 +1334,8 @@ function renderSessionItem(s, options) {
   appendSessionCloseButton(el, s);
 
   el.addEventListener("click", (function (id) {
-    return function () {
+    return function (event) {
+      if (isDesktopHierarchyToggleEvent(event)) return;
       if (getWs() && store.get('connected')) {
         var pendingQuery = searchQuery || "";
         getWs().send(JSON.stringify({ type: "switch_session", id: id }));

package/lib/public/modules/sticky-note-markdown.js

@@ -58,6 +58,11 @@ function nodeToMarkdown(node) {
       return "\n" + inner;
     case "P": return "\n" + inner;
     case "A": return node.getAttribute("href") || inner;
+    case "BUTTON":
+      if (node.classList.contains("clayos-log-link") && node.dataset && node.dataset.logRef) {
+        return "`" + node.dataset.logRef + "`";
+      }
+      return inner;
     case "SPAN":
       if (node.classList.contains("sn-check")) {
         return node.classList.contains("checked") ? "- [x]" : "- [ ]";

package/lib/public/modules/sticky-notes-browser.js

@@ -11,6 +11,7 @@
 import { store } from './store.js';
 import { iconHtml, refreshIcons } from './icons.js';
 import { renderMiniMarkdown, getTitle } from './sticky-note-markdown.js';
+import { enhanceClayLogLinks } from './clay-log-links.js';
 import { send } from './sticky-notes-shared.js';
 import { listNoteData, focusNoteOnCanvas, hideNotes, showNotes } from './sticky-notes.js';
 
@@ -205,6 +206,7 @@ function buildCard(data) {
   var bodyLines = (data.text || "").split("\n").slice(1).join("\n").trim();
   if (bodyLines) {
     body.innerHTML = renderMiniMarkdown("_\n" + bodyLines).replace('<div class="sn-title">_</div>', "");
+    enhanceClayLogLinks(body);
   }
   card.appendChild(body);
 

package/lib/public/modules/sticky-notes-card.js

@@ -8,6 +8,7 @@
 import { refreshIcons, iconHtml } from './icons.js';
 import { VENDOR_AVATARS } from './app-rendering.js';
 import { getTitle, renderMiniMarkdown } from './sticky-note-markdown.js';
+import { enhanceClayLogLinks } from './clay-log-links.js';
 import {
   NOTE_COLORS,
   isClosedNote,
@@ -139,6 +140,7 @@ export function renderNote(data) {
   rendered.spellcheck = true;
   if (data.text && data.text.trim()) {
     rendered.innerHTML = renderMiniMarkdown(data.text);
+    enhanceClayLogLinks(rendered);
   } else {
     rendered.classList.add("is-empty");
   }

package/lib/public/modules/sticky-notes-editor.js

@@ -7,6 +7,7 @@
 
 import { refreshIcons, iconHtml } from './icons.js';
 import { extractMarkdown, renderMiniMarkdown } from './sticky-note-markdown.js';
+import { enhanceClayLogLinks } from './clay-log-links.js';
 import { debouncedTextUpdate, syncTitle } from './sticky-notes-shared.js';
 
 var formatToolbarEl = null;
@@ -183,6 +184,7 @@ export function setupTextEdit(textarea, rendered, noteId, mdBtn) {
       syncTitle(noteEl, md);
       if (md.trim()) {
         rendered.innerHTML = renderMiniMarkdown(md);
+        enhanceClayLogLinks(rendered);
         rendered.classList.remove("is-empty");
       } else {
         rendered.innerHTML = "";
@@ -217,6 +219,7 @@ export function setupTextEdit(textarea, rendered, noteId, mdBtn) {
     textarea.value = md;
     if (md.trim()) {
       rendered.innerHTML = renderMiniMarkdown(md);
+      enhanceClayLogLinks(rendered);
       rendered.classList.remove("is-empty");
     } else {
       rendered.innerHTML = "";

package/lib/public/modules/sticky-notes.js

@@ -7,6 +7,7 @@
 
 import { refreshIcons, iconHtml } from './icons.js';
 import { renderMiniMarkdown } from './sticky-note-markdown.js';
+import { enhanceClayLogLinks } from './clay-log-links.js';
 import { isClosedNote, send, clampPos, clearNoteTimers, syncTitle } from './sticky-notes-shared.js';
 import { renderNote, closeColorPicker } from './sticky-notes-card.js';
 import { closeFormatToolbar, isFormatToolbarOpen } from './sticky-notes-editor.js';
@@ -240,6 +241,7 @@ function patchNote(entry, next) {
     if (textarea) textarea.value = nextText;
     if (nextText.trim()) {
       rendered.innerHTML = renderMiniMarkdown(nextText);
+      enhanceClayLogLinks(rendered);
       rendered.classList.remove("is-empty");
     } else {
       rendered.innerHTML = "";

package/lib/public/style.css

@@ -41,7 +41,7 @@
 @import url("css/session-search.css");
 @import url("css/tooltip.css");
 @import url("css/mates.css?v=20260407");
-@import url("css/command-palette.css?v=20260901-clay-chat2");
+@import url("css/command-palette.css?v=20260908-log-links2");
 @import url("css/mention.css");
 @import url("css/debate.css");
 @import url("css/home-debate-planning.css");

package/lib/sdk-bridge.js

@@ -1623,6 +1623,21 @@ function createSDKBridge(opts) {
     if (selectedUserInputMode === "fallback") {
       sessionToolDefs = sessionToolDefs.concat(yoke.userInput.fallbackToolDefs(sessionUserInputHandler));
     }
+    function findSessionToolDef(toolName) {
+      // Codex restores a thread's original dynamic-tool catalog on resume, but
+      // pair state can change after this query starts. Resolve live session
+      // handlers first so the dispatcher cannot lag behind that catalog. Keep
+      // the query snapshot as a fallback for query-bound tools such as the
+      // structured-input fallback, whose handler exists only for this turn.
+      var liveToolDefs = getSessionToolDefs(session) || [];
+      for (var liveIndex = 0; liveIndex < liveToolDefs.length; liveIndex++) {
+        if (liveToolDefs[liveIndex].name === toolName) return liveToolDefs[liveIndex];
+      }
+      for (var snapshotIndex = 0; snapshotIndex < sessionToolDefs.length; snapshotIndex++) {
+        if (sessionToolDefs[snapshotIndex].name === toolName) return sessionToolDefs[snapshotIndex];
+      }
+      return null;
+    }
 
     // Give fresh queries an immediate provisional label. The visible user
     // message in history wins over `text`, which may contain an internal
@@ -1663,10 +1678,9 @@ function createSDKBridge(opts) {
       toolServerDescriptors: extractMcpDescriptors(mergedMcpServers) || undefined,
       dynamicTools: sessionToolDefs,
       callDynamicTool: function (toolName, args) {
-        for (var dti = 0; dti < sessionToolDefs.length; dti++) {
-          if (sessionToolDefs[dti].name === toolName && typeof sessionToolDefs[dti].handler === "function") {
-            return sessionToolDefs[dti].handler(args || {});
-          }
+        var toolDef = findSessionToolDef(toolName);
+        if (toolDef && typeof toolDef.handler === "function") {
+          return toolDef.handler(args || {});
         }
         return Promise.reject(new Error("Session tool not found: " + toolName));
       },
@@ -1674,12 +1688,8 @@ function createSDKBridge(opts) {
       abortController: linuxUser ? undefined : session.abortController,
       canUseTool: function(toolName, input, toolOpts) {
         var permissionName = toolName;
-        for (var pti = 0; pti < sessionToolDefs.length; pti++) {
-          if (sessionToolDefs[pti].name === toolName && sessionToolDefs[pti].permissionName) {
-            permissionName = sessionToolDefs[pti].permissionName;
-            break;
-          }
-        }
+        var permissionToolDef = findSessionToolDef(toolName);
+        if (permissionToolDef && permissionToolDef.permissionName) permissionName = permissionToolDef.permissionName;
         return handleCanUseTool(session, permissionName, input, toolOpts);
       },
       onUserInputRequest: function(request, respond) {

package/lib/server-global-ws.js

@@ -7,6 +7,7 @@
 // Bound to the slug-less `/ws` endpoint by lib/server.js. Only handles the
 // small set of messages needed to bootstrap into a project context:
 //   - ping            -> pong keep-alive
+//   - home_*           -> user-scoped Home preferences
 //   - browse_dir      -> directory picker for the add-project modal
 //   - add_project     -> register an existing directory
 //   - create_project  -> make a new empty project
@@ -37,6 +38,7 @@ function attachGlobalWs(opts) {
   var onAddProject = opts.onAddProject;
   var onCreateProject = opts.onCreateProject;
   var onCloneProject = opts.onCloneProject;
+  var onHomePreferenceMessage = opts.onHomePreferenceMessage;
 
   function handleMessage(ws, msg) {
     if (!msg || typeof msg !== "object") return;
@@ -46,6 +48,8 @@ function attachGlobalWs(opts) {
       return;
     }
 
+    if (typeof onHomePreferenceMessage === "function" && onHomePreferenceMessage(ws, msg)) return;
+
     // --- Directory picker for the add-project modal ---
     if (msg.type === "browse_dir") {
       var rawPath = (msg.path || "").replace(/^~/, config.REAL_HOME);

package/lib/server-home-chat-events.js

@@ -228,6 +228,9 @@ function searchToolLabel(name, input) {
   if (name === "list_project_sessions") return "Reviewing project conversations";
   if (name === "list_projects") return "Reviewing your projects";
   if (name === "search_project_history") return query ? "Searching a project for \u201c" + query + "\u201d" : "Searching a project";
+  if (name === "search_project_logs") return query ? "Searching project logs for \u201c" + query + "\u201d" : "Searching project logs";
+  if (name === "list_project_logs") return "Reviewing project logs";
+  if (name === "read_project_log" || name === "read_project_log_revision" || name === "project_log_history") return "Reading a project log";
   return "Using " + (cleanActivityText(name, 64) || "a workspace tool");
 }
 

package/lib/server-home-chat.js

@@ -204,7 +204,12 @@ function attachHomeChat(deps) {
 
   var homeModels = attachHomeModels({ users: users, mates: mates, projects: projects, sendMessage: sendMessage });
   var homeDebates = attachHomeDebates({ mates: mates, findMateProject: findMateProject, ownsSession: ownsSession, sessionReference: sessionReference, sendMessage: sendMessage });
-  var homeClaySessionLinks = attachHomeClaySessionLinks({ projects: projects, workspaceQueryService: deps.workspaceQueryService, sendMessage: sendMessage });
+  var homeClaySessionLinks = attachHomeClaySessionLinks({
+    projects: projects,
+    workspaceQueryService: deps.workspaceQueryService,
+    projectLogsService: deps.projectLogsService,
+    sendMessage: sendMessage,
+  });
 
   function sendHistory(ws, found, session, requestId) {
     if (ws.readyState !== 1) return;
@@ -383,7 +388,7 @@ function attachHomeChat(deps) {
 
   function handleMessage(ws, msg) {
     if (!msg || typeof msg.type !== "string") return false;
-    if (msg.type !== "home_debates_list" && msg.type !== "home_clay_ask" && msg.type !== "home_clay_session_resolve" && 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_debate_question_response" && msg.type !== "home_debate_control" && msg.type !== "home_mate_creation_plan" && msg.type !== "home_mate_creation_question_response" && 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") {
+    if (msg.type !== "home_debates_list" && msg.type !== "home_clay_ask" && msg.type !== "home_clay_session_resolve" && msg.type !== "home_clay_log_resolve" && 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_debate_question_response" && msg.type !== "home_debate_control" && msg.type !== "home_mate_creation_plan" && msg.type !== "home_mate_creation_question_response" && 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") {
       return false;
     }
 
@@ -402,6 +407,7 @@ function attachHomeChat(deps) {
     if (users.isMultiUser() && !userId) {
       if (msg.type === "home_debates_list") sendMessage(ws, { type: "home_debates_state", requestId: msg.requestId || null, status: "error", debates: [], error: "Sign in to load your debates." });
       else if (msg.type === "home_clay_session_resolve") sendMessage(ws, { type: "home_clay_session_target", requestId: msg.requestId || null, sessionRef: msg.sessionRef || null, status: "error", error: "Sign in to open this session." });
+      else if (msg.type === "home_clay_log_resolve") sendMessage(ws, { type: "home_clay_log_target", requestId: msg.requestId || null, ref: msg.ref || null, status: "error", error: "Sign in to open this log." });
       else if (msg.type === "home_mate_models_get" || msg.type === "home_mate_model_set") homeModels.sendAccessError(ws, msg, "Not authenticated.");
       else sendError(ws, msg.mateId || null, "Not authenticated.", msg.requestId || null, msg.sessionId || null);
       return true;
@@ -410,6 +416,7 @@ function attachHomeChat(deps) {
     if (homeDebates.handle(ws, userId, msg)) return true;
     if (msg.type === "home_clay_ask") { homeClayEntry.start(ws, userId, msg); return true; }
     if (msg.type === "home_clay_session_resolve") { homeClaySessionLinks.resolve(ws, msg); return true; }
+    if (msg.type === "home_clay_log_resolve") { homeClaySessionLinks.resolveLog(ws, msg); return true; }
 
     if (msg.type === "home_mate_debate_plan") {
       homeDebate.start(ws, userId, msg);

package/lib/server-home-clay-entry.js

@@ -2,7 +2,7 @@
 
 function attachHomeClayEntry(ctx) {
   function providerPrompt(text) {
-    return "This conversation began in Clay Studio's global search. Respond as Clay. When the user is trying to locate prior work, use search_workspace_history before any other investigation. Search by meaning, related terms, and context, using at most three focused search passes. Do not use Bash, filesystem scans, or generic agents to search Clay conversation history. Give the user useful findings promptly, and do not mention tools or internal search mechanics. Do not force a workspace search when the request is a general question or task.\n\nUser request:\n" + text;
+    return "This conversation began in Clay Studio's global search. Respond as Clay. When the user is trying to locate a conversation, use search_workspace_history before any other investigation. When the user asks about a project's prior work, decisions, defects, status, rationale, or unfinished work, identify the project and search_project_logs before answering; use conversation history as additional evidence when useful. Search by meaning, related terms, and context, using at most three focused search passes. Do not use Bash, filesystem scans, or generic agents to search Clay history. Give the user useful findings promptly, and do not mention tools or internal search mechanics. Do not force a workspace or Logs search when the request is a general question or task.\n\nUser request:\n" + text;
   }
 
   function findExisting(manager, userId, requestId) {

package/lib/server-home-clay-session-links.js

@@ -1,13 +1,19 @@
-// Resolve rendered Mate session references through an exact owner-bound source session.
+// Resolve rendered Mate session and Project Log references through an exact
+// owner-bound source session.
 
 function attachHomeClaySessionLinks(ctx) {
-  function resolve(ws, msg) {
+  function source(ws, msg) {
     var tap = msg.surface === "search" ? ws._searchClayTap : ws._homeChatTap;
     var sourceProject = tap && tap.mateSlug ? ctx.projects.get(tap.mateSlug) : null;
     var sourceManager = sourceProject && sourceProject.getSessionManager ? sourceProject.getSessionManager() : null;
     var sourceSession = sourceManager && tap ? sourceManager.sessions.get(tap.sessionId) : null;
-    var bound = ctx.workspaceQueryService && sourceSession
-      ? ctx.workspaceQueryService.bindProjectSession({ projectSlug: tap.mateSlug, session: sourceSession })
+    return { tap: tap, project: sourceProject, session: sourceSession };
+  }
+
+  function resolve(ws, msg) {
+    var selected = source(ws, msg);
+    var bound = ctx.workspaceQueryService && selected.session
+      ? ctx.workspaceQueryService.bindProjectSession({ projectSlug: selected.tap.mateSlug, session: selected.session })
       : null;
     var payload = { type: "home_clay_session_target", requestId: msg.requestId || null, sessionRef: msg.sessionRef || null, status: "error" };
     try {
@@ -20,7 +26,30 @@ function attachHomeClaySessionLinks(ctx) {
     ctx.sendMessage(ws, payload);
   }
 
-  return { resolve: resolve };
+  function resolveLog(ws, msg) {
+    var selected = source(ws, msg);
+    var status = selected.project && selected.project.getStatus ? selected.project.getStatus() : null;
+    var bound = ctx.projectLogsService && selected.session && status
+      ? ctx.projectLogsService.bindMate({
+        projectSlug: selected.tap.mateSlug,
+        projectOwnerId: status.projectOwnerId || null,
+        isMate: true,
+        mateId: selected.tap.mateId,
+        session: selected.session,
+      })
+      : null;
+    var payload = { type: "home_clay_log_target", requestId: msg.requestId || null, ref: msg.ref || null, status: "error" };
+    try {
+      if (!bound) throw new Error("The source conversation is no longer available.");
+      payload.target = bound.resolveLogNavigation({ ref: msg.ref });
+      payload.status = "ready";
+    } catch (error) {
+      payload.error = error.message || "Log not available.";
+    }
+    ctx.sendMessage(ws, payload);
+  }
+
+  return { resolve: resolve, resolveLog: resolveLog };
 }
 
 module.exports = { attachHomeClaySessionLinks: attachHomeClaySessionLinks };