stack-service-base 0.0.57 → 0.0.59

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 81646afebee3b19d18a2f13f58aeae9559b79033315ec6200c86085611ac088d
-  data.tar.gz: df126a48c152469880314fc4bc440555a93528c6d3f71e53d58485763d4175bc
+  metadata.gz: 55f435587160a4c4210903f8cf0af139ac161402c49cd82e34da0ec1f0d2115d
+  data.tar.gz: 44c4c02fbd588a70835cdd6cb10348e78df5cef0a5017b667445046763084411
 SHA512:
-  metadata.gz: 653ebe71e422922b1d688b9bb9d00a4d81450b2da6c1f956a56c64c60659ceb52d83048a9bcef5cd6175bf2a48e357055f0826f391ac3bc70aca7bbc83f98368
-  data.tar.gz: 38a1901294e10dc628547f6ea83f0a837f2989e57849d06435105328936db516e1cecf9eac5b596b728f25bf26f397a6f3910b67a2440d8138c39ad149039bcb
+  metadata.gz: 95d9aff0cff97f4f857247eefe3ed61a03ea05a7d202eb3e118d485d418b7578e76a60190aa4965f6e4fbf4e424d67617e1e394519352817bb0b5fd6c538eeac
+  data.tar.gz: 17adacbd6686f78010139866873cb22a6d3c328ae93ace314b8821861af3341bc0740642d262650804a1129aeabb50af6232c6711963d4715ccf877a8077cad7

data/lib/stack-service-base/examples/mcp_config.ru

@@ -0,0 +1,73 @@
+require 'sinatra'
+require 'stack-service-base'
+
+StackServiceBase.rack_setup self
+
+SERVICES = {
+  "database-backend" => {
+    status: "running",
+    uptime: 72 * 3600,                       # seconds
+    last_restart: Time.now - 72 * 3600
+  }
+}
+
+require 'stack-service-base/mcp_processor'
+require 'stack-service-base/mcp_tool_registry'
+
+MCP_PROCESSOR = McpProcessor.new
+
+Tool :service_status do
+  description 'Check current status of a service'
+  input service_name: { type: "string", description: "Service name to inspect", required: true }
+  execute do |inputs|
+    service_name = inputs[:service_name]
+    service = SERVICES[service_name]
+    rpc_error!(404, "Unknown service #{service_name}") unless service
+    {
+      toolResult: {
+        service_name: service_name,
+        status: service[:status],
+        uptime_sec: service[:uptime],
+        last_restart: service[:last_restart].utc.iso8601,
+      }
+    }
+  end
+end
+
+Tool :restart_service do
+  description 'Restart a service'
+  input service_name: { type: "string", description: "Service name to restart", required: true },
+        force: { type: "boolean", default: false, description: "Force restart if graceful fails" }
+  execute do |inputs|
+    service_name = inputs[:service_name]
+    service = SERVICES[service_name]
+    rpc_error!(404, "Unknown service #{service_name}") unless service
+
+    service[:status]       = "running"
+    service[:last_restart] = Time.now
+    service[:uptime]       = 0
+
+    {
+      toolResult: {
+        service_name: service_name,
+        status: service[:status],
+        restarted_at: service[:last_restart].utc.iso8601,
+        force: inputs.fetch(:force, false)
+      }
+    }
+  end
+end
+
+before { content_type :json }
+error McpProcessor::ParseError do |err|
+  status err.status
+  err.body
+end
+
+get  '/', &MCP_PROCESSOR.method(:root_endpoint)
+post '/' do
+  request.body.rewind
+  MCP_PROCESSOR.rpc_endpoint(request.body.read)
+end
+
+run Sinatra::Application

data/lib/stack-service-base/mcp_processor.rb

@@ -0,0 +1,118 @@
+class JsonRpcError < StandardError
+  attr_reader :code
+
+  def initialize(code:, message:)
+    super(message)
+    @code = code
+  end
+end
+
+module RpcErrorHelpers
+  def rpc_error!(code, message)
+    raise ::JsonRpcError.new(code: code, message: message)
+  end
+end
+
+class McpProcessor
+  PROTOCOL_VERSION = '2025-06-18'
+
+  include RpcErrorHelpers
+  ParseError = Class.new(StandardError) do
+    attr_reader :body, :status
+
+    def initialize(body:, status:)
+      @body = body
+      @status = status
+      super("MCP parse error")
+    end
+  end
+
+  def initialize(logger: LOGGER)
+    @logger = logger
+  end
+
+  def root_endpoint
+    root_response
+  end
+
+  def rpc_endpoint(raw_body)
+    req = JSON.parse(raw_body.to_s)
+    rpc_response(id: req["id"], method: req["method"], params: req["params"])
+  rescue JSON::ParserError
+    body = error_response(id: nil, code: -32700, message: "Parse error")
+    raise ParseError.new(body: body, status: 400)
+  end
+
+  def list_tools
+    { tools: ToolRegistry.list, nextCursor: nil }
+  end
+
+  def root_response
+    json_rpc_response(id: nil) { list_tools }
+  end
+
+  def error_response(id:, code:, message:)
+    json_rpc_response(id: id) { rpc_error!(code, message) }
+  end
+
+  def rpc_response(id:, method:, params:)
+    json_rpc_response(id: id) { |body| handle(method: method, params: params, body: body) }
+  end
+
+  def handle(method:, params:, body: )
+    case method
+    when "tools/list"  then list_tools
+    when "tools/call"  then call_tool(params || {})
+    when "initialize"  then initialize_(body)
+    when "initialized" then {}
+    else
+      rpc_error!(-32601, "Unknown method #{method}")
+    end
+  end
+
+  # https://gist.github.com/ruvnet/7b6843c457822cbcf42fc4aa635eadbb
+
+  def initialize_(body)
+    body[:serverInfo] = {
+      name: 'mcp-server',
+      title: 'MCP Server',
+      version: '1.0.0'
+    }
+    # result
+    {
+      protocolVersion: PROTOCOL_VERSION,
+      capabilities: {
+        logging: {},
+        prompts: { listChanged: false },
+        resources: { listChanged: false },
+        tools: { listChanged: false }
+      }
+    }
+  end
+
+  private
+
+  def json_rpc_response(id:)
+    body = { jsonrpc: "2.0", id: id }
+
+    begin
+      result = yield(body)
+      body[:result] = result unless body[:error] || result.nil?
+    rescue JsonRpcError => e
+      body[:error] = { code: e.code, message: e.message }
+    rescue => e
+      @logger&.error("Unhandled RPC error: #{e.class}: #{e.message}\n#{e.backtrace&.first}")
+      body[:error] = { code: -32603, message: "Internal error" }
+    end
+
+    body.delete(:result) if body[:error]
+    JSON.dump(body)
+  end
+
+  def call_tool(params)
+    name      = params["name"]
+    arguments = params["arguments"] || {}
+    tool      = ToolRegistry.fetch(name) || rpc_error!(-32601, "Unknown tool #{name}")
+    tool.call(arguments)
+  end
+end

data/lib/stack-service-base/mcp_tool_registry.rb

@@ -0,0 +1,84 @@
+module ToolRegistry
+  class ExecutionContext
+    include RpcErrorHelpers
+  end
+
+  class Definition
+    attr_reader :name
+
+    def initialize(name)
+      @name = name.to_s
+      @inputs = {}
+    end
+
+    def description(text = nil)
+      return @description if text.nil?
+      @description = text
+    end
+
+    def input(fields = {})
+      @inputs.merge!(fields.transform_keys(&:to_s))
+    end
+
+    def input_schema
+      properties = {}
+      required = []
+
+      @inputs.each do |field, config|
+        cfg = config.transform_keys { |key| key.is_a?(Symbol) ? key : key.to_sym }
+        required << field if cfg.delete(:required)
+        properties[field] = cfg.transform_keys(&:to_s)
+      end
+
+      { type: "object", properties: properties, required: required }
+    end
+
+    def execute(&block) = @executor = block
+
+    def to_h
+      {
+        name: name,
+        description: description,
+        inputSchema: input_schema
+      }
+    end
+
+    def call(arguments)
+      raise JsonRpcError.new(code: 500, message: "Tool #{name} missing executor") unless @executor
+
+      ExecutionContext.new.instance_exec(symbolize_keys(arguments || {}), &@executor)
+    end
+
+    private
+
+    def symbolize_keys(hash)
+      hash.each_with_object({}) do |(key, value), memo|
+        memo[key.to_sym] = value
+      end
+    end
+  end
+
+  module_function
+
+  def define(name, &block)
+    definition = Definition.new(name)
+    definition.instance_eval(&block)
+    registry[definition.name] = definition
+  end
+
+  def registry
+    @registry ||= {}
+  end
+
+  def list
+    registry.values.map(&:to_h)
+  end
+
+  def fetch(name)
+    registry[name.to_s]
+  end
+end
+
+def Tool(name, &block)
+  ToolRegistry.define(name, &block)
+end

data/lib/stack-service-base/open_telemetry.rb

@@ -2,6 +2,7 @@ require 'async'
 
 ENV['OTEL_LOG_LEVEL'] ||= 'debug'
 ENV['OTEL_TRACES_EXPORTER'] ||= 'console,otlp'
+ENV['OTEL_LOGS_EXPORTER'] ||= 'otlp,console'
 
 unless defined? OTEL_ENABLED
   OTEL_ENABLED = !ENV['OTEL_EXPORTER_OTLP_ENDPOINT'].to_s.empty?
@@ -22,6 +23,9 @@ if OTEL_ENABLED
   require 'opentelemetry/exporter/otlp'
   require 'opentelemetry/instrumentation/all'
   require 'opentelemetry-api'
+  require 'opentelemetry-sdk'
+  require 'opentelemetry-logs-sdk'
+  require 'opentelemetry-exporter-otlp-logs'
 end
 
 if defined? Async and OTEL_ENABLED
@@ -76,9 +80,21 @@ def otel_initialize
     # c.service_name = SERVICE_NAME
   end
 
+  # Logs API
+  # ENV['OTEL_LOGS_EXPORTER'] = 'otlp,console' # Export logs to the console ,console
+  if ENV['OTEL_LOGS_EXPORTER'] =~ /console/
+    processor = OpenTelemetry::SDK::Logs::Export::SimpleLogRecordProcessor.new(OpenTelemetry::SDK::Logs::Export::ConsoleLogRecordExporter.new)
+    OpenTelemetry.logger_provider.add_log_record_processor(processor)
+  end
+
+  # Access a Logger for your library from the LoggerProvider configured by the OpenTelemetry API
+  logger = OpenTelemetry.logger_provider.logger(name: SERVICE_NAME, version: '0.1.0')
+  logger.on_emit( timestamp: Time.now, severity_text: 'INFO', body: 'Log provider initialized ', attributes: { 'ready' => true } )
+
   at_exit do
     OpenTelemetry.tracer_provider.force_flush
     OpenTelemetry.tracer_provider.shutdown
+    OpenTelemetry.logger_provider.shutdown
   end
 
   $tracer_ = OpenTelemetry.tracer_provider.tracer(SERVICE_NAME)

data/lib/stack-service-base/project_template/gitlab-c/docker/Dockerfile.build

@@ -8,7 +8,7 @@ COPY . .
 
 CMD ["bash", "-c", "-x", "\
     env && cd /build/docker && \
-    build-labels -n -c docker-compose.yml gitlab set_version to_dockerfiles to_compose | tee bake.yml && \
+    build-labels -n -c docker-compose.yml changed gitlab set_version to_dockerfiles to_compose | tee bake.yml && \
     export OTEL_RESOURCE_ATTRIBUTES=service.name=docker-builder,pipeline.id=${CI_PIPELINE_ID},project.name=${CI_PROJECT_NAME} && \
     export REGISTRY_HOST=$CI_REGISTRY_HOST && \
     grep \"services: {}\" bake.yml || docker buildx bake -f bake.yml $([ -z \"$CI_SKIP_PUSH\" ] && echo \"--push\") && \

data/lib/stack-service-base/stack_template/home/stack/stack.drs

@@ -1,5 +1,5 @@
 Options name: 'stack-name'
 
-Service :service_name,  image: 'service_name/master', ports: 8000, ingress: { host: 'service_name.*' }
+Service :service_name,  image: 'service_name/master', ports: 7000, ingress: { host: 'service_name.*' }
 
 raise 'Configure the stack (https://github.com/artyomb/dry-stack)'

data/lib/stack-service-base/version.rb

@@ -1,3 +1,3 @@
 module StackServiceBase
-  VERSION = '0.0.57'
+  VERSION = '0.0.59'
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: stack-service-base
 version: !ruby/object:Gem::Version
-  version: 0.0.57
+  version: 0.0.59
 platform: ruby
 authors:
 - Artyom B
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-14 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -94,6 +93,48 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: opentelemetry-logs-api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: opentelemetry-logs-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: opentelemetry-exporter-otlp-logs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: nats-pure
   requirement: !ruby/object:Gem::Requirement
@@ -234,8 +275,118 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.5.1
-description:
-email:
+- !ruby/object:Gem::Dependency
+  name: rspec-benchmark
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rack-test
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: async-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-snapshot
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: testcontainers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: slim
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 executables:
 - ssbase
 extensions: []
@@ -247,8 +398,11 @@ files:
 - lib/stack-service-base/command_line.rb
 - lib/stack-service-base/database.rb
 - lib/stack-service-base/debugger.rb
+- lib/stack-service-base/examples/mcp_config.ru
 - lib/stack-service-base/fiber_pool.rb
 - lib/stack-service-base/logging.rb
+- lib/stack-service-base/mcp_processor.rb
+- lib/stack-service-base/mcp_tool_registry.rb
 - lib/stack-service-base/nats_patch_1.rb
 - lib/stack-service-base/nats_service.rb
 - lib/stack-service-base/open_telemetry.rb
@@ -290,10 +444,8 @@ files:
 - lib/stack-service-base/stack_template/home/stack/stack.drs
 - lib/stack-service-base/version.rb
 - lib/stack-service-base/views/ssbase_info.slim
-homepage:
 licenses: []
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -301,15 +453,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.3.1
+      version: 3.4.4
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.9
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Common files
 test_files: []