@intangle/mcp-server 2.5.6 → 2.6.1

package/dist/index.js

@@ -272,9 +272,44 @@ try {
         const { id, ids } = args;
         return makeApiCall("fetch", { id, ids });
     }
+    async function handleFetchConversationMessages(args) {
+        const { space_id, conversation_id } = args;
+        if (!space_id || !conversation_id) {
+            throw new Error("space_id and conversation_id are required");
+        }
+        return makeApiCall("conversation-messages", args);
+    }
+    async function handleSubscribeConversation(args) {
+        const { space_id, conversation_id } = args;
+        if (!space_id || !conversation_id) {
+            throw new Error("space_id and conversation_id are required");
+        }
+        return makeApiCall("conversation-subscribe", args);
+    }
+    async function handleConversationInbox(args) {
+        const { space_id } = args;
+        if (!space_id) {
+            throw new Error("space_id is required");
+        }
+        return makeApiCall("conversation-inbox", args);
+    }
+    async function handleMarkConversationRead(args) {
+        const { space_id, conversation_id } = args;
+        if (!space_id || !conversation_id) {
+            throw new Error("space_id and conversation_id are required");
+        }
+        return makeApiCall("conversation-read", args);
+    }
     async function handleViewSpaces() {
         return makeApiCall("list-spaces", {});
     }
+    async function handleViewGroups(args) {
+        const { space_id } = args;
+        if (!space_id) {
+            throw new Error("space_id is required. Use view_spaces to see available options.");
+        }
+        return makeApiCall("view-groups", { space_id });
+    }
     async function handleViewProjects(args) {
         const { space_id } = args;
         if (!space_id) {
@@ -287,11 +322,64 @@ try {
         if (!project_id && !slug) {
             throw new Error("Either project_id or slug (with space_id) is required. Use view_projects to get valid IDs.");
         }
-        if (slug && !space_id) {
-            throw new Error("space_id is required when using slug. Use view_spaces to see available options.");
+        if (!space_id) {
+            throw new Error("space_id is required. Use view_spaces to see available options.");
         }
         return makeApiCall("view-project", { project_id, space_id, slug });
     }
+    async function handleCreateGroup(args) {
+        const { space_id, name } = args;
+        if (!space_id || !name) {
+            throw new Error("space_id and name are required");
+        }
+        return makeApiCall("create-group", { space_id, name });
+    }
+    async function handleRenameGroup(args) {
+        const { space_id, group_id, name } = args;
+        if (!space_id || !group_id || !name) {
+            throw new Error("space_id, group_id, and name are required");
+        }
+        return makeApiCall("rename-group", { space_id, group_id, name });
+    }
+    async function handleDeleteGroup(args) {
+        const { space_id, group_id } = args;
+        if (!space_id || !group_id) {
+            throw new Error("space_id and group_id are required");
+        }
+        return makeApiCall("delete-group", { space_id, group_id });
+    }
+    async function handleCreateProject(args) {
+        const { space_id, name, group_id } = args;
+        if (!space_id || !name) {
+            throw new Error("space_id and name are required");
+        }
+        return makeApiCall("create-project", { space_id, name, group_id });
+    }
+    async function handleRenameProject(args) {
+        const { space_id, project_id, name } = args;
+        if (!space_id || !project_id || !name) {
+            throw new Error("space_id, project_id, and name are required");
+        }
+        return makeApiCall("rename-project", { space_id, project_id, name });
+    }
+    async function handleDeleteProject(args) {
+        const { space_id, project_id } = args;
+        if (!space_id || !project_id) {
+            throw new Error("space_id and project_id are required");
+        }
+        return makeApiCall("delete-project", { space_id, project_id });
+    }
+    async function handleAssignProjectToGroup(args) {
+        const { space_id, project_id, group_id } = args;
+        if (!space_id || !project_id) {
+            throw new Error("space_id and project_id are required");
+        }
+        return makeApiCall("assign-project-to-group", {
+            space_id,
+            project_id,
+            group_id,
+        });
+    }
     async function handleCreateSpace(args) {
         return makeApiCall("create-space", args);
     }
@@ -374,16 +462,51 @@ try {
                 case "fetch_items":
                     result = await handleFetch(args);
                     break;
+                case "fetch_conversation_messages":
+                    result = await handleFetchConversationMessages(args);
+                    break;
+                case "subscribe_conversation":
+                    result = await handleSubscribeConversation(args);
+                    break;
+                case "list_conversation_inbox":
+                    result = await handleConversationInbox(args);
+                    break;
+                case "mark_conversation_read":
+                    result = await handleMarkConversationRead(args);
+                    break;
                 case "view_spaces":
                     result = await handleViewSpaces();
                     break;
-                // PROJECTS DISABLED - Projects have been disabled. May be re-enabled later.
-                // case "view_projects":
-                //   result = await handleViewProjects(args)
-                //   break
-                // case "view_project":
-                //   result = await handleViewProject(args)
-                //   break
+                case "view_groups":
+                    result = await handleViewGroups(args);
+                    break;
+                case "create_group":
+                    result = await handleCreateGroup(args);
+                    break;
+                case "rename_group":
+                    result = await handleRenameGroup(args);
+                    break;
+                case "delete_group":
+                    result = await handleDeleteGroup(args);
+                    break;
+                case "view_projects":
+                    result = await handleViewProjects(args);
+                    break;
+                case "view_project":
+                    result = await handleViewProject(args);
+                    break;
+                case "create_project":
+                    result = await handleCreateProject(args);
+                    break;
+                case "rename_project":
+                    result = await handleRenameProject(args);
+                    break;
+                case "delete_project":
+                    result = await handleDeleteProject(args);
+                    break;
+                case "assign_project_to_group":
+                    result = await handleAssignProjectToGroup(args);
+                    break;
                 case "create_space":
                     result = await handleCreateSpace(args);
                     break;

package/dist/tool-definitions.js

@@ -43,50 +43,360 @@ const TOOL_DEFINITIONS = [
             }
         }
     },
-    // PROJECTS DISABLED - Projects have been disabled. May be re-enabled later.
-    // {
-    //   name: "view_projects",
-    //   title: "View Projects",
-    //   description:
-    //     "List all projects in a space. Projects are user-created canvases that organize context, tasks, documents, and skills. Use this to discover available projects before viewing their contents.",
-    //   inputSchema: {
-    //     type: "object",
-    //     properties: {
-    //       space_id: {
-    //         type: "string",
-    //         description:
-    //           "REQUIRED: Space to list projects from (use view_spaces to see available options)"
-    //       }
-    //     },
-    //     required: ["space_id"]
-    //   }
-    // },
-    // {
-    //   name: "view_project",
-    //   title: "View Project",
-    //   description:
-    //     "View a specific project with all its items (context, tasks, documents, skills). Returns item metadata (IDs, titles, types, status) for each item in the project. Use fetch_items to get full content of specific items.",
-    //   inputSchema: {
-    //     type: "object",
-    //     properties: {
-    //       project_id: {
-    //         type: "string",
-    //         description:
-    //           "Project ID to view (e.g., 'proj_123...'). Get project IDs from view_projects."
-    //       },
-    //       space_id: {
-    //         type: "string",
-    //         description:
-    //           "Optional: Space ID (required if using slug instead of project_id)"
-    //       },
-    //       slug: {
-    //         type: "string",
-    //         description:
-    //           "Optional: Project slug (URL-friendly name). Requires space_id if used."
-    //       }
-    //     }
-    //   }
-    // },
+    {
+        name: "fetch_conversation_messages",
+        title: "Fetch Conversation Messages",
+        description: "Read persisted messages from a conversation/chat summary. Useful for polling shared threads after async `message` calls or when multiple participants are collaborating in the same conversation. Returns stable message IDs and timestamps so callers can dedupe and continue from `next_cursor`.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "REQUIRED: Space containing the conversation (use view_spaces first)."
+                },
+                conversation_id: {
+                    type: "string",
+                    description: "REQUIRED: Chat summary / conversation ID to read (e.g. 'summary_123...')."
+                },
+                organization_id: {
+                    type: "string",
+                    description: "Optional Clerk org ID when the space belongs to an organization graph."
+                },
+                since_timestamp: {
+                    type: "integer",
+                    description: "Optional millisecond cursor. Only messages newer than this timestamp are returned."
+                },
+                limit: {
+                    type: "integer",
+                    description: "Optional page size from 1 to 200 (default 50)."
+                }
+            },
+            required: ["space_id", "conversation_id"]
+        }
+    },
+    {
+        name: "subscribe_conversation",
+        title: "Subscribe Conversation",
+        description: "Register a participant in a shared conversation so it can use inbox and read-cursor tools without first sending a message. By default the subscription starts caught up at the latest message.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "REQUIRED: Space containing the conversation (use view_spaces first)."
+                },
+                conversation_id: {
+                    type: "string",
+                    description: "REQUIRED: Chat summary / conversation ID to subscribe to."
+                },
+                organization_id: {
+                    type: "string",
+                    description: "Optional Clerk org ID when the space belongs to an organization graph."
+                },
+                participant_id: {
+                    type: "string",
+                    description: "Optional stable participant ID. Use an explicit `user_*` or `agent_*` style ID when you want the same participant identity reused across calls."
+                },
+                participant_type: {
+                    type: "string",
+                    description: "Optional participant type. Defaults to `user`. Supported values: `user`, `agent`, `assistant`, `connector`."
+                },
+                participant_label: {
+                    type: "string",
+                    description: "Optional display label for the participant in collaborative chat UIs."
+                },
+                mark_read: {
+                    type: "boolean",
+                    description: "Optional. Defaults to true. When true, the subscription starts caught up at the current latest message."
+                }
+            },
+            required: ["space_id", "conversation_id"]
+        }
+    },
+    {
+        name: "list_conversation_inbox",
+        title: "List Conversation Inbox",
+        description: "List the conversations a participant is subscribed to in one space, with unread counts and read cursors. Use this to poll multiple shared threads efficiently.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "REQUIRED: Space to list inbox conversations from (use view_spaces first)."
+                },
+                organization_id: {
+                    type: "string",
+                    description: "Optional Clerk org ID when the space belongs to an organization graph."
+                },
+                participant_id: {
+                    type: "string",
+                    description: "Optional stable participant ID. Use the same value you used for message/subscribe calls to read the same inbox."
+                },
+                participant_type: {
+                    type: "string",
+                    description: "Optional participant type. Defaults to `user`. Supported values: `user`, `agent`, `assistant`, `connector`."
+                },
+                participant_label: {
+                    type: "string",
+                    description: "Optional display label used when the participant identity is being created for the first time."
+                },
+                unread_only: {
+                    type: "boolean",
+                    description: "Optional. When true, only return conversations that currently have unread messages."
+                },
+                since_timestamp: {
+                    type: "integer",
+                    description: "Optional millisecond cursor. Only conversations updated after this timestamp are returned."
+                },
+                limit: {
+                    type: "integer",
+                    description: "Optional page size from 1 to 200 (default 50)."
+                }
+            },
+            required: ["space_id"]
+        }
+    },
+    {
+        name: "mark_conversation_read",
+        title: "Mark Conversation Read",
+        description: "Advance a participant's read cursor for a shared conversation. Use this after processing messages returned from fetch_conversation_messages.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "REQUIRED: Space containing the conversation (use view_spaces first)."
+                },
+                conversation_id: {
+                    type: "string",
+                    description: "REQUIRED: Chat summary / conversation ID to mark as read."
+                },
+                organization_id: {
+                    type: "string",
+                    description: "Optional Clerk org ID when the space belongs to an organization graph."
+                },
+                participant_id: {
+                    type: "string",
+                    description: "Optional stable participant ID. Use the same value you used for message/subscribe calls."
+                },
+                participant_type: {
+                    type: "string",
+                    description: "Optional participant type. Defaults to `user`. Supported values: `user`, `agent`, `assistant`, `connector`."
+                },
+                participant_label: {
+                    type: "string",
+                    description: "Optional display label used when the participant identity is being created for the first time."
+                },
+                read_at: {
+                    type: "integer",
+                    description: "Optional millisecond cursor to advance to. If omitted, the conversation is marked read through its latest message."
+                }
+            },
+            required: ["space_id", "conversation_id"]
+        }
+    },
+    {
+        name: "view_groups",
+        title: "View Groups",
+        description: "List all groups in a space, including the projects currently inside each group plus any ungrouped projects.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "REQUIRED: Space to list groups from (use view_spaces to see available options)"
+                }
+            },
+            required: ["space_id"]
+        }
+    },
+    {
+        name: "create_group",
+        title: "Create Group",
+        description: "Create a new group inside a space.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "REQUIRED: Space to create the group in."
+                },
+                name: {
+                    type: "string",
+                    description: "Name for the new group."
+                }
+            },
+            required: ["space_id", "name"]
+        }
+    },
+    {
+        name: "rename_group",
+        title: "Rename Group",
+        description: "Rename an existing group.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "REQUIRED: Space containing the group."
+                },
+                group_id: {
+                    type: "string",
+                    description: "REQUIRED: Group ID to rename."
+                },
+                name: {
+                    type: "string",
+                    description: "REQUIRED: New group name."
+                }
+            },
+            required: ["space_id", "group_id", "name"]
+        }
+    },
+    {
+        name: "delete_group",
+        title: "Delete Group",
+        description: "Delete a group. Projects inside it are preserved and become ungrouped.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "REQUIRED: Space containing the group."
+                },
+                group_id: {
+                    type: "string",
+                    description: "REQUIRED: Group ID to delete."
+                }
+            },
+            required: ["space_id", "group_id"]
+        }
+    },
+    {
+        name: "view_projects",
+        title: "View Projects",
+        description: "List all projects in a space, including which group each project belongs to.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "REQUIRED: Space to list projects from (use view_spaces to see available options)"
+                }
+            },
+            required: ["space_id"]
+        }
+    },
+    {
+        name: "view_project",
+        title: "View Project",
+        description: "View a specific project with all its items. Use fetch_items to retrieve full content for specific item IDs.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "string",
+                    description: "Project ID to view (e.g., 'proj_123...'). Get project IDs from view_projects."
+                },
+                space_id: {
+                    type: "string",
+                    description: "REQUIRED: Space containing the project."
+                },
+                slug: {
+                    type: "string",
+                    description: "Optional: Project slug (URL-friendly name)."
+                }
+            },
+            required: ["space_id"]
+        }
+    },
+    {
+        name: "create_project",
+        title: "Create Project",
+        description: "Create a new project in a space. Optionally place it inside a group immediately.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "REQUIRED: Space to create the project in."
+                },
+                name: {
+                    type: "string",
+                    description: "REQUIRED: Project name."
+                },
+                group_id: {
+                    type: "string",
+                    description: "Optional: Group ID to place the project inside."
+                }
+            },
+            required: ["space_id", "name"]
+        }
+    },
+    {
+        name: "rename_project",
+        title: "Rename Project",
+        description: "Rename an existing project.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "REQUIRED: Space containing the project."
+                },
+                project_id: {
+                    type: "string",
+                    description: "REQUIRED: Project ID to rename."
+                },
+                name: {
+                    type: "string",
+                    description: "REQUIRED: New project name."
+                }
+            },
+            required: ["space_id", "project_id", "name"]
+        }
+    },
+    {
+        name: "delete_project",
+        title: "Delete Project",
+        description: "Delete an existing project from a space.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "REQUIRED: Space containing the project."
+                },
+                project_id: {
+                    type: "string",
+                    description: "REQUIRED: Project ID to delete."
+                }
+            },
+            required: ["space_id", "project_id"]
+        }
+    },
+    {
+        name: "assign_project_to_group",
+        title: "Assign Project To Group",
+        description: "Move a project into a group. Omit group_id to make the project ungrouped.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "REQUIRED: Space containing the project."
+                },
+                project_id: {
+                    type: "string",
+                    description: "REQUIRED: Project ID to move."
+                },
+                group_id: {
+                    type: "string",
+                    description: "Optional: Target group ID. Omit this to ungroup the project."
+                }
+            },
+            required: ["space_id", "project_id"]
+        }
+    },
     {
         name: "start",
         title: "Start Space Session",
@@ -306,8 +616,7 @@ const TOOL_DEFINITIONS = [
                     }
                 }
             },
-            required: ["space_id"],
-            anyOf: [{ required: ["add"] }, { required: ["update"] }, { required: ["delete"] }]
+            required: ["space_id"]
         }
     },
     {
@@ -403,20 +712,13 @@ const TOOL_DEFINITIONS = [
                     items: { type: "string" }
                 }
             },
-            required: ["space_id"],
-            anyOf: [
-                { required: ["list"] },
-                { required: ["create"] },
-                { required: ["rename"] },
-                { required: ["move_items"] },
-                { required: ["delete"] }
-            ]
+            required: ["space_id"]
         }
     },
     {
         name: "message",
         title: "Message Assistant",
-        description: "Primary orchestration tool. Send a request to the Intangle assistant and wait for one assistant turn to complete. Returns assistant text plus continuity IDs (`session_id`, `conversation_id`) so callers can continue the same thread reliably across turns.",
+        description: "Primary orchestration tool. Send a request to the Intangle assistant and either wait for one assistant turn to complete or submit asynchronously for later polling. Returns assistant text plus continuity IDs (`session_id`, `conversation_id`) so callers can continue the same thread reliably across turns.",
         inputSchema: {
             type: "object",
             properties: {
@@ -436,6 +738,10 @@ const TOOL_DEFINITIONS = [
                     type: "string",
                     description: "Optional existing conversation/chat summary ID to resume a specific conversation. If omitted, Intangle uses/creates the active conversation for this space."
                 },
+                new_conversation: {
+                    type: "boolean",
+                    description: "Optional. When true, force a fresh conversation instead of reusing the current active thread."
+                },
                 session_id: {
                     type: "string",
                     description: "Optional runtime session ID to reuse across calls. Reuse the returned session_id for best continuity and lower warm-up overhead."
@@ -452,6 +758,22 @@ const TOOL_DEFINITIONS = [
                     type: "integer",
                     description: "Optional timeout in milliseconds (10,000 to 300,000; default 120,000)."
                 },
+                wait_for_response: {
+                    type: "boolean",
+                    description: "Optional. Defaults to true. Set false to submit the turn asynchronously and poll the conversation later with fetch_conversation_messages."
+                },
+                participant_id: {
+                    type: "string",
+                    description: "Optional stable participant ID for collaborative/shared chats. Use an explicit `user_*` or `agent_*` style ID when you want the same participant identity reused across calls."
+                },
+                participant_type: {
+                    type: "string",
+                    description: "Optional participant type. Defaults to `user`. Supported values: `user`, `agent`, `assistant`, `connector`."
+                },
+                participant_label: {
+                    type: "string",
+                    description: "Optional display label for the participant in collaborative chat UIs."
+                },
                 timezone: {
                     type: "string",
                     description: "Optional IANA timezone for assistant context."
@@ -487,6 +809,8 @@ const TOOL_DEFINITIONS = [
 const READ_ONLY_TOOLS = new Set([
     "search",
     "fetch_items",
+    "fetch_conversation_messages",
+    "list_conversation_inbox",
     "start",
     "view_spaces",
     "view_space"
@@ -499,6 +823,8 @@ const DESTRUCTIVE_TOOLS = new Set([
 const IDEMPOTENT_TOOLS = new Set([
     "search",
     "fetch_items",
+    "fetch_conversation_messages",
+    "list_conversation_inbox",
     "start",
     "view_spaces",
     "view_space"