@intangle/mcp-server 2.6.17 → 2.6.19

package/dist/tool-definitions.js

@@ -159,11 +159,20 @@ const BASE_TOOLS = [
     {
         name: "get_items",
         title: "Get Items",
-        description: "Read complete Items by exact IDs or browse below one Space/Item using authoritative parent_id hierarchy. Every Item is a Room; Spaces remain typed scopes. Legacy IDs are accepted with alias provenance preserved. Use include=comments for canonical Item-owned comments and body revision. Use include=assignees for typed User/Agent principals.",
+        description: "For whole-Space organisation, use mode=structure. It returns complete authorised structural aggregates plus compact paged Item details; aggregates cover the full scope. Omit ids and depth, and omit under to inspect the whole authorised Space. Use coverage.snapshot, a structural SHA-256 checksum over authoritative inventory, to compare pages; it does not make page hydration transactional. Read complete Items by exact IDs or browse below one Space/Item using authoritative parent_id hierarchy. Every Item is a Room; Spaces remain typed scopes. Legacy IDs are accepted with alias provenance preserved. Use include=comments for canonical Item-owned comments and body revision. Use include=assignees for typed User/Agent principals.",
         inputSchema: {
             type: "object",
             additionalProperties: false,
             properties: {
+                mode: {
+                    type: "string",
+                    enum: [
+                        "items",
+                        "structure"
+                    ],
+                    default: "items",
+                    description: "items (default) returns bounded Item reads. structure returns complete authorised structural aggregates plus compact paged Item details; omit ids and depth. Omit under to inspect the whole authorised Space."
+                },
                 space_id: {
                     type: "string",
                     description: "REQUIRED: Exact Space containing the Items."
@@ -188,17 +197,20 @@ const BASE_TOOLS = [
                 depth: {
                     type: "integer",
                     minimum: 0,
-                    maximum: 20
+                    maximum: 20,
+                    description: "Maximum hierarchy depth. Defaults to 0 for current Space roots and 1 for explicit selectors. Omit in structure mode, which inspects all depths."
                 },
                 limit: {
                     type: "integer",
                     minimum: 1,
-                    maximum: 200
+                    maximum: 200,
+                    default: 50,
+                    description: "Maximum Items in this page."
                 },
                 offset: {
                     type: "integer",
                     minimum: 0,
-                    maximum: 5000
+                    description: "Items to skip in stable breadth-first order. items mode supports up to 5000; structure has no offset cap."
                 },
                 include: {
                     type: "array",
@@ -216,7 +228,8 @@ const BASE_TOOLS = [
                             "metadata",
                             "all"
                         ]
-                    }
+                    },
+                    description: "Optional payload fields for the returned page. structure defaults to []; items defaults to content, attributes, assignee, artifact, and metadata. Explicit include hydrates only selected page details, never aggregate content coverage."
                 }
             },
             required: [
@@ -539,9 +552,6 @@ const BASE_TOOLS = [
                                                 type: "string",
                                                 description: "Direct-parent alias for source_parent_id. The current Space ID selects Space-root Items."
                                             },
-                                            ungrouped: {
-                                                type: "boolean"
-                                            },
                                             type: {
                                                 type: [
                                                     "string",
@@ -814,7 +824,7 @@ const BASE_TOOLS = [
     {
         name: "message",
         title: "Message Assistant",
-        description: "Primary way to use Intangle for memory, communicating and collaborating with Tan agent in a shared thread. Send a request and either wait for one assistant turn to complete or submit asynchronously for later polling. Intangle derives the durable participant identity from the authenticated runner rather than caller-supplied fields. Conversations are backed by `summary_*` IDs; reuse the returned `conversation_id` and reuse the returned `session_id` so callers can continue the same thread reliably across turns. For shared coordination channels, pass a stable `channel_id`; channel and project/group coordinates scope context, while the stable idempotency key anchors retries to one durable turn and the returned conversation_id remains the durable thread anchor.",
+        description: "Primary way to use Intangle for memory, communicating and collaborating with Tan agent in a shared thread. Send a request and either wait for one assistant turn to complete or submit asynchronously for later polling. Intangle derives the durable participant identity from the authenticated runner rather than caller-supplied fields. Conversations are backed by `summary_*` IDs; reuse the returned `conversation_id` and reuse the returned `session_id` so callers can continue the same thread reliably across turns. For shared Item coordination, pass the stable Item Room identity as `channel_id` using `item|<item_id>`; this Item room/channel coordinate is preferred. `project_id`, `group_id`, and legacy `project|...` or `group|...` channel values remain accepted only as compatibility coordinates for older stored calls and integrations. The stable idempotency key anchors retries to one durable turn, and the returned `conversation_id` remains the durable thread anchor.",
         inputSchema: {
             type: "object",
             properties: {
@@ -844,15 +854,15 @@ const BASE_TOOLS = [
                 },
                 project_id: {
                     type: "string",
-                    description: "Optional project scope for the assistant turn."
+                    description: "Optional legacy Project compatibility coordinate for older stored calls. Prefer channel_id with the target Item Room identity."
                 },
                 group_id: {
                     type: "string",
-                    description: "Optional group scope for the assistant turn. Use this with channel_id for group-scoped coordination."
+                    description: "Optional legacy Group compatibility coordinate for older stored calls. Prefer channel_id with the target Item Room identity."
                 },
                 channel_id: {
                     type: "string",
-                    description: "Optional route/channel scope for the assistant turn. Defaults to root when omitted. Examples: root, group|legal, project|work/launch."
+                    description: "Optional Item room/channel coordinate for the assistant turn. Prefer `item|<item_id>` for a nested Item Room; defaults to `root` for Space-level context. Legacy `project|...` and `group|...` values remain accepted for compatibility."
                 },
                 organization_id: {
                     type: "string",
@@ -868,7 +878,7 @@ const BASE_TOOLS = [
                 },
                 client_turn_id: {
                     type: "string",
-                    description: "Optional caller correlation value. Phoenix derives the durable turn identity from idempotency_key and scopes it by the verified user, graph, space, channel, project/group, and stable retry key."
+                    description: "Optional caller correlation value. Phoenix derives the durable turn identity from idempotency_key and scopes it by the verified user, graph, Space, preferred Item room/channel, any legacy Project/Group compatibility coordinates, and the stable retry key."
                 },
                 idempotency_key: {
                     type: "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intangle/mcp-server",
-  "version": "2.6.17",
+  "version": "2.6.19",
   "description": "Model Context Protocol server for Intangle - AI context that persists across conversations",
   "main": "dist/index.js",
   "type": "module",
@@ -55,5 +55,5 @@
     "tsx": "^4.0.0",
     "typescript": "^5.0.0"
   },
-  "intangleSourceHash": "d1f5d50cf190e68920b3717fe3450192a3832435172f87b5fb2200ea1086ff9a"
+  "intangleSourceHash": "125c1c3327e41998085eb9151a0bfe2a66e8b80d27c78d6849e8348b0ee4c22e"
 }