claude-sessions-mcp 0.4.0 → 0.4.1-beta.0

package/dist/index.js

@@ -3,7 +3,7 @@
 // src/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { Effect } from "effect";
+import { Cause, Effect } from "effect";
 import { z } from "zod";
 import * as session from "@claude-sessions/core";
 
@@ -13,13 +13,24 @@ import { dirname, resolve } from "path";
 import { fileURLToPath } from "url";
 import { existsSync } from "fs";
 var __dirname = dirname(fileURLToPath(import.meta.url));
-async function startWebServer(port = 5173, openBrowser = true) {
+async function startWebServer(options = {}) {
+  const { port = 5173, openBrowser = true, editor, home, project } = options;
   const localCliPath = resolve(__dirname, "../../web/dist/cli.js");
   const useLocal = existsSync(localCliPath);
-  const child = useLocal ? spawn("node", [localCliPath, "--port", String(port)], {
+  const cliArgs = ["--port", String(port)];
+  if (editor) {
+    cliArgs.push("--editor", editor);
+  }
+  if (home) {
+    cliArgs.push("--home", home);
+  }
+  if (project) {
+    cliArgs.push("--project", project);
+  }
+  const child = useLocal ? spawn("node", [localCliPath, ...cliArgs], {
     stdio: ["ignore", "pipe", "pipe"],
     env: { ...process.env }
-  }) : spawn("npx", ["@claude-sessions/web", "--port", String(port)], {
+  }) : spawn("npx", ["@claude-sessions/web@latest", ...cliArgs], {
     stdio: ["ignore", "pipe", "pipe"],
     env: { ...process.env }
   });
@@ -62,12 +73,22 @@ async function stopWebServer(server2) {
 }
 
 // src/index.ts
+async function runEffect(effect) {
+  return Effect.runPromise(
+    effect.pipe(
+      Effect.catchAllCause((cause) => {
+        const prettyError = Cause.pretty(cause);
+        return Effect.die(new Error(prettyError));
+      })
+    )
+  );
+}
 var server = new McpServer({
   name: "claude-sessions-mcp",
   version: "0.4.0"
 });
 server.tool("list_projects", "List all Claude Code projects with session counts", {}, async () => {
-  const result = await Effect.runPromise(session.listProjects);
+  const result = await runEffect(session.listProjects);
   return {
     content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
   };
@@ -79,7 +100,7 @@ server.tool(
     project_name: z.string().describe("Project folder name (e.g., '-Users-young-works-myproject')")
   },
   async ({ project_name }) => {
-    const result = await Effect.runPromise(session.listSessions(project_name));
+    const result = await runEffect(session.listSessions(project_name));
     return {
       content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
     };
@@ -94,9 +115,7 @@ server.tool(
     new_title: z.string().describe("New title to add as prefix")
   },
   async ({ project_name, session_id, new_title }) => {
-    const result = await Effect.runPromise(
-      session.renameSession(project_name, session_id, new_title)
-    );
+    const result = await runEffect(session.renameSession(project_name, session_id, new_title));
     return {
       content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
     };
@@ -110,7 +129,7 @@ server.tool(
     session_id: z.string().describe("Session ID to delete")
   },
   async ({ project_name, session_id }) => {
-    const result = await Effect.runPromise(session.deleteSession(project_name, session_id));
+    const result = await runEffect(session.deleteSession(project_name, session_id));
     return {
       content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
     };
@@ -125,9 +144,7 @@ server.tool(
     message_uuid: z.string().describe("UUID of the message to delete")
   },
   async ({ project_name, session_id, message_uuid }) => {
-    const result = await Effect.runPromise(
-      session.deleteMessage(project_name, session_id, message_uuid)
-    );
+    const result = await runEffect(session.deleteMessage(project_name, session_id, message_uuid));
     return {
       content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
     };
@@ -140,7 +157,7 @@ server.tool(
     project_name: z.string().optional().describe("Optional: filter by project name")
   },
   async ({ project_name }) => {
-    const result = await Effect.runPromise(session.previewCleanup(project_name));
+    const result = await runEffect(session.previewCleanup(project_name));
     return {
       content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
     };
@@ -156,7 +173,7 @@ server.tool(
     clear_orphan_agents: z.boolean().default(true).describe("Clear orphan agent files whose session no longer exists (default: true)")
   },
   async ({ project_name, clear_empty, clear_invalid, clear_orphan_agents }) => {
-    const result = await Effect.runPromise(
+    const result = await runEffect(
       session.clearSessions({
         projectName: project_name,
         clearEmpty: clear_empty,
@@ -177,7 +194,77 @@ server.tool(
     session_id: z.string().describe("Session ID")
   },
   async ({ project_name, session_id }) => {
-    const result = await Effect.runPromise(session.getSessionFiles(project_name, session_id));
+    const result = await runEffect(session.getSessionFiles(project_name, session_id));
+    return {
+      content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+    };
+  }
+);
+server.tool(
+  "analyze_session",
+  "Analyze a session to get statistics, tool usage, patterns, and optimization insights",
+  {
+    project_name: z.string().describe("Project folder name"),
+    session_id: z.string().describe("Session ID")
+  },
+  async ({ project_name, session_id }) => {
+    const result = await runEffect(session.analyzeSession(project_name, session_id));
+    return {
+      content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+    };
+  }
+);
+server.tool(
+  "summarize_session",
+  "Summarize a session into compact user/assistant conversation format with timestamps",
+  {
+    project_name: z.string().describe("Project folder name"),
+    session_id: z.string().describe("Session ID"),
+    limit: z.number().default(50).describe("Maximum number of messages to include (default: 50)"),
+    max_length: z.number().default(100).describe("Maximum length for each message content (default: 100)")
+  },
+  async ({ project_name, session_id, limit, max_length }) => {
+    const result = await runEffect(
+      session.summarizeSession(project_name, session_id, {
+        limit,
+        maxLength: max_length
+      })
+    );
+    return {
+      content: [{ type: "text", text: result.formatted }]
+    };
+  }
+);
+server.tool(
+  "compress_session",
+  "Compress a session by removing redundant snapshots and truncating long tool outputs",
+  {
+    project_name: z.string().describe("Project folder name"),
+    session_id: z.string().describe("Session ID"),
+    keep_snapshots: z.enum(["first_last", "all", "none"]).default("first_last").describe("Which snapshots to keep: first_last (default), all, or none"),
+    max_tool_output_length: z.number().default(0).describe("Truncate tool outputs longer than this (0 = no limit)")
+  },
+  async ({ project_name, session_id, keep_snapshots, max_tool_output_length }) => {
+    const result = await runEffect(
+      session.compressSession(project_name, session_id, {
+        keepSnapshots: keep_snapshots,
+        maxToolOutputLength: max_tool_output_length
+      })
+    );
+    return {
+      content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+    };
+  }
+);
+server.tool(
+  "extract_project_knowledge",
+  "Extract patterns, hot files, workflows, and decisions from project sessions",
+  {
+    project_name: z.string().describe("Project folder name"),
+    session_ids: z.array(z.string()).optional().describe("Optional: specific session IDs to analyze (default: all sessions)")
+  },
+  async ({ project_name, session_ids }) => {
+    const result = await runEffect(session.extractProjectKnowledge(project_name, session_ids));
     return {
       content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
     };
@@ -194,9 +281,7 @@ server.tool(
     )
   },
   async ({ project_name, session_id, message_uuid }) => {
-    const result = await Effect.runPromise(
-      session.splitSession(project_name, session_id, message_uuid)
-    );
+    const result = await runEffect(session.splitSession(project_name, session_id, message_uuid));
     return {
       content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
     };
@@ -209,9 +294,12 @@ server.tool(
   {
     port: z.number().default(5173).describe("Port to run the web server on (default: 5173)"),
     open_browser: z.boolean().default(true).describe("Whether to open browser automatically (default: true)"),
-    restart: z.boolean().default(false).describe("Restart the server if already running (default: false)")
+    restart: z.boolean().default(false).describe("Restart the server if already running (default: false)"),
+    editor: z.string().optional().describe("Editor command to open files (default: code)"),
+    home: z.string().optional().describe("Home directory for ~ expansion (default: system homedir)"),
+    project: z.string().optional().describe("Current project name for priority sorting in project list")
   },
-  async ({ port, open_browser, restart }) => {
+  async ({ port, open_browser, restart, editor, home, project }) => {
     try {
       if (webServerInstance) {
         if (restart) {
@@ -236,7 +324,13 @@ server.tool(
           };
         }
       }
-      webServerInstance = await startWebServer(port, open_browser);
+      webServerInstance = await startWebServer({
+        port,
+        openBrowser: open_browser,
+        editor,
+        home,
+        project
+      });
       return {
         content: [
           {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/server.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * claude-sessions-mcp\n * MCP server for managing Claude Code conversation sessions\n */\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { Effect } from 'effect'\nimport { z } from 'zod'\nimport * as session from '@claude-sessions/core'\nimport { startWebServer, stopWebServer, type WebServer } from './server.js'\n\nconst server = new McpServer({\n  name: 'claude-sessions-mcp',\n  version: '0.4.0',\n})\n\n// List all projects\nserver.tool('list_projects', 'List all Claude Code projects with session counts', {}, async () => {\n  const result = await Effect.runPromise(session.listProjects)\n  return {\n    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n  }\n})\n\n// List sessions in a project\nserver.tool(\n  'list_sessions',\n  'List all sessions in a project',\n  {\n    project_name: z.string().describe(\"Project folder name (e.g., '-Users-young-works-myproject')\"),\n  },\n  async ({ project_name }) => {\n    const result = await Effect.runPromise(session.listSessions(project_name))\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Rename session\nserver.tool(\n  'rename_session',\n  'Rename a session by adding a title prefix to the first message',\n  {\n    project_name: z.string().describe('Project folder name'),\n    session_id: z.string().describe('Session ID (filename without .jsonl)'),\n    new_title: z.string().describe('New title to add as prefix'),\n  },\n  async ({ project_name, session_id, new_title }) => {\n    const result = await Effect.runPromise(\n      session.renameSession(project_name, session_id, new_title)\n    )\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Delete session\nserver.tool(\n  'delete_session',\n  'Delete a session (moves to .bak folder for recovery)',\n  {\n    project_name: z.string().describe('Project folder name'),\n    session_id: z.string().describe('Session ID to delete'),\n  },\n  async ({ project_name, session_id }) => {\n    const result = await Effect.runPromise(session.deleteSession(project_name, session_id))\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Delete message\nserver.tool(\n  'delete_message',\n  'Delete a message from a session and repair the parentUuid chain',\n  {\n    project_name: z.string().describe('Project folder name'),\n    session_id: z.string().describe('Session ID'),\n    message_uuid: z.string().describe('UUID of the message to delete'),\n  },\n  async ({ project_name, session_id, message_uuid }) => {\n    const result = await Effect.runPromise(\n      session.deleteMessage(project_name, session_id, message_uuid)\n    )\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Preview cleanup\nserver.tool(\n  'preview_cleanup',\n  'Preview sessions that would be cleaned (empty and invalid API key sessions)',\n  {\n    project_name: z.string().optional().describe('Optional: filter by project name'),\n  },\n  async ({ project_name }) => {\n    const result = await Effect.runPromise(session.previewCleanup(project_name))\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Clear sessions\nserver.tool(\n  'clear_sessions',\n  'Delete all empty sessions and invalid API key sessions',\n  {\n    project_name: z.string().optional().describe('Optional: filter by project name'),\n    clear_empty: z.boolean().default(true).describe('Clear empty sessions (default: true)'),\n    clear_invalid: z\n      .boolean()\n      .default(true)\n      .describe('Clear invalid API key sessions (default: true)'),\n    clear_orphan_agents: z\n      .boolean()\n      .default(true)\n      .describe('Clear orphan agent files whose session no longer exists (default: true)'),\n  },\n  async ({ project_name, clear_empty, clear_invalid, clear_orphan_agents }) => {\n    const result = await Effect.runPromise(\n      session.clearSessions({\n        projectName: project_name,\n        clearEmpty: clear_empty,\n        clearInvalid: clear_invalid,\n        clearOrphanAgents: clear_orphan_agents,\n      })\n    )\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Get changed files from a session\nserver.tool(\n  'get_session_files',\n  'Get list of all files changed in a session (from file-history-snapshot and tool_use)',\n  {\n    project_name: z.string().describe('Project folder name'),\n    session_id: z.string().describe('Session ID'),\n  },\n  async ({ project_name, session_id }) => {\n    const result = await Effect.runPromise(session.getSessionFiles(project_name, session_id))\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Split session\nserver.tool(\n  'split_session',\n  'Split a session at a specific message, creating a new session with messages from that point onwards',\n  {\n    project_name: z.string().describe('Project folder name'),\n    session_id: z.string().describe('Session ID to split'),\n    message_uuid: z\n      .string()\n      .describe(\n        'UUID of the message where the split starts (this message becomes the first message of the new session)'\n      ),\n  },\n  async ({ project_name, session_id, message_uuid }) => {\n    const result = await Effect.runPromise(\n      session.splitSession(project_name, session_id, message_uuid)\n    )\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Start GUI\nlet webServerInstance: WebServer | null = null\n\nserver.tool(\n  'start_gui',\n  'Start the web GUI for session management and open it in browser',\n  {\n    port: z.number().default(5173).describe('Port to run the web server on (default: 5173)'),\n    open_browser: z\n      .boolean()\n      .default(true)\n      .describe('Whether to open browser automatically (default: true)'),\n    restart: z\n      .boolean()\n      .default(false)\n      .describe('Restart the server if already running (default: false)'),\n  },\n  async ({ port, open_browser, restart }) => {\n    try {\n      if (webServerInstance) {\n        if (restart) {\n          await stopWebServer(webServerInstance)\n          webServerInstance = null\n        } else {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: JSON.stringify(\n                  {\n                    success: true,\n                    message: 'Web GUI is already running',\n                    url: `http://localhost:${port}`,\n                  },\n                  null,\n                  2\n                ),\n              },\n            ],\n          }\n        }\n      }\n\n      webServerInstance = await startWebServer(port, open_browser)\n\n      return {\n        content: [\n          {\n            type: 'text',\n            text: JSON.stringify(\n              {\n                success: true,\n                message: 'Web GUI started successfully',\n                url: `http://localhost:${port}`,\n                pid: process.pid,\n              },\n              null,\n              2\n            ),\n          },\n        ],\n      }\n    } catch (error) {\n      return {\n        content: [\n          {\n            type: 'text',\n            text: JSON.stringify(\n              {\n                success: false,\n                error: String(error),\n              },\n              null,\n              2\n            ),\n          },\n        ],\n      }\n    }\n  }\n)\n\n// Stop GUI\nserver.tool('stop_gui', 'Stop the web GUI server', {}, async () => {\n  if (webServerInstance) {\n    const port = webServerInstance.port\n    // Call shutdown API first for graceful shutdown\n    try {\n      await fetch(`http://localhost:${port}/api/shutdown`, { method: 'POST' })\n    } catch {\n      // Server might already be stopping\n    }\n    // Then kill the process if still running\n    await stopWebServer(webServerInstance)\n    webServerInstance = null\n    return {\n      content: [\n        {\n          type: 'text',\n          text: JSON.stringify({ success: true, message: 'Web GUI stopped successfully' }, null, 2),\n        },\n      ],\n    }\n  }\n  return {\n    content: [\n      {\n        type: 'text',\n        text: JSON.stringify({ success: true, message: 'Web GUI was not running' }, null, 2),\n      },\n    ],\n  }\n})\n\n// Main entry\nasync function main() {\n  const transport = new StdioServerTransport()\n  await server.connect(transport)\n}\n\nmain().catch(console.error)\n","/**\n * Web server management for MCP\n * Launches @claude-sessions/web\n */\nimport { spawn, type ChildProcess } from 'node:child_process'\nimport { dirname, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { existsSync } from 'node:fs'\n\nconst __dirname = dirname(fileURLToPath(import.meta.url))\n\nexport interface WebServer {\n  process: ChildProcess\n  port: number\n}\n\nexport async function startWebServer(\n  port: number = 5173,\n  openBrowser: boolean = true\n): Promise<WebServer> {\n  // Try local build first, fallback to npx\n  const localCliPath = resolve(__dirname, '../../web/dist/cli.js')\n  const useLocal = existsSync(localCliPath)\n\n  const child = useLocal\n    ? spawn('node', [localCliPath, '--port', String(port)], {\n        stdio: ['ignore', 'pipe', 'pipe'],\n        env: { ...process.env },\n      })\n    : spawn('npx', ['@claude-sessions/web', '--port', String(port)], {\n        stdio: ['ignore', 'pipe', 'pipe'],\n        env: { ...process.env },\n      })\n\n  // Wait for server to start\n  await new Promise<void>((resolve, reject) => {\n    const timeout = setTimeout(() => reject(new Error('Server startup timeout')), 30000)\n\n    child.stdout?.on('data', (data: Buffer) => {\n      const output = data.toString()\n      // SvelteKit adapter-node outputs \"Listening on http://0.0.0.0:PORT\"\n      if (\n        output.includes('Listening on') ||\n        output.includes('localhost') ||\n        output.includes('Local:')\n      ) {\n        clearTimeout(timeout)\n        resolve()\n      }\n    })\n\n    child.stderr?.on('data', (data: Buffer) => {\n      const output = data.toString()\n      // npm/npx progress output goes to stderr\n      if (output.includes('Listening on') || output.includes('localhost')) {\n        clearTimeout(timeout)\n        resolve()\n      }\n    })\n\n    child.on('error', (err) => {\n      clearTimeout(timeout)\n      reject(err)\n    })\n\n    child.on('exit', (code) => {\n      if (code !== 0) {\n        clearTimeout(timeout)\n        reject(new Error(`Server exited with code ${code}`))\n      }\n    })\n  })\n\n  // Open browser if requested\n  if (openBrowser) {\n    const url = `http://localhost:${port}`\n    const openCmd =\n      process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open'\n    spawn(openCmd, [url], { stdio: 'ignore', detached: true }).unref()\n  }\n\n  return { process: child, port }\n}\n\nexport async function stopWebServer(server: WebServer): Promise<void> {\n  server.process.kill('SIGTERM')\n}\n"],"mappings":"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","names":["resolve","server"]}
+{"version":3,"sources":["../src/index.ts","../src/server.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * claude-sessions-mcp\n * MCP server for managing Claude Code conversation sessions\n */\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { Cause, Effect } from 'effect'\nimport { z } from 'zod'\nimport * as session from '@claude-sessions/core'\nimport { startWebServer, stopWebServer, type WebServer } from './server.js'\n\n// Helper to run Effect with detailed error reporting\nasync function runEffect<A>(effect: Effect.Effect<A, unknown, never>): Promise<A> {\n  return Effect.runPromise(\n    effect.pipe(\n      Effect.catchAllCause((cause) => {\n        const prettyError = Cause.pretty(cause)\n        return Effect.die(new Error(prettyError))\n      })\n    )\n  ) as Promise<A>\n}\n\nconst server = new McpServer({\n  name: 'claude-sessions-mcp',\n  version: '0.4.0',\n})\n\n// List all projects\nserver.tool('list_projects', 'List all Claude Code projects with session counts', {}, async () => {\n  const result = await runEffect(session.listProjects)\n  return {\n    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n  }\n})\n\n// List sessions in a project\nserver.tool(\n  'list_sessions',\n  'List all sessions in a project',\n  {\n    project_name: z.string().describe(\"Project folder name (e.g., '-Users-young-works-myproject')\"),\n  },\n  async ({ project_name }) => {\n    const result = await runEffect(session.listSessions(project_name))\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Rename session\nserver.tool(\n  'rename_session',\n  'Rename a session by adding a title prefix to the first message',\n  {\n    project_name: z.string().describe('Project folder name'),\n    session_id: z.string().describe('Session ID (filename without .jsonl)'),\n    new_title: z.string().describe('New title to add as prefix'),\n  },\n  async ({ project_name, session_id, new_title }) => {\n    const result = await runEffect(session.renameSession(project_name, session_id, new_title))\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Delete session\nserver.tool(\n  'delete_session',\n  'Delete a session (moves to .bak folder for recovery)',\n  {\n    project_name: z.string().describe('Project folder name'),\n    session_id: z.string().describe('Session ID to delete'),\n  },\n  async ({ project_name, session_id }) => {\n    const result = await runEffect(session.deleteSession(project_name, session_id))\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Delete message\nserver.tool(\n  'delete_message',\n  'Delete a message from a session and repair the parentUuid chain',\n  {\n    project_name: z.string().describe('Project folder name'),\n    session_id: z.string().describe('Session ID'),\n    message_uuid: z.string().describe('UUID of the message to delete'),\n  },\n  async ({ project_name, session_id, message_uuid }) => {\n    const result = await runEffect(session.deleteMessage(project_name, session_id, message_uuid))\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Preview cleanup\nserver.tool(\n  'preview_cleanup',\n  'Preview sessions that would be cleaned (empty and invalid API key sessions)',\n  {\n    project_name: z.string().optional().describe('Optional: filter by project name'),\n  },\n  async ({ project_name }) => {\n    const result = await runEffect(session.previewCleanup(project_name))\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Clear sessions\nserver.tool(\n  'clear_sessions',\n  'Delete all empty sessions and invalid API key sessions',\n  {\n    project_name: z.string().optional().describe('Optional: filter by project name'),\n    clear_empty: z.boolean().default(true).describe('Clear empty sessions (default: true)'),\n    clear_invalid: z\n      .boolean()\n      .default(true)\n      .describe('Clear invalid API key sessions (default: true)'),\n    clear_orphan_agents: z\n      .boolean()\n      .default(true)\n      .describe('Clear orphan agent files whose session no longer exists (default: true)'),\n  },\n  async ({ project_name, clear_empty, clear_invalid, clear_orphan_agents }) => {\n    const result = await runEffect(\n      session.clearSessions({\n        projectName: project_name,\n        clearEmpty: clear_empty,\n        clearInvalid: clear_invalid,\n        clearOrphanAgents: clear_orphan_agents,\n      })\n    )\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Get changed files from a session\nserver.tool(\n  'get_session_files',\n  'Get list of all files changed in a session (from file-history-snapshot and tool_use)',\n  {\n    project_name: z.string().describe('Project folder name'),\n    session_id: z.string().describe('Session ID'),\n  },\n  async ({ project_name, session_id }) => {\n    const result = await runEffect(session.getSessionFiles(project_name, session_id))\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Analyze session for optimization insights\nserver.tool(\n  'analyze_session',\n  'Analyze a session to get statistics, tool usage, patterns, and optimization insights',\n  {\n    project_name: z.string().describe('Project folder name'),\n    session_id: z.string().describe('Session ID'),\n  },\n  async ({ project_name, session_id }) => {\n    const result = await runEffect(session.analyzeSession(project_name, session_id))\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Summarize session into user/assistant conversation format\nserver.tool(\n  'summarize_session',\n  'Summarize a session into compact user/assistant conversation format with timestamps',\n  {\n    project_name: z.string().describe('Project folder name'),\n    session_id: z.string().describe('Session ID'),\n    limit: z.number().default(50).describe('Maximum number of messages to include (default: 50)'),\n    max_length: z\n      .number()\n      .default(100)\n      .describe('Maximum length for each message content (default: 100)'),\n  },\n  async ({ project_name, session_id, limit, max_length }) => {\n    const result = await runEffect(\n      session.summarizeSession(project_name, session_id, {\n        limit,\n        maxLength: max_length,\n      })\n    )\n    return {\n      content: [{ type: 'text', text: result.formatted }],\n    }\n  }\n)\n\n// Compress session to reduce file size\nserver.tool(\n  'compress_session',\n  'Compress a session by removing redundant snapshots and truncating long tool outputs',\n  {\n    project_name: z.string().describe('Project folder name'),\n    session_id: z.string().describe('Session ID'),\n    keep_snapshots: z\n      .enum(['first_last', 'all', 'none'])\n      .default('first_last')\n      .describe('Which snapshots to keep: first_last (default), all, or none'),\n    max_tool_output_length: z\n      .number()\n      .default(0)\n      .describe('Truncate tool outputs longer than this (0 = no limit)'),\n  },\n  async ({ project_name, session_id, keep_snapshots, max_tool_output_length }) => {\n    const result = await runEffect(\n      session.compressSession(project_name, session_id, {\n        keepSnapshots: keep_snapshots,\n        maxToolOutputLength: max_tool_output_length,\n      })\n    )\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Extract project knowledge from sessions\nserver.tool(\n  'extract_project_knowledge',\n  'Extract patterns, hot files, workflows, and decisions from project sessions',\n  {\n    project_name: z.string().describe('Project folder name'),\n    session_ids: z\n      .array(z.string())\n      .optional()\n      .describe('Optional: specific session IDs to analyze (default: all sessions)'),\n  },\n  async ({ project_name, session_ids }) => {\n    const result = await runEffect(session.extractProjectKnowledge(project_name, session_ids))\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Split session\nserver.tool(\n  'split_session',\n  'Split a session at a specific message, creating a new session with messages from that point onwards',\n  {\n    project_name: z.string().describe('Project folder name'),\n    session_id: z.string().describe('Session ID to split'),\n    message_uuid: z\n      .string()\n      .describe(\n        'UUID of the message where the split starts (this message becomes the first message of the new session)'\n      ),\n  },\n  async ({ project_name, session_id, message_uuid }) => {\n    const result = await runEffect(session.splitSession(project_name, session_id, message_uuid))\n    return {\n      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n    }\n  }\n)\n\n// Start GUI\nlet webServerInstance: WebServer | null = null\n\nserver.tool(\n  'start_gui',\n  'Start the web GUI for session management and open it in browser',\n  {\n    port: z.number().default(5173).describe('Port to run the web server on (default: 5173)'),\n    open_browser: z\n      .boolean()\n      .default(true)\n      .describe('Whether to open browser automatically (default: true)'),\n    restart: z\n      .boolean()\n      .default(false)\n      .describe('Restart the server if already running (default: false)'),\n    editor: z.string().optional().describe('Editor command to open files (default: code)'),\n    home: z\n      .string()\n      .optional()\n      .describe('Home directory for ~ expansion (default: system homedir)'),\n    project: z\n      .string()\n      .optional()\n      .describe('Current project name for priority sorting in project list'),\n  },\n  async ({ port, open_browser, restart, editor, home, project }) => {\n    try {\n      if (webServerInstance) {\n        if (restart) {\n          await stopWebServer(webServerInstance)\n          webServerInstance = null\n        } else {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: JSON.stringify(\n                  {\n                    success: true,\n                    message: 'Web GUI is already running',\n                    url: `http://localhost:${port}`,\n                  },\n                  null,\n                  2\n                ),\n              },\n            ],\n          }\n        }\n      }\n\n      webServerInstance = await startWebServer({\n        port,\n        openBrowser: open_browser,\n        editor,\n        home,\n        project,\n      })\n\n      return {\n        content: [\n          {\n            type: 'text',\n            text: JSON.stringify(\n              {\n                success: true,\n                message: 'Web GUI started successfully',\n                url: `http://localhost:${port}`,\n                pid: process.pid,\n              },\n              null,\n              2\n            ),\n          },\n        ],\n      }\n    } catch (error) {\n      return {\n        content: [\n          {\n            type: 'text',\n            text: JSON.stringify(\n              {\n                success: false,\n                error: String(error),\n              },\n              null,\n              2\n            ),\n          },\n        ],\n      }\n    }\n  }\n)\n\n// Stop GUI\nserver.tool('stop_gui', 'Stop the web GUI server', {}, async () => {\n  if (webServerInstance) {\n    const port = webServerInstance.port\n    // Call shutdown API first for graceful shutdown\n    try {\n      await fetch(`http://localhost:${port}/api/shutdown`, { method: 'POST' })\n    } catch {\n      // Server might already be stopping\n    }\n    // Then kill the process if still running\n    await stopWebServer(webServerInstance)\n    webServerInstance = null\n    return {\n      content: [\n        {\n          type: 'text',\n          text: JSON.stringify({ success: true, message: 'Web GUI stopped successfully' }, null, 2),\n        },\n      ],\n    }\n  }\n  return {\n    content: [\n      {\n        type: 'text',\n        text: JSON.stringify({ success: true, message: 'Web GUI was not running' }, null, 2),\n      },\n    ],\n  }\n})\n\n// Main entry\nasync function main() {\n  const transport = new StdioServerTransport()\n  await server.connect(transport)\n}\n\nmain().catch(console.error)\n","/**\n * Web server management for MCP\n * Launches @claude-sessions/web\n */\nimport { spawn, type ChildProcess } from 'node:child_process'\nimport { dirname, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { existsSync } from 'node:fs'\n\nconst __dirname = dirname(fileURLToPath(import.meta.url))\n\nexport interface WebServer {\n  process: ChildProcess\n  port: number\n}\n\nexport interface WebServerOptions {\n  port?: number\n  openBrowser?: boolean\n  editor?: string\n  home?: string\n  project?: string\n}\n\nexport async function startWebServer(options: WebServerOptions = {}): Promise<WebServer> {\n  const { port = 5173, openBrowser = true, editor, home, project } = options\n\n  // Try local build first, fallback to npx\n  const localCliPath = resolve(__dirname, '../../web/dist/cli.js')\n  const useLocal = existsSync(localCliPath)\n\n  // Build CLI arguments\n  const cliArgs = ['--port', String(port)]\n  if (editor) {\n    cliArgs.push('--editor', editor)\n  }\n  if (home) {\n    cliArgs.push('--home', home)\n  }\n  if (project) {\n    cliArgs.push('--project', project)\n  }\n\n  const child = useLocal\n    ? spawn('node', [localCliPath, ...cliArgs], {\n        stdio: ['ignore', 'pipe', 'pipe'],\n        env: { ...process.env },\n      })\n    : spawn('npx', ['@claude-sessions/web@latest', ...cliArgs], {\n        stdio: ['ignore', 'pipe', 'pipe'],\n        env: { ...process.env },\n      })\n\n  // Wait for server to start\n  await new Promise<void>((resolve, reject) => {\n    const timeout = setTimeout(() => reject(new Error('Server startup timeout')), 30000)\n\n    child.stdout?.on('data', (data: Buffer) => {\n      const output = data.toString()\n      // SvelteKit adapter-node outputs \"Listening on http://0.0.0.0:PORT\"\n      if (\n        output.includes('Listening on') ||\n        output.includes('localhost') ||\n        output.includes('Local:')\n      ) {\n        clearTimeout(timeout)\n        resolve()\n      }\n    })\n\n    child.stderr?.on('data', (data: Buffer) => {\n      const output = data.toString()\n      // npm/npx progress output goes to stderr\n      if (output.includes('Listening on') || output.includes('localhost')) {\n        clearTimeout(timeout)\n        resolve()\n      }\n    })\n\n    child.on('error', (err) => {\n      clearTimeout(timeout)\n      reject(err)\n    })\n\n    child.on('exit', (code) => {\n      if (code !== 0) {\n        clearTimeout(timeout)\n        reject(new Error(`Server exited with code ${code}`))\n      }\n    })\n  })\n\n  // Open browser if requested\n  if (openBrowser) {\n    const url = `http://localhost:${port}`\n    const openCmd =\n      process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open'\n    spawn(openCmd, [url], { stdio: 'ignore', detached: true }).unref()\n  }\n\n  return { process: child, port }\n}\n\nexport async function stopWebServer(server: WebServer): Promise<void> {\n  server.process.kill('SIGTERM')\n}\n"],"mappings":"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","names":["resolve","server"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-sessions-mcp",
-  "version": "0.4.0",
+  "version": "0.4.1-beta.0",
   "description": "MCP server for managing Claude Code conversation sessions",
   "type": "module",
   "license": "MIT",
@@ -30,20 +30,23 @@
     "dist"
   ],
   "dependencies": {
-    "@claude-sessions/core": "^0.1.0",
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "effect": "^3.12.0",
-    "zod": "^3.24.0"
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "effect": "^3.19.14",
+    "zod": "^4.3.5",
+    "@claude-sessions/core": "0.4.1-beta.0"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
+    "@types/node": "^25.0.9",
     "tsup": "^8.3.0",
     "tsx": "^4.19.0",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.17"
   },
   "scripts": {
     "build": "tsup",
     "dev": "tsx watch src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src"
   }