@mastra/valkey 0.2.1-alpha.0 → 0.2.1-alpha.1

package/README.md

@@ -10,188 +10,7 @@ npm install @mastra/valkey
 
 ## Usage
 
-### Basic Usage
-
-```typescript
-import { ValkeyStore } from '@mastra/valkey';
-
-// Using connection string
-const storage = new ValkeyStore({
-  id: 'my-storage',
-  connectionString: 'valkey://localhost:6379',
-});
-
-// Using host/port config
-const storage = new ValkeyStore({
-  id: 'my-storage',
-  host: 'localhost',
-  port: 6379,
-  password: 'your-password',
-  db: 0,
-});
-
-// Initialize (connects to Valkey)
-await storage.init();
-```
-
-### With Pre-configured Client
-
-```typescript
-import { ValkeyStore } from '@mastra/valkey';
-import { createClient } from 'valkey';
-
-// Create a custom valkey client with specific settings
-const client = createClient({
-  url: 'valkey://localhost:6379',
-  socket: {
-    reconnectStrategy: retries => Math.min(retries * 50, 2000),
-  },
-});
-
-// Connect the client before passing to ValkeyStore
-await client.connect();
-
-const storage = new ValkeyStore({
-  id: 'my-storage',
-  client,
-});
-```
-
-## Parameters
-
-| Parameter          | Type           | Description                                              |
-| ------------------ | -------------- | -------------------------------------------------------- |
-| `id`               | `string`       | Unique identifier for the storage instance               |
-| `connectionString` | `string`       | Valkey connection URL (e.g., `valkey://localhost:6379`)  |
-| `host`             | `string`       | Valkey host address                                      |
-| `port`             | `number`       | Valkey port (default: 6379)                              |
-| `password`         | `string`       | Valkey password for authentication                       |
-| `db`               | `number`       | Valkey database number (default: 0)                      |
-| `client`           | `ValkeyClient` | Pre-configured valkey client (from the `valkey` 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 { ValkeyStore } from '@mastra/valkey';
-
-export const valkeyAgent = new Agent({
-  id: 'valkey-agent',
-  name: 'Valkey Agent',
-  instructions: 'You are an AI agent with memory backed by Valkey.',
-  model: 'openai/gpt-4',
-  memory: new Memory({
-    storage: new ValkeyStore({
-      id: 'valkey-agent-storage',
-      connectionString: process.env.VALKEY_URL!,
-    }),
-    options: {
-      generateTitle: true,
-    },
-  }),
-});
-```
-
-## Accessing the Underlying Client
-
-You can access the underlying valkey client for advanced operations:
-
-```typescript
-const storage = new ValkeyStore({
-  id: 'my-storage',
-  connectionString: 'valkey://localhost:6379',
-});
-
-await storage.init();
-
-// Get the valkey 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 Valkey 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 Valkey connections via the official `valkey` package (node-valkey)
-- Support for Valkey 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 Valkey
-
-```typescript
-const storage = new ValkeyStore({
-  id: 'standalone',
-  host: 'localhost',
-  port: 6379,
-});
-```
-
-### Valkey with Password
-
-```typescript
-const storage = new ValkeyStore({
-  id: 'auth',
-  connectionString: 'valkey://:password@localhost:6379',
-});
-```
-
-### Valkey Sentinel (via custom client)
-
-```typescript
-import { createClient } from 'valkey';
-
-const client = createClient({
-  url: 'valkey://localhost:26379',
-  // Configure sentinel options as needed
-});
-await client.connect();
-
-const storage = new ValkeyStore({
-  id: 'sentinel',
-  client,
-});
-```
-
-### Valkey Cluster (via custom client)
+Configure the database credentials required by your provider.
 
 ```typescript
 import { ValkeyStore } from '@mastra/valkey';
@@ -208,16 +27,15 @@ const storage = new ValkeyStore({
 });
 ```
 
-## Closing Connections
+## Documentation
 
-Always close connections when done:
+- [Valkey integration guide](https://mastra.ai/integrations/databases/valkey)
+- [Storage reference](https://mastra.ai/reference/storage/overview)
 
-```typescript
-await storage.close();
-```
+## Changelog
+
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/stores/valkey/CHANGELOG.md) for version history and release notes.
 
-## Related Links
+## Support
 
-- [Valkey Documentation](https://valkey.io/documentation)
-- [node-valkey Documentation](https://github.com/valkey/node-valkey)
-- [Mastra Documentation](https://mastra.ai/docs)
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-valkey
 description: Documentation for @mastra/valkey. Use when working with @mastra/valkey APIs, configuration, or implementation.
 metadata:
   package: "@mastra/valkey"
-  version: "0.2.1-alpha.0"
+  version: "0.2.1-alpha.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.1-alpha.0",
+  "version": "0.2.1-alpha.1",
   "package": "@mastra/valkey",
   "exports": {},
   "modules": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/valkey",
-  "version": "0.2.1-alpha.0",
+  "version": "0.2.1-alpha.1",
   "description": "Valkey storage and cache provider for Mastra, powered by Valkey GLIDE",
   "type": "module",
   "main": "dist/index.js",
@@ -33,10 +33,10 @@
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
     "vitest": "4.1.10",
-    "@internal/storage-test-utils": "0.0.125",
+    "@internal/lint": "0.0.129",
     "@internal/types-builder": "0.0.104",
-    "@mastra/core": "1.64.0-alpha.2",
-    "@internal/lint": "0.0.129"
+    "@internal/storage-test-utils": "0.0.125",
+    "@mastra/core": "1.64.0-alpha.7"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.61.0-0 <2.0.0-0"