@blokjs/runner 0.2.0

package/dist/marketplace/RuntimeDiscovery.js

@@ -0,0 +1,219 @@
+/**
+ * RuntimeDiscovery - Package Discovery and Resolution Service
+ *
+ * Helps find, resolve, and recommend runtime packages from the catalog.
+ * Provides compatibility checking, semver range resolution, and
+ * intelligent package recommendations for the Blok marketplace.
+ */
+export class RuntimeDiscovery {
+    catalog;
+    registry;
+    constructor(catalog, registry) {
+        this.catalog = catalog;
+        this.registry = registry;
+    }
+    /**
+     * Discover all packages available for a specific runtime.
+     *
+     * @param runtime - The runtime kind to discover packages for
+     * @returns Array of matching package manifests
+     */
+    discover(runtime) {
+        return this.catalog.listByRuntime(runtime);
+    }
+    /**
+     * Resolve a package by name with full compatibility checking.
+     *
+     * @param options - Resolution options including name, version, runtime preference
+     * @returns Discovery result with compatibility info and alternatives, or undefined
+     */
+    resolve(options) {
+        const { name, version, runtime, preferVerified } = options;
+        let resolvedVersion;
+        if (version) {
+            // Check if this is a semver range or exact version
+            if (version.startsWith("^") || version.startsWith("~")) {
+                resolvedVersion = this.resolveVersion(name, version);
+            }
+            else {
+                resolvedVersion = version;
+            }
+        }
+        const manifest = this.catalog.get(name, resolvedVersion);
+        if (!manifest)
+            return undefined;
+        // If runtime is specified, verify it matches
+        if (runtime && manifest.runtime !== runtime) {
+            return undefined;
+        }
+        const compatibility = this.checkCompatibility(manifest);
+        let alternatives = this.findAlternatives(name, manifest.runtime);
+        // If preferVerified, sort alternatives with verified first
+        if (preferVerified) {
+            alternatives = alternatives.sort((a, b) => {
+                if (a.verified && !b.verified)
+                    return -1;
+                if (!a.verified && b.verified)
+                    return 1;
+                return 0;
+            });
+        }
+        return {
+            package: manifest,
+            compatibility,
+            alternatives,
+        };
+    }
+    /**
+     * Find alternative packages similar to a given package.
+     * Searches by shared tags and runtime kind.
+     *
+     * @param name - The package name to find alternatives for
+     * @param runtime - Optional runtime kind to filter alternatives
+     * @returns Array of alternative package manifests
+     */
+    findAlternatives(name, runtime) {
+        const original = this.catalog.get(name);
+        const searchResult = this.catalog.search({
+            runtime,
+            limit: 100,
+        });
+        // Exclude the original package and score by tag overlap
+        const candidates = searchResult.packages.filter((pkg) => pkg.name !== name);
+        if (!original)
+            return candidates;
+        // Score by tag similarity
+        const scored = candidates.map((pkg) => {
+            const sharedTags = pkg.tags.filter((tag) => original.tags.some((oTag) => oTag.toLowerCase() === tag.toLowerCase()));
+            return { pkg, score: sharedTags.length };
+        });
+        scored.sort((a, b) => b.score - a.score);
+        return scored.map((s) => s.pkg);
+    }
+    /**
+     * Check if a package is compatible with the current environment.
+     *
+     * @param manifest - The package manifest to check
+     * @returns Compatibility information with warnings
+     */
+    checkCompatibility(manifest) {
+        const warnings = [];
+        let runtimeAvailable = false;
+        const blokVersionMatch = true;
+        let protocolSupported = true;
+        // Check if the runtime adapter is registered
+        try {
+            runtimeAvailable = this.registry.has(manifest.runtime);
+        }
+        catch {
+            runtimeAvailable = false;
+        }
+        if (!runtimeAvailable) {
+            warnings.push(`Runtime '${manifest.runtime}' is not currently registered. Install the adapter before using this package.`);
+        }
+        // Check minimum Blok version compatibility
+        if (manifest.minBlokVersion) {
+            // In a real implementation, this would compare against the actual Blok version.
+            // For now, we assume compatibility and note the requirement.
+            warnings.push(`Package requires minimum Blok version ${manifest.minBlokVersion}. Verify your Blok installation is compatible.`);
+        }
+        // Check protocol support
+        if (manifest.protocols.length === 0) {
+            protocolSupported = false;
+            warnings.push("Package does not declare any supported protocols.");
+        }
+        const compatible = runtimeAvailable && blokVersionMatch && protocolSupported;
+        return {
+            compatible,
+            blokVersionMatch,
+            runtimeAvailable,
+            protocolSupported,
+            warnings,
+        };
+    }
+    /**
+     * Recommend packages for a runtime, optionally filtered by tags.
+     * Results are sorted by a composite score of rating and downloads.
+     *
+     * @param runtime - The runtime kind to recommend packages for
+     * @param tags - Optional tags to filter recommendations
+     * @returns Array of recommended package manifests
+     */
+    recommend(runtime, tags) {
+        let candidates = this.catalog.listByRuntime(runtime);
+        // Filter by tags if provided
+        if (tags && tags.length > 0) {
+            candidates = candidates.filter((pkg) => tags.some((tag) => pkg.tags.some((pkgTag) => pkgTag.toLowerCase() === tag.toLowerCase())));
+        }
+        // Sort by composite score: rating * log(downloads + 1)
+        candidates.sort((a, b) => {
+            const scoreA = a.rating * Math.log(a.downloads + 1);
+            const scoreB = b.rating * Math.log(b.downloads + 1);
+            return scoreB - scoreA;
+        });
+        return candidates;
+    }
+    /**
+     * Resolve a semver range to a specific version available in the catalog.
+     * Supports exact versions, ^ (caret), and ~ (tilde) ranges.
+     *
+     * @param name - The package name
+     * @param range - The semver range string (e.g., "^1.2.0", "~2.0.0", "1.5.3")
+     * @returns The resolved version string, or undefined if no match found
+     */
+    resolveVersion(name, range) {
+        const versions = this.catalog.getVersions(name);
+        if (versions.length === 0)
+            return undefined;
+        // Exact version match
+        if (!range.startsWith("^") && !range.startsWith("~")) {
+            return versions.includes(range) ? range : undefined;
+        }
+        const prefix = range[0];
+        const baseVersion = range.slice(1);
+        const baseParts = baseVersion.split(".").map(Number);
+        if (baseParts.length < 3) {
+            // Pad with zeros
+            while (baseParts.length < 3) {
+                baseParts.push(0);
+            }
+        }
+        const [baseMajor, baseMinor, basePatch] = baseParts;
+        const matching = versions.filter((v) => {
+            const parts = v.split(".").map(Number);
+            const [major, minor, patch] = [parts[0] || 0, parts[1] || 0, parts[2] || 0];
+            if (prefix === "^") {
+                // Caret: allows changes that do not modify the left-most non-zero digit
+                // ^1.2.3 := >=1.2.3 <2.0.0
+                // ^0.2.3 := >=0.2.3 <0.3.0
+                // ^0.0.3 := >=0.0.3 <0.0.4
+                if (baseMajor !== 0) {
+                    return major === baseMajor && this.semverGte(major, minor, patch, baseMajor, baseMinor, basePatch);
+                }
+                if (baseMinor !== 0) {
+                    return major === 0 && minor === baseMinor && patch >= basePatch;
+                }
+                return major === 0 && minor === 0 && patch === basePatch;
+            }
+            if (prefix === "~") {
+                // Tilde: allows patch-level changes
+                // ~1.2.3 := >=1.2.3 <1.3.0
+                return major === baseMajor && minor === baseMinor && patch >= basePatch;
+            }
+            return false;
+        });
+        // Return the highest matching version (versions are already sorted desc)
+        return matching.length > 0 ? matching[0] : undefined;
+    }
+    /**
+     * Check if version (major, minor, patch) is >= base version.
+     */
+    semverGte(major, minor, patch, baseMajor, baseMinor, basePatch) {
+        if (major !== baseMajor)
+            return major > baseMajor;
+        if (minor !== baseMinor)
+            return minor > baseMinor;
+        return patch >= basePatch;
+    }
+}
+//# sourceMappingURL=RuntimeDiscovery.js.map

package/dist/marketplace/RuntimeDiscovery.js.map

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

package/dist/marketplace/RuntimeHealthMonitor.d.ts

@@ -0,0 +1,100 @@
+/**
+ * RuntimeHealthMonitor - Health Monitoring for Blok Runtime Adapters
+ *
+ * Tracks the health of all registered runtime adapters with periodic
+ * health checks, status transitions, uptime tracking, and event-driven
+ * notifications following the same patterns as TriggerMetricsCollector.
+ */
+import type { RuntimeRegistry } from "../RuntimeRegistry";
+import type { RuntimeKind } from "../adapters/RuntimeAdapter";
+export interface RuntimeHealthStatus {
+    runtime: RuntimeKind;
+    status: "healthy" | "degraded" | "unhealthy" | "unknown";
+    lastCheck: number;
+    lastSuccess: number;
+    consecutiveFailures: number;
+    uptime: number;
+    latencyMs: number;
+    details: Record<string, unknown>;
+}
+export interface HealthMonitorConfig {
+    checkIntervalMs: number;
+    unhealthyThreshold: number;
+    degradedThreshold: number;
+    timeoutMs: number;
+    historySize: number;
+}
+export interface HealthCheckRecord {
+    runtime: RuntimeKind;
+    timestamp: number;
+    status: "healthy" | "degraded" | "unhealthy" | "unknown";
+    latencyMs: number;
+    error?: string;
+}
+export type HealthChangeListener = (runtime: RuntimeKind, oldStatus: string, newStatus: string) => void;
+export declare class RuntimeHealthMonitor {
+    private registry;
+    private config;
+    private healthStatuses;
+    private history;
+    private listeners;
+    private interval;
+    constructor(registry: RuntimeRegistry, config?: Partial<HealthMonitorConfig>);
+    /**
+     * Begin periodic health checks using setInterval.
+     */
+    start(): void;
+    /**
+     * Stop periodic health checks.
+     */
+    stop(): void;
+    /**
+     * Check all registered runtimes and return their health statuses.
+     */
+    checkAll(): Promise<Map<RuntimeKind, RuntimeHealthStatus>>;
+    /**
+     * Check a specific runtime by verifying adapter availability and responsiveness.
+     */
+    checkRuntime(runtime: RuntimeKind): Promise<RuntimeHealthStatus>;
+    /**
+     * Get current status for a specific runtime.
+     */
+    getStatus(runtime: RuntimeKind): RuntimeHealthStatus | undefined;
+    /**
+     * Get all current health statuses.
+     */
+    getAllStatuses(): RuntimeHealthStatus[];
+    /**
+     * Get check history, optionally filtered by runtime and limited in count.
+     */
+    getHistory(runtime?: RuntimeKind, limit?: number): HealthCheckRecord[];
+    /**
+     * Subscribe to status change events. Returns an unsubscribe function.
+     */
+    onHealthChange(listener: HealthChangeListener): () => void;
+    /**
+     * Quick check if a runtime is currently healthy.
+     */
+    isHealthy(runtime: RuntimeKind): boolean;
+    /**
+     * Calculate uptime percentage from history for a given runtime.
+     */
+    getUptimePercentage(runtime: RuntimeKind): number;
+    /**
+     * Clear all status data and history.
+     */
+    reset(): void;
+    /**
+     * Calculate uptime percentage from recorded history for a specific runtime.
+     * Uptime is the ratio of healthy checks to total checks, expressed as 0-100.
+     */
+    private calculateUptimeFromHistory;
+    /**
+     * Notify all listeners of a health status change.
+     */
+    private emitHealthChange;
+    /**
+     * Execute an async function with a timeout.
+     */
+    private withTimeout;
+}

package/dist/marketplace/RuntimeHealthMonitor.js

@@ -0,0 +1,241 @@
+/**
+ * RuntimeHealthMonitor - Health Monitoring for Blok Runtime Adapters
+ *
+ * Tracks the health of all registered runtime adapters with periodic
+ * health checks, status transitions, uptime tracking, and event-driven
+ * notifications following the same patterns as TriggerMetricsCollector.
+ */
+const DEFAULT_CONFIG = {
+    checkIntervalMs: 30_000,
+    unhealthyThreshold: 3,
+    degradedThreshold: 1,
+    timeoutMs: 5_000,
+    historySize: 100,
+};
+export class RuntimeHealthMonitor {
+    registry;
+    config;
+    healthStatuses = new Map();
+    history = [];
+    listeners = [];
+    interval;
+    constructor(registry, config) {
+        this.registry = registry;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Begin periodic health checks using setInterval.
+     */
+    start() {
+        if (this.interval) {
+            return;
+        }
+        // Perform an initial check immediately
+        this.checkAll();
+        this.interval = setInterval(() => {
+            this.checkAll();
+        }, this.config.checkIntervalMs);
+    }
+    /**
+     * Stop periodic health checks.
+     */
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = undefined;
+        }
+    }
+    /**
+     * Check all registered runtimes and return their health statuses.
+     */
+    async checkAll() {
+        const kinds = this.registry.getRegisteredKinds();
+        const results = new Map();
+        for (const kind of kinds) {
+            const status = await this.checkRuntime(kind);
+            results.set(kind, status);
+        }
+        return results;
+    }
+    /**
+     * Check a specific runtime by verifying adapter availability and responsiveness.
+     */
+    async checkRuntime(runtime) {
+        const startTime = Date.now();
+        const previousStatus = this.healthStatuses.get(runtime);
+        const oldStatusLabel = previousStatus?.status ?? "unknown";
+        let newStatus;
+        try {
+            // Verify the adapter is registered and functional by attempting to retrieve it.
+            // Wrap in a timeout to detect hung adapters.
+            await this.withTimeout(async () => {
+                const adapter = this.registry.get(runtime);
+                // Verify the adapter object is present and has the expected kind
+                if (adapter.kind !== runtime) {
+                    throw new Error(`Adapter kind mismatch: expected ${runtime}, got ${adapter.kind}`);
+                }
+            }, this.config.timeoutMs);
+            const latencyMs = Date.now() - startTime;
+            const consecutiveFailures = 0;
+            const status = "healthy";
+            newStatus = {
+                runtime,
+                status,
+                lastCheck: Date.now(),
+                lastSuccess: Date.now(),
+                consecutiveFailures,
+                uptime: 0,
+                latencyMs,
+                details: {},
+            };
+        }
+        catch (err) {
+            const latencyMs = Date.now() - startTime;
+            const consecutiveFailures = (previousStatus?.consecutiveFailures ?? 0) + 1;
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            let status;
+            if (consecutiveFailures >= this.config.unhealthyThreshold) {
+                status = "unhealthy";
+            }
+            else if (consecutiveFailures >= this.config.degradedThreshold) {
+                status = "degraded";
+            }
+            else {
+                status = "degraded";
+            }
+            newStatus = {
+                runtime,
+                status,
+                lastCheck: Date.now(),
+                lastSuccess: previousStatus?.lastSuccess ?? 0,
+                consecutiveFailures,
+                uptime: 0,
+                latencyMs,
+                details: { error: errorMessage },
+            };
+        }
+        // Record check in history
+        const record = {
+            runtime,
+            timestamp: newStatus.lastCheck,
+            status: newStatus.status,
+            latencyMs: newStatus.latencyMs,
+            ...(newStatus.details.error ? { error: newStatus.details.error } : {}),
+        };
+        this.history.push(record);
+        if (this.history.length > this.config.historySize) {
+            this.history = this.history.slice(-this.config.historySize);
+        }
+        // Calculate uptime from history
+        newStatus.uptime = this.calculateUptimeFromHistory(runtime);
+        // Store updated status
+        this.healthStatuses.set(runtime, newStatus);
+        // Emit health change events when status transitions
+        if (oldStatusLabel !== newStatus.status) {
+            this.emitHealthChange(runtime, oldStatusLabel, newStatus.status);
+        }
+        return newStatus;
+    }
+    /**
+     * Get current status for a specific runtime.
+     */
+    getStatus(runtime) {
+        return this.healthStatuses.get(runtime);
+    }
+    /**
+     * Get all current health statuses.
+     */
+    getAllStatuses() {
+        return Array.from(this.healthStatuses.values());
+    }
+    /**
+     * Get check history, optionally filtered by runtime and limited in count.
+     */
+    getHistory(runtime, limit) {
+        let records = [...this.history];
+        if (runtime) {
+            records = records.filter((r) => r.runtime === runtime);
+        }
+        if (limit !== undefined && limit > 0) {
+            records = records.slice(-limit);
+        }
+        return records;
+    }
+    /**
+     * Subscribe to status change events. Returns an unsubscribe function.
+     */
+    onHealthChange(listener) {
+        this.listeners.push(listener);
+        return () => {
+            const index = this.listeners.indexOf(listener);
+            if (index !== -1) {
+                this.listeners.splice(index, 1);
+            }
+        };
+    }
+    /**
+     * Quick check if a runtime is currently healthy.
+     */
+    isHealthy(runtime) {
+        const status = this.healthStatuses.get(runtime);
+        return status?.status === "healthy";
+    }
+    /**
+     * Calculate uptime percentage from history for a given runtime.
+     */
+    getUptimePercentage(runtime) {
+        return this.calculateUptimeFromHistory(runtime);
+    }
+    /**
+     * Clear all status data and history.
+     */
+    reset() {
+        this.healthStatuses.clear();
+        this.history = [];
+    }
+    /**
+     * Calculate uptime percentage from recorded history for a specific runtime.
+     * Uptime is the ratio of healthy checks to total checks, expressed as 0-100.
+     */
+    calculateUptimeFromHistory(runtime) {
+        const runtimeHistory = this.history.filter((r) => r.runtime === runtime);
+        if (runtimeHistory.length === 0) {
+            return 100;
+        }
+        const healthyChecks = runtimeHistory.filter((r) => r.status === "healthy").length;
+        return (healthyChecks / runtimeHistory.length) * 100;
+    }
+    /**
+     * Notify all listeners of a health status change.
+     */
+    emitHealthChange(runtime, oldStatus, newStatus) {
+        for (const listener of this.listeners) {
+            try {
+                listener(runtime, oldStatus, newStatus);
+            }
+            catch {
+                // Swallow listener errors to avoid breaking the monitor loop
+            }
+        }
+    }
+    /**
+     * Execute an async function with a timeout.
+     */
+    withTimeout(fn, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`Health check timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            fn()
+                .then((result) => {
+                clearTimeout(timer);
+                resolve(result);
+            })
+                .catch((err) => {
+                clearTimeout(timer);
+                reject(err);
+            });
+        });
+    }
+}
+//# sourceMappingURL=RuntimeHealthMonitor.js.map

package/dist/marketplace/RuntimeHealthMonitor.js.map

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