@mastra/server 1.18.1-alpha.0 → 1.19.0-alpha.2

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 (31) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/dist/{chunk-FTGC7KXM.js → chunk-3VRBDPB6.js} +131 -16
  3. package/dist/chunk-3VRBDPB6.js.map +1 -0
  4. package/dist/{chunk-U5XW3WOS.js → chunk-5CDCKTHB.js} +38 -20
  5. package/dist/chunk-5CDCKTHB.js.map +1 -0
  6. package/dist/{chunk-POOOTRUM.cjs → chunk-DAEHQAZC.cjs} +38 -20
  7. package/dist/chunk-DAEHQAZC.cjs.map +1 -0
  8. package/dist/{chunk-MS7GNCN3.cjs → chunk-KWEYG4OZ.cjs} +144 -29
  9. package/dist/chunk-KWEYG4OZ.cjs.map +1 -0
  10. package/dist/docs/SKILL.md +1 -1
  11. package/dist/docs/assets/SOURCE_MAP.json +1 -1
  12. package/dist/docs/references/docs-server-custom-adapters.md +3 -1
  13. package/dist/{observational-memory-SASGM6OW-3S6D4TAF.js → observational-memory-B25SASRW-L4GYD2ZN.js} +3 -3
  14. package/dist/{observational-memory-SASGM6OW-3S6D4TAF.js.map → observational-memory-B25SASRW-L4GYD2ZN.js.map} +1 -1
  15. package/dist/{observational-memory-SASGM6OW-2G3RBRTW.cjs → observational-memory-B25SASRW-T76NSRNU.cjs} +26 -26
  16. package/dist/{observational-memory-SASGM6OW-2G3RBRTW.cjs.map → observational-memory-B25SASRW-T76NSRNU.cjs.map} +1 -1
  17. package/dist/server/handlers/agent-builder.cjs +16 -16
  18. package/dist/server/handlers/agent-builder.js +1 -1
  19. package/dist/server/handlers.cjs +2 -2
  20. package/dist/server/handlers.js +1 -1
  21. package/dist/server/server-adapter/index.cjs +24 -16
  22. package/dist/server/server-adapter/index.cjs.map +1 -1
  23. package/dist/server/server-adapter/index.js +10 -2
  24. package/dist/server/server-adapter/index.js.map +1 -1
  25. package/dist/server/server-adapter/routes/observability.d.ts +881 -119
  26. package/dist/server/server-adapter/routes/observability.d.ts.map +1 -1
  27. package/package.json +4 -4
  28. package/dist/chunk-FTGC7KXM.js.map +0 -1
  29. package/dist/chunk-MS7GNCN3.cjs.map +0 -1
  30. package/dist/chunk-POOOTRUM.cjs.map +0 -1
  31. package/dist/chunk-U5XW3WOS.js.map +0 -1
@@ -1954,7 +1954,11 @@ var ObservationStrategy = class _ObservationStrategy {
1954
1954
  retrieval;
1955
1955
  /** Select the right strategy based on scope and mode. Wired up by index.ts. */
1956
1956
  static create;
1957
- /** Run the full observation lifecycle. */
1957
+ /**
1958
+ * Run the full observation lifecycle.
1959
+ * @returns `true` if a full observation cycle completed; `false` if skipped (stale lock) or async-buffer failure was swallowed.
1960
+ * @throws On sync/resource-scoped observer failure after failed markers (same as pre–Option-A contract).
1961
+ */
1958
1962
  async run() {
1959
1963
  const { record, threadId, abortSignal, writer, reflectionHooks, requestContext } = this.opts;
1960
1964
  const cycleId = this.generateCycleId();
@@ -1962,7 +1966,7 @@ var ObservationStrategy = class _ObservationStrategy {
1962
1966
  if (this.needsLock) {
1963
1967
  const fresh = await this.storage.getObservationalMemory(record.threadId, record.resourceId);
1964
1968
  if (fresh?.lastObservedAt && record.lastObservedAt && fresh.lastObservedAt > record.lastObservedAt) {
1965
- return;
1969
+ return false;
1966
1970
  }
1967
1971
  }
1968
1972
  const { messages, existingObservations } = await this.prepare();
@@ -1983,23 +1987,29 @@ var ObservationStrategy = class _ObservationStrategy {
1983
1987
  observabilityContext: this.opts.observabilityContext
1984
1988
  });
1985
1989
  }
1990
+ return true;
1986
1991
  } catch (error) {
1987
1992
  await this.emitFailedMarkers(cycleId, error);
1988
- const failedMarkerForStorage = {
1989
- type: "data-om-observation-failed",
1990
- data: {
1991
- cycleId,
1992
- operationType: "observation",
1993
- startedAt: (/* @__PURE__ */ new Date()).toISOString(),
1994
- error: error instanceof Error ? error.message : String(error),
1995
- recordId: record.id,
1996
- threadId
1997
- }
1998
- };
1999
- await this.persistMarkerToStorage(failedMarkerForStorage, threadId, this.opts.resourceId).catch(() => {
2000
- });
2001
- if (abortSignal?.aborted) throw error;
1993
+ if (!this.rethrowOnFailure) {
1994
+ const failedMarkerForStorage = {
1995
+ type: "data-om-observation-failed",
1996
+ data: {
1997
+ cycleId,
1998
+ operationType: "observation",
1999
+ startedAt: (/* @__PURE__ */ new Date()).toISOString(),
2000
+ error: error instanceof Error ? error.message : String(error),
2001
+ recordId: record.id,
2002
+ threadId
2003
+ }
2004
+ };
2005
+ await this.persistMarkerToStorage(failedMarkerForStorage, threadId, this.opts.resourceId).catch(() => {
2006
+ });
2007
+ if (abortSignal?.aborted) throw error;
2008
+ omError("[OM] Observation failed", error);
2009
+ return false;
2010
+ }
2002
2011
  omError("[OM] Observation failed", error);
2012
+ throw error;
2003
2013
  }
2004
2014
  }
2005
2015
  // ── Shared helpers ──────────────────────────────────────────
@@ -2220,6 +2230,9 @@ var SyncObservationStrategy = class extends ObservationStrategy {
2220
2230
  get needsReflection() {
2221
2231
  return true;
2222
2232
  }
2233
+ get rethrowOnFailure() {
2234
+ return true;
2235
+ }
2223
2236
  async prepare() {
2224
2237
  const { record, threadId, messages } = this.opts;
2225
2238
  this.deps.emitDebugEvent({
@@ -2411,6 +2424,9 @@ var AsyncBufferObservationStrategy = class extends ObservationStrategy {
2411
2424
  get needsReflection() {
2412
2425
  return false;
2413
2426
  }
2427
+ get rethrowOnFailure() {
2428
+ return false;
2429
+ }
2414
2430
  generateCycleId() {
2415
2431
  return this.cycleId;
2416
2432
  }
@@ -2547,6 +2563,9 @@ var ResourceScopedObservationStrategy = class extends ObservationStrategy {
2547
2563
  get needsReflection() {
2548
2564
  return true;
2549
2565
  }
2566
+ get rethrowOnFailure() {
2567
+ return true;
2568
+ }
2550
2569
  async prepare() {
2551
2570
  const { record, threadId: currentThreadId, messages: currentThreadMessages } = this.opts;
2552
2571
  const { threads: allThreads } = await this.storage.listThreads({ filter: { resourceId: this.resourceId } });
@@ -8799,7 +8818,7 @@ ${grouped}` : grouped;
8799
8818
  }
8800
8819
  hooks?.onObservationStart?.();
8801
8820
  try {
8802
- await ObservationStrategy.create(this, {
8821
+ observed = await ObservationStrategy.create(this, {
8803
8822
  record: freshRecord,
8804
8823
  threadId,
8805
8824
  resourceId,
@@ -8809,7 +8828,6 @@ ${grouped}` : grouped;
8809
8828
  writer: opts.writer,
8810
8829
  observabilityContext: opts.observabilityContext
8811
8830
  }).run();
8812
- observed = true;
8813
8831
  } finally {
8814
8832
  hooks?.onObservationEnd?.();
8815
8833
  }
@@ -9441,5 +9459,5 @@ exports.stripEphemeralAnchorIds = stripEphemeralAnchorIds;
9441
9459
  exports.stripObservationGroups = stripObservationGroups;
9442
9460
  exports.truncateStringByTokens = truncateStringByTokens;
9443
9461
  exports.wrapInObservationGroup = wrapInObservationGroup;
9444
- //# sourceMappingURL=chunk-POOOTRUM.cjs.map
9445
- //# sourceMappingURL=chunk-POOOTRUM.cjs.map
9462
+ //# sourceMappingURL=chunk-DAEHQAZC.cjs.map
9463
+ //# sourceMappingURL=chunk-DAEHQAZC.cjs.map