crewly 1.20.195 → 1.20.196

package/dist/cli/backend/src/services/monitoring/agent-turn-state.js

@@ -0,0 +1,391 @@
+/**
+ * Agent Turn State
+ *
+ * Whether an agent is mid-turn according to its runtime, not according to
+ * its screen. Long tool calls, a model writing a long tool input and
+ * background subagents are all silent on the PTY. Reading silence as "idle"
+ * let a restart kill Eve mid-work (2026-10-02, TKT-194). See
+ * specs/2026-10-02-restart-busy-and-resume.md.
+ *
+ * Sources:
+ * - Claude Code hooks (POST /api/agent-hooks): SessionStart, UserPromptSubmit,
+ *   PreToolUse, PostToolUse, SubagentStart, SubagentStop, Stop. Only
+ *   identifiers are kept (event names, tool-use ids, subagent ids), never
+ *   payload content.
+ * - The Claude Code transcript (see claude-transcript-turn.ts).
+ *
+ * How they combine:
+ * - The hooks lead. A transcript turn end (end_turn, interrupt, API or
+ *   usage-limit error) newer than the last hook event ends a hook `turn`:
+ *   Esc and API errors fire no Stop hook.
+ * - `Stop` clears open tool calls and holds the turn's subagents. Held
+ *   subagents count as `background` only while the transcript (Claude Code's
+ *   own pending-background count) agrees; a transcript turn end with nothing
+ *   pending drops them.
+ * - A transcript-only `background` (no hook saw a subagent) is reported as
+ *   `idle`: on its own it never blocks the drain or settling.
+ * - A transcript `turn` newer than the last hook event (a lost hook) is a turn.
+ *
+ * Verdicts:
+ * - `turn`: a turn is in progress;
+ * - `background`: the turn ended, but a subagent is still running and will
+ *   start a new turn when it finishes;
+ * - `idle`: the runtime said the turn ended and nothing is pending;
+ * - `unknown`: no trustworthy signal; callers fall back to the screen.
+ *
+ * @module services/monitoring/agent-turn-state
+ */
+import { TURN_STATE_CONSTANTS } from '../../constants.js';
+import { claudeTranscriptTurnState } from './claude-transcript-turn.js';
+/** Hook events this service reads. */
+const TURN_EVENTS = new Set(['SessionStart', 'UserPromptSubmit', 'PreToolUse', 'PostToolUse', 'SubagentStart', 'SubagentStop', 'Stop']);
+/** SessionStart sources that mean a new runtime process. */
+const RUNTIME_START_SOURCES = new Set(['startup', 'resume']);
+/** Prefix of synthetic ids for subagents that reported none. */
+const ANON = '\u0000anon-';
+const UNKNOWN = { state: 'unknown', longRunning: false, since: null, source: 'none' };
+/**
+ * Oldest value, or null.
+ *
+ * @param values - Timestamps
+ * @returns Smallest, or null when empty
+ */
+function oldest(values) {
+    let min = null;
+    for (const v of values)
+        if (min === null || v < min)
+            min = v;
+    return min;
+}
+/**
+ * Process-wide runtime turn state. Singleton; in memory only (a backend
+ * restart kills the agents too, so nothing needs to survive one).
+ */
+export class AgentTurnStateService {
+    static instance = null;
+    records = new Map();
+    transcriptLocator = null;
+    /** Located transcript per session, re-resolved after LOCATOR_CACHE_MS */
+    located = new Map();
+    /**
+     * @returns The singleton
+     */
+    static getInstance() {
+        if (!AgentTurnStateService.instance)
+            AgentTurnStateService.instance = new AgentTurnStateService();
+        return AgentTurnStateService.instance;
+    }
+    /** Reset the singleton (tests only). */
+    static resetInstance() {
+        AgentTurnStateService.instance = null;
+    }
+    /**
+     * Install the transcript locator.
+     *
+     * @param locator - Locator, or null to disable the transcript
+     */
+    setTranscriptLocator(locator) {
+        this.transcriptLocator = locator;
+        this.located.clear();
+    }
+    /**
+     * A runtime process was (re)started for the session: forget its old turn
+     * state, and ignore transcript background launches from before now.
+     *
+     * @param sessionName - Session
+     * @param now - Start time
+     */
+    noteRuntimeStart(sessionName, now = Date.now()) {
+        this.records.delete(sessionName);
+        this.located.delete(sessionName);
+        const r = this.recordFor(sessionName, now);
+        r.runtimeStartedAt = now;
+    }
+    /**
+     * Record a Claude Code hook event.
+     *
+     * @param sessionName - Reporting session
+     * @param event - Hook event name (validated by the caller)
+     * @param ids - Tool-use / subagent ids and SessionStart source, already validated
+     * @param now - Clock
+     * @returns True when the event changed the turn state model
+     */
+    recordHook(sessionName, event, ids = {}, now = Date.now()) {
+        if (!TURN_EVENTS.has(event))
+            return false;
+        if (event === 'SessionStart') {
+            if (ids.source && RUNTIME_START_SOURCES.has(ids.source)) {
+                this.noteRuntimeStart(sessionName, now);
+            }
+            else {
+                // /clear or compaction: same process, maybe another transcript file.
+                this.located.delete(sessionName);
+            }
+            return true;
+        }
+        const r = this.recordFor(sessionName, now);
+        r.lastEventAt = now;
+        const markActive = () => {
+            if (!r.active) {
+                r.active = true;
+                r.activeSince = now;
+            }
+        };
+        const max = TURN_STATE_CONSTANTS.MAX_OPEN_PER_SESSION;
+        switch (event) {
+            case 'UserPromptSubmit':
+                markActive();
+                break;
+            case 'PreToolUse':
+                markActive();
+                if (ids.toolUseId && r.openTools.size < max)
+                    r.openTools.set(ids.toolUseId, now);
+                break;
+            case 'PostToolUse':
+                markActive();
+                if (ids.toolUseId)
+                    r.openTools.delete(ids.toolUseId);
+                break;
+            case 'SubagentStart':
+                if (r.subagents.size < max)
+                    r.subagents.set(ids.agentId ?? `${ANON}${r.anonSeq++}`, now);
+                break;
+            case 'SubagentStop': {
+                const removeFrom = (m) => {
+                    if (ids.agentId && m.delete(ids.agentId))
+                        return true;
+                    if (!ids.agentId) {
+                        const anon = [...m.keys()].find((k) => k.startsWith(ANON)) ?? m.keys().next().value;
+                        if (anon !== undefined)
+                            return m.delete(anon);
+                    }
+                    return false;
+                };
+                if (!removeFrom(r.subagents))
+                    removeFrom(r.heldSubagents);
+                // The parent is notified and resumes: its turn is active again
+                // until the next Stop (2026-10-02, Eve's 04:41:11 turn).
+                markActive();
+                break;
+            }
+            case 'Stop':
+                this.endTurn(r, now);
+                break;
+        }
+        return true;
+    }
+    /**
+     * Forget a session (its runtime exited).
+     *
+     * @param sessionName - Session
+     */
+    forget(sessionName) {
+        this.records.delete(sessionName);
+        this.located.delete(sessionName);
+    }
+    /**
+     * Sessions that reported a hook event (still remembered).
+     *
+     * @returns Session names
+     */
+    knownSessions() {
+        return [...this.records.keys()];
+    }
+    /**
+     * Epoch ms of the session's last hook event, or null when it never sent one.
+     *
+     * @param sessionName - Session
+     * @returns Time or null
+     */
+    lastHookEventAt(sessionName) {
+        const r = this.records.get(sessionName);
+        return r && r.lastEventAt > 0 ? r.lastEventAt : null;
+    }
+    /**
+     * What the hooks alone say (held subagents count as background here).
+     *
+     * @param sessionName - Session
+     * @param now - Clock
+     * @returns Verdict (`unknown` without hooks or after a long silence)
+     */
+    hookVerdict(sessionName, now = Date.now()) {
+        const r = this.records.get(sessionName);
+        if (!r || r.lastEventAt === 0)
+            return UNKNOWN;
+        this.expire(r, now);
+        const subs = r.subagents.size + r.heldSubagents.size;
+        if (r.active) {
+            const open = r.openTools.size > 0 || subs > 0;
+            if (open || now - r.lastEventAt <= TURN_STATE_CONSTANTS.HOOK_SILENCE_MS) {
+                return { state: 'turn', longRunning: open, since: r.activeSince, source: 'hooks' };
+            }
+            // A lost Stop must not pin the agent as busy forever.
+            return UNKNOWN;
+        }
+        if (subs > 0) {
+            return { state: 'background', longRunning: true, since: oldest([...r.subagents.values(), ...r.heldSubagents.values()]), source: 'hooks' };
+        }
+        return { state: 'idle', longRunning: false, since: null, source: 'hooks' };
+    }
+    /**
+     * Combined verdict (see the module doc for the rules).
+     *
+     * @param sessionName - Session
+     * @param now - Clock
+     * @returns Verdict
+     *
+     * @example
+     * ```typescript
+     * const v = AgentTurnStateService.getInstance().getVerdict('eve-1');
+     * if (v.state === 'turn' || v.state === 'background') // do not call it idle
+     * ```
+     */
+    getVerdict(sessionName, now = Date.now()) {
+        const r = this.records.get(sessionName);
+        const t = this.readTranscript(sessionName, now, r?.runtimeStartedAt ?? undefined);
+        const transcriptTurn = t !== null && t.verdict === 'turn' && now - t.mtimeMs <= TURN_STATE_CONSTANTS.TRANSCRIPT_FRESH_MS;
+        const asTranscriptTurn = () => ({
+            state: 'turn',
+            longRunning: false,
+            since: t && Number.isFinite(t.lastEntryAt) ? t.lastEntryAt : null,
+            source: 'transcript',
+        });
+        if (!r || r.lastEventAt === 0) {
+            if (transcriptTurn)
+                return asTranscriptTurn();
+            // A transcript-only "background" never blocks on its own.
+            if (t && (t.verdict === 'idle' || t.verdict === 'background'))
+                return { state: 'idle', longRunning: false, since: null, source: 'transcript' };
+            return UNKNOWN;
+        }
+        // Esc, API errors and usage limits end the turn with no Stop hook: a
+        // transcript turn end newer than the last hook event ends it here too.
+        if (r.active && t && Number.isFinite(t.turnEndedAt) && t.turnEndedAt > r.lastEventAt) {
+            this.endTurn(r, t.turnEndedAt);
+        }
+        const hooks = this.hookVerdict(sessionName, now);
+        if (hooks.state === 'turn')
+            return hooks;
+        if (hooks.state === 'background') {
+            // Held subagents need Claude Code's own word that they still run.
+            // (A transcript still mid-flush — its last entry the turn's tool
+            // result — agrees too when it lists the launch as pending.)
+            const agrees = t !== null && t.pendingBackground > 0 && (t.verdict === 'background' || transcriptTurn);
+            const liveSince = oldest(r.subagents.values());
+            if (r.subagents.size > 0 || agrees) {
+                return { ...hooks, ...(agrees ? {} : { since: liveSince }) };
+            }
+            if (t !== null && t.verdict === 'idle' && r.stoppedAt !== null && Number.isFinite(t.turnEndedAt) && t.turnEndedAt >= r.stoppedAt - TURN_STATE_CONSTANTS.TRANSCRIPT_LAG_MS) {
+                r.heldSubagents.clear(); // the transcript says nothing is pending: they were stale
+            }
+            if (!t)
+                r.heldSubagents.clear(); // no second opinion: Stop clears them
+            return { state: 'idle', longRunning: false, since: null, source: 'hooks' };
+        }
+        // A turn the hooks missed (a failed POST) but the transcript shows.
+        if (transcriptTurn && t && t.lastEntryAt > r.lastEventAt)
+            return asTranscriptTurn();
+        return hooks;
+    }
+    /**
+     * Whether the agent still has background work after its turn ended: the
+     * work it is answering for is not finished yet.
+     *
+     * @param sessionName - Session
+     * @param now - Clock
+     * @returns True for a `background` verdict
+     */
+    hasBackgroundWork(sessionName, now = Date.now()) {
+        return this.getVerdict(sessionName, now).state === 'background';
+    }
+    /**
+     * End a record's turn: open tools are cleared, the turn's subagents are held.
+     *
+     * @param r - Record
+     * @param at - When the turn ended
+     */
+    endTurn(r, at) {
+        r.active = false;
+        r.stoppedAt = at;
+        r.openTools.clear();
+        for (const [id, startedAt] of r.subagents)
+            r.heldSubagents.set(id, startedAt);
+        r.subagents.clear();
+    }
+    /**
+     * Drop open tool calls and subagents older than OPEN_WORK_MAX_MS.
+     *
+     * @param r - Record
+     * @param now - Clock
+     */
+    expire(r, now) {
+        const maxAge = TURN_STATE_CONSTANTS.OPEN_WORK_MAX_MS;
+        for (const m of [r.openTools, r.subagents, r.heldSubagents]) {
+            for (const [id, at] of m)
+                if (now - at > maxAge)
+                    m.delete(id);
+        }
+    }
+    /**
+     * Read the session's transcript, if a locator finds one.
+     *
+     * @param sessionName - Session
+     * @param now - Clock
+     * @param launchedAfter - Runtime start (older launches ignored)
+     * @returns The transcript state, or null
+     */
+    readTranscript(sessionName, now, launchedAfter) {
+        if (!this.transcriptLocator)
+            return null;
+        const cached = this.located.get(sessionName);
+        let file;
+        if (cached && now - cached.at < TURN_STATE_CONSTANTS.LOCATOR_CACHE_MS) {
+            file = cached.file;
+        }
+        else {
+            try {
+                file = this.transcriptLocator(sessionName);
+            }
+            catch {
+                file = null;
+            }
+            if (this.located.size >= TURN_STATE_CONSTANTS.MAX_TRACKED_SESSIONS)
+                this.located.clear();
+            this.located.set(sessionName, { file, at: now });
+        }
+        if (!file)
+            return null;
+        return claudeTranscriptTurnState(file, launchedAfter !== undefined ? { launchedAfter } : {});
+    }
+    /**
+     * Get or create a session's record (bounded).
+     *
+     * @param sessionName - Session
+     * @param now - Clock
+     * @returns The record
+     */
+    recordFor(sessionName, now) {
+        let r = this.records.get(sessionName);
+        if (r)
+            return r;
+        if (this.records.size >= TURN_STATE_CONSTANTS.MAX_TRACKED_SESSIONS) {
+            const first = this.records.keys().next().value;
+            if (first !== undefined)
+                this.records.delete(first);
+        }
+        r = {
+            active: false,
+            activeSince: now,
+            lastEventAt: 0,
+            stoppedAt: null,
+            runtimeStartedAt: null,
+            openTools: new Map(),
+            subagents: new Map(),
+            heldSubagents: new Map(),
+            anonSeq: 0,
+        };
+        this.records.set(sessionName, r);
+        return r;
+    }
+}
+//# sourceMappingURL=agent-turn-state.js.map

package/dist/cli/backend/src/services/monitoring/agent-turn-state.js.map

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

package/dist/cli/backend/src/services/monitoring/claude-transcript-turn.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Claude Code transcript → turn state.
+ *
+ * Reads the end of a Claude Code conversation transcript (JSONL) and says
+ * whether the agent is mid-turn, done with its turn, or done but with
+ * background work (a subagent or a `run_in_background` shell) that will start
+ * another turn when it finishes. Fallback for the hook-fed turn state
+ * (specs/2026-10-02-restart-busy-and-resume.md).
+ *
+ * Completion notices (`<task-notification>…<tool-use-id>X</tool-use-id>`)
+ * reach the transcript in three shapes, and all three count: a `user`
+ * message, a `queue-operation` entry's `content`, and a `queued_command`
+ * `attachment`'s `prompt`. Reading only the first left about half of all
+ * transcripts ending in a false "background" (PR #1013 review).
+ *
+ * Launches older than the current runtime (`launchedAfter`) are ignored: a
+ * restart kills background work, and the resumed conversation still lists it.
+ *
+ * Only the main chain counts (`isSidechain` entries belong to subagents).
+ * Nothing read here is logged or stored beyond the verdict.
+ *
+ * @module services/monitoring/claude-transcript-turn
+ */
+/** What the transcript says. */
+export type TranscriptTurnVerdict = 'turn' | 'background' | 'idle' | 'unknown';
+/** Result of reading a transcript. */
+export interface TranscriptTurnState {
+    /** Verdict at the end of the file */
+    verdict: TranscriptTurnVerdict;
+    /** Epoch ms of the newest relevant entry (NaN when none) */
+    lastEntryAt: number;
+    /** Epoch ms of the newest turn end (end_turn, turn_duration, interrupt, API / usage-limit error); NaN when none */
+    turnEndedAt: number;
+    /** Background launches with no completion notice yet */
+    pendingBackground: number;
+    /** Epoch ms of the oldest pending background launch (NaN when none) */
+    oldestPendingAt: number;
+    /** File modification time (epoch ms) */
+    mtimeMs: number;
+}
+/** Options for parsing. */
+export interface TranscriptParseOptions {
+    /** Ignore background launches (and turn-end pending counts) older than this (epoch ms) */
+    launchedAfter?: number;
+}
+/**
+ * Turn state from transcript text (pure; exported for tests).
+ *
+ * @param text - JSONL text (a partial first line is ignored)
+ * @param mtimeMs - File modification time
+ * @param options - Runtime start filter
+ * @returns The state
+ */
+export declare function parseClaudeTranscriptTurn(text: string, mtimeMs?: number, options?: TranscriptParseOptions): TranscriptTurnState;
+/**
+ * Turn state of a transcript file, cached by (size, mtime, launchedAfter).
+ *
+ * @param filePath - Transcript path
+ * @param options - Runtime start filter
+ * @returns The state, or null when the file cannot be read
+ *
+ * @example
+ * ```typescript
+ * const s = claudeTranscriptTurnState('/Users/me/.claude/projects/-x/abc.jsonl', { launchedAfter: startedAt });
+ * if (s?.verdict === 'turn') // mid-turn
+ * ```
+ */
+export declare function claudeTranscriptTurnState(filePath: string, options?: TranscriptParseOptions): TranscriptTurnState | null;
+/**
+ * Forget cached transcript reads (tests only).
+ */
+export declare function resetTranscriptTurnCache(): void;
+//# sourceMappingURL=claude-transcript-turn.d.ts.map

package/dist/cli/backend/src/services/monitoring/claude-transcript-turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-transcript-turn.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/monitoring/claude-transcript-turn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,gCAAgC;AAChC,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/E,sCAAsC;AACtC,MAAM,WAAW,mBAAmB;IACnC,qCAAqC;IACrC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,mHAAmH;IACnH,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,eAAe,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,2BAA2B;AAC3B,MAAM,WAAW,sBAAsB;IACtC,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAsFD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAmB,EAAE,OAAO,GAAE,sBAA2B,GAAG,mBAAmB,CA4G/I;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,mBAAmB,GAAG,IAAI,CAmB5H;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}