@jungjaehoon/mama-os 0.1.1

package/dist/gateways/message-splitter.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * Message splitter for messenger platforms
+ *
+ * Splits long messages into chunks that fit within platform limits
+ * while preserving readability (splitting at newlines or spaces).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MAX_LENGTH = void 0;
+exports.splitMessage = splitMessage;
+exports.splitForDiscord = splitForDiscord;
+exports.splitForSlack = splitForSlack;
+exports.estimateChunks = estimateChunks;
+exports.truncateWithEllipsis = truncateWithEllipsis;
+exports.splitWithCodeBlocks = splitWithCodeBlocks;
+/**
+ * Default maximum message length (Discord limit)
+ */
+exports.DEFAULT_MAX_LENGTH = 2000;
+/**
+ * Split a message into chunks that fit within the maximum length
+ *
+ * @param text - Text to split
+ * @param options - Split options
+ * @returns Array of text chunks
+ */
+function splitMessage(text, options = {}) {
+    const { maxLength = exports.DEFAULT_MAX_LENGTH, splitPoints = ['\n', ' '], chunkSuffix = '', continuationPrefix = '', } = options;
+    // Adjust max length for suffix/prefix
+    const effectiveMax = maxLength - chunkSuffix.length;
+    const firstChunkMax = effectiveMax;
+    const continuationMax = effectiveMax - continuationPrefix.length;
+    // If text fits, return as single chunk
+    if (text.length <= maxLength) {
+        return [text];
+    }
+    const chunks = [];
+    let remaining = text;
+    let isFirst = true;
+    while (remaining.length > 0) {
+        const currentMax = isFirst ? firstChunkMax : continuationMax;
+        if (remaining.length <= currentMax) {
+            // Last chunk
+            const prefix = isFirst ? '' : continuationPrefix;
+            chunks.push(prefix + remaining);
+            break;
+        }
+        // Find best split point
+        let splitIndex = findBestSplitPoint(remaining, currentMax, splitPoints);
+        // Add chunk
+        const prefix = isFirst ? '' : continuationPrefix;
+        const chunk = prefix + remaining.slice(0, splitIndex).trimEnd();
+        chunks.push(chunk + chunkSuffix);
+        // Move to next chunk
+        remaining = remaining.slice(splitIndex).trimStart();
+        isFirst = false;
+    }
+    return chunks;
+}
+/**
+ * Find the best point to split the text
+ *
+ * @param text - Text to split
+ * @param maxLength - Maximum length for this chunk
+ * @param splitPoints - Preferred split characters
+ * @returns Index to split at
+ */
+function findBestSplitPoint(text, maxLength, splitPoints) {
+    // Try each split point in order of preference
+    for (const splitChar of splitPoints) {
+        const lastIndex = text.lastIndexOf(splitChar, maxLength);
+        // Only use if it's not too close to the start (at least 50% of maxLength)
+        if (lastIndex >= maxLength / 2) {
+            return lastIndex + splitChar.length;
+        }
+    }
+    // No good split point found, just cut at maxLength
+    return maxLength;
+}
+/**
+ * Split message for Discord (2000 char limit)
+ */
+function splitForDiscord(text) {
+    return splitMessage(text, { maxLength: 2000 });
+}
+/**
+ * Split message for Slack (40000 char limit for regular messages)
+ * Note: Slack has different limits for different contexts
+ */
+function splitForSlack(text) {
+    return splitMessage(text, { maxLength: 40000 });
+}
+/**
+ * Estimate number of chunks a message will be split into
+ */
+function estimateChunks(text, maxLength = exports.DEFAULT_MAX_LENGTH) {
+    if (text.length <= maxLength)
+        return 1;
+    return Math.ceil(text.length / maxLength);
+}
+/**
+ * Truncate text with ellipsis if too long
+ */
+function truncateWithEllipsis(text, maxLength, ellipsis = '...') {
+    if (text.length <= maxLength)
+        return text;
+    return text.slice(0, maxLength - ellipsis.length) + ellipsis;
+}
+/**
+ * Split text into code blocks if it contains code
+ * Preserves code block formatting
+ */
+function splitWithCodeBlocks(text, maxLength = exports.DEFAULT_MAX_LENGTH) {
+    // If no code blocks or fits in one message, use simple split
+    if (!text.includes('```') || text.length <= maxLength) {
+        return splitMessage(text, { maxLength });
+    }
+    const chunks = [];
+    const codeBlockRegex = /```[\s\S]*?```/g;
+    let lastIndex = 0;
+    let match;
+    while ((match = codeBlockRegex.exec(text)) !== null) {
+        // Text before code block
+        const beforeCode = text.slice(lastIndex, match.index);
+        if (beforeCode.trim()) {
+            chunks.push(...splitMessage(beforeCode, { maxLength }));
+        }
+        // Code block itself
+        const codeBlock = match[0];
+        if (codeBlock.length <= maxLength) {
+            chunks.push(codeBlock);
+        }
+        else {
+            // Split long code blocks
+            chunks.push(...splitMessage(codeBlock, { maxLength, splitPoints: ['\n'] }));
+        }
+        lastIndex = match.index + match[0].length;
+    }
+    // Remaining text after last code block
+    const remaining = text.slice(lastIndex);
+    if (remaining.trim()) {
+        chunks.push(...splitMessage(remaining, { maxLength }));
+    }
+    return chunks;
+}
+//# sourceMappingURL=message-splitter.js.map

package/dist/gateways/message-splitter.js.map

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

package/dist/gateways/plugin-loader.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Gateway Plugin Loader
+ *
+ * Discovers and loads gateway plugins from ~/.mama/plugins/
+ * Each plugin is a directory with:
+ * - plugin.json (manifest)
+ * - index.ts or index.js (entry point)
+ */
+import type { PluginManifest, LoadedPlugin, Gateway, AgentLoopInterface, MessageSource } from './types.js';
+/**
+ * Plugin loader configuration
+ */
+export interface PluginLoaderConfig {
+    /** Plugin directory (default: ~/.mama/plugins) */
+    pluginsDir?: string;
+    /** Gateway configurations from main config */
+    gatewayConfigs?: Record<string, unknown>;
+    /** Agent loop instance */
+    agentLoop?: AgentLoopInterface;
+}
+/**
+ * Plugin Loader class
+ */
+export declare class PluginLoader {
+    private readonly pluginsDir;
+    private readonly gatewayConfigs;
+    private readonly agentLoop?;
+    private readonly plugins;
+    private readonly messageHandlers;
+    constructor(config?: PluginLoaderConfig);
+    /**
+     * Discover all plugins in the plugins directory
+     */
+    discover(): Promise<PluginManifest[]>;
+    /**
+     * Check if a plugin is enabled in config
+     */
+    private isPluginEnabled;
+    /**
+     * Load and register a plugin
+     */
+    loadPlugin(pluginId: string): Promise<Gateway | null>;
+    /**
+     * Load all discovered plugins
+     */
+    loadAll(): Promise<Gateway[]>;
+    /**
+     * Create the API object for a plugin
+     */
+    private createPluginApi;
+    /**
+     * Create a logger for a plugin
+     */
+    private createLogger;
+    /**
+     * Get all loaded gateways
+     */
+    getGateways(): Gateway[];
+    /**
+     * Get a specific gateway by source ID
+     */
+    getGateway(source: MessageSource): Gateway | undefined;
+    /**
+     * Get all discovered plugins
+     */
+    getPlugins(): LoadedPlugin[];
+    /**
+     * Stop all gateways
+     */
+    stopAll(): Promise<void>;
+}
+/**
+ * Create a plugin loader instance
+ */
+export declare function createPluginLoader(config?: PluginLoaderConfig): PluginLoader;
+//# sourceMappingURL=plugin-loader.d.ts.map

package/dist/gateways/plugin-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../src/gateways/plugin-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,cAAc,EAGd,YAAY,EACZ,OAAO,EAGP,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,0BAA0B;IAC1B,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0B;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4C;gBAEhE,MAAM,GAAE,kBAAuB;IAO3C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAiD3C;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAgD3D;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAanC;;OAEG;IACH,OAAO,CAAC,eAAe;IAgCvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,WAAW,IAAI,OAAO,EAAE;IAUxB;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,GAAG,SAAS;IAStD;;OAEG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAO/B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAE5E"}

package/dist/gateways/plugin-loader.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * Gateway Plugin Loader
+ *
+ * Discovers and loads gateway plugins from ~/.mama/plugins/
+ * Each plugin is a directory with:
+ * - plugin.json (manifest)
+ * - index.ts or index.js (entry point)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginLoader = void 0;
+exports.createPluginLoader = createPluginLoader;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const url_1 = require("url");
+/**
+ * Plugin Loader class
+ */
+class PluginLoader {
+    pluginsDir;
+    gatewayConfigs;
+    agentLoop;
+    plugins = new Map();
+    messageHandlers = new Map();
+    constructor(config = {}) {
+        const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+        this.pluginsDir = config.pluginsDir || (0, path_1.join)(homeDir, '.mama', 'plugins');
+        this.gatewayConfigs = config.gatewayConfigs || {};
+        this.agentLoop = config.agentLoop;
+    }
+    /**
+     * Discover all plugins in the plugins directory
+     */
+    async discover() {
+        const manifests = [];
+        if (!(0, fs_1.existsSync)(this.pluginsDir)) {
+            console.log(`[PluginLoader] Plugins directory not found: ${this.pluginsDir}`);
+            return manifests;
+        }
+        const entries = (0, fs_1.readdirSync)(this.pluginsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const pluginDir = (0, path_1.join)(this.pluginsDir, entry.name);
+            const manifestPath = (0, path_1.join)(pluginDir, 'plugin.json');
+            if (!(0, fs_1.existsSync)(manifestPath)) {
+                console.warn(`[PluginLoader] No plugin.json in ${entry.name}, skipping`);
+                continue;
+            }
+            try {
+                const manifestContent = (0, fs_1.readFileSync)(manifestPath, 'utf-8');
+                const manifest = JSON.parse(manifestContent);
+                // Validate required fields
+                if (!manifest.id || !manifest.name || !manifest.main) {
+                    console.warn(`[PluginLoader] Invalid manifest in ${entry.name}: missing required fields`);
+                    continue;
+                }
+                manifests.push(manifest);
+                // Store plugin info
+                this.plugins.set(manifest.id, {
+                    manifest,
+                    path: pluginDir,
+                    enabled: this.isPluginEnabled(manifest.id),
+                });
+                console.log(`[PluginLoader] Discovered plugin: ${manifest.name} (${manifest.id})`);
+            }
+            catch (err) {
+                console.error(`[PluginLoader] Failed to load manifest from ${entry.name}:`, err);
+            }
+        }
+        return manifests;
+    }
+    /**
+     * Check if a plugin is enabled in config
+     */
+    isPluginEnabled(pluginId) {
+        const config = this.gatewayConfigs[pluginId];
+        return config?.enabled !== false; // Enabled by default
+    }
+    /**
+     * Load and register a plugin
+     */
+    async loadPlugin(pluginId) {
+        const plugin = this.plugins.get(pluginId);
+        if (!plugin) {
+            console.error(`[PluginLoader] Plugin not found: ${pluginId}`);
+            return null;
+        }
+        if (!plugin.enabled) {
+            console.log(`[PluginLoader] Plugin disabled: ${pluginId}`);
+            return null;
+        }
+        const entryPath = (0, path_1.join)(plugin.path, plugin.manifest.main);
+        if (!(0, fs_1.existsSync)(entryPath)) {
+            console.error(`[PluginLoader] Entry point not found: ${entryPath}`);
+            return null;
+        }
+        try {
+            // Create plugin API
+            const api = this.createPluginApi(pluginId);
+            // Dynamic import of plugin module
+            const moduleUrl = (0, url_1.pathToFileURL)(entryPath).href;
+            const module = (await import(moduleUrl));
+            // Get the plugin module (handle both default export and named export)
+            const pluginModule = module.default || module;
+            if (!pluginModule.register || typeof pluginModule.register !== 'function') {
+                console.error(`[PluginLoader] Plugin ${pluginId} has no register function`);
+                return null;
+            }
+            // Register the plugin and get gateway instance
+            const gateway = await pluginModule.register(api);
+            plugin.gateway = gateway;
+            console.log(`[PluginLoader] Loaded plugin: ${plugin.manifest.name}`);
+            return gateway;
+        }
+        catch (err) {
+            console.error(`[PluginLoader] Failed to load plugin ${pluginId}:`, err);
+            return null;
+        }
+    }
+    /**
+     * Load all discovered plugins
+     */
+    async loadAll() {
+        const gateways = [];
+        for (const [pluginId] of this.plugins) {
+            const gateway = await this.loadPlugin(pluginId);
+            if (gateway) {
+                gateways.push(gateway);
+            }
+        }
+        return gateways;
+    }
+    /**
+     * Create the API object for a plugin
+     */
+    createPluginApi(pluginId) {
+        // Note: plugin info is available via this.plugins.get(pluginId)
+        const handlers = [];
+        this.messageHandlers.set(pluginId, handlers);
+        const logger = this.createLogger(pluginId);
+        return {
+            logger,
+            getConfig: () => {
+                return this.gatewayConfigs[pluginId];
+            },
+            getAgentLoop: () => {
+                if (!this.agentLoop) {
+                    throw new Error('Agent loop not available');
+                }
+                return this.agentLoop;
+            },
+            onMessage: (handler) => {
+                handlers.push(handler);
+            },
+            sendResponse: async (_channelId, _text, _metadata) => {
+                // This will be overridden by the gateway implementation
+                logger.warn(`sendResponse not implemented for ${pluginId}`);
+            },
+        };
+    }
+    /**
+     * Create a logger for a plugin
+     */
+    createLogger(pluginId) {
+        const prefix = `[${pluginId}]`;
+        return {
+            info: (message, ...args) => console.log(prefix, message, ...args),
+            warn: (message, ...args) => console.warn(prefix, message, ...args),
+            error: (message, ...args) => console.error(prefix, message, ...args),
+            debug: (message, ...args) => console.debug(prefix, message, ...args),
+        };
+    }
+    /**
+     * Get all loaded gateways
+     */
+    getGateways() {
+        const gateways = [];
+        for (const plugin of this.plugins.values()) {
+            if (plugin.gateway) {
+                gateways.push(plugin.gateway);
+            }
+        }
+        return gateways;
+    }
+    /**
+     * Get a specific gateway by source ID
+     */
+    getGateway(source) {
+        for (const plugin of this.plugins.values()) {
+            if (plugin.gateway?.source === source) {
+                return plugin.gateway;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Get all discovered plugins
+     */
+    getPlugins() {
+        return Array.from(this.plugins.values());
+    }
+    /**
+     * Stop all gateways
+     */
+    async stopAll() {
+        for (const plugin of this.plugins.values()) {
+            if (plugin.gateway?.isConnected()) {
+                await plugin.gateway.stop();
+            }
+        }
+    }
+}
+exports.PluginLoader = PluginLoader;
+/**
+ * Create a plugin loader instance
+ */
+function createPluginLoader(config) {
+    return new PluginLoader(config);
+}
+//# sourceMappingURL=plugin-loader.js.map

package/dist/gateways/plugin-loader.js.map

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

package/dist/gateways/session-store.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Session store for messenger conversations
+ *
+ * Manages conversation sessions with rolling context (history)
+ * for cross-platform messenger integration.
+ */
+import Database from 'better-sqlite3';
+import type { Session, MessageSource, ConversationTurn } from './types.js';
+/**
+ * SQLite-backed session store for messenger conversations
+ */
+export declare class SessionStore {
+    private db;
+    private maxTurns;
+    private maxResponseLength;
+    constructor(db: Database.Database, options?: {
+        maxTurns?: number;
+        maxResponseLength?: number;
+    });
+    /**
+     * Run database migration
+     */
+    private runMigration;
+    /**
+     * Get existing session or create new one
+     */
+    getOrCreate(source: MessageSource, channelId: string, userId?: string): Session;
+    /**
+     * Get session by ID
+     */
+    getById(sessionId: string): Session | null;
+    /**
+     * Update session with new conversation turn
+     */
+    updateSession(sessionId: string, userMessage: string, botResponse: string): boolean;
+    /**
+     * Get conversation history for a session
+     */
+    getHistory(sessionId: string): ConversationTurn[];
+    /**
+     * Clear session context (start fresh)
+     */
+    clearContext(sessionId: string): boolean;
+    /**
+     * Delete a session
+     */
+    deleteSession(sessionId: string): boolean;
+    /**
+     * List all sessions for a source
+     */
+    listSessions(source?: MessageSource): Session[];
+    /**
+     * Delete inactive sessions older than specified age
+     */
+    cleanupInactiveSessions(maxAgeMs: number): number;
+    /**
+     * Get the most recently active session for a specific source
+     */
+    getLastActiveSession(source?: MessageSource): Session | null;
+    /**
+     * Format context as readable string for system prompt
+     */
+    formatContextForPrompt(sessionId: string): string;
+    /**
+     * Convert database row to Session object
+     */
+    private rowToSession;
+    /**
+     * Truncate text to specified length
+     */
+    private truncate;
+    /**
+     * Close database connection
+     */
+    close(): void;
+}
+//# sourceMappingURL=session-store.d.ts.map

package/dist/gateways/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/gateways/session-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAoB3E;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,iBAAiB,CAAS;gBAGhC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAO;IAQjE;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAsC/E;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAQ1C;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAoCnF;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAWjD;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAcxC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMzC;;OAEG;IACH,YAAY,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,EAAE;IAa/C;;OAEG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IASjD;;OAEG;IACH,oBAAoB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI;IAiB5D;;OAEG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAUjD;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAKhB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}