clay-server 2.26.0-beta.9 → 2.26.0

package/lib/browser-mcp-server.js

@@ -111,7 +111,7 @@ function create(sendCommand, getTabList, contextOps) {
   // --- browser_screenshot ---
   tools.push(tool(
     "browser_screenshot",
-    "Capture a screenshot of a browser tab (full viewport or a specific element)",
+    "Capture a screenshot of a browser tab. Skip if the tab is already attached as a context source (data is auto-injected).",
     buildShape({
       tabId: { type: "number", description: "Tab ID" },
       selector: { type: "string", description: "CSS selector to capture a specific element (optional)" },
@@ -134,7 +134,7 @@ function create(sendCommand, getTabList, contextOps) {
   // --- browser_console ---
   tools.push(tool(
     "browser_console",
-    "Read captured console logs from a tab (log, warn, error, info)",
+    "Read captured console logs from a tab. Skip if the tab is already a context source (data is auto-injected).",
     buildShape({
       tabId: { type: "number", description: "Tab ID" },
     }, ["tabId"]),
@@ -157,7 +157,7 @@ function create(sendCommand, getTabList, contextOps) {
   // --- browser_network ---
   tools.push(tool(
     "browser_network",
-    "Read captured network requests (fetch/XHR) from a tab",
+    "Read captured network requests (fetch/XHR) from a tab. Skip if the tab is already a context source.",
     buildShape({
       tabId: { type: "number", description: "Tab ID" },
     }, ["tabId"]),
@@ -181,7 +181,7 @@ function create(sendCommand, getTabList, contextOps) {
   // --- browser_read_page ---
   tools.push(tool(
     "browser_read_page",
-    "Read page text content (innerText). Optionally read only a specific element.",
+    "Read page text content (innerText). Skip if the tab is already a context source (text is auto-injected). Use for tabs NOT in context sources, or to read a specific element via selector.",
     buildShape({
       tabId: { type: "number", description: "Tab ID" },
       selector: { type: "string", description: "CSS selector to read specific element (optional)" },

package/lib/debate-mcp-server.js

@@ -0,0 +1,94 @@
+// Debate MCP Server for Clay (in-process SDK version)
+// Provides the propose_debate tool so mates can propose debates
+// via the SDK tool system instead of writing files to disk.
+//
+// Usage:
+//   var debateMcp = require("./debate-mcp-server");
+//   var mcpConfig = debateMcp.create(onPropose);
+//   // Pass mcpConfig to sdk-bridge opts.mcpServers
+
+var z;
+try { z = require("zod"); } catch (e) { z = null; }
+
+function buildShape(props, required) {
+  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;
+}
+
+// onPropose(briefData) -> Promise<{action: "start"|"cancel"}>
+// The returned Promise blocks the tool until the user approves or cancels.
+function create(onPropose) {
+  var sdk;
+  try { sdk = require("@anthropic-ai/claude-agent-sdk"); } catch (e) {
+    console.error("[debate-mcp] Failed to load SDK:", e.message);
+    return null;
+  }
+
+  var createSdkMcpServer = sdk.createSdkMcpServer;
+  var tool = sdk.tool;
+  if (!createSdkMcpServer || !tool) {
+    console.error("[debate-mcp] SDK missing createSdkMcpServer or tool helper");
+    return null;
+  }
+
+  var tools = [];
+
+  tools.push(tool(
+    "propose_debate",
+    "Propose a structured debate among Clay Mates. The user will see an inline approval card. The tool blocks until the user approves or cancels.",
+    buildShape({
+      topic: { type: "string", description: "The debate topic" },
+      format: { type: "string", description: "Debate format, e.g. free_discussion (default)" },
+      context: { type: "string", description: "Key context from the conversation that panelists should know" },
+      specialRequests: { type: "string", description: "Special instructions for the debate, or empty" },
+      panelists: { type: "string", description: "JSON array of panelist objects: [{\"mateId\": \"<UUID>\", \"role\": \"perspective\", \"brief\": \"guidance\"}]" },
+    }, ["topic", "panelists"]),
+    function (args) {
+      var panelists;
+      try {
+        panelists = JSON.parse(args.panelists);
+      } catch (e) {
+        return Promise.resolve({
+          content: [{ type: "text", text: "Error: panelists must be a valid JSON array. Got: " + (args.panelists || "").substring(0, 100) }],
+        });
+      }
+
+      var briefData = {
+        topic: args.topic || "Untitled debate",
+        format: args.format || "free_discussion",
+        context: args.context || "",
+        specialRequests: args.specialRequests || null,
+        panelists: panelists,
+      };
+
+      return onPropose(briefData).then(function (result) {
+        if (result && result.action === "start") {
+          return { content: [{ type: "text", text: "Debate approved and started. Topic: " + briefData.topic }] };
+        }
+        return { content: [{ type: "text", text: "Debate proposal was cancelled by the user." }] };
+      });
+    }
+  ));
+
+  return createSdkMcpServer({
+    name: "clay-debate",
+    version: "1.0.0",
+    tools: tools,
+  });
+}
+
+module.exports = { create: create };

package/lib/mates.js

@@ -633,35 +633,23 @@ var DEBATE_AWARENESS_SECTION =
   "\n\n" + DEBATE_AWARENESS_MARKER + "\n" +
   "## Proposing Debates\n\n" +
   "**This section is managed by the system and cannot be removed.**\n\n" +
-  "When the user suggests that a topic would benefit from a multi-perspective debate " +
-  "(e.g., \"let's debate this\", \"I want to hear different viewpoints\"), you can propose " +
-  "a structured debate by writing a brief file.\n\n" +
+  "When the user suggests a debate, you MUST use the `propose_debate` tool. " +
+  "NEVER write debate files to disk. NEVER mkdir for debates. NEVER use Write/Bash for debate setup. " +
+  "The ONLY way to propose a debate is the `propose_debate` tool.\n\n" +
   "**How to propose a debate:**\n" +
-  "1. Generate a unique ID: `debate_` followed by the current timestamp in milliseconds\n" +
-  "2. Write the brief as JSON to: `.clay/debates/<debate_id>/brief.json` (relative to the project root)\n" +
-  "3. The system will detect the file and show the user an inline card with your proposal\n" +
-  "4. The user can then approve or cancel the debate\n\n" +
-  "**Brief JSON schema:**\n" +
-  "```json\n" +
-  "{\n" +
-  "  \"topic\": \"The refined debate topic\",\n" +
-  "  \"format\": \"free_discussion\",\n" +
-  "  \"context\": \"Key context from the conversation that panelists should know\",\n" +
-  "  \"specialRequests\": \"Any special instructions, or null\",\n" +
-  "  \"panelists\": [\n" +
-  "    {\n" +
-  "      \"mateId\": \"<mate UUID from the team roster above>\",\n" +
-  "      \"role\": \"The perspective or stance this panelist should take\",\n" +
-  "      \"brief\": \"Specific guidance for this panelist\"\n" +
-  "    }\n" +
-  "  ]\n" +
-  "}\n" +
-  "```\n\n" +
+  "Call the `propose_debate` tool with these parameters:\n" +
+  "- `topic` (required): The refined debate topic\n" +
+  "- `format`: Debate format, default \"free_discussion\"\n" +
+  "- `context`: Key context from the conversation that panelists should know\n" +
+  "- `specialRequests`: Any special instructions\n" +
+  "- `panelists` (required): A JSON string array of panelist objects:\n" +
+  "  `[{\"mateId\": \"<mate UUID from team roster>\", \"role\": \"perspective\", \"brief\": \"guidance\"}]`\n\n" +
+  "The user will see an inline approval card. The tool blocks until they approve or cancel.\n\n" +
   "**Rules:**\n" +
   "- Choose 2-4 panelists from the team roster. Pick mates whose expertise fits the topic.\n" +
   "- Do NOT include yourself as a panelist. You will moderate the debate.\n" +
   "- Only propose a debate when the user explicitly asks for one.\n" +
-  "- Make sure the directory exists before writing (use mkdir -p or equivalent).\n";
+  "- Do NOT write files to disk for debate proposals. Always use the propose_debate tool.\n";
 
 function enforceDebateAwareness(filePath) {
   if (!fs.existsSync(filePath)) return false;