@midscene/shared 1.0.1-beta-20251208071759.0 → 1.0.1-beta-20251208075922.0

package/dist/types/mcp/base-tools.d.ts

@@ -1,8 +1,12 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { BaseAgent, BaseDevice, IMidsceneTools, ToolDefinition } from './types';
-export declare abstract class BaseMidsceneTools implements IMidsceneTools {
+/**
+ * Base class for platform-specific MCP tools
+ * Generic type TAgent allows subclasses to use their specific agent types
+ */
+export declare abstract class BaseMidsceneTools<TAgent extends BaseAgent = BaseAgent> implements IMidsceneTools {
     protected mcpServer?: McpServer;
-    protected agent?: BaseAgent;
+    protected agent?: TAgent;
     protected toolDefinitions: ToolDefinition[];
     /**
      * Ensure agent is initialized and ready for use.
@@ -11,7 +15,7 @@ export declare abstract class BaseMidsceneTools implements IMidsceneTools {
      * @returns Promise resolving to initialized agent instance
      * @throws Error if agent initialization fails
      */
-    protected abstract ensureAgent(initParam?: string): Promise<BaseAgent>;
+    protected abstract ensureAgent(initParam?: string): Promise<TAgent>;
     /**
      * Optional: prepare platform-specific tools (e.g., device connection)
      */

package/dist/types/mcp/types.d.ts

@@ -72,6 +72,7 @@ export interface ActionSpaceItem {
 /**
  * Base agent interface
  * Represents a platform-specific agent (Android, iOS, Web)
+ * Note: Return types use `unknown` for compatibility with platform-specific implementations
  */
 export interface BaseAgent {
     getActionSpace(): Promise<ActionSpaceItem[]>;
@@ -79,8 +80,8 @@ export interface BaseAgent {
     page?: {
         screenshotBase64(): Promise<string>;
     };
-    aiAction?: (description: string, params?: Record<string, unknown>) => Promise<void>;
-    aiWaitFor?: (assertion: string, options: Record<string, unknown>) => Promise<void>;
+    aiAction?: (description: string, params?: Record<string, unknown>) => Promise<unknown>;
+    aiWaitFor?: (assertion: string, options: Record<string, unknown>) => Promise<unknown>;
 }
 /**
  * Base device interface for temporary device instances

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/shared",
-  "version": "1.0.1-beta-20251208071759.0",
+  "version": "1.0.1-beta-20251208075922.0",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "types": "./dist/types/index.d.ts",

package/src/mcp/base-tools.ts

@@ -15,9 +15,15 @@ import type {
 
 const debug = getDebug('mcp:base-tools');
 
-export abstract class BaseMidsceneTools implements IMidsceneTools {
+/**
+ * Base class for platform-specific MCP tools
+ * Generic type TAgent allows subclasses to use their specific agent types
+ */
+export abstract class BaseMidsceneTools<TAgent extends BaseAgent = BaseAgent>
+  implements IMidsceneTools
+{
   protected mcpServer?: McpServer;
-  protected agent?: BaseAgent;
+  protected agent?: TAgent;
   protected toolDefinitions: ToolDefinition[] = [];
 
   /**
@@ -27,7 +33,7 @@ export abstract class BaseMidsceneTools implements IMidsceneTools {
    * @returns Promise resolving to initialized agent instance
    * @throws Error if agent initialization fails
    */
-  protected abstract ensureAgent(initParam?: string): Promise<BaseAgent>;
+  protected abstract ensureAgent(initParam?: string): Promise<TAgent>;
 
   /**
    * Optional: prepare platform-specific tools (e.g., device connection)

package/src/mcp/types.ts

@@ -72,6 +72,7 @@ export interface ActionSpaceItem {
 /**
  * Base agent interface
  * Represents a platform-specific agent (Android, iOS, Web)
+ * Note: Return types use `unknown` for compatibility with platform-specific implementations
  */
 export interface BaseAgent {
   getActionSpace(): Promise<ActionSpaceItem[]>;
@@ -82,11 +83,11 @@ export interface BaseAgent {
   aiAction?: (
     description: string,
     params?: Record<string, unknown>,
-  ) => Promise<void>;
+  ) => Promise<unknown>;
   aiWaitFor?: (
     assertion: string,
     options: Record<string, unknown>,
-  ) => Promise<void>;
+  ) => Promise<unknown>;
 }
 
 /**