@blokjs/runner 0.2.0

package/dist/cost/CostEstimator.js

@@ -0,0 +1,171 @@
+/**
+ * Cost Estimator for Blok Workflows
+ *
+ * Estimates execution costs per node and workflow based on
+ * runtime type, cloud provider pricing, and optional profiling data.
+ *
+ * @example
+ * ```typescript
+ * const estimator = new CostEstimator({ provider: "aws", executionsPerMonth: 100000 });
+ * const estimate = estimator.estimateWorkflow(workflowDef);
+ * console.log(estimator.toTable());
+ * ```
+ */
+import { DEFAULT_DURATIONS, DEFAULT_MEMORY, PRICING, getRuntimeCategory, } from "./pricing";
+export class CostEstimator {
+    config;
+    estimates = [];
+    constructor(config) {
+        this.config = {
+            provider: config?.provider ?? "aws",
+            executionsPerMonth: config?.executionsPerMonth ?? 10_000,
+            customPricing: config?.customPricing,
+        };
+    }
+    estimateWorkflow(workflow, profiles) {
+        const profileMap = new Map();
+        if (profiles) {
+            for (const p of profiles) {
+                profileMap.set(p.nodeName, p);
+            }
+        }
+        const nodes = [];
+        this.walkSteps(workflow.steps, profileMap, nodes);
+        const costPerExecution = nodes.reduce((sum, n) => sum + n.costPerExecution, 0);
+        const monthlyCost = costPerExecution * this.config.executionsPerMonth;
+        const estimate = {
+            workflowName: workflow.name,
+            nodes,
+            costPerExecution,
+            monthlyCost,
+            executionsPerMonth: this.config.executionsPerMonth,
+            provider: this.config.provider,
+        };
+        this.estimates.push(estimate);
+        return estimate;
+    }
+    estimateNode(nodeName, stepName, stepType, runtime, avgDurationMs, avgMemoryMb) {
+        const category = getRuntimeCategory(runtime || "nodejs", stepType);
+        const costModel = this.getCostModel(category);
+        const durationMs = avgDurationMs ?? DEFAULT_DURATIONS[category];
+        const memoryMb = avgMemoryMb ?? DEFAULT_MEMORY[category];
+        const cpuCost = durationMs * costModel.costPerMsCpu;
+        const memoryCost = ((memoryMb * durationMs) / 1000) * costModel.costPerMbMemorySecond;
+        const costPerExecution = costModel.baseCostPerExecution + cpuCost + memoryCost + costModel.networkCostPerCall;
+        return {
+            nodeName,
+            stepName,
+            runtime: runtime || this.inferRuntime(stepType),
+            category,
+            estimatedDurationMs: durationMs,
+            estimatedMemoryMb: memoryMb,
+            costPerExecution,
+            monthlyCost: costPerExecution * this.config.executionsPerMonth,
+        };
+    }
+    getEstimates() {
+        return this.estimates;
+    }
+    toTable() {
+        if (this.estimates.length === 0)
+            return "[No cost estimates]";
+        const lines = [];
+        for (const estimate of this.estimates) {
+            lines.push("");
+            lines.push(`  Workflow: ${estimate.workflowName}  |  Provider: ${estimate.provider.toUpperCase()}  |  ${this.fmtNum(estimate.executionsPerMonth)} exec/month`);
+            lines.push("");
+            const header = this.padColumns([
+                { val: "Node", width: 22 },
+                { val: "Runtime", width: 10 },
+                { val: "Type", width: 12 },
+                { val: "Dur(ms)", width: 10 },
+                { val: "Mem(MB)", width: 10 },
+                { val: "Per Exec", width: 12 },
+                { val: "Monthly", width: 12 },
+            ]);
+            lines.push(`  ${header}`);
+            lines.push(`  ${"─".repeat(header.length)}`);
+            for (const node of estimate.nodes) {
+                const row = this.padColumns([
+                    { val: this.truncate(node.nodeName, 20), width: 22 },
+                    { val: node.runtime, width: 10 },
+                    { val: node.category, width: 12 },
+                    { val: node.estimatedDurationMs.toFixed(0), width: 10 },
+                    { val: node.estimatedMemoryMb.toFixed(0), width: 10 },
+                    { val: this.fmtUsd(node.costPerExecution), width: 12 },
+                    { val: this.fmtUsd(node.monthlyCost), width: 12 },
+                ]);
+                lines.push(`  ${row}`);
+            }
+            lines.push(`  ${"─".repeat(header.length)}`);
+            const totalRow = this.padColumns([
+                { val: "TOTAL", width: 22 },
+                { val: "", width: 10 },
+                { val: "", width: 12 },
+                { val: "", width: 10 },
+                { val: "", width: 10 },
+                { val: this.fmtUsd(estimate.costPerExecution), width: 12 },
+                { val: this.fmtUsd(estimate.monthlyCost), width: 12 },
+            ]);
+            lines.push(`  ${totalRow}`);
+        }
+        lines.push("");
+        return lines.join("\n");
+    }
+    toJson() {
+        return JSON.stringify(this.estimates, null, 2);
+    }
+    reset() {
+        this.estimates = [];
+    }
+    // -- Internal --
+    walkSteps(steps, profileMap, nodes) {
+        for (const step of steps) {
+            const profile = profileMap.get(step.node);
+            const estimate = this.estimateNode(step.node, step.name, step.type || "local", step.runtime || "", profile?.avgTimeMs, profile?.memoryAvgMb);
+            nodes.push(estimate);
+            if (step.conditions) {
+                for (const cond of step.conditions) {
+                    if (cond.steps) {
+                        this.walkSteps(cond.steps, profileMap, nodes);
+                    }
+                }
+            }
+        }
+    }
+    getCostModel(category) {
+        const base = PRICING[this.config.provider][category];
+        const custom = this.config.customPricing?.[category];
+        if (custom) {
+            return { ...base, ...custom };
+        }
+        return base;
+    }
+    inferRuntime(stepType) {
+        if (stepType.startsWith("runtime.")) {
+            return stepType.replace("runtime.", "");
+        }
+        return "nodejs";
+    }
+    fmtUsd(amount) {
+        if (amount === 0)
+            return "$0.00";
+        if (amount < 0.01)
+            return `$${amount.toFixed(6)}`;
+        if (amount < 1)
+            return `$${amount.toFixed(4)}`;
+        if (amount < 1000)
+            return `$${amount.toFixed(2)}`;
+        return `$${amount.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+    }
+    fmtNum(n) {
+        return n.toLocaleString("en-US");
+    }
+    truncate(s, len) {
+        return s.length > len ? `${s.substring(0, len - 3)}...` : s;
+    }
+    padColumns(cols) {
+        return cols.map((c) => c.val + " ".repeat(Math.max(0, c.width - c.val.length))).join("");
+    }
+}
+//# sourceMappingURL=CostEstimator.js.map

package/dist/cost/CostEstimator.js.map

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

package/dist/cost/index.d.ts

@@ -0,0 +1,4 @@
+export { CostEstimator } from "./CostEstimator";
+export type { NodeCostEstimate, WorkflowCostEstimate, CostEstimatorConfig } from "./CostEstimator";
+export { PRICING, DEFAULT_DURATIONS, DEFAULT_MEMORY, getRuntimeCategory } from "./pricing";
+export type { CloudProvider, RuntimeCostCategory, RuntimeCostModel } from "./pricing";

package/dist/cost/index.js

@@ -0,0 +1,3 @@
+export { CostEstimator } from "./CostEstimator";
+export { PRICING, DEFAULT_DURATIONS, DEFAULT_MEMORY, getRuntimeCategory } from "./pricing";
+//# sourceMappingURL=index.js.map

package/dist/cost/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cost/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC"}

package/dist/cost/pricing.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Cloud Provider Pricing Models for Blok Runtime Cost Estimation
+ *
+ * Pricing is based on publicly available cloud provider rates as of 2026-01.
+ * All costs are in USD.
+ */
+export type CloudProvider = "aws" | "gcp" | "azure" | "local";
+export type RuntimeCostCategory = "in-process" | "docker" | "grpc" | "wasm";
+export interface RuntimeCostModel {
+    category: RuntimeCostCategory;
+    baseCostPerExecution: number;
+    costPerMsCpu: number;
+    costPerMbMemorySecond: number;
+    containerOverheadMs: number;
+    networkCostPerCall: number;
+}
+/** Map RuntimeKind to cost category */
+export declare function getRuntimeCategory(runtimeKind: string, stepType?: string): RuntimeCostCategory;
+/** Default cost models per provider and category */
+export declare const PRICING: Record<CloudProvider, Record<RuntimeCostCategory, RuntimeCostModel>>;
+/** Default estimated durations (ms) by runtime category when no profiling data available */
+export declare const DEFAULT_DURATIONS: Record<RuntimeCostCategory, number>;
+/** Default estimated memory (MB) by runtime category */
+export declare const DEFAULT_MEMORY: Record<RuntimeCostCategory, number>;

package/dist/cost/pricing.js

@@ -0,0 +1,169 @@
+/**
+ * Cloud Provider Pricing Models for Blok Runtime Cost Estimation
+ *
+ * Pricing is based on publicly available cloud provider rates as of 2026-01.
+ * All costs are in USD.
+ */
+/** Map RuntimeKind to cost category */
+export function getRuntimeCategory(runtimeKind, stepType) {
+    if (runtimeKind === "wasm")
+        return "wasm";
+    if (runtimeKind === "nodejs" || runtimeKind === "bun" || stepType === "local" || stepType === "module")
+        return "in-process";
+    // go, java, rust, php, csharp, ruby, python3, docker — all use HTTP SDK containers
+    return "docker";
+}
+/** Default cost models per provider and category */
+export const PRICING = {
+    aws: {
+        "in-process": {
+            category: "in-process",
+            baseCostPerExecution: 0.0000002, // Lambda per-request ($0.20/million)
+            costPerMsCpu: 0.0000000167, // Lambda GB-s pricing at 128MB
+            costPerMbMemorySecond: 0.0000000167,
+            containerOverheadMs: 0,
+            networkCostPerCall: 0,
+        },
+        docker: {
+            category: "docker",
+            baseCostPerExecution: 0.0000002,
+            costPerMsCpu: 0.0000000334, // Fargate vCPU-second pricing
+            costPerMbMemorySecond: 0.0000000037,
+            containerOverheadMs: 50, // Cold start for container
+            networkCostPerCall: 0.000001, // Network transfer
+        },
+        grpc: {
+            category: "grpc",
+            baseCostPerExecution: 0.0000002,
+            costPerMsCpu: 0.0000000167,
+            costPerMbMemorySecond: 0.0000000167,
+            containerOverheadMs: 5,
+            networkCostPerCall: 0.000005, // gRPC call overhead
+        },
+        wasm: {
+            category: "wasm",
+            baseCostPerExecution: 0.0000001, // Minimal overhead
+            costPerMsCpu: 0.00000001,
+            costPerMbMemorySecond: 0.000000005,
+            containerOverheadMs: 1,
+            networkCostPerCall: 0,
+        },
+    },
+    gcp: {
+        "in-process": {
+            category: "in-process",
+            baseCostPerExecution: 0.0000004,
+            costPerMsCpu: 0.00001,
+            costPerMbMemorySecond: 0.0000025,
+            containerOverheadMs: 0,
+            networkCostPerCall: 0,
+        },
+        docker: {
+            category: "docker",
+            baseCostPerExecution: 0.0000004,
+            costPerMsCpu: 0.0000324,
+            costPerMbMemorySecond: 0.0000035,
+            containerOverheadMs: 80,
+            networkCostPerCall: 0.000001,
+        },
+        grpc: {
+            category: "grpc",
+            baseCostPerExecution: 0.0000004,
+            costPerMsCpu: 0.00001,
+            costPerMbMemorySecond: 0.0000025,
+            containerOverheadMs: 5,
+            networkCostPerCall: 0.000005,
+        },
+        wasm: {
+            category: "wasm",
+            baseCostPerExecution: 0.0000002,
+            costPerMsCpu: 0.000000008,
+            costPerMbMemorySecond: 0.000000004,
+            containerOverheadMs: 1,
+            networkCostPerCall: 0,
+        },
+    },
+    azure: {
+        "in-process": {
+            category: "in-process",
+            baseCostPerExecution: 0.0000002,
+            costPerMsCpu: 0.000016,
+            costPerMbMemorySecond: 0.000016,
+            containerOverheadMs: 0,
+            networkCostPerCall: 0,
+        },
+        docker: {
+            category: "docker",
+            baseCostPerExecution: 0.0000002,
+            costPerMsCpu: 0.000034,
+            costPerMbMemorySecond: 0.0000037,
+            containerOverheadMs: 60,
+            networkCostPerCall: 0.000001,
+        },
+        grpc: {
+            category: "grpc",
+            baseCostPerExecution: 0.0000002,
+            costPerMsCpu: 0.000016,
+            costPerMbMemorySecond: 0.000016,
+            containerOverheadMs: 5,
+            networkCostPerCall: 0.000005,
+        },
+        wasm: {
+            category: "wasm",
+            baseCostPerExecution: 0.0000001,
+            costPerMsCpu: 0.00000001,
+            costPerMbMemorySecond: 0.000000005,
+            containerOverheadMs: 1,
+            networkCostPerCall: 0,
+        },
+    },
+    local: {
+        "in-process": {
+            category: "in-process",
+            baseCostPerExecution: 0,
+            costPerMsCpu: 0,
+            costPerMbMemorySecond: 0,
+            containerOverheadMs: 0,
+            networkCostPerCall: 0,
+        },
+        docker: {
+            category: "docker",
+            baseCostPerExecution: 0,
+            costPerMsCpu: 0,
+            costPerMbMemorySecond: 0,
+            containerOverheadMs: 50,
+            networkCostPerCall: 0,
+        },
+        grpc: {
+            category: "grpc",
+            baseCostPerExecution: 0,
+            costPerMsCpu: 0,
+            costPerMbMemorySecond: 0,
+            containerOverheadMs: 5,
+            networkCostPerCall: 0,
+        },
+        wasm: {
+            category: "wasm",
+            baseCostPerExecution: 0,
+            costPerMsCpu: 0,
+            costPerMbMemorySecond: 0,
+            containerOverheadMs: 1,
+            networkCostPerCall: 0,
+        },
+    },
+};
+/** Default estimated durations (ms) by runtime category when no profiling data available */
+export const DEFAULT_DURATIONS = {
+    "in-process": 10,
+    docker: 100,
+    grpc: 50,
+    wasm: 5,
+};
+/** Default estimated memory (MB) by runtime category */
+export const DEFAULT_MEMORY = {
+    "in-process": 64,
+    docker: 256,
+    grpc: 128,
+    wasm: 32,
+};
+//# sourceMappingURL=pricing.js.map

package/dist/cost/pricing.js.map

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

package/dist/defineNode.d.ts

@@ -0,0 +1,155 @@
+import type { z } from "zod";
+import type { Context } from "@blokjs/shared";
+import BlokService from "./Blok";
+import type { IBlokResponse } from "./BlokResponse";
+import type Condition from "./types/Condition";
+import type JsonLikeObject from "./types/JsonLikeObject";
+/**
+ * Function-first node definition with Zod schema validation
+ *
+ * @example
+ * ```typescript
+ * const MyNode = defineNode({
+ *   name: "my-node",
+ *   description: "Does something awesome",
+ *
+ *   input: z.object({
+ *     userId: z.string().uuid(),
+ *   }),
+ *
+ *   output: z.object({
+ *     user: z.object({
+ *       id: z.string(),
+ *       name: z.string(),
+ *     }),
+ *   }),
+ *
+ *   async execute(ctx, input) {
+ *     // Type-safe input and output!
+ *     const user = await fetchUser(input.userId);
+ *     return { user };
+ *   },
+ * });
+ * ```
+ */
+export interface FnNodeDefinition<TInput extends z.ZodTypeAny = z.ZodTypeAny, TOutput extends z.ZodTypeAny = z.ZodTypeAny> {
+    /** Node name (used for identification in workflows) */
+    name: string;
+    /** Human-readable description of what this node does */
+    description: string;
+    /** Zod schema for input validation */
+    input: TInput;
+    /** Zod schema for output validation */
+    output: TOutput;
+    /** Response content type (e.g. "text/html", "application/pdf"). Defaults to "application/json" */
+    contentType?: string;
+    /** Whether this is a flow control node (e.g. if-else) that returns sub-steps to execute */
+    flow?: boolean;
+    /**
+     * Node execution logic
+     * @param ctx - Workflow context
+     * @param input - Type-safe input (validated against input schema)
+     * @returns Type-safe output (will be validated against output schema)
+     */
+    execute: (ctx: Context, input: z.infer<TInput>) => Promise<z.infer<TOutput>> | z.infer<TOutput>;
+}
+/**
+ * FunctionNode wrapper that bridges function-first nodes to existing BlokService infrastructure
+ *
+ * This class wraps a function-first node definition and makes it compatible with the
+ * existing BlokService.run() execution model. It handles:
+ * - Zod input validation
+ * - Zod output validation
+ * - Error mapping (ZodError → GlobalError)
+ * - Response wrapping (BlokResponse)
+ */
+export declare class FunctionNode<TInput extends z.ZodTypeAny, TOutput extends z.ZodTypeAny> extends BlokService<z.infer<TInput>> {
+    private definition;
+    constructor(definition: FnNodeDefinition<TInput, TOutput>);
+    /**
+     * Implementation of the abstract handle() method required by BlokService
+     *
+     * This method:
+     * 1. Validates input with Zod
+     * 2. Executes the user's execute() function
+     * 3. Validates output with Zod
+     * 4. Wraps result in BlokResponse
+     * 5. Maps any errors to GlobalError
+     */
+    handle(ctx: Context, inputs: z.infer<TInput> | JsonLikeObject | Condition[]): Promise<IBlokResponse | BlokService<z.infer<TInput>>[]>;
+    /**
+     * Maps any error to GlobalError, with special handling for ZodError
+     *
+     * ZodError produces detailed validation errors that are transformed into
+     * a user-friendly error message with all validation issues listed.
+     *
+     * @param error - Any error thrown during execution
+     * @returns GlobalError instance
+     */
+    private mapErrorToGlobalError;
+    /**
+     * Converts ZodError to GlobalError with detailed validation messages
+     *
+     * Example output:
+     * "Validation failed: userId (expected string, received undefined),
+     *  email (invalid email format)"
+     *
+     * @param zodError - Zod validation error
+     * @returns GlobalError with formatted validation messages
+     */
+    private zodErrorToGlobalError;
+    /**
+     * Converts Zod schema to JSON Schema for backward compatibility
+     *
+     * This is a simplified conversion that covers basic types.
+     * For production use, consider using zod-to-json-schema library.
+     *
+     * @param zodSchema - Zod schema to convert
+     * @returns JSON Schema representation
+     */
+    private zodToJsonSchema;
+}
+/**
+ * Define a function-first node with Zod schema validation
+ *
+ * This is the main API for creating modern, type-safe nodes in Blok.
+ *
+ * Benefits over class-based nodes:
+ * - 60%+ less boilerplate code
+ * - Type-safe inputs and outputs via Zod
+ * - Automatic validation
+ * - Better AI generation success rates
+ * - Easier to test and maintain
+ *
+ * @example
+ * ```typescript
+ * import { defineNode } from "@blokjs/runner";
+ * import { z } from "zod";
+ *
+ * export default defineNode({
+ *   name: "fetch-user",
+ *   description: "Fetches user by ID from database",
+ *
+ *   input: z.object({
+ *     userId: z.string().uuid(),
+ *   }),
+ *
+ *   output: z.object({
+ *     user: z.object({
+ *       id: z.string(),
+ *       name: z.string(),
+ *       email: z.string().email(),
+ *     }),
+ *   }),
+ *
+ *   async execute(ctx, input) {
+ *     const user = await db.users.findById(input.userId);
+ *     return { user };
+ *   },
+ * });
+ * ```
+ *
+ * @param definition - Node definition with Zod schemas
+ * @returns FunctionNode instance compatible with existing runner
+ */
+export declare function defineNode<TInput extends z.ZodTypeAny, TOutput extends z.ZodTypeAny>(definition: FnNodeDefinition<TInput, TOutput>): FunctionNode<TInput, TOutput>;