@dsiloed/silo-link 1.0.0

package/dist/core/claude-launcher.js

@@ -0,0 +1,352 @@
+import { spawn } from 'node:child_process';
+/**
+ * Manages Claude Code child processes.
+ *
+ * Strategy:
+ * - For SiloLink-spawned sessions: nudge via stdin when idle (preserves context)
+ * - Respawn ONLY when the process actually exits
+ * - On respawn, use `claude --resume <id>` to restore context
+ * - Store Claude session ID in DSiloed agent_session metadata
+ * - Kill all child processes on SiloLink shutdown
+ */
+export class ClaudeLauncher {
+    config;
+    sessionManager;
+    dsiloedClient;
+    childProcess = null;
+    tmuxSessions = new Map(); // tmuxName -> conversationId
+    tmuxMonitorTimer = null;
+    idleCheckTimer = null;
+    launchingConversations = new Set();
+    messageQueue = null;
+    enabled;
+    lastNudgeAt = 0;
+    nudgeCount = 0; // Consecutive nudges without activity change
+    lastActivitySnapshot = new Map(); // sessionId -> lastActivity timestamp
+    // Last Claude Code session ID (for --resume)
+    lastClaudeSessionId = null;
+    constructor(config, sessionManager, dsiloedClient, messageQueue) {
+        this.config = config;
+        this.sessionManager = sessionManager;
+        this.dsiloedClient = dsiloedClient || null;
+        this.messageQueue = messageQueue || null;
+        this.enabled = !!(config.claude_command && config.claude_working_directory);
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    isAutoRespawnEnabled() {
+        return this.enabled && !!this.config.claude_auto_respawn;
+    }
+    hasLiveProcess() {
+        return this.tmuxSessions.size > 0;
+    }
+    getLastClaudeSessionId() {
+        return this.lastClaudeSessionId;
+    }
+    setLastResumeId(resumeId) {
+        this.lastClaudeSessionId = resumeId;
+        console.log(`[ClaudeLauncher] Restored resume ID from previous session: ${resumeId}`);
+    }
+    /**
+     * Start the idle monitor that nudges idle sessions or respawns dead ones.
+     */
+    startIdleMonitor() {
+        if (!this.isAutoRespawnEnabled())
+            return;
+        const checkInterval = Math.max((this.config.claude_idle_timeout_ms || 30000) / 2, 5000);
+        this.idleCheckTimer = setInterval(() => this.checkIdle(), checkInterval);
+        console.log(`  Claude auto-manage enabled (idle timeout: ${this.config.claude_idle_timeout_ms || 30000}ms)`);
+    }
+    stopIdleMonitor() {
+        if (this.idleCheckTimer) {
+            clearInterval(this.idleCheckTimer);
+            this.idleCheckTimer = null;
+        }
+    }
+    /**
+     * Launch a new Claude Code session. Uses --resume if a previous session ID is available.
+     */
+    async launch(reason = 'manual', conversationId) {
+        if (!this.enabled) {
+            console.log('[ClaudeLauncher] Not configured — set claude_command and claude_working_directory in config');
+            return false;
+        }
+        const convKey = conversationId || 0;
+        if (this.launchingConversations.has(convKey)) {
+            console.log(`[ClaudeLauncher] Already launching for conversation ${convKey}, skipping`);
+            return false;
+        }
+        this.launchingConversations.add(convKey);
+        try {
+            const command = this.config.claude_command || 'claude';
+            const cwd = this.config.claude_working_directory || process.cwd();
+            const args = ['--dangerously-skip-permissions'];
+            let prompt;
+            // Try to resume previous session if we have an ID
+            if (this.lastClaudeSessionId && (reason === 'process-exit' || reason === 'inbound-message')) {
+                args.push('--resume', this.lastClaudeSessionId);
+                console.log(`[ClaudeLauncher] Resuming session: ${this.lastClaudeSessionId}`);
+                prompt = 'Continue polling SiloLink for messages. Check memory for context if needed.';
+            }
+            else {
+                if (reason === 'process-exit' || reason === 'inbound-message') {
+                    const registerParams = conversationId
+                        ? `{ "conversation_id": ${conversationId} }`
+                        : `{}`;
+                    prompt = [
+                        `Call mcp__silolink__remote_register with these exact parameters: ${registerParams}. After registering, IMMEDIATELY send a remote_notify message telling the user you are ready. Then enter the poll loop using remote_poll. See CLAUDE.md for the poll loop pattern.`,
+                        '',
+                        'Context: This is a new session replacing a previous one that ended.',
+                        'Before entering the poll loop:',
+                        '1. Check your memory files for context on recent work',
+                        '2. Briefly review what was being worked on',
+                        '3. Save any important context from the conversation history to memory',
+                        '4. Send a remote_notify telling the user you are ready and what context you loaded',
+                        '5. Then enter the poll loop and process any pending messages',
+                        '',
+                        'CRITICAL: The user is NOT watching the terminal. You MUST send a remote_notify progress update after EVERY major step (file edits, commits, merges, deploys, errors). Do not go silent while working.',
+                    ].join('\n');
+                }
+                else {
+                    prompt = this.config.claude_session_prompt ||
+                        'Register with SiloLink as "portablemind" and enter the poll loop.';
+                }
+            }
+            console.log(`[ClaudeLauncher] Launching Claude Code via tmux (reason: ${reason})`);
+            console.log(`  Command: ${command} ${args.join(' ')}`);
+            console.log(`  Working directory: ${cwd}`);
+            console.log(`  Prompt: ${prompt.substring(0, 100)}...`);
+            const tmuxSession = `silolink-claude-${Date.now()}`;
+            // Create a new tmux session running Claude Code in a real TTY
+            const claudeCmd = `cd ${cwd} && ${command} ${args.join(' ')}`;
+            const tmuxCreate = spawn('tmux', [
+                'new-session', '-d', '-s', tmuxSession, '-x', '200', '-y', '50', claudeCmd,
+            ], {
+                stdio: 'ignore',
+                detached: true,
+                env: {
+                    ...process.env,
+                    SILOLINK_MCP_URL: `http://localhost:${this.config.mcp_port}/mcp`,
+                },
+            });
+            tmuxCreate.unref();
+            // Wait for tmux session to start, then send the prompt
+            await new Promise(resolve => setTimeout(resolve, 3000));
+            // Check if tmux session exists
+            const checkResult = spawn('tmux', ['has-session', '-t', tmuxSession], { stdio: 'ignore' });
+            const sessionExists = await new Promise(resolve => {
+                checkResult.on('exit', code => resolve(code === 0));
+            });
+            if (!sessionExists) {
+                console.error(`[ClaudeLauncher] tmux session ${tmuxSession} failed to start`);
+                return false;
+            }
+            console.log(`[ClaudeLauncher] tmux session "${tmuxSession}" created`);
+            this.tmuxSessions.set(tmuxSession, conversationId || 0);
+            // Send the prompt to Claude via tmux send-keys after MCP servers initialize
+            const sessionToPrompt = tmuxSession;
+            const promptToSend = prompt;
+            setTimeout(() => {
+                const escapedPrompt = promptToSend.replace(/"/g, '\\"').replace(/\n/g, ' ');
+                const sendKeys = spawn('tmux', ['send-keys', '-t', sessionToPrompt, escapedPrompt], { stdio: 'pipe' });
+                sendKeys.on('exit', (code) => {
+                    if (code === 0) {
+                        console.log(`[ClaudeLauncher] Sent prompt to tmux session "${sessionToPrompt}" (${promptToSend.length} chars)`);
+                        // Send Enter separately after a short delay to avoid bracketed paste swallowing it
+                        setTimeout(() => {
+                            spawn('tmux', ['send-keys', '-t', sessionToPrompt, 'Enter'], { stdio: 'pipe' });
+                        }, 500);
+                    }
+                    else {
+                        console.error(`[ClaudeLauncher] Failed to send prompt to tmux session "${sessionToPrompt}" (exit code: ${code})`);
+                    }
+                });
+                sendKeys.on('error', (err) => {
+                    console.error(`[ClaudeLauncher] Error sending prompt to "${sessionToPrompt}": ${err.message}`);
+                });
+            }, 8000); // Wait 8s for MCP to initialize
+            // Monitor the tmux session for exit
+            this.monitorTmuxSession(tmuxSession);
+            return true;
+        }
+        finally {
+            setTimeout(() => { this.launchingConversations.delete(convKey); }, 10000);
+        }
+    }
+    /**
+     * Store the Claude resume ID in the DSiloed agent session metadata.
+     */
+    async storeResumeId(resumeId) {
+        if (!this.dsiloedClient)
+            return;
+        const sessions = this.sessionManager.getAll();
+        for (const session of sessions) {
+            if (session.agentSessionId) {
+                session.claudeResumeId = resumeId;
+                await this.dsiloedClient.updateAgentSession(session.agentSessionId, {
+                    metadata: { claude_resume_id: resumeId },
+                });
+                console.log(`[ClaudeLauncher] Stored resume ID in agent session ${session.agentSessionId}`);
+            }
+        }
+    }
+    /**
+     * Called when an inbound message arrives and no active session can handle it.
+     */
+    async launchOnMessage(conversationId) {
+        if (!this.enabled)
+            return false;
+        // Check if there's already a session registered for this conversation
+        if (conversationId) {
+            const existingSession = this.sessionManager.getByConversationId(conversationId);
+            if (existingSession) {
+                console.log(`[ClaudeLauncher] Session already exists for conversation ${conversationId} — skipping`);
+                return false;
+            }
+        }
+        return this.launch('inbound-message', conversationId);
+    }
+    /**
+     * Check for idle sessions — nudge if process alive, respawn if dead.
+     * If a session has been nudged multiple times without responding and has
+     * pending messages, kill and relaunch it (hung session recovery).
+     */
+    async checkIdle() {
+        const sessions = this.sessionManager.getAll();
+        const idleTimeout = this.config.claude_idle_timeout_ms || 30000;
+        const maxNudges = 3; // Kill after 3 failed nudges (~90s with no response)
+        const now = Date.now();
+        if (sessions.length === 0)
+            return;
+        const allIdle = sessions.every(s => now - s.lastActivity.getTime() > idleTimeout);
+        if (!allIdle) {
+            // Activity detected — reset nudge counter and update snapshots
+            this.nudgeCount = 0;
+            for (const s of sessions) {
+                this.lastActivitySnapshot.set(s.sessionId, s.lastActivity.getTime());
+            }
+            return;
+        }
+        if (this.hasLiveProcess()) {
+            // Check if activity changed since last nudge
+            const activityChanged = sessions.some(s => {
+                const prev = this.lastActivitySnapshot.get(s.sessionId) || 0;
+                return s.lastActivity.getTime() > prev;
+            });
+            if (activityChanged) {
+                this.nudgeCount = 0;
+            }
+            // Update snapshots
+            for (const s of sessions) {
+                this.lastActivitySnapshot.set(s.sessionId, s.lastActivity.getTime());
+            }
+            // Check if any session has pending messages in the queue
+            const hasPendingMessages = this.messageQueue && sessions.some(s => this.messageQueue.queueSize(s.sessionId) > 0);
+            if (this.nudgeCount >= maxNudges && hasPendingMessages) {
+                // Session is hung with undelivered messages — kill and relaunch
+                console.log(`[ClaudeLauncher] Session hung (${this.nudgeCount} nudges with no response, messages pending) — killing and relaunching`);
+                const hungSessions = sessions.filter(s => this.messageQueue.queueSize(s.sessionId) > 0);
+                for (const s of hungSessions) {
+                    this.killByConversation(s.conversationId);
+                    this.sessionManager.unregister(s.sessionId);
+                    // Relaunch for this conversation
+                    await this.launch('inbound-message', s.conversationId);
+                }
+                this.nudgeCount = 0;
+                return;
+            }
+            // Process alive but idle — nudge via stdin
+            this.nudge();
+            this.nudgeCount++;
+            return;
+        }
+        else if (this.launchingConversations.size === 0) {
+            const lastConvId = sessions[0]?.conversationId;
+            if (!this.lastClaudeSessionId) {
+                this.lastClaudeSessionId = sessions[0]?.claudeResumeId || null;
+            }
+            console.log(`[ClaudeLauncher] Sessions orphaned (process dead), respawning...`);
+            this.nudgeCount = 0;
+            await this.launch('process-exit', lastConvId);
+        }
+    }
+    /**
+     * Monitor a tmux session and detect when it exits.
+     */
+    monitorTmuxSession(sessionName) {
+        // Start monitor if not already running
+        if (!this.tmuxMonitorTimer) {
+            this.tmuxMonitorTimer = setInterval(() => this.checkTmuxSessions(), 5000);
+        }
+    }
+    checkTmuxSessions() {
+        for (const [name] of this.tmuxSessions) {
+            const check = spawn('tmux', ['has-session', '-t', name], { stdio: 'ignore' });
+            check.on('exit', (code) => {
+                if (code !== 0) {
+                    console.log(`[ClaudeLauncher] tmux session "${name}" ended`);
+                    this.tmuxSessions.delete(name);
+                    if (this.tmuxSessions.size === 0 && this.tmuxMonitorTimer) {
+                        clearInterval(this.tmuxMonitorTimer);
+                        this.tmuxMonitorTimer = null;
+                    }
+                }
+            });
+        }
+    }
+    /**
+     * Send a message to all running Claude sessions via tmux send-keys.
+     */
+    nudge() {
+        if (this.tmuxSessions.size === 0)
+            return false;
+        const now = Date.now();
+        if (now - this.lastNudgeAt < 10000)
+            return false;
+        this.lastNudgeAt = now;
+        const message = 'Continue polling SiloLink for messages. Do not stop the poll loop.';
+        for (const [name] of this.tmuxSessions) {
+            spawn('tmux', ['send-keys', '-t', name, message, 'Enter'], { stdio: 'ignore' });
+        }
+        console.log(`[ClaudeLauncher] Nudged ${this.tmuxSessions.size} Claude session(s) via tmux`);
+        return true;
+    }
+    /**
+     * Kill the Claude session for a specific conversation.
+     */
+    killByConversation(conversationId) {
+        for (const [name, convId] of this.tmuxSessions) {
+            if (convId === conversationId) {
+                console.log(`[ClaudeLauncher] Killing tmux session "${name}" (conversation ${conversationId})`);
+                spawn('tmux', ['kill-session', '-t', name], { stdio: 'ignore' });
+                this.tmuxSessions.delete(name);
+                return;
+            }
+        }
+        console.log(`[ClaudeLauncher] No tmux session found for conversation ${conversationId}`);
+    }
+    /**
+     * Kill all running Claude Code sessions.
+     */
+    kill() {
+        for (const [name] of this.tmuxSessions) {
+            console.log(`[ClaudeLauncher] Killing tmux session "${name}"`);
+            spawn('tmux', ['kill-session', '-t', name], { stdio: 'ignore' });
+        }
+        this.tmuxSessions.clear();
+        if (this.tmuxMonitorTimer) {
+            clearInterval(this.tmuxMonitorTimer);
+            this.tmuxMonitorTimer = null;
+        }
+        if (this.childProcess) {
+            this.childProcess.kill('SIGTERM');
+            this.childProcess = null;
+        }
+    }
+    destroy() {
+        this.stopIdleMonitor();
+        this.kill();
+    }
+}
+//# sourceMappingURL=claude-launcher.js.map

package/dist/core/claude-launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-launcher.js","sourceRoot":"","sources":["../../src/core/claude-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAM9D;;;;;;;;;GASG;AACH,MAAM,OAAO,cAAc;IACjB,MAAM,CAAiB;IACvB,cAAc,CAAiB;IAC/B,aAAa,CAAuB;IACpC,YAAY,GAAwB,IAAI,CAAC;IACzC,YAAY,GAAwB,IAAI,GAAG,EAAE,CAAC,CAAC,6BAA6B;IAC5E,gBAAgB,GAA0C,IAAI,CAAC;IAC/D,cAAc,GAA0C,IAAI,CAAC;IAC7D,sBAAsB,GAAgB,IAAI,GAAG,EAAE,CAAC;IAChD,YAAY,GAAwB,IAAI,CAAC;IACzC,OAAO,CAAU;IACjB,WAAW,GAAG,CAAC,CAAC;IAChB,UAAU,GAAG,CAAC,CAAC,CAAC,6CAA6C;IAC7D,oBAAoB,GAAwB,IAAI,GAAG,EAAE,CAAC,CAAC,sCAAsC;IACrG,6CAA6C;IACrC,mBAAmB,GAAkB,IAAI,CAAC;IAElD,YACE,MAAsB,EACtB,cAA8B,EAC9B,aAA6B,EAC7B,YAA2B;QAE3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,aAAa,GAAG,aAAa,IAAI,IAAI,CAAC;QAC3C,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,IAAI,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAC9E,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;IAC3D,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,sBAAsB;QACpB,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;IAED,eAAe,CAAC,QAAgB;QAC9B,IAAI,CAAC,mBAAmB,GAAG,QAAQ,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,8DAA8D,QAAQ,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE;YAAE,OAAO;QAEzC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QACxF,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,aAAa,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,+CAA+C,IAAI,CAAC,MAAM,CAAC,sBAAsB,IAAI,KAAK,KAAK,CAAC,CAAC;IAC/G,CAAC;IAED,eAAe;QACb,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;IAGD;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,SAAiB,QAAQ,EAAE,cAAuB;QAC7D,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,6FAA6F,CAAC,CAAC;YAC3G,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,OAAO,GAAG,cAAc,IAAI,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,uDAAuD,OAAO,YAAY,CAAC,CAAC;YACxF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,QAAQ,CAAC;YACvD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,wBAAwB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAElE,MAAM,IAAI,GAAG,CAAC,gCAAgC,CAAC,CAAC;YAEhD,IAAI,MAAc,CAAC;YAEnB,kDAAkD;YAClD,IAAI,IAAI,CAAC,mBAAmB,IAAI,CAAC,MAAM,KAAK,cAAc,IAAI,MAAM,KAAK,iBAAiB,CAAC,EAAE,CAAC;gBAC5F,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC;gBAChD,OAAO,CAAC,GAAG,CAAC,sCAAsC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;gBAC9E,MAAM,GAAG,6EAA6E,CAAC;YACzF,CAAC;iBAAM,CAAC;gBACN,IAAI,MAAM,KAAK,cAAc,IAAI,MAAM,KAAK,iBAAiB,EAAE,CAAC;oBAC9D,MAAM,cAAc,GAAG,cAAc;wBACnC,CAAC,CAAC,wBAAwB,cAAc,IAAI;wBAC5C,CAAC,CAAC,IAAI,CAAC;oBACT,MAAM,GAAG;wBACP,oEAAoE,cAAc,oLAAoL;wBACtQ,EAAE;wBACF,qEAAqE;wBACrE,gCAAgC;wBAChC,uDAAuD;wBACvD,4CAA4C;wBAC5C,uEAAuE;wBACvE,oFAAoF;wBACpF,8DAA8D;wBAC9D,EAAE;wBACF,uMAAuM;qBACxM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACf,CAAC;qBAAM,CAAC;oBACN,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,qBAAqB;wBACxC,mEAAmE,CAAC;gBACxE,CAAC;YACH,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,4DAA4D,MAAM,GAAG,CAAC,CAAC;YACnF,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;YAExD,MAAM,WAAW,GAAG,mBAAmB,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAEpD,8DAA8D;YAC9D,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9D,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE;gBAC/B,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS;aAC3E,EAAE;gBACD,KAAK,EAAE,QAAQ;gBACf,QAAQ,EAAE,IAAI;gBACd,GAAG,EAAE;oBACH,GAAG,OAAO,CAAC,GAAG;oBACd,gBAAgB,EAAE,oBAAoB,IAAI,CAAC,MAAM,CAAC,QAAQ,MAAM;iBACjE;aACF,CAAC,CAAC;YACH,UAAU,CAAC,KAAK,EAAE,CAAC;YAEnB,uDAAuD;YACvD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;YAExD,+BAA+B;YAC/B,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC3F,MAAM,aAAa,GAAG,MAAM,IAAI,OAAO,CAAU,OAAO,CAAC,EAAE;gBACzD,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;YACtD,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,OAAO,CAAC,KAAK,CAAC,iCAAiC,WAAW,kBAAkB,CAAC,CAAC;gBAC9E,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,kCAAkC,WAAW,WAAW,CAAC,CAAC;YACtE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,cAAc,IAAI,CAAC,CAAC,CAAC;YAExD,4EAA4E;YAC5E,MAAM,eAAe,GAAG,WAAW,CAAC;YACpC,MAAM,YAAY,GAAG,MAAM,CAAC;YAC5B,UAAU,CAAC,GAAG,EAAE;gBACd,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC5E,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBACvG,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;oBAC3B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;wBACf,OAAO,CAAC,GAAG,CAAC,iDAAiD,eAAe,MAAM,YAAY,CAAC,MAAM,SAAS,CAAC,CAAC;wBAChH,mFAAmF;wBACnF,UAAU,CAAC,GAAG,EAAE;4BACd,KAAK,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;wBAClF,CAAC,EAAE,GAAG,CAAC,CAAC;oBACV,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,KAAK,CAAC,2DAA2D,eAAe,iBAAiB,IAAI,GAAG,CAAC,CAAC;oBACpH,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;oBAC3B,OAAO,CAAC,KAAK,CAAC,6CAA6C,eAAe,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACjG,CAAC,CAAC,CAAC;YACL,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,gCAAgC;YAE1C,oCAAoC;YACpC,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;YAErC,OAAO,IAAI,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CAAC,QAAgB;QAC1C,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO;QAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;QAC9C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;gBAC3B,OAAO,CAAC,cAAc,GAAG,QAAQ,CAAC;gBAClC,MAAM,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,OAAO,CAAC,cAAc,EAAE;oBAClE,QAAQ,EAAE,EAAE,gBAAgB,EAAE,QAAQ,EAAE;iBACzC,CAAC,CAAC;gBACH,OAAO,CAAC,GAAG,CAAC,sDAAsD,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,cAAuB;QAC3C,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAEhC,sEAAsE;QACtE,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;YAChF,IAAI,eAAe,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,4DAA4D,cAAc,aAAa,CAAC,CAAC;gBACrG,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAC;IACxD,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,SAAS;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;QAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,sBAAsB,IAAI,KAAK,CAAC;QAChE,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,qDAAqD;QAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAElC,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CACjC,GAAG,GAAG,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,WAAW,CAC7C,CAAC;QAEF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,+DAA+D;YAC/D,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;YACpB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YAC1B,6CAA6C;YAC7C,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;gBACxC,MAAM,IAAI,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC7D,OAAO,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;YACzC,CAAC,CAAC,CAAC;YAEH,IAAI,eAAe,EAAE,CAAC;gBACpB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;YACtB,CAAC;YAED,mBAAmB;YACnB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;YACvE,CAAC;YAED,yDAAyD;YACzD,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAChE,IAAI,CAAC,YAAa,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAC9C,CAAC;YAEF,IAAI,IAAI,CAAC,UAAU,IAAI,SAAS,IAAI,kBAAkB,EAAE,CAAC;gBACvD,gEAAgE;gBAChE,OAAO,CAAC,GAAG,CAAC,kCAAkC,IAAI,CAAC,UAAU,uEAAuE,CAAC,CAAC;gBACtI,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACvC,IAAI,CAAC,YAAa,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAC9C,CAAC;gBACF,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;oBAC7B,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;oBAC1C,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;oBAC5C,iCAAiC;oBACjC,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;gBACzD,CAAC;gBACD,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;gBACpB,OAAO;YACT,CAAC;YAED,2CAA2C;YAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;aAAM,IAAI,IAAI,CAAC,sBAAsB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC;YAC/C,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBAC9B,IAAI,CAAC,mBAAmB,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,cAAc,IAAI,IAAI,CAAC;YACjE,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC;YAChF,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;YACpB,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,WAAmB;QAC5C,uCAAuC;QACvC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,IAAI,CAAC,gBAAgB,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAEO,iBAAiB;QACvB,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC9E,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBACxB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,CAAC,GAAG,CAAC,kCAAkC,IAAI,SAAS,CAAC,CAAC;oBAC7D,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBAC/B,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;wBAC1D,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;wBACrC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;oBAC/B,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAE/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,IAAI,CAAC,WAAW,GAAG,KAAK;YAAE,OAAO,KAAK,CAAC;QACjD,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;QAEvB,MAAM,OAAO,GAAG,oEAAoE,CAAC;QACrF,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACvC,KAAK,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,CAAC,YAAY,CAAC,IAAI,6BAA6B,CAAC,CAAC;QAC5F,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,cAAsB;QACvC,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/C,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,0CAA0C,IAAI,mBAAmB,cAAc,GAAG,CAAC,CAAC;gBAChG,KAAK,CAAC,MAAM,EAAE,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACjE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC/B,OAAO;YACT,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,2DAA2D,cAAc,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;OAEG;IACH,IAAI;QACF,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACvC,OAAO,CAAC,GAAG,CAAC,0CAA0C,IAAI,GAAG,CAAC,CAAC;YAC/D,KAAK,CAAC,MAAM,EAAE,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACrC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC/B,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAClC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;CACF"}

package/dist/core/message-queue.d.ts

@@ -0,0 +1,47 @@
+import type { InboundMessage } from '../types/index.js';
+/**
+ * Message queue with delivery acknowledgment.
+ *
+ * Messages are NEVER removed from the queue until the next successful
+ * interaction confirms the prior message was delivered. This ensures
+ * messages survive MCP transport failures, tool rejections, and
+ * connection drops.
+ *
+ * Flow:
+ * 1. Message arrives → pushed to queue, waiter notified (if waiting)
+ * 2. waitForMessage returns the message → message stays in queue, marked as "pending delivery"
+ * 3. Next waitForMessage/checkMessages call → acknowledges prior delivery, removes from queue
+ * 4. If no acknowledgment (connection dropped) → message stays in queue for retry
+ */
+export declare class MessageQueue {
+    private queues;
+    private waiters;
+    private pendingAck;
+    enqueue(sessionId: string, message: InboundMessage): void;
+    /**
+     * Get the next message, acknowledging any previously returned message.
+     * The returned message stays in the queue until the NEXT call acknowledges it.
+     */
+    waitForMessage(sessionId: string, timeoutMs: number): Promise<InboundMessage>;
+    /**
+     * Non-blocking check for all queued messages. Acknowledges any pending delivery.
+     */
+    dequeueAll(sessionId: string): InboundMessage[];
+    /**
+     * Non-blocking peek: returns the first message without consuming it.
+     * Acknowledges any previously delivered message first.
+     * Returns null if no messages are queued.
+     */
+    poll(sessionId: string): InboundMessage | null;
+    /**
+     * Acknowledge that the previously returned message was successfully delivered.
+     * Removes it from the queue.
+     */
+    private acknowledge;
+    clearSession(sessionId: string): void;
+    /**
+     * Get queue size for a session (for debugging)
+     */
+    queueSize(sessionId: string): number;
+}
+//# sourceMappingURL=message-queue.d.ts.map

package/dist/core/message-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-queue.d.ts","sourceRoot":"","sources":["../../src/core/message-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAQxD;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,OAAO,CAAkC;IAEjD,OAAO,CAAC,UAAU,CAAkC;IAEpD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAoBzD;;;OAGG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAuC7E;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IAU/C;;;;OAIG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAW9C;;;OAGG;IACH,OAAO,CAAC,WAAW;IAgBnB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAWrC;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAGrC"}

package/dist/core/message-queue.js

@@ -0,0 +1,139 @@
+/**
+ * Message queue with delivery acknowledgment.
+ *
+ * Messages are NEVER removed from the queue until the next successful
+ * interaction confirms the prior message was delivered. This ensures
+ * messages survive MCP transport failures, tool rejections, and
+ * connection drops.
+ *
+ * Flow:
+ * 1. Message arrives → pushed to queue, waiter notified (if waiting)
+ * 2. waitForMessage returns the message → message stays in queue, marked as "pending delivery"
+ * 3. Next waitForMessage/checkMessages call → acknowledges prior delivery, removes from queue
+ * 4. If no acknowledgment (connection dropped) → message stays in queue for retry
+ */
+export class MessageQueue {
+    queues = new Map();
+    waiters = new Map();
+    // Track the last message ID returned to a caller — acknowledged on next call
+    pendingAck = new Map();
+    enqueue(sessionId, message) {
+        let queue = this.queues.get(sessionId);
+        if (!queue) {
+            queue = [];
+            this.queues.set(sessionId, queue);
+        }
+        queue.push(message);
+        console.log(`[MessageQueue] Enqueued message ${message.id} for session ${sessionId} (queue size: ${queue.length})`);
+        // Wake up waiter if one exists
+        const waiter = this.waiters.get(sessionId);
+        if (waiter) {
+            clearTimeout(waiter.timer);
+            this.waiters.delete(sessionId);
+            // Don't consume — just notify. The waiter's handler will call peek/ack.
+            waiter.resolve(message);
+        }
+    }
+    /**
+     * Get the next message, acknowledging any previously returned message.
+     * The returned message stays in the queue until the NEXT call acknowledges it.
+     */
+    waitForMessage(sessionId, timeoutMs) {
+        // Acknowledge previously returned message
+        this.acknowledge(sessionId);
+        // Check queue for pending messages
+        const queue = this.queues.get(sessionId);
+        if (queue && queue.length > 0) {
+            const message = queue[0]; // Peek, don't shift
+            this.pendingAck.set(sessionId, message.id);
+            console.log(`[MessageQueue] Returning queued message ${message.id} (pending ack, queue size: ${queue.length})`);
+            return Promise.resolve(message);
+        }
+        // Cancel any existing waiter
+        const existing = this.waiters.get(sessionId);
+        if (existing) {
+            clearTimeout(existing.timer);
+            existing.reject(new Error('Superseded by new waiter'));
+        }
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.waiters.delete(sessionId);
+                reject(new Error('Timeout waiting for message'));
+            }, timeoutMs);
+            this.waiters.set(sessionId, {
+                resolve: (message) => {
+                    // Message was just enqueued — peek it without removing
+                    this.pendingAck.set(sessionId, message.id);
+                    console.log(`[MessageQueue] Waiter resolved with message ${message.id} (pending ack)`);
+                    resolve(message);
+                },
+                reject,
+                timer
+            });
+        });
+    }
+    /**
+     * Non-blocking check for all queued messages. Acknowledges any pending delivery.
+     */
+    dequeueAll(sessionId) {
+        this.acknowledge(sessionId);
+        const queue = this.queues.get(sessionId);
+        if (!queue || queue.length === 0)
+            return [];
+        // Return copies and clear queue (check_messages consumes all)
+        const messages = [...queue];
+        queue.length = 0;
+        return messages;
+    }
+    /**
+     * Non-blocking peek: returns the first message without consuming it.
+     * Acknowledges any previously delivered message first.
+     * Returns null if no messages are queued.
+     */
+    poll(sessionId) {
+        this.acknowledge(sessionId);
+        const queue = this.queues.get(sessionId);
+        if (!queue || queue.length === 0)
+            return null;
+        const message = queue[0];
+        this.pendingAck.set(sessionId, message.id);
+        console.log(`[MessageQueue] Poll returned message ${message.id} (pending ack, queue size: ${queue.length})`);
+        return message;
+    }
+    /**
+     * Acknowledge that the previously returned message was successfully delivered.
+     * Removes it from the queue.
+     */
+    acknowledge(sessionId) {
+        const ackId = this.pendingAck.get(sessionId);
+        if (ackId === undefined)
+            return;
+        const queue = this.queues.get(sessionId);
+        if (queue) {
+            const index = queue.findIndex(m => m.id === ackId);
+            if (index !== -1) {
+                queue.splice(index, 1);
+                console.log(`[MessageQueue] Acknowledged and removed message ${ackId} (queue size: ${queue.length})`);
+            }
+        }
+        // Delete pendingAck AFTER removing from queue to prevent stuck messages
+        this.pendingAck.delete(sessionId);
+    }
+    clearSession(sessionId) {
+        this.queues.delete(sessionId);
+        this.pendingAck.delete(sessionId);
+        const waiter = this.waiters.get(sessionId);
+        if (waiter) {
+            clearTimeout(waiter.timer);
+            waiter.reject(new Error('Session cleared'));
+            this.waiters.delete(sessionId);
+        }
+    }
+    /**
+     * Get queue size for a session (for debugging)
+     */
+    queueSize(sessionId) {
+        return this.queues.get(sessionId)?.length || 0;
+    }
+}
+//# sourceMappingURL=message-queue.js.map

package/dist/core/message-queue.js.map

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

package/dist/core/session-manager.d.ts

@@ -0,0 +1,24 @@
+import type { Session } from '../types/index.js';
+export declare class SessionManager {
+    private sessions;
+    private mcpToSession;
+    private conversationToSession;
+    private cleanupTimer;
+    private onSessionCleaned?;
+    constructor(onSessionCleaned?: (session: Session) => void);
+    register(session: Session): void;
+    unregister(sessionId: string): Session | undefined;
+    get(sessionId: string): Session | undefined;
+    getByMcpSessionId(mcpSessionId: string): Session | undefined;
+    getByConversationId(conversationId: number): Session | undefined;
+    getAll(): Session[];
+    touchActivity(sessionId: string): void;
+    /**
+     * Checks that the 3 internal maps are consistent with each other.
+     * Returns true if everything is in sync, false otherwise.
+     */
+    validate(): boolean;
+    private cleanupIdle;
+    destroy(): void;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/core/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/core/session-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAIjD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,qBAAqB,CAAkC;IAC/D,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,gBAAgB,CAAC,CAA6B;gBAE1C,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI;IAKzD,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAMhC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAUlD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI3C,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAK5D,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAKhE,MAAM,IAAI,OAAO,EAAE;IAInB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOtC;;;OAGG;IACH,QAAQ,IAAI,OAAO;IAyDnB,OAAO,CAAC,WAAW;IAcnB,OAAO,IAAI,IAAI;CAShB"}