@mastra/memory 1.5.0 → 1.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/CHANGELOG.md +30 -0
  2. package/dist/{chunk-DF7NDDSM.js → chunk-6PKWQ3GH.js} +28 -11
  3. package/dist/chunk-6PKWQ3GH.js.map +1 -0
  4. package/dist/{chunk-LLTHE64H.cjs → chunk-6XVTMLW4.cjs} +28 -11
  5. package/dist/chunk-6XVTMLW4.cjs.map +1 -0
  6. package/dist/index.cjs +1 -1
  7. package/dist/index.js +1 -1
  8. package/dist/{observational-memory-ZNTAIUGT.js → observational-memory-AJWSMZVP.js} +3 -3
  9. package/dist/{observational-memory-ZNTAIUGT.js.map → observational-memory-AJWSMZVP.js.map} +1 -1
  10. package/dist/{observational-memory-4PCXEZIS.cjs → observational-memory-Q5TO525O.cjs} +17 -17
  11. package/dist/{observational-memory-4PCXEZIS.cjs.map → observational-memory-Q5TO525O.cjs.map} +1 -1
  12. package/dist/processors/index.cjs +15 -15
  13. package/dist/processors/index.js +1 -1
  14. package/dist/processors/observational-memory/observational-memory.d.ts.map +1 -1
  15. package/dist/processors/observational-memory/token-counter.d.ts.map +1 -1
  16. package/package.json +7 -7
  17. package/dist/chunk-DF7NDDSM.js.map +0 -1
  18. package/dist/chunk-LLTHE64H.cjs.map +0 -1
  19. package/dist/docs/SKILL.md +0 -54
  20. package/dist/docs/assets/SOURCE_MAP.json +0 -103
  21. package/dist/docs/references/docs-agents-agent-approval.md +0 -377
  22. package/dist/docs/references/docs-agents-agent-memory.md +0 -212
  23. package/dist/docs/references/docs-agents-network-approval.md +0 -275
  24. package/dist/docs/references/docs-agents-networks.md +0 -290
  25. package/dist/docs/references/docs-memory-memory-processors.md +0 -316
  26. package/dist/docs/references/docs-memory-message-history.md +0 -260
  27. package/dist/docs/references/docs-memory-observational-memory.md +0 -246
  28. package/dist/docs/references/docs-memory-overview.md +0 -45
  29. package/dist/docs/references/docs-memory-semantic-recall.md +0 -272
  30. package/dist/docs/references/docs-memory-storage.md +0 -261
  31. package/dist/docs/references/docs-memory-working-memory.md +0 -400
  32. package/dist/docs/references/reference-core-getMemory.md +0 -50
  33. package/dist/docs/references/reference-core-listMemory.md +0 -56
  34. package/dist/docs/references/reference-memory-clone-utilities.md +0 -199
  35. package/dist/docs/references/reference-memory-cloneThread.md +0 -130
  36. package/dist/docs/references/reference-memory-createThread.md +0 -68
  37. package/dist/docs/references/reference-memory-getThreadById.md +0 -24
  38. package/dist/docs/references/reference-memory-listThreads.md +0 -145
  39. package/dist/docs/references/reference-memory-memory-class.md +0 -147
  40. package/dist/docs/references/reference-memory-observational-memory.md +0 -565
  41. package/dist/docs/references/reference-processors-token-limiter-processor.md +0 -113
  42. package/dist/docs/references/reference-storage-dynamodb.md +0 -282
  43. package/dist/docs/references/reference-storage-libsql.md +0 -135
  44. package/dist/docs/references/reference-storage-mongodb.md +0 -262
  45. package/dist/docs/references/reference-storage-postgresql.md +0 -529
  46. package/dist/docs/references/reference-storage-upstash.md +0 -160
  47. package/dist/docs/references/reference-vectors-libsql.md +0 -305
  48. package/dist/docs/references/reference-vectors-mongodb.md +0 -295
  49. package/dist/docs/references/reference-vectors-pg.md +0 -408
  50. package/dist/docs/references/reference-vectors-upstash.md +0 -294
@@ -916,6 +916,13 @@ function extractReflectorListItems(content) {
916
916
  function validateCompression(reflectedTokens, targetThreshold) {
917
917
  return reflectedTokens < targetThreshold;
918
918
  }
919
+ var sharedDefaultEncoder;
920
+ function getDefaultEncoder() {
921
+ if (!sharedDefaultEncoder) {
922
+ sharedDefaultEncoder = new lite.Tiktoken(o200k_base__default.default);
923
+ }
924
+ return sharedDefaultEncoder;
925
+ }
919
926
  var TokenCounter = class _TokenCounter {
920
927
  encoder;
921
928
  // Per-message overhead: accounts for role tokens, message framing, and separators.
@@ -925,7 +932,7 @@ var TokenCounter = class _TokenCounter {
925
932
  // Conversation-level overhead: system prompt framing, reply priming tokens, etc.
926
933
  static TOKENS_PER_CONVERSATION = 24;
927
934
  constructor(encoding) {
928
- this.encoder = new lite.Tiktoken(encoding || o200k_base__default.default);
935
+ this.encoder = encoding ? new lite.Tiktoken(encoding) : getDefaultEncoder();
929
936
  }
930
937
  /**
931
938
  * Count tokens in a plain string
@@ -1380,7 +1387,7 @@ var ObservationalMemory = class _ObservationalMemory {
1380
1387
  _ObservationalMemory.lastBufferedBoundary.delete(reflBufKey);
1381
1388
  _ObservationalMemory.asyncBufferingOps.delete(obsBufKey);
1382
1389
  _ObservationalMemory.asyncBufferingOps.delete(reflBufKey);
1383
- _ObservationalMemory.reflectionBufferCycleIds.delete(obsBufKey);
1390
+ _ObservationalMemory.reflectionBufferCycleIds.delete(reflBufKey);
1384
1391
  }
1385
1392
  }
1386
1393
  /**
@@ -1932,6 +1939,11 @@ Async buffering is enabled by default \u2014 this opt-out is only needed when us
1932
1939
  resourceId: resourceId ?? threadId
1933
1940
  };
1934
1941
  }
1942
+ if (!threadId) {
1943
+ throw new Error(
1944
+ `ObservationalMemory (scope: 'thread') requires a threadId, but received an empty value. This is a bug \u2014 getThreadContext should have caught this earlier.`
1945
+ );
1946
+ }
1935
1947
  return {
1936
1948
  threadId,
1937
1949
  resourceId: resourceId ?? threadId
@@ -2690,6 +2702,11 @@ ${suggestedResponse}
2690
2702
  resourceId: serialized.memoryInfo.resourceId
2691
2703
  };
2692
2704
  }
2705
+ if (this.scope === "thread") {
2706
+ throw new Error(
2707
+ `ObservationalMemory (scope: 'thread') requires a threadId, but none was found in RequestContext or MessageList. Ensure the agent is configured with Memory and a valid threadId is provided.`
2708
+ );
2709
+ }
2693
2710
  return null;
2694
2711
  }
2695
2712
  // ══════════════════════════════════════════════════════════════════════════
@@ -3766,13 +3783,6 @@ ${result.observations}` : result.observations;
3766
3783
  const newMessageIds = messagesToObserve.map((m) => m.id);
3767
3784
  const existingIds = freshRecord?.observedMessageIds ?? record.observedMessageIds ?? [];
3768
3785
  const allObservedIds = [.../* @__PURE__ */ new Set([...Array.isArray(existingIds) ? existingIds : [], ...newMessageIds])];
3769
- await this.storage.updateActiveObservations({
3770
- id: record.id,
3771
- observations: newObservations,
3772
- tokenCount: totalTokenCount,
3773
- lastObservedAt,
3774
- observedMessageIds: allObservedIds
3775
- });
3776
3786
  if (result.suggestedContinuation || result.currentTask) {
3777
3787
  const thread = await this.storage.getThreadById({ threadId });
3778
3788
  if (thread) {
@@ -3787,6 +3797,13 @@ ${result.observations}` : result.observations;
3787
3797
  });
3788
3798
  }
3789
3799
  }
3800
+ await this.storage.updateActiveObservations({
3801
+ id: record.id,
3802
+ observations: newObservations,
3803
+ tokenCount: totalTokenCount,
3804
+ lastObservedAt,
3805
+ observedMessageIds: allObservedIds
3806
+ });
3790
3807
  const actualTokensObserved = this.tokenCounter.countMessages(messagesToObserve);
3791
3808
  if (lastMessage?.id) {
3792
3809
  const endMarker = this.createObservationEndMarker({
@@ -5068,5 +5085,5 @@ exports.formatMessagesForObserver = formatMessagesForObserver;
5068
5085
  exports.hasCurrentTaskSection = hasCurrentTaskSection;
5069
5086
  exports.optimizeObservationsForContext = optimizeObservationsForContext;
5070
5087
  exports.parseObserverOutput = parseObserverOutput;
5071
- //# sourceMappingURL=chunk-LLTHE64H.cjs.map
5072
- //# sourceMappingURL=chunk-LLTHE64H.cjs.map
5088
+ //# sourceMappingURL=chunk-6XVTMLW4.cjs.map
5089
+ //# sourceMappingURL=chunk-6XVTMLW4.cjs.map