@intangle/mcp-server 2.6.18 → 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: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intangle/mcp-server",
-  "version": "2.6.18",
+  "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": "b0f174c2303048a64be3fb5fcfa162856d98b5f34a05ddbcf7813263f6820fbe"
+  "intangleSourceHash": "125c1c3327e41998085eb9151a0bfe2a66e8b80d27c78d6849e8348b0ee4c22e"
 }