clay-server 4.0.0 → 4.0.1-beta.1

package/lib/project-sessions.js

@@ -87,6 +87,13 @@ function attachSessions(ctx) {
   var getLinuxUserForSession = ctx.getLinuxUserForSession;
   var ensureProjectAccessForSession = ctx.ensureProjectAccessForSession;
   var getOsUserInfoForWs = ctx.getOsUserInfoForWs;
+  function stopSession(session) {
+    if (!session || (!session.isProcessing && !session._queryStarting)) return false;
+    if (typeof ctx.onHumanPairStop === "function") ctx.onHumanPairStop(session);
+    session.taskStopRequested = true;
+    if (session.abortController) session.abortController.abort();
+    return true;
+  }
   var hydrateImageRefs = ctx.hydrateImageRefs;
   var onProcessingChanged = ctx.onProcessingChanged;
   var broadcastPresence = ctx.broadcastPresence;
@@ -1004,11 +1011,7 @@ function attachSessions(ctx) {
 
     if (msg.type === "stop") {
       var session = getSessionForWs(ws);
-      if (session && (session.isProcessing || session._queryStarting)) {
-        if (typeof ctx.onHumanPairStop === "function") ctx.onHumanPairStop(session);
-        session.taskStopRequested = true;
-        if (session.abortController) session.abortController.abort();
-      }
+      stopSession(session);
       return true;
     }
 
@@ -2071,6 +2074,13 @@ function attachSessions(ctx) {
     handleSessionsMessage: handleSessionsMessage,
     resolveSessionForView: resolveSessionForView,
     respondToAskUser: respondToAskUser,
+    respondToHomePermission: function (ws, msg, session) {
+      if (!session || !msg || !session.pendingPermissions || !session.pendingPermissions[msg.requestId]) return false;
+      var indexedSessionId = sm.permissionRequestIndex[msg.requestId];
+      if (indexedSessionId !== session.localId || sm.sessions.get(indexedSessionId) !== session) return false;
+      return handleSessionsMessage(ws, { type: "permission_response", requestId: msg.requestId, decision: msg.decision });
+    },
+    stopHomeSession: stopSession,
   };
 }
 

package/lib/project.js

@@ -1331,6 +1331,10 @@ function createProjectContext(opts) {
       if (typeof opts.onDmMessage === "function") opts.onDmMessage(ws, msg, slug);
       return;
     }
+    if (msg.type === "home_mate_stop" || msg.type === "home_mate_permission_response") {
+      if (typeof opts.onDmMessage === "function") opts.onDmMessage(ws, msg, slug);
+      return;
+    }
     if (msg.type === "project_assignment_response" || msg.type === "dm_open" || msg.type === "dm_send" || msg.type === "dm_list" || msg.type === "dm_typing" || msg.type === "dm_add_favorite" || msg.type === "dm_remove_favorite" || msg.type === "mate_create" || msg.type === "mate_list" || msg.type === "mate_delete" || msg.type === "mate_update" || msg.type === "mate_readd_builtin" || msg.type === "mate_list_available_builtins" || msg.type === "email_accounts_list" || msg.type === "email_account_add" || msg.type === "email_account_remove" || msg.type === "email_account_test" || msg.type === "home_debates_list" || msg.type === "home_mate_present" || msg.type === "home_mate_open" || msg.type === "home_mate_sessions_list" || msg.type === "home_mate_session_open" || msg.type === "home_mate_send" || msg.type === "home_mate_new_session" || msg.type === "home_mate_debate_plan" || msg.type === "home_debate_proposal_response" || msg.type === "home_mate_creation_plan" || msg.type === "home_mate_creation_proposal_response" || msg.type === "home_mate_close" || msg.type === "home_mate_memory_list" || msg.type === "home_mate_knowledge_list" || msg.type === "home_mate_models_get" || msg.type === "home_mate_model_set" || msg.type === "home_dock_get" || msg.type === "home_dock_set" || msg.type === "home_surface_get" || msg.type === "home_surface_set" || msg.type === "tools_list" || msg.type === "tool_get" || msg.type === "tool_install" || msg.type === "tool_remove" || msg.type === "tool_storage_op" || msg.type === "tool_llm_op" || msg.type === "tool_llm_config_get" || msg.type === "tool_control_response" || msg.type === "tool_source_get" || msg.type === "tool_mate_access_set" || msg.type === "tool_server_control" || msg.type === "tool_frame_url") {
       if (typeof opts.onDmMessage === "function") {
         opts.onDmMessage(ws, msg, slug);
@@ -2314,6 +2318,8 @@ function createProjectContext(opts) {
     handleHomeDebateProposalResponse: function (ws, msg, session) { return _debateProposal.handleHomeMessage(ws, msg, session); },
     handleHomeMateCreationProposalResponse: function (ws, msg, session) { return _mateCreationProposal.handleHomeMessage(ws, msg, session); },
     handleHomeAskUserResponse: function (msg, session) { return _sessions.respondToAskUser(session, msg); },
+    handleHomePermissionResponse: function (ws, msg, session) { return _sessions.respondToHomePermission(ws, msg, session); },
+    stopHomeSession: function (session) { return _sessions.stopHomeSession(session); },
     handleHomeDebateControl: function (ws, msg, session) { return _debate.handleHomeControl(ws, msg, session); },
     getVendorModelCatalog: _models.getVendorCatalog,
     getVendorModelAvailability: _models.getVendorAvailability,

package/lib/public/app.js

@@ -294,6 +294,7 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     savedMainSlug: null,
     connected: false,
     pendingOutboundMessages: [],
+    searchClayChatState: null,
     homeChatMateId: null,
     homeChatSessionId: null,
     homeChatSessionModel: null,

package/lib/public/css/command-palette.css

@@ -392,6 +392,32 @@
   gap: 12px;
 }
 
+.search-clay-permission {
+  margin: 0 6px;
+  padding: 12px;
+  border: 1px solid color-mix(in srgb, var(--accent) 30%, var(--border-subtle));
+  border-radius: 10px;
+  background: color-mix(in srgb, var(--accent) 6%, var(--bg-secondary));
+}
+
+.search-clay-permission strong { display: block; color: var(--text); font-size: 13px; }
+.search-clay-permission p { margin: 5px 0 10px; color: var(--text-muted); font-size: 11px; line-height: 1.45; overflow-wrap: anywhere; }
+.search-clay-permission > div { display: flex; justify-content: flex-end; gap: 7px; }
+.search-clay-permission button {
+  min-height: 30px;
+  padding: 0 10px;
+  border: 1px solid var(--border);
+  border-radius: 7px;
+  background: var(--bg);
+  color: var(--text);
+  font: inherit;
+  font-size: 11px;
+  cursor: pointer;
+}
+.search-clay-permission button.is-primary { border-color: var(--accent); background: var(--accent); color: white; }
+.search-clay-permission button:disabled { opacity: 0.55; cursor: default; }
+.search-clay-permission small { display: block; margin-top: 7px; color: var(--text-muted); font-size: 11px; }
+
 .search-clay-message { width: 100%; min-width: 0; }
 .search-clay-transcript .search-clay-message-user {
   display: flex;

package/lib/public/index.html

@@ -31,7 +31,7 @@
 (function(){try{var k="clay-theme-vars",v=localStorage.getItem(k),r=document.documentElement;if(v){var o=JSON.parse(v),p;for(p in o)r.style.setProperty(p,o[p]);var vt=localStorage.getItem(k.replace("-vars","-variant"));if(vt==="light"){r.classList.add("light-theme");r.classList.remove("dark-theme")}else{r.classList.add("dark-theme");r.classList.remove("light-theme")}var m=document.querySelector('meta[name="theme-color"]');if(m&&o["--bg"])m.setAttribute("content",o["--bg"])}else{var sl=window.matchMedia&&window.matchMedia("(prefers-color-scheme: light)").matches;if(sl){r.classList.add("light-theme");r.classList.remove("dark-theme")}}}catch(e){}})();
 </script>
 <script>if(window.navigator.standalone||window.matchMedia("(display-mode:standalone)").matches){document.documentElement.classList.add("pwa-standalone")}</script>
-<link rel="stylesheet" href="style.css?v=20260908-log-links2">
+<link rel="stylesheet" href="style.css?v=20260910-ask-clay-controls1">
 <style>
 @media(max-width:768px){
   /* User messages: vertical stack, avatar on top, right-aligned */
@@ -2337,7 +2337,7 @@
 <script src="https://cdn.jsdelivr.net/npm/@xterm/addon-fit@0/lib/addon-fit.min.js"></script>
 <script src="https://cdn.jsdelivr.net/npm/@xterm/addon-web-links@0/lib/addon-web-links.min.js"></script>
 <script src="https://cdn.jsdelivr.net/npm/@xterm/addon-webgl@0/lib/addon-webgl.min.js"></script>
-<script type="module" src="app.js?v=20260908-log-links2"></script>
+<script type="module" src="app.js?v=20260910-ask-clay-controls1"></script>
 <div id="pwa-install-modal" class="pwa-modal hidden">
   <div class="pwa-modal-backdrop"></div>
   <div class="pwa-modal-card">

package/lib/public/modules/app-message-router.js

@@ -78,7 +78,7 @@ export function handleHomeProtocolMessage(msg) {
 
 export function processMessage(msg) {
   var searchHandled = handleSearchClayMessage(msg);
-  if (searchHandled && msg.type === "home_clay_activity") return;
+  if (searchHandled && (msg.type === "home_clay_activity" || msg.type === "home_mate_stopping" || msg.type.indexOf("home_mate_permission_") === 0)) return;
   if (handleHomeProtocolMessage(msg)) return;
   processAppMessage(msg);
 }

package/lib/public/modules/search-clay-chat.js

@@ -6,8 +6,9 @@ import { refreshIcons } from './icons.js';
 import { store } from './store.js';
 import { mateAvatarUrl } from './avatar.js';
 import { createAssistantBubble, createUserBubble, finalizeAssistantBubble, renderAssistantBubbleText } from './chat-bubble-renderer.js';
+import { isExactSearchControlMessage, replaceSearchPermissions, applySearchPermissionMessage, createSearchPermissionCard } from './search-clay-controls.js';
 
-var state = null;
+var state = store.get('searchClayChatState') || null;
 var hostEl = null;
 var backHandler = null;
 var closeHandler = null;
@@ -213,6 +214,22 @@ function submit(input, sendButton) {
   render();
 }
 
+function stopSearchClayChat() {
+  if (!state || !state.processing || state.stopping || !state.mateId || !state.sessionId) return false;
+  if (!send({ type: "home_mate_stop", mateId: state.mateId, sessionId: state.sessionId, requestId: state.requestId })) return false;
+  state.stopping = true;
+  render();
+  return true;
+}
+
+function respondToPermission(permission, decision) {
+  if (!state || permission.status !== "pending") return false;
+  if (!send({ type: "home_mate_permission_response", mateId: state.mateId, sessionId: state.sessionId, requestId: state.requestId, permissionRequestId: permission.permissionRequestId, decision: decision })) return false;
+  permission.status = "answering";
+  render();
+  return true;
+}
+
 function expand() {
   if (!state || !state.mateId || !state.sessionId) return;
   var mateId = state.mateId;
@@ -260,9 +277,9 @@ function render() {
     freshSendButton.className = "search-clay-send";
     freshSendButton.setAttribute("aria-label", "Send to Clay");
     freshSendButton.innerHTML = '<i data-lucide="arrow-up" aria-hidden="true"></i>';
-    freshInput.addEventListener("input", function () { state.draft = freshInput.value; freshSendButton.disabled = !state.sessionId || !freshInput.value.trim(); });
+    freshInput.addEventListener("input", function () { state.draft = freshInput.value; freshSendButton.disabled = state.processing ? (!state.sessionId || state.stopping) : (!state.sessionId || !freshInput.value.trim()); });
     freshInput.addEventListener("keydown", function (event) { if (event.key === "Enter" && !event.shiftKey && !event.isComposing) { event.preventDefault(); submit(freshInput, freshSendButton); } });
-    freshSendButton.addEventListener("click", function () { submit(freshInput, freshSendButton); });
+    freshSendButton.addEventListener("click", function () { if (state.processing) stopSearchClayChat(); else submit(freshInput, freshSendButton); });
     composer.appendChild(freshInput);
     composer.appendChild(freshSendButton);
     shell.appendChild(composer);
@@ -271,6 +288,7 @@ function render() {
   transcript.innerHTML = "";
   for (var i = 0; i < state.messages.length; i++) transcript.appendChild(renderMessage(state.messages[i], false));
   if (state.activities.length || state.stream) transcript.appendChild(renderMessage({ role: "assistant", text: state.stream, activities: state.activities, activitiesExpanded: state.activityExpanded, toggleActivities: function (expanded) { state.activityExpanded = expanded; } }, true));
+  for (var p = 0; p < state.permissions.length; p++) transcript.appendChild(createSearchPermissionCard(state.permissions[p], respondToPermission));
   if (state.processing && !state.stream && !state.activities.length) {
     var progress = progressCopy();
     var pending = document.createElement("div");
@@ -297,7 +315,9 @@ function render() {
   var sendButton = shell.querySelector(".search-clay-send");
   input.placeholder = state.sessionId ? "Message Clay…" : "Starting Clay…";
   input.disabled = !state.sessionId;
-  sendButton.disabled = !state.sessionId || !input.value.trim();
+  sendButton.disabled = state.processing ? (!state.sessionId || state.stopping) : (!state.sessionId || !input.value.trim());
+  sendButton.setAttribute("aria-label", state.processing ? (state.stopping ? "Stopping Clay" : "Stop Clay") : "Send to Clay");
+  sendButton.innerHTML = state.processing ? '<i data-lucide="square" aria-hidden="true"></i>' : '<i data-lucide="arrow-up" aria-hidden="true"></i>';
   var expandButton = shell.querySelector('.search-clay-icon-button[aria-label="Open this conversation in Home"]');
   if (expandButton) expandButton.disabled = !state.sessionId;
   refreshIcons();
@@ -311,7 +331,8 @@ export function startSearchClayChat(query, host, onBack, onClose) {
   backHandler = onBack;
   closeHandler = onClose;
   var startedAt = Date.now();
-  state = { requestId: requestId(), mateId: null, sessionId: null, messages: [{ role: "user", text: clean }], queuedUsers: [], pendingTurns: 1, activities: [], activityExpanded: false, stream: "", draft: "", processing: true, awaitingCompletion: true, activity: "thinking", step: 0, startedAt: startedAt, updatedAt: startedAt };
+  state = { requestId: requestId(), mateId: null, sessionId: null, messages: [{ role: "user", text: clean }], queuedUsers: [], pendingTurns: 1, activities: [], permissions: [], activityExpanded: false, stream: "", draft: "", processing: true, stopping: false, awaitingCompletion: true, activity: "thinking", step: 0, startedAt: startedAt, updatedAt: startedAt, query: clean };
+  store.set({ searchClayChatState: state });
   startProgressTimer();
   render();
   if (!send({ type: "home_clay_ask", requestId: state.requestId, text: clean })) {
@@ -330,6 +351,7 @@ export function attachSearchClayChat(host, onBack, onClose) {
   hostEl = host;
   backHandler = onBack;
   closeHandler = onClose;
+  if (state.processing) send({ type: "home_clay_ask", requestId: state.requestId, text: state.query });
   render();
   return true;
 }
@@ -349,7 +371,7 @@ export function getSearchClayChatSummary() {
 export function detachSearchClayChat() { hostEl = null; }
 
 export function handleSearchClayMessage(msg) {
-  if (!state || !msg || msg.requestId !== state.requestId) return false;
+  if (!isExactSearchControlMessage(state, msg)) return false;
   state.updatedAt = Date.now();
   if (msg.mateId) state.mateId = msg.mateId;
   if (msg.type === "home_mate_session_identity" && msg.sessionId) state.sessionId = msg.sessionId;
@@ -366,6 +388,12 @@ export function handleSearchClayMessage(msg) {
     state.pendingTurns = state.processing ? Math.max(1, state.pendingTurns) : 0;
     if (state.processing) startProgressTimer();
     state.stream = "";
+    state.stopping = false;
+    replaceSearchPermissions(state, msg.pendingPermissions);
+  } else if (msg.type === "home_mate_permission_request" || msg.type === "home_mate_permission_resolved" || msg.type === "home_mate_permission_cancelled") {
+    applySearchPermissionMessage(state, msg);
+  } else if (msg.type === "home_mate_stopping") {
+    state.stopping = true;
   } else if (msg.type === "home_mate_delta") {
     if (!state.awaitingCompletion) return true;
     state.sessionId = msg.sessionId || state.sessionId;
@@ -381,6 +409,7 @@ export function handleSearchClayMessage(msg) {
     state.activityExpanded = false;
     state.pendingTurns = Math.max(0, state.pendingTurns - 1);
     state.processing = state.pendingTurns > 0;
+    state.stopping = false;
     state.awaitingCompletion = state.processing;
     state.startedAt = Date.now();
     if (!state.processing) stopProgressTimer();
@@ -393,6 +422,7 @@ export function handleSearchClayMessage(msg) {
     state.pendingTurns = Math.max(0, state.pendingTurns - 1);
     state.activityExpanded = false;
     state.processing = state.pendingTurns > 0;
+    state.stopping = false;
     state.awaitingCompletion = state.processing;
     state.startedAt = Date.now();
     if (!state.processing) stopProgressTimer();
@@ -400,3 +430,14 @@ export function handleSearchClayMessage(msg) {
   render();
   return true;
 }
+
+store.subscribe(function (appState, previous) {
+  if (!state || appState.connected === previous.connected) return;
+  if (!appState.connected) {
+    replaceSearchPermissions(state, []);
+    state.stopping = false;
+    render();
+    return;
+  }
+  if (state.processing) send({ type: "home_clay_ask", requestId: state.requestId, text: state.query });
+});

package/lib/public/modules/search-clay-controls.js

@@ -0,0 +1,86 @@
+function cleanText(value, fallback) {
+  if (typeof value !== "string") return fallback || "";
+  var clean = value.replace(/[\u0000-\u001f\u007f]/g, " ").replace(/\s+/g, " ").trim();
+  return clean || fallback || "";
+}
+
+export function isExactSearchControlMessage(state, message) {
+  if (!state || !message || message.requestId !== state.requestId) return false;
+  if (state.mateId && message.mateId && message.mateId !== state.mateId) return false;
+  if (state.sessionId) {
+    if (message.type === "home_mate_session_identity") return message.previousSessionId === state.sessionId;
+    if (message.sessionId !== state.sessionId) return false;
+  }
+  return true;
+}
+
+export function replaceSearchPermissions(state, permissions) {
+  state.permissions = Array.isArray(permissions) ? permissions.filter(function (item) {
+    return item && typeof item.permissionRequestId === "string" && item.permissionRequestId;
+  }).map(function (item) {
+    return { permissionRequestId: item.permissionRequestId, toolName: cleanText(item.toolName, "Tool"), toolInput: item.toolInput || {}, decisionReason: cleanText(item.decisionReason, ""), status: "pending" };
+  }) : [];
+}
+
+export function applySearchPermissionMessage(state, message) {
+  if (!isExactSearchControlMessage(state, message)) return false;
+  if (!Array.isArray(state.permissions)) state.permissions = [];
+  var permissionRequestId = message.permissionRequestId;
+  var index = -1;
+  for (var i = 0; i < state.permissions.length; i++) {
+    if (state.permissions[i].permissionRequestId === permissionRequestId) index = i;
+  }
+  if (message.type === "home_mate_permission_request") {
+    var permission = { permissionRequestId: permissionRequestId, toolName: cleanText(message.toolName, "Tool"), toolInput: message.toolInput || {}, decisionReason: cleanText(message.decisionReason, ""), status: "pending" };
+    if (index === -1) state.permissions.push(permission);
+    else state.permissions[index] = permission;
+    return true;
+  }
+  if (index === -1) return true;
+  if (message.type === "home_mate_permission_resolved") {
+    state.permissions[index].status = message.decision === "allow" ? "allowed" : "denied";
+  } else if (message.type === "home_mate_permission_cancelled") {
+    state.permissions[index].status = "cancelled";
+  }
+  return true;
+}
+
+function permissionTarget(permission) {
+  var input = permission.toolInput && typeof permission.toolInput === "object" ? permission.toolInput : {};
+  return cleanText(input.file_path || input.command || input.url || input.query || input.pattern || permission.decisionReason, "Clay needs your approval to continue.");
+}
+
+export function createSearchPermissionCard(permission, onDecision) {
+  var card = document.createElement("section");
+  card.className = "search-clay-permission is-" + permission.status;
+  card.setAttribute("role", "group");
+  card.setAttribute("aria-label", "Permission request for " + permission.toolName);
+  var title = document.createElement("strong");
+  title.textContent = "Allow " + permission.toolName + "?";
+  card.appendChild(title);
+  var target = document.createElement("p");
+  target.textContent = permissionTarget(permission);
+  card.appendChild(target);
+  if (permission.status === "pending" || permission.status === "answering") {
+    var actions = document.createElement("div");
+    var deny = document.createElement("button");
+    deny.type = "button";
+    deny.textContent = "Deny";
+    deny.disabled = permission.status === "answering";
+    deny.addEventListener("click", function () { onDecision(permission, "deny"); });
+    var allow = document.createElement("button");
+    allow.type = "button";
+    allow.className = "is-primary";
+    allow.textContent = "Approve";
+    allow.disabled = permission.status === "answering";
+    allow.addEventListener("click", function () { onDecision(permission, "allow"); });
+    actions.appendChild(deny);
+    actions.appendChild(allow);
+    card.appendChild(actions);
+  } else {
+    var result = document.createElement("small");
+    result.textContent = permission.status === "allowed" ? "Approved" : (permission.status === "denied" ? "Denied" : "Cancelled");
+    card.appendChild(result);
+  }
+  return card;
+}

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=20260908-log-links2");
+@import url("css/command-palette.css?v=20260910-ask-clay-controls1");
 @import url("css/mention.css");
 @import url("css/debate.css");
 @import url("css/home-debate-planning.css");

package/lib/sdk-bridge.js

@@ -866,7 +866,7 @@ function createSDKBridge(opts) {
       }
 
       var _nm = getNotificationsModule();
-      if (_nm) {
+      if (_nm && session.homeClayEntryMode !== "search") {
         _nm.notify("permission_request", {
           title: permissionPushTitle(toolName, input),
           body: permissionPushBody(toolName, input),

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

@@ -267,6 +267,9 @@ function transformEvent(event, mateId, session, requestId, stableSessionId) {
     }
     if (event.type === "tool_executing") return Object.assign({ type: "home_clay_activity", activityId: session._homeClayToolActivityId || "tool:" + (session._homeClayActivityStep || 1), phase: "searching", status: "active", label: searchToolLabel(event.name, event.input), step: session._homeClayActivityStep || 1 }, metadata);
     if (event.type === "tool_result") return Object.assign({ type: "home_clay_activity", activityId: session._homeClayToolActivityId || "tool:" + (session._homeClayActivityStep || 1), phase: event.is_error ? "reconsidering" : "reviewing", status: event.is_error ? "error" : "done", label: event.is_error ? "That lead did not work; trying another route" : "Reviewed the search results", step: session._homeClayActivityStep || 1 }, metadata);
+    if (event.type === "permission_request") return Object.assign({ type: "home_mate_permission_request", permissionRequestId: event.requestId, toolName: event.toolName, toolInput: event.toolInput, decisionReason: event.decisionReason || "" }, metadata);
+    if (event.type === "permission_resolved") return Object.assign({ type: "home_mate_permission_resolved", permissionRequestId: event.requestId, decision: event.decision || "deny" }, metadata);
+    if (event.type === "permission_cancel") return Object.assign({ type: "home_mate_permission_cancelled", permissionRequestId: event.requestId }, metadata);
   }
   if (session && session.homeDebatePlanning === true && HOME_DEBATE_EVENT_TYPES[event.type]) {
     var live = { type: "home_debate_event", eventType: event.type };

package/lib/server-home-chat.js

@@ -224,6 +224,12 @@ function attachHomeChat(deps) {
         messages: historyToHomeChat(session.history || [], session.debateSetupMode === true, session.mateCreationMode === true),
         isProcessing: session.isProcessing === true,
       };
+      if (session.homeClayEntryMode === "search") {
+        payload.pendingPermissions = Object.keys(session.pendingPermissions || {}).map(function (permissionRequestId) {
+          var pending = session.pendingPermissions[permissionRequestId];
+          return { permissionRequestId: permissionRequestId, toolName: pending.toolName, toolInput: pending.toolInput, decisionReason: pending.decisionReason || "" };
+        });
+      }
       if (session.debateSetupMode === true) payload.debatePlanning = true;
       if (session.homeDebatePhase) payload.debatePhase = session.homeDebatePhase;
       if (session.mateCreationMode === true) payload.mateCreation = true;
@@ -388,6 +394,35 @@ function attachHomeChat(deps) {
 
   function handleMessage(ws, msg) {
     if (!msg || typeof msg.type !== "string") return false;
+    if (msg.type === "home_mate_stop" || msg.type === "home_mate_permission_response") {
+      var controlUserId = ws._clayUser ? ws._clayUser.id : null;
+      if (users.isMultiUser() && !controlUserId) {
+        sendError(ws, msg.mateId || null, "Not authenticated.", msg.requestId || null, msg.sessionId || null);
+        return true;
+      }
+      var controlFound = findMateProject(controlUserId, msg.mateId, true);
+      var controlTap = messageTap(ws, msg);
+      var controlManager = controlFound ? controlFound.ctx.getSessionManager() : null;
+      var controlSession = controlManager && controlTap && controlTap.mateId === controlFound.mate.id && controlTap.requestId === msg.requestId
+        ? controlManager.sessions.get(controlTap.sessionId) : null;
+      var controlReference = controlSession ? sessionReference(controlSession) : null;
+      if (!controlFound || !controlSession || controlReference !== msg.sessionId || !ownsSession(controlSession, controlUserId) || controlSession.homeClayEntryMode !== "search") {
+        sendError(ws, msg.mateId || null, "Conversation control is no longer available.", msg.requestId || null, msg.sessionId || null, "session_not_found");
+        return true;
+      }
+      if (msg.type === "home_mate_permission_response") {
+        var controlDecision = msg.decision === "allow" ? "allow" : (msg.decision === "deny" ? "deny" : null);
+        if (!controlDecision || typeof msg.permissionRequestId !== "string" || !controlSession.pendingPermissions[msg.permissionRequestId]) {
+          sendError(ws, controlFound.mate.id, "This permission request is no longer pending.", msg.requestId || null, msg.sessionId || null, "permission_not_found", { toolId: msg.permissionRequestId });
+          return true;
+        }
+        controlFound.ctx.handleHomePermissionResponse(ws, { requestId: msg.permissionRequestId, decision: controlDecision }, controlSession);
+      } else {
+        sendMessage(ws, { type: "home_mate_stopping", mateId: controlFound.mate.id, sessionId: controlReference, requestId: msg.requestId || null });
+        controlFound.ctx.stopHomeSession(controlSession);
+      }
+      return true;
+    }
     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;
     }

package/lib/ws-schema.js

@@ -643,6 +643,8 @@ var schema = {
   "home_mate_sessions_list":  { direction: "c2s", handler: "lib/server-home-chat.js", description: "List the current user's conversations with the selected mate" },
   "home_mate_session_open":   { direction: "c2s", handler: "lib/server-home-chat.js", description: "Open one explicit conversation with the selected mate" },
   "home_mate_send":           { direction: "c2s", handler: "lib/server-home-chat.js", description: "Send a message to the selected mate from the home hub" },
+  "home_mate_stop":           { direction: "c2s", handler: "lib/server-home-chat.js", description: "Stop the exact query-bound global Ask Clay turn" },
+  "home_mate_permission_response": { direction: "c2s", handler: "lib/server-home-chat.js", description: "Answer an exact pending global Ask Clay permission request" },
   "home_mate_new_session":    { direction: "c2s", handler: "lib/server-home-chat.js", description: "Start a fresh embedded session with the selected mate, optionally with a typed creation intent" },
   "home_mate_debate_plan":    { direction: "c2s", handler: "lib/server-home-chat.js", description: "Start a fresh server-seeded debate planning conversation with Clay using an optional prefilled topic" },
   "home_mate_creation_plan":  { direction: "c2s", handler: "lib/server-home-chat.js", description: "Start a fresh server-seeded Mate creation interview with Clay" },
@@ -659,6 +661,10 @@ var schema = {
   "home_mate_model_set":      { direction: "c2s", handler: "lib/server-home-chat.js", description: "Validate and persist the Mate vendor/model, optionally applying it to an exact owned pristine Home draft" },
   "home_mate_history":        { direction: "s2c", handler: "lib/public/modules/home-mate-chat.js", description: "Selected mate's initial or refreshed chat history" },
   "home_clay_activity":       { direction: "s2c", handler: "lib/public/modules/search-clay-chat.js", description: "Sanitized progress stage for a query-bound global-search Clay conversation" },
+  "home_mate_permission_request": { direction: "s2c", handler: "lib/public/modules/search-clay-chat.js", description: "Exact pending permission card for a global Ask Clay conversation" },
+  "home_mate_permission_resolved": { direction: "s2c", handler: "lib/public/modules/search-clay-chat.js", description: "Server-confirmed Ask Clay permission decision" },
+  "home_mate_permission_cancelled": { direction: "s2c", handler: "lib/public/modules/search-clay-chat.js", description: "Server-confirmed Ask Clay permission cancellation" },
+  "home_mate_stopping":       { direction: "s2c", handler: "lib/public/modules/search-clay-chat.js", description: "Server accepted Stop for the exact Ask Clay conversation" },
   "home_mate_session_identity": { direction: "s2c", handler: "lib/public/modules/app-message-router.js", description: "Promote an active Home session from its local reference to its durable runtime identity" },
   "home_mate_sessions_state": { direction: "s2c", handler: "lib/public/modules/home-mate-chat.js", description: "Owned visible Mate conversations with sanitized runtime identity, model, status, and timestamps" },
   "home_mate_delta":          { direction: "s2c", handler: "lib/public/modules/home-mate-chat.js", description: "Selected mate's streaming assistant text delta" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clay-server",
-  "version": "4.0.0",
+  "version": "4.0.1-beta.1",
   "description": "Self-hosted team workspace for Claude Code and Codex. Multi-user, browser-based, with persistent AI mates.",
   "bin": {
     "clay-server": "./bin/cli.js",