@hcu-lab.me/mcp-device 1.0.0

package/dist/utils/withTimeout.js

@@ -0,0 +1,85 @@
+/**
+ * Executes a promise with a timeout. If the promise doesn't resolve or reject within
+ * the specified timeout, returns the provided default value.
+ *
+ * @param operation The promise to execute
+ * @param timeoutMs Timeout in milliseconds
+ * @param operationName Name of the operation (for logs)
+ * @param defaultValue Value to return if the operation times out
+ * @returns Promise that resolves with the operation result or the default value on timeout
+ */
+export function withTimeout(operation, timeoutMs, operationName, defaultValue) {
+    // Don't sanitize operation name for logs - only telemetry will sanitize if needed
+    return new Promise((resolve, reject) => {
+        let isCompleted = false;
+        // Set up timeout
+        const timeoutId = setTimeout(() => {
+            if (!isCompleted) {
+                isCompleted = true;
+                if (defaultValue !== null) {
+                    resolve(defaultValue);
+                }
+                else {
+                    // Keep the original operation name in the error message
+                    // Telemetry sanitization happens at the capture level
+                    reject(`__ERROR__: ${operationName} timed out after ${timeoutMs / 1000} seconds`);
+                }
+            }
+        }, timeoutMs);
+        // Execute the operation
+        operation
+            .then(result => {
+            if (!isCompleted) {
+                isCompleted = true;
+                clearTimeout(timeoutId);
+                resolve(result);
+            }
+        })
+            .catch(error => {
+            if (!isCompleted) {
+                isCompleted = true;
+                clearTimeout(timeoutId);
+                if (defaultValue !== null) {
+                    resolve(defaultValue);
+                }
+                else {
+                    // Pass the original error unchanged - sanitization for telemetry happens in capture
+                    reject(error);
+                }
+            }
+        });
+    });
+}
+/**
+ * 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

@@ -0,0 +1 @@
+export declare const VERSION = "0.2.46";

package/dist/version.js

@@ -0,0 +1 @@
+export const VERSION = '0.2.46';

package/package.json

@@ -0,0 +1,131 @@
+{
+  "name": "@hcu-lab.me/mcp-device",
+  "version": "1.0.0",
+  "description": "MCP Device securely connects a user-owned computer to an authenticated Model Context Protocol gateway.",
+  "license": "MIT",
+  "author": "Hirohimeow",
+  "homepage": "https://github.com/Hiroshimeow/agent-mcp-device",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Hiroshimeow/agent-mcp-device.git"
+  },
+  "bugs": "https://github.com/Hiroshimeow/agent-mcp-device/issues",
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bin": {
+    "mcp-device": "dist/mcp-device.js",
+    "md": "dist/mcp-device.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "device:install": "cd src/device && npm install",
+    "device:start": "tsx src/device/device.ts",
+    "device:start:dev": "nodemon --watch src/device --exec tsx src/device/device.ts",
+    "sync-version": "node scripts/sync-version.js",
+    "bump": "node scripts/sync-version.js --bump",
+    "bump:minor": "node scripts/sync-version.js --bump --minor",
+    "bump:major": "node scripts/sync-version.js --bump --major",
+    "build": "shx rm -rf dist/remote-device && shx rm -f dist/device/desktop-commander-integration.js dist/device/desktop-commander-integration.d.ts && tsc && shx chmod +x dist/*.js && shx mkdir -p dist/data && shx cp src/data/onboarding-prompts.json dist/data/ && node scripts/copy-official-ca.cjs && node scripts/build-ui-runtime.cjs",
+    "watch": "tsc --watch",
+    "start": "node dist/mcp-device.js",
+    "start:debug": "node --inspect-brk=9229 dist/mcp-device.js",
+    "prepack": "node scripts/verify-production-trust.cjs && shx rm -rf dist/remote-device && shx rm -f dist/device/desktop-commander-integration.js dist/device/desktop-commander-integration.d.ts dist/hcu-device.js dist/hcu-device.d.ts dist/track-installation.js dist/setup-claude-server.js dist/uninstall-claude-server.js dist/npm-scripts/setup.js dist/npm-scripts/setup.d.ts dist/npm-scripts/uninstall.js dist/npm-scripts/uninstall.d.ts dist/npm-scripts/verify-ripgrep.js dist/npm-scripts/verify-ripgrep.d.ts",
+    "prepare": "npm run build",
+    "clean": "shx rm -rf dist",
+    "test": "npm run build && node test/run-all-tests.js",
+    "test:integration": "npm run build && node test/integration/run-all-integration-tests.js",
+    "test:debug": "node --inspect test/run-all-tests.js",
+    "link:local": "npm run build && npm link",
+    "unlink:local": "npm unlink",
+    "inspector": "npx @modelcontextprotocol/inspector dist/index.js",
+    "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",
+    "logs:export": "npm run build && node scripts/export-fuzzy-logs.js",
+    "count-tokens": "npm run build && node scripts/count-tokens.js",
+    "count-tokens:json": "npm run build && node scripts/count-tokens.js --json"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "terminal",
+    "claude",
+    "ai",
+    "command-line",
+    "process-management",
+    "file-editing",
+    "code-editing",
+    "diff",
+    "patch",
+    "block-editing",
+    "file-system",
+    "text-manipulation",
+    "code-modification",
+    "surgical-edits",
+    "file-operations"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.9.0",
+    "@opendocsg/pdf2md": "^0.2.2",
+    "@tiptap/core": "^3.31.3",
+    "@tiptap/extension-image": "^3.31.3",
+    "@tiptap/extension-table": "^3.31.3",
+    "@tiptap/extension-table-cell": "^3.31.3",
+    "@tiptap/extension-table-header": "^3.31.3",
+    "@tiptap/extension-table-row": "^3.31.3",
+    "@tiptap/pm": "^3.31.3",
+    "@tiptap/starter-kit": "^3.31.3",
+    "@vscode/ripgrep": "^1.15.9",
+    "cross-fetch": "^4.1.0",
+    "exceljs": "^4.4.0",
+    "fastest-levenshtein": "^1.0.16",
+    "file-type": "^21.1.1",
+    "highlight.js": "^11.11.1",
+    "isbinaryfile": "^5.0.4",
+    "markdown-it": "^14.1.0",
+    "md-to-pdf": "^5.2.5",
+    "open": "^10.2.0",
+    "pdf-lib": "^1.17.1",
+    "pizzip": "^3.2.0",
+    "proxy-agent": "6.5.0",
+    "proxy-from-env": "2.1.0",
+    "qrcode-terminal": "^0.12.0",
+    "remark": "^15.0.1",
+    "remark-gfm": "^4.0.1",
+    "remark-parse": "^11.0.0",
+    "sharp": "^0.35.4",
+    "tiptap-markdown": "^0.9.0",
+    "unified": "^11.0.5",
+    "unpdf": "^1.4.0",
+    "ws": "^8.18.3",
+    "zod": "^3.24.1",
+    "zod-to-json-schema": "^3.23.5"
+  },
+  "optionalDependencies": {
+    "caffeinate": "^1.0.1"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/ext-apps": "^1.0.1",
+    "@types/node": "^20.17.24",
+    "@types/ws": "^8.18.1",
+    "commander": "^13.1.0",
+    "esbuild": "^0.27.2",
+    "js-tiktoken": "^1.0.21",
+    "jsdom": "^24.1.3",
+    "nodemon": "^3.0.2",
+    "shx": "^0.3.4",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.3.3"
+  },
+  "overrides": {
+    "@mapbox/node-pre-gyp": "^2.0.3",
+    "exceljs": {
+      "uuid": "^11.1.1"
+    }
+  }
+}