clay-server 5.2.0-beta.1 → 5.2.0-beta.11

package/lib/public/modules/input.js

@@ -1,3 +1,5 @@
+import { contextualAccessReference } from './contextual-mate-context.js';
+import { contextualScreenReference } from './contextual-clay-session.js';
 import { stopSTT } from './stt-controller.js';
 import { expectCreatedSession } from './session-create.js';
 import { hasRecordedSpeechFor, requestRecordedSend } from './stt-recording.js';
@@ -6,6 +8,7 @@ import { setRewindMode, isRewindMode } from './rewind.js';
 import { renderPicker as renderContextPicker } from './context-sources.js';
 import { checkForMention, showMentionMenu, hideMentionMenu, isMentionMenuVisible, mentionMenuKeydown, setMentionAtIdx, parseMentionFromInput, clearMentionState, stickyReapplyMention, sendMention, sendUserMention, renderMentionUser, renderUserMention, removeMentionChip } from './mention.js';
 import { store } from './store.js';
+import { sessionCallback, paneMessageBinding, samePaneBinding } from './pane-binding.js';
 import { sendAcknowledgedMessage } from './message-delivery.js';
 import { mateAvatarUrl } from './avatar.js';
 import { tuiIsActive, tuiSubmitText } from './session-tui-view.js';
@@ -120,6 +123,10 @@ function showPreThinkingForTurn() {
 
 // --- Send ---
 export function sendMessage() {
+  if (store.get('deferredSessionSwitch') || store.get('panePendingBinding') || store.get('paneSuspended')) return;
+  if (store.get('paneCommittedBinding') && !store.get('paneReady')) return;
+  var actionBinding = paneMessageBinding();
+  if (store.get('contextualWriterSuspended')) return;
   if (ctx && requestRecordedSend(ctx.inputEl, sendMessage)) return;
   stopSTT();
   // Debate ended mode intercept: route to resume handler
@@ -343,13 +350,17 @@ export function sendMessage() {
     store.set({ pendingScheduleAdmissions: admissions, pendingScheduleAdmission: admissions[scheduleRequestId] });
     ctx.ws.send(JSON.stringify({
       type: "schedule_message", requestId: scheduleRequestId,
+      paneBinding: actionBinding || undefined,
       projectSlug: scheduleContext.projectSlug, sessionId: scheduleContext.sessionId, accountId: scheduleContext.accountId,
       text: text || "", images: images, pastes: pastes, resetsAt: resetsAt,
     }));
     return;
   }
 
+  var screenReference = contextualScreenReference();
   var payload = { type: "message", text: text || "" };
+  if (actionBinding) payload.paneBinding = actionBinding;
+  if (screenReference) payload.contextualSnapshot = screenReference;
   if (images.length > 0) {
     payload.images = images;
   }
@@ -359,6 +370,8 @@ export function sendMessage() {
   // Include selected vendor for session binding (server uses on first message)
   var _selVendor = store.get("currentVendor") || null;
   if (_selVendor) payload.vendor = _selVendor;
+  var contextRef = contextualAccessReference();
+  if (contextRef) payload.mateContextRef = contextRef;
   if (!prepareAutonomousPayload(payload)) return;
   ctx.currentMsgTs = Date.now();
   sendAcknowledgedMessage(payload);
@@ -433,6 +446,7 @@ export function sendTextMessage(text) {
 export function sendShellResultToAgent(msg) {
   if (!ctx || !ctx.connected || !msg || msg.error || !msg.command) return false;
   if (String(msg.sessionId) !== String(store.get("activeSessionId"))) return false;
+  if (store.get('paneCommittedBinding') && !samePaneBinding(msg.paneActivation, store.get('paneCommittedBinding'))) return false;
   var payload = {
     type: "message",
     text: "$ " + msg.command,
@@ -440,7 +454,8 @@ export function sendShellResultToAgent(msg) {
   };
   var selectedVendor = store.get("currentVendor") || null;
   if (selectedVendor) payload.vendor = selectedVendor;
-  ctx.ws.send(JSON.stringify(payload));
+  if (msg.paneActivation) payload.paneBinding = msg.paneActivation;
+  if (ctx.ws.send(JSON.stringify(payload)) === false) return false;
   commitVendorForTurn();
   showPreThinkingForTurn();
   return true;
@@ -448,7 +463,9 @@ export function sendShellResultToAgent(msg) {
 
 export function autoResize() {
   ctx.inputEl.style.height = "auto";
-  ctx.inputEl.style.height = Math.min(ctx.inputEl.scrollHeight, 120) + "px";
+  var border = ctx.inputEl.offsetHeight - ctx.inputEl.clientHeight;
+  ctx.inputEl.style.height = Math.min(ctx.inputEl.scrollHeight + border, 120) + "px";
+  ctx.inputEl.style.overflowY = ctx.inputEl.scrollHeight > ctx.inputEl.clientHeight ? "auto" : "hidden";
   // Defensive: sync send/stop button whenever input size changes
   if (ctx.processing && ctx.setSendBtnMode) {
     ctx.setSendBtnMode(hasSendableContent() ? "send" : "stop");
@@ -533,6 +550,38 @@ function removePendingImage(idx) {
   renderInputPreviews();
 }
 
+// Move composer ownership between two authenticated views of the same session.
+export function composerDepartureReason() {
+  if (uploadingCount) return 'Wait for attachments to finish uploading before changing views.';
+  if (store.get('speechActive') || ctx && hasRecordedSpeechFor(ctx.inputEl)) return 'Finish or discard the voice recording before changing views.';
+  var retry = store.get('speechRetry');
+  if (retry && ctx && retry.input === ctx.inputEl) return 'Retry or discard the voice recording before changing views.';
+  return '';
+}
+export function takeComposerDraft() {
+  var reason = composerDepartureReason();
+  if (reason) throw new Error(reason);
+  if (document.dispatchEvent) document.dispatchEvent(new CustomEvent('clay-composer-handoff'));
+  var input = ctx.inputEl;
+  var draft = { text: input.value, start: input.selectionStart, end: input.selectionEnd, direction: input.selectionDirection, images: pendingImages, pastes: pendingPastes, files: pendingFiles, delay: scheduleDelayMs };
+  input.value = '';
+  clearPendingImages();
+  clearScheduleDelay();
+  autoResize();
+  return draft;
+}
+export function restoreComposerDraft(draft) {
+  if (!draft) return;
+  pendingImages = draft.images || [];
+  pendingPastes = draft.pastes || [];
+  pendingFiles = draft.files || [];
+  ctx.inputEl.value = draft.text || '';
+  ctx.inputEl.setSelectionRange(draft.start || 0, draft.end || 0, draft.direction || 'none');
+  setScheduleDelayMs(draft.delay || 0);
+  renderInputPreviews();
+  autoResize();
+}
+
 export function clearPendingImages() {
   pendingImages = [];
   pendingPastes = [];
@@ -552,14 +601,14 @@ function pastePreview(text) {
 }
 
 function editPendingPaste(idx) {
-  showPasteModal(pendingPastes[idx].text, function (text) {
+  showPasteModal(pendingPastes[idx].text, sessionCallback(function (text) {
     if (!text) {
       removePendingPaste(idx);
       return;
     }
     pendingPastes[idx] = { text: text, preview: pastePreview(text) };
     renderInputPreviews();
-  });
+  }));
 }
 
 function removePendingFile(idx) {
@@ -693,6 +742,7 @@ function uploadFile(file) {
     return;
   }
   uploadingCount++;
+  store.set({ composerUploadingCount: uploadingCount });
   renderInputPreviews();
   var reader = new FileReader();
   reader.onload = function (ev) {
@@ -705,12 +755,14 @@ function uploadFile(file) {
     xhr.setRequestHeader("Content-Type", "application/json");
     xhr.onload = function () {
       uploadingCount--;
+      store.set({ composerUploadingCount: uploadingCount });
       if (xhr.status === 200) {
         try {
           var resp = JSON.parse(xhr.responseText);
           pendingFiles.push({ name: resp.name || uploadName, path: resp.path });
-        } catch (e) {}
+        } catch (e) { showToast('Upload response could not be read: ' + uploadName + '. Your draft is preserved.', 'error'); }
       } else {
+        showToast('Upload failed: ' + uploadName + '. Your draft is preserved.', 'error');
         if (ctx.addSystemMessage) ctx.addSystemMessage("Upload failed: " + uploadName, true);
       }
       renderInputPreviews();
@@ -720,6 +772,8 @@ function uploadFile(file) {
     };
     xhr.onerror = function () {
       uploadingCount--;
+      store.set({ composerUploadingCount: uploadingCount });
+      showToast('Upload failed: ' + uploadName + '. Your draft is preserved.', 'error');
       if (ctx.addSystemMessage) ctx.addSystemMessage("Upload failed: " + uploadName, true);
       renderInputPreviews();
       if (ctx.processing && ctx.setSendBtnMode) {
@@ -728,6 +782,7 @@ function uploadFile(file) {
     };
     xhr.send(JSON.stringify({ name: uploadName, data: b64 }));
   };
+  reader.onerror = function () { uploadingCount--; store.set({ composerUploadingCount: uploadingCount }); renderInputPreviews(); showToast('Attachment could not be read. Your draft is preserved.', 'error'); };
   reader.readAsDataURL(file);
 }
 
@@ -739,7 +794,14 @@ function readImageBlob(blob) {
     uploadFile(blob);
     return;
   }
+  uploadingCount++; store.set({ composerUploadingCount: uploadingCount });
+  var completed = false;
+  function finish() {
+    if (completed) return; completed = true; uploadingCount--;
+    store.set({ composerUploadingCount: uploadingCount }); renderInputPreviews();
+  }
   var reader = new FileReader();
+  reader.onerror = function () { finish(); showToast('Image could not be read. Your draft is preserved.', 'error'); };
   reader.onload = function (ev) {
     var dataUrl = ev.target.result;
     // Check base64 payload size (~3/4 of base64 length)
@@ -748,7 +810,7 @@ function readImageBlob(blob) {
     var estimatedBytes = b64.length * 0.75;
 
     if (estimatedBytes <= MAX_IMAGE_BYTES) {
-      addPendingImage(dataUrl);
+      addPendingImage(dataUrl); finish();
       return;
     }
 
@@ -766,8 +828,9 @@ function readImageBlob(blob) {
       var cx = canvas.getContext("2d");
       cx.drawImage(img, 0, 0, nw, nh);
       var resized = canvas.toDataURL("image/jpeg", RESIZE_QUALITY);
-      addPendingImage(resized);
+      addPendingImage(resized); finish();
     };
+    img.onerror = function () { finish(); showToast('Image could not be loaded. Your draft is preserved.', 'error'); };
     img.src = dataUrl;
   };
   reader.readAsDataURL(blob);
@@ -836,10 +899,13 @@ function sendInputSync() {
     if (dk) ctx.ws.send(JSON.stringify({ type: "dm_typing", dmKey: dk, typing: hasText }));
     return;
   }
-  ctx.ws.send(JSON.stringify({ type: "input_sync", text: ctx.inputEl.value }));
+  var speech = store.get('speechActive');
+  ctx.ws.send(JSON.stringify({ type: "input_sync", text: ctx.inputEl.value,
+    paneBinding: speech && speech.writing ? speech.paneBinding || undefined : undefined }));
 }
 
 export function handleInputSync(text) {
+  if (store.get('contextualWriterSuspended')) return;
   isRemoteInput = true;
   ctx.inputEl.value = text;
   autoResize();
@@ -859,7 +925,7 @@ function createFileInput(accept, capture, multiple) {
   input.style.display = "none";
   document.body.appendChild(input);
 
-  input.addEventListener("change", function () {
+  var selectFiles = sessionCallback(function () {
     if (input.files) {
       for (var i = 0; i < input.files.length; i++) {
         if (input.files[i].type.indexOf("image/") === 0) {
@@ -869,6 +935,9 @@ function createFileInput(accept, capture, multiple) {
         }
       }
     }
+  });
+  input.addEventListener("change", function () {
+    selectFiles();
     document.body.removeChild(input);
   });
 
@@ -957,6 +1026,14 @@ export function initInput(_ctx) {
     }
   }
 
+  document.addEventListener('clay-composer-handoff', function () {
+    if (scheduleInlineInput) {
+      var minutes = parseInt(scheduleInlineInput.value, 10);
+      if (minutes >= 1 && minutes <= 1440) setScheduleDelayMs(minutes * 60000);
+    }
+    collapseScheduleBtn();
+  });
+
   function setScheduleDelay(ms) {
     scheduleDelayMs = ms;
     if (!scheduleBtn) return;
@@ -986,7 +1063,7 @@ export function initInput(_ctx) {
     scheduleInlineInput.className = "schedule-inline-input";
     scheduleBtn.appendChild(scheduleInlineInput);
 
-    setTimeout(function () { scheduleInlineInput.focus(); }, 0);
+    setTimeout(sessionCallback(function () { if (scheduleInlineInput) scheduleInlineInput.focus(); }), 0);
 
     scheduleInlineInput.addEventListener("click", function (e) { e.stopPropagation(); });
     scheduleInlineInput.addEventListener("keydown", function (e) {
@@ -1005,6 +1082,7 @@ export function initInput(_ctx) {
 
     // Close on outside click
     setTimeout(function () {
+      if (!scheduleInlineInput) return;
       scheduleOutsideHandler = function (ev) {
         if (!scheduleBtn.contains(ev.target)) {
           if (scheduleInlineInput) {

package/lib/public/modules/issues-render.js

@@ -1,3 +1,4 @@
+import { store } from './store.js';
 import { githubWorkMarkup } from './session-github.js';
 import { issueGithubAction } from './issues-github.js';
 import { escapeHtml } from './utils.js';
@@ -18,7 +19,7 @@ export function renderIssueList(result) {
     var meta = [authorLine(entry), relativeTime(entry.updatedAt || entry.createdAt)];
     if (entry.revision > 1) meta.push('v' + entry.revision);
     if (entry.commentCount) meta.push(entry.commentCount + (entry.commentCount === 1 ? ' comment' : ' comments'));
-    return '<button type="button" class="issue-row" data-open-issue="' + esc(entry.ref) + '">' +
+    return '<button type="button" class="issue-row" data-control-runtime="' + esc(store.get("controlRuntimeId")) + '" data-control-revision="' + esc(entry.revision) + '" data-open-issue="' + esc(entry.ref) + '">' +
       '<div class="issue-row-head"><span class="issue-type">' + esc(entry.type) + '</span>' + priorityChip(entry.priority) + '<strong>' + esc(entry.title) + '</strong></div>' +
       (entry.summary ? '<p>' + esc(entry.summary) + '</p>' : '') +
       '<div class="issue-row-meta">' + statusChip(entry.status) + '<span>' + esc(meta.filter(Boolean).join(' · ')) + '</span></div></button>';
@@ -35,7 +36,7 @@ export function renderIssueDetail(entry) {
   var closed = entry.status === 'resolved' || entry.status === 'closed';
   var time = entry.updatedAt || entry.createdAt;
   var byline = [authorLine(entry), time ? new Date(time).toLocaleString() : '', 'v' + entry.revision].filter(Boolean).join(' · ');
-  return '<article class="issue-detail"><div class="issue-doc-chips"><span class="issue-type">' + esc(entry.type) + '</span>' + priorityChip(entry.priority) + statusChip(entry.status) + '</div>' +
+  return '<article class="issue-detail" data-control-ref="' + esc(entry.ref) + '" data-control-runtime="' + esc(store.get("controlRuntimeId")) + '" data-control-revision="' + esc(entry.revision) + '"><div class="issue-doc-chips"><span class="issue-type">' + esc(entry.type) + '</span>' + priorityChip(entry.priority) + statusChip(entry.status) + '</div>' +
     githubWorkMarkup(entry, true) +
     '<h2 class="issue-doc-title">' + esc(entry.title) + '</h2>' + prose(entry.summary, 'issue-doc-summary') + '<div class="issue-byline">' + esc(byline) + '</div>' +
     '<div class="issue-actions">' + action('data-issue-work', 'play', 'Start work', ' class="issue-primary"' + (closed ? ' disabled title="Reopen this issue to start work"' : '')) +

package/lib/public/modules/knowledge-db-workbench.js

@@ -125,7 +125,7 @@ export function handleKnowledgeDbClick(event, panel) {
   if (event.target.closest('[data-db-create-submit]')) { submitCreate(panel); return true; }
   if (event.target.closest('[data-db-create-cancel]')) { patchState(workspaceKey(), { createDraft: null }); patchMain(workspaceKey(), { fullscreen: false }); if (renderOwner) renderOwner({ forceDocument: true }); return true; }
   var reference = event.target.closest('[data-db-reference]'); if (reference) { var referenceKey = workspaceKey(); if (reference.dataset.dbReferenceType === 'text') { if (openOwnerDocument) openOwnerDocument('local:' + reference.dataset.dbReference); } else { var databaseIdentity = identityOwner ? identityOwner({ id: reference.dataset.dbReferenceDatabase, itemType: 'db', common: false }) : 'local:' + reference.dataset.dbReferenceDatabase; if (openOwnerDocument) openOwnerDocument(databaseIdentity); openRecord(reference.dataset.dbReferenceDatabase, reference.dataset.dbReference, referenceKey); } return true; }
-  var row = event.target.closest('[data-db-record]'); if (row) { openRecord(row.dataset.dbDatabase, row.dataset.dbRecord); return true; }
+  var row = event.target.closest('tr[data-db-record]'); if (row) { openRecord(row.dataset.dbDatabase, row.dataset.dbRecord); return true; }
   var edit = event.target.closest('[data-db-edit-record]'); if (edit) { beginRecordEdit(edit.dataset.dbEditRecord, false); return true; }
   var add = event.target.closest('[data-db-add-record]'); if (add) { beginRecordEdit(add.dataset.dbAddRecord, true); return true; }
   var save = event.target.closest('[data-db-save-record]'); if (save) { submitRecord(panel, save.dataset.dbSaveRecord); return true; }
@@ -155,7 +155,7 @@ export function handleKnowledgeDbClick(event, panel) {
 }
 
 export function handleKnowledgeDbKeydown(event, panel) {
-  var keyboardRow = event.target.closest && event.target.closest('[data-db-record]'); if (keyboardRow && (event.key === 'Enter' || event.key === ' ')) { event.preventDefault(); openRecord(keyboardRow.dataset.dbDatabase, keyboardRow.dataset.dbRecord); return true; }
+  var keyboardRow = event.target.closest && event.target.closest('tr[data-db-record]'); if (keyboardRow && (event.key === 'Enter' || event.key === ' ')) { event.preventDefault(); openRecord(keyboardRow.dataset.dbDatabase, keyboardRow.dataset.dbRecord); return true; }
   var dialog = panel && panel.querySelector('.knowledge-db-dialog'); if (!dialog) return false;
   if (event.key === 'Escape') { event.preventDefault(); closeArchiveDialog(panel); return true; }
   if (event.key !== 'Tab') return false; var controls = dialog.querySelectorAll('button:not(:disabled)'); if (!controls.length) return false; var first = controls[0]; var last = controls[controls.length - 1];
@@ -175,10 +175,10 @@ function renderDatabaseRecovery(body, toolbar, draft) { toolbar.innerHTML = '<sp
 function renderTable(body, dbState) {
   var database = dbState.database; var view = database.views.filter(function (item) { return item.id === dbState.selectedViewId; })[0] || database.views[0] || { columns: database.schema.filter(function (field) { return !field.archived; }).map(function (field) { return field.id; }) }; var fields = view.columns.map(function (id) { return fieldById(database, id); }).filter(Boolean);
   var html = '<div class="knowledge-db-table-wrap"><table class="knowledge-db-table"><thead><tr>' + fields.map(function (field) { return '<th scope="col">' + escapeText(field.name) + '</th>'; }).join('') + '</tr></thead><tbody>';
-  html += dbState.records.map(function (record) { return '<tr tabindex="0" data-db-record="' + escapeText(record.id) + '" data-db-database="' + escapeText(database.id) + '">' + fields.map(function (field) { return '<td>' + displayValue(field, record.values[field.id], record.references) + '</td>'; }).join('') + '</tr>'; }).join('');
+  html += dbState.records.map(function (record) { return '<tr data-control-runtime="' + escapeText(store.get('controlRuntimeId')) + '" data-control-revision="' + escapeText(record.revision) + '" tabindex="0" data-db-record="' + escapeText(record.id) + '" data-db-database="' + escapeText(database.id) + '">' + fields.map(function (field) { return '<td>' + displayValue(field, record.values[field.id], record.references) + '</td>'; }).join('') + '</tr>'; }).join('');
   html += '</tbody></table>' + (!dbState.records.length && !dbState.loading ? '<p class="knowledge-empty">No records in this view.</p>' : '') + (dbState.nextCursor ? '<button type="button" class="knowledge-search-more" data-db-more="' + escapeText(database.id) + '">Load more</button>' : '') + '</div>'; body.innerHTML = html;
 }
-function renderRecord(body, dbState) { var detail = selectedRecordState(workspaceKey(), dbState.database.id); if (!detail) { body.innerHTML = '<p class="knowledge-empty">Loading record…</p>'; return; } var history = (detail.history || []).map(function (entry) { return '<li><b>' + escapeText(entry.action || 'update') + '</b><span>Revision ' + escapeText(entry.revision) + ' · ' + new Date(entry.at).toLocaleString() + '</span></li>'; }).join(''); body.innerHTML = '<article class="knowledge-db-record"><button type="button" data-db-record-back="' + escapeText(dbState.database.id) + '">' + iconHtml('arrow-left') + 'Table</button><h2>' + escapeText(detail.title) + '</h2><dl>' + dbState.database.schema.filter(function (field) { return !field.archived; }).map(function (field) { return '<dt>' + escapeText(field.name) + '</dt><dd>' + displayValue(field, detail.record.values[field.id], detail.record.references) + '</dd>'; }).join('') + '</dl><p class="knowledge-db-attribution">Revision ' + detail.record.revision + ' · updated ' + new Date(detail.record.updatedAt).toLocaleString() + '</p>' + (history ? '<h3>Recent history</h3><ol class="knowledge-db-history">' + history + '</ol>' : '') + '</article>'; }
+function renderRecord(body, dbState) { var detail = selectedRecordState(workspaceKey(), dbState.database.id); if (!detail) { body.innerHTML = '<p class="knowledge-empty">Loading record…</p>'; return; } var history = (detail.history || []).map(function (entry) { return '<li><b>' + escapeText(entry.action || 'update') + '</b><span>Revision ' + escapeText(entry.revision) + ' · ' + new Date(entry.at).toLocaleString() + '</span></li>'; }).join(''); body.innerHTML = '<article class="knowledge-db-record" data-control-runtime="' + escapeText(store.get('controlRuntimeId')) + '" data-control-revision="' + escapeText(detail.record.revision) + '" data-db-record="' + escapeText(detail.record.id) + '" data-db-database="' + escapeText(dbState.database.id) + '"><button type="button" data-db-record-back="' + escapeText(dbState.database.id) + '">' + iconHtml('arrow-left') + 'Table</button><h2>' + escapeText(detail.title) + '</h2><dl>' + dbState.database.schema.filter(function (field) { return !field.archived; }).map(function (field) { return '<dt>' + escapeText(field.name) + '</dt><dd>' + displayValue(field, detail.record.values[field.id], detail.record.references) + '</dd>'; }).join('') + '</dl><p class="knowledge-db-attribution">Revision ' + detail.record.revision + ' · updated ' + new Date(detail.record.updatedAt).toLocaleString() + '</p>' + (history ? '<h3>Recent history</h3><ol class="knowledge-db-history">' + history + '</ol>' : '') + '</article>'; }
 function renderRecordForm(body, toolbar, dbState) { var edit = dbState.edit; var values = edit.values || {}; toolbar.innerHTML = '<span class="knowledge-preview-name">' + (edit.creating ? 'New record' : 'Edit record') + '</span>' + (!edit.creating ? '<button type="button" class="danger" data-db-archive-record="' + escapeText(dbState.database.id) + '">Archive</button>' : '') + '<button type="button" data-db-cancel-edit>Cancel</button><button type="button" class="primary" data-db-save-record="' + escapeText(dbState.database.id) + '">' + (edit.saving ? 'Retry save' : 'Save') + '</button>'; body.innerHTML = '<form class="knowledge-db-form" onsubmit="return false"><h2>' + (edit.creating ? 'New record' : 'Edit record') + '</h2>' + dbState.database.schema.filter(function (field) { return !field.archived; }).map(function (field) { return '<label>' + escapeText(field.name) + fieldInput(field, values[field.id]) + '</label>'; }).join('') + (edit.error ? '<p class="knowledge-inline-error">' + escapeText(edit.error) + '</p>' : '') + '</form>'; }
 function renderSettings(body, toolbar, dbState) { var edit = dbState.edit; toolbar.innerHTML = '<span class="knowledge-preview-name">Database settings</span><button type="button" data-db-cancel-edit>Cancel</button><button type="button" class="primary" data-db-save-settings="' + escapeText(dbState.database.id) + '">' + (edit.saving ? 'Retry rename' : 'Save name') + '</button>'; body.innerHTML = '<form class="knowledge-db-form" onsubmit="return false"><h2>Database settings</h2><label>Name<input data-db-settings-name value="' + escapeText(edit.name) + '" maxlength="120"></label>' + (edit.error ? '<p class="knowledge-inline-error">' + escapeText(edit.error) + '</p>' : '') + '<section class="knowledge-danger-zone"><h3>Archive database</h3><p>Records, schema, views, and history remain recoverable.</p><button type="button" class="danger" data-db-archive-database="' + escapeText(dbState.database.id) + '">Archive database</button></section></form>'; }
 function renderRecover(body, toolbar, dbState) { var edit = dbState.edit; toolbar.innerHTML = '<span class="knowledge-preview-name">Recover record</span><button type="button" data-db-cancel-edit>Cancel</button><button type="button" class="primary" data-db-confirm-recover-record="' + escapeText(dbState.database.id) + '">' + (edit.saving ? 'Retry recovery' : 'Recover') + '</button>'; body.innerHTML = '<div class="knowledge-db-form"><h2>Recover archived record?</h2><p>This restores the exact record at revision ' + escapeText(edit.baseVersion) + '.</p>' + (edit.error ? '<p class="knowledge-inline-error">' + escapeText(edit.error) + '</p>' : '') + '</div>'; }

package/lib/public/modules/markdown.js

@@ -1,3 +1,5 @@
+import { enhanceSessionCitations } from './clay-session-links.js';
+import { renderBrowserLink, enhanceBrowserLinks } from './clay-browser-links.js';
 import { renderWireframeBlocks } from './wireframe-chat.js';
 import { copyToClipboard, escapeHtml } from './utils.js';
 import { refreshIcons } from './icons.js';
@@ -14,6 +16,8 @@ marked.use({ gfm: true, breaks: false });
 marked.use({
   renderer: {
     link({ href, title, tokens, text }) {
+      var browserLink = renderBrowserLink(href, title, text);
+      if (browserLink) return browserLink;
       var recordLink = renderClayRecordLink(href, text);
       if (recordLink) return recordLink;
       var localLink = renderLocalFileLink(href, title, text);
@@ -67,42 +71,10 @@ export function renderMarkdown(text) {
 
 export function enhanceClaySessionLinks(root) {
   if (!root || typeof document === "undefined") return;
-  var walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT);
-  var nodes = [];
-  var node;
-  while ((node = walker.nextNode())) {
-    if (!node.parentElement || node.parentElement.closest("code, pre, a, button")) continue;
-    if (/\[clayos\/session:[A-Za-z0-9_-]{24}(?:\s+[\u2014-]\s+[^\]\n]{1,80})?\]/.test(node.nodeValue || "")) nodes.push(node);
-  }
-  for (var i = 0; i < nodes.length; i++) {
-    var text = nodes[i].nodeValue || "";
-    var pattern = /\[clayos\/(session:[A-Za-z0-9_-]{24})(?:\s+[\u2014-]\s+([^\]\n]{1,80}))?\]/g;
-    var fragment = document.createDocumentFragment();
-    var offset = 0;
-    var match;
-    while ((match = pattern.exec(text))) {
-      fragment.appendChild(document.createTextNode(text.slice(offset, match.index)));
-      var button = document.createElement("button");
-      button.type = "button";
-      button.className = "clayos-session-link";
-      button.dataset.sessionRef = match[1];
-      button.setAttribute("aria-label", "Open session" + (match[2] ? " from " + match[2].trim() : ""));
-      var label = document.createElement("span");
-      label.textContent = "Session";
-      button.appendChild(label);
-      if (match[2]) {
-        var meta = document.createElement("small");
-        meta.textContent = match[2].trim();
-        button.appendChild(meta);
-      }
-      fragment.appendChild(button);
-      offset = pattern.lastIndex;
-    }
-    fragment.appendChild(document.createTextNode(text.slice(offset)));
-    nodes[i].parentNode.replaceChild(fragment, nodes[i]);
-  }
+  enhanceSessionCitations(root);
   enhanceClayLogLinks(root);
   enhanceClayFileLinks(root);
+  enhanceBrowserLinks(root);
 }
 
 /**

package/lib/public/modules/mate-avatar-catalog.js

@@ -0,0 +1,97 @@
+// Shared appearance names; stable IDs remain internal catalog identities.
+export var MATE_AVATAR_COLLECTIONS = [{"id":"B","name":"Oddballs","avatars":[{"id":"B01","name":"Indigo Cyclops"},
+{"id":"B02","name":"Coral Sentinel"},
+{"id":"B03","name":"Golden Visor"},
+{"id":"B04","name":"Mint Wide Eyes"},
+{"id":"B05","name":"Ivory Grin"},
+{"id":"B06","name":"Blue Teardrop"},
+{"id":"B07","name":"Peach Orbit"},
+{"id":"B08","name":"Lilac Sleeper"},
+{"id":"B09","name":"Coral Prism"},
+{"id":"B10","name":"Mint Spring"},
+{"id":"B11","name":"Golden Pebbles"},
+{"id":"B12","name":"Periwinkle Orbit"},
+{"id":"B13","name":"Coral Horizon"},
+{"id":"B14","name":"Indigo Stack"},
+{"id":"B15","name":"Mint Button Box"},
+{"id":"B16","name":"Golden Curve"},
+{"id":"B17","name":"Loop Listener"},
+{"id":"B18","name":"Blue Twin Antenna"},
+{"id":"B19","name":"Lilac Daydream"},
+{"id":"B20","name":"Coral Toothsome"},
+{"id":"B21","name":"Ivory Satellite"},
+{"id":"B22","name":"Mint Coil"},
+{"id":"B23","name":"Golden Wonder"},
+{"id":"B24","name":"Slate Smile"},
+{"id":"B25","name":"Lilac Shield"},
+{"id":"B26","name":"Mint Diamond"},
+{"id":"B27","name":"Coral Pebble"},
+{"id":"B28","name":"Golden Horns"},
+{"id":"B29","name":"Blue Trio"},
+{"id":"B30","name":"Ivory Tower"},
+{"id":"B31","name":"Charcoal Grin"},
+{"id":"B32","name":"Teal Cheer"},
+{"id":"B33","name":"Rose Satellite"},
+{"id":"B34","name":"Blue Spool"},
+{"id":"B35","name":"Golden Band"},
+{"id":"B36","name":"Mint Beacon"},
+{"id":"B37","name":"Charcoal Crescent"},
+{"id":"B38","name":"Coral Cyclops"},
+{"id":"B39","name":"Blue Scout"},
+{"id":"B40","name":"Ivory Navigator"},
+{"id":"B41","name":"Golden Porthole"},
+{"id":"B42","name":"Lilac Windup"},
+{"id":"B43","name":"Mint Receiver"},
+{"id":"B44","name":"Coral Stack"},
+{"id":"B45","name":"Indigo Porthole"},
+{"id":"B46","name":"Stone Sprout"},
+{"id":"B47","name":"Mint Sunbeam"},
+{"id":"B48","name":"Golden Cubby"}]},
+{"id":"C","name":"Kindred Bots","avatars":[{"id":"C01","name":"Violet Smile"},
+{"id":"C02","name":"Apricot Joy"},
+{"id":"C03","name":"Sage Curious"},
+{"id":"C04","name":"Golden Wink"},
+{"id":"C05","name":"Blue Sideglance"},
+{"id":"C06","name":"Charcoal Wonder"},
+{"id":"C07","name":"Lilac Specs"},
+{"id":"C08","name":"Coral Giggle"},
+{"id":"C09","name":"Mint Blush"},
+{"id":"C10","name":"Golden Button"},
+{"id":"C11","name":"Sky Smile"},
+{"id":"C12","name":"Plum Joy"},
+{"id":"C13","name":"Teal Diamond"},
+{"id":"C14","name":"Peach Dimple"},
+{"id":"C15","name":"Indigo Delight"},
+{"id":"C16","name":"Sage Sprout"},
+{"id":"C17","name":"Golden Specs"},
+{"id":"C18","name":"Lilac Stargaze"},
+{"id":"C19","name":"Blue Curiosity"},
+{"id":"C20","name":"Coral Heart"},
+{"id":"C21","name":"Mint Bud"},
+{"id":"C22","name":"Ivory Surprise"},
+{"id":"C23","name":"Rose Wink"},
+{"id":"C24","name":"Sky Giggle"},
+{"id":"C25","name":"Ivory Dreamer"},
+{"id":"C26","name":"Mint Loop"},
+{"id":"C27","name":"Violet Glasses"},
+{"id":"C28","name":"Coral Sunshine"},
+{"id":"C29","name":"Slate Sideglance"},
+{"id":"C30","name":"Golden Dimple"},
+{"id":"C31","name":"Teal Listener"},
+{"id":"C32","name":"Peach Cheer"},
+{"id":"C33","name":"Indigo Blush"},
+{"id":"C34","name":"Sage Daydream"},
+{"id":"C35","name":"Rose Wonder"},
+{"id":"C36","name":"Sky Blush"},
+{"id":"C37","name":"Peach Heart"},
+{"id":"C38","name":"Blue Button"},
+{"id":"C39","name":"Lilac Wink"},
+{"id":"C40","name":"Mint Dish"},
+{"id":"C41","name":"Ivory Wonder"},
+{"id":"C42","name":"Violet Cheer"},
+{"id":"C43","name":"Rose Specs"},
+{"id":"C44","name":"Teal Delight"},
+{"id":"C45","name":"Golden Diamond"},
+{"id":"C46","name":"Lilac Surprise"},
+{"id":"C47","name":"Sage Listener"},
+{"id":"C48","name":"Coral Crown"}]}];

package/lib/public/modules/mate-knowledge-workbench.js

@@ -350,7 +350,7 @@ function renderExplorer() {
   files.forEach(function (file) {
     var parts = file.name.split('/'); var folder = parts.length > 1 ? parts.slice(0, -1).join('/') : '';
     if (!state.query.trim() && folder !== lastFolder) { var folderRow = document.createElement('div'); folderRow.className = 'knowledge-folder-row'; folderRow.innerHTML = iconHtml('folder') + '<span>' + escapeText(folder || 'Top level') + '</span>'; list.appendChild(folderRow); lastFolder = folder; }
-    var id = documentIdentity(file); var button = document.createElement('button'); button.type = 'button'; button.className = 'knowledge-file-row'; button.dataset.openDocument = id; button.style.setProperty('--knowledge-depth', String(Math.min(parts.length - 1, 6))); if (id === state.selected) button.setAttribute('aria-current', 'true');
+    var id = documentIdentity(file); var button = document.createElement('button'); button.type = 'button'; button.className = 'knowledge-file-row'; button.dataset.openDocument = id; button.dataset.controlRevision = String(file.revision || ''); button.dataset.controlRuntime = store.get('controlRuntimeId') || '';  button.style.setProperty('--knowledge-depth', String(Math.min(parts.length - 1, 6))); if (id === state.selected) button.setAttribute('aria-current', 'true');
     button.innerHTML = iconHtml(file.itemType === 'db' || file.name.endsWith('.jsonl') ? 'database' : 'file-text') + '<span>' + escapeText(parts[parts.length - 1].replace(/\.(md|jsonl)$/i, '')) + (file.snippet ? '<em>' + escapeText(file.snippet) + '</em>' : '') + '</span>' + (file.common ? '<small>shared</small>' : ''); list.appendChild(button);
   });
   if (state.query.trim() && state.searchFiles.length < state.searchTotal) { var more = document.createElement('button'); more.type = 'button'; more.className = 'knowledge-search-more'; more.dataset.searchMore = ''; more.disabled = state.searching; more.textContent = state.searching ? 'Loading more…' : 'Load more results'; list.appendChild(more); }

package/lib/public/modules/mate-loading-scene.js

@@ -0,0 +1,17 @@
+// Decorative opening state; conversation readiness remains with its host.
+export function mateLoadingMarkup() {
+  return '<div data-clay-loading class="mate-loading" role="status" aria-live="polite">' +
+    '<div class="mate-loading-scene" aria-hidden="true">' +
+    '<img class="mate-loading-avatar" alt="">' +
+    '<img class="mate-loading-desk" src="/welcome-art/conversation-desk.png" alt="" decoding="async">' +
+    '</div><p class="mate-loading-label"></p>' +
+    '<div class="mate-loading-dots" aria-hidden="true"><span></span><span></span><span></span></div></div>';
+}
+
+export function updateMateLoadingScene(element, name, avatar) {
+  var image = element.querySelector('.mate-loading-avatar');
+  if (image.getAttribute('src') !== avatar) image.setAttribute('src', avatar);
+  var label = element.querySelector('.mate-loading-label');
+  var text = 'Getting ready with ' + name;
+  if (label.textContent !== text) label.textContent = text;
+}

package/lib/public/modules/mate-management.js

@@ -1,12 +1,14 @@
 // Shared Mate profile and removal flows used by project and Home surfaces.
 
 import { getWs } from './ws-ref.js';
-import { showMateProfilePopover } from './profile.js';
+import { store } from './store.js';
+import { openHomeMateSettings } from './home-mate-settings.js';
 import { showToast } from './utils.js';
 import { showConfirm, hideConfirm } from './app-misc.js';
 import { iconHtml, refreshIcons } from './icons.js';
 
 var mateMenu = null;
+var mateMenuOpener = null;
 
 function send(message) {
   var ws = getWs();
@@ -15,9 +17,13 @@ function send(message) {
 
 export function editMateProfile(anchorEl, mate) {
   if (!anchorEl || !mate || mate.primary) return;
-  showMateProfilePopover(anchorEl, mate, function (updates) {
-    send({ type: "mate_update", mateId: mate.id, updates: updates });
-  });
+  openHomeMateSettings(mate.id, anchorEl);
+}
+
+export function changeMateAvatar(anchorEl, mate) {
+  var current = (store.get('cachedMatesList') || []).find(function (item) { return mate && item.id === mate.id; });
+  if (!anchorEl || !current || current.primary || current.builtinKey === 'clay' || (current.profile || {}).avatarLocked) return false;
+  return openHomeMateSettings(current.id, anchorEl, { avatar: true });
 }
 
 export function confirmMateRemoval(anchorEl, mate, onRemoved) {
@@ -76,9 +82,12 @@ export function confirmMateRemoval(anchorEl, mate, onRemoved) {
   input.focus();
 }
 
-export function closeMateManagementMenu() {
+export function closeMateManagementMenu(restoreFocus) {
+  var opener = mateMenuOpener;
   if (mateMenu) mateMenu.remove();
-  mateMenu = null;
+  mateMenu = null; mateMenuOpener = null;
+  document.removeEventListener("keydown", handleMateMenuKeydown, true);
+  if (restoreFocus && opener && opener.isConnected) opener.focus({ preventScroll: true });
   document.removeEventListener("click", handleMateMenuOutside, true);
 }
 
@@ -86,6 +95,18 @@ function handleMateMenuOutside(event) {
   if (mateMenu && !mateMenu.contains(event.target)) closeMateManagementMenu();
 }
 
+function handleMateMenuKeydown(event) {
+  if (!mateMenu) return;
+  if (event.key === 'Escape') {
+    event.preventDefault(); event.stopPropagation(); closeMateManagementMenu(true); return;
+  }
+  if (event.key === 'Tab') { closeMateManagementMenu(true); return; }
+  var items = Array.from(mateMenu.querySelectorAll('[role="menuitem"]:not(:disabled)'));
+  var index = items.indexOf(document.activeElement);
+  var next = event.key === 'ArrowDown' ? (index + 1) % items.length : event.key === 'ArrowUp' ? (index + items.length - 1) % items.length : event.key === 'Home' ? 0 : event.key === 'End' ? items.length - 1 : -1;
+  if (next >= 0) { event.preventDefault(); event.stopPropagation(); items[next].focus(); }
+}
+
 export function showMateManagementMenu(anchorEl, mate, options) {
   if (!anchorEl || !mate || mate.primary) return;
   options = options || {};
@@ -93,7 +114,16 @@ export function showMateManagementMenu(anchorEl, mate, options) {
   if (options.beforeOpen) options.beforeOpen();
   var menu = document.createElement("div");
   menu.className = "project-ctx-menu";
+  menu.setAttribute('role', 'menu');
+  menu.setAttribute('aria-label', 'Actions for ' + ((mate.profile || {}).displayName || mate.name || 'Mate'));
+  if (!(mate.profile || {}).avatarLocked && mate.builtinKey !== 'clay') {
+    var avatar = document.createElement('button'); avatar.type = 'button'; avatar.className = 'project-ctx-item'; avatar.setAttribute('role', 'menuitem');
+    avatar.innerHTML = iconHtml('image') + ' <span>Change avatar</span>';
+    avatar.addEventListener('click', function (event) { event.stopPropagation(); closeMateManagementMenu(); changeMateAvatar(anchorEl, mate); });
+    menu.appendChild(avatar);
+  }
   var edit = document.createElement("button");
+  edit.type = "button"; edit.setAttribute("role", "menuitem");
   edit.className = "project-ctx-item";
   edit.innerHTML = iconHtml("edit-2") + " <span>Edit Profile</span>";
   edit.addEventListener("click", function (event) {
@@ -102,6 +132,7 @@ export function showMateManagementMenu(anchorEl, mate, options) {
     editMateProfile(anchorEl, mate);
   });
   var remove = document.createElement("button");
+  remove.type = "button"; remove.setAttribute("role", "menuitem");
   remove.className = "project-ctx-item project-ctx-delete";
   remove.innerHTML = iconHtml(mate.builtinKey ? "minus-circle" : "trash-2")
     + " <span>" + (mate.builtinKey ? "Remove mate" : "Delete mate") + "</span>";
@@ -113,7 +144,9 @@ export function showMateManagementMenu(anchorEl, mate, options) {
   menu.appendChild(edit);
   menu.appendChild(remove);
   document.body.appendChild(menu);
-  mateMenu = menu;
+  mateMenu = menu; mateMenuOpener = anchorEl;
+  document.addEventListener("keydown", handleMateMenuKeydown, true);
+  menu.querySelector("[role=menuitem]").focus();
   refreshIcons();
   requestAnimationFrame(function () {
     var rect = anchorEl.getBoundingClientRect();