musonda 1.0.0

package/dist/gateway/server.d.ts

@@ -0,0 +1,38 @@
+import { MusondaConfig } from '../config/types.js';
+import { AgentHarness } from '../agent/harness.js';
+import { DiscordChannelAdapter } from './channels/discord.js';
+import { SlackChannelAdapter } from './channels/slack.js';
+import { WebhookChannelAdapter } from './channels/webhook.js';
+import { CliChannelAdapter, CliChannelOptions } from './channels/cli.js';
+import { MusondaScheduler } from '../scheduler/scheduler.js';
+import { PluginManager } from '../plugins/pluginManager.js';
+export declare class MusondaGateway {
+    private config;
+    private memory;
+    private tools;
+    private client;
+    private harness;
+    private scheduler;
+    private pluginManager;
+    private discordAdapter;
+    private slackAdapter;
+    private webhookAdapter;
+    private cliAdapter;
+    private httpServer;
+    private sessionQueues;
+    constructor(config: MusondaConfig, cliOptions?: CliChannelOptions);
+    private setupChannels;
+    private setupScheduler;
+    private handleScheduleTrigger;
+    private handleInboundMessage;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getHarness(): AgentHarness;
+    getScheduler(): MusondaScheduler;
+    getDiscordAdapter(): DiscordChannelAdapter;
+    getSlackAdapter(): SlackChannelAdapter;
+    getWebhookAdapter(): WebhookChannelAdapter;
+    getCliAdapter(): CliChannelAdapter;
+    getPluginManager(): PluginManager;
+    getActiveSessionQueueCount(): number;
+}

package/dist/gateway/server.js

@@ -0,0 +1,233 @@
+import { MemoryManager } from '../memory/memoryManager.js';
+import { ToolRegistry } from '../tools/registry.js';
+import { OpenAIResponsesClient } from '../agent/openaiResponsesClient.js';
+import { AgentHarness } from '../agent/harness.js';
+import { DiscordChannelAdapter } from './channels/discord.js';
+import { SlackChannelAdapter } from './channels/slack.js';
+import { WebhookChannelAdapter } from './channels/webhook.js';
+import { CliChannelAdapter } from './channels/cli.js';
+import { HttpGatewayServer } from './http.js';
+import { MusondaScheduler } from '../scheduler/scheduler.js';
+import { PluginManager } from '../plugins/pluginManager.js';
+import { logger } from '../utils/logger.js';
+export class MusondaGateway {
+    config;
+    memory;
+    tools;
+    client;
+    harness;
+    scheduler;
+    pluginManager;
+    discordAdapter;
+    slackAdapter;
+    webhookAdapter;
+    cliAdapter;
+    httpServer = null;
+    // Session message queue to serialize processing per session
+    sessionQueues = new Map();
+    constructor(config, cliOptions) {
+        this.config = config;
+        this.memory = new MemoryManager(config);
+        this.tools = new ToolRegistry();
+        this.client = new OpenAIResponsesClient(config.model);
+        this.scheduler = new MusondaScheduler(config.memory.storageDir, config.user.timezone);
+        this.pluginManager = new PluginManager(config);
+        this.harness = new AgentHarness(config, this.memory, this.tools, this.client, this.scheduler, this.pluginManager);
+        this.discordAdapter = new DiscordChannelAdapter(config);
+        this.slackAdapter = new SlackChannelAdapter(config);
+        this.webhookAdapter = new WebhookChannelAdapter();
+        this.cliAdapter = new CliChannelAdapter(config, cliOptions);
+        if (config.gateway.enableHttp) {
+            this.httpServer = new HttpGatewayServer(config, this.harness, this.webhookAdapter, this.discordAdapter, this.slackAdapter, this.scheduler, this.cliAdapter);
+        }
+        this.setupChannels();
+        this.setupScheduler();
+    }
+    setupChannels() {
+        const inboundHandler = async (inbound) => {
+            await this.handleInboundMessage(inbound);
+        };
+        this.discordAdapter.onMessage(inboundHandler);
+        this.slackAdapter.onMessage(inboundHandler);
+        this.webhookAdapter.onMessage(inboundHandler);
+        this.cliAdapter.onMessage(inboundHandler);
+    }
+    setupScheduler() {
+        this.scheduler.onTrigger(async (job) => {
+            await this.handleScheduleTrigger(job);
+        });
+    }
+    async handleScheduleTrigger(job) {
+        const assistantName = this.config.assistant.customName || this.config.assistant.name || 'Musonda';
+        logger.info(`Processing scheduled task "${job.title}" for channel [${job.target.channel}]`);
+        let dispatchText = '';
+        if (job.action.type === 'prompt') {
+            try {
+                const sessionId = `schedule:${job.id}:${job.target.channel}`;
+                const promptInstruction = `[SCHEDULED TASK TRIGGERED: "${job.title}"]\n${job.action.content}`;
+                const result = await this.harness.processMessage({
+                    sessionId,
+                    channel: job.target.channel,
+                    channelId: job.target.channelId,
+                    userId: job.target.userId,
+                    userName: job.target.userName,
+                    threadTs: job.target.threadTs,
+                    messageText: promptInstruction,
+                    scheduler: this.scheduler,
+                });
+                dispatchText = result.replyText;
+            }
+            catch (err) {
+                logger.error(`Failed to execute scheduled prompt for job "${job.title}":`, err);
+                dispatchText = `⚠️ [${assistantName} Schedule] Failed to run task "${job.title}": ${err.message}`;
+            }
+        }
+        else {
+            // Fixed reminder
+            dispatchText = `⏰ **Reminder**: ${job.action.content}`;
+        }
+        // Dispatch to destination channel
+        if (job.target.channel === 'discord') {
+            const sent = await this.discordAdapter.sendDirect(job.target.channelId, dispatchText, job.target.userId);
+            if (!sent) {
+                logger.warn(`Could not deliver Discord scheduled notification for "${job.title}"`);
+            }
+        }
+        else if (job.target.channel === 'slack') {
+            const sent = await this.slackAdapter.sendDirect(job.target.channelId, dispatchText, job.target.threadTs);
+            if (!sent) {
+                logger.warn(`Could not deliver Slack scheduled notification for "${job.title}"`);
+            }
+        }
+        else if (job.target.channel === 'cli') {
+            const sent = await this.cliAdapter.sendDirect(dispatchText);
+            if (!sent) {
+                logger.warn(`Could not deliver CLI scheduled notification for "${job.title}"`);
+            }
+        }
+        else {
+            logger.info(`[WEBHOOK SCHEDULE NOTIFICATION]: "${job.title}" -> ${dispatchText}`);
+        }
+    }
+    async handleInboundMessage(inbound) {
+        const sessionId = `${inbound.channel}:${inbound.channelId}:${inbound.userId}`;
+        // Queue processing for this session
+        const currentQueue = this.sessionQueues.get(sessionId) || Promise.resolve();
+        const nextQueue = currentQueue
+            .then(async () => {
+            try {
+                const result = await this.harness.processMessage({
+                    sessionId,
+                    channel: inbound.channel,
+                    channelId: inbound.channelId,
+                    userId: inbound.userId,
+                    userName: inbound.userName,
+                    threadTs: inbound.threadTs,
+                    messageText: inbound.text,
+                    scheduler: this.scheduler,
+                    onStreamDelta: inbound.onStreamDelta,
+                    onEvent: inbound.onEvent,
+                });
+                await inbound.reply(result.replyText);
+            }
+            catch (err) {
+                logger.error(`Error processing message in session ${sessionId}:`, err);
+                await inbound.reply(`⚠️ ${err.message || 'An error occurred in Musonda Gateway.'}`);
+            }
+        })
+            .catch((err) => {
+            logger.error(`Fatal queue error for session ${sessionId}:`, err);
+        });
+        this.sessionQueues.set(sessionId, nextQueue);
+        try {
+            await nextQueue;
+        }
+        finally {
+            // Only remove the queue if no later request replaced it while this one ran.
+            if (this.sessionQueues.get(sessionId) === nextQueue) {
+                this.sessionQueues.delete(sessionId);
+            }
+        }
+    }
+    async start() {
+        const assistantName = this.config.assistant.customName || this.config.assistant.name || 'Musonda';
+        logger.info(`Starting Musonda Gateway for "${assistantName}"...`);
+        logger.info(`AI Model: ${this.config.model.model} (OpenAI Responses API)`);
+        if (process.env.NODE_ENV === 'production' && !this.config.gateway.apiKey?.trim()) {
+            logger.warn('⚠️  SECURITY WARNING: Running in production mode without GATEWAY_API_KEY configured. Protected API endpoints will reject incoming requests.');
+        }
+        // Load Agent Plugins (Skills and MCP servers)
+        await this.pluginManager.loadAll(this.tools);
+        // Start Scheduler
+        await this.scheduler.start();
+        // Start Webhook/API adapter
+        await this.webhookAdapter.start();
+        // Start HTTP Server
+        if (this.httpServer) {
+            await this.httpServer.start();
+        }
+        // Start Discord Channel
+        if (this.config.channels.discord.enabled) {
+            await this.discordAdapter.start();
+        }
+        else {
+            logger.info('Discord channel is disabled. Enable in config or via onboarding.');
+        }
+        // Start Slack Channel
+        if (this.config.channels.slack.enabled) {
+            await this.slackAdapter.start();
+        }
+        else {
+            logger.info('Slack channel is disabled. Enable in config or via onboarding.');
+        }
+        // Start CLI Channel
+        if (this.config.channels.cli?.enabled) {
+            await this.cliAdapter.start();
+        }
+        logger.info(`🚀 Musonda Gateway is running. Readiness is available at /ready.`);
+    }
+    async stop() {
+        logger.info('Shutting down Musonda Gateway...');
+        await this.pluginManager.shutdownAll();
+        await this.scheduler.stop();
+        if (this.discordAdapter.isConnected()) {
+            await this.discordAdapter.stop();
+        }
+        if (this.slackAdapter.isConnected()) {
+            await this.slackAdapter.stop();
+        }
+        if (this.cliAdapter.isConnected()) {
+            await this.cliAdapter.stop();
+        }
+        if (this.httpServer) {
+            await this.httpServer.stop();
+        }
+        await this.webhookAdapter.stop();
+        logger.info('Musonda Gateway stopped.');
+    }
+    getHarness() {
+        return this.harness;
+    }
+    getScheduler() {
+        return this.scheduler;
+    }
+    getDiscordAdapter() {
+        return this.discordAdapter;
+    }
+    getSlackAdapter() {
+        return this.slackAdapter;
+    }
+    getWebhookAdapter() {
+        return this.webhookAdapter;
+    }
+    getCliAdapter() {
+        return this.cliAdapter;
+    }
+    getPluginManager() {
+        return this.pluginManager;
+    }
+    getActiveSessionQueueCount() {
+        return this.sessionQueues.size;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/gateway/server.js.map

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

package/dist/gateway/types.d.ts

@@ -0,0 +1,28 @@
+import { AgentEvent } from '../agent/types.js';
+export interface InboundMessage {
+    id: string;
+    channel: string;
+    channelType: 'dm' | 'guild' | 'webhook' | 'http' | 'cli';
+    channelId: string;
+    userId: string;
+    userName: string;
+    userHandle?: string;
+    threadTs?: string;
+    text: string;
+    raw?: any;
+    reply: (text: string, options?: any) => Promise<void>;
+    sendTyping?: () => Promise<void>;
+    onStreamDelta?: (delta: string) => void | Promise<void>;
+    onEvent?: (event: AgentEvent) => void | Promise<void>;
+}
+export interface OutboundMessage {
+    text: string;
+    replyToId?: string;
+}
+export interface ChannelAdapter {
+    readonly name: string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isConnected(): boolean;
+    onMessage(handler: (message: InboundMessage) => Promise<void>): void;
+}

package/dist/gateway/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/gateway/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/gateway/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+export { MusondaGateway } from './gateway/server.js';
+export { AgentHarness } from './agent/harness.js';
+export * from './agent/types.js';
+export { configLoader } from './config/loader.js';
+export * from './config/types.js';
+export { PluginManager } from './plugins/pluginManager.js';
+export { ManifestValidator } from './plugins/manifest.js';
+export { SkillDiscovery } from './plugins/skills/skillDiscovery.js';
+export { SkillFrontmatterParser } from './plugins/skills/frontmatterParser.js';
+export { McpConfigValidator } from './plugins/mcp/mcpConfig.js';
+export { McpBridge } from './plugins/mcp/mcpBridge.js';
+export * from './plugins/types.js';
+export * from './plugins/skills/types.js';
+export * from './plugins/mcp/types.js';
+import { runMusondaCli, dispatchCliArgs } from './cli/musondaCli.js';
+export { runMusondaCli, dispatchCliArgs };

package/dist/index.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+export { MusondaGateway } from './gateway/server.js';
+export { AgentHarness } from './agent/harness.js';
+export * from './agent/types.js';
+export { configLoader } from './config/loader.js';
+export * from './config/types.js';
+export { PluginManager } from './plugins/pluginManager.js';
+export { ManifestValidator } from './plugins/manifest.js';
+export { SkillDiscovery } from './plugins/skills/skillDiscovery.js';
+export { SkillFrontmatterParser } from './plugins/skills/frontmatterParser.js';
+export { McpConfigValidator } from './plugins/mcp/mcpConfig.js';
+export { McpBridge } from './plugins/mcp/mcpBridge.js';
+export * from './plugins/types.js';
+export * from './plugins/skills/types.js';
+export * from './plugins/mcp/types.js';
+import { runMusondaCli, dispatchCliArgs } from './cli/musondaCli.js';
+export { runMusondaCli, dispatchCliArgs };
+// If executed directly as CLI binary or entrypoint script
+const arg1 = (process.argv[1] || '').replace(/\\/g, '/').toLowerCase();
+const isDirect = arg1.endsWith('/musonda') ||
+    arg1.endsWith('/musonda.js') ||
+    arg1.endsWith('/musonda.cmd') ||
+    arg1.endsWith('/musonda.ps1') ||
+    arg1.endsWith('/index.js') ||
+    arg1.endsWith('/index.ts');
+if (isDirect) {
+    runMusondaCli(process.argv.slice(2)).catch((err) => {
+        console.error(`\x1b[31mFatal error: ${err.message || err}\x1b[0m`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC;AAE1C,0DAA0D;AAC1D,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AACvE,MAAM,QAAQ,GACZ,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;IACzB,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC5B,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC7B,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC7B,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;IAC1B,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAE7B,IAAI,QAAQ,EAAE,CAAC;IACb,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAQ,EAAE,EAAE;QACtD,OAAO,CAAC,KAAK,CAAC,wBAAwB,GAAG,CAAC,OAAO,IAAI,GAAG,SAAS,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/memory/memoryManager.d.ts

@@ -0,0 +1,22 @@
+import { MemoryCategory, MemoryItem, UserMemoryProfile, SessionMessage, SessionRecord } from './types.js';
+import { MusondaConfig } from '../config/types.js';
+export declare class MemoryManager {
+    private memoryStorage;
+    private profileStorage;
+    private sessionsDir;
+    private maxShortTermHistory;
+    private autoRecallTopK;
+    constructor(config: MusondaConfig);
+    private initProfileIfNeeded;
+    getProfile(): UserMemoryProfile;
+    updateProfile(updates: Partial<UserMemoryProfile>): UserMemoryProfile;
+    addMemory(content: string, category?: MemoryCategory, tags?: string[]): MemoryItem;
+    getAllMemories(): MemoryItem[];
+    deleteMemory(id: string): boolean;
+    searchMemories(query: string, limit?: number): MemoryItem[];
+    private getSessionStorage;
+    getSession(sessionId: string, channel?: string, userId?: string, userName?: string): SessionRecord;
+    appendSessionMessage(sessionId: string, message: Omit<SessionMessage, 'id' | 'timestamp'>, channel?: string, userId?: string, userName?: string): SessionMessage;
+    getRecentSessionMessages(sessionId: string, limit?: number): SessionMessage[];
+    clearSession(sessionId: string): void;
+}

package/dist/memory/memoryManager.js

@@ -0,0 +1,200 @@
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { JsonStorage } from './storage.js';
+import { logger } from '../utils/logger.js';
+export class MemoryManager {
+    memoryStorage;
+    profileStorage;
+    sessionsDir;
+    maxShortTermHistory;
+    autoRecallTopK;
+    constructor(config) {
+        const memoryDir = config.memory.storageDir;
+        this.sessionsDir = config.memory.sessionsDir;
+        this.maxShortTermHistory = config.memory.maxShortTermHistory;
+        this.autoRecallTopK = config.memory.autoRecallTopK;
+        this.memoryStorage = new JsonStorage(path.join(memoryDir, 'long_term.json'));
+        this.profileStorage = new JsonStorage(path.join(memoryDir, 'profile.json'));
+        this.initProfileIfNeeded(config);
+    }
+    initProfileIfNeeded(config) {
+        if (!this.profileStorage.exists()) {
+            const initialProfile = {
+                name: config.user.name || 'Friend',
+                assistantCustomName: config.assistant.customName || config.assistant.name || 'Musonda',
+                bio: config.user.bio || '',
+                interests: config.user.interests || [],
+                timezone: config.user.timezone || Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC',
+                communicationStyle: config.user.communicationStyle || 'friendly',
+                notes: config.user.notes || '',
+                customInstructions: config.assistant.systemInstructions || '',
+                updatedAt: new Date().toISOString(),
+            };
+            this.profileStorage.write(initialProfile);
+            logger.memory('Initialized persistent user profile for ' + initialProfile.name);
+        }
+    }
+    getProfile() {
+        return this.profileStorage.read({
+            name: 'Friend',
+            assistantCustomName: 'Musonda',
+            bio: '',
+            interests: [],
+            timezone: 'UTC',
+            communicationStyle: 'friendly',
+            notes: '',
+            customInstructions: '',
+            updatedAt: new Date().toISOString(),
+        });
+    }
+    updateProfile(updates) {
+        const current = this.getProfile();
+        const updated = {
+            ...current,
+            ...updates,
+            updatedAt: new Date().toISOString(),
+        };
+        this.profileStorage.write(updated);
+        logger.memory('Updated user profile details');
+        return updated;
+    }
+    addMemory(content, category = 'general', tags = []) {
+        const memories = this.memoryStorage.read([]);
+        const now = new Date().toISOString();
+        const newItem = {
+            id: crypto.randomUUID(),
+            category,
+            content: content.trim(),
+            tags: tags.map((t) => t.toLowerCase().trim()),
+            createdAt: now,
+            updatedAt: now,
+            accessCount: 0,
+        };
+        memories.push(newItem);
+        this.memoryStorage.write(memories);
+        logger.memory(`Saved new memory [${category}]: "${content.substring(0, 60)}..."`);
+        return newItem;
+    }
+    getAllMemories() {
+        return this.memoryStorage.read([]);
+    }
+    deleteMemory(id) {
+        const memories = this.memoryStorage.read([]);
+        const initialLen = memories.length;
+        const filtered = memories.filter((m) => m.id !== id);
+        if (filtered.length !== initialLen) {
+            this.memoryStorage.write(filtered);
+            logger.memory(`Deleted memory id: ${id}`);
+            return true;
+        }
+        return false;
+    }
+    searchMemories(query, limit = this.autoRecallTopK) {
+        const memories = this.memoryStorage.read([]);
+        if (!memories.length || !query.trim())
+            return [];
+        const queryTokens = query
+            .toLowerCase()
+            .split(/[\s,.;:!?]+/)
+            .filter((t) => t.length > 2);
+        if (!queryTokens.length) {
+            return memories.slice(-limit);
+        }
+        const scored = memories.map((item) => {
+            let score = 0;
+            const contentLower = item.content.toLowerCase();
+            const tagsLower = item.tags.join(' ').toLowerCase();
+            for (const token of queryTokens) {
+                if (contentLower.includes(token))
+                    score += 2;
+                if (tagsLower.includes(token))
+                    score += 3;
+            }
+            // Slightly favor user preferences and profile facts
+            if (item.category === 'preference')
+                score += 1.5;
+            if (item.category === 'fact')
+                score += 1.0;
+            return { item, score };
+        });
+        const results = scored
+            .filter((entry) => entry.score > 0)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit)
+            .map((entry) => {
+            entry.item.accessCount = (entry.item.accessCount || 0) + 1;
+            return entry.item;
+        });
+        if (results.length > 0) {
+            this.memoryStorage.write(memories);
+        }
+        return results;
+    }
+    getSessionStorage(sessionId) {
+        const safeId = sessionId.replace(/[^a-zA-Z0-9_-]/g, '_');
+        const filePath = path.join(this.sessionsDir, `${safeId}.json`);
+        return new JsonStorage(filePath);
+    }
+    getSession(sessionId, channel = 'default', userId = 'user', userName) {
+        const storage = this.getSessionStorage(sessionId);
+        const now = new Date().toISOString();
+        return storage.read({
+            sessionId,
+            channel,
+            userId,
+            userName,
+            createdAt: now,
+            updatedAt: now,
+            messages: [],
+        });
+    }
+    appendSessionMessage(sessionId, message, channel = 'default', userId = 'user', userName) {
+        const storage = this.getSessionStorage(sessionId);
+        const session = this.getSession(sessionId, channel, userId, userName);
+        const fullMessage = {
+            ...message,
+            id: crypto.randomUUID(),
+            timestamp: new Date().toISOString(),
+        };
+        session.messages.push(fullMessage);
+        session.updatedAt = new Date().toISOString();
+        if (session.messages.length > this.maxShortTermHistory) {
+            session.messages = session.messages.slice(-this.maxShortTermHistory);
+        }
+        storage.write(session);
+        return fullMessage;
+    }
+    getRecentSessionMessages(sessionId, limit) {
+        const storage = this.getSessionStorage(sessionId);
+        if (!storage.exists())
+            return [];
+        const session = storage.read({
+            sessionId,
+            channel: 'default',
+            userId: 'user',
+            createdAt: '',
+            updatedAt: '',
+            messages: [],
+        });
+        const take = limit || this.maxShortTermHistory;
+        return session.messages.slice(-take);
+    }
+    clearSession(sessionId) {
+        const storage = this.getSessionStorage(sessionId);
+        if (storage.exists()) {
+            const session = storage.read({
+                sessionId,
+                channel: 'default',
+                userId: 'user',
+                createdAt: '',
+                updatedAt: '',
+                messages: [],
+            });
+            session.messages = [];
+            session.updatedAt = new Date().toISOString();
+            storage.write(session);
+            logger.memory(`Cleared session ${sessionId}`);
+        }
+    }
+}
+//# sourceMappingURL=memoryManager.js.map

package/dist/memory/memoryManager.js.map

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

package/dist/memory/storage.d.ts

@@ -0,0 +1,24 @@
+export declare class JsonStorage<T> {
+    private filePath;
+    private maxBackups;
+    constructor(filePath: string);
+    private ensureDirectory;
+    private acquireLock;
+    private releaseLock;
+    exists(): boolean;
+    read(defaultValue: T): T;
+    write(data: T): void;
+    /**
+     * Creates an explicit snapshot backup of the current storage file in a .backups subdirectory.
+     * Automatically enforces rotation to retain the latest configured number of backups.
+     */
+    createBackup(tag?: string): string | null;
+    /**
+     * Lists all existing backups for this storage instance, newest first.
+     */
+    listBackups(): string[];
+    /**
+     * Restores data from the specified backup or the latest backup available.
+     */
+    restoreBackup(backupPath?: string): boolean;
+}