pi-harness-runtime 0.9.2 → 0.9.5

package/packages/health-monitor/dist/monitor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Health Monitor — Core Monitor
+ */
+import type { ComponentName, ComponentHealth, HealthReport, HealthStatus, MonitorConfig, RecoveryAction } from "./types.js";
+export declare const DEFAULT_CONFIG: Required<MonitorConfig>;
+export interface SnapshotValue {
+    value: number;
+    unit: string;
+}
+export interface HealthSnapshot {
+    timestamp: number;
+    memory: Record<string, SnapshotValue>;
+    cpu: Record<string, SnapshotValue>;
+    uptime: number;
+}
+export declare function collectMemory(): {
+    name: string;
+    timestamp: number;
+    values: Record<string, SnapshotValue>;
+};
+export declare function collectCPU(): {
+    name: string;
+    timestamp: number;
+    values: Record<string, SnapshotValue>;
+};
+export declare function collectUptime(): {
+    name: string;
+    timestamp: number;
+    values: Record<string, SnapshotValue>;
+};
+export declare function collectSnapshot(): HealthSnapshot;
+export declare function determineStatus(responseTimeMs: number, errorRate: number, config: Required<MonitorConfig>): HealthStatus;
+export declare function createReport(components: ComponentHealth[], _config: Required<MonitorConfig>): HealthReport;
+export declare function aggregateHealth(statuses: HealthStatus[]): HealthStatus;
+export declare function determineRecoveryAction(component: ComponentName, status: HealthStatus, config: Required<MonitorConfig>): RecoveryAction | null;
+export declare function resetRecoveryAttempts(component: ComponentName): void;
+export declare function runHealthCheck(component: ComponentName, checkFn: () => Promise<boolean>, config: Required<MonitorConfig>): Promise<ComponentHealth>;
+export declare function calculateUptime(report: HealthReport): number;
+//# sourceMappingURL=monitor.d.ts.map

package/packages/health-monitor/dist/monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../src/monitor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,aAAa,EACb,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,aAAa,CAOlD,CAAC;AAOF,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,aAAa,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CAAE,CAY1G;AAED,wBAAgB,UAAU,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CAAE,CAUvG;AAED,wBAAgB,aAAa,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CAAE,CAQ1G;AAED,wBAAgB,eAAe,IAAI,cAAc,CAchD;AAED,wBAAgB,eAAe,CAC9B,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC7B,YAAY,CAWd;AAED,wBAAgB,YAAY,CAC3B,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC9B,YAAY,CAOd;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,YAAY,CAMtE;AAED,wBAAgB,uBAAuB,CACtC,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC7B,cAAc,GAAG,IAAI,CA8BvB;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,CAEpE;AAED,wBAAsB,cAAc,CACnC,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC/B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC7B,OAAO,CAAC,eAAe,CAAC,CAuC1B;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE5D"}

package/packages/health-monitor/dist/monitor.js

@@ -0,0 +1,155 @@
+/**
+ * Health Monitor — Core Monitor
+ */
+export const DEFAULT_CONFIG = {
+    checkIntervalMs: 30_000,
+    degradedThreshold: 2000,
+    unhealthyThreshold: 10_000,
+    maxErrorRate: 0.1,
+    autoRecover: false,
+    maxRecoveryAttempts: 3,
+};
+const recoveryAttempts = new Map();
+const startTime = Date.now();
+export function collectMemory() {
+    const mem = process.memoryUsage();
+    return {
+        name: "memory",
+        timestamp: Date.now(),
+        values: {
+            rss: { value: mem.rss, unit: "bytes" },
+            heapTotal: { value: mem.heapTotal, unit: "bytes" },
+            heapUsed: { value: mem.heapUsed, unit: "bytes" },
+            external: { value: mem.external, unit: "bytes" },
+        },
+    };
+}
+export function collectCPU() {
+    const cpu = process.cpuUsage();
+    return {
+        name: "cpu",
+        timestamp: Date.now(),
+        values: {
+            user: { value: cpu.user, unit: "microseconds" },
+            system: { value: cpu.system, unit: "microseconds" },
+        },
+    };
+}
+export function collectUptime() {
+    return {
+        name: "uptime",
+        timestamp: Date.now(),
+        values: {
+            seconds: { value: process.uptime(), unit: "seconds" },
+        },
+    };
+}
+export function collectSnapshot() {
+    return {
+        timestamp: Date.now(),
+        memory: {
+            rss: { value: process.memoryUsage().rss, unit: "bytes" },
+            heapUsed: { value: process.memoryUsage().heapUsed, unit: "bytes" },
+            heapTotal: { value: process.memoryUsage().heapTotal, unit: "bytes" },
+        },
+        cpu: {
+            user: { value: process.cpuUsage().user, unit: "microseconds" },
+            system: { value: process.cpuUsage().system, unit: "microseconds" },
+        },
+        uptime: process.uptime(),
+    };
+}
+export function determineStatus(responseTimeMs, errorRate, config) {
+    if (responseTimeMs > config.unhealthyThreshold ||
+        errorRate > config.maxErrorRate) {
+        return "unhealthy";
+    }
+    if (responseTimeMs > config.degradedThreshold) {
+        return "degraded";
+    }
+    return "healthy";
+}
+export function createReport(components, _config) {
+    return {
+        overall: aggregateHealth(components.map((c) => c.status)),
+        timestamp: new Date().toISOString(),
+        components,
+        uptime: Math.floor((Date.now() - startTime) / 1000),
+    };
+}
+export function aggregateHealth(statuses) {
+    if (statuses.length === 0)
+        return "unknown";
+    if (statuses.some((s) => s === "unhealthy"))
+        return "unhealthy";
+    if (statuses.some((s) => s === "degraded"))
+        return "degraded";
+    if (statuses.every((s) => s === "healthy"))
+        return "healthy";
+    return "unknown";
+}
+export function determineRecoveryAction(component, status, config) {
+    if (status === "healthy")
+        return null;
+    if (!config.autoRecover)
+        return null;
+    const attempts = recoveryAttempts.get(component) ?? 0;
+    if (attempts >= config.maxRecoveryAttempts) {
+        return {
+            type: "alert",
+            target: component,
+            config: {
+                message: `Max recovery attempts (${attempts}) exceeded for ${component}`,
+            },
+        };
+    }
+    recoveryAttempts.set(component, attempts + 1);
+    if (status === "unhealthy") {
+        return {
+            type: "restart",
+            target: component,
+            config: { attempt: attempts + 1 },
+        };
+    }
+    return {
+        type: "retry",
+        target: component,
+        config: { attempt: attempts + 1, backoffMs: 2 ** attempts * 1000 },
+    };
+}
+export function resetRecoveryAttempts(component) {
+    recoveryAttempts.delete(component);
+}
+export async function runHealthCheck(component, checkFn, config) {
+    const start = Date.now();
+    let status = "healthy";
+    let details;
+    try {
+        const result = await Promise.race([
+            checkFn(),
+            new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), config.unhealthyThreshold)),
+        ]);
+        if (!result) {
+            status = "unhealthy";
+            details = "Check returned false";
+        }
+    }
+    catch (err) {
+        status = "unhealthy";
+        details = err instanceof Error ? err.message : "Unknown error";
+    }
+    const responseTimeMs = Date.now() - start;
+    const determined = determineStatus(responseTimeMs, status === "unhealthy" ? 1 : 0, config);
+    return {
+        component,
+        status: determined,
+        lastCheck: new Date().toISOString(),
+        responseTimeMs,
+        errorRate: status === "unhealthy" ? 1 : 0,
+        details,
+    };
+}
+export function calculateUptime(report) {
+    return report.overall === "unhealthy" ? 95 : 100;
+}
+//# sourceMappingURL=monitor.js.map

package/packages/health-monitor/dist/monitor.js.map

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

package/packages/health-monitor/dist/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Health Monitor — Types
+ */
+export type ComponentName = "provider-adapter" | "skill-registry" | "memory-engine" | "session-manager" | "checkpoint-engine" | "quota-manager" | "framework-detector";
+export type HealthStatus = "healthy" | "degraded" | "unhealthy" | "unknown";
+export interface ComponentHealth {
+    component: ComponentName;
+    status: HealthStatus;
+    lastCheck: string;
+    responseTimeMs?: number;
+    errorRate?: number;
+    details?: string;
+}
+export interface HealthReport {
+    overall: HealthStatus;
+    timestamp: string;
+    components: ComponentHealth[];
+    uptime: number;
+}
+export interface MonitorConfig {
+    checkIntervalMs: number;
+    degradedThreshold: number;
+    unhealthyThreshold: number;
+    maxErrorRate: number;
+    autoRecover: boolean;
+    maxRecoveryAttempts: number;
+}
+export interface RecoveryAction {
+    type: "restart" | "retry" | "fallback" | "alert" | "scale";
+    target: ComponentName;
+    config: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/health-monitor/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GACtB,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,GACf,oBAAoB,CAAC;AAExB,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IAC3D,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC"}

package/packages/health-monitor/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Health Monitor — Types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/health-monitor/dist/types.js.map

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

package/packages/health-monitor/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@pi/health-monitor",
+  "version": "0.9.5",
+  "type": "module",
+  "description": "Health monitoring and auto-healing",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "bun-types": "^1.0.0"
+  }
+}

package/packages/health-monitor/src/index.ts

@@ -0,0 +1,16 @@
+/**
+ * Health Monitor — Main Entry
+ */
+
+export {
+	DEFAULT_CONFIG,
+	determineStatus,
+	createReport,
+	aggregateHealth,
+	determineRecoveryAction,
+	resetRecoveryAttempts,
+	runHealthCheck,
+	calculateUptime,
+	collectSnapshot,
+} from "./monitor.js";
+export type * from "./types.js";

package/packages/health-monitor/src/monitor.ts

@@ -0,0 +1,216 @@
+/**
+ * Health Monitor — Core Monitor
+ */
+
+import type {
+	ComponentName,
+	ComponentHealth,
+	HealthReport,
+	HealthStatus,
+	MonitorConfig,
+	RecoveryAction,
+} from "./types.js";
+
+export const DEFAULT_CONFIG: Required<MonitorConfig> = {
+	checkIntervalMs: 30_000,
+	degradedThreshold: 2000,
+	unhealthyThreshold: 10_000,
+	maxErrorRate: 0.1,
+	autoRecover: false,
+	maxRecoveryAttempts: 3,
+};
+
+const recoveryAttempts = new Map<ComponentName, number>();
+const startTime = Date.now();
+
+// ─── Collectors ────────────────────────────────────────────────────────────────
+
+export interface SnapshotValue {
+	value: number;
+	unit: string;
+}
+
+export interface HealthSnapshot {
+	timestamp: number;
+	memory: Record<string, SnapshotValue>;
+	cpu: Record<string, SnapshotValue>;
+	uptime: number;
+}
+
+export function collectMemory(): { name: string; timestamp: number; values: Record<string, SnapshotValue> } {
+	const mem = process.memoryUsage();
+	return {
+		name: "memory",
+		timestamp: Date.now(),
+		values: {
+			rss: { value: mem.rss, unit: "bytes" },
+			heapTotal: { value: mem.heapTotal, unit: "bytes" },
+			heapUsed: { value: mem.heapUsed, unit: "bytes" },
+			external: { value: mem.external, unit: "bytes" },
+		},
+	};
+}
+
+export function collectCPU(): { name: string; timestamp: number; values: Record<string, SnapshotValue> } {
+	const cpu = process.cpuUsage();
+	return {
+		name: "cpu",
+		timestamp: Date.now(),
+		values: {
+			user: { value: cpu.user, unit: "microseconds" },
+			system: { value: cpu.system, unit: "microseconds" },
+		},
+	};
+}
+
+export function collectUptime(): { name: string; timestamp: number; values: Record<string, SnapshotValue> } {
+	return {
+		name: "uptime",
+		timestamp: Date.now(),
+		values: {
+			seconds: { value: process.uptime(), unit: "seconds" },
+		},
+	};
+}
+
+export function collectSnapshot(): HealthSnapshot {
+	return {
+		timestamp: Date.now(),
+		memory: {
+			rss: { value: process.memoryUsage().rss, unit: "bytes" },
+			heapUsed: { value: process.memoryUsage().heapUsed, unit: "bytes" },
+			heapTotal: { value: process.memoryUsage().heapTotal, unit: "bytes" },
+		},
+		cpu: {
+			user: { value: process.cpuUsage().user, unit: "microseconds" },
+			system: { value: process.cpuUsage().system, unit: "microseconds" },
+		},
+		uptime: process.uptime(),
+	};
+}
+
+export function determineStatus(
+	responseTimeMs: number,
+	errorRate: number,
+	config: Required<MonitorConfig>,
+): HealthStatus {
+	if (
+		responseTimeMs > config.unhealthyThreshold ||
+		errorRate > config.maxErrorRate
+	) {
+		return "unhealthy";
+	}
+	if (responseTimeMs > config.degradedThreshold) {
+		return "degraded";
+	}
+	return "healthy";
+}
+
+export function createReport(
+	components: ComponentHealth[],
+	_config: Required<MonitorConfig>,
+): HealthReport {
+	return {
+		overall: aggregateHealth(components.map((c) => c.status)),
+		timestamp: new Date().toISOString(),
+		components,
+		uptime: Math.floor((Date.now() - startTime) / 1000),
+	};
+}
+
+export function aggregateHealth(statuses: HealthStatus[]): HealthStatus {
+	if (statuses.length === 0) return "unknown";
+	if (statuses.some((s) => s === "unhealthy")) return "unhealthy";
+	if (statuses.some((s) => s === "degraded")) return "degraded";
+	if (statuses.every((s) => s === "healthy")) return "healthy";
+	return "unknown";
+}
+
+export function determineRecoveryAction(
+	component: ComponentName,
+	status: HealthStatus,
+	config: Required<MonitorConfig>,
+): RecoveryAction | null {
+	if (status === "healthy") return null;
+	if (!config.autoRecover) return null;
+
+	const attempts = recoveryAttempts.get(component) ?? 0;
+	if (attempts >= config.maxRecoveryAttempts) {
+		return {
+			type: "alert",
+			target: component,
+			config: {
+				message: `Max recovery attempts (${attempts}) exceeded for ${component}`,
+			},
+		};
+	}
+
+	recoveryAttempts.set(component, attempts + 1);
+
+	if (status === "unhealthy") {
+		return {
+			type: "restart",
+			target: component,
+			config: { attempt: attempts + 1 },
+		};
+	}
+
+	return {
+		type: "retry",
+		target: component,
+		config: { attempt: attempts + 1, backoffMs: 2 ** attempts * 1000 },
+	};
+}
+
+export function resetRecoveryAttempts(component: ComponentName): void {
+	recoveryAttempts.delete(component);
+}
+
+export async function runHealthCheck(
+	component: ComponentName,
+	checkFn: () => Promise<boolean>,
+	config: Required<MonitorConfig>,
+): Promise<ComponentHealth> {
+	const start = Date.now();
+	let status: HealthStatus = "healthy";
+	let details: string | undefined;
+
+	try {
+		const result = await Promise.race([
+			checkFn(),
+			new Promise<false>((_, reject) =>
+				setTimeout(
+					() => reject(new Error("timeout")),
+					config.unhealthyThreshold,
+				),
+			),
+		]);
+		if (!result) {
+			status = "unhealthy";
+			details = "Check returned false";
+		}
+	} catch (err) {
+		status = "unhealthy";
+		details = err instanceof Error ? err.message : "Unknown error";
+	}
+
+	const responseTimeMs = Date.now() - start;
+	const determined = determineStatus(
+		responseTimeMs,
+		status === "unhealthy" ? 1 : 0,
+		config,
+	);
+
+	return {
+		component,
+		status: determined,
+		lastCheck: new Date().toISOString(),
+		responseTimeMs,
+		errorRate: status === "unhealthy" ? 1 : 0,
+		details,
+	};
+}
+
+export function calculateUptime(report: HealthReport): number {
+	return report.overall === "unhealthy" ? 95 : 100;
+}

package/packages/health-monitor/src/types.ts

@@ -0,0 +1,45 @@
+/**
+ * Health Monitor — Types
+ */
+
+export type ComponentName =
+	| "provider-adapter"
+	| "skill-registry"
+	| "memory-engine"
+	| "session-manager"
+	| "checkpoint-engine"
+	| "quota-manager"
+	| "framework-detector";
+
+export type HealthStatus = "healthy" | "degraded" | "unhealthy" | "unknown";
+
+export interface ComponentHealth {
+	component: ComponentName;
+	status: HealthStatus;
+	lastCheck: string;
+	responseTimeMs?: number;
+	errorRate?: number;
+	details?: string;
+}
+
+export interface HealthReport {
+	overall: HealthStatus;
+	timestamp: string;
+	components: ComponentHealth[];
+	uptime: number;
+}
+
+export interface MonitorConfig {
+	checkIntervalMs: number;
+	degradedThreshold: number;
+	unhealthyThreshold: number;
+	maxErrorRate: number;
+	autoRecover: boolean;
+	maxRecoveryAttempts: number;
+}
+
+export interface RecoveryAction {
+	type: "restart" | "retry" | "fallback" | "alert" | "scale";
+	target: ComponentName;
+	config: Record<string, unknown>;
+}