@methodts/runtime 0.1.0

package/dist/sessions/cognitive-provider.js

@@ -0,0 +1,208 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Cognitive Agent Provider v3 — manual module composition (PRD 042 Phase 4).
+ *
+ * Architecture: BridgeMonitorModule + BridgeReasonerActorModule composed in a
+ * manual for-loop with monitor-first execution order. Module factories from
+ * cognitive-modules.ts encapsulate all behavioral logic (11 fixes from PRDs
+ * 033/040/041). This file owns the outer cycle engine and session lifecycle.
+ *
+ * Execution order per cycle:
+ *   1. Monitor reads last cycle's RA monitoring -> produces BridgeMonitorControl
+ *   2. RA runs inner while-loop with monitor's control applied immediately
+ *
+ * External interface unchanged: createCognitiveSession returning PtySession.
+ */
+import PQueue from 'p-queue';
+import { moduleId, createWorkspace } from '@methodts/pacta';
+import { createBridgeReasonerActorModule, createBridgeMonitorModule, } from './cognitive-modules.js';
+// ── Cost estimation constants ───────────────────────────────────
+// Sonnet ~$3/$15 per M tokens (input/output). Order of magnitude is fine.
+const INPUT_COST_PER_TOKEN = 3.0 / 1_000_000;
+const OUTPUT_COST_PER_TOKEN = 15.0 / 1_000_000;
+// ── Factory ─────────────────────────────────────────────────────
+export function createCognitiveSession(options) {
+    const { id, workdir, onEvent, adapter, tools, config: cfg, initialPrompt, cognitiveSink } = options;
+    const maxCycles = cfg?.maxCycles ?? 15;
+    const maxToolsPerCycle = cfg?.maxToolsPerCycle ?? 5;
+    const wsCapacity = cfg?.workspaceCapacity ?? 8;
+    const confThreshold = cfg?.confidenceThreshold ?? 0.3;
+    const stagThreshold = cfg?.stagnationThreshold ?? 2;
+    const intBudget = cfg?.interventionBudget ?? 5;
+    // 8192 gives enough room for Write tool calls on large outputs (reports, code files).
+    // 2048 caused no-action loops: plan used most tokens, leaving no room for the action JSON.
+    const maxOutputTokens = cfg?.maxOutputTokens ?? 8192;
+    const queue = new PQueue({ concurrency: 1 });
+    let status = 'ready';
+    let promptCount = 0;
+    let lastActivityAt = new Date();
+    let transcript = '';
+    const outputSubs = new Set();
+    const exitCbs = [];
+    const getStatus = () => status;
+    // ── Session-level workspace (persists across prompts) ─────────
+    const salienceCtx = {
+        now: Date.now(),
+        goals: ['complete the task', 'produce correct output'],
+        sourcePriorities: new Map([
+            [moduleId('reasoner-actor'), 0.9],
+            [moduleId('monitor'), 0.7],
+            [moduleId('observer'), 0.6],
+        ]),
+    };
+    const ws = createWorkspace({ capacity: wsCapacity }, salienceCtx);
+    // ── Session-level cumulative token/cost tracking ──────────────
+    let sessionInputTokens = 0;
+    let sessionOutputTokens = 0;
+    let sessionCostUsd = 0;
+    function notify(data) {
+        for (const sub of outputSubs) {
+            try {
+                sub(data);
+            }
+            catch { /* */ }
+        }
+    }
+    // ── Cognitive cycle ─────────────────────────────────────────
+    async function runCycle(prompt, onChunk) {
+        const obsPort = ws.getWritePort(moduleId('observer'));
+        const raWritePort = ws.getWritePort(moduleId('reasoner-actor'));
+        const raReadPort = ws.getReadPort(moduleId('reasoner-actor'));
+        // Observer: seed workspace with task
+        obsPort.write({ source: moduleId('observer'), content: prompt, salience: 0.95, timestamp: Date.now() });
+        obsPort.write({
+            source: moduleId('observer'),
+            content: `## TASK\n${prompt}\nComplete the task, then call "done". Do not continue after solving it.`,
+            salience: 0.95, timestamp: Date.now(),
+        });
+        let promptInputTokens = 0, promptOutputTokens = 0;
+        let lastOutput = '';
+        let actualCycles = 0;
+        // ── Instantiate modules — per-prompt, session-scoped dependencies injected ──
+        const monitorPort = ws.getWritePort(moduleId('monitor'));
+        const raConfig = {
+            maxToolsPerCycle, maxOutputTokens, wsCapacity, cycleNumber: 1, maxCycles,
+        };
+        const raModule = createBridgeReasonerActorModule(adapter, tools, ws, raWritePort, raReadPort, obsPort, raConfig, onEvent, cognitiveSink, onChunk);
+        const monModule = createBridgeMonitorModule(ws, monitorPort, wsCapacity, { confThreshold, stagThreshold, intBudget }, onEvent, cognitiveSink);
+        // State initialized per-prompt (not per-session).
+        let raState = raModule.initialState();
+        let monState = monModule.initialState();
+        let lastRAMonitoring = null;
+        for (let c = 0; c < maxCycles; c++) {
+            actualCycles = c + 1;
+            onEvent({ type: 'cycle-start', cycle: c + 1, maxCycles });
+            cognitiveSink?.handle({ type: 'cognitive:cycle_phase', phase: 'start', cycleNumber: c + 1, timestamp: Date.now() });
+            ws.resetCycleQuotas();
+            // Update cycle number in RA config (mutable field).
+            raConfig.cycleNumber = c + 1;
+            // Monitor runs FIRST — reads last cycle's RA monitoring, produces control.
+            // On cycle 0, lastRAMonitoring is null → monitor returns defaultControl (no interventions).
+            const monResult = await monModule.step(lastRAMonitoring, monState, { target: moduleId('monitor'), timestamp: Date.now() });
+            monState = monResult.state;
+            const control = monResult.output;
+            // RA runs SECOND — with this cycle's monitor control applied immediately.
+            const raResult = await raModule.step(prompt, raState, control);
+            raState = raResult.state;
+            lastRAMonitoring = raResult.monitoring;
+            // Accumulate token totals from per-cycle deltas.
+            promptInputTokens += raResult.monitoring.promptInputTokens;
+            promptOutputTokens += raResult.monitoring.promptOutputTokens;
+            if (raResult.monitoring.cycleDone) {
+                lastOutput = raResult.monitoring.lastOutput;
+                break;
+            }
+        }
+        // ── Accumulate into session-level totals ──
+        sessionInputTokens += promptInputTokens;
+        sessionOutputTokens += promptOutputTokens;
+        const promptCostUsd = promptInputTokens * INPUT_COST_PER_TOKEN + promptOutputTokens * OUTPUT_COST_PER_TOKEN;
+        sessionCostUsd += promptCostUsd;
+        const totalTokens = promptInputTokens + promptOutputTokens;
+        const output = lastOutput ||
+            (raState.foldedCtx.length > 0
+                ? `Cycle limit reached. Summary of actions:\n${raState.foldedCtx.slice(-5).join('\n')}`
+                : '(no output — cycle limit reached)');
+        onEvent({
+            type: 'done', output,
+            metadata: {
+                totalTokens,
+                totalCycles: actualCycles,
+                monitorInterventions: monState.interventions,
+                costUsd: promptCostUsd,
+                inputTokens: promptInputTokens,
+                outputTokens: promptOutputTokens,
+                sessionCostUsd,
+                sessionInputTokens,
+                sessionOutputTokens,
+                workdir,
+            },
+        });
+        return output;
+    }
+    // ── Shared prompt execution ─────────────────────────────────
+    function execPrompt(prompt, onChunk) {
+        if (status === 'dead')
+            return Promise.reject(new Error(`Session ${id} is dead`));
+        return queue.add(async () => {
+            if (status === 'dead')
+                throw new Error(`Session ${id} is dead`);
+            status = 'working';
+            promptCount++;
+            lastActivityAt = new Date();
+            notify(`\n[cognitive] Prompt #${promptCount}...\n`);
+            try {
+                const output = await runCycle(prompt, onChunk);
+                transcript += `\n--- Prompt #${promptCount} ---\n${prompt}\n--- Response ---\n${output}\n`;
+                notify(output);
+                lastActivityAt = new Date();
+                if (getStatus() !== 'dead')
+                    status = 'ready';
+                return { output, timedOut: false };
+            }
+            catch (err) {
+                lastActivityAt = new Date();
+                if (getStatus() !== 'dead')
+                    status = 'ready';
+                const msg = err.message;
+                notify(`\n[cognitive] Error: ${msg}\n`);
+                return { output: `Error: ${msg}`, timedOut: false };
+            }
+        });
+    }
+    // ── PtySession ────────────────────────────────────────────────
+    const session = {
+        id,
+        get pid() { return null; },
+        get status() { return status; },
+        set status(s) { status = s; },
+        get queueDepth() { return queue.size + queue.pending; },
+        get promptCount() { return promptCount; },
+        set promptCount(n) { promptCount = n; },
+        get lastActivityAt() { return lastActivityAt; },
+        set lastActivityAt(d) { lastActivityAt = d; },
+        get transcript() { return transcript; },
+        onOutput(cb) { outputSubs.add(cb); return () => { outputSubs.delete(cb); }; },
+        onExit(cb) { exitCbs.push(cb); },
+        sendPrompt(p) { return execPrompt(p); },
+        sendPromptStream(p, onChunk) { return execPrompt(p, onChunk); },
+        resize() { },
+        kill() {
+            status = 'dead';
+            outputSubs.clear();
+            for (const cb of exitCbs) {
+                try {
+                    cb(0);
+                }
+                catch { /* */ }
+            }
+        },
+        interrupt() { return false; },
+        get adaptiveSettle() { return null; },
+    };
+    if (initialPrompt) {
+        session.sendPrompt(initialPrompt).catch(() => { });
+    }
+    return session;
+}
+//# sourceMappingURL=cognitive-provider.js.map

package/dist/sessions/cognitive-provider.js.map

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

package/dist/sessions/cognitive-sink.d.ts

@@ -0,0 +1,73 @@
+/**
+ * CognitiveEventBusSink — bridges the pacta cognitive algebra (CognitiveEvent)
+ * to the Universal Event Bus (RuntimeEvent, PRD 026).
+ *
+ * PRD-057 / S2 §14 Q6 / C5: the class is named `CognitiveEventBusSink` to
+ * disambiguate from `@methodts/pacta`'s `CognitiveEvent` producer concept. The
+ * shorter legacy name `CognitiveSink` is aliased for back-compat in
+ * `@methodts/bridge/domains/sessions/cognitive-sink.ts` until C7 cleanup.
+ *
+ * The sink has two responsibilities:
+ *   1. Expose a handle(event: CognitiveEvent) method that cognitive-provider.ts
+ *      calls instead of emitting ad-hoc StreamEvents. The sink translates each
+ *      of the 9 CognitiveEvent algebra types into a typed RuntimeEvent and
+ *      emits it on the injected EventBus.
+ *   2. Implement EventSink so it can optionally be registered with the bus by
+ *      the composition root (server-entry.ts) for passthrough or fan-out use.
+ *
+ * Severity mapping:
+ *   info     — module_step, monitoring_signal, control_directive, workspace_write, cycle_phase
+ *   warning  — control_policy_violation, workspace_eviction, learn_failed
+ *   error    — cycle_aborted
+ *
+ * RuntimeEvent shape produced:
+ *   domain   = 'cognitive'
+ *   type     = 'cognitive.{variant}'   (colon replaced with dot, e.g. 'cognitive.module_step')
+ *   payload  = full CognitiveEvent data + optional experimentId, runId, cycleNumber fields
+ *   source   = 'runtime/sessions/cognitive-sink'
+ */
+import type { RuntimeEvent, RuntimeEventInput, EventBus, EventSink } from '../ports/event-bus.js';
+import type { CognitiveEvent } from '@methodts/pacta';
+export interface CognitiveEventContext {
+    sessionId?: string;
+    projectId?: string;
+    experimentId?: string;
+    runId?: string;
+}
+/**
+ * Adapter that translates typed CognitiveEvents from the pacta algebra
+ * into RuntimeEvents on the Universal Event Bus.
+ *
+ * Constructor-injected EventBus is the only hard dependency (port pattern, DR-15).
+ */
+export declare class CognitiveEventBusSink implements EventSink {
+    readonly name = "cognitive";
+    private readonly bus;
+    private context;
+    constructor(bus: EventBus, context?: CognitiveEventContext);
+    /**
+     * Update the ambient context attached to every emitted RuntimeEvent.
+     * Call when session, experiment, or run identity changes.
+     */
+    setContext(context: CognitiveEventContext): void;
+    /**
+     * Translate a CognitiveEvent into a RuntimeEvent and emit it on the bus.
+     * This is the method cognitive-provider.ts calls — one call per algebra event.
+     */
+    handle(event: CognitiveEvent): void;
+    /**
+     * EventSink.onEvent — receives RuntimeEvents already on the bus.
+     * Used when this sink is registered in the composition root for passthrough.
+     * Filters to domain='cognitive' and re-emits (no-op for other domains).
+     */
+    onEvent(_event: RuntimeEvent): void;
+    onError(error: Error, event: RuntimeEvent): void;
+    /**
+     * Map a CognitiveEvent to a RuntimeEventInput, deriving domain, type,
+     * severity, and payload from the algebra discriminant.
+     */
+    toRuntimeEventInput(event: CognitiveEvent): RuntimeEventInput;
+    /** @deprecated Alias retained for migration. Prefer `toRuntimeEventInput`. */
+    toBridgeEventInput(event: CognitiveEvent): RuntimeEventInput;
+}
+//# sourceMappingURL=cognitive-sink.d.ts.map

package/dist/sessions/cognitive-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive-sink.d.ts","sourceRoot":"","sources":["../../src/sessions/cognitive-sink.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAItD,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;;;GAKG;AACH,qBAAa,qBAAsB,YAAW,SAAS;IACrD,QAAQ,CAAC,IAAI,eAAe;IAE5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAW;IAC/B,OAAO,CAAC,OAAO,CAAwB;gBAE3B,GAAG,EAAE,QAAQ,EAAE,OAAO,GAAE,qBAA0B;IAO9D;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAMhD;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAOnC;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAMnC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAMhD;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB;IAkC7D,8EAA8E;IAC9E,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB;CAG7D"}

package/dist/sessions/cognitive-sink.js

@@ -0,0 +1,154 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * CognitiveEventBusSink — bridges the pacta cognitive algebra (CognitiveEvent)
+ * to the Universal Event Bus (RuntimeEvent, PRD 026).
+ *
+ * PRD-057 / S2 §14 Q6 / C5: the class is named `CognitiveEventBusSink` to
+ * disambiguate from `@methodts/pacta`'s `CognitiveEvent` producer concept. The
+ * shorter legacy name `CognitiveSink` is aliased for back-compat in
+ * `@methodts/bridge/domains/sessions/cognitive-sink.ts` until C7 cleanup.
+ *
+ * The sink has two responsibilities:
+ *   1. Expose a handle(event: CognitiveEvent) method that cognitive-provider.ts
+ *      calls instead of emitting ad-hoc StreamEvents. The sink translates each
+ *      of the 9 CognitiveEvent algebra types into a typed RuntimeEvent and
+ *      emits it on the injected EventBus.
+ *   2. Implement EventSink so it can optionally be registered with the bus by
+ *      the composition root (server-entry.ts) for passthrough or fan-out use.
+ *
+ * Severity mapping:
+ *   info     — module_step, monitoring_signal, control_directive, workspace_write, cycle_phase
+ *   warning  — control_policy_violation, workspace_eviction, learn_failed
+ *   error    — cycle_aborted
+ *
+ * RuntimeEvent shape produced:
+ *   domain   = 'cognitive'
+ *   type     = 'cognitive.{variant}'   (colon replaced with dot, e.g. 'cognitive.module_step')
+ *   payload  = full CognitiveEvent data + optional experimentId, runId, cycleNumber fields
+ *   source   = 'runtime/sessions/cognitive-sink'
+ */
+// ── CognitiveEventBusSink ───────────────────────────────────────
+/**
+ * Adapter that translates typed CognitiveEvents from the pacta algebra
+ * into RuntimeEvents on the Universal Event Bus.
+ *
+ * Constructor-injected EventBus is the only hard dependency (port pattern, DR-15).
+ */
+export class CognitiveEventBusSink {
+    name = 'cognitive';
+    bus;
+    context;
+    constructor(bus, context = {}) {
+        this.bus = bus;
+        this.context = context;
+    }
+    // ── Context mutation ─────────────────────────────────────────
+    /**
+     * Update the ambient context attached to every emitted RuntimeEvent.
+     * Call when session, experiment, or run identity changes.
+     */
+    setContext(context) {
+        this.context = { ...this.context, ...context };
+    }
+    // ── Primary entry point ──────────────────────────────────────
+    /**
+     * Translate a CognitiveEvent into a RuntimeEvent and emit it on the bus.
+     * This is the method cognitive-provider.ts calls — one call per algebra event.
+     */
+    handle(event) {
+        const input = this.toRuntimeEventInput(event);
+        this.bus.emit(input);
+    }
+    // ── EventSink interface (passthrough / fan-out) ───────────────
+    /**
+     * EventSink.onEvent — receives RuntimeEvents already on the bus.
+     * Used when this sink is registered in the composition root for passthrough.
+     * Filters to domain='cognitive' and re-emits (no-op for other domains).
+     */
+    onEvent(_event) {
+        // No-op: CognitiveEventBusSink is a producer, not a consumer. The composition
+        // root may register it as a sink for structural completeness, but this path
+        // is intentionally inert to avoid double-emission loops.
+    }
+    onError(error, event) {
+        console.error(`[cognitive-sink] Error processing event ${event.id}:`, error.message);
+    }
+    // ── Mapping logic ────────────────────────────────────────────
+    /**
+     * Map a CognitiveEvent to a RuntimeEventInput, deriving domain, type,
+     * severity, and payload from the algebra discriminant.
+     */
+    toRuntimeEventInput(event) {
+        const { sessionId, projectId, experimentId, runId } = this.context;
+        const source = 'runtime/sessions/cognitive-sink';
+        // Strip 'cognitive:' prefix and replace with dot form for runtime type
+        // convention: e.g. 'cognitive:module_step' → 'cognitive.module_step'.
+        const type = event.type.replace(':', '.');
+        const basePayload = {
+            ...event,
+        };
+        // Forward optional ambient context fields when present.
+        if (experimentId !== undefined)
+            basePayload.experimentId = experimentId;
+        if (runId !== undefined)
+            basePayload.runId = runId;
+        // cycleNumber is present on several event types — surface it at payload
+        // top-level for consumers that want to filter/group by cycle without
+        // parsing the full payload.
+        const cycleNumber = extractCycleNumber(event);
+        if (cycleNumber !== undefined)
+            basePayload.cycleNumber = cycleNumber;
+        return {
+            version: 1,
+            domain: 'cognitive',
+            type,
+            severity: deriveSeverity(event),
+            source,
+            ...(sessionId !== undefined && { sessionId }),
+            ...(projectId !== undefined && { projectId }),
+            payload: basePayload,
+        };
+    }
+    /** @deprecated Alias retained for migration. Prefer `toRuntimeEventInput`. */
+    toBridgeEventInput(event) {
+        return this.toRuntimeEventInput(event);
+    }
+}
+// ── Helpers ────────────────────────────────────────────────────
+/**
+ * Derive RuntimeEvent severity from the CognitiveEvent variant.
+ *
+ * info    — normal execution signals (steps, directives, writes, phases, monitoring)
+ * warning — anomalies that may require attention (policy violation, eviction, LEARN failure)
+ * error   — unrecoverable failures that halt the cycle (cycle aborted)
+ */
+function deriveSeverity(event) {
+    switch (event.type) {
+        case 'cognitive:module_step': return 'info';
+        case 'cognitive:monitoring_signal': return 'info';
+        case 'cognitive:control_directive': return 'info';
+        case 'cognitive:workspace_write': return 'info';
+        case 'cognitive:cycle_phase': return 'info';
+        case 'cognitive:control_policy_violation': return 'warning';
+        case 'cognitive:workspace_eviction': return 'warning';
+        case 'cognitive:learn_failed': return 'warning';
+        case 'cognitive:cycle_aborted': return 'error';
+        default:
+            // Exhaustive check — TypeScript narrows to never here.
+            // Runtime fallback for forward-compatibility with new event types.
+            return 'info';
+    }
+}
+/**
+ * Extract cycleNumber from events that carry it, returning undefined otherwise.
+ */
+function extractCycleNumber(event) {
+    switch (event.type) {
+        case 'cognitive:cycle_phase': return event.cycleNumber;
+        case 'cognitive:learn_failed': return event.cycleNumber;
+        case 'cognitive:cycle_aborted': return event.cycleNumber;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=cognitive-sink.js.map

package/dist/sessions/cognitive-sink.js.map

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

package/dist/sessions/diagnostics.d.ts

@@ -0,0 +1,70 @@
+import type { AdaptiveSettleDelay } from './print-session.js';
+export interface SessionDiagnostics {
+    /** Time from spawn to first PTY output (ms). */
+    time_to_first_output_ms: number | null;
+    /** Time from spawn to first tool call detection (ms). */
+    time_to_first_tool_ms: number | null;
+    /** Total tool calls observed (from PTY watcher). */
+    tool_call_count: number;
+    /** Total settle delay overhead (sum of all settle waits, ms). */
+    total_settle_overhead_ms: number;
+    /** Number of false-positive settle cutoffs detected. */
+    false_positive_settles: number;
+    /** Current adaptive settle delay (ms). */
+    current_settle_delay_ms: number;
+    /** Number of times the session went idle (back to prompt). */
+    idle_transitions: number;
+    /** Longest continuous idle period (ms). */
+    longest_idle_ms: number;
+    /** Whether the session ever received a permission prompt. */
+    permission_prompt_detected: boolean;
+    /** Stall classification (null if not stalled). */
+    stall_reason: 'resource_contention' | 'permission_blocked' | 'task_complexity' | 'unknown' | null;
+}
+/**
+ * Per-session diagnostics tracker. Created at spawn, collects metrics
+ * throughout the session lifetime, produces snapshots on demand.
+ */
+export declare class DiagnosticsTracker {
+    private readonly spawnedAt;
+    private firstOutputAt;
+    private firstToolAt;
+    private _toolCallCount;
+    private _totalSettleOverheadMs;
+    private _falsePositiveSettles;
+    private readonly _settleDelayMs;
+    private _idleTransitions;
+    private _longestIdleMs;
+    private _idleStartedAt;
+    private _permissionPromptDetected;
+    /** PRD 012 Phase 2: Optional adaptive settle reference for dynamic metrics. */
+    private readonly _adaptiveSettle;
+    constructor(settleDelayMs: number, adaptiveSettle?: AdaptiveSettleDelay | null);
+    /** Called on first PTY data chunk. */
+    recordFirstOutput(): void;
+    /** Called when PTY watcher detects a tool call. */
+    recordToolCall(): void;
+    /** Called when PTY watcher detects an idle transition (prompt char after activity). */
+    recordIdleTransition(): void;
+    /** Called when any non-idle activity is detected — ends the current idle period. */
+    recordActivity(): void;
+    /** Called when a permission prompt is detected in PTY output. */
+    recordPermissionPrompt(): void;
+    /** Called after each prompt response completes. Adds one settle wait to overhead. */
+    recordPromptCompletion(): void;
+    /** Returns current diagnostics snapshot. */
+    snapshot(): SessionDiagnostics;
+    /**
+     * Classify the stall reason for an idle session.
+     * Called by the pool when building status for a stale/idle session.
+     *
+     * PRD 012 heuristic:
+     * - No tool calls ever → permission_blocked
+     * - Tool calls + many idle transitions → task_complexity
+     * - Slow first output + other agents slow → resource_contention
+     * - None of above → unknown
+     */
+    classifyStall(otherSessionsSlow: boolean): SessionDiagnostics['stall_reason'];
+    private endIdlePeriod;
+}
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/sessions/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/sessions/diagnostics.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,yDAAyD;IACzD,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,wBAAwB,EAAE,MAAM,CAAC;IACjC,wDAAwD;IACxD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,0CAA0C;IAC1C,uBAAuB,EAAE,MAAM,CAAC;IAChC,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,0BAA0B,EAAE,OAAO,CAAC;IACpC,kDAAkD;IAClD,YAAY,EAAE,qBAAqB,GAAG,oBAAoB,GAAG,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAAC;CACnG;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,sBAAsB,CAAK;IACnC,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,yBAAyB,CAAS;IAC1C,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;gBAEjD,aAAa,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAM9E,sCAAsC;IACtC,iBAAiB,IAAI,IAAI;IAMzB,mDAAmD;IACnD,cAAc,IAAI,IAAI;IAStB,uFAAuF;IACvF,oBAAoB,IAAI,IAAI;IAK5B,oFAAoF;IACpF,cAAc,IAAI,IAAI;IAItB,iEAAiE;IACjE,sBAAsB,IAAI,IAAI;IAI9B,qFAAqF;IACrF,sBAAsB,IAAI,IAAI;IAQ9B,4CAA4C;IAC5C,QAAQ,IAAI,kBAAkB;IAgC9B;;;;;;;;;OASG;IACH,aAAa,CAAC,iBAAiB,EAAE,OAAO,GAAG,kBAAkB,CAAC,cAAc,CAAC;IAe7E,OAAO,CAAC,aAAa;CAStB"}