blokctl 1.3.0 → 1.4.1

package/dist/scaffold-repo/sdks/ruby/lib/blok/node/typed_node.rb

@@ -0,0 +1,180 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "node_handler"
+require_relative "../errors/blok_error"
+
+module Blok
+  module Node
+    # TypedNode is the typed authoring contract (SPEC-B P4) — the Ruby equivalent
+    # of the TypeScript +defineNode+ / Python +@node+ / Rust +TypedNode+. Declare
+    # an input schema with a small DSL; the SDK validates the raw config against
+    # it (missing required field / wrong type -> structured BlokError, HTTP 400)
+    # BEFORE +run+, passes a symbol-keyed, defaulted input hash, and reflects the
+    # JSON Schema for the node catalog (GET /__blok/nodes) — instead of a raw
+    # config Hash.
+    #
+    # @example
+    #   class SearchNode < Blok::Node::TypedNode
+    #     node_name "@acme/search"
+    #     description "Full-text search"
+    #     input do
+    #       field :query, :string, required: true
+    #       field :limit, :integer, default: 10
+    #     end
+    #
+    #     def run(ctx, input)
+    #       rows = [input[:query]] * input[:limit]
+    #       { "results" => rows, "count" => rows.size }
+    #     end
+    #   end
+    class TypedNode < NodeHandler
+      # JSON Schema type name for each declared field type.
+      JSON_TYPES = {
+        string: "string", integer: "integer", number: "number",
+        boolean: "boolean", array: "array", object: "object"
+      }.freeze
+
+      # Acceptable Ruby classes for each declared field type.
+      RUBY_TYPES = {
+        string: [String], integer: [Integer], number: [Integer, Float],
+        boolean: [TrueClass, FalseClass], array: [Array], object: [Hash]
+      }.freeze
+
+      # One declared field in an input/output schema.
+      Field = Struct.new(:name, :type, :required, :default, :has_default, keyword_init: true)
+
+      # Collects +field+ declarations from an +input+/+output+ block.
+      class SchemaBuilder
+        attr_reader :fields
+
+        def initialize
+          @fields = []
+        end
+
+        # @param name [Symbol] field name
+        # @param type [Symbol] one of :string, :integer, :number, :boolean, :array, :object
+        # @param required [Boolean] whether the field must be present
+        def field(name, type, required: false, **opts)
+          @fields << Field.new(
+            name: name.to_sym, type: type.to_sym, required: required,
+            default: opts[:default], has_default: opts.key?(:default)
+          )
+        end
+      end
+
+      class << self
+        # Get/set the registered node name (e.g. "@acme/search").
+        def node_name(value = nil)
+          @node_name = value unless value.nil?
+          @node_name
+        end
+
+        # Get/set the human-readable description.
+        def description(value = nil)
+          @description = value unless value.nil?
+          @description || ""
+        end
+
+        def input(&block)
+          builder = SchemaBuilder.new
+          builder.instance_eval(&block)
+          @input_fields = builder.fields
+        end
+
+        def output(&block)
+          builder = SchemaBuilder.new
+          builder.instance_eval(&block)
+          @output_fields = builder.fields
+        end
+
+        def input_fields
+          @input_fields || []
+        end
+
+        def output_fields
+          @output_fields
+        end
+
+        # Build a JSON Schema (Ruby Hash) from a list of fields.
+        def schema_for(fields)
+          properties = {}
+          required = []
+          fields.each do |f|
+            properties[f.name.to_s] = { "type" => JSON_TYPES.fetch(f.type, "object") }
+            required << f.name.to_s if f.required
+          end
+          schema = { "type" => "object", "properties" => properties }
+          schema["required"] = required unless required.empty?
+          schema
+        end
+      end
+
+      # NodeHandler entry point: validate the raw config, then run.
+      def execute(ctx, config)
+        input = validate_input(config)
+        run(ctx, input)
+      end
+
+      # Run the node with a VALIDATED, symbol-keyed input hash. Override this.
+      def run(ctx, input)
+        raise NotImplementedError, "#{self.class}#run must be implemented"
+      end
+
+      # ---- Reflection (consumed by the gRPC ListNodes catalog) ----
+
+      # @return [Hash] { description:, input_schema_json:, output_schema_json: }
+      def reflect
+        out_fields = self.class.output_fields
+        {
+          description: self.class.description,
+          input_schema_json: JSON.generate(self.class.schema_for(self.class.input_fields)),
+          output_schema_json: out_fields.nil? ? nil : JSON.generate(self.class.schema_for(out_fields))
+        }
+      end
+
+      private
+
+      def validate_input(config)
+        result = {}
+        self.class.input_fields.each do |f|
+          key = f.name.to_s
+          if config.key?(key) || config.key?(f.name)
+            value = config.key?(key) ? config[key] : config[f.name]
+            check_type!(f, value)
+            result[f.name] = value
+          elsif f.has_default
+            result[f.name] = f.default
+          elsif f.required
+            raise validation_error("missing required field '#{f.name}'")
+          else
+            result[f.name] = nil
+          end
+        end
+        result
+      end
+
+      def check_type!(field, value)
+        return if value.nil? && !field.required
+
+        allowed = RUBY_TYPES[field.type]
+        return if allowed.nil? # unknown type → don't enforce
+        return if allowed.any? { |klass| value.is_a?(klass) }
+
+        raise validation_error(
+          "field '#{field.name}' expected #{field.type}, got #{value.class}"
+        )
+      end
+
+      def validation_error(detail)
+        name = self.class.node_name.to_s
+        Blok::Errors::BlokError.validation(
+          code: "NODE_INPUT_VALIDATION",
+          message: "Input validation failed for node '#{name}': #{detail}",
+          http_status: 400,
+          node: name
+        )
+      end
+    end
+  end
+end

package/dist/scaffold-repo/sdks/ruby/lib/blok/runtime/v1/runtime_pb.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: blok/runtime/v1/runtime.proto
+
+require 'google/protobuf'
+
+require 'google/protobuf/timestamp_pb'
+
+
+descriptor_data = "\n\x1d\x62lok/runtime/v1/runtime.proto\x12\x0f\x62lok.runtime.v1\x1a\x1fgoogle/protobuf/timestamp.proto\"\xb1\x02\n\x0e\x45xecuteRequest\x12&\n\x04node\x18\x01 \x01(\x0b\x32\x18.blok.runtime.v1.NodeRef\x12\x0e\n\x06inputs\x18\x02 \x01(\x0c\x12\'\n\x04step\x18\x03 \x01(\x0b\x32\x19.blok.runtime.v1.StepInfo\x12-\n\x07trigger\x18\x04 \x01(\x0b\x32\x1c.blok.runtime.v1.TriggerInfo\x12,\n\x05state\x18\x05 \x01(\x0b\x32\x1d.blok.runtime.v1.RuntimeState\x12/\n\x08workflow\x18\x06 \x01(\x0b\x32\x1d.blok.runtime.v1.WorkflowInfo\x12\x30\n\x07options\x18\x07 \x01(\x0b\x32\x1f.blok.runtime.v1.ExecuteOptions\"6\n\x07NodeRef\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0c\n\x04type\x18\x02 \x01(\t\x12\x0f\n\x07version\x18\x03 \x01(\t\"E\n\x08StepInfo\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\r\n\x05index\x18\x02 \x01(\x05\x12\r\n\x05total\x18\x03 \x01(\x05\x12\r\n\x05\x64\x65pth\x18\x04 \x01(\x05\"\x87\x04\n\x0bTriggerInfo\x12\x0c\n\x04\x62ody\x18\x01 \x01(\x0c\x12:\n\x07headers\x18\x02 \x03(\x0b\x32).blok.runtime.v1.TriggerInfo.HeadersEntry\x12\x38\n\x06params\x18\x03 \x03(\x0b\x32(.blok.runtime.v1.TriggerInfo.ParamsEntry\x12\x36\n\x05query\x18\x04 \x03(\x0b\x32\'.blok.runtime.v1.TriggerInfo.QueryEntry\x12:\n\x07\x63ookies\x18\x05 \x03(\x0b\x32).blok.runtime.v1.TriggerInfo.CookiesEntry\x12\x0e\n\x06method\x18\x06 \x01(\t\x12\x0b\n\x03url\x18\x07 \x01(\t\x12\x10\n\x08\x62\x61se_url\x18\x08 \x01(\t\x12\x14\n\x0ctrigger_kind\x18\t \x01(\t\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a-\n\x0bParamsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a,\n\nQueryEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a.\n\x0c\x43ookiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x96\x01\n\x0cRuntimeState\x12\x17\n\x0fprevious_output\x18\x01 \x01(\x0c\x12\x0c\n\x04vars\x18\x02 \x01(\x0c\x12\x33\n\x03\x65nv\x18\x03 \x03(\x0b\x32&.blok.runtime.v1.RuntimeState.EnvEntry\x1a*\n\x08\x45nvEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"{\n\x0cWorkflowInfo\x12\x0e\n\x06run_id\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\x0c\n\x04path\x18\x03 \x01(\t\x12\x0f\n\x07version\x18\x04 \x01(\t\x12.\n\nstarted_at\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xbc\x01\n\x0e\x45xecuteOptions\x12\x13\n\x0b\x64\x65\x61\x64line_ms\x18\x01 \x01(\x03\x12\x13\n\x0bstream_logs\x18\x02 \x01(\x08\x12\x17\n\x0f\x63\x61pture_metrics\x18\x03 \x01(\x08\x12\x39\n\x05hints\x18\x0f \x03(\x0b\x32*.blok.runtime.v1.ExecuteOptions.HintsEntry\x1a,\n\nHintsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xd8\x01\n\x0f\x45xecuteResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x0c\n\x04\x64\x61ta\x18\x02 \x01(\x0c\x12\x14\n\x0c\x63ontent_type\x18\x03 \x01(\t\x12)\n\x05\x65rror\x18\x04 \x01(\x0b\x32\x1a.blok.runtime.v1.NodeError\x12\x12\n\nvars_delta\x18\x05 \x01(\x0c\x12&\n\x04logs\x18\x06 \x03(\x0b\x32\x18.blok.runtime.v1.LogLine\x12)\n\x07metrics\x18\x07 \x01(\x0b\x32\x18.blok.runtime.v1.Metrics\"\x86\x02\n\x0c\x45xecuteEvent\x12/\n\x07started\x18\x01 \x01(\x0b\x32\x1c.blok.runtime.v1.NodeStartedH\x00\x12\'\n\x03log\x18\x02 \x01(\x0b\x32\x18.blok.runtime.v1.LogLineH\x00\x12-\n\x08progress\x18\x03 \x01(\x0b\x32\x19.blok.runtime.v1.ProgressH\x00\x12\x31\n\x07partial\x18\x04 \x01(\x0b\x32\x1e.blok.runtime.v1.PartialResultH\x00\x12\x31\n\x05\x66inal\x18\x05 \x01(\x0b\x32 .blok.runtime.v1.ExecuteResponseH\x00\x42\x07\n\x05\x65vent\"5\n\x0bNodeStarted\x12&\n\x02\x61t\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"*\n\x08Progress\x12\x0f\n\x07percent\x18\x01 \x01(\x01\x12\r\n\x05phase\x18\x02 \x01(\t\"&\n\rPartialResult\x12\x15\n\rsnapshot_json\x18\x01 \x01(\x0c\"\xc9\x01\n\x07LogLine\x12-\n\ttimestamp\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\r\n\x05level\x18\x02 \x01(\t\x12\x0f\n\x07message\x18\x03 \x01(\t\x12<\n\nattributes\x18\x04 \x03(\x0b\x32(.blok.runtime.v1.LogLine.AttributesEntry\x1a\x31\n\x0f\x41ttributesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xe7\x03\n\tNodeError\x12\x0c\n\x04\x63ode\x18\x01 \x01(\t\x12\x30\n\x08\x63\x61tegory\x18\x02 \x01(\x0e\x32\x1e.blok.runtime.v1.ErrorCategory\x12\x30\n\x08severity\x18\x03 \x01(\x0e\x32\x1e.blok.runtime.v1.ErrorSeverity\x12\x0c\n\x04node\x18\x04 \x01(\t\x12\x0b\n\x03sdk\x18\x05 \x01(\t\x12\x13\n\x0bsdk_version\x18\x06 \x01(\t\x12\x14\n\x0cruntime_kind\x18\x07 \x01(\t\x12&\n\x02\x61t\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0f\n\x07message\x18\t \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\n \x01(\t\x12\x13\n\x0bremediation\x18\x0b \x01(\t\x12\x0f\n\x07\x64oc_url\x18\x0c \x01(\t\x12*\n\x06\x63\x61uses\x18\r \x03(\x0b\x32\x1a.blok.runtime.v1.NodeError\x12\r\n\x05stack\x18\x0e \x01(\t\x12\x1d\n\x15\x63ontext_snapshot_json\x18\x0f \x01(\x0c\x12\x13\n\x0bhttp_status\x18\x10 \x01(\x05\x12\x11\n\tretryable\x18\x11 \x01(\x08\x12\x16\n\x0eretry_after_ms\x18\x12 \x01(\x03\x12\x14\n\x0c\x64\x65tails_json\x18\x13 \x01(\x0c\"\x12\n\x10ListNodesRequest\"\x81\x01\n\x11ListNodesResponse\x12.\n\x05nodes\x18\x01 \x03(\x0b\x32\x1f.blok.runtime.v1.NodeDescriptor\x12\x10\n\x08sdk_name\x18\x02 \x01(\t\x12\x13\n\x0bsdk_version\x18\x03 \x01(\t\x12\x15\n\rproto_version\x18\x04 \x01(\t\"x\n\x0eNodeDescriptor\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x19\n\x11input_schema_json\x18\x03 \x01(\x0c\x12\x1a\n\x12output_schema_json\x18\x04 \x01(\x0c\x12\x0c\n\x04tags\x18\x05 \x03(\t\" \n\rHealthRequest\x12\x0f\n\x07service\x18\x01 \x01(\t\"\xac\x01\n\x0eHealthResponse\x12\x36\n\x06status\x18\x01 \x01(\x0e\x32&.blok.runtime.v1.HealthResponse.Status\x12\x13\n\x0bsdk_version\x18\x02 \x01(\t\x12\x18\n\x10registered_nodes\x18\x03 \x03(\t\"3\n\x06Status\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x0b\n\x07SERVING\x10\x01\x12\x0f\n\x0bNOT_SERVING\x10\x02\"s\n\x07Metrics\x12\x13\n\x0b\x64uration_ms\x18\x01 \x01(\x01\x12\x0e\n\x06\x63pu_ms\x18\x02 \x01(\x01\x12\x14\n\x0cmemory_bytes\x18\x03 \x01(\x03\x12\x15\n\rrequest_bytes\x18\x04 \x01(\x03\x12\x16\n\x0eresponse_bytes\x18\x05 \x01(\x03*\xdb\x01\n\rErrorCategory\x12\x18\n\x14\x43\x41TEGORY_UNSPECIFIED\x10\x00\x12\x0e\n\nVALIDATION\x10\x01\x12\x11\n\rCONFIGURATION\x10\x02\x12\x0e\n\nDEPENDENCY\x10\x03\x12\x0b\n\x07TIMEOUT\x10\x04\x12\x0e\n\nPERMISSION\x10\x05\x12\x0e\n\nRATE_LIMIT\x10\x06\x12\r\n\tNOT_FOUND\x10\x07\x12\x0c\n\x08\x43ONFLICT\x10\x08\x12\r\n\tCANCELLED\x10\t\x12\x0c\n\x08INTERNAL\x10\n\x12\x0c\n\x08PROTOCOL\x10\x0b\x12\x08\n\x04\x44\x41TA\x10\x0c*S\n\rErrorSeverity\x12\x18\n\x14SEVERITY_UNSPECIFIED\x10\x00\x12\x08\n\x04INFO\x10\x01\x12\x08\n\x04WARN\x10\x02\x12\t\n\x05\x45RROR\x10\x03\x12\t\n\x05\x46\x41TAL\x10\x04\x32\xcd\x02\n\x0bNodeRuntime\x12L\n\x07\x45xecute\x12\x1f.blok.runtime.v1.ExecuteRequest\x1a .blok.runtime.v1.ExecuteResponse\x12Q\n\rExecuteStream\x12\x1f.blok.runtime.v1.ExecuteRequest\x1a\x1d.blok.runtime.v1.ExecuteEvent0\x01\x12I\n\x06Health\x12\x1e.blok.runtime.v1.HealthRequest\x1a\x1f.blok.runtime.v1.HealthResponse\x12R\n\tListNodes\x12!.blok.runtime.v1.ListNodesRequest\x1a\".blok.runtime.v1.ListNodesResponseB\x8f\x01\n\x13\x63om.blok.runtime.v1P\x01Z>github.com/nickincloud/blok-go/genpb/blok/runtime/v1;runtimev1\xaa\x02\x0f\x42lok.Runtime.V1\xca\x02\x0f\x42lok\\Runtime\\V1\xea\x02\x11\x42lok::Runtime::V1b\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module Blok
+  module Runtime
+    module V1
+      ExecuteRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.ExecuteRequest").msgclass
+      NodeRef = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.NodeRef").msgclass
+      StepInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.StepInfo").msgclass
+      TriggerInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.TriggerInfo").msgclass
+      RuntimeState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.RuntimeState").msgclass
+      WorkflowInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.WorkflowInfo").msgclass
+      ExecuteOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.ExecuteOptions").msgclass
+      ExecuteResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.ExecuteResponse").msgclass
+      ExecuteEvent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.ExecuteEvent").msgclass
+      NodeStarted = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.NodeStarted").msgclass
+      Progress = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.Progress").msgclass
+      PartialResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.PartialResult").msgclass
+      LogLine = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.LogLine").msgclass
+      NodeError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.NodeError").msgclass
+      ListNodesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.ListNodesRequest").msgclass
+      ListNodesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.ListNodesResponse").msgclass
+      NodeDescriptor = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.NodeDescriptor").msgclass
+      HealthRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.HealthRequest").msgclass
+      HealthResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.HealthResponse").msgclass
+      HealthResponse::Status = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.HealthResponse.Status").enummodule
+      Metrics = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.Metrics").msgclass
+      ErrorCategory = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.ErrorCategory").enummodule
+      ErrorSeverity = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("blok.runtime.v1.ErrorSeverity").enummodule
+    end
+  end
+end

package/dist/scaffold-repo/sdks/ruby/lib/blok/runtime/v1/runtime_services_pb.rb

@@ -0,0 +1,55 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: blok/runtime/v1/runtime.proto for package 'Blok.Runtime.V1'
+# Original file comments:
+# Blok Runtime v1 — the wire contract between the TypeScript runner and SDK
+# servers (Python, Go, Rust, Java, C#, PHP, Ruby).
+#
+# Single source of truth for cross-language interop. Generated stubs in each
+# SDK are derived from this file via `make proto`.
+#
+# Stability: `blok.runtime.v1` is additive-only. CI runs `buf breaking` to
+# reject backward-incompatible changes. Breaking changes go to `v2`, served
+# alongside `v1` during migration.
+#
+
+require 'grpc'
+require 'blok/runtime/v1/runtime_pb'
+
+module Blok
+  module Runtime
+    module V1
+      module NodeRuntime
+        # =============================================================================
+        # Service
+        # =============================================================================
+        #
+        # NodeRuntime is the contract every Blok SDK exposes. One service handles
+        # three responsibilities:
+        #   1. Run a node (Execute / ExecuteStream)
+        #   2. Tell the runner which nodes it can run (ListNodes)
+        #   3. Tell the runner if it is alive (Health)
+        class Service
+
+          include ::GRPC::GenericService
+
+          self.marshal_class_method = :encode
+          self.unmarshal_class_method = :decode
+          self.service_name = 'blok.runtime.v1.NodeRuntime'
+
+          # Run a node and return its result. Unary, deadline-driven.
+          rpc :Execute, ::Blok::Runtime::V1::ExecuteRequest, ::Blok::Runtime::V1::ExecuteResponse
+          # Run a node and stream events back as it executes (logs, progress, partial
+          # results, then a final ExecuteResponse). Optional capability — SDKs that
+          # don't implement it should return UNIMPLEMENTED.
+          rpc :ExecuteStream, ::Blok::Runtime::V1::ExecuteRequest, stream(::Blok::Runtime::V1::ExecuteEvent)
+          # Health check (wire-compatible with grpc.health.v1.Health/Check).
+          rpc :Health, ::Blok::Runtime::V1::HealthRequest, ::Blok::Runtime::V1::HealthResponse
+          # Discover registered nodes and their schemas (drives Studio + OpenAPI gen).
+          rpc :ListNodes, ::Blok::Runtime::V1::ListNodesRequest, ::Blok::Runtime::V1::ListNodesResponse
+        end
+
+        Stub = Service.rpc_stub_class
+      end
+    end
+  end
+end