soka-rails 0.0.3 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8e5ecc6bd862b68971cd0b63fe3535e24b110844dbb93d69a6088af129b1806e
-  data.tar.gz: e7d13cca5d699e68f1224a6f3981b372abc1ac3072845aec7f10a47f31702517
+  metadata.gz: 727e9c42b3117990a0eb0237b5a12e9db9eafe6ad5cb3b2e6992a5de89920153
+  data.tar.gz: 48072884855827edbad3bba576d324d6d79dd888ba347d8b67af5977341acbdc
 SHA512:
-  metadata.gz: 8fccb922b42ad0ecebb6aa56e85aa2adca7235b0bf8f8f706abbf426e777202674329662d6982ada09fa15ed5c4962ee354e33f0ffaed26c24063305b09f1109
-  data.tar.gz: 7a626cb54ba4272cb95cdaa895098fc99f3c14f3873a26f3ae5c8c41e705b9ffb56c22ac24f34874715b8f84920a023864ce54f8c02471e5dd0b8cdd892b7f80
+  metadata.gz: 32e97666a15b7e655a9a208c439b55c287a8701fac1a03282553aa0b14d4d81a28e7f564509069cce9d5142affeae1fa13dcf836699a80e4bd8bc455d1e220bb
+  data.tar.gz: 31d91665ae6af181d9db5a33cecb18de6561f31d259095a89d10ba01e23d0aa87346094d58d4b47fbebc6ec5539200e1e26e323fa92eb3835c552abd613a0070

data/.rubocop.yml

@@ -10,7 +10,7 @@ plugins:
   - rubocop-rspec
 
 AllCops:
-  TargetRubyVersion: 3.4
+  TargetRubyVersion: 3.1
   SuggestExtensions: false
   NewCops: enable
 

data/CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.5] - 2025-08-05
+
+### Added
+- Support for Ruby 3.1, 3.2, and 3.3
+
+### Changed
+- Updated CI/CD workflows to test all supported Ruby versions
+- Adjusted RuboCop target version to minimum supported version (3.1)
+- Updated gemspec minimum Ruby version requirement
+- Upgraded soka dependency to 0.0.5
+
+## [0.0.4] - 2025-08-04
+
+### Added
+- Support for dynamic instructions in Soka v0.0.4
+- Ability to generate agent instructions dynamically via methods
+- Context-aware behavior based on runtime conditions (environment, time, user, etc.)
+- Updated README with dynamic instructions examples
+- Enhanced agent generator template with dynamic instructions examples
+
 ## [0.0.3] - 2025-08-04
 
 ### Added

data/README.md

@@ -26,8 +26,9 @@ Soka Rails is a Rails integration package for the Soka AI Agent Framework, provi
 - 🔄 **Rails Lifecycle Hooks**: Integrates with Rails logging and error tracking
 - 💾 **Session Memory Support**: Store conversation history in Rails sessions
 - 🔐 **Authentication Integration**: Works with Rails authentication systems
-- 🗣️ **Custom Instructions**: Customize agent personality and behavior (Soka v0.0.3+)
-- 🌐 **Multilingual Thinking**: Support for reasoning in different languages (Soka v0.0.3+)
+- 🗣️ **Custom Instructions**: Customize agent personality and behavior
+- 🎯 **Dynamic Instructions**: Generate instructions dynamically via methods
+- 🌐 **Multilingual Thinking**: Support for reasoning in different languages
 
 ## Installation
 
@@ -132,6 +133,15 @@ class WeatherAgent < ApplicationAgent
   tool WeatherApiTool
   tool LocationTool
 
+  # Custom instructions
+  # instructions "You are a helpful weather assistant"
+
+  # Dynamic instructions via method
+  # instructions :generate_instructions
+
+  # Multilingual thinking
+  # think_in 'zh-TW'  # Think in Traditional Chinese
+
   # Rails integration hooks
   before_action :log_request
   on_error :notify_error_service
@@ -146,6 +156,15 @@ class WeatherAgent < ApplicationAgent
     Rails.error.report(error, context: context)
     :continue
   end
+
+  # Example of dynamic instructions method
+  # def generate_instructions
+  #   <<~PROMPT
+  #     You are a weather assistant for #{Rails.env} environment.
+  #     Current time: #{Time.zone.now}
+  #     User location: #{request&.location&.city || 'Unknown'}
+  #   PROMPT
+  # end
 end
 ```
 
@@ -196,6 +215,59 @@ class ConversationsController < ApplicationController
 end
 ```
 
+### Custom Instructions and Dynamic Instructions
+
+```ruby
+class CustomerSupportAgent < ApplicationAgent
+  # Static instructions
+  instructions <<~PROMPT
+    You are a friendly customer support agent.
+    Always be polite and helpful.
+    Use emojis when appropriate.
+  PROMPT
+
+  # OR Dynamic instructions via method
+  instructions :generate_context_aware_instructions
+
+  private
+
+  def generate_context_aware_instructions
+    business_hours = (9..17).include?(Time.zone.now.hour)
+
+    <<~PROMPT
+      You are a customer support agent for #{Rails.application.class.module_parent_name}.
+      Environment: #{Rails.env}
+      Current time: #{Time.zone.now.strftime('%Y-%m-%d %H:%M:%S %Z')}
+      Business hours: #{business_hours ? 'Yes' : 'No (after hours)'}
+      #{business_hours ? 'Provide immediate assistance.' : 'Inform about callback options.'}
+    PROMPT
+  end
+end
+```
+
+### Multilingual Thinking
+
+```ruby
+class GlobalSupportAgent < ApplicationAgent
+  # Set default thinking language
+  think_in 'zh-TW'  # Think in Traditional Chinese
+
+  # Or set dynamically at runtime
+  def initialize(options = {})
+    super
+    # Detect user's preferred language from session or request
+    self.think_in = detect_user_language
+  end
+
+  private
+
+  def detect_user_language
+    # Logic to detect language from session, user preferences, or request headers
+    session[:locale] || I18n.locale || 'en'
+  end
+end
+```
+
 ### Event Streaming
 
 ```ruby
@@ -248,6 +320,9 @@ class WeatherAgent < ApplicationAgent
   # Custom instructions
   # instructions "You are a weather expert. Always provide temperature in both Celsius and Fahrenheit."
 
+  # Dynamic instructions via method
+  # instructions :generate_instructions
+
   # Multilingual thinking
   # think_in 'en'  # Supported: 'en', 'zh-TW', 'ja-JP', etc.
 
@@ -397,7 +472,7 @@ end
 
 - Ruby: >= 3.4
 - Rails: >= 7.0
-- Soka: >= 1.0
+- Soka: >= 0.0.4
 
 ## Contributing
 

data/lib/generators/soka/agent/templates/agent.rb.tt

@@ -10,10 +10,13 @@ class <%= @agent_class_name %> < ApplicationAgent
   # tool YourTool
 <% end -%>
 
-  # Custom instructions (new in v0.0.3)
+  # Custom instructions
   # instructions "You are a helpful assistant specialized in..."
 
-  # Multilingual thinking (new in v0.0.3)
+  # Dynamic instructions via method
+  # instructions :generate_instructions  # Reference a method for dynamic instructions
+
+  # Multilingual thinking
   # think_in 'en'  # 'en', 'zh-TW', 'ja-JP', etc.
 
   # Configuration
@@ -28,4 +31,13 @@ class <%= @agent_class_name %> < ApplicationAgent
   # private
 
   # Implement your private methods here
+
+  # Example of dynamic instructions method
+  # def generate_instructions
+  #   <<~PROMPT
+  #     You are a #{Rails.env} environment assistant.
+  #     Current Time: #{Time.zone.now.strftime('%Y-%m-%d %H:%M:%S')}
+  #     User: #{current_user&.name || 'Guest'}
+  #   PROMPT
+  # end
 end

data/lib/soka/rails/version.rb

@@ -2,6 +2,6 @@
 
 module Soka
   module Rails
-    VERSION = '0.0.3'
+    VERSION = '0.0.5'
   end
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: soka-rails
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.5
 platform: ruby
 authors:
 - jiunjiun
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -35,14 +36,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.3
+        version: 0.0.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.3
+        version: 0.0.5
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -104,6 +105,7 @@ metadata:
   source_code_uri: https://github.com/jiunjiun/soka-rails
   changelog_uri: https://github.com/jiunjiun/soka-rails/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -111,14 +113,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.4'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.3.27
+signing_key:
 specification_version: 4
 summary: Rails integration for Soka AI Agent Framework
 test_files: []