@nicofains1/agentwatch 0.1.0

package/README.md

@@ -0,0 +1,127 @@
+# @nicofains1/agentwatch
+
+Observability for multi-agent systems. Track heartbeats, trace cross-agent actions, detect cascade failures, and replay what went wrong.
+
+Built for teams running fleets of AI agents (CrewAI, AutoGen, LangGraph, custom) who need to understand why Agent B failed after Agent A timed out.
+
+## Install
+
+```bash
+npm install @nicofains1/agentwatch
+```
+
+## Quick Start
+
+```typescript
+import { AgentWatch } from '@nicofains1/agentwatch';
+
+const aw = new AgentWatch(); // uses agentwatch.db by default
+
+// Register heartbeats from your agents
+aw.report('agent-a', 'healthy');
+aw.report('agent-b', 'healthy');
+
+// Trace cross-agent actions
+const traceId = aw.createTraceId();
+
+const e1 = aw.trace(traceId, 'agent-a', 'fetch-data', 'url=https://api.example.com', 'rows=150');
+const e2 = aw.trace(traceId, 'agent-b', 'process', JSON.stringify({ rows: 150 }), '', {
+  parentEventId: e1.id,
+  status: 'error',
+  durationMs: 4200,
+});
+
+// Find the root cause
+const chain = aw.correlate(e2.id);
+console.log(chain?.root_cause); // -> agent-a / fetch-data
+
+// Fleet dashboard
+console.log(aw.dashboardText());
+```
+
+## Features
+
+**Heartbeat registration** - Track agent health status over time. Detect stale or offline agents based on configurable thresholds.
+
+**Cross-agent tracing** - Link actions across agents with trace IDs and parent event references. When agent-c fails because agent-b sent bad data that it got from agent-a, the trace shows the full chain.
+
+**Cascade failure detection** - Walk backward from any failure to find the root cause across your agent fleet. `correlate(failureEventId)` returns the full chain from root cause to final failure.
+
+**Alert de-duplication** - Same alert type from the same agent within a time window gets collapsed into one alert with an incrementing count. Severity auto-escalates: info (1x) -> warning (3x) -> critical (10x).
+
+**Fleet dashboard** - One-line summary of your entire fleet: which agents are healthy, degraded, erroring, or offline. Uptime percentages and active alert counts per agent.
+
+**Forensic replay** - Given a trace ID, replay all cascade chains to understand the full failure sequence.
+
+## CLI
+
+```bash
+npx agentwatch dashboard              # Fleet health overview
+npx agentwatch cascade <event-id>     # Trace cascade from a failure
+npx agentwatch failures [agent]       # List recent failures
+npx agentwatch alerts [agent]         # List active alerts
+npx agentwatch replay <trace-id>      # Replay all cascades in a trace
+```
+
+Set `AGENTWATCH_DB` to point to your database file (default: `agentwatch.db`).
+
+## API
+
+### `new AgentWatch(config?)`
+
+```typescript
+const aw = new AgentWatch({
+  db_path: 'agentwatch.db',       // SQLite file path (default: agentwatch.db)
+  alert_window_minutes: 30,        // De-dup window for alerts (default: 30)
+  heartbeat_stale_minutes: 30,     // When to mark agents as offline (default: 30)
+});
+```
+
+### Heartbeats
+
+```typescript
+aw.report(agent: string, status: 'healthy' | 'degraded' | 'error' | 'offline', context?: string)
+aw.getLatestHeartbeat(agent: string): Heartbeat | undefined
+aw.getFleetHealth(): AgentHealth[]
+```
+
+### Tracing
+
+```typescript
+aw.createTraceId(): string
+aw.trace(traceId, agent, action, input, output, opts?): TraceEvent
+aw.getTraceEvents(traceId: string): TraceEvent[]
+aw.getRecentFailures(agent?: string, limit?: number): TraceEvent[]
+```
+
+### Cascade Detection
+
+```typescript
+aw.correlate(failureEventId: number): CascadeChain | null
+aw.replay(traceId: string): CascadeChain[]
+```
+
+### Alerts
+
+```typescript
+aw.alert(agent, alertType, message): Alert
+aw.resolveAlert(alertId: number): void
+aw.activeAlerts(agent?: string): Alert[]
+```
+
+### Dashboard
+
+```typescript
+aw.dashboard(): DashboardOutput
+aw.dashboardText(): string
+```
+
+## Storage
+
+Uses SQLite via `better-sqlite3`. The database file is created automatically on first use. WAL mode is enabled for concurrent reads.
+
+Tables: `heartbeats`, `trace_events`, `alerts` - all with proper indexes for fast lookups.
+
+## License
+
+MIT

package/dist/alerts.d.ts

@@ -0,0 +1,11 @@
+import type Database from 'better-sqlite3';
+import type { Alert } from './types.js';
+/**
+ * Record an alert with de-duplication.
+ * If the same (agent, alert_type) exists within the window, increment count.
+ * Escalate severity based on count: 1 = info, 3+ = warning, 10+ = critical.
+ */
+export declare function recordAlert(db: Database.Database, agent: string, alertType: string, message: string, windowMinutes?: number): Alert;
+export declare function resolveAlert(db: Database.Database, alertId: number): void;
+export declare function getActiveAlerts(db: Database.Database, agent?: string): Alert[];
+//# sourceMappingURL=alerts.d.ts.map

package/dist/alerts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../src/alerts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAiB,MAAM,YAAY,CAAC;AAOvD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,aAAa,GAAE,MAAW,GACzB,KAAK,CAuCP;AAED,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,MAAM,GACd,IAAI,CAEN;AAED,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,CAAC,EAAE,MAAM,GACb,KAAK,EAAE,CAWT"}

package/dist/alerts.js

@@ -0,0 +1,67 @@
+function sqliteNow(offsetMs = 0) {
+    const d = new Date(Date.now() + offsetMs);
+    return d.toISOString().replace('T', ' ').replace(/\.\d{3}Z$/, '');
+}
+/**
+ * Record an alert with de-duplication.
+ * If the same (agent, alert_type) exists within the window, increment count.
+ * Escalate severity based on count: 1 = info, 3+ = warning, 10+ = critical.
+ */
+export function recordAlert(db, agent, alertType, message, windowMinutes = 30) {
+    const windowStart = sqliteNow(-windowMinutes * 60 * 1000);
+    const existing = db.prepare(`
+    SELECT * FROM alerts
+    WHERE agent = ? AND alert_type = ? AND resolved = 0 AND last_seen > ?
+    ORDER BY last_seen DESC
+    LIMIT 1
+  `).get(agent, alertType, windowStart);
+    if (existing) {
+        const newCount = existing.count + 1;
+        const severity = escalateSeverity(newCount);
+        db.prepare(`
+      UPDATE alerts
+      SET count = ?, severity = ?, message = ?, last_seen = datetime('now')
+      WHERE id = ?
+    `).run(newCount, severity, message, existing.id);
+        return { ...existing, count: newCount, severity, message, last_seen: new Date().toISOString() };
+    }
+    const stmt = db.prepare(`
+    INSERT INTO alerts (agent, alert_type, severity, message)
+    VALUES (?, ?, 'info', ?)
+  `);
+    const result = stmt.run(agent, alertType, message);
+    return {
+        id: Number(result.lastInsertRowid),
+        agent,
+        alert_type: alertType,
+        severity: 'info',
+        message,
+        count: 1,
+        first_seen: new Date().toISOString(),
+        last_seen: new Date().toISOString(),
+        resolved: false,
+    };
+}
+export function resolveAlert(db, alertId) {
+    db.prepare(`UPDATE alerts SET resolved = 1 WHERE id = ?`).run(alertId);
+}
+export function getActiveAlerts(db, agent) {
+    if (agent) {
+        return db.prepare(`
+      SELECT * FROM alerts WHERE agent = ? AND resolved = 0
+      ORDER BY severity DESC, last_seen DESC
+    `).all(agent);
+    }
+    return db.prepare(`
+    SELECT * FROM alerts WHERE resolved = 0
+    ORDER BY severity DESC, last_seen DESC
+  `).all();
+}
+function escalateSeverity(count) {
+    if (count >= 10)
+        return 'critical';
+    if (count >= 3)
+        return 'warning';
+    return 'info';
+}
+//# sourceMappingURL=alerts.js.map

package/dist/alerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.js","sourceRoot":"","sources":["../src/alerts.ts"],"names":[],"mappings":"AAGA,SAAS,SAAS,CAAC,QAAQ,GAAG,CAAC;IAC7B,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC1C,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,EAAqB,EACrB,KAAa,EACb,SAAiB,EACjB,OAAe,EACf,gBAAwB,EAAE;IAE1B,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,aAAa,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAE1D,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;GAK3B,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAsB,CAAC;IAE3D,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC5C,EAAE,CAAC,OAAO,CAAC;;;;KAIV,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAEjD,OAAO,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;IAClG,CAAC;IAED,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;GAGvB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAEnD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC;QAClC,KAAK;QACL,UAAU,EAAE,SAAS;QACrB,QAAQ,EAAE,MAAM;QAChB,OAAO;QACP,KAAK,EAAE,CAAC;QACR,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,EAAqB,EACrB,OAAe;IAEf,EAAE,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,EAAqB,EACrB,KAAc;IAEd,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,CAAC,OAAO,CAAC;;;KAGjB,CAAC,CAAC,GAAG,CAAC,KAAK,CAAY,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,CAAC,OAAO,CAAC;;;GAGjB,CAAC,CAAC,GAAG,EAAa,CAAC;AACtB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,UAAU,CAAC;IACnC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACjC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import { AgentWatch } from '../index.js';
+const args = process.argv.slice(2);
+const command = args[0];
+const dbPath = process.env.AGENTWATCH_DB ?? 'agentwatch.db';
+const aw = new AgentWatch({ db_path: dbPath });
+try {
+    switch (command) {
+        case 'dashboard': {
+            console.log(aw.dashboardText());
+            break;
+        }
+        case 'cascade': {
+            const failureId = parseInt(args[1], 10);
+            if (isNaN(failureId)) {
+                console.error('Usage: agentwatch cascade <failure-event-id>');
+                process.exit(1);
+            }
+            const chain = aw.correlate(failureId);
+            if (!chain) {
+                console.error(`No trace event found with id ${failureId}`);
+                process.exit(1);
+            }
+            console.log(`Cascade for failure #${failureId}`);
+            console.log('='.repeat(60));
+            console.log(`Root cause: ${chain.root_cause.agent} / ${chain.root_cause.action}`);
+            console.log(`Chain length: ${chain.chain.length} steps`);
+            console.log('');
+            for (let i = 0; i < chain.chain.length; i++) {
+                const step = chain.chain[i];
+                const prefix = i === 0 ? 'ROOT' : i === chain.chain.length - 1 ? 'FAIL' : `  ${i} `;
+                console.log(`[${prefix}] ${step.agent} / ${step.action} (${step.status}, ${step.duration_ms}ms)`);
+                console.log(`       Input:  ${truncate(step.input, 120)}`);
+                console.log(`       Output: ${truncate(step.output, 120)}`);
+                console.log(`       Time:   ${step.timestamp}`);
+                if (i < chain.chain.length - 1)
+                    console.log('       |');
+            }
+            break;
+        }
+        case 'failures': {
+            const agent = args[1];
+            const limit = parseInt(args[2] ?? '20', 10);
+            const failures = aw.getRecentFailures(agent, limit);
+            if (failures.length === 0) {
+                console.log('No recent failures.');
+                break;
+            }
+            console.log(`Recent failures${agent ? ` for ${agent}` : ''} (${failures.length})`);
+            console.log('='.repeat(60));
+            for (const f of failures) {
+                console.log(`#${f.id} | ${f.agent} / ${f.action} | trace=${f.trace_id.slice(0, 8)} | ${f.created_at}`);
+                console.log(`  Output: ${truncate(f.output, 100)}`);
+            }
+            break;
+        }
+        case 'alerts': {
+            const alertAgent = args[1];
+            const alerts = aw.activeAlerts(alertAgent);
+            if (alerts.length === 0) {
+                console.log('No active alerts.');
+                break;
+            }
+            console.log(`Active alerts (${alerts.length})`);
+            console.log('='.repeat(60));
+            for (const a of alerts) {
+                console.log(`[${a.severity.toUpperCase()}] ${a.agent} / ${a.alert_type} (x${a.count})`);
+                console.log(`  ${a.message}`);
+                console.log(`  First: ${a.first_seen} | Last: ${a.last_seen}`);
+            }
+            break;
+        }
+        case 'replay': {
+            const traceId = args[1];
+            if (!traceId) {
+                console.error('Usage: agentwatch replay <trace-id>');
+                process.exit(1);
+            }
+            const chains = aw.replay(traceId);
+            if (chains.length === 0) {
+                console.log(`No failures found in trace ${traceId}`);
+                break;
+            }
+            console.log(`Trace ${traceId} - ${chains.length} cascade(s) found`);
+            console.log('='.repeat(60));
+            for (const chain of chains) {
+                console.log('');
+                console.log(`Cascade -> failure #${chain.failure_id} (${chain.chain.length} steps)`);
+                for (let i = 0; i < chain.chain.length; i++) {
+                    const step = chain.chain[i];
+                    const arrow = i < chain.chain.length - 1 ? ' ->' : ' X';
+                    console.log(`  ${step.agent}/${step.action} [${step.status}]${arrow}`);
+                    console.log(`    in:  ${truncate(step.input, 80)}`);
+                    console.log(`    out: ${truncate(step.output, 80)}`);
+                }
+            }
+            break;
+        }
+        default: {
+            console.log('AgentWatch - Multi-agent observability');
+            console.log('');
+            console.log('Usage:');
+            console.log('  agentwatch dashboard              Fleet health overview');
+            console.log('  agentwatch cascade <event-id>     Trace cascade from failure');
+            console.log('  agentwatch failures [agent]       List recent failures');
+            console.log('  agentwatch alerts [agent]          List active alerts');
+            console.log('  agentwatch replay <trace-id>      Replay all cascades in a trace');
+            console.log('');
+            console.log('Environment:');
+            console.log('  AGENTWATCH_DB    Path to SQLite database (default: agentwatch.db)');
+        }
+    }
+}
+finally {
+    aw.close();
+}
+function truncate(s, max) {
+    const oneline = s.replace(/\n/g, ' ');
+    return oneline.length > max ? oneline.slice(0, max - 3) + '...' : oneline;
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/dashboard.d.ts

@@ -0,0 +1,15 @@
+import type Database from 'better-sqlite3';
+import type { AgentHealth } from './types.js';
+export interface DashboardOutput {
+    timestamp: string;
+    agents: AgentHealth[];
+    total_agents: number;
+    healthy_count: number;
+    degraded_count: number;
+    error_count: number;
+    offline_count: number;
+    total_active_alerts: number;
+}
+export declare function getDashboard(db: Database.Database, staleMinutes?: number): DashboardOutput;
+export declare function formatDashboard(dashboard: DashboardOutput): string;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../src/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,YAAY,GAAE,MAAW,GACxB,eAAe,CAcjB;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,CA0BlE"}

package/dist/dashboard.js

@@ -0,0 +1,40 @@
+import { getFleetHealth } from './heartbeat.js';
+import { getActiveAlerts } from './alerts.js';
+export function getDashboard(db, staleMinutes = 30) {
+    const agents = getFleetHealth(db, staleMinutes);
+    const alerts = getActiveAlerts(db);
+    return {
+        timestamp: new Date().toISOString(),
+        agents,
+        total_agents: agents.length,
+        healthy_count: agents.filter(a => a.status === 'healthy').length,
+        degraded_count: agents.filter(a => a.status === 'degraded').length,
+        error_count: agents.filter(a => a.status === 'error').length,
+        offline_count: agents.filter(a => a.status === 'offline').length,
+        total_active_alerts: alerts.length,
+    };
+}
+export function formatDashboard(dashboard) {
+    const lines = [];
+    lines.push(`AgentWatch Fleet Dashboard - ${dashboard.timestamp}`);
+    lines.push('='.repeat(60));
+    lines.push('');
+    lines.push(`Agents: ${dashboard.total_agents} total | ${dashboard.healthy_count} healthy | ${dashboard.degraded_count} degraded | ${dashboard.error_count} error | ${dashboard.offline_count} offline`);
+    lines.push(`Active Alerts: ${dashboard.total_active_alerts}`);
+    lines.push('');
+    lines.push('Agent'.padEnd(15) + 'Status'.padEnd(12) + 'Uptime'.padEnd(10) + 'Alerts'.padEnd(10) + 'Last Heartbeat');
+    lines.push('-'.repeat(60));
+    for (const agent of dashboard.agents) {
+        const statusIcon = agent.status === 'healthy' ? 'OK'
+            : agent.status === 'degraded' ? 'WARN'
+                : agent.status === 'error' ? 'ERR'
+                    : 'OFF';
+        lines.push(agent.agent.padEnd(15) +
+            statusIcon.padEnd(12) +
+            `${agent.uptime_pct}%`.padEnd(10) +
+            String(agent.active_alerts).padEnd(10) +
+            (agent.last_heartbeat || 'never'));
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/dashboard.js.map

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

package/dist/db.d.ts

@@ -0,0 +1,3 @@
+import Database from 'better-sqlite3';
+export declare function createDb(path: string): Database.Database;
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AA2CtC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAMxD"}

package/dist/db.js

@@ -0,0 +1,49 @@
+import Database from 'better-sqlite3';
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS heartbeats (
+  id         INTEGER PRIMARY KEY AUTOINCREMENT,
+  agent      TEXT NOT NULL,
+  status     TEXT NOT NULL CHECK(status IN ('healthy', 'degraded', 'error', 'offline')),
+  context    TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS trace_events (
+  id              INTEGER PRIMARY KEY AUTOINCREMENT,
+  trace_id        TEXT NOT NULL,
+  agent           TEXT NOT NULL,
+  action          TEXT NOT NULL,
+  input           TEXT NOT NULL DEFAULT '',
+  output          TEXT NOT NULL DEFAULT '',
+  parent_event_id INTEGER REFERENCES trace_events(id),
+  status          TEXT NOT NULL DEFAULT 'ok' CHECK(status IN ('ok', 'error')),
+  duration_ms     INTEGER NOT NULL DEFAULT 0,
+  created_at      TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS alerts (
+  id         INTEGER PRIMARY KEY AUTOINCREMENT,
+  agent      TEXT NOT NULL,
+  alert_type TEXT NOT NULL,
+  severity   TEXT NOT NULL DEFAULT 'info' CHECK(severity IN ('info', 'warning', 'critical')),
+  message    TEXT NOT NULL,
+  count      INTEGER NOT NULL DEFAULT 1,
+  first_seen TEXT NOT NULL DEFAULT (datetime('now')),
+  last_seen  TEXT NOT NULL DEFAULT (datetime('now')),
+  resolved   INTEGER NOT NULL DEFAULT 0
+);
+
+CREATE INDEX IF NOT EXISTS idx_heartbeats_agent ON heartbeats(agent, created_at);
+CREATE INDEX IF NOT EXISTS idx_trace_events_trace ON trace_events(trace_id);
+CREATE INDEX IF NOT EXISTS idx_trace_events_agent ON trace_events(agent, created_at);
+CREATE INDEX IF NOT EXISTS idx_trace_events_parent ON trace_events(parent_event_id);
+CREATE INDEX IF NOT EXISTS idx_alerts_agent ON alerts(agent, alert_type, resolved);
+`;
+export function createDb(path) {
+    const db = new Database(path);
+    db.pragma('journal_mode = WAL');
+    db.pragma('foreign_keys = ON');
+    db.exec(SCHEMA);
+    return db;
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCd,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChB,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/heartbeat.d.ts

@@ -0,0 +1,6 @@
+import type Database from 'better-sqlite3';
+import type { AgentStatus, Heartbeat, AgentHealth } from './types.js';
+export declare function report(db: Database.Database, agent: string, status: AgentStatus, context?: string): Heartbeat;
+export declare function getLatestHeartbeat(db: Database.Database, agent: string): Heartbeat | undefined;
+export declare function getFleetHealth(db: Database.Database, staleMinutes?: number): AgentHealth[];
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQtE,wBAAgB,MAAM,CACpB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,MAAa,GACrB,SAAS,CAaX;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,GACZ,SAAS,GAAG,SAAS,CAOvB;AAED,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,YAAY,GAAE,MAAW,GACxB,WAAW,EAAE,CA4Cf"}

package/dist/heartbeat.js

@@ -0,0 +1,66 @@
+/** Format a date as SQLite-compatible `YYYY-MM-DD HH:MM:SS` */
+function sqliteNow(offsetMs = 0) {
+    const d = new Date(Date.now() + offsetMs);
+    return d.toISOString().replace('T', ' ').replace(/\.\d{3}Z$/, '');
+}
+export function report(db, agent, status, context = '{}') {
+    const stmt = db.prepare(`
+    INSERT INTO heartbeats (agent, status, context)
+    VALUES (?, ?, ?)
+  `);
+    const result = stmt.run(agent, status, context);
+    return {
+        id: Number(result.lastInsertRowid),
+        agent,
+        status,
+        context,
+        created_at: new Date().toISOString(),
+    };
+}
+export function getLatestHeartbeat(db, agent) {
+    return db.prepare(`
+    SELECT * FROM heartbeats
+    WHERE agent = ?
+    ORDER BY created_at DESC
+    LIMIT 1
+  `).get(agent);
+}
+export function getFleetHealth(db, staleMinutes = 30) {
+    const agents = db.prepare(`
+    SELECT DISTINCT agent FROM heartbeats
+  `).all();
+    return agents.map(({ agent }) => {
+        const latest = getLatestHeartbeat(db, agent);
+        if (!latest) {
+            return { agent, status: 'offline', last_heartbeat: '', uptime_pct: 0, active_alerts: 0 };
+        }
+        const staleThreshold = sqliteNow(-staleMinutes * 60 * 1000);
+        const isStale = latest.created_at < staleThreshold;
+        const status = isStale ? 'offline' : latest.status;
+        // Uptime: % of heartbeats in last 24h that were 'healthy'
+        const dayAgo = sqliteNow(-24 * 60 * 60 * 1000);
+        const totalCount = db.prepare(`
+      SELECT COUNT(*) as cnt FROM heartbeats
+      WHERE agent = ? AND created_at > ?
+    `).get(agent, dayAgo);
+        const healthyCount = db.prepare(`
+      SELECT COUNT(*) as cnt FROM heartbeats
+      WHERE agent = ? AND created_at > ? AND status = 'healthy'
+    `).get(agent, dayAgo);
+        const uptime = totalCount.cnt > 0
+            ? Math.round((healthyCount.cnt / totalCount.cnt) * 100)
+            : 0;
+        const alertCount = db.prepare(`
+      SELECT COUNT(*) as cnt FROM alerts
+      WHERE agent = ? AND resolved = 0
+    `).get(agent);
+        return {
+            agent,
+            status,
+            last_heartbeat: latest.created_at,
+            uptime_pct: uptime,
+            active_alerts: alertCount.cnt,
+        };
+    });
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/heartbeat.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import type { AgentWatchConfig, AgentStatus, TraceEvent, CascadeChain } from './types.js';
+export declare class AgentWatch {
+    private db;
+    private alertWindowMinutes;
+    private heartbeatStaleMinutes;
+    constructor(config?: AgentWatchConfig);
+    report(agent: string, status: AgentStatus, context?: string): import("./types.js").Heartbeat;
+    trace(traceId: string, agent: string, action: string, input: string, output: string, opts?: {
+        parentEventId?: number;
+        status?: 'ok' | 'error';
+        durationMs?: number;
+    }): TraceEvent;
+    correlate(failureEventId: number): CascadeChain | null;
+    dashboard(): import("./dashboard.js").DashboardOutput;
+    dashboardText(): string;
+    alert(agent: string, alertType: string, message: string): import("./types.js").Alert;
+    resolveAlert(alertId: number): void;
+    activeAlerts(agent?: string): import("./types.js").Alert[];
+    replay(traceId: string): CascadeChain[];
+    createTraceId(): string;
+    getTraceEvents(traceId: string): TraceEvent[];
+    getRecentFailures(agent?: string, limit?: number): TraceEvent[];
+    getLatestHeartbeat(agent: string): import("./types.js").Heartbeat | undefined;
+    getFleetHealth(): import("./types.js").AgentHealth[];
+    close(): void;
+}
+export type { AgentStatus, AlertSeverity, Heartbeat, TraceEvent, Alert, AgentHealth, CascadeStep, CascadeChain, AgentWatchConfig, } from './types.js';
+export { createTraceId } from './trace.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1F,qBAAa,UAAU;IACrB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,qBAAqB,CAAS;gBAE1B,MAAM,GAAE,gBAAqB;IAQzC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,MAAa;IAKjE,KAAK,CACH,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9E,UAAU;IAWb,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAKtD,SAAS;IAIT,aAAa,IAAI,MAAM;IAKvB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAIvD,YAAY,CAAC,OAAO,EAAE,MAAM;IAI5B,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM;IAK3B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE;IAKvC,aAAa,IAAI,MAAM;IAIvB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;IAI7C,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAI/D,kBAAkB,CAAC,KAAK,EAAE,MAAM;IAIhC,cAAc;IAId,KAAK;CAGN;AAGD,YAAY,EACV,WAAW,EACX,aAAa,EACb,SAAS,EACT,UAAU,EACV,KAAK,EACL,WAAW,EACX,WAAW,EACX,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,75 @@
+import { createDb } from './db.js';
+import { report, getLatestHeartbeat, getFleetHealth } from './heartbeat.js';
+import { createTraceId, trace, correlate, getRecentFailures, getTraceEvents, replayTrace } from './trace.js';
+import { recordAlert, resolveAlert, getActiveAlerts } from './alerts.js';
+import { getDashboard, formatDashboard } from './dashboard.js';
+export class AgentWatch {
+    db;
+    alertWindowMinutes;
+    heartbeatStaleMinutes;
+    constructor(config = {}) {
+        const dbPath = config.db_path ?? 'agentwatch.db';
+        this.db = createDb(dbPath);
+        this.alertWindowMinutes = config.alert_window_minutes ?? 30;
+        this.heartbeatStaleMinutes = config.heartbeat_stale_minutes ?? 30;
+    }
+    // Feature 1: Heartbeat registration
+    report(agent, status, context = '{}') {
+        return report(this.db, agent, status, context);
+    }
+    // Feature 2: Cross-agent event correlation
+    trace(traceId, agent, action, input, output, opts) {
+        const event = trace(this.db, traceId, agent, action, input, output, opts);
+        // Auto-alert on errors
+        if (opts?.status === 'error') {
+            recordAlert(this.db, agent, `trace_error:${action}`, output, this.alertWindowMinutes);
+        }
+        return event;
+    }
+    correlate(failureEventId) {
+        return correlate(this.db, failureEventId);
+    }
+    // Feature 3: Fleet health dashboard
+    dashboard() {
+        return getDashboard(this.db, this.heartbeatStaleMinutes);
+    }
+    dashboardText() {
+        return formatDashboard(this.dashboard());
+    }
+    // Feature 4: Alert de-duplication
+    alert(agent, alertType, message) {
+        return recordAlert(this.db, agent, alertType, message, this.alertWindowMinutes);
+    }
+    resolveAlert(alertId) {
+        return resolveAlert(this.db, alertId);
+    }
+    activeAlerts(agent) {
+        return getActiveAlerts(this.db, agent);
+    }
+    // Feature 5: Cascade replay
+    replay(traceId) {
+        return replayTrace(this.db, traceId);
+    }
+    // Utilities
+    createTraceId() {
+        return createTraceId();
+    }
+    getTraceEvents(traceId) {
+        return getTraceEvents(this.db, traceId);
+    }
+    getRecentFailures(agent, limit) {
+        return getRecentFailures(this.db, agent, limit);
+    }
+    getLatestHeartbeat(agent) {
+        return getLatestHeartbeat(this.db, agent);
+    }
+    getFleetHealth() {
+        return getFleetHealth(this.db, this.heartbeatStaleMinutes);
+    }
+    close() {
+        this.db.close();
+    }
+}
+// Re-export for direct use
+export { createTraceId } from './trace.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/trace.d.ts

@@ -0,0 +1,24 @@
+import type Database from 'better-sqlite3';
+import type { TraceEvent, CascadeChain } from './types.js';
+export declare function createTraceId(): string;
+export declare function trace(db: Database.Database, traceId: string, agent: string, action: string, input: string, output: string, opts?: {
+    parentEventId?: number;
+    status?: 'ok' | 'error';
+    durationMs?: number;
+}): TraceEvent;
+export declare function getTraceEvents(db: Database.Database, traceId: string): TraceEvent[];
+/**
+ * Walk backward from a failed event to find the root cause.
+ * Follows parent_event_id links to build the cascade chain.
+ */
+export declare function correlate(db: Database.Database, failureEventId: number): CascadeChain | null;
+/**
+ * Find recent failures for an agent or across all agents.
+ */
+export declare function getRecentFailures(db: Database.Database, agent?: string, limit?: number): TraceEvent[];
+/**
+ * Find all events in a trace that are errors, then correlate each.
+ * Returns all cascade chains for a given trace.
+ */
+export declare function replayTrace(db: Database.Database, traceId: string): CascadeChain[];
+//# sourceMappingURL=trace.d.ts.map

package/dist/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAExE,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,KAAK,CACnB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IACJ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GACL,UAAU,CA2BZ;AAED,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,MAAM,GACd,UAAU,EAAE,CAMd;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,cAAc,EAAE,MAAM,GACrB,YAAY,GAAG,IAAI,CAkCrB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,GAAE,MAAW,GACjB,UAAU,EAAE,CAed;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,MAAM,GACd,YAAY,EAAE,CAUhB"}

package/dist/trace.js

@@ -0,0 +1,99 @@
+import { randomUUID } from 'node:crypto';
+export function createTraceId() {
+    return randomUUID();
+}
+export function trace(db, traceId, agent, action, input, output, opts = {}) {
+    const stmt = db.prepare(`
+    INSERT INTO trace_events (trace_id, agent, action, input, output, parent_event_id, status, duration_ms)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+  `);
+    const result = stmt.run(traceId, agent, action, input, output, opts.parentEventId ?? null, opts.status ?? 'ok', opts.durationMs ?? 0);
+    return {
+        id: Number(result.lastInsertRowid),
+        trace_id: traceId,
+        agent,
+        action,
+        input,
+        output,
+        parent_event_id: opts.parentEventId ?? null,
+        status: opts.status ?? 'ok',
+        duration_ms: opts.durationMs ?? 0,
+        created_at: new Date().toISOString(),
+    };
+}
+export function getTraceEvents(db, traceId) {
+    return db.prepare(`
+    SELECT * FROM trace_events
+    WHERE trace_id = ?
+    ORDER BY created_at ASC
+  `).all(traceId);
+}
+/**
+ * Walk backward from a failed event to find the root cause.
+ * Follows parent_event_id links to build the cascade chain.
+ */
+export function correlate(db, failureEventId) {
+    const failure = db.prepare(`
+    SELECT * FROM trace_events WHERE id = ?
+  `).get(failureEventId);
+    if (!failure)
+        return null;
+    const chain = [];
+    let current = failure;
+    while (current) {
+        chain.unshift({
+            event_id: current.id,
+            agent: current.agent,
+            action: current.action,
+            input: current.input,
+            output: current.output,
+            status: current.status,
+            duration_ms: current.duration_ms,
+            timestamp: current.created_at,
+        });
+        if (current.parent_event_id === null)
+            break;
+        current = db.prepare(`
+      SELECT * FROM trace_events WHERE id = ?
+    `).get(current.parent_event_id);
+    }
+    return {
+        failure_id: failureEventId,
+        root_cause: chain[0],
+        chain,
+    };
+}
+/**
+ * Find recent failures for an agent or across all agents.
+ */
+export function getRecentFailures(db, agent, limit = 20) {
+    if (agent) {
+        return db.prepare(`
+      SELECT * FROM trace_events
+      WHERE agent = ? AND status = 'error'
+      ORDER BY created_at DESC
+      LIMIT ?
+    `).all(agent, limit);
+    }
+    return db.prepare(`
+    SELECT * FROM trace_events
+    WHERE status = 'error'
+    ORDER BY created_at DESC
+    LIMIT ?
+  `).all(limit);
+}
+/**
+ * Find all events in a trace that are errors, then correlate each.
+ * Returns all cascade chains for a given trace.
+ */
+export function replayTrace(db, traceId) {
+    const failures = db.prepare(`
+    SELECT * FROM trace_events
+    WHERE trace_id = ? AND status = 'error'
+    ORDER BY created_at ASC
+  `).all(traceId);
+    return failures
+        .map(f => correlate(db, f.id))
+        .filter((c) => c !== null);
+}
+//# sourceMappingURL=trace.js.map

package/dist/trace.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+export type AgentStatus = 'healthy' | 'degraded' | 'error' | 'offline';
+export type AlertSeverity = 'info' | 'warning' | 'critical';
+export interface Heartbeat {
+    id: number;
+    agent: string;
+    status: AgentStatus;
+    context: string;
+    created_at: string;
+}
+export interface TraceEvent {
+    id: number;
+    trace_id: string;
+    agent: string;
+    action: string;
+    input: string;
+    output: string;
+    parent_event_id: number | null;
+    status: 'ok' | 'error';
+    duration_ms: number;
+    created_at: string;
+}
+export interface Alert {
+    id: number;
+    agent: string;
+    alert_type: string;
+    severity: AlertSeverity;
+    message: string;
+    count: number;
+    first_seen: string;
+    last_seen: string;
+    resolved: boolean;
+}
+export interface AgentHealth {
+    agent: string;
+    status: AgentStatus;
+    last_heartbeat: string;
+    uptime_pct: number;
+    active_alerts: number;
+}
+export interface CascadeStep {
+    event_id: number;
+    agent: string;
+    action: string;
+    input: string;
+    output: string;
+    status: 'ok' | 'error';
+    duration_ms: number;
+    timestamp: string;
+}
+export interface CascadeChain {
+    failure_id: number;
+    root_cause: CascadeStep;
+    chain: CascadeStep[];
+}
+export interface AgentWatchConfig {
+    db_path?: string;
+    alert_window_minutes?: number;
+    heartbeat_stale_minutes?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AACvE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAE5D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,WAAW,CAAC;IACxB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@nicofains1/agentwatch",
+  "version": "0.1.0",
+  "description": "Multi-agent observability: cascade failure detection, heartbeats, and forensic replay",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "agentwatch": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.8.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.8"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "agents",
+    "observability",
+    "cascade-failure",
+    "multi-agent",
+    "monitoring",
+    "heartbeat",
+    "tracing",
+    "fleet-management",
+    "ai-agents",
+    "debugging"
+  ],
+  "author": "nicofains1",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nicofains1/agentwatch.git"
+  },
+  "homepage": "https://github.com/nicofains1/agentwatch",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}