clay-server 5.1.1-beta.1 → 5.2.0-beta.10

package/lib/public/modules/home-mate-settings.js

@@ -8,7 +8,7 @@ import { store } from './store.js';
 import { getWs } from './ws-ref.js';
 import { iconHtml, refreshIcons } from './icons.js';
 import { confirmMateRemoval } from './mate-management.js';
-import { renderHomeMateAvatarEditor, confirmHomeMateAvatar, failHomeMateAvatar, clearHomeMateAvatarEditor } from './home-mate-avatar-editor.js';
+import { hasHomeMateAvatarDraft, homeMateAvatarSaving, renderHomeMateAvatarEditor, confirmHomeMateAvatar, failHomeMateAvatar, clearHomeMateAvatarEditor } from './home-mate-avatar-editor.js';
 import { resetHomeMateModelPicker, clearHomeMateModelPicker, hasHomeMateModelDraft, requestHomeMateModels, renderHomeMateModelPicker, applyHomeMateModelsState, applyHomeMateModelResult } from './home-mate-model-picker.js';
 
 var dialog = null;
@@ -73,16 +73,19 @@ function renderGeneral(body, mate) {
   description.textContent = "Manage " + getMateName(mate) + "’s identity and appearance.";
   body.appendChild(description);
   renderMateProfile(body, mate, renderDialogContent, function () {
+    if (homeMateAvatarSaving()) return;
+    if (store.get('mateSettingsAvatarOpen') && hasHomeMateAvatarDraft()) {
+      showConfirm('Discard this avatar choice?', function () { clearHomeMateAvatarEditor(); store.set({mateSettingsAvatarOpen:false}); renderDialogContent(); document.getElementById('mate-profile-avatar').focus(); }, 'Discard choice');
+      return;
+    }
+    clearHomeMateAvatarEditor();
     store.set({mateSettingsAvatarOpen: !store.get('mateSettingsAvatarOpen')});
     renderDialogContent();
   });
   if (store.get('mateSettingsAvatarOpen')) {
     var appearance = document.createElement("section");
     appearance.className = "mate-settings-appearance";
-    renderHomeMateAvatarEditor(appearance, mate, renderDialogContent);
-    var done = document.createElement('button'); done.type = 'button'; done.className = 'mate-settings-button'; done.textContent = 'Done';
-    done.addEventListener('click',function () { store.set({mateSettingsAvatarOpen:false}); renderDialogContent(); document.getElementById('mate-profile-avatar').focus(); });
-    appearance.appendChild(done);
+    renderHomeMateAvatarEditor(appearance, mate, renderDialogContent, store.get('mateSettingsAvatarDirect') ? function () { clearHomeMateAvatarEditor(); renderDialogContent(); closeHomeMateSettings(); } : null);
     body.appendChild(appearance);
   }
   renderMateColorPicker(body, mate, renderDialogContent);
@@ -118,7 +121,7 @@ function requestSection(section) {
 function savePending() {
   var prompt = store.get('mateInstructionsDraft');
   var model = store.get('mateModelDraft');
-  return mateColorSaving() || mateProfileSaving() || !!((prompt && prompt.status === 'saving') || (model && model.saveId));
+  return homeMateAvatarSaving() || mateColorSaving() || mateProfileSaving() || !!((prompt && prompt.status === 'saving') || (model && model.saveId));
 }
 
 function renderDialogContent() {
@@ -199,7 +202,7 @@ function handleDialogKeydown(event) {
 
 export function closeHomeMateSettings(force) {
   if (force !== true && savePending()) return false;
-  if (force !== true && (hasMateProfileDraft() || hasMateInstructionDraft() || hasHomeMateModelDraft())) {
+  if (force !== true && (hasHomeMateAvatarDraft() || hasMateProfileDraft() || hasMateInstructionDraft() || hasHomeMateModelDraft())) {
     var previous = document.activeElement;
     showConfirm("Discard unsaved Mate settings?", function () { closeHomeMateSettings(true); }, "Discard changes", false, function () { if (previous && previous.isConnected) previous.focus(); });
     document.getElementById("confirm-cancel").focus();
@@ -215,7 +218,7 @@ export function closeHomeMateSettings(force) {
   memoryState = null;
   knowledgeState = null;
   modelRequested = false;
-  store.set({mateSettingsAvatarOpen:false});
+  store.set({mateSettingsAvatarOpen:false, mateSettingsAvatarDirect:false});
   resetMateProfile();
   resetMateColor();
   clearHomeMateModelPicker();
@@ -230,12 +233,13 @@ export function closeHomeMateSettings(force) {
 export function openHomeMateSettings(mateId, opener, options) {
   var mate = getMate(mateId);
   if (!mate || (dialog && savePending())) return false;
-  if (dialog && (hasMateProfileDraft() || hasMateInstructionDraft() || hasHomeMateModelDraft())) {
+  if (dialog && (hasHomeMateAvatarDraft() || hasMateProfileDraft() || hasMateInstructionDraft() || hasHomeMateModelDraft())) {
     showConfirm("Discard unsaved Mate settings?", function () { closeHomeMateSettings(true); openHomeMateSettings(mateId, opener, options); }, "Discard changes", false);
     return false;
   }
   closeHomeMateSettings(true);
   resetMateInstructions(mateId);
+  store.set({ mateSettingsAvatarOpen: !!(options && options.avatar && !(mate.profile || {}).avatarLocked), mateSettingsAvatarDirect: !!(options && options.avatar) });
   dialogMateId = mateId;
   dialogOpener = opener || document.activeElement;
   dialogSection = options && ["model", "prompt"].indexOf(options.section) !== -1 ? options.section : "general";
@@ -308,7 +312,10 @@ export function openHomeMateSettings(mateId, opener, options) {
   requestSection(dialogSection);
   loadMateInstructions(renderDialogContent);
   refreshIcons();
-  requestAnimationFrame(function () { close.focus({ preventScroll: true }); });
+  requestAnimationFrame(function () {
+    var first = options && options.avatar && dialog ? (dialog.querySelector('.home-mate-avatar-choice[aria-pressed="true"]:not(:disabled)') || dialog.querySelector('.home-mate-avatar-choice:not(:disabled)')) : null;
+    (first || close).focus();
+  });
   return true;
 }
 
@@ -354,7 +361,7 @@ export function syncHomeMateSettingsTarget(msg) {
   var mate = getMate(dialogMateId);
   if (!mate) closeHomeMateSettings();
   else {
-    confirmHomeMateAvatar(mate);
+    confirmHomeMateAvatar(mate, msg && msg.requestId);
     dialog.querySelector(".home-mate-settings-header span").textContent = getMateName(mate);
     renderDialogContent();
   }
@@ -364,7 +371,7 @@ export function handleHomeMateAvatarError(msg) {
   if (!dialog || !msg) return false;
   var colorHandled = applyMateColorResult(msg);
   var profileHandled = applyMateProfile(msg);
-  if (!colorHandled && !profileHandled && !failHomeMateAvatar(msg.mateId, msg.error)) return false;
+  if (!colorHandled && !profileHandled && !failHomeMateAvatar(msg.mateId, msg.error, msg.requestId)) return false;
   renderDialogContent();
   return true;
 }

package/lib/public/modules/icon-strip-tooltip.js

@@ -81,7 +81,8 @@ export function showIconTooltipHtml(el, html, options) {
 export function bindIconTooltip(el, resolveMetadata) {
   function show() {
     var metadata = tooltipMetadata(typeof resolveMetadata === "function" ? resolveMetadata() : resolveMetadata);
-    showIconTooltip(el, metadata.text || "", metadata);
+    if (!metadata.text) { hideIconTooltip(); return; }
+    showIconTooltip(el, metadata.text, metadata);
   }
   el.addEventListener("mouseenter", show);
   el.addEventListener("focus", show);

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); }