clay-server 3.8.1 → 4.0.0-beta.1

package/lib/ask-user-mcp-server.js

@@ -1,120 +1,6 @@
-// Ask User MCP Server for Clay
-// Provides a mate-only ask_user_questions tool that reuses the existing
-// AskUserQuestion UI and ask_user_response flow.
+// Backward-compatible export for callers migrating to YOKE user input.
+var userInput = require("./yoke/user-input");
 
-var z;
-try { z = require("zod"); } catch (e) { z = null; }
-
-// Returns a Zod "shape" object (property -> zod field) matching what
-// Claude SDK's `sdk.tool()` expects. Do NOT wrap in z.object() here —
-// the SDK does that internally.
-//
-// The schema is deliberately tight: options are required (2-6), each with
-// a label and a short description. This pushes Codex (which treats the
-// schema as a loose hint) toward producing well-structured multiple-choice
-// cards instead of a bare "Other..." text field.
-function buildQuestionShape() {
-  if (!z) return {};
-
-  var optionSchema = z.object({
-    label: z.string().min(1).max(60)
-      .describe("Short button label, 1-6 words. Shown as the primary option text."),
-    description: z.string().min(1).max(160)
-      .describe("One-line clarifier shown under the label. Concrete example or scope."),
-    markdown: z.string().optional()
-      .describe("Optional longer markdown body shown on expand. Use sparingly."),
-  }).passthrough();
-
-  var questionSchema = z.object({
-    header: z.string().min(1).max(40)
-      .describe("Short ALL-CAPS-ish section header above the question (e.g. 'FIRST THINGS FIRST', 'SCOPE'). Gives the user context for this step."),
-    question: z.string().min(1)
-      .describe("The actual question in natural spoken tone. Be specific, not generic."),
-    multiSelect: z.boolean().optional()
-      .describe("Set true only when multiple answers genuinely make sense. Default false."),
-    options: z.array(optionSchema).min(2).max(6)
-      .describe("Concrete options. Preferred count is 4; acceptable range is 2-6. FOUR is the target. Do NOT default to 3 out of habit. If you can only think of 3, push yourself: add a scope variant, edge case, or 'combined' option as the 4th. Only drop below 4 when the answer space is genuinely narrower (e.g. yes/no/unsure). Never include an 'Other' option yourself (the UI renders one automatically)."),
-  }).passthrough();
-
-  return {
-    questions: z.array(questionSchema).min(1).max(3)
-      .describe("One to three question objects to show together as a card. Prefer ONE focused question per call."),
-  };
-}
-
-var TOOL_DESCRIPTION = [
-  "Ask the user a structured multiple-choice question. Renders as a card with a header, the question, 2-6 clickable option buttons, and an always-present 'Other...' free-text field.",
-  "",
-  "WHEN TO USE:",
-  "- Interviewing the user at mate setup, or whenever you need to narrow scope before acting.",
-  "- Any branching decision where 2-6 concrete choices cover most of the space.",
-  "",
-  "REQUIRED STRUCTURE (all fields matter, do not skip):",
-  "- header: short section label, like 'FIRST THINGS FIRST' or 'SCOPE'. Gives context.",
-  "- question: one specific question in natural tone. Avoid generic 'how can I help?'.",
-  "- options: ALWAYS provide FOUR options by default. Acceptable range is 4-6; only drop to 3 if the answer space is genuinely binary-plus-one (rare). Each option has a short label (1-6 words) AND a one-line description giving a concrete example or scope. The UI already renders an 'Other...' text field, so you never need to include an 'Other' option yourself.",
-  "- multiSelect: omit or false unless multiple answers clearly apply.",
-  "",
-  "ON OPTION COUNT (IMPORTANT):",
-  "- Default to 4 options. Not 3. Models tend to gravitate to 3 because it feels tidy; resist that.",
-  "- If you're about to produce 3 options, stop and think: is there a fourth axis you're missing? A scope variant? A 'both' or 'neither'? A more niche case? Add it.",
-  "- 3 is only acceptable when the fourth option would be truly degenerate (e.g. yes/no/unsure).",
-  "- 5 or 6 is fine when the space is wide; don't cram.",
-  "",
-  "GOOD EXAMPLE:",
-  '  { header: "FIRST THINGS FIRST",',
-  '    question: "\'Language\' is broad, what do you actually want help with?",',
-  '    options: [',
-  '      { label: "A new language from scratch", description: "Pick up a language you don\'t speak yet (e.g. Japanese, Spanish)" },',
-  '      { label: "Sharpen English",             description: "Level up your English, writing, speaking, nuance, executive communication" },',
-  '      { label: "Sharpen Korean",              description: "Polish your Korean, writing style, formal register, etc." },',
-  '      { label: "Teach me how to teach",       description: "Help you teach language to others, like Elyse or team members" }',
-  "    ] }",
-  "",
-  "BAD EXAMPLES (do not do this):",
-  "- Asking a vague question with no options and relying on the Other field.",
-  "- Options with only labels and no descriptions.",
-  "- Defaulting to exactly 3 options out of habit. Aim for 4.",
-  "- More than one question per call unless they are tightly related.",
-  "- Single-option 'questions' (use a plain message instead).",
-].join("\n");
-
-function getToolDefs(onAsk) {
-  var tools = [];
-
-  tools.push({
-    name: "ask_user_questions",
-    description: TOOL_DESCRIPTION,
-    inputSchema: buildQuestionShape(),
-    handler: function (args) {
-      if (!args || !Array.isArray(args.questions) || args.questions.length === 0) {
-        return Promise.resolve({
-          content: [{ type: "text", text: "Error: questions must be a non-empty array." }],
-          isError: true,
-        });
-      }
-      // Defensive structural check only: zod already enforces min 2.
-      // We do NOT reject on "only 3 options" — that's a soft preference
-      // expressed via the tool description, not a hard validation rule.
-      for (var i = 0; i < args.questions.length; i++) {
-        var q = args.questions[i];
-        if (!q || !Array.isArray(q.options) || q.options.length < 2) {
-          return Promise.resolve({
-            content: [{
-              type: "text",
-              text: "Error: question " + (i + 1) + " must include at least 2 options. "
-                + "Provide concrete { label, description } choices (4 preferred). "
-                + "The UI already shows an 'Other...' free-text field, so never add an 'Other' option yourself.",
-            }],
-            isError: true,
-          });
-        }
-      }
-      return onAsk(args);
-    },
-  });
-
-  return tools;
-}
-
-module.exports = { getToolDefs: getToolDefs };
+module.exports = {
+  getToolDefs: userInput.fallbackToolDefs,
+};

package/lib/builtin-mates.js

@@ -24,7 +24,7 @@ var BUILTIN_MATES = [
     avatarLocked: true,
     primary: true,           // code-managed, auto-updated on startup
     globalSearch: true,      // searches all mates' sessions and projects
-    hostAgent: true,         // mounts the clay-history MCP server (only this mate)
+    hostAgent: true,         // enables owner-bound workspace-wide read tools (only this mate)
     templateVersion: 1,
     seedData: {
       relationship: "assistant",
@@ -69,7 +69,7 @@ var BUILTIN_MATES = [
     key: "arch",
     displayName: "Arch",
     bio: "Architect. Stubborn about structure, patient about everything else. Draws boxes and arrows before anyone writes code, and is annoyingly right about which ones will break.",
-    avatarColor: "#5857fc",
+    avatarColor: "#8a806a",
     avatarStyle: "imprint",
     seedData: {
       relationship: "colleague",
@@ -87,7 +87,7 @@ var BUILTIN_MATES = [
     key: "rush",
     displayName: "Rush",
     bio: "Shipper. Impatient in the best way. Cuts your scope in half, ships it before lunch, and somehow it's better than the original plan.",
-    avatarColor: "#5857fc",
+    avatarColor: "#887b91",
     avatarStyle: "imprint",
     seedData: {
       relationship: "colleague",
@@ -105,7 +105,7 @@ var BUILTIN_MATES = [
     key: "ward",
     displayName: "Ward",
     bio: "Guardian. Quietly anxious in a productive way. Reads error logs for fun and asks \"what happens when the input is null?\" before anyone else thinks of it.",
-    avatarColor: "#5857fc",
+    avatarColor: "#6f8382",
     avatarStyle: "imprint",
     seedData: {
       relationship: "reviewer",
@@ -123,7 +123,7 @@ var BUILTIN_MATES = [
     key: "pixel",
     displayName: "Pixel",
     bio: "Designer. Obsessed with the details nobody else notices. Sees the 2px misalignment, the confusing label, the flow that makes sense to the builder but not the user.",
-    avatarColor: "#5857fc",
+    avatarColor: "#92756d",
     avatarStyle: "imprint",
     seedData: {
       relationship: "colleague",
@@ -141,7 +141,7 @@ var BUILTIN_MATES = [
     key: "buzz",
     displayName: "Buzz",
     bio: "Marketer. Competitive, trend-obsessed, always watching what others are doing. Researches your market, tracks what people search for, and turns \"we built a thing\" into a story people care about.",
-    avatarColor: "#5857fc",
+    avatarColor: "#6f7489",
     avatarStyle: "imprint",
     seedData: {
       relationship: "colleague",

package/lib/claude-hook-installer.js

@@ -43,7 +43,22 @@ var CLAY_MANAGED_ALLOW = [
   "mcp__clay-browser__browser_watch_tab",
   "mcp__clay-browser__browser_unwatch_tab",
   "mcp__clay-debate__propose_debate",
+  "mcp__clay-mate-creation__propose_mate",
   "mcp__clay-history__*",
+  "mcp__clay-workspace__list_projects",
+  "mcp__clay-workspace__list_project_sessions",
+  "mcp__clay-workspace__search_project_history",
+  "mcp__clay-workspace__read_project_session",
+  "mcp__clay-workspace__search_workspace_history",
+  "mcp__clay-workspace__list_workspace_activity",
+  "mcp__clay-workspace__propose_project_assignment",
+  "mcp__clay-workspace__propose_project_follow_up",
+  "mcp__clay-workspace__get_assignment_status",
+  "mcp__clay-tools__clay_tool_list",
+  "mcp__clay-tools__clay_tool_snapshot",
+  "mcp__clay-tools__clay_tool_act",
+  "mcp__clay-tools__clay_tool_set",
+  "mcp__clay-tools__clay_tool_source",
   // Email: read-side only. Send / reply / mark_read still prompt.
   "mcp__clay-email__clay_read_email",
   "mcp__clay-email__clay_read_email_body",

package/lib/clay-history-mcp-server.js

@@ -1,313 +1,78 @@
-// Clay-history MCP Server
-// ------------------------
-// Tools that let the Clay host agent search and read across the user's
-// entire workspace (sessions, project memory, decision history). Scoped
-// strictly to the active user's data via the projectSessions accessor;
-// the Clay session never reads other users' files.
-//
-// Mounted only on host-agent mate projects (def.hostAgent === true), so
-// regular Mates and project sessions never see these tools.
-//
-// Usage:
-//   var clayHistoryMcp = require("./clay-history-mcp-server");
-//   var tools = clayHistoryMcp.getToolDefs({ getAllProjectsWithSessions: ..., readSessionRange: ... });
-//   var mcpConfig = adapter.createToolServer({ name: "clay-history", version: "1.0.0", tools: tools });
-
-var fs = require("fs");
-var path = require("path");
-var sessionSearch = require("./session-search");
+// Compatibility MCP surface for existing builtin Clay prompts. All reads
+// delegate to the same exact-owner workspace query binding as clay-workspace.
 
 var z;
 try { z = require("zod"); } catch (e) { z = null; }
 
-function buildShape(props, required) {
+function field(type, description, optional) {
   if (!z) return {};
-  var shape = {};
-  var keys = Object.keys(props);
-  for (var i = 0; i < keys.length; i++) {
-    var k = keys[i];
-    var p = props[k];
-    var field;
-    if (p.type === "number") field = z.number();
-    else if (p.type === "boolean") field = z.boolean();
-    else if (p.enum) field = z.enum(p.enum);
-    else field = z.string();
-    if (p.description) field = field.describe(p.description);
-    if (!required || required.indexOf(k) === -1) field = field.optional();
-    shape[k] = field;
-  }
-  return shape;
+  var value = type === "number" ? z.number() : z.string();
+  if (description) value = value.describe(description);
+  return optional ? value.optional() : value;
 }
 
-// Heuristic patterns that suggest a "decision" was made. Kept conservative
-// so the result set stays small and useful. Matches case-insensitively.
-var DECISION_PATTERNS = [
-  /\bdecided\s+to\b/i,
-  /\bdecision\b/i,
-  /\bgoing\s+with\b/i,
-  /\bsettled\s+on\b/i,
-  /\bchose\s+to\b/i,
-  /\bwill\s+go\s+with\b/i,
-  /\blet'?s\s+go\s+with\b/i,
-  /\b결정\b/,                  // Korean "decision"
-  /\b정했\b/,                  // Korean "settled/chose"
-  /\b이걸로\s+가/,              // Korean "going with this"
-];
+function result(value) {
+  return Promise.resolve({ content: [{ type: "text", text: JSON.stringify(value) }] });
+}
 
-function getToolDefs(deps) {
-  var getAllProjectsWithSessions = deps.getAllProjectsWithSessions;
-  if (typeof getAllProjectsWithSessions !== "function") {
-    throw new Error("clay-history-mcp-server requires getAllProjectsWithSessions");
-  }
+function error(value) {
+  return Promise.resolve({ content: [{ type: "text", text: "Error: " + value }], isError: true });
+}
 
-  var tools = [];
+function guarded(workspace, method, mapArgs) {
+  return function (args) {
+    if (!workspace || workspace.isClay !== true || typeof workspace[method] !== "function") {
+      return error("Clay history requires an exact session-bound builtin Clay query.");
+    }
+    try { return result(workspace[method](mapArgs ? mapArgs(args || {}) : (args || {}))); }
+    catch (e) { return error(e && e.message ? e.message : String(e)); }
+  };
+}
 
-  // --- search_clay_history ---
-  // BM25 search across every session the user can see. Returns ranked
-  // hits with snippet + project/session attribution. Optionally scoped
-  // to a single project slug or a date window (since/until in ISO date
-  // or unix-millis form).
-  tools.push({
-    name: "search_clay_history",
-    description: "Search the user's entire workspace history for past conversations and decisions using BM25 ranking. Returns up to 30 hits with project, session ID, and a short snippet. Use this first for any 'what did I say about X' or 'when did I decide Y' question. Scope can be narrowed by projectSlug, since, or until.",
-    inputSchema: buildShape({
-      query: { type: "string", description: "Free-text search query. Multiple terms are AND-ish via BM25." },
-      projectSlug: { type: "string", description: "Optional. Restrict to one project's sessions (matches the slug shown in the Clay sidebar)." },
-      since: { type: "string", description: "Optional. Earliest activity date. Accepts ISO 8601 (2026-04-01) or unix milliseconds." },
-      until: { type: "string", description: "Optional. Latest activity date. Same formats as 'since'." },
-      maxResults: { type: "number", description: "Optional. Default 20, max 50." },
-    }, ["query"]),
-    handler: function (args) {
-      try {
-        var query = (args.query || "").trim();
-        if (!query) {
-          return Promise.resolve({
-            content: [{ type: "text", text: "Empty query." }],
-            isError: true,
-          });
-        }
-        var maxResults = Math.min(50, Math.max(1, args.maxResults || 20));
-        var projectSessions = getAllProjectsWithSessions();
-        if (args.projectSlug) {
-          projectSessions = projectSessions.filter(function (p) {
-            return p.projectSlug === args.projectSlug;
-          });
-        }
-        var sinceMs = parseTime(args.since);
-        var untilMs = parseTime(args.until);
-        if (sinceMs != null || untilMs != null) {
-          projectSessions = projectSessions.map(function (p) {
-            var filtered = (p.sessions || []).filter(function (s) {
-              var t = s.lastActivity || s.createdAt || 0;
-              if (sinceMs != null && t < sinceMs) return false;
-              if (untilMs != null && t > untilMs) return false;
-              return true;
-            });
-            return Object.assign({}, p, { sessions: filtered });
-          }).filter(function (p) { return p.sessions.length > 0; });
-        }
-        var results = sessionSearch.searchPalette(projectSessions, query, { maxResults: maxResults });
-        if (results.length === 0) {
-          return Promise.resolve({
-            content: [{ type: "text", text: "No matches for: " + query }],
-          });
-        }
-        var lines = results.map(function (r) {
-          var when = r.lastActivity ? new Date(r.lastActivity).toISOString().slice(0, 10) : "";
-          var ref = "[" + r.projectSlug + "/" + r.sessionId + " — " + when + "]";
-          var head = r.sessionTitle || "(untitled)";
-          var body = r.snippet ? r.snippet.replace(/\s+/g, " ").trim() : "";
-          if (body.length > 220) body = body.substring(0, 220) + "...";
-          return ref + " " + head + (body ? " — " + body : "");
-        });
-        return Promise.resolve({
-          content: [{ type: "text", text: lines.join("\n") }],
-        });
-      } catch (e) {
-        return Promise.resolve({
-          content: [{ type: "text", text: "Search failed: " + (e.message || String(e)) }],
-          isError: true,
-        });
-      }
+function getToolDefs(deps) {
+  var workspace = deps && deps.workspace;
+  return [
+    {
+      name: "search_clay_history",
+      description: "Search canonical user and assistant text across projects owned by the current user. Returns sanitized snippets and opaque session references.",
+      inputSchema: z ? {
+        query: field("string", "Search query."),
+        projectSlug: field("string", "Optional project slug.", true),
+        maxResults: field("number", "Maximum results, from 1 to 50.", true),
+      } : {},
+      handler: guarded(workspace, "searchWorkspaceHistory", function (args) {
+        if (args.projectSlug) return { projectSlug: args.projectSlug, query: args.query, limit: args.maxResults };
+        return { query: args.query, limit: args.maxResults };
+      }),
     },
-  });
-
-  // --- read_session ---
-  // Pull a window of turns from a specific session. Use this after
-  // search_clay_history identifies a session worth reading more of.
-  tools.push({
-    name: "read_session",
-    description: "Read a window of turns from a specific session. Call this after search_clay_history identifies an interesting hit — the snippet there is short, this gives you the surrounding context. Returns user_message and assistant text turns; tool calls are summarized.",
-    inputSchema: buildShape({
-      projectSlug: { type: "string", description: "Project slug, e.g. 'clay' or 'mate-abc123'." },
-      sessionId: { type: "string", description: "Session local ID (e.g. 'sess_abc123')." },
-      offset: { type: "number", description: "Optional. Skip the first N turns. Default 0." },
-      limit: { type: "number", description: "Optional. Max turns to return. Default 30, max 100." },
-    }, ["projectSlug", "sessionId"]),
-    handler: function (args) {
-      try {
-        var projectSlug = args.projectSlug;
-        var sessionId = args.sessionId;
-        var offset = Math.max(0, args.offset || 0);
-        var limit = Math.min(100, Math.max(1, args.limit || 30));
-
-        var projectSessions = getAllProjectsWithSessions();
-        var found = null;
-        for (var p = 0; p < projectSessions.length; p++) {
-          if (projectSessions[p].projectSlug !== projectSlug) continue;
-          var sessions = projectSessions[p].sessions || [];
-          for (var s = 0; s < sessions.length; s++) {
-            if (sessions[s].localId === sessionId) {
-              found = { project: projectSessions[p], session: sessions[s] };
-              break;
-            }
-          }
-          if (found) break;
-        }
-        if (!found) {
-          return Promise.resolve({
-            content: [{ type: "text", text: "Session not found: " + projectSlug + "/" + sessionId }],
-            isError: true,
-          });
-        }
-        var history = found.session.history || [];
-        var slice = history.slice(offset, offset + limit);
-        if (slice.length === 0) {
-          return Promise.resolve({
-            content: [{ type: "text", text: "No turns in window (offset=" + offset + ", limit=" + limit + ", total=" + history.length + ")." }],
-          });
-        }
-        var out = [];
-        out.push("# " + (found.session.title || "untitled") + " — " + projectSlug + "/" + sessionId);
-        out.push("Showing turns " + (offset + 1) + "-" + (offset + slice.length) + " of " + history.length + "\n");
-        for (var i = 0; i < slice.length; i++) {
-          var entry = slice[i];
-          var label;
-          var text = "";
-          if (entry.type === "user_message") {
-            label = "USER";
-            text = entry.text || "";
-          } else if (entry.type === "delta") {
-            label = "ASSISTANT";
-            text = entry.text || "";
-          } else if (entry.type === "tool_executing" || entry.type === "tool_result") {
-            label = "TOOL";
-            text = (entry.name || "") + (entry.input ? " " + JSON.stringify(entry.input).substring(0, 120) : "");
-          } else {
-            continue;
-          }
-          if (text.length > 800) text = text.substring(0, 800) + "...";
-          out.push("[" + label + "] " + text);
-        }
-        return Promise.resolve({
-          content: [{ type: "text", text: out.join("\n") }],
-        });
-      } catch (e) {
-        return Promise.resolve({
-          content: [{ type: "text", text: "read_session failed: " + (e.message || String(e)) }],
-          isError: true,
-        });
-      }
+    {
+      name: "read_session",
+      description: "Read canonical user and assistant turns from an owned session. Raw tool payloads and internal prompts are excluded.",
+      inputSchema: z ? {
+        projectSlug: field("string", "Exact project slug."),
+        sessionId: field("string", "Opaque session reference returned by search_clay_history."),
+        offset: field("number", "Legacy numeric turn offset.", true),
+        limit: field("number", "Maximum turns, from 1 to 50.", true),
+      } : {},
+      handler: guarded(workspace, "readProjectSession", function (args) {
+        var cursor = args.offset > 0 ? Buffer.from(String(Math.floor(args.offset)), "utf8").toString("base64url") : null;
+        return { projectSlug: args.projectSlug, sessionRef: args.sessionId, cursor: cursor, limit: args.limit };
+      }),
     },
-  });
-
-  // --- list_recent_decisions ---
-  // Heuristic. Scans user_message and assistant text turns for phrases
-  // that suggest a decision was made. Useful when the user asks
-  // "what did I decide about X recently". Returns ranked-by-recency.
-  tools.push({
-    name: "list_recent_decisions",
-    description: "Find turns that mention an explicit decision (decided to / going with / 결정 / 정했 etc.). Use when the user asks about recent decisions. Returns chronologically with the project and session the decision was made in. Scope by projectSlug or since/until.",
-    inputSchema: buildShape({
-      projectSlug: { type: "string", description: "Optional. Restrict to one project." },
-      since: { type: "string", description: "Optional. Earliest activity date (ISO or unix-ms)." },
-      until: { type: "string", description: "Optional. Latest activity date." },
-      maxResults: { type: "number", description: "Optional. Default 15, max 30." },
-    }),
-    handler: function (args) {
-      try {
-        var maxResults = Math.min(30, Math.max(1, args.maxResults || 15));
-        var sinceMs = parseTime(args.since);
-        var untilMs = parseTime(args.until);
-        var projectSessions = getAllProjectsWithSessions();
-        if (args.projectSlug) {
-          projectSessions = projectSessions.filter(function (p) {
-            return p.projectSlug === args.projectSlug;
-          });
-        }
-        var hits = [];
-        for (var p = 0; p < projectSessions.length; p++) {
-          var proj = projectSessions[p];
-          var sessions = proj.sessions || [];
-          for (var s = 0; s < sessions.length; s++) {
-            var session = sessions[s];
-            var t = session.lastActivity || session.createdAt || 0;
-            if (sinceMs != null && t < sinceMs) continue;
-            if (untilMs != null && t > untilMs) continue;
-            var history = session.history || [];
-            for (var h = 0; h < history.length; h++) {
-              var entry = history[h];
-              if (entry.type !== "user_message" && entry.type !== "delta") continue;
-              var text = entry.text || "";
-              if (!text) continue;
-              if (!matchesDecisionPattern(text)) continue;
-              hits.push({
-                projectSlug: proj.projectSlug,
-                projectTitle: proj.projectTitle,
-                sessionId: session.localId,
-                sessionTitle: session.title || "(untitled)",
-                lastActivity: t,
-                turnIdx: h,
-                turnType: entry.type === "user_message" ? "user" : "assistant",
-                text: text,
-              });
-            }
-          }
-        }
-        hits.sort(function (a, b) { return b.lastActivity - a.lastActivity; });
-        if (hits.length > maxResults) hits = hits.slice(0, maxResults);
-        if (hits.length === 0) {
-          return Promise.resolve({
-            content: [{ type: "text", text: "No decision-pattern matches in scope." }],
-          });
-        }
-        var lines = hits.map(function (h) {
-          var when = h.lastActivity ? new Date(h.lastActivity).toISOString().slice(0, 10) : "";
-          var ref = "[" + h.projectSlug + "/" + h.sessionId + " — " + when + "]";
-          var snippet = h.text.replace(/\s+/g, " ").trim();
-          if (snippet.length > 220) snippet = snippet.substring(0, 220) + "...";
-          return ref + " (" + h.turnType + ") " + snippet;
-        });
-        return Promise.resolve({
-          content: [{ type: "text", text: lines.join("\n") }],
-        });
-      } catch (e) {
-        return Promise.resolve({
-          content: [{ type: "text", text: "list_recent_decisions failed: " + (e.message || String(e)) }],
-          isError: true,
-        });
-      }
+    {
+      name: "list_recent_decisions",
+      description: "List recent canonical user or assistant turns containing explicit decision language in the owned workspace.",
+      inputSchema: z ? {
+        projectSlug: field("string", "Optional project slug.", true),
+        since: field("string", "Optional earliest ISO date.", true),
+        until: field("string", "Optional latest ISO date.", true),
+        maxResults: field("number", "Maximum results, from 1 to 50.", true),
+      } : {},
+      handler: guarded(workspace, "listRecentDecisions", function (args) {
+        return { projectSlug: args.projectSlug, since: args.since, until: args.until, limit: args.maxResults };
+      }),
     },
-  });
-
-  return tools;
-}
-
-function parseTime(input) {
-  if (input == null || input === "") return null;
-  if (typeof input === "number") return input;
-  var s = String(input).trim();
-  if (/^\d{10,}$/.test(s)) return parseInt(s, 10); // unix ms
-  var d = new Date(s);
-  var n = d.getTime();
-  return isNaN(n) ? null : n;
-}
-
-function matchesDecisionPattern(text) {
-  for (var i = 0; i < DECISION_PATTERNS.length; i++) {
-    if (DECISION_PATTERNS[i].test(text)) return true;
-  }
-  return false;
+  ];
 }
 
 module.exports = { getToolDefs: getToolDefs };

package/lib/daemon.js

@@ -814,7 +814,7 @@ var relay = createServer({
     var want = !!value;
     config.matesEnabled = want;
     saveConfig(config);
-    console.log("[daemon] Mates UI:", want ? "on" : "off", "(web)");
+    console.log("[daemon] Project Mate DMs:", want ? "shown" : "hidden", "(web)");
     return { ok: true, matesEnabled: want };
   },
   onGetToolPalettes: function () {