@mastra/core 1.6.0 → 1.7.0

package/dist/harness/harness.d.ts

@@ -1,6 +1,7 @@
 import type { z } from 'zod';
+import type { ObservationalMemoryRecord } from '../storage/types.js';
 import { Workspace } from '../workspace/workspace.js';
-import type { AvailableModel, HeartbeatHandler, HarnessConfig, HarnessEventListener, HarnessMessage, HarnessMode, HarnessSession, HarnessStateSchema, HarnessThread, ModelAuthStatus, PermissionPolicy, PermissionRules, ToolCategory } from './types.js';
+import type { AvailableModel, HeartbeatHandler, HarnessConfig, HarnessDisplayState, HarnessEventListener, HarnessMessage, HarnessMode, HarnessSession, HarnessStateSchema, HarnessThread, ModelAuthStatus, PermissionPolicy, PermissionRules, ToolCategory } from './types.js';
 /**
  * The Harness orchestrates multiple agent modes, shared state, memory, and storage.
  * It's the core abstraction that a TUI (or other UI) controls.
@@ -51,6 +52,7 @@ export declare class Harness<TState extends HarnessStateSchema = HarnessStateSch
     private tokenUsage;
     private sessionGrantedCategories;
     private sessionGrantedTools;
+    private displayState;
     constructor(config: HarnessConfig<TState>);
     /**
      * Initialize the harness — loads storage and workspace.
@@ -149,6 +151,7 @@ export declare class Harness<TState extends HarnessStateSchema = HarnessStateSch
      * then emits an `om_status` event for the UI.
      */
     loadOMProgress(): Promise<void>;
+    getObservationalMemoryRecord(): Promise<ObservationalMemoryRecord | null>;
     /**
      * Returns the observer model ID from state, falling back to omConfig defaults.
      */
@@ -265,6 +268,16 @@ export declare class Harness<TState extends HarnessStateSchema = HarnessStateSch
     getFollowUpCount(): number;
     isRunning(): boolean;
     getCurrentRunId(): string | null;
+    /**
+     * Returns a read-only snapshot of the canonical display state.
+     * UIs should use this to render instead of building up state from raw events.
+     */
+    getDisplayState(): Readonly<HarnessDisplayState>;
+    /**
+     * Reset display state fields that are scoped to a thread.
+     * Called on thread switch/creation.
+     */
+    private resetThreadDisplayState;
     /**
      * Respond to a pending tool approval from the UI.
      * "always_allow_category" grants the tool's category for the rest of the session, then approves.
@@ -318,6 +331,13 @@ export declare class Harness<TState extends HarnessStateSchema = HarnessStateSch
      */
     subscribe(listener: HarnessEventListener): () => void;
     private emit;
+    private dispatchToListeners;
+    /**
+     * Apply a display state update based on an incoming event.
+     * This is the centralized state machine that keeps HarnessDisplayState in sync
+     * with every event the Harness emits.
+     */
+    private applyDisplayStateUpdate;
     /**
      * Build the toolsets object that includes built-in harness tools (ask_user, submit_plan,
      * and optionally subagent) plus any user-configured tools.

package/dist/harness/harness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/harness/harness.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/harness/harness.ts"],"names":[],"mappings":"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"}

package/dist/harness/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkVJWRJWSC_cjs = require('../chunk-VJWRJWSC.cjs');
-var chunkAYHSPIT6_cjs = require('../chunk-AYHSPIT6.cjs');
+var chunk2X66GWF5_cjs = require('../chunk-2X66GWF5.cjs');
+var chunk7UAJ6LMR_cjs = require('../chunk-7UAJ6LMR.cjs');
 var chunkEAZ6YDCQ_cjs = require('../chunk-EAZ6YDCQ.cjs');
 var chunkVDKWYUGC_cjs = require('../chunk-VDKWYUGC.cjs');
 var zod = require('zod');
@@ -309,7 +309,7 @@ Use this tool when:
           isError: true
         };
       }
-      const subagent = new chunkVJWRJWSC_cjs.Agent({
+      const subagent = new chunk2X66GWF5_cjs.Agent({
         id: `subagent-${definition.id}`,
         name: `${definition.name} Subagent`,
         instructions: definition.instructions,
@@ -427,6 +427,55 @@ function parseSubagentMeta(content) {
   return { text, modelId, durationMs, toolCalls };
 }
 
+// src/harness/types.ts
+function defaultDisplayState() {
+  return {
+    isRunning: false,
+    currentMessage: null,
+    tokenUsage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+    activeTools: /* @__PURE__ */ new Map(),
+    toolInputBuffers: /* @__PURE__ */ new Map(),
+    pendingApproval: null,
+    pendingQuestion: null,
+    pendingPlanApproval: null,
+    activeSubagents: /* @__PURE__ */ new Map(),
+    omProgress: defaultOMProgressState(),
+    bufferingMessages: false,
+    bufferingObservations: false,
+    modifiedFiles: /* @__PURE__ */ new Map(),
+    tasks: [],
+    previousTasks: []
+  };
+}
+function defaultOMProgressState() {
+  return {
+    status: "idle",
+    pendingTokens: 0,
+    threshold: 3e4,
+    thresholdPercent: 0,
+    observationTokens: 0,
+    reflectionThreshold: 4e4,
+    reflectionThresholdPercent: 0,
+    buffered: {
+      observations: {
+        status: "idle",
+        chunks: 0,
+        messageTokens: 0,
+        projectedMessageRemoval: 0,
+        observationTokens: 0
+      },
+      reflection: {
+        status: "idle",
+        inputObservationTokens: 0,
+        observationTokens: 0
+      }
+    },
+    generationCount: 0,
+    stepNumber: 0,
+    preReflectionTokens: 0
+  };
+}
+
 // src/harness/harness.ts
 var Harness = class {
   id;
@@ -456,6 +505,7 @@ var Harness = class {
   };
   sessionGrantedCategories = /* @__PURE__ */ new Set();
   sessionGrantedTools = /* @__PURE__ */ new Set();
+  displayState = defaultDisplayState();
   constructor(config) {
     this.id = config.id;
     this.config = config;
@@ -469,7 +519,7 @@ var Harness = class {
       throw new Error("Harness requires at least one agent mode");
     }
     this.currentModeId = defaultMode.id;
-    if (config.workspace instanceof chunkAYHSPIT6_cjs.Workspace) {
+    if (config.workspace instanceof chunk7UAJ6LMR_cjs.Workspace) {
       this.workspace = config.workspace;
     } else if (typeof config.workspace === "function") {
       this.workspaceFn = config.workspace;
@@ -493,7 +543,7 @@ var Harness = class {
     if (this.config.workspace && !this.workspaceInitialized && !this.workspaceFn) {
       try {
         if (!this.workspace) {
-          this.workspace = new chunkAYHSPIT6_cjs.Workspace(this.config.workspace);
+          this.workspace = new chunk7UAJ6LMR_cjs.Workspace(this.config.workspace);
         }
         this.emit({ type: "workspace_status_changed", status: "initializing" });
         await this.workspace.init();
@@ -1084,6 +1134,15 @@ var Harness = class {
     } catch {
     }
   }
+  async getObservationalMemoryRecord() {
+    if (!this.currentThreadId) return null;
+    try {
+      const memoryStorage = await this.getMemoryStorage();
+      return await memoryStorage.getObservationalMemory(this.currentThreadId, this.resourceId);
+    } catch {
+      return null;
+    }
+  }
   /**
    * Returns the observer model ID from state, falling back to omConfig defaults.
    */
@@ -1792,6 +1851,35 @@ var Harness = class {
   getCurrentRunId() {
     return this.currentRunId;
   }
+  // ===========================================================================
+  // Display State
+  // ===========================================================================
+  /**
+   * Returns a read-only snapshot of the canonical display state.
+   * UIs should use this to render instead of building up state from raw events.
+   */
+  getDisplayState() {
+    return this.displayState;
+  }
+  /**
+   * Reset display state fields that are scoped to a thread.
+   * Called on thread switch/creation.
+   */
+  resetThreadDisplayState() {
+    this.displayState.activeTools = /* @__PURE__ */ new Map();
+    this.displayState.toolInputBuffers = /* @__PURE__ */ new Map();
+    this.displayState.pendingApproval = null;
+    this.displayState.pendingQuestion = null;
+    this.displayState.pendingPlanApproval = null;
+    this.displayState.activeSubagents = /* @__PURE__ */ new Map();
+    this.displayState.currentMessage = null;
+    this.displayState.modifiedFiles = /* @__PURE__ */ new Map();
+    this.displayState.tasks = [];
+    this.displayState.previousTasks = [];
+    this.displayState.omProgress = defaultOMProgressState();
+    this.displayState.bufferingMessages = false;
+    this.displayState.bufferingObservations = false;
+  }
   /**
    * Respond to a pending tool approval from the UI.
    * "always_allow_category" grants the tool's category for the rest of the session, then approves.
@@ -1919,6 +2007,16 @@ var Harness = class {
     };
   }
   emit(event) {
+    this.applyDisplayStateUpdate(event);
+    this.dispatchToListeners(event);
+    if (event.type !== "display_state_changed") {
+      this.dispatchToListeners({
+        type: "display_state_changed",
+        displayState: this.displayState
+      });
+    }
+  }
+  dispatchToListeners(event) {
     for (const listener of this.listeners) {
       try {
         const result = listener(event);
@@ -1930,6 +2028,323 @@ var Harness = class {
       }
     }
   }
+  /**
+   * Apply a display state update based on an incoming event.
+   * This is the centralized state machine that keeps HarnessDisplayState in sync
+   * with every event the Harness emits.
+   */
+  applyDisplayStateUpdate(event) {
+    const ds = this.displayState;
+    switch (event.type) {
+      // ── Agent lifecycle ────────────────────────────────────────────────
+      case "agent_start":
+        ds.isRunning = true;
+        ds.activeTools = /* @__PURE__ */ new Map();
+        ds.toolInputBuffers = /* @__PURE__ */ new Map();
+        ds.currentMessage = null;
+        ds.pendingApproval = null;
+        break;
+      case "agent_end":
+        ds.isRunning = false;
+        ds.pendingApproval = null;
+        ds.pendingQuestion = null;
+        ds.pendingPlanApproval = null;
+        for (const [, tool] of ds.activeTools) {
+          if (tool.status === "running" || tool.status === "streaming_input") {
+            tool.status = "error";
+          }
+        }
+        ds.activeSubagents = /* @__PURE__ */ new Map();
+        break;
+      // ── Message streaming ──────────────────────────────────────────────
+      case "message_start":
+        ds.currentMessage = event.message;
+        break;
+      case "message_update":
+        ds.currentMessage = event.message;
+        break;
+      case "message_end":
+        ds.currentMessage = event.message;
+        break;
+      // ── Tool lifecycle ─────────────────────────────────────────────────
+      case "tool_input_start": {
+        ds.toolInputBuffers.set(event.toolCallId, { text: "", toolName: event.toolName });
+        const existing = ds.activeTools.get(event.toolCallId);
+        if (existing) {
+          existing.status = "streaming_input";
+        } else {
+          ds.activeTools.set(event.toolCallId, {
+            name: event.toolName,
+            args: {},
+            status: "streaming_input"
+          });
+        }
+        break;
+      }
+      case "tool_input_delta": {
+        const buf = ds.toolInputBuffers.get(event.toolCallId);
+        if (buf) {
+          buf.text += event.argsTextDelta;
+        }
+        break;
+      }
+      case "tool_input_end":
+        ds.toolInputBuffers.delete(event.toolCallId);
+        break;
+      case "tool_start": {
+        const existingTool = ds.activeTools.get(event.toolCallId);
+        if (existingTool) {
+          existingTool.name = event.toolName;
+          existingTool.args = event.args;
+          existingTool.status = "running";
+        } else {
+          ds.activeTools.set(event.toolCallId, {
+            name: event.toolName,
+            args: event.args,
+            status: "running"
+          });
+        }
+        break;
+      }
+      case "tool_update": {
+        const tool = ds.activeTools.get(event.toolCallId);
+        if (tool) {
+          tool.partialResult = typeof event.partialResult === "string" ? event.partialResult : JSON.stringify(event.partialResult);
+        }
+        break;
+      }
+      case "tool_end": {
+        const endedTool = ds.activeTools.get(event.toolCallId);
+        if (endedTool) {
+          endedTool.status = event.isError ? "error" : "completed";
+          endedTool.result = event.result;
+          endedTool.isError = event.isError;
+        }
+        if (!event.isError) {
+          const FILE_TOOLS = ["string_replace_lsp", "write_file", "ast_smart_edit"];
+          const toolState = ds.activeTools.get(event.toolCallId);
+          if (toolState && FILE_TOOLS.includes(toolState.name)) {
+            const toolArgs = toolState.args;
+            const filePath = toolArgs?.path;
+            if (filePath) {
+              const existing = ds.modifiedFiles.get(filePath);
+              if (existing) {
+                existing.operations.push(toolState.name);
+              } else {
+                ds.modifiedFiles.set(filePath, {
+                  operations: [toolState.name],
+                  firstModified: /* @__PURE__ */ new Date()
+                });
+              }
+            }
+          }
+        }
+        break;
+      }
+      case "shell_output": {
+        const shellTool = ds.activeTools.get(event.toolCallId);
+        if (shellTool) {
+          shellTool.shellOutput = (shellTool.shellOutput ?? "") + event.output;
+        }
+        break;
+      }
+      case "tool_approval_required":
+        ds.pendingApproval = {
+          toolCallId: event.toolCallId,
+          toolName: event.toolName,
+          args: event.args
+        };
+        break;
+      // ── Interactive prompts ────────────────────────────────────────────
+      case "ask_question":
+        ds.pendingQuestion = {
+          questionId: event.questionId,
+          question: event.question,
+          options: event.options
+        };
+        break;
+      case "plan_approval_required":
+        ds.pendingPlanApproval = {
+          planId: event.planId,
+          title: event.title,
+          plan: event.plan
+        };
+        break;
+      case "plan_approved":
+        ds.pendingPlanApproval = null;
+        break;
+      // ── Subagent tracking ──────────────────────────────────────────────
+      case "subagent_start":
+        ds.activeSubagents.set(event.toolCallId, {
+          agentType: event.agentType,
+          task: event.task,
+          modelId: event.modelId,
+          toolCalls: [],
+          textDelta: "",
+          status: "running"
+        });
+        break;
+      case "subagent_text_delta": {
+        const sub = ds.activeSubagents.get(event.toolCallId);
+        if (sub) {
+          sub.textDelta += event.textDelta;
+        }
+        break;
+      }
+      case "subagent_tool_start": {
+        const subAgent = ds.activeSubagents.get(event.toolCallId);
+        if (subAgent) {
+          subAgent.toolCalls.push({ name: event.subToolName, isError: false });
+        }
+        break;
+      }
+      case "subagent_tool_end": {
+        const subTool = ds.activeSubagents.get(event.toolCallId);
+        if (subTool) {
+          const tc = subTool.toolCalls.find((t) => t.name === event.subToolName && !t.isError);
+          if (tc) {
+            tc.isError = event.isError;
+          }
+        }
+        break;
+      }
+      case "subagent_end": {
+        const endedSub = ds.activeSubagents.get(event.toolCallId);
+        if (endedSub) {
+          endedSub.status = event.isError ? "error" : "completed";
+          endedSub.durationMs = event.durationMs;
+          endedSub.result = event.result;
+        }
+        break;
+      }
+      // ── Observational Memory ───────────────────────────────────────────
+      case "om_status": {
+        const w = event.windows;
+        ds.omProgress.pendingTokens = w.active.messages.tokens;
+        ds.omProgress.threshold = w.active.messages.threshold;
+        ds.omProgress.thresholdPercent = w.active.messages.threshold > 0 ? w.active.messages.tokens / w.active.messages.threshold * 100 : 0;
+        ds.omProgress.observationTokens = w.active.observations.tokens;
+        ds.omProgress.reflectionThreshold = w.active.observations.threshold;
+        ds.omProgress.reflectionThresholdPercent = w.active.observations.threshold > 0 ? w.active.observations.tokens / w.active.observations.threshold * 100 : 0;
+        ds.omProgress.buffered = {
+          observations: { ...w.buffered.observations },
+          reflection: { ...w.buffered.reflection }
+        };
+        ds.omProgress.generationCount = event.generationCount;
+        ds.omProgress.stepNumber = event.stepNumber;
+        ds.bufferingMessages = w.buffered.observations.status === "running";
+        ds.bufferingObservations = w.buffered.reflection.status === "running";
+        break;
+      }
+      case "om_observation_start":
+        ds.omProgress.status = "observing";
+        ds.omProgress.cycleId = event.cycleId;
+        ds.omProgress.startTime = Date.now();
+        break;
+      case "om_observation_end":
+        ds.omProgress.status = "idle";
+        ds.omProgress.cycleId = void 0;
+        ds.omProgress.startTime = void 0;
+        ds.omProgress.observationTokens = event.observationTokens;
+        ds.omProgress.pendingTokens = 0;
+        ds.omProgress.thresholdPercent = 0;
+        break;
+      case "om_observation_failed":
+        ds.omProgress.status = "idle";
+        ds.omProgress.cycleId = void 0;
+        ds.omProgress.startTime = void 0;
+        break;
+      case "om_reflection_start":
+        ds.omProgress.status = "reflecting";
+        ds.omProgress.cycleId = event.cycleId;
+        ds.omProgress.startTime = Date.now();
+        ds.omProgress.preReflectionTokens = ds.omProgress.observationTokens;
+        ds.omProgress.observationTokens = event.tokensToReflect;
+        ds.omProgress.reflectionThresholdPercent = ds.omProgress.reflectionThreshold > 0 ? event.tokensToReflect / ds.omProgress.reflectionThreshold * 100 : 0;
+        break;
+      case "om_reflection_end":
+        ds.omProgress.status = "idle";
+        ds.omProgress.cycleId = void 0;
+        ds.omProgress.startTime = void 0;
+        ds.omProgress.observationTokens = event.compressedTokens;
+        ds.omProgress.reflectionThresholdPercent = ds.omProgress.reflectionThreshold > 0 ? event.compressedTokens / ds.omProgress.reflectionThreshold * 100 : 0;
+        break;
+      case "om_reflection_failed":
+        ds.omProgress.status = "idle";
+        ds.omProgress.cycleId = void 0;
+        ds.omProgress.startTime = void 0;
+        break;
+      case "om_buffering_start":
+        if (event.operationType === "observation") {
+          ds.bufferingMessages = true;
+        } else {
+          ds.bufferingObservations = true;
+        }
+        break;
+      case "om_buffering_end":
+        if (event.operationType === "observation") {
+          ds.bufferingMessages = false;
+        } else {
+          ds.bufferingObservations = false;
+        }
+        break;
+      case "om_buffering_failed":
+        if (event.operationType === "observation") {
+          ds.bufferingMessages = false;
+        } else {
+          ds.bufferingObservations = false;
+        }
+        break;
+      case "om_activation":
+        if (event.operationType === "observation") {
+          ds.bufferingMessages = false;
+        } else {
+          ds.bufferingObservations = false;
+        }
+        break;
+      // ── Token usage ────────────────────────────────────────────────────
+      case "usage_update":
+        ds.tokenUsage = {
+          promptTokens: this.tokenUsage.promptTokens,
+          completionTokens: this.tokenUsage.completionTokens,
+          totalTokens: this.tokenUsage.totalTokens
+        };
+        break;
+      // ── Tasks ──────────────────────────────────────────────────────────
+      case "task_updated":
+        ds.previousTasks = [...ds.tasks];
+        ds.tasks = event.tasks;
+        break;
+      // ── Thread lifecycle ───────────────────────────────────────────────
+      case "thread_changed":
+        this.resetThreadDisplayState();
+        ds.tokenUsage = { ...this.tokenUsage };
+        break;
+      case "thread_created":
+        this.resetThreadDisplayState();
+        ds.tokenUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+        break;
+      // ── State changes (for OM threshold overrides) ──────────────────────
+      case "state_changed": {
+        const keys = event.changedKeys;
+        if (keys.includes("observationThreshold")) {
+          const value = event.state.observationThreshold;
+          if (typeof value === "number") {
+            ds.omProgress.threshold = value;
+            ds.omProgress.thresholdPercent = value > 0 ? ds.omProgress.pendingTokens / value * 100 : 0;
+          }
+        }
+        if (keys.includes("reflectionThreshold")) {
+          const value = event.state.reflectionThreshold;
+          if (typeof value === "number") {
+            ds.omProgress.reflectionThreshold = value;
+            ds.omProgress.reflectionThresholdPercent = value > 0 ? ds.omProgress.observationTokens / value * 100 : 0;
+          }
+        }
+        break;
+      }
+    }
+  }
   // ===========================================================================
   // Runtime Context
   // ===========================================================================
@@ -2128,6 +2543,8 @@ var Harness = class {
 
 exports.Harness = Harness;
 exports.askUserTool = askUserTool;
+exports.defaultDisplayState = defaultDisplayState;
+exports.defaultOMProgressState = defaultOMProgressState;
 exports.parseSubagentMeta = parseSubagentMeta;
 exports.submitPlanTool = submitPlanTool;
 exports.taskCheckTool = taskCheckTool;