ucu-mcp 0.3.9 → 0.4.2

package/dist/src/safety/guard.js

@@ -233,7 +233,6 @@ export class SafetyGuard {
                 reason: `Rate-limited: ${elapsed}ms since last action (min ${this.rateLimitMs}ms)`,
             };
         }
-        this.lastActionTime = now;
         // 6. User activity pause (skipped for observe-class actions) -----------------
         if (!options.skipUserActivityPause && this.isUserActivityPauseActive()) {
             return {
@@ -241,6 +240,7 @@ export class SafetyGuard {
                 reason: `User activity detected — pausing automation for ${this.userActivityPauseMs}ms`,
             };
         }
+        this.lastActionTime = now;
         return { allowed: true };
     }
     // -----------------------------------------------------------------------

package/dist/src/util/errors.d.ts

@@ -10,13 +10,16 @@ export declare class UcuError extends Error {
     static readonly defaultCode: string;
     readonly code: string;
     readonly retryable: boolean;
-    constructor(message: string, code?: string, retryable?: boolean);
+    /** Optional inline remediation hint surfaced by the platform layer. */
+    readonly hint?: string;
+    constructor(message: string, code?: string, retryable?: boolean, hint?: string);
     /** Serialize for MCP response / JSON.stringify. */
     toJSON(): {
         name: string;
         code: string;
         retryable: boolean;
         message: string;
+        hint?: string;
     };
 }
 /**
@@ -45,7 +48,9 @@ export declare class PermissionError extends UcuError {
  */
 export declare class WindowNotFoundError extends UcuError {
     static readonly defaultCode = "WINDOW_NOT_FOUND";
-    constructor(windowId: string);
+    constructor(windowId: string, options?: {
+        hint?: string;
+    });
 }
 /**
  * Active target window is no longer available.

package/dist/src/util/errors.js

@@ -13,7 +13,9 @@ export class UcuError extends Error {
     static defaultCode = "UCU_ERROR";
     code;
     retryable;
-    constructor(message, code, retryable = false) {
+    /** Optional inline remediation hint surfaced by the platform layer. */
+    hint;
+    constructor(message, code, retryable = false, hint) {
         super(message);
         if (code === undefined) {
             // The default code applied to instances of this class when no explicit code is passed to the constructor.
@@ -23,6 +25,7 @@ export class UcuError extends Error {
         this.name = this.constructor.name;
         this.code = code;
         this.retryable = retryable;
+        this.hint = hint;
     }
     /** Serialize for MCP response / JSON.stringify. */
     toJSON() {
@@ -31,6 +34,7 @@ export class UcuError extends Error {
             code: this.code,
             retryable: this.retryable,
             message: this.message,
+            ...(this.hint && { hint: this.hint }),
         };
     }
 }
@@ -84,8 +88,8 @@ function getPermissionMessage(permission, platform) {
  */
 export class WindowNotFoundError extends UcuError {
     static defaultCode = "WINDOW_NOT_FOUND";
-    constructor(windowId) {
-        super(`Window ${windowId} not found. It may have been closed. Run list_windows to get fresh IDs.`, WindowNotFoundError.defaultCode, false);
+    constructor(windowId, options) {
+        super(`Window ${windowId} not found. It may have been closed. Run list_windows to get fresh IDs.`, WindowNotFoundError.defaultCode, false, options?.hint);
     }
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ucu-mcp",
-  "version": "0.3.9",
+  "version": "0.4.2",
   "description": "MCP server for Universal Computer Use — desktop automation for AI agents via Model Context Protocol",
   "type": "module",
   "bin": {