@iflow-mcp/jkheadley-instar 0.26.2

package/dist/monitoring/SessionWatchdog.js

@@ -0,0 +1,549 @@
+/**
+ * SessionWatchdog — Auto-remediation for stuck Claude sessions (Instar port).
+ *
+ * Detects when a Claude session has a long-running bash command and escalates
+ * from gentle (Ctrl+C) to forceful (SIGKILL + session kill). Adapted from
+ * Dawn Server's SessionWatchdog for Instar's self-contained architecture.
+ *
+ * Escalation pipeline:
+ *   Level 0: Monitoring (default)
+ *   Level 1: Ctrl+C via tmux send-keys
+ *   Level 2: SIGTERM the stuck child PID
+ *   Level 3: SIGKILL the stuck child PID
+ *   Level 4: Kill tmux session
+ */
+import { spawnSync } from 'node:child_process';
+import { EventEmitter } from 'node:events';
+import fs from 'node:fs';
+import path from 'node:path';
+import { maybeRotateJsonl } from '../utils/jsonl-rotation.js';
+/** 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 ?? '';
+}
+export var EscalationLevel;
+(function (EscalationLevel) {
+    EscalationLevel[EscalationLevel["Monitoring"] = 0] = "Monitoring";
+    EscalationLevel[EscalationLevel["CtrlC"] = 1] = "CtrlC";
+    EscalationLevel[EscalationLevel["SigTerm"] = 2] = "SigTerm";
+    EscalationLevel[EscalationLevel["SigKill"] = 3] = "SigKill";
+    EscalationLevel[EscalationLevel["KillSession"] = 4] = "KillSession";
+})(EscalationLevel || (EscalationLevel = {}));
+// Processes that are long-running by design
+const EXCLUDED_PATTERNS = [
+    'playwright-mcp', 'playwright-persistent', '@playwright/mcp',
+    'chrome-native-host', 'claude-in-chrome-mcp', 'payments-mcp',
+    'mcp-remote', '/mcp/', '.mcp/', 'caffeinate', 'exa-mcp-server',
+    // Shell-snapshot sourcing is session initialization, not a stuck command
+    '.claude/shell-snapshots',
+];
+const EXCLUDED_PREFIXES = [
+    '/bin/zsh -c -l source',
+    '/bin/bash -c -l source',
+    // Shell-snapshot commands don't always include -l flag
+    '/bin/zsh -c source',
+    '/bin/bash -c source',
+];
+// Escalation delays (ms to wait before advancing to next level)
+const ESCALATION_DELAYS = {
+    [EscalationLevel.Monitoring]: 0,
+    [EscalationLevel.CtrlC]: 0,
+    [EscalationLevel.SigTerm]: 15_000,
+    [EscalationLevel.SigKill]: 10_000,
+    [EscalationLevel.KillSession]: 5_000,
+};
+const DEFAULT_STUCK_THRESHOLD_MS = 180_000; // 3 minutes
+const DEFAULT_POLL_INTERVAL_MS = 30_000;
+const MAX_RETRIES = 2;
+export class SessionWatchdog extends EventEmitter {
+    config;
+    sessionManager;
+    state;
+    interval = null;
+    escalationState = new Map();
+    interventionHistory = [];
+    enabled = true;
+    running = false;
+    stuckThresholdMs;
+    pollIntervalMs;
+    logPath;
+    /** Intelligence provider — gates escalation entry with LLM command analysis */
+    intelligence = null;
+    /** Temporarily exempted commands (LLM confirmed as legitimate long-running) */
+    temporaryExclusions = new Set(); // PIDs
+    /** Counter for LLM gate overrides (said "legitimate") — for telemetry */
+    llmGateOverrides = 0;
+    /** Pending outcome checks — maps sessionName to intervention event */
+    pendingOutcomeChecks = new Map();
+    constructor(config, sessionManager, state) {
+        super();
+        this.config = config;
+        this.sessionManager = sessionManager;
+        this.state = state;
+        const wdConfig = config.monitoring.watchdog;
+        this.stuckThresholdMs = (wdConfig?.stuckCommandSec ?? 180) * 1000;
+        this.pollIntervalMs = wdConfig?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+        // Persistent log path
+        this.logPath = path.join(config.stateDir, 'watchdog-interventions.jsonl');
+    }
+    start() {
+        if (this.interval)
+            return;
+        console.log(`[Watchdog] Starting (poll: ${this.pollIntervalMs / 1000}s, threshold: ${this.stuckThresholdMs / 1000}s)`);
+        this.interval = setInterval(() => this.poll(), this.pollIntervalMs);
+        setTimeout(() => this.poll(), 5000);
+    }
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+    }
+    setEnabled(enabled) {
+        this.enabled = enabled;
+        if (!enabled) {
+            this.escalationState.clear();
+        }
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    isManaging(sessionName) {
+        const s = this.escalationState.get(sessionName);
+        return s !== undefined && s.level > EscalationLevel.Monitoring;
+    }
+    getStatus() {
+        const runningSessions = this.sessionManager.listRunningSessions();
+        const sessions = runningSessions.map(s => ({
+            name: s.tmuxSession,
+            escalation: this.escalationState.get(s.tmuxSession) ?? null,
+        }));
+        return {
+            enabled: this.enabled,
+            sessions,
+            interventionHistory: this.interventionHistory.slice(-20),
+        };
+    }
+    // --- Core polling ---
+    async poll() {
+        if (!this.enabled || this.running)
+            return;
+        this.running = true;
+        try {
+            const sessions = this.sessionManager.listRunningSessions();
+            for (const session of sessions) {
+                try {
+                    await this.checkSession(session.tmuxSession);
+                }
+                catch (err) {
+                    console.error(`[Watchdog] Error checking "${session.tmuxSession}":`, err);
+                }
+            }
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    async checkSession(tmuxSession) {
+        const existing = this.escalationState.get(tmuxSession);
+        if (existing && existing.level > EscalationLevel.Monitoring) {
+            this.handleEscalation(tmuxSession, existing);
+            return;
+        }
+        // Find Claude PID in the tmux session
+        const claudePid = this.getClaudePid(tmuxSession);
+        if (!claudePid)
+            return;
+        const children = this.getChildProcesses(claudePid);
+        const stuckChild = children.find(c => !this.isExcluded(c.command) &&
+            !this.temporaryExclusions.has(c.pid) &&
+            c.elapsedMs > this.stuckThresholdMs);
+        if (stuckChild) {
+            // LLM gate: check if this command is legitimately long-running before escalating
+            const isStuck = await this.isCommandStuck(stuckChild.command, stuckChild.elapsedMs);
+            if (!isStuck) {
+                // LLM says legitimate — temporarily exclude this PID from future checks
+                this.temporaryExclusions.add(stuckChild.pid);
+                return;
+            }
+            const state = {
+                level: EscalationLevel.CtrlC,
+                levelEnteredAt: Date.now(),
+                stuckChildPid: stuckChild.pid,
+                stuckCommand: stuckChild.command,
+                retryCount: existing?.retryCount ?? 0,
+            };
+            this.escalationState.set(tmuxSession, state);
+            console.log(`[Watchdog] "${tmuxSession}": stuck command (${Math.round(stuckChild.elapsedMs / 1000)}s): ` +
+                `${stuckChild.command.slice(0, 80)} — sending Ctrl+C`);
+            this.sessionManager.sendKey(tmuxSession, 'C-c');
+            this.recordIntervention(tmuxSession, EscalationLevel.CtrlC, 'Sent Ctrl+C', stuckChild);
+        }
+        else if (existing) {
+            this.escalationState.delete(tmuxSession);
+        }
+        // Clean up temporary exclusions for dead processes
+        for (const pid of this.temporaryExclusions) {
+            if (!this.isProcessAlive(pid)) {
+                this.temporaryExclusions.delete(pid);
+            }
+        }
+    }
+    handleEscalation(tmuxSession, state) {
+        const now = Date.now();
+        if (!this.isProcessAlive(state.stuckChildPid)) {
+            console.log(`[Watchdog] "${tmuxSession}": stuck process ${state.stuckChildPid} died — recovered`);
+            this.emit('recovery', tmuxSession, state.level);
+            this.escalationState.delete(tmuxSession);
+            return;
+        }
+        const timeInLevel = now - state.levelEnteredAt;
+        const nextLevel = state.level + 1;
+        if (nextLevel > EscalationLevel.KillSession) {
+            if (state.retryCount >= MAX_RETRIES) {
+                console.log(`[Watchdog] "${tmuxSession}": max retries reached — giving up`);
+                this.escalationState.delete(tmuxSession);
+                return;
+            }
+            state.level = EscalationLevel.CtrlC;
+            state.levelEnteredAt = now;
+            state.retryCount++;
+            this.sessionManager.sendKey(tmuxSession, 'C-c');
+            this.recordIntervention(tmuxSession, EscalationLevel.CtrlC, `Retry ${state.retryCount}: Sent Ctrl+C`, {
+                pid: state.stuckChildPid, command: state.stuckCommand, elapsedMs: 0,
+            });
+            return;
+        }
+        const delayForNext = ESCALATION_DELAYS[nextLevel] ?? 15_000;
+        if (timeInLevel < delayForNext)
+            return;
+        state.level = nextLevel;
+        state.levelEnteredAt = now;
+        const child = { pid: state.stuckChildPid, command: state.stuckCommand, elapsedMs: 0 };
+        switch (state.level) {
+            case EscalationLevel.SigTerm:
+                console.log(`[Watchdog] "${tmuxSession}": sending SIGTERM to ${state.stuckChildPid}`);
+                this.sendSignal(state.stuckChildPid, 'SIGTERM');
+                this.recordIntervention(tmuxSession, EscalationLevel.SigTerm, `SIGTERM ${state.stuckChildPid}`, child);
+                break;
+            case EscalationLevel.SigKill:
+                console.log(`[Watchdog] "${tmuxSession}": sending SIGKILL to ${state.stuckChildPid}`);
+                this.sendSignal(state.stuckChildPid, 'SIGKILL');
+                this.recordIntervention(tmuxSession, EscalationLevel.SigKill, `SIGKILL ${state.stuckChildPid}`, child);
+                break;
+            case EscalationLevel.KillSession:
+                console.log(`[Watchdog] "${tmuxSession}": killing tmux session`);
+                this.killTmuxSession(tmuxSession);
+                this.recordIntervention(tmuxSession, EscalationLevel.KillSession, 'Killed tmux session', child);
+                this.escalationState.delete(tmuxSession);
+                break;
+        }
+    }
+    /**
+     * LLM gate: Before entering escalation, ask whether the command is
+     * legitimately long-running or actually stuck. This prevents the watchdog
+     * from killing legitimate builds, installs, or data processing.
+     *
+     * Returns true if the command appears stuck and should be escalated.
+     * Returns false if the LLM thinks it's a legitimate long-running task.
+     * If no LLM is available, returns true (fail-open — stuck commands need recovery).
+     */
+    async isCommandStuck(command, elapsedMs) {
+        if (!this.intelligence)
+            return true; // No LLM → fail-open
+        const elapsedMin = Math.round(elapsedMs / 60000);
+        const prompt = [
+            'You are evaluating whether a running process is stuck or legitimately long-running.',
+            '',
+            `Command: ${command.slice(0, 200)}`,
+            `Running for: ${elapsedMin} minutes`,
+            '',
+            'Legitimate long-running commands include:',
+            '- Package installs (npm install, pip install, cargo build, etc.)',
+            '- Large builds (webpack, tsc with many files, docker build)',
+            '- Database migrations or data processing',
+            '- Test suites (pytest, vitest, jest with many tests)',
+            '- Network operations (curl large files, git clone large repos)',
+            '- Interactive processes (vim, less, ssh sessions)',
+            '',
+            'Likely stuck commands include:',
+            '- Simple commands that should complete in seconds (ls, cat, echo)',
+            '- Commands with no output that normally produce output quickly',
+            '- Processes that appear to be waiting for input that will never come',
+            '',
+            'Is this command stuck or legitimate? Respond with exactly one word: stuck or legitimate.',
+        ].join('\n');
+        try {
+            const response = await this.intelligence.evaluate(prompt, {
+                maxTokens: 5,
+                temperature: 0,
+            });
+            const answer = response.trim().toLowerCase();
+            if (answer === 'legitimate') {
+                console.log(`[Watchdog] LLM says "${command.slice(0, 60)}" is legitimate — skipping escalation`);
+                this.llmGateOverrides++;
+                return false;
+            }
+            return true;
+        }
+        catch (err) {
+            // @silent-fallback-ok — LLM intelligence is optional; fail-open to recover stuck processes
+            console.warn(`[Watchdog] LLM command check failed, assuming stuck:`, err);
+            return true; // Fail-open
+        }
+    }
+    // --- Process utilities (self-contained, no shared module) ---
+    getClaudePid(tmuxSession) {
+        try {
+            // Get pane PID
+            const panePidStr = shellExec(`${this.config.sessions.tmuxPath} list-panes -t "=${tmuxSession}" -F "#{pane_pid}" 2>/dev/null`).trim().split('\n')[0];
+            if (!panePidStr)
+                return null;
+            const panePid = parseInt(panePidStr, 10);
+            if (isNaN(panePid))
+                return null;
+            // Find claude child
+            const claudePidStr = shellExec(`pgrep -P ${panePid} -f claude 2>/dev/null | head -1`).trim();
+            if (!claudePidStr)
+                return null;
+            const pid = parseInt(claudePidStr, 10);
+            return isNaN(pid) ? null : pid;
+        }
+        catch {
+            // @silent-fallback-ok — process detection returns null
+            return null;
+        }
+    }
+    getChildProcesses(pid) {
+        try {
+            const childPidsStr = shellExec(`pgrep -P ${pid} 2>/dev/null`).trim();
+            if (!childPidsStr)
+                return [];
+            const childPids = childPidsStr.split('\n').filter(Boolean).join(',');
+            if (!childPids)
+                return [];
+            const output = shellExec(`ps -o pid=,etime=,command= -p ${childPids} 2>/dev/null`).trim();
+            if (!output)
+                return [];
+            const results = [];
+            for (const line of output.split('\n')) {
+                const match = line.trim().match(/^(\d+)\s+([\d:.-]+)\s+(.+)$/);
+                if (!match)
+                    continue;
+                const childPid = parseInt(match[1], 10);
+                if (isNaN(childPid))
+                    continue;
+                results.push({
+                    pid: childPid,
+                    command: match[3],
+                    elapsedMs: this.parseElapsed(match[2]),
+                });
+            }
+            return results;
+        }
+        catch {
+            // @silent-fallback-ok — process enumeration returns empty
+            return [];
+        }
+    }
+    isExcluded(command) {
+        for (const pattern of EXCLUDED_PATTERNS) {
+            if (command.includes(pattern))
+                return true;
+        }
+        for (const prefix of EXCLUDED_PREFIXES) {
+            if (command.startsWith(prefix))
+                return true;
+        }
+        return false;
+    }
+    parseElapsed(elapsed) {
+        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;
+    }
+    sendSignal(pid, signal) {
+        try {
+            process.kill(pid, signal);
+        }
+        catch (err) {
+            // @silent-fallback-ok — ESRCH expected for dead processes
+            if (err.code !== 'ESRCH') {
+                console.error(`[Watchdog] Failed to send ${signal} to ${pid}:`, err);
+            }
+        }
+    }
+    isProcessAlive(pid) {
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch {
+            // @silent-fallback-ok — signal 0 check
+            return false;
+        }
+    }
+    killTmuxSession(tmuxSession) {
+        try {
+            shellExec(`${this.config.sessions.tmuxPath} kill-session -t "=${tmuxSession}" 2>/dev/null`);
+        }
+        catch { }
+    }
+    recordIntervention(sessionName, level, action, child) {
+        const event = {
+            sessionName,
+            level,
+            action,
+            stuckCommand: child.command.slice(0, 200),
+            stuckPid: child.pid,
+            timestamp: Date.now(),
+        };
+        this.interventionHistory.push(event);
+        if (this.interventionHistory.length > 50) {
+            this.interventionHistory = this.interventionHistory.slice(-50);
+        }
+        this.emit('intervention', event);
+        // Schedule outcome check — 60s later, was the session still alive?
+        if (level === EscalationLevel.CtrlC) {
+            // Only track outcome from the first intervention (Ctrl+C)
+            this.pendingOutcomeChecks.set(sessionName, event);
+            setTimeout(() => this.checkOutcome(sessionName, event), 60_000);
+        }
+        // Persist to JSONL
+        this.persistEvent(event);
+    }
+    /**
+     * Check session health 60s after an intervention.
+     * Did the session recover (still producing output) or die?
+     */
+    checkOutcome(sessionName, event) {
+        const pending = this.pendingOutcomeChecks.get(sessionName);
+        if (!pending || pending.timestamp !== event.timestamp)
+            return;
+        this.pendingOutcomeChecks.delete(sessionName);
+        const sessions = this.sessionManager.listRunningSessions();
+        const stillRunning = sessions.some(s => s.tmuxSession === sessionName);
+        event.outcome = stillRunning ? 'recovered' : 'died';
+        event.outcomeDelayMs = Date.now() - event.timestamp;
+        // Persist the outcome update
+        this.persistEvent({ ...event, _outcomeUpdate: true });
+        this.emit('outcome', { sessionName, outcome: event.outcome, level: event.level });
+    }
+    /**
+     * Append an event to the persistent JSONL log.
+     * 30-day retention, auto-rotated.
+     */
+    persistEvent(event) {
+        try {
+            const dir = path.dirname(this.logPath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.appendFileSync(this.logPath, JSON.stringify(event) + '\n');
+            maybeRotateJsonl(this.logPath); // 10MB default, keep 75%
+        }
+        catch {
+            // @silent-fallback-ok — persistence failure is non-critical
+        }
+    }
+    /**
+     * Read persistent intervention log entries since a given time.
+     */
+    readLog(sinceMs) {
+        try {
+            if (!fs.existsSync(this.logPath))
+                return [];
+            const content = fs.readFileSync(this.logPath, 'utf-8').trim();
+            if (!content)
+                return [];
+            const since = sinceMs ?? 0;
+            return content.split('\n')
+                .map(line => { try {
+                return JSON.parse(line);
+            }
+            catch {
+                return null;
+            } })
+                .filter((e) => e !== null && e.timestamp >= since);
+        }
+        catch {
+            // @silent-fallback-ok — log read failure returns empty
+            return [];
+        }
+    }
+    /**
+     * Get aggregated watchdog stats for a time window.
+     * Used by TelemetryCollector for Baseline submissions.
+     */
+    getStats(sinceMs) {
+        const events = this.readLog(sinceMs);
+        const levelNames = ['monitoring', 'ctrl-c', 'sigterm', 'sigkill', 'kill-session'];
+        const stats = {
+            interventionsTotal: 0,
+            interventionsByLevel: {},
+            recoveries: 0,
+            sessionDeaths: 0,
+            outcomeUnknown: 0,
+            llmGateOverrides: this.llmGateOverrides,
+        };
+        for (const event of events) {
+            // Skip outcome update entries
+            if (event._outcomeUpdate) {
+                if (event.outcome === 'recovered')
+                    stats.recoveries++;
+                else if (event.outcome === 'died')
+                    stats.sessionDeaths++;
+                else
+                    stats.outcomeUnknown++;
+                continue;
+            }
+            stats.interventionsTotal++;
+            const levelName = levelNames[event.level] ?? `level-${event.level}`;
+            stats.interventionsByLevel[levelName] = (stats.interventionsByLevel[levelName] || 0) + 1;
+        }
+        return stats;
+    }
+    /**
+     * Rotate the persistent log — remove entries older than 30 days.
+     */
+    rotateLog() {
+        try {
+            if (!fs.existsSync(this.logPath))
+                return;
+            const content = fs.readFileSync(this.logPath, 'utf-8').trim();
+            if (!content)
+                return;
+            const cutoff = Date.now() - 30 * 24 * 60 * 60 * 1000;
+            const lines = content.split('\n');
+            const fresh = lines.filter(line => {
+                try {
+                    const e = JSON.parse(line);
+                    return e.timestamp >= cutoff;
+                }
+                catch {
+                    return false;
+                }
+            });
+            if (fresh.length < lines.length) {
+                fs.writeFileSync(this.logPath, fresh.join('\n') + (fresh.length > 0 ? '\n' : ''));
+            }
+        }
+        catch {
+            // @silent-fallback-ok — rotation failure is non-critical
+        }
+    }
+}
+//# sourceMappingURL=SessionWatchdog.js.map

package/dist/monitoring/SessionWatchdog.js.map

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

package/dist/monitoring/StallTriageNurse.d.ts

@@ -0,0 +1,96 @@
+/**
+ * StallTriageNurse — LLM-powered session recovery for stalled sessions.
+ *
+ * Instar version: Uses IntelligenceProvider for LLM calls, EventEmitter for
+ * typed events, and StateManager for persistence across restarts.
+ *
+ * When a message goes unanswered, the nurse:
+ * 1. Gathers context (tmux output, session liveness, recent messages)
+ * 2. Diagnoses the problem via LLM (IntelligenceProvider or direct API)
+ * 3. Executes a treatment action (nudge, interrupt, unstick, restart)
+ * 4. Verifies the action worked
+ * 5. Escalates if needed (up to maxEscalations)
+ */
+import { EventEmitter } from 'events';
+import type { IntelligenceProvider } from '../core/types.js';
+import type { StateManager } from '../core/StateManager.js';
+import type { StallTriageConfig, TreatmentAction, TriageDiagnosis, TriageContext, TriageResult, TriageRecord, TriageEvents, TriageDeps, ProcessInfo } from './StallTriageNurse.types.js';
+export type { StallTriageConfig, TreatmentAction, TriageDiagnosis, TriageContext, TriageResult, TriageRecord, TriageEvents, TriageDeps, ProcessInfo, };
+export declare class StallTriageNurse extends EventEmitter {
+    private config;
+    private deps;
+    private state;
+    private intelligence;
+    private cooldowns;
+    private activeCases;
+    private history;
+    /** Track restart timestamps per topic for loop detection */
+    private restartTimestamps;
+    private static readonly MAX_HISTORY;
+    private static readonly STATE_KEY;
+    constructor(deps: TriageDeps, opts?: {
+        config?: Partial<StallTriageConfig>;
+        state?: StateManager;
+        intelligence?: IntelligenceProvider;
+    });
+    emit<K extends keyof TriageEvents>(event: K, data: TriageEvents[K]): boolean;
+    on<K extends keyof TriageEvents>(event: K, listener: (data: TriageEvents[K]) => void): this;
+    /**
+     * Check if a topic was recently triaged and is in cooldown.
+     */
+    isInCooldown(topicId: number): boolean;
+    /**
+     * Get current status for health checks and API.
+     */
+    getStatus(): {
+        enabled: boolean;
+        activeCases: number;
+        historyCount: number;
+        cooldowns: number;
+    };
+    /**
+     * Get the history of past triage records (capped at MAX_HISTORY).
+     */
+    getHistory(limit?: number): TriageRecord[];
+    /**
+     * Check if a topic is in a restart loop (too many restarts in a short window).
+     * Returns the count of recent restarts if in a loop, or 0 if not.
+     */
+    isInRestartLoop(topicId: number): number;
+    /**
+     * Record a restart for loop detection tracking.
+     */
+    private recordRestart;
+    /**
+     * Main entry point. Gathers context, diagnoses via LLM, executes treatment,
+     * verifies, and escalates if needed.
+     */
+    triage(topicId: number, sessionName: string, pendingMessage: string, injectedAt: number, trigger?: 'watchdog' | 'telegram_stall' | 'manual'): Promise<TriageResult>;
+    /**
+     * Fast pattern-based diagnosis that runs BEFORE the LLM.
+     * Returns a diagnosis if a known pattern matches, or null to fall through to LLM.
+     */
+    heuristicDiagnose(context: TriageContext): TriageDiagnosis | null;
+    private gatherContext;
+    private diagnose;
+    /**
+     * Process-tree fallback: when LLM is unavailable, check actual child processes
+     * to see if something is stuck.
+     */
+    private processTreeFallback;
+    private buildDiagnosisPrompt;
+    callAnthropicApi(prompt: string): Promise<string>;
+    parseDiagnosis(rawResponse: string): TriageDiagnosis;
+    private executeAction;
+    /**
+     * After interrupt/unstick, inject a system message into the session so the
+     * Claude instance knows what happened and can recover gracefully.
+     */
+    private sendPostInterventionFollowUp;
+    verifyAction(action: TreatmentAction, context: TriageContext): Promise<boolean>;
+    private loadState;
+    private saveState;
+    private recordResult;
+    private delay;
+}
+//# sourceMappingURL=StallTriageNurse.d.ts.map