@intangle/mcp-server 1.2.1 → 1.2.3

package/index.ts

@@ -17,6 +17,7 @@ import {
 import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
 import { dirname, join } from "path";
+import { TOOLS } from "./tool-definitions.js";
 
 // Load environment variables from .env and .env.local
 config({ quiet: true });
@@ -107,364 +108,6 @@ const server = new Server(
 	},
 );
 
-const TOOLS = [
-	{
-		name: "search_memories",
-		description:
-			"Search through ALL stored data including BOTH context (general information) AND tasks (actionable workflow items). Uses intelligent routing with query classification. Supports depth control for speed vs thoroughness tradeoff. ALWAYS provide space_id parameter - this is mandatory for all searches.",
-		inputSchema: {
-			type: "object",
-			properties: {
-				space_id: {
-					type: "string",
-					description:
-						"REQUIRED: Space to search in (use list_spaces to see available options)",
-				},
-				query: {
-					type: "string",
-					description: "Search query for finding relevant memories",
-				},
-				topics: {
-					type: "array",
-					items: { type: "string" },
-					description: "Filter by specific topics",
-				},
-				max_results: {
-					type: "number",
-					description: "Maximum number of results to return",
-					default: 10,
-				},
-				depth: {
-					type: "string",
-					enum: ["quick", "balanced", "deep"],
-					description:
-						"Search depth: 'quick' = fast list retrieval, 'balanced' = smart routing with AI (default), 'deep' = full hybrid search with attention agent",
-					default: "balanced",
-				},
-				return_format: {
-					type: "string",
-					enum: ["full", "summary", "ids_only"],
-					description:
-						"Result format: 'full' = complete content (default), 'summary' = truncated content, 'ids_only' = just IDs for subsequent fetch",
-					default: "full",
-				},
-			},
-			required: ["query"],
-		},
-	},
-	{
-		name: "get_recent_memories",
-		description:
-			"Get the most recent CONTEXT items (general information). For recent tasks, use list_tasks instead. NOTE: This tool is called 'get_recent_memories' (not 'fetch'). Returns fully decrypted data. REQUIRES space_id parameter.",
-		inputSchema: {
-			type: "object",
-			properties: {
-				space_id: {
-					type: "string",
-					description:
-						"REQUIRED: Space to get memories from (use list_spaces to see available options)",
-				},
-				topics: {
-					type: "array",
-					items: { type: "string" },
-					description: "Filter by specific topics",
-				},
-				limit: {
-					type: "number",
-					description: "Number of recent memories to retrieve",
-					default: 20,
-				},
-			},
-			required: ["space_id"],
-		},
-	},
-	{
-		name: "fetch",
-		description:
-			"Fetch complete items (context or tasks) by ID. Accepts single ID or array of IDs. Returns BOTH context (Memory nodes) and tasks (Task nodes) with full content, topics, and metadata. Always returns full content (never summaries). Use this after getting summaries from search/list/start to retrieve full details for specific items.",
-		inputSchema: {
-			type: "object",
-			properties: {
-				id: {
-					type: "string",
-					description:
-						"Single ID to fetch (context or task ID like 'mem_123' or 'task_456')",
-				},
-				ids: {
-					type: "array",
-					items: { type: "string" },
-					description:
-						"Array of IDs to fetch (mix of context and task IDs). Use this to fetch multiple items in one call.",
-				},
-			},
-		},
-	},
-	{
-		name: "list_spaces",
-		description:
-			"Get all available spaces with their descriptions and item counts (both context and tasks). Spaces are top-level containers that isolate different contexts (e.g., personal, work, projects).",
-		inputSchema: {
-			type: "object",
-			properties: {},
-		},
-	},
-	{
-		name: "create_space",
-		description:
-			"Create a new space with optional configuration. Spaces are top-level containers that hold both context (general information) and tasks (actionable items). The 'start' tool loads this configuration when beginning work in this space. Checks user's plan limits and returns upgrade link if limit reached.",
-		inputSchema: {
-			type: "object",
-			properties: {
-				name: {
-					type: "string",
-					description:
-						"Name for the space (e.g., 'Work', 'Personal', 'Project X')",
-				},
-				description: {
-					type: "string",
-					description:
-						"Brief description of what this space is for (e.g., 'Work-related context and tasks')",
-				},
-				config_badges: {
-					type: "array",
-					items: { type: "string" },
-					description:
-						"Array of keywords for memory focus in this space. These keywords help steer what context gets loaded when running 'start' for this space. Examples: ['TypeScript', 'React', 'API design', 'authentication']. They act as search terms to prioritize relevant memories.",
-				},
-				startup_preferences: {
-					type: "string",
-					description:
-						"AI behavior preferences for this space. Guides how AI assistants and agents should communicate and behave (e.g., 'be concise and frank', 'think critically', 'play devils advocate'). This appears in the start briefing under 'Assistant Preferences'.",
-				},
-				include_tasks: {
-					type: "boolean",
-					description:
-						"Whether to automatically retrieve pending/in-progress tasks when running the 'start' tool for this space",
-					default: false,
-				},
-			},
-			required: ["name"],
-		},
-	},
-	{
-		name: "get_space_info",
-		description: "Get detailed information about a specific space",
-		inputSchema: {
-			type: "object",
-			properties: {
-				space_id: {
-					type: "string",
-					description: "ID of space to get info for",
-				},
-			},
-			required: ["space_id"],
-		},
-	},
-	{
-		name: "start",
-		description:
-			"Start working in a space and get comprehensive initialization. Returns static context, auto-searched context (general information), preferences, and optionally pending tasks. This tool retrieves BOTH context AND tasks based on space configuration. Call this when starting a conversation in a space to get relevant information.",
-		inputSchema: {
-			type: "object",
-			properties: {
-				space_id: {
-					type: "string",
-					description: "Space to start (e.g., 'renvoi', 'personal')",
-				},
-			},
-			required: ["space_id"],
-		},
-	},
-	{
-		name: "update_memory",
-		description:
-			"Unified tool for ALL memory operations: add, update, or delete context and tasks. Supports any combination of operations in a single call. Context = general information/knowledge (Memory nodes). Tasks = actionable workflow items (Task nodes). Max 50 operations per call. At least one operation (add/update/delete) required.",
-		inputSchema: {
-			type: "object",
-			properties: {
-				space_id: {
-					type: "string",
-					description:
-						"REQUIRED: Space to operate in (use list_spaces to see available options)",
-				},
-				add: {
-					type: "object",
-					description: "Add new context and/or tasks to memory",
-					properties: {
-						context: {
-							type: "array",
-							items: {
-								type: "object",
-								properties: {
-									title: { type: "string", description: "Context title" },
-									content: {
-										type: "string",
-										description: "Context content (general information)",
-									},
-									topics: {
-										type: "array",
-										items: { type: "string" },
-										description: "Optional topics/tags",
-									},
-								},
-								required: ["title", "content"],
-							},
-							description: "Array of context items to add",
-						},
-						tasks: {
-							type: "array",
-							items: {
-								type: "object",
-								properties: {
-									title: { type: "string", description: "Task title" },
-									content: { type: "string", description: "Task description" },
-									topics: {
-										type: "array",
-										items: { type: "string" },
-										description: "Optional topics/tags",
-									},
-									status: {
-										type: "string",
-										enum: [
-											"pending",
-											"in_progress",
-											"completed",
-											"invalidated",
-										],
-										description: "Task status (default: pending)",
-									},
-									priority: {
-										type: "string",
-										enum: ["urgent", "high", "medium", "low"],
-										description: "Priority level (default: medium)",
-									},
-								},
-								required: ["title", "content"],
-							},
-							description: "Array of tasks to add",
-						},
-					},
-				},
-				update: {
-					type: "object",
-					description: "Update existing context and/or tasks",
-					properties: {
-						context: {
-							type: "array",
-							items: {
-								type: "object",
-								properties: {
-									id: { type: "string", description: "Context ID to update" },
-									title: {
-										type: "string",
-										description: "New title (optional)",
-									},
-									content: {
-										type: "string",
-										description: "New content (optional)",
-									},
-									topics: {
-										type: "array",
-										items: { type: "string" },
-										description: "New topics (optional)",
-									},
-								},
-								required: ["id"],
-							},
-							description: "Array of context updates (must include id)",
-						},
-						tasks: {
-							type: "array",
-							items: {
-								type: "object",
-								properties: {
-									task_id: { type: "string", description: "Task ID to update" },
-									title: {
-										type: "string",
-										description: "New title (optional)",
-									},
-									content: {
-										type: "string",
-										description: "New content (optional)",
-									},
-									topics: {
-										type: "array",
-										items: { type: "string" },
-										description: "New topics (optional)",
-									},
-									status: {
-										type: "string",
-										enum: [
-											"pending",
-											"in_progress",
-											"completed",
-											"invalidated",
-										],
-										description: "New status (optional)",
-									},
-									priority: {
-										type: "string",
-										enum: ["urgent", "high", "medium", "low"],
-										description: "New priority (optional)",
-									},
-								},
-								required: ["task_id"],
-							},
-							description: "Array of task updates (must include task_id)",
-						},
-					},
-				},
-				delete: {
-					type: "object",
-					description: "Delete context and/or tasks by ID",
-					properties: {
-						context_ids: {
-							type: "array",
-							items: { type: "string" },
-							description: "Array of context IDs to delete",
-						},
-						task_ids: {
-							type: "array",
-							items: { type: "string" },
-							description: "Array of task IDs to delete",
-						},
-					},
-				},
-			},
-			required: ["space_id"],
-		},
-	},
-	{
-		name: "list_tasks",
-		description: "List tasks in a space with optional filtering",
-		inputSchema: {
-			type: "object",
-			properties: {
-				space_id: {
-					type: "string",
-					description: "Space to list tasks from",
-				},
-				status: {
-					type: "string",
-					enum: ["pending", "in_progress", "completed", "invalidated"],
-					description: "Optional: Filter by status",
-				},
-				topics: {
-					type: "array",
-					items: { type: "string" },
-					description: "Optional: Filter by topics",
-				},
-				limit: {
-					type: "number",
-					description: "Maximum number of tasks to return",
-					default: 50,
-				},
-			},
-			required: ["space_id"],
-		},
-	},
-];
-
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
 	tools: TOOLS,
 }));
@@ -535,7 +178,7 @@ async function handleFetch(args: any) {
 	return makeApiCall("fetch", { id, ids });
 }
 
-async function handleListSpaces() {
+async function handleViewSpaces() {
 	return makeApiCall("list-spaces", {});
 }
 
@@ -543,9 +186,9 @@ async function handleCreateSpace(args: any) {
 	return makeApiCall("create-space", args);
 }
 
-async function handleGetSpaceInfo(args: any) {
+async function handleViewSpace(args: any) {
 	const { space_id } = args as { space_id: string };
-	return makeApiCall("get-space-info", { space_id });
+	return makeApiCall("view-space", { space_id });
 }
 
 async function handleStart(args: any) {
@@ -553,10 +196,10 @@ async function handleStart(args: any) {
 	return makeApiCall("start", { space_id });
 }
 
-async function handleUpdateMemory(args: any) {
+async function handleUpdateSpace(args: any) {
 	if (!args.space_id) {
 		throw new Error(
-			"space_id is required. Use list_spaces to see available options.",
+			"space_id is required. Use view_spaces to see available options.",
 		);
 	}
 
@@ -586,7 +229,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request: any) => {
 		let result: any;
 
 		switch (name) {
-			case "search_memories":
+			case "search":
 				result = await handleSearchMemories(args);
 				break;
 			case "get_recent_memories":
@@ -595,20 +238,20 @@ server.setRequestHandler(CallToolRequestSchema, async (request: any) => {
 			case "fetch":
 				result = await handleFetch(args);
 				break;
-			case "list_spaces":
-				result = await handleListSpaces();
+			case "view_spaces":
+				result = await handleViewSpaces();
 				break;
 			case "create_space":
 				result = await handleCreateSpace(args);
 				break;
-			case "get_space_info":
-				result = await handleGetSpaceInfo(args);
+			case "view_space":
+				result = await handleViewSpace(args);
 				break;
 			case "start":
 				result = await handleStart(args);
 				break;
-			case "update_memory":
-				result = await handleUpdateMemory(args);
+			case "update_space":
+				result = await handleUpdateSpace(args);
 				break;
 			case "list_tasks":
 				result = await handleListTasks(args);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@intangle/mcp-server",
-	"version": "1.2.1",
+	"version": "1.2.3",
 	"description": "Model Context Protocol server for Intangle - AI memory that persists across conversations",
 	"main": "dist/index.js",
 	"type": "module",