@blokjs/runner 0.2.1 → 0.2.2

package/dist/adapters/HttpRuntimeAdapter.js

@@ -20,6 +20,7 @@
  */
 export class HttpRuntimeAdapter {
     kind;
+    transport = "http";
     baseUrl;
     timeoutMs;
     constructor(kind, host, port, options) {
@@ -41,7 +42,23 @@ export class HttpRuntimeAdapter {
                 signal: AbortSignal.timeout(this.timeoutMs),
             });
             if (!response.ok) {
-                throw new Error(`HTTP runtime '${this.kind}' at ${this.baseUrl} returned HTTP ${response.status}: ${response.statusText}`);
+                // Read the error response body — SDK containers return structured error details
+                // that would otherwise be lost (e.g. validation messages, stack traces)
+                let errorDetail = "";
+                try {
+                    const errorBody = (await response.json());
+                    const errors = errorBody?.errors;
+                    errorDetail = errors?.message || JSON.stringify(errors) || "";
+                }
+                catch {
+                    try {
+                        errorDetail = await response.text();
+                    }
+                    catch {
+                        /* body not readable */
+                    }
+                }
+                throw new Error(`HTTP runtime '${this.kind}' at ${this.baseUrl} returned HTTP ${response.status}: ${response.statusText}${errorDetail ? ` — ${errorDetail}` : ""}`);
             }
             const result = (await response.json());
             const duration_ms = performance.now() - startTime;
@@ -76,11 +93,31 @@ export class HttpRuntimeAdapter {
     /**
      * 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
+     * Sends two shapes in the same envelope so the migration to the new
+     * canonical wire format is backward-compatible:
+     *
+     *   1. **Legacy keys** — `node.config` + `context.{request,response,vars,env}`.
+     *      Existing SDK HTTP servers (Rust, Python, Go HTTP, others) read
+     *      these keys today and keep working unchanged.
+     *
+     *   2. **New canonical keys** — `step` / `inputs` / `trigger` / `state` /
+     *      `workflow`. Same field names + structure as the gRPC proto so SDK
+     *      authors who adopt the new shape get a uniform mental model across
+     *      transports. The "inputs unwrapped at the wire layer" property
+     *      (FIXES.md #3) holds for both shapes.
+     *
+     * Data flow priority for the legacy `request.body`:
+     * 1. If the node has resolved inputs (from the blueprint Mapper), use
+     *    those as `request.body` so workflows that define explicit inputs
+     *    like `"chain": "js/ctx.response.data.chain"` keep working.
+     * 2. Otherwise, fall back to `ctx.response.data` (previous step output)
+     *    enabling zero-config chaining for SDK nodes that read body fields.
+     *
+     * The new `trigger.body` always reflects the actual trigger body
+     * (`ctx.request?.body`) — separated from inputs at the wire layer.
+     *
+     * Deprecation timeline: legacy keys will be removed in the next minor
+     * version once SDK HTTP servers have all adopted the new shape.
      */
     createExecutionRequest(node, ctx) {
         const nodeConfig = ctx.config
@@ -91,26 +128,40 @@ export class HttpRuntimeAdapter {
         // 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 ?? {});
+        const legacyRequestBody = resolvedInputs || (ctx.response?.data ?? {});
+        // Unwrap the {inputs: {...}} wrapper that comes from @blokjs/helper StepNode.
+        // SDK nodes expect config to contain the inputs directly (e.g. config.operation),
+        // not wrapped as config.inputs.operation.
+        const unwrappedConfig = resolvedInputs || nodeConfig?.inputs || nodeConfig || {};
+        const stepInfo = ctx._stepInfo;
+        const headers = ctx.request?.headers ?? {};
+        const params = ctx.request?.params ?? {};
+        const query = ctx.request?.query ?? {};
+        const cookies = ctx.request?.cookies ?? {};
+        const method = ctx.request?.method ?? "";
+        const url = ctx.request?.url ?? "";
+        const baseUrl = ctx.request?.baseUrl ?? "";
         return {
+            // ===== Legacy keys (kept for one minor for backward compat) =====
             node: {
                 name: node.node,
                 type: node.type,
-                config: nodeConfig || {},
+                version: "",
+                config: unwrappedConfig,
             },
             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 ?? "",
+                    body: legacyRequestBody,
+                    headers,
+                    params,
+                    query,
+                    method,
+                    url,
+                    cookies,
+                    baseUrl,
                 },
                 response: {
                     data: null,
@@ -121,6 +172,36 @@ export class HttpRuntimeAdapter {
                 vars: ctx.vars ?? {},
                 env: ctx.env ?? {},
             },
+            // ===== New canonical keys (mirror the gRPC proto v1 schema) =====
+            step: {
+                name: stepInfo?.name ?? node.name,
+                index: stepInfo?.index ?? 0,
+                total: stepInfo?.total ?? 1,
+                depth: stepInfo?.depth ?? 0,
+            },
+            inputs: unwrappedConfig,
+            trigger: {
+                body: ctx.request?.body ?? null,
+                headers,
+                params,
+                query,
+                cookies,
+                method,
+                url,
+                baseUrl,
+                triggerKind: "",
+            },
+            state: {
+                previousOutput: ctx.response?.data ?? null,
+                vars: ctx.vars ?? {},
+                env: ctx.env ?? {},
+            },
+            workflow: {
+                runId: ctx.id,
+                name: ctx.workflow_name ?? "",
+                path: ctx.workflow_path ?? "",
+                version: "",
+            },
         };
     }
     /**

package/dist/adapters/HttpRuntimeAdapter.js.map

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

package/dist/adapters/NodeJsRuntimeAdapter.d.ts

@@ -12,6 +12,7 @@ import type { ExecutionResult, RuntimeAdapter } from "./RuntimeAdapter";
  */
 export declare class NodeJsRuntimeAdapter implements RuntimeAdapter {
     readonly kind = "nodejs";
+    readonly transport: "module";
     /**
      * Execute a Node.js node in-process
      *

package/dist/adapters/NodeJsRuntimeAdapter.js

@@ -9,6 +9,7 @@
  */
 export class NodeJsRuntimeAdapter {
     kind = "nodejs";
+    transport = "module";
     /**
      * Execute a Node.js node in-process
      *

package/dist/adapters/NodeJsRuntimeAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"NodeJsRuntimeAdapter.js","sourceRoot":"","sources":["../../src/adapters/NodeJsRuntimeAdapter.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAoB;IAChB,IAAI,GAAG,QAAQ,CAAC;IAEhC;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,IAAgB,EAAE,GAAY;QAC3C,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEpC,IAAI,CAAC;YACJ,gCAAgC;YAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAErC,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAElD,6CAA6C;YAC7C,0BAA0B;YAC1B,0EAA0E;YAC1E,+CAA+C;YAC/C,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAiF,CAAC;YAChH,MAAM,gBAAgB,GAAG,QAAkE,CAAC;YAE5F,6FAA6F;YAC7F,MAAM,WAAW,GAAG,YAAY,EAAE,KAAK,KAAK,IAAI,IAAI,YAAY,EAAE,KAAK,KAAK,SAAS,CAAC;YACtF,MAAM,aAAa,GAAG,gBAAgB,EAAE,KAAK,KAAK,IAAI,IAAI,gBAAgB,EAAE,KAAK,KAAK,SAAS,CAAC;YAChG,MAAM,QAAQ,GAAG,WAAW,IAAI,aAAa,CAAC;YAE9C,yEAAyE;YACzE,MAAM,aAAa,GAAG,YAAY,EAAE,OAAO,CAAC;YAC5C,MAAM,eAAe,GAAG,gBAAgB,EAAE,OAAO,CAAC;YAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,IAAI,eAAe,IAAI,IAAI,CAAC,CAAC;YAE9E,wCAAwC;YACxC,MAAM,UAAU,GAAG,YAAY,EAAE,KAAK,IAAI,gBAAgB,EAAE,KAAK,IAAI,IAAI,CAAC;YAE1E,OAAO;gBACN,OAAO;gBACP,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,MAAM,EAAE,UAAU;gBAClB,OAAO,EAAE;oBACR,WAAW;iBACX;aACD,CAAC;QACH,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAElD,OAAO;gBACN,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,IAAI;gBACV,MAAM,EAAE;oBACP,OAAO,EAAG,KAAe,CAAC,OAAO;oBACjC,KAAK,EAAG,KAAe,CAAC,KAAK;oBAC7B,IAAI,EAAG,KAAe,CAAC,IAAI;iBAC3B;gBACD,OAAO,EAAE;oBACR,WAAW;iBACX;aACD,CAAC;QACH,CAAC;IACF,CAAC;CACD"}
+{"version":3,"file":"NodeJsRuntimeAdapter.js","sourceRoot":"","sources":["../../src/adapters/NodeJsRuntimeAdapter.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAoB;IAChB,IAAI,GAAG,QAAQ,CAAC;IAChB,SAAS,GAAG,QAAiB,CAAC;IAE9C;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,IAAgB,EAAE,GAAY;QAC3C,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEpC,IAAI,CAAC;YACJ,gCAAgC;YAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAErC,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAElD,6CAA6C;YAC7C,0BAA0B;YAC1B,0EAA0E;YAC1E,+CAA+C;YAC/C,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAiF,CAAC;YAChH,MAAM,gBAAgB,GAAG,QAAkE,CAAC;YAE5F,6FAA6F;YAC7F,MAAM,WAAW,GAAG,YAAY,EAAE,KAAK,KAAK,IAAI,IAAI,YAAY,EAAE,KAAK,KAAK,SAAS,CAAC;YACtF,MAAM,aAAa,GAAG,gBAAgB,EAAE,KAAK,KAAK,IAAI,IAAI,gBAAgB,EAAE,KAAK,KAAK,SAAS,CAAC;YAChG,MAAM,QAAQ,GAAG,WAAW,IAAI,aAAa,CAAC;YAE9C,yEAAyE;YACzE,MAAM,aAAa,GAAG,YAAY,EAAE,OAAO,CAAC;YAC5C,MAAM,eAAe,GAAG,gBAAgB,EAAE,OAAO,CAAC;YAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,IAAI,eAAe,IAAI,IAAI,CAAC,CAAC;YAE9E,wCAAwC;YACxC,MAAM,UAAU,GAAG,YAAY,EAAE,KAAK,IAAI,gBAAgB,EAAE,KAAK,IAAI,IAAI,CAAC;YAE1E,OAAO;gBACN,OAAO;gBACP,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,MAAM,EAAE,UAAU;gBAClB,OAAO,EAAE;oBACR,WAAW;iBACX;aACD,CAAC;QACH,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAElD,OAAO;gBACN,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,IAAI;gBACV,MAAM,EAAE;oBACP,OAAO,EAAG,KAAe,CAAC,OAAO;oBACjC,KAAK,EAAG,KAAe,CAAC,KAAK;oBAC7B,IAAI,EAAG,KAAe,CAAC,IAAI;iBAC3B;gBACD,OAAO,EAAE;oBACR,WAAW;iBACX;aACD,CAAC;QACH,CAAC;IACF,CAAC;CACD"}

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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"}