@blokjs/runner 0.6.21 → 0.7.0

package/dist/marketplace/RuntimeAutoScaler.js

@@ -1,366 +0,0 @@
-/**
- * RuntimeAutoScaler - Automatic Container Pool Scaling for Blok Runtimes
- *
- * Monitors runtime execution load and automatically adjusts Docker container
- * pool sizes based on configurable scaling policies. Tracks metrics like RPS,
- * p95 latency, and CPU utilization to make informed scaling decisions.
- *
- * Follows patterns from DockerRuntimeAdapter (pool management, health checks)
- * and TriggerMetricsCollector (metrics tracking, percentile calculations).
- */
-const DEFAULT_POLICY = {
-    minInstances: 1,
-    maxInstances: 10,
-    targetCpuUtilization: 70,
-    targetLatencyMs: 200,
-    targetRps: 100,
-    scaleUpCooldownMs: 60_000,
-    scaleDownCooldownMs: 300_000,
-    scaleUpStep: 1,
-    scaleDownStep: 1,
-};
-const DEFAULT_CONFIG = {
-    evaluationIntervalMs: 30_000,
-    enabled: true,
-    dryRun: false,
-};
-const MAX_HISTORY_DECISIONS = 500;
-/**
- * RuntimeAutoScaler monitors runtime execution load and automatically
- * adjusts Docker container pool sizes based on scaling policies.
- *
- * It periodically evaluates metrics from the RuntimeMetricsDashboard and
- * produces ScalingDecisions that indicate whether to scale up, scale down,
- * or maintain the current number of instances.
- */
-export class RuntimeAutoScaler {
-    policies = new Map();
-    history = new Map();
-    listeners = [];
-    interval;
-    dashboard;
-    config;
-    constructor(dashboard, config) {
-        this.dashboard = dashboard;
-        this.config = {
-            evaluationIntervalMs: config?.evaluationIntervalMs ?? DEFAULT_CONFIG.evaluationIntervalMs,
-            enabled: config?.enabled ?? DEFAULT_CONFIG.enabled,
-            dryRun: config?.dryRun ?? DEFAULT_CONFIG.dryRun,
-        };
-    }
-    /**
-     * Set a scaling policy for a runtime.
-     * Merges provided values with defaults.
-     */
-    setPolicy(policy) {
-        this.policies.set(policy.runtime, {
-            ...DEFAULT_POLICY,
-            ...policy,
-        });
-        // Initialize history for this runtime if not present
-        if (!this.history.has(policy.runtime)) {
-            this.history.set(policy.runtime, {
-                decisions: [],
-                scaleUpCount: 0,
-                scaleDownCount: 0,
-                lastScaleUp: 0,
-                lastScaleDown: 0,
-            });
-        }
-    }
-    /**
-     * Get the scaling policy for a runtime.
-     */
-    getPolicy(runtime) {
-        return this.policies.get(runtime);
-    }
-    /**
-     * Remove the scaling policy for a runtime.
-     */
-    removePolicy(runtime) {
-        this.policies.delete(runtime);
-    }
-    /**
-     * Begin periodic evaluation of all runtime scaling policies.
-     */
-    start() {
-        if (!this.config.enabled) {
-            return;
-        }
-        if (this.interval) {
-            clearInterval(this.interval);
-        }
-        this.interval = setInterval(() => {
-            this.evaluateAll();
-        }, this.config.evaluationIntervalMs);
-    }
-    /**
-     * Stop periodic evaluation.
-     */
-    stop() {
-        if (this.interval) {
-            clearInterval(this.interval);
-            this.interval = undefined;
-        }
-    }
-    /**
-     * Evaluate a single runtime against its scaling policy.
-     *
-     * The evaluation logic:
-     * 1. Get current metrics from RuntimeMetricsDashboard
-     * 2. Get the scaling policy for this runtime
-     * 3. Check cooldown periods (don't scale too frequently)
-     * 4. Determine desired instances based on RPS, latency, and CPU thresholds
-     * 5. Clamp desired between minInstances and maxInstances
-     * 6. Create ScalingDecision with descriptive reason
-     * 7. Record in history and notify listeners
-     */
-    evaluate(runtime) {
-        const policy = this.policies.get(runtime);
-        if (!policy) {
-            return this.createNoChangeDecision(runtime, 0, "No scaling policy configured for this runtime");
-        }
-        const metrics = this.collectMetrics(runtime);
-        const history = this.getOrCreateHistory(runtime);
-        const now = Date.now();
-        // Determine current instance count from instance utilization and max
-        const currentInstances = Math.max(policy.minInstances, Math.round((metrics.instanceUtilization / 100) * policy.maxInstances) || policy.minInstances);
-        let desiredInstances = currentInstances;
-        let action = "no_change";
-        let reason = "All metrics within acceptable thresholds";
-        // Check if scale up is needed
-        const rpsExceeded = metrics.currentRps > policy.targetRps * currentInstances;
-        const latencyExceeded = metrics.currentLatencyP95 > policy.targetLatencyMs;
-        const cpuExceeded = metrics.currentCpuUtilization > policy.targetCpuUtilization;
-        if (rpsExceeded || latencyExceeded) {
-            // Check scale-up cooldown
-            const timeSinceLastScaleUp = now - history.lastScaleUp;
-            if (timeSinceLastScaleUp < policy.scaleUpCooldownMs && history.lastScaleUp > 0) {
-                reason = `Scale up needed but in cooldown (${Math.round((policy.scaleUpCooldownMs - timeSinceLastScaleUp) / 1000)}s remaining)`;
-            }
-            else {
-                desiredInstances = currentInstances + policy.scaleUpStep;
-                action = "scale_up";
-                const reasons = [];
-                if (rpsExceeded) {
-                    reasons.push(`RPS ${metrics.currentRps.toFixed(1)} exceeds target ${policy.targetRps * currentInstances} (${policy.targetRps}/instance * ${currentInstances})`);
-                }
-                if (latencyExceeded) {
-                    reasons.push(`p95 latency ${metrics.currentLatencyP95.toFixed(1)}ms exceeds target ${policy.targetLatencyMs}ms`);
-                }
-                if (cpuExceeded) {
-                    reasons.push(`CPU utilization ${metrics.currentCpuUtilization.toFixed(1)}% exceeds target ${policy.targetCpuUtilization}%`);
-                }
-                reason = `Scaling up: ${reasons.join("; ")}`;
-            }
-        }
-        else {
-            // Check if scale down is possible
-            const canScaleDown = currentInstances > policy.minInstances;
-            const rpsAllowsScaleDown = metrics.currentRps < policy.targetRps * (currentInstances - 1);
-            const latencyIsGood = metrics.currentLatencyP95 <= policy.targetLatencyMs;
-            if (canScaleDown && rpsAllowsScaleDown && latencyIsGood) {
-                // Check scale-down cooldown
-                const timeSinceLastScaleDown = now - history.lastScaleDown;
-                if (timeSinceLastScaleDown < policy.scaleDownCooldownMs && history.lastScaleDown > 0) {
-                    reason = `Scale down possible but in cooldown (${Math.round((policy.scaleDownCooldownMs - timeSinceLastScaleDown) / 1000)}s remaining)`;
-                }
-                else {
-                    desiredInstances = currentInstances - policy.scaleDownStep;
-                    action = "scale_down";
-                    reason = `Scaling down: RPS ${metrics.currentRps.toFixed(1)} is below threshold ${policy.targetRps * (currentInstances - 1)} for ${currentInstances - 1} instances, latency ${metrics.currentLatencyP95.toFixed(1)}ms is within target ${policy.targetLatencyMs}ms`;
-                }
-            }
-        }
-        // Clamp desired instances between min and max
-        desiredInstances = Math.max(policy.minInstances, Math.min(policy.maxInstances, desiredInstances));
-        // If clamping changed the desired count back to current, it's a no_change
-        if (desiredInstances === currentInstances) {
-            action = "no_change";
-            if (desiredInstances >= policy.maxInstances && (rpsExceeded || latencyExceeded)) {
-                reason = `At maximum capacity (${policy.maxInstances} instances), cannot scale further`;
-            }
-        }
-        const decision = {
-            runtime,
-            action,
-            currentInstances,
-            desiredInstances,
-            reason,
-            timestamp: now,
-            metrics,
-        };
-        // Record in history
-        this.recordDecision(runtime, decision);
-        // Notify listeners
-        this.notifyListeners(decision);
-        return decision;
-    }
-    /**
-     * Evaluate all runtimes that have scaling policies.
-     */
-    evaluateAll() {
-        const decisions = [];
-        for (const runtime of this.policies.keys()) {
-            const decision = this.evaluate(runtime);
-            decisions.push(decision);
-        }
-        return decisions;
-    }
-    /**
-     * Get the scaling history for a runtime.
-     */
-    getHistory(runtime) {
-        return this.history.get(runtime);
-    }
-    /**
-     * Get scaling history for all runtimes.
-     */
-    getAllHistory() {
-        return new Map(this.history);
-    }
-    /**
-     * Subscribe to scaling decisions. Returns an unsubscribe function.
-     */
-    onScalingDecision(listener) {
-        this.listeners.push(listener);
-        return () => {
-            const index = this.listeners.indexOf(listener);
-            if (index !== -1) {
-                this.listeners.splice(index, 1);
-            }
-        };
-    }
-    /**
-     * Suggest a scaling policy based on current runtime metrics.
-     * Uses observed metrics to derive sensible defaults.
-     */
-    getRecommendedPolicy(runtime) {
-        const metrics = this.collectMetrics(runtime);
-        // Base recommendations on current observed load
-        const recommendedTargetRps = metrics.currentRps > 0 ? Math.ceil(metrics.currentRps * 1.5) : DEFAULT_POLICY.targetRps;
-        const recommendedTargetLatency = metrics.currentLatencyP95 > 0 ? Math.ceil(metrics.currentLatencyP95 * 1.25) : DEFAULT_POLICY.targetLatencyMs;
-        const recommendedMinInstances = metrics.currentRps > 0
-            ? Math.max(1, Math.ceil(metrics.currentRps / recommendedTargetRps))
-            : DEFAULT_POLICY.minInstances;
-        const recommendedMaxInstances = Math.max(recommendedMinInstances * 3, DEFAULT_POLICY.maxInstances);
-        return {
-            runtime,
-            minInstances: recommendedMinInstances,
-            maxInstances: recommendedMaxInstances,
-            targetCpuUtilization: DEFAULT_POLICY.targetCpuUtilization,
-            targetLatencyMs: recommendedTargetLatency,
-            targetRps: recommendedTargetRps,
-            scaleUpCooldownMs: DEFAULT_POLICY.scaleUpCooldownMs,
-            scaleDownCooldownMs: DEFAULT_POLICY.scaleDownCooldownMs,
-            scaleUpStep: DEFAULT_POLICY.scaleUpStep,
-            scaleDownStep: DEFAULT_POLICY.scaleDownStep,
-        };
-    }
-    /**
-     * Clear all history, policies, and state.
-     */
-    reset() {
-        this.stop();
-        this.policies.clear();
-        this.history.clear();
-        this.listeners = [];
-    }
-    /**
-     * Collect current scaling metrics from the RuntimeMetricsDashboard.
-     */
-    collectMetrics(runtime) {
-        const executionMetrics = this.dashboard.getMetrics(runtime);
-        if (!executionMetrics) {
-            return {
-                currentRps: 0,
-                currentLatencyP95: 0,
-                currentCpuUtilization: 0,
-                instanceUtilization: 0,
-            };
-        }
-        const policy = this.policies.get(runtime);
-        const maxInstances = policy?.maxInstances ?? DEFAULT_POLICY.maxInstances;
-        const minInstances = policy?.minInstances ?? DEFAULT_POLICY.minInstances;
-        // Estimate current instance count from total executions and RPS
-        // In the absence of a direct instance count, use minInstances as the baseline
-        const currentInstances = Math.max(minInstances, 1);
-        return {
-            currentRps: executionMetrics.throughput.requestsPerSecond,
-            currentLatencyP95: executionMetrics.latency.p95,
-            currentCpuUtilization: executionMetrics.resourceUsage.avgCpuMs > 0
-                ? Math.min(100, (executionMetrics.resourceUsage.avgCpuMs / 1000) * 100)
-                : 0,
-            instanceUtilization: maxInstances > 0 ? (currentInstances / maxInstances) * 100 : 0,
-        };
-    }
-    /**
-     * Create a no-change decision with the given reason.
-     */
-    createNoChangeDecision(runtime, currentInstances, reason) {
-        return {
-            runtime,
-            action: "no_change",
-            currentInstances,
-            desiredInstances: currentInstances,
-            reason,
-            timestamp: Date.now(),
-            metrics: {
-                currentRps: 0,
-                currentLatencyP95: 0,
-                currentCpuUtilization: 0,
-                instanceUtilization: 0,
-            },
-        };
-    }
-    /**
-     * Get or create history entry for a runtime.
-     */
-    getOrCreateHistory(runtime) {
-        let history = this.history.get(runtime);
-        if (!history) {
-            history = {
-                decisions: [],
-                scaleUpCount: 0,
-                scaleDownCount: 0,
-                lastScaleUp: 0,
-                lastScaleDown: 0,
-            };
-            this.history.set(runtime, history);
-        }
-        return history;
-    }
-    /**
-     * Record a scaling decision in the history.
-     */
-    recordDecision(runtime, decision) {
-        const history = this.getOrCreateHistory(runtime);
-        history.decisions.push(decision);
-        // Prune old decisions to avoid unbounded growth
-        if (history.decisions.length > MAX_HISTORY_DECISIONS) {
-            history.decisions = history.decisions.slice(-MAX_HISTORY_DECISIONS / 2);
-        }
-        if (decision.action === "scale_up") {
-            history.scaleUpCount++;
-            history.lastScaleUp = decision.timestamp;
-        }
-        else if (decision.action === "scale_down") {
-            history.scaleDownCount++;
-            history.lastScaleDown = decision.timestamp;
-        }
-    }
-    /**
-     * Notify all registered listeners of a scaling decision.
-     */
-    notifyListeners(decision) {
-        for (const listener of this.listeners) {
-            try {
-                listener(decision);
-            }
-            catch {
-                // Listener errors should not break the evaluation loop
-            }
-        }
-    }
-}
-//# sourceMappingURL=RuntimeAutoScaler.js.map

package/dist/marketplace/RuntimeAutoScaler.js.map

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

package/dist/marketplace/RuntimeCatalog.d.ts

@@ -1,180 +0,0 @@
-/**
- * RuntimeCatalog - Central Registry for Runtime Packages
- *
- * Manages runtime package metadata, search, versioning, and statistics
- * for the Blok marketplace. Supports publishing, discovery, and filtering
- * of runtime packages across all supported language runtimes.
- */
-import type { RuntimeKind } from "../adapters/RuntimeAdapter";
-export interface RuntimeNodeInfo {
-    name: string;
-    description: string;
-    inputs: Record<string, string>;
-    outputs: Record<string, string>;
-}
-export interface RuntimePackageManifest {
-    name: string;
-    version: string;
-    runtime: RuntimeKind;
-    description: string;
-    author: string;
-    license: string;
-    repository?: string;
-    tags: string[];
-    protocols: ("http" | "grpc" | "both")[];
-    dockerImage?: string;
-    minBlokVersion?: string;
-    /**
-     * Minimum runtime versions required by this package.
-     * Keys are runtime kind identifiers, values are semver constraints.
-     * @example { python3: ">=3.11.0", go: ">=1.21.0" }
-     */
-    runtimeVersions?: Partial<Record<string, string>>;
-    nodeCount: number;
-    nodes: RuntimeNodeInfo[];
-    createdAt: number;
-    updatedAt: number;
-    downloads: number;
-    rating: number;
-    verified: boolean;
-}
-export interface CatalogSearchOptions {
-    query?: string;
-    runtime?: RuntimeKind;
-    tags?: string[];
-    verified?: boolean;
-    sortBy?: "name" | "downloads" | "rating" | "updated";
-    sortOrder?: "asc" | "desc";
-    limit?: number;
-    offset?: number;
-}
-export interface CatalogSearchResult {
-    packages: RuntimePackageManifest[];
-    total: number;
-    page: number;
-    pageSize: number;
-}
-export interface CatalogStats {
-    totalPackages: number;
-    totalVersions: number;
-    packagesByRuntime: Record<string, number>;
-    totalDownloads: number;
-    verifiedCount: number;
-    averageRating: number;
-}
-export declare class RuntimeCatalog {
-    private packages;
-    constructor();
-    /**
-     * Publish a runtime package to the catalog.
-     *
-     * @param manifest - The package manifest to publish
-     * @throws Error if required fields are missing or invalid
-     */
-    publish(manifest: RuntimePackageManifest): void;
-    /**
-     * Remove a specific version of a package from the catalog.
-     *
-     * @param name - The package name
-     * @param version - The version to remove
-     * @returns true if the version was removed, false if not found
-     */
-    unpublish(name: string, version: string): boolean;
-    /**
-     * Get a package manifest by name and optional version.
-     * Returns the latest version if no version is specified.
-     *
-     * @param name - The package name
-     * @param version - Optional specific version
-     * @returns The manifest if found, undefined otherwise
-     */
-    get(name: string, version?: string): RuntimePackageManifest | undefined;
-    /**
-     * Get all available versions of a package, sorted by semver descending.
-     *
-     * @param name - The package name
-     * @returns Array of version strings sorted by semver (newest first)
-     */
-    getVersions(name: string): string[];
-    /**
-     * Get the latest version of a package by semver ordering.
-     *
-     * @param name - The package name
-     * @returns The latest version string, or undefined if package not found
-     */
-    getLatestVersion(name: string): string | undefined;
-    /**
-     * Search the catalog with filtering, sorting, and pagination.
-     *
-     * @param options - Search and filter options
-     * @returns Paginated search results
-     */
-    search(options: CatalogSearchOptions): CatalogSearchResult;
-    /**
-     * List all latest-version packages for a specific runtime.
-     *
-     * @param runtime - The runtime kind to filter by
-     * @returns Array of matching package manifests
-     */
-    listByRuntime(runtime: RuntimeKind): RuntimePackageManifest[];
-    /**
-     * Get the most popular packages sorted by download count.
-     *
-     * @param limit - Maximum number of results (default 10)
-     * @returns Array of package manifests sorted by downloads descending
-     */
-    getPopular(limit?: number): RuntimePackageManifest[];
-    /**
-     * Get all verified packages.
-     *
-     * @returns Array of verified package manifests
-     */
-    getVerified(): RuntimePackageManifest[];
-    /**
-     * Increment the download counter for a specific package version.
-     *
-     * @param name - The package name
-     * @param version - The package version
-     */
-    incrementDownloads(name: string, version: string): void;
-    /**
-     * Set the rating for a specific package version.
-     *
-     * @param name - The package name
-     * @param version - The package version
-     * @param rating - The rating value (0-5)
-     * @throws Error if rating is out of range
-     */
-    setRating(name: string, version: string, rating: number): void;
-    /**
-     * Get overall catalog statistics.
-     *
-     * @returns Aggregated catalog statistics
-     */
-    getStats(): CatalogStats;
-    /**
-     * Serialize the catalog to a JSON string for persistence.
-     *
-     * @returns JSON string representation of the catalog
-     */
-    toJSON(): string;
-    /**
-     * Deserialize a catalog from a JSON string.
-     *
-     * @param json - The JSON string to parse
-     * @returns A new RuntimeCatalog instance populated with the data
-     */
-    static fromJSON(json: string): RuntimeCatalog;
-    /**
-     * Get the latest version manifest for every package in the catalog.
-     */
-    private getAllLatestPackages;
-    /**
-     * Validate that a manifest has all required fields.
-     */
-    private validateManifest;
-    /**
-     * Compare two semver strings. Returns negative if a < b, 0 if equal, positive if a > b.
-     */
-    private compareSemver;
-}