@wonderwhy-er/desktop-commander 0.2.15 → 0.2.16

package/README.md

@@ -954,7 +954,7 @@ External telemetry (sent to analytics services) is enabled by default but can be
 
 **Note:** This only disables external telemetry. Local usage analytics remain active for tool functionality but is not share externally
 
-For complete details about data collection, please see our [Privacy Policy](PRIVACY.md).
+For complete details about data collection, please see our [Privacy Policy](https://legal.desktopcommander.app/privacy_desktop_commander_mcp).
 
 ## Verifications
 [![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/25ff7a06-58bc-40b8-bd79-ebb715140f1a)

package/dist/handlers/search-handlers.js

@@ -132,6 +132,10 @@ export async function handleGetMoreSearchResults(args) {
         }
         if (results.isComplete) {
             output += `\n✅ Search completed.`;
+            // Warn users if search was incomplete due to permission issues
+            if (results.wasIncomplete) {
+                output += `\n⚠️  Warning: Some files were inaccessible due to permissions. Results may be incomplete.`;
+            }
         }
         return {
             content: [{ type: "text", text: output }],

package/dist/search-manager.d.ts

@@ -18,6 +18,7 @@ export interface SearchSession {
     buffer: string;
     totalMatches: number;
     totalContextLines: number;
+    wasIncomplete?: boolean;
 }
 export interface SearchSessionOptions {
     rootPath: string;
@@ -64,6 +65,7 @@ export interface SearchSessionOptions {
         error?: string;
         hasMoreResults: boolean;
         runtime: number;
+        wasIncomplete?: boolean;
     };
     /**
      * Terminate a search session (like force_terminate)
@@ -105,4 +107,3 @@ export interface SearchSessionOptions {
     private parseLine;
 }
 export declare const searchManager: SearchManager;
-export declare function stopSearchManagerCleanup(): void;

package/dist/search-manager.js

@@ -120,7 +120,8 @@ import { capture } from './utils/capture.js';
                 isError: session.isError && !!session.error?.trim(), // Only error if we have actual errors
                 error: session.error?.trim() || undefined,
                 hasMoreResults: false, // Tail always returns what's available
-                runtime: Date.now() - session.startTime
+                runtime: Date.now() - session.startTime,
+                wasIncomplete: session.wasIncomplete
             };
         }
         // Handle positive offsets (range behavior) - like file reading
@@ -136,7 +137,8 @@ import { capture } from './utils/capture.js';
             isError: session.isError && !!session.error?.trim(), // Only error if we have actual errors
             error: session.error?.trim() || undefined,
             hasMoreResults,
-            runtime: Date.now() - session.startTime
+            runtime: Date.now() - session.startTime,
+            wasIncomplete: session.wasIncomplete
         };
     }
     /**
@@ -149,7 +151,6 @@ import { capture } from './utils/capture.js';
         }
         if (!session.process.killed) {
             session.process.kill('SIGTERM');
-            capture('search_session_terminated', { sessionId });
         }
         // Don't delete session immediately - let user read final results
         // It will be cleaned up by cleanup process
@@ -178,7 +179,6 @@ import { capture } from './utils/capture.js';
         for (const [sessionId, session] of this.sessions) {
             if (session.isComplete && session.lastReadTime < cutoffTime) {
                 this.sessions.delete(sessionId);
-                capture('search_session_cleaned_up', { sessionId });
             }
         }
     }
@@ -289,6 +289,9 @@ import { capture } from './utils/capture.js';
         });
         process.stderr?.on('data', (data) => {
             const errorText = data.toString();
+            // Store error text for potential user display, but don't capture individual errors
+            // We'll capture incomplete search status in the completion event instead
+            session.error = (session.error || '') + errorText;
             // Filter meaningful errors
             const filteredErrors = errorText
                 .split('\n')
@@ -320,6 +323,11 @@ import { capture } from './utils/capture.js';
                 this.processBufferedOutput(session, true);
             }
             session.isComplete = true;
+            // Track if search was incomplete due to access issues
+            // Ripgrep exit code 2 means "some files couldn't be searched"
+            if (code === 2) {
+                session.wasIncomplete = true;
+            }
             // Only treat as error if:
             // 1. Unexpected exit code (not 0, 1, or 2) AND
             // 2. We have meaningful errors after filtering AND
@@ -340,7 +348,8 @@ import { capture } from './utils/capture.js';
                 exitCode: code,
                 totalResults: session.totalMatches + session.totalContextLines,
                 totalMatches: session.totalMatches,
-                runtime: Date.now() - session.startTime
+                runtime: Date.now() - session.startTime,
+                wasIncomplete: session.wasIncomplete || false // NEW: Track incomplete searches
             });
             // Rely on cleanupSessions(maxAge) only; no per-session timer
         });
@@ -348,10 +357,6 @@ import { capture } from './utils/capture.js';
             session.isComplete = true;
             session.isError = true;
             session.error = `Process error: ${error.message}`;
-            capture('search_session_process_error', {
-                sessionId: session.id,
-                error: error.message
-            });
             // Rely on cleanupSessions(maxAge) only; no per-session timer
         });
     }
@@ -462,10 +467,3 @@ function startCleanupIfNeeded() {
         }, 1000);
     }
 }
-// Export cleanup function for graceful shutdown
-export function stopSearchManagerCleanup() {
-    if (cleanupInterval) {
-        clearInterval(cleanupInterval);
-        cleanupInterval = null;
-    }
-}

package/dist/server.js

@@ -117,6 +117,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         - systemInfo (operating system and environment details)
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(GetConfigArgsSchema),
+                    annotations: {
+                        title: "Get Configuration",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "set_config_value",
@@ -139,6 +143,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(SetConfigValueArgsSchema),
+                    annotations: {
+                        title: "Set Configuration Value",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: false,
+                    },
                 },
                 // Filesystem tools
                 {
@@ -177,6 +187,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ReadFileArgsSchema),
+                    annotations: {
+                        title: "Read File or URL",
+                        readOnlyHint: true,
+                        openWorldHint: true,
+                    },
                 },
                 {
                     name: "read_multiple_files",
@@ -193,6 +208,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ReadMultipleFilesArgsSchema),
+                    annotations: {
+                        title: "Read Multiple Files",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "write_file",
@@ -226,6 +245,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(WriteFileArgsSchema),
+                    annotations: {
+                        title: "Write File",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: false,
+                    },
                 },
                 {
                     name: "create_directory",
@@ -251,6 +276,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ListDirectoryArgsSchema),
+                    annotations: {
+                        title: "List Directory Contents",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "move_file",
@@ -263,6 +292,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(MoveFileArgsSchema),
+                    annotations: {
+                        title: "Move/Rename File",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: false,
+                    },
                 },
                 {
                     name: "start_search",
@@ -372,6 +407,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(GetMoreSearchResultsArgsSchema),
+                    annotations: {
+                        title: "Get Search Results",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "stop_search",
@@ -399,6 +438,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ListSearchesArgsSchema),
+                    annotations: {
+                        title: "List Active Searches",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "get_file_info",
@@ -418,6 +461,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(GetFileInfoArgsSchema),
+                    annotations: {
+                        title: "Get File Information",
+                        readOnlyHint: true,
+                    },
                 },
                 // Note: list_allowed_directories removed - use get_config to check allowedDirectories
                 // Text editing tools
@@ -457,6 +504,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(EditBlockArgsSchema),
+                    annotations: {
+                        title: "Edit Text Block",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: false,
+                    },
                 },
                 // Terminal tools
                 {
@@ -513,6 +566,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(StartProcessArgsSchema),
+                    annotations: {
+                        title: "Start Terminal Process",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: true,
+                    },
                 },
                 {
                     name: "read_process_output",
@@ -540,6 +599,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ReadProcessOutputArgsSchema),
+                    annotations: {
+                        title: "Read Process Output",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "interact_with_process",
@@ -592,6 +655,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(InteractWithProcessArgsSchema),
+                    annotations: {
+                        title: "Send Input to Process",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: true,
+                    },
                 },
                 {
                     name: "force_terminate",
@@ -600,6 +669,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ForceTerminateArgsSchema),
+                    annotations: {
+                        title: "Force Terminate Process",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: false,
+                    },
                 },
                 {
                     name: "list_sessions",
@@ -618,6 +693,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ListSessionsArgsSchema),
+                    annotations: {
+                        title: "List Terminal Sessions",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "list_processes",
@@ -628,6 +707,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ListProcessesArgsSchema),
+                    annotations: {
+                        title: "List Running Processes",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "kill_process",
@@ -638,6 +721,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(KillProcessArgsSchema),
+                    annotations: {
+                        title: "Kill Process",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: false,
+                    },
                 },
                 {
                     name: "get_usage_stats",
@@ -648,6 +737,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(GetUsageStatsArgsSchema),
+                    annotations: {
+                        title: "Get Usage Statistics",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "give_feedback_to_desktop_commander",

package/dist/tools/config.js

@@ -14,17 +14,7 @@ export async function getConfig() {
         const configWithSystemInfo = {
             ...config,
             currentClient,
-            systemInfo: {
-                platform: systemInfo.platform,
-                platformName: systemInfo.platformName,
-                defaultShell: systemInfo.defaultShell,
-                pathSeparator: systemInfo.pathSeparator,
-                isWindows: systemInfo.isWindows,
-                isMacOS: systemInfo.isMacOS,
-                isLinux: systemInfo.isLinux,
-                docker: systemInfo.docker,
-                examplePaths: systemInfo.examplePaths
-            }
+            systemInfo
         };
         console.error(`getConfig result: ${JSON.stringify(configWithSystemInfo, null, 2)}`);
         return {

package/dist/utils/system-info.d.ts

@@ -29,6 +29,18 @@ export interface SystemInfo {
     isMacOS: boolean;
     isLinux: boolean;
     docker: ContainerInfo;
+    isDXT: boolean;
+    nodeInfo?: {
+        version: string;
+        path: string;
+        npmVersion?: string;
+    };
+    processInfo: {
+        pid: number;
+        arch: string;
+        platform: string;
+        versions: NodeJS.ProcessVersions;
+    };
     examplePaths: {
         home: string;
         temp: string;

package/dist/utils/system-info.js

@@ -305,6 +305,27 @@ function getContainerEnvironment(containerType) {
     }
     return Object.keys(env).length > 0 ? env : undefined;
 }
+/**
+ * Detect Node.js installation and version from current process
+ */
+function detectNodeInfo() {
+    try {
+        // Get Node.js version from current process
+        const version = process.version.replace('v', ''); // Remove 'v' prefix
+        // Get Node.js executable path from current process
+        const path = process.execPath;
+        // Get npm version from environment if available
+        const npmVersion = process.env.npm_version;
+        return {
+            version,
+            path,
+            ...(npmVersion && { npmVersion })
+        };
+    }
+    catch (error) {
+        return undefined;
+    }
+}
 /**
  * Get comprehensive system information for tool prompts
  */
@@ -397,6 +418,15 @@ export function getSystemInfo() {
             examplePaths.accessible = mountPoints.map(mount => mount.containerPath);
         }
     }
+    // Detect Node.js installation from current process
+    const nodeInfo = detectNodeInfo();
+    // Get process information
+    const processInfo = {
+        pid: process.pid,
+        arch: process.arch,
+        platform: process.platform,
+        versions: process.versions
+    };
     return {
         platform,
         platformName,
@@ -415,6 +445,9 @@ export function getSystemInfo() {
             mountPoints,
             containerEnvironment: getContainerEnvironment(containerDetection.containerType)
         },
+        isDXT: !!process.env.MCP_DXT,
+        nodeInfo,
+        processInfo,
         examplePaths
     };
 }
@@ -545,33 +578,51 @@ LINUX-SPECIFIC NOTES:
  * Get common development tool guidance based on OS
  */
 export function getDevelopmentToolGuidance(systemInfo) {
-    const { isWindows, isMacOS, isLinux, platformName } = systemInfo;
+    const { isWindows, isMacOS, isLinux, platformName, nodeInfo, processInfo } = systemInfo;
+    // Add detected Node.js info to guidance
+    const nodeGuidance = nodeInfo
+        ? `Node.js: v${nodeInfo.version} (${nodeInfo.path})${nodeInfo.npmVersion ? ` | npm: v${nodeInfo.npmVersion}` : ''}`
+        : 'Node.js: Not detected';
+    // Add process environment info
+    const envInfo = `
+Current Process Environment:
+- Node: v${processInfo.versions.node}
+- V8: v${processInfo.versions.v8}
+- Architecture: ${processInfo.arch}
+- Platform: ${processInfo.platform}
+- Process ID: ${processInfo.pid}`;
     if (isWindows) {
         return `
 COMMON WINDOWS DEVELOPMENT TOOLS:
-- Node.js: Usually installed globally, accessible from any shell
+- ${nodeGuidance}
 - Python: May be 'python' or 'py' command, check both
 - Git: Git Bash provides Unix-like environment
 - WSL: Windows Subsystem for Linux available for Unix tools
-- Visual Studio tools: cl, msbuild for C++ compilation`;
+- Visual Studio tools: cl, msbuild for C++ compilation
+
+${envInfo}`;
     }
     else if (isMacOS) {
         return `
 COMMON MACOS DEVELOPMENT TOOLS:
 - Xcode Command Line Tools: Required for many development tools
 - Homebrew: Primary package manager for development tools
+- ${nodeGuidance}
 - Python: Usually python3, check if python points to Python 2
-- Node.js: Available via brew or direct installer
-- Ruby: System Ruby available, rbenv/rvm for version management`;
+- Ruby: System Ruby available, rbenv/rvm for version management
+
+${envInfo}`;
     }
     else {
         return `
 COMMON LINUX DEVELOPMENT TOOLS:
 - Package managers: Install tools via distribution package manager
 - Python: Usually python3, python may point to Python 2
-- Node.js: Available via package manager or NodeSource repository
+- ${nodeGuidance}
 - Build tools: gcc, make typically available or easily installed
-- Container tools: docker, podman common for development`;
+- Container tools: docker, podman common for development
+
+${envInfo}`;
     }
 }
 /**

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.2.15";
+export declare const VERSION = "0.2.16";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.2.15';
+export const VERSION = '0.2.16';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wonderwhy-er/desktop-commander",
-  "version": "0.2.15",
+  "version": "0.2.16",
   "description": "MCP server for terminal operations and file editing",
   "mcpName": "io.github.wonderwhy-er/desktop-commander",
   "license": "MIT",
@@ -42,6 +42,7 @@
     "link:local": "npm run build && npm link",
     "unlink:local": "npm unlink",
     "inspector": "npx @modelcontextprotocol/inspector dist/index.js",
+    "build:mcpb": "node scripts/build-mcpb.cjs",
     "logs:view": "npm run build && node scripts/view-fuzzy-logs.js",
     "logs:analyze": "npm run build && node scripts/analyze-fuzzy-logs.js",
     "logs:clear": "npm run build && node scripts/clear-fuzzy-logs.js",