@hazeljs/messaging 0.2.0-beta.30

package/dist/messaging.service.js

@@ -0,0 +1,109 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessagingService = void 0;
+/**
+ * Messaging Service - LLM/Agent-powered bot response generation
+ * Uses IConversationContextStore (memory or Redis) for horizontally scalable context
+ * Supports: plain LLM, RAG-augmented, Agent (tools + RAG like CSR), custom handler
+ */
+const core_1 = require("@hazeljs/core");
+const memory_conversation_context_1 = require("./store/memory-conversation-context");
+const DEFAULT_SYSTEM_PROMPT = `You are a helpful, friendly assistant in a messaging app. 
+Keep responses concise and conversational. Adapt your tone to be natural for chat.`;
+const RAG_CONTEXT_PREFIX = `Use the following context from the knowledge base to answer. 
+If the context doesn't contain relevant information, say so. Cite sources when helpful.\n\n---\n`;
+let MessagingService = class MessagingService {
+    constructor(options = {}, contextStore) {
+        this.options = {
+            systemPrompt: DEFAULT_SYSTEM_PROMPT,
+            model: 'gpt-4o-mini',
+            temperature: 0.7,
+            maxTokens: 500,
+            maxContextTurns: 10,
+            ragTopK: 5,
+            ragMinScore: 0.5,
+            ...options,
+        };
+        this.store = contextStore ?? options.contextStore ?? new memory_conversation_context_1.MemoryConversationContextStore();
+    }
+    /** Generate bot response for an incoming message */
+    async handleMessage(message) {
+        const store = this.store;
+        const sessionId = message.sessionId ?? `default:${message.channel}:${message.userId}`;
+        if (this.options.customHandler) {
+            const reply = await Promise.resolve(this.options.customHandler(message));
+            await store.appendTurn(sessionId, { role: 'user', content: message.text }, this.options.maxContextTurns);
+            if (reply) {
+                await store.appendTurn(sessionId, { role: 'assistant', content: reply }, this.options.maxContextTurns);
+            }
+            return reply;
+        }
+        if (this.options.agentHandler) {
+            await store.appendTurn(sessionId, { role: 'user', content: message.text }, this.options.maxContextTurns);
+            const turns = await store.getTurns(sessionId);
+            const result = await this.options.agentHandler({
+                message,
+                sessionId,
+                conversationTurns: turns,
+            });
+            const reply = typeof result === 'string' ? result : result.response;
+            if (reply) {
+                await store.appendTurn(sessionId, { role: 'assistant', content: reply }, this.options.maxContextTurns);
+            }
+            return reply;
+        }
+        const provider = this.options.aiProvider;
+        if (!provider) {
+            throw new Error('MessagingService requires aiProvider, agentHandler, or customHandler. Configure via MessagingModule.forRoot().');
+        }
+        await store.appendTurn(sessionId, { role: 'user', content: message.text }, this.options.maxContextTurns);
+        const turns = await store.getTurns(sessionId);
+        let systemPrompt = this.options.systemPrompt;
+        if (this.options.ragService) {
+            const results = await this.options.ragService.search(message.text, {
+                topK: this.options.ragTopK,
+                minScore: this.options.ragMinScore,
+            });
+            if (results.length > 0) {
+                const context = results.map((r, i) => `[${i + 1}] ${r.content}`).join('\n\n');
+                systemPrompt = `${systemPrompt}\n\n${RAG_CONTEXT_PREFIX}Context:\n${context}\n---\n`;
+            }
+        }
+        const messages = [
+            { role: 'system', content: systemPrompt },
+            ...turns.map((t) => ({ role: t.role, content: t.content })),
+        ];
+        const response = await provider.complete({
+            messages,
+            model: this.options.model,
+            temperature: this.options.temperature,
+            maxTokens: this.options.maxTokens,
+        });
+        const reply = response.content?.trim() ?? 'I could not generate a response.';
+        await store.appendTurn(sessionId, { role: 'assistant', content: reply }, this.options.maxContextTurns);
+        return reply;
+    }
+    /** Clear conversation history for a session */
+    async clearSession(sessionId) {
+        await this.store.clearSession(sessionId);
+    }
+    /** Get current options */
+    getOptions() {
+        return { ...this.options };
+    }
+};
+exports.MessagingService = MessagingService;
+exports.MessagingService = MessagingService = __decorate([
+    (0, core_1.Injectable)(),
+    __metadata("design:paramtypes", [Object, Object])
+], MessagingService);
+//# sourceMappingURL=messaging.service.js.map

package/dist/messaging.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.service.js","sourceRoot":"","sources":["../src/messaging.service.ts"],"names":[],"mappings":"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"}

package/dist/messaging.service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=messaging.service.test.d.ts.map

package/dist/messaging.service.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.service.test.d.ts","sourceRoot":"","sources":["../src/messaging.service.test.ts"],"names":[],"mappings":""}

package/dist/messaging.service.test.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * MessagingService tests
+ */
+const messaging_service_1 = require("./messaging.service");
+const memory_conversation_context_1 = require("./store/memory-conversation-context");
+const createMockMessage = (overrides = {}) => ({
+    id: 'msg-1',
+    channel: 'telegram',
+    conversationId: 'conv-123',
+    userId: 'user-456',
+    text: 'Hello',
+    timestamp: new Date(),
+    ...overrides,
+});
+describe('MessagingService', () => {
+    describe('customHandler', () => {
+        it('calls customHandler and returns response', async () => {
+            const customHandler = jest.fn().mockResolvedValue('Custom reply');
+            const service = new messaging_service_1.MessagingService({
+                customHandler,
+            });
+            const msg = createMockMessage({ text: 'Hi' });
+            const reply = await service.handleMessage(msg);
+            expect(customHandler).toHaveBeenCalledWith(msg);
+            expect(reply).toBe('Custom reply');
+        });
+        it('appends user and assistant turns to store', async () => {
+            const store = new memory_conversation_context_1.MemoryConversationContextStore();
+            const customHandler = jest.fn().mockResolvedValue('Echo');
+            const service = new messaging_service_1.MessagingService({ customHandler }, store);
+            await service.handleMessage(createMockMessage({ text: 'Hello' }));
+            const turns = await store.getTurns('default:telegram:user-456');
+            expect(turns).toHaveLength(2);
+            expect(turns[0]).toEqual({ role: 'user', content: 'Hello' });
+            expect(turns[1]).toEqual({ role: 'assistant', content: 'Echo' });
+        });
+        it('uses sessionId from message when provided', async () => {
+            const store = new memory_conversation_context_1.MemoryConversationContextStore();
+            const customHandler = jest.fn().mockResolvedValue('OK');
+            const service = new messaging_service_1.MessagingService({ customHandler }, store);
+            await service.handleMessage(createMockMessage({ sessionId: 'custom-session', text: 'Hi' }));
+            const turns = await store.getTurns('custom-session');
+            expect(turns).toHaveLength(2);
+        });
+        it('does not append assistant turn when reply is empty', async () => {
+            const store = new memory_conversation_context_1.MemoryConversationContextStore();
+            const customHandler = jest.fn().mockResolvedValue('');
+            const service = new messaging_service_1.MessagingService({ customHandler }, store);
+            const reply = await service.handleMessage(createMockMessage({ text: 'Hi' }));
+            expect(reply).toBe('');
+            const turns = await store.getTurns('default:telegram:user-456');
+            expect(turns).toHaveLength(1);
+            expect(turns[0].role).toBe('user');
+        });
+    });
+    describe('agentHandler', () => {
+        it('calls agentHandler and returns string result', async () => {
+            const agentHandler = jest.fn().mockResolvedValue('Agent says hi');
+            const store = new memory_conversation_context_1.MemoryConversationContextStore();
+            const service = new messaging_service_1.MessagingService({ agentHandler }, store);
+            const msg = createMockMessage({ text: 'Help' });
+            const reply = await service.handleMessage(msg);
+            expect(agentHandler).toHaveBeenCalledWith(expect.objectContaining({ message: msg, sessionId: expect.any(String) }));
+            expect(reply).toBe('Agent says hi');
+        });
+        it('handles AgentHandlerResult with response property', async () => {
+            const agentHandler = jest.fn().mockResolvedValue({
+                response: 'Here is the answer',
+                sources: [{ content: 'doc1', score: 0.9 }],
+            });
+            const service = new messaging_service_1.MessagingService({ agentHandler });
+            const reply = await service.handleMessage(createMockMessage({ text: 'Query' }));
+            expect(reply).toBe('Here is the answer');
+        });
+        it('appends turns to store for agentHandler', async () => {
+            const store = new memory_conversation_context_1.MemoryConversationContextStore();
+            const agentHandler = jest.fn().mockResolvedValue('Done');
+            const service = new messaging_service_1.MessagingService({ agentHandler }, store);
+            await service.handleMessage(createMockMessage({ text: 'Go' }));
+            const turns = await store.getTurns('default:telegram:user-456');
+            expect(turns).toHaveLength(2);
+        });
+    });
+    describe('aiProvider (LLM)', () => {
+        it('throws when no aiProvider, agentHandler, or customHandler', async () => {
+            const service = new messaging_service_1.MessagingService({});
+            await expect(service.handleMessage(createMockMessage())).rejects.toThrow('MessagingService requires aiProvider, agentHandler, or customHandler');
+        });
+        it('calls aiProvider.complete and returns response', async () => {
+            const mockComplete = jest.fn().mockResolvedValue({ content: '  LLM reply  ' });
+            const aiProvider = { complete: mockComplete };
+            const service = new messaging_service_1.MessagingService({ aiProvider });
+            const reply = await service.handleMessage(createMockMessage({ text: 'Hello' }));
+            expect(mockComplete).toHaveBeenCalledWith(expect.objectContaining({
+                model: 'gpt-4o-mini',
+                messages: expect.arrayContaining([
+                    expect.objectContaining({ role: 'system' }),
+                    expect.objectContaining({ role: 'user', content: 'Hello' }),
+                ]),
+            }));
+            expect(reply).toBe('LLM reply');
+        });
+        it('uses fallback when response content is null/undefined', async () => {
+            const aiProvider = {
+                complete: jest.fn().mockResolvedValue({ content: null }),
+            };
+            const service = new messaging_service_1.MessagingService({ aiProvider });
+            const reply = await service.handleMessage(createMockMessage());
+            expect(reply).toBe('I could not generate a response.');
+        });
+        it('uses RAG when ragService provided', async () => {
+            const mockComplete = jest.fn().mockResolvedValue({ content: 'RAG answer' });
+            const aiProvider = { complete: mockComplete };
+            const ragService = {
+                search: jest.fn().mockResolvedValue([
+                    { content: 'Doc 1 content', score: 0.9 },
+                    { content: 'Doc 2 content', score: 0.8 },
+                ]),
+            };
+            const service = new messaging_service_1.MessagingService({ aiProvider, ragService });
+            await service.handleMessage(createMockMessage({ text: 'What is X?' }));
+            expect(ragService.search).toHaveBeenCalledWith('What is X?', expect.objectContaining({ topK: 5, minScore: 0.5 }));
+            const systemContent = mockComplete.mock.calls[0][0].messages[0].content;
+            expect(systemContent).toContain('Doc 1 content');
+            expect(systemContent).toContain('Doc 2 content');
+        });
+        it('does not augment prompt when RAG returns no results', async () => {
+            const mockComplete = jest.fn().mockResolvedValue({ content: 'Answer' });
+            const aiProvider = { complete: mockComplete };
+            const ragService = { search: jest.fn().mockResolvedValue([]) };
+            const service = new messaging_service_1.MessagingService({ aiProvider, ragService });
+            await service.handleMessage(createMockMessage({ text: 'Query' }));
+            const systemContent = mockComplete.mock.calls[0][0].messages[0].content;
+            expect(systemContent).not.toContain('Context:');
+        });
+    });
+    describe('clearSession', () => {
+        it('clears conversation history', async () => {
+            const store = new memory_conversation_context_1.MemoryConversationContextStore();
+            const customHandler = jest.fn().mockResolvedValue('Hi');
+            const service = new messaging_service_1.MessagingService({ customHandler }, store);
+            await service.handleMessage(createMockMessage({ text: 'Hello' }));
+            await service.clearSession('default:telegram:user-456');
+            const turns = await store.getTurns('default:telegram:user-456');
+            expect(turns).toEqual([]);
+        });
+    });
+    describe('getOptions', () => {
+        it('returns copy of options', () => {
+            const service = new messaging_service_1.MessagingService({
+                customHandler: () => 'x',
+                model: 'gpt-4',
+            });
+            const opts = service.getOptions();
+            expect(opts.model).toBe('gpt-4');
+            expect(opts.customHandler).toBeDefined();
+            expect(opts).not.toBe(service.getOptions());
+        });
+    });
+});
+//# sourceMappingURL=messaging.service.test.js.map

package/dist/messaging.service.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.service.test.js","sourceRoot":"","sources":["../src/messaging.service.test.ts"],"names":[],"mappings":"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"}

package/dist/store/conversation-context.interface.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Conversation context store - abstract storage for multi-turn history
+ * Implementations: memory (dev), Redis (production, horizontally scalable)
+ */
+export interface ConversationTurn {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export interface IConversationContextStore {
+    /** Get conversation turns for a session */
+    getTurns(sessionId: string): Promise<ConversationTurn[]>;
+    /** Append turn and optionally trim to max count */
+    appendTurn(sessionId: string, turn: ConversationTurn, maxTurns?: number): Promise<void>;
+    /** Clear session history */
+    clearSession(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=conversation-context.interface.d.ts.map

package/dist/store/conversation-context.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-context.interface.d.ts","sourceRoot":"","sources":["../../src/store/conversation-context.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEzD,mDAAmD;IACnD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExF,4BAA4B;IAC5B,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD"}

package/dist/store/conversation-context.interface.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Conversation context store - abstract storage for multi-turn history
+ * Implementations: memory (dev), Redis (production, horizontally scalable)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=conversation-context.interface.js.map

package/dist/store/conversation-context.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-context.interface.js","sourceRoot":"","sources":["../../src/store/conversation-context.interface.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/store/memory-conversation-context.d.ts

@@ -0,0 +1,11 @@
+/**
+ * In-memory conversation context - for dev/single-instance only
+ */
+import type { IConversationContextStore, ConversationTurn } from './conversation-context.interface';
+export declare class MemoryConversationContextStore implements IConversationContextStore {
+    private history;
+    getTurns(sessionId: string): Promise<ConversationTurn[]>;
+    appendTurn(sessionId: string, turn: ConversationTurn, maxTurns?: number): Promise<void>;
+    clearSession(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=memory-conversation-context.d.ts.map

package/dist/store/memory-conversation-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-conversation-context.d.ts","sourceRoot":"","sources":["../../src/store/memory-conversation-context.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpG,qBAAa,8BAA+B,YAAW,yBAAyB;IAC9E,OAAO,CAAC,OAAO,CAAyC;IAElD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIxD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvF,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrD"}

package/dist/store/memory-conversation-context.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryConversationContextStore = void 0;
+class MemoryConversationContextStore {
+    constructor() {
+        this.history = new Map();
+    }
+    async getTurns(sessionId) {
+        return this.history.get(sessionId) ?? [];
+    }
+    async appendTurn(sessionId, turn, maxTurns) {
+        const turns = this.history.get(sessionId) ?? [];
+        turns.push(turn);
+        const trimmed = maxTurns && turns.length > maxTurns * 2 ? turns.slice(-(maxTurns * 2)) : turns;
+        this.history.set(sessionId, trimmed);
+    }
+    async clearSession(sessionId) {
+        this.history.delete(sessionId);
+    }
+}
+exports.MemoryConversationContextStore = MemoryConversationContextStore;
+//# sourceMappingURL=memory-conversation-context.js.map

package/dist/store/memory-conversation-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-conversation-context.js","sourceRoot":"","sources":["../../src/store/memory-conversation-context.ts"],"names":[],"mappings":";;;AAKA,MAAa,8BAA8B;IAA3C;QACU,YAAO,GAAG,IAAI,GAAG,EAA8B,CAAC;IAgB1D,CAAC;IAdC,KAAK,CAAC,QAAQ,CAAC,SAAiB;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,IAAsB,EAAE,QAAiB;QAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,MAAM,OAAO,GAAG,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC/F,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAiB;QAClC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;CACF;AAjBD,wEAiBC"}

package/dist/store/memory-conversation-context.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory-conversation-context.test.d.ts.map

package/dist/store/memory-conversation-context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-conversation-context.test.d.ts","sourceRoot":"","sources":["../../src/store/memory-conversation-context.test.ts"],"names":[],"mappings":""}

package/dist/store/memory-conversation-context.test.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * MemoryConversationContextStore tests
+ */
+const memory_conversation_context_1 = require("./memory-conversation-context");
+describe('MemoryConversationContextStore', () => {
+    let store;
+    beforeEach(() => {
+        store = new memory_conversation_context_1.MemoryConversationContextStore();
+    });
+    describe('getTurns', () => {
+        it('returns empty array for unknown session', async () => {
+            const turns = await store.getTurns('unknown-session');
+            expect(turns).toEqual([]);
+        });
+        it('returns stored turns for known session', async () => {
+            await store.appendTurn('s1', { role: 'user', content: 'Hello' });
+            const turns = await store.getTurns('s1');
+            expect(turns).toEqual([{ role: 'user', content: 'Hello' }]);
+        });
+    });
+    describe('appendTurn', () => {
+        it('appends user and assistant turns', async () => {
+            await store.appendTurn('s1', { role: 'user', content: 'Hi' });
+            await store.appendTurn('s1', { role: 'assistant', content: 'Hello!' });
+            const turns = await store.getTurns('s1');
+            expect(turns).toHaveLength(2);
+            expect(turns[0]).toEqual({ role: 'user', content: 'Hi' });
+            expect(turns[1]).toEqual({ role: 'assistant', content: 'Hello!' });
+        });
+        it('trims to maxTurns*2 when exceeded', async () => {
+            for (let i = 0; i < 15; i++) {
+                await store.appendTurn('s1', {
+                    role: i % 2 === 0 ? 'user' : 'assistant',
+                    content: `msg${i}`,
+                });
+            }
+            const turns = await store.getTurns('s1');
+            expect(turns.length).toBeLessThanOrEqual(20);
+            expect(turns[turns.length - 1].content).toBe('msg14');
+        });
+        it('does not trim when under maxTurns*2', async () => {
+            for (let i = 0; i < 5; i++) {
+                await store.appendTurn('s1', {
+                    role: i % 2 === 0 ? 'user' : 'assistant',
+                    content: `msg${i}`,
+                });
+            }
+            const turns = await store.getTurns('s1');
+            expect(turns).toHaveLength(5);
+        });
+    });
+    describe('clearSession', () => {
+        it('removes session data', async () => {
+            await store.appendTurn('s1', { role: 'user', content: 'Hi' });
+            await store.clearSession('s1');
+            const turns = await store.getTurns('s1');
+            expect(turns).toEqual([]);
+        });
+        it('does not affect other sessions', async () => {
+            await store.appendTurn('s1', { role: 'user', content: 'Hi' });
+            await store.appendTurn('s2', { role: 'user', content: 'Bye' });
+            await store.clearSession('s1');
+            expect(await store.getTurns('s2')).toEqual([{ role: 'user', content: 'Bye' }]);
+        });
+    });
+});
+//# sourceMappingURL=memory-conversation-context.test.js.map

package/dist/store/memory-conversation-context.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-conversation-context.test.js","sourceRoot":"","sources":["../../src/store/memory-conversation-context.test.ts"],"names":[],"mappings":"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"}

package/dist/store/redis-conversation-context.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Redis-backed conversation context - horizontally scalable
+ */
+import type { IConversationContextStore, ConversationTurn } from './conversation-context.interface';
+export interface RedisConversationContextConfig {
+    /** Redis client (ioredis) */
+    client: {
+        get: (k: string) => Promise<string | null>;
+        setex: (k: string, t: number, v: string) => Promise<string>;
+        del: (k: string) => Promise<number>;
+    };
+    /** TTL for context keys in seconds (default: 24h) */
+    ttlSeconds?: number;
+}
+export declare class RedisConversationContextStore implements IConversationContextStore {
+    private client;
+    private ttl;
+    constructor(config: RedisConversationContextConfig);
+    private key;
+    getTurns(sessionId: string): Promise<ConversationTurn[]>;
+    appendTurn(sessionId: string, turn: ConversationTurn, maxTurns?: number): Promise<void>;
+    clearSession(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=redis-conversation-context.d.ts.map

package/dist/store/redis-conversation-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-conversation-context.d.ts","sourceRoot":"","sources":["../../src/store/redis-conversation-context.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAKpG,MAAM,WAAW,8BAA8B;IAC7C,6BAA6B;IAC7B,MAAM,EAAE;QACN,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QAC3C,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5D,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;KACrC,CAAC;IACF,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,6BAA8B,YAAW,yBAAyB;IAC7E,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,GAAG,CAAS;gBAER,MAAM,EAAE,8BAA8B;IAKlD,OAAO,CAAC,GAAG;IAIL,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAUxD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvF,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrD"}

package/dist/store/redis-conversation-context.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisConversationContextStore = void 0;
+const KEY_PREFIX = 'messaging:context:';
+const DEFAULT_TTL_SEC = 86400; // 24h
+class RedisConversationContextStore {
+    constructor(config) {
+        this.client = config.client;
+        this.ttl = config.ttlSeconds ?? DEFAULT_TTL_SEC;
+    }
+    key(sessionId) {
+        return `${KEY_PREFIX}${sessionId}`;
+    }
+    async getTurns(sessionId) {
+        const raw = await this.client.get(this.key(sessionId));
+        if (!raw)
+            return [];
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return [];
+        }
+    }
+    async appendTurn(sessionId, turn, maxTurns) {
+        const turns = await this.getTurns(sessionId);
+        turns.push(turn);
+        const trimmed = maxTurns && turns.length > maxTurns * 2 ? turns.slice(-(maxTurns * 2)) : turns;
+        const k = this.key(sessionId);
+        await this.client.setex(k, this.ttl, JSON.stringify(trimmed));
+    }
+    async clearSession(sessionId) {
+        await this.client.del(this.key(sessionId));
+    }
+}
+exports.RedisConversationContextStore = RedisConversationContextStore;
+//# sourceMappingURL=redis-conversation-context.js.map

package/dist/store/redis-conversation-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-conversation-context.js","sourceRoot":"","sources":["../../src/store/redis-conversation-context.ts"],"names":[],"mappings":";;;AAKA,MAAM,UAAU,GAAG,oBAAoB,CAAC;AACxC,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,MAAM;AAarC,MAAa,6BAA6B;IAIxC,YAAY,MAAsC;QAChD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,eAAe,CAAC;IAClD,CAAC;IAEO,GAAG,CAAC,SAAiB;QAC3B,OAAO,GAAG,UAAU,GAAG,SAAS,EAAE,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAiB;QAC9B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,IAAsB,EAAE,QAAiB;QAC3E,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,MAAM,OAAO,GAAG,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC/F,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9B,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAiB;QAClC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7C,CAAC;CACF;AAlCD,sEAkCC"}

package/dist/store/redis-conversation-context.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=redis-conversation-context.test.d.ts.map

package/dist/store/redis-conversation-context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-conversation-context.test.d.ts","sourceRoot":"","sources":["../../src/store/redis-conversation-context.test.ts"],"names":[],"mappings":""}