@mastra/memory 1.15.1-alpha.1 → 1.16.0-alpha.0

package/dist/{chunk-HAEQMUD4.js → chunk-HB6AYAFD.js}

@@ -484,7 +484,10 @@ function createActivationMarker(params) {
       threadId: params.threadId,
       generationCount: params.generationCount,
       config: params.config,
-      observations: params.observations
+      observations: params.observations,
+      triggeredBy: params.triggeredBy,
+      lastActivityAt: params.lastActivityAt,
+      ttlExpiredMs: params.ttlExpiredMs
     }
   };
 }
@@ -934,6 +937,8 @@ var ObservationStrategy = class _ObservationStrategy {
     this.scope = deps.scope;
     this.retrieval = deps.retrieval;
   }
+  deps;
+  opts;
   storage;
   messageHistory;
   tokenCounter;
@@ -1940,6 +1945,8 @@ var ObservationStep = class {
     this.turn = turn;
     this.stepNumber = stepNumber;
   }
+  turn;
+  stepNumber;
   _prepared = false;
   _context;
   /** Whether this step has been prepared. */
@@ -1999,7 +2006,8 @@ var ObservationStep = class {
         threadId,
         writer: this.turn.writer,
         requestContext: this.turn.requestContext,
-        observabilityContext: this.turn.observabilityContext
+        observabilityContext: this.turn.observabilityContext,
+        lastActivityAt: getLastActivityFromMessages(messageList.get.all.db())
       });
       await this.turn.refreshRecord();
       if (this.turn.record.generationCount > preReflectGeneration) {
@@ -2175,7 +2183,8 @@ var ObservationStep = class {
           writer: this.turn.writer,
           messageList,
           requestContext: this.turn.requestContext,
-          observabilityContext: this.turn.observabilityContext
+          observabilityContext: this.turn.observabilityContext,
+          lastActivityAt: getLastActivityFromMessages(messageList.get.all.db())
         });
         return {
           succeeded: true,
@@ -4130,7 +4139,8 @@ var ReflectorRunner = class {
       observationTokens: getMaxThreshold(
         record ? this.getEffectiveReflectionTokens(record) : this.reflectionConfig.observationTokens
       ),
-      scope: this.scope
+      scope: this.scope,
+      activateAfterIdle: this.reflectionConfig.activateAfterIdle
     };
   }
   /**
@@ -4416,7 +4426,7 @@ var ReflectorRunner = class {
    * Try to activate buffered reflection when threshold is reached.
    * Returns true if activation succeeded.
    */
-  async tryActivateBufferedReflection(record, lockKey, writer, messageList) {
+  async tryActivateBufferedReflection(record, lockKey, writer, messageList, activationMetadata) {
     const bufferKey = this.buffering.getReflectionBufferKey(lockKey);
     const asyncOp = BufferingCoordinator.asyncBufferingOps.get(bufferKey);
     if (asyncOp) {
@@ -4476,6 +4486,9 @@ ${unreflectedContent}` : freshRecord.bufferedReflection;
         threadId: freshRecord.threadId ?? "",
         generationCount: afterRecord?.generationCount ?? freshRecord.generationCount ?? 0,
         observations: afterRecord?.activeObservations,
+        triggeredBy: activationMetadata?.triggeredBy,
+        lastActivityAt: activationMetadata?.lastActivityAt,
+        ttlExpiredMs: activationMetadata?.ttlExpiredMs,
         config: this.getObservationMarkerConfig(freshRecord)
       });
       void writer.custom(activationMarker).catch(() => {
@@ -4504,7 +4517,9 @@ ${unreflectedContent}` : freshRecord.bufferedReflection;
       messageList,
       reflectionHooks,
       requestContext,
-      observabilityContext
+      observabilityContext,
+      lastActivityAt,
+      threadId: requestedThreadId
     } = opts;
     const lockKey = this.buffering.getLockKey(record.threadId, record.resourceId);
     const reflectThreshold = getMaxThreshold(this.getEffectiveReflectionTokens(record));
@@ -4536,9 +4551,17 @@ ${unreflectedContent}` : freshRecord.bufferedReflection;
         );
       }
     }
-    if (observationTokens < reflectThreshold) {
+    const activateAfterIdle = this.reflectionConfig.activateAfterIdle;
+    const ttlExpiredMs = activateAfterIdle !== void 0 && lastActivityAt !== void 0 ? Date.now() - lastActivityAt : void 0;
+    const ttlExpired = ttlExpiredMs !== void 0 && activateAfterIdle !== void 0 && ttlExpiredMs >= activateAfterIdle;
+    if (observationTokens < reflectThreshold && !ttlExpired) {
       return;
     }
+    const activationMetadata = {
+      triggeredBy: ttlExpired ? "ttl" : "threshold",
+      lastActivityAt: ttlExpired ? lastActivityAt : void 0,
+      ttlExpiredMs: ttlExpired ? ttlExpiredMs : void 0
+    };
     if (record.isReflecting) {
       if (isOpActiveInProcess(record.id, "reflecting")) {
         omDebug(`[OM:reflect] isReflecting=true and active in this process, skipping`);
@@ -4548,7 +4571,13 @@ ${unreflectedContent}` : freshRecord.bufferedReflection;
       await this.storage.setReflectingFlag(record.id, false);
     }
     if (this.buffering.isAsyncReflectionEnabled()) {
-      const activationSuccess = await this.tryActivateBufferedReflection(record, lockKey, writer, messageList);
+      const activationSuccess = await this.tryActivateBufferedReflection(
+        record,
+        lockKey,
+        writer,
+        messageList,
+        activationMetadata
+      );
       if (activationSuccess) {
         return;
       }
@@ -4577,7 +4606,7 @@ ${unreflectedContent}` : freshRecord.bufferedReflection;
     registerOp(record.id, "reflecting");
     const cycleId = crypto.randomUUID();
     const startedAt = (/* @__PURE__ */ new Date()).toISOString();
-    const threadId = opts.threadId ?? "unknown";
+    const threadId = requestedThreadId ?? "unknown";
     if (writer) {
       const startMarker = createObservationStartMarker({
         cycleId,
@@ -6227,6 +6256,58 @@ function buildMessageRange(messages) {
   const last = [...messages].reverse().find(messageHasVisibleContent) ?? messages[messages.length - 1];
   return `${first.id}:${last.id}`;
 }
+function getLastActivityFromMessages(messages) {
+  if (!messages) return void 0;
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const message = messages[i];
+    if (!message || message.role !== "assistant") {
+      continue;
+    }
+    if (!message.content || typeof message.content === "string") {
+      return message.createdAt ? new Date(message.createdAt).getTime() : void 0;
+    }
+    for (let j = message.content.parts.length - 1; j >= 0; j--) {
+      const part = message.content.parts[j];
+      if (!part || part.type?.startsWith("data-")) {
+        continue;
+      }
+      if (part.createdAt !== void 0) {
+        return part.createdAt;
+      }
+    }
+    return message.createdAt ? new Date(message.createdAt).getTime() : void 0;
+  }
+  return void 0;
+}
+function parseActivationTTL(value, fieldPath) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value === "number") {
+    if (!Number.isFinite(value) || value < 0) {
+      throw new Error(`${fieldPath} must be a non-negative number of milliseconds or a duration string like "5m".`);
+    }
+    return value;
+  }
+  const trimmed = value.trim();
+  const match = trimmed.match(
+    /^(\d+(?:\.\d+)?)\s*(ms|msec|msecs|millisecond|milliseconds|s|sec|secs|second|seconds|m|min|mins|minute|minutes|h|hr|hrs|hour|hours)$/i
+  );
+  if (!match) {
+    throw new Error(
+      `${fieldPath} must be a non-negative number of milliseconds or a duration string like "5m" or "1hr".`
+    );
+  }
+  const rawAmount = match[1];
+  const rawUnit = match[2];
+  const amount = Number(rawAmount);
+  const unit = rawUnit.toLowerCase();
+  if (!Number.isFinite(amount) || amount < 0) {
+    throw new Error(`${fieldPath} must be a non-negative number of milliseconds or a duration string like "5m".`);
+  }
+  const multiplier = unit === "ms" || unit === "msec" || unit === "msecs" || unit === "millisecond" || unit === "milliseconds" ? 1 : unit === "s" || unit === "sec" || unit === "secs" || unit === "second" || unit === "seconds" ? 1e3 : unit === "m" || unit === "min" || unit === "mins" || unit === "minute" || unit === "minutes" ? 6e4 : 36e5;
+  return amount * multiplier;
+}
 var ObservationalMemory = class _ObservationalMemory {
   storage;
   tokenCounter;
@@ -6373,6 +6454,7 @@ Async buffering is enabled by default \u2014 this opt-out is only needed when us
         config.observation?.messageTokens ?? OBSERVATIONAL_MEMORY_DEFAULTS.observation.messageTokens
       ),
       bufferActivation: asyncBufferingDisabled ? void 0 : config.observation?.bufferActivation ?? OBSERVATIONAL_MEMORY_DEFAULTS.observation.bufferActivation,
+      activateAfterIdle: parseActivationTTL(config.activateAfterIdle, "activateAfterIdle"),
       blockAfter: asyncBufferingDisabled ? void 0 : resolveBlockAfter(
         config.observation?.blockAfter ?? (config.observation?.bufferTokens ?? OBSERVATIONAL_MEMORY_DEFAULTS.observation.bufferTokens ? 1.2 : void 0),
         config.observation?.messageTokens ?? OBSERVATIONAL_MEMORY_DEFAULTS.observation.messageTokens
@@ -6391,6 +6473,7 @@ Async buffering is enabled by default \u2014 this opt-out is only needed when us
       },
       providerOptions: config.reflection?.providerOptions ?? OBSERVATIONAL_MEMORY_DEFAULTS.reflection.providerOptions,
       bufferActivation: asyncBufferingDisabled ? void 0 : config?.reflection?.bufferActivation ?? OBSERVATIONAL_MEMORY_DEFAULTS.reflection.bufferActivation,
+      activateAfterIdle: parseActivationTTL(config.activateAfterIdle, "activateAfterIdle"),
       blockAfter: asyncBufferingDisabled ? void 0 : resolveBlockAfter(
         config.reflection?.blockAfter ?? (config.reflection?.bufferActivation ?? OBSERVATIONAL_MEMORY_DEFAULTS.reflection.bufferActivation ? 1.2 : void 0),
         config.reflection?.observationTokens ?? OBSERVATIONAL_MEMORY_DEFAULTS.reflection.observationTokens
@@ -6785,7 +6868,8 @@ Async buffering is enabled by default \u2014 this opt-out is only needed when us
     return {
       messageTokens: getMaxThreshold(this.observationConfig.messageTokens),
       observationTokens: getMaxThreshold(this.reflectionConfig.observationTokens),
-      scope: this.scope
+      scope: this.scope,
+      activateAfterIdle: this.observationConfig.activateAfterIdle
     };
   }
   /**
@@ -8023,7 +8107,7 @@ ${grouped}` : grouped;
     await BufferingCoordinator.awaitBuffering(threadId, resourceId ?? null, this.scope);
     const preStatus = await this.getStatus({ threadId, resourceId, messages });
     if (preStatus.canActivate) {
-      const actResult = await this.activate({ threadId, resourceId });
+      const actResult = await this.activate({ threadId, resourceId, messages });
       activated = actResult.activated;
     }
     const postStatus = await this.getStatus({ threadId, resourceId, messages });
@@ -8283,10 +8367,28 @@ ${grouped}` : grouped;
     if (!chunks.length) {
       return { activated: false, record };
     }
+    let activationTriggeredBy = "threshold";
+    let activationLastActivityAt;
+    let activateAfterIdleExpiredMs;
     if (opts.checkThreshold) {
-      const status = await this.getStatus({ threadId, resourceId, messages: opts.messages });
-      if (status.pendingTokens < status.threshold) {
-        return { activated: false, record };
+      const thresholdMessages = opts.messages ?? await this.loadMessagesFromStorage(
+        threadId,
+        resourceId,
+        record.lastObservedAt ? new Date(record.lastObservedAt) : void 0
+      );
+      const activateAfterIdle = this.observationConfig.activateAfterIdle;
+      const lastActivityAt = getLastActivityFromMessages(thresholdMessages);
+      const ttlExpiredMs = activateAfterIdle !== void 0 && lastActivityAt !== void 0 ? Date.now() - lastActivityAt : void 0;
+      const ttlExpired = ttlExpiredMs !== void 0 && activateAfterIdle !== void 0 && ttlExpiredMs >= activateAfterIdle;
+      if (ttlExpired) {
+        activationTriggeredBy = "ttl";
+        activationLastActivityAt = lastActivityAt;
+        activateAfterIdleExpiredMs = ttlExpiredMs;
+      } else {
+        const status = await this.getStatus({ threadId, resourceId, messages: thresholdMessages });
+        if (status.pendingTokens < status.threshold) {
+          return { activated: false, record };
+        }
       }
     }
     if (record.isBufferingObservation) {
@@ -8344,6 +8446,9 @@ ${grouped}` : grouped;
           threadId: postSwapRecord.threadId ?? record.threadId ?? "",
           generationCount: postSwapRecord.generationCount ?? 0,
           observations: chunkData?.observations ?? activationResult.observations,
+          triggeredBy: activationTriggeredBy,
+          lastActivityAt: activationLastActivityAt,
+          ttlExpiredMs: activateAfterIdleExpiredMs,
           config: this.getObservationMarkerConfig()
         });
         void opts.writer.custom(activationMarker).catch(() => {
@@ -8834,5 +8939,5 @@ function getObservationsAsOf(activeObservations, asOf) {
 }
 
 export { ModelByInputTokens, OBSERVER_SYSTEM_PROMPT, ObservationalMemory, ObservationalMemoryProcessor, TokenCounter, buildObserverPrompt, buildObserverSystemPrompt, combineObservationGroupRanges, deriveObservationGroupProvenance, extractCurrentTask, formatMessagesForObserver, formatToolResultForObserver, getObservationsAsOf, hasCurrentTaskSection, injectAnchorIds, optimizeObservationsForContext, parseAnchorId, parseObservationGroups, parseObserverOutput, reconcileObservationGroupsFromReflection, renderObservationGroupsForReflection, resolveToolResultValue, stripEphemeralAnchorIds, stripObservationGroups, truncateStringByTokens, wrapInObservationGroup };
-//# sourceMappingURL=chunk-HAEQMUD4.js.map
-//# sourceMappingURL=chunk-HAEQMUD4.js.map
+//# sourceMappingURL=chunk-HB6AYAFD.js.map
+//# sourceMappingURL=chunk-HB6AYAFD.js.map