clay-server 3.4.0-beta.2 → 3.4.0-beta.20

package/lib/sdk-message-processor.js

@@ -175,6 +175,10 @@ function attachMessageProcessor(ctx) {
 
     // Cache slash_commands and model from CLI init message
     if (parsed.yokeType === "init") {
+      var previousBackgroundTaskCount = (session.activeBackgroundTasks || []).length;
+      session.activeBackgroundTasks = [];
+      sendToSession(session, { type: "active_background_tasks", tasks: [] });
+      if (previousBackgroundTaskCount !== 0) sm.broadcastSessionList();
       var fsSkills = discoverSkillDirs();
       sm.skillNames = mergeSkills(parsed.skills, fsSkills);
       if (parsed.slashCommands) {
@@ -192,13 +196,20 @@ function attachMessageProcessor(ctx) {
         send({ type: "slash_commands", commands: sm.slashCommands });
       }
       if (parsed.model) {
-        sm.currentModel = sm.currentModel || sm._savedDefaultModel || parsed.model;
         var initVendor = session.vendor || (adapter && adapter.vendor) || "claude";
-        send({
+        sm.defaultModelByVendor = sm.defaultModelByVendor || {};
+        sm.defaultModelByVendor[initVendor] = sm.defaultModelByVendor[initVendor] || parsed.model;
+        var initModels = getModelsForVendor(initVendor);
+        var initModel = session.model || sm.defaultModelByVendor[initVendor] || "";
+        if (initModels.length > 0 && !initModels.some(function(entry) {
+          return entry === initModel || (entry && (entry.value === initModel || entry.id === initModel || entry.resolvedModel === initModel));
+        })) initModel = typeof initModels[0] === "string" ? initModels[0] : (initModels[0].value || initModels[0].id || "");
+        sendToSession(session, {
           type: "model_info",
-          model: sm.currentModel,
-          models: getModelsForVendor(initVendor),
+          model: initModel,
+          models: initModels,
           vendor: initVendor,
+          sessionId: session.localId,
           availableVendors: sm.availableVendors || [],
           installedVendors: sm.installedVendors || [],
         });
@@ -612,6 +623,15 @@ function attachMessageProcessor(ctx) {
         });
       }
 
+    } else if (parsed.yokeType === "background_tasks_changed") {
+      var previousBackgroundTaskCount = (session.activeBackgroundTasks || []).length;
+      var activeBackgroundTasks = Array.isArray(parsed.tasks) ? parsed.tasks : [];
+      session.activeBackgroundTasks = activeBackgroundTasks;
+      sendToSession(session, { type: "active_background_tasks", tasks: activeBackgroundTasks });
+      if (previousBackgroundTaskCount !== activeBackgroundTasks.length) {
+        sm.broadcastSessionList();
+      }
+
     } else if (parsed.yokeType === "tool_progress") {
       // Sub-agent tool_progress: forward as activity update
       var parentId = parsed.parentToolId;
@@ -783,6 +803,8 @@ function attachMessageProcessor(ctx) {
       // app-server returned an unauthorized/token-revoked error). Trigger the
       // same login flow as the Claude login-prompt path.
       session.isProcessing = false;
+      session._awaitingTurnResult = false;
+      session._queuedTurnCount = 0;
       onProcessingChanged();
       emitAuthRequired(session);
 

package/lib/session-handoff-context.js

@@ -0,0 +1,110 @@
+var spawnSync = require("child_process").spawnSync;
+var yoke = require("./yoke");
+
+var MAX_CONTEXT_CHARS = 36000;
+var MAX_TURNS = 12;
+var MAX_USER_CHARS = 5000;
+var MAX_ASSISTANT_CHARS = 9000;
+var MAX_GIT_CHARS = 5000;
+var MAX_TRANSCRIPT_CHARS = 24000;
+
+function trimText(value, limit) {
+  var text = typeof value === "string" ? value.trim() : "";
+  if (text.length <= limit) return text;
+  return text.slice(0, limit) + "\n[truncated]";
+}
+
+function recentTurns(history) {
+  var turns = [];
+  var current = null;
+  history = Array.isArray(history) ? history : [];
+  for (var i = 0; i < history.length; i++) {
+    var entry = history[i];
+    if (!entry) continue;
+    if (entry.type === "user_message" || (entry.type === "handoff_context" && entry.request)) {
+      current = { user: trimText(entry.text || entry.request, MAX_USER_CHARS), assistant: "" };
+      turns.push(current);
+    } else if (entry.type === "delta" && entry.text) {
+      if (!current) {
+        current = { user: "", assistant: "" };
+        turns.push(current);
+      }
+      current.assistant += entry.text;
+      if (current.assistant.length > MAX_ASSISTANT_CHARS) {
+        current.assistant = current.assistant.slice(-MAX_ASSISTANT_CHARS);
+      }
+    }
+  }
+  return turns.slice(-MAX_TURNS);
+}
+
+function latestUserRequest(history) {
+  var turns = recentTurns(history);
+  for (var i = turns.length - 1; i >= 0; i--) {
+    if (turns[i].user) return turns[i].user;
+  }
+  return "";
+}
+
+function gitCommand(cwd, args) {
+  var result = spawnSync("git", args, {
+    cwd: cwd,
+    encoding: "utf8",
+    timeout: 5000,
+    maxBuffer: 1024 * 1024,
+  });
+  if (result.error || result.status !== 0) return "";
+  return trimText(result.stdout, MAX_GIT_CHARS);
+}
+
+function repositoryState(cwd) {
+  var status = gitCommand(cwd, ["status", "--short", "--branch"]);
+  var lines = [];
+  lines.push("Working tree:\n" + (status || "clean"));
+  return lines.join("\n\n");
+}
+
+function transcriptText(turns) {
+  var sections = [];
+  for (var i = 0; i < turns.length; i++) {
+    var turn = turns[i];
+    var parts = ["Turn " + (i + 1)];
+    if (turn.user) parts.push("USER:\n" + turn.user);
+    if (turn.assistant) parts.push("ASSISTANT:\n" + trimText(turn.assistant, MAX_ASSISTANT_CHARS));
+    sections.push(parts.join("\n\n"));
+  }
+  while (sections.length > 1 && sections.join("\n\n---\n\n").length > MAX_TRANSCRIPT_CHARS) {
+    sections.shift();
+  }
+  return sections.join("\n\n---\n\n");
+}
+
+function buildHandoffContext(options) {
+  var source = options.source;
+  var targetVendor = options.targetVendor;
+  var sourceVendor = source.vendor || "claude";
+  var sourceName = (yoke.getVendorInfo(sourceVendor) || {}).displayName || sourceVendor;
+  var targetName = (yoke.getVendorInfo(targetVendor) || {}).displayName || targetVendor;
+  var turns = recentTurns(source.history);
+  var latestUser = latestUserRequest(source.history);
+  var parts = [
+    "[Clay session handoff]",
+    "You are continuing work from another Clay coding-agent session. This is a snapshot, not a native conversation resume. Verify the current filesystem state before acting.",
+    "Source agent: " + sourceName,
+    "Target agent: " + targetName,
+    "Source session: " + (source.title || "Untitled session") + " (#" + source.localId + ")",
+  ];
+  if (latestUser) parts.push("Current user request, verbatim:\n" + latestUser);
+  parts.push("Repository state at handoff:\n" + repositoryState(options.cwd));
+  parts.push("Recent conversation:\n" + transcriptText(turns));
+  parts.push("Continue from the unresolved work above. Preserve the user's decisions and constraints, inspect the actual files before making assumptions, and proceed without asking the user to repeat context.");
+  return trimText(parts.join("\n\n"), MAX_CONTEXT_CHARS);
+}
+
+module.exports = {
+  MAX_CONTEXT_CHARS: MAX_CONTEXT_CHARS,
+  buildHandoffContext: buildHandoffContext,
+  latestUserRequest: latestUserRequest,
+  recentTurns: recentTurns,
+  repositoryState: repositoryState,
+};

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

@@ -2,7 +2,14 @@
 
 var buildShape = require("./session-spawn-mcp-server").buildShape;
 
-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. 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, and remove a note created by your session when it stops being useful instead of turning it into a completion log. Put a concise plain-text title on the first line, stay focused on one topic, and include only the context needed for future action.";
+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 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, and remove a note created by your session when it stops being useful instead of turning it into a completion log. Put a concise plain-text title on the first line, stay focused on one topic, and include only the context needed for future action.";
 
 function getToolDefs(handlers) {
   return [

package/lib/sessions.js

@@ -169,6 +169,7 @@ function createSessionManager(opts) {
       if (session.lastRewindUuid) metaObj.lastRewindUuid = session.lastRewindUuid;
       if (session.loop) metaObj.loop = session.loop;
       if (session.spawn) metaObj.spawn = session.spawn;
+      if (session.handoff) metaObj.handoff = session.handoff;
       if (session.debateState) metaObj.debateState = session.debateState;
       if (session.debateSetupMode) metaObj.debateSetupMode = true;
       var meta = JSON.stringify(metaObj);
@@ -281,6 +282,7 @@ function createSessionManager(opts) {
       session.effort = m.effort || null;
       if (m.loop) session.loop = m.loop;
       if (m.spawn) session.spawn = m.spawn;
+      if (m.handoff) session.handoff = m.handoff;
       if (m.debateState) session.debateState = m.debateState;
       if (m.debateSetupMode) session.debateSetupMode = true;
       if (m.ownerId) session.ownerId = m.ownerId;
@@ -493,6 +495,7 @@ function createSessionManager(opts) {
       title: s.title || "New Session",
       active: isActive,
       isProcessing: s.isProcessing,
+      backgroundTaskCount: (s.activeBackgroundTasks || []).length,
       lastActivity: s.lastActivity || s.createdAt || 0,
       loop: loop,
       spawn: s.spawn || null,
@@ -715,6 +718,7 @@ function createSessionManager(opts) {
     if (session.isProcessing) {
       _send({ type: "status", status: "processing" });
     }
+    _send({ type: "active_background_tasks", tasks: session.activeBackgroundTasks || [] });
 
     // Re-send any pending permission requests
     var pendingIds = Object.keys(session.pendingPermissions);

package/lib/worktree.js

@@ -43,9 +43,14 @@ function isWorktree(projectPath) {
   }
 }
 
+function isPathInside(parentPath, candidatePath) {
+  var relative = path.relative(path.resolve(parentPath), path.resolve(candidatePath));
+  return relative !== "" && relative !== ".." && relative.indexOf(".." + path.sep) !== 0 && !path.isAbsolute(relative);
+}
+
 // Scan worktrees for a given project path
-// Returns array of { path, branch, bare, detached, accessible }
-// accessible = true if worktree path is inside parentPath
+// Returns array of { path, branch, bare, detached, external }
+// external = true when Git registered the worktree outside the main project folder
 function scanWorktrees(projectPath) {
   var resolvedParent = path.resolve(projectPath);
   try {
@@ -63,7 +68,7 @@ function scanWorktrees(projectPath) {
       if (wt.bare) continue;
       var resolvedWt = path.resolve(wt.path);
       if (resolvedWt === resolvedParent) continue;
-      wt.accessible = resolvedWt.indexOf(resolvedParent + path.sep) === 0;
+      wt.external = !isPathInside(resolvedParent, resolvedWt);
       wt.dirName = path.basename(wt.path);
       results.push(wt);
     }
@@ -131,4 +136,4 @@ function removeWorktree(projectPath, worktreeDirName) {
   }
 }
 
-module.exports = { scanWorktrees: scanWorktrees, createWorktree: createWorktree, removeWorktree: removeWorktree, isWorktree: isWorktree };
+module.exports = { scanWorktrees: scanWorktrees, createWorktree: createWorktree, removeWorktree: removeWorktree, isWorktree: isWorktree, isPathInside: isPathInside };

package/lib/ws-schema.js

@@ -30,6 +30,8 @@ var schema = {
   "search_session_content":   { direction: "c2s", handler: "lib/project-sessions.js", description: "Full-text search within a session" },
   "load_more_history":        { direction: "c2s", handler: "lib/project-sessions.js", description: "Request older history entries for the current session" },
   "fork_session":             { direction: "c2s", handler: "lib/project-sessions.js", description: "Fork a session from a given message UUID" },
+  "handoff_session":          { direction: "c2s", handler: "lib/project-session-handoff.js", description: "Continue the active session in a newly created agent session" },
+  "handoff_session_options":  { direction: "c2s", handler: "lib/project-session-handoff.js", description: "Request vendors, models, and effort capabilities for the handoff dialog (response reuses the same type)" },
   "input_sync":               { direction: "c2s", handler: "lib/project-sessions.js", description: "Sync the current input field text to other clients" },
   "tui_transcript_request":   { direction: "c2s", handler: "lib/project-sessions.js", description: "Ask for the assistant text index of a Claude TUI session (for hover-to-grab)" },
   "split_group_create":       { direction: "c2s", handler: "lib/session-split-groups.js", description: "Create a persistent two-session split group" },
@@ -49,6 +51,9 @@ var schema = {
   "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" },
+  "session_handoff_result":   { direction: "s2c", handler: "lib/public/modules/session-actions.js", description: "Session handoff result and new target session ID" },
+  "handoff_context":          { direction: "s2c", handler: "lib/public/modules/session-actions.js", description: "Timeline marker identifying the source of a handoff session" },
+  "handoff_created":          { direction: "s2c", handler: "lib/public/modules/session-actions.js", description: "Timeline marker linking a source session to its handoff target" },
   "input_sync_broadcast":     { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Broadcast input text from another client" },
   "tui_transcript_state":     { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Assistant text index for a Claude TUI session (full replace; sent on request and after each new assistant message)" },
   "split_groups":             { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Full persistent split-group list for the current user" },
@@ -109,6 +114,7 @@ var schema = {
   "subagent_done":            { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Subagent task completed" },
   "task_started":             { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Background task started" },
   "task_progress":            { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Background task progress update" },
+  "active_background_tasks":  { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Current background tasks for the active session (full replacement)" },
   "markdown_edit_present":    { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Open a user-requested Markdown edit with a before snapshot" },
 
   // -----------------------------------------------------------------------
@@ -175,7 +181,8 @@ var schema = {
   // -----------------------------------------------------------------------
   // Model / config
   // -----------------------------------------------------------------------
-  "set_model":                { direction: "c2s", handler: "lib/project-sessions.js", description: "Set the model for the current session" },
+  "set_model":                { direction: "c2s", handler: "lib/project-models.js", description: "Set the model for the current session" },
+  "get_vendor_models":        { direction: "c2s", handler: "lib/project-models.js", description: "Load a vendor model catalog" },
   "set_server_default_model": { direction: "c2s", handler: "lib/project-sessions.js", description: "Set the server-wide default model" },
   "set_project_default_model": { direction: "c2s", handler: "lib/project-sessions.js", description: "Set the project default model" },
   "set_permission_mode":      { direction: "c2s", handler: "lib/project-sessions.js", description: "Set permission mode for the current session" },
@@ -192,6 +199,7 @@ var schema = {
   "set_betas":                { direction: "c2s", handler: "lib/project-sessions.js", description: "Set beta feature flags" },
   "set_thinking":             { direction: "c2s", handler: "lib/project-sessions.js", description: "Set thinking mode and budget" },
   "model_info":               { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Current model and available models list" },
+  "model_selection_result":   { direction: "s2c", handler: "lib/public/modules/model-picker.js", description: "Acknowledgement or error for a model selection" },
   "config_state":             { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Full config state: model, mode, effort, betas, thinking" },
   "slash_commands":           { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Available slash commands list" },
   "fast_mode_state":          { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Fast mode toggle state" },

package/lib/yoke/acp-agent-profiles.js

@@ -96,21 +96,16 @@ function validateOpenCodeConfig(config) {
   }
 }
 
+function trustDefaultWhenModeIsNotExposed(ctx, next) {
+  var options = ctx.state && ctx.state.configOptions;
+  for (var i = 0; i < (options || []).length; i++) {
+    if (options[i].category === "mode" || options[i].id === "mode") return next();
+  }
+  if (ctx.state && ctx.state.modes) return next();
+  return Promise.resolve();
+}
+
 var ACP_AGENT_PROFILES = {
-  gemini: {
-    vendor: "gemini",
-    displayName: "Gemini CLI",
-    binaryName: "gemini",
-    overrideName: "GEMINI_CLI_PATH",
-    args: ["--acp", "--approval-mode=default"],
-    defaultModels: ["auto"],
-    defaultModel: "auto",
-    // Gemini advertises loadSession, but releases through 0.46.0 could load
-    // the transcript without restoring the model's conversation memory.
-    // Keep resume gated until Clay's live contract test proves it reliable.
-    sessionResume: false,
-    permissionModeGuaranteed: true,
-  },
   opencode: {
     vendor: "opencode",
     displayName: "OpenCode",
@@ -161,6 +156,61 @@ var ACP_AGENT_PROFILES = {
       return Promise.resolve();
     },
   },
+  kimi: {
+    vendor: "kimi",
+    displayName: "Kimi Code",
+    binaryName: "kimi",
+    overrideName: "KIMI_CLI_PATH",
+    args: ["acp"],
+    defaultModels: ["auto"],
+    defaultModel: "auto",
+    sessionResume: null,
+    ensureSafePermissionMode: trustDefaultWhenModeIsNotExposed,
+  },
+  grok: {
+    vendor: "grok",
+    displayName: "Grok Build",
+    binaryName: "grok",
+    overrideName: "GROK_CLI_PATH",
+    args: ["--no-auto-update", "--permission-mode", "ask", "agent", "stdio"],
+    defaultModels: ["auto"],
+    defaultModel: "auto",
+    sessionResume: null,
+    permissionModeGuaranteed: true,
+  },
+  copilot: {
+    vendor: "copilot",
+    displayName: "GitHub Copilot CLI",
+    binaryName: "copilot",
+    overrideName: "COPILOT_CLI_PATH",
+    args: ["--acp"],
+    defaultModels: ["auto"],
+    defaultModel: "auto",
+    sessionResume: null,
+    ensureSafePermissionMode: trustDefaultWhenModeIsNotExposed,
+  },
+  qwen: {
+    vendor: "qwen",
+    displayName: "Qwen Code",
+    binaryName: "qwen",
+    overrideName: "QWEN_CLI_PATH",
+    args: ["--acp", "--approval-mode", "default"],
+    defaultModels: ["auto"],
+    defaultModel: "auto",
+    sessionResume: null,
+    permissionModeGuaranteed: true,
+  },
+  junie: {
+    vendor: "junie",
+    displayName: "Junie CLI",
+    binaryName: "junie",
+    overrideName: "JUNIE_CLI_PATH",
+    args: ["--acp", "true"],
+    defaultModels: ["auto"],
+    defaultModel: "auto",
+    sessionResume: null,
+    ensureSafePermissionMode: trustDefaultWhenModeIsNotExposed,
+  },
 };
 
 function getAcpAgentProfile(vendor) {