@intangle/mcp-server 2.6.9 → 2.6.10

package/dist/highq-tool-definitions.js

@@ -0,0 +1,211 @@
+const SPACE_SCOPE_PROPERTIES = {
+    space_id: {
+        type: "string",
+        description: "REQUIRED: Intangle Space whose authorized HighQ connection should be used."
+    },
+    organization_id: {
+        type: "string",
+        description: "Optional Clerk organization ID for an organization-owned Space. Include it when the same raw space_id could exist in more than one graph."
+    }
+};
+export const HIGHQ_DIRECT_TOOL_NAMES = [
+    "HIGHQ_LIST_PENDING_REVIEWS",
+    "HIGHQ_GET_LEGAL_REVIEW_CONTEXT",
+    "HIGHQ_RESOLVE_FOLDER_PATH",
+    "HIGHQ_LIST_FOLDER_FILES",
+    "HIGHQ_GET_FILE_CONTENT",
+    "HIGHQ_FILL_LEGAL_REPORT"
+];
+export const HIGHQ_DIRECT_TOOLS = [
+    {
+        name: "HIGHQ_LIST_PENDING_REVIEWS",
+        title: "List Pending HighQ Reviews",
+        description: "Return a clean shortlist of pending or in-progress HighQ request reviews from the connected site.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...SPACE_SCOPE_PROPERTIES,
+                site_id: {
+                    type: "string",
+                    description: "HighQ site ID. Optional when exactly one allowed site is connected."
+                },
+                status_filter: {
+                    type: "string",
+                    enum: ["in_progress", "pending", "active", "all"],
+                    description: "Optional review status filter. Defaults to active."
+                },
+                request_type_contains: {
+                    type: "string",
+                    description: "Optional case-insensitive request-type substring."
+                },
+                page_size: {
+                    type: "integer",
+                    minimum: 1,
+                    maximum: 1000,
+                    description: "Optional number of request rows to inspect. Defaults to 100."
+                }
+            },
+            required: ["space_id"]
+        }
+    },
+    {
+        name: "HIGHQ_GET_LEGAL_REVIEW_CONTEXT",
+        title: "Get HighQ Legal Review Context",
+        description: "Resolve one HighQ request into structured review fields, source-document context, a safe writeback blueprint, and canonical Intangle Item retrieval coordinates for ingested attachments. Original file_* IDs remain accepted compatibility identities for the same Item.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...SPACE_SCOPE_PROPERTIES,
+                site_id: {
+                    type: "string",
+                    description: "HighQ site ID. Optional when exactly one allowed site is connected."
+                },
+                request_id: {
+                    type: "string",
+                    description: "Request-style identifier such as RQ-0023. Required when item_id is omitted."
+                },
+                item_id: {
+                    type: "string",
+                    description: "Direct HighQ iSheet row ID. Required when request_id is omitted."
+                },
+                isheet_id: {
+                    type: "string",
+                    description: "Optional Requests iSheet ID."
+                },
+                file_metadata_isheet_id: {
+                    type: "string",
+                    description: "Optional File Metadata iSheet ID used to resolve request-linked documents."
+                },
+                section_label: {
+                    type: "string",
+                    description: "Optional section label. Defaults to Legal Report."
+                },
+                view_id: {
+                    type: "string",
+                    description: "Optional HighQ view ID matching the visible form."
+                },
+                max_documents: {
+                    type: "integer",
+                    minimum: 1,
+                    maximum: 20,
+                    description: "Optional maximum number of source documents. Defaults to 8."
+                }
+            },
+            required: ["space_id"]
+        }
+    },
+    {
+        name: "HIGHQ_RESOLVE_FOLDER_PATH",
+        title: "Resolve HighQ Folder Path",
+        description: "Resolve a human-readable HighQ folder path to its exact HighQ folder ID.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...SPACE_SCOPE_PROPERTIES,
+                site_id: { type: "string", description: "REQUIRED HighQ site ID." },
+                folder_path: {
+                    type: "string",
+                    description: "REQUIRED HighQ folder path. Numeric UI prefixes may be included."
+                },
+                start_folder_id: {
+                    type: "string",
+                    description: "Optional existing folder ID to resolve relative to."
+                }
+            },
+            required: ["space_id", "site_id", "folder_path"]
+        }
+    },
+    {
+        name: "HIGHQ_LIST_FOLDER_FILES",
+        title: "List HighQ Folder Files",
+        description: "List the files stored directly in one HighQ folder.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...SPACE_SCOPE_PROPERTIES,
+                site_id: {
+                    type: "string",
+                    description: "Optional when exactly one allowed HighQ site is connected. The resolved file must belong to that site."
+                },
+                folder_id: { type: "string", description: "REQUIRED HighQ folder ID." }
+            },
+            required: ["space_id", "folder_id"]
+        }
+    },
+    {
+        name: "HIGHQ_GET_FILE_CONTENT",
+        title: "Get HighQ File Content",
+        description: "Retrieve text when safely extractable from one HighQ file, otherwise return metadata and a retrieval hint. Raw binary payloads are not returned.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...SPACE_SCOPE_PROPERTIES,
+                site_id: {
+                    type: "string",
+                    description: "Optional allowed HighQ site ID."
+                },
+                file_id: { type: "string", description: "REQUIRED HighQ file ID." },
+                original: {
+                    type: "boolean",
+                    description: "Optional request for the original file on older HighQ APIs."
+                },
+                get_converted_file: {
+                    type: "boolean",
+                    description: "Optional request for converted content on newer HighQ APIs."
+                },
+                api_version: {
+                    type: "integer",
+                    minimum: 1,
+                    description: "Optional HighQ file-download API version."
+                }
+            },
+            required: ["space_id", "file_id"]
+        }
+    },
+    {
+        name: "HIGHQ_FILL_LEGAL_REPORT",
+        title: "Fill HighQ Legal Report",
+        description: "Prepare a Phoenix-authorized, durable writeback for the visible Legal Report fields of one HighQ request using the blueprint returned by HIGHQ_GET_LEGAL_REVIEW_CONTEXT.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...SPACE_SCOPE_PROPERTIES,
+                site_id: {
+                    type: "string",
+                    description: "HighQ site ID. Optional when exactly one allowed site is connected."
+                },
+                request_id: {
+                    type: "string",
+                    description: "Request-style identifier such as RQ-0023. Required when item_id is omitted."
+                },
+                item_id: {
+                    type: "string",
+                    description: "Direct HighQ iSheet row ID. Required when request_id is omitted."
+                },
+                isheet_id: {
+                    type: "string",
+                    description: "Optional Requests iSheet ID."
+                },
+                section_label: {
+                    type: "string",
+                    description: "Optional section label. Defaults to Legal Report."
+                },
+                view_id: {
+                    type: "string",
+                    description: "Optional HighQ view ID matching the visible form."
+                },
+                field_values: {
+                    type: "object",
+                    additionalProperties: true,
+                    description: "REQUIRED field labels or column keys mapped to intended Legal Report values."
+                },
+                idempotency_key: {
+                    type: "string",
+                    pattern: "\\S",
+                    description: "REQUIRED stable identity for this intended write. Generate it once and reuse the exact value when polling or retrying so Phoenix can reconcile the durable approval without duplicate HighQ writes."
+                }
+            },
+            required: ["space_id", "field_values", "idempotency_key"]
+        }
+    }
+];

package/dist/index.js

@@ -10,7 +10,8 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ErrorCode, ListResourceTemplatesRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, McpError, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { config } from "dotenv";
 import fetch from "node-fetch";
-import { TOOLS } from "./tool-definitions.js";
+import { HIGHQ_DIRECT_TOOL_NAMES } from "./highq-tool-definitions.js";
+const HIGHQ_DIRECT_TOOL_NAME_SET = new Set(HIGHQ_DIRECT_TOOL_NAMES);
 // ... imports ...
 // Debug logging
 const DEBUG_LOG = "/tmp/intangle-mcp-debug.log";
@@ -196,31 +197,45 @@ try {
             method,
             params,
         };
-        const response = await fetch(buildRemoteApiUrl(), {
-            method: "POST",
-            headers,
-            body: JSON.stringify(rpcBody),
-        });
-        const responseText = await response.text();
-        let responseJson = {};
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), API_TIMEOUT_MS);
         try {
-            responseJson = responseText ? JSON.parse(responseText) : {};
-        }
-        catch {
-            throw new Error(`Failed to parse MCP remote ${method} response`);
+            const response = await fetch(buildRemoteApiUrl(), {
+                method: "POST",
+                headers,
+                body: JSON.stringify(rpcBody),
+                signal: controller.signal,
+            });
+            const responseText = await response.text();
+            let responseJson = {};
+            try {
+                responseJson = responseText ? JSON.parse(responseText) : {};
+            }
+            catch {
+                throw new Error(`Failed to parse MCP remote ${method} response`);
+            }
+            if (!response.ok) {
+                const message = responseJson?.error?.message ||
+                    responseJson?.message ||
+                    `${response.status} ${response.statusText}`;
+                throw new Error(`MCP remote ${method} failed: ${message}`);
+            }
+            if (responseJson?.error) {
+                const code = responseJson.error.code;
+                const message = responseJson.error.message || "Unknown MCP remote error";
+                throw new Error(`MCP remote ${method} error (${code}): ${message}`);
+            }
+            return responseJson?.result ?? {};
         }
-        if (!response.ok) {
-            const message = responseJson?.error?.message ||
-                responseJson?.message ||
-                `${response.status} ${response.statusText}`;
-            throw new Error(`MCP remote ${method} failed: ${message}`);
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new Error(`MCP remote ${method} timed out after ${API_TIMEOUT_MS / 1000}s`);
+            }
+            throw error;
         }
-        if (responseJson?.error) {
-            const code = responseJson.error.code;
-            const message = responseJson.error.message || "Unknown MCP remote error";
-            throw new Error(`MCP remote ${method} error (${code}): ${message}`);
+        finally {
+            clearTimeout(timeoutId);
         }
-        return responseJson?.result ?? {};
     }
     const server = new Server({
         name: "intangle-context",
@@ -237,9 +252,13 @@ try {
             tools: {},
         },
     });
-    server.setRequestHandler(ListToolsRequestSchema, async () => ({
-        tools: TOOLS,
-    }));
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        const result = await makeRemoteRpcCall("tools/list", {});
+        if (!Array.isArray(result?.tools)) {
+            throw new McpError(ErrorCode.InternalError, "Remote tool catalog unavailable");
+        }
+        return { tools: result.tools };
+    });
     server.setRequestHandler(ListResourcesRequestSchema, async () => {
         const result = await makeRemoteRpcCall("resources/list", {});
         return {
@@ -536,6 +555,17 @@ try {
                     result = await handleMessage(args);
                     break;
                 default:
+                    if (HIGHQ_DIRECT_TOOL_NAME_SET.has(name)) {
+                        const remoteResult = await makeRemoteRpcCall("tools/call", {
+                            name,
+                            arguments: args,
+                        });
+                        const text = remoteResult?.content?.find((entry) => entry?.type === "text" && typeof entry.text === "string")?.text;
+                        result = {
+                            response: typeof text === "string" ? text : JSON.stringify(remoteResult),
+                        };
+                        break;
+                    }
                     throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
             }
             // Extract response field for Layer 2 compressed tools, otherwise stringify full result

package/dist/tool-definitions.js

@@ -1,3 +1,4 @@
+import { HIGHQ_DIRECT_TOOLS } from "./highq-tool-definitions.js";
 // Tools definition - matches the stdio server
 const TOOL_DEFINITIONS = [
     {
@@ -39,7 +40,7 @@ const TOOL_DEFINITIONS = [
     {
         name: "fetch_items",
         title: "Fetch Items by ID",
-        description: "Retrieve full content for specific items by ID, including `file_*`, `artifact_*`, and `summary_*` ids. File fetches return extracted content, file metadata, chunk metadata, and decrypted `data.source_data_url` when available; use this before asking Tan to reason over a specific uploaded contract/file in detail. Artifact fetches return content plus render metadata and `config`/`state`/`data` when available.",
+        description: "Retrieve full content for specific Items by ID. Canonical generalized Items retain original compatibility IDs such as `file_*`, `doc_*`, `context_*`, `task_*`, and `skill_*`; pass those IDs unchanged. When Phoenix resolves a distinct legacy alias, the result preserves `requested_id` and `legacy_id` while returning the canonical Item `id`. File fetches return extracted content, file metadata, chunk metadata, and decrypted `data.source_data_url` when available. Artifact fetches accept `artifact_*` IDs and return content plus render metadata and `config`/`state`/`data` when available.",
         inputSchema: {
             type: "object",
             properties: {
@@ -47,6 +48,10 @@ const TOOL_DEFINITIONS = [
                     type: "string",
                     description: "Optional: Space containing the items. Provide this for shared/org spaces so fetch resolves against the correct graph."
                 },
+                organization_id: {
+                    type: "string",
+                    description: "Optional Clerk org ID when the Space belongs to an organization graph. Include it when the same raw space_id could exist in multiple graphs."
+                },
                 id: {
                     type: "string",
                     description: "Single ID to fetch (e.g. `mem_123`, `task_456`, `skill_789`, `doc_321`, `file_654`, `artifact_654`, or `summary_987`)."
@@ -59,7 +64,33 @@ const TOOL_DEFINITIONS = [
             }
         }
     },
-    { name: "read_artifact", title: "Read Artifact", description: "Read one existing artifact by `artifact_id` without asking Tan to restream it in chat. Returns content plus render metadata and `config`/`state`/`data` when available. Prefer this when an external agent already has the artifact id and needs the current artifact payload directly.", inputSchema: { type: "object", properties: { space_id: { type: "string", description: "Optional: Space containing the artifact. Provide this for shared/org spaces so access checks resolve against the correct graph." }, artifact_id: { type: "string", description: "REQUIRED: Existing artifact ID to read (e.g. `artifact_123`)." }, item_id: { type: "string", description: "Optional alias for `artifact_id`." }, organization_id: { type: "string", description: "Optional Clerk org ID when the space belongs to an organization graph." } }, required: ["artifact_id"] } },
+    {
+        name: "read_artifact",
+        title: "Read Artifact",
+        description: "Read one existing artifact by `artifact_id` without asking Tan to restream it in chat. Returns content plus render metadata and `config`/`state`/`data` when available. Prefer this when an external agent already has the artifact id and needs the current artifact payload directly.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "Optional: Space containing the artifact. Provide this for shared/org spaces so access checks resolve against the correct graph."
+                },
+                artifact_id: {
+                    type: "string",
+                    description: "REQUIRED: Existing artifact ID to read (e.g. `artifact_123`)."
+                },
+                item_id: {
+                    type: "string",
+                    description: "Optional alias for `artifact_id`."
+                },
+                organization_id: {
+                    type: "string",
+                    description: "Optional Clerk org ID when the space belongs to an organization graph."
+                }
+            },
+            required: ["artifact_id"]
+        }
+    },
     {
         name: "usage_status",
         title: "Usage Status",
@@ -435,34 +466,6 @@ const TOOL_DEFINITIONS = [
             properties: {}
         }
     },
-    {
-        name: "create_space",
-        title: "Create Space",
-        description: "Create a new space with optional configuration.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                name: {
-                    type: "string",
-                    description: "Name for the NEW space being created (e.g., 'Work', 'Personal', 'Project X')"
-                },
-                description: {
-                    type: "string",
-                    description: "Brief description of what this NEW space is for (e.g., 'Work-related context and tasks')"
-                },
-                config_badges: {
-                    type: "array",
-                    items: { type: "string" },
-                    description: "Array of keywords for this NEW space. Examples: ['fitness', 'recipes', 'travel planning'], ['client work', 'meetings', 'proposals'], ['TypeScript', 'React', 'API design']. They help agents understand and prioritize the space."
-                },
-                startup_preferences: {
-                    type: "string",
-                    description: "AI behavior preferences for this NEW space. Guides how AI assistants and agents should communicate and behave (e.g., 'be concise and frank', 'think critically', 'play devils advocate')."
-                }
-            },
-            required: ["name"]
-        }
-    },
     {
         name: "view_space",
         title: "View Space",
@@ -701,7 +704,10 @@ const TOOL_DEFINITIONS = [
                     items: {
                         type: "object",
                         properties: {
-                            folder_id: { type: "string", description: "Folder ID to rename." },
+                            folder_id: {
+                                type: "string",
+                                description: "Folder ID to rename."
+                            },
                             new_name: { type: "string", description: "New folder name." }
                         },
                         required: ["folder_id", "new_name"]
@@ -814,7 +820,8 @@ const TOOL_DEFINITIONS = [
             },
             required: ["space_id", "content", "idempotency_key"]
         }
-    }
+    },
+    ...HIGHQ_DIRECT_TOOLS
     // DISABLED: memory_action tool is broken and causing errors.
     // Pending OHM protocol fix. Use update_memory, search, or fetch_items instead.
     // {
@@ -847,12 +854,16 @@ const READ_ONLY_TOOLS = new Set([
     "fetch_conversation_messages",
     "list_conversation_inbox",
     "view_spaces",
-    "view_space"
+    "view_space",
+    "HIGHQ_LIST_PENDING_REVIEWS",
+    "HIGHQ_RESOLVE_FOLDER_PATH",
+    "HIGHQ_LIST_FOLDER_FILES",
+    "HIGHQ_GET_FILE_CONTENT"
 ]);
 const DESTRUCTIVE_TOOLS = new Set([
-    "create_space",
     "update_memory",
-    "update_folders"
+    "update_folders",
+    "HIGHQ_FILL_LEGAL_REPORT"
 ]);
 const IDEMPOTENT_TOOLS = new Set([
     "search",
@@ -862,7 +873,11 @@ const IDEMPOTENT_TOOLS = new Set([
     "fetch_conversation_messages",
     "list_conversation_inbox",
     "view_spaces",
-    "view_space"
+    "view_space",
+    "HIGHQ_LIST_PENDING_REVIEWS",
+    "HIGHQ_RESOLVE_FOLDER_PATH",
+    "HIGHQ_LIST_FOLDER_FILES",
+    "HIGHQ_GET_FILE_CONTENT"
 ]);
 export const TOOLS = TOOL_DEFINITIONS.map((tool) => ({
     ...tool,

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@intangle/mcp-server",
-  "version": "2.6.9",
+  "version": "2.6.10",
   "description": "Model Context Protocol server for Intangle - AI context that persists across conversations",
   "main": "dist/index.js",
   "type": "module",
   "scripts": {
     "start": "node dist/index.js",
     "dev": "tsx watch index.ts",
-    "prebuild": "cp ../web/src/app/api/mcp-remote/tool-definitions.ts ./tool-definitions.ts",
+    "prebuild": "node scripts/sync-tool-definitions.mjs",
     "build": "tsc",
     "lint": "biome check .",
-    "lint:release": "biome check --config-path=biome.release.json package.json index.ts tool-definitions.ts",
+    "lint:release": "biome check --config-path=biome.release.json package.json index.ts tool-definitions.ts highq-tool-definitions.ts",
     "lint:fix": "biome check --fix .",
     "prepublishOnly": "npm run build"
   },
@@ -55,5 +55,5 @@
     "tsx": "^4.0.0",
     "typescript": "^5.0.0"
   },
-  "intangleSourceHash": "9abfe72739f6805935f9dbc2649e64fe58535ea7776d22be212609679a600e7c"
+  "intangleSourceHash": "11c5f54f11f3f1ad4db90f88c9da05835ef99f8307554d7c7d22ba7cf61054c1"
 }