tsikol 0.1.0

data/examples/sampling_example.rb

@@ -0,0 +1,104 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/tsikol'
+
+Tsikol.server "ai-assistant" do
+  # Enable and configure sampling
+  on_sampling do |request|
+    # This handler is called when the server needs AI assistance
+    # In a real implementation, this would be handled by the MCP client
+    # For demo purposes, we'll simulate a response
+    
+    messages = request[:messages]
+    system_prompt = request[:system_prompt]
+    max_tokens = request[:max_tokens] || 100
+    
+    log :info, "Sampling request received", data: {
+      message_count: messages.size,
+      system_prompt: system_prompt,
+      max_tokens: max_tokens
+    }
+    
+    # In real usage, the MCP client (like Claude Code) would:
+    # 1. Show the request to the user for approval
+    # 2. Send to the AI model
+    # 3. Return the response
+    
+    # For demo, return a simulated response
+    {
+      role: "assistant",
+      content: {
+        type: "text",
+        text: "This is a simulated AI response. In production, the MCP client would handle this request and return actual AI-generated content."
+      }
+    }
+  end
+  
+  # Tool that uses sampling to enhance its functionality
+  tool "enhance_text" do |text:, style: "professional"|
+    log :info, "Enhancing text with style: #{style}"
+    
+    # Request AI assistance via sampling
+    begin
+      # In a real implementation, the server would send a sampling request
+      # to the client, which would then use an AI model
+      
+      # For now, we'll just demonstrate the structure
+      enhanced = case style
+      when "professional"
+        "#{text} (enhanced professionally)"
+      when "casual"
+        "#{text} (made more casual)"
+      when "technical"
+        "#{text} (with technical details)"
+      else
+        text
+      end
+      
+      "Enhanced: #{enhanced}"
+    rescue => e
+      log :error, "Enhancement failed", data: { error: e.message }
+      "Error enhancing text: #{e.message}"
+    end
+  end
+  
+  # Tool that generates content using sampling
+  tool "generate_content" do |topic:, length: "short"|
+    log :info, "Generating content about: #{topic}"
+    
+    # This would trigger a sampling request in a real implementation
+    content_length = case length
+    when "short"
+      "Brief content about #{topic}."
+    when "medium"
+      "Detailed explanation about #{topic} with examples and context."
+    when "long"
+      "Comprehensive analysis of #{topic} including background, current state, and future implications."
+    else
+      "Content about #{topic}."
+    end
+    
+    content_length
+  end
+  
+  # Resource that provides sampling configuration info
+  resource "sampling/config" do
+    {
+      enabled: true,
+      models_supported: ["claude-3-sonnet", "claude-3-opus"],
+      max_tokens_limit: 4096,
+      features: [
+        "Content generation",
+        "Text enhancement",
+        "Code generation",
+        "Analysis and reasoning"
+      ]
+    }.to_json
+  end
+  
+  # Prompt that can be enhanced with sampling
+  prompt "brainstorm" do |topic:, approach: "creative"|
+    "Help me brainstorm ideas about #{topic} using a #{approach} approach. Generate diverse and innovative suggestions."
+  end
+end

data/examples/weather-service/app/prompts/weather/chat.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Weather
+  class Chat < Tsikol::Prompt
+    name "weather-chat"
+    description "Interactive weather information assistant"
+    
+    argument :topic do
+      type :string
+      required
+      description "Weather topic to discuss"
+      
+      complete do |partial|
+        topics = [
+          "current conditions",
+          "forecast",
+          "climate trends", 
+          "severe weather",
+          "travel planning",
+          "outdoor activities",
+          "seasonal patterns",
+          "weather safety"
+        ]
+        topics.select { |topic| topic.downcase.include?(partial.downcase) }
+      end
+    end
+    
+    argument :location do
+      type :string
+      optional
+      description "Specific location for weather discussion"
+      
+      complete do |partial|
+        cities = [
+          "New York", "London", "Tokyo", "Paris", "Berlin",
+          "Sydney", "Toronto", "Mumbai", "Beijing", "Moscow"
+        ]
+        cities.select { |city| city.downcase.start_with?(partial.downcase) }
+      end
+    end
+    
+    def get_messages(topic:, location: nil)
+      base_prompt = case topic
+      when "current conditions"
+        "You are a weather assistant. Help me understand the current weather conditions#{location ? " in #{location}" : ""}."
+      when "forecast"
+        "You are a weather forecasting expert. Provide detailed forecast information#{location ? " for #{location}" : ""}."
+      when "climate trends"
+        "You are a climate scientist. Discuss recent climate trends and patterns#{location ? " affecting #{location}" : ""}."
+      when "severe weather"
+        "You are a severe weather specialist. Explain severe weather risks and safety#{location ? " for #{location}" : ""}."
+      when "travel planning"
+        "You are a travel weather advisor. Help plan travel considering weather conditions#{location ? " for #{location}" : ""}."
+      when "outdoor activities"
+        "You are an outdoor activity weather consultant. Advise on weather for outdoor activities#{location ? " in #{location}" : ""}."
+      when "seasonal patterns"
+        "You are a seasonal weather expert. Explain seasonal weather patterns#{location ? " for #{location}" : ""}."
+      when "weather safety"
+        "You are a weather safety expert. Provide weather safety tips and guidelines#{location ? " for #{location}" : ""}."
+      else
+        "You are a knowledgeable weather assistant. Help me understand #{topic}#{location ? " for #{location}" : ""}."
+      end
+      
+      [
+        {
+          role: "system",
+          content: {
+            type: "text",
+            text: base_prompt + " Provide accurate, helpful information based on typical weather patterns and safety guidelines."
+          }
+        },
+        {
+          role: "user", 
+          content: {
+            type: "text",
+            text: "I'd like to know about #{topic}#{location ? " in #{location}" : ""}. What can you tell me?"
+          }
+        }
+      ]
+    end
+    
+    def set_server(server)
+      @server = server
+      
+      define_singleton_method(:log) do |level, message, data: nil, logger: nil|
+        @server.log(level, message, data: data, logger: logger)
+      end
+    end
+  end
+end

data/examples/weather-service/app/resources/weather/alerts.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Weather
+  class Alerts < Tsikol::Resource
+    uri "weather/alerts"
+    description "Active weather alerts and warnings"
+    
+    def read
+      # Mock weather alerts data
+      alerts = [
+        {
+          type: "Severe Thunderstorm Warning",
+          location: "New York",
+          severity: "moderate",
+          expires: (Time.now + 3600).strftime("%Y-%m-%d %H:%M"),
+          description: "Severe thunderstorms capable of producing damaging winds and large hail"
+        },
+        {
+          type: "Heat Advisory",
+          location: "Phoenix",
+          severity: "minor",
+          expires: (Time.now + 7200).strftime("%Y-%m-%d %H:%M"),
+          description: "Temperatures expected to reach 110°F. Stay hydrated and avoid prolonged outdoor exposure"
+        },
+        {
+          type: "Winter Storm Watch",
+          location: "Chicago",
+          severity: "major",
+          expires: (Time.now + 10800).strftime("%Y-%m-%d %H:%M"),
+          description: "Heavy snow accumulation of 8-12 inches expected. Travel will be dangerous"
+        }
+      ]
+      
+      if alerts.empty?
+        "No active weather alerts at this time."
+      else
+        output = ["Active Weather Alerts:", ""]
+        
+        alerts.each_with_index do |alert, i|
+          output << "#{i + 1}. #{alert[:type]} - #{alert[:location]}"
+          output << "   Severity: #{alert[:severity].capitalize}"
+          output << "   Expires: #{alert[:expires]}"
+          output << "   #{alert[:description]}"
+          output << ""
+        end
+        
+        output.join("\n").strip
+      end
+    end
+    
+    def set_server(server)
+      @server = server
+      
+      define_singleton_method(:log) do |level, message, data: nil, logger: nil|
+        @server.log(level, message, data: data, logger: logger)
+      end
+    end
+  end
+end

data/examples/weather-service/app/tools/weather/get_current.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Weather
+  class GetCurrent < Tsikol::Tool
+    description "Get current weather for a location"
+    
+    parameter :location do
+      type :string
+      required
+      description "City name or coordinates"
+      
+      complete do |partial|
+        cities = [
+          "New York", "London", "Tokyo", "Paris", "Berlin",
+          "Sydney", "Toronto", "Mumbai", "Beijing", "Moscow",
+          "Los Angeles", "Chicago", "Houston", "Phoenix", "Philadelphia"
+        ]
+        cities.select { |city| city.downcase.start_with?(partial.downcase) }
+      end
+    end
+    
+    parameter :units do
+      type :string
+      optional
+      default "fahrenheit"
+      enum ["fahrenheit", "celsius", "kelvin"]
+      description "Temperature units"
+    end
+    
+    def initialize
+      @server = nil # Will be set by framework
+    end
+    
+    def execute(location:, units: "fahrenheit")
+      # Log using server's log method if available
+      log :info, "Getting weather for #{location}" if respond_to?(:log)
+      
+      # Mock temperature data
+      temps = { 
+        "New York" => 72, 
+        "London" => 61, 
+        "Tokyo" => 77,
+        "Paris" => 64,
+        "Berlin" => 59
+      }
+      
+      temp = temps[location] || 70
+      
+      if temps[location]
+        log :debug, "Found temperature in cache", data: { location: location, temp: temp } if respond_to?(:log)
+      else
+        log :warning, "Location not found, using default", data: { location: location } if respond_to?(:log)
+      end
+      
+      converted_temp = convert_temperature(temp, units)
+      "Currently #{converted_temp}° #{units} in #{location}"
+    end
+    
+    private
+    
+    def convert_temperature(fahrenheit, to_units)
+      case to_units
+      when "celsius"
+        ((fahrenheit - 32) * 5.0 / 9.0).round(1)
+      when "kelvin"
+        ((fahrenheit - 32) * 5.0 / 9.0 + 273.15).round(1)
+      else
+        fahrenheit
+      end
+    end
+    
+    # Allow server to inject log method
+    def set_server(server)
+      @server = server
+      
+      # Define log method that delegates to server
+      define_singleton_method(:log) do |level, message, data: nil, logger: nil|
+        @server.log(level, message, data: data, logger: logger)
+      end
+    end
+  end
+end

data/examples/weather-service/app/tools/weather/get_forecast.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require 'date'
+
+module Weather
+  class GetForecast < Tsikol::Tool
+    description "Get weather forecast for a location"
+    
+    parameter :location do
+      type :string
+      required
+      description "City name or coordinates"
+      
+      complete do |partial|
+        cities = [
+          "New York", "London", "Tokyo", "Paris", "Berlin",
+          "Sydney", "Toronto", "Mumbai", "Beijing", "Moscow"
+        ]
+        cities.select { |city| city.downcase.start_with?(partial.downcase) }
+      end
+    end
+    
+    parameter :days do
+      type :integer
+      optional
+      default 5
+      description "Number of days to forecast (1-10)"
+    end
+    
+    parameter :units do
+      type :string
+      optional
+      default "fahrenheit"
+      enum ["fahrenheit", "celsius", "kelvin"]
+      description "Temperature units"
+    end
+    
+    def execute(location:, days: 5, units: "fahrenheit")
+      log :info, "Getting #{days}-day forecast for #{location}" if respond_to?(:log)
+      
+      # Validate days
+      days = [[days, 1].max, 10].min
+      
+      # Mock forecast data
+      base_temps = {
+        "New York" => 72,
+        "London" => 61,
+        "Tokyo" => 77,
+        "Paris" => 64,
+        "Berlin" => 59
+      }
+      
+      base_temp = base_temps[location] || 70
+      forecast = []
+      
+      days.times do |i|
+        # Add some variation
+        temp_variation = rand(-10..10)
+        temp = base_temp + temp_variation
+        converted_temp = convert_temperature(temp, units)
+        
+        date = (Date.today + i + 1).strftime("%A, %B %d")
+        forecast << "#{date}: #{converted_temp}° #{units}"
+      end
+      
+      "#{days}-day forecast for #{location}:\n#{forecast.join("\n")}"
+    end
+    
+    private
+    
+    def convert_temperature(fahrenheit, to_units)
+      case to_units
+      when "celsius"
+        ((fahrenheit - 32) * 5.0 / 9.0).round(1)
+      when "kelvin"
+        ((fahrenheit - 32) * 5.0 / 9.0 + 273.15).round(1)
+      else
+        fahrenheit
+      end
+    end
+    
+    def set_server(server)
+      @server = server
+      
+      define_singleton_method(:log) do |level, message, data: nil, logger: nil|
+        @server.log(level, message, data: data, logger: logger)
+      end
+    end
+  end
+end

data/examples/weather-service/server.rb

@@ -0,0 +1,28 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../../lib/tsikol'
+
+# Require all components
+require_relative 'app/tools/weather/get_current'
+require_relative 'app/tools/weather/get_forecast'
+require_relative 'app/resources/weather/alerts'
+require_relative 'app/prompts/weather/chat'
+
+# Start the weather service with inline routes
+Tsikol.start(name: "weather-service") do
+  # Register components
+  tool Weather::GetCurrent
+  tool Weather::GetForecast
+  resource Weather::Alerts
+  prompt Weather::Chat
+  
+  # Enable capabilities
+  logging true
+  completion true
+  
+  # Simple inline resource
+  resource "server/health" do
+    "Weather service is healthy"
+  end
+end

data/exe/tsikol

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "tsikol/cli"
+
+Tsikol::CLI.start(ARGV)

data/lib/tsikol/cli/templates/Gemfile.erb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gem "tsikol"
+
+group :development, :test do
+  gem "minitest", "~> 5.0"
+  gem "rake", "~> 13.0"
+end

data/lib/tsikol/cli/templates/README.md.erb

@@ -0,0 +1,38 @@
+# <%= @project_name.split(/[-_]/).map(&:capitalize).join(' ') %>
+
+A Model Context Protocol (MCP) server built with Tsikol.
+
+## Installation
+
+```bash
+bundle install
+```
+
+## Usage
+
+Start the server:
+
+```bash
+./server.rb
+```
+
+## Development
+
+Generate new components:
+
+```bash
+# Generate a new tool
+tsikol generate tool my_tool param1:string param2:integer
+
+# Generate a new resource
+tsikol generate resource my_resource
+
+# Generate a new prompt
+tsikol generate prompt my_prompt topic:string
+```
+
+## Testing
+
+```bash
+bundle exec rake test
+```

data/lib/tsikol/cli/templates/gitignore.erb

@@ -0,0 +1,49 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+# Ignore Byebug command history file.
+.byebug_history
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# MCP specific
+/audit.log
+/server_audit.log
+/tsikol-debug.log
+
+# IDE files
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.DS_Store

data/lib/tsikol/cli/templates/prompt.rb.erb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+class <%= @class_name %> < Tsikol::Prompt
+  name "<%= @prompt_name %>"
+  description "TODO: Add description for <%= @prompt_name %>"
+  
+<% @arguments.each do |arg| -%>
+  argument :<%= arg[:name] %> do
+    type :<%= arg[:type] %>
+<% if arg[:required] -%>
+    required
+<% else -%>
+    optional
+<% end -%>
+    description "TODO: Add description for <%= arg[:name] %>"
+<% if arg[:type] == 'string' -%>
+    
+    # Add completion for better UX
+    # complete do |partial|
+    #   # Return array of possible values
+    #   suggestions = ["suggestion1", "suggestion2", "suggestion3"]
+    #   suggestions.select { |s| s.downcase.include?(partial.downcase) }
+    # end
+<% end -%>
+  end
+  
+<% end -%>
+  def get_messages(<%= @arguments.map { |a| "#{a[:name]}:#{a[:required] ? '' : ' nil'}" }.join(', ') %>)
+    # TODO: Implement <%= @prompt_name %> logic
+    log :info, "Getting messages for <%= @prompt_name %>" if respond_to?(:log)
+    
+    [
+      {
+        role: "user",
+        content: {
+          type: "text",
+          text: "TODO: Generate prompt based on arguments"
+        }
+      }
+    ]
+  end
+  
+  private
+  
+  def set_server(server)
+    @server = server
+    
+    # Enable logging
+    define_singleton_method(:log) do |level, message, data: nil, logger: nil|
+      @server.log(level, message, data: data, logger: logger)
+    end
+  end
+end

data/lib/tsikol/cli/templates/resource.rb.erb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+class <%= @class_name %> < Tsikol::Resource
+  uri "<%= @uri %>"
+  description "TODO: Add description for <%= @resource_name %>"
+  
+  def read
+    # TODO: Implement <%= @resource_name %> logic
+    log :info, "Reading <%= @resource_name %>" if respond_to?(:log)
+    
+    # Return the resource content
+    {
+      # Add your data here
+      example: "data",
+      timestamp: Time.now.iso8601
+    }.to_json
+  end
+  
+  private
+  
+  def set_server(server)
+    @server = server
+    
+    # Enable logging
+    define_singleton_method(:log) do |level, message, data: nil, logger: nil|
+      @server.log(level, message, data: data, logger: logger)
+    end
+  end
+end

data/lib/tsikol/cli/templates/server.rb.erb

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "tsikol"
+
+# Start <%= @project_name %> MCP server
+Tsikol.start(name: "<%= @project_name %>") do
+  # Components will be added here by the CLI
+  
+  # Example inline resource
+  resource "health" do
+    "Server is healthy"
+  end
+  
+  # Enable capabilities as needed
+  # logging true
+  # completion true
+  # sampling true
+  
+  # Add middleware as needed
+  # use Tsikol::LoggingMiddleware
+  # use Tsikol::RateLimitMiddleware, max_requests: 100, window: 60
+end