blokctl 0.2.0

package/dist/commands/create/utils/Examples.d.ts

@@ -0,0 +1,39 @@
+declare const node_file = "import ApiCall from \"@blok/api-call\";\nimport IfElse from \"@blok/if-else\";\nimport type { NodeBase } from \"@blok/shared\";\nimport ChainInit from \"./nodes/chain-init/index\";\nimport ChainVerify from \"./nodes/chain-verify/index\";\nimport ExampleNodes from \"./nodes/examples/index\";\nimport RuntimeBridge from \"./nodes/runtime-bridge/index\";\n\nconst nodes: {\n\t[key: string]: NodeBase;\n} = {\n\t\"@blok/api-call\": ApiCall,\n\t\"@blok/if-else\": IfElse,\n\t\"chain-init\": ChainInit,\n\t\"chain-verify\": ChainVerify,\n\t\"runtime-bridge\": RuntimeBridge,\n\t...ExampleNodes,\n};\n\nexport default nodes;\n";
+declare const package_dependencies: {
+    ai: string;
+    "@ai-sdk/openai": string;
+    ejs: string;
+    pg: string;
+    mongodb: string;
+};
+declare const package_dev_dependencies: {
+    "@types/ejs": string;
+    "@types/pg": string;
+};
+declare const python3_file = "\nfrom core.blok import BlokService\nfrom core.types.context import Context\nfrom core.types.blok_response import BlokResponse\nfrom core.types.global_error import GlobalError\nfrom typing import Any, Dict\nimport traceback\n\nclass Node(BlokService):\n    def __init__(self):\n        BlokService.__init__(self)\n        self.input_schema = {}\n        self.output_schema = {}\n\n    async def handle(self, ctx: Context, inputs: Dict[str, Any]) -> BlokResponse:\n        response = BlokResponse()\n\n        try:\n            response.setSuccess({ \"message\": \"Hello World from Python3!\" })\n        except Exception as error:\n            err = GlobalError(error)\n            err.setCode(500)\n            err.setName(self.name)\n\n            stack_trace = traceback.format_exc()\n            err.setStack(stack_trace)\n            response.success = False\n            response.setError(err)\n\n        return response\n";
+declare const examples_url = "\nExamples:\n1- Open \"workflow-docs.json\" in your browser at http://localhost:4000/workflow-docs\n2- Open \"db-manager.json\" in your browser at http://localhost:4000/db-manager\n3- Open \"dashboard-gen.json\" in your browser at http://localhost:4000/dashboard-gen\n4- Open \"countries.json\" in your browser at http://localhost:4000/countries\n\nFor more documentation, visit src/nodes/examples/README.md. The first three examples require a PostgreSQL database to function.\n";
+declare const workflow_template = "\n{\n\t\"name\": \"\",\n\t\"description\": \"\",\n\t\"version\": \"1.0.0\",\n\t\"trigger\": {\n\t\t\"http\": {\n\t\t\t\"method\": \"GET\",\n\t\t\t\"path\": \"/\",\n\t\t\t\"accept\": \"application/json\"\n\t\t}\n\t},\n\t\"steps\": [\n\t\t{\n\t\t\t\"name\": \"node-name\",\n\t\t\t\"node\": \"node-module-name\",\n\t\t\t\"type\": \"module\"\n\t\t}\n\t],\n\t\"nodes\": {\n\t\t\"name\": {\n\t\t\t\"inputs\": {\n\n\t\t\t}\n\t\t}\n\t}\n}\n";
+declare const supervisord_nodejs = "\n[supervisord]\nnodaemon=true\n\n[program:nodejs_app]\ncommand=npm start\ndirectory=/app\nautostart=true\nautorestart=true\nstderr_logfile=/var/log/nodejs.err.log\nstdout_logfile=/var/log/nodejs.out.log\n";
+declare const supervisord_python = "\n[program:python_app]\ncommand=python3 /app/.blok/runtimes/python3/server.py\ndirectory=/app\nautostart=true\nautorestart=true\nstderr_logfile=/var/log/python.err.log\nstdout_logfile=/var/log/python.out.log\n";
+declare const go_node_file = "package main\n\nimport (\n\t\"github.com/blok/sdk\"\n)\n\ntype HelloWorldNode struct{}\n\nfunc (n *HelloWorldNode) Execute(ctx *sdk.Context, config map[string]interface{}) (*sdk.ExecutionResult, error) {\n\t// Access request body\n\tname := \"World\"\n\tif body, ok := ctx.Request.Body.(map[string]interface{}); ok {\n\t\tif nameVal, ok := body[\"name\"].(string); ok {\n\t\t\tname = nameVal\n\t\t}\n\t}\n\n\t// Access configuration\n\tprefix := \"Hello\"\n\tif prefixVal, ok := config[\"prefix\"].(string); ok {\n\t\tprefix = prefixVal\n\t}\n\n\t// Store result in context for downstream nodes\n\tctx.Vars[\"greeting\"] = prefix + \", \" + name + \"!\"\n\n\t// Return successful result\n\treturn &sdk.ExecutionResult{\n\t\tSuccess: true,\n\t\tData: map[string]interface{}{\n\t\t\t\"message\": prefix + \", \" + name + \"!\",\n\t\t\t\"timestamp\": sdk.GetCurrentTimestamp(),\n\t\t\t\"language\": \"Go\",\n\t\t},\n\t\tErrors: nil,\n\t}, nil\n}\n\nfunc main() {\n\t// Register node\n\tregistry := sdk.NewNodeRegistry()\n\tregistry.Register(\"{{NODE_NAME}}\", &HelloWorldNode{})\n\n\t// Start HTTP server\n\tserver := sdk.NewHTTPServer(registry, \":8080\")\n\tif err := server.Start(); err != nil {\n\t\tpanic(err)\n\t}\n}\n";
+declare const go_mod_file = "module github.com/blok/nodes/{{NODE_NAME}}\n\ngo 1.21\n\nrequire github.com/blok/sdk v1.0.0\n";
+declare const go_dockerfile = "FROM golang:1.21-alpine AS builder\n\nWORKDIR /app\nCOPY go.mod go.sum ./\nRUN go mod download\n\nCOPY . .\nRUN CGO_ENABLED=0 GOOS=linux go build -o /node main.go\n\nFROM alpine:latest\nRUN apk --no-cache add ca-certificates\nWORKDIR /root/\nCOPY --from=builder /node .\n\nEXPOSE 8080\nHEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \\\n  CMD wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1\n\nCMD [\"./node\"]\n";
+declare const java_node_file = "package com.blok.nodes;\n\nimport com.blok.runtime.Blok;\nimport com.blok.runtime.NodeRegistry;\nimport com.blok.server.RuntimeServer;\nimport java.util.HashMap;\nimport java.util.Map;\n\npublic class HelloWorldNode implements Blok.NodeHandler {\n    @Override\n    public Blok.ExecutionResult execute(Blok.Context ctx, Map<String, Object> config) {\n        try {\n            // Access request body\n            String name = \"World\";\n            if (ctx.request.body != null && ctx.request.body.containsKey(\"name\")) {\n                name = (String) ctx.request.body.get(\"name\");\n            }\n\n            // Access configuration\n            String prefix = \"Hello\";\n            if (config != null && config.containsKey(\"prefix\")) {\n                prefix = (String) config.get(\"prefix\");\n            }\n\n            // Store result in context for downstream nodes\n            String greeting = prefix + \", \" + name + \"!\";\n            ctx.vars.put(\"greeting\", greeting);\n\n            // Build response data\n            Map<String, Object> data = new HashMap<>();\n            data.put(\"message\", greeting);\n            data.put(\"timestamp\", System.currentTimeMillis());\n            data.put(\"language\", \"Java\");\n\n            // Return successful result\n            return new Blok.ExecutionResult(true, data, null, null, null);\n        } catch (Exception e) {\n            return new Blok.ExecutionResult(false, null, e.getMessage(), null, null);\n        }\n    }\n\n    public static void main(String[] args) {\n        try {\n            // Register node\n            NodeRegistry registry = new NodeRegistry();\n            registry.register(\"{{NODE_NAME}}\", new HelloWorldNode());\n\n            // Start HTTP server\n            RuntimeServer server = new RuntimeServer(registry, 8080);\n            server.start();\n        } catch (Exception e) {\n            e.printStackTrace();\n            System.exit(1);\n        }\n    }\n}\n";
+declare const java_pom_file = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<project xmlns=\"http://maven.apache.org/POM/4.0.0\"\n         xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n         xsi:schemaLocation=\"http://maven.apache.org/POM/4.0.0\n         http://maven.apache.org/xsd/maven-4.0.0.xsd\">\n    <modelVersion>4.0.0</modelVersion>\n\n    <groupId>com.blok</groupId>\n    <artifactId>{{NODE_NAME}}</artifactId>\n    <version>1.0.0</version>\n\n    <properties>\n        <maven.compiler.source>17</maven.compiler.source>\n        <maven.compiler.target>17</maven.compiler.target>\n        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>\n    </properties>\n\n    <dependencies>\n        <dependency>\n            <groupId>com.google.code.gson</groupId>\n            <artifactId>gson</artifactId>\n            <version>2.10.1</version>\n        </dependency>\n    </dependencies>\n\n    <build>\n        <plugins>\n            <plugin>\n                <groupId>org.apache.maven.plugins</groupId>\n                <artifactId>maven-shade-plugin</artifactId>\n                <version>3.5.0</version>\n                <executions>\n                    <execution>\n                        <phase>package</phase>\n                        <goals>\n                            <goal>shade</goal>\n                        </goals>\n                        <configuration>\n                            <transformers>\n                                <transformer implementation=\"org.apache.maven.plugins.shade.resource.ManifestResourceTransformer\">\n                                    <mainClass>com.blok.nodes.HelloWorldNode</mainClass>\n                                </transformer>\n                            </transformers>\n                        </configuration>\n                    </execution>\n                </executions>\n            </plugin>\n        </plugins>\n    </build>\n</project>\n";
+declare const java_dockerfile = "FROM maven:3.9-eclipse-temurin-17 AS builder\n\nWORKDIR /app\nCOPY pom.xml .\nRUN mvn dependency:go-offline\n\nCOPY src ./src\nRUN mvn clean package -DskipTests\n\nFROM eclipse-temurin:17-jre-alpine\n\nWORKDIR /root/\nCOPY --from=builder /app/target/{{NODE_NAME}}-1.0.0.jar ./app.jar\n\nEXPOSE 8080\nHEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \\\n  CMD wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1\n\nCMD [\"java\", \"-jar\", \"app.jar\"]\n";
+declare const rust_node_file = "use async_trait::async_trait;\nuse blok::{NodeHandler, NodeRegistry, Context};\nuse std::collections::HashMap;\n\n/// {{NODE_NAME}} - A Blok node implemented in Rust\nstruct {{NODE_NAME_PASCAL}};\n\n#[async_trait]\nimpl NodeHandler for {{NODE_NAME_PASCAL}} {\n    async fn execute(\n        &self,\n        ctx: &mut Context,\n        config: &HashMap<String, serde_json::Value>,\n    ) -> Result<serde_json::Value, Box<dyn std::error::Error + Send + Sync>> {\n        // Access request body\n        let name = ctx.request.body\n            .get(\"name\")\n            .and_then(|v| v.as_str())\n            .unwrap_or(\"World\");\n\n        // Access configuration\n        let prefix = config\n            .get(\"prefix\")\n            .and_then(|v| v.as_str())\n            .unwrap_or(\"Hello\");\n\n        let message = format!(\"{}, {}!\", prefix, name);\n\n        // Store in context vars for downstream nodes\n        ctx.vars.insert(\n            \"greeting\".to_string(),\n            serde_json::Value::String(message.clone()),\n        );\n\n        // Return response\n        Ok(serde_json::json!({\n            \"message\": message,\n            \"language\": \"Rust\"\n        }))\n    }\n}\n\n#[tokio::main]\nasync fn main() {\n    // Initialize tracing\n    tracing_subscriber::fmt::init();\n\n    // Register nodes\n    let mut registry = NodeRegistry::new(\"1.0.0\");\n    registry.register(\"{{NODE_NAME}}\", {{NODE_NAME_PASCAL}});\n\n    // Start HTTP server\n    blok::server::serve(registry, 8080).await.unwrap();\n}\n";
+declare const rust_cargo_file = "[package]\nname = \"{{NODE_NAME}}\"\nversion = \"1.0.0\"\nedition = \"2021\"\n\n[[bin]]\nname = \"{{NODE_NAME}}\"\npath = \"src/main.rs\"\n\n[dependencies]\nblok = { path = \"../../sdk\" }\ntokio = { version = \"1\", features = [\"full\"] }\nserde = { version = \"1\", features = [\"derive\"] }\nserde_json = \"1\"\nasync-trait = \"0.1\"\ntracing = \"0.1\"\ntracing-subscriber = \"0.3\"\n";
+declare const rust_dockerfile = "FROM rust:1.77-alpine AS builder\n\nRUN apk add --no-cache musl-dev\n\nWORKDIR /app\nCOPY Cargo.toml Cargo.lock ./\nRUN mkdir -p src && echo 'fn main() {}' > src/main.rs && \\\n    cargo build --release 2>/dev/null || true && rm -rf src\n\nCOPY . .\nRUN cargo build --release\n\nFROM alpine:latest\nRUN apk --no-cache add ca-certificates\nWORKDIR /root/\nCOPY --from=builder /app/target/release/{{NODE_NAME}} .\n\nEXPOSE 8080\nHEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \\\n  CMD wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1\n\nCMD [\"./{{NODE_NAME}}\"]\n";
+declare const csharp_node_file = "using System.Text.Json;\nusing Blok.Runtime;\n\nnamespace Blok.Runtime.Nodes;\n\npublic class {{NODE_NAME_PASCAL}}Node : INodeHandler\n{\n    public Task<JsonElement> ExecuteAsync(Context ctx, Dictionary<string, JsonElement> config)\n    {\n        // Access request body\n        var name = \"World\";\n        if (ctx.Request.Body.ValueKind == JsonValueKind.Object &&\n            ctx.Request.Body.TryGetProperty(\"name\", out var nameEl) &&\n            nameEl.ValueKind == JsonValueKind.String)\n        {\n            name = nameEl.GetString() ?? \"World\";\n        }\n\n        // Access configuration\n        var prefix = \"Hello\";\n        if (config.TryGetValue(\"prefix\", out var prefixEl) &&\n            prefixEl.ValueKind == JsonValueKind.String)\n        {\n            prefix = prefixEl.GetString() ?? \"Hello\";\n        }\n\n        var message = $\"{prefix}, {name}!\";\n\n        // Store in context for downstream nodes\n        ctx.Vars[\"greeting\"] = JsonSerializer.SerializeToElement(message);\n\n        // Return response\n        var result = JsonSerializer.SerializeToElement(new\n        {\n            message,\n            timestamp = DateTime.UtcNow.ToString(\"o\"),\n            language = \"C#\"\n        });\n\n        return Task.FromResult(result);\n    }\n}\n";
+declare const csharp_csproj_file = "<Project Sdk=\"Microsoft.NET.Sdk.Web\">\n  <PropertyGroup>\n    <TargetFramework>net8.0</TargetFramework>\n    <RootNamespace>Blok.Runtime</RootNamespace>\n    <ImplicitUsings>enable</ImplicitUsings>\n    <Nullable>enable</Nullable>\n  </PropertyGroup>\n</Project>\n";
+declare const csharp_dockerfile = "FROM mcr.microsoft.com/dotnet/sdk:8.0 AS builder\nWORKDIR /app\nCOPY *.csproj .\nRUN dotnet restore\nCOPY . .\nRUN dotnet publish -c Release -o /out\n\nFROM mcr.microsoft.com/dotnet/aspnet:8.0-alpine\nWORKDIR /app\nCOPY --from=builder /out .\n\nEXPOSE 8080\nENV PORT=8080\nHEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \\\n  CMD wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1\n\nCMD [\"dotnet\", \"BlokRuntime.dll\"]\n";
+declare const php_node_file = "<?php\n\nnamespace Blok\\Nodes;\n\nuse Blok\\NodeHandler;\nuse Blok\\Context;\n\nclass {{NODE_NAME_PASCAL}}Node implements NodeHandler\n{\n    public function execute(Context $ctx, array $config): mixed\n    {\n        // Access request body\n        $name = $ctx->request->body['name'] ?? 'World';\n\n        // Access configuration\n        $prefix = $config['prefix'] ?? 'Hello';\n\n        $message = \"$prefix, $name!\";\n\n        // Store in context for downstream nodes\n        $ctx->vars['greeting'] = $message;\n\n        // Return response\n        return [\n            'message' => $message,\n            'timestamp' => date('c'),\n            'language' => 'PHP',\n        ];\n    }\n}\n";
+declare const php_composer_file = "{\n    \"name\": \"blok/{{NODE_NAME}}\",\n    \"type\": \"project\",\n    \"require\": {\n        \"php\": \">=8.2\",\n        \"react/http\": \"^1.9\",\n        \"react/socket\": \"^1.15\"\n    },\n    \"autoload\": {\n        \"psr-4\": {\n            \"Blok\\\\\": \"src/\"\n        }\n    }\n}\n";
+declare const php_dockerfile = "FROM php:8.2-cli-alpine AS builder\nWORKDIR /app\nCOPY --from=composer:latest /usr/bin/composer /usr/bin/composer\nCOPY composer.json .\nRUN composer install --no-dev --optimize-autoloader\nCOPY . .\n\nFROM php:8.2-cli-alpine\nWORKDIR /app\nCOPY --from=builder /app .\n\nEXPOSE 8080\nENV PORT=8080\nHEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \\\n  CMD wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1\n\nCMD [\"php\", \"index.php\"]\n";
+declare const ruby_node_file = "require_relative '../../lib/blok'\n\nmodule Blok\n  module Nodes\n    class {{NODE_NAME_PASCAL}}Node < Blok::NodeHandler\n      def execute(ctx, config)\n        # Access request body\n        name = ctx.request.body.is_a?(Hash) ? ctx.request.body['name'] : nil\n        name ||= 'World'\n\n        # Access configuration\n        prefix = config['prefix'] || 'Hello'\n\n        message = \"#{prefix}, #{name}!\"\n\n        # Store in context for downstream nodes\n        ctx.vars['greeting'] = message\n\n        # Return response\n        {\n          'message' => message,\n          'timestamp' => Time.now.utc.iso8601,\n          'language' => 'Ruby'\n        }\n      end\n    end\n  end\nend\n";
+declare const ruby_gemfile = "source 'https://rubygems.org'\n\nruby '>= 3.1'\n\ngem 'sinatra', '~> 4.0'\ngem 'puma', '~> 6.4'\ngem 'rackup', '~> 2.1'\n";
+declare const ruby_dockerfile = "FROM ruby:3.2-alpine AS builder\nRUN apk add --no-cache build-base\nWORKDIR /app\nCOPY Gemfile Gemfile.lock ./\nRUN bundle install --without development test\n\nFROM ruby:3.2-alpine\nRUN apk --no-cache add ca-certificates wget\nWORKDIR /app\nCOPY --from=builder /usr/local/bundle /usr/local/bundle\nCOPY . .\n\nEXPOSE 8080\nENV PORT=8080\nENV RACK_ENV=production\nHEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \\\n  CMD wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1\n\nCMD [\"bundle\", \"exec\", \"puma\", \"-b\", \"tcp://0.0.0.0:8080\"]\n";
+declare const agents_md = "# Blok Project\n\nBlok is a TypeScript-first workflow orchestration framework. It executes declarative workflows (JSON or TypeScript DSL) composed of steps (nodes) that run across 8 language runtimes: NodeJS, Python3, Go, Rust, Java, C#, PHP, and Ruby.\n\n## Project Structure\n\n```\n\u251C\u2500\u2500 src/\n\u2502   \u2514\u2500\u2500 nodes/             # TypeScript node implementations\n\u251C\u2500\u2500 runtimes/              # Non-NodeJS runtime nodes (Go, Python3, etc.)\n\u2502   \u2514\u2500\u2500 {lang}/nodes/      # Language-specific node implementations\n\u251C\u2500\u2500 workflows/\n\u2502   \u251C\u2500\u2500 json/              # Workflow definitions (JSON)\n\u2502   \u251C\u2500\u2500 yaml/              # Workflow definitions (YAML)\n\u2502   \u2514\u2500\u2500 toml/              # Workflow definitions (TOML)\n\u251C\u2500\u2500 .blok/\n\u2502   \u251C\u2500\u2500 config.json        # Runtime configuration (ports, start commands)\n\u2502   \u2514\u2500\u2500 runtimes/          # Auto-generated runtime scaffolds\n\u251C\u2500\u2500 .env.local             # Environment variables (ports, paths)\n\u2514\u2500\u2500 supervisord.conf       # Process management config\n```\n\n## Commands\n\n```bash\nnpm run dev                # Start dev server (or blokctl dev for multi-runtime)\nnpm run build              # Build project\nnpm test                   # Run tests\nblokctl create node <name> # Scaffold a new node\nblokctl create workflow <n># Scaffold a new workflow\nblokctl trace              # Open Blok Studio (trace visualization)\nblokctl studio             # Alias for blokctl trace\n```\n\n## Context \u2014 Critical Data Flow\n\nThe Context type is the central execution state passed through every step.\n\n```typescript\ntype Context = {\n  id: string;                      // Unique request ID\n  request: RequestContext;          // Incoming request (body, headers, params, query)\n  response: ResponseContext;       // Current step output \u2014 OVERWRITTEN every step\n  vars?: VarsContext;              // Persistent variables \u2014 PERSISTS across workflow\n  config: ConfigContext;           // Node config (inputs resolved by Mapper)\n  env?: EnvContext;                // process.env access\n  logger: LoggerContext;\n  error: ErrorContext;\n};\n```\n\n### The Two Critical Rules\n\n**Rule 1: \\`ctx.response.data\\` is OVERWRITTEN after every step.**\nEach step's output replaces the previous \\`ctx.response.data\\`. If you need a step's output later, store it in \\`ctx.vars\\`.\n\n**Rule 2: \\`ctx.vars\\` PERSISTS across the entire workflow.**\nUse \\`set_var: true\\` on a step to auto-store its output in \\`ctx.vars[stepName]\\`. Downstream steps access it via \\`ctx.vars['step-name']\\`.\n\n### Data Flow Example\n\n```\nStep 1: \"fetch-user\"  (set_var: true)\n  \u2192 ctx.response.data = { id: \"123\", name: \"Alice\" }\n  \u2192 ctx.vars[\"fetch-user\"] = { id: \"123\", name: \"Alice\" }\n\nStep 2: \"transform\"\n  \u2192 ctx.response.data = { result: \"done\" }     \u2190 Step 1 output GONE from response\n  \u2192 ctx.vars[\"fetch-user\"] still available\n\nStep 3: \"output\"\n  \u2192 Can read ctx.vars[\"fetch-user\"].name        \u2190 still \"Alice\"\n```\n\n### Blueprint Mapper \u2014 Expression Resolution\n\nNode inputs support dynamic expressions resolved BEFORE node execution:\n\n```json\n{\n  \"inputs\": {\n    \"userId\": \"js/ctx.request.body.userId\",\n    \"chain\": \"js/ctx.vars['previous-step'].chain\",\n    \"previous\": \"js/ctx.response.data.result\"\n  }\n}\n```\n\nAvailable in js/ expressions: \\`ctx\\`, \\`data\\` (ctx.response.data), \\`func\\` (ctx.func), \\`vars\\` (ctx.vars)\n\n---\n\n## Creating Nodes with defineNode\n\nUse \\`defineNode()\\` for all new nodes. Never use the legacy class-based pattern.\n\n```typescript\nimport { defineNode } from \"@blok/runner\";\nimport { z } from \"zod\";\n\nexport default defineNode({\n  name: \"fetch-user\",\n  description: \"Fetches user by ID\",\n\n  input: z.object({\n    userId: z.string().uuid(),\n  }),\n\n  output: z.object({\n    user: z.object({\n      id: z.string(),\n      name: z.string(),\n      email: z.string().email(),\n    }),\n  }),\n\n  async execute(ctx, input) {\n    const user = await fetchUser(input.userId);\n    return { user };\n  },\n});\n```\n\n### Key Behaviors\n\n- Zod input/output validation runs automatically\n- ZodError is mapped to GlobalError with HTTP 400\n- \\`flow: true\\` nodes return NodeBase[] for conditional execution\n- \\`contentType\\` sets response Content-Type (e.g., \"text/html\")\n- Always \\`export default defineNode(...)\\`\n\n---\n\n## Workflow Structure (JSON)\n\n```json\n{\n  \"name\": \"My Workflow\",\n  \"version\": \"1.0.0\",\n  \"trigger\": {\n    \"http\": { \"method\": \"POST\", \"path\": \"/api/process\", \"accept\": \"application/json\" }\n  },\n  \"steps\": [\n    { \"name\": \"fetch\",   \"node\": \"@blok/api-call\", \"type\": \"module\" },\n    { \"name\": \"process\", \"node\": \"my-node\",        \"type\": \"module\", \"set_var\": true },\n    { \"name\": \"go-step\", \"node\": \"chain-test\",     \"type\": \"runtime.go\" }\n  ],\n  \"nodes\": {\n    \"fetch\":   { \"inputs\": { \"url\": \"https://api.example.com\", \"method\": \"GET\" } },\n    \"process\": { \"inputs\": { \"data\": \"js/ctx.response.data\" } },\n    \"go-step\": { \"inputs\": { \"processed\": \"js/ctx.vars['process']\" } }\n  }\n}\n```\n\n### Step Types\n\n| Type | Description |\n|------|-------------|\n| \\`module\\` | TypeScript node from registered modules |\n| \\`local\\` | TypeScript node from filesystem (NODES_PATH) |\n| \\`runtime.python3\\` | Python3 SDK container (port 9007) |\n| \\`runtime.go\\` | Go SDK container (port 9001) |\n| \\`runtime.rust\\` | Rust SDK container (port 9002) |\n| \\`runtime.java\\` | Java SDK container (port 9003) |\n| \\`runtime.csharp\\` | C# SDK container (port 9004) |\n| \\`runtime.php\\` | PHP SDK container (port 9005) |\n| \\`runtime.ruby\\` | Ruby SDK container (port 9006) |\n\n### Conditional Workflow (if-else)\n\n```json\n{\n  \"nodes\": {\n    \"filter\": {\n      \"conditions\": [\n        {\n          \"type\": \"if\",\n          \"condition\": \"ctx.request.query.active === \\\\\"true\\\\\"\",\n          \"steps\": [{ \"name\": \"active-path\", \"node\": \"handle-active\", \"type\": \"module\" }]\n        },\n        {\n          \"type\": \"else\",\n          \"steps\": [{ \"name\": \"default-path\", \"node\": \"handle-default\", \"type\": \"module\" }]\n        }\n      ]\n    }\n  }\n}\n```\n\n---\n\n## Trigger Types\n\n| Trigger | Example Config |\n|---------|---------------|\n| \\`http\\` | \\`{ \"method\": \"GET\", \"path\": \"/\", \"accept\": \"application/json\" }\\` |\n| \\`grpc\\` | \\`{ \"service\": \"UserService\", \"method\": \"GetUser\" }\\` |\n| \\`cron\\` | \\`{ \"schedule\": \"0 * * * *\", \"timezone\": \"UTC\" }\\` |\n| \\`queue\\` | \\`{ \"provider\": \"kafka\", \"topic\": \"events\" }\\` |\n| \\`pubsub\\` | \\`{ \"provider\": \"gcp\", \"topic\": \"updates\" }\\` |\n| \\`webhook\\` | \\`{ \"source\": \"github\", \"events\": [\"push\"] }\\` |\n| \\`websocket\\` | \\`{ \"events\": [\"message\"], \"path\": \"/ws\" }\\` |\n| \\`sse\\` | \\`{ \"events\": [\"update\"], \"path\": \"/stream\" }\\` |\n| \\`worker\\` | \\`{ \"queue\": \"jobs\", \"concurrency\": 5 }\\` |\n\n---\n\n## Runtime Adapter System\n\nAll non-NodeJS SDKs communicate via HTTP:\n- **POST /execute** \u2014 Execute node with context\n- **GET /health** \u2014 Health check\n\nEnvironment variables: \\`RUNTIME_{LANG}_HOST\\` / \\`RUNTIME_{LANG}_PORT\\`\n\nRuntime nodes auto-save \\`result.data\\` to \\`ctx.vars[stepName]\\`.\n\n---\n\n## Blok Studio\n\nReal-time workflow trace visualization UI.\n\n- Launch: \\`blokctl trace\\` or \\`blokctl studio\\`\n- API: \\`/__blok/runs\\`, \\`/__blok/runs/:id\\`, \\`/__blok/runs/:id/stream\\` (SSE)\n- Disable: \\`BLOK_TRACE_ENABLED=false\\`\n\n---\n\n## Do NOT\n\n- Do NOT rely on \\`ctx.response.data\\` for data from non-previous steps \u2014 it gets overwritten\n- Do NOT create class-based nodes \u2014 use \\`defineNode()\\` instead\n- Do NOT use \\`any\\` type \u2014 use \\`unknown\\` and narrow with Zod\n- Do NOT hardcode runtime ports \u2014 use environment variables\n- Do NOT skip Zod input/output schemas\n- Do NOT edit files in \\`.blok/runtimes/\\` \u2014 they are auto-generated\n\n## Do\n\n- Use \\`ctx.vars\\` with \\`set_var: true\\` to pass data between non-adjacent steps\n- Use \\`js/ctx.vars['step-name'].field\\` in workflow inputs for data flow\n- Use Zod schemas for all input/output validation\n- Use \\`defineNode()\\` for all new nodes\n- Handle errors via GlobalError with appropriate HTTP status codes\n- Keep nodes focused \u2014 one responsibility per node\n";
+declare const claude_md = "# Blok Project \u2014 Claude Code Guide\n\nRead \\`AGENTS.md\\` for full architecture and API details. This file contains Claude-specific guidance.\n\n## Quick Commands\n\n\\`\\`\\`bash\nnpm run dev                        # Start dev server\nblokctl dev                        # Multi-runtime dev server\nblokctl create node <name>         # Scaffold new node\nblokctl create workflow <name>     # Scaffold new workflow\nblokctl trace                      # Open Blok Studio\nnpm test                           # Run tests\n\\`\\`\\`\n\n## Context Rules (Memorize These)\n\n1. **\\`ctx.response.data\\` is OVERWRITTEN every step.** Previous output GONE unless stored in vars.\n2. **\\`ctx.vars\\` PERSISTS across the workflow.** Use \\`set_var: true\\` or \\`js/ctx.vars['step']\\`.\n3. **Blueprint Mapper resolves \\`js/\\` expressions BEFORE node execution.**\n\nWhen users have data flow issues, check these three things first.\n\n## Debugging Workflows\n\n1. **Verify structure**: Every \\`steps[].name\\` must match a key in \\`nodes\\`\n2. **Trace data flow**: Which steps have \\`set_var: true\\`? Do \\`js/\\` expressions reference correct step names?\n3. **Check runtimes**: SDK containers running? \\`GET http://localhost:{port}/health\\`\n4. **Check Studio traces**: \\`/__blok/runs/:id\\` shows step-by-step inputs/outputs/errors\n\n### Common Errors\n\n| Error | Fix |\n|-------|-----|\n| \\`Node type X not found\\` | Wrong \\`type\\` in step \u2014 use module, local, or runtime.* |\n| \\`Validation failed\\` | Zod schema mismatch \u2014 check input schema vs actual data |\n| \\`Runtime execution error\\` | SDK container not running \u2014 check health endpoint |\n| \\`ctx.vars['X'] undefined\\` | Source step missing \\`set_var: true\\` or name mismatch |\n\n## Generating Code\n\nAlways use \\`defineNode()\\`. Never class-based BlokService.\n\n\\`\\`\\`typescript\nimport { defineNode } from \"@blok/runner\";\nimport { z } from \"zod\";\n\nexport default defineNode({\n  name: \"node-name\",\n  description: \"What this node does\",\n  input: z.object({ /* Zod schema */ }),\n  output: z.object({ /* Zod schema */ }),\n  async execute(ctx, input) {\n    return { /* must match output schema */ };\n  },\n});\n\\`\\`\\`\n\n### Checklist:\n- Zod input schema covers all inputs\n- Zod output schema matches execute() return\n- Node name matches workflow references\n- No \\`any\\` types \u2014 use \\`z.unknown()\\` if dynamic\n- \\`export default defineNode(...)\\`\n\n## Blok Studio Help\n\n- Launch: \\`blokctl trace\\` or navigate to \\`/__blok\\`\n- \"No output\" \u2192 Node not returning data or Zod output validation failed\n- \"Step error\" \u2192 Expand error \u2014 check if 400 (validation) or 500 (runtime)\n- \"Vars not passing\" \u2192 Source step needs \\`set_var: true\\`, target needs \\`js/ctx.vars['name']\\`\n\n## Do NOT\n\n- Do NOT suggest class-based BlokService for new nodes\n- Do NOT generate code with \\`any\\` types\n- Do NOT assume \\`ctx.response.data\\` persists across steps\n- Do NOT skip Zod schemas when creating nodes\n- Do NOT edit files in \\`.blok/runtimes/\\`\n";
+declare const function_first_node_file = "import { defineNode } from \"@blok/runner\";\nimport { z } from \"zod\";\n\n/**\n * A function-first node that demonstrates the modern defineNode pattern.\n * This node is type-safe, validated, and requires 60% less boilerplate.\n */\nexport default defineNode({\n\tname: \"{{NODE_NAME}}\",\n\tdescription: \"A function-first node with Zod validation\",\n\n\t// Input schema using Zod - automatically validated\n\tinput: z.object({\n\t\tmessage: z.string().optional().default(\"Hello World\"),\n\t}),\n\n\t// Output schema using Zod - automatically validated\n\toutput: z.object({\n\t\tmessage: z.string(),\n\t\ttimestamp: z.string(),\n\t}),\n\n\t// Execute function - type-safe with inferred types from Zod schemas\n\tasync execute(ctx, input) {\n\t\t// Your business logic here\n\t\t// - ctx.vars: Access workflow variables\n\t\t// - ctx.request: Access HTTP request data\n\t\t// - ctx.logger: Log messages\n\t\t// - ctx.env: Access environment variables\n\n\t\t// Example: Store data for downstream nodes\n\t\tctx.vars[\"processed-message\"] = input.message;\n\n\t\t// Return type-safe output (validated automatically)\n\t\treturn {\n\t\t\tmessage: `Processed: ${input.message}`,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t};\n\t},\n});\n";
+export { node_file, package_dependencies, package_dev_dependencies, python3_file, examples_url, workflow_template, supervisord_nodejs, supervisord_python, go_node_file, go_mod_file, go_dockerfile, java_node_file, java_pom_file, java_dockerfile, rust_node_file, rust_cargo_file, rust_dockerfile, csharp_node_file, csharp_csproj_file, csharp_dockerfile, php_node_file, php_composer_file, php_dockerfile, ruby_node_file, ruby_gemfile, ruby_dockerfile, function_first_node_file, agents_md, claude_md, };