@spexly/mcp-server 1.0.2 → 1.1.0

package/dist/index.js

@@ -33,30 +33,30 @@ const { apiKey: API_KEY, apiUrl: API_URL } = parseArgs();
 // Import event types from centralized module
 import { EVENT_TYPES } from './eventTypes.js';
 const SPEXLY_DIR = path.join(os.homedir(), '.spexly');
-const CONVERSATIONS_FILE = path.join(SPEXLY_DIR, 'conversations.json');
-function loadConversations() {
+const AGENTS_FILE = path.join(SPEXLY_DIR, 'agents.json');
+function loadAgentMap() {
     try {
-        if (!fs.existsSync(CONVERSATIONS_FILE))
+        if (!fs.existsSync(AGENTS_FILE))
             return new Map();
-        return new Map(Object.entries(JSON.parse(fs.readFileSync(CONVERSATIONS_FILE, 'utf-8'))));
+        return new Map(Object.entries(JSON.parse(fs.readFileSync(AGENTS_FILE, 'utf-8'))));
     }
     catch {
         return new Map();
     }
 }
-function saveConversation(conversationId, agent) {
+function saveAgent(id, agent) {
     try {
         fs.mkdirSync(SPEXLY_DIR, { recursive: true });
-        const data = loadConversations();
-        data.set(conversationId, agent);
-        fs.writeFileSync(CONVERSATIONS_FILE, JSON.stringify(Object.fromEntries(data), null, 2));
+        const data = loadAgentMap();
+        data.set(id, agent);
+        fs.writeFileSync(AGENTS_FILE, JSON.stringify(Object.fromEntries(data), null, 2));
     }
     catch (err) {
-        console.error('[WARN] Failed to save conversation:', err);
+        console.error('[WARN] Failed to save agent:', err);
     }
 }
-function getAgentForConversation(conversationId) {
-    return loadConversations().get(conversationId);
+function getAgent(id) {
+    return loadAgentMap().get(id);
 }
 // ============================================
 // API Client
@@ -86,20 +86,23 @@ async function apiRequest(method, path, body) {
 // ============================================
 const server = new McpServer({
     name: "spexly",
-    version: "1.0.0"
+    version: "1.1.0"
 });
 // Tool: register_agent
-server.tool("register_agent", "Register yourself as an agent with Spexly for status monitoring. " +
-    "CALL THIS ONCE at the start of a conversation. " +
-    "Use the same conversationId for all calls in this conversation - it must be consistent. " +
-    "This is IDEMPOTENT - safe to call multiple times with the same conversationId.", {
-    conversationId: z.string().describe("Unique, consistent identifier for this conversation (use the same value for all calls)"),
-    name: z.string().describe("Descriptive name for this conversation (e.g., 'Implementing MCP Server')"),
-    workspace: z.string().optional().describe("Optional workspace name for grouping agents (immutable after registration)"),
-    parentId: z.string().optional().describe("Optional parent agent ID for nested/hierarchical agents")
-}, async ({ conversationId, name, workspace, parentId }) => {
+server.registerTool("register_agent", {
+    description: "Register yourself as an agent with Spexly for status monitoring. " +
+        "CALL THIS ONCE at the start of a conversation. " +
+        "Use the same id for all calls in this conversation - it must be consistent. " +
+        "This is IDEMPOTENT - safe to call multiple times with the same id.",
+    inputSchema: {
+        id: z.string().describe("Unique, consistent identifier for this agent (use the same value for all calls)"),
+        name: z.string().describe("Descriptive name for this agent (e.g., 'Implementing MCP Server')"),
+        workspace: z.string().optional().describe("Optional workspace name for grouping agents (immutable after registration)"),
+        parentId: z.string().optional().describe("Optional parent agent id for hierarchical agents")
+    }
+}, async ({ id, name, workspace, parentId }) => {
     // Check if already registered
-    const existing = getAgentForConversation(conversationId);
+    const existing = getAgent(id);
     if (existing) {
         return {
             content: [{
@@ -113,17 +116,29 @@ server.tool("register_agent", "Register yourself as an agent with Spexly for sta
                 }]
         };
     }
+    // Resolve parentId through mapping if provided
+    let resolvedParentId = null;
+    if (parentId) {
+        const parentAgent = getAgent(parentId);
+        if (!parentAgent) {
+            return {
+                content: [{ type: "text", text: `Error: Parent agent "${parentId}" not found. Register the parent first.` }],
+                isError: true
+            };
+        }
+        resolvedParentId = parentAgent.agentId;
+    }
     // Register new agent
     const result = await apiRequest("POST", "/agents/register", {
         name,
         workspace: workspace || null,
-        parentId: parentId || null
+        parentId: resolvedParentId
     });
     if (!result.ok) {
         return { content: [{ type: "text", text: `Error: ${result.error}` }], isError: true };
     }
     // Persist the mapping
-    saveConversation(conversationId, {
+    saveAgent(id, {
         agentId: result.data.id,
         name: result.data.name,
         workspace: result.data.workspace || null,
@@ -142,16 +157,19 @@ server.tool("register_agent", "Register yourself as an agent with Spexly for sta
     };
 });
 // Tool: update_agent
-server.tool("update_agent", "Update the name of a registered agent. " +
-    "Use this to rename an agent if the conversation context has changed. " +
-    "Use the same conversationId as your register_agent call.", {
-    conversationId: z.string().describe("Unique, consistent identifier for this conversation (use the same value for all calls)"),
-    name: z.string().describe("New descriptive name for this conversation")
-}, async ({ conversationId, name }) => {
-    const agent = getAgentForConversation(conversationId);
+server.registerTool("update_agent", {
+    description: "Update the name of a registered agent. " +
+        "Use this to rename an agent if the context has changed. " +
+        "Use the same id as your register_agent call.",
+    inputSchema: {
+        id: z.string().describe("Unique, consistent identifier for this agent (use the same value for all calls)"),
+        name: z.string().describe("New descriptive name for this agent")
+    }
+}, async ({ id, name }) => {
+    const agent = getAgent(id);
     if (!agent) {
         return {
-            content: [{ type: "text", text: "Error: No agent registered for this conversation. Call register_agent first." }],
+            content: [{ type: "text", text: "Error: No agent registered with this id. Call register_agent first." }],
             isError: true
         };
     }
@@ -160,7 +178,7 @@ server.tool("update_agent", "Update the name of a registered agent. " +
         return { content: [{ type: "text", text: `Error: ${result.error}` }], isError: true };
     }
     // Update local cache
-    saveConversation(conversationId, {
+    saveAgent(id, {
         ...agent,
         name: result.data.name
     });
@@ -177,16 +195,19 @@ server.tool("update_agent", "Update the name of a registered agent. " +
     };
 });
 // Tool: report_event
-server.tool("report_event", "Report your current status to the Spexly monitoring dashboard. " +
-    "CALL THIS whenever your working state changes: " +
-    "task_start (beginning work), task_complete (finished), thinking (reasoning NOT working), " +
-    "error (problem), idle (waiting), blocked (stuck), needs_input (need clarification). " +
-    "Use the same conversationId as your register_agent call.", {
-    conversationId: z.string().describe("Unique, consistent identifier for this conversation (use the same value for all calls)"),
-    eventType: z.enum(EVENT_TYPES).describe("Your current state"),
-    message: z.string().optional().describe("Brief description of what you're doing")
-}, async ({ conversationId, eventType, message }) => {
-    const agent = getAgentForConversation(conversationId);
+server.registerTool("report_event", {
+    description: "Report your current status to the Spexly monitoring dashboard. " +
+        "CALL THIS whenever your working state changes: " +
+        "task_start (beginning work), task_complete (finished), thinking (reasoning NOT working), " +
+        "error (problem), idle (waiting), blocked (stuck), needs_input (need clarification). " +
+        "Use the same id as your register_agent call.",
+    inputSchema: {
+        id: z.string().describe("Unique, consistent identifier for this agent (use the same value for all calls)"),
+        eventType: z.enum(EVENT_TYPES).describe("Your current state"),
+        message: z.string().optional().describe("Brief description of what you're doing")
+    }
+}, async ({ id, eventType, message }) => {
+    const agent = getAgent(id);
     if (!agent) {
         return {
             content: [{ type: "text", text: "Error: Not registered. Call register_agent first." }],
@@ -216,7 +237,7 @@ async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error("Spexly MCP server running");
-    console.error(`Conversations: ${CONVERSATIONS_FILE}`);
+    console.error(`Agents file: ${AGENTS_FILE}`);
 }
 main().catch((err) => {
     console.error("Fatal error:", err);

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@spexly/mcp-server",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Spexly MCP Server - AI agent status monitoring via Model Context Protocol",
   "main": "dist/index.js",
   "bin": {
-    "spexly-mcp": "./dist/index.js"
+    "spexly-mcp": "dist/index.js"
   },
   "files": [
     "dist",
@@ -44,4 +44,4 @@
   "engines": {
     "node": ">=18.0.0"
   }
-}
+}