stack-service-base 0.0.56 → 0.0.58

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93e0600204518262fd868f9aa5c6a8faa1abeab9fd3154499e5d213960ad198e
-  data.tar.gz: e34002d076c4158809b17bf77974de41a41bb9c6ee126ce3dc7650dd736784e6
+  metadata.gz: f07b63778720acb4d2629f0cd7fd0cb9042194f9e8cf4b8c36fd766555a3e7ef
+  data.tar.gz: b44692326f9a69a994ab2915dccbbf714bc1500d9d02b5f2acc4c717d642e8a9
 SHA512:
-  metadata.gz: 498f96e043f0bc5f385bacd38f758b99c2ff7050f6ad6b4d706da5cbd9ae91725254a3835a39428af537f01eae4fe351e36930b5e9c801dc3a558d344141daf5
-  data.tar.gz: ac5043941ccc4f20ac9bbebb0124c14417efb69117c5a78aa9ac69e9c1e1c05656bf170830b11959374bfc4a6154ae85bc28d7f77d8cbcf06aa9c061c82ad7bd
+  metadata.gz: dbe54cb277386c5ef81d3c5746ccb4c2f8931d7d83145f6184e4bd461cdaff7e320b2ede10dd79eed87aba917917a569b9419813aed167f9e39f8464772f301c
+  data.tar.gz: 0fb8592aeb9801157144a4e25fa27a78179722c28493ffe350694e3a705f1d8bd309a4326ca03a695f70fbe9bdff7a3bfa17603272cd5f94fcd6249192cfaa96

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,94 @@
+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
+  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) { handle(method: method, params: params) }
+  end
+
+  def handle(method:, params:)
+    case method
+    when "tools/list" then list_tools
+    when "tools/call" then call_tool(params || {})
+    else
+      rpc_error!(-32601, "Unknown method #{method}")
+    end
+  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?
@@ -14,13 +15,17 @@ $stdout.puts "OTEL_ENABLED: #{OTEL_ENABLED}"
 if OTEL_ENABLED
   STACK_NAME = ENV['STACK_NAME'] || 'undefined_stack'
   SERVICE_NAME = ENV['STACK_SERVICE_NAME'] || 'undefined_service'
-  ENV['OTEL_RESOURCE_ATTRIBUTES'] ||= "deployment.environment=#{STACK_NAME},service.name=#{SERVICE_NAME}"
+  HOSTNAME=ENV['HOSTNAME'] || 'undefined'
+  ENV['OTEL_RESOURCE_ATTRIBUTES'] ||= "deployment.environment=#{STACK_NAME},service.name=#{SERVICE_NAME},hostname=#{HOSTNAME}"
   ENV.select{ |k,v| k =~ /OTEL/}.each { |k,v| $stdout.puts "#{k}: #{v}"}
 
   require 'opentelemetry/sdk'
   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
@@ -75,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/version.rb

@@ -1,3 +1,3 @@
 module StackServiceBase
-  VERSION = '0.0.56'
+  VERSION = '0.0.58'
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: stack-service-base
 version: !ruby/object:Gem::Version
-  version: 0.0.56
+  version: 0.0.58
 platform: ruby
 authors:
 - Artyom B
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-08 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: []