@iflow-mcp/jkheadley-instar 0.26.2

package/dist/monitoring/OrphanProcessReaper.js

@@ -0,0 +1,476 @@
+/**
+ * OrphanProcessReaper — Detect and clean up orphaned Claude processes.
+ *
+ * Addresses the critical gap where Claude processes spawned outside
+ * SessionManager (setup-wizard, login flow, corrupted state) are invisible
+ * to the watchdog and accumulate indefinitely.
+ *
+ * Classification strategy:
+ *   1. "tracked" — In a tmux session managed by SessionManager → leave alone
+ *   2. "instar-orphan" — In a tmux session matching project naming but not tracked → auto-clean
+ *   3. "external" — Not in a project-prefixed tmux session (user's own Claude, VS Code, etc.) → report only
+ *
+ * Safety: NEVER auto-kills user Claude sessions outside Instar.
+ * External processes are only reported via Telegram for user decision.
+ */
+import { spawnSync } from 'node:child_process';
+import { EventEmitter } from 'node:events';
+/** Drop-in replacement for execSync that avoids its security concerns. */
+function shellExec(cmd, timeout = 5000) {
+    return spawnSync('/bin/sh', ['-c', cmd], { encoding: 'utf-8', timeout }).stdout ?? '';
+}
+const DEFAULT_POLL_INTERVAL = 60_000; // 1 minute
+const DEFAULT_ORPHAN_MAX_AGE = 3_600_000; // 1 hour
+const DEFAULT_EXTERNAL_REPORT_AGE = 14_400_000; // 4 hours
+const DEFAULT_HIGH_MEMORY_MB = 500;
+export class OrphanProcessReaper extends EventEmitter {
+    config;
+    reaperConfig;
+    sessionManager;
+    interval = null;
+    projectPrefix;
+    lastReport = null;
+    reportedExternalPids = new Set(); // Don't spam about same PIDs
+    lastExternalAlertTime = 0; // Cooldown to avoid spamming about normal VS Code/terminal processes
+    static EXTERNAL_ALERT_COOLDOWN_MS = 24 * 60 * 60_000; // 24 hours
+    constructor(config, sessionManager, reaperConfig = {}) {
+        super();
+        this.config = config;
+        this.sessionManager = sessionManager;
+        this.reaperConfig = reaperConfig;
+        // Project prefix used in tmux session naming (e.g., "the-portal-")
+        this.projectPrefix = `${config.projectName}-`;
+    }
+    start() {
+        if (this.interval)
+            return;
+        const pollMs = this.reaperConfig.pollIntervalMs ?? DEFAULT_POLL_INTERVAL;
+        console.log(`[OrphanReaper] Starting (poll: ${pollMs / 1000}s, orphan max age: ${(this.reaperConfig.orphanMaxAgeMs ?? DEFAULT_ORPHAN_MAX_AGE) / 60000}m)`);
+        this.interval = setInterval(() => this.poll(), pollMs);
+        // First check after 10 seconds (let other systems initialize)
+        setTimeout(() => this.poll(), 10_000);
+    }
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+    }
+    getLastReport() {
+        return this.lastReport;
+    }
+    /**
+     * Run a scan immediately and return the report.
+     * Can be called on-demand via API endpoints.
+     */
+    async scan() {
+        return this.poll();
+    }
+    // ── Core Poll ──────────────────────────────────────────────────────
+    async poll() {
+        const claudeProcesses = this.findAllClaudeProcesses();
+        const tmuxSessions = this.listAllTmuxSessions();
+        const trackedSessions = this.getTrackedSessionNames();
+        const classified = this.classifyProcesses(claudeProcesses, tmuxSessions, trackedSessions);
+        const tracked = classified.filter(p => p.classification === 'tracked');
+        const orphans = classified.filter(p => p.classification === 'instar-orphan');
+        const external = classified.filter(p => p.classification === 'external');
+        const report = {
+            timestamp: new Date().toISOString(),
+            tracked,
+            orphans,
+            external,
+            totalMemoryMB: Math.round(classified.reduce((sum, p) => sum + p.rssKB, 0) / 1024),
+            orphanMemoryMB: Math.round(orphans.reduce((sum, p) => sum + p.rssKB, 0) / 1024),
+            externalMemoryMB: Math.round(external.reduce((sum, p) => sum + p.rssKB, 0) / 1024),
+            actionsPerformed: [],
+        };
+        // Handle orphans
+        const orphanMaxAge = this.reaperConfig.orphanMaxAgeMs ?? DEFAULT_ORPHAN_MAX_AGE;
+        const autoKill = this.reaperConfig.autoKillOrphans !== false; // default true
+        for (const orphan of orphans) {
+            if (orphan.elapsedMs > orphanMaxAge && autoKill) {
+                this.killProcess(orphan.pid);
+                // Also kill the tmux session if it exists
+                if (orphan.tmuxSession) {
+                    this.killTmuxSession(orphan.tmuxSession);
+                }
+                const msg = `Killed orphan PID ${orphan.pid} (${Math.round(orphan.rssKB / 1024)}MB, running ${this.formatDuration(orphan.elapsedMs)}, tmux: ${orphan.tmuxSession || 'none'})`;
+                report.actionsPerformed.push(msg);
+                console.log(`[OrphanReaper] ${msg}`);
+            }
+        }
+        // Report high-memory or old external processes (but don't auto-kill)
+        const externalReportAge = this.reaperConfig.externalReportAgeMs ?? DEFAULT_EXTERNAL_REPORT_AGE;
+        const highMemMB = this.reaperConfig.highMemoryThresholdMB ?? DEFAULT_HIGH_MEMORY_MB;
+        const alertCallback = this.reaperConfig.alertCallback;
+        const newExternalAlerts = [];
+        for (const ext of external) {
+            const isOld = ext.elapsedMs > externalReportAge;
+            const isHighMem = ext.rssKB / 1024 > highMemMB;
+            const alreadyReported = this.reportedExternalPids.has(ext.pid);
+            if ((isOld || isHighMem) && !alreadyReported) {
+                newExternalAlerts.push(ext);
+                this.reportedExternalPids.add(ext.pid);
+            }
+        }
+        // Clean up reported PIDs for processes that no longer exist
+        for (const pid of this.reportedExternalPids) {
+            if (!external.some(p => p.pid === pid)) {
+                this.reportedExternalPids.delete(pid);
+            }
+        }
+        // Send alert about external processes if any are notable.
+        // Cooldown: only alert once per 24h — external processes are usually normal
+        // (VS Code, terminal sessions) and constant alerts are noise.
+        const reportExternal = this.reaperConfig.reportExternalProcesses !== false;
+        const now = Date.now();
+        const externalAlertCooledDown = now - this.lastExternalAlertTime > OrphanProcessReaper.EXTERNAL_ALERT_COOLDOWN_MS;
+        if (reportExternal && newExternalAlerts.length > 0 && alertCallback && externalAlertCooledDown) {
+            const totalExternal = external.length;
+            const totalMemMB = Math.round(external.reduce((sum, p) => sum + p.rssKB, 0) / 1024);
+            const processWord = totalExternal === 1 ? 'process' : 'processes';
+            const msg = `Found ${totalExternal} Claude ${processWord} running outside your agent (using ${totalMemMB}MB of memory). This is usually from VS Code or a terminal session you have open — no action needed if that's the case.\n\nIf you're not actively using Claude elsewhere, reply "clean processes" to free up the memory.`;
+            try {
+                await alertCallback(msg);
+                this.lastExternalAlertTime = now;
+                report.actionsPerformed.push(`Reported ${totalExternal} external process(es) to user`);
+            }
+            catch (err) {
+                console.error('[OrphanReaper] Failed to send alert:', err);
+            }
+        }
+        // Alert about orphan kills
+        if (report.actionsPerformed.length > 0 && alertCallback) {
+            const orphanKills = report.actionsPerformed.filter(a => a.startsWith('Killed orphan'));
+            if (orphanKills.length > 0) {
+                const processWord = orphanKills.length === 1 ? 'process' : 'processes';
+                const msg = `Cleaned up ${orphanKills.length} orphaned ${processWord} that were left over from previous agent sessions, freeing ~${report.orphanMemoryMB}MB of memory. No action needed — this is automatic maintenance.`;
+                try {
+                    await alertCallback(msg);
+                }
+                catch (err) {
+                    console.error('[OrphanReaper] Failed to send orphan alert:', err);
+                }
+            }
+        }
+        this.lastReport = report;
+        this.emit('scan', report);
+        return report;
+    }
+    // ── Process Discovery ──────────────────────────────────────────────
+    /**
+     * Find ALL Claude processes owned by the current user.
+     * Uses `ps` to get PID, PPID, RSS, elapsed time, and command.
+     */
+    findAllClaudeProcesses() {
+        try {
+            // Find all processes named "claude" owned by current user
+            // Use ps with custom format for reliable parsing
+            const uid = process.getuid?.() ?? 0;
+            const output = shellExec(`ps -u ${uid} -o pid=,ppid=,rss=,etime=,command= 2>/dev/null | grep -i '[c]laude' | grep -v grep`, 10_000).trim();
+            if (!output)
+                return [];
+            const processes = [];
+            for (const line of output.split('\n')) {
+                const match = line.trim().match(/^(\d+)\s+(\d+)\s+(\d+)\s+([\d:.-]+)\s+(.+)$/);
+                if (!match)
+                    continue;
+                const pid = parseInt(match[1], 10);
+                const ppid = parseInt(match[2], 10);
+                const rssKB = parseInt(match[3], 10);
+                const elapsed = this.parseElapsed(match[4]);
+                const command = match[5];
+                // Skip the instar server process itself
+                if (command.includes('instar') && command.includes('server'))
+                    continue;
+                // Only count actual Claude Code processes (not helpers, MCP servers, etc.)
+                if (!this.isClaudeCodeProcess(command))
+                    continue;
+                processes.push({
+                    pid,
+                    ppid,
+                    rssKB,
+                    elapsedMs: elapsed,
+                    command: command.slice(0, 300),
+                    tmuxSession: null, // Will be resolved in classification
+                });
+            }
+            return processes;
+        }
+        catch { // @silent-fallback-ok — process listing may fail if ps is unavailable
+            return [];
+        }
+    }
+    /**
+     * Determine if a command is an actual Claude Code session (not an MCP server, etc.)
+     */
+    isClaudeCodeProcess(command) {
+        // Actual Claude Code CLI invocations
+        if (command.includes('claude') && !command.includes('claude-')) {
+            // Exclude MCP servers, helpers, etc.
+            const exclusions = [
+                'claude-in-chrome', 'claude-mcp', 'playwright-mcp',
+                'mcp-remote', 'exa-mcp', 'payments-mcp',
+            ];
+            return !exclusions.some(e => command.includes(e));
+        }
+        // node running Claude Code
+        if (command.includes('node') && command.includes('claude')) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * List all tmux sessions and map pane PIDs to session names.
+     */
+    listAllTmuxSessions() {
+        const pidToSession = new Map();
+        try {
+            const output = shellExec(`${this.config.sessions.tmuxPath} list-panes -a -F "#{session_name}||#{pane_pid}" 2>/dev/null`).trim();
+            if (!output)
+                return pidToSession;
+            for (const line of output.split('\n')) {
+                const [sessionName, pidStr] = line.split('||');
+                if (sessionName && pidStr) {
+                    const pid = parseInt(pidStr, 10);
+                    if (!isNaN(pid)) {
+                        pidToSession.set(pid, sessionName);
+                    }
+                }
+            }
+        }
+        catch {
+            // tmux not running or no sessions
+        }
+        return pidToSession;
+    }
+    /**
+     * Get tmux session names tracked by SessionManager.
+     */
+    getTrackedSessionNames() {
+        const running = this.sessionManager.listRunningSessions();
+        return new Set(running.map(s => s.tmuxSession));
+    }
+    // ── Classification ─────────────────────────────────────────────────
+    /**
+     * Classify each Claude process:
+     *   - tracked: In a tmux session managed by SessionManager
+     *   - instar-orphan: In a project-prefixed tmux session NOT tracked by SessionManager
+     *   - external: Everything else (user sessions, VS Code, etc.)
+     */
+    classifyProcesses(processes, tmuxSessions, trackedSessions) {
+        return processes.map(proc => {
+            // Resolve which tmux session this process belongs to
+            // Check if this PID or its parent is a tmux pane
+            const directSession = tmuxSessions.get(proc.pid);
+            const parentSession = tmuxSessions.get(proc.ppid);
+            // Also check grandparent — Claude spawns under node which is under tmux pane
+            const grandparentPid = this.getParentPid(proc.ppid);
+            const grandparentSession = grandparentPid ? tmuxSessions.get(grandparentPid) : null;
+            const tmuxSession = directSession || parentSession || grandparentSession || null;
+            proc.tmuxSession = tmuxSession;
+            if (tmuxSession) {
+                // In a tmux session — is it tracked?
+                if (trackedSessions.has(tmuxSession)) {
+                    return {
+                        ...proc,
+                        classification: 'tracked',
+                        reason: `Managed by SessionManager in tmux "${tmuxSession}"`,
+                    };
+                }
+                // In a tmux session matching our project prefix but NOT tracked
+                if (tmuxSession.startsWith(this.projectPrefix)) {
+                    return {
+                        ...proc,
+                        classification: 'instar-orphan',
+                        reason: `In project-prefixed tmux "${tmuxSession}" but not tracked by SessionManager`,
+                    };
+                }
+                // In some other tmux session — likely user's own
+                return {
+                    ...proc,
+                    classification: 'external',
+                    reason: `In tmux session "${tmuxSession}" (not project-prefixed)`,
+                };
+            }
+            // Not in any tmux session — could be VS Code, terminal, or spawn()-based orphan
+            const parentCommand = this.getProcessCommand(proc.ppid);
+            // VS Code spawns Claude via its integrated terminal
+            if (parentCommand && (parentCommand.includes('code') ||
+                parentCommand.includes('Code Helper') ||
+                parentCommand.includes('Electron') ||
+                parentCommand.includes('cursor') ||
+                parentCommand.includes('windsurf'))) {
+                return {
+                    ...proc,
+                    classification: 'external',
+                    reason: `Spawned by IDE (parent: ${parentCommand.slice(0, 80)})`,
+                };
+            }
+            // Terminal.app, iTerm, Warp, etc.
+            if (parentCommand && (parentCommand.includes('Terminal') ||
+                parentCommand.includes('iTerm') ||
+                parentCommand.includes('Warp') ||
+                parentCommand.includes('Alacritty') ||
+                parentCommand.includes('kitty') ||
+                parentCommand.includes('zsh') ||
+                parentCommand.includes('bash'))) {
+                return {
+                    ...proc,
+                    classification: 'external',
+                    reason: `Spawned by terminal (parent: ${parentCommand.slice(0, 80)})`,
+                };
+            }
+            // Non-tmux, non-IDE process — might be a spawn() orphan from Instar
+            // (e.g., setup-wizard). If it's old, classify as orphan.
+            const orphanAge = this.reaperConfig.orphanMaxAgeMs ?? DEFAULT_ORPHAN_MAX_AGE;
+            if (proc.elapsedMs > orphanAge) {
+                return {
+                    ...proc,
+                    classification: 'external',
+                    reason: `Non-tmux process with unknown parent (pid ${proc.ppid}: ${(parentCommand || 'unknown').slice(0, 60)}). Old but cannot confirm Instar origin — reporting as external for safety.`,
+                };
+            }
+            // Recent non-tmux process — assume external (user just started it)
+            return {
+                ...proc,
+                classification: 'external',
+                reason: `Non-tmux process, parent: ${(parentCommand || 'unknown').slice(0, 80)}`,
+            };
+        });
+    }
+    // ── Process Utilities ──────────────────────────────────────────────
+    getParentPid(pid) {
+        try {
+            const output = shellExec(`ps -o ppid= -p ${pid} 2>/dev/null`).trim();
+            const ppid = parseInt(output, 10);
+            return isNaN(ppid) ? null : ppid;
+        }
+        catch { // @silent-fallback-ok — process may not exist
+            return null;
+        }
+    }
+    getProcessCommand(pid) {
+        try {
+            const output = shellExec(`ps -o command= -p ${pid} 2>/dev/null`).trim();
+            return output || null;
+        }
+        catch { // @silent-fallback-ok — process may not exist
+            return null;
+        }
+    }
+    killProcess(pid) {
+        try {
+            process.kill(pid, 'SIGTERM');
+            // Give it 5 seconds, then SIGKILL if needed
+            setTimeout(() => {
+                try {
+                    process.kill(pid, 0); // Check if still alive
+                    process.kill(pid, 'SIGKILL');
+                    console.log(`[OrphanReaper] SIGKILL sent to PID ${pid} (SIGTERM wasn't enough)`);
+                }
+                catch { // @silent-fallback-ok — process already dead (expected)
+                    // Already dead — good
+                }
+            }, 5000);
+            return true;
+        }
+        catch (err) { // @silent-fallback-ok — kill may fail if process already exited
+            if (err.code !== 'ESRCH') {
+                console.error(`[OrphanReaper] Failed to kill PID ${pid}:`, err);
+            }
+            return false;
+        }
+    }
+    killTmuxSession(sessionName) {
+        try {
+            shellExec(`${this.config.sessions.tmuxPath} kill-session -t "=${sessionName}" 2>/dev/null`);
+        }
+        catch {
+            // Already dead
+        }
+    }
+    /**
+     * Manually kill an external process by PID.
+     * Called via user command (e.g., "clean 12345").
+     */
+    killExternalProcess(pid) {
+        const report = this.lastReport;
+        if (!report) {
+            return { success: false, message: 'No scan report available. Run a scan first.' };
+        }
+        const process = report.external.find(p => p.pid === pid);
+        if (!process) {
+            return { success: false, message: `PID ${pid} is not in the external process list.` };
+        }
+        const killed = this.killProcess(pid);
+        if (process.tmuxSession) {
+            this.killTmuxSession(process.tmuxSession);
+        }
+        return {
+            success: killed,
+            message: killed
+                ? `Killed PID ${pid} (${Math.round(process.rssKB / 1024)}MB, ${process.reason})`
+                : `Failed to kill PID ${pid}`,
+        };
+    }
+    /**
+     * Kill all external processes. User-initiated only.
+     */
+    killAllExternal() {
+        const report = this.lastReport;
+        if (!report) {
+            return { killed: 0, freedMB: 0, details: ['No scan report available.'] };
+        }
+        const details = [];
+        let freedKB = 0;
+        for (const proc of report.external) {
+            const killed = this.killProcess(proc.pid);
+            if (proc.tmuxSession) {
+                this.killTmuxSession(proc.tmuxSession);
+            }
+            if (killed) {
+                freedKB += proc.rssKB;
+                details.push(`Killed PID ${proc.pid} (${Math.round(proc.rssKB / 1024)}MB)`);
+            }
+        }
+        return {
+            killed: details.length,
+            freedMB: Math.round(freedKB / 1024),
+            details,
+        };
+    }
+    // ── Parsing Utilities ──────────────────────────────────────────────
+    parseElapsed(elapsed) {
+        // Format: [[DD-]HH:]MM:SS or just MM:SS
+        let days = 0;
+        let timePart = elapsed;
+        if (elapsed.includes('-')) {
+            const [d, t] = elapsed.split('-');
+            days = parseInt(d, 10);
+            timePart = t;
+        }
+        const parts = timePart.split(':').map(Number);
+        let seconds = 0;
+        if (parts.length === 3)
+            seconds = parts[0] * 3600 + parts[1] * 60 + parts[2];
+        else if (parts.length === 2)
+            seconds = parts[0] * 60 + parts[1];
+        else
+            seconds = parts[0];
+        return (days * 86400 + seconds) * 1000;
+    }
+    formatDuration(ms) {
+        const hours = Math.floor(ms / 3_600_000);
+        const minutes = Math.floor((ms % 3_600_000) / 60_000);
+        if (hours > 24) {
+            const days = Math.floor(hours / 24);
+            return `${days}d ${hours % 24}h`;
+        }
+        if (hours > 0)
+            return `${hours}h ${minutes}m`;
+        return `${minutes}m`;
+    }
+}
+//# sourceMappingURL=OrphanProcessReaper.js.map

package/dist/monitoring/OrphanProcessReaper.js.map

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

package/dist/monitoring/PresenceProxy.d.ts

@@ -0,0 +1,167 @@
+/**
+ * PresenceProxy — Intelligent Response Standby
+ *
+ * Monitors the gap between user messages and agent responses on Telegram,
+ * providing tiered, LLM-generated status updates on the agent's behalf.
+ *
+ * Tier 1 (20s):  Haiku summarizes what the agent is doing
+ * Tier 2 (2min): Haiku compares progress since Tier 1
+ * Tier 3 (5min): Sonnet assesses if the agent is genuinely stuck
+ *
+ * All messages prefixed with 🔭 [Standby] to distinguish from agent responses.
+ * Proxy messages do NOT count as agent responses for StallDetector.
+ */
+import type { IntelligenceProvider } from '../core/types.js';
+import type { MessageLoggedEvent } from '../messaging/shared/MessagingEventBus.js';
+export interface PresenceProxyConfig {
+    stateDir: string;
+    intelligence: IntelligenceProvider;
+    agentName: string;
+    captureSessionOutput: (sessionName: string, lines?: number) => string | null;
+    getSessionForTopic: (topicId: number) => string | null;
+    isSessionAlive: (sessionName: string) => boolean;
+    sendMessage: (topicId: number, text: string, metadata?: ProxyMetadata) => Promise<void>;
+    getAuthorizedUserIds: () => number[];
+    getProcessTree: (sessionName: string) => ProcessInfo[];
+    /** Check if agent sent any message to this topic after the given timestamp. Prevents race conditions. */
+    hasAgentRespondedSince?: (topicId: number, sinceMs: number) => boolean;
+    acquireTriageMutex?: (sessionName: string, holder: string) => boolean;
+    releaseTriageMutex?: (sessionName: string, holder: string) => void;
+    isTriageMutexHeld?: (sessionName: string) => string | null;
+    triggerManualTriage?: (topicId: number, sessionName: string) => Promise<void>;
+    tier1DelayMs?: number;
+    tier2DelayMs?: number;
+    tier3DelayMs?: number;
+    tier3RecheckDelayMs?: number;
+    silenceDurationMs?: number;
+    tier1Model?: 'fast' | 'balanced' | 'capable';
+    tier2Model?: 'fast' | 'balanced' | 'capable';
+    tier3Model?: 'fast' | 'balanced' | 'capable';
+    maxTmuxLines?: {
+        t1: number;
+        t2: number;
+        t3: number;
+    };
+    llmTimeoutMs?: {
+        t1: number;
+        t2: number;
+        t3: number;
+    };
+    llmRateLimit?: {
+        perTopicPerHour: number;
+        tier3MaxRechecks: number;
+        autoSilenceMinutes: number;
+    };
+    concurrentLlmCalls?: number;
+    allowExternalLlm?: boolean;
+    credentialPatterns?: string[];
+    prefix?: string;
+    conversationHistoryMax?: number;
+    __dev_timerMultiplier?: number;
+}
+export interface ProxyMetadata {
+    source: 'presence-proxy';
+    tier: number;
+    isProxy: true;
+}
+export interface ProcessInfo {
+    pid: number;
+    command: string;
+    elapsed?: string;
+}
+interface PresenceState {
+    topicId: number;
+    sessionName: string;
+    userMessageAt: number;
+    userMessageText: string;
+    tier1FiredAt: number | null;
+    tier1Snapshot: string | null;
+    tier1SnapshotHash: string | null;
+    tier2FiredAt: number | null;
+    tier2Snapshot: string | null;
+    tier2SnapshotHash: string | null;
+    tier3FiredAt: number | null;
+    tier3Assessment: 'working' | 'waiting' | 'stalled' | 'dead' | null;
+    tier3Summary: string | null;
+    tier3RecheckCount: number;
+    silencedUntil: number | null;
+    cancelled: boolean;
+    llmCallCount: number;
+    lastLlmCallAt: number;
+    conversationHistory: Array<{
+        role: 'user' | 'proxy';
+        text: string;
+        timestamp: number;
+    }>;
+}
+export declare function sanitizeTmuxOutput(raw: string, extraPatterns?: string[]): string;
+export declare function guardProxyOutput(text: string): {
+    safe: boolean;
+    reason?: string;
+};
+/**
+ * Check if terminal output indicates quota exhaustion.
+ * Returns a human-friendly message if detected, null otherwise.
+ *
+ * Only checks the LAST 15 lines of the snapshot to avoid false positives
+ * from historical quota errors that the session already recovered from.
+ * Quota errors are terminal — if the session recovered and kept working,
+ * the error scrolls up and out of the recent window.
+ */
+export declare function detectQuotaExhaustion(snapshot: string): string | null;
+export declare class PresenceProxy {
+    private config;
+    private states;
+    private timers;
+    private llmQueue;
+    private stateDir;
+    private started;
+    private tier1DelayMs;
+    private tier2DelayMs;
+    private tier3DelayMs;
+    private tier3RecheckDelayMs;
+    private silenceDurationMs;
+    private prefix;
+    private maxConversationHistory;
+    private rateLimit;
+    constructor(config: PresenceProxyConfig);
+    start(): void;
+    stop(): void;
+    /**
+     * Called when a message is logged. Starts/resets timers for user messages,
+     * cancels proxy for agent messages.
+     */
+    onMessageLogged(event: MessageLoggedEvent): void;
+    /**
+     * Handle user commands: unstick, restart, quiet, resume
+     */
+    handleCommand(topicId: number, command: string, userId: number): Promise<boolean>;
+    private handleUserMessage;
+    private handleAgentMessage;
+    private scheduleTier;
+    private fireTier;
+    private fireTier1;
+    private fireTier2;
+    private fireTier3;
+    private handleQuiet;
+    private handleResume;
+    private handleUnstick;
+    private handleRestart;
+    private buildTier1Prompt;
+    private buildConversationPrompt;
+    private buildTier2Prompt;
+    private buildTier3Prompt;
+    private callLlm;
+    private sendProxyMessage;
+    /** System/delivery messages that should NOT be treated as real agent responses */
+    private isSystemMessage;
+    private checkRateLimit;
+    private clearTimersForTopic;
+    private cleanupState;
+    private persistState;
+    private recoverFromRestart;
+    getState(topicId: number): PresenceState | undefined;
+    getActiveTopics(): number[];
+}
+export {};
+//# sourceMappingURL=PresenceProxy.d.ts.map