@wonderwhy-er/desktop-commander 0.2.43 → 0.2.45

package/dist/utils/welcome-onboarding.d.ts

@@ -6,4 +6,4 @@
  * 2. Users in the 'showOnboardingPage' A/B variant
  * 3. Haven't seen it yet
  */
-export declare function handleWelcomePageOnboarding(): Promise<void>;
+export declare function handleWelcomePageOnboarding(clientName?: string): Promise<void>;

package/dist/utils/welcome-onboarding.js

@@ -12,7 +12,7 @@ import { capture } from './capture.js';
  * 2. Users in the 'showOnboardingPage' A/B variant
  * 3. Haven't seen it yet
  */
-export async function handleWelcomePageOnboarding() {
+export async function handleWelcomePageOnboarding(clientName) {
     // Check if this is a new install pending A/B decision
     // This flag is set when config is first created and survives process restarts
     const pending = await configManager.getValue('pendingWelcomeOnboarding');
@@ -48,7 +48,7 @@ export async function handleWelcomePageOnboarding() {
         return;
     }
     try {
-        await openWelcomePage();
+        await openWelcomePage(clientName);
         await configManager.setValue('sawOnboardingPage', true);
         await configManager.setValue('pendingWelcomeOnboarding', false);
         capture('server_welcome_page_opened', { success: true });

package/dist/utils/withTimeout.d.ts

@@ -9,3 +9,20 @@
  * @returns Promise that resolves with the operation result or the default value on timeout
  */
 export declare function withTimeout<T>(operation: Promise<T>, timeoutMs: number, operationName: string, defaultValue: T): Promise<T>;
+/**
+ * Run an operation under a timeout WITH real cancellation.
+ *
+ * Unlike withTimeout (which only races a timer and leaves the underlying work
+ * running — holding its libuv thread/fd until the OS call returns), this passes
+ * an AbortSignal into the operation and aborts it when the timeout fires, so a
+ * read/stream that honors the signal is cancelled and its resources released.
+ *
+ * Rejects with an Error whose `.code` is 'ETIMEDOUT' on timeout (so existing
+ * ETIMEDOUT handling / permission-error mapping keeps working).
+ *
+ * Caveat: an operation wedged inside a single un-interruptible syscall only
+ * observes the abort once that syscall returns; library reads that ignore the
+ * signal (e.g. Excel/PDF parsers) still get the timeout rejection but keep
+ * running in the background until they finish on their own.
+ */
+export declare function runWithAbortableTimeout<T>(operation: (signal: AbortSignal) => Promise<T>, timeoutMs: number, operationName: string): Promise<T>;

package/dist/utils/withTimeout.js

@@ -50,3 +50,36 @@ export function withTimeout(operation, timeoutMs, operationName, defaultValue) {
         });
     });
 }
+/**
+ * Run an operation under a timeout WITH real cancellation.
+ *
+ * Unlike withTimeout (which only races a timer and leaves the underlying work
+ * running — holding its libuv thread/fd until the OS call returns), this passes
+ * an AbortSignal into the operation and aborts it when the timeout fires, so a
+ * read/stream that honors the signal is cancelled and its resources released.
+ *
+ * Rejects with an Error whose `.code` is 'ETIMEDOUT' on timeout (so existing
+ * ETIMEDOUT handling / permission-error mapping keeps working).
+ *
+ * Caveat: an operation wedged inside a single un-interruptible syscall only
+ * observes the abort once that syscall returns; library reads that ignore the
+ * signal (e.g. Excel/PDF parsers) still get the timeout rejection but keep
+ * running in the background until they finish on their own.
+ */
+export function runWithAbortableTimeout(operation, timeoutMs, operationName) {
+    const controller = new AbortController();
+    let timeoutId;
+    const timeout = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            controller.abort();
+            const error = new Error(`${operationName} timed out after ${timeoutMs / 1000} seconds`);
+            error.code = 'ETIMEDOUT';
+            reject(error);
+        }, timeoutMs);
+    });
+    const op = operation(controller.signal);
+    // Swallow the late abort rejection so it can't surface as an unhandled
+    // rejection after the timeout has already settled the race.
+    op.catch(() => { });
+    return Promise.race([op, timeout]).finally(() => clearTimeout(timeoutId));
+}

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.2.43";
+export declare const VERSION = "0.2.45";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.2.43';
+export const VERSION = '0.2.45';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wonderwhy-er/desktop-commander",
-  "version": "0.2.43",
+  "version": "0.2.45",
   "description": "MCP server for terminal operations and file editing",
   "mcpName": "io.github.wonderwhy-er/desktop-commander",
   "license": "MIT",