@blokjs/runner 0.2.1 → 0.4.0

package/dist/adapters/RuntimeAdapter.d.ts

@@ -4,6 +4,13 @@ import type RunnerNode from "../RunnerNode";
  * RuntimeKind represents all supported runtime environments
  */
 export type RuntimeKind = "nodejs" | "bun" | "python3" | "go" | "java" | "rust" | "php" | "csharp" | "ruby" | "docker" | "wasm";
+/**
+ * Wire transport an adapter uses to reach an SDK runtime. `module` is for
+ * in-process NodeJS adapters; `http` and `grpc` are the two non-NodeJS
+ * options. Used for log tagging and for distinguishing the same `kind`
+ * across transports during the gRPC migration.
+ */
+export type AdapterTransport = "module" | "http" | "grpc";
 /**
  * ExecutionResult is the canonical response structure from any runtime adapter
  */
@@ -16,6 +23,10 @@ export type ExecutionResult = {
         duration_ms?: number;
         cpu_ms?: number;
         memory_bytes?: number;
+        /** Approximate or exact bytes the adapter sent on the wire. */
+        request_bytes?: number;
+        /** Bytes the adapter received from the SDK. */
+        response_bytes?: number;
     };
     /** Variables set by the SDK node during execution, to be merged into ctx.vars */
     vars?: Record<string, unknown>;
@@ -31,6 +42,12 @@ export interface RuntimeAdapter {
      * The kind of runtime this adapter handles
      */
     readonly kind: RuntimeKind;
+    /**
+     * Wire transport this adapter uses (`http`, `grpc`, or in-process
+     * `module`). Surfaced in step-prefix logs so operators can tell at a
+     * glance which path a runtime node took during the migration.
+     */
+    readonly transport: AdapterTransport;
     /**
      * Execute a node in this runtime
      *

package/dist/adapters/WasmRuntimeAdapter.d.ts

@@ -21,6 +21,7 @@ import type { ExecutionResult, RuntimeAdapter } from "./RuntimeAdapter";
  */
 export declare class WasmRuntimeAdapter implements RuntimeAdapter {
     readonly kind: "wasm";
+    readonly transport: "module";
     private moduleCache;
     private maxCacheSize;
     constructor(options?: {

package/dist/adapters/WasmRuntimeAdapter.js

@@ -18,6 +18,7 @@
  */
 export class WasmRuntimeAdapter {
     kind = "wasm";
+    transport = "module";
     moduleCache = new Map();
     maxCacheSize;
     constructor(options) {

package/dist/adapters/WasmRuntimeAdapter.js.map

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

package/dist/adapters/grpc/GrpcChannelOptions.d.ts

@@ -0,0 +1,31 @@
+import type { ChannelOptions } from "@grpc/grpc-js";
+import { GRPC_DEFAULTS, type GrpcAdapterConfig } from "./types";
+/**
+ * Build the {@link ChannelOptions} dictionary for `@grpc/grpc-js` from a
+ * {@link GrpcAdapterConfig}. Pure function — no I/O.
+ *
+ * The returned options enforce:
+ * - 16MB max send/receive message length (parity with PHP buffer ceiling).
+ * - Keepalive pings every 10s with 5s ack timeout.
+ * - TLS server-name override when provided.
+ *
+ * Service config (for `Health` RPC retries) is passed through verbatim so
+ * advanced users can tune retry/hedging policy without touching this file.
+ *
+ * @example
+ *   const channel = new grpc.Client(
+ *     `${cfg.host}:${cfg.port}`,
+ *     credentials,
+ *     buildChannelOptions(cfg),
+ *   );
+ */
+export declare function buildChannelOptions(config: GrpcAdapterConfig): ChannelOptions;
+/**
+ * Default service config for the Health RPC. Permits up to 3 retries on
+ * `UNAVAILABLE` with exponential backoff.
+ *
+ * Only applied to `NodeRuntime/Health` — `Execute` is intentionally never
+ * retried automatically because workflow steps are not idempotent in general.
+ */
+export declare const DEFAULT_HEALTH_SERVICE_CONFIG: string;
+export { GRPC_DEFAULTS };

package/dist/adapters/grpc/GrpcChannelOptions.js

@@ -0,0 +1,68 @@
+import { GRPC_DEFAULTS } from "./types";
+/**
+ * Build the {@link ChannelOptions} dictionary for `@grpc/grpc-js` from a
+ * {@link GrpcAdapterConfig}. Pure function — no I/O.
+ *
+ * The returned options enforce:
+ * - 16MB max send/receive message length (parity with PHP buffer ceiling).
+ * - Keepalive pings every 10s with 5s ack timeout.
+ * - TLS server-name override when provided.
+ *
+ * Service config (for `Health` RPC retries) is passed through verbatim so
+ * advanced users can tune retry/hedging policy without touching this file.
+ *
+ * @example
+ *   const channel = new grpc.Client(
+ *     `${cfg.host}:${cfg.port}`,
+ *     credentials,
+ *     buildChannelOptions(cfg),
+ *   );
+ */
+export function buildChannelOptions(config) {
+    const opts = {
+        "grpc.max_send_message_length": config.maxMessageBytes,
+        "grpc.max_receive_message_length": config.maxMessageBytes,
+        "grpc.keepalive_time_ms": config.keepalive.timeMs,
+        "grpc.keepalive_timeout_ms": config.keepalive.timeoutMs,
+        "grpc.keepalive_permit_without_calls": config.keepalive.permitWithoutCalls ? 1 : 0,
+        // Sets the maximum amount of time a connection can be idle before keepalive
+        // pings start. Matches keepalive_time so we ping consistently.
+        "grpc.http2.min_time_between_pings_ms": config.keepalive.timeMs,
+    };
+    if (config.tls?.serverNameOverride) {
+        opts["grpc.ssl_target_name_override"] = config.tls.serverNameOverride;
+        opts["grpc.default_authority"] = config.tls.serverNameOverride;
+    }
+    if (config.serviceConfigJson) {
+        opts["grpc.service_config"] = config.serviceConfigJson;
+    }
+    return opts;
+}
+/**
+ * Default service config for the Health RPC. Permits up to 3 retries on
+ * `UNAVAILABLE` with exponential backoff.
+ *
+ * Only applied to `NodeRuntime/Health` — `Execute` is intentionally never
+ * retried automatically because workflow steps are not idempotent in general.
+ */
+export const DEFAULT_HEALTH_SERVICE_CONFIG = JSON.stringify({
+    methodConfig: [
+        {
+            name: [
+                {
+                    service: "blok.runtime.v1.NodeRuntime",
+                    method: "Health",
+                },
+            ],
+            retryPolicy: {
+                maxAttempts: 3,
+                initialBackoff: "0.1s",
+                maxBackoff: "1s",
+                backoffMultiplier: 2,
+                retryableStatusCodes: ["UNAVAILABLE"],
+            },
+        },
+    ],
+});
+export { GRPC_DEFAULTS };
+//# sourceMappingURL=GrpcChannelOptions.js.map

package/dist/adapters/grpc/GrpcChannelOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GrpcChannelOptions.js","sourceRoot":"","sources":["../../../src/adapters/grpc/GrpcChannelOptions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAA0B,MAAM,SAAS,CAAC;AAEhE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAyB;IAC5D,MAAM,IAAI,GAAmB;QAC5B,8BAA8B,EAAE,MAAM,CAAC,eAAe;QACtD,iCAAiC,EAAE,MAAM,CAAC,eAAe;QACzD,wBAAwB,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM;QACjD,2BAA2B,EAAE,MAAM,CAAC,SAAS,CAAC,SAAS;QACvD,qCAAqC,EAAE,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClF,4EAA4E;QAC5E,+DAA+D;QAC/D,sCAAsC,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM;KAC/D,CAAC;IAEF,IAAI,MAAM,CAAC,GAAG,EAAE,kBAAkB,EAAE,CAAC;QACpC,IAAI,CAAC,+BAA+B,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACtE,IAAI,CAAC,wBAAwB,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAChE,CAAC;IAED,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC9B,IAAI,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACxD,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAW,IAAI,CAAC,SAAS,CAAC;IACnE,YAAY,EAAE;QACb;YACC,IAAI,EAAE;gBACL;oBACC,OAAO,EAAE,6BAA6B;oBACtC,MAAM,EAAE,QAAQ;iBAChB;aACD;YACD,WAAW,EAAE;gBACZ,WAAW,EAAE,CAAC;gBACd,cAAc,EAAE,MAAM;gBACtB,UAAU,EAAE,IAAI;gBAChB,iBAAiB,EAAE,CAAC;gBACpB,oBAAoB,EAAE,CAAC,aAAa,CAAC;aACrC;SACD;KACD;CACD,CAAC,CAAC;AAEH,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/adapters/grpc/GrpcClientPool.d.ts

@@ -0,0 +1,43 @@
+import { type ChannelCredentials, type Client } from "@grpc/grpc-js";
+import type { GrpcAdapterConfig, TlsConfig } from "./types";
+/**
+ * Pool of gRPC clients keyed by `(host, port)`. One persistent client per
+ * endpoint for the lifetime of the pool — no per-request TCP/HTTP/2
+ * handshake.
+ *
+ * Adapters request a client via {@link get}; the pool creates it on first
+ * use and caches it. {@link close} drains all clients, used during graceful
+ * shutdown.
+ *
+ * Single Responsibility: lifecycle of `Client` instances. The pool does not
+ * encode requests, decode responses, or interpret errors — those belong to
+ * {@link GrpcCodec} and {@link GrpcErrors}.
+ */
+export declare class GrpcClientPool {
+    private readonly clients;
+    /**
+     * Get (or lazily create) a client for the given config's `(host, port)`.
+     * Subsequent calls with the same endpoint return the same instance.
+     */
+    get(config: GrpcAdapterConfig): Client;
+    /**
+     * Close a client for a specific endpoint. Returns true if a client was
+     * present and closed.
+     */
+    closeEndpoint(host: string, port: number): boolean;
+    /**
+     * Drain the pool. Closes every cached client.
+     */
+    close(): void;
+    /** How many clients the pool currently holds. */
+    size(): number;
+}
+/**
+ * Build channel credentials from a {@link TlsConfig}. When `tls` is omitted
+ * returns insecure credentials (plaintext channel) — appropriate for loopback
+ * dev only.
+ *
+ * `BLOK_GRPC_REQUIRE_TLS=true` causes the adapter to throw at startup when an
+ * insecure channel targets a non-loopback host.
+ */
+export declare function buildCredentials(tls?: TlsConfig): ChannelCredentials;

package/dist/adapters/grpc/GrpcClientPool.js

@@ -0,0 +1,89 @@
+import fs from "node:fs";
+import { credentials as grpcCredentials } from "@grpc/grpc-js";
+import { buildChannelOptions } from "./GrpcChannelOptions";
+import { NodeRuntimeService } from "./GrpcCodec";
+/**
+ * Pool of gRPC clients keyed by `(host, port)`. One persistent client per
+ * endpoint for the lifetime of the pool — no per-request TCP/HTTP/2
+ * handshake.
+ *
+ * Adapters request a client via {@link get}; the pool creates it on first
+ * use and caches it. {@link close} drains all clients, used during graceful
+ * shutdown.
+ *
+ * Single Responsibility: lifecycle of `Client` instances. The pool does not
+ * encode requests, decode responses, or interpret errors — those belong to
+ * {@link GrpcCodec} and {@link GrpcErrors}.
+ */
+export class GrpcClientPool {
+    clients = new Map();
+    /**
+     * Get (or lazily create) a client for the given config's `(host, port)`.
+     * Subsequent calls with the same endpoint return the same instance.
+     */
+    get(config) {
+        const endpoint = `${config.host}:${config.port}`;
+        const existing = this.clients.get(endpoint);
+        if (existing)
+            return existing;
+        const creds = buildCredentials(config.tls);
+        const options = buildChannelOptions(config);
+        const ServiceCtor = NodeRuntimeService;
+        const client = new ServiceCtor(endpoint, creds, options);
+        this.clients.set(endpoint, client);
+        return client;
+    }
+    /**
+     * Close a client for a specific endpoint. Returns true if a client was
+     * present and closed.
+     */
+    closeEndpoint(host, port) {
+        const endpoint = `${host}:${port}`;
+        const client = this.clients.get(endpoint);
+        if (!client)
+            return false;
+        client.close();
+        this.clients.delete(endpoint);
+        return true;
+    }
+    /**
+     * Drain the pool. Closes every cached client.
+     */
+    close() {
+        for (const client of this.clients.values()) {
+            try {
+                client.close();
+            }
+            catch {
+                /* swallow — best-effort cleanup during shutdown */
+            }
+        }
+        this.clients.clear();
+    }
+    /** How many clients the pool currently holds. */
+    size() {
+        return this.clients.size;
+    }
+}
+/**
+ * Build channel credentials from a {@link TlsConfig}. When `tls` is omitted
+ * returns insecure credentials (plaintext channel) — appropriate for loopback
+ * dev only.
+ *
+ * `BLOK_GRPC_REQUIRE_TLS=true` causes the adapter to throw at startup when an
+ * insecure channel targets a non-loopback host.
+ */
+export function buildCredentials(tls) {
+    if (!tls)
+        return grpcCredentials.createInsecure();
+    if (tls.insecureSkipVerify) {
+        // Verified-server-via-handshake-skipped is genuinely insecure. We log
+        // at adapter startup; here we just produce the credentials object.
+        return grpcCredentials.createInsecure();
+    }
+    const ca = tls.caCertPath ? fs.readFileSync(tls.caCertPath) : null;
+    const clientCert = tls.clientCertPath ? fs.readFileSync(tls.clientCertPath) : null;
+    const clientKey = tls.clientKeyPath ? fs.readFileSync(tls.clientKeyPath) : null;
+    return grpcCredentials.createSsl(ca ?? null, clientKey ?? null, clientCert ?? null);
+}
+//# sourceMappingURL=GrpcClientPool.js.map

package/dist/adapters/grpc/GrpcClientPool.js.map

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

package/dist/adapters/grpc/GrpcCodec.d.ts

@@ -0,0 +1,226 @@
+import type { Context } from "@blokjs/shared";
+import { type ServiceClientConstructor } from "@grpc/grpc-js";
+import type RunnerNode from "../../RunnerNode";
+/**
+ * The {@link NodeRuntime} service client constructor — used by
+ * {@link GrpcClientPool} to instantiate clients.
+ */
+export declare const NodeRuntimeService: ServiceClientConstructor;
+export interface ExecuteRequestProto {
+    node: NodeRefProto;
+    inputs: Buffer;
+    step: StepInfoProto;
+    trigger: TriggerInfoProto;
+    state: RuntimeStateProto;
+    workflow: WorkflowInfoProto;
+    options: ExecuteOptionsProto;
+}
+export interface NodeRefProto {
+    name: string;
+    type: string;
+    version: string;
+}
+export interface StepInfoProto {
+    name: string;
+    index: number;
+    total: number;
+    depth: number;
+}
+export interface TriggerInfoProto {
+    body: Buffer;
+    headers: Record<string, string>;
+    params: Record<string, string>;
+    query: Record<string, string>;
+    cookies: Record<string, string>;
+    method: string;
+    url: string;
+    baseUrl: string;
+    triggerKind: string;
+}
+export interface RuntimeStateProto {
+    previousOutput: Buffer;
+    vars: Buffer;
+    env: Record<string, string>;
+}
+export interface WorkflowInfoProto {
+    runId: string;
+    name: string;
+    path: string;
+    version: string;
+    startedAt: {
+        seconds: string;
+        nanos: number;
+    } | null;
+}
+export interface ExecuteOptionsProto {
+    deadlineMs: string;
+    streamLogs: boolean;
+    captureMetrics: boolean;
+    hints: Record<string, string>;
+}
+export interface ExecuteResponseProto {
+    success: boolean;
+    data: Buffer;
+    contentType: string;
+    error: NodeErrorProto | null;
+    varsDelta: Buffer;
+    logs: LogLineProto[];
+    metrics: MetricsProto | null;
+}
+export interface NodeErrorProto {
+    code: string;
+    category: string;
+    severity: string;
+    node: string;
+    sdk: string;
+    sdkVersion: string;
+    runtimeKind: string;
+    at: {
+        seconds: string;
+        nanos: number;
+    } | null;
+    message: string;
+    description: string;
+    remediation: string;
+    docUrl: string;
+    causes: NodeErrorProto[];
+    stack: string;
+    contextSnapshotJson: Buffer;
+    httpStatus: number;
+    retryable: boolean;
+    retryAfterMs: string;
+    detailsJson: Buffer;
+}
+export interface LogLineProto {
+    timestamp: {
+        seconds: string;
+        nanos: number;
+    } | null;
+    level: string;
+    message: string;
+    attributes: Record<string, string>;
+}
+export interface MetricsProto {
+    durationMs: number;
+    cpuMs: number;
+    memoryBytes: string;
+    requestBytes: string;
+    responseBytes: string;
+}
+export interface DecodedExecuteResponse {
+    readonly success: boolean;
+    readonly data: unknown;
+    readonly contentType: string;
+    readonly varsDelta: Record<string, unknown>;
+    readonly logs: ReadonlyArray<DecodedLogLine>;
+    readonly error: DecodedNodeError | null;
+    readonly metrics: DecodedMetrics;
+}
+export interface DecodedLogLine {
+    readonly timestamp: number;
+    readonly level: string;
+    readonly message: string;
+    readonly attributes: Record<string, string>;
+}
+export interface DecodedNodeError {
+    readonly code: string;
+    readonly category: string;
+    readonly severity: string;
+    readonly node: string;
+    readonly sdk: string;
+    readonly sdkVersion: string;
+    readonly runtimeKind: string;
+    readonly at: number;
+    readonly message: string;
+    readonly description: string;
+    readonly remediation: string;
+    readonly docUrl: string;
+    readonly causes: ReadonlyArray<DecodedNodeError>;
+    readonly stack: string;
+    readonly contextSnapshot: unknown;
+    readonly httpStatus: number;
+    readonly retryable: boolean;
+    readonly retryAfterMs: number;
+    readonly details: unknown;
+}
+export interface DecodedMetrics {
+    readonly durationMs: number;
+    readonly cpuMs: number;
+    readonly memoryBytes: number;
+    readonly requestBytes: number;
+    readonly responseBytes: number;
+}
+/**
+ * Encode a workflow {@link Context} and a {@link RunnerNode} into a
+ * {@link ExecuteRequestProto} ready for the gRPC wire.
+ *
+ * Pure function — no I/O. The opaque JSON-shaped fields (`inputs`,
+ * `previous_output`, `vars`, body) are serialized to UTF-8 bytes here so the
+ * SDK side can JSON-decode lazily.
+ *
+ * Critically, `inputs` is the resolved node config (from the Blueprint
+ * Mapper) sent UNWRAPPED — no `{inputs:{...}}` envelope. This closes the
+ * `BLOK_FRAMEWORK_FIXES.md` #3 unwrap-hack family of bugs at the wire format
+ * layer.
+ */
+export declare function encodeExecuteRequest(node: RunnerNode, ctx: Context, stepIndex: number, stepTotal: number, stepDepth: number, deadlineMs: number): ExecuteRequestProto;
+/**
+ * Proto envelope for a streamed event. proto-loader with `oneofs: true`
+ * exposes the active oneof case via the `event` property AND mirrors the
+ * matching field at the top level. We discriminate on `event`.
+ */
+export interface ExecuteEventProto {
+    event: "started" | "log" | "progress" | "partial" | "final" | undefined;
+    started?: {
+        at: {
+            seconds: string;
+            nanos: number;
+        } | null;
+    };
+    log?: LogLineProto;
+    progress?: {
+        percent: number;
+        phase: string;
+    };
+    partial?: {
+        snapshotJson: Buffer;
+    };
+    final?: ExecuteResponseProto;
+}
+/**
+ * Adapter-facing discriminated union — keeps callers free of proto-loader
+ * shape concerns and lets TypeScript narrow on the `type` field.
+ */
+export type DecodedExecuteEvent = {
+    readonly type: "started";
+    readonly at: number;
+} | {
+    readonly type: "log";
+    readonly log: DecodedLogLine;
+} | {
+    readonly type: "progress";
+    readonly percent: number;
+    readonly phase: string;
+} | {
+    readonly type: "partial";
+    readonly snapshot: unknown;
+} | {
+    readonly type: "final";
+    readonly response: DecodedExecuteResponse;
+};
+/**
+ * Decode a single streamed `ExecuteEvent` proto into the discriminated union
+ * the adapter exposes. Returns `null` when the proto envelope is empty (no
+ * oneof field set) — the caller skips such frames.
+ */
+export declare function decodeExecuteEvent(event: ExecuteEventProto): DecodedExecuteEvent | null;
+/**
+ * Decode a {@link ExecuteResponseProto} from the wire into the shape the
+ * adapter consumes. Defensive against missing fields (proto-loader fills in
+ * defaults, but we guard against malformed responses too).
+ */
+export declare function decodeExecuteResponse(response: ExecuteResponseProto): DecodedExecuteResponse;
+/** Encode a value as UTF-8 JSON bytes. `null`/`undefined` → empty buffer. */
+export declare function jsonToBuffer(value: unknown): Buffer;
+/** Decode a buffer as UTF-8 JSON. Empty/missing buffer → `null`. */
+export declare function bufferToJson(buf: Buffer | undefined): unknown;