clay-server 4.0.0-beta.17 → 4.0.0-beta.19

package/lib/public/modules/app-projects.js

@@ -417,13 +417,15 @@ export function switchProject(slug) {
   if (!slug) return;
   document.cookie = "clay_last_project=" + encodeURIComponent(slug) + "; Path=/; SameSite=Strict; Max-Age=31536000";
   var st = store.snap();
+  var targetWsPath = "/p/" + slug + "/ws";
+  var alreadyInProject = slug === st.currentSlug && st.wsPath === targetWsPath;
   var wasDm = st.dmMode;
   var wasMate = st.dmMode && st.dmTargetUser && st.dmTargetUser.isMate;
   if (st.dmMode) exitDmMode(wasMate);
   closeWhatsNewArticle();
   if (isHomeHubVisible()) {
     hideHomeHub();
-    if (slug === store.get('currentSlug')) {
+    if (alreadyInProject) {
       if (document.documentElement.classList.contains("pwa-standalone")) {
         history.replaceState(null, "", "/p/" + slug + "/");
       } else {
@@ -432,7 +434,7 @@ export function switchProject(slug) {
       return;
     }
   }
-  if (slug === store.get('currentSlug')) {
+  if (alreadyInProject) {
     var ws = getWs();
     if (wasDm && ws && ws.readyState === 1) {
       ws.send(JSON.stringify({ type: "switch_session", id: store.get('activeSessionId') }));
@@ -446,7 +448,7 @@ export function switchProject(slug) {
   resetScheduler(slug);
   store.set({ currentSlug: slug });
   store.set({ basePath: "/p/" + slug + "/" });
-  store.set({ wsPath: "/p/" + slug + "/ws" });
+  store.set({ wsPath: targetWsPath });
   if (document.documentElement.classList.contains("pwa-standalone")) {
     history.replaceState(null, "", "/p/" + slug + "/");
   } else {

package/lib/public/modules/chat-bubble-renderer.js

@@ -105,7 +105,7 @@ export function addAssistantCopyHandler(row, rawText) {
   }
 
   row.addEventListener("click", function (event) {
-    if (event.target.closest("a, pre, code")) return;
+    if (event.target.closest("a, button, pre, code")) return;
     var selection = window.getSelection();
     if (selection && selection.toString().length > 0) return;
     if (!primed) {

package/lib/public/modules/clay-log-links.js

@@ -0,0 +1,70 @@
+export function parseClayLogReferences(text) {
+  var pattern = /\[clayos\/(log:[A-Za-z0-9_-]{24})(?:\s+[\u2014-]\s+([^\]\n]{1,80}))?\]|(^|[^A-Za-z0-9_/:])(log:[A-Za-z0-9_-]{24})(?![A-Za-z0-9_-])/g;
+  var results = [];
+  var match;
+  while ((match = pattern.exec(text || ""))) {
+    results.push({
+      start: match.index,
+      end: pattern.lastIndex,
+      prefix: match[3] || "",
+      ref: match[1] || match[4],
+      label: match[2] ? match[2].trim() : "",
+    });
+  }
+  return results;
+}
+
+export function isExactClayLogReference(text) {
+  return /^log:[A-Za-z0-9_-]{24}$/.test((text || "").trim());
+}
+
+function createLogLink(ref, labelText) {
+  var button = document.createElement("button");
+  button.type = "button";
+  button.className = "clayos-log-link";
+  button.contentEditable = "false";
+  button.dataset.logRef = ref;
+  button.setAttribute("aria-label", "Open Project Log" + (labelText ? " " + labelText : ""));
+  var label = document.createElement("span");
+  label.textContent = "Log";
+  button.appendChild(label);
+  if (labelText) {
+    var meta = document.createElement("small");
+    meta.textContent = labelText;
+    button.appendChild(meta);
+  }
+  return button;
+}
+
+export function enhanceClayLogLinks(root) {
+  var codeNodes = root.querySelectorAll("code");
+  for (var codeIndex = 0; codeIndex < codeNodes.length; codeIndex++) {
+    var code = codeNodes[codeIndex];
+    var codeText = (code.textContent || "").trim();
+    if (code.closest("pre") || !isExactClayLogReference(codeText)) continue;
+    code.parentNode.replaceChild(createLogLink(codeText, ""), code);
+  }
+
+  var walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT);
+  var nodes = [];
+  var node;
+  while ((node = walker.nextNode())) {
+    if (!node.parentElement || node.parentElement.closest("code, pre, a, button")) continue;
+    if (parseClayLogReferences(node.nodeValue).length) nodes.push(node);
+  }
+  for (var i = 0; i < nodes.length; i++) {
+    var text = nodes[i].nodeValue || "";
+    var matches = parseClayLogReferences(text);
+    var fragment = document.createDocumentFragment();
+    var offset = 0;
+    for (var j = 0; j < matches.length; j++) {
+      var match = matches[j];
+      fragment.appendChild(document.createTextNode(text.slice(offset, match.start)));
+      if (match.prefix) fragment.appendChild(document.createTextNode(match.prefix));
+      fragment.appendChild(createLogLink(match.ref, match.label));
+      offset = match.end;
+    }
+    fragment.appendChild(document.createTextNode(text.slice(offset)));
+    nodes[i].parentNode.replaceChild(fragment, nodes[i]);
+  }
+}

package/lib/public/modules/command-palette.js

@@ -6,6 +6,7 @@ import { showHomeHub, minimizeHomeHub } from './app-home-hub.js';
 import { openHomeConversation } from './home-mate-chat.js';
 import { startSearchClayChat, attachSearchClayChat, detachSearchClayChat, getSearchClayChatSummary } from './search-clay-chat.js';
 import { getWs } from './ws-ref.js';
+import { openProjectLog } from './project-logs.js';
 
 function formatRelativeDate(ts) {
   if (!ts) return "";
@@ -27,6 +28,7 @@ var ctx;
 var paletteEl = null, inputEl = null, resultsEl = null, footerEl = null;
 var activeIndex = -1, items = [], debounceTimer = null, abortCtrl = null;
 var pendingNav = null, cachedHomeData = [], cachedVersion = null;
+var pendingLogNav = null;
 var searchResults = [], searchQuery = "", searchPending = false, chatMode = false;
 
 export function initCommandPalette(value) {
@@ -52,43 +54,62 @@ export function initCommandPalette(value) {
 }
 
 function handleClaySessionLinkClick(event) {
-  var link = event.target.closest(".clayos-session-link");
+  var link = event.target.closest(".clayos-session-link, .clayos-log-link");
   if (!link || link.classList.contains("is-loading")) return;
+  event.preventDefault();
+  event.stopPropagation();
+  if (link.classList.contains("clayos-log-link") && !link.closest(".search-clay-chat, #home-mate-chat")) {
+    openProjectLog(link.dataset.logRef);
+    return;
+  }
   var ws = getWs();
   if (!ws || ws.readyState !== 1) {
     link.classList.add("is-error");
-    link.title = "Reconnect to open this session";
+    link.title = "Reconnect to open this item";
     return;
   }
-  var requestId = "clayos-session-" + Date.now() + "-" + Math.random().toString(36).slice(2, 9);
-  link.dataset.sessionRequest = requestId;
+  var isLog = link.classList.contains("clayos-log-link");
+  var requestId = "clayos-" + (isLog ? "log-" : "session-") + Date.now() + "-" + Math.random().toString(36).slice(2, 9);
+  if (isLog) link.dataset.logRequest = requestId;
+  else link.dataset.sessionRequest = requestId;
   link.classList.remove("is-error");
   link.classList.add("is-loading");
-  ws.send(JSON.stringify({
-    type: "home_clay_session_resolve",
-    requestId: requestId,
-    sessionRef: link.dataset.sessionRef,
-    surface: link.closest(".search-clay-chat") ? "search" : "home",
-  }));
+  var request = { requestId: requestId, surface: link.closest(".search-clay-chat") ? "search" : "home" };
+  if (isLog) {
+    request.type = "home_clay_log_resolve";
+    request.ref = link.dataset.logRef;
+  } else {
+    request.type = "home_clay_session_resolve";
+    request.sessionRef = link.dataset.sessionRef;
+  }
+  ws.send(JSON.stringify(request));
 }
 
 export function handleClaySessionTarget(msg) {
-  if (!msg || msg.type !== "home_clay_session_target") return false;
-  var links = document.querySelectorAll(".clayos-session-link[data-session-request]");
+  if (!msg || (msg.type !== "home_clay_session_target" && msg.type !== "home_clay_log_target")) return false;
+  var isLog = msg.type === "home_clay_log_target";
+  var links = document.querySelectorAll(isLog ? ".clayos-log-link[data-log-request]" : ".clayos-session-link[data-session-request]");
   var link = null;
-  for (var i = 0; i < links.length; i++) if (links[i].dataset.sessionRequest === msg.requestId) link = links[i];
+  for (var i = 0; i < links.length; i++) {
+    if ((isLog ? links[i].dataset.logRequest : links[i].dataset.sessionRequest) === msg.requestId) link = links[i];
+  }
   if (link) {
     link.classList.remove("is-loading");
-    delete link.dataset.sessionRequest;
+    if (isLog) delete link.dataset.logRequest;
+    else delete link.dataset.sessionRequest;
   }
   if (msg.status !== "ready" || !msg.target) {
     if (link) {
       link.classList.add("is-error");
-      link.title = msg.error || "Session not available";
+      link.title = msg.error || "Item not available";
     }
     return true;
   }
   closeCommandPalette();
+  if (isLog) {
+    navigateToLog(msg.target);
+    return true;
+  }
   if (msg.target.isMate && msg.target.mateId && msg.target.homeSessionId) {
     showHomeHub();
     openHomeConversation(msg.target.mateId, msg.target.homeSessionId);
@@ -129,6 +150,11 @@ export function closeCommandPalette() {
 export function setPaletteVersion(version) { cachedVersion = version; }
 
 export function handlePaletteSessionSwitch() {
+  if (pendingLogNav && ctx.currentSlug && ctx.currentSlug() === pendingLogNav.projectSlug) {
+    var logNav = pendingLogNav;
+    pendingLogNav = null;
+    openProjectLog(logNav.ref);
+  }
   if (!pendingNav) return;
   var nav = pendingNav;
   pendingNav = null;
@@ -138,6 +164,17 @@ export function handlePaletteSessionSwitch() {
   }
 }
 
+function navigateToLog(target) {
+  closeCommandPalette();
+  minimizeHomeHub();
+  if (ctx.currentSlug && ctx.currentSlug() === target.projectSlug) {
+    openProjectLog(target.ref);
+  } else {
+    pendingLogNav = { projectSlug: target.projectSlug, ref: target.ref };
+    ctx.switchProject(target.projectSlug);
+  }
+}
+
 function buildDOM() {
   paletteEl = document.createElement("div");
   paletteEl.className = "cmd-palette hidden";

package/lib/public/modules/markdown.js

@@ -2,6 +2,7 @@ import { copyToClipboard, escapeHtml } from './utils.js';
 import { refreshIcons } from './icons.js';
 import { getMermaidThemeVars } from './theme.js';
 import { store } from './store.js';
+import { enhanceClayLogLinks } from './clay-log-links.js';
 
 // Initialize markdown parser
 marked.use({ gfm: true, breaks: false });
@@ -89,6 +90,7 @@ export function enhanceClaySessionLinks(root) {
     fragment.appendChild(document.createTextNode(text.slice(offset)));
     nodes[i].parentNode.replaceChild(fragment, nodes[i]);
   }
+  enhanceClayLogLinks(root);
 }
 
 /**

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

@@ -336,6 +336,13 @@ 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) {

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

@@ -84,6 +84,8 @@ export function renderDesktopDriverHierarchy(root, renderSession, rerender, matc
   var key = "driver:" + root.driver.id;
   var isExpanded = expanded("desktop", key, root.workers, matchIds);
   var childrenId = "session-workers-" + root.driver.id;
+  var header = document.createElement("div");
+  header.className = "session-driver-header";
   var row = renderSession(root.driver);
   row.classList.add("session-driver-item");
   var control = document.createElement("button");
@@ -93,20 +95,26 @@ 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");
-  control.addEventListener("click", function (event) {
-    event.preventDefault();
-    event.stopPropagation();
-    toggle("desktop", key, isExpanded, rerender);
-  });
-  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;
+  control.addEventListener("click", function (event) {
+    event.preventDefault();
+    event.stopPropagation();
+    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;
+  });
+  header.appendChild(control);
+  header.appendChild(row);
+  wrapper.appendChild(header);
+
   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/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 and Mate    -> the same user-scoped handlers as project sockets
 //   - 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,8 @@ function attachGlobalWs(opts) {
   var onAddProject = opts.onAddProject;
   var onCreateProject = opts.onCreateProject;
   var onCloneProject = opts.onCloneProject;
+  var onHomePreferenceMessage = opts.onHomePreferenceMessage;
+  var onAppMessage = opts.onAppMessage;
 
   function handleMessage(ws, msg) {
     if (!msg || typeof msg !== "object") return;
@@ -46,6 +49,14 @@ function attachGlobalWs(opts) {
       return;
     }
 
+    // A user does not need an ordinary project before Home becomes useful.
+    // Route Mate discovery, Home chat/debates, and tools through the same
+    // handlers used by project sockets. This also lets mate_list repair an
+    // existing account whose built-ins were missing from its final storage.
+    if (typeof onAppMessage === "function" && onAppMessage(ws, msg)) 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 };