clay-server 5.2.0-beta.6 → 5.2.0-beta.7

package/lib/workspace-assignment-service.js

@@ -19,6 +19,8 @@ function attachWorkspaceAssignmentService(ctx) {
   var records = [];
   var unsubscribers = {};
   var pendingRestartReplay = {};
+  var presentations = new WeakMap();
+  var presentationTargets = new WeakMap();
 
   function recordFile(userId) {
     return storageDir ? path.join(storageDir, userStorageKey(userId)) : null;
@@ -130,7 +132,27 @@ function attachWorkspaceAssignmentService(ctx) {
     return { project: project, manager: manager, session: session };
   }
 
+  function present(record, principal) {
+    try {
+      var display = ctx.getPresentation && ctx.getPresentation(principal), project = exactTarget(record);
+      if (!display || !project) return;
+      var view = { project: project, session: null, origin: null }; presentationTargets.set(record, view);
+      if (record.delivery === 'follow_up') project.getSessionManager().sessions.forEach(function (session) { if (ctx.sessionRef(record.targetProjectSlug, session) === record.targetSessionRef) { view.session = session; view.origin = session.sessionOriginId; } });
+      var projection = require('./clay-control-target-projection');
+      var target = view.session ? { kind: 'session', projectSlug: record.targetProjectSlug, sessionId: view.session.localId, sessionOriginId: view.origin } : { kind: 'project', projectSlug: record.targetProjectSlug, runtimeId: projection.runtime(project.getSessionManager()) };
+      var observer = display.track('assignment', record.delivery === 'follow_up' ? 'follow_up' : 'assign', target, function () {
+        if (exactTarget(record) !== project || view.session && (project.getSessionManager().sessions.get(view.session.localId) !== view.session || view.session.sessionOriginId !== view.origin || (view.session.ownerId || null) !== (record.userId || null))) throw new Error('Assignment target changed.');
+      }, 'review');
+      if (observer) { presentations.set(record, observer); var expiry = setTimeout(function () { presentations.delete(record); }, 300000); expiry.unref(); }
+    } catch (error) { /* Presentation never changes the assignment decision. */ }
+  }
   function emit(record, eventType) {
+    var observer = presentations.get(record);
+    if (observer) {
+      if (record.status === 'starting') observer.phase('queued');
+      else if (record.status === 'running') observer.phase('running');
+      else if (record.status !== 'proposed') { observer.finish({ status: record.status === 'interrupted' ? 'failed' : record.status, outcome: record.status === 'interrupted' ? 'uncertain' : undefined }); presentations.delete(record); }
+    }
     var source = exactSource(record);
     if (!source) return;
     source.manager.sendAndRecord(source.session, {
@@ -193,6 +215,7 @@ function attachWorkspaceAssignmentService(ctx) {
     if (!exactSource(record)) throw new Error("Source conversation is no longer available.");
     records.push(record);
     saveUser(record.userId);
+    present(record, principal);
     emit(record, "project_assignment_proposal");
     return publicRecord(record);
   }
@@ -229,6 +252,7 @@ function attachWorkspaceAssignmentService(ctx) {
     if (!exactSource(record)) throw new Error("Source conversation is no longer available.");
     records.push(record);
     saveUser(record.userId);
+    present(record, principal);
     emit(record, "project_assignment_proposal");
     return publicRecord(record);
   }
@@ -267,6 +291,7 @@ function attachWorkspaceAssignmentService(ctx) {
   }
 
   function watch(record, manager, session) {
+    var view = presentationTargets.get(record); if (view) { view.session = session; view.origin = session.sessionOriginId; var observer = presentations.get(record); if (observer && observer.target) observer.target({ kind: 'session', projectSlug: record.targetProjectSlug, sessionId: session.localId, sessionOriginId: session.sessionOriginId }); }
     var unsubscribe = manager.subscribeSession(session.localId, function (event) {
       if (event.type === "session_id") {
         record.targetSessionRef = ctx.sessionRef(record.targetProjectSlug, session);

package/lib/workspace-query-mcp-server.js

@@ -32,7 +32,7 @@ function handler(bound, method) {
   };
 }
 
-var SESSION_CITATION = " When citing a returned session in user-visible text, write [clayos/<sessionRef> — short label] so Clay Studio renders an owner-validated session control.";
+var SESSION_CITATION = " Cite returned sessions as Markdown links: [short human label](session:OPAQUE_REFERENCE), replacing the entire target with the exact returned sessionRef. Do not prepend a project name, change the opaque reference, or wrap citations in backticks/code. For a specific returned entry, append #entry-<entryIndex> using its exact returned entry index. Legacy [clayos/<sessionRef> — short label] remains supported. Labels are presentation only; Clay Studio resolves the exact reference with the authenticated owner's permissions.";
 
 function commonTools(bound) {
   return [

package/lib/ws-request.js

@@ -8,6 +8,7 @@ function parseWsRequestUrl(requestUrl) {
     path: parsed.pathname || "/",
     pane: parsed.query.pane === "1",
     paneSession: paneSession,
+    contextual: parsed.query.pane === "1" && parsed.query.contextual === "1",
   };
 }
 

package/lib/ws-schema.js

@@ -11,6 +11,11 @@
  * Use it as a reference when adding new message types.
  */
 
+// message.contextualSnapshot: version=1, viewId, nullable projectTitle,
+// conversationTitle/projectSlug (160 characters), nullable positive sessionId,
+// screen=Home|Project|Direct message. Private canonical owner delivery only.
+// Persisted user_message metadata is echoed in message_ack only after recording;
+// queued admission ACK has no snapshot. Never part of user text/pastes or authority.
 var schema = {
 
   // -----------------------------------------------------------------------
@@ -62,6 +67,7 @@ var schema = {
   "project_assignment_response": { direction: "c2s", handler: "lib/workspace-assignment-service.js", description: "Approve or cancel an exact-session cross-project assignment proposal" },
   "home_clay_session_resolve": { direction: "c2s", handler: "lib/server-home-chat.js", description: "Resolve an opaque Mate session reference through the exact bound source session" },
   "home_clay_session_target": { direction: "s2c", handler: "lib/public/modules/command-palette.js", description: "Return an owner-validated navigation target for a rendered Mate session reference" },
+  "home_clay_contextual_session": { direction: "s2c", handler: "lib/public/modules/contextual-search.js", description: "Return the exact fresh canonical session for an idempotent contextual Ask request; does not submit or execute a message" },
   "issues_list": { direction: "c2s", handler: "lib/project-issues.js", description: "Project Issues issues list" },
   "issue_read": { direction: "c2s", handler: "lib/project-issues.js", description: "Project Issues issue read" },
   "issue_create": { direction: "c2s", handler: "lib/project-issues.js", description: "Project Issues issue create" },
@@ -482,6 +488,7 @@ var schema = {
   "term_resized":             { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Terminal was resized" },
   "term_exited":              { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Terminal process exited" },
   "term_closed":              { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Terminal session was closed" },
+  "term_control_projection": { direction: "s2c", handler: "lib/public/modules/terminal.js", description: "Authoritative terminal identity/revision after owner resize without echoing resize input" },
   "term_list":                { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Full list of open terminals" },
   "term_error":               { direction: "s2c", handler: "lib/public/modules/app-messages.js", description: "Terminal error (e.g. access denied)" },
   "shell_command":            { direction: "c2s", handler: "lib/project-shell-command.js", description: "Run a one-shot shell command for agent context" },
@@ -785,6 +792,7 @@ var schema = {
   // -----------------------------------------------------------------------
   "home_mate_open":           { direction: "c2s", handler: "lib/server-home-chat.js", description: "Open or restore the selected mate's embedded chat session" },
   "home_clay_ask":            { direction: "c2s", handler: "lib/server-home-chat.js", description: "Start a fresh builtin Clay conversation from the global search drawer" },
+  "contextual_mate_sessions_result": { direction: "s2c", handler: "lib/public/modules/contextual-mate-sessions.js", description: "Exact owner-private saved Mate conversation list or selection receipt; no transcript tap or underlying navigation" },
   "home_mate_sessions_list":  { direction: "c2s", handler: "lib/server-home-chat.js", description: "List the current user's conversations with the selected mate" },
   "home_mate_session_open":   { direction: "c2s", handler: "lib/server-home-chat.js", description: "Open one explicit conversation with the selected mate" },
   "home_mate_send":           { direction: "c2s", handler: "lib/server-home-chat.js", description: "Send a message to the selected mate from the home hub" },
@@ -814,6 +822,8 @@ var schema = {
   "clay_navigation_offer":    { direction: "s2c", handler: "lib/public/modules/clay-owner-navigation.js", description: "Offer one exact reviewed navigation to a selected owner connection" },
   "clay_navigation_claim":    { direction: "c2s", handler: "lib/server-owner-ui.js", description: "Claim an offered navigation with live source/target revalidation" },
   "clay_navigation_apply":    { direction: "s2c", handler: "lib/public/modules/clay-owner-navigation.js", description: "Invoke the shared conversation navigator after live claim" },
+  "clay_studio_rendered": { direction: "c2s", handler: "lib/project-studio-presentation.js", description: "Exact source-viewer workbench render receipt; no product effects" },
+  "clay_navigation_rendered": { direction: "c2s", handler: "lib/server-owner-ui.js", description: "Bounded exact-viewer rendered conversation evidence; acceptance alone remains separate" },
   "clay_navigation_ack":      { direction: "c2s", handler: "lib/server-owner-ui.js", description: "Client invocation acknowledgement; never proof of visible rendering" },
   "context_view_get":         { direction: "c2s", handler: "lib/server-context-view.js", description: "Read the authenticated user's context display preference" },
   "context_view_set":         { direction: "c2s", handler: "lib/server-context-view.js", description: "Persist the authenticated user's context display preference" },

package/lib/yoke/claude-hook-installer.js

@@ -45,6 +45,10 @@ var CLAY_MANAGED_ALLOW = [
   "mcp__clay-debate__propose_debate",
   "mcp__clay-mate-creation__propose_mate",
   "mcp__clay-history__*",
+  "mcp__clay-workspace__read_current_context",
+  "mcp__clay-workspace__read_selected_context",
+  "mcp__clay-workspace__open_context_conversation",
+  "mcp__clay-workspace__read_context_navigation_receipt",
   "mcp__clay-workspace__read_owner_screen",
   "mcp__clay-workspace__inspect_owner_screen_change",
   "mcp__clay-workspace__control_owner_screen",

package/package.json

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