clay-server 4.1.0-beta.5 → 4.1.0-beta.7

package/lib/users-preferences.js

@@ -1,6 +1,7 @@
 function attachPreferences(deps) {
   var loadUsers = deps.loadUsers;
   var saveUsers = deps.saveUsers;
+  var configModule = deps.config || require("./config");
 
   // --- DM Favorites ---
 
@@ -289,6 +290,38 @@ function attachPreferences(deps) {
     return { error: "User not found" };
   }
 
+  // --- Per-user cursor sharing preference ---
+
+  function getCursorSharing(userId) {
+    var data = loadUsers();
+    for (var i = 0; i < data.users.length; i++) {
+      if (data.users[i].id === userId) return data.users[i].cursorSharing !== false;
+    }
+    if (userId === "default") {
+      var current = configModule.loadConfig() || {};
+      return current.cursorSharing !== false;
+    }
+    return true;
+  }
+
+  function setCursorSharing(userId, enabled) {
+    if (typeof enabled !== "boolean") return { error: "enabled must be a boolean" };
+    var data = loadUsers();
+    for (var i = 0; i < data.users.length; i++) {
+      if (data.users[i].id === userId) {
+        data.users[i].cursorSharing = enabled;
+        saveUsers(data);
+        return { ok: true, cursorSharing: enabled };
+      }
+    }
+    if (userId === "default") {
+      var current = configModule.loadConfig() || {};
+      configModule.saveConfig(Object.assign({}, current, { cursorSharing: enabled }));
+      return { ok: true, cursorSharing: enabled };
+    }
+    return { error: "User not found" };
+  }
+
   // --- Per-user extra auto-approve patterns ---
   //
   // Strings appended to Clay's managed CLAY_MANAGED_ALLOW list when
@@ -515,6 +548,8 @@ function attachPreferences(deps) {
     setAutoContinue: setAutoContinue,
     getClaudeOpenMode: getClaudeOpenMode,
     setClaudeOpenMode: setClaudeOpenMode,
+    getCursorSharing: getCursorSharing,
+    setCursorSharing: setCursorSharing,
     getClaudeUserAllowList: getClaudeUserAllowList,
     setClaudeUserAllowList: setClaudeUserAllowList,
     getMatesEnabled: getMatesEnabled,

package/lib/users-scheduled-task-preferences.js

@@ -0,0 +1,44 @@
+function attachScheduledTaskPreferences(deps) {
+  function normalize(value) {
+    value = value && typeof value === "object" ? value : {};
+    return {
+      vendor: typeof value.vendor === "string" ? value.vendor.substring(0, 40) : "",
+      model: typeof value.model === "string" ? value.model.substring(0, 200) : "",
+      effort: typeof value.effort === "string" ? value.effort.substring(0, 40) : "",
+    };
+  }
+  function single(load) {
+    try {
+      var config = deps.configModule || require("./config");
+      var current = config.loadConfig() || {};
+      if (load) return normalize(current.scheduledTaskInterviewEngine);
+      return { config: config, current: current };
+    } catch (e) { return load ? normalize(null) : null; }
+  }
+  function get(userId) {
+    var data = deps.loadUsers();
+    for (var i = 0; i < data.users.length; i++) if (data.users[i].id === userId) return normalize(data.users[i].scheduledTaskInterviewEngine);
+    return userId === "default" ? single(true) : normalize(null);
+  }
+  function set(userId, value) {
+    var next = normalize(value);
+    try {
+      var data = deps.loadUsers();
+      for (var i = 0; i < data.users.length; i++) {
+        if (data.users[i].id !== userId) continue;
+        data.users[i].scheduledTaskInterviewEngine = next; deps.saveUsers(data); return { ok: true, preference: next };
+      }
+      if (userId === "default") {
+        var target = single(false);
+        if (!target) return { error: "Unable to save interview engine preference" };
+        target.config.saveConfig(Object.assign({}, target.current, { scheduledTaskInterviewEngine: next }));
+        return { ok: true, preference: next };
+      }
+      return { error: "User not found" };
+    } catch (error) {
+      return { error: "Unable to save interview engine preference: " + (error.message || error) };
+    }
+  }
+  return { get: get, set: set };
+}
+module.exports = { attachScheduledTaskPreferences: attachScheduledTaskPreferences };

package/lib/users.js

@@ -9,6 +9,8 @@ var { attachPreferences } = require("./users-preferences");
 var { attachHomeDockPreferences } = require("./users-home-dock-preferences");
 var { attachHomeSurfacePreferences } = require("./users-home-surface-preferences");
 var { attachExperimentalPreferences } = require("./users-experimental-preferences");
+var { attachScheduledTaskPreferences } = require("./users-scheduled-task-preferences");
+var { attachDefaultAiPreferences } = require("./users-default-ai-preferences");
 
 var USERS_FILE = path.join(CONFIG_DIR, "users.json");
 
@@ -400,6 +402,8 @@ var preferences = attachPreferences({ loadUsers: loadUsers, saveUsers: saveUsers
 var homeDockPreferences = attachHomeDockPreferences({ loadUsers: loadUsers, saveUsers: saveUsers });
 var homeSurfacePreferences = attachHomeSurfacePreferences({ loadUsers: loadUsers, saveUsers: saveUsers });
 var experimentalPreferences = attachExperimentalPreferences({ loadUsers: loadUsers, saveUsers: saveUsers });
+var scheduledTaskPreferences = attachScheduledTaskPreferences({ loadUsers: loadUsers, saveUsers: saveUsers });
+var defaultAiPreferences = attachDefaultAiPreferences({ loadUsers: loadUsers, saveUsers: saveUsers, isMultiUser: auth.isMultiUser });
 
 // Alias auth functions
 var isMultiUser = auth.isMultiUser;
@@ -437,6 +441,8 @@ var getAutoContinue = preferences.getAutoContinue;
 var setAutoContinue = preferences.setAutoContinue;
 var getClaudeOpenMode = preferences.getClaudeOpenMode;
 var setClaudeOpenMode = preferences.setClaudeOpenMode;
+var getCursorSharing = preferences.getCursorSharing;
+var setCursorSharing = preferences.setCursorSharing;
 var getClaudeUserAllowList = preferences.getClaudeUserAllowList;
 var setClaudeUserAllowList = preferences.setClaudeUserAllowList;
 var getMatesEnabled = preferences.getMatesEnabled;
@@ -454,6 +460,10 @@ var getHomeDockPreference = homeDockPreferences.getHomeDockPreference;
 var setHomeDockPreference = homeDockPreferences.setHomeDockPreference;
 var getHomeSurfacePreference = homeSurfacePreferences.getHomeSurfacePreference;
 var setHomeSurfacePreference = homeSurfacePreferences.setHomeSurfacePreference;
+var getScheduledTaskInterviewEngine = scheduledTaskPreferences.get;
+var setScheduledTaskInterviewEngine = scheduledTaskPreferences.set;
+var getDefaultAiPreference = defaultAiPreferences.getDefaultAiPreference;
+var setDefaultAiPreference = defaultAiPreferences.setDefaultAiPreference;
 
 module.exports = {
   USERS_FILE: USERS_FILE,
@@ -513,6 +523,8 @@ module.exports = {
   setAutoContinue: setAutoContinue,
   getClaudeOpenMode: getClaudeOpenMode,
   setClaudeOpenMode: setClaudeOpenMode,
+  getCursorSharing: getCursorSharing,
+  setCursorSharing: setCursorSharing,
   getClaudeUserAllowList: getClaudeUserAllowList,
   setClaudeUserAllowList: setClaudeUserAllowList,
   getMatesEnabled: getMatesEnabled,
@@ -529,6 +541,10 @@ module.exports = {
   setHomeDockPreference: setHomeDockPreference,
   getHomeSurfacePreference: getHomeSurfacePreference,
   setHomeSurfacePreference: setHomeSurfacePreference,
+  getScheduledTaskInterviewEngine: getScheduledTaskInterviewEngine,
+  setScheduledTaskInterviewEngine: setScheduledTaskInterviewEngine,
+  getDefaultAiPreference: getDefaultAiPreference,
+  setDefaultAiPreference: setDefaultAiPreference,
   getDeletedBuiltinKeys: getDeletedBuiltinKeys,
   addDeletedBuiltinKey: addDeletedBuiltinKey,
   removeDeletedBuiltinKey: removeDeletedBuiltinKey,

package/lib/workspace-query-projection.js

@@ -0,0 +1,29 @@
+function createProjection(deps) {
+  var canonicalTurns = deps.canonicalTurns;
+  var sanitizedHistory = deps.sanitizedHistory;
+  var cleanMetadata = deps.cleanMetadata;
+  var sessionRef = deps.sessionRef;
+
+  function sanitizedProject(project, turnLimit) {
+    return {
+      projectSlug: project.projectSlug,
+      projectTitle: project.projectTitle,
+      projectIcon: project.projectIcon,
+      isMate: project.isMate,
+      mateId: project.mateId,
+      sessions: project.sessions.map(function (session) {
+        return {
+          localId: sessionRef(project.projectSlug, session),
+          title: cleanMetadata(session.title || "New Session", 160),
+          createdAt: session.createdAt || 0,
+          lastActivity: session.lastActivity || session.createdAt || 0,
+          history: sanitizedHistory(canonicalTurns(session.history, turnLimit)),
+        };
+      }),
+    };
+  }
+
+  return { sanitizedProject: sanitizedProject };
+}
+
+module.exports = { createProjection: createProjection };

package/lib/workspace-query-service.js

@@ -1,6 +1,7 @@
 var sessionSearch = require("./session-search");
 var builtinMates = require("./builtin-mates");
 var workspaceQueryAccess = require("./workspace-query-access");
+var createProjection = require("./workspace-query-projection").createProjection;
 var crypto = require("crypto");
 
 var MAX_PAGE = 50;
@@ -52,12 +53,12 @@ function sessionRef(projectSlug, session) {
   return "session:" + digest.substring(0, 24);
 }
 
-function canonicalTurns(history) {
+function canonicalTurns(history, maxChars) {
+  var turnLimit = maxChars == null ? MAX_TURN_CHARS : maxChars;
   var turns = [];
   var assistant = "";
-
   function flushAssistant() {
-    var text = cleanText(assistant, MAX_TURN_CHARS);
+    var text = cleanText(assistant, turnLimit);
     if (text) turns.push({ role: "assistant", text: text });
     assistant = "";
   }
@@ -69,11 +70,11 @@ function canonicalTurns(history) {
       flushAssistant();
     } else if (event.type === "user_message") {
       flushAssistant();
-      var userText = cleanText(event.text, MAX_TURN_CHARS);
+      var userText = cleanText(event.text, turnLimit);
       if (userText) turns.push({ role: "user", text: userText });
     } else if (event.type === "delta" && typeof event.text === "string") {
       assistant += event.text;
-      if (assistant.length > MAX_TURN_CHARS * 2) assistant = assistant.substring(0, MAX_TURN_CHARS * 2);
+      if (assistant.length > turnLimit * 2) assistant = assistant.substring(0, turnLimit * 2);
     } else if (event.type === "result" || event.type === "done" || event.type === "error") {
       flushAssistant();
     }
@@ -88,9 +89,17 @@ function sanitizedHistory(turns) {
     history.push({ type: turns[i].role === "user" ? "user_message" : "delta", text: turns[i].text });
     if (turns[i].role === "assistant") history.push({ type: "result" });
   }
+
   return history;
 }
 
+var projection = createProjection({
+  canonicalTurns: canonicalTurns,
+  sanitizedHistory: sanitizedHistory,
+  cleanMetadata: cleanMetadata,
+  sessionRef: sessionRef,
+});
+
 function sessionActivity(session) {
   if (session.isProcessing) return "processing";
   if (session.pendingPermissions && Object.keys(session.pendingPermissions).length > 0) return "waiting_for_approval";
@@ -283,26 +292,6 @@ function attachWorkspaceQueryService(ctx) {
     var result = page(sessions, args || {});
     return { project: { projectSlug: project.projectSlug, title: project.projectTitle }, sessions: result.items, nextCursor: result.nextCursor, total: result.total };
   }
-
-  function sanitizedProject(project) {
-    return {
-      projectSlug: project.projectSlug,
-      projectTitle: project.projectTitle,
-      projectIcon: project.projectIcon,
-      isMate: project.isMate,
-      mateId: project.mateId,
-      sessions: project.sessions.map(function (session) {
-        return {
-          localId: sessionRef(project.projectSlug, session),
-          title: cleanMetadata(session.title || "New Session", 160),
-          createdAt: session.createdAt || 0,
-          lastActivity: session.lastActivity || session.createdAt || 0,
-          history: sanitizedHistory(canonicalTurns(session.history)),
-        };
-      }),
-    };
-  }
-
   function searchHistory(principal, projectSlug, args) {
     var query = cleanText(args && args.query || "", 500);
     if (!query) throw new Error("A search query is required.");
@@ -319,8 +308,10 @@ function attachWorkspaceQueryService(ctx) {
     }
     var bySlug = {};
     for (var v = 0; v < visible.length; v++) bySlug[visible[v].projectSlug] = visible[v];
-    var projects = visible.map(sanitizedProject);
-    var max = Math.min(100, decodeCursor(args && args.cursor) + parseLimit(args && args.limit, 20) + 20);
+    var projects = visible.map(function (project) {
+      return projection.sanitizedProject(project, Infinity);
+    });
+    var max = decodeCursor(args && args.cursor) + parseLimit(args && args.limit, 20) + 20;
     var ranked = sessionSearch.searchPalette(projects, query, { maxResults: max });
     var offset = decodeCursor(args && args.cursor);
     var limit = parseLimit(args && args.limit, 20);
@@ -345,7 +336,6 @@ function attachWorkspaceQueryService(ctx) {
     }
     return { results: results, nextCursor: offset + limit < ranked.length ? encodeCursor(offset + limit) : null };
   }
-
   function readSession(principal, args) {
     var project = findProject(principal, args && args.projectSlug);
     if (!project) throw new Error("Project not found in the owned workspace.");
@@ -435,7 +425,7 @@ function attachWorkspaceQueryService(ctx) {
     var projects = collect(principal);
     for (var p = 0; p < projects.length; p++) {
       if (excludeSource && projects[p].projectSlug === principal.sourceProjectSlug) continue;
-      var sanitized = sanitizedProject(projects[p]);
+      var sanitized = projection.sanitizedProject(projects[p], MAX_TURN_CHARS);
       for (var s = 0; s < sanitized.sessions.length; s++) {
         sanitized.sessions[s]._projectTitle = sanitized.projectTitle;
         sanitized.sessions[s]._projectSlug = sanitized.projectSlug;

package/lib/ws-schema.js

@@ -20,6 +20,7 @@ var schema = {
   "resume_tui_session":       { direction: "c2s", handler: "lib/project-sessions.js", description: "Spawn the claude --resume PTY for a TUI session shown read-only (lazy resume)" },
   "suspend_tui_session":      { direction: "c2s", handler: "lib/project-sessions.js", description: "Close a live TUI session's PTY now but keep it resumable (explicit Close)" },
   "new_session":              { direction: "c2s", handler: "lib/project-sessions.js", description: "Create a new blank session (opts: vendor, mode, sessionVisibility, dangerouslySkipPermissions)" },
+  "new_session_result":       { direction: "s2c", handler: "lib/public/modules/scheduled-tasks.js", description: "Correlated result for a requested new session" },
   "delete_session":           { direction: "c2s", handler: "lib/project-sessions.js", description: "Delete a session by ID" },
   "rename_session":           { direction: "c2s", handler: "lib/project-sessions.js", description: "Rename a session" },
   "set_session_bookmark":     { direction: "c2s", handler: "lib/project-sessions.js", description: "Bookmark or unbookmark a session in the sidebar" },
@@ -44,6 +45,22 @@ var schema = {
   "project_assignment_response": { direction: "c2s", handler: "lib/workspace-assignment-service.js", description: "Approve or cancel an exact-session cross-project assignment proposal" },
   "home_clay_session_resolve": { direction: "c2s", handler: "lib/server-home-chat.js", description: "Resolve an opaque Mate session reference through the exact bound source session" },
   "home_clay_session_target": { direction: "s2c", handler: "lib/public/modules/command-palette.js", description: "Return an owner-validated navigation target for a rendered Mate session reference" },
+  "issues_list": { direction: "c2s", handler: "lib/project-issues.js", description: "Project Issues issues list" },
+  "issue_read": { direction: "c2s", handler: "lib/project-issues.js", description: "Project Issues issue read" },
+  "issue_create": { direction: "c2s", handler: "lib/project-issues.js", description: "Project Issues issue create" },
+  "issue_update": { direction: "c2s", handler: "lib/project-issues.js", description: "Project Issues issue update" },
+  "issue_history": { direction: "c2s", handler: "lib/project-issues.js", description: "Project Issues issue history" },
+  "issue_revision": { direction: "c2s", handler: "lib/project-issues.js", description: "Project Issues issue revision" },
+  "issue_start_work": { direction: "c2s", handler: "lib/project-issues.js", description: "Project Issues issue start work" },
+  "issue_open_work": { direction: "c2s", handler: "lib/project-issues.js", description: "Project Issues issue open work" },
+  "issue_comment": { direction: "c2s", handler: "lib/project-issues.js", description: "Append an attributed Issue comment" },
+  "issue_delete": { direction: "c2s", handler: "lib/project-issues.js", description: "Delete an Issue (project owner only; append-only tombstone)" },
+  "issues_result": { direction: "s2c", handler: "lib/public/modules/issues.js", description: "Project Issues issues result" },
+  "issue_updated": { direction: "s2c", handler: "lib/public/modules/issues.js", description: "Project Issues issue updated" },
+  "issue_commented": { direction: "s2c", handler: "lib/public/modules/issues.js", description: "Issue after an attributed comment" },
+  "issue_deleted": { direction: "s2c", handler: "lib/public/modules/issues.js", description: "Issue deletion notification" },
+  "issue_reference_resolve": { direction: "c2s", handler: "lib/server-home-chat.js", description: "Project Issues issue reference resolve" },
+  "issue_reference_result": { direction: "s2c", handler: "lib/public/modules/clay-issue-links.js", description: "Project Issues issue reference result" },
   "home_clay_log_resolve":     { direction: "c2s", handler: "lib/server-home-chat.js", description: "Resolve an opaque Project Log reference through the exact bound Clay session" },
   "home_clay_log_target":      { direction: "s2c", handler: "lib/public/modules/command-palette.js", description: "Return an owner-validated project target for a rendered Log reference" },
 
@@ -53,6 +70,17 @@ var schema = {
   "session_presence":         { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Which users are present in which sessions" },
   "session_io":               { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Notify that a session has new output activity" },
   "session_unread":           { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Unread message count for a session" },
+  "scheduled_tasks_list":     { direction: "c2s", handler: "lib/project-scheduled-tasks.js", description: "List project schedules for the active Driver session" },
+  "scheduled_tasks_state":    { direction: "s2c", handler: "lib/public/modules/scheduled-tasks.js", description: "Correlated Scheduled Tasks workbench list" },
+  "scheduled_task_interview_start": { direction: "c2s", handler: "lib/project-scheduled-tasks.js", description: "Begin the built-in interview in a newly selected Driver session" },
+  "scheduled_task_interview_start_result": { direction: "s2c", handler: "lib/public/modules/scheduled-tasks.js", description: "Correlated schedule interview start result" },
+  "scheduled_task_interview_state": { direction: "s2c", handler: "lib/public/modules/scheduled-tasks.js", description: "Session-bound schedule proposal state" },
+  "scheduled_task_manual_start": { direction: "c2s", handler: "lib/project-scheduled-tasks.js", description: "Start or resume a blank manual schedule draft in the current Driver session" },
+  "scheduled_task_manual_start_result": { direction: "s2c", handler: "lib/public/modules/scheduled-tasks.js", description: "Correlated manual schedule draft start result" },
+  "scheduled_task_create":    { direction: "c2s", handler: "lib/project-scheduled-tasks.js", description: "Create a schedule from an exact pending proposal" },
+  "scheduled_task_update":    { direction: "c2s", handler: "lib/project-scheduled-tasks.js", description: "Update an exact schedule revision" },
+  "scheduled_task_cancel":    { direction: "c2s", handler: "lib/project-scheduled-tasks.js", description: "Cancel the active schedule interview or draft" },
+  "scheduled_task_action_result": { direction: "s2c", handler: "lib/public/modules/scheduled-tasks.js", description: "Correlated create or edit result" },
   "search_results":           { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Session title search results" },
   "search_content_results":   { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Full-text content search results" },
   "fork_complete":            { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Fork succeeded, includes new session ID" },
@@ -85,7 +113,7 @@ var schema = {
   // Chat / streaming
   // -----------------------------------------------------------------------
   "message":                  { direction: "c2s", handler: "lib/project-user-message.js", description: "Send an idempotent user chat message; message_ack confirms persistence" },
-  "message_ack":              { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Confirm that an idempotent user chat message was persisted" },
+  "message_ack":              { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Confirm that an idempotent user chat message was persisted, correlated to its exact project session" },
   "user_message":             { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Echo of the user message in the timeline" },
   "delta":                    { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Incremental text delta from the assistant" },
   "result":                   { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Final assistant result text" },
@@ -194,8 +222,20 @@ var schema = {
   "scheduled_message_queued": { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Scheduled message has been queued" },
   "scheduled_message_sent":   { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Scheduled message was sent" },
   "scheduled_message_cancelled": { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Scheduled message was cancelled" },
+  "scheduled_message_state":  { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Authoritative pending scheduled message state after session history replay" },
   "auto_continue_scheduled":  { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Auto-continue was scheduled after rate limit" },
   "auto_continue_fired":      { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Auto-continue timer fired" },
+  "pending_message_get":      { direction: "c2s", handler: "lib/project-user-message.js", description: "Get the exact active session's pending-message queue and canonical paused state" },
+  "pending_message_edit":     { direction: "c2s", handler: "lib/project-user-message.js", description: "Edit owned pending-message text and images using exact session and queue revision guards" },
+  "pending_message_cancel":   { direction: "c2s", handler: "lib/project-user-message.js", description: "Cancel an owned pending or claimed message using exact session and queue revision guards" },
+  "pending_message_reorder":  { direction: "c2s", handler: "lib/project-user-message.js", description: "Reorder the requesting user's pending messages using an exact validated permutation" },
+  "pending_message_resume":   { direction: "c2s", handler: "lib/project-user-message.js", description: "Explicitly resume a canonically paused queue using exact session and queue revision guards" },
+  "pending_message_result":   { direction: "s2c", handler: "lib/public/modules/pending-message-queue.js", description: "Correlated pending-message request result with exact session, project, revision, items, and paused state" },
+  "message_queued":           { direction: "s2c", handler: "lib/public/modules/pending-message-queue.js", description: "Sender acknowledgement that a chat message is represented by pending queue state" },
+  "pending_message_queued":   { direction: "s2c", handler: "lib/public/modules/pending-message-queue.js", description: "Authorized session-viewer notification for a newly queued message" },
+  "pending_message_state":    { direction: "s2c", handler: "lib/public/modules/pending-message-queue.js", description: "Authoritative pending-message queue revision, items, and paused state" },
+  "pending_message_claimed":  { direction: "s2c", handler: "lib/public/modules/pending-message-queue.js", description: "Authorized notification that one pending item is reserved for delivery" },
+  "pending_message_consumed": { direction: "s2c", handler: "lib/public/modules/pending-message-queue.js", description: "Authorized terminal notification after SDK acceptance or delivery failure" },
 
   // -----------------------------------------------------------------------
   // Model / config
@@ -208,6 +248,18 @@ var schema = {
   "set_session_full_access":  { direction: "c2s", handler: "lib/project-sessions.js", description: "Toggle Clay-managed permission skipping for a GUI session" },
   "session_full_access_changed": { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "A session's full-access state changed" },
   "session_full_access_result": { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Result of toggling session full access" },
+  "autonomous_run_arm":        { direction: "c2s", handler: "lib/project-autonomous-run.js", description: "Arm an Until complete task with request identity, limits, and server-persisted success criteria after enabling Skip Permissions" },
+  "loop_interview_start":      { direction: "c2s", handler: "lib/project-loop-interview.js", description: "Start a server-owned built-in Loop interview in the exact current Driver session" },
+  "loop_interview_state":      { direction: "c2s", handler: "lib/project-loop-interview.js", description: "Request the persisted Loop interview brief for the exact current session" },
+  "loop_interview_start_run":  { direction: "c2s", handler: "lib/project-loop-interview.js", description: "Human-approved handoff from a persisted Loop brief into the existing arm lifecycle" },
+  "loop_interview_edit":       { direction: "c2s", handler: "lib/project-loop-interview.js", description: "Edit a persisted Loop brief before human approval" },
+  "loop_interview_cancel":     { direction: "c2s", handler: "lib/project-loop-interview.js", description: "Cancel a persisted Loop brief" },
+  "autonomous_run_disarm":     { direction: "c2s", handler: "lib/project-autonomous-run.js", description: "Deselect an exact armed Until complete run with correlated request and run identity" },
+  "autonomous_run_stop":       { direction: "c2s", handler: "lib/project-autonomous-run.js", description: "Stop an exact active Until complete run with correlated request and run identity" },
+  "autonomous_run_resume":     { direction: "c2s", handler: "lib/project-autonomous-run.js", description: "Explicitly resume an exact run paused after restart with correlated request and run identity" },
+  "autonomous_run_arm_result": { direction: "s2c", handler: "lib/public/modules/autonomous-run.js", description: "Session- and request-correlated Until complete arm acknowledgement with the persisted run criteria" },
+  "autonomous_run_action_result": { direction: "s2c", handler: "lib/public/modules/autonomous-run.js", description: "Session-, run-, and request-correlated Until complete action acknowledgement" },
+  "autonomous_run_state":      { direction: "s2c", handler: "lib/public/modules/autonomous-run.js", description: "Synchronized Until complete run state" },
   "reload_skills":            { direction: "c2s", handler: "lib/project-sessions.js", description: "Hot-reload skills/MCP/agents on the active query without a restart" },
   "set_mcp_permission_mode_override": { direction: "c2s", handler: "lib/project-sessions.js", description: "Override permission mode (default/auto/null) for one MCP server" },
   "set_server_default_mode":  { direction: "c2s", handler: "lib/project-sessions.js", description: "Set the server-wide default permission mode" },
@@ -239,6 +291,9 @@ var schema = {
   "cursor_move":              { direction: "both", handler: "lib/project-sessions.js", description: "Cursor position update from a user" },
   "cursor_leave":             { direction: "both", handler: "lib/project-sessions.js", description: "User cursor left the viewport" },
   "text_select":              { direction: "both", handler: "lib/project-sessions.js", description: "Text selection ranges from a user" },
+  "cursor_sharing_get":        { direction: "c2s", handler: "lib/server-cursor-sharing.js", description: "Request the authenticated user's cursor sharing preference" },
+  "cursor_sharing_set":        { direction: "c2s", handler: "lib/server-cursor-sharing.js", description: "Persist the authenticated user's cursor sharing preference" },
+  "cursor_sharing_state":      { direction: "s2c", handler: "lib/public/modules/cursor-sharing-preference.js", description: "Cursor sharing preference and hydration state" },
 
   // -----------------------------------------------------------------------
   // Push notifications
@@ -660,6 +715,11 @@ var schema = {
   "home_mate_knowledge_list": { direction: "c2s", handler: "lib/server-home-chat.js", description: "Request a correlated read-only knowledge file list for one owned Mate" },
   "home_mate_models_get":     { direction: "c2s", handler: "lib/server-home-chat.js", description: "Request an available vendor and model catalog for the selected Mate" },
   "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" },
+  "default_ai_get":           { direction: "c2s", handler: "lib/server-default-ai.js", description: "Read the authenticated user's shared Default AI and available providers" },
+  "default_ai_catalog_get":   { direction: "c2s", handler: "lib/server-default-ai.js", description: "Read one installed provider catalog for the Default AI picker" },
+  "default_ai_set":           { direction: "c2s", handler: "lib/server-default-ai.js", description: "Validate and persist the authenticated user's shared Default AI" },
+  "default_ai_state":         { direction: "s2c", handler: "lib/public/modules/default-ai.js", description: "Correlated or same-user-broadcast canonical Default AI state" },
+  "default_ai_catalog":       { direction: "s2c", handler: "lib/public/modules/default-ai.js", description: "Correlated Default AI provider catalog" },
   "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" },

package/lib/yoke/adapters/antigravity.js

@@ -345,6 +345,7 @@ function createAntigravityAdapter(opts) {
       elicitation: false,
       fileCheckpointing: false,
       contextCompacting: false,
+      queryBoundTools: { mode: "none", reason: "The current Clay adapter does not forward custom-tool configuration to agy." },
       skillSharing: true,
       toolPolicy: ["ask", "allow-all"],
     };

package/lib/yoke/adapters/claude-worker.js

@@ -162,14 +162,16 @@ function buildZodShape(z, inputSchema) {
     var key = keys[i];
     var prop = props[key];
     var field;
+    var nullable = Array.isArray(prop.type) && prop.type.indexOf("null") !== -1;
+    var propType = nullable ? prop.type.filter(function (type) { return type !== "null"; })[0] : prop.type;
 
-    if (prop.type === "number" || prop.type === "integer") {
+    if (propType === "number" || propType === "integer") {
       field = z.number();
-    } else if (prop.type === "boolean") {
+    } else if (propType === "boolean") {
       field = z.boolean();
-    } else if (prop.type === "array") {
+    } else if (propType === "array") {
       field = z.array(z.any());
-    } else if (prop.type === "object") {
+    } else if (propType === "object") {
       field = z.record(z.any());
     } else if (prop.enum) {
       field = z.enum(prop.enum);
@@ -177,6 +179,7 @@ function buildZodShape(z, inputSchema) {
       field = z.string();
     }
 
+    if (nullable) field = field.nullable();
     if (prop.description) field = field.describe(prop.description);
     if (required.indexOf(key) === -1) field = field.optional();
     shape[key] = field;
@@ -204,8 +207,10 @@ function createWorkerMcpToolHandler(serverName, toolName) {
 function buildMcpServersFromDescriptors(descriptors, sdk) {
   if (!descriptors || !descriptors.length) return null;
   var z;
-  try { z = require("zod").z; } catch (e) {
-    try { z = require("zod"); } catch (e2) { return null; }
+  try { z = require("zod/v3"); } catch (e) {
+    try { z = require("zod").z; } catch (e2) {
+      try { z = require("zod"); } catch (e3) { return null; }
+    }
   }
 
   var servers = {};

package/lib/yoke/adapters/claude.js

@@ -126,6 +126,40 @@ function loadSDKSync() {
   return _sdkSync;
 }
 
+function claudeToolInputSchema(inputSchema) {
+  if (!inputSchema || inputSchema.type !== "object" || !inputSchema.properties) return inputSchema || {};
+  // Claude's SDK bundles a Zod processor that is incompatible with Zod 4
+  // schemas from the daemon's dependency tree. Prefer the compatibility
+  // surface shipped by Zod 4; the fallback keeps older installations working.
+  var zod;
+  try { zod = require("zod/v3"); } catch (e) { zod = require("zod"); }
+  var z = zod.z || zod;
+  var shape = {};
+  var required = inputSchema.required || [];
+  var keys = Object.keys(inputSchema.properties);
+  for (var i = 0; i < keys.length; i++) {
+    var key = keys[i];
+    var property = inputSchema.properties[key] || {};
+    var field;
+    var nullable = Array.isArray(property.type) && property.type.indexOf("null") !== -1;
+    var propertyType = nullable ? property.type.filter(function (type) { return type !== "null"; })[0] : property.type;
+    if (Array.isArray(property.enum) && property.enum.length) field = z.enum(property.enum);
+    else if (propertyType === "integer") field = z.number().int();
+    else if (propertyType === "number") field = z.number();
+    else if (propertyType === "boolean") field = z.boolean();
+    else if (propertyType === "array") field = z.array(z.any());
+    else if (propertyType === "object") field = z.record(z.any());
+    else field = z.string();
+    if (nullable) field = field.nullable();
+    if (typeof property.minimum === "number" && typeof field.min === "function") field = field.min(property.minimum);
+    if (typeof property.maximum === "number" && typeof field.max === "function") field = field.max(property.maximum);
+    if (property.description && typeof field.describe === "function") field = field.describe(property.description);
+    if (required.indexOf(key) === -1) field = field.optional();
+    shape[key] = field;
+  }
+  return shape;
+}
+
 // --- Internal message queue (async iterable for SDK prompt) ---
 function createMessageQueue() {
   var queue = [];
@@ -1466,7 +1500,7 @@ function createClaudeAdapter(opts) {
       var sdkTools = [];
       for (var i = 0; i < def.tools.length; i++) {
         var t = def.tools[i];
-        sdkTools.push(sdk.tool(t.name, t.description, t.inputSchema, t.handler));
+        sdkTools.push(sdk.tool(t.name, t.description, claudeToolInputSchema(t.inputSchema), t.handler));
       }
       return sdk.createSdkMcpServer({
         name: def.name,

package/lib/yoke/adapters/codex.js

@@ -29,6 +29,7 @@ var CODEX_REASONING_DEFAULTS = {
   model_supports_reasoning_summaries: true,
 };
 var DEFAULT_CODEX_MODEL = "gpt-6-astra";
+var CODEX_QUERY_BOUND_TOOL_CAPABILITY = { mode: "dynamic", resume: "persisted-catalog-only" };
 var CODEX_NOTE_TOOLS = {
   list_notes: true,
   write_note: true,
@@ -1476,6 +1477,7 @@ function createCodexAdapter(opts) {
         elicitation: true,
         fileCheckpointing: false,
         contextCompacting: false,
+        queryBoundTools: CODEX_QUERY_BOUND_TOOL_CAPABILITY,
         skillSharing: true,
         toolPolicy: ["ask", "allow-all"],
       },
@@ -1578,6 +1580,7 @@ function createCodexAdapter(opts) {
 
   var adapter = {
     vendor: "codex",
+    queryBoundToolCapability: CODEX_QUERY_BOUND_TOOL_CAPABILITY,
     userInputCapability: { mode: "native", native: true, transport: "item/tool/requestUserInput" },
 
     init: function(initOpts) {

package/lib/yoke/claude-user-input.js

@@ -28,6 +28,8 @@ function elicitation(handler, request, opts) {
 function canUseTool(queryOpts) {
   var original = queryOpts.canUseTool;
   return function (toolName, input, opts) {
+    var validationError = toolName === "AskUserQuestion" && typeof queryOpts.validateUserInputRequest === "function" ? queryOpts.validateUserInputRequest(input) : null;
+    if (validationError) return Promise.resolve({ behavior: "deny", message: validationError });
     if (toolName === "AskUserQuestion" && typeof queryOpts.onUserInputRequest === "function") return ask(queryOpts.onUserInputRequest, input, opts);
     if (toolName === "AskUserQuestion") return Promise.resolve({ behavior: "deny", message: "Use the query's structured input fallback tool." });
     if (original) return original(toolName, input, opts);

package/lib/yoke/index.js

@@ -6,6 +6,7 @@ var instructions = require("./instructions");
 var vendorRegistry = require("./vendor-registry");
 var completeOnce = require("./complete-once").completeOnce;
 var userInput = require("./user-input");
+var sessionTools = require("./session-tool-transport");
 var createClaudeAdapter = require("./adapters/claude").createClaudeAdapter;
 var createCodexAdapter = require("./adapters/codex").createCodexAdapter;
 var createAntigravityAdapter = require("./adapters/antigravity").createAntigravityAdapter;
@@ -477,4 +478,5 @@ module.exports = {
   validateQueryHandle: iface.validateQueryHandle,
   completeOnce: completeOnce,
   userInput: userInput,
+  sessionTools: sessionTools,
 };

package/lib/yoke/mcp-bridge-server.js

@@ -25,6 +25,7 @@ var clayPort = 2633;
 var claySlug = "";
 var clayTls = false;
 var claySessionId = null;
+var clayQueryGeneration = null;
 var sessionOnly = false;
 
 for (var i = 0; i < args.length; i++) {
@@ -40,6 +41,10 @@ for (var i = 0; i < args.length; i++) {
     i++;
   } else if (args[i] === "--tls") {
     clayTls = true;
+  } else if (args[i] === "--query-generation" && args[i + 1]) {
+    clayQueryGeneration = parseInt(args[i + 1], 10);
+    if (!Number.isInteger(clayQueryGeneration)) clayQueryGeneration = null;
+    i++;
   } else if (args[i] === "--session-only") {
     sessionOnly = true;
   }
@@ -115,7 +120,7 @@ function postJson(urlPath, body) {
 
 // --- Fetch tools from Clay ---
 function fetchTools() {
-  return postJson(CLAY_MCP_PATH, { action: "list_tools", sessionId: claySessionId, sessionOnly: sessionOnly }).then(function (resp) {
+  return postJson(CLAY_MCP_PATH, { action: "list_tools", sessionId: claySessionId, queryGeneration: clayQueryGeneration, sessionOnly: sessionOnly }).then(function (resp) {
     if (resp.error) {
       log("Failed to fetch tools: " + resp.error);
       return [];
@@ -142,6 +147,7 @@ function callTool(serverName, toolName, args) {
     tool: toolName,
     args: args || {},
     sessionId: claySessionId,
+    queryGeneration: clayQueryGeneration,
     sessionOnly: sessionOnly,
   });
 }

package/lib/yoke/package.json

@@ -3,5 +3,5 @@
   "version": "0.1.0",
   "description": "YOKE - Yoke Overrides Known Engines. Vendor-independent harness abstraction for Clay.",
   "main": "index.js",
-  "license": "MIT"
+  "license": "AGPL-3.0-only"
 }