@blokjs/runner 0.2.0

package/dist/marketplace/RuntimeMetricsDashboard.d.ts

@@ -0,0 +1,113 @@
+/**
+ * RuntimeMetricsDashboard - Aggregated Execution Metrics for Blok Runtimes
+ *
+ * Collects and aggregates execution metrics across all runtimes with
+ * latency percentiles, throughput tracking, and resource monitoring
+ * following the same patterns as TriggerMetricsCollector.
+ */
+import type { ExecutionResult, RuntimeKind } from "../adapters/RuntimeAdapter";
+export interface LatencyPercentiles {
+    count: number;
+    min: number;
+    max: number;
+    avg: number;
+    p50: number;
+    p95: number;
+    p99: number;
+}
+export interface ThroughputMetrics {
+    requestsPerSecond: number;
+    peakRps: number;
+    windowSizeMs: number;
+}
+export interface ResourceMetrics {
+    avgCpuMs: number;
+    avgMemoryBytes: number;
+    peakMemoryBytes: number;
+}
+export interface RuntimeExecutionMetrics {
+    runtime: RuntimeKind;
+    totalExecutions: number;
+    successfulExecutions: number;
+    failedExecutions: number;
+    successRate: number;
+    latency: LatencyPercentiles;
+    throughput: ThroughputMetrics;
+    resourceUsage: ResourceMetrics;
+    lastExecution: number;
+}
+export interface AggregateMetrics {
+    totalExecutions: number;
+    totalSuccess: number;
+    totalFailures: number;
+    overallSuccessRate: number;
+    avgLatencyMs: number;
+    activeRuntimes: number;
+    busiestRuntime: RuntimeKind | null;
+    slowestRuntime: RuntimeKind | null;
+}
+export interface DashboardSnapshot {
+    timestamp: number;
+    runtimes: RuntimeExecutionMetrics[];
+    aggregate: AggregateMetrics;
+}
+export declare class RuntimeMetricsDashboard {
+    private metrics;
+    /**
+     * Record an execution result for a runtime.
+     */
+    recordExecution(runtime: RuntimeKind, result: ExecutionResult): void;
+    /**
+     * Get computed metrics for a specific runtime.
+     */
+    getMetrics(runtime: RuntimeKind): RuntimeExecutionMetrics | undefined;
+    /**
+     * Get computed metrics for all tracked runtimes.
+     */
+    getAllMetrics(): RuntimeExecutionMetrics[];
+    /**
+     * Get a full dashboard snapshot with per-runtime and aggregate metrics.
+     */
+    getSnapshot(): DashboardSnapshot;
+    /**
+     * Get top runtimes ranked by a specific metric.
+     */
+    getTopRuntimes(by: "executions" | "successRate" | "latency", limit?: number): RuntimeExecutionMetrics[];
+    /**
+     * Get execution count trend over time windows for a specific runtime.
+     *
+     * @param runtime - The runtime to get trends for
+     * @param intervalMs - Size of each time window in ms (default: 60000 = 1 min)
+     * @param windowCount - Number of time windows to return (default: 10)
+     * @returns Array of execution counts, one per time window (oldest first)
+     */
+    getExecutionTrend(runtime: RuntimeKind, intervalMs?: number, windowCount?: number): number[];
+    /**
+     * Clear all metrics for all runtimes.
+     */
+    reset(): void;
+    /**
+     * Clear metrics for a specific runtime.
+     */
+    resetRuntime(runtime: RuntimeKind): void;
+    /**
+     * Compute RuntimeExecutionMetrics from raw data for a single runtime.
+     */
+    private computeMetrics;
+    /**
+     * Compute latency percentiles from a samples array.
+     */
+    private computeLatencyPercentiles;
+    /**
+     * Compute the p-th percentile from a pre-sorted array.
+     */
+    private percentile;
+    /**
+     * Compute resource usage metrics from raw data.
+     */
+    private computeResourceMetrics;
+    /**
+     * Compute aggregate metrics across all runtimes.
+     */
+    private computeAggregate;
+}

package/dist/marketplace/RuntimeMetricsDashboard.js

@@ -0,0 +1,293 @@
+/**
+ * RuntimeMetricsDashboard - Aggregated Execution Metrics for Blok Runtimes
+ *
+ * Collects and aggregates execution metrics across all runtimes with
+ * latency percentiles, throughput tracking, and resource monitoring
+ * following the same patterns as TriggerMetricsCollector.
+ */
+const MAX_LATENCY_SAMPLES = 10_000;
+const RPS_WINDOW_MS = 60_000; // 1 minute window for RPS calculation
+function createEmptyMetricsData() {
+    return {
+        latencySamples: [],
+        requestTimestamps: [],
+        cpuSamples: [],
+        memorySamples: [],
+        peakMemoryBytes: 0,
+        successCount: 0,
+        failureCount: 0,
+        peakRps: 0,
+        lastExecution: 0,
+    };
+}
+export class RuntimeMetricsDashboard {
+    metrics = new Map();
+    /**
+     * Record an execution result for a runtime.
+     */
+    recordExecution(runtime, result) {
+        let data = this.metrics.get(runtime);
+        if (!data) {
+            data = createEmptyMetricsData();
+            this.metrics.set(runtime, data);
+        }
+        const now = Date.now();
+        data.lastExecution = now;
+        // Track success/failure
+        if (result.success) {
+            data.successCount++;
+        }
+        else {
+            data.failureCount++;
+        }
+        // Record latency sample from execution metrics
+        if (result.metrics?.duration_ms !== undefined) {
+            data.latencySamples.push(result.metrics.duration_ms);
+            if (data.latencySamples.length > MAX_LATENCY_SAMPLES) {
+                // Keep only the most recent half
+                data.latencySamples = data.latencySamples.slice(-MAX_LATENCY_SAMPLES / 2);
+            }
+        }
+        // Record resource usage samples
+        if (result.metrics?.cpu_ms !== undefined) {
+            data.cpuSamples.push(result.metrics.cpu_ms);
+            if (data.cpuSamples.length > MAX_LATENCY_SAMPLES) {
+                data.cpuSamples = data.cpuSamples.slice(-MAX_LATENCY_SAMPLES / 2);
+            }
+        }
+        if (result.metrics?.memory_bytes !== undefined) {
+            data.memorySamples.push(result.metrics.memory_bytes);
+            if (result.metrics.memory_bytes > data.peakMemoryBytes) {
+                data.peakMemoryBytes = result.metrics.memory_bytes;
+            }
+            if (data.memorySamples.length > MAX_LATENCY_SAMPLES) {
+                data.memorySamples = data.memorySamples.slice(-MAX_LATENCY_SAMPLES / 2);
+            }
+        }
+        // Record request timestamp for RPS calculation
+        data.requestTimestamps.push(now);
+        const cutoff = now - RPS_WINDOW_MS;
+        while (data.requestTimestamps.length > 0 && data.requestTimestamps[0] < cutoff) {
+            data.requestTimestamps.shift();
+        }
+        // Update peak RPS
+        const currentRps = data.requestTimestamps.length / (RPS_WINDOW_MS / 1000);
+        if (currentRps > data.peakRps) {
+            data.peakRps = currentRps;
+        }
+    }
+    /**
+     * Get computed metrics for a specific runtime.
+     */
+    getMetrics(runtime) {
+        const data = this.metrics.get(runtime);
+        if (!data) {
+            return undefined;
+        }
+        return this.computeMetrics(runtime, data);
+    }
+    /**
+     * Get computed metrics for all tracked runtimes.
+     */
+    getAllMetrics() {
+        const result = [];
+        this.metrics.forEach((data, runtime) => {
+            result.push(this.computeMetrics(runtime, data));
+        });
+        return result;
+    }
+    /**
+     * Get a full dashboard snapshot with per-runtime and aggregate metrics.
+     */
+    getSnapshot() {
+        const runtimes = this.getAllMetrics();
+        const aggregate = this.computeAggregate(runtimes);
+        return {
+            timestamp: Date.now(),
+            runtimes,
+            aggregate,
+        };
+    }
+    /**
+     * Get top runtimes ranked by a specific metric.
+     */
+    getTopRuntimes(by, limit = 10) {
+        const all = this.getAllMetrics();
+        switch (by) {
+            case "executions":
+                all.sort((a, b) => b.totalExecutions - a.totalExecutions);
+                break;
+            case "successRate":
+                all.sort((a, b) => b.successRate - a.successRate);
+                break;
+            case "latency":
+                // Lower latency is better, sort ascending
+                all.sort((a, b) => a.latency.avg - b.latency.avg);
+                break;
+        }
+        return all.slice(0, limit);
+    }
+    /**
+     * Get execution count trend over time windows for a specific runtime.
+     *
+     * @param runtime - The runtime to get trends for
+     * @param intervalMs - Size of each time window in ms (default: 60000 = 1 min)
+     * @param windowCount - Number of time windows to return (default: 10)
+     * @returns Array of execution counts, one per time window (oldest first)
+     */
+    getExecutionTrend(runtime, intervalMs = 60_000, windowCount = 10) {
+        const data = this.metrics.get(runtime);
+        if (!data) {
+            return new Array(windowCount).fill(0);
+        }
+        const now = Date.now();
+        const trend = new Array(windowCount).fill(0);
+        for (const timestamp of data.requestTimestamps) {
+            const age = now - timestamp;
+            const windowIndex = windowCount - 1 - Math.floor(age / intervalMs);
+            if (windowIndex >= 0 && windowIndex < windowCount) {
+                trend[windowIndex]++;
+            }
+        }
+        return trend;
+    }
+    /**
+     * Clear all metrics for all runtimes.
+     */
+    reset() {
+        this.metrics.clear();
+    }
+    /**
+     * Clear metrics for a specific runtime.
+     */
+    resetRuntime(runtime) {
+        this.metrics.delete(runtime);
+    }
+    /**
+     * Compute RuntimeExecutionMetrics from raw data for a single runtime.
+     */
+    computeMetrics(runtime, data) {
+        const totalExecutions = data.successCount + data.failureCount;
+        const successRate = totalExecutions > 0 ? data.successCount / totalExecutions : 1;
+        // Prune old request timestamps before computing throughput
+        const now = Date.now();
+        const cutoff = now - RPS_WINDOW_MS;
+        while (data.requestTimestamps.length > 0 && data.requestTimestamps[0] < cutoff) {
+            data.requestTimestamps.shift();
+        }
+        const currentRps = data.requestTimestamps.length / (RPS_WINDOW_MS / 1000);
+        return {
+            runtime,
+            totalExecutions,
+            successfulExecutions: data.successCount,
+            failedExecutions: data.failureCount,
+            successRate,
+            latency: this.computeLatencyPercentiles(data.latencySamples),
+            throughput: {
+                requestsPerSecond: currentRps,
+                peakRps: data.peakRps,
+                windowSizeMs: RPS_WINDOW_MS,
+            },
+            resourceUsage: this.computeResourceMetrics(data),
+            lastExecution: data.lastExecution,
+        };
+    }
+    /**
+     * Compute latency percentiles from a samples array.
+     */
+    computeLatencyPercentiles(samples) {
+        if (samples.length === 0) {
+            return { count: 0, min: 0, max: 0, avg: 0, p50: 0, p95: 0, p99: 0 };
+        }
+        const sorted = [...samples].sort((a, b) => a - b);
+        const count = sorted.length;
+        const sum = sorted.reduce((a, b) => a + b, 0);
+        return {
+            count,
+            min: sorted[0],
+            max: sorted[count - 1],
+            avg: sum / count,
+            p50: this.percentile(sorted, 50),
+            p95: this.percentile(sorted, 95),
+            p99: this.percentile(sorted, 99),
+        };
+    }
+    /**
+     * Compute the p-th percentile from a pre-sorted array.
+     */
+    percentile(sorted, p) {
+        if (sorted.length === 0)
+            return 0;
+        const index = Math.ceil((p / 100) * sorted.length) - 1;
+        return sorted[Math.max(0, Math.min(index, sorted.length - 1))];
+    }
+    /**
+     * Compute resource usage metrics from raw data.
+     */
+    computeResourceMetrics(data) {
+        const avgCpuMs = data.cpuSamples.length > 0 ? data.cpuSamples.reduce((a, b) => a + b, 0) / data.cpuSamples.length : 0;
+        const avgMemoryBytes = data.memorySamples.length > 0 ? data.memorySamples.reduce((a, b) => a + b, 0) / data.memorySamples.length : 0;
+        return {
+            avgCpuMs,
+            avgMemoryBytes,
+            peakMemoryBytes: data.peakMemoryBytes,
+        };
+    }
+    /**
+     * Compute aggregate metrics across all runtimes.
+     */
+    computeAggregate(runtimes) {
+        if (runtimes.length === 0) {
+            return {
+                totalExecutions: 0,
+                totalSuccess: 0,
+                totalFailures: 0,
+                overallSuccessRate: 1,
+                avgLatencyMs: 0,
+                activeRuntimes: 0,
+                busiestRuntime: null,
+                slowestRuntime: null,
+            };
+        }
+        let totalExecutions = 0;
+        let totalSuccess = 0;
+        let totalFailures = 0;
+        let latencySum = 0;
+        let latencyCount = 0;
+        let busiestRuntime = null;
+        let busiestCount = -1;
+        let slowestRuntime = null;
+        let slowestLatency = -1;
+        for (const m of runtimes) {
+            totalExecutions += m.totalExecutions;
+            totalSuccess += m.successfulExecutions;
+            totalFailures += m.failedExecutions;
+            if (m.latency.count > 0) {
+                latencySum += m.latency.avg * m.latency.count;
+                latencyCount += m.latency.count;
+            }
+            if (m.totalExecutions > busiestCount) {
+                busiestCount = m.totalExecutions;
+                busiestRuntime = m.runtime;
+            }
+            if (m.latency.avg > slowestLatency && m.latency.count > 0) {
+                slowestLatency = m.latency.avg;
+                slowestRuntime = m.runtime;
+            }
+        }
+        const overallSuccessRate = totalExecutions > 0 ? totalSuccess / totalExecutions : 1;
+        const avgLatencyMs = latencyCount > 0 ? latencySum / latencyCount : 0;
+        const activeRuntimes = runtimes.filter((m) => m.totalExecutions > 0).length;
+        return {
+            totalExecutions,
+            totalSuccess,
+            totalFailures,
+            overallSuccessRate,
+            avgLatencyMs,
+            activeRuntimes,
+            busiestRuntime,
+            slowestRuntime,
+        };
+    }
+}
+//# sourceMappingURL=RuntimeMetricsDashboard.js.map

package/dist/marketplace/RuntimeMetricsDashboard.js.map

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

package/dist/monitoring/CircuitBreaker.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Circuit Breaker Pattern for Blok Triggers
+ *
+ * Prevents cascading failures by detecting repeated errors
+ * and temporarily disabling failing operations.
+ *
+ * States:
+ * - CLOSED: Normal operation, requests flow through
+ * - OPEN: Failures exceeded threshold, requests are rejected
+ * - HALF_OPEN: Testing recovery, limited requests allowed
+ */
+export type CircuitState = "CLOSED" | "OPEN" | "HALF_OPEN";
+export interface CircuitBreakerConfig {
+    /** Number of failures before opening the circuit */
+    failureThreshold: number;
+    /** Time in ms before attempting recovery (OPEN -> HALF_OPEN) */
+    resetTimeoutMs: number;
+    /** Number of successful requests in HALF_OPEN to close the circuit */
+    halfOpenMaxAttempts: number;
+    /** Optional: time window for failure counting (rolling window) */
+    failureWindowMs?: number;
+}
+export interface CircuitBreakerStats {
+    state: CircuitState;
+    failures: number;
+    successes: number;
+    consecutiveFailures: number;
+    lastFailure: number | null;
+    lastSuccess: number | null;
+    lastStateChange: number;
+    totalRequests: number;
+    totalRejected: number;
+}
+export type CircuitBreakerEventType = "state_change" | "request_rejected" | "failure" | "success";
+export interface CircuitBreakerEvent {
+    type: CircuitBreakerEventType;
+    state: CircuitState;
+    previousState?: CircuitState;
+    timestamp: number;
+    error?: Error;
+}
+export type CircuitBreakerListener = (event: CircuitBreakerEvent) => void;
+export declare class CircuitBreaker {
+    private state;
+    private failures;
+    private successes;
+    private consecutiveFailures;
+    private halfOpenAttempts;
+    private lastFailure;
+    private lastSuccess;
+    private lastStateChange;
+    private totalRequests;
+    private totalRejected;
+    private failureTimestamps;
+    private config;
+    private listeners;
+    private resetTimer;
+    constructor(config: CircuitBreakerConfig);
+    /**
+     * Execute a function through the circuit breaker.
+     * Throws CircuitOpenError if the circuit is open.
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Check if the circuit allows execution without actually executing.
+     */
+    canExecute(): boolean;
+    /**
+     * Get current circuit breaker statistics.
+     */
+    getStats(): CircuitBreakerStats;
+    /**
+     * Get the current circuit state.
+     */
+    getState(): CircuitState;
+    /**
+     * Get estimated time before the circuit will attempt recovery.
+     */
+    getRetryAfterMs(): number;
+    /**
+     * Manually reset the circuit to CLOSED state.
+     */
+    reset(): void;
+    /**
+     * Register an event listener.
+     */
+    on(listener: CircuitBreakerListener): void;
+    /**
+     * Remove an event listener.
+     */
+    off(listener: CircuitBreakerListener): void;
+    /**
+     * Clean up resources. Call when shutting down.
+     */
+    destroy(): void;
+    private onSuccess;
+    private onFailure;
+    private transitionTo;
+    private pruneOldFailures;
+    private scheduleResetTimer;
+    private clearResetTimer;
+    private emit;
+}
+export declare class CircuitOpenError extends Error {
+    retryAfterMs: number;
+    constructor(message: string, retryAfterMs: number);
+}