@agentmeshhq/agent 0.4.15 → 0.4.18

package/dist/core/daemon/startup-diagnostics.js

@@ -0,0 +1,277 @@
+/**
+ * Startup Diagnostics for Agent Tmux Sessions
+ *
+ * Provides structured logging for runner startup to diagnose
+ * session creation failures and early exits.
+ */
+import { execSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const DIAGNOSTICS_DIR = path.join(os.homedir(), ".agentmesh", "diagnostics");
+const STARTUP_WINDOW_MS = 15000; // 15 second window for startup monitoring
+/**
+ * Ensures the diagnostics directory exists
+ */
+function ensureDiagnosticsDir() {
+    if (!fs.existsSync(DIAGNOSTICS_DIR)) {
+        fs.mkdirSync(DIAGNOSTICS_DIR, { recursive: true });
+    }
+}
+/**
+ * Gets the path to the diagnostics log file for an agent
+ */
+function getDiagnosticsPath(agentName) {
+    return path.join(DIAGNOSTICS_DIR, `${agentName}-startup.jsonl`);
+}
+/**
+ * Redacts sensitive environment variable values, keeping only keys
+ */
+export function redactEnvKeys(env) {
+    const sensitiveKeys = new Set([
+        "token",
+        "key",
+        "secret",
+        "password",
+        "auth",
+        "credential",
+        "api_key",
+        "apikey",
+    ]);
+    return Object.entries(env)
+        .filter(([, value]) => value !== undefined && value !== "")
+        .map(([key]) => {
+        const lowerKey = key.toLowerCase();
+        // Mark sensitive keys with [REDACTED] suffix
+        const isSensitive = sensitiveKeys.has(lowerKey) || [...sensitiveKeys].some((sk) => lowerKey.includes(sk));
+        return isSensitive ? `${key}=[REDACTED]` : key;
+    });
+}
+/**
+ * Detects the runner type from the command
+ */
+export function detectRunnerKind(command) {
+    const cmd = command.trim().toLowerCase();
+    if (cmd.startsWith("opencode"))
+        return "opencode";
+    if (cmd.startsWith("claude"))
+        return "claude";
+    if (cmd.startsWith("codex"))
+        return "codex";
+    return "other";
+}
+/**
+ * Logs startup diagnostics for a new tmux session
+ */
+export function logSessionStartup(agentName, diagnostics) {
+    ensureDiagnosticsDir();
+    const entry = {
+        type: "startup",
+        timestamp: new Date().toISOString(),
+        agentName,
+        data: diagnostics,
+    };
+    const logPath = getDiagnosticsPath(agentName);
+    fs.appendFileSync(logPath, `${JSON.stringify(entry)}\n`);
+    // Also log to console for immediate visibility
+    console.log(`[STARTUP] ${agentName}: ${diagnostics.resolvedCommand}`);
+    console.log(`[STARTUP] Runner: ${diagnostics.runnerKind}, Autonomous: ${diagnostics.autonomous ?? false}`);
+}
+/**
+ * Logs a process exit event
+ */
+export function logProcessExit(agentName, exitEvent) {
+    ensureDiagnosticsDir();
+    const entry = {
+        type: "exit",
+        timestamp: new Date().toISOString(),
+        agentName,
+        data: exitEvent,
+    };
+    const logPath = getDiagnosticsPath(agentName);
+    fs.appendFileSync(logPath, `${JSON.stringify(entry)}\n`);
+    // Log with appropriate severity
+    const severity = exitEvent.elapsedMs < STARTUP_WINDOW_MS ? "ERROR" : "WARN";
+    console.log(`[${severity}] ${agentName}: Process exited (code=${exitEvent.code}, signal=${exitEvent.signal}, elapsed=${exitEvent.elapsedMs}ms) - ${exitEvent.reason}`);
+}
+/**
+ * Reads the recent diagnostics for an agent
+ */
+export function readStartupDiagnostics(agentName) {
+    try {
+        const logPath = getDiagnosticsPath(agentName);
+        if (!fs.existsSync(logPath)) {
+            return [];
+        }
+        const content = fs.readFileSync(logPath, "utf-8");
+        return content
+            .trim()
+            .split("\n")
+            .filter(Boolean)
+            .map((line) => JSON.parse(line));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Clears old diagnostics for an agent (keeps last 100 entries)
+ */
+export function cleanupOldDiagnostics(agentName) {
+    try {
+        const entries = readStartupDiagnostics(agentName);
+        if (entries.length <= 100)
+            return;
+        const logPath = getDiagnosticsPath(agentName);
+        const recent = entries.slice(-100);
+        fs.writeFileSync(logPath, `${recent.map((e) => JSON.stringify(e)).join("\n")}\n`);
+    }
+    catch {
+        // Non-fatal: cleanup failure should not break anything
+    }
+}
+/**
+ * Captures the current pane PID for an agent's session
+ */
+export function capturePanePid(sessionName) {
+    try {
+        const output = execSync(`tmux list-panes -t "${sessionName}" -F "#{pane_pid}"`, {
+            encoding: "utf-8",
+            timeout: 5000,
+        }).trim();
+        const pid = parseInt(output, 10);
+        return Number.isNaN(pid) ? null : pid;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Monitors a tmux session for early process exit
+ * Returns a cleanup function to stop monitoring
+ */
+export function monitorSessionExit(agentName, sessionName, startTime, onEarlyExit) {
+    const initialPid = capturePanePid(sessionName);
+    let checkInterval = null;
+    let hasExited = false;
+    // Stop monitoring after startup window + grace period
+    const stopMonitoringAt = startTime.getTime() + STARTUP_WINDOW_MS + 5000;
+    checkInterval = setInterval(() => {
+        if (hasExited)
+            return;
+        const now = Date.now();
+        if (now > stopMonitoringAt) {
+            // Startup window passed, stop monitoring
+            if (checkInterval) {
+                clearInterval(checkInterval);
+                checkInterval = null;
+            }
+            return;
+        }
+        try {
+            // Check if session still exists
+            execSync(`tmux has-session -t "${sessionName}" 2>/dev/null`, { timeout: 1000 });
+            // Check if pane is dead
+            const paneInfo = execSync(`tmux list-panes -t "${sessionName}" -F "#{pane_pid}:#{pane_dead}" 2>/dev/null`, { encoding: "utf-8", timeout: 1000 }).trim();
+            const [currentPidStr, dead] = paneInfo.split(":");
+            const currentPid = parseInt(currentPidStr, 10);
+            if (dead === "1") {
+                hasExited = true;
+                const elapsedMs = now - startTime.getTime();
+                const event = {
+                    code: null,
+                    signal: null,
+                    elapsedMs,
+                    reason: "pane_died",
+                };
+                logProcessExit(agentName, event);
+                onEarlyExit?.(event);
+                if (checkInterval) {
+                    clearInterval(checkInterval);
+                    checkInterval = null;
+                }
+                return;
+            }
+            // Check if PID changed (process restarted/exited)
+            if (initialPid && !Number.isNaN(currentPid) && currentPid !== initialPid && initialPid > 0) {
+                hasExited = true;
+                const elapsedMs = now - startTime.getTime();
+                const event = {
+                    code: null,
+                    signal: null,
+                    elapsedMs,
+                    reason: "process_replaced",
+                };
+                logProcessExit(agentName, event);
+                onEarlyExit?.(event);
+                if (checkInterval) {
+                    clearInterval(checkInterval);
+                    checkInterval = null;
+                }
+            }
+        }
+        catch {
+            // Session no longer exists - process exited
+            if (!hasExited) {
+                hasExited = true;
+                const elapsedMs = now - startTime.getTime();
+                const event = {
+                    code: null,
+                    signal: null,
+                    elapsedMs,
+                    reason: "session_terminated",
+                };
+                logProcessExit(agentName, event);
+                onEarlyExit?.(event);
+                if (checkInterval) {
+                    clearInterval(checkInterval);
+                    checkInterval = null;
+                }
+            }
+        }
+    }, 1000); // Check every second
+    // Return cleanup function
+    return () => {
+        if (checkInterval) {
+            clearInterval(checkInterval);
+            checkInterval = null;
+        }
+    };
+}
+/**
+ * Formats a diagnostic summary for display
+ */
+export function formatDiagnosticSummary(agentName) {
+    const entries = readStartupDiagnostics(agentName);
+    if (entries.length === 0) {
+        return `No startup diagnostics found for ${agentName}`;
+    }
+    const recent = entries.slice(-5); // Last 5 entries
+    const lines = [
+        `\n=== Startup Diagnostics for ${agentName} ===`,
+        `Total entries: ${entries.length}`,
+        "",
+    ];
+    for (const entry of recent) {
+        if (entry.type === "startup") {
+            const data = entry.data;
+            lines.push(`[${entry.timestamp}] STARTUP`);
+            lines.push(`  Command: ${data.resolvedCommand}`);
+            lines.push(`  Runner: ${data.runnerKind}`);
+            lines.push(`  Session: ${data.sessionName}`);
+            lines.push(`  Workdir: ${data.workdir ?? "(not set)"}`);
+            lines.push(`  Autonomous: ${data.autonomous ?? false}`);
+            lines.push(`  Env vars: ${data.envKeys.join(", ")}`);
+        }
+        else {
+            const data = entry.data;
+            lines.push(`[${entry.timestamp}] EXIT`);
+            lines.push(`  Code: ${data.code ?? "N/A"}, Signal: ${data.signal ?? "N/A"}`);
+            lines.push(`  Elapsed: ${data.elapsedMs}ms`);
+            lines.push(`  Reason: ${data.reason}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=startup-diagnostics.js.map

package/dist/core/daemon/startup-diagnostics.js.map

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

package/dist/core/daemon/watcher-loop.d.ts

@@ -0,0 +1,27 @@
+/**
+ * LLM-powered watcher loop.
+ *
+ * Two event sources feed the tick queue:
+ *   1. Scheduled ticker — every 2 min, full state fetch
+ *   2. WebSocket events — immediate reactive ticks (coalesced while LLM is busy)
+ *
+ * A consumer loop polls every 5s:
+ *   - If LLM is processing → check tmux for completion
+ *   - If idle and queue has items → dequeue, fetch state, inject into tmux
+ *
+ * Epic #883
+ */
+import type { WatcherTickQueue } from "./watcher-queue.js";
+import { type WatcherContext } from "./watcher-state.js";
+export interface WatcherLoopHandle {
+    stop: () => void;
+}
+export declare function startWatcherLoop(ctx: WatcherContext, queue: WatcherTickQueue): WatcherLoopHandle;
+/**
+ * Intercept WebSocket events relevant to the watcher and enqueue reactive ticks.
+ * Returns true if the event was consumed (watcher-relevant), false otherwise.
+ */
+export declare function handleWatcherWebSocketEvent(event: {
+    type: string;
+    [key: string]: unknown;
+}, queue: WatcherTickQueue): boolean;

package/dist/core/daemon/watcher-loop.js

@@ -0,0 +1,134 @@
+/**
+ * LLM-powered watcher loop.
+ *
+ * Two event sources feed the tick queue:
+ *   1. Scheduled ticker — every 2 min, full state fetch
+ *   2. WebSocket events — immediate reactive ticks (coalesced while LLM is busy)
+ *
+ * A consumer loop polls every 5s:
+ *   - If LLM is processing → check tmux for completion
+ *   - If idle and queue has items → dequeue, fetch state, inject into tmux
+ *
+ * Epic #883
+ */
+import { captureSessionOutput, sendKeys } from "../tmux.js";
+import { fetchWatcherState, formatStateForLlm } from "./watcher-state.js";
+const TICK_INTERVAL_MS = 120_000; // 2 minutes
+const CONSUMER_POLL_MS = 5_000; // 5 seconds
+const IDLE_THRESHOLD_MS = 10_000; // 10s no output change → tick complete
+const HARD_TIMEOUT_MS = 180_000; // 3 min max per tick
+/**
+ * Detect whether the LLM has finished processing by checking tmux output
+ * stability. Returns true if the output hasn't changed for IDLE_THRESHOLD_MS.
+ */
+function detectTickComplete(agentName, lastOutputSnapshot, lastOutputChangeAt) {
+    const current = captureSessionOutput(agentName, 30);
+    const now = Date.now();
+    if (current !== lastOutputSnapshot) {
+        // Output changed — LLM is still working
+        return { complete: false, currentOutput: current };
+    }
+    // Output stable — check if long enough
+    if (now - lastOutputChangeAt >= IDLE_THRESHOLD_MS) {
+        return { complete: true, currentOutput: current };
+    }
+    return { complete: false, currentOutput: current };
+}
+export function startWatcherLoop(ctx, queue) {
+    let lastInjectionAt = 0;
+    let lastOutputSnapshot = null;
+    let lastOutputChangeAt = 0;
+    let stopped = false;
+    // --- Scheduled ticker: enqueue a scheduled tick every 2 min ---
+    const scheduledTimer = setInterval(() => {
+        if (stopped)
+            return;
+        queue.enqueue("scheduled", ["interval"]);
+        ctx.log("[watcher-loop] Scheduled tick enqueued");
+    }, TICK_INTERVAL_MS);
+    // Enqueue the first tick immediately
+    queue.enqueue("scheduled", ["startup"]);
+    // --- Consumer loop: process one tick at a time ---
+    const consumerTimer = setInterval(async () => {
+        if (stopped)
+            return;
+        try {
+            if (queue.isProcessing()) {
+                // Check if LLM finished processing
+                const elapsed = Date.now() - lastInjectionAt;
+                if (elapsed >= HARD_TIMEOUT_MS) {
+                    ctx.log(`[watcher-loop] Hard timeout (${Math.round(elapsed / 1000)}s) — forcing tick complete`);
+                    queue.markComplete();
+                    return;
+                }
+                const { complete, currentOutput } = detectTickComplete(ctx.agentName, lastOutputSnapshot, lastOutputChangeAt);
+                if (currentOutput !== lastOutputSnapshot) {
+                    lastOutputSnapshot = currentOutput;
+                    lastOutputChangeAt = Date.now();
+                }
+                if (complete) {
+                    ctx.log("[watcher-loop] Tick complete (output idle)");
+                    queue.markComplete();
+                }
+                return;
+            }
+            // Not processing — check if there's a tick to dequeue
+            if (queue.size() === 0)
+                return;
+            const tick = queue.dequeue();
+            if (!tick)
+                return;
+            const tickNumber = queue.nextTickNumber();
+            ctx.log(`[watcher-loop] Processing tick #${tickNumber} (${tick.source}: ${tick.triggeredBy.join(", ")})`);
+            // Fetch fresh state from hub
+            const state = await fetchWatcherState(ctx);
+            // Format and inject into tmux
+            const message = formatStateForLlm(state, tickNumber, tick.triggeredBy);
+            const sent = sendKeys(ctx.agentName, message);
+            if (!sent) {
+                ctx.log("[watcher-loop] Failed to inject tick into tmux — marking complete");
+                queue.markComplete();
+                return;
+            }
+            // Track for completion detection
+            lastInjectionAt = Date.now();
+            lastOutputSnapshot = captureSessionOutput(ctx.agentName, 30);
+            lastOutputChangeAt = Date.now();
+        }
+        catch (err) {
+            ctx.log(`[watcher-loop] Consumer error: ${err.message}`);
+            // If processing, mark complete to avoid stuck state
+            if (queue.isProcessing()) {
+                queue.markComplete();
+            }
+        }
+    }, CONSUMER_POLL_MS);
+    return {
+        stop() {
+            stopped = true;
+            clearInterval(scheduledTimer);
+            clearInterval(consumerTimer);
+            ctx.log("[watcher-loop] Stopped");
+        },
+    };
+}
+/**
+ * Intercept WebSocket events relevant to the watcher and enqueue reactive ticks.
+ * Returns true if the event was consumed (watcher-relevant), false otherwise.
+ */
+export function handleWatcherWebSocketEvent(event, queue) {
+    const watcherEvents = new Set([
+        "handoff.received",
+        "handoff.created",
+        "handoffs.updated",
+        "claims.updated",
+        "blockers.updated",
+        "blocker.resolved",
+    ]);
+    if (watcherEvents.has(event.type)) {
+        queue.enqueue("reactive", [event.type]);
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=watcher-loop.js.map

package/dist/core/daemon/watcher-loop.js.map

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

package/dist/core/daemon/watcher-queue.d.ts

@@ -0,0 +1,33 @@
+/**
+ * In-memory tick queue for the LLM-powered watcher.
+ *
+ * Coalesces rapid WebSocket events into a single reactive tick and replaces
+ * stale scheduled ticks so the LLM always gets the freshest state.
+ *
+ * Epic #883
+ */
+export type TickSource = "scheduled" | "reactive";
+export interface TickItem {
+    source: TickSource;
+    triggeredBy: string[];
+    queuedAt: Date;
+}
+export declare class WatcherTickQueue {
+    private queue;
+    private processing;
+    private tickCounter;
+    /**
+     * Enqueue a tick with deduplication:
+     * - Reactive + reactive → coalesce (merge triggeredBy, keep latest queuedAt)
+     * - Scheduled + scheduled → replace (only latest snapshot matters)
+     * - Otherwise → push new item
+     */
+    enqueue(source: TickSource, triggeredBy: string[]): void;
+    dequeue(): TickItem | null;
+    markComplete(): void;
+    isProcessing(): boolean;
+    size(): number;
+    nextTickNumber(): number;
+    /** Reset for testing */
+    clear(): void;
+}

package/dist/core/daemon/watcher-queue.js

@@ -0,0 +1,71 @@
+/**
+ * In-memory tick queue for the LLM-powered watcher.
+ *
+ * Coalesces rapid WebSocket events into a single reactive tick and replaces
+ * stale scheduled ticks so the LLM always gets the freshest state.
+ *
+ * Epic #883
+ */
+const MAX_QUEUE_SIZE = 10;
+export class WatcherTickQueue {
+    queue = [];
+    processing = false;
+    tickCounter = 0;
+    /**
+     * Enqueue a tick with deduplication:
+     * - Reactive + reactive → coalesce (merge triggeredBy, keep latest queuedAt)
+     * - Scheduled + scheduled → replace (only latest snapshot matters)
+     * - Otherwise → push new item
+     */
+    enqueue(source, triggeredBy) {
+        const last = this.queue.at(-1);
+        if (last && source === "reactive" && last.source === "reactive") {
+            // Coalesce: merge trigger reasons, update timestamp
+            for (const t of triggeredBy) {
+                if (!last.triggeredBy.includes(t)) {
+                    last.triggeredBy.push(t);
+                }
+            }
+            last.queuedAt = new Date();
+            return;
+        }
+        if (last && source === "scheduled" && last.source === "scheduled") {
+            // Replace stale scheduled tick
+            last.triggeredBy = triggeredBy;
+            last.queuedAt = new Date();
+            return;
+        }
+        if (this.queue.length >= MAX_QUEUE_SIZE) {
+            // Drop oldest to prevent unbounded growth
+            this.queue.shift();
+        }
+        this.queue.push({ source, triggeredBy, queuedAt: new Date() });
+    }
+    dequeue() {
+        const item = this.queue.shift() ?? null;
+        if (item) {
+            this.processing = true;
+        }
+        return item;
+    }
+    markComplete() {
+        this.processing = false;
+    }
+    isProcessing() {
+        return this.processing;
+    }
+    size() {
+        return this.queue.length;
+    }
+    nextTickNumber() {
+        this.tickCounter += 1;
+        return this.tickCounter;
+    }
+    /** Reset for testing */
+    clear() {
+        this.queue = [];
+        this.processing = false;
+        this.tickCounter = 0;
+    }
+}
+//# sourceMappingURL=watcher-queue.js.map

package/dist/core/daemon/watcher-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher-queue.js","sourceRoot":"","sources":["../../../src/core/daemon/watcher-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B,MAAM,OAAO,gBAAgB;IACnB,KAAK,GAAe,EAAE,CAAC;IACvB,UAAU,GAAG,KAAK,CAAC;IACnB,WAAW,GAAG,CAAC,CAAC;IAExB;;;;;OAKG;IACH,OAAO,CAAC,MAAkB,EAAE,WAAqB;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAE/B,IAAI,IAAI,IAAI,MAAM,KAAK,UAAU,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAChE,oDAAoD;YACpD,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;gBAC5B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;oBAClC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,IAAI,IAAI,IAAI,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAClE,+BAA+B;YAC/B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;YAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC;YACxC,0CAA0C;YAC1C,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,OAAO;QACL,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC;QACxC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY;QACV,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,wBAAwB;IACxB,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACvB,CAAC;CACF"}

package/dist/core/daemon/watcher-state.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Fetches project state from hub APIs and formats it for LLM injection.
+ *
+ * Each tick sends a full snapshot — the LLM reasons from a single tick
+ * without needing conversation history.
+ *
+ * Epic #883
+ */
+export interface WatcherContext {
+    hubUrl: string;
+    token: string;
+    workspace: string;
+    teamId: string;
+    agentName: string;
+    log: (msg: string) => void;
+}
+interface HandoffSnapshot {
+    handoff_id: string;
+    from_agent_id: string | null;
+    to_agent_id: string | null;
+    scope: string;
+    status: string;
+    created_at: string;
+    accepted_at: string | null;
+}
+interface ClaimSnapshot {
+    claim_id: string;
+    agent_id: string;
+    scope: string;
+    paths: string[];
+    status: string;
+    expires_at: string;
+}
+interface BlockerSnapshot {
+    blocker_id: string;
+    agent_id: string;
+    scope: string;
+    category: string;
+    description: string;
+    status: string;
+    created_at: string;
+}
+interface AgentSnapshot {
+    agent_id: string;
+    display_name: string;
+    status: string;
+    model: string;
+    last_heartbeat_at: string | null;
+    metadata?: Record<string, unknown>;
+}
+interface TeamMemberSnapshot {
+    agent_id: string;
+    display_name: string;
+    role: string;
+}
+export interface WatcherStatePayload {
+    fetchedAt: string;
+    handoffs: HandoffSnapshot[];
+    claims: ClaimSnapshot[];
+    blockers: BlockerSnapshot[];
+    agents: AgentSnapshot[];
+    teamMembers: TeamMemberSnapshot[];
+}
+export declare function fetchWatcherState(ctx: WatcherContext): Promise<WatcherStatePayload>;
+export declare function formatStateForLlm(state: WatcherStatePayload, tickNumber: number, triggerReasons: string[]): string;
+export {};