@midscene/core 1.3.8 → 1.3.9

package/dist/types/ai-model/conversation-history.d.ts

@@ -7,6 +7,7 @@ export declare class ConversationHistory {
     private readonly messages;
     private subGoals;
     private memories;
+    private historicalLogs;
     pendingFeedbackMessage: string;
     constructor(options?: ConversationHistoryOptions);
     resetPendingFeedbackMessageIfExists(): void;
@@ -28,12 +29,14 @@ export declare class ConversationHistory {
      */
     setSubGoals(subGoals: SubGoal[]): void;
     /**
-     * Update a single sub-goal by index
+     * Update a single sub-goal by index.
+     * Clears logs if status or description actually changes.
      * @returns true if the sub-goal was found and updated, false otherwise
      */
     updateSubGoal(index: number, updates: Partial<Omit<SubGoal, 'index'>>): boolean;
     /**
-     * Mark the first pending sub-goal as running
+     * Mark the first pending sub-goal as running.
+     * Clears logs since status changes.
      */
     markFirstPendingAsRunning(): void;
     /**
@@ -43,13 +46,30 @@ export declare class ConversationHistory {
      */
     markSubGoalFinished(index: number): boolean;
     /**
-     * Mark all sub-goals as finished
+     * Mark all sub-goals as finished.
+     * Clears logs for any goal whose status actually changes.
      */
     markAllSubGoalsFinished(): void;
     /**
-     * Convert sub-goals to text representation
+     * Append a log entry to the currently running sub-goal.
+     * The log describes an action performed while working on the sub-goal.
+     */
+    appendSubGoalLog(log: string): void;
+    /**
+     * Convert sub-goals to text representation.
+     * Includes actions performed (logs) for the current sub-goal.
      */
     subGoalsToText(): string;
+    /**
+     * Append a log entry to the historical logs list.
+     * Used in non-deepThink mode to track executed steps across planning rounds.
+     */
+    appendHistoricalLog(log: string): void;
+    /**
+     * Convert historical logs to text representation.
+     * Provides context about previously executed steps to the model.
+     */
+    historicalLogsToText(): string;
     /**
      * Append a memory to the memories list
      */

package/dist/types/types.d.ts

@@ -174,6 +174,7 @@ export interface SubGoal {
     index: number;
     status: SubGoalStatus;
     description: string;
+    logs?: string[];
 }
 export interface RawResponsePlanningAIResponse {
     action: PlanningAction;

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.3.8",
+  "version": "1.3.9",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "main": "./dist/lib/index.js",
@@ -89,7 +89,7 @@
     "semver": "7.5.2",
     "undici": "^6.0.0",
     "zod": "3.24.3",
-    "@midscene/shared": "1.3.8"
+    "@midscene/shared": "1.3.9"
   },
   "devDependencies": {
     "@rslib/core": "^0.18.3",