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

package/lib/server.js

@@ -16,6 +16,8 @@ var serverMates = require("./server-mates");
 var serverHomeChat = require("./server-home-chat");
 var shouldSuppressHomeResponse = require("./home-response-notifications").shouldSuppressHomeResponse;
 var serverHomePreferences = require("./server-home-preferences");
+var serverDefaultAi = require("./server-default-ai");
+var serverCursorSharing = require("./server-cursor-sharing");
 var serverTools = require("./server-tools");
 var serverAdmin = require("./server-admin");
 var serverSettings = require("./server-settings");
@@ -28,6 +30,8 @@ var { attachMateKnowledgeService } = require("./mate-knowledge-service");
 var serverEmail = require("./server-email");
 var serverGlobalWs = require("./server-global-ws");
 var { parseWsRequestUrl } = require("./ws-request");
+var { attachDurableScheduler } = require("./durable-scheduler");
+var { attachDurableSchedulerLifecycle } = require("./server-durable-scheduler");
 
 var { CONFIG_DIR } = require("./config");
 var { provisionLinuxUser } = require("./os-users");
@@ -185,6 +189,8 @@ function createServer(opts) {
   var onUserProvisioned = opts.onUserProvisioned || null;
   var onUserDeleted = opts.onUserDeleted || null;
   var getRemovedProjects = opts.getRemovedProjects || function () { return []; };
+  var durableScheduler = null;
+  var durableSchedulerLifecycle = null;
 
   // --- Auth module ---
   var auth = serverAuth.attachAuth({
@@ -368,6 +374,26 @@ function createServer(opts) {
     },
     findUserById: function (userId) { return users.findUserById(userId); },
   });
+  var issuesService = require("./issues-service").attachIssuesService({
+    getProjects: function () { return projects; },
+    isMultiUser: function () { return users.isMultiUser(); },
+    canAccessProject: function (userId, status) {
+      if (!status || !status.slug || !onGetProjectAccess) return false;
+      var access = onGetProjectAccess(status.slug);
+      if (!access || access.error) return false;
+      return users.canAccessProject(userId, access) === true;
+    },
+    hasFullProjectAccess: function (userId, status) {
+      if (!status || !status.slug || !onGetProjectAccess) return false;
+      var access = onGetProjectAccess(status.slug);
+      if (!access || access.error) return false;
+      var governing = access.isWorktree && access.parentAccess ? access.parentAccess : access;
+      return users.canAccessProject(userId, governing) === true;
+    },
+    osUsersEnabled: function () { return osUsers; },
+    getOsUserInfoForActor: function (user) { return user && user.linuxUser ? require("./os-users").resolveOsUserInfo(user.linuxUser) : null; },
+    findUserById: function (userId) { return users.findUserById(userId); },
+  });
   // Mate Knowledge reads the synchronized Knowledge records. The Mate list is
   // derived from the owning user alone, so a binding can never span users.
   var mateKnowledgeService = attachMateKnowledgeService({
@@ -1040,6 +1066,8 @@ function createServer(opts) {
   // --- WebSocket ---
   var wss = new WebSocketServer({ noServer: true });
   var homePreferencesHandler = null;
+  var defaultAiService = null;
+  var cursorSharingService = null;
 
   // Slug-less /ws handler: lets a user with no projects yet load the regular
   // app shell and create/add/clone their first one. Only knows about the
@@ -1059,6 +1087,7 @@ function createServer(opts) {
     },
     onConnection: function (ws) {
       sendProjectsUpdatedToClient(ws);
+      if (cursorSharingService) cursorSharingService.sendStateTo(ws);
     },
   });
 
@@ -1302,7 +1331,9 @@ function createServer(opts) {
       },
       workspaceQueryService: workspaceQueryService,
       projectLogsService: projectLogsService,
+      issuesService: issuesService,
       mateKnowledgeService: mateKnowledgeService,
+      durableScheduler: durableScheduler,
       canAccessProjectSlug: function (userId, targetSlug) {
         var target = projects.get(targetSlug);
         if (!target) return false;
@@ -1331,6 +1362,10 @@ function createServer(opts) {
       port: portNum,
       tls: !!tlsOptions,
       authToken: pinHash || null,
+      resolveDefaultAi: function (ws) {
+        if (!defaultAiService) return Promise.resolve({ ready: false, error: "Default AI is not ready." });
+        return defaultAiService.resolveForWs(ws);
+      },
       getProjectCount: function () { return projects.size; },
       getProjectList: function (userId) {
         return getVisibleProjects(userId);
@@ -1460,6 +1495,7 @@ function createServer(opts) {
       onShutdown: onShutdown,
       onRestart: onRestart,
       onDmMessage: handleDmMessage,
+      sendCursorSharingState: function (ws) { if (cursorSharingService) cursorSharingService.sendStateTo(ws); },
       broadcastAll: broadcastAll,
       notificationsModule: _globalNotifications,
       refreshVendorAuthEverywhere: refreshVendorAuthEverywhere,
@@ -1503,6 +1539,11 @@ function createServer(opts) {
     addProject: addProject,
     workspaceQueryService: workspaceQueryService,
     projectLogsService: projectLogsService,
+    issuesService: issuesService,
+    resolveDefaultAi: function (ws) {
+      if (!defaultAiService) return Promise.resolve({ ready: false, error: "Default AI is not ready." });
+      return defaultAiService.resolveForWs(ws);
+    },
   });
 
   homePreferencesHandler = serverHomePreferences.attachHomePreferences({
@@ -1510,6 +1551,9 @@ function createServer(opts) {
     projects: projects,
   });
 
+  defaultAiService = serverDefaultAi.attachDefaultAiService({ users: users, homeChatHandler: homeChatHandler, forEachAppClient: forEachAppClient });
+  cursorSharingService = serverCursorSharing.attachCursorSharingService({ users: users, forEachAppClient: forEachAppClient });
+
   // --- User-installed home tools handler ---
   var toolsHandler = serverTools.attachTools({
     users: users,
@@ -1535,6 +1579,8 @@ function createServer(opts) {
   }
 
   function handleDmMessage(ws, msg, routedProjectSlug) {
+    if (cursorSharingService && cursorSharingService.handleMessage(ws, msg)) return true;
+    if (defaultAiService && defaultAiService.handleMessage(ws, msg)) return true;
     if (assignmentService.handleMessage(ws, msg, routedProjectSlug)) return true;
     if (dmHandler.handleMessage(ws, msg)) return true;
     if (mateHandler && mateHandler.handleMessage(ws, msg)) return true;
@@ -1817,8 +1863,24 @@ function createServer(opts) {
     });
   }
 
+  var schedulerNamespace = process.env.CLAY_DEV ? "dev" : "prod";
+  durableScheduler = opts.durableScheduler || attachDurableScheduler({
+    storageDir: path.join(CONFIG_DIR, "scheduler"),
+    namespace: schedulerNamespace,
+    globalConcurrency: opts.schedulerGlobalConcurrency || 4,
+    perOwnerConcurrency: opts.schedulerPerOwnerConcurrency || 1,
+  });
+  durableSchedulerLifecycle = attachDurableSchedulerLifecycle({
+    server: server,
+    scheduler: durableScheduler,
+    onError: function (err) {
+      console.error("[server] Durable scheduler shutdown failed:", err && err.message ? err.message : err);
+    },
+  });
+
   function destroyAll() {
     var shutdowns = [];
+    shutdowns.push(durableSchedulerLifecycle.shutdown());
     projects.forEach(function (ctx, slug) {
       console.log("[server] Destroying project:", slug);
       var result = ctx.destroy();
@@ -1898,6 +1960,7 @@ function createServer(opts) {
     forEachProject: forEachProject,
     destroyProject: removeProject,
     destroyAll: destroyAll,
+    durableScheduler: durableScheduler,
     setProjectLogContextState: setProjectLogContextState,
   };
 }

package/lib/session-notes-mcp-server.js

@@ -6,7 +6,7 @@ var MEMORY_CONTRACT =
   "The sticky-note board persists across sessions and is a user-facing artifact shared with people and Clay agents, not private agent scratch space. " +
   "Default to not writing. Create a note proactively only when the user explicitly asks to remember or track something, or when all of these are true: it will remain useful after the current task and session, it is not already adequately recorded in the repository or another note, and the user would likely be glad to find it on the board a week later. " +
   "Good notes capture an unresolved commitment, durable product decision, user preference, constraint, or handoff that will materially change future work. " +
-  "Important exception for deferred defects: while doing code or technical work, actively create a sticky note when you discover a concrete defect, regression risk, security issue, or data-loss risk that is outside the current session goal and will remain unfixed when the turn ends. Do not wait for the user to ask. Include the observable evidence, affected component, likely impact, and a clear next action. Check active notes first when a duplicate is plausible. Do not create defect notes for speculation, general cleanup ideas, or problems you fixed in the current session. " +
+  "Important exception for deferred defects: while doing code or technical work, actively create a sticky note when you discover a concrete defect, regression risk, security issue, or data-loss risk that is outside the current session goal and will remain unfixed when the turn ends. Do not wait for the user to ask. For a Project Driver session with Issues authority, search, reuse, or create the Issue first and put the primary details there: observable evidence, affected component, impact, and next action. Then make the sticky note only a concise title, one-line actionable cue, and the actual opaque issue: reference; do not duplicate the full defect details in the note. If you lack Issues authority, route through an eligible Project Driver; never invent an issue reference or drop the alert. Check active notes first when a duplicate is plausible. Do not create defect notes for speculation, general cleanup ideas, or problems you fixed in the current session. " +
   "Important exception for deferred proposals: when you propose work (a fix, follow-up, improvement, or next step) and the user defers it rather than declining it (\"let's do that later\", \"next time\", \"after this\"), actively create a sticky note before the topic moves on. Do not wait to be asked. Capture what was proposed, why it mattered, and the agreed timing if any. Deferred agreements scroll out of chat history quickly and are hard to track; the board is where they survive. If the user declines the idea outright, do not write a note. " +
   "Never create a note merely because work is important, lengthy, spans agents or restarts, or might help another agent. Do not record completed work, implementation details, test results, investigation logs, transient blockers, conversation summaries, or announcements of your own activity. When uncertain, do not write. " +
   "Updates are visible too: update only when durable state materially changes. " +

package/lib/session-pair-factory.js

@@ -67,11 +67,11 @@ function attachPairFactory(ctx) {
     throw new Error("model is not available for vendor \"" + vendor + "\": " + requested);
   }
 
-  function validateEffort(vendor, effort) {
+  function validateEffort(vendor, effort, exact) {
     var requested = typeof effort === "string" ? effort.trim() : "";
     var fallback = (sm.currentEffortByVendor && sm.currentEffortByVendor[vendor]) || sm.currentEffort || "medium";
     var clamped = yoke.clampEffort(vendor, requested || fallback) || null;
-    if (requested && !clamped) {
+    if (requested && (!clamped || (exact && clamped !== requested))) {
       throw new Error("reasoning effort is not supported for vendor \"" + vendor + "\": " + requested);
     }
     return clamped;
@@ -79,13 +79,16 @@ function attachPairFactory(ctx) {
 
   // Resolve and validate one session runtime request without creating
   // anything. Throws on the first unusable field.
-  function preflightRuntime(spec, defaultVendor) {
+  function preflightRuntime(spec, defaultVendor, exact) {
     var request = spec || {};
     var vendor = validateVendor((typeof request.vendor === "string" && request.vendor.trim()) || defaultVendor);
+    var info = yoke.getVendorInfo(vendor) || {};
+    if (exact && !(typeof request.model === "string" && request.model.trim())) throw new Error("an explicit model is required for vendor \"" + vendor + "\"");
+    if (exact && Array.isArray(info.effortLevels) && info.effortLevels.length && !(typeof request.effort === "string" && request.effort.trim())) throw new Error("an explicit reasoning effort is required for vendor \"" + vendor + "\"");
     return {
       vendor: vendor,
       model: validateModel(vendor, request.model),
-      effort: validateEffort(vendor, request.effort),
+      effort: validateEffort(vendor, request.effort, exact),
       explicitEffort: !!(typeof request.effort === "string" && request.effort.trim()),
     };
   }
@@ -227,6 +230,39 @@ function attachPairFactory(ctx) {
     return created;
   }
 
+  function createOwnedPair(ownerId, args) {
+    if (ctx.isMate) throw new Error("Pair sessions are only available in projects");
+    var request = args || {};
+    var driverRuntime = preflightRuntime(request.driver || {}, "claude");
+    var workerRuntime = preflightRuntime(request.worker || {}, null);
+    var driver = sm.createSessionRaw({ ownerId: ownerId || null, vendor: driverRuntime.vendor, model: driverRuntime.model, effort: driverRuntime.effort });
+    var worker = null;
+    try {
+      driver.title = request.name ? request.name + " · Driver" : "Scheduled task · Driver";
+      if (driverRuntime.explicitEffort) driver.loopSettings = { effort: driverRuntime.effort };
+      worker = sm.createSessionRaw({ ownerId: ownerId || null, vendor: workerRuntime.vendor, model: workerRuntime.model, effort: workerRuntime.effort });
+      worker.title = request.name ? request.name + " · Split Worker" : "Scheduled task · Split Worker";
+      if (workerRuntime.explicitEffort) worker.loopSettings = { effort: workerRuntime.effort };
+      sessionProvenance.markWorker(driver, worker, sm.sessions);
+      if (typeof sm.saveSessionFile === "function") { sm.saveSessionFile(driver); sm.saveSessionFile(worker); }
+      var result = store.createOwned(ownerId || null, { members: [driver.localId, worker.localId], pair: { driverId: driver.localId, workerId: worker.localId }, name: request.name || "Scheduled task" });
+      if (!result.ok) throw new Error(result.error);
+      sm.broadcastSessionList();
+      return { driver: driver, worker: worker, group: result.group };
+    } catch (error) {
+      removeCreated(worker);
+      removeCreated(driver);
+      throw error;
+    }
+  }
+
+  function removeOwnedPair(ownerId, created) {
+    if (!created || !created.group || !store.dissolveOwned(ownerId || null, created.group.id)) return false;
+    removeCreated(created.worker);
+    removeCreated(created.driver);
+    return true;
+  }
+
   function createPair(ws, msg) {
     try {
       var created = createPairRecord(ws, msg);
@@ -240,6 +276,8 @@ function attachPairFactory(ctx) {
     createPair: createPair,
     createPairRecord: createPairRecord,
     createWorkerForDriver: createWorkerForDriver,
+    createOwnedPair: createOwnedPair,
+    removeOwnedPair: removeOwnedPair,
     preflightRuntime: preflightRuntime,
     preflightWorkerForDriver: preflightWorkerForDriver,
     validateModel: validateModel,

package/lib/session-pair-query-start.js

@@ -0,0 +1,22 @@
+function beginPairQuery(ctx, session, text) {
+  session._queryStartTs = Date.now();
+  var promise = ctx.sdk.startQuery(session, text, undefined, ctx.linuxUser);
+  var owner = {
+    session: session,
+    generation: Number(session._queryGeneration || 0),
+  };
+  session._pairResumeQuery = owner;
+  Promise.resolve(promise).catch(function (error) {
+    var current = ctx.sm.sessions.get(session.localId);
+    var ownsCurrent = current === session && session._pairResumeQuery === owner &&
+      Number(session._queryGeneration || 0) === owner.generation;
+    if (!ownsCurrent) return;
+    delete session._pairResumeQuery;
+    session.isProcessing = false;
+    ctx.sm.sendAndRecord(session, { type: "error", text: error.message || String(error) });
+    ctx.onProcessingChanged();
+  });
+  return owner;
+}
+
+module.exports = { beginPairQuery: beginPairQuery };

package/lib/session-query-tool-bridge.js

@@ -0,0 +1,52 @@
+// Exact-query projection of SDK-owned tools into the project stdio MCP bridge.
+
+var sessionToolTransport = require("./yoke/session-tool-transport");
+
+function normalizeInputSchema(inputSchema) {
+  if (inputSchema && typeof inputSchema.type === "string") return inputSchema;
+  try {
+    var zod = require("zod");
+    var schema = inputSchema && inputSchema.safeParse ? inputSchema : zod.object(inputSchema || {});
+    return zod.toJSONSchema(schema);
+  } catch (e) {
+    return { type: "object", properties: {} };
+  }
+}
+
+function createSessionQueryToolBridge(ctx) {
+  function defs(queryGeneration) {
+    if (!ctx.session || !ctx.sdk || !Number.isInteger(queryGeneration)) return [];
+    return ctx.sdk.getQueryToolDefs(ctx.session, queryGeneration) || [];
+  }
+
+  function listTools(queryGeneration, normalizeToolSchema) {
+    var tools = [];
+    var queryTools = defs(queryGeneration);
+    var normalize = normalizeToolSchema || normalizeInputSchema;
+    for (var i = 0; i < queryTools.length; i++) {
+      var server = sessionToolTransport.bridgeServerForTool(queryTools[i].name);
+      if (!server) continue;
+      tools.push({
+        server: server,
+        name: queryTools[i].name,
+        description: queryTools[i].description || queryTools[i].name,
+        inputSchema: normalize(queryTools[i].inputSchema),
+      });
+    }
+    return tools;
+  }
+
+  function callTool(queryGeneration, serverName, toolName, args) {
+    var queryTools = defs(queryGeneration);
+    for (var i = 0; i < queryTools.length; i++) {
+      if (sessionToolTransport.bridgeServerForTool(queryTools[i].name) !== serverName || queryTools[i].name !== toolName) continue;
+      if (typeof queryTools[i].handler !== "function") return Promise.reject(new Error("Session tool handler unavailable: " + serverName + "/" + toolName));
+      return Promise.resolve(queryTools[i].handler(args || {}));
+    }
+    return null;
+  }
+
+  return { listTools: listTools, callTool: callTool };
+}
+
+module.exports = { createSessionQueryToolBridge: createSessionQueryToolBridge, normalizeInputSchema: normalizeInputSchema };

package/lib/session-search.js

@@ -576,7 +576,10 @@ function searchPalette(projectSessions, query, opts) {
   if (allDocs.length === 0) return [];
 
   var index = buildIndex(allDocs);
-  var raw = searchIndex(index, query, maxResults * 3); // over-fetch for dedup
+  // Rank every matching document before deduplication. A session with many
+  // matching turns must not consume the over-fetch window and hide other
+  // matching sessions from the palette.
+  var raw = searchIndex(index, query, allDocs.length);
 
   // Deduplicate: keep best match per session
   var bestPerSession = {};

package/lib/session-split-groups.js

@@ -179,6 +179,40 @@ function createSplitGroupStore(opts) {
     return { ok: true, group: group };
   }
 
+  function createOwned(ownerId, msg) {
+    var members = msg && msg.members;
+    if (!Array.isArray(members) || members.length !== 2) return { ok: false, error: "A split group requires exactly two sessions" };
+    var left = sessions.get(members[0]);
+    var right = sessions.get(members[1]);
+    if (!left || !right || left === right) return { ok: false, error: "Session not found" };
+    if ((left.ownerId || null) !== (ownerId || null) || (right.ownerId || null) !== (ownerId || null)) return { ok: false, error: "Session owner does not match the scheduled task owner" };
+    if (groupForMember(left.localId) || groupForMember(right.localId)) return { ok: false, error: "A session can belong to only one split group" };
+    var pair = msg && msg.pair;
+    if (!pair || pair.driverId !== left.localId || pair.workerId !== right.localId) return { ok: false, error: "Pair roles must reference both split group members" };
+    var requestedName = typeof msg.name === "string" ? msg.name.trim().slice(0, 80) : "";
+    var group = {
+      id: "sg_" + Date.now().toString(36) + "_" + crypto.randomBytes(3).toString("hex"),
+      name: requestedName || autoGroupName(left.title, right.title), nameCustomized: !!requestedName,
+      ownerId: ownerId || null, members: members.slice(),
+      pair: { driverId: pair.driverId, workerId: pair.workerId }, createdAt: Date.now(),
+    };
+    groups.push(group);
+    try { save(); } catch (error) { groups.pop(); return { ok: false, error: error.message || String(error) }; }
+    broadcast();
+    onPairChanged(group);
+    return { ok: true, group: group };
+  }
+
+  function dissolveOwned(ownerId, id) {
+    var index = groups.findIndex(function (item) { return item.id === id && (item.ownerId || null) === (ownerId || null); });
+    if (index === -1) return false;
+    var removed = groups.splice(index, 1)[0];
+    try { save(); } catch (error) { groups.splice(index, 0, removed); return false; }
+    broadcast();
+    onPairChanged(removed);
+    return true;
+  }
+
   function rename(ws, msg) {
     var group = groups.find(function (item) { return item.id === (msg && msg.id); });
     if (!group) return { ok: false, error: "Split group not found" };
@@ -265,7 +299,7 @@ function createSplitGroupStore(opts) {
   }
 
   load();
-  return { create: create, rename: rename, setPair: setPair, dissolve: dissolve, dissolveBySession: dissolveBySession,
+  return { create: create, createOwned: createOwned, dissolveOwned: dissolveOwned, rename: rename, setPair: setPair, dissolve: dissolve, dissolveBySession: dissolveBySession,
     refreshAutoName: refreshAutoName, refreshAnchors: refreshAnchors,
     listFor: listFor, groupForMember: groupForMember, get groups() { return groups; } };
 }

package/lib/sessions.js

@@ -8,6 +8,8 @@ var hygiene = require("./session-hygiene");
 var backgroundTaskTiming = require("./background-task-timing");
 var sessionProvenance = require("./session-provenance");
 var sessionVisibility = require("./session-visibility");
+var projectAutonomousRun = require("./project-autonomous-run").projectAutonomousRun;
+var restoreStoredRun = require("./project-autonomous-run").restoreStoredRun;
 
 function createSessionManager(opts) {
   var cwd = opts.cwd;
@@ -17,6 +19,8 @@ function createSessionManager(opts) {
   var sendAndRecord = null;      // set after init via setSendAndRecord
   var onSessionDone = opts.onSessionDone || function () {};
   var onSessionDeleted = opts.onSessionDeleted || function () {};
+  var sessionDeletedListeners = [];
+  var sessionViewedListeners = [];
   var onSessionRenamed = opts.onSessionRenamed || function () {};
   var onSessionIdentityAssigned = opts.onSessionIdentityAssigned || function () {};
 
@@ -153,6 +157,7 @@ function createSessionManager(opts) {
       };
       if (session.ownerId) metaObj.ownerId = session.ownerId;
       if (session.vendor) metaObj.vendor = session.vendor;
+      if (session.codexDynamicToolCatalogVersion) metaObj.codexDynamicToolCatalogVersion = session.codexDynamicToolCatalogVersion;
       if (session.model) metaObj.model = session.model;
       if (session.effort) metaObj.effort = session.effort;
       // Persist the session's "born" mode so TUI sessions reappear after a
@@ -167,6 +172,11 @@ function createSessionManager(opts) {
       if (session.dangerouslySkipPermissions) metaObj.dangerouslySkipPermissions = true;
       if (session.permissionMode) metaObj.permissionMode = session.permissionMode;
       if (session.permissionModeBeforeFullAccess) metaObj.permissionModeBeforeFullAccess = session.permissionModeBeforeFullAccess;
+      if (session.autonomousRun) metaObj.autonomousRun = session.autonomousRun;
+      if (session.loopInterviewBrief) metaObj.loopInterviewBrief = session.loopInterviewBrief;
+      if (session.loopInterviewHandoff) metaObj.loopInterviewHandoff = session.loopInterviewHandoff;
+      if (session.scheduledTaskDraft) metaObj.scheduledTaskDraft = session.scheduledTaskDraft;
+      if (session.scheduledTaskRun) metaObj.scheduledTaskRun = session.scheduledTaskRun;
       metaObj.sessionVisibility = sessionVisibility.normalize(session.sessionVisibility);
       if (session.sessionVisibilityExplicit) metaObj.sessionVisibilityExplicit = true;
       if (session.bookmarked) metaObj.bookmarked = true;
@@ -293,6 +303,7 @@ function createSessionManager(opts) {
         lastRewindUuid: m.lastRewindUuid || null,
       };
       if (m.vendor) session.vendor = m.vendor;
+      session.codexDynamicToolCatalogVersion = Number(m.codexDynamicToolCatalogVersion || 0);
       session.model = m.model || deriveSessionModel(loaded[i].history);
       session.effort = m.effort || null;
       if (m.loop) session.loop = m.loop;
@@ -322,6 +333,11 @@ function createSessionManager(opts) {
       session.dangerouslySkipPermissions = session.mode === "tui" && !!m.dangerouslySkipPermissions;
       session.permissionMode = m.permissionMode || (session.mode === "gui" && m.dangerouslySkipPermissions ? "bypassPermissions" : null);
       session.permissionModeBeforeFullAccess = m.permissionModeBeforeFullAccess || null;
+      session.autonomousRun = restoreStoredRun(m.autonomousRun);
+      session.loopInterviewBrief = m.loopInterviewBrief && typeof m.loopInterviewBrief === "object" ? m.loopInterviewBrief : null;
+      session.loopInterviewHandoff = m.loopInterviewHandoff && typeof m.loopInterviewHandoff === "object" ? m.loopInterviewHandoff : null;
+      session.scheduledTaskDraft = m.scheduledTaskDraft && typeof m.scheduledTaskDraft === "object" ? m.scheduledTaskDraft : null;
+      session.scheduledTaskRun = m.scheduledTaskRun && typeof m.scheduledTaskRun === "object" ? m.scheduledTaskRun : null;
       session.terminalId = null;
       session.runtimeMode = null;
       session.runtimeTerminalId = null;
@@ -554,6 +570,13 @@ function createSessionManager(opts) {
       runtimeTerminalId: typeof s.runtimeTerminalId === "number" ? s.runtimeTerminalId : null,
       dangerouslySkipPermissions: !!s.dangerouslySkipPermissions,
       permissionMode: s.permissionMode || null,
+      autonomousRun: s.autonomousRun ? {
+        id: s.autonomousRun.id,
+        state: s.autonomousRun.state,
+        continuationCount: s.autonomousRun.continuationCount || 0,
+        maxContinuations: s.autonomousRun.maxContinuations,
+        deadlineAt: s.autonomousRun.deadlineAt || null,
+      } : null,
     };
   }
 
@@ -636,6 +659,11 @@ function createSessionManager(opts) {
       dangerouslySkipPermissions: !!(sessionOpts && sessionOpts.mode === "tui" && sessionOpts.dangerouslySkipPermissions),
       permissionMode: (sessionOpts && sessionOpts.permissionMode) || null,
       permissionModeBeforeFullAccess: null,
+      autonomousRun: null,
+      loopInterviewBrief: null,
+      loopInterviewHandoff: null,
+      scheduledTaskDraft: null,
+      scheduledTaskRun: null,
       terminalId: null,
       sessionOriginId: null,
     };
@@ -678,6 +706,11 @@ function createSessionManager(opts) {
       dangerouslySkipPermissions: !!(sessionOpts && sessionOpts.mode === "tui" && sessionOpts.dangerouslySkipPermissions),
       permissionMode: (sessionOpts && sessionOpts.permissionMode) || null,
       permissionModeBeforeFullAccess: null,
+      autonomousRun: null,
+      loopInterviewBrief: null,
+      loopInterviewHandoff: null,
+      scheduledTaskDraft: null,
+      scheduledTaskRun: null,
       terminalId: null,
       sessionOriginId: null,
     };
@@ -738,6 +771,9 @@ function createSessionManager(opts) {
     }
 
     _send({ type: "history_done", lastUsage: lastUsage, lastModelUsage: lastModelUsage, lastCost: lastCost, lastStreamInputTokens: lastStreamInputTokens, contextUsage: session.lastContextUsage || null });
+    for (var vi = 0; vi < sessionViewedListeners.length; vi++) {
+      try { sessionViewedListeners[vi](session, targetWs, _send); } catch (e) {}
+    }
   }
 
   function switchSession(localId, targetWs, transform) {
@@ -768,7 +804,7 @@ function createSessionManager(opts) {
     var _capsByVendor = capabilitiesByVendor || {};
     var _sessionVendor = session.vendor || defaultVendor || "claude";
     var _vendorCaps = _capsByVendor[_sessionVendor] || {};
-    _send({ type: "session_switched", id: localId, cliSessionId: session.cliSessionId || null, loop: session.loop || null, vendor: session.vendor || null, model: session.model || null, effort: session.effort || null, hasHistory: (session.history && session.history.length > 0), capabilities: _vendorCaps, isProcessing: !!session.isProcessing, mode: session.mode || "gui", terminalId: typeof session.terminalId === "number" ? session.terminalId : null, runtimeMode: session.runtimeMode || null, runtimeTerminalId: typeof session.runtimeTerminalId === "number" ? session.runtimeTerminalId : null, tuiSuspended: !!session.tuiSuspended, dangerouslySkipPermissions: !!session.dangerouslySkipPermissions, permissionMode: session.permissionMode || null });
+    _send({ type: "session_switched", id: localId, cliSessionId: session.cliSessionId || null, loop: session.loop || null, vendor: session.vendor || null, model: session.model || null, effort: session.effort || null, hasHistory: (session.history && session.history.length > 0), capabilities: _vendorCaps, isProcessing: !!session.isProcessing, mode: session.mode || "gui", terminalId: typeof session.terminalId === "number" ? session.terminalId : null, runtimeMode: session.runtimeMode || null, runtimeTerminalId: typeof session.runtimeTerminalId === "number" ? session.runtimeTerminalId : null, tuiSuspended: !!session.tuiSuspended, dangerouslySkipPermissions: !!session.dangerouslySkipPermissions, permissionMode: session.permissionMode || null, autonomousRun: projectAutonomousRun(session.autonomousRun), loopInterviewBrief: session.loopInterviewBrief || null, loopInterviewHandoff: session.loopInterviewHandoff || null, scheduledTaskDraft: session.scheduledTaskDraft || null });
     // Send vendor-specific slash commands
     var _vendorCmds = slashCommandsByVendor[_sessionVendor] || slashCommands || [];
     _send({ type: "slash_commands", commands: _vendorCmds, vendor: _sessionVendor });
@@ -841,9 +877,14 @@ function createSessionManager(opts) {
     }
 
     sessions.delete(localId);
-    try { onSessionDeleted(localId); } catch (e) {
+    try { onSessionDeleted(localId, session); } catch (e) {
       console.error("[session] Session deletion hook failed:", e.message || e);
     }
+    for (var di = 0; di < sessionDeletedListeners.length; di++) {
+      try { sessionDeletedListeners[di](localId, session); } catch (e) {
+        console.error("[session] Session deletion listener failed:", e.message || e);
+      }
+    }
 
     if (activeSessionId === localId) {
       var remaining = [...sessions.keys()];
@@ -882,9 +923,14 @@ function createSessionManager(opts) {
       try { fs.unlinkSync(sessionFilePath(session.cliSessionId)); } catch(e) {}
     }
     sessions.delete(localId);
-    try { onSessionDeleted(localId); } catch (e) {
+    try { onSessionDeleted(localId, session); } catch (e) {
       console.error("[session] Session deletion hook failed:", e.message || e);
     }
+    for (var di = 0; di < sessionDeletedListeners.length; di++) {
+      try { sessionDeletedListeners[di](localId, session); } catch (e) {
+        console.error("[session] Session deletion listener failed:", e.message || e);
+      }
+    }
   }
 
   function deleteSessionsBulk(localIds, targetWs) {
@@ -1250,6 +1296,8 @@ function createSessionManager(opts) {
     sessions: sessions,
     sessionsDir: sessionsDir,
     setOnSessionDeleted: function (fn) { onSessionDeleted = fn || function () {}; },
+    addOnSessionDeleted: function (fn) { if (typeof fn === "function") sessionDeletedListeners.push(fn); },
+    addOnSessionViewed: function (fn) { if (typeof fn === "function") sessionViewedListeners.push(fn); },
     setOnSessionRenamed: function (fn) { onSessionRenamed = fn || function () {}; },
     setOnSessionIdentityAssigned: function (fn) { onSessionIdentityAssigned = fn || function () {}; },
     notifySessionRenamed: function (localId) { onSessionRenamed(localId); },

package/lib/tool-llm.js

@@ -32,6 +32,7 @@ async function complete(opts) {
     query: {
       cwd: opts.cwd,
       linuxUser: opts.linuxUser || undefined,
+      effort: selection.effort || undefined,
       skipProjectInstructions: true,
       skipSkills: true,
       canUseTool: function () { return Promise.resolve({ behavior: "deny", message: "Capsule LLM calls cannot use tools." }); },

package/lib/users-default-ai-preferences.js

@@ -0,0 +1,80 @@
+// Durable user-scoped Default AI preference storage.
+
+var PREFERENCE_KEY = "defaultAiPreference";
+var LEGACY_KEY = "scheduledTaskInterviewEngine";
+
+function isPlainObject(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+
+function validText(value, maxLength) {
+  return typeof value === "string" && value.length <= maxLength && !/[\u0000-\u001f\u007f]/.test(value);
+}
+
+function validatePreference(value) {
+  if (!isPlainObject(value)) return { ok: false, error: "Default AI preference must be an object." };
+  if (!validText(value.vendor, 40) || !/^[a-z0-9][a-z0-9_-]{0,39}$/.test(value.vendor)) return { ok: false, error: "Default AI vendor is invalid." };
+  if (value.model !== undefined && (!validText(value.model, 200) || (value.model !== "" && (value.model.trim() !== value.model || value.model.trim() === "")))) return { ok: false, error: "Default AI model is invalid." };
+  if (value.effort !== undefined && (!validText(value.effort, 40) || (value.effort !== "" && (value.effort.trim() !== value.effort || !/^[a-zA-Z0-9_-]{1,40}$/.test(value.effort))))) return { ok: false, error: "Default AI effort is invalid." };
+  return { ok: true, preference: { vendor: value.vendor, model: value.model === undefined ? "" : value.model, effort: value.effort === undefined ? "" : value.effort } };
+}
+
+function attachDefaultAiPreferences(deps) {
+  var loadUsers = deps.loadUsers;
+  var saveUsers = deps.saveUsers;
+  var isMultiUser = deps.isMultiUser || function () { return false; };
+  var configModule = deps.configModule || require("./config");
+
+  function userRecord(data, userId) {
+    var users = Array.isArray(data.users) ? data.users : [];
+    for (var i = 0; i < users.length; i++) if (users[i] && users[i].id === userId) return users[i];
+    return null;
+  }
+
+  function readValue(value, source) {
+    if (value === undefined) return { present: false, preference: null, source: null };
+    var checked = validatePreference(value);
+    if (!checked.ok) return { present: true, preference: null, source: source, error: checked.error };
+    return { present: true, preference: checked.preference, source: source };
+  }
+
+  function getDefaultAiPreference(userId) {
+    var data;
+    try { data = loadUsers(); } catch (error) { return { present: false, preference: null, source: null, error: "Unable to read Default AI preference: " + (error.message || error) }; }
+    var record = userRecord(data, userId);
+    if (isMultiUser() && !record) return { present: false, preference: null, source: null, error: "User not found." };
+    if (record && Object.prototype.hasOwnProperty.call(record, PREFERENCE_KEY)) return readValue(record[PREFERENCE_KEY], "explicit");
+    if (record && Object.prototype.hasOwnProperty.call(record, LEGACY_KEY)) return readValue(record[LEGACY_KEY], "legacy");
+    if (userId === "default") {
+      var config;
+      try { config = configModule.loadConfig() || {}; } catch (configError) { return { present: false, preference: null, source: null, error: "Unable to read Default AI preference: " + (configError.message || configError) }; }
+      if (Object.prototype.hasOwnProperty.call(config, PREFERENCE_KEY)) return readValue(config[PREFERENCE_KEY], "explicit");
+      if (Object.prototype.hasOwnProperty.call(config, LEGACY_KEY)) return readValue(config[LEGACY_KEY], "legacy");
+    }
+    return { present: false, preference: null, source: null };
+  }
+
+  function setDefaultAiPreference(userId, value) {
+    var checked = validatePreference(value);
+    if (!checked.ok) return { ok: false, error: checked.error };
+    var data;
+    try { data = loadUsers(); } catch (error3) { return { ok: false, error: "Unable to read Default AI preference: " + (error3.message || error3) }; }
+    var record = userRecord(data, userId);
+    if (isMultiUser() && !record) return { ok: false, error: "User not found." };
+    if (record) {
+      var nextData = Object.assign({}, data, { users: (data.users || []).map(function (item) { return item === record ? Object.assign({}, item, { defaultAiPreference: checked.preference }) : item; }) });
+      try { saveUsers(nextData); } catch (error) { return { ok: false, error: "Unable to save Default AI preference: " + (error.message || error) }; }
+      return { ok: true, preference: checked.preference };
+    }
+    if (userId !== "default") return { ok: false, error: "User not found." };
+    try {
+      var current = configModule.loadConfig() || {};
+      configModule.saveConfig(Object.assign({}, current, { defaultAiPreference: checked.preference }));
+      return { ok: true, preference: checked.preference };
+    } catch (error2) { return { ok: false, error: "Unable to save Default AI preference: " + (error2.message || error2) }; }
+  }
+
+  return { getDefaultAiPreference: getDefaultAiPreference, setDefaultAiPreference: setDefaultAiPreference, validatePreference: validatePreference };
+}
+
+module.exports = { attachDefaultAiPreferences: attachDefaultAiPreferences, validatePreference: validatePreference, PREFERENCE_KEY: PREFERENCE_KEY };

package/lib/users-home-surface-preferences.js

@@ -5,7 +5,7 @@ function attachHomeSurfacePreferences(deps) {
   var saveUsers = deps.saveUsers;
 
   function defaults() {
-    return { surface: null, projectSlug: null, activeMateId: null, activeSessionByMate: {}, sidebarCollapsed: false, chatScope: "all", subSurface: "chat" };
+    return { surface: null, projectSlug: null, activeMateId: null, activeSessionByMate: {}, sidebarCollapsed: false, matesCollapsed: false, chatScope: "all", subSurface: "chat" };
   }
 
   function validId(value) {
@@ -37,6 +37,7 @@ function attachHomeSurfacePreferences(deps) {
       activeMateId: validId(source.activeMateId) ? source.activeMateId : null,
       activeSessionByMate: normalizedSessions,
       sidebarCollapsed: source.sidebarCollapsed === true,
+      matesCollapsed: source.matesCollapsed === true,
       chatScope: source.chatScope === "current" ? "current" : "all",
       subSurface: source.subSurface === "debates" ? "debates" : "chat",
     };