@intangle/mcp-server 2.3.9 → 2.4.0

package/dist/index.js

@@ -196,6 +196,20 @@ try {
             unlink: args.unlink,
         });
     }
+    async function handleMessage(args) {
+        if (!args.type || !args.content) {
+            throw new Error("type and content are required");
+        }
+        // Inject session_id from environment variable
+        const sessionId = process.env.INTANGLE_SESSION_ID;
+        if (!sessionId) {
+            throw new Error("INTANGLE_SESSION_ID environment variable is required for the message tool");
+        }
+        return makeApiCall("message", {
+            ...args,
+            session_id: sessionId,
+        });
+    }
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
         try {
@@ -228,6 +242,9 @@ try {
                 case "update_space":
                     result = await handleUpdateSpace(args);
                     break;
+                case "message":
+                    result = await handleMessage(args);
+                    break;
                 default:
                     throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
             }

package/dist/tool-definitions.js

@@ -302,6 +302,44 @@ export const TOOLS = [
             required: ["space_id"]
         }
     },
+    {
+        name: "message",
+        title: "Send Message",
+        description: "Send a message to the Intangle assistant for user interaction. Use type 'approval' to request approval (blocks until user responds), 'question' to ask the user a question (blocks until answered), 'notification' for informational updates (returns immediately), 'completion' to signal task completion (returns immediately), or 'error' to report errors (returns immediately).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                type: {
+                    type: "string",
+                    enum: ["approval", "question", "notification", "completion", "error"],
+                    description: "Message type. 'approval' and 'question' block until the user responds. 'notification', 'completion', and 'error' return immediately."
+                },
+                content: {
+                    type: "string",
+                    description: "The message content to display to the user"
+                },
+                metadata: {
+                    type: "object",
+                    description: "Optional context about the message",
+                    properties: {
+                        file: {
+                            type: "string",
+                            description: "Related file path"
+                        },
+                        action: {
+                            type: "string",
+                            description: "Action being performed"
+                        },
+                        details: {
+                            type: "string",
+                            description: "Additional details"
+                        }
+                    }
+                }
+            },
+            required: ["type", "content"]
+        }
+    },
     // DISABLED: memory_action tool is broken and causing errors.
     // Pending OHM protocol fix. Use update_space, search, or fetch_items instead.
     // {

package/index.ts

@@ -270,6 +270,25 @@ try {
     })
   }
 
+  async function handleMessage(args: any) {
+    if (!args.type || !args.content) {
+      throw new Error("type and content are required")
+    }
+
+    // Inject session_id from environment variable
+    const sessionId = process.env.INTANGLE_SESSION_ID
+    if (!sessionId) {
+      throw new Error(
+        "INTANGLE_SESSION_ID environment variable is required for the message tool"
+      )
+    }
+
+    return makeApiCall("message", {
+      ...args,
+      session_id: sessionId,
+    })
+  }
+
   server.setRequestHandler(CallToolRequestSchema, async (request: any) => {
     const { name, arguments: args } = request.params
 
@@ -304,6 +323,9 @@ try {
         case "update_space":
           result = await handleUpdateSpace(args)
           break
+        case "message":
+          result = await handleMessage(args)
+          break
         default:
           throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`)
       }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@intangle/mcp-server",
-	"version": "2.3.9",
+	"version": "2.4.0",
 	"description": "Model Context Protocol server for Intangle - AI context that persists across conversations",
 	"main": "dist/index.js",
 	"type": "module",

package/tool-definitions.ts

@@ -341,6 +341,46 @@ export const TOOLS = [
       required: ["space_id"]
     }
   },
+  {
+    name: "message",
+    title: "Send Message",
+    description:
+      "Send a message to the Intangle assistant for user interaction. Use type 'approval' to request approval (blocks until user responds), 'question' to ask the user a question (blocks until answered), 'notification' for informational updates (returns immediately), 'completion' to signal task completion (returns immediately), or 'error' to report errors (returns immediately).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        type: {
+          type: "string",
+          enum: ["approval", "question", "notification", "completion", "error"],
+          description:
+            "Message type. 'approval' and 'question' block until the user responds. 'notification', 'completion', and 'error' return immediately."
+        },
+        content: {
+          type: "string",
+          description: "The message content to display to the user"
+        },
+        metadata: {
+          type: "object",
+          description: "Optional context about the message",
+          properties: {
+            file: {
+              type: "string",
+              description: "Related file path"
+            },
+            action: {
+              type: "string",
+              description: "Action being performed"
+            },
+            details: {
+              type: "string",
+              description: "Additional details"
+            }
+          }
+        }
+      },
+      required: ["type", "content"]
+    }
+  },
   // DISABLED: memory_action tool is broken and causing errors.
   // Pending OHM protocol fix. Use update_space, search, or fetch_items instead.
   // {