instar 1.2.40 → 1.2.42

package/dist/monitoring/ActiveWorkSilenceSentinel.js

@@ -0,0 +1,181 @@
+/**
+ * ActiveWorkSilenceSentinel — detects sessions in the registry that were
+ * actively producing output and then went silent for an extended period,
+ * independent of topic binding.
+ *
+ * Closes the watchdog gap surfaced 2026-05-22: a gsd-style sub-spawned
+ * worktree session went silent for 1h16m and three existing watchdogs all
+ * missed it:
+ *   - SessionWatchdog requires a long-running child (this had none).
+ *   - SessionMonitor only inspects topic-bound sessions (this wasn't).
+ *   - PresenceProxy wakes on inbound user messages (none arrived).
+ *
+ * This sentinel sits one layer below those: it walks the SessionRegistry
+ * directly, looking for "had output recently, now hasn't for N minutes."
+ * On match it tries one gentle nudge; if that doesn't unstick the session
+ * within the verify window, it escalates via the tone-gated /attention
+ * path.
+ *
+ * Spec: docs/specs/silently-stopped-trio.md
+ *
+ * Signal-vs-authority: the threshold check is a detector. The nudge is a
+ * bounded recovery primitive. The escalation goes through MessagingToneGate
+ * via the notify path. No new blocking authority.
+ */
+import { EventEmitter } from 'node:events';
+const DEFAULT_CONFIG = {
+    enabled: true,
+    tickIntervalMs: 60_000,
+    silenceThresholdMs: 15 * 60_000,
+    verifyWindowMs: 30_000,
+};
+export class ActiveWorkSilenceSentinel extends EventEmitter {
+    deps;
+    cfg;
+    states = new Map();
+    verifyTimers = new Map();
+    tickHandle = null;
+    constructor(deps, cfg = {}) {
+        super();
+        this.deps = deps;
+        this.cfg = { ...DEFAULT_CONFIG, ...cfg };
+    }
+    start() {
+        if (!this.cfg.enabled || this.tickHandle)
+            return;
+        this.tickHandle = setInterval(() => this.tick(), this.cfg.tickIntervalMs);
+        // Unref so this doesn't keep the process alive on shutdown.
+        if (typeof this.tickHandle.unref === 'function')
+            this.tickHandle.unref();
+    }
+    stop() {
+        if (this.tickHandle) {
+            clearInterval(this.tickHandle);
+            this.tickHandle = null;
+        }
+        for (const t of this.verifyTimers.values())
+            this.clearTimer(t);
+        this.verifyTimers.clear();
+        this.states.clear();
+    }
+    /** Public for tests. Walk the registry and act on silence findings. */
+    tick() {
+        const now = (this.deps.now ?? Date.now)();
+        const sessions = this.deps.listSessions();
+        for (const s of sessions) {
+            if (s.paused || s.recoveryInFlight)
+                continue;
+            if (!s.lastOutputAt || s.lastOutputAt <= 0)
+                continue;
+            // Session is in the registry but never produced output → not "actively working then stopped"; skip.
+            const idleMs = now - s.lastOutputAt;
+            if (idleMs < this.cfg.silenceThresholdMs)
+                continue;
+            const existing = this.states.get(s.sessionName);
+            if (existing)
+                continue; // already handling
+            this.report(s.sessionName, s.lastOutputAt);
+        }
+    }
+    /** Public entry: report a silence finding. Idempotent. */
+    report(sessionName, lastOutputAt) {
+        if (!this.cfg.enabled)
+            return;
+        if (this.states.has(sessionName))
+            return;
+        const now = (this.deps.now ?? Date.now)();
+        const state = {
+            sessionName,
+            detectedAt: now,
+            lastOutputAtAtDetection: lastOutputAt,
+            nudgedAt: 0,
+            status: 'detected',
+        };
+        this.states.set(sessionName, state);
+        this.emit('silence', { sessionName, idleMs: now - lastOutputAt });
+        void this.runNudge(sessionName);
+    }
+    isRecoveryActive(sessionName) {
+        const s = this.states.get(sessionName);
+        return !!s && s.status !== 'recovered' && s.status !== 'escalated';
+    }
+    listActive() {
+        return Array.from(this.states.values());
+    }
+    clear(sessionName) {
+        const t = this.verifyTimers.get(sessionName);
+        if (t)
+            this.clearTimer(t);
+        this.verifyTimers.delete(sessionName);
+        this.states.delete(sessionName);
+    }
+    async runNudge(sessionName) {
+        const state = this.states.get(sessionName);
+        if (!state)
+            return;
+        state.status = 'nudged';
+        state.nudgedAt = (this.deps.now ?? Date.now)();
+        let accepted = false;
+        try {
+            accepted = await this.deps.nudgeFn(sessionName);
+        }
+        catch (err) {
+            this.emit('nudge-error', { sessionName, err });
+            accepted = false;
+        }
+        if (!accepted) {
+            // Couldn't even nudge — escalate immediately.
+            this.escalate(sessionName);
+            return;
+        }
+        const handle = this.setTimer(() => this.verifyNudge(sessionName), this.cfg.verifyWindowMs);
+        this.verifyTimers.set(sessionName, handle);
+    }
+    verifyNudge(sessionName) {
+        const state = this.states.get(sessionName);
+        if (!state)
+            return;
+        // Re-poll the registry — has lastOutputAt advanced past detection point?
+        const fresh = this.deps.listSessions().find(s => s.sessionName === sessionName);
+        if (!fresh) {
+            // Session vanished from registry — treat as recovered (probably ended cleanly).
+            state.status = 'recovered';
+            this.clear(sessionName);
+            return;
+        }
+        if (fresh.lastOutputAt > state.lastOutputAtAtDetection) {
+            state.status = 'recovered';
+            this.emit('recovered', sessionName);
+            this.clear(sessionName);
+            return;
+        }
+        this.escalate(sessionName);
+    }
+    escalate(sessionName) {
+        const state = this.states.get(sessionName);
+        if (!state)
+            return;
+        state.status = 'escalated';
+        const minutes = Math.max(1, Math.round(((this.deps.now ?? Date.now)() - state.lastOutputAtAtDetection) / 60_000));
+        void this.notify(sessionName, `${friendlyName(sessionName)} was working and went quiet about ${minutes} minutes ago. I tried a gentle nudge and nothing came back. Want me to dig in?`);
+        this.emit('escalated', sessionName);
+    }
+    async notify(sessionName, text) {
+        try {
+            await this.deps.notifyFn(sessionName, text);
+        }
+        catch (err) {
+            this.emit('notify-error', { sessionName, err });
+        }
+    }
+    setTimer(fn, ms) {
+        return (this.deps.setTimer ?? setTimeout)(fn, ms);
+    }
+    clearTimer(handle) {
+        (this.deps.clearTimer ?? clearTimeout)(handle);
+    }
+}
+function friendlyName(sessionName) {
+    return sessionName.replace(/^ai\.instar\./, '').replace(/-server$/, '').replace(/-lifeline$/, '');
+}
+//# sourceMappingURL=ActiveWorkSilenceSentinel.js.map

package/dist/monitoring/ActiveWorkSilenceSentinel.js.map

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

package/dist/monitoring/SocketDisconnectSentinel.d.ts

@@ -0,0 +1,113 @@
+/**
+ * SocketDisconnectSentinel — detects Claude Code's "socket connection closed
+ * unexpectedly" message in tracked sessions and runs a bounded recovery loop.
+ *
+ * Closes the gap surfaced by the joint diagnosis on 2026-05-22: the instar
+ * repo had detectors for rate limits, quota, hundreds of patterns, but zero
+ * detectors for Claude Code's own connection-drop string. When it fires, the
+ * session freezes; nothing classifies it; no recovery runs; no user-visible
+ * alert reaches the user.
+ *
+ * Pattern mirrors `RateLimitSentinel.report` → backoff → `resumeFn` →
+ * verification → escalate, but the failure shape is simpler (no Claude
+ * Code internal retries to wait out — disconnect is immediate) so the
+ * lifecycle is shorter.
+ *
+ * Spec: docs/specs/silently-stopped-trio.md
+ *
+ * Signal-vs-authority: the regex + state machine are detectors. The
+ * notifyFn path is the existing MessagingToneGate authority (called through
+ * /attention). No new blocking authority introduced.
+ */
+import { EventEmitter } from 'node:events';
+export type SocketDisconnectStatus = 'detected' | 'recovering' | 'recovered' | 'escalated';
+export interface SocketDisconnectState {
+    sessionName: string;
+    detectedAt: number;
+    attempts: number;
+    lastInjectAt: number;
+    status: SocketDisconnectStatus;
+}
+export interface SocketDisconnectSentinelDeps {
+    /**
+     * Inject a recovery nudge into the session: typically Ctrl+C then Enter.
+     * Returns whether the injection was accepted.
+     */
+    resumeFn: (sessionName: string) => Promise<boolean>;
+    /** Route a user-facing message; server.ts owns topic routing. */
+    notifyFn: (sessionName: string, text: string) => Promise<void>;
+    /** Peek at the session's most recent tmux output. Returns a string that
+     * may be empty if the session has no recent output. */
+    getRecentOutput: (sessionName: string) => string;
+    /**
+     * Optional: list the session names to scan on each tick. Required for the
+     * self-driving `start()` loop; without it the sentinel is event-driven only
+     * (caller invokes `scanSession`/`report`). The server wiring supplies this.
+     */
+    listSessionNames?: () => string[];
+    /** Override Date.now (tests). */
+    now?: () => number;
+    /** Override timer setters (tests). */
+    setTimer?: (fn: () => void, ms: number) => ReturnType<typeof setTimeout>;
+    clearTimer?: (handle: ReturnType<typeof setTimeout>) => void;
+}
+export interface SocketDisconnectSentinelConfig {
+    enabled?: boolean;
+    /** Backoff staircase in ms between recovery attempts. Last value repeats. */
+    backoffScheduleMs?: number[];
+    /** Max recovery attempts before escalating. Default 4. */
+    maxAttempts?: number;
+    /** How long to wait after a nudge before declaring recovery (ms). Default 60s. */
+    verifyWindowMs?: number;
+    /** How often the self-driving loop scans every session (ms). Default 15s. */
+    tickIntervalMs?: number;
+}
+/**
+ * Patterns Claude Code uses when its connection to Anthropic drops. Broad
+ * intentionally — false-positive cost is one harmless nudge; false-negative
+ * cost is the silently-stopped failure class this sentinel exists to close.
+ */
+export declare const SOCKET_DISCONNECT_PATTERNS: readonly RegExp[];
+/**
+ * Detector — true if `text` contains any known disconnect pattern.
+ */
+export declare function detectSocketDisconnect(text: string): boolean;
+export declare class SocketDisconnectSentinel extends EventEmitter {
+    private readonly deps;
+    private readonly cfg;
+    private readonly states;
+    private readonly timers;
+    private tickHandle;
+    constructor(deps: SocketDisconnectSentinelDeps, cfg?: SocketDisconnectSentinelConfig);
+    /**
+     * Begin the self-driving scan loop. No-op unless `listSessionNames` was
+     * provided (otherwise the sentinel is purely event-driven). The interval is
+     * unref'd so it never holds the process open at shutdown.
+     */
+    start(): void;
+    /** Stop the scan loop and cancel all in-flight recovery. */
+    stop(): void;
+    /** One scan pass over every session the registry currently knows about. */
+    tick(): void;
+    /** Called by the tick loop (or by an event trigger) for each tracked session. */
+    scanSession(sessionName: string): void;
+    /**
+     * Public entry: report a detected disconnect. Idempotent — second call
+     * for the same session within an active recovery is a no-op.
+     */
+    report(sessionName: string): void;
+    isRecoveryActive(sessionName: string): boolean;
+    listActive(): SocketDisconnectState[];
+    /** Cancel any in-flight recovery for this session (test + shutdown helper). */
+    clear(sessionName: string): void;
+    /** Cancel all in-flight recovery (server shutdown). */
+    shutdown(): void;
+    private scheduleNextAttempt;
+    private runAttempt;
+    private verifyAttempt;
+    private escalate;
+    private notify;
+    private setTimer;
+    private clearTimer;
+}
+//# sourceMappingURL=SocketDisconnectSentinel.d.ts.map

package/dist/monitoring/SocketDisconnectSentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocketDisconnectSentinel.d.ts","sourceRoot":"","sources":["../../src/monitoring/SocketDisconnectSentinel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,sBAAsB,GAC9B,UAAU,GACV,YAAY,GACZ,WAAW,GACX,WAAW,CAAC;AAEhB,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,iEAAiE;IACjE,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D;2DACuD;IACvD,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IAClC,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IACzE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,KAAK,IAAI,CAAC;CAC9D;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAKvD,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAM5D;AAED,qBAAa,wBAAyB,SAAQ,YAAY;IAM5C,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA2C;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoD;IAC3E,OAAO,CAAC,UAAU,CAA+C;gBAEpC,IAAI,EAAE,4BAA4B,EAAE,GAAG,GAAE,8BAAmC;IAKzG;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAOb,4DAA4D;IAC5D,IAAI,IAAI,IAAI;IAQZ,2EAA2E;IAC3E,IAAI,IAAI,IAAI;IAMZ,iFAAiF;IACjF,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQtC;;;OAGG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAsBjC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAK9C,UAAU,IAAI,qBAAqB,EAAE;IAIrC,+EAA+E;IAC/E,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAOhC,uDAAuD;IACvD,QAAQ,IAAI,IAAI;IAQhB,OAAO,CAAC,mBAAmB;YAcb,UAAU;IA2BxB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,QAAQ;YAaF,MAAM;IAQpB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,UAAU;CAGnB"}

package/dist/monitoring/SocketDisconnectSentinel.js

@@ -0,0 +1,235 @@
+/**
+ * SocketDisconnectSentinel — detects Claude Code's "socket connection closed
+ * unexpectedly" message in tracked sessions and runs a bounded recovery loop.
+ *
+ * Closes the gap surfaced by the joint diagnosis on 2026-05-22: the instar
+ * repo had detectors for rate limits, quota, hundreds of patterns, but zero
+ * detectors for Claude Code's own connection-drop string. When it fires, the
+ * session freezes; nothing classifies it; no recovery runs; no user-visible
+ * alert reaches the user.
+ *
+ * Pattern mirrors `RateLimitSentinel.report` → backoff → `resumeFn` →
+ * verification → escalate, but the failure shape is simpler (no Claude
+ * Code internal retries to wait out — disconnect is immediate) so the
+ * lifecycle is shorter.
+ *
+ * Spec: docs/specs/silently-stopped-trio.md
+ *
+ * Signal-vs-authority: the regex + state machine are detectors. The
+ * notifyFn path is the existing MessagingToneGate authority (called through
+ * /attention). No new blocking authority introduced.
+ */
+import { EventEmitter } from 'node:events';
+const DEFAULT_CONFIG = {
+    enabled: true,
+    backoffScheduleMs: [60_000, 5 * 60_000, 15 * 60_000, 30 * 60_000],
+    maxAttempts: 4,
+    verifyWindowMs: 60_000,
+    tickIntervalMs: 15_000,
+};
+/**
+ * Patterns Claude Code uses when its connection to Anthropic drops. Broad
+ * intentionally — false-positive cost is one harmless nudge; false-negative
+ * cost is the silently-stopped failure class this sentinel exists to close.
+ */
+export const SOCKET_DISCONNECT_PATTERNS = [
+    /socket connection closed unexpectedly/i,
+    /websocket.*reset by peer/i,
+    /ECONNRESET.*claude/i,
+    /connection.*closed.*unexpectedly/i,
+];
+/**
+ * Detector — true if `text` contains any known disconnect pattern.
+ */
+export function detectSocketDisconnect(text) {
+    if (!text)
+        return false;
+    for (const pat of SOCKET_DISCONNECT_PATTERNS) {
+        if (pat.test(text))
+            return true;
+    }
+    return false;
+}
+export class SocketDisconnectSentinel extends EventEmitter {
+    deps;
+    cfg;
+    states = new Map();
+    timers = new Map();
+    tickHandle = null;
+    constructor(deps, cfg = {}) {
+        super();
+        this.deps = deps;
+        this.cfg = { ...DEFAULT_CONFIG, ...cfg };
+    }
+    /**
+     * Begin the self-driving scan loop. No-op unless `listSessionNames` was
+     * provided (otherwise the sentinel is purely event-driven). The interval is
+     * unref'd so it never holds the process open at shutdown.
+     */
+    start() {
+        if (!this.cfg.enabled || this.tickHandle)
+            return;
+        if (!this.deps.listSessionNames)
+            return;
+        this.tickHandle = setInterval(() => this.tick(), this.cfg.tickIntervalMs);
+        if (typeof this.tickHandle.unref === 'function')
+            this.tickHandle.unref();
+    }
+    /** Stop the scan loop and cancel all in-flight recovery. */
+    stop() {
+        if (this.tickHandle) {
+            clearInterval(this.tickHandle);
+            this.tickHandle = null;
+        }
+        this.shutdown();
+    }
+    /** One scan pass over every session the registry currently knows about. */
+    tick() {
+        if (!this.cfg.enabled)
+            return;
+        const names = this.deps.listSessionNames?.() ?? [];
+        for (const name of names)
+            this.scanSession(name);
+    }
+    /** Called by the tick loop (or by an event trigger) for each tracked session. */
+    scanSession(sessionName) {
+        if (!this.cfg.enabled)
+            return;
+        if (this.states.has(sessionName))
+            return; // already handling
+        const output = this.deps.getRecentOutput(sessionName);
+        if (!detectSocketDisconnect(output))
+            return;
+        this.report(sessionName);
+    }
+    /**
+     * Public entry: report a detected disconnect. Idempotent — second call
+     * for the same session within an active recovery is a no-op.
+     */
+    report(sessionName) {
+        if (!this.cfg.enabled)
+            return;
+        if (this.states.has(sessionName))
+            return;
+        const now = (this.deps.now ?? Date.now)();
+        const state = {
+            sessionName,
+            detectedAt: now,
+            attempts: 0,
+            lastInjectAt: 0,
+            status: 'detected',
+        };
+        this.states.set(sessionName, state);
+        // First user notice — tone-gated path via notifyFn.
+        void this.notify(sessionName, `${friendlyName(sessionName)} lost its connection to Claude Code. Trying to recover; will let you know if it can't.`);
+        this.scheduleNextAttempt(sessionName);
+    }
+    isRecoveryActive(sessionName) {
+        const s = this.states.get(sessionName);
+        return !!s && s.status !== 'recovered' && s.status !== 'escalated';
+    }
+    listActive() {
+        return Array.from(this.states.values());
+    }
+    /** Cancel any in-flight recovery for this session (test + shutdown helper). */
+    clear(sessionName) {
+        const t = this.timers.get(sessionName);
+        if (t)
+            this.clearTimer(t);
+        this.timers.delete(sessionName);
+        this.states.delete(sessionName);
+    }
+    /** Cancel all in-flight recovery (server shutdown). */
+    shutdown() {
+        for (const t of this.timers.values())
+            this.clearTimer(t);
+        this.timers.clear();
+        this.states.clear();
+    }
+    // ── Recovery loop ──────────────────────────────────────────────────
+    scheduleNextAttempt(sessionName) {
+        const state = this.states.get(sessionName);
+        if (!state)
+            return;
+        if (state.attempts >= this.cfg.maxAttempts) {
+            this.escalate(sessionName);
+            return;
+        }
+        const idx = Math.min(state.attempts, this.cfg.backoffScheduleMs.length - 1);
+        const wait = this.cfg.backoffScheduleMs[idx];
+        state.status = 'recovering';
+        const handle = this.setTimer(() => this.runAttempt(sessionName), wait);
+        this.timers.set(sessionName, handle);
+    }
+    async runAttempt(sessionName) {
+        const state = this.states.get(sessionName);
+        if (!state)
+            return;
+        const now = (this.deps.now ?? Date.now)();
+        state.attempts += 1;
+        state.lastInjectAt = now;
+        let injected = false;
+        try {
+            injected = await this.deps.resumeFn(sessionName);
+        }
+        catch (err) {
+            this.emit('recovery-error', { sessionName, err });
+            injected = false;
+        }
+        if (!injected) {
+            // Nudge couldn't be delivered — escalate immediately, this isn't
+            // something a backoff staircase can fix.
+            this.escalate(sessionName);
+            return;
+        }
+        // Schedule a verify check.
+        const handle = this.setTimer(() => this.verifyAttempt(sessionName), this.cfg.verifyWindowMs);
+        this.timers.set(sessionName, handle);
+    }
+    verifyAttempt(sessionName) {
+        const state = this.states.get(sessionName);
+        if (!state)
+            return;
+        const output = this.deps.getRecentOutput(sessionName);
+        // Heuristic: if the disconnect pattern no longer appears in the recent
+        // output, the session has progressed past the freeze.
+        if (!detectSocketDisconnect(output)) {
+            state.status = 'recovered';
+            void this.notify(sessionName, `${friendlyName(sessionName)} is reconnected and back to work.`);
+            this.emit('recovered', sessionName);
+            this.clear(sessionName);
+            return;
+        }
+        // Still stuck → next attempt.
+        this.scheduleNextAttempt(sessionName);
+    }
+    escalate(sessionName) {
+        const state = this.states.get(sessionName);
+        if (!state)
+            return;
+        state.status = 'escalated';
+        const minutes = Math.max(1, Math.round(((this.deps.now ?? Date.now)() - state.detectedAt) / 60_000));
+        void this.notify(sessionName, `${friendlyName(sessionName)} has been disconnected for about ${minutes} minutes and my recovery attempts haven't worked. Want me to dig in?`);
+        this.emit('escalated', sessionName);
+        // Keep state so a subsequent scanSession doesn't re-report the same outage.
+    }
+    async notify(sessionName, text) {
+        try {
+            await this.deps.notifyFn(sessionName, text);
+        }
+        catch (err) {
+            this.emit('notify-error', { sessionName, err });
+        }
+    }
+    setTimer(fn, ms) {
+        return (this.deps.setTimer ?? setTimeout)(fn, ms);
+    }
+    clearTimer(handle) {
+        (this.deps.clearTimer ?? clearTimeout)(handle);
+    }
+}
+/** Strip prefix conventions for user-facing copy. Keeps B12 simple. */
+function friendlyName(sessionName) {
+    return sessionName.replace(/^ai\.instar\./, '').replace(/-server$/, '').replace(/-lifeline$/, '');
+}
+//# sourceMappingURL=SocketDisconnectSentinel.js.map

package/dist/monitoring/SocketDisconnectSentinel.js.map

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

package/dist/monitoring/sentinelWiring.d.ts

@@ -0,0 +1,82 @@
+/**
+ * sentinelWiring — constructs the runtime dependencies for the two
+ * "silently-stopped" sentinels (SocketDisconnectSentinel and
+ * ActiveWorkSilenceSentinel) from a SessionManager surface + config.
+ *
+ * Why this module exists: PR #334 merged both sentinels as standalone,
+ * unit-tested detectors but never instantiated them in the server. The
+ * release notes claimed "wired into server startup" — it wasn't true. This
+ * module is the missing wire-up, extracted from server.ts so the dependency
+ * construction is itself unit-testable (Testing Integrity Standard: every
+ * dependency-injected component needs wiring-integrity tests proving the deps
+ * are real functions that delegate to the underlying primitives, not nulls or
+ * silent no-ops).
+ *
+ * Signal-vs-authority: everything here is a detector or a bounded recovery
+ * primitive. `looksActivelyWorking` is a structural detector. All user-facing
+ * escalation routes through the existing MessagingToneGate via the `/attention`
+ * endpoint (category: degradation) — no new blocking authority is introduced.
+ *
+ * Spec: docs/specs/silently-stopped-trio.md
+ */
+import type { SocketDisconnectSentinelDeps } from './SocketDisconnectSentinel.js';
+import type { ActiveWorkSilenceSentinelDeps, SessionRegistryEntry } from './ActiveWorkSilenceSentinel.js';
+import type { IntelligenceFramework } from '../core/intelligenceProviderFactory.js';
+/** Minimal SessionManager surface the wiring depends on. */
+export interface SentinelSessionSurface {
+    captureOutput(tmuxSession: string, lines?: number): string | null;
+    isSessionAlive(tmuxSession: string): boolean;
+    sendKey(tmuxSession: string, key: string): boolean;
+    listRunningSessions(): Array<{
+        tmuxSession: string;
+        framework?: IntelligenceFramework;
+    }>;
+}
+/**
+ * Posts a user-facing escalation through the tone-gated `/attention` route.
+ * Returns true on 201 (delivered), false otherwise — including a 422 tone-gate
+ * block (which is the gate doing its job, not an error to retry).
+ */
+export type AttentionPoster = (item: {
+    id: string;
+    title: string;
+    summary: string;
+    category?: string;
+    priority?: string;
+}) => Promise<boolean>;
+export declare function makeAttentionPoster(opts: {
+    port: number;
+    authToken: string;
+    fetchImpl?: typeof fetch;
+}): AttentionPoster;
+export declare function buildSocketDisconnectDeps(opts: {
+    sessions: SentinelSessionSurface;
+    notify: AttentionPoster;
+}): SocketDisconnectSentinelDeps;
+/**
+ * Detector: does this captured frame show the framework actively working
+ * (spinner, tool call, "esc to interrupt", "(running)") rather than sitting
+ * idle at its prompt? Used to filter the silence sentinel's candidate set so a
+ * session that is simply waiting for the user is never flagged as "stopped".
+ */
+export declare function looksActivelyWorking(output: string, framework?: IntelligenceFramework): boolean;
+/**
+ * Tracks per-session output-change time so the silence sentinel can tell
+ * "frozen mid-task" from "still producing output". Only sessions whose most
+ * recent frame shows active-work signatures are surfaced as candidates; an
+ * idle-at-prompt session is marked `paused` so the sentinel skips it — it is
+ * not "actively working then stopped".
+ */
+export declare class OutputActivityTracker {
+    private readonly sessions;
+    private readonly now;
+    private readonly last;
+    constructor(sessions: SentinelSessionSurface, now?: () => number);
+    snapshot(): SessionRegistryEntry[];
+}
+export declare function buildActiveWorkSilenceDeps(opts: {
+    tracker: OutputActivityTracker;
+    sessions: SentinelSessionSurface;
+    notify: AttentionPoster;
+}): ActiveWorkSilenceSentinelDeps;
+//# sourceMappingURL=sentinelWiring.d.ts.map

package/dist/monitoring/sentinelWiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinelWiring.d.ts","sourceRoot":"","sources":["../../src/monitoring/sentinelWiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,KAAK,EACV,6BAA6B,EAC7B,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAEpF,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAClE,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7C,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACnD,mBAAmB,IAAI,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,qBAAqB,CAAA;KAAE,CAAC,CAAC;CAC1F;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEvB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,eAAe,CAoBlB;AAKD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,QAAQ,EAAE,sBAAsB,CAAC;IACjC,MAAM,EAAE,eAAe,CAAC;CACzB,GAAG,4BAA4B,CAqB/B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,qBAAqB,GAChC,OAAO,CAQT;AAED;;;;;;GAMG;AACH,qBAAa,qBAAqB;IAI9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmD;gBAGrD,QAAQ,EAAE,sBAAsB,EAChC,GAAG,GAAE,MAAM,MAAiB;IAG/C,QAAQ,IAAI,oBAAoB,EAAE;CAuBnC;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,sBAAsB,CAAC;IACjC,MAAM,EAAE,eAAe,CAAC;CACzB,GAAG,6BAA6B,CAehC"}