clay-server 3.4.0-beta.12 → 3.4.0-beta.14

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

@@ -21,6 +21,7 @@ import { handlePaletteSessionSwitch, setPaletteVersion } from './command-palette
 import { handleFindInSessionResults } from './session-search.js';
 import { syncPaneTitles, maybeRestoreSplitGroup, openGroup } from './split-view.js';
 import { showPairDialog, handlePairCreated, handleSplitDelegation, showWorkerDelegationNotice, hideWorkerDelegationNotice } from './split-pair-ui.js';
+import { handleSessionActionMessage } from './session-actions.js';
 import { renderWorkerProposal, updateWorkerProposal } from './worker-proposal.js';
 import { handleInputSync, autoResize, builtinCommands, setScheduleBtnDisabled, sendShellResultToAgent } from './input.js';
 import { startThinking, appendThinking, stopThinking, resetThinkingGroup, createToolItem, updateToolExecuting, updateToolResult, markAllToolsDone, closeToolGroup, removeToolFromGroup, resetToolState, getTools, getPlanContent, setPlanContent, renderPlanBanner, renderPlanCard, getTodoTools, handleTodoWrite, handleTaskCreate, handleTaskUpdate, applyDeadSessionTodoCompaction, isPlanFilePath, enableMainInput, addTurnMeta, updateSubagentActivity, addSubagentToolEntry, markSubagentDone, initSubagentStop, updateSubagentProgress, updateSubagentTaskStatus, renderAskUserQuestion, markAskUserAnswered, renderPermissionRequest, markPermissionCancelled, markPermissionResolved, renderElicitationRequest, markElicitationResolved, renderUserDialogRequest, markUserDialogResolved, updateThinkingTokens } from './tools.js';
@@ -601,6 +602,13 @@ export function processMessage(msg) {
         if (createdPairGroup) openGroup(createdPairGroup);
         break;
 
+      case "session_handoff_result":
+      case "handoff_session_options":
+      case "handoff_context":
+      case "handoff_created":
+        handleSessionActionMessage(msg);
+        break;
+
       case "worker_proposal":
         renderWorkerProposal(msg);
         break;

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

@@ -814,9 +814,7 @@ export function updateContextPanel() {
       hCtxEl = document.createElement("div");
       hCtxEl.className = "header-context";
       hCtxEl.innerHTML = '<div class="header-context-bar"><div class="header-context-fill"></div></div><span class="header-context-label"></span>';
-      var workerBtn = document.getElementById("header-add-worker-btn");
-      var contextAnchor = workerBtn && workerBtn.parentNode === statusArea ? workerBtn.nextSibling : statusArea.firstChild;
-      statusArea.insertBefore(hCtxEl, contextAnchor);
+      statusArea.insertBefore(hCtxEl, statusArea.firstChild);
       hCtxEl.addEventListener("mouseenter", function() {
         if (store.get('richContextUsage')) {
           showCtxPopover();

package/lib/public/modules/model-picker.js

@@ -238,8 +238,6 @@ export function renderModelPicker() {
     return;
   }
 
-  var caps = s.vendorCapabilities || {};
-  var locked = s.activeSessionMode === "gui" && !!s.sessionHasHistory && !caps.midSessionModelSwitch;
   for (var i = 0; i < s.currentModels.length; i++) {
     var item = s.currentModels[i];
     var value = modelEntryValue(item);
@@ -247,29 +245,18 @@ export function renderModelPicker() {
     var button = document.createElement("button");
     button.className = "config-radio-item";
     if (modelEntryMatches(item, s.currentModel)) button.classList.add("active");
-    if (locked) button.classList.add("locked");
     button.dataset.model = value;
     button.textContent = typeof item === "string" ? item : (item.displayName || value);
     if (s.modelSelectionPending && s.modelSelectionPending.model === value) {
       button.classList.add("pending");
       button.textContent += " · Selecting…";
     }
-    button.disabled = locked || !!s.modelSelectionPending;
-    if (locked) {
-      button.title = "This vendor binds the model when the session starts. Start a new session to change it.";
-    } else {
-      button.addEventListener("click", function() { requestModelSelection(this.dataset.model); });
-    }
+    button.disabled = !!s.modelSelectionPending;
+    button.addEventListener("click", function() { requestModelSelection(this.dataset.model); });
     configModelList.appendChild(button);
   }
 
   if (s.modelSelectionError) {
     appendState("Model selection failed", s.modelSelectionError, false);
   }
-  if (locked) {
-    var hint = document.createElement("div");
-    hint.className = "config-model-hint";
-    hint.textContent = "Locked after first message. Start a new session to change models.";
-    configModelList.appendChild(hint);
-  }
 }

package/lib/public/modules/session-actions.js

@@ -0,0 +1,294 @@
+import { store } from './store.js';
+import { getWs } from './ws-ref.js';
+import { refreshIcons, iconHtml } from './icons.js';
+import { addSystemMessage, VENDOR_AVATARS, VENDOR_NAMES } from './app-rendering.js';
+import { openPairDialog } from './split-pair-ui.js';
+import { buildAgentVendorSelect, fillAgentModels, buildAgentEffortSelect, fillAgentEffort } from './agent-config-selects.js';
+import { showToast } from './utils.js';
+
+var menu = null;
+var button = null;
+var outsideHandler = null;
+var escapeHandler = null;
+var handoffDialog = null;
+var handoffEscapeHandler = null;
+var handoffSubmitButton = null;
+
+function closeMenu() {
+  if (menu) menu.remove();
+  menu = null;
+  if (button) button.setAttribute("aria-expanded", "false");
+  if (outsideHandler) document.removeEventListener("pointerdown", outsideHandler, true);
+  if (escapeHandler) document.removeEventListener("keydown", escapeHandler);
+  outsideHandler = null;
+  escapeHandler = null;
+}
+
+function positionMenu() {
+  if (!menu || !button) return;
+  var rect = button.getBoundingClientRect();
+  var width = menu.offsetWidth;
+  menu.style.top = Math.round(rect.bottom + 6) + "px";
+  menu.style.left = Math.max(8, Math.round(rect.right - width)) + "px";
+}
+
+function actionRow(icon, label, description) {
+  var row = document.createElement("button");
+  row.type = "button";
+  row.className = "session-actions-row";
+  row.innerHTML = iconHtml(icon, "session-actions-row-icon") +
+    '<span class="session-actions-row-copy"><strong></strong><span></span></span>' +
+    iconHtml("chevron-right", "session-actions-row-chevron");
+  row.querySelector("strong").textContent = label;
+  row.querySelector(".session-actions-row-copy > span").textContent = description;
+  return row;
+}
+
+function menuShell(label) {
+  var el = document.createElement("div");
+  el.className = "session-actions-menu";
+  el.setAttribute("role", "menu");
+  el.setAttribute("aria-label", label);
+  document.body.appendChild(el);
+  menu = el;
+  button.setAttribute("aria-expanded", "true");
+  return el;
+}
+
+function installCloseHandlers() {
+  outsideHandler = function (event) {
+    if (menu && !menu.contains(event.target) && event.target !== button && !button.contains(event.target)) closeMenu();
+  };
+  escapeHandler = function (event) {
+    if (event.key === "Escape") {
+      event.preventDefault();
+      closeMenu();
+      if (button) button.focus();
+    }
+  };
+  setTimeout(function () {
+    document.addEventListener("pointerdown", outsideHandler, true);
+    document.addEventListener("keydown", escapeHandler);
+  }, 0);
+}
+
+function closeHandoffDialog() {
+  if (handoffDialog) handoffDialog.remove();
+  if (handoffEscapeHandler) document.removeEventListener("keydown", handoffEscapeHandler);
+  handoffDialog = null;
+  handoffEscapeHandler = null;
+  handoffSubmitButton = null;
+}
+
+function handoffField(labelText, control) {
+  var field = document.createElement("div");
+  field.className = "handoff-modal-field";
+  var label = document.createElement("label");
+  label.className = "wt-modal-label";
+  label.textContent = labelText;
+  field.appendChild(label);
+  field.appendChild(control);
+  return field;
+}
+
+function requestHandoffDialog() {
+  var ws = getWs();
+  if (!ws || ws.readyState !== 1) return;
+  closeMenu();
+  ws.send(JSON.stringify({ type: "handoff_session_options" }));
+}
+
+function showHandoffDialog(options) {
+  closeHandoffDialog();
+  var installed = options.installedVendors || [];
+  var vendorInfo = store.get('vendorInfo') || {};
+  if (store.get('isOsUsers')) {
+    installed = installed.filter(function (vendor) {
+      return !vendorInfo[vendor] || vendorInfo[vendor].osUserIsolation !== false;
+    });
+  }
+  if (installed.length < 1) {
+    showToast("Install a coding agent before continuing this session.", "error");
+    return;
+  }
+
+  var currentVendor = store.get('currentVendor') || "claude";
+  var currentModel = store.get('currentModel') || "";
+  var currentEffort = store.get('currentEffort') || "";
+  var container = document.createElement("div");
+  var overlay = document.createElement("div");
+  overlay.className = "wt-modal-overlay";
+  container.appendChild(overlay);
+  var modal = document.createElement("div");
+  modal.className = "wt-modal handoff-modal";
+  modal.setAttribute("role", "dialog");
+  modal.setAttribute("aria-modal", "true");
+  modal.setAttribute("aria-labelledby", "handoff-modal-title");
+
+  var title = document.createElement("div");
+  title.id = "handoff-modal-title";
+  title.className = "wt-modal-title";
+  title.textContent = "Continue in a new agent";
+  modal.appendChild(title);
+  var desc = document.createElement("div");
+  desc.className = "handoff-modal-desc";
+  desc.textContent = "Start an independent session with a focused copy of this conversation's context.";
+  modal.appendChild(desc);
+
+  var source = document.createElement("div");
+  source.className = "handoff-modal-source";
+  var sourceAvatar = document.createElement("img");
+  sourceAvatar.src = VENDOR_AVATARS[currentVendor] || VENDOR_AVATARS.claude;
+  sourceAvatar.alt = "";
+  source.appendChild(sourceAvatar);
+  var sourceCopy = document.createElement("span");
+  var sourceTitle = document.createElement("strong");
+  sourceTitle.textContent = document.getElementById("header-title").textContent || "Current session";
+  var sourceMeta = document.createElement("span");
+  sourceMeta.textContent = "From " + (VENDOR_NAMES[currentVendor] || currentVendor);
+  sourceCopy.appendChild(sourceTitle);
+  sourceCopy.appendChild(sourceMeta);
+  source.appendChild(sourceCopy);
+  modal.appendChild(source);
+
+  var vendorSelect = buildAgentVendorSelect(installed, currentVendor);
+  var modelSelect = document.createElement("select");
+  modelSelect.className = "wt-modal-input";
+  var effortSelect = buildAgentEffortSelect();
+  var vendorField = handoffField("Agent", vendorSelect);
+  var modelField = handoffField("Model", modelSelect);
+  var effortField = handoffField("Reasoning effort", effortSelect);
+  modal.appendChild(vendorField);
+  modal.appendChild(modelField);
+  modal.appendChild(effortField);
+
+  function syncEffort(preferred) {
+    fillAgentEffort(effortSelect, vendorSelect.value, options, modelSelect.value, preferred);
+    var capabilities = (options.capabilitiesByVendor && options.capabilitiesByVendor[vendorSelect.value]) || {};
+    effortField.style.display = capabilities.effort === false ? "none" : "";
+  }
+  fillAgentModels(modelSelect, vendorSelect.value, options, vendorSelect.value === currentVendor ? currentModel : "");
+  syncEffort(vendorSelect.value === currentVendor ? currentEffort : "");
+  vendorSelect.addEventListener("change", function () {
+    fillAgentModels(modelSelect, vendorSelect.value, options, "");
+    syncEffort("");
+  });
+  modelSelect.addEventListener("change", function () { syncEffort(effortSelect.value); });
+
+  var actions = document.createElement("div");
+  actions.className = "wt-modal-actions";
+  var cancel = document.createElement("button");
+  cancel.type = "button";
+  cancel.className = "wt-modal-btn";
+  cancel.textContent = "Cancel";
+  var submit = document.createElement("button");
+  submit.type = "button";
+  submit.className = "wt-modal-btn primary";
+  submit.textContent = "Continue";
+  actions.appendChild(cancel);
+  actions.appendChild(submit);
+  modal.appendChild(actions);
+  container.appendChild(modal);
+  document.body.appendChild(container);
+  handoffDialog = container;
+  handoffSubmitButton = submit;
+
+  cancel.addEventListener("click", closeHandoffDialog);
+  overlay.addEventListener("click", closeHandoffDialog);
+  handoffEscapeHandler = function (event) {
+    if (event.key === "Escape") closeHandoffDialog();
+  };
+  document.addEventListener("keydown", handoffEscapeHandler);
+  submit.addEventListener("click", function () {
+    var ws = getWs();
+    if (!ws || ws.readyState !== 1) return;
+    ws.send(JSON.stringify({
+      type: "handoff_session",
+      targetVendor: vendorSelect.value,
+      model: modelSelect.value,
+      effort: effortSelect.value,
+    }));
+    submit.disabled = true;
+    submit.textContent = "Continuing…";
+  });
+  vendorSelect.focus();
+}
+
+function showMainMenu() {
+  closeMenu();
+  var el = menuShell("Session actions");
+  var addWorker = actionRow("bot", "Add AI Worker", "Open a second agent beside this session.");
+  addWorker.addEventListener("click", function () {
+    var sessionId = store.get('activeSessionId');
+    if (!sessionId) return;
+    closeMenu();
+    openPairDialog({
+      sessionId: sessionId,
+      title: document.getElementById("header-title").textContent,
+      vendor: store.get('currentVendor') || "claude",
+    });
+  });
+  var handoff = actionRow("forward", "Continue in another agent", "Carry this conversation into a new session.");
+  var unavailable = !store.get('sessionHasHistory') || store.get('sessionIsProcessing');
+  handoff.disabled = unavailable;
+  handoff.title = unavailable ? "Available after the current turn is complete" : "";
+  handoff.addEventListener("click", requestHandoffDialog);
+  el.appendChild(addWorker);
+  el.appendChild(handoff);
+  refreshIcons();
+  positionMenu();
+  installCloseHandlers();
+}
+
+function updateVisibility() {
+  if (!button) return;
+  var state = store.snap();
+  var hidden = !state.activeSessionId || state.dmMode || state.paneMode || !!state.splitPanes || state.activeSessionMode !== "gui";
+  button.classList.toggle("hidden", hidden);
+  if (hidden) closeMenu();
+}
+
+export function initSessionActions() {
+  button = document.getElementById("header-session-actions-btn");
+  if (!button) return;
+  button.addEventListener("click", function () {
+    if (menu) closeMenu();
+    else showMainMenu();
+  });
+  store.subscribe(function (state, prev) {
+    if (state.activeSessionId !== prev.activeSessionId || state.dmMode !== prev.dmMode ||
+        state.paneMode !== prev.paneMode || state.splitPanes !== prev.splitPanes ||
+        state.activeSessionMode !== prev.activeSessionMode) updateVisibility();
+  });
+  window.addEventListener("resize", closeMenu);
+  updateVisibility();
+}
+
+export function handleSessionActionMessage(msg) {
+  if (msg.type === "handoff_session_options") {
+    showHandoffDialog(msg);
+    return true;
+  }
+  if (msg.type === "session_handoff_result") {
+    if (msg.ok) closeHandoffDialog();
+    else {
+      showToast(msg.error || "Could not continue the session in another agent.", "error");
+      if (handoffSubmitButton) {
+        handoffSubmitButton.disabled = false;
+        handoffSubmitButton.textContent = "Continue";
+      }
+    }
+    return true;
+  }
+  if (msg.type === "handoff_context") {
+    var sourceName = VENDOR_NAMES[msg.sourceVendor] || msg.sourceVendor || "another agent";
+    addSystemMessage("Continued from “" + (msg.sourceTitle || "Untitled session") + "” in " + sourceName + ".", false);
+    return true;
+  }
+  if (msg.type === "handoff_created") {
+    var targetName = VENDOR_NAMES[msg.targetVendor] || msg.targetVendor || "another agent";
+    addSystemMessage("Continued in a new " + targetName + " session.", false);
+    return true;
+  }
+  return false;
+}

package/lib/public/modules/split-pair-ui.js

@@ -1,7 +1,7 @@
 import { store } from './store.js';
 import { getWs } from './ws-ref.js';
-import { VENDOR_AVATARS, VENDOR_NAMES, VENDOR_ORDER, isExperimentalVendor } from './app-rendering.js';
-import { effortLevelsFor, effortDisplayName } from './app-panels.js';
+import { VENDOR_AVATARS } from './app-rendering.js';
+import { buildAgentVendorSelect, fillAgentModels, buildAgentEffortSelect, fillAgentEffort } from './agent-config-selects.js';
 import { showToast } from './utils.js';
 
 var pairDialog = null;
@@ -9,78 +9,14 @@ var pairDialog = null;
 // that session becomes the Driver and the dialog only configures the Worker.
 var pendingDriver = null;
 
-function optionValue(entry) {
-  if (typeof entry === "string") return entry;
-  return entry && (entry.value || entry.id) || "";
-}
-
-function optionLabel(entry) {
-  if (typeof entry === "string") return entry;
-  return entry && (entry.displayName || entry.name || entry.value || entry.id) || "";
-}
-
-function fillModels(select, vendor, options) {
-  var models = (options.modelsByVendor && options.modelsByVendor[vendor]) || [];
-  select.innerHTML = "";
-  var automatic = document.createElement("option");
-  automatic.value = "";
-  automatic.textContent = "Automatic";
-  select.appendChild(automatic);
-  for (var i = 0; i < models.length; i++) {
-    var option = document.createElement("option");
-    option.value = optionValue(models[i]);
-    option.textContent = optionLabel(models[i]);
-    select.appendChild(option);
-  }
-}
-
 function closePairDialog() {
   if (pairDialog) pairDialog.remove();
   pairDialog = null;
 }
 
-function buildVendorSelect(installed, preferred) {
-  var select = document.createElement("select");
-  select.className = "wt-modal-input";
-  for (var i = 0; i < VENDOR_ORDER.length; i++) {
-    if (installed.indexOf(VENDOR_ORDER[i]) === -1) continue;
-    var option = document.createElement("option");
-    option.value = VENDOR_ORDER[i];
-    option.textContent = (isExperimentalVendor(VENDOR_ORDER[i]) ? "🧪 " : "") + (VENDOR_NAMES[VENDOR_ORDER[i]] || VENDOR_ORDER[i]);
-    if (isExperimentalVendor(VENDOR_ORDER[i])) option.title = "Experimental integration; not yet validated through direct use testing";
-    select.appendChild(option);
-  }
-  if (preferred && installed.indexOf(preferred) !== -1) select.value = preferred;
-  return select;
-}
-
 // Effort levels are vendor- and model-specific (codex: minimal..xhigh,
 // claude/kiro: low..max, plus per-model supportedEffortLevels overrides), so
 // options are rebuilt whenever the role's vendor or model changes.
-function fillEffortOptions(select, vendor, options, modelValue) {
-  var previous = select.value;
-  var models = (options.modelsByVendor && options.modelsByVendor[vendor]) || [];
-  var levels = effortLevelsFor(vendor, models, modelValue);
-  select.innerHTML = "";
-  var automatic = document.createElement("option");
-  automatic.value = "";
-  automatic.textContent = "Default";
-  select.appendChild(automatic);
-  for (var i = 0; i < levels.length; i++) {
-    var option = document.createElement("option");
-    option.value = levels[i];
-    option.textContent = effortDisplayName(levels[i]);
-    select.appendChild(option);
-  }
-  select.value = levels.indexOf(previous) !== -1 ? previous : "";
-}
-
-function buildEffortSelect() {
-  var select = document.createElement("select");
-  select.className = "wt-modal-input";
-  return select;
-}
-
 function fieldLabel(text, control) {
   var label = document.createElement("label");
   label.className = "wt-modal-label";
@@ -155,25 +91,25 @@ export function showPairDialog(options) {
     : "One Driver plans and directs a visible Worker session.";
   modal.appendChild(desc);
 
-  var driverVendor = buildVendorSelect(installed, installed.indexOf("claude") !== -1 ? "claude" : installed[0]);
+  var driverVendor = buildAgentVendorSelect(installed, installed.indexOf("claude") !== -1 ? "claude" : installed[0]);
   var workerDefault = options.lastVendor && options.lastVendor !== driverVendor.value ? options.lastVendor : (installed.indexOf("codex") !== -1 ? "codex" : installed[0]);
-  var workerVendor = buildVendorSelect(installed, workerDefault);
+  var workerVendor = buildAgentVendorSelect(installed, workerDefault);
   var driverModel = document.createElement("select");
   driverModel.className = "wt-modal-input";
   var workerModel = document.createElement("select");
   workerModel.className = "wt-modal-input";
-  var driverEffort = buildEffortSelect();
-  var workerEffort = buildEffortSelect();
-  function refreshDriverEffort() { fillEffortOptions(driverEffort, driverVendor.value, options, driverModel.value); }
-  function refreshWorkerEffort() { fillEffortOptions(workerEffort, workerVendor.value, options, workerModel.value); }
-  fillModels(driverModel, driverVendor.value, options);
-  fillModels(workerModel, workerVendor.value, options);
+  var driverEffort = buildAgentEffortSelect();
+  var workerEffort = buildAgentEffortSelect();
+  function refreshDriverEffort() { fillAgentEffort(driverEffort, driverVendor.value, options, driverModel.value); }
+  function refreshWorkerEffort() { fillAgentEffort(workerEffort, workerVendor.value, options, workerModel.value); }
+  fillAgentModels(driverModel, driverVendor.value, options);
+  fillAgentModels(workerModel, workerVendor.value, options);
   refreshDriverEffort();
   refreshWorkerEffort();
   workerEffort.value = "medium";
   if (workerEffort.value !== "medium") workerEffort.value = "";
-  driverVendor.addEventListener("change", function () { fillModels(driverModel, driverVendor.value, options); refreshDriverEffort(); });
-  workerVendor.addEventListener("change", function () { fillModels(workerModel, workerVendor.value, options); refreshWorkerEffort(); });
+  driverVendor.addEventListener("change", function () { fillAgentModels(driverModel, driverVendor.value, options); refreshDriverEffort(); });
+  workerVendor.addEventListener("change", function () { fillAgentModels(workerModel, workerVendor.value, options); refreshWorkerEffort(); });
   driverModel.addEventListener("change", refreshDriverEffort);
   workerModel.addEventListener("change", refreshWorkerEffort);
 
@@ -319,7 +255,8 @@ export function syncPairChrome(host, split) {
         setBtn.title = "Make this session the Driver; the other pane becomes its Worker";
         setBtn.addEventListener("click", function () { sendSetPair(group.id, paneSessionId); });
         var titleEl = header.querySelector(".split-pane-title");
-        header.insertBefore(setBtn, titleEl ? titleEl.nextSibling : null);
+        var accessEl = header.querySelector(".split-pane-full-access");
+        header.insertBefore(setBtn, accessEl ? accessEl.nextSibling : (titleEl ? titleEl.nextSibling : null));
       })(split.panes[ai].sessionId, headers[ai]);
     }
     return;
@@ -339,7 +276,8 @@ export function syncPairChrome(host, split) {
         sendSetPair(group.id, isDriver ? null : sessionId);
       });
       var title = header.querySelector(".split-pane-title");
-      header.insertBefore(badge, title ? title.nextSibling : null);
+      var access = header.querySelector(".split-pane-full-access");
+      header.insertBefore(badge, access ? access.nextSibling : (title ? title.nextSibling : null));
     })(split.panes[pi].sessionId, headers[pi]);
   }
   var active = (store.get('splitDelegations') || {})[group.id];

package/lib/public/modules/split-view.js

@@ -231,6 +231,9 @@ function createPane(pane, index) {
     }, "Skip Permissions", true);
   });
   header.appendChild(fullAccess);
+  // Permission state belongs to the session identity on the left. Keep it
+  // immediately after the title instead of grouping it with usage and close.
+  header.insertBefore(fullAccess, ctxChip);
 
   var close = document.createElement("button");
   close.type = "button";

package/lib/public/style.css

@@ -3,6 +3,7 @@
 @import url("css/title-bar.css?v=20260824");
 @import url("css/pane.css");
 @import url("css/worker-proposal.css");
+@import url("css/session-actions.css");
 @import url("css/sidebar.css");
 @import url("css/overlays.css");
 @import url("css/menus.css");

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/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;