@midscene/shared 1.7.6-beta-20260425023224.0 → 1.7.6

package/dist/es/mcp/base-tools.mjs

@@ -61,10 +61,10 @@ class BaseMidsceneTools {
         return [];
     }
     getCliReportSessionName() {}
-    createNewCliReportSession() {
+    createNewCliReportSession(targetIdentity) {
         const sessionName = this.getCliReportSessionName();
         if (!sessionName) return;
-        return generateCliReportSession(sessionName);
+        return generateCliReportSession(sessionName, targetIdentity);
     }
     commitCliReportSession(session) {
         if (session) writeCliReportSession(session);
@@ -74,6 +74,16 @@ class BaseMidsceneTools {
         if (!sessionName) return;
         return readCliReportSession(sessionName)?.reportFileName;
     }
+    readCliReportAgentOptions() {
+        const reportFileName = this.readCliReportFileName();
+        if (!reportFileName) return;
+        return {
+            reportFileName,
+            reportAttributes: {
+                'data-group-id': reportFileName
+            }
+        };
+    }
     async initTools() {
         this.toolDefinitions = [];
         const platformTools = this.preparePlatformTools();

package/dist/es/mcp/cli-report-session.mjs

@@ -5,6 +5,10 @@ const sessionDirName = 'cli-report-session';
 function sanitizeSessionName(sessionName) {
     return sessionName.replace(/[^a-zA-Z0-9._-]/g, '_') || 'default';
 }
+function sanitizeFileSegment(segment) {
+    const sanitized = segment.replace(/[^a-zA-Z0-9._-]/g, '_') || 'unknown';
+    return sanitized.slice(0, 80);
+}
 function ensureHtmlFileName(reportFileName) {
     return reportFileName.endsWith('.html') ? reportFileName : `${reportFileName}.html`;
 }
@@ -35,12 +39,16 @@ function getCliReportSessionDir() {
 function getCliReportSessionPath(sessionName) {
     return join(getCliReportSessionDir(), `${sanitizeSessionName(sessionName)}.json`);
 }
-function generateCliReportSession(sessionName) {
-    const reportFileName = `${sanitizeSessionName(sessionName)}-${formatDateForFileName(new Date())}-${randomId()}`;
+function generateCliReportSession(sessionName, targetIdentity) {
+    const identitySegment = targetIdentity ? `-${sanitizeFileSegment(targetIdentity)}` : '';
+    const reportFileName = `${sanitizeSessionName(sessionName)}${identitySegment}-${formatDateForFileName(new Date())}-${randomId()}`;
     const reportPath = join(getMidsceneRunSubDir('report'), ensureHtmlFileName(reportFileName));
     const session = {
         version: 1,
         sessionName,
+        ...targetIdentity ? {
+            targetIdentity
+        } : {},
         reportFileName,
         reportPath,
         createdAt: Date.now()
@@ -50,8 +58,8 @@ function generateCliReportSession(sessionName) {
 function writeCliReportSession(session) {
     writeFileSync(getCliReportSessionPath(session.sessionName), JSON.stringify(session, null, 2), 'utf-8');
 }
-function createCliReportSession(sessionName) {
-    const session = generateCliReportSession(sessionName);
+function createCliReportSession(sessionName, targetIdentity) {
+    const session = generateCliReportSession(sessionName, targetIdentity);
     writeCliReportSession(session);
     return session;
 }

package/dist/lib/mcp/base-tools.js

@@ -89,10 +89,10 @@ class BaseMidsceneTools {
         return [];
     }
     getCliReportSessionName() {}
-    createNewCliReportSession() {
+    createNewCliReportSession(targetIdentity) {
         const sessionName = this.getCliReportSessionName();
         if (!sessionName) return;
-        return (0, external_cli_report_session_js_namespaceObject.generateCliReportSession)(sessionName);
+        return (0, external_cli_report_session_js_namespaceObject.generateCliReportSession)(sessionName, targetIdentity);
     }
     commitCliReportSession(session) {
         if (session) (0, external_cli_report_session_js_namespaceObject.writeCliReportSession)(session);
@@ -102,6 +102,16 @@ class BaseMidsceneTools {
         if (!sessionName) return;
         return (0, external_cli_report_session_js_namespaceObject.readCliReportSession)(sessionName)?.reportFileName;
     }
+    readCliReportAgentOptions() {
+        const reportFileName = this.readCliReportFileName();
+        if (!reportFileName) return;
+        return {
+            reportFileName,
+            reportAttributes: {
+                'data-group-id': reportFileName
+            }
+        };
+    }
     async initTools() {
         this.toolDefinitions = [];
         const platformTools = this.preparePlatformTools();

package/dist/lib/mcp/cli-report-session.js

@@ -36,6 +36,10 @@ const sessionDirName = 'cli-report-session';
 function sanitizeSessionName(sessionName) {
     return sessionName.replace(/[^a-zA-Z0-9._-]/g, '_') || 'default';
 }
+function sanitizeFileSegment(segment) {
+    const sanitized = segment.replace(/[^a-zA-Z0-9._-]/g, '_') || 'unknown';
+    return sanitized.slice(0, 80);
+}
 function ensureHtmlFileName(reportFileName) {
     return reportFileName.endsWith('.html') ? reportFileName : `${reportFileName}.html`;
 }
@@ -66,12 +70,16 @@ function getCliReportSessionDir() {
 function getCliReportSessionPath(sessionName) {
     return (0, external_node_path_namespaceObject.join)(getCliReportSessionDir(), `${sanitizeSessionName(sessionName)}.json`);
 }
-function generateCliReportSession(sessionName) {
-    const reportFileName = `${sanitizeSessionName(sessionName)}-${formatDateForFileName(new Date())}-${randomId()}`;
+function generateCliReportSession(sessionName, targetIdentity) {
+    const identitySegment = targetIdentity ? `-${sanitizeFileSegment(targetIdentity)}` : '';
+    const reportFileName = `${sanitizeSessionName(sessionName)}${identitySegment}-${formatDateForFileName(new Date())}-${randomId()}`;
     const reportPath = (0, external_node_path_namespaceObject.join)((0, external_common_js_namespaceObject.getMidsceneRunSubDir)('report'), ensureHtmlFileName(reportFileName));
     const session = {
         version: 1,
         sessionName,
+        ...targetIdentity ? {
+            targetIdentity
+        } : {},
         reportFileName,
         reportPath,
         createdAt: Date.now()
@@ -81,8 +89,8 @@ function generateCliReportSession(sessionName) {
 function writeCliReportSession(session) {
     (0, external_node_fs_namespaceObject.writeFileSync)(getCliReportSessionPath(session.sessionName), JSON.stringify(session, null, 2), 'utf-8');
 }
-function createCliReportSession(sessionName) {
-    const session = generateCliReportSession(sessionName);
+function createCliReportSession(sessionName, targetIdentity) {
+    const session = generateCliReportSession(sessionName, targetIdentity);
     writeCliReportSession(session);
     return session;
 }

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

@@ -82,9 +82,13 @@ export declare abstract class BaseMidsceneTools<TAgent extends BaseAgent = BaseA
      */
     protected preparePlatformTools(): ToolDefinition[];
     protected getCliReportSessionName(): string | undefined;
-    protected createNewCliReportSession(): CliReportSession | undefined;
+    protected createNewCliReportSession(targetIdentity?: string): CliReportSession | undefined;
     protected commitCliReportSession(session?: CliReportSession): void;
     protected readCliReportFileName(): string | undefined;
+    protected readCliReportAgentOptions(): {
+        reportFileName: string;
+        reportAttributes: Record<string, string>;
+    } | undefined;
     /**
      * Must be implemented by subclasses to create a temporary device instance
      * This allows getting real actionSpace without connecting to device

package/dist/types/mcp/cli-report-session.d.ts

@@ -1,11 +1,12 @@
 export interface CliReportSession {
     version: 1;
     sessionName: string;
+    targetIdentity?: string;
     reportFileName: string;
     reportPath: string;
     createdAt: number;
 }
-export declare function generateCliReportSession(sessionName: string): CliReportSession;
+export declare function generateCliReportSession(sessionName: string, targetIdentity?: string): CliReportSession;
 export declare function writeCliReportSession(session: CliReportSession): void;
-export declare function createCliReportSession(sessionName: string): CliReportSession;
+export declare function createCliReportSession(sessionName: string, targetIdentity?: string): CliReportSession;
 export declare function readCliReportSession(sessionName: string): CliReportSession | undefined;

package/package.json

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

package/src/mcp/base-tools.ts

@@ -200,12 +200,14 @@ export abstract class BaseMidsceneTools<
     return undefined;
   }
 
-  protected createNewCliReportSession(): CliReportSession | undefined {
+  protected createNewCliReportSession(
+    targetIdentity?: string,
+  ): CliReportSession | undefined {
     const sessionName = this.getCliReportSessionName();
     if (!sessionName) {
       return undefined;
     }
-    return generateCliReportSession(sessionName);
+    return generateCliReportSession(sessionName, targetIdentity);
   }
 
   protected commitCliReportSession(session?: CliReportSession): void {
@@ -222,6 +224,24 @@ export abstract class BaseMidsceneTools<
     return readCliReportSession(sessionName)?.reportFileName;
   }
 
+  protected readCliReportAgentOptions():
+    | {
+        reportFileName: string;
+        reportAttributes: Record<string, string>;
+      }
+    | undefined {
+    const reportFileName = this.readCliReportFileName();
+    if (!reportFileName) {
+      return undefined;
+    }
+    return {
+      reportFileName,
+      reportAttributes: {
+        'data-group-id': reportFileName,
+      },
+    };
+  }
+
   /**
    * Must be implemented by subclasses to create a temporary device instance
    * This allows getting real actionSpace without connecting to device

package/src/mcp/cli-report-session.ts

@@ -5,6 +5,7 @@ import { getMidsceneRunBaseDir, getMidsceneRunSubDir } from '../common';
 export interface CliReportSession {
   version: 1;
   sessionName: string;
+  targetIdentity?: string;
   reportFileName: string;
   reportPath: string;
   createdAt: number;
@@ -16,6 +17,11 @@ function sanitizeSessionName(sessionName: string): string {
   return sessionName.replace(/[^a-zA-Z0-9._-]/g, '_') || 'default';
 }
 
+function sanitizeFileSegment(segment: string): string {
+  const sanitized = segment.replace(/[^a-zA-Z0-9._-]/g, '_') || 'unknown';
+  return sanitized.slice(0, 80);
+}
+
 function ensureHtmlFileName(reportFileName: string): string {
   return reportFileName.endsWith('.html')
     ? reportFileName
@@ -58,8 +64,12 @@ function getCliReportSessionPath(sessionName: string): string {
 
 export function generateCliReportSession(
   sessionName: string,
+  targetIdentity?: string,
 ): CliReportSession {
-  const reportFileName = `${sanitizeSessionName(sessionName)}-${formatDateForFileName(new Date())}-${randomId()}`;
+  const identitySegment = targetIdentity
+    ? `-${sanitizeFileSegment(targetIdentity)}`
+    : '';
+  const reportFileName = `${sanitizeSessionName(sessionName)}${identitySegment}-${formatDateForFileName(new Date())}-${randomId()}`;
   const reportPath = join(
     getMidsceneRunSubDir('report'),
     ensureHtmlFileName(reportFileName),
@@ -67,6 +77,7 @@ export function generateCliReportSession(
   const session: CliReportSession = {
     version: 1,
     sessionName,
+    ...(targetIdentity ? { targetIdentity } : {}),
     reportFileName,
     reportPath,
     createdAt: Date.now(),
@@ -82,8 +93,11 @@ export function writeCliReportSession(session: CliReportSession): void {
   );
 }
 
-export function createCliReportSession(sessionName: string): CliReportSession {
-  const session = generateCliReportSession(sessionName);
+export function createCliReportSession(
+  sessionName: string,
+  targetIdentity?: string,
+): CliReportSession {
+  const session = generateCliReportSession(sessionName, targetIdentity);
   writeCliReportSession(session);
   return session;
 }