@intangle/mcp-server 2.3.8 → 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

@@ -164,7 +164,7 @@ export const TOOLS = [
                 },
                 add: {
                     type: "object",
-                    description: "Add new items to context with automatic intelligent classification and topic suggestion",
+                    description: "Add new items. ALWAYS pass 'type' field on each item to skip expensive auto-classification.",
                     properties: {
                         items: {
                             type: "array",
@@ -174,7 +174,12 @@ export const TOOLS = [
                                     title: { type: "string", description: "Item title" },
                                     content: {
                                         type: "string",
-                                        description: "Item content - system automatically classifies as task (actionable), context (knowledge), or skill (workflow/procedure) and suggests relevant topics. VALUABLE CONTENT INCLUDES: decisions and their reasoning, user preferences observed, lessons learned, process descriptions, meeting outcomes, project context, expertise areas, working patterns, and anything that would help future sessions understand this user/space better."
+                                        description: "Item content. VALUABLE CONTENT INCLUDES: decisions and their reasoning, user preferences observed, lessons learned, process descriptions, meeting outcomes, project context, expertise areas, working patterns, and anything that would help future sessions understand this user/space better."
+                                    },
+                                    type: {
+                                        type: "string",
+                                        enum: ["task", "context", "skill", "document"],
+                                        description: "REQUIRED: Item type. 'task' for actionable items, 'context' for knowledge/facts, 'skill' for workflows, 'document' for long-form reference material. Omitting this triggers expensive auto-classification."
                                     },
                                     subtasks: {
                                         type: "array",
@@ -212,7 +217,7 @@ export const TOOLS = [
                                 },
                                 required: ["title", "content"]
                             },
-                            description: "Array of items to add. System intelligently: (1) classifies as task, context, or skill, (2) suggests 1-3 relevant topics based on content and existing topics. Examples: 'Need to fix auth bug' → task with topics like 'authentication', 'bug-fix'. 'Learned React batches updates' → context with topics like 'react', 'learning'. Tasks can include subtasks array for hierarchical task management."
+                            description: "Array of items to add. ALWAYS pass 'type' field to skip auto-classification. System suggests 1-3 relevant topics based on content. Tasks can include subtasks array for hierarchical task management."
                         }
                     }
                 },
@@ -297,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.8",
+	"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

@@ -187,7 +187,7 @@ export const TOOLS = [
         add: {
           type: "object",
           description:
-            "Add new items to context with automatic intelligent classification and topic suggestion",
+            "Add new items. ALWAYS pass 'type' field on each item to skip expensive auto-classification.",
           properties: {
             items: {
               type: "array",
@@ -198,7 +198,13 @@ export const TOOLS = [
                   content: {
                     type: "string",
                     description:
-                      "Item content - system automatically classifies as task (actionable), context (knowledge), or skill (workflow/procedure) and suggests relevant topics. VALUABLE CONTENT INCLUDES: decisions and their reasoning, user preferences observed, lessons learned, process descriptions, meeting outcomes, project context, expertise areas, working patterns, and anything that would help future sessions understand this user/space better."
+                      "Item content. VALUABLE CONTENT INCLUDES: decisions and their reasoning, user preferences observed, lessons learned, process descriptions, meeting outcomes, project context, expertise areas, working patterns, and anything that would help future sessions understand this user/space better."
+                  },
+                  type: {
+                    type: "string",
+                    enum: ["task", "context", "skill", "document"],
+                    description:
+                      "REQUIRED: Item type. 'task' for actionable items, 'context' for knowledge/facts, 'skill' for workflows, 'document' for long-form reference material. Omitting this triggers expensive auto-classification."
                   },
                   subtasks: {
                     type: "array",
@@ -242,7 +248,7 @@ export const TOOLS = [
                 required: ["title", "content"]
               },
               description:
-                "Array of items to add. System intelligently: (1) classifies as task, context, or skill, (2) suggests 1-3 relevant topics based on content and existing topics. Examples: 'Need to fix auth bug' → task with topics like 'authentication', 'bug-fix'. 'Learned React batches updates' → context with topics like 'react', 'learning'. Tasks can include subtasks array for hierarchical task management."
+                "Array of items to add. ALWAYS pass 'type' field to skip auto-classification. System suggests 1-3 relevant topics based on content. Tasks can include subtasks array for hierarchical task management."
             }
           }
         },
@@ -335,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.
   // {