@mastra/mongodb 1.9.0 → 1.9.1

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # @mastra/mongodb
 
+## 1.9.1
+
+### Patch Changes
+
+- Added notification inbox storage support for MongoDB stores. ([#17241](https://github.com/mastra-ai/mastra/pull/17241))
+
+  ```ts
+  import { MongoDBStore } from '@mastra/mongodb';
+
+  const storage = new MongoDBStore({ url: process.env.MONGODB_URI!, dbName: 'mastra' });
+  ```
+
+  Agents using this store can persist thread-scoped notification inbox records for notification signals.
+
+- Updated dependencies [[`c973db4`](https://github.com/mastra-ai/mastra/commit/c973db428df1b564ff0c35d4b2a90e8f4f1e13fd), [`552285e`](https://github.com/mastra-ai/mastra/commit/552285e5af43cfc680a0972032cab8de8776c6a0), [`77e686c`](https://github.com/mastra-ai/mastra/commit/77e686c264e493e99ae5024e4dfe3ea5d5a09718), [`ece8dba`](https://github.com/mastra-ai/mastra/commit/ece8dba7ec1a5089eee8c33167cd762bfa91e509), [`e751af2`](https://github.com/mastra-ai/mastra/commit/e751af219433fbf4c7035b2d771b4c9ec8813b05), [`e2a8380`](https://github.com/mastra-ai/mastra/commit/e2a838017a7657850404c1e94c70d79ffdc6f14a), [`be3f1cd`](https://github.com/mastra-ai/mastra/commit/be3f1cd81f0e2a649e8eac15a024d542d814aef8), [`a34d9db`](https://github.com/mastra-ai/mastra/commit/a34d9dbc39fedb722f271318e9355ecee70489ab)]:
+  - @mastra/core@1.39.0
+
+## 1.9.1-alpha.0
+
+### Patch Changes
+
+- Added notification inbox storage support for MongoDB stores. ([#17241](https://github.com/mastra-ai/mastra/pull/17241))
+
+  ```ts
+  import { MongoDBStore } from '@mastra/mongodb';
+
+  const storage = new MongoDBStore({ url: process.env.MONGODB_URI!, dbName: 'mastra' });
+  ```
+
+  Agents using this store can persist thread-scoped notification inbox records for notification signals.
+
+- Updated dependencies [[`c973db4`](https://github.com/mastra-ai/mastra/commit/c973db428df1b564ff0c35d4b2a90e8f4f1e13fd), [`552285e`](https://github.com/mastra-ai/mastra/commit/552285e5af43cfc680a0972032cab8de8776c6a0), [`77e686c`](https://github.com/mastra-ai/mastra/commit/77e686c264e493e99ae5024e4dfe3ea5d5a09718), [`ece8dba`](https://github.com/mastra-ai/mastra/commit/ece8dba7ec1a5089eee8c33167cd762bfa91e509), [`e751af2`](https://github.com/mastra-ai/mastra/commit/e751af219433fbf4c7035b2d771b4c9ec8813b05), [`e2a8380`](https://github.com/mastra-ai/mastra/commit/e2a838017a7657850404c1e94c70d79ffdc6f14a), [`be3f1cd`](https://github.com/mastra-ai/mastra/commit/be3f1cd81f0e2a649e8eac15a024d542d814aef8), [`a34d9db`](https://github.com/mastra-ai/mastra/commit/a34d9dbc39fedb722f271318e9355ecee70489ab)]:
+  - @mastra/core@1.39.0-alpha.0
+
 ## 1.9.0
 
 ### Minor Changes

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-mongodb
 description: Documentation for @mastra/mongodb. Use when working with @mastra/mongodb APIs, configuration, or implementation.
 metadata:
   package: "@mastra/mongodb"
-  version: "1.9.0"
+  version: "1.9.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.9.0",
+  "version": "1.9.1",
   "package": "@mastra/mongodb",
   "exports": {},
   "modules": {}

package/dist/docs/references/docs-memory-working-memory.md

@@ -26,7 +26,7 @@ const agent = new Agent({
   id: 'personal-assistant',
   name: 'PersonalAssistant',
   instructions: 'You are a helpful personal assistant.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     options: {
       workingMemory: {
@@ -130,7 +130,7 @@ Resource-scoped working memory requires specific storage adapters that support t
 
 ## Custom templates
 
-Templates guide the agent on what information to track and update in working memory. While a default template is used if none is provided, you'll typically want to define a custom template tailored to your agent's specific use case to ensure it remembers the most relevant information.
+Templates guide the agent on what information to track and update in working memory. While a default template is used if none is provided, you'll typically want to define a custom template tailored to your agent's specific use case to ensure it remembers the most relevant information. For threads shared by multiple users, see [Multi-user threads](https://mastra.ai/docs/memory/multi-user-threads).
 
 Here's an example of a custom template. In this example the agent will store the users name, location, timezone, etc as soon as the user sends a message containing any of the info:
 
@@ -393,6 +393,33 @@ const response = await agent.generate('What do you know about me?', {
 })
 ```
 
+## Opt in to state signals (experimental)
+
+By default, working memory reaches the model as part of the system message. You can opt into delivering it as a [state signal](https://mastra.ai/docs/agents/signals) instead by setting `useStateSignals: true`:
+
+```typescript
+const memory = new Memory({
+  storage: new LibSQLStore({ url: 'file:./mastra.db' }),
+  options: {
+    workingMemory: {
+      enabled: true,
+      template: '# User\n- name:\n- location:',
+      useStateSignals: true, // experimental: deliver as state signal
+    },
+  },
+})
+```
+
+What changes:
+
+- **Storage is identical.** The same resource/thread `workingMemory` field is read and written.
+- **The tool is the same shape, exposed under a new name.** Writes still flow through the same underlying tool; on this path it is registered as `setWorkingMemory` (instead of `updateWorkingMemory`). The rename keeps legacy strip filters from removing tool-call parts so they persist as a normal audit trail and the next model step picks the new value up automatically.
+- **Delivery only.** Instead of folding into the system prompt, `Memory` auto-attaches a `WorkingMemoryStateProcessor` that emits the current working memory as a `state` signal with `stateId: 'working-memory'`.
+
+You inherit the standard state-signal benefits: thread-scoped tracking metadata, `cacheKey` dedup so identical snapshots are only emitted once, and `contextWindow.hasSnapshot` re-injection when an older snapshot rolls out of the window.
+
+The default (`useStateSignals: false`) keeps the existing system-message behavior unchanged. `useStateSignals` is not supported with template working memory `version: 'vnext'`.
+
 ## Examples
 
 - [Working memory with template](https://github.com/mastra-ai/mastra/tree/main/examples/memory-with-template)

package/dist/docs/references/docs-rag-retrieval.md

@@ -272,7 +272,7 @@ import { PGVECTOR_PROMPT } from '@mastra/pg'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${PGVECTOR_PROMPT}
@@ -289,7 +289,7 @@ import { PINECONE_PROMPT } from '@mastra/pinecone'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${PINECONE_PROMPT}
@@ -306,7 +306,7 @@ import { QDRANT_PROMPT } from '@mastra/qdrant'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${QDRANT_PROMPT}
@@ -323,7 +323,7 @@ import { CHROMA_PROMPT } from '@mastra/chroma'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${CHROMA_PROMPT}
@@ -340,7 +340,7 @@ import { ASTRA_PROMPT } from '@mastra/astra'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${ASTRA_PROMPT}
@@ -357,7 +357,7 @@ import { LIBSQL_PROMPT } from '@mastra/libsql'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${LIBSQL_PROMPT}
@@ -374,7 +374,7 @@ import { UPSTASH_PROMPT } from '@mastra/upstash'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${UPSTASH_PROMPT}
@@ -391,7 +391,7 @@ import { VECTORIZE_PROMPT } from '@mastra/vectorize'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${VECTORIZE_PROMPT}
@@ -408,7 +408,7 @@ import { MONGODB_PROMPT } from '@mastra/mongodb'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${MONGODB_PROMPT}
@@ -425,7 +425,7 @@ import { OPENSEARCH_PROMPT } from '@mastra/opensearch'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${OPENSEARCH_PROMPT}
@@ -442,7 +442,7 @@ import { S3VECTORS_PROMPT } from '@mastra/s3vectors'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${S3VECTORS_PROMPT}
@@ -472,7 +472,10 @@ const initialResults = await pgVector.query({
 })
 
 // Create a relevance scorer
-const relevanceProvider = new MastraAgentRelevanceScorer('relevance-scorer', 'openai/gpt-5.4')
+const relevanceProvider = new MastraAgentRelevanceScorer(
+  'relevance-scorer',
+  'openai/gpt-5.5',
+)
 
 // Re-rank the results
 const rerankedResults = await rerank({

package/dist/docs/references/reference-storage-mongodb.md

@@ -97,6 +97,9 @@ The storage implementation handles collection creation and management automatica
 - `mastra_traces`: Stores telemetry and tracing data
 - `mastra_scorers`: Stores scoring and evaluation data
 - `mastra_resources`: Stores resource working memory data
+- `mastra_notifications`: Stores notification inbox records and delivery metadata
+
+`MongoDBStore` exposes notification storage through `getStore('notifications')`.
 
 ### Initialization
 
@@ -206,7 +209,7 @@ export const mongodbAgent = new Agent({
   name: 'mongodb-agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new MongoDBStore({
       uri: process.env.MONGODB_URI!,

package/dist/docs/references/reference-vectors-mongodb.md

@@ -263,7 +263,7 @@ export const mongodbAgent = new Agent({
   name: 'mongodb-agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new MongoDBStore({
       id: 'mongodb-storage',

package/dist/index.cjs

@@ -14,7 +14,7 @@ var evals = require('@mastra/core/evals');
 
 // package.json
 var package_default = {
-  version: "1.9.0"};
+  version: "1.9.1"};
 var MongoDBFilterTranslator = class extends filter.BaseFilterTranslator {
   getSupportedOperators() {
     return {
@@ -6287,6 +6287,294 @@ ${unreflectedContent}` : bufferedReflection;
     }
   }
 };
+var statusTimestamp = (status, now) => {
+  if (status === "delivered") return { deliveredAt: now };
+  if (status === "seen") return { seenAt: now };
+  if (status === "dismissed") return { dismissedAt: now };
+  if (status === "archived") return { archivedAt: now };
+  if (status === "discarded") return { discardedAt: now };
+  return {};
+};
+var cloneDate = (value) => value ? new Date(value) : void 0;
+var cloneValue = (value) => value === void 0 ? void 0 : structuredClone(value);
+var cloneRecord = (record) => ({
+  ...record,
+  createdAt: new Date(record.createdAt),
+  updatedAt: new Date(record.updatedAt),
+  deliveredAt: cloneDate(record.deliveredAt),
+  seenAt: cloneDate(record.seenAt),
+  dismissedAt: cloneDate(record.dismissedAt),
+  archivedAt: cloneDate(record.archivedAt),
+  discardedAt: cloneDate(record.discardedAt),
+  deliverAt: cloneDate(record.deliverAt),
+  summaryAt: cloneDate(record.summaryAt),
+  lastDeliveryAttemptAt: cloneDate(record.lastDeliveryAttemptAt),
+  payload: cloneValue(record.payload),
+  attributes: cloneValue(record.attributes),
+  metadata: cloneValue(record.metadata)
+});
+function rowToNotification(row) {
+  return {
+    id: row.id,
+    threadId: row.threadId,
+    source: row.source,
+    kind: row.kind,
+    priority: row.priority,
+    status: row.status,
+    summary: row.summary,
+    payload: row.payload ?? void 0,
+    resourceId: row.resourceId ?? void 0,
+    agentId: row.agentId ?? void 0,
+    sourceId: row.sourceId ?? void 0,
+    dedupeKey: row.dedupeKey ?? void 0,
+    coalesceKey: row.coalesceKey ?? void 0,
+    coalescedCount: Number(row.coalescedCount ?? 1),
+    attributes: row.attributes,
+    createdAt: row.createdAt instanceof Date ? row.createdAt : new Date(row.createdAt),
+    updatedAt: row.updatedAt instanceof Date ? row.updatedAt : new Date(row.updatedAt),
+    deliveredAt: row.deliveredAt ? row.deliveredAt instanceof Date ? row.deliveredAt : new Date(row.deliveredAt) : void 0,
+    seenAt: row.seenAt ? row.seenAt instanceof Date ? row.seenAt : new Date(row.seenAt) : void 0,
+    dismissedAt: row.dismissedAt ? row.dismissedAt instanceof Date ? row.dismissedAt : new Date(row.dismissedAt) : void 0,
+    archivedAt: row.archivedAt ? row.archivedAt instanceof Date ? row.archivedAt : new Date(row.archivedAt) : void 0,
+    discardedAt: row.discardedAt ? row.discardedAt instanceof Date ? row.discardedAt : new Date(row.discardedAt) : void 0,
+    deliverAt: row.deliverAt ? row.deliverAt instanceof Date ? row.deliverAt : new Date(row.deliverAt) : void 0,
+    summaryAt: row.summaryAt ? row.summaryAt instanceof Date ? row.summaryAt : new Date(row.summaryAt) : void 0,
+    deliveryReason: row.deliveryReason ?? void 0,
+    deliveryAttempts: Number(row.deliveryAttempts ?? 0),
+    lastDeliveryAttemptAt: row.lastDeliveryAttemptAt ? row.lastDeliveryAttemptAt instanceof Date ? row.lastDeliveryAttemptAt : new Date(row.lastDeliveryAttemptAt) : void 0,
+    lastDeliveryError: row.lastDeliveryError ?? void 0,
+    deliveredSignalId: row.deliveredSignalId ?? void 0,
+    summarySignalId: row.summarySignalId ?? void 0,
+    metadata: row.metadata ?? void 0
+  };
+}
+function recordToDocument(record) {
+  return {
+    ...record,
+    payload: record.payload ?? null,
+    resourceId: record.resourceId ?? null,
+    agentId: record.agentId ?? null,
+    sourceId: record.sourceId ?? null,
+    dedupeKey: record.dedupeKey ?? null,
+    coalesceKey: record.coalesceKey ?? null,
+    attributes: record.attributes ?? null,
+    deliveredAt: record.deliveredAt ?? null,
+    seenAt: record.seenAt ?? null,
+    dismissedAt: record.dismissedAt ?? null,
+    archivedAt: record.archivedAt ?? null,
+    discardedAt: record.discardedAt ?? null,
+    deliverAt: record.deliverAt ?? null,
+    summaryAt: record.summaryAt ?? null,
+    deliveryReason: record.deliveryReason ?? null,
+    lastDeliveryAttemptAt: record.lastDeliveryAttemptAt ?? null,
+    lastDeliveryError: record.lastDeliveryError ?? null,
+    deliveredSignalId: record.deliveredSignalId ?? null,
+    summarySignalId: record.summarySignalId ?? null,
+    metadata: record.metadata ?? null
+  };
+}
+var NotificationsMongoDB = class _NotificationsMongoDB extends storage.NotificationsStorage {
+  #connector;
+  #skipDefaultIndexes;
+  #indexes;
+  static MANAGED_COLLECTIONS = [storage.TABLE_NOTIFICATIONS];
+  constructor(config) {
+    super();
+    this.#connector = resolveMongoDBConfig(config);
+    this.#skipDefaultIndexes = config.skipDefaultIndexes;
+    this.#indexes = config.indexes?.filter(
+      (idx) => _NotificationsMongoDB.MANAGED_COLLECTIONS.includes(idx.collection)
+    );
+  }
+  async getCollection() {
+    return this.#connector.getCollection(storage.TABLE_NOTIFICATIONS);
+  }
+  async init() {
+    await this.createDefaultIndexes();
+    await this.createCustomIndexes();
+  }
+  getDefaultIndexDefinitions() {
+    return [
+      { collection: storage.TABLE_NOTIFICATIONS, keys: { threadId: 1, id: 1 }, options: { unique: true } },
+      { collection: storage.TABLE_NOTIFICATIONS, keys: { threadId: 1, status: 1, updatedAt: -1 } },
+      {
+        collection: storage.TABLE_NOTIFICATIONS,
+        keys: { threadId: 1, source: 1, kind: 1, status: 1, agentId: 1, resourceId: 1, dedupeKey: 1, coalesceKey: 1 }
+      },
+      { collection: storage.TABLE_NOTIFICATIONS, keys: { status: 1, deliverAt: 1, summaryAt: 1 } }
+    ];
+  }
+  async createDefaultIndexes() {
+    if (this.#skipDefaultIndexes) return;
+    for (const indexDef of this.getDefaultIndexDefinitions()) {
+      try {
+        const collection = await this.#connector.getCollection(indexDef.collection);
+        await collection.createIndex(indexDef.keys, indexDef.options);
+      } catch (error) {
+        this.logger?.warn?.(`Failed to create index on ${indexDef.collection}:`, error);
+      }
+    }
+  }
+  async createCustomIndexes() {
+    if (!this.#indexes || this.#indexes.length === 0) return;
+    for (const indexDef of this.#indexes) {
+      try {
+        const collection = await this.#connector.getCollection(indexDef.collection);
+        await collection.createIndex(indexDef.keys, indexDef.options);
+      } catch (error) {
+        this.logger?.warn?.(`Failed to create custom index on ${indexDef.collection}:`, error);
+      }
+    }
+  }
+  async dangerouslyClearAll() {
+    const collection = await this.getCollection();
+    await collection.deleteMany({});
+  }
+  async createNotification(input) {
+    const existing = await this.findCoalescable(input);
+    const collection = await this.getCollection();
+    if (existing) {
+      const now2 = /* @__PURE__ */ new Date();
+      const attributes = input.attributes ? { ...cloneValue(existing.attributes), ...cloneValue(input.attributes) } : cloneValue(existing.attributes);
+      const metadata = input.metadata ? { ...cloneValue(existing.metadata), ...cloneValue(input.metadata) } : cloneValue(existing.metadata);
+      await collection.updateOne(
+        { threadId: existing.threadId, id: existing.id },
+        {
+          $set: {
+            summary: input.summary,
+            payload: cloneValue(input.payload ?? existing.payload) ?? null,
+            priority: input.priority ?? existing.priority,
+            attributes: attributes ?? null,
+            updatedAt: now2,
+            deliverAt: input.deliverAt ?? existing.deliverAt ?? null,
+            summaryAt: input.summaryAt ?? existing.summaryAt ?? null,
+            deliveryReason: input.deliveryReason ?? existing.deliveryReason ?? null,
+            metadata: metadata ?? null
+          },
+          $inc: { coalescedCount: 1 }
+        }
+      );
+      const updated = await this.getNotification({ threadId: existing.threadId, id: existing.id });
+      if (!updated) throw new Error(`Notification ${existing.id} was not found for thread ${existing.threadId}`);
+      return updated;
+    }
+    const now = input.createdAt ?? /* @__PURE__ */ new Date();
+    const record = {
+      id: input.id ?? crypto$1.randomUUID(),
+      threadId: input.threadId,
+      source: input.source,
+      kind: input.kind,
+      priority: input.priority ?? "medium",
+      status: "pending",
+      summary: input.summary,
+      payload: cloneValue(input.payload),
+      resourceId: input.resourceId,
+      agentId: input.agentId,
+      sourceId: input.sourceId,
+      dedupeKey: input.dedupeKey,
+      coalesceKey: input.coalesceKey,
+      coalescedCount: 1,
+      attributes: cloneValue(input.attributes),
+      createdAt: now,
+      updatedAt: now,
+      deliverAt: input.deliverAt,
+      summaryAt: input.summaryAt,
+      deliveryReason: input.deliveryReason,
+      deliveryAttempts: 0,
+      metadata: cloneValue(input.metadata)
+    };
+    await collection.insertOne(recordToDocument(record));
+    return cloneRecord(record);
+  }
+  async listNotifications(input) {
+    const filter = { threadId: input.threadId };
+    if (input.status) filter.status = Array.isArray(input.status) ? { $in: input.status } : input.status;
+    if (input.priority) filter.priority = Array.isArray(input.priority) ? { $in: input.priority } : input.priority;
+    if (input.source) filter.source = input.source;
+    if (input.resourceId) filter.resourceId = input.resourceId;
+    if (input.agentId) filter.agentId = input.agentId;
+    if (input.search) {
+      const search = input.search.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+      filter.$or = [{ summary: { $regex: search, $options: "i" } }, { kind: { $regex: search, $options: "i" } }];
+    }
+    const collection = await this.getCollection();
+    const cursor = collection.find(filter).sort({ updatedAt: -1 });
+    if (input.limit) cursor.limit(input.limit);
+    const rows = await cursor.toArray();
+    return rows.map((row) => rowToNotification(row));
+  }
+  async listDueNotifications(input) {
+    const filter = {
+      status: "pending",
+      $or: [{ deliverAt: { $ne: null, $lte: input.now } }, { summaryAt: { $ne: null, $lte: input.now } }]
+    };
+    if (input.agentId) filter.agentId = input.agentId;
+    if (input.resourceId) filter.resourceId = input.resourceId;
+    const collection = await this.getCollection();
+    const rows = await collection.find(filter).sort({ updatedAt: 1 }).toArray();
+    const due = rows.map((row) => rowToNotification(row)).sort((a, b) => dueTime(a) - dueTime(b) || a.updatedAt.getTime() - b.updatedAt.getTime());
+    return due.slice(0, input.limit ?? due.length).map(cloneRecord);
+  }
+  async getNotification(input) {
+    const collection = await this.getCollection();
+    const row = await collection.findOne({ threadId: input.threadId, id: input.id });
+    return row ? rowToNotification(row) : null;
+  }
+  async updateNotification(input) {
+    const existing = await this.getNotification({ threadId: input.threadId, id: input.id });
+    if (!existing) {
+      throw new Error(`Notification ${input.id} was not found for thread ${input.threadId}`);
+    }
+    const now = /* @__PURE__ */ new Date();
+    const set = {
+      ...input.status ? { status: input.status, ...statusTimestamp(input.status, now) } : {},
+      ...input.summary !== void 0 ? { summary: input.summary } : {},
+      ...input.payload !== void 0 ? { payload: cloneValue(input.payload) } : {},
+      ...input.attributes !== void 0 ? { attributes: cloneValue(input.attributes) } : {},
+      ...input.metadata !== void 0 ? { metadata: cloneValue(input.metadata) } : {},
+      ...input.deliverAt !== void 0 ? { deliverAt: input.deliverAt } : {},
+      ...input.summaryAt !== void 0 ? { summaryAt: input.summaryAt } : {},
+      ...input.deliveryReason !== void 0 ? { deliveryReason: input.deliveryReason } : {},
+      ...input.deliveryAttempts !== void 0 ? { deliveryAttempts: input.deliveryAttempts } : {},
+      ...input.lastDeliveryAttemptAt !== void 0 ? { lastDeliveryAttemptAt: input.lastDeliveryAttemptAt } : {},
+      ...input.lastDeliveryError !== void 0 ? { lastDeliveryError: input.lastDeliveryError } : {},
+      ...input.deliveredSignalId !== void 0 ? { deliveredSignalId: input.deliveredSignalId } : {},
+      ...input.summarySignalId !== void 0 ? { summarySignalId: input.summarySignalId } : {},
+      updatedAt: now
+    };
+    const collection = await this.getCollection();
+    await collection.updateOne({ threadId: input.threadId, id: input.id }, { $set: set });
+    const updated = await this.getNotification({ threadId: input.threadId, id: input.id });
+    if (!updated) throw new Error(`Notification ${input.id} was not found for thread ${input.threadId}`);
+    return updated;
+  }
+  async findCoalescable(input) {
+    if (!input.dedupeKey && !input.coalesceKey) return void 0;
+    const collection = await this.getCollection();
+    const row = await collection.findOne(
+      {
+        threadId: input.threadId,
+        source: input.source,
+        kind: input.kind,
+        status: "pending",
+        agentId: input.agentId ?? null,
+        resourceId: input.resourceId ?? null,
+        $or: [
+          ...input.dedupeKey ? [{ dedupeKey: input.dedupeKey }] : [],
+          ...input.coalesceKey ? [{ coalesceKey: input.coalesceKey }] : []
+        ]
+      },
+      { sort: { updatedAt: -1 } }
+    );
+    return row ? rowToNotification(row) : void 0;
+  }
+};
+var dueTime = (record) => {
+  const deliverAt = record.deliverAt?.getTime();
+  const summaryAt = record.summaryAt?.getTime();
+  if (deliverAt !== void 0 && summaryAt !== void 0) return Math.min(deliverAt, summaryAt);
+  return deliverAt ?? summaryAt ?? Number.POSITIVE_INFINITY;
+};
 var ObservabilityMongoDB = class _ObservabilityMongoDB extends storage.ObservabilityStorage {
   #connector;
   #skipDefaultIndexes;
@@ -10351,6 +10639,7 @@ var MongoDBStore = class extends storage.MastraCompositeStore {
       indexes: config.indexes
     };
     const memory = new MemoryStorageMongoDB(domainConfig);
+    const notifications = new NotificationsMongoDB(domainConfig);
     const scores = new ScoresStorageMongoDB(domainConfig);
     const workflows = new WorkflowsStorageMongoDB(domainConfig);
     const observability = new ObservabilityMongoDB(domainConfig);
@@ -10368,6 +10657,7 @@ var MongoDBStore = class extends storage.MastraCompositeStore {
     const schedules = new SchedulesMongoDB(domainConfig);
     this.stores = {
       memory,
+      notifications,
       scores,
       workflows,
       observability,
@@ -10516,6 +10806,7 @@ exports.MongoDBSkillsStorage = MongoDBSkillsStorage;
 exports.MongoDBStore = MongoDBStore;
 exports.MongoDBVector = MongoDBVector;
 exports.MongoDBWorkspacesStorage = MongoDBWorkspacesStorage;
+exports.NotificationsMongoDB = NotificationsMongoDB;
 exports.ObservabilityMongoDB = ObservabilityMongoDB;
 exports.SchedulesMongoDB = SchedulesMongoDB;
 exports.ScoresStorageMongoDB = ScoresStorageMongoDB;