clay-server 4.8.0-beta.2 → 4.8.0-beta.3

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

@@ -9,7 +9,8 @@ function escapeHtml(value) {
 }
 
 function safeLinks(session) {
-  return (session && Array.isArray(session.githubLinks) ? session.githubLinks : []).filter(function (link) {
+  return (session && Array.isArray(session.githubLinks) ? session.githubLinks : []).concat(session && Array.isArray(session.linearLinks) ? session.linearLinks : []).filter(function (link) {
+    if (link.provider === 'linear') return /^https:\/\/linear\.app\/[a-zA-Z0-9_-]+\/issue\/[A-Z][A-Z0-9_]*-[1-9][0-9]*$/.test(link.url);
     var target = githubLinkTarget(link.url);
     return target && (target.kind === 'issue' || target.kind === 'pull');
   });
@@ -27,7 +28,7 @@ export function orderedGithubWork(session) {
   return links;
 }
 function compactGithubWork(links, sessionRow) {
-  if (!sessionRow) return links.slice(0, 1);
+  if (!sessionRow && !links.some(function (link) { return link.provider === 'linear'; })) return links.slice(0, 1);
   var latestIssue = links.find(function (link) { return link.kind === 'issue'; });
   var latestPr = links.find(function (link) { return link.kind === 'pr'; });
   return [latestIssue, latestPr].filter(Boolean);
@@ -37,6 +38,10 @@ export function githubWorkMarkup(session, detailed, expanded, sessionRow) {
   if (!links.length) return '';
   var displayed = detailed || expanded ? links : compactGithubWork(links, sessionRow);
   return '<span class="session-github-links' + (detailed ? ' github-work-details' : '') + (sessionRow ? ' session-row-github-links' : '') + '">' + displayed.map(function (link) {
+    if (link.provider === 'linear') {
+      var description = link.identifier + ' · ' + link.title + ' · ' + link.stateName + (link.stale ? ' · Last known status' : '');
+      return anchor(link.url, description, iconHtml('circle-dot', 'github-work-status') + '<span class="linear-work-id">' + escapeHtml(link.identifier) + '</span><span class="linear-work-title">' + escapeHtml(link.title) + '</span><span class="linear-work-state">' + escapeHtml(link.stateName) + '</span>', 'session-github-link session-linear-link');
+    }
     var state = ['open', 'closed', 'merged', 'draft'].indexOf(link.state) >= 0 ? link.state : 'unknown';
     var icon = link.kind === 'pr' ? (state === 'merged' ? 'git-merge' : state === 'closed' ? 'git-pull-request-closed' : state === 'draft' ? 'git-pull-request-draft' : 'git-pull-request') : (state === 'closed' ? 'circle-check' : 'circle-dot');
     var description = link.repository + ' · ' + label(link) + ' · ' + link.title + ' · ' + state + (link.checkedAt ? ' · Checked ' + new Date(link.checkedAt).toLocaleString() : '') + (link.stale ? ' (last known status; refresh unavailable)' : '');
@@ -50,7 +55,7 @@ export function githubWorkMarkup(session, detailed, expanded, sessionRow) {
       });
     }
     return html;
-  }).join('') + (!detailed && !expanded && links.length > displayed.length ? '<button type="button" class="github-work-more" aria-label="Show all ' + links.length + ' linked GitHub items" aria-haspopup="dialog" aria-expanded="false" data-github-links="' + escapeHtml(JSON.stringify(safeLinks(session))) + '">+' + (links.length - displayed.length) + '</button>' : '') + '</span>';
+  }).join('') + (!detailed && !expanded && links.length > displayed.length ? '<button type="button" class="github-work-more" aria-label="Show all ' + links.length + ' linked ' + (links.some(function (item) { return item.provider === 'linear'; }) ? 'work items' : 'GitHub items') + '" aria-haspopup="dialog" aria-expanded="false" data-github-links="' + escapeHtml(JSON.stringify(safeLinks(session))) + '">+' + (links.length - displayed.length) + '</button>' : '') + '</span>';
 }
 export function appendGithubWork(row, session, title) {
   var html = githubWorkMarkup(session, false, false, true);
@@ -109,6 +114,8 @@ export function refreshGithubWork() {
   if (!ws || ws.readyState !== 1) return;
   store.set({ githubWorkRefresh: { key: key, at: Date.now() } });
   ws.send(JSON.stringify({ type: 'session_github_refresh', sessionIds: ids }));
+  var linearIds = ids.filter(function (id) { return (store.get('githubWorkSessions') || []).some(function (item) { return item.id === id && (item.linearLinks || []).length; }); });
+  if (linearIds.length) ws.send(JSON.stringify({ type: 'session_linear_refresh', sessionIds: linearIds }));
 }
 
 export function resetGithubWork() {
@@ -126,6 +133,8 @@ function bindGithubWorkPopover() {
   if (store.get('githubWorkPopoverBound')) return;
   store.set({ githubWorkPopoverBound: true });
   document.addEventListener('click', function (event) {
+    var linear = event.target.closest('.session-linear-link');
+    if (linear && !event.metaKey && !event.ctrlKey && !event.shiftKey && !event.altKey) { event.preventDefault(); event.stopPropagation(); closeGithubWorkPopover(); import('./linear-panel.js').then(function (module) { module.openLinear(linear.href); }); return; }
     var button = event.target.closest('.github-work-more');
     if (!button) return;
     event.preventDefault();
@@ -141,8 +150,9 @@ function bindGithubWorkPopover() {
     popup.className = 'github-work-popover';
     popup.setAttribute('popover', 'auto');
     popup.setAttribute('role', 'dialog');
-    popup.setAttribute('aria-label', 'Linked GitHub work');
-    popup.innerHTML = '<strong>Linked GitHub work</strong>' + githubWorkMarkup({ githubLinks: links }, false, true);
+    var workTitle = links.some(function (link) { return link.provider === 'linear'; }) ? 'Linked work' : 'Linked GitHub work';
+    popup.setAttribute('aria-label', workTitle);
+    popup.innerHTML = '<strong>' + workTitle + '</strong>' + githubWorkMarkup({ githubLinks: links }, false, true);
     document.body.appendChild(popup);
     button.setAttribute('aria-expanded', 'true');
     popup.addEventListener('toggle', function (toggle) {

package/lib/public/modules/sticky-notes.js

@@ -195,16 +195,33 @@ export function initStickyNotes() {
 export function showNotes(restoreTemporary) {
   notesVisible = true;
   if (restoreTemporary !== false) store.set({ notesTemporarilyHidden: false });
-  var container = document.getElementById("sticky-notes-container");
-  if (container) container.classList.remove("hidden");
+  applyCanvasVisibility();
   notes.forEach(function (entry) { if (entry && entry.el) syncFlightState(entry.el); });
   syncFlightControls();
 }
 
+// Project Settings owns the screen while open. Suppression is separate from
+// intent: `notesVisible` keeps tracking show/hide requests and updates, and only
+// the canvas element is held hidden, so release shows the latest intended state.
+var notesSuppressed = false;
+function applyCanvasVisibility() {
+  var container = document.getElementById("sticky-notes-container");
+  if (container) container.classList.toggle("hidden", !notesVisible || notesSuppressed);
+}
+export function holdNotesForSettings() {
+  notesSuppressed = true;
+  closeColorPicker();
+  closeFormatToolbar();
+  applyCanvasVisibility();
+}
+export function releaseNotesForSettings() {
+  notesSuppressed = false;
+  applyCanvasVisibility();
+}
+
 export function hideNotes() {
   notesVisible = false;
-  var container = document.getElementById("sticky-notes-container");
-  if (container) container.classList.add("hidden");
+  applyCanvasVisibility();
   closeColorPicker();
   notes.forEach(function (entry) { if (entry && entry.el) syncFlightState(entry.el, true); });
   syncFlightControls();
@@ -290,7 +307,7 @@ export function handleNotesList(msg) {
   // explicit view state and must survive reconnects and list updates.
   if (openCount() > 0 && !notesVisible) {
     notesVisible = true;
-    container.classList.remove("hidden");
+    applyCanvasVisibility();
   }
   if (created) reclampAllNotes();
   syncFlightControls();
@@ -314,7 +331,7 @@ export function handleNoteCreated(msg) {
   // Show container if hidden, unless the user explicitly flew the notes out.
   if (!notesVisible && !store.get("notesTemporarilyHidden")) {
     notesVisible = true;
-    container.classList.remove("hidden");
+    applyCanvasVisibility();
   }
   reclampAllNotes();
   syncFlightControls();

package/lib/public/modules/user-settings.js

@@ -1,3 +1,4 @@
+import { initLinearSettings, loadLinearConnection, clearLinearKeyInput } from './linear-settings.js';
 // user-settings.js — Modal dialog for user settings
 // Account management and logout
 
@@ -41,6 +42,7 @@ export function initUserSettings(appCtx) {
   if (!settingsEl || !openBtn) return;
 
   initCapsulePreference();
+  initLinearSettings();
 
   navItems = settingsEl.querySelectorAll('.us-nav-item');
   sections = settingsEl.querySelectorAll('.us-section');
@@ -297,6 +299,7 @@ export function initUserSettings(appCtx) {
 // settings tab (e.g. the disabled-Mates picker button passing 'us-mates').
 // Falls back to Account so existing callers and the icon click are unchanged.
 export function openUserSettings(initialSection) {
+  loadLinearConnection();
   settingsEl.classList.remove('hidden');
   openBtn.classList.add('active');
   refreshIcons(settingsEl);
@@ -306,6 +309,7 @@ export function openUserSettings(initialSection) {
 }
 
 export function closeUserSettings() {
+  clearLinearKeyInput();
   settingsEl.classList.add('hidden');
   openBtn.classList.remove('active');
 }

package/lib/public/style.css

@@ -1,6 +1,7 @@
 @import url("css/session-github.css");
 @import url("css/vendor-login-browser.css");
 @import url("css/issues.css");
+@import url("css/linear.css");
 @import url("css/base.css?v=20260828-type1");
 @import url("css/icon-strip.css?v=20260828-surfaces4");
 @import url("css/title-bar.css?v=20260828-project-header1");
@@ -45,6 +46,7 @@
 @import url("css/stt.css");
 @import url("css/profile.css");
 @import url("css/user-settings.css?v=20260828-type1");
+@import url("css/settings-ui.css");
 @import url("css/admin.css");
 @import url("css/session-search.css");
 @import url("css/tooltip.css");

package/lib/sdk-bridge.js

@@ -553,6 +553,9 @@ function createSDKBridge(opts) {
       return toolName === name || toolName === "mcp__clay-github__" + name;
     })) return { behavior: "allow", updatedInput: input };
 
+    if (["link_session_linear", "get_session_linear", "unlink_session_linear", "read_linear_issue", "search_linear_issues"].some(function (name) {
+      return toolName === name || toolName === "mcp__clay-linear__" + name;
+    })) return { behavior: "allow", updatedInput: input };
     // Shared-browser handlers enforce session access and live control ownership.
     // All actions use the same tool; do not duplicate its in-app handoff UI.
     if (toolName === "shared_browser" || toolName === "mcp__clay-shared-browser__shared_browser") {
@@ -1109,6 +1112,7 @@ function createSDKBridge(opts) {
           if (codexCatalogCandidate.userInputVersion) session.codexUserInputToolCatalogVersion = codexCatalogCandidate.userInputVersion;
           if (codexCatalogCandidate.sharedBrowserVersion) session.codexSharedBrowserToolCatalogVersion = codexCatalogCandidate.sharedBrowserVersion;
           if (codexCatalogCandidate.issuesVersion) session.codexIssuesToolCatalogVersion = codexCatalogCandidate.issuesVersion;
+          if (codexCatalogCandidate.linearVersion) session.codexLinearToolCatalogVersion = codexCatalogCandidate.linearVersion;
           sm.saveSessionFile(session);
           codexCatalogCandidate = null;
         }
@@ -1790,6 +1794,9 @@ function createSDKBridge(opts) {
     // delivered by this provider.
     var sessionToolDefs = getSessionToolDefs(session) || [];
     var queryGeneration = Number(session._sdkQueryGeneration || 0);
+    var hasLinearCatalog = sessionToolDefs.some(function (tool) { return tool.name === "link_session_linear"; });
+    var recoverCodexLinearTools = sessionAdapter.vendor === "codex" && !!session.cliSessionId
+      && hasLinearCatalog && Number(session.codexLinearToolCatalogVersion || 0) < 1 && canUseSessionTools(session) === true;
     var hasIssueCatalog = false;
     for (var issueToolIndex = 0; issueToolIndex < sessionToolDefs.length; issueToolIndex++) {
       if (sessionToolDefs[issueToolIndex].name === "create_issue") {
@@ -1973,7 +1980,7 @@ function createSDKBridge(opts) {
       dynamicTools: sessionToolDefs,
       // Codex persists dynamic tools with a thread. A stale authorized Driver
       // gets this exact-query bridge; its handlers still reauthorize live.
-      sessionMcpServer: (recoverCodexIssueTools || recoverCodexQuestionTools || recoverCodexBrowserTools) ? getCodexSessionMcpServer(session, queryGeneration) : undefined,
+      sessionMcpServer: (recoverCodexIssueTools || recoverCodexQuestionTools || recoverCodexBrowserTools || recoverCodexLinearTools) ? getCodexSessionMcpServer(session, queryGeneration) : undefined,
       callDynamicTool: function (toolName, args) {
         var toolDef = findSessionToolDef(toolName);
         if (toolDef && typeof toolDef.handler === "function") {
@@ -2192,6 +2199,7 @@ function createSDKBridge(opts) {
       if (requiredCatalogTools.ask_user_questions) {
         codexCatalogCandidate = Object.assign({}, codexCatalogCandidate || {}, { generation: queryGeneration, userInputVersion: 1 });
       }
+      if (hasLinearCatalog) codexCatalogCandidate = Object.assign({}, codexCatalogCandidate || {}, { generation: queryGeneration, linearVersion: 1 });
       if (hasSharedBrowserCatalog) {
         codexCatalogCandidate = Object.assign({}, codexCatalogCandidate || {}, { generation: queryGeneration, sharedBrowserVersion: 3 });
       }

package/lib/server-linear.js

@@ -0,0 +1,50 @@
+var attachStore = require('./linear-store').attachLinearStore;
+var api = require('./linear-api');
+function attachLinear(ctx) {
+  var storage = attachStore(ctx.CONFIG_DIR), pending = new Map();
+  function owner(req) {
+    if (!ctx.isRequestAuthed(req)) return null;
+    if (!ctx.users.isMultiUser()) return 'default';
+    var user = ctx.getMultiUserFromReq(req);
+    return user && user.id;
+  }
+  function json(res, status, body) { res.writeHead(status, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store' }); res.end(JSON.stringify(body)); }
+  function handleRequest(req, res, url) {
+    if (url !== '/api/linear/connection') return false;
+    var id = owner(req);
+    if (!id) { json(res, 401, { error: 'Sign in to connect Linear.' }); return true; }
+    var origin = req.headers.origin;
+    try { if (req.headers['sec-fetch-site'] === 'cross-site' || (origin && new URL(origin).host !== req.headers.host)) throw new Error(); }
+    catch (error) { json(res, 403, { error: 'Invalid request origin.' }); return true; }
+    if (req.method === 'GET') {
+      try { json(res, 200, storage.view(id)); } catch (error) { json(res, 500, { error: 'Could not read Linear connection.' }); }
+      return true;
+    }
+    if (req.method !== 'PUT' && req.method !== 'DELETE') { json(res, 405, { error: 'Method not allowed.' }); return true; }
+    // A disconnect or newer save invalidates an older validation in flight.
+    var operation = {}; pending.set(id, operation);
+    var chunks = [], size = 0;
+    req.on('data', function (chunk) { size += chunk.length; if (size <= 8192) chunks.push(chunk); });
+    req.on('end', async function () {
+      try {
+        if (size > 8192) throw new Error('Request is too large.');
+        var token = null, workspace = null;
+        if (req.method === 'PUT') {
+          var body = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+          if (typeof body.key !== 'string' || !body.key.trim() || body.key.length > 4096 || /[\r\n]/.test(body.key)) throw new Error('Enter a valid Linear API key.');
+          token = body.key.trim();
+          var data = await (ctx.query || api.query)(token, 'query ClayConnection { organization { id name urlKey } }');
+          if (!data.organization || !data.organization.id) throw new Error('Linear workspace is unavailable.');
+          workspace = { id: data.organization.id, name: data.organization.name, slug: data.organization.urlKey };
+        }
+        if (pending.get(id) !== operation || owner(req) !== id || res.destroyed) throw new Error('Connection changed. Please try again.');
+        json(res, 200, storage.save(id, token, workspace));
+      } catch (error) { if (!res.destroyed) json(res, 400, { error: 'Could not update Linear connection. Check your API key and try again.' }); }
+      finally { if (pending.get(id) === operation) pending.delete(id); }
+    });
+    req.on('error', function () { if (pending.get(id) === operation) pending.delete(id); });
+    return true;
+  }
+  return { handleRequest: handleRequest, storage: storage };
+}
+module.exports = { attachLinear: attachLinear };

package/lib/server.js

@@ -443,6 +443,9 @@ function createServer(opts) {
     getMultiUserFromReq: getMultiUserFromReq,
   });
 
+  var linear = require('./server-linear').attachLinear({ users: users, getMultiUserFromReq: getMultiUserFromReq,
+    isRequestAuthed: isRequestAuthed, CONFIG_DIR: CONFIG_DIR });
+
   var speech = serverSpeech.attachSpeech({ users: users, getMultiUserFromReq: getMultiUserFromReq,
     isRequestAuthed: isRequestAuthed, CONFIG_DIR: CONFIG_DIR, getAllowedOrigins: getAllowedOrigins });
 
@@ -798,6 +801,7 @@ function createServer(opts) {
       return;
     }
 
+    if (linear.handleRequest(req, res, fullUrl)) return;
     if (speech.handleRequest(req, res, fullUrl)) return;
     if (networkSettings.handleRequest(req, res, fullUrl)) return;
     if (settings.handleRequest(req, res, fullUrl)) return;
@@ -1352,6 +1356,7 @@ function createServer(opts) {
       workspaceQueryService: workspaceQueryService,
       projectLogsService: projectLogsService,
       issuesService: issuesService,
+      linearStorage: linear.storage,
       mateKnowledgeService: mateKnowledgeService,
       durableScheduler: durableScheduler,
       canAccessProjectSlug: function (userId, targetSlug) {

package/lib/sessions.js

@@ -177,10 +177,12 @@ function createSessionManager(opts) {
         createdAt: session.createdAt,
       };
       if (session.githubLinks) metaObj.githubLinks = session.githubLinks;
+      if (session.linearLinks) metaObj.linearLinks = session.linearLinks;
       if (session.ownerId) metaObj.ownerId = session.ownerId;
       if (session.vendor) metaObj.vendor = session.vendor;
       if (session.codexDynamicToolCatalogVersion) metaObj.codexDynamicToolCatalogVersion = session.codexDynamicToolCatalogVersion;
       if (session.codexUserInputToolCatalogVersion) metaObj.codexUserInputToolCatalogVersion = session.codexUserInputToolCatalogVersion;
+      if (session.codexLinearToolCatalogVersion) metaObj.codexLinearToolCatalogVersion = session.codexLinearToolCatalogVersion;
       if (session.codexSharedBrowserToolCatalogVersion) metaObj.codexSharedBrowserToolCatalogVersion = session.codexSharedBrowserToolCatalogVersion;
       if (session.codexIssuesToolCatalogVersion) metaObj.codexIssuesToolCatalogVersion = session.codexIssuesToolCatalogVersion;
       if (session.model) metaObj.model = session.model;
@@ -347,6 +349,7 @@ function createSessionManager(opts) {
         titleProvisional: m.titleProvisional === true,
         titleAutoGenerated: m.titleAutoGenerated === true,
         githubLinks: Array.isArray(m.githubLinks) ? m.githubLinks.slice(0, 8) : [],
+        linearLinks: Array.isArray(m.linearLinks) ? m.linearLinks.slice(0, 8) : [],
         titleManuallySet: m.titleManuallySet === true || legacyTitleProtected,
         createdAt: m.createdAt || Date.now(),
         lastActivity: loaded[i].mtime || m.createdAt || Date.now(),
@@ -357,6 +360,7 @@ function createSessionManager(opts) {
       if (m.vendor) session.vendor = m.vendor;
       session.codexDynamicToolCatalogVersion = Number(m.codexDynamicToolCatalogVersion || 0);
       session.codexUserInputToolCatalogVersion = Number(m.codexUserInputToolCatalogVersion || 0);
+      session.codexLinearToolCatalogVersion = Number(m.codexLinearToolCatalogVersion || 0);
       session.codexSharedBrowserToolCatalogVersion = Number(m.codexSharedBrowserToolCatalogVersion || 0);
       session.codexIssuesToolCatalogVersion = Number(m.codexIssuesToolCatalogVersion || 0);
       session.model = m.model || deriveSessionModel(loaded[i].history);
@@ -611,6 +615,7 @@ function createSessionManager(opts) {
       cliSessionId: s.cliSessionId || null,
       title: s.title || "New Session",
       githubLinks: s.githubLinks || [],
+      linearLinks: s.linearLinks || [],
       active: isActive,
       isProcessing: s.isProcessing,
       // Sidebar badge: user work only. Ambient housekeeping is surfaced in the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clay-server",
-  "version": "4.8.0-beta.2",
+  "version": "4.8.0-beta.3",
   "description": "Self-hosted team workspace for Claude Code and Codex. Multi-user, browser-based, with persistent AI mates.",
   "bin": {
     "clay-server": "./bin/cli.js"