@mastra/redis-streams 0.0.0 → 0.0.2-alpha.0

package/LICENSE.md

@@ -0,0 +1,30 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named "ee/" within this
+  repository, including but not limited to:
+  - `packages/core/src/auth/ee/`
+  - `packages/server/src/server/auth/ee/`
+    is licensed under the license defined in `ee/LICENSE`.
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/dist/index.cjs

@@ -0,0 +1,360 @@
+'use strict';
+
+var crypto = require('crypto');
+var events = require('@mastra/core/events');
+var redis = require('redis');
+
+// src/index.ts
+var RedisStreamsPubSub = class extends events.PubSub {
+  // Redis Streams is a pull transport: consumers issue XREADGROUP to read
+  // events. Mastra reads this to know an OrchestrationWorker is required.
+  get supportedModes() {
+    return ["pull"];
+  }
+  #writeClient;
+  #connectOptions;
+  #keyPrefix;
+  #blockMs;
+  #maxStreamLength;
+  #reclaimIntervalMs;
+  #reclaimIdleMs;
+  #maxDeliveryAttempts;
+  #logger;
+  // Keyed by `${topic}::${cbId}` so the same callback can be subscribed to
+  // multiple topics independently. Without the topic in the key,
+  // unsubscribe(otherTopic, cb) would tear down the wrong subscription.
+  #subscriptions = /* @__PURE__ */ new Map();
+  #cbIds = /* @__PURE__ */ new WeakMap();
+  #pendingPublishes = /* @__PURE__ */ new Set();
+  #closed = false;
+  constructor(options = {}) {
+    super();
+    const url = options.url ?? options.redisOptions?.url ?? "redis://localhost:6379";
+    this.#connectOptions = { ...options.redisOptions, url };
+    this.#writeClient = redis.createClient(this.#connectOptions);
+    this.#keyPrefix = options.keyPrefix ?? "mastra:topic";
+    this.#blockMs = options.blockMs ?? 1e3;
+    this.#maxStreamLength = options.maxStreamLength ?? 1e4;
+    this.#reclaimIntervalMs = options.reclaimIntervalMs ?? 3e4;
+    this.#reclaimIdleMs = options.reclaimIdleMs ?? 6e4;
+    const cap = options.maxDeliveryAttempts ?? 5;
+    if (cap === 0) {
+      options.logger?.warn?.(
+        "redis-streams: maxDeliveryAttempts=0 is treated as Infinity for back-compat; pass Infinity to disable the cap explicitly."
+      );
+      this.#maxDeliveryAttempts = Infinity;
+    } else if (cap < 0 || Number.isNaN(cap)) {
+      throw new Error(`redis-streams: maxDeliveryAttempts must be >= 1 or Infinity, got ${cap}`);
+    } else {
+      this.#maxDeliveryAttempts = cap;
+    }
+    this.#logger = options.logger;
+  }
+  #subKey(topic, cb) {
+    let cbId = this.#cbIds.get(cb);
+    if (!cbId) {
+      cbId = crypto.randomUUID();
+      this.#cbIds.set(cb, cbId);
+    }
+    return `${topic}::${cbId}`;
+  }
+  /** Lazily connect the shared writer client. Idempotent. */
+  async #ensureWriterConnected() {
+    if (this.#writeClient.isOpen) return;
+    await this.#writeClient.connect();
+  }
+  #streamKey(topic) {
+    return `${this.#keyPrefix}:${topic}`;
+  }
+  async publish(topic, event) {
+    if (this.#closed) throw new Error("RedisStreamsPubSub: cannot publish on closed client");
+    await this.#ensureWriterConnected();
+    const id = crypto.randomUUID();
+    const createdAt = /* @__PURE__ */ new Date();
+    const payload = {
+      ...event,
+      id,
+      createdAt,
+      deliveryAttempt: event.deliveryAttempt ?? 1
+    };
+    const xaddOptions = {};
+    if (this.#maxStreamLength > 0) {
+      xaddOptions.TRIM = {
+        strategy: "MAXLEN",
+        strategyModifier: "~",
+        threshold: this.#maxStreamLength
+      };
+    }
+    const promise = this.#writeClient.xAdd(
+      this.#streamKey(topic),
+      "*",
+      { event: JSON.stringify(payload) },
+      xaddOptions
+    );
+    this.#pendingPublishes.add(promise);
+    try {
+      await promise;
+    } finally {
+      this.#pendingPublishes.delete(promise);
+    }
+  }
+  async subscribe(topic, cb, options) {
+    if (this.#closed) throw new Error("RedisStreamsPubSub: cannot subscribe on closed client");
+    const key = this.#subKey(topic, cb);
+    if (this.#subscriptions.has(key)) return;
+    await this.#ensureWriterConnected();
+    const isGrouped = !!options?.group;
+    const group = options?.group ?? `__fanout-${crypto.randomUUID()}`;
+    const consumer = `${group}-${crypto.randomUUID()}`;
+    const streamKey = this.#streamKey(topic);
+    try {
+      await this.#writeClient.xGroupCreate(streamKey, group, "0", { MKSTREAM: true });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (!msg.includes("BUSYGROUP")) throw err;
+      this.#logger?.debug?.("redis-streams: consumer group already exists", { topic, group });
+    }
+    const readClient = redis.createClient(this.#connectOptions);
+    await readClient.connect();
+    const sub = {
+      cb,
+      topic,
+      streamKey,
+      group,
+      consumer,
+      isGrouped,
+      readClient,
+      stopped: false,
+      loop: void 0,
+      reclaimTimer: void 0
+    };
+    this.#subscriptions.set(key, sub);
+    sub.loop = this.#runReadLoop(sub);
+    this.#startReclaimLoop(sub);
+  }
+  /**
+   * Periodically run XAUTOCLAIM against this subscription's group so that
+   * messages a crashed/stuck consumer read but never acked get redelivered to
+   * a live sibling. Runs only for grouped subscriptions — fan-out groups are
+   * private to one consumer, so there's no sibling to claim from.
+   */
+  #startReclaimLoop(sub) {
+    if (this.#reclaimIntervalMs <= 0) return;
+    if (!sub.isGrouped) return;
+    const tick = async () => {
+      if (sub.stopped || this.#closed) return;
+      try {
+        const reply = await this.#writeClient.xAutoClaim(
+          sub.streamKey,
+          sub.group,
+          sub.consumer,
+          this.#reclaimIdleMs,
+          "0-0",
+          { COUNT: 100 }
+        );
+        const messages = reply?.messages ?? [];
+        for (const entry of messages) {
+          if (sub.stopped || this.#closed) return;
+          if (!entry) continue;
+          await this.#deliverMessage(sub, entry.id, entry.message);
+        }
+      } catch (err) {
+        this.#logger?.debug?.("redis-streams: XAUTOCLAIM failed", {
+          topic: sub.topic,
+          group: sub.group,
+          err: err instanceof Error ? err.message : err
+        });
+      }
+      if (sub.stopped || this.#closed) return;
+      sub.reclaimTimer = setTimeout(tick, this.#reclaimIntervalMs);
+    };
+    sub.reclaimTimer = setTimeout(tick, this.#reclaimIntervalMs);
+  }
+  async unsubscribe(topic, cb) {
+    const key = this.#subKey(topic, cb);
+    const sub = this.#subscriptions.get(key);
+    if (!sub) return;
+    this.#subscriptions.delete(key);
+    sub.stopped = true;
+    if (sub.reclaimTimer) {
+      clearTimeout(sub.reclaimTimer);
+      sub.reclaimTimer = void 0;
+    }
+    try {
+      await sub.readClient.quit();
+    } catch (err) {
+      this.#logger?.debug?.("redis-streams: reader quit failed", {
+        topic: sub.topic,
+        err: err instanceof Error ? err.message : err
+      });
+    }
+    if (sub.loop) {
+      try {
+        await sub.loop;
+      } catch (err) {
+        this.#logger?.debug?.("redis-streams: read loop exited with error", {
+          topic: sub.topic,
+          err: err instanceof Error ? err.message : err
+        });
+      }
+    }
+    if (!sub.isGrouped) {
+      try {
+        await this.#writeClient.xGroupDestroy(sub.streamKey, sub.group);
+      } catch (err) {
+        this.#logger?.debug?.("redis-streams: xGroupDestroy failed", {
+          topic: sub.topic,
+          group: sub.group,
+          err: err instanceof Error ? err.message : err
+        });
+      }
+    }
+  }
+  async flush() {
+    if (this.#pendingPublishes.size > 0) {
+      await Promise.allSettled([...this.#pendingPublishes]);
+    }
+  }
+  /**
+   * Disconnect all clients and stop all subscription loops.
+   */
+  async close() {
+    if (this.#closed) return;
+    this.#closed = true;
+    const subs = [...this.#subscriptions.values()];
+    await Promise.all(subs.map((sub) => this.unsubscribe(sub.topic, sub.cb)));
+    if (this.#writeClient.isOpen) {
+      try {
+        await this.#writeClient.quit();
+      } catch (err) {
+        this.#logger?.debug?.("redis-streams: writer quit failed", {
+          err: err instanceof Error ? err.message : err
+        });
+      }
+    }
+  }
+  async #runReadLoop(sub) {
+    while (!sub.stopped) {
+      let result;
+      try {
+        result = await sub.readClient.xReadGroup(sub.group, sub.consumer, [{ key: sub.streamKey, id: ">" }], {
+          COUNT: 10,
+          BLOCK: this.#blockMs
+        });
+      } catch (err) {
+        if (sub.stopped) return;
+        this.#logger?.debug?.("redis-streams: xReadGroup failed", {
+          topic: sub.topic,
+          group: sub.group,
+          err: err instanceof Error ? err.message : err
+        });
+        await new Promise((r) => setTimeout(r, 100));
+        continue;
+      }
+      if (!result || result.length === 0) continue;
+      for (const stream of result) {
+        for (const entry of stream.messages) {
+          if (sub.stopped) return;
+          await this.#deliverMessage(sub, entry.id, entry.message);
+        }
+      }
+    }
+  }
+  async #deliverMessage(sub, streamId, fields) {
+    let event;
+    try {
+      event = JSON.parse(fields.event ?? "{}");
+      if (typeof event.createdAt === "string") {
+        event.createdAt = new Date(event.createdAt);
+      }
+    } catch (err) {
+      this.#logger?.debug?.("redis-streams: malformed payload, dropping", {
+        topic: sub.topic,
+        streamId,
+        err: err instanceof Error ? err.message : err
+      });
+      try {
+        await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);
+      } catch (ackErr) {
+        this.#logger?.debug?.("redis-streams: xAck after malformed payload failed", {
+          topic: sub.topic,
+          err: ackErr instanceof Error ? ackErr.message : ackErr
+        });
+      }
+      return;
+    }
+    let settled = false;
+    const ack = async () => {
+      if (settled) return;
+      settled = true;
+      try {
+        await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);
+      } catch (err) {
+        this.#logger?.debug?.("redis-streams: ack cleanup failed", {
+          topic: sub.topic,
+          err: err instanceof Error ? err.message : err
+        });
+      }
+    };
+    const nack = async () => {
+      if (settled) return;
+      settled = true;
+      const attempt = event.deliveryAttempt ?? 1;
+      if (attempt >= this.#maxDeliveryAttempts) {
+        this.#logger?.warn?.("redis-streams: dropping event after max delivery attempts", {
+          topic: sub.topic,
+          eventType: event.type,
+          eventId: event.id,
+          attempt,
+          max: this.#maxDeliveryAttempts
+        });
+        try {
+          await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);
+        } catch (err) {
+          this.#logger?.debug?.("redis-streams: ack on dropped poison message failed", {
+            topic: sub.topic,
+            err: err instanceof Error ? err.message : err
+          });
+        }
+        return;
+      }
+      const next = {
+        ...event,
+        deliveryAttempt: attempt + 1
+      };
+      try {
+        await this.#writeClient.xAdd(sub.streamKey, "*", { event: JSON.stringify(next) });
+      } catch (err) {
+        this.#logger?.warn?.("redis-streams: nack republish failed; leaving original pending for reclaim", {
+          topic: sub.topic,
+          eventId: event.id,
+          err: err instanceof Error ? err.message : err
+        });
+        settled = false;
+        return;
+      }
+      try {
+        await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);
+      } catch (err) {
+        this.#logger?.debug?.("redis-streams: xAck after nack failed", {
+          topic: sub.topic,
+          err: err instanceof Error ? err.message : err
+        });
+      }
+    };
+    try {
+      const result = sub.cb(event, ack, nack);
+      if (result && typeof result.catch === "function") {
+        result.catch(async () => {
+          await nack();
+        });
+      }
+    } catch {
+      await nack();
+    }
+  }
+};
+
+exports.RedisStreamsPubSub = RedisStreamsPubSub;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["PubSub","createClient","randomUUID"],"mappings":";;;;;;;AA2DO,IAAM,kBAAA,GAAN,cAAiCA,aAAA,CAAO;AAAA;AAAA;AAAA,EAG7C,IAAa,cAAA,GAAoD;AAC/D,IAAA,OAAO,CAAC,MAAM,CAAA;AAAA,EAChB;AAAA,EAEA,YAAA;AAAA,EACA,eAAA;AAAA,EACA,UAAA;AAAA,EACA,QAAA;AAAA,EACA,gBAAA;AAAA,EACA,kBAAA;AAAA,EACA,cAAA;AAAA,EACA,oBAAA;AAAA,EACA,OAAA;AAAA;AAAA;AAAA;AAAA,EAIA,cAAA,uBAAgD,GAAA,EAAI;AAAA,EACpD,MAAA,uBAA6C,OAAA,EAAQ;AAAA,EACrD,iBAAA,uBAA+C,GAAA,EAAI;AAAA,EACnD,OAAA,GAAU,KAAA;AAAA,EAEV,WAAA,CAAY,OAAA,GAAoC,EAAC,EAAG;AAClD,IAAA,KAAA,EAAM;AACN,IAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,GAAA,IAAO,OAAA,CAAQ,cAAc,GAAA,IAAO,wBAAA;AACxD,IAAA,IAAA,CAAK,eAAA,GAAkB,EAAE,GAAG,OAAA,CAAQ,cAAc,GAAA,EAAI;AACtD,IAAA,IAAA,CAAK,YAAA,GAAeC,kBAAA,CAAa,IAAA,CAAK,eAAe,CAAA;AACrD,IAAA,IAAA,CAAK,UAAA,GAAa,QAAQ,SAAA,IAAa,cAAA;AACvC,IAAA,IAAA,CAAK,QAAA,GAAW,QAAQ,OAAA,IAAW,GAAA;AACnC,IAAA,IAAA,CAAK,gBAAA,GAAmB,QAAQ,eAAA,IAAmB,GAAA;AACnD,IAAA,IAAA,CAAK,kBAAA,GAAqB,QAAQ,iBAAA,IAAqB,GAAA;AACvD,IAAA,IAAA,CAAK,cAAA,GAAiB,QAAQ,aAAA,IAAiB,GAAA;AAC/C,IAAA,MAAM,GAAA,GAAM,QAAQ,mBAAA,IAAuB,CAAA;AAC3C,IAAA,IAAI,QAAQ,CAAA,EAAG;AACb,MAAA,OAAA,CAAQ,MAAA,EAAQ,IAAA;AAAA,QACd;AAAA,OACF;AACA,MAAA,IAAA,CAAK,oBAAA,GAAuB,QAAA;AAAA,IAC9B,WAAW,GAAA,GAAM,CAAA,IAAK,MAAA,CAAO,KAAA,CAAM,GAAG,CAAA,EAAG;AACvC,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,iEAAA,EAAoE,GAAG,CAAA,CAAE,CAAA;AAAA,IAC3F,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,oBAAA,GAAuB,GAAA;AAAA,IAC9B;AACA,IAAA,IAAA,CAAK,UAAU,OAAA,CAAQ,MAAA;AAAA,EACzB;AAAA,EAEA,OAAA,CAAQ,OAAe,EAAA,EAA2B;AAChD,IAAA,IAAI,IAAA,GAAO,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,EAAE,CAAA;AAC7B,IAAA,IAAI,CAAC,IAAA,EAAM;AACT,MAAA,IAAA,GAAOC,iBAAA,EAAW;AAClB,MAAA,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,EAAA,EAAI,IAAI,CAAA;AAAA,IAC1B;AACA,IAAA,OAAO,CAAA,EAAG,KAAK,CAAA,EAAA,EAAK,IAAI,CAAA,CAAA;AAAA,EAC1B;AAAA;AAAA,EAGA,MAAM,sBAAA,GAAwC;AAC5C,IAAA,IAAI,IAAA,CAAK,aAAa,MAAA,EAAQ;AAC9B,IAAA,MAAM,IAAA,CAAK,aAAa,OAAA,EAAQ;AAAA,EAClC;AAAA,EAEA,WAAW,KAAA,EAAuB;AAChC,IAAA,OAAO,CAAA,EAAG,IAAA,CAAK,UAAU,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA;AAAA,EACpC;AAAA,EAEA,MAAM,OAAA,CAAQ,KAAA,EAAe,KAAA,EAAuD;AAClF,IAAA,IAAI,IAAA,CAAK,OAAA,EAAS,MAAM,IAAI,MAAM,qDAAqD,CAAA;AACvF,IAAA,MAAM,KAAK,sBAAA,EAAuB;AAElC,IAAA,MAAM,KAAKA,iBAAA,EAAW;AACtB,IAAA,MAAM,SAAA,uBAAgB,IAAA,EAAK;AAC3B,IAAA,MAAM,OAAA,GAAiB;AAAA,MACrB,GAAG,KAAA;AAAA,MACH,EAAA;AAAA,MACA,SAAA;AAAA,MACA,eAAA,EAAiB,MAAM,eAAA,IAAmB;AAAA,KAC5C;AACA,IAAA,MAAM,cAA2F,EAAC;AAClG,IAAA,IAAI,IAAA,CAAK,mBAAmB,CAAA,EAAG;AAC7B,MAAA,WAAA,CAAY,IAAA,GAAO;AAAA,QACjB,QAAA,EAAU,QAAA;AAAA,QACV,gBAAA,EAAkB,GAAA;AAAA,QAClB,WAAW,IAAA,CAAK;AAAA,OAClB;AAAA,IACF;AACA,IAAA,MAAM,OAAA,GAAU,KAAK,YAAA,CAAa,IAAA;AAAA,MAChC,IAAA,CAAK,WAAW,KAAK,CAAA;AAAA,MACrB,GAAA;AAAA,MACA,EAAE,KAAA,EAAO,IAAA,CAAK,SAAA,CAAU,OAAO,CAAA,EAAE;AAAA,MACjC;AAAA,KACF;AACA,IAAA,IAAA,CAAK,iBAAA,CAAkB,IAAI,OAAO,CAAA;AAClC,IAAA,IAAI;AACF,MAAA,MAAM,OAAA;AAAA,IACR,CAAA,SAAE;AACA,MAAA,IAAA,CAAK,iBAAA,CAAkB,OAAO,OAAO,CAAA;AAAA,IACvC;AAAA,EACF;AAAA,EAEA,MAAM,SAAA,CAAU,KAAA,EAAe,EAAA,EAAmB,OAAA,EAA2C;AAC3F,IAAA,IAAI,IAAA,CAAK,OAAA,EAAS,MAAM,IAAI,MAAM,uDAAuD,CAAA;AACzF,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AAClC,IAAA,IAAI,IAAA,CAAK,cAAA,CAAe,GAAA,CAAI,GAAG,CAAA,EAAG;AAElC,IAAA,MAAM,KAAK,sBAAA,EAAuB;AAElC,IAAA,MAAM,SAAA,GAAY,CAAC,CAAC,OAAA,EAAS,KAAA;AAC7B,IAAA,MAAM,KAAA,GAAQ,OAAA,EAAS,KAAA,IAAS,CAAA,SAAA,EAAYA,mBAAY,CAAA,CAAA;AACxD,IAAA,MAAM,QAAA,GAAW,CAAA,EAAG,KAAK,CAAA,CAAA,EAAIA,mBAAY,CAAA,CAAA;AACzC,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,UAAA,CAAW,KAAK,CAAA;AAYvC,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,CAAK,aAAa,YAAA,CAAa,SAAA,EAAW,OAAO,GAAA,EAAK,EAAE,QAAA,EAAU,IAAA,EAAM,CAAA;AAAA,IAChF,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,MAAM,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC3D,MAAA,IAAI,CAAC,GAAA,CAAI,QAAA,CAAS,WAAW,GAAG,MAAM,GAAA;AACtC,MAAA,IAAA,CAAK,SAAS,KAAA,GAAQ,8CAAA,EAAgD,EAAE,KAAA,EAAO,OAAO,CAAA;AAAA,IACxF;AAIA,IAAA,MAAM,UAAA,GAAaD,kBAAA,CAAa,IAAA,CAAK,eAAe,CAAA;AACpD,IAAA,MAAM,WAAW,OAAA,EAAQ;AAEzB,IAAA,MAAM,GAAA,GAAoB;AAAA,MACxB,EAAA;AAAA,MACA,KAAA;AAAA,MACA,SAAA;AAAA,MACA,KAAA;AAAA,MACA,QAAA;AAAA,MACA,SAAA;AAAA,MACA,UAAA;AAAA,MACA,OAAA,EAAS,KAAA;AAAA,MACT,IAAA,EAAM,MAAA;AAAA,MACN,YAAA,EAAc;AAAA,KAChB;AACA,IAAA,IAAA,CAAK,cAAA,CAAe,GAAA,CAAI,GAAA,EAAK,GAAG,CAAA;AAChC,IAAA,GAAA,CAAI,IAAA,GAAO,IAAA,CAAK,YAAA,CAAa,GAAG,CAAA;AAChC,IAAA,IAAA,CAAK,kBAAkB,GAAG,CAAA;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,kBAAkB,GAAA,EAAyB;AACzC,IAAA,IAAI,IAAA,CAAK,sBAAsB,CAAA,EAAG;AAClC,IAAA,IAAI,CAAC,IAAI,SAAA,EAAW;AAEpB,IAAA,MAAM,OAAO,YAAY;AACvB,MAAA,IAAI,GAAA,CAAI,OAAA,IAAW,IAAA,CAAK,OAAA,EAAS;AACjC,MAAA,IAAI;AACF,QAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,YAAA,CAAa,UAAA;AAAA,UACpC,GAAA,CAAI,SAAA;AAAA,UACJ,GAAA,CAAI,KAAA;AAAA,UACJ,GAAA,CAAI,QAAA;AAAA,UACJ,IAAA,CAAK,cAAA;AAAA,UACL,KAAA;AAAA,UACA,EAAE,OAAO,GAAA;AAAI,SACf;AACA,QAAA,MAAM,QAAA,GAAY,KAAA,EAAO,QAAA,IAAY,EAAC;AACtC,QAAA,KAAA,MAAW,SAAS,QAAA,EAAU;AAC5B,UAAA,IAAI,GAAA,CAAI,OAAA,IAAW,IAAA,CAAK,OAAA,EAAS;AACjC,UAAA,IAAI,CAAC,KAAA,EAAO;AACZ,UAAA,MAAM,KAAK,eAAA,CAAgB,GAAA,EAAK,KAAA,CAAM,EAAA,EAAI,MAAM,OAAO,CAAA;AAAA,QACzD;AAAA,MACF,SAAS,GAAA,EAAK;AACZ,QAAA,IAAA,CAAK,OAAA,EAAS,QAAQ,kCAAA,EAAoC;AAAA,UACxD,OAAO,GAAA,CAAI,KAAA;AAAA,UACX,OAAO,GAAA,CAAI,KAAA;AAAA,UACX,GAAA,EAAK,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU;AAAA,SAC3C,CAAA;AAAA,MACH;AACA,MAAA,IAAI,GAAA,CAAI,OAAA,IAAW,IAAA,CAAK,OAAA,EAAS;AACjC,MAAA,GAAA,CAAI,YAAA,GAAe,UAAA,CAAW,IAAA,EAAM,IAAA,CAAK,kBAAkB,CAAA;AAAA,IAC7D,CAAA;AAEA,IAAA,GAAA,CAAI,YAAA,GAAe,UAAA,CAAW,IAAA,EAAM,IAAA,CAAK,kBAAkB,CAAA;AAAA,EAC7D;AAAA,EAEA,MAAM,WAAA,CAAY,KAAA,EAAe,EAAA,EAAkC;AACjE,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AAClC,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,cAAA,CAAe,GAAA,CAAI,GAAG,CAAA;AACvC,IAAA,IAAI,CAAC,GAAA,EAAK;AACV,IAAA,IAAA,CAAK,cAAA,CAAe,OAAO,GAAG,CAAA;AAC9B,IAAA,GAAA,CAAI,OAAA,GAAU,IAAA;AACd,IAAA,IAAI,IAAI,YAAA,EAAc;AACpB,MAAA,YAAA,CAAa,IAAI,YAAY,CAAA;AAC7B,MAAA,GAAA,CAAI,YAAA,GAAe,MAAA;AAAA,IACrB;AAGA,IAAA,IAAI;AACF,MAAA,MAAM,GAAA,CAAI,WAAW,IAAA,EAAK;AAAA,IAC5B,SAAS,GAAA,EAAK;AACZ,MAAA,IAAA,CAAK,OAAA,EAAS,QAAQ,mCAAA,EAAqC;AAAA,QACzD,OAAO,GAAA,CAAI,KAAA;AAAA,QACX,GAAA,EAAK,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU;AAAA,OAC3C,CAAA;AAAA,IACH;AAEA,IAAA,IAAI,IAAI,IAAA,EAAM;AACZ,MAAA,IAAI;AACF,QAAA,MAAM,GAAA,CAAI,IAAA;AAAA,MACZ,SAAS,GAAA,EAAK;AAEZ,QAAA,IAAA,CAAK,OAAA,EAAS,QAAQ,4CAAA,EAA8C;AAAA,UAClE,OAAO,GAAA,CAAI,KAAA;AAAA,UACX,GAAA,EAAK,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU;AAAA,SAC3C,CAAA;AAAA,MACH;AAAA,IACF;AAGA,IAAA,IAAI,CAAC,IAAI,SAAA,EAAW;AAClB,MAAA,IAAI;AACF,QAAA,MAAM,KAAK,YAAA,CAAa,aAAA,CAAc,GAAA,CAAI,SAAA,EAAW,IAAI,KAAK,CAAA;AAAA,MAChE,SAAS,GAAA,EAAK;AACZ,QAAA,IAAA,CAAK,OAAA,EAAS,QAAQ,qCAAA,EAAuC;AAAA,UAC3D,OAAO,GAAA,CAAI,KAAA;AAAA,UACX,OAAO,GAAA,CAAI,KAAA;AAAA,UACX,GAAA,EAAK,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU;AAAA,SAC3C,CAAA;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,KAAA,GAAuB;AAE3B,IAAA,IAAI,IAAA,CAAK,iBAAA,CAAkB,IAAA,GAAO,CAAA,EAAG;AACnC,MAAA,MAAM,QAAQ,UAAA,CAAW,CAAC,GAAG,IAAA,CAAK,iBAAiB,CAAC,CAAA;AAAA,IACtD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,KAAA,GAAuB;AAC3B,IAAA,IAAI,KAAK,OAAA,EAAS;AAClB,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA;AAIf,IAAA,MAAM,OAAO,CAAC,GAAG,IAAA,CAAK,cAAA,CAAe,QAAQ,CAAA;AAC7C,IAAA,MAAM,OAAA,CAAQ,GAAA,CAAI,IAAA,CAAK,GAAA,CAAI,CAAA,GAAA,KAAO,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,KAAA,EAAO,GAAA,CAAI,EAAE,CAAC,CAAC,CAAA;AAEtE,IAAA,IAAI,IAAA,CAAK,aAAa,MAAA,EAAQ;AAC5B,MAAA,IAAI;AACF,QAAA,MAAM,IAAA,CAAK,aAAa,IAAA,EAAK;AAAA,MAC/B,SAAS,GAAA,EAAK;AACZ,QAAA,IAAA,CAAK,OAAA,EAAS,QAAQ,mCAAA,EAAqC;AAAA,UACzD,GAAA,EAAK,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU;AAAA,SAC3C,CAAA;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,aAAa,GAAA,EAAkC;AACnD,IAAA,OAAO,CAAC,IAAI,OAAA,EAAS;AACnB,MAAA,IAAI,MAAA;AACJ,MAAA,IAAI;AACF,QAAA,MAAA,GAAS,MAAM,GAAA,CAAI,UAAA,CAAW,UAAA,CAAW,GAAA,CAAI,OAAO,GAAA,CAAI,QAAA,EAAU,CAAC,EAAE,KAAK,GAAA,CAAI,SAAA,EAAW,EAAA,EAAI,GAAA,EAAK,CAAA,EAAG;AAAA,UACnG,KAAA,EAAO,EAAA;AAAA,UACP,OAAO,IAAA,CAAK;AAAA,SACb,CAAA;AAAA,MACH,SAAS,GAAA,EAAK;AACZ,QAAA,IAAI,IAAI,OAAA,EAAS;AACjB,QAAA,IAAA,CAAK,OAAA,EAAS,QAAQ,kCAAA,EAAoC;AAAA,UACxD,OAAO,GAAA,CAAI,KAAA;AAAA,UACX,OAAO,GAAA,CAAI,KAAA;AAAA,UACX,GAAA,EAAK,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU;AAAA,SAC3C,CAAA;AAED,QAAA,MAAM,IAAI,OAAA,CAAQ,CAAA,CAAA,KAAK,UAAA,CAAW,CAAA,EAAG,GAAG,CAAC,CAAA;AACzC,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,CAAC,MAAA,IAAU,MAAA,CAAO,MAAA,KAAW,CAAA,EAAG;AAEpC,MAAA,KAAA,MAAW,UAAU,MAAA,EAAQ;AAC3B,QAAA,KAAA,MAAW,KAAA,IAAS,OAAO,QAAA,EAAU;AACnC,UAAA,IAAI,IAAI,OAAA,EAAS;AACjB,UAAA,MAAM,KAAK,eAAA,CAAgB,GAAA,EAAK,KAAA,CAAM,EAAA,EAAI,MAAM,OAAO,CAAA;AAAA,QACzD;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,eAAA,CAAgB,GAAA,EAAmB,QAAA,EAAkB,MAAA,EAA+C;AACxG,IAAA,IAAI,KAAA;AACJ,IAAA,IAAI;AACF,MAAA,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,MAAA,CAAO,KAAA,IAAS,IAAI,CAAA;AAEvC,MAAA,IAAI,OAAO,KAAA,CAAM,SAAA,KAAc,QAAA,EAAU;AACvC,QAAA,KAAA,CAAM,SAAA,GAAY,IAAI,IAAA,CAAK,KAAA,CAAM,SAAS,CAAA;AAAA,MAC5C;AAAA,IACF,SAAS,GAAA,EAAK;AACZ,MAAA,IAAA,CAAK,OAAA,EAAS,QAAQ,4CAAA,EAA8C;AAAA,QAClE,OAAO,GAAA,CAAI,KAAA;AAAA,QACX,QAAA;AAAA,QACA,GAAA,EAAK,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU;AAAA,OAC3C,CAAA;AACD,MAAA,IAAI;AACF,QAAA,MAAM,KAAK,YAAA,CAAa,IAAA,CAAK,IAAI,SAAA,EAAW,GAAA,CAAI,OAAO,QAAQ,CAAA;AAAA,MACjE,SAAS,MAAA,EAAQ;AACf,QAAA,IAAA,CAAK,OAAA,EAAS,QAAQ,oDAAA,EAAsD;AAAA,UAC1E,OAAO,GAAA,CAAI,KAAA;AAAA,UACX,GAAA,EAAK,MAAA,YAAkB,KAAA,GAAQ,MAAA,CAAO,OAAA,GAAU;AAAA,SACjD,CAAA;AAAA,MACH;AACA,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,OAAA,GAAU,KAAA;AACd,IAAA,MAAM,MAAM,YAAY;AACtB,MAAA,IAAI,OAAA,EAAS;AACb,MAAA,OAAA,GAAU,IAAA;AACV,MAAA,IAAI;AAIF,QAAA,MAAM,KAAK,YAAA,CAAa,IAAA,CAAK,IAAI,SAAA,EAAW,GAAA,CAAI,OAAO,QAAQ,CAAA;AAAA,MACjE,SAAS,GAAA,EAAK;AACZ,QAAA,IAAA,CAAK,OAAA,EAAS,QAAQ,mCAAA,EAAqC;AAAA,UACzD,OAAO,GAAA,CAAI,KAAA;AAAA,UACX,GAAA,EAAK,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU;AAAA,SAC3C,CAAA;AAAA,MACH;AAAA,IACF,CAAA;AACA,IAAA,MAAM,OAAO,YAAY;AACvB,MAAA,IAAI,OAAA,EAAS;AACb,MAAA,OAAA,GAAU,IAAA;AACV,MAAA,MAAM,OAAA,GAAU,MAAM,eAAA,IAAmB,CAAA;AAIzC,MAAA,IAAI,OAAA,IAAW,KAAK,oBAAA,EAAsB;AACxC,QAAA,IAAA,CAAK,OAAA,EAAS,OAAO,2DAAA,EAA6D;AAAA,UAChF,OAAO,GAAA,CAAI,KAAA;AAAA,UACX,WAAW,KAAA,CAAM,IAAA;AAAA,UACjB,SAAS,KAAA,CAAM,EAAA;AAAA,UACf,OAAA;AAAA,UACA,KAAK,IAAA,CAAK;AAAA,SACX,CAAA;AACD,QAAA,IAAI;AAEF,UAAA,MAAM,KAAK,YAAA,CAAa,IAAA,CAAK,IAAI,SAAA,EAAW,GAAA,CAAI,OAAO,QAAQ,CAAA;AAAA,QACjE,SAAS,GAAA,EAAK;AACZ,UAAA,IAAA,CAAK,OAAA,EAAS,QAAQ,qDAAA,EAAuD;AAAA,YAC3E,OAAO,GAAA,CAAI,KAAA;AAAA,YACX,GAAA,EAAK,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU;AAAA,WAC3C,CAAA;AAAA,QACH;AACA,QAAA;AAAA,MACF;AAKA,MAAA,MAAM,IAAA,GAAc;AAAA,QAClB,GAAG,KAAA;AAAA,QACH,iBAAiB,OAAA,GAAU;AAAA,OAC7B;AACA,MAAA,IAAI;AACF,QAAA,MAAM,IAAA,CAAK,YAAA,CAAa,IAAA,CAAK,GAAA,CAAI,SAAA,EAAW,GAAA,EAAK,EAAE,KAAA,EAAO,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA,EAAG,CAAA;AAAA,MAClF,SAAS,GAAA,EAAK;AACZ,QAAA,IAAA,CAAK,OAAA,EAAS,OAAO,4EAAA,EAA8E;AAAA,UACjG,OAAO,GAAA,CAAI,KAAA;AAAA,UACX,SAAS,KAAA,CAAM,EAAA;AAAA,UACf,GAAA,EAAK,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU;AAAA,SAC3C,CAAA;AAGD,QAAA,OAAA,GAAU,KAAA;AACV,QAAA;AAAA,MACF;AACA,MAAA,IAAI;AACF,QAAA,MAAM,KAAK,YAAA,CAAa,IAAA,CAAK,IAAI,SAAA,EAAW,GAAA,CAAI,OAAO,QAAQ,CAAA;AAAA,MACjE,SAAS,GAAA,EAAK;AACZ,QAAA,IAAA,CAAK,OAAA,EAAS,QAAQ,uCAAA,EAAyC;AAAA,UAC7D,OAAO,GAAA,CAAI,KAAA;AAAA,UACX,GAAA,EAAK,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU;AAAA,SAC3C,CAAA;AAAA,MACH;AAAA,IACF,CAAA;AAEA,IAAA,IAAI;AAOF,MAAA,MAAM,MAAA,GAAkB,GAAA,CAAI,EAAA,CAAG,KAAA,EAAO,KAAK,IAAI,CAAA;AAC/C,MAAA,IAAI,MAAA,IAAU,OAAQ,MAAA,CAA+C,KAAA,KAAU,UAAA,EAAY;AACzF,QAAC,MAAA,CAA4B,MAAM,YAAY;AAC7C,UAAA,MAAM,IAAA,EAAK;AAAA,QACb,CAAC,CAAA;AAAA,MACH;AAAA,IACF,CAAA,CAAA,MAAQ;AAEN,MAAA,MAAM,IAAA,EAAK;AAAA,IACb;AAAA,EACF;AACF","file":"index.cjs","sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { PubSub } from '@mastra/core/events';\nimport type { Event, EventCallback, PubSubDeliveryMode, SubscribeOptions } from '@mastra/core/events';\nimport { createClient } from 'redis';\nimport type { RedisClientOptions, RedisClientType } from 'redis';\n\n/**\n * Mastra PubSub backed by Redis Streams.\n *\n * - Each topic maps to a Redis stream key `<prefix>:<topic>`.\n * - Subscriptions with `options.group` use a real Redis consumer group, so\n *   competing subscribers in the same group share the work (round-robin).\n * - Subscriptions without a group create a private per-subscriber consumer\n *   group, so they get fan-out semantics (every subscriber sees every event).\n * - Nack triggers redelivery by re-publishing the event with an incremented\n *   `deliveryAttempt` field, then XACK-ing the original. This trades strict\n *   FIFO ordering on retry for a simple, reliable redelivery path.\n */\nexport interface RedisStreamsPubSubConfig {\n  url?: string;\n  keyPrefix?: string;\n  blockMs?: number;\n  redisOptions?: RedisClientOptions;\n  /**\n   * Approximate maximum number of entries kept per stream. On every publish we\n   * issue MAXLEN ~ N which lets Redis trim opportunistically. Defaults to\n   * 10_000 — set to 0 to disable trimming.\n   */\n  maxStreamLength?: number;\n  /**\n   * How often (in ms) each subscription runs XAUTOCLAIM to recover messages\n   * that an earlier consumer in the group read but never acked. Defaults to\n   * 30_000 ms. Set to 0 to disable.\n   */\n  reclaimIntervalMs?: number;\n  /**\n   * Minimum idle time (in ms) before a pending message is eligible for\n   * reclaim. Should be much larger than typical in-flight processing time to\n   * avoid double-delivery. Defaults to 60_000 ms.\n   */\n  reclaimIdleMs?: number;\n  /**\n   * Maximum number of times a single event will be redelivered via nack\n   * before it is dropped (acked without republish). Defaults to 5. Set to\n   * `Infinity` to disable the cap (events redeliver forever on every nack).\n   *\n   * `0` is treated as `Infinity` with a one-time warn for back-compat;\n   * prefer `Infinity` to disable the cap explicitly.\n   */\n  maxDeliveryAttempts?: number;\n  /**\n   * Optional logger for diagnostics. When omitted, suppressed errors\n   * (BUSYGROUP, malformed payloads, connection-close races) are swallowed\n   * silently. When provided, those paths emit `debug`/`warn` entries so\n   * operators can see what's happening without noise on the happy path.\n   */\n  logger?: { debug?: (...args: unknown[]) => void; warn?: (...args: unknown[]) => void };\n}\n\nexport class RedisStreamsPubSub extends PubSub {\n  // Redis Streams is a pull transport: consumers issue XREADGROUP to read\n  // events. Mastra reads this to know an OrchestrationWorker is required.\n  override get supportedModes(): ReadonlyArray<PubSubDeliveryMode> {\n    return ['pull'];\n  }\n\n  #writeClient: RedisClientType;\n  #connectOptions: RedisClientOptions;\n  #keyPrefix: string;\n  #blockMs: number;\n  #maxStreamLength: number;\n  #reclaimIntervalMs: number;\n  #reclaimIdleMs: number;\n  #maxDeliveryAttempts: number;\n  #logger?: RedisStreamsPubSubConfig['logger'];\n  // Keyed by `${topic}::${cbId}` so the same callback can be subscribed to\n  // multiple topics independently. Without the topic in the key,\n  // unsubscribe(otherTopic, cb) would tear down the wrong subscription.\n  #subscriptions: Map<string, Subscription> = new Map();\n  #cbIds: WeakMap<EventCallback, string> = new WeakMap();\n  #pendingPublishes: Set<Promise<unknown>> = new Set();\n  #closed = false;\n\n  constructor(options: RedisStreamsPubSubConfig = {}) {\n    super();\n    const url = options.url ?? options.redisOptions?.url ?? 'redis://localhost:6379';\n    this.#connectOptions = { ...options.redisOptions, url };\n    this.#writeClient = createClient(this.#connectOptions) as RedisClientType;\n    this.#keyPrefix = options.keyPrefix ?? 'mastra:topic';\n    this.#blockMs = options.blockMs ?? 1000;\n    this.#maxStreamLength = options.maxStreamLength ?? 10_000;\n    this.#reclaimIntervalMs = options.reclaimIntervalMs ?? 30_000;\n    this.#reclaimIdleMs = options.reclaimIdleMs ?? 60_000;\n    const cap = options.maxDeliveryAttempts ?? 5;\n    if (cap === 0) {\n      options.logger?.warn?.(\n        'redis-streams: maxDeliveryAttempts=0 is treated as Infinity for back-compat; pass Infinity to disable the cap explicitly.',\n      );\n      this.#maxDeliveryAttempts = Infinity;\n    } else if (cap < 0 || Number.isNaN(cap)) {\n      throw new Error(`redis-streams: maxDeliveryAttempts must be >= 1 or Infinity, got ${cap}`);\n    } else {\n      this.#maxDeliveryAttempts = cap;\n    }\n    this.#logger = options.logger;\n  }\n\n  #subKey(topic: string, cb: EventCallback): string {\n    let cbId = this.#cbIds.get(cb);\n    if (!cbId) {\n      cbId = randomUUID();\n      this.#cbIds.set(cb, cbId);\n    }\n    return `${topic}::${cbId}`;\n  }\n\n  /** Lazily connect the shared writer client. Idempotent. */\n  async #ensureWriterConnected(): Promise<void> {\n    if (this.#writeClient.isOpen) return;\n    await this.#writeClient.connect();\n  }\n\n  #streamKey(topic: string): string {\n    return `${this.#keyPrefix}:${topic}`;\n  }\n\n  async publish(topic: string, event: Omit<Event, 'id' | 'createdAt'>): Promise<void> {\n    if (this.#closed) throw new Error('RedisStreamsPubSub: cannot publish on closed client');\n    await this.#ensureWriterConnected();\n\n    const id = randomUUID();\n    const createdAt = new Date();\n    const payload: Event = {\n      ...event,\n      id,\n      createdAt,\n      deliveryAttempt: event.deliveryAttempt ?? 1,\n    };\n    const xaddOptions: { TRIM?: { strategy: 'MAXLEN'; strategyModifier: '~'; threshold: number } } = {};\n    if (this.#maxStreamLength > 0) {\n      xaddOptions.TRIM = {\n        strategy: 'MAXLEN',\n        strategyModifier: '~',\n        threshold: this.#maxStreamLength,\n      };\n    }\n    const promise = this.#writeClient.xAdd(\n      this.#streamKey(topic),\n      '*',\n      { event: JSON.stringify(payload) },\n      xaddOptions,\n    );\n    this.#pendingPublishes.add(promise);\n    try {\n      await promise;\n    } finally {\n      this.#pendingPublishes.delete(promise);\n    }\n  }\n\n  async subscribe(topic: string, cb: EventCallback, options?: SubscribeOptions): Promise<void> {\n    if (this.#closed) throw new Error('RedisStreamsPubSub: cannot subscribe on closed client');\n    const key = this.#subKey(topic, cb);\n    if (this.#subscriptions.has(key)) return; // idempotent: same (topic, cb) already subscribed\n\n    await this.#ensureWriterConnected();\n\n    const isGrouped = !!options?.group;\n    const group = options?.group ?? `__fanout-${randomUUID()}`;\n    const consumer = `${group}-${randomUUID()}`;\n    const streamKey = this.#streamKey(topic);\n\n    // Create the consumer group if it doesn't exist. MKSTREAM creates the\n    // stream if needed. BUSYGROUP means another subscriber raced us — fine.\n    //\n    // We anchor brand-new groups at '0' (stream start) instead of '$' so that\n    // a worker which subscribes after a publish still sees the backlog. This\n    // is the \"late join\" case: a server may publish workflow.start before any\n    // orchestrator process exists. Without this, that work is silently lost.\n    // Existing groups (BUSYGROUP path) keep their own checkpoint, so this\n    // doesn't change semantics for already-running clusters. Stream growth is\n    // bounded by the MAXLEN ~ trim applied on every publish.\n    try {\n      await this.#writeClient.xGroupCreate(streamKey, group, '0', { MKSTREAM: true });\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      if (!msg.includes('BUSYGROUP')) throw err;\n      this.#logger?.debug?.('redis-streams: consumer group already exists', { topic, group });\n    }\n\n    // Each subscription gets a dedicated reader connection because XREADGROUP\n    // with BLOCK > 0 holds the connection until a message arrives.\n    const readClient = createClient(this.#connectOptions) as RedisClientType;\n    await readClient.connect();\n\n    const sub: Subscription = {\n      cb,\n      topic,\n      streamKey,\n      group,\n      consumer,\n      isGrouped,\n      readClient,\n      stopped: false,\n      loop: undefined,\n      reclaimTimer: undefined,\n    };\n    this.#subscriptions.set(key, sub);\n    sub.loop = this.#runReadLoop(sub);\n    this.#startReclaimLoop(sub);\n  }\n\n  /**\n   * Periodically run XAUTOCLAIM against this subscription's group so that\n   * messages a crashed/stuck consumer read but never acked get redelivered to\n   * a live sibling. Runs only for grouped subscriptions — fan-out groups are\n   * private to one consumer, so there's no sibling to claim from.\n   */\n  #startReclaimLoop(sub: Subscription): void {\n    if (this.#reclaimIntervalMs <= 0) return;\n    if (!sub.isGrouped) return;\n\n    const tick = async () => {\n      if (sub.stopped || this.#closed) return;\n      try {\n        const reply = await this.#writeClient.xAutoClaim(\n          sub.streamKey,\n          sub.group,\n          sub.consumer,\n          this.#reclaimIdleMs,\n          '0-0',\n          { COUNT: 100 },\n        );\n        const messages = (reply?.messages ?? []) as Array<{ id: string; message: Record<string, string> } | null>;\n        for (const entry of messages) {\n          if (sub.stopped || this.#closed) return;\n          if (!entry) continue;\n          await this.#deliverMessage(sub, entry.id, entry.message);\n        }\n      } catch (err) {\n        this.#logger?.debug?.('redis-streams: XAUTOCLAIM failed', {\n          topic: sub.topic,\n          group: sub.group,\n          err: err instanceof Error ? err.message : err,\n        });\n      }\n      if (sub.stopped || this.#closed) return;\n      sub.reclaimTimer = setTimeout(tick, this.#reclaimIntervalMs);\n    };\n\n    sub.reclaimTimer = setTimeout(tick, this.#reclaimIntervalMs);\n  }\n\n  async unsubscribe(topic: string, cb: EventCallback): Promise<void> {\n    const key = this.#subKey(topic, cb);\n    const sub = this.#subscriptions.get(key);\n    if (!sub) return;\n    this.#subscriptions.delete(key);\n    sub.stopped = true;\n    if (sub.reclaimTimer) {\n      clearTimeout(sub.reclaimTimer);\n      sub.reclaimTimer = undefined;\n    }\n\n    // Cancel the in-flight blocking XREADGROUP by closing the reader.\n    try {\n      await sub.readClient.quit();\n    } catch (err) {\n      this.#logger?.debug?.('redis-streams: reader quit failed', {\n        topic: sub.topic,\n        err: err instanceof Error ? err.message : err,\n      });\n    }\n\n    if (sub.loop) {\n      try {\n        await sub.loop;\n      } catch (err) {\n        // loop exits naturally when readClient closes; surface only at debug.\n        this.#logger?.debug?.('redis-streams: read loop exited with error', {\n          topic: sub.topic,\n          err: err instanceof Error ? err.message : err,\n        });\n      }\n    }\n\n    // For fan-out, drop the private group entirely so the stream can be reclaimed.\n    if (!sub.isGrouped) {\n      try {\n        await this.#writeClient.xGroupDestroy(sub.streamKey, sub.group);\n      } catch (err) {\n        this.#logger?.debug?.('redis-streams: xGroupDestroy failed', {\n          topic: sub.topic,\n          group: sub.group,\n          err: err instanceof Error ? err.message : err,\n        });\n      }\n    }\n  }\n\n  async flush(): Promise<void> {\n    // Wait for any in-flight publishes to settle.\n    if (this.#pendingPublishes.size > 0) {\n      await Promise.allSettled([...this.#pendingPublishes]);\n    }\n  }\n\n  /**\n   * Disconnect all clients and stop all subscription loops.\n   */\n  async close(): Promise<void> {\n    if (this.#closed) return;\n    this.#closed = true;\n\n    // Walk the actual subscriptions and pass the original topic through so\n    // unsubscribe's key lookup works.\n    const subs = [...this.#subscriptions.values()];\n    await Promise.all(subs.map(sub => this.unsubscribe(sub.topic, sub.cb)));\n\n    if (this.#writeClient.isOpen) {\n      try {\n        await this.#writeClient.quit();\n      } catch (err) {\n        this.#logger?.debug?.('redis-streams: writer quit failed', {\n          err: err instanceof Error ? err.message : err,\n        });\n      }\n    }\n  }\n\n  async #runReadLoop(sub: Subscription): Promise<void> {\n    while (!sub.stopped) {\n      let result;\n      try {\n        result = await sub.readClient.xReadGroup(sub.group, sub.consumer, [{ key: sub.streamKey, id: '>' }], {\n          COUNT: 10,\n          BLOCK: this.#blockMs,\n        });\n      } catch (err) {\n        if (sub.stopped) return;\n        this.#logger?.debug?.('redis-streams: xReadGroup failed', {\n          topic: sub.topic,\n          group: sub.group,\n          err: err instanceof Error ? err.message : err,\n        });\n        // Connection error or similar — pause briefly then retry.\n        await new Promise(r => setTimeout(r, 100));\n        continue;\n      }\n\n      if (!result || result.length === 0) continue;\n\n      for (const stream of result) {\n        for (const entry of stream.messages) {\n          if (sub.stopped) return;\n          await this.#deliverMessage(sub, entry.id, entry.message);\n        }\n      }\n    }\n  }\n\n  async #deliverMessage(sub: Subscription, streamId: string, fields: Record<string, string>): Promise<void> {\n    let event: Event;\n    try {\n      event = JSON.parse(fields.event ?? '{}') as Event;\n      // createdAt is serialized as a string; rehydrate.\n      if (typeof event.createdAt === 'string') {\n        event.createdAt = new Date(event.createdAt);\n      }\n    } catch (err) {\n      this.#logger?.debug?.('redis-streams: malformed payload, dropping', {\n        topic: sub.topic,\n        streamId,\n        err: err instanceof Error ? err.message : err,\n      });\n      try {\n        await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);\n      } catch (ackErr) {\n        this.#logger?.debug?.('redis-streams: xAck after malformed payload failed', {\n          topic: sub.topic,\n          err: ackErr instanceof Error ? ackErr.message : ackErr,\n        });\n      }\n      return;\n    }\n\n    let settled = false;\n    const ack = async () => {\n      if (settled) return;\n      settled = true;\n      try {\n        // Only ack against this consumer group. Do NOT xDel: the stream may\n        // be consumed by other groups, and xDel removes the entry for all of\n        // them. Stream growth is bounded elsewhere via MAXLEN-style trimming.\n        await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);\n      } catch (err) {\n        this.#logger?.debug?.('redis-streams: ack cleanup failed', {\n          topic: sub.topic,\n          err: err instanceof Error ? err.message : err,\n        });\n      }\n    };\n    const nack = async () => {\n      if (settled) return;\n      settled = true;\n      const attempt = event.deliveryAttempt ?? 1;\n      // Cap redelivery to avoid an infinite poison-pill loop. When the cap\n      // is hit we drop the event (xAck without republish) and warn so an\n      // operator can find it in logs.\n      if (attempt >= this.#maxDeliveryAttempts) {\n        this.#logger?.warn?.('redis-streams: dropping event after max delivery attempts', {\n          topic: sub.topic,\n          eventType: event.type,\n          eventId: event.id,\n          attempt,\n          max: this.#maxDeliveryAttempts,\n        });\n        try {\n          // Group-scoped ack only — see ack() above for why we never xDel.\n          await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);\n        } catch (err) {\n          this.#logger?.debug?.('redis-streams: ack on dropped poison message failed', {\n            topic: sub.topic,\n            err: err instanceof Error ? err.message : err,\n          });\n        }\n        return;\n      }\n      // Republish with incremented deliveryAttempt FIRST, then ack the\n      // original entry. If the republish fails we deliberately leave the\n      // original message pending so XAUTOCLAIM (or another consumer) can\n      // pick it up on a future tick — acking first would silently drop it.\n      const next: Event = {\n        ...event,\n        deliveryAttempt: attempt + 1,\n      };\n      try {\n        await this.#writeClient.xAdd(sub.streamKey, '*', { event: JSON.stringify(next) });\n      } catch (err) {\n        this.#logger?.warn?.('redis-streams: nack republish failed; leaving original pending for reclaim', {\n          topic: sub.topic,\n          eventId: event.id,\n          err: err instanceof Error ? err.message : err,\n        });\n        // Allow this entry to be redelivered: reset settled so the next\n        // delivery attempt (via XAUTOCLAIM) can ack/nack it again.\n        settled = false;\n        return;\n      }\n      try {\n        await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);\n      } catch (err) {\n        this.#logger?.debug?.('redis-streams: xAck after nack failed', {\n          topic: sub.topic,\n          err: err instanceof Error ? err.message : err,\n        });\n      }\n    };\n\n    try {\n      // EventCallback is typed `=> void` but handlers commonly return a\n      // promise (TS allows Promise<void> to satisfy void). If we get one\n      // back, attach a catch handler so async rejections route to nack\n      // instead of silently dropping the message. We do NOT await here —\n      // serializing messages on a subscription would deadlock orchestration\n      // callbacks that await their own future events.\n      const result: unknown = sub.cb(event, ack, nack);\n      if (result && typeof (result as { then?: unknown; catch?: unknown }).catch === 'function') {\n        (result as Promise<unknown>).catch(async () => {\n          await nack();\n        });\n      }\n    } catch {\n      // Caller threw synchronously — treat as nack.\n      await nack();\n    }\n  }\n}\n\ninterface Subscription {\n  cb: EventCallback;\n  topic: string;\n  streamKey: string;\n  group: string;\n  consumer: string;\n  isGrouped: boolean;\n  readClient: RedisClientType;\n  stopped: boolean;\n  loop: Promise<void> | undefined;\n  reclaimTimer: ReturnType<typeof setTimeout> | undefined;\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+import { PubSub } from '@mastra/core/events';
+import type { Event, EventCallback, PubSubDeliveryMode, SubscribeOptions } from '@mastra/core/events';
+import type { RedisClientOptions } from 'redis';
+/**
+ * Mastra PubSub backed by Redis Streams.
+ *
+ * - Each topic maps to a Redis stream key `<prefix>:<topic>`.
+ * - Subscriptions with `options.group` use a real Redis consumer group, so
+ *   competing subscribers in the same group share the work (round-robin).
+ * - Subscriptions without a group create a private per-subscriber consumer
+ *   group, so they get fan-out semantics (every subscriber sees every event).
+ * - Nack triggers redelivery by re-publishing the event with an incremented
+ *   `deliveryAttempt` field, then XACK-ing the original. This trades strict
+ *   FIFO ordering on retry for a simple, reliable redelivery path.
+ */
+export interface RedisStreamsPubSubConfig {
+    url?: string;
+    keyPrefix?: string;
+    blockMs?: number;
+    redisOptions?: RedisClientOptions;
+    /**
+     * Approximate maximum number of entries kept per stream. On every publish we
+     * issue MAXLEN ~ N which lets Redis trim opportunistically. Defaults to
+     * 10_000 — set to 0 to disable trimming.
+     */
+    maxStreamLength?: number;
+    /**
+     * How often (in ms) each subscription runs XAUTOCLAIM to recover messages
+     * that an earlier consumer in the group read but never acked. Defaults to
+     * 30_000 ms. Set to 0 to disable.
+     */
+    reclaimIntervalMs?: number;
+    /**
+     * Minimum idle time (in ms) before a pending message is eligible for
+     * reclaim. Should be much larger than typical in-flight processing time to
+     * avoid double-delivery. Defaults to 60_000 ms.
+     */
+    reclaimIdleMs?: number;
+    /**
+     * Maximum number of times a single event will be redelivered via nack
+     * before it is dropped (acked without republish). Defaults to 5. Set to
+     * `Infinity` to disable the cap (events redeliver forever on every nack).
+     *
+     * `0` is treated as `Infinity` with a one-time warn for back-compat;
+     * prefer `Infinity` to disable the cap explicitly.
+     */
+    maxDeliveryAttempts?: number;
+    /**
+     * Optional logger for diagnostics. When omitted, suppressed errors
+     * (BUSYGROUP, malformed payloads, connection-close races) are swallowed
+     * silently. When provided, those paths emit `debug`/`warn` entries so
+     * operators can see what's happening without noise on the happy path.
+     */
+    logger?: {
+        debug?: (...args: unknown[]) => void;
+        warn?: (...args: unknown[]) => void;
+    };
+}
+export declare class RedisStreamsPubSub extends PubSub {
+    #private;
+    get supportedModes(): ReadonlyArray<PubSubDeliveryMode>;
+    constructor(options?: RedisStreamsPubSubConfig);
+    publish(topic: string, event: Omit<Event, 'id' | 'createdAt'>): Promise<void>;
+    subscribe(topic: string, cb: EventCallback, options?: SubscribeOptions): Promise<void>;
+    unsubscribe(topic: string, cb: EventCallback): Promise<void>;
+    flush(): Promise<void>;
+    /**
+     * Disconnect all clients and stop all subscription loops.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEtG,OAAO,KAAK,EAAE,kBAAkB,EAAmB,MAAM,OAAO,CAAC;AAEjE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;CACxF;AAED,qBAAa,kBAAmB,SAAQ,MAAM;;IAG5C,IAAa,cAAc,IAAI,aAAa,CAAC,kBAAkB,CAAC,CAE/D;gBAmBW,OAAO,GAAE,wBAA6B;IA2C5C,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC7E,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6FtF,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA+C5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAuK7B"}

package/dist/index.js

@@ -0,0 +1,358 @@
+import { randomUUID } from 'crypto';
+import { PubSub } from '@mastra/core/events';
+import { createClient } from 'redis';
+
+// src/index.ts
+var RedisStreamsPubSub = class extends PubSub {
+  // Redis Streams is a pull transport: consumers issue XREADGROUP to read
+  // events. Mastra reads this to know an OrchestrationWorker is required.
+  get supportedModes() {
+    return ["pull"];
+  }
+  #writeClient;
+  #connectOptions;
+  #keyPrefix;
+  #blockMs;
+  #maxStreamLength;
+  #reclaimIntervalMs;
+  #reclaimIdleMs;
+  #maxDeliveryAttempts;
+  #logger;
+  // Keyed by `${topic}::${cbId}` so the same callback can be subscribed to
+  // multiple topics independently. Without the topic in the key,
+  // unsubscribe(otherTopic, cb) would tear down the wrong subscription.
+  #subscriptions = /* @__PURE__ */ new Map();
+  #cbIds = /* @__PURE__ */ new WeakMap();
+  #pendingPublishes = /* @__PURE__ */ new Set();
+  #closed = false;
+  constructor(options = {}) {
+    super();
+    const url = options.url ?? options.redisOptions?.url ?? "redis://localhost:6379";
+    this.#connectOptions = { ...options.redisOptions, url };
+    this.#writeClient = createClient(this.#connectOptions);
+    this.#keyPrefix = options.keyPrefix ?? "mastra:topic";
+    this.#blockMs = options.blockMs ?? 1e3;
+    this.#maxStreamLength = options.maxStreamLength ?? 1e4;
+    this.#reclaimIntervalMs = options.reclaimIntervalMs ?? 3e4;
+    this.#reclaimIdleMs = options.reclaimIdleMs ?? 6e4;
+    const cap = options.maxDeliveryAttempts ?? 5;
+    if (cap === 0) {
+      options.logger?.warn?.(
+        "redis-streams: maxDeliveryAttempts=0 is treated as Infinity for back-compat; pass Infinity to disable the cap explicitly."
+      );
+      this.#maxDeliveryAttempts = Infinity;
+    } else if (cap < 0 || Number.isNaN(cap)) {
+      throw new Error(`redis-streams: maxDeliveryAttempts must be >= 1 or Infinity, got ${cap}`);
+    } else {
+      this.#maxDeliveryAttempts = cap;
+    }
+    this.#logger = options.logger;
+  }
+  #subKey(topic, cb) {
+    let cbId = this.#cbIds.get(cb);
+    if (!cbId) {
+      cbId = randomUUID();
+      this.#cbIds.set(cb, cbId);
+    }
+    return `${topic}::${cbId}`;
+  }
+  /** Lazily connect the shared writer client. Idempotent. */
+  async #ensureWriterConnected() {
+    if (this.#writeClient.isOpen) return;
+    await this.#writeClient.connect();
+  }
+  #streamKey(topic) {
+    return `${this.#keyPrefix}:${topic}`;
+  }
+  async publish(topic, event) {
+    if (this.#closed) throw new Error("RedisStreamsPubSub: cannot publish on closed client");
+    await this.#ensureWriterConnected();
+    const id = randomUUID();
+    const createdAt = /* @__PURE__ */ new Date();
+    const payload = {
+      ...event,
+      id,
+      createdAt,
+      deliveryAttempt: event.deliveryAttempt ?? 1
+    };
+    const xaddOptions = {};
+    if (this.#maxStreamLength > 0) {
+      xaddOptions.TRIM = {
+        strategy: "MAXLEN",
+        strategyModifier: "~",
+        threshold: this.#maxStreamLength
+      };
+    }
+    const promise = this.#writeClient.xAdd(
+      this.#streamKey(topic),
+      "*",
+      { event: JSON.stringify(payload) },
+      xaddOptions
+    );
+    this.#pendingPublishes.add(promise);
+    try {
+      await promise;
+    } finally {
+      this.#pendingPublishes.delete(promise);
+    }
+  }
+  async subscribe(topic, cb, options) {
+    if (this.#closed) throw new Error("RedisStreamsPubSub: cannot subscribe on closed client");
+    const key = this.#subKey(topic, cb);
+    if (this.#subscriptions.has(key)) return;
+    await this.#ensureWriterConnected();
+    const isGrouped = !!options?.group;
+    const group = options?.group ?? `__fanout-${randomUUID()}`;
+    const consumer = `${group}-${randomUUID()}`;
+    const streamKey = this.#streamKey(topic);
+    try {
+      await this.#writeClient.xGroupCreate(streamKey, group, "0", { MKSTREAM: true });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (!msg.includes("BUSYGROUP")) throw err;
+      this.#logger?.debug?.("redis-streams: consumer group already exists", { topic, group });
+    }
+    const readClient = createClient(this.#connectOptions);
+    await readClient.connect();
+    const sub = {
+      cb,
+      topic,
+      streamKey,
+      group,
+      consumer,
+      isGrouped,
+      readClient,
+      stopped: false,
+      loop: void 0,
+      reclaimTimer: void 0
+    };
+    this.#subscriptions.set(key, sub);
+    sub.loop = this.#runReadLoop(sub);
+    this.#startReclaimLoop(sub);
+  }
+  /**
+   * Periodically run XAUTOCLAIM against this subscription's group so that
+   * messages a crashed/stuck consumer read but never acked get redelivered to
+   * a live sibling. Runs only for grouped subscriptions — fan-out groups are
+   * private to one consumer, so there's no sibling to claim from.
+   */
+  #startReclaimLoop(sub) {
+    if (this.#reclaimIntervalMs <= 0) return;
+    if (!sub.isGrouped) return;
+    const tick = async () => {
+      if (sub.stopped || this.#closed) return;
+      try {
+        const reply = await this.#writeClient.xAutoClaim(
+          sub.streamKey,
+          sub.group,
+          sub.consumer,
+          this.#reclaimIdleMs,
+          "0-0",
+          { COUNT: 100 }
+        );
+        const messages = reply?.messages ?? [];
+        for (const entry of messages) {
+          if (sub.stopped || this.#closed) return;
+          if (!entry) continue;
+          await this.#deliverMessage(sub, entry.id, entry.message);
+        }
+      } catch (err) {
+        this.#logger?.debug?.("redis-streams: XAUTOCLAIM failed", {
+          topic: sub.topic,
+          group: sub.group,
+          err: err instanceof Error ? err.message : err
+        });
+      }
+      if (sub.stopped || this.#closed) return;
+      sub.reclaimTimer = setTimeout(tick, this.#reclaimIntervalMs);
+    };
+    sub.reclaimTimer = setTimeout(tick, this.#reclaimIntervalMs);
+  }
+  async unsubscribe(topic, cb) {
+    const key = this.#subKey(topic, cb);
+    const sub = this.#subscriptions.get(key);
+    if (!sub) return;
+    this.#subscriptions.delete(key);
+    sub.stopped = true;
+    if (sub.reclaimTimer) {
+      clearTimeout(sub.reclaimTimer);
+      sub.reclaimTimer = void 0;
+    }
+    try {
+      await sub.readClient.quit();
+    } catch (err) {
+      this.#logger?.debug?.("redis-streams: reader quit failed", {
+        topic: sub.topic,
+        err: err instanceof Error ? err.message : err
+      });
+    }
+    if (sub.loop) {
+      try {
+        await sub.loop;
+      } catch (err) {
+        this.#logger?.debug?.("redis-streams: read loop exited with error", {
+          topic: sub.topic,
+          err: err instanceof Error ? err.message : err
+        });
+      }
+    }
+    if (!sub.isGrouped) {
+      try {
+        await this.#writeClient.xGroupDestroy(sub.streamKey, sub.group);
+      } catch (err) {
+        this.#logger?.debug?.("redis-streams: xGroupDestroy failed", {
+          topic: sub.topic,
+          group: sub.group,
+          err: err instanceof Error ? err.message : err
+        });
+      }
+    }
+  }
+  async flush() {
+    if (this.#pendingPublishes.size > 0) {
+      await Promise.allSettled([...this.#pendingPublishes]);
+    }
+  }
+  /**
+   * Disconnect all clients and stop all subscription loops.
+   */
+  async close() {
+    if (this.#closed) return;
+    this.#closed = true;
+    const subs = [...this.#subscriptions.values()];
+    await Promise.all(subs.map((sub) => this.unsubscribe(sub.topic, sub.cb)));
+    if (this.#writeClient.isOpen) {
+      try {
+        await this.#writeClient.quit();
+      } catch (err) {
+        this.#logger?.debug?.("redis-streams: writer quit failed", {
+          err: err instanceof Error ? err.message : err
+        });
+      }
+    }
+  }
+  async #runReadLoop(sub) {
+    while (!sub.stopped) {
+      let result;
+      try {
+        result = await sub.readClient.xReadGroup(sub.group, sub.consumer, [{ key: sub.streamKey, id: ">" }], {
+          COUNT: 10,
+          BLOCK: this.#blockMs
+        });
+      } catch (err) {
+        if (sub.stopped) return;
+        this.#logger?.debug?.("redis-streams: xReadGroup failed", {
+          topic: sub.topic,
+          group: sub.group,
+          err: err instanceof Error ? err.message : err
+        });
+        await new Promise((r) => setTimeout(r, 100));
+        continue;
+      }
+      if (!result || result.length === 0) continue;
+      for (const stream of result) {
+        for (const entry of stream.messages) {
+          if (sub.stopped) return;
+          await this.#deliverMessage(sub, entry.id, entry.message);
+        }
+      }
+    }
+  }
+  async #deliverMessage(sub, streamId, fields) {
+    let event;
+    try {
+      event = JSON.parse(fields.event ?? "{}");
+      if (typeof event.createdAt === "string") {
+        event.createdAt = new Date(event.createdAt);
+      }
+    } catch (err) {
+      this.#logger?.debug?.("redis-streams: malformed payload, dropping", {
+        topic: sub.topic,
+        streamId,
+        err: err instanceof Error ? err.message : err
+      });
+      try {
+        await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);
+      } catch (ackErr) {
+        this.#logger?.debug?.("redis-streams: xAck after malformed payload failed", {
+          topic: sub.topic,
+          err: ackErr instanceof Error ? ackErr.message : ackErr
+        });
+      }
+      return;
+    }
+    let settled = false;
+    const ack = async () => {
+      if (settled) return;
+      settled = true;
+      try {
+        await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);
+      } catch (err) {
+        this.#logger?.debug?.("redis-streams: ack cleanup failed", {
+          topic: sub.topic,
+          err: err instanceof Error ? err.message : err
+        });
+      }
+    };
+    const nack = async () => {
+      if (settled) return;
+      settled = true;
+      const attempt = event.deliveryAttempt ?? 1;
+      if (attempt >= this.#maxDeliveryAttempts) {
+        this.#logger?.warn?.("redis-streams: dropping event after max delivery attempts", {
+          topic: sub.topic,
+          eventType: event.type,
+          eventId: event.id,
+          attempt,
+          max: this.#maxDeliveryAttempts
+        });
+        try {
+          await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);
+        } catch (err) {
+          this.#logger?.debug?.("redis-streams: ack on dropped poison message failed", {
+            topic: sub.topic,
+            err: err instanceof Error ? err.message : err
+          });
+        }
+        return;
+      }
+      const next = {
+        ...event,
+        deliveryAttempt: attempt + 1
+      };
+      try {
+        await this.#writeClient.xAdd(sub.streamKey, "*", { event: JSON.stringify(next) });
+      } catch (err) {
+        this.#logger?.warn?.("redis-streams: nack republish failed; leaving original pending for reclaim", {
+          topic: sub.topic,
+          eventId: event.id,
+          err: err instanceof Error ? err.message : err
+        });
+        settled = false;
+        return;
+      }
+      try {
+        await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);
+      } catch (err) {
+        this.#logger?.debug?.("redis-streams: xAck after nack failed", {
+          topic: sub.topic,
+          err: err instanceof Error ? err.message : err
+        });
+      }
+    };
+    try {
+      const result = sub.cb(event, ack, nack);
+      if (result && typeof result.catch === "function") {
+        result.catch(async () => {
+          await nack();
+        });
+      }
+    } catch {
+      await nack();
+    }
+  }
+};
+
+export { RedisStreamsPubSub };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { PubSub } from '@mastra/core/events';\nimport type { Event, EventCallback, PubSubDeliveryMode, SubscribeOptions } from '@mastra/core/events';\nimport { createClient } from 'redis';\nimport type { RedisClientOptions, RedisClientType } from 'redis';\n\n/**\n * Mastra PubSub backed by Redis Streams.\n *\n * - Each topic maps to a Redis stream key `<prefix>:<topic>`.\n * - Subscriptions with `options.group` use a real Redis consumer group, so\n *   competing subscribers in the same group share the work (round-robin).\n * - Subscriptions without a group create a private per-subscriber consumer\n *   group, so they get fan-out semantics (every subscriber sees every event).\n * - Nack triggers redelivery by re-publishing the event with an incremented\n *   `deliveryAttempt` field, then XACK-ing the original. This trades strict\n *   FIFO ordering on retry for a simple, reliable redelivery path.\n */\nexport interface RedisStreamsPubSubConfig {\n  url?: string;\n  keyPrefix?: string;\n  blockMs?: number;\n  redisOptions?: RedisClientOptions;\n  /**\n   * Approximate maximum number of entries kept per stream. On every publish we\n   * issue MAXLEN ~ N which lets Redis trim opportunistically. Defaults to\n   * 10_000 — set to 0 to disable trimming.\n   */\n  maxStreamLength?: number;\n  /**\n   * How often (in ms) each subscription runs XAUTOCLAIM to recover messages\n   * that an earlier consumer in the group read but never acked. Defaults to\n   * 30_000 ms. Set to 0 to disable.\n   */\n  reclaimIntervalMs?: number;\n  /**\n   * Minimum idle time (in ms) before a pending message is eligible for\n   * reclaim. Should be much larger than typical in-flight processing time to\n   * avoid double-delivery. Defaults to 60_000 ms.\n   */\n  reclaimIdleMs?: number;\n  /**\n   * Maximum number of times a single event will be redelivered via nack\n   * before it is dropped (acked without republish). Defaults to 5. Set to\n   * `Infinity` to disable the cap (events redeliver forever on every nack).\n   *\n   * `0` is treated as `Infinity` with a one-time warn for back-compat;\n   * prefer `Infinity` to disable the cap explicitly.\n   */\n  maxDeliveryAttempts?: number;\n  /**\n   * Optional logger for diagnostics. When omitted, suppressed errors\n   * (BUSYGROUP, malformed payloads, connection-close races) are swallowed\n   * silently. When provided, those paths emit `debug`/`warn` entries so\n   * operators can see what's happening without noise on the happy path.\n   */\n  logger?: { debug?: (...args: unknown[]) => void; warn?: (...args: unknown[]) => void };\n}\n\nexport class RedisStreamsPubSub extends PubSub {\n  // Redis Streams is a pull transport: consumers issue XREADGROUP to read\n  // events. Mastra reads this to know an OrchestrationWorker is required.\n  override get supportedModes(): ReadonlyArray<PubSubDeliveryMode> {\n    return ['pull'];\n  }\n\n  #writeClient: RedisClientType;\n  #connectOptions: RedisClientOptions;\n  #keyPrefix: string;\n  #blockMs: number;\n  #maxStreamLength: number;\n  #reclaimIntervalMs: number;\n  #reclaimIdleMs: number;\n  #maxDeliveryAttempts: number;\n  #logger?: RedisStreamsPubSubConfig['logger'];\n  // Keyed by `${topic}::${cbId}` so the same callback can be subscribed to\n  // multiple topics independently. Without the topic in the key,\n  // unsubscribe(otherTopic, cb) would tear down the wrong subscription.\n  #subscriptions: Map<string, Subscription> = new Map();\n  #cbIds: WeakMap<EventCallback, string> = new WeakMap();\n  #pendingPublishes: Set<Promise<unknown>> = new Set();\n  #closed = false;\n\n  constructor(options: RedisStreamsPubSubConfig = {}) {\n    super();\n    const url = options.url ?? options.redisOptions?.url ?? 'redis://localhost:6379';\n    this.#connectOptions = { ...options.redisOptions, url };\n    this.#writeClient = createClient(this.#connectOptions) as RedisClientType;\n    this.#keyPrefix = options.keyPrefix ?? 'mastra:topic';\n    this.#blockMs = options.blockMs ?? 1000;\n    this.#maxStreamLength = options.maxStreamLength ?? 10_000;\n    this.#reclaimIntervalMs = options.reclaimIntervalMs ?? 30_000;\n    this.#reclaimIdleMs = options.reclaimIdleMs ?? 60_000;\n    const cap = options.maxDeliveryAttempts ?? 5;\n    if (cap === 0) {\n      options.logger?.warn?.(\n        'redis-streams: maxDeliveryAttempts=0 is treated as Infinity for back-compat; pass Infinity to disable the cap explicitly.',\n      );\n      this.#maxDeliveryAttempts = Infinity;\n    } else if (cap < 0 || Number.isNaN(cap)) {\n      throw new Error(`redis-streams: maxDeliveryAttempts must be >= 1 or Infinity, got ${cap}`);\n    } else {\n      this.#maxDeliveryAttempts = cap;\n    }\n    this.#logger = options.logger;\n  }\n\n  #subKey(topic: string, cb: EventCallback): string {\n    let cbId = this.#cbIds.get(cb);\n    if (!cbId) {\n      cbId = randomUUID();\n      this.#cbIds.set(cb, cbId);\n    }\n    return `${topic}::${cbId}`;\n  }\n\n  /** Lazily connect the shared writer client. Idempotent. */\n  async #ensureWriterConnected(): Promise<void> {\n    if (this.#writeClient.isOpen) return;\n    await this.#writeClient.connect();\n  }\n\n  #streamKey(topic: string): string {\n    return `${this.#keyPrefix}:${topic}`;\n  }\n\n  async publish(topic: string, event: Omit<Event, 'id' | 'createdAt'>): Promise<void> {\n    if (this.#closed) throw new Error('RedisStreamsPubSub: cannot publish on closed client');\n    await this.#ensureWriterConnected();\n\n    const id = randomUUID();\n    const createdAt = new Date();\n    const payload: Event = {\n      ...event,\n      id,\n      createdAt,\n      deliveryAttempt: event.deliveryAttempt ?? 1,\n    };\n    const xaddOptions: { TRIM?: { strategy: 'MAXLEN'; strategyModifier: '~'; threshold: number } } = {};\n    if (this.#maxStreamLength > 0) {\n      xaddOptions.TRIM = {\n        strategy: 'MAXLEN',\n        strategyModifier: '~',\n        threshold: this.#maxStreamLength,\n      };\n    }\n    const promise = this.#writeClient.xAdd(\n      this.#streamKey(topic),\n      '*',\n      { event: JSON.stringify(payload) },\n      xaddOptions,\n    );\n    this.#pendingPublishes.add(promise);\n    try {\n      await promise;\n    } finally {\n      this.#pendingPublishes.delete(promise);\n    }\n  }\n\n  async subscribe(topic: string, cb: EventCallback, options?: SubscribeOptions): Promise<void> {\n    if (this.#closed) throw new Error('RedisStreamsPubSub: cannot subscribe on closed client');\n    const key = this.#subKey(topic, cb);\n    if (this.#subscriptions.has(key)) return; // idempotent: same (topic, cb) already subscribed\n\n    await this.#ensureWriterConnected();\n\n    const isGrouped = !!options?.group;\n    const group = options?.group ?? `__fanout-${randomUUID()}`;\n    const consumer = `${group}-${randomUUID()}`;\n    const streamKey = this.#streamKey(topic);\n\n    // Create the consumer group if it doesn't exist. MKSTREAM creates the\n    // stream if needed. BUSYGROUP means another subscriber raced us — fine.\n    //\n    // We anchor brand-new groups at '0' (stream start) instead of '$' so that\n    // a worker which subscribes after a publish still sees the backlog. This\n    // is the \"late join\" case: a server may publish workflow.start before any\n    // orchestrator process exists. Without this, that work is silently lost.\n    // Existing groups (BUSYGROUP path) keep their own checkpoint, so this\n    // doesn't change semantics for already-running clusters. Stream growth is\n    // bounded by the MAXLEN ~ trim applied on every publish.\n    try {\n      await this.#writeClient.xGroupCreate(streamKey, group, '0', { MKSTREAM: true });\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      if (!msg.includes('BUSYGROUP')) throw err;\n      this.#logger?.debug?.('redis-streams: consumer group already exists', { topic, group });\n    }\n\n    // Each subscription gets a dedicated reader connection because XREADGROUP\n    // with BLOCK > 0 holds the connection until a message arrives.\n    const readClient = createClient(this.#connectOptions) as RedisClientType;\n    await readClient.connect();\n\n    const sub: Subscription = {\n      cb,\n      topic,\n      streamKey,\n      group,\n      consumer,\n      isGrouped,\n      readClient,\n      stopped: false,\n      loop: undefined,\n      reclaimTimer: undefined,\n    };\n    this.#subscriptions.set(key, sub);\n    sub.loop = this.#runReadLoop(sub);\n    this.#startReclaimLoop(sub);\n  }\n\n  /**\n   * Periodically run XAUTOCLAIM against this subscription's group so that\n   * messages a crashed/stuck consumer read but never acked get redelivered to\n   * a live sibling. Runs only for grouped subscriptions — fan-out groups are\n   * private to one consumer, so there's no sibling to claim from.\n   */\n  #startReclaimLoop(sub: Subscription): void {\n    if (this.#reclaimIntervalMs <= 0) return;\n    if (!sub.isGrouped) return;\n\n    const tick = async () => {\n      if (sub.stopped || this.#closed) return;\n      try {\n        const reply = await this.#writeClient.xAutoClaim(\n          sub.streamKey,\n          sub.group,\n          sub.consumer,\n          this.#reclaimIdleMs,\n          '0-0',\n          { COUNT: 100 },\n        );\n        const messages = (reply?.messages ?? []) as Array<{ id: string; message: Record<string, string> } | null>;\n        for (const entry of messages) {\n          if (sub.stopped || this.#closed) return;\n          if (!entry) continue;\n          await this.#deliverMessage(sub, entry.id, entry.message);\n        }\n      } catch (err) {\n        this.#logger?.debug?.('redis-streams: XAUTOCLAIM failed', {\n          topic: sub.topic,\n          group: sub.group,\n          err: err instanceof Error ? err.message : err,\n        });\n      }\n      if (sub.stopped || this.#closed) return;\n      sub.reclaimTimer = setTimeout(tick, this.#reclaimIntervalMs);\n    };\n\n    sub.reclaimTimer = setTimeout(tick, this.#reclaimIntervalMs);\n  }\n\n  async unsubscribe(topic: string, cb: EventCallback): Promise<void> {\n    const key = this.#subKey(topic, cb);\n    const sub = this.#subscriptions.get(key);\n    if (!sub) return;\n    this.#subscriptions.delete(key);\n    sub.stopped = true;\n    if (sub.reclaimTimer) {\n      clearTimeout(sub.reclaimTimer);\n      sub.reclaimTimer = undefined;\n    }\n\n    // Cancel the in-flight blocking XREADGROUP by closing the reader.\n    try {\n      await sub.readClient.quit();\n    } catch (err) {\n      this.#logger?.debug?.('redis-streams: reader quit failed', {\n        topic: sub.topic,\n        err: err instanceof Error ? err.message : err,\n      });\n    }\n\n    if (sub.loop) {\n      try {\n        await sub.loop;\n      } catch (err) {\n        // loop exits naturally when readClient closes; surface only at debug.\n        this.#logger?.debug?.('redis-streams: read loop exited with error', {\n          topic: sub.topic,\n          err: err instanceof Error ? err.message : err,\n        });\n      }\n    }\n\n    // For fan-out, drop the private group entirely so the stream can be reclaimed.\n    if (!sub.isGrouped) {\n      try {\n        await this.#writeClient.xGroupDestroy(sub.streamKey, sub.group);\n      } catch (err) {\n        this.#logger?.debug?.('redis-streams: xGroupDestroy failed', {\n          topic: sub.topic,\n          group: sub.group,\n          err: err instanceof Error ? err.message : err,\n        });\n      }\n    }\n  }\n\n  async flush(): Promise<void> {\n    // Wait for any in-flight publishes to settle.\n    if (this.#pendingPublishes.size > 0) {\n      await Promise.allSettled([...this.#pendingPublishes]);\n    }\n  }\n\n  /**\n   * Disconnect all clients and stop all subscription loops.\n   */\n  async close(): Promise<void> {\n    if (this.#closed) return;\n    this.#closed = true;\n\n    // Walk the actual subscriptions and pass the original topic through so\n    // unsubscribe's key lookup works.\n    const subs = [...this.#subscriptions.values()];\n    await Promise.all(subs.map(sub => this.unsubscribe(sub.topic, sub.cb)));\n\n    if (this.#writeClient.isOpen) {\n      try {\n        await this.#writeClient.quit();\n      } catch (err) {\n        this.#logger?.debug?.('redis-streams: writer quit failed', {\n          err: err instanceof Error ? err.message : err,\n        });\n      }\n    }\n  }\n\n  async #runReadLoop(sub: Subscription): Promise<void> {\n    while (!sub.stopped) {\n      let result;\n      try {\n        result = await sub.readClient.xReadGroup(sub.group, sub.consumer, [{ key: sub.streamKey, id: '>' }], {\n          COUNT: 10,\n          BLOCK: this.#blockMs,\n        });\n      } catch (err) {\n        if (sub.stopped) return;\n        this.#logger?.debug?.('redis-streams: xReadGroup failed', {\n          topic: sub.topic,\n          group: sub.group,\n          err: err instanceof Error ? err.message : err,\n        });\n        // Connection error or similar — pause briefly then retry.\n        await new Promise(r => setTimeout(r, 100));\n        continue;\n      }\n\n      if (!result || result.length === 0) continue;\n\n      for (const stream of result) {\n        for (const entry of stream.messages) {\n          if (sub.stopped) return;\n          await this.#deliverMessage(sub, entry.id, entry.message);\n        }\n      }\n    }\n  }\n\n  async #deliverMessage(sub: Subscription, streamId: string, fields: Record<string, string>): Promise<void> {\n    let event: Event;\n    try {\n      event = JSON.parse(fields.event ?? '{}') as Event;\n      // createdAt is serialized as a string; rehydrate.\n      if (typeof event.createdAt === 'string') {\n        event.createdAt = new Date(event.createdAt);\n      }\n    } catch (err) {\n      this.#logger?.debug?.('redis-streams: malformed payload, dropping', {\n        topic: sub.topic,\n        streamId,\n        err: err instanceof Error ? err.message : err,\n      });\n      try {\n        await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);\n      } catch (ackErr) {\n        this.#logger?.debug?.('redis-streams: xAck after malformed payload failed', {\n          topic: sub.topic,\n          err: ackErr instanceof Error ? ackErr.message : ackErr,\n        });\n      }\n      return;\n    }\n\n    let settled = false;\n    const ack = async () => {\n      if (settled) return;\n      settled = true;\n      try {\n        // Only ack against this consumer group. Do NOT xDel: the stream may\n        // be consumed by other groups, and xDel removes the entry for all of\n        // them. Stream growth is bounded elsewhere via MAXLEN-style trimming.\n        await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);\n      } catch (err) {\n        this.#logger?.debug?.('redis-streams: ack cleanup failed', {\n          topic: sub.topic,\n          err: err instanceof Error ? err.message : err,\n        });\n      }\n    };\n    const nack = async () => {\n      if (settled) return;\n      settled = true;\n      const attempt = event.deliveryAttempt ?? 1;\n      // Cap redelivery to avoid an infinite poison-pill loop. When the cap\n      // is hit we drop the event (xAck without republish) and warn so an\n      // operator can find it in logs.\n      if (attempt >= this.#maxDeliveryAttempts) {\n        this.#logger?.warn?.('redis-streams: dropping event after max delivery attempts', {\n          topic: sub.topic,\n          eventType: event.type,\n          eventId: event.id,\n          attempt,\n          max: this.#maxDeliveryAttempts,\n        });\n        try {\n          // Group-scoped ack only — see ack() above for why we never xDel.\n          await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);\n        } catch (err) {\n          this.#logger?.debug?.('redis-streams: ack on dropped poison message failed', {\n            topic: sub.topic,\n            err: err instanceof Error ? err.message : err,\n          });\n        }\n        return;\n      }\n      // Republish with incremented deliveryAttempt FIRST, then ack the\n      // original entry. If the republish fails we deliberately leave the\n      // original message pending so XAUTOCLAIM (or another consumer) can\n      // pick it up on a future tick — acking first would silently drop it.\n      const next: Event = {\n        ...event,\n        deliveryAttempt: attempt + 1,\n      };\n      try {\n        await this.#writeClient.xAdd(sub.streamKey, '*', { event: JSON.stringify(next) });\n      } catch (err) {\n        this.#logger?.warn?.('redis-streams: nack republish failed; leaving original pending for reclaim', {\n          topic: sub.topic,\n          eventId: event.id,\n          err: err instanceof Error ? err.message : err,\n        });\n        // Allow this entry to be redelivered: reset settled so the next\n        // delivery attempt (via XAUTOCLAIM) can ack/nack it again.\n        settled = false;\n        return;\n      }\n      try {\n        await this.#writeClient.xAck(sub.streamKey, sub.group, streamId);\n      } catch (err) {\n        this.#logger?.debug?.('redis-streams: xAck after nack failed', {\n          topic: sub.topic,\n          err: err instanceof Error ? err.message : err,\n        });\n      }\n    };\n\n    try {\n      // EventCallback is typed `=> void` but handlers commonly return a\n      // promise (TS allows Promise<void> to satisfy void). If we get one\n      // back, attach a catch handler so async rejections route to nack\n      // instead of silently dropping the message. We do NOT await here —\n      // serializing messages on a subscription would deadlock orchestration\n      // callbacks that await their own future events.\n      const result: unknown = sub.cb(event, ack, nack);\n      if (result && typeof (result as { then?: unknown; catch?: unknown }).catch === 'function') {\n        (result as Promise<unknown>).catch(async () => {\n          await nack();\n        });\n      }\n    } catch {\n      // Caller threw synchronously — treat as nack.\n      await nack();\n    }\n  }\n}\n\ninterface Subscription {\n  cb: EventCallback;\n  topic: string;\n  streamKey: string;\n  group: string;\n  consumer: string;\n  isGrouped: boolean;\n  readClient: RedisClientType;\n  stopped: boolean;\n  loop: Promise<void> | undefined;\n  reclaimTimer: ReturnType<typeof setTimeout> | undefined;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/redis-streams",
-  "version": "0.0.0",
+  "version": "0.0.2-alpha.0",
   "description": "Mastra Redis Streams PubSub integration",
   "type": "module",
   "main": "dist/index.js",
@@ -22,31 +22,23 @@
     },
     "./package.json": "./package.json"
   },
-  "scripts": {
-    "build": "tsup --silent --config tsup.config.ts",
-    "build:watch": "tsup --watch --silent --config tsup.config.ts",
-    "pretest": "docker compose up -d --wait",
-    "test": "vitest run",
-    "posttest": "docker compose down",
-    "lint": "eslint ."
-  },
   "dependencies": {
     "redis": "5.10.0"
   },
   "devDependencies": {
-    "@internal/lint": "workspace:*",
-    "@internal/types-builder": "workspace:*",
-    "@mastra/core": "workspace:*",
-    "@mastra/deployer": "workspace:*",
-    "@mastra/libsql": "workspace:*",
     "@types/node": "22.19.15",
-    "@vitest/coverage-v8": "catalog:",
-    "@vitest/ui": "catalog:",
+    "@vitest/coverage-v8": "4.1.5",
+    "@vitest/ui": "4.1.5",
     "eslint": "^10.2.1",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
+    "typescript": "^6.0.3",
+    "vitest": "4.1.5",
+    "@internal/lint": "0.0.92",
+    "@mastra/core": "1.33.0-alpha.9",
+    "@internal/types-builder": "0.0.67",
+    "@mastra/libsql": "1.10.1-alpha.2",
+    "@mastra/deployer": "1.33.0-alpha.9"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0-0 <2.0.0-0"
@@ -62,5 +54,13 @@
   },
   "engines": {
     "node": ">=22.13.0"
+  },
+  "scripts": {
+    "build": "tsup --silent --config tsup.config.ts",
+    "build:watch": "tsup --watch --silent --config tsup.config.ts",
+    "pretest": "docker compose up -d --wait",
+    "test": "vitest run",
+    "posttest": "docker compose down",
+    "lint": "eslint ."
   }
-}
+}