soka-rails 0.0.1 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6730ee1778d50df9b15f89e90cae6ee7ad6e5ccad4957859ab99b328cd4d37f
-  data.tar.gz: 51d7ca5f8469231d197f74317661f02d4a9cdfa6a3ba4deb92d85928aab51bf3
+  metadata.gz: 8e5ecc6bd862b68971cd0b63fe3535e24b110844dbb93d69a6088af129b1806e
+  data.tar.gz: e7d13cca5d699e68f1224a6f3981b372abc1ac3072845aec7f10a47f31702517
 SHA512:
-  metadata.gz: 2b5b44129a5845a5d9f4054f6b8128620767092b9db3862c715d12d9383d8d76dea3f0abe0cac00b67f91806a1247970dc9870828201795ce2d7396252435da3
-  data.tar.gz: 48beed549db55eee4f4ca2d9a20dae03ec51b6de0103dc9c4a4519d5938f64be872c2ab41cee3b88766fe32cebfd32d44268f8fb9dc741c5ceee8fb0c4f47435
+  metadata.gz: 8fccb922b42ad0ecebb6aa56e85aa2adca7235b0bf8f8f706abbf426e777202674329662d6982ada09fa15ed5c4962ee354e33f0ffaed26c24063305b09f1109
+  data.tar.gz: 7a626cb54ba4272cb95cdaa895098fc99f3c14f3873a26f3ae5c8c41e705b9ffb56c22ac24f34874715b8f84920a023864ce54f8c02471e5dd0b8cdd892b7f80

data/CHANGELOG.md

@@ -5,6 +5,20 @@ 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.3] - 2025-08-04
+
+### Added
+- Upgrade to Soka v0.0.3 with custom instructions and multilingual support
+
+## [0.0.2] - 2025-08-01
+
+### Fixed
+- Comment out private keyword in agent template
+- Resolve Rails autoloading issues for agents and tools
+
+### Changed
+- Add link to full changelog in release notes
+
 ## [0.0.1] - 2025-08-01
 
 ### Added

data/DESIGN.md

@@ -478,7 +478,6 @@ module Soka
       def mock_ai_response(response_attrs = {})
         default_response = {
           final_answer: "Mocked answer",
-          confidence_score: 0.95,
           status: :completed,
           iterations: 1,
           thought_process: []
@@ -616,7 +615,6 @@ class ConversationsController < ApplicationController
   def build_response(result)
     {
       answer: result.final_answer,
-      confidence: result.confidence_score,
       status: result.status,
       metadata: {
         iterations: result.iterations,
@@ -652,7 +650,6 @@ class ProcessConversationJob < ApplicationJob
     user.conversations.create!(
       message: message,
       response: result.final_answer,
-      confidence: result.confidence_score,
       metadata: {
         iterations: result.iterations,
         thought_process: result.thought_process

data/README.md

@@ -26,6 +26,8 @@ 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+)
 
 ## Installation
 
@@ -91,7 +93,7 @@ class ConversationsController < ApplicationController
 
     render json: {
       answer: result.final_answer,
-      confidence: result.confidence_score
+      status: result.status
     }
   end
 end
@@ -243,6 +245,12 @@ class WeatherAgent < ApplicationAgent
   tool TemperatureTool
   tool HumidityTool
 
+  # Custom instructions
+  # instructions "You are a weather expert. Always provide temperature in both Celsius and Fahrenheit."
+
+  # Multilingual thinking
+  # think_in 'en'  # Supported: 'en', 'zh-TW', 'ja-JP', etc.
+
   # Configuration
   # max_iterations 10
   # timeout 30

data/SPEC.md

@@ -291,7 +291,6 @@ class ConversationsController < ApplicationController
     
     render json: {
       answer: result.final_answer,
-      confidence: result.confidence_score,
       status: result.status
     }
   end

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

@@ -10,6 +10,12 @@ class <%= @agent_class_name %> < ApplicationAgent
   # tool YourTool
 <% end -%>
 
+  # Custom instructions (new in v0.0.3)
+  # instructions "You are a helpful assistant specialized in..."
+
+  # Multilingual thinking (new in v0.0.3)
+  # think_in 'en'  # 'en', 'zh-TW', 'ja-JP', etc.
+
   # Configuration
   # max_iterations 10
   # timeout 30
@@ -19,7 +25,7 @@ class <%= @agent_class_name %> < ApplicationAgent
   # after_action :your_method
   # on_error :your_method
 
-  private
+  # private
 
   # Implement your private methods here
 end

data/lib/generators/soka/tool/templates/tool_spec.rb.tt

@@ -15,14 +15,14 @@ RSpec.describe <%= @tool_class_name %>Tool, type: :tool do
       }
     end
 
-    it 'executes successfully with valid params' do
+    it 'calls successfully with valid params' do
       result = tool.call(**params)
 
       expect(result).to be_a(Hash)
       expect(result[:result]).to be_present
     end
 <% else -%>
-    it 'executes successfully' do
+    it 'calls successfully' do
       result = tool.call
 
       expect(result).to be_a(Hash)

data/lib/soka/rails/railtie.rb

@@ -1,14 +1,65 @@
 # frozen_string_literal: true
 
+require 'soka'
+
 module Soka
   module Rails
     # Rails integration for Soka, configuring autoloading and initializers
+    #
+    # This Railtie ensures that Soka agents and tools can be autoloaded
+    # properly by Rails' Zeitwerk autoloader. It sets up app/soka as a
+    # root directory and collapses subdirectories to avoid namespace requirements.
+    #
+    # @example Directory structure
+    #   app/soka/
+    #   ├── agents/
+    #   │   ├── application_agent.rb  # Defines ApplicationAgent (not Agents::ApplicationAgent)
+    #   │   └── search_agent.rb       # Defines SearchAgent (not Agents::SearchAgent)
+    #   └── tools/
+    #       ├── application_tool.rb   # Defines ApplicationTool (not Tools::ApplicationTool)
+    #       └── search_tool.rb        # Defines SearchTool (not Tools::SearchTool)
     class Railtie < ::Rails::Railtie
-      # Configure autoloading - executed after Rails completes basic setup
-      initializer 'soka.setup_autoloading', before: :set_autoload_paths do |app|
-        # Add app/soka to autoload paths
-        # eager_load: true will automatically include all subdirectories
-        app.config.paths.add 'app/soka', eager_load: true
+      # Configuration for collapsed directories
+      # Users can modify this in an initializer if needed
+      config.soka_collapsed_dirs = %w[agents tools]
+
+      # Set up Zeitwerk autoloading for Soka directories
+      #
+      # This initializer runs after Rails sets up its autoloaders but before
+      # eager loading begins. It configures app/soka as a root directory
+      # and collapses specified subdirectories.
+      initializer 'soka.setup_autoloading',
+                  after: :setup_once_autoloader,
+                  before: :eager_load! do |app|
+        setup_soka_autoloading(app)
+      end
+
+      private
+
+      def setup_soka_autoloading(app)
+        soka_path = app.root.join('app/soka')
+        return unless soka_path.exist?
+
+        configure_autoloader(soka_path)
+      rescue StandardError => e
+        ::Rails.logger&.error "[Soka] Failed to configure autoloading: #{e.message}"
+        raise
+      end
+
+      def configure_autoloader(soka_path)
+        # Add app/soka as a root directory without namespace
+        # This allows classes in app/soka to be loaded at the top level
+        ::Rails.autoloaders.main.push_dir(soka_path.to_s)
+
+        # Collapse configured directories
+        # This removes the directory name from the expected constant path
+        # e.g., app/soka/agents/foo.rb defines Foo instead of Agents::Foo
+        config.soka_collapsed_dirs.each do |dir|
+          dir_path = soka_path.join(dir)
+          ::Rails.autoloaders.main.collapse(dir_path.to_s) if dir_path.exist?
+        end
+
+        ::Rails.logger&.debug "[Soka] Configured autoloading for #{soka_path}"
       end
     end
   end

data/lib/soka/rails/test_helpers.rb

@@ -19,7 +19,6 @@ module Soka
       def build_mock_response(attrs)
         default_response = {
           final_answer: 'Mocked answer',
-          confidence_score: 0.95,
           status: :completed,
           iterations: 1,
           thought_process: []
@@ -95,7 +94,6 @@ module Soka
         default_attrs = {
           status: :completed,
           final_answer: 'Success',
-          confidence_score: 0.95,
           iterations: 1
         }
 

data/lib/soka/rails/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: soka-rails
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.3
 platform: ruby
 authors:
 - jiunjiun
@@ -35,14 +35,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.1
+        version: 0.0.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.1
+        version: 0.0.3
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement