clay-server 5.3.0-beta.6 → 5.3.0

package/lib/project-admin-overview.js

@@ -1,4 +1,4 @@
-// This projection is an allowlist. Never add runtime/session/path objects here.
+// Allowlisted display fields and scalar aggregates, never session identities or path/runtime objects.
 function projectMetadata(status, access, users) {
   if (!status || status.isMate || !access || access.error) return null;
   var owner = access.ownerId && users.findUserById(access.ownerId);
@@ -13,6 +13,12 @@ function projectMetadata(status, access, users) {
     administrativeAccess: true,
     ownershipRecovery: access.ownershipRecovery === "required" || !owner,
     runtimeHealth: "Registered",
+    icon: typeof status.icon === 'string' ? status.icon : null,
+    isWorktree: status.isWorktree === true,
+    parentSlug: status.isWorktree === true && typeof status.parentSlug === 'string' ? status.parentSlug : null,
+    sessions: Number.isSafeInteger(status.sessions) && status.sessions >= 0 ? status.sessions : null,
+    clients: Number.isSafeInteger(status.clients) && status.clients >= 0 ? status.clients : null,
+    isProcessing: typeof status.isProcessing === 'boolean' ? status.isProcessing : null,
   };
 }
 
@@ -34,18 +40,23 @@ function page(metadata, projects) {
   var accessText = metadata.ownershipRecovery
     ? "Ownership needs recovery. The server operator must independently verify or repair the authoritative account-to-OS mapping before ownership repair can succeed. Ambiguous records stay restricted; administrator status cannot claim this project. See the Project ownership and administrator access guide."
     : "Only the project owner can change ownership, visibility and sharing. Administrator status does not grant access to private content.";
-  var strip = projects.filter(function (project) { return !project.isMate; }).map(function (project) {
-    return '<a class="icon-strip-item' + (project.slug === metadata.slug ? ' active' : '') + '" href="/p/' + encodeURIComponent(project.slug) + '/" title="' + escape(project.title || project.project) + '"><span class="icon-strip-name">' + escape((project.title || project.project || project.slug).substring(0, 2)) + '</span></a>';
-  }).join("");
+  var navigation = projects.filter(function (project) { return !project.isMate; }).map(function (project) {
+    return { slug: project.slug, title: project.title || project.project || project.slug, icon: typeof project.icon === 'string' ? project.icon : null,
+      isWorktree: project.isWorktree === true, parentSlug: project.parentSlug || null, contentAccess: project.contentAccess !== false };
+  });
+  var payload = JSON.stringify({ project: metadata, projects: navigation }).replace(/</g, "\\u003c");
+  function fact(label, value) { return '<div><dt>' + escape(label) + '</dt><dd>' + escape(value === null ? 'Unavailable' : String(value)) + '</dd></div>'; }
   return '<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>' + escape(metadata.title) + ' · Clay</title>' +
-    '<script src="/appearance-bootstrap.js"></script><link rel="stylesheet" href="/style.css"><link rel="stylesheet" href="/css/project-admin-overview.css"></head><body>' +
-    '<div id="layout"><header id="top-bar"><a href="/" class="top-bar-brand-link" aria-label="Clay home"><span class="top-bar-brand-wordmark"></span></a></header>' +
-    '<div id="layout-body"><nav id="icon-strip" aria-label="Projects"><div class="icon-strip-projects">' + strip + '</div></nav>' +
-    '<main id="main-area" class="project-admin-overview"><div class="project-admin-canvas"><h1>' + escape(metadata.title) + '</h1>' +
+    '<script src="/appearance-bootstrap.js"></script><link rel="stylesheet" href="/style.css"><link rel="stylesheet" href="/css/project-admin-overview.css"></head><body class="project-admin-page">' +
+    '<div id="layout"><header id="top-bar"><a href="/" class="top-bar-brand-link" aria-label="Clay home"><span class="top-bar-brand-wordmark"></span></a><span class="project-admin-role">Server administration</span></header>' +
+    '<div id="layout-body"><nav id="icon-strip" aria-label="Projects"><a class="icon-strip-home" href="/" aria-label="Clay home" data-tip="Clay home"><img class="icon-strip-logo" src="/clay-studio-symbol.png" alt="" width="38" height="38"></a><div class="icon-strip-separator"></div><div class="icon-strip-projects" id="icon-strip-projects"></div></nav>' +
+    '<main id="main-area" class="project-admin-overview"><div class="project-admin-canvas"><div class="project-admin-heading"><div><p class="project-admin-eyebrow">Project overview</p><h1>' + escape(metadata.title) + '</h1><p id="project-admin-parent" hidden></p></div><span class="project-admin-access-badge">Content restricted</span></div>' +
     '<div role="tablist" aria-label="Project information"><button type="button" role="tab" aria-selected="true" id="overview-tab" aria-controls="overview-panel">Overview</button><button type="button" role="tab" aria-selected="false" id="access-tab" aria-controls="access-panel">Access</button></div>' +
-    '<section id="overview-panel" role="tabpanel" aria-labelledby="overview-tab"><dl><dt>Owner</dt><dd>' + escape(metadata.ownerName) + '</dd><dt>Visibility</dt><dd>' + escape(metadata.visibility) + '</dd><dt>Status</dt><dd>' + (metadata.ownershipRecovery ? 'Ownership needs recovery' : escape(metadata.runtimeHealth)) + '</dd><dt>Your access</dt><dd>Administrative metadata only</dd></dl><p>' + escape(privacyText) + '</p><p class="project-admin-secondary">Resource usage is unavailable for this project.</p></section>' +
-    '<section id="access-panel" role="tabpanel" aria-labelledby="access-tab" hidden><h2>Administrative metadata only</h2><p>' + escape(accessText) + '</p></section></div></main></div></div>' +
-    '<script type="module" src="/modules/project-admin-overview.js"></script></body></html>';
+    '<section id="overview-panel" role="tabpanel" aria-labelledby="overview-tab"><dl class="project-admin-facts">' + fact('Owner', metadata.ownerName) + fact('Visibility', metadata.visibility) + fact('Registration', metadata.runtimeHealth) + fact('Sessions', metadata.sessions) + fact('Connected clients', metadata.clients) + fact('Agent activity', metadata.isProcessing === null ? null : metadata.isProcessing ? 'Active turn reported' : 'No active turn reported') + '</dl><p class="project-admin-secondary">Session and activity counts reflect this page load.</p>' +
+    '<section class="project-admin-storage" aria-labelledby="storage-heading"><div class="project-admin-section-heading"><h2 id="storage-heading">Storage</h2><button type="button" id="project-admin-refresh">Refresh usage</button></div><div id="project-admin-usage" aria-busy="true"><dl class="project-admin-metrics"><div><dt>Project allocated</dt><dd id="usage-bytes">—</dd></div><div><dt>Files</dt><dd id="usage-files">—</dd></div><div><dt>Volume available</dt><dd id="usage-free">—</dd></div><div><dt>Volume capacity</dt><dd id="usage-capacity">—</dd></div></dl><p id="usage-status" role="status">Measuring storage…</p><p class="project-admin-secondary">Allocated filesystem blocks, including dependencies. Nested registered projects are counted separately; hard links shared across projects are excluded. Volume space is shared, not a project quota.</p></div></section>' +
+    '<div class="project-admin-notice"><h2>Administrative metadata only</h2><p>' + escape(privacyText) + '</p></div></section>' +
+    '<section id="access-panel" role="tabpanel" aria-labelledby="access-tab" hidden><h2>Administrative metadata only</h2><p>' + escape(accessText) + '</p><dl class="project-admin-facts">' + fact('Owner', metadata.ownerName) + fact('Your access', 'Administrative metadata only') + '</dl></section></div></main></div></div>' +
+    '<script type="application/json" id="project-admin-data">' + payload + '</script><script type="module" src="/modules/project-admin-overview.js"></script></body></html>';
 }
 
 module.exports = { metadataFor: metadataFor, page: page };

package/lib/project-background-tasks.js

@@ -0,0 +1,76 @@
+// Read-only inspection of native background work through its existing query.
+function remember(session, tasks) {
+  var generation = session._sdkQueryGeneration || 0;
+  var catalog = session.backgroundTaskCatalog;
+  if (!catalog || catalog.generation !== generation) catalog = { generation: generation, tasks: [] };
+  var next = (tasks || []).slice(0, 64).map(function (task) {
+    var old = catalog.tasks.find(function (item) { return item.task_id === task.task_id && String(item.run_id || '') === String(task.run_id || ''); });
+    return Object.assign(old || {}, task, { active: true });
+  });
+  catalog.tasks.forEach(function (old) {
+    if (!next.some(function (task) { return task.task_id === old.task_id; })) next.push(Object.assign(old, { active: false }));
+  });
+  catalog.tasks = next.slice(0, 64); session.backgroundTaskCatalog = catalog;
+  return catalog.tasks;
+}
+function observeMessage(session, parsed, send) {
+  if (!parsed || parsed.messageRole !== 'assistant' || !Array.isArray(parsed.content)) return false;
+  var id = session.taskIdMap && session.taskIdMap[parsed.parentToolUseId];
+  var catalog = session.backgroundTaskCatalog;
+  if (!id || !catalog || catalog.generation !== (session._sdkQueryGeneration || 0)) return false;
+  var task = catalog.tasks.find(function (item) { return item.task_id === id && item.active; });
+  if (!task) return false;
+  var text = parsed.content.filter(function (part) { return part && part.type === 'text' && typeof part.text === 'string'; }).map(function (part) { return part.text; }).join('\n').slice(0, 1200);
+  if (!text.trim()) return false;
+  var id = parsed.uuid || String(Date.now());
+  var preview = { id: id, text: text, vendor: session.vendor || null, timestamp: task.preview && task.preview.id === id ? task.preview.timestamp : Date.now() };
+  if (task.preview && task.preview.id === preview.id && task.preview.text === preview.text) return false;
+  task.preview = preview;
+  send(session, { type: 'background_task_preview', taskId: task.task_id, runId: task.run_id || null, sessionOriginId: session.sessionOriginId, preview: preview, live: true });
+  return true;
+}
+function attach(ctx) {
+  var pending = new WeakSet();
+  function authorized(ws, session) {
+    if (!session || ctx.getSessionForWs(ws) !== session || ws.readyState !== 1 || session.destroying) return false;
+    var users = ctx.usersModule;
+    if (!users.isMultiUser()) return !session.ownerId;
+    var user = ws._clayUser;
+    return !!(user && users.findUserById(user.id) && users.canAccessProject(user.id, (ctx.getProjectAccess ? ctx.getProjectAccess() : { visibility: "public" })) &&
+      users.canAccessSession(user.id, session, (ctx.getProjectAccess ? ctx.getProjectAccess() : { visibility: "public" })));
+  }
+  async function read(ws, msg) {
+    var session = ctx.getSessionForWs(ws), query = session && session.queryInstance;
+    var generation = session && session._sdkQueryGeneration;
+    var catalog = session && session.backgroundTaskCatalog;
+    var task = catalog && catalog.generation === (generation || 0) && catalog.tasks.find(function (item) {
+      return item.task_id === msg.taskId && String(item.run_id || '') === String(msg.runId || '');
+    });
+    var actor = ws._clayUser && ws._clayUser.id, cwd = session && session.cwd, owner = session && session.ownerId;
+    var osIdentity = session && ctx.getLinuxUserForSession ? ctx.getLinuxUserForSession(session) : null;
+    var requestId = typeof msg.requestId === 'string' ? msg.requestId.slice(0, 120) : null;
+    function current() { return authorized(ws, session) && ctx.sm.sessions.get(session.localId) === session &&
+      session.sessionOriginId === msg.sessionOriginId && session.queryInstance === query && session._sdkQueryGeneration === generation &&
+      session.cwd === cwd && session.ownerId === owner && (!ctx.getLinuxUserForSession || ctx.getLinuxUserForSession(session) === osIdentity) && (ws._clayUser && ws._clayUser.id) === actor && session.backgroundTaskCatalog === catalog &&
+      catalog.tasks.indexOf(task) >= 0; }
+    function reply(data) { if (authorized(ws, session)) ctx.sendTo(ws, Object.assign({ type: 'background_task_read', requestId: requestId,
+      taskId: msg.taskId, runId: msg.runId || null, sessionOriginId: msg.sessionOriginId }, data)); }
+    if (!requestId || !task || !current() || !query || msg.type === 'background_task_read' && typeof query.readBackgroundTask !== 'function') {
+      reply({ error: 'This task is unavailable in the current session.' }); return;
+    }
+    var reading = msg.type === 'background_task_read';
+    if (reading && pending.has(ws)) { reply({ error: 'A task read is already in progress.' }); return; }
+    if (reading) pending.add(ws);
+    try {
+      var data;
+      if (msg.type === 'background_task_stop') {
+        if (!task.active || typeof query.stopTask !== 'function') throw new Error('Task is no longer running.');
+        await query.stopTask(task.task_id); data = { stopRequested: true };
+      } else data = await query.readBackgroundTask({ taskId: task.task_id, runId: task.run_id || null, offset: msg.offset });
+      if (current()) reply({ data: data });
+    } catch (error) { if (current()) reply({ error: 'Task transcript or output is not available yet.' }); }
+    finally { if (reading) pending.delete(ws); }
+  }
+  return { handleMessage: function (ws, msg) { if (msg.type !== 'background_task_read' && msg.type !== 'background_task_stop') return false; read(ws, msg); return true; } };
+}
+module.exports = { attach: attach, remember: remember, observeMessage: observeMessage };

package/lib/project-connection.js

@@ -334,7 +334,7 @@ function attachConnection(ctx) {
       if (active.isProcessing) {
         sendTo(ws, { type: "status", status: "processing" });
       }
-      sendTo(ws, { type: "active_background_tasks", tasks: active.activeBackgroundTasks || [] });
+      sendTo(ws, { type: "active_background_tasks", tasks: active.activeBackgroundTasks || [], catalog: active.backgroundTaskCatalog && active.backgroundTaskCatalog.tasks || [] });
       var pendingIds = Object.keys(active.pendingPermissions);
       for (var pi = 0; pi < pendingIds.length; pi++) {
         var p = active.pendingPermissions[pendingIds[pi]];

package/lib/project-sessions.js

@@ -93,6 +93,7 @@ function formatAskUserAnswerAsMessage(input, answers) {
 function attachSessions(ctx) {
   var mateDefaultsToken = {};
   var contextUsage = contextUsageModule.attachContextUsage(ctx);
+  var backgroundTaskReader = require("./project-background-tasks").attach(ctx);
   var cwd = ctx.cwd;
   var slug = ctx.slug;
   var isMate = ctx.isMate;
@@ -606,6 +607,7 @@ function attachSessions(ctx) {
     if (workerRemoval.handleMessage(ws, msg)) return true;
     if (serverSettingsMessages.handleServerSettings({ opts: opts, usersModule: usersModule, sendTo: sendTo, send: send }, ws, msg)) return true;
     if (contextUsage.handleMessage(ws, msg)) return true;
+    if (backgroundTaskReader.handleMessage(ws, msg)) return true;
 
     if (msg.type === "push_subscribe") {
       var _pushUserId = ws._clayUser ? ws._clayUser.id : null;
@@ -681,6 +683,9 @@ function attachSessions(ctx) {
         if (creationRequestId) sendTo(ws, { type: "new_session_result", requestId: creationRequestId, ok: false, error: text });
         else sendTo(ws, { type: "error", text: text });
       };
+      if (msg.activate === false && (!creationRequestId || isMate || ws._clayPane || msg.slug !== slug)) {
+        creationFailed("Inactive creation requires this exact project and an ordinary session request."); return true;
+      }
       // The same request id is created at most once per socket.
       if (creationRequestId) {
         if (!ws._createdRequests) ws._createdRequests = [];
@@ -723,7 +728,8 @@ function attachSessions(ctx) {
       // Reuse an existing blank GUI session instead of stacking another
       // one. A vendor-less blank is acceptable: nothing has happened in it,
       // so stamping the requested vendor is equivalent to a fresh create.
-      var reusable = msg.forceNew === true ? null : sm.findReusableBlankSession({
+      var inactiveCreation = msg.activate === false && !!creationRequestId && !isMate && !ws._clayPane;
+      var reusable = msg.forceNew === true || inactiveCreation ? null : sm.findReusableBlankSession({
         vendor: sessionOpts.vendor || null,
         ownerId: sessionOpts.ownerId || null,
       });
@@ -734,9 +740,10 @@ function attachSessions(ctx) {
         sm.switchSession(reusable.localId, ws);
         newSess = reusable;
       } else {
-        newSess = sm.createSession(sessionOpts, ws);
+        newSess = inactiveCreation ? sm.createSessionRaw(sessionOpts) : sm.createSession(sessionOpts, ws);
       }
-      ws._clayActiveSession = newSess.localId;
+      if (!inactiveCreation) ws._clayActiveSession = newSess.localId;
+      else { sm.saveSessionFile(newSess); sm.broadcastSessionList(); }
       var folderPlaced = msg.folderId === undefined ? null : sessionFolders.placeNewSession(ws, newSess, msg.folderId, msg.folderSlug);
       if (msg.requestId) {
         var created = { type: "new_session_result", requestId: String(msg.requestId).substring(0, 200), ok: true, sessionId: newSess.localId };
@@ -758,8 +765,8 @@ function attachSessions(ctx) {
         send({ type: "last_vendor", vendor: msg.vendor });
       }
       var nsPresKey = ws._clayUser ? ws._clayUser.id : "_default";
-      if (!ws._clayPane) userPresence.setPresence(slug, nsPresKey, userPresence.sessionIdForPersistence(newSess), null);
-      if (usersModule.isMultiUser() && !ws._clayPane) {
+      if (!inactiveCreation && !ws._clayPane) userPresence.setPresence(slug, nsPresKey, userPresence.sessionIdForPersistence(newSess), null);
+      if (!inactiveCreation && usersModule.isMultiUser() && !ws._clayPane) {
         broadcastPresence();
       }
       return true;

package/lib/project-split-views.js

@@ -73,6 +73,13 @@ function attachProjectSplitViews(ctx) {
     var accountId = users.isMultiUser() ? ownerId : 'default';
     return typeof users.getSessionFolders === 'function' ? users.getSessionFolders(accountId, ctx.slug).folders.map(function (folder) { return folder.id; }) : [];
   }
+  function destinationFolder(ownerId, view, origin) {
+    var state = typeof users.getSessionFolders === 'function' ? users.getSessionFolders(users.isMultiUser() ? ownerId : 'default', ctx.slug) : null;
+    if (!state) return null;
+    // Singleton Views still appear as session rows and use session placement.
+    var id = view && view.sessionRefs.length !== 1 ? view.folderId : (state.assignments || {})[view ? view.sessionRefs[0].originId : origin];
+    return state.folders.some(function (folder) { return folder.id === id; }) ? id : null;
+  }
   function stateFor(ws) {
     var current = actor(ws);
     if (!current) return null;
@@ -137,10 +144,11 @@ function attachProjectSplitViews(ctx) {
         input.liveSessions = refs.sessions;
         if (action === "update") {
           var exact = verifyStoredView(ws, current, input.id);
-          return exact.ok ? store.update(current.id, current.linuxUser, input, refs.refs) : exact;
+          var inheritedFolder = target && target.sessionRefs.length === 1 && input.sessionOrigins.length > 1 ? destinationFolder(current.id, target) : undefined;
+          return exact.ok ? store.update(current.id, current.linuxUser, input, refs.refs, inheritedFolder) : exact;
         }
         input.nameMode = "automatic";
-        return store.create(current.id, current.linuxUser, input, refs.refs);
+        return store.create(current.id, current.linuxUser, input, refs.refs, destinationFolder(current.id, null, input.activeSessionOriginId));
       }
       if (action === "move") {
         var sourceState = store.state(current.id, current.linuxUser);
@@ -159,7 +167,8 @@ function attachProjectSplitViews(ctx) {
         if (!targetResolved.refs) return targetResolved;
         if (input.targetWorkspace && !require('./project-view-pair').authorized(ctx, ws, input.targetWorkspace.linkedPair)) return { ok: false, code: 'pair', error: 'The exact linked Worker pair is unavailable.' };
         input.liveSessions = targetResolved.sessions;
-        return store.move(current.id, current.linuxUser, input, sourceResolved.refs, targetResolved.refs);
+        var destination = sourceState.views.find(function (view) { return view.id === input.targetViewId; });
+        return store.move(current.id, current.linuxUser, input, sourceResolved.refs, targetResolved.refs, destinationFolder(current.id, destination, input.targetSessionOriginId));
       }
       if (action === 'organize' && (input.projectSlug !== ctx.slug || input.folderId !== null && folderIds(current.id).indexOf(input.folderId) < 0)) return { ok: false, code: 'folder', error: 'That project folder is no longer available.' };
       var exactView = verifyStoredView(ws, current, input.id);

package/lib/project-view-store.js

@@ -122,7 +122,7 @@ function createSplitViewsStore(opts) {
     });
     return refs.every(function (ref) { return used.indexOf(ref.originId) === -1; });
   }
-  function create(ownerId, linuxUser, input, resolvedRefs) {
+  function create(ownerId, linuxUser, input, resolvedRefs, destinationFolderId) {
     input = input || {};
     var prepared = prepareRecord(ownerId, linuxUser, input.expectedRevision);
     if (!prepared.ok) return prepared;
@@ -136,14 +136,14 @@ function createSplitViewsStore(opts) {
     if (!uniqueMembership(prepared.record.views, refs.refs)) return { ok: false, error: "A session can belong to only one Split view" };
     var nameMode = input.nameMode === "custom" ? "custom" : "automatic";
     var view = { id: crypto.randomUUID(), name: nameMode === "automatic" ? names.automaticName(input.liveSessions) : name.name, nameMode: nameMode,
-      folderId: null, favorite: false, revision: prepared.record.revision + 1, layout: input.layout,
+      folderId: destinationFolderId || null, favorite: false, revision: prepared.record.revision + 1, layout: input.layout,
       activeSessionOriginId: input.activeSessionOriginId, tree: clone(input.tree), sessionRefs: refs.refs };
     if (input.workspace !== undefined || refs.refs.length < 2) view.workspace = input.workspace === undefined ? workspace.legacy(view) : clone(input.workspace);
     prepared.record.views.push(view);
     if (input.active === true) prepared.record.activeViewId = view.id;
     return commit(ownerId, prepared.record, view);
   }
-  function update(ownerId, linuxUser, input, resolvedRefs) {
+  function update(ownerId, linuxUser, input, resolvedRefs, destinationFolderId) {
     input = input || {};
     var prepared = prepareRecord(ownerId, linuxUser, input.expectedRevision);
     if (!prepared.ok) return prepared;
@@ -168,6 +168,7 @@ function createSplitViewsStore(opts) {
     if (names.mode(found.view) === "automatic") found.view.name = names.automaticName(input.liveSessions);
     found.view.layout = input.layout; found.view.activeSessionOriginId = input.activeSessionOriginId;
     found.view.tree = clone(input.tree); found.view.sessionRefs = refs.refs;
+    if (destinationFolderId !== undefined) found.view.folderId = destinationFolderId;
     if (input.workspace !== undefined || refs.refs.length < 2) found.view.workspace = input.workspace === undefined ? workspace.legacy(found.view) : clone(input.workspace);
     if (input.active === true) prepared.record.activeViewId = found.view.id;
     return commit(ownerId, prepared.record, found.view);
@@ -201,7 +202,7 @@ function createSplitViewsStore(opts) {
     if (prepared.record.activeViewId === removed.id) prepared.record.activeViewId = null;
     return commit(ownerId, prepared.record, null);
   }
-  function move(ownerId, linuxUser, input, resolvedSourceRefs, resolvedTargetRefs) {
+  function move(ownerId, linuxUser, input, resolvedSourceRefs, resolvedTargetRefs, destinationFolderId) {
     input = input || {};
     var prepared = prepareRecord(ownerId, linuxUser, input.expectedRevision);
     if (!prepared.ok) return prepared;
@@ -286,11 +287,12 @@ function createSplitViewsStore(opts) {
     if (nextSourceOrigins.length < 2 && !source.view.workspace) { prepared.record.views.splice(source.index, 1); if (prepared.record.activeViewId === source.view.id) prepared.record.activeViewId = null; }
     if (nextSourceOrigins.length >= 2 && names.mode(source.view) === "automatic") source.view.name = names.automaticName(input.sourceLiveSessions.filter(function (session) { return session.sessionOriginId !== input.sourceSessionOriginId; }));
     if (target) {
+      if (destinationFolderId !== undefined) target.view.folderId = destinationFolderId;
       target.view.tree = clone(input.tree); target.view.layout = input.layout;
       target.view.activeSessionOriginId = input.activeSessionOriginId; target.view.sessionRefs = targetRefs.refs;
       if (names.mode(target.view) === "automatic") target.view.name = names.automaticName(input.liveSessions);
     } else {
-      target = { index: -1, view: { id: crypto.randomUUID(), folderId: null, favorite: false, name: names.automaticName(input.liveSessions), nameMode: "automatic", revision: prepared.record.revision + 1,
+      target = { index: -1, view: { id: crypto.randomUUID(), folderId: destinationFolderId || null, favorite: false, name: names.automaticName(input.liveSessions), nameMode: "automatic", revision: prepared.record.revision + 1,
         layout: input.layout, activeSessionOriginId: input.activeSessionOriginId, tree: clone(input.tree), sessionRefs: targetRefs.refs } };
       prepared.record.views.push(target.view);
     }

package/lib/project-worker-conversation.js

@@ -104,6 +104,7 @@ function attachProjectWorkerConversation(ctx) {
     if (type === "user_message") return { role: "user", text: textContent(entry.text || entry.content) };
     if (type === "delta" || type === "result" || type === "assistant_message") return { role: "assistant", text: textContent(entry.text || entry.content) };
     if (type === "tool_start" || type === "tool_use") return Object.assign({ role: "tool", text: "Used " + (toolIdentity(entry).toolName || "tool") }, toolIdentity(entry));
+    if (type === "tool_executing") return Object.assign({ role: "tool", text: JSON.stringify(entry.input || {}) }, toolIdentity(entry));
     if (type === "tool_result") return Object.assign({ role: "tool", text: textContent(entry.content) || "No recorded tool output.", isError: entry.is_error === true }, toolIdentity(entry));
     return null;
   }
@@ -187,7 +188,11 @@ function attachProjectWorkerConversation(ctx) {
     watches.set(ws, watch);
     if (ws.once) ws.once('close', watch.close);
   }
+  var previews = require('./worker-message-previews').attach({ sm: sm, send: send, resolve: function (ws, target) {
+    var user = actor(ws); return user && exactPair(ws, target, user);
+  } });
   function handleMessage(ws, msg) {
+    if (msg && previews.handleMessage(ws, msg)) return true;
     if (!msg || msg.type !== "split_worker_conversation_request") return false;
     var requestId = typeof msg.requestId === "string" ? msg.requestId.slice(0, 160) : "";
     var response = { type: "split_worker_conversation", requestId: requestId, pageBefore: msg.before == null ? null : msg.before,

package/lib/public/app.js

@@ -501,6 +501,13 @@ import { initDebate, handleDebatePreparing, handleDebateStarted, handleDebateRes
     speechLifecycleBound: false,
     askUserRequests: {},
     activeBackgroundTasks: [],
+    backgroundTaskCatalog: [],
+    backgroundTaskViewer: null,
+    splitSessionPicker: null,
+    splitSessionCreation: null,
+    agentMessagePreviews: {},
+    agentMessageBubble: null,
+    workerMessagePreviewSubscription: null,
     sessionVendorBound: false,
     cliSessionId: null,
     isHeadlessMode: false,

package/lib/public/css/contextual-clay.css

@@ -1,12 +1,13 @@
 /* Anchored shell around the unchanged production conversation renderer. */
 #contextual-clay {
+  --contextual-chat-gutter: 80px;
   position: fixed;
   z-index: 160;
   top: var(--contextual-top, 38px);
   left: var(--contextual-left, 64px);
   width: var(--contextual-width, 480px);
   height: var(--contextual-height, 640px);
-  max-width: calc(100vw - 16px);
+  max-width: min(calc(var(--mate-content-width, 860px) + var(--contextual-chat-gutter)), calc(100vw - 16px));
   max-height: calc(100dvh - 16px);
   display: flex;
   flex-direction: column;

package/lib/public/css/mate-conversation.css

@@ -1,7 +1,7 @@
 /* Restore the Home conversation's reading measure inside Mate projects.
    The existing project renderer, queue and composer still own behavior. */
+:root { --mate-content-width: 860px; }
 body.mate-workspace-active {
-  --mate-content-width: 860px;
   --content-width: var(--mate-content-width);
 }
 body.mate-workspace-active #messages {

package/lib/public/css/pending-message-queue.css

@@ -1,10 +1,9 @@
 #pending-message-queue {
   margin: 0 7px 8px;
-  padding: 8px;
-  border: 1px solid color-mix(in srgb, var(--border) 82%, var(--accent));
-  border-radius: 13px;
-  background: color-mix(in srgb, var(--bg-alt) 74%, transparent);
-  box-shadow: inset 3px 0 0 color-mix(in srgb, var(--accent) 70%, transparent);
+  padding: 4px;
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  background: var(--bg-alt);
 }
 
 #pending-message-queue.hidden { display: none; }
@@ -14,15 +13,14 @@
   align-items: center;
   justify-content: space-between;
   min-height: 24px;
-  padding: 0 3px 6px 8px;
+  padding: 0 5px 2px 8px;
 }
 
 .pending-message-eyebrow {
   color: var(--text-muted);
   font-size: 10px;
-  font-weight: 700;
-  letter-spacing: 0.11em;
-  text-transform: uppercase;
+  font-weight: 550;
+  letter-spacing: 0.01em;
 }
 
 .pending-message-count {
@@ -62,7 +60,7 @@
 .pending-message-list {
   display: flex;
   flex-direction: column;
-  gap: 5px;
+  gap: 0;
   max-height: min(230px, 28vh);
   overflow-y: auto;
   overscroll-behavior: contain;
@@ -71,27 +69,30 @@
 
 .pending-message-chip {
   display: grid;
-  grid-template-columns: 22px 24px minmax(0, 1fr) auto;
+  grid-template-columns: 16px 24px minmax(0, 1fr) auto;
   align-items: center;
   flex: 0 0 auto;
   min-height: 46px;
-  border: 1px solid var(--border-subtle);
-  border-radius: 10px;
-  background: color-mix(in srgb, var(--bg) 90%, var(--bg-alt));
+  position: relative;
+  border: 1px solid transparent;
+  border-radius: 5px;
+  background: transparent;
   transition: border-color 120ms ease, background 120ms ease, transform 120ms ease;
 }
 
-.pending-message-chip:hover { border-color: var(--border); }
+.pending-message-chip + .pending-message-chip { border-top-color: var(--border-subtle); }
+.pending-message-chip:hover { background: rgba(var(--overlay-rgb), 0.035); }
 .pending-message-chip.is-claimed { background: color-mix(in srgb, var(--accent) 5%, var(--bg)); }
 .pending-message-chip.is-dragging { opacity: 0.62; transform: scale(0.992); }
-.pending-message-chip.is-drop-target { border-color: var(--accent); background: color-mix(in srgb, var(--accent) 8%, var(--bg)); }
+.pending-message-chip.is-drop-target::before { content: ""; position: absolute; top: -1px; left: 4px; right: 4px; height: 2px; border-radius: 2px; background: var(--accent); }
+.pending-message-chip.is-drop-target.is-drop-after::before { top: auto; bottom: -1px; }
+#pending-message-queue.is-reordering { cursor: grabbing; user-select: none; }
 
 .pending-message-number {
   align-self: stretch;
   display: flex;
   align-items: center;
   justify-content: center;
-  border-right: 1px solid var(--border-subtle);
   color: var(--text-dimmer);
   font-size: 10px;
   font-variant-numeric: tabular-nums;
@@ -119,6 +120,10 @@ button.pending-message-drag:active { cursor: grabbing; }
 .pending-message-chip.is-claimed .pending-message-drag .lucide { animation: spin 1.2s linear infinite; }
 
 .pending-message-content { min-width: 0; padding: 7px 7px 7px 3px; overflow: visible; }
+.pending-message-content:has(> .pending-message-image-strip) { display: grid; grid-template-columns: auto minmax(0, 1fr); column-gap: 9px; align-items: center; }
+.pending-message-content > .pending-message-image-strip { grid-column: 1; grid-row: 1 / 4; margin: 0; min-height: 0; max-width: 86px; flex-wrap: nowrap; overflow-x: auto; }
+.pending-message-content:has(> .pending-message-image-strip) > :not(.pending-message-image-strip) { grid-column: 2; }
+.pending-message-content > .pending-message-image-strip .pending-message-image-thumb { width: 30px; height: 30px; flex: 0 0 30px; }
 .pending-message-preview { overflow: hidden; color: var(--text); font-size: 12px; line-height: 1.3; text-overflow: ellipsis; white-space: nowrap; }
 .pending-message-image-strip,
 .pending-message-image-editor { display: flex; flex-wrap: wrap; gap: 5px; min-height: 36px; margin-top: 6px; align-items: center; }
@@ -179,10 +184,10 @@ button.pending-message-drag:active { cursor: grabbing; }
 .pending-message-edit-actions button:focus-visible { outline: 2px solid var(--accent); outline-offset: 1px; }
 
 @media (max-width: 600px) {
-  #pending-message-queue { margin: 0 3px 6px; padding: 6px; border-radius: 12px; }
+  #pending-message-queue { margin: 0 3px 6px; padding: 4px; border-radius: 8px; }
   .pending-message-head { padding-left: 6px; }
   .pending-message-list { max-height: min(196px, 24vh); }
-  .pending-message-chip { grid-template-columns: 20px 28px minmax(0, 1fr) auto; min-height: 44px; }
+  .pending-message-chip { grid-template-columns: 16px 28px minmax(0, 1fr) auto; min-height: 44px; }
   .pending-message-drag { width: 28px; height: 34px; }
   .pending-message-actions button { width: 30px; height: 34px; }
   .pending-message-meta { gap: 5px; }

package/lib/public/css/project-admin-overview.css

@@ -1,13 +1,42 @@
-.project-admin-overview { overflow: auto; padding: 8px; }
-.project-admin-canvas { width: 100%; min-height: 100%; padding: 24px; border: 1px solid var(--border); border-radius: 8px; background: var(--bg); }
-.project-admin-canvas h1 { font-size: 20px; margin: 0 0 16px; }
-.project-admin-canvas h2 { font-size: 16px; }
-.project-admin-canvas [role="tablist"] { display: flex; gap: 4px; border-bottom: 1px solid var(--border); padding-bottom: 8px; }
-.project-admin-canvas [role="tab"] { height: 32px; padding: 0 12px; border: 1px solid var(--border); border-radius: 8px; color: inherit; background: transparent; cursor: pointer; }
-.project-admin-canvas [aria-selected="true"] { background: #5857fc; color: white; }
-.project-admin-canvas :focus-visible { outline: 2px solid #5857fc; outline-offset: 2px; }
-.project-admin-canvas dl { display: grid; grid-template-columns: 110px 1fr; gap: 12px; margin: 24px 0; font-size: 13px; }
-.project-admin-canvas dd { margin: 0; }
-.project-admin-canvas p { max-width: 640px; line-height: 1.6; font-size: 14px; }
-.project-admin-secondary { opacity: .65; }
-@media (max-width: 600px) { .project-admin-canvas { padding: 16px; } }
+#main-area.project-admin-overview { display: block; overflow: auto; min-width: 0; padding: 8px; }
+.project-admin-canvas { min-height: 100%; padding: 24px; border: 1px solid var(--border); border-radius: 8px; background: var(--bg); }
+.project-admin-heading { display: flex; align-items: center; justify-content: space-between; gap: 16px; max-width: 1000px; margin-bottom: 22px; }
+.project-admin-canvas h1 { font-size: 22px; font-weight: 600; margin: 0; overflow-wrap: anywhere; }
+.project-admin-canvas h2 { font-size: 13px; font-weight: 600; margin: 0; }
+.project-admin-eyebrow, .project-admin-role { color: var(--text-muted); font-size: 11px; }
+.project-admin-canvas .project-admin-eyebrow { margin: 0 0 5px; font-size: 11px; }
+.project-admin-role { margin-left: auto; padding-right: 16px; }
+.project-admin-access-badge { flex-shrink: 0; border: 1px solid var(--border); border-radius: 5px; padding: 5px 8px; color: var(--text-muted); font-size: 11px; }
+.project-admin-canvas [role="tablist"] { display: flex; gap: 18px; border-bottom: 1px solid var(--border); max-width: 1000px; }
+.project-admin-canvas [role="tab"] { height: 32px; padding: 0 2px; border: 0; border-bottom: 2px solid transparent; border-radius: 0; color: var(--text-muted); background: transparent; cursor: pointer; font: inherit; font-size: 12px; }
+.project-admin-canvas [role="tab"][aria-selected="true"] { color: var(--text); border-bottom-color: var(--accent); }
+.project-admin-page :focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+.project-admin-facts { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 22px 28px; margin: 24px 0 28px; max-width: 1000px; }
+.project-admin-facts dt, .project-admin-metrics dt { font-size: 11px; color: var(--text-muted); margin-bottom: 6px; }
+.project-admin-facts dd { font-size: 13px; margin: 0; overflow-wrap: anywhere; }
+.project-admin-canvas p { line-height: 1.6; font-size: 12px; color: var(--text-secondary); }
+#project-admin-parent { margin: 6px 0 0; font-size: 11px; color: var(--text-muted); }
+.project-admin-storage { border-top: 1px solid var(--border); border-bottom: 1px solid var(--border); padding: 18px 0; max-width: 1000px; }
+.project-admin-section-heading { display: flex; align-items: center; justify-content: space-between; gap: 12px; margin-bottom: 18px; }
+.project-admin-section-heading button { height: 28px; border: 1px solid var(--border); border-radius: 6px; padding: 0 9px; font: inherit; font-size: 11px; background: var(--bg-alt); color: var(--text-secondary); cursor: pointer; }
+.project-admin-section-heading button:hover { background: var(--sidebar-hover); }
+.project-admin-section-heading button:disabled { opacity: .55; cursor: wait; }
+.project-admin-metrics { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 18px; margin: 0 0 16px; }
+.project-admin-metrics dd { font-size: 19px; font-weight: 500; margin: 0; font-variant-numeric: tabular-nums; overflow-wrap: anywhere; }
+.project-admin-canvas #usage-status { margin: 8px 0 4px; font-size: 11px; }
+.project-admin-canvas .project-admin-secondary { font-size: 11px; color: var(--text-muted); max-width: 720px; margin: 4px 0 0; }
+.project-admin-notice { padding-top: 22px; max-width: 680px; }
+.project-admin-notice h2 { color: var(--text-muted); }
+.project-admin-notice p { margin: 6px 0; }
+.project-admin-rail-header { position: relative; }
+.project-admin-page #icon-strip { padding-bottom: 12px; }
+.project-admin-page #icon-strip .icon-strip-home { margin-bottom: 0; }
+@media (max-width: 700px) {
+  .project-admin-canvas { padding: 16px; }
+  .project-admin-heading { align-items: flex-start; flex-direction: column; gap: 10px; margin-bottom: 16px; }
+  .project-admin-facts { grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 18px; }
+  .project-admin-metrics { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+  .project-admin-metrics dd { font-size: 17px; }
+  .project-admin-role { font-size: 10px; }
+  .project-admin-page #icon-strip { display: flex; width: 60px; }
+}

package/lib/public/css/shared-browser.css

@@ -107,14 +107,37 @@
 .shared-browser-pointer i { position: absolute; left: -12px; top: -12px; width: 30px; height: 30px; border: 2px solid #a59dff; border-radius: 50%; opacity: 0; }
 @media (prefers-reduced-motion: reduce) { .shared-browser-pointer { transition: none; } }
 
-.shared-browser-tabs { display: flex; gap: 4px; align-items: center; overflow-x: auto; flex-shrink: 0; padding: 6px 8px 0; border-bottom: 1px solid var(--border); }
-.shared-browser-tab { display: flex; align-items: center; min-width: 100px; max-width: 210px; border-radius: 7px 7px 0 0; background: var(--bg-alt); }
-.shared-browser-tab:has([aria-selected="true"]) { box-shadow: inset 0 -2px var(--accent); background: var(--bg-surface, var(--bg-alt)); }
-.shared-browser-tab [role="tab"] { min-width: 0; gap: 8px; font-size: 11px; padding: 9px 8px; }
-.shared-browser-tab [role="tab"] span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-.shared-browser-tab small { font-size: 9px; color: var(--text-muted); }
-.shared-browser-tab [aria-selected="true"] small { color: var(--accent); }
-.shared-browser-tab > button:last-child { padding: 5px; font-size: 15px; color: var(--text-muted); }
+/* Tabs sit on the pane's top edge; the selected face joins the address toolbar. */
+.shared-browser-tabs { display: flex; align-items: center; gap: 3px; min-width: 0; padding: 4px 6px 0; background: var(--bg-alt); flex: 1 1 auto; }
+.shared-browser-tab-list { display: flex; align-items: stretch; min-width: 0; overflow-x: auto; scrollbar-width: none; overscroll-behavior-x: contain; }
+.shared-browser-tab-list::-webkit-scrollbar { display: none; }
+.shared-browser-tab { position: relative; display: flex; align-items: center; flex: 0 1 160px; width: 160px; min-width: 84px; max-width: 180px; height: 29px; padding: 0 4px; border-radius: 8px 8px 0 0; color: var(--text-muted); }
+.shared-browser-tab::after { content: ''; position: absolute; right: -1px; top: 7px; height: 14px; width: 1px; background: var(--border); }
+.shared-browser-tab:has([aria-selected="true"]), .shared-browser-tab:hover { background: var(--bg); color: var(--text); }
+.shared-browser-tab:has([aria-selected="true"]) { z-index: 1; }
+.shared-browser-tab:has([aria-selected="true"])::after, .shared-browser-tab:has(+ .shared-browser-tab [aria-selected="true"])::after { display: none; }
+.shared-browser-panel .shared-browser-tab [role="tab"] { flex: 1; min-width: 0; height: 27px; gap: 6px; padding: 0 5px; border-radius: 5px; font-size: 11px; font-weight: 400; color: inherit; }
+.shared-browser-panel .shared-browser-tab [role="tab"]:hover { background: transparent; }
+.shared-browser-tab-label { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.shared-browser-tab [role="tab"] svg { width: 12px; height: 12px; color: var(--text-muted); }
+.shared-browser-tab[data-phase="ended"] [role="tab"] svg { opacity: .45; }
+.shared-browser-panel .shared-browser-tab-close { flex: 0 0 18px; width: 18px; height: 18px; padding: 3px; border-radius: 50%; color: var(--text-muted); }
+.shared-browser-panel .shared-browser-tab-close svg { width: 11px; height: 11px; }
+.shared-browser-panel .shared-browser-tab-close:hover { background: rgba(var(--overlay-rgb), .1); color: var(--text); }
+.shared-browser-panel .shared-browser-new-tab { flex: 0 0 23px; width: 23px; height: 23px; margin-bottom: 3px; padding: 4px; border-radius: 50%; color: var(--text-muted); }
+.shared-browser-panel .shared-browser-new-tab:hover { background: rgba(var(--overlay-rgb), .08); }
+.tool-pane-header.browser-pane-header { flex-wrap: nowrap; height: 33px; min-height: 33px; padding: 0 6px; gap: 4px; border-bottom: 0; background: var(--bg-alt); align-items: center; }
+.browser-pane-header > .tool-pane-kind { padding: 0 3px; }
+.browser-pane-header > .tool-pane-kind .split-view-model, .browser-pane-header > .tool-pane-title { display: none; }
+.browser-pane-header > .shared-browser-tabs { align-self: stretch; padding: 4px 0 0; flex-shrink: 1; }
+.browser-pane-header > .split-pane-drag-space { flex: 1 0 12px; min-width: 12px; }
+.browser-pane-header > .shared-browser-window { flex-shrink: 0; }
+.shared-browser-panel .shared-browser-address { min-height: 40px; box-sizing: border-box; padding: 5px 7px; background: var(--bg); }
+.shared-browser-panel .shared-browser-address button { width: 27px; height: 27px; flex-shrink: 0; padding: 5px; border-radius: 50%; }
+.shared-browser-panel .shared-browser-address input { height: 28px; box-sizing: border-box; border-radius: 14px; padding: 4px 11px; border-color: transparent; }
+.shared-browser-panel .shared-browser-address input:focus { outline: 2px solid var(--accent); outline-offset: -1px; }
+.browser-settings-open .shared-browser-tabs { display: none; }
+.browser-settings-open .browser-pane-header > .tool-pane-title { display: block; }
 
 #shared-browser-toggle-btn[aria-expanded="true"] { color: var(--text); background: rgba(var(--overlay-rgb), .06); }