@midscene/core 1.9.4 → 1.9.5-beta-20260611033424.0

package/dist/types/agent/tasks.d.ts

@@ -44,6 +44,19 @@ export declare class TaskExecutor {
     });
     private createExecutionSession;
     private getActionSpace;
+    /**
+     * Set the pending feedback message consumed by the next planning round.
+     * The message is always prefixed with the current time. When a body is
+     * provided it is appended after the timestamp; otherwise only the time
+     * context is recorded. This is the single entry point for writing
+     * `pendingFeedbackMessage` so the time prefix stays consistent.
+     */
+    private setPendingFeedbackMessage;
+    /**
+     * Collect feedback produced by executed tasks for the next planning round.
+     * Returns undefined when no task reported feedback.
+     */
+    private collectPlanningFeedback;
     /**
      * Get a readable time string. When device time is enabled, use the
      * device-formatted wall-clock time directly so host timezone formatting does

package/dist/types/device/index.d.ts

@@ -1,5 +1,5 @@
 import type { ModelRuntime } from '../ai-model/models';
-import type { ActionScrollParam, DeviceAction, LocateResultElement } from '../types';
+import type { ActionScrollParam, DeviceAction, ExecutorContext, LocateResultElement } from '../types';
 import type { ElementNode } from '@midscene/shared/extractor';
 import { z } from 'zod';
 import type { ElementCacheFeature, Rect, Size } from '../types';
@@ -173,7 +173,7 @@ export declare const defineAction: <TSchema extends z.ZodType | undefined = unde
     description: string;
     interfaceAlias?: string;
     paramSchema?: TSchema;
-    call: (param: TRuntime) => Promise<TReturn> | TReturn;
+    call: (param: TRuntime, context?: ExecutorContext) => Promise<TReturn> | TReturn;
 } & Partial<Omit<DeviceAction<TRuntime, TReturn>, "name" | "description" | "interfaceAlias" | "paramSchema" | "call">>) => DeviceAction<TRuntime, TReturn>;
 export declare const actionTapParamSchema: z.ZodObject<{
     locate: z.ZodObject<{

package/dist/types/types.d.ts

@@ -319,6 +319,11 @@ export interface ExecutionTaskReturn<TaskOutput = unknown, TaskLog = unknown> {
 export type ExecutionTask<E extends ExecutionTaskApply<any, any, any> = ExecutionTaskApply<any, any, any>> = E & ExecutionTaskReturn<E extends ExecutionTaskApply<any, any, infer TaskOutput, any> ? TaskOutput : unknown, E extends ExecutionTaskApply<any, any, any, infer TaskLog> ? TaskLog : unknown> & {
     taskId: string;
     status: 'pending' | 'running' | 'finished' | 'failed' | 'cancelled';
+    /**
+     * Optional feedback produced by a task for the next planning round.
+     * This is execution metadata, not part of the action return value.
+     */
+    planningFeedback?: string;
     error?: Error;
     errorMessage?: string;
     errorStack?: string;
@@ -464,7 +469,7 @@ export interface DeviceAction<TParam = any, TReturn = any> {
     description?: string;
     interfaceAlias?: string;
     paramSchema?: z.ZodType<TParam>;
-    call: (param: TParam, context: ExecutorContext) => Promise<TReturn> | TReturn;
+    call: (param: TParam, context?: ExecutorContext) => Promise<TReturn> | TReturn;
     delayBeforeRunner?: number;
     delayAfterRunner?: number;
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@midscene/core",
   "description": "Automate browser actions, extract data, and perform assertions using AI. It offers JavaScript SDK, Chrome extension, and support for scripting in YAML. See https://midscenejs.com/ for details.",
-  "version": "1.9.4",
+  "version": "1.9.5-beta-20260611033424.0",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "main": "./dist/lib/index.js",
@@ -99,7 +99,7 @@
     "semver": "7.5.2",
     "undici": "^6.0.0",
     "zod": "^3.25.1",
-    "@midscene/shared": "1.9.4"
+    "@midscene/shared": "1.9.5-beta-20260611033424.0"
   },
   "devDependencies": {
     "@rslib/core": "^0.18.3",