@jungjaehoon/mama-os 0.1.1

package/dist/agent/session-pool.js

@@ -0,0 +1,272 @@
+"use strict";
+/**
+ * Session Pool - Claude CLI Session Reuse Manager
+ *
+ * Manages Claude CLI session IDs per channel to enable conversation continuity.
+ * Instead of creating new sessions for each message, reuses existing sessions
+ * so Claude CLI maintains its own conversation history.
+ *
+ * Benefits:
+ * - 6x token reduction (no manual history injection needed)
+ * - Natural conversation flow (Claude remembers context)
+ * - Automatic summarization by Claude when context fills up
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionPool = void 0;
+exports.getSessionPool = getSessionPool;
+exports.setSessionPool = setSessionPool;
+exports.buildChannelKey = buildChannelKey;
+const crypto_1 = require("crypto");
+/**
+ * Context window threshold (80% of 200K)
+ * When exceeded, session will be reset on next request
+ */
+const CONTEXT_THRESHOLD_TOKENS = 160000;
+const DEFAULT_SESSION_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
+const DEFAULT_MAX_SESSIONS = 100;
+const DEFAULT_CLEANUP_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Session Pool for Claude CLI session management
+ *
+ * Key design:
+ * - Channel key format: "{source}:{channelId}" (e.g., "discord:123456")
+ * - Sessions expire after timeout (default 30 min)
+ * - Automatic cleanup of stale sessions
+ */
+class SessionPool {
+    sessions = new Map();
+    config;
+    cleanupTimer = null;
+    constructor(config = {}) {
+        this.config = {
+            sessionTimeoutMs: config.sessionTimeoutMs ?? DEFAULT_SESSION_TIMEOUT_MS,
+            maxSessions: config.maxSessions ?? DEFAULT_MAX_SESSIONS,
+            cleanupIntervalMs: config.cleanupIntervalMs ?? DEFAULT_CLEANUP_INTERVAL_MS,
+        };
+        // Start periodic cleanup
+        this.startCleanupTimer();
+    }
+    /**
+     * Get or create session ID for a channel
+     *
+     * With --no-session-persistence flag, Claude CLI doesn't lock session IDs.
+     * This allows session reuse for conversation continuity.
+     *
+     * Auto-resets session when context window reaches 80% (160K tokens).
+     *
+     * @param channelKey - Channel identifier (format: "{source}:{channelId}")
+     * @returns Object with sessionId and isNew flag
+     */
+    getSession(channelKey) {
+        const existing = this.sessions.get(channelKey);
+        const now = Date.now();
+        // Check if existing session is still valid
+        if (existing) {
+            const isExpired = now - existing.lastActive > this.config.sessionTimeoutMs;
+            const isContextFull = existing.totalInputTokens >= CONTEXT_THRESHOLD_TOKENS;
+            if (isExpired) {
+                this.sessions.delete(channelKey);
+                console.log(`[SessionPool] Session expired for ${channelKey}, creating new one`);
+            }
+            else if (isContextFull) {
+                this.sessions.delete(channelKey);
+                console.log(`[SessionPool] Context 80% full (${existing.totalInputTokens} tokens) for ${channelKey}, creating fresh session`);
+            }
+            else {
+                // Reuse existing session
+                existing.lastActive = now;
+                existing.messageCount++;
+                const usagePercent = Math.round((existing.totalInputTokens / 200000) * 100);
+                console.log(`[SessionPool] Reusing session for ${channelKey}: ${existing.sessionId} (msg #${existing.messageCount}, ${usagePercent}% context)`);
+                return { sessionId: existing.sessionId, isNew: false };
+            }
+        }
+        // Create new session
+        const sessionId = this.createSession(channelKey);
+        return { sessionId, isNew: true };
+    }
+    /**
+     * Update token usage for a session
+     * Called after each Claude CLI response
+     *
+     * @param channelKey - Channel identifier
+     * @param inputTokens - Input tokens from this request
+     * @returns Current total tokens and whether threshold is approaching
+     */
+    updateTokens(channelKey, inputTokens) {
+        const existing = this.sessions.get(channelKey);
+        if (!existing) {
+            return { totalTokens: 0, nearThreshold: false };
+        }
+        existing.totalInputTokens += inputTokens;
+        const nearThreshold = existing.totalInputTokens >= CONTEXT_THRESHOLD_TOKENS * 0.9; // 90% of threshold
+        if (nearThreshold) {
+            console.log(`[SessionPool] ⚠️ Context approaching limit: ${existing.totalInputTokens} tokens (${Math.round(existing.totalInputTokens / 2000)}% of 200K)`);
+        }
+        return {
+            totalTokens: existing.totalInputTokens,
+            nearThreshold,
+        };
+    }
+    /**
+     * Get current token usage for a session
+     */
+    getTokenUsage(channelKey) {
+        const existing = this.sessions.get(channelKey);
+        return existing?.totalInputTokens ?? 0;
+    }
+    /**
+     * Legacy method for backward compatibility
+     * @deprecated Use getSession() instead
+     */
+    getSessionId(channelKey) {
+        return this.getSession(channelKey).sessionId;
+    }
+    /**
+     * Release a session after use (no-op since we use fresh sessions)
+     */
+    releaseSession(_channelKey) {
+        // No-op: Each request uses a fresh session ID
+        // Claude CLI locks session IDs, preventing reuse
+    }
+    /**
+     * Create a new session for a channel
+     */
+    createSession(channelKey) {
+        const now = Date.now();
+        const sessionId = (0, crypto_1.randomUUID)();
+        // Enforce max sessions limit
+        if (this.sessions.size >= this.config.maxSessions) {
+            this.evictOldestSession();
+        }
+        const entry = {
+            sessionId,
+            lastActive: now,
+            messageCount: 1,
+            createdAt: now,
+            inUse: true, // Lock on creation
+            totalInputTokens: 0,
+        };
+        this.sessions.set(channelKey, entry);
+        console.log(`[SessionPool] Created new session for ${channelKey}: ${sessionId}`);
+        return sessionId;
+    }
+    /**
+     * Force create a new session (for /clear command)
+     */
+    resetSession(channelKey) {
+        this.sessions.delete(channelKey);
+        return this.createSession(channelKey);
+    }
+    /**
+     * Check if a session exists and is active
+     */
+    hasActiveSession(channelKey) {
+        const existing = this.sessions.get(channelKey);
+        if (!existing)
+            return false;
+        const isExpired = Date.now() - existing.lastActive > this.config.sessionTimeoutMs;
+        return !isExpired;
+    }
+    /**
+     * Get session info for a channel
+     */
+    getSessionInfo(channelKey) {
+        return this.sessions.get(channelKey) || null;
+    }
+    /**
+     * Get all active sessions (for debugging/monitoring)
+     */
+    listSessions() {
+        return new Map(this.sessions);
+    }
+    /**
+     * Get active session count
+     */
+    getActiveSessionCount() {
+        return this.sessions.size;
+    }
+    /**
+     * Evict the oldest (least recently used) session
+     */
+    evictOldestSession() {
+        let oldestKey = null;
+        let oldestTime = Infinity;
+        for (const [key, entry] of this.sessions) {
+            if (entry.lastActive < oldestTime) {
+                oldestTime = entry.lastActive;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.sessions.delete(oldestKey);
+            console.log(`[SessionPool] Evicted oldest session: ${oldestKey}`);
+        }
+    }
+    /**
+     * Clean up expired sessions
+     */
+    cleanup() {
+        const now = Date.now();
+        let cleaned = 0;
+        for (const [key, entry] of this.sessions) {
+            if (now - entry.lastActive > this.config.sessionTimeoutMs) {
+                this.sessions.delete(key);
+                cleaned++;
+            }
+        }
+        if (cleaned > 0) {
+            console.log(`[SessionPool] Cleaned up ${cleaned} expired sessions`);
+        }
+        return cleaned;
+    }
+    /**
+     * Start periodic cleanup timer
+     */
+    startCleanupTimer() {
+        if (this.cleanupTimer)
+            return;
+        this.cleanupTimer = setInterval(() => {
+            this.cleanup();
+        }, this.config.cleanupIntervalMs);
+        // Don't prevent process exit
+        this.cleanupTimer.unref();
+    }
+    /**
+     * Stop cleanup timer and clear all sessions
+     */
+    dispose() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        this.sessions.clear();
+    }
+}
+exports.SessionPool = SessionPool;
+/**
+ * Global session pool instance
+ */
+let globalSessionPool = null;
+/**
+ * Get global session pool instance
+ */
+function getSessionPool() {
+    if (!globalSessionPool) {
+        globalSessionPool = new SessionPool();
+    }
+    return globalSessionPool;
+}
+/**
+ * Set global session pool instance (for testing)
+ */
+function setSessionPool(pool) {
+    globalSessionPool = pool;
+}
+/**
+ * Build channel key from source and channel ID
+ */
+function buildChannelKey(source, channelId) {
+    return `${source}:${channelId}`;
+}
+//# sourceMappingURL=session-pool.js.map

package/dist/agent/session-pool.js.map

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

package/dist/agent/streaming-callback-manager.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Streaming Callback Manager
+ *
+ * Coordinates callbacks between ClaudeClient and Discord gateway.
+ * Manages placeholder message creation, text accumulation, and error handling.
+ */
+import type { Message } from 'discord.js';
+import type { ClaudeResponse } from './types.js';
+/**
+ * Interface for Discord gateway operations
+ */
+export interface DiscordGatewayInterface {
+    /**
+     * Edit a message with throttling to prevent rate limits
+     * @param message Discord message to edit
+     * @param content New message content
+     */
+    editMessageThrottled(message: Message, content: string): Promise<void>;
+}
+/**
+ * Manages streaming callbacks and coordinates with Discord gateway
+ *
+ * Responsibilities:
+ * - Create placeholder message before streaming starts
+ * - Accumulate text deltas and update Discord message
+ * - Track tool use events
+ * - Handle errors and update placeholder with error message
+ * - Clean up references after streaming completes
+ */
+export declare class StreamingCallbackManager {
+    private discordGateway;
+    private originalMessage;
+    private placeholderMessage;
+    private accumulatedText;
+    /**
+     * Create a new streaming callback manager
+     * @param discordGateway Discord gateway for message operations
+     * @param originalMessage Original message to reply to
+     */
+    constructor(discordGateway: DiscordGatewayInterface, originalMessage: Message);
+    /**
+     * Create a placeholder message to be updated with streaming content
+     * @throws Error if message creation fails
+     */
+    createPlaceholder(): Promise<void>;
+    /**
+     * Handle text delta from streaming response
+     * Accumulates text and updates Discord message
+     * @param text Text delta to add
+     */
+    onDelta(text: string): Promise<void>;
+    /**
+     * Handle tool use event
+     * @param name Tool name
+     * @param _input Tool input
+     */
+    onToolUse(name: string, _input: unknown): void;
+    /**
+     * Handle final response from streaming
+     * @param _response Final Claude response
+     */
+    onFinal(_response: ClaudeResponse): Promise<void>;
+    /**
+     * Handle error during streaming
+     * Updates placeholder message with error information
+     * @param error Error that occurred
+     */
+    onError(error: Error): Promise<void>;
+    /**
+     * Clean up resources and clear references
+     * Should be called after streaming completes
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Get the current placeholder message
+     * @returns Placeholder message or null if not created
+     */
+    getPlaceholderMessage(): Message | null;
+    /**
+     * Get the accumulated text so far
+     * @returns Accumulated text content
+     */
+    getAccumulatedText(): string;
+}
+//# sourceMappingURL=streaming-callback-manager.d.ts.map

package/dist/agent/streaming-callback-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-callback-manager.d.ts","sourceRoot":"","sources":["../../src/agent/streaming-callback-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAED;;;;;;;;;GASG;AACH,qBAAa,wBAAwB;IAUjC,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,eAAe;IAVzB,OAAO,CAAC,kBAAkB,CAAwB;IAClD,OAAO,CAAC,eAAe,CAAM;IAE7B;;;;OAIG;gBAEO,cAAc,EAAE,uBAAuB,EACvC,eAAe,EAAE,OAAO;IAGlC;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;OAIG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1C;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAI9C;;;OAGG;IACG,OAAO,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1C;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;;OAGG;IACH,qBAAqB,IAAI,OAAO,GAAG,IAAI;IAIvC;;;OAGG;IACH,kBAAkB,IAAI,MAAM;CAG7B"}

package/dist/agent/streaming-callback-manager.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * Streaming Callback Manager
+ *
+ * Coordinates callbacks between ClaudeClient and Discord gateway.
+ * Manages placeholder message creation, text accumulation, and error handling.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamingCallbackManager = void 0;
+/**
+ * Manages streaming callbacks and coordinates with Discord gateway
+ *
+ * Responsibilities:
+ * - Create placeholder message before streaming starts
+ * - Accumulate text deltas and update Discord message
+ * - Track tool use events
+ * - Handle errors and update placeholder with error message
+ * - Clean up references after streaming completes
+ */
+class StreamingCallbackManager {
+    discordGateway;
+    originalMessage;
+    placeholderMessage = null;
+    accumulatedText = '';
+    /**
+     * Create a new streaming callback manager
+     * @param discordGateway Discord gateway for message operations
+     * @param originalMessage Original message to reply to
+     */
+    constructor(discordGateway, originalMessage) {
+        this.discordGateway = discordGateway;
+        this.originalMessage = originalMessage;
+    }
+    /**
+     * Create a placeholder message to be updated with streaming content
+     * @throws Error if message creation fails
+     */
+    async createPlaceholder() {
+        this.placeholderMessage = await this.originalMessage.reply('⏳ Processing...');
+    }
+    /**
+     * Handle text delta from streaming response
+     * Accumulates text and updates Discord message
+     * @param text Text delta to add
+     */
+    async onDelta(text) {
+        this.accumulatedText += text;
+        if (this.placeholderMessage) {
+            await this.discordGateway.editMessageThrottled(this.placeholderMessage, this.accumulatedText);
+        }
+    }
+    /**
+     * Handle tool use event
+     * @param name Tool name
+     * @param _input Tool input
+     */
+    onToolUse(name, _input) {
+        console.log(`[Streaming] Tool called: ${name}`);
+    }
+    /**
+     * Handle final response from streaming
+     * @param _response Final Claude response
+     */
+    async onFinal(_response) {
+        console.log('[Streaming] Stream complete');
+        // Final flush handled by Discord gateway's throttle mechanism
+    }
+    /**
+     * Handle error during streaming
+     * Updates placeholder message with error information
+     * @param error Error that occurred
+     */
+    async onError(error) {
+        console.error('[Streaming] Error:', error);
+        if (this.placeholderMessage) {
+            await this.placeholderMessage.edit(`❌ Translation failed: ${error.message}\n\nPlease try again or use a smaller image.`);
+        }
+    }
+    /**
+     * Clean up resources and clear references
+     * Should be called after streaming completes
+     */
+    async cleanup() {
+        this.placeholderMessage = null;
+        this.accumulatedText = '';
+    }
+    /**
+     * Get the current placeholder message
+     * @returns Placeholder message or null if not created
+     */
+    getPlaceholderMessage() {
+        return this.placeholderMessage;
+    }
+    /**
+     * Get the accumulated text so far
+     * @returns Accumulated text content
+     */
+    getAccumulatedText() {
+        return this.accumulatedText;
+    }
+}
+exports.StreamingCallbackManager = StreamingCallbackManager;
+//# sourceMappingURL=streaming-callback-manager.js.map

package/dist/agent/streaming-callback-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-callback-manager.js","sourceRoot":"","sources":["../../src/agent/streaming-callback-manager.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAiBH;;;;;;;;;GASG;AACH,MAAa,wBAAwB;IAUzB;IACA;IAVF,kBAAkB,GAAmB,IAAI,CAAC;IAC1C,eAAe,GAAG,EAAE,CAAC;IAE7B;;;;OAIG;IACH,YACU,cAAuC,EACvC,eAAwB;QADxB,mBAAc,GAAd,cAAc,CAAyB;QACvC,oBAAe,GAAf,eAAe,CAAS;IAC/B,CAAC;IAEJ;;;OAGG;IACH,KAAK,CAAC,iBAAiB;QACrB,IAAI,CAAC,kBAAkB,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAChF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC;QAC7B,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,cAAc,CAAC,oBAAoB,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,IAAY,EAAE,MAAe;QACrC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,SAAyB;QACrC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,8DAA8D;IAChE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,KAAY;QACxB,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAChC,yBAAyB,KAAK,CAAC,OAAO,8CAA8C,CACrF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QAC/B,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,qBAAqB;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;CACF;AA1FD,4DA0FC"}