@aithr-ai/mcp-server 1.0.0 → 1.0.1

package/index.js

@@ -91,7 +91,7 @@ class MCPServer {
     return [
       {
         name: 'aether_canvas_state',
-        description: 'Get the current state of the Aether canvas including all nodes and connections',
+        description: 'Get the current state of the Aether canvas including all nodes and connections. Use summary=true for lightweight response with just node IDs and types.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -99,7 +99,29 @@ class MCPServer {
               type: 'string',
               description: 'Project ID (optional, uses default if not provided)',
             },
+            summary: {
+              type: 'boolean',
+              description: 'If true, returns only node IDs, types, and status (much smaller response). Default: false',
+            },
+          },
+        },
+      },
+      {
+        name: 'aether_clear_canvas',
+        description: 'Remove ALL nodes from the canvas. Use with caution - this deletes all agents and their artifacts from the project canvas.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            projectId: {
+              type: 'string',
+              description: 'Project ID (optional, uses default if not provided)',
+            },
+            confirm: {
+              type: 'boolean',
+              description: 'Must be true to confirm deletion',
+            },
           },
+          required: ['confirm'],
         },
       },
       {
@@ -830,6 +852,9 @@ class MCPServer {
         case 'aether_canvas_state':
           result = await this.getCanvasState(args);
           break;
+        case 'aether_clear_canvas':
+          result = await this.clearCanvas(args);
+          break;
         case 'aether_add_agent':
           result = await this.addAgent(args);
           break;
@@ -992,12 +1017,41 @@ class MCPServer {
 
   async getCanvasState(args) {
     const projectId = args.projectId || config.projectId;
+    const summary = args.summary || false;
+
     if (!projectId) {
       return { error: 'No project ID configured. Set AETHER_PROJECT_ID environment variable.' };
     }
 
     try {
       const data = await this.apiCall(`/workspaces/${config.workspaceSlug}/projects/${projectId}/canvas`);
+
+      // If summary mode, return only essential info (much smaller response)
+      if (summary) {
+        const nodeSummary = (data.nodes || []).map(node => ({
+          id: node.id,
+          agentId: node.agentId,
+          agentType: node.agentType,
+          status: node.status,
+          label: node.data?.label || node.agentId,
+        }));
+
+        const edgeSummary = (data.edges || []).map(edge => ({
+          id: edge.id,
+          source: edge.source,
+          target: edge.target,
+          type: edge.data?.connectionType,
+        }));
+
+        return {
+          nodeCount: nodeSummary.length,
+          edgeCount: edgeSummary.length,
+          nodes: nodeSummary,
+          edges: edgeSummary,
+        };
+      }
+
+      // Full response (can be very large)
       return {
         nodes: data.nodes?.length || 0,
         edges: data.edges?.length || 0,
@@ -1011,6 +1065,57 @@ class MCPServer {
     }
   }
 
+  async clearCanvas(args) {
+    const projectId = args.projectId || config.projectId;
+    const confirm = args.confirm;
+
+    if (!confirm) {
+      return { error: 'Must set confirm: true to clear the canvas' };
+    }
+
+    if (!projectId) {
+      return { error: 'No project ID configured. Set AETHER_PROJECT_ID environment variable.' };
+    }
+
+    try {
+      // First get all nodes
+      const data = await this.apiCall(`/workspaces/${config.workspaceSlug}/projects/${projectId}/canvas`);
+      const nodes = data.nodes || [];
+
+      if (nodes.length === 0) {
+        return { message: 'Canvas is already empty', deletedCount: 0 };
+      }
+
+      // Delete each node
+      const deleted = [];
+      const failed = [];
+
+      for (const node of nodes) {
+        try {
+          await this.apiCall(
+            `/workspaces/${config.workspaceSlug}/projects/${projectId}/canvas/nodes/${node.id}`,
+            'DELETE'
+          );
+          deleted.push(node.id);
+        } catch (e) {
+          failed.push({ id: node.id, error: e.message });
+        }
+      }
+
+      return {
+        message: `Cleared ${deleted.length} nodes from canvas`,
+        deletedCount: deleted.length,
+        failedCount: failed.length,
+        failed: failed.length > 0 ? failed : undefined,
+      };
+    } catch (e) {
+      return {
+        error: 'Could not clear canvas',
+        details: e.message,
+      };
+    }
+  }
+
   async addAgent(args) {
     const { agentType, task, position, parentNodeId, nodeType, outputArtifactType, systemPrompt } = args;
     const projectId = config.projectId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aithr-ai/mcp-server",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "MCP server to connect Claude Code to Aether canvas - AI-powered team workspace for software development",
   "main": "index.js",
   "type": "module",