@blokjs/runner 0.2.0

package/dist/adapters/DockerRuntimeAdapter.d.ts

@@ -0,0 +1,85 @@
+import type { Context } from "@blokjs/shared";
+import type RunnerNode from "../RunnerNode";
+import type { ExecutionResult, RuntimeAdapter, RuntimeKind } from "./RuntimeAdapter";
+/**
+ * Container pool configuration
+ */
+interface PoolConfig {
+    minInstances: number;
+    maxInstances: number;
+    maxIdleTime: number;
+    maxUseCount: number;
+    healthCheckInterval: number;
+}
+/**
+ * DockerRuntimeAdapter executes nodes in Docker containers
+ *
+ * This adapter provides:
+ * - Container pooling for performance
+ * - Health checks for reliability
+ * - Automatic cleanup and recycling
+ * - HTTP-based communication protocol
+ *
+ * Containers must expose an HTTP endpoint that:
+ * - POST /execute - Executes a node with the provided context
+ * - GET /health - Returns container health status
+ */
+export declare class DockerRuntimeAdapter implements RuntimeAdapter {
+    readonly kind: RuntimeKind;
+    private image;
+    private pool;
+    private poolConfig;
+    private cleanupInterval?;
+    private healthCheckInterval?;
+    private nextPort;
+    constructor(kind: RuntimeKind | undefined, image: string, poolConfig?: Partial<PoolConfig>);
+    /**
+     * Execute a node in a Docker container
+     */
+    execute(node: RunnerNode, ctx: Context): Promise<ExecutionResult>;
+    /**
+     * Get a container from the pool or create a new one
+     */
+    private getContainer;
+    /**
+     * Create a new container instance
+     */
+    private createContainer;
+    /**
+     * Wait for container to be healthy
+     */
+    private waitForHealth;
+    /**
+     * Check if a container is healthy
+     */
+    private checkHealth;
+    /**
+     * Execute a request in a container
+     */
+    private executeInContainer;
+    /**
+     * Create the execution request payload
+     */
+    private createExecutionRequest;
+    /**
+     * Recycle a container (stop and remove from pool)
+     */
+    private recycleContainer;
+    /**
+     * Initialize the container pool
+     */
+    private initializePool;
+    /**
+     * Cleanup idle containers
+     */
+    private cleanupIdleContainers;
+    /**
+     * Perform health checks on all containers
+     */
+    private performHealthChecks;
+    /**
+     * Shutdown the adapter and cleanup all containers
+     */
+    shutdown(): Promise<void>;
+}
+export {};

package/dist/adapters/DockerRuntimeAdapter.js

@@ -0,0 +1,298 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+const execAsync = promisify(exec);
+/**
+ * DockerRuntimeAdapter executes nodes in Docker containers
+ *
+ * This adapter provides:
+ * - Container pooling for performance
+ * - Health checks for reliability
+ * - Automatic cleanup and recycling
+ * - HTTP-based communication protocol
+ *
+ * Containers must expose an HTTP endpoint that:
+ * - POST /execute - Executes a node with the provided context
+ * - GET /health - Returns container health status
+ */
+export class DockerRuntimeAdapter {
+    kind;
+    image;
+    pool = new Map();
+    poolConfig;
+    cleanupInterval;
+    healthCheckInterval;
+    nextPort = 9000;
+    constructor(kind = "docker", image, poolConfig) {
+        this.kind = kind;
+        this.image = image;
+        this.poolConfig = {
+            minInstances: poolConfig?.minInstances ?? 0,
+            maxInstances: poolConfig?.maxInstances ?? 5,
+            maxIdleTime: poolConfig?.maxIdleTime ?? 5 * 60 * 1000, // 5 minutes
+            maxUseCount: poolConfig?.maxUseCount ?? 100,
+            healthCheckInterval: poolConfig?.healthCheckInterval ?? 30 * 1000, // 30 seconds
+        };
+        // Initialize pool
+        this.initializePool();
+    }
+    /**
+     * Execute a node in a Docker container
+     */
+    async execute(node, ctx) {
+        const startTime = performance.now();
+        try {
+            // Get or create a container from the pool
+            const container = await this.getContainer();
+            // Prepare the execution request
+            const request = this.createExecutionRequest(node, ctx);
+            // Execute via HTTP POST to container
+            const response = await this.executeInContainer(container, request);
+            // Update container stats
+            container.lastUsed = Date.now();
+            container.useCount++;
+            // Recycle container if needed
+            if (container.useCount >= this.poolConfig.maxUseCount) {
+                await this.recycleContainer(container);
+            }
+            const duration_ms = performance.now() - startTime;
+            return {
+                success: response.success ?? true,
+                data: response.data,
+                errors: response.errors || null,
+                logs: response.logs,
+                metrics: {
+                    duration_ms,
+                    ...(response.metrics || {}),
+                },
+            };
+        }
+        catch (error) {
+            const duration_ms = performance.now() - startTime;
+            return {
+                success: false,
+                data: null,
+                errors: {
+                    message: error.message,
+                    stack: error.stack,
+                    name: error.name,
+                },
+                metrics: {
+                    duration_ms,
+                },
+            };
+        }
+    }
+    /**
+     * Get a container from the pool or create a new one
+     */
+    async getContainer() {
+        // Try to get a healthy container from the pool
+        for (const container of this.pool.values()) {
+            if (container.healthy && container.useCount < this.poolConfig.maxUseCount) {
+                return container;
+            }
+        }
+        // Check if we can create a new container
+        if (this.pool.size < this.poolConfig.maxInstances) {
+            return await this.createContainer();
+        }
+        // Wait and retry (simple backoff)
+        await new Promise((resolve) => setTimeout(resolve, 100));
+        return await this.getContainer();
+    }
+    /**
+     * Create a new container instance
+     */
+    async createContainer() {
+        const port = this.nextPort++;
+        const containerName = `blok-runtime-${this.kind}-${Date.now()}-${port}`;
+        try {
+            // Run container with port mapping
+            const { stdout } = await execAsync(`docker run -d --name ${containerName} -p ${port}:8080 --rm ${this.image}`);
+            const containerId = stdout.trim();
+            const container = {
+                containerId,
+                containerName,
+                image: this.image,
+                port,
+                healthy: false,
+                lastUsed: Date.now(),
+                useCount: 0,
+            };
+            // Wait for container to be healthy
+            await this.waitForHealth(container);
+            this.pool.set(containerId, container);
+            return container;
+        }
+        catch (error) {
+            throw new Error(`Failed to create container: ${error.message}`);
+        }
+    }
+    /**
+     * Wait for container to be healthy
+     */
+    async waitForHealth(container, maxAttempts = 30, delay = 1000) {
+        for (let i = 0; i < maxAttempts; i++) {
+            try {
+                const healthy = await this.checkHealth(container);
+                if (healthy) {
+                    container.healthy = true;
+                    return;
+                }
+            }
+            catch {
+                // Container not ready yet
+            }
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+        throw new Error(`Container ${container.containerName} failed to become healthy`);
+    }
+    /**
+     * Check if a container is healthy
+     */
+    async checkHealth(container) {
+        try {
+            const response = await fetch(`http://localhost:${container.port}/health`, {
+                method: "GET",
+                signal: AbortSignal.timeout(2000),
+            });
+            if (response.ok) {
+                const data = await response.json();
+                return data.status === "healthy";
+            }
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Execute a request in a container
+     */
+    async executeInContainer(container, request) {
+        const response = await fetch(`http://localhost:${container.port}/execute`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(request),
+            signal: AbortSignal.timeout(30000), // 30 second timeout
+        });
+        if (!response.ok) {
+            throw new Error(`Container execution failed: ${response.statusText}`);
+        }
+        return (await response.json());
+    }
+    /**
+     * Create the execution request payload
+     */
+    createExecutionRequest(node, ctx) {
+        const nodeConfig = ctx.config ? ctx.config[node.name] : {};
+        return {
+            node: {
+                name: node.node,
+                type: node.type,
+                config: nodeConfig || {},
+            },
+            context: {
+                id: ctx.id,
+                workflow_name: ctx.workflow_name,
+                workflow_path: ctx.workflow_path,
+                request: {
+                    body: ctx.request.body,
+                    headers: ctx.request.headers,
+                    params: ctx.request.params,
+                    query: ctx.request.query,
+                    method: ctx.request.method,
+                    url: ctx.request.url,
+                    cookies: ctx.request.cookies,
+                    baseUrl: ctx.request.baseUrl,
+                },
+                response: ctx.response,
+                vars: ctx.vars,
+                env: ctx.env,
+            },
+        };
+    }
+    /**
+     * Recycle a container (stop and remove from pool)
+     */
+    async recycleContainer(container) {
+        this.pool.delete(container.containerId);
+        try {
+            // Container will auto-remove due to --rm flag
+            await execAsync(`docker stop ${container.containerName}`);
+        }
+        catch {
+            // Ignore errors during cleanup
+        }
+    }
+    /**
+     * Initialize the container pool
+     */
+    async initializePool() {
+        // Create minimum instances
+        const promises = [];
+        for (let i = 0; i < this.poolConfig.minInstances; i++) {
+            promises.push(this.createContainer().catch(() => null));
+        }
+        await Promise.all(promises);
+        // Start cleanup interval
+        this.cleanupInterval = setInterval(() => {
+            this.cleanupIdleContainers();
+        }, 60000); // Run every minute
+        // Start health check interval
+        this.healthCheckInterval = setInterval(() => {
+            this.performHealthChecks();
+        }, this.poolConfig.healthCheckInterval);
+    }
+    /**
+     * Cleanup idle containers
+     */
+    async cleanupIdleContainers() {
+        const now = Date.now();
+        const containersToRemove = [];
+        for (const container of this.pool.values()) {
+            const idleTime = now - container.lastUsed;
+            const isIdle = idleTime > this.poolConfig.maxIdleTime;
+            const canRemove = this.pool.size > this.poolConfig.minInstances;
+            if (isIdle && canRemove) {
+                containersToRemove.push(container);
+            }
+        }
+        for (const container of containersToRemove) {
+            await this.recycleContainer(container);
+        }
+    }
+    /**
+     * Perform health checks on all containers
+     */
+    async performHealthChecks() {
+        const checks = Array.from(this.pool.values()).map(async (container) => {
+            const healthy = await this.checkHealth(container);
+            container.healthy = healthy;
+            // Recycle unhealthy containers
+            if (!healthy) {
+                await this.recycleContainer(container);
+            }
+        });
+        await Promise.allSettled(checks);
+    }
+    /**
+     * Shutdown the adapter and cleanup all containers
+     */
+    async shutdown() {
+        // Clear intervals
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+        }
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+        }
+        // Stop all containers
+        const shutdownPromises = Array.from(this.pool.values()).map((container) => this.recycleContainer(container));
+        await Promise.allSettled(shutdownPromises);
+        this.pool.clear();
+    }
+}
+//# sourceMappingURL=DockerRuntimeAdapter.js.map

package/dist/adapters/DockerRuntimeAdapter.js.map

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

package/dist/adapters/HttpRuntimeAdapter.d.ts

@@ -0,0 +1,58 @@
+import type { Context } from "@blokjs/shared";
+import type RunnerNode from "../RunnerNode";
+import type { ExecutionResult, RuntimeAdapter, RuntimeKind } from "./RuntimeAdapter";
+/**
+ * Configuration options for HttpRuntimeAdapter
+ */
+export interface HttpRuntimeAdapterOptions {
+    /** Request timeout in milliseconds (default: 30000) */
+    timeoutMs?: number;
+}
+/**
+ * HttpRuntimeAdapter executes nodes in pre-existing SDK containers via HTTP.
+ *
+ * Unlike DockerRuntimeAdapter, this adapter does NOT manage container lifecycle.
+ * It connects to already-running containers (managed externally by Docker Compose,
+ * Kubernetes, or any other orchestrator).
+ *
+ * All SDK containers implement the same HTTP contract:
+ * - POST /execute  — Execute a node with the provided context
+ * - GET  /health   — Return container health status
+ *
+ * Environment variables per language:
+ *   RUNTIME_GO_HOST / RUNTIME_GO_PORT
+ *   RUNTIME_RUST_HOST / RUNTIME_RUST_PORT
+ *   RUNTIME_JAVA_HOST / RUNTIME_JAVA_PORT
+ *   RUNTIME_CSHARP_HOST / RUNTIME_CSHARP_PORT
+ *   RUNTIME_PHP_HOST / RUNTIME_PHP_PORT
+ *   RUNTIME_RUBY_HOST / RUNTIME_RUBY_PORT
+ *   RUNTIME_PYTHON3_HOST / RUNTIME_PYTHON3_PORT
+ */
+export declare class HttpRuntimeAdapter implements RuntimeAdapter {
+    readonly kind: RuntimeKind;
+    private baseUrl;
+    private timeoutMs;
+    constructor(kind: RuntimeKind, host: string, port: number, options?: HttpRuntimeAdapterOptions);
+    /**
+     * Execute a node in the SDK container via HTTP POST /execute
+     */
+    execute(node: RunnerNode, ctx: Context): Promise<ExecutionResult>;
+    /**
+     * Create the ExecutionRequest payload for the SDK container.
+     *
+     * Data flow priority:
+     * 1. If the node has resolved inputs (from blueprint Mapper), use those as request.body
+     *    This allows workflows to define explicit inputs like: "chain": "js/ctx.response.data.chain"
+     * 2. Otherwise, fall back to ctx.response.data (previous step output)
+     *    This enables zero-config chaining where SDK nodes automatically receive prior output
+     */
+    private createExecutionRequest;
+    /**
+     * Check if the SDK container is healthy via GET /health
+     */
+    checkHealth(): Promise<boolean>;
+    /**
+     * Get the base URL for this adapter
+     */
+    getBaseUrl(): string;
+}

package/dist/adapters/HttpRuntimeAdapter.js

@@ -0,0 +1,152 @@
+/**
+ * HttpRuntimeAdapter executes nodes in pre-existing SDK containers via HTTP.
+ *
+ * Unlike DockerRuntimeAdapter, this adapter does NOT manage container lifecycle.
+ * It connects to already-running containers (managed externally by Docker Compose,
+ * Kubernetes, or any other orchestrator).
+ *
+ * All SDK containers implement the same HTTP contract:
+ * - POST /execute  — Execute a node with the provided context
+ * - GET  /health   — Return container health status
+ *
+ * Environment variables per language:
+ *   RUNTIME_GO_HOST / RUNTIME_GO_PORT
+ *   RUNTIME_RUST_HOST / RUNTIME_RUST_PORT
+ *   RUNTIME_JAVA_HOST / RUNTIME_JAVA_PORT
+ *   RUNTIME_CSHARP_HOST / RUNTIME_CSHARP_PORT
+ *   RUNTIME_PHP_HOST / RUNTIME_PHP_PORT
+ *   RUNTIME_RUBY_HOST / RUNTIME_RUBY_PORT
+ *   RUNTIME_PYTHON3_HOST / RUNTIME_PYTHON3_PORT
+ */
+export class HttpRuntimeAdapter {
+    kind;
+    baseUrl;
+    timeoutMs;
+    constructor(kind, host, port, options) {
+        this.kind = kind;
+        this.baseUrl = `http://${host}:${port}`;
+        this.timeoutMs = options?.timeoutMs ?? 30000;
+    }
+    /**
+     * Execute a node in the SDK container via HTTP POST /execute
+     */
+    async execute(node, ctx) {
+        const startTime = performance.now();
+        try {
+            const request = this.createExecutionRequest(node, ctx);
+            const response = await fetch(`${this.baseUrl}/execute`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(request),
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP runtime '${this.kind}' at ${this.baseUrl} returned HTTP ${response.status}: ${response.statusText}`);
+            }
+            const result = (await response.json());
+            const duration_ms = performance.now() - startTime;
+            return {
+                success: result.success ?? true,
+                data: result.data,
+                errors: result.errors || null,
+                logs: result.logs,
+                metrics: {
+                    duration_ms,
+                    ...(result.metrics || {}),
+                },
+                vars: result.vars,
+            };
+        }
+        catch (error) {
+            const duration_ms = performance.now() - startTime;
+            return {
+                success: false,
+                data: null,
+                errors: {
+                    message: error.message,
+                    stack: error.stack,
+                    name: error.name,
+                },
+                metrics: {
+                    duration_ms,
+                },
+            };
+        }
+    }
+    /**
+     * Create the ExecutionRequest payload for the SDK container.
+     *
+     * Data flow priority:
+     * 1. If the node has resolved inputs (from blueprint Mapper), use those as request.body
+     *    This allows workflows to define explicit inputs like: "chain": "js/ctx.response.data.chain"
+     * 2. Otherwise, fall back to ctx.response.data (previous step output)
+     *    This enables zero-config chaining where SDK nodes automatically receive prior output
+     */
+    createExecutionRequest(node, ctx) {
+        const nodeConfig = ctx.config
+            ? ctx.config[node.name]
+            : {};
+        // Check if the Mapper has resolved inputs for this node
+        // The Mapper runs BEFORE run() in NodeBase.process(), so by now
+        // config[node.name].inputs has resolved values (not raw js/ expressions)
+        const resolvedInputs = nodeConfig?.inputs;
+        // Use resolved inputs if available, otherwise fall back to previous step data
+        const requestBody = resolvedInputs || (ctx.response?.data ?? {});
+        return {
+            node: {
+                name: node.node,
+                type: node.type,
+                config: nodeConfig || {},
+            },
+            context: {
+                id: ctx.id,
+                workflow_name: ctx.workflow_name,
+                workflow_path: ctx.workflow_path,
+                request: {
+                    body: requestBody,
+                    headers: ctx.request?.headers ?? {},
+                    params: ctx.request?.params ?? {},
+                    query: ctx.request?.query ?? {},
+                    method: ctx.request?.method ?? "",
+                    url: ctx.request?.url ?? "",
+                    cookies: ctx.request?.cookies ?? {},
+                    baseUrl: ctx.request?.baseUrl ?? "",
+                },
+                response: {
+                    data: null,
+                    contentType: "application/json",
+                    success: true,
+                    error: null,
+                },
+                vars: ctx.vars ?? {},
+                env: ctx.env ?? {},
+            },
+        };
+    }
+    /**
+     * Check if the SDK container is healthy via GET /health
+     */
+    async checkHealth() {
+        try {
+            const response = await fetch(`${this.baseUrl}/health`, {
+                method: "GET",
+                signal: AbortSignal.timeout(5000),
+            });
+            if (response.ok) {
+                const data = (await response.json());
+                return data.status === "healthy" || data.status === "ok";
+            }
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get the base URL for this adapter
+     */
+    getBaseUrl() {
+        return this.baseUrl;
+    }
+}
+//# sourceMappingURL=HttpRuntimeAdapter.js.map

package/dist/adapters/HttpRuntimeAdapter.js.map

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

package/dist/adapters/NodeJsRuntimeAdapter.d.ts

@@ -0,0 +1,23 @@
+import type { Context } from "@blokjs/shared";
+import type RunnerNode from "../RunnerNode";
+import type { ExecutionResult, RuntimeAdapter } from "./RuntimeAdapter";
+/**
+ * NodeJsRuntimeAdapter executes TypeScript/JavaScript nodes in-process
+ *
+ * This adapter handles both:
+ * - Module nodes: Nodes loaded from the NodeMap (registered npm packages)
+ * - Local nodes: Nodes loaded from the local filesystem
+ *
+ * Execution happens in the same Node.js process with zero gRPC/HTTP overhead.
+ */
+export declare class NodeJsRuntimeAdapter implements RuntimeAdapter {
+    readonly kind = "nodejs";
+    /**
+     * Execute a Node.js node in-process
+     *
+     * @param node - The node instance to execute (already resolved/instantiated)
+     * @param ctx - The workflow execution context
+     * @returns Promise that resolves to ExecutionResult
+     */
+    execute(node: RunnerNode, ctx: Context): Promise<ExecutionResult>;
+}