@kuralle-agents/redis-store 0.5.0 → 0.6.0

package/README.md

@@ -18,6 +18,7 @@ Three backend implementations — sessions, long-term memory, and vector search
 
 - **`RedisSessionStore`** — `SessionStore` implementation for durable session persistence.
 - **`RedisMemoryService`** — `MemoryService` implementation for cross-session long-term memory.
+- **`RedisPersistentMemoryStore`** — `PersistentMemoryStore` for durable USER/MEMORY markdown blocks.
 - **`RedisVectorStore`** — `VectorStoreCore` implementation for vector similarity search.
 - **`fromUpstash` / `fromNodeRedis` / `fromIORedis`** — client adapters.
 
@@ -92,6 +93,25 @@ const runtime = createRuntime({
 });
 ```
 
+## Working memory blocks
+
+```ts
+import { createRuntime } from '@kuralle-agents/core';
+import { RedisPersistentMemoryStore, fromUpstash } from '@kuralle-agents/redis-store';
+import { Redis } from '@upstash/redis';
+
+const client = Redis.fromEnv();
+const workingMemoryStore = new RedisPersistentMemoryStore({ client, prefix: 'kuralle' });
+
+const runtime = createRuntime({
+  agents: [agent],
+  defaultAgentId: 'support',
+  defaultWorkingMemoryStore: workingMemoryStore,
+});
+```
+
+On Cloudflare Workers, use `fromUpstash` with the REST client — no TCP socket required.
+
 ## Related
 
 - [`@kuralle-agents/core`](https://www.npmjs.com/package/@kuralle-agents/core) — `SessionStore` interface and runtime.

package/dist/RedisPersistentMemoryStore.d.ts

@@ -0,0 +1,17 @@
+import type { MemoryBlockScope, PersistentMemoryBlock, PersistentMemoryStore } from '@kuralle-agents/core';
+import type { RedisClientLike } from './RedisSessionStore.js';
+export type RedisPersistentMemoryStoreOptions = {
+    client: RedisClientLike;
+    prefix?: string;
+};
+export declare class RedisPersistentMemoryStore implements PersistentMemoryStore {
+    private client;
+    private prefix;
+    constructor(options: RedisPersistentMemoryStoreOptions);
+    private blockKey;
+    private indexKey;
+    loadBlock(scope: MemoryBlockScope, owner: string, key: string): Promise<PersistentMemoryBlock | null>;
+    saveBlock(block: PersistentMemoryBlock, owner: string): Promise<void>;
+    deleteBlock(scope: MemoryBlockScope, owner: string, key: string): Promise<void>;
+    listBlocks(scope: MemoryBlockScope, owner: string): Promise<string[]>;
+}

package/dist/RedisPersistentMemoryStore.js

@@ -0,0 +1,51 @@
+import { addMembers, callCommand, getMembers, removeMembers, } from './redisHelpers.js';
+export class RedisPersistentMemoryStore {
+    client;
+    prefix;
+    constructor(options) {
+        this.client = options.client;
+        this.prefix = options.prefix ?? 'kuralle';
+    }
+    blockKey(scope, owner, key) {
+        return `${this.prefix}:wm:${scope}:${owner}:${key}`;
+    }
+    indexKey(scope, owner) {
+        return `${this.prefix}:wm:${scope}:${owner}:__index`;
+    }
+    async loadBlock(scope, owner, key) {
+        const raw = await callCommand(this.client, ['get'], this.blockKey(scope, owner, key));
+        if (!raw) {
+            return null;
+        }
+        try {
+            const parsed = JSON.parse(raw);
+            return {
+                key,
+                scope,
+                content: parsed.content,
+                charLimit: parsed.charLimit,
+                updatedAt: parsed.updatedAt,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    async saveBlock(block, owner) {
+        const payload = {
+            ...block,
+            updatedAt: block.updatedAt ?? new Date().toISOString(),
+        };
+        const redisKey = this.blockKey(block.scope, owner, block.key);
+        await callCommand(this.client, ['set'], redisKey, JSON.stringify(payload));
+        await addMembers(this.client, this.indexKey(block.scope, owner), block.key);
+    }
+    async deleteBlock(scope, owner, key) {
+        await callCommand(this.client, ['del'], this.blockKey(scope, owner, key));
+        await removeMembers(this.client, this.indexKey(scope, owner), key);
+    }
+    async listBlocks(scope, owner) {
+        const keys = await getMembers(this.client, this.indexKey(scope, owner));
+        return keys.sort();
+    }
+}

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export { RedisSessionStore } from './RedisSessionStore.js';
 export type { RedisClientLike, RedisStoreOptions } from './RedisSessionStore.js';
 export { RedisMemoryService } from './RedisMemoryService.js';
 export type { RedisMemoryStoreOptions } from './RedisMemoryService.js';
+export { RedisPersistentMemoryStore } from './RedisPersistentMemoryStore.js';
+export type { RedisPersistentMemoryStoreOptions } from './RedisPersistentMemoryStore.js';
 export { fromUpstash, fromNodeRedis, fromIORedis } from './adapters.js';
 export type { RedisAdapterOptions } from './adapters.js';
 export { RedisVectorStore } from './RedisVectorStore.js';

package/dist/index.js

@@ -1,4 +1,5 @@
 export { RedisSessionStore } from './RedisSessionStore.js';
 export { RedisMemoryService } from './RedisMemoryService.js';
+export { RedisPersistentMemoryStore } from './RedisPersistentMemoryStore.js';
 export { fromUpstash, fromNodeRedis, fromIORedis } from './adapters.js';
 export { RedisVectorStore } from './RedisVectorStore.js';

package/package.json

@@ -6,7 +6,7 @@
     "url": "git+https://github.com/kuralle/kuralle-agents.git",
     "directory": "packages/kuralle-redis-store"
   },
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Redis-backed SessionStore for Kuralle (supports Upstash and common Redis clients)",
   "type": "module",
   "main": "dist/index.js",
@@ -18,11 +18,11 @@
     }
   },
   "dependencies": {
-    "@kuralle-agents/core": "0.5.0"
+    "@kuralle-agents/core": "0.6.0"
   },
   "peerDependencies": {
-    "@kuralle-agents/core": "0.5.0",
-    "@kuralle-agents/rag": "0.5.0"
+    "@kuralle-agents/core": "0.6.0",
+    "@kuralle-agents/rag": "0.6.0"
   },
   "devDependencies": {
     "@ai-sdk/openai": "^3.0.0",
@@ -33,7 +33,7 @@
     "tsx": "^4.7.0",
     "typescript": "^5.3.0",
     "zod": "^3.22.0",
-    "@kuralle-agents/rag": "0.5.0"
+    "@kuralle-agents/rag": "0.6.0"
   },
   "publishConfig": {
     "access": "public"