@mastra/redis 0.0.0-a2a-vnext-20260424123427

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+# @mastra/redis
+
+## 0.0.0-a2a-vnext-20260424123427
+
+### Patch Changes
+
+- Updated dependencies [[`092271d`](https://github.com/mastra-ai/mastra/commit/092271d86af4cbe0d70cbf32709dd99b58acd3dd)]:
+  - @mastra/core@0.0.0-a2a-vnext-20260424123427
+
+## 1.0.1
+
+### Patch Changes
+
+- Add Redis storage provider ([#11795](https://github.com/mastra-ai/mastra/pull/11795))
+
+  Introduces `@mastra/redis`, a Redis-backed storage implementation for Mastra built on the official `redis` (node-redis) client.
+
+  Includes support for the core storage domains (memory, workflows, scores) and multiple connection options: `connectionString`, `host`/`port`/`db`/`password`, or injecting a pre-configured client for advanced setups (e.g. custom socket/retry settings, Sentinel/Cluster via custom client).
+
+- Updated dependencies [[`20f59b8`](https://github.com/mastra-ai/mastra/commit/20f59b876cf91199efbc49a0e36b391240708f08), [`aba393e`](https://github.com/mastra-ai/mastra/commit/aba393e2da7390c69b80e516a4f153cda6f09376), [`3d83d06`](https://github.com/mastra-ai/mastra/commit/3d83d06f776f00fb5f4163dddd32a030c5c20844), [`e2687a7`](https://github.com/mastra-ai/mastra/commit/e2687a7408790c384563816a9a28ed06735684c9), [`fdd54cf`](https://github.com/mastra-ai/mastra/commit/fdd54cf612a9af876e9fdd85e534454f6e7dd518), [`6315317`](https://github.com/mastra-ai/mastra/commit/63153175fe9a7b224e5be7c209bbebc01dd9b0d5), [`a371ac5`](https://github.com/mastra-ai/mastra/commit/a371ac534aa1bb368a1acf9d8b313378dfdc787e), [`0474c2b`](https://github.com/mastra-ai/mastra/commit/0474c2b2e7c7e1ad8691dca031284841391ff1ef), [`0a5fa1d`](https://github.com/mastra-ai/mastra/commit/0a5fa1d3cb0583889d06687155f26fd7d2edc76c), [`7e0e63e`](https://github.com/mastra-ai/mastra/commit/7e0e63e2e485e84442351f4c7a79a424c83539dc), [`ea43e64`](https://github.com/mastra-ai/mastra/commit/ea43e646dd95d507694b6112b0bf1df22ad552b2), [`f607106`](https://github.com/mastra-ai/mastra/commit/f607106854c6416c4a07d4082604b9f66d047221), [`30456b6`](https://github.com/mastra-ai/mastra/commit/30456b6b08c8fd17e109dd093b73d93b65e83bc5), [`9d11a8c`](https://github.com/mastra-ai/mastra/commit/9d11a8c1c8924eb975a245a5884d40ca1b7e0491), [`9d3b24b`](https://github.com/mastra-ai/mastra/commit/9d3b24b19407ae9c09586cf7766d38dc4dff4a69), [`00d1b16`](https://github.com/mastra-ai/mastra/commit/00d1b16b401199cb294fa23f43336547db4dca9b), [`47cee3e`](https://github.com/mastra-ai/mastra/commit/47cee3e137fe39109cf7fffd2a8cf47b76dc702e), [`62919a6`](https://github.com/mastra-ai/mastra/commit/62919a6ee0fbf3779ad21a97b1ec6696515d5104), [`d246696`](https://github.com/mastra-ai/mastra/commit/d246696139a3144a5b21b042d41c532688e957e1), [`354f9ce`](https://github.com/mastra-ai/mastra/commit/354f9ce1ca6af2074b6a196a23f8ec30012dccca), [`16e34ca`](https://github.com/mastra-ai/mastra/commit/16e34caa98b9a114b17a6125e4e3fd87f169d0d0), [`7020c06`](https://github.com/mastra-ai/mastra/commit/7020c0690b199d9da337f0e805f16948e557922e), [`8786a61`](https://github.com/mastra-ai/mastra/commit/8786a61fa54ba265f85eeff9985ca39863d18bb6), [`9467ea8`](https://github.com/mastra-ai/mastra/commit/9467ea87695749a53dfc041576410ebf9ee7bb67), [`7338d94`](https://github.com/mastra-ai/mastra/commit/7338d949380cf68b095342e8e42610dc51d557c1), [`c80dc16`](https://github.com/mastra-ai/mastra/commit/c80dc16e113e6cc159f510ffde501ad4711b2189), [`af8a57e`](https://github.com/mastra-ai/mastra/commit/af8a57ed9ba9685ad8601d5b71ae3706da6222f9), [`d63ffdb`](https://github.com/mastra-ai/mastra/commit/d63ffdbb2c11e76fe5ea45faab44bc15460f010c), [`47cee3e`](https://github.com/mastra-ai/mastra/commit/47cee3e137fe39109cf7fffd2a8cf47b76dc702e), [`1bd5104`](https://github.com/mastra-ai/mastra/commit/1bd51048b6da93507276d6623e3fd96a9e1a8944), [`e9837b5`](https://github.com/mastra-ai/mastra/commit/e9837b53699e18711b09e0ca010a4106376f2653), [`8f1b280`](https://github.com/mastra-ai/mastra/commit/8f1b280b7fe6999ec654f160cb69c1a8719e7a57), [`92dcf02`](https://github.com/mastra-ai/mastra/commit/92dcf029294210ac91b090900c1a0555a425c57a), [`0fd90a2`](https://github.com/mastra-ai/mastra/commit/0fd90a215caf5fca8099c15a67ca03e4427747a3), [`8fb2405`](https://github.com/mastra-ai/mastra/commit/8fb2405138f2d208b7962ad03f121ca25bcc28c5), [`12df98c`](https://github.com/mastra-ai/mastra/commit/12df98c4904643d9481f5c78f3bed443725b4c96)]:
+  - @mastra/core@1.26.0
+
+## 1.0.1-alpha.0
+
+### Patch Changes
+
+- Add Redis storage provider ([#11795](https://github.com/mastra-ai/mastra/pull/11795))
+
+  Introduces `@mastra/redis`, a Redis-backed storage implementation for Mastra built on the official `redis` (node-redis) client.
+
+  Includes support for the core storage domains (memory, workflows, scores) and multiple connection options: `connectionString`, `host`/`port`/`db`/`password`, or injecting a pre-configured client for advanced setups (e.g. custom socket/retry settings, Sentinel/Cluster via custom client).
+
+- Updated dependencies [[`a371ac5`](https://github.com/mastra-ai/mastra/commit/a371ac534aa1bb368a1acf9d8b313378dfdc787e), [`47cee3e`](https://github.com/mastra-ai/mastra/commit/47cee3e137fe39109cf7fffd2a8cf47b76dc702e), [`c80dc16`](https://github.com/mastra-ai/mastra/commit/c80dc16e113e6cc159f510ffde501ad4711b2189), [`47cee3e`](https://github.com/mastra-ai/mastra/commit/47cee3e137fe39109cf7fffd2a8cf47b76dc702e)]:
+  - @mastra/core@1.26.0-alpha.12

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/README.md

@@ -0,0 +1,223 @@
+# @mastra/redis
+
+Redis storage provider for Mastra that provides storage capabilities for direct Redis connections.
+
+## Installation
+
+```bash
+npm install @mastra/redis
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { RedisStore } from '@mastra/redis';
+
+// Using connection string
+const storage = new RedisStore({
+  id: 'my-storage',
+  connectionString: 'redis://localhost:6379',
+});
+
+// Using host/port config
+const storage = new RedisStore({
+  id: 'my-storage',
+  host: 'localhost',
+  port: 6379,
+  password: 'your-password',
+  db: 0,
+});
+
+// Initialize (connects to Redis)
+await storage.init();
+```
+
+### With Pre-configured Client
+
+```typescript
+import { RedisStore } from '@mastra/redis';
+import { createClient } from 'redis';
+
+// Create a custom redis client with specific settings
+const client = createClient({
+  url: 'redis://localhost:6379',
+  socket: {
+    reconnectStrategy: retries => Math.min(retries * 50, 2000),
+  },
+});
+
+// Connect the client before passing to RedisStore
+await client.connect();
+
+const storage = new RedisStore({
+  id: 'my-storage',
+  client,
+});
+```
+
+## Parameters
+
+| Parameter          | Type          | Description                                            |
+| ------------------ | ------------- | ------------------------------------------------------ |
+| `id`               | `string`      | Unique identifier for the storage instance             |
+| `connectionString` | `string`      | Redis connection URL (e.g., `redis://localhost:6379`)  |
+| `host`             | `string`      | Redis host address                                     |
+| `port`             | `number`      | Redis port (default: 6379)                             |
+| `password`         | `string`      | Redis password for authentication                      |
+| `db`               | `number`      | Redis database number (default: 0)                     |
+| `client`           | `RedisClient` | Pre-configured redis client (from the `redis` package) |
+| `disableInit`      | `boolean`     | Disable automatic initialization                       |
+
+## Accessing Storage Domains
+
+```typescript
+// Access memory domain (threads, messages, resources)
+const memory = await storage.getStore('memory');
+await memory?.saveThread({ thread });
+await memory?.saveMessages({ messages });
+
+// Access workflows domain
+const workflows = await storage.getStore('workflows');
+await workflows?.persistWorkflowSnapshot({ workflowName, runId, snapshot });
+
+// Access scores domain
+const scores = await storage.getStore('scores');
+await scores?.saveScore(score);
+```
+
+## Usage with Mastra Agent
+
+```typescript
+import { Memory } from '@mastra/memory';
+import { Agent } from '@mastra/core/agent';
+import { RedisStore } from '@mastra/redis';
+
+export const redisAgent = new Agent({
+  id: 'redis-agent',
+  name: 'Redis Agent',
+  instructions: 'You are an AI agent with memory backed by Redis.',
+  model: 'openai/gpt-4',
+  memory: new Memory({
+    storage: new RedisStore({
+      id: 'redis-agent-storage',
+      connectionString: process.env.REDIS_URL!,
+    }),
+    options: {
+      generateTitle: true,
+    },
+  }),
+});
+```
+
+## Accessing the Underlying Client
+
+You can access the underlying redis client for advanced operations:
+
+```typescript
+const storage = new RedisStore({
+  id: 'my-storage',
+  connectionString: 'redis://localhost:6379',
+});
+
+await storage.init();
+
+// Get the redis client
+const client = storage.getClient();
+
+// Use for custom operations
+await client.set('custom-key', 'value');
+const value = await client.get('custom-key');
+```
+
+## Key Structure
+
+The Redis storage uses the following key patterns:
+
+- Threads: `mastra_threads:id:{threadId}`
+- Messages: `mastra_messages:threadId:{threadId}:id:{messageId}`
+- Message index: `msg-idx:{messageId}` (for fast lookups)
+- Thread messages sorted set: `thread:{threadId}:messages`
+- Workflow snapshots: `mastra_workflow_snapshot:namespace:{ns}:workflow_name:{name}:run_id:{id}`
+- Scores: `mastra_scorers:id:{scoreId}`
+- Resources: `mastra_resources:{resourceId}`
+
+## Features
+
+- Direct Redis connections via the official `redis` package (node-redis)
+- Support for Redis Sentinel and Cluster (via custom client)
+- Persistent storage for threads, messages, and resources
+- Workflow state persistence with snapshot support
+- Evaluation scores storage
+- Sorted sets for message ordering
+- Efficient batch operations with multi/exec
+
+## Connection Options
+
+### Standalone Redis
+
+```typescript
+const storage = new RedisStore({
+  id: 'standalone',
+  host: 'localhost',
+  port: 6379,
+});
+```
+
+### Redis with Password
+
+```typescript
+const storage = new RedisStore({
+  id: 'auth',
+  connectionString: 'redis://:password@localhost:6379',
+});
+```
+
+### Redis Sentinel (via custom client)
+
+```typescript
+import { createClient } from 'redis';
+
+const client = createClient({
+  url: 'redis://localhost:26379',
+  // Configure sentinel options as needed
+});
+await client.connect();
+
+const storage = new RedisStore({
+  id: 'sentinel',
+  client,
+});
+```
+
+### Redis Cluster (via custom client)
+
+```typescript
+import { RedisStore } from '@mastra/redis';
+import { createCluster } from 'redis';
+
+const cluster = createCluster({
+  rootNodes: [{ url: 'redis://node-1:6379' }, { url: 'redis://node-2:6379' }],
+});
+await cluster.connect();
+
+const storage = new RedisStore({
+  id: 'cluster',
+  client: cluster,
+});
+```
+
+## Closing Connections
+
+Always close connections when done:
+
+```typescript
+await storage.close();
+```
+
+## Related Links
+
+- [Redis Documentation](https://redis.io/documentation)
+- [node-redis Documentation](https://github.com/redis/node-redis)
+- [Mastra Documentation](https://mastra.ai/docs)

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@mastra/redis",
+  "version": "0.0.0-a2a-vnext-20260424123427",
+  "description": "Redis storage provider for Mastra - provides storage capabilities for direct Redis connections",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "author": "Mauro Erta <mauro@vlkstudio.com>",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "redis": "5.10.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.13.17",
+    "@vitest/coverage-v8": "4.1.5",
+    "@vitest/ui": "4.1.5",
+    "dotenv": "^17.0.0",
+    "eslint": "^9.37.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "4.1.5",
+    "@internal/lint": "0.0.0-a2a-vnext-20260424123427",
+    "@mastra/core": "0.0.0-a2a-vnext-20260424123427",
+    "@internal/storage-test-utils": "0.0.82",
+    "@internal/types-builder": "0.0.0-a2a-vnext-20260424123427"
+  },
+  "peerDependencies": {
+    "@mastra/core": "0.0.0-a2a-vnext-20260424123427"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "homepage": "https://mastra.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mastra-ai/mastra.git",
+    "directory": "stores/redis"
+  },
+  "bugs": {
+    "url": "https://github.com/mastra-ai/mastra/issues"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "pretest": "docker compose up -d",
+    "test": "vitest run",
+    "posttest": "docker compose down",
+    "lint": "eslint .",
+    "build:lib": "tsup --silent --config tsup.config.ts",
+    "build:docs": "pnpx tsx ../../scripts/generate-package-docs.ts stores/redis",
+    "build:watch": "tsup --watch --silent --config tsup.config.ts"
+  }
+}