ox-ai-workers 0.5.1 → 0.5.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b3d80806db64371193199ae3e0731060a156fd08398628e68fdd0bae2fa459c
-  data.tar.gz: bd70e01c89c093a85b2f32cf62b6de0826fff868378721e4203bfbc732998a63
+  metadata.gz: b83e9d2c4e62f4e457a1cb4cf041da04bb0af0abb324bc6138ffa528b39a9a0b
+  data.tar.gz: fc6ee779728aebe0507d58a576968f5f8f4c1c57da8863d95d78420fe7616ff8
 SHA512:
-  metadata.gz: 796005900f27745768ec4cb9467937aaad3cb2dd2cad6d76e8ae3fa1a0da29a32c596de8456d491b3c7fadfc2db9324369befbf120ceddfc1224bbb53cdba05b
-  data.tar.gz: 8d1fcf58fbaf734dab49276bec6fdd6f8aabddbe187c0a97495fe1ca767e5dfcdd09eb56069bfc3574712941fe3e7d77a1b2420ca7b294ef2a701b4d7deb1e5b
+  metadata.gz: 5a6395486f158fb8a8f1ed302e2fe17484a551426a050448f0112fb851457afcb0c3a11523ec1a6d70f4bf02c2b7b884744d0926b16d2ce4cd53a0b6e74f576f
+  data.tar.gz: cb6532ed38d70d74a5c50526324b00e33514d524ac222921015fc3695c83952b3a219603c5b27890089f71f26f33a65ed0498e2c740fb2357e6abb5701bb0ac4

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 ## [Unreleased]
 
+## [0.5.3] - 2024-07-31
+
+- Fixed summarize state
+
+## [0.5.2] - 2024-07-31
+
+- Added new assistant: `Localizer`
+- Added logger
+
 ## [0.5.1] - 2024-07-30
 
 - Improved FileSystem functionality
@@ -27,10 +36,10 @@
 
 ## [0.3.0] - 2024-07-30
 
-- on_inner_monologue: ->(text:) { puts Rainbow("monologue: #{text}").yellow }
-- on_outer_voice: ->(text:) { puts Rainbow("voice: #{text}").green }
-- on_action_request: ->(text:) { puts Rainbow("action: #{text}").red }
-- on_pack_history: ->(text:) { puts Rainbow("summary: #{text}").blue }
+- on_inner_monologue: ->(text:) { puts "monologue: #{text}" }
+- on_outer_voice: ->(text:) { puts "voice: #{text}" }
+- on_action_request: ->(text:) { puts "action: #{text}" }
+- on_pack_history: ->(text:) { puts "summary: #{text}" }
 
 ## [0.2.5] - 2024-07-30
 

data/README.md

@@ -111,10 +111,10 @@ iterator = OxAiWorkers::Iterator.new(
     worker: my_worker, 
     tools: [my_tool],
     role: "You are a software agent inside my computer",
-    on_inner_monologue: ->(text:) { puts Rainbow("monologue: #{text}").yellow },
-    on_outer_voice: ->(text:) { puts Rainbow("voice: #{text}").green },
-    on_action_request: ->(text:) { puts Rainbow("action: #{text}").red },
-    on_pack_history: ->(text:) { puts Rainbow("summary: #{text}").blue } 
+    on_inner_monologue: ->(text:) { puts "monologue: #{text}".colorize(:yellow) },
+    on_outer_voice: ->(text:) { puts "voice: #{text}".colorize(:green) },
+    on_action_request: ->(text:) { puts "action: #{text}".colorize(:red) },
+    on_pack_history: ->(text:) { puts "summary: #{text}".colorize(:blue) }
   )
 
 iterator.add_task("Show files in current directory.")
@@ -158,6 +158,15 @@ After this, in the `my_assistant.rb` file, you can find an example of an assista
 .oxaiworkers-local/start
 ```
 
+## Logging
+
+OxAiWorkers uses standard logging mechanisms and defaults to `:warn` level. Most messages are at info level, but we will add debug or warn statements as needed.
+To show all log messages:
+
+```ruby
+OxAiWorkers.logger.level = :debug
+```
+
 ## Features
 
 - **Generative Intelligence**: Leverages OpenAI's capabilities to enhance task execution.
@@ -165,46 +174,6 @@ After this, in the `my_assistant.rb` file, you can find an example of an assista
 - **External Tools**: Integrates with external tools and services to complete tasks.
 - **Finite State Machine**: Implements a robust state machine to manage task states and transitions.
 
-## Configuration
-
-OxAiWorkers uses YAML files for configuration. Below is an example configuration:
-
-```yaml
-en:
-  oxaiworkers:
-    iterator:
-      inner_monologue:
-        description: "Use inner monologue to plan the response and articulate main points"
-        speech: "Text"
-      outer_voice:
-        description: "Provide the user with necessary information without expecting a response"
-        text: "Text"
-      action_request:
-        description: "Ask a clarifying question or request an action with a response from the user"
-        action: "Text"
-      pack_history:
-        description: "Save facts, nuances, and actions before clearing messages"
-        text: "Listing important facts and nuances"
-      monologue:
-        - "Step 1: Develop your own solution to the problem. Take initiative and make assumptions."
-        - "Step 1.1: Wrap all your work for this step in the inner_monologue function."
-        - "Step 2: Relate your solution to the task, improve it, and call the necessary functions step by step."
-        - "Step 2.1: Interact with the user using the outer_voice and action_request functions during the process."
-        - "Step 3: When the solution is ready, report it using the outer_voice function."
-        - "Step 4: Save facts, nuances, and actions using the summarize function."
-    tool:
-      eval:
-        ruby:
-          description: "Execute Ruby code and return the result of the last expression"
-          input: "Ruby source code"
-        sh:
-          description: "Execute a sh command and get the result (stdout + stderr)"
-          input: "Source command"
-    assistant:
-      sysop:
-        role: "You are a software agent inside my computer"
-```
-
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/neonix20b/ox-ai-workers. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/neonix20b/ox-ai-workers/blob/main/CODE_OF_CONDUCT.md).

data/lib/ox-ai-workers.rb

@@ -2,12 +2,13 @@
 
 require 'faraday'
 require 'faraday/multipart'
-require 'rainbow'
+require 'colorize'
 require 'openai'
 require 'yaml'
 require 'json'
 
 require_relative 'oxaiworkers/version'
+require_relative 'oxaiworkers/contextual_logger'
 require_relative 'oxaiworkers/load_i18n'
 require_relative 'oxaiworkers/present_compat'
 require_relative 'oxaiworkers/module_request'
@@ -27,6 +28,7 @@ require_relative 'oxaiworkers/tool/file_system'
 require_relative 'oxaiworkers/assistant/module_base'
 require_relative 'oxaiworkers/assistant/sysop'
 require_relative 'oxaiworkers/assistant/coder'
+require_relative 'oxaiworkers/assistant/localizer'
 
 module OxAiWorkers
   DEFAULT_MODEL = 'gpt-4o-mini'
@@ -54,8 +56,17 @@ module OxAiWorkers
 
   class << self
     attr_writer :configuration
+    attr_reader :logger
+
+    # @param logger [Logger]
+    # @return [ContextualLogger]
+    def logger=(logger)
+      @logger = ContextualLogger.new(logger)
+    end
   end
 
+  self.logger ||= ::Logger.new($stdout, level: :info)
+
   def self.configuration
     @configuration ||= OxAiWorkers::Configuration.new
   end

data/lib/oxaiworkers/assistant/coder.rb

@@ -10,10 +10,10 @@ module OxAiWorkers
           worker: init_worker(delayed: delayed, model: model),
           role: format(I18n.t('oxaiworkers.assistant.coder.role'), language),
           tools: [Tool::Eval.new, Tool::FileSystem.new],
-          on_inner_monologue: ->(text:) { puts Rainbow("monologue: #{text}").yellow },
-          on_outer_voice: ->(text:) { puts Rainbow("voice: #{text}").green },
-          on_action_request: ->(text:) { puts Rainbow("action: #{text}").red },
-          on_pack_history: ->(text:) { puts Rainbow("summary: #{text}").blue }
+          on_inner_monologue: ->(text:) { puts "monologue: #{text}".colorize(:yellow) },
+          on_outer_voice: ->(text:) { puts "voice: #{text}".colorize(:green) },
+          on_action_request: ->(text:) { puts "action: #{text}".colorize(:red) },
+          on_pack_history: ->(text:) { puts "summary: #{text}".colorize(:blue) }
         )
       end
     end

data/lib/oxaiworkers/assistant/localizer.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module OxAiWorkers
+  module Assistant
+    class Localizer
+      include OxAiWorkers::Assistant::ModuleBase
+
+      def initialize(delayed: false, model: nil, language: 'русский', locale: :ru, source: 'english')
+        @iterator = Iterator.new(
+          worker: init_worker(delayed: delayed, model: model),
+          role: format(I18n.t('oxaiworkers.assistant.localizer.role'), language),
+          tools: [Tool::Eval.new, Tool::FileSystem.new],
+          on_inner_monologue: ->(text:) { puts "monologue: #{text}".colorize(:yellow) },
+          on_outer_voice: ->(text:) { puts "voice: #{text}".colorize(:green) },
+          on_action_request: ->(text:) { puts "action: #{text}".colorize(:red) },
+          on_pack_history: ->(text:) { puts "summary: #{text}".colorize(:blue) }
+        )
+        @iterator.add_context(format(I18n.t('oxaiworkers.assistant.localizer.source'), source))
+
+        @iterator.add_context(format(I18n.t('oxaiworkers.assistant.localizer.locale'),
+                                     language, locale))
+      end
+    end
+  end
+end

data/lib/oxaiworkers/assistant/sysop.rb

@@ -10,10 +10,10 @@ module OxAiWorkers
           worker: init_worker(delayed: delayed, model: model),
           role: I18n.t('oxaiworkers.assistant.sysop.role'),
           tools: [Tool::Eval.new],
-          on_inner_monologue: ->(text:) { puts Rainbow("monologue: #{text}").yellow },
-          on_outer_voice: ->(text:) { puts Rainbow("voice: #{text}").green },
-          on_action_request: ->(text:) { puts Rainbow("action: #{text}").red },
-          on_pack_history: ->(text:) { puts Rainbow("summary: #{text}").blue }
+          on_inner_monologue: ->(text:) { puts "monologue: #{text}".colorize(:yellow) },
+          on_outer_voice: ->(text:) { puts "voice: #{text}".colorize(:green) },
+          on_action_request: ->(text:) { puts "action: #{text}".colorize(:red) },
+          on_pack_history: ->(text:) { puts "summary: #{text}".colorize(:blue) }
         )
       end
     end

data/lib/oxaiworkers/contextual_logger.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module OxAiWorkers
+  class ContextualLogger
+    MESSAGE_COLOR_OPTIONS = {
+      debug: {
+        color: :white
+      },
+      error: {
+        color: :red
+      },
+      fatal: {
+        color: :red,
+        background: :white,
+        mode: :bold
+      },
+      unknown: {
+        color: :white
+      },
+      info: {
+        color: :magenta
+      },
+      warn: {
+        color: :yellow,
+        mode: :bold
+      }
+    }
+
+    def initialize(logger)
+      @logger = logger
+      @levels = Logger::Severity.constants.map(&:downcase)
+    end
+
+    def respond_to_missing?(method, include_private = false)
+      @logger.respond_to?(method, include_private)
+    end
+
+    def method_missing(method, *args, **kwargs, &block)
+      return @logger.send(method, *args, **kwargs, &block) unless @levels.include?(method)
+
+      for_class = kwargs.delete(:for)
+      for_class_name = for_class&.name
+
+      log_line_parts = []
+      log_line_parts << '[OxAiWorkers]' # .colorize(color: :yellow)
+      log_line_parts << if for_class.respond_to?(:logger_options)
+                          "#{"[#{for_class_name}]".colorize(for_class.logger_options)}:"
+                        elsif for_class_name
+                          "[#{for_class_name}]:"
+                        end
+      log_line_parts << args.first.colorize(MESSAGE_COLOR_OPTIONS[method])
+      log_line = log_line_parts.compact.join(' ')
+
+      @logger.send(
+        method,
+        log_line
+      )
+    end
+  end
+end

data/lib/oxaiworkers/delayed_request.rb

@@ -65,7 +65,7 @@ module OxAiWorkers
         @file_id = response['id']
         process_batch!
       rescue OpenAI::Error => e
-        puts e.inspect
+        OxAiWorkers.logger.debug(e.inspect, for: self.class)
         fail_batch!
       end
       file.unlink

data/lib/oxaiworkers/iterator.rb

@@ -26,7 +26,6 @@ module OxAiWorkers
 
     def initialize(worker:, role: nil, tools: [], on_inner_monologue: nil, on_outer_voice: nil, on_action_request: nil,
                    on_pack_history: nil)
-      puts "call: #{__method__}"
       @worker = worker
       @tools = [self] + tools
       @role = role
@@ -54,14 +53,14 @@ module OxAiWorkers
 
     def inner_monologue(speach:)
       # @queue.pop
-      @queue << { role: :system, content: speach.to_s }
+      @queue << { role: :assistant, content: speach.to_s }
       @on_inner_monologue&.call(text: speach)
       nil
     end
 
     def outer_voice(text:)
       # @queue.pop
-      @queue << { role: :system, content: text.to_s }
+      @queue << { role: :assistant, content: text.to_s }
       @on_outer_voice&.call(text: text)
       nil
     end
@@ -69,7 +68,7 @@ module OxAiWorkers
     def action_request(action:)
       @result = action
       # @queue.pop
-      @messages << { role: :system, content: action.to_s }
+      @messages << { role: :assistant, content: action.to_s }
       complete! if can_complete?
       @on_action_request&.call(text: action)
       nil
@@ -78,6 +77,7 @@ module OxAiWorkers
     def summarize(text:)
       @milestones << text.to_s
       @messages = []
+      @queue << { role: :assistant, content: I18n.t('oxaiworkers.iterator.pack_history.result') }
       @worker.finish
       rebuild_worker
       # complete! if can_complete?
@@ -86,24 +86,22 @@ module OxAiWorkers
     end
 
     def init
-      puts "call: #{__method__} state: #{state_name}"
       rebuild_worker
       request!
     end
 
     def rebuild_worker
       @worker.messages = []
-      @worker.append(role: :system, content: @role) if !@role.nil? && @role.present?
+      @worker.append(role: :system, content: @role) if @role.present?
       @worker.append(role: :system, content: @monologue.join("\n"))
-      @worker.append(messages: @context) if !@context.nil? and @context.any?
+      @worker.append(messages: @context) if @context.present?
       @tasks.each { |task| @worker.append(role: :user, content: task) }
-      @milestones.each { |milestone| @worker.append(role: :system, content: milestone) }
+      @milestones.each { |milestone| @worker.append(role: :assistant, content: milestone) }
       @worker.append(messages: @messages)
-      @worker.tools = @tools.map { |tool| tool.class.function_schemas.to_openai_format }.flatten if @tools.any?
+      @worker.tools = @tools.map { |tool| tool.class.function_schemas.to_openai_format }.flatten if @tools.present?
     end
 
     def next_iteration
-      puts "call: #{__method__} state: #{state_name}"
       @worker.append(messages: @queue)
       @messages += @queue
       @queue = []
@@ -111,19 +109,16 @@ module OxAiWorkers
     end
 
     def external_request
-      puts "call: #{__method__} state: #{state_name}"
       @worker.request!
       ticker
     end
 
     def ticker
-      puts "call: #{__method__} state: #{state_name}"
       sleep(60) until @worker.completed?
       analyze!
     end
 
     def process_result(_transition)
-      puts "call: #{__method__} state: #{state_name}"
       @result = @worker.result || @worker.errors
       if @worker.tool_calls.present?
         @queue << { role: :assistant, content: @worker.tool_calls_raw.to_s }
@@ -133,18 +128,11 @@ module OxAiWorkers
           end.first
           unless tool.nil?
             out = tool.send(external_call[:name], **external_call[:args])
-            @queue << { role: :system, content: out.to_s } if out.present?
+            @queue << { role: :user, content: out.to_s } if out.present?
           end
         end
         @worker.finish
         iterate! if can_iterate?
-
-        # tool = @tools.select{|t| t.class.tool_name == @worker.external_call[:class] && t.respond_to?(@worker.external_call[:name]) }.first
-        # out = tool.send(@worker.external_call[:name], **@worker.external_call[:args])
-        # if can_iterate?
-        #   @queue << {role: :system, content: out.to_s} if out.present?
-        #   iterate!
-        # end
       elsif @worker.result.present?
         action_request action: @worker.result
       end
@@ -161,17 +149,15 @@ module OxAiWorkers
       execute if auto_execute
     end
 
-    def append_context(text, role: :system)
+    def add_context(text, role: :system)
       @context << { role: role, content: text }
     end
 
     def execute
-      puts "call: #{__method__} state: #{state_name}"
       prepare! if valid?
     end
 
     def cancel
-      puts "call: #{__method__} state: #{state_name}"
       @worker.cancel if @worker.respond_to?(:cancel)
     end
 

data/lib/oxaiworkers/module_request.rb

@@ -6,7 +6,6 @@ module OxAiWorkers
                   :tool_calls_raw, :tool_calls
 
     def initialize_requests(model: nil, max_tokens: nil, temperature: nil)
-      # puts "call: ModuleRequest::#{__method__}"
       @max_tokens = max_tokens || OxAiWorkers.configuration.max_tokens
       @custom_id = SecureRandom.uuid
       @model = model || OxAiWorkers.configuration.model
@@ -23,7 +22,6 @@ module OxAiWorkers
     end
 
     def cleanup
-      # puts "call: ModuleRequest::#{__method__}"
       @client ||= OpenAI::Client.new(
         access_token: OxAiWorkers.configuration.access_token,
         log_errors: true # Highly recommended in development, so you can see what errors OpenAI is returning. Not recommended in production because it could leak private data to your logs.
@@ -61,7 +59,6 @@ module OxAiWorkers
     end
 
     def parse_choices(response)
-      # puts response.inspect
       @tool_calls = []
       @result = response.dig('choices', 0, 'message', 'content')
       @tool_calls_raw = response.dig('choices', 0, 'message', 'tool_calls')

data/lib/oxaiworkers/request.rb

@@ -12,10 +12,8 @@ module OxAiWorkers
     def request!
       response = @client.chat(parameters: params)
       parse_choices(response)
-      # @result = response.dig("choices", 0, "message", "content")
-      # puts response.inspect
     rescue OpenAI::Error => e
-      puts e.inspect
+      OxAiWorkers.logger.debug(e.inspect, for: self.class)
     end
 
     def completed?

data/lib/oxaiworkers/state_batch.rb

@@ -56,10 +56,5 @@ module OxAiWorkers
       @batch_id = nil
       super()
     end
-
-    def initialize
-      puts "call: StateBatch::#{__method__}"
-      super()
-    end
   end
 end

data/lib/oxaiworkers/state_helper.rb

@@ -3,7 +3,7 @@
 module OxAiWorkers
   module StateHelper
     def log_me(transition)
-      # puts "`#{transition.event}` was called to transition from :#{transition.from} to :#{transition.to}"
+      # OxAiWorkers.logger.debug("`#{transition.event}` was called to transition from :#{transition.from} to :#{transition.to}")
     end
   end
 end

data/lib/oxaiworkers/tool/database.rb

@@ -72,7 +72,7 @@ module OxAiWorkers
       #
       # @return [String] Database schema
       def dump_schema
-        puts('Dumping schema tables and keys', for: self.class)
+        OxAiWorkers.logger.debug('Dumping schema tables and keys', for: self.class)
         schema = ''
         db.tables.each do |table|
           describe_table(table, schema)
@@ -108,10 +108,11 @@ module OxAiWorkers
       # @param input [String] SQL query to be executed
       # @return [Array] Results from the SQL query
       def execute(input:)
-        puts("Executing \"#{input}\"", for: self.class)
+        OxAiWorkers.logger.info("Executing \"#{input}\"", for: self.class)
 
         db[input].to_a
       rescue Sequel::DatabaseError => e
+        OxAiWorkers.logger.info(e.message, for: self.class)
         e.message
       end
     end

data/lib/oxaiworkers/tool/eval.rb

@@ -17,18 +17,19 @@ module OxAiWorkers
       end
 
       # def ruby(input:)
-      #   puts Rainbow("Executing ruby: \"#{input}\"").red
+      #   puts "Executing ruby: \"#{input}\"".colorize(:red)
       #   eval(input)
       # end
 
       def sh(input:)
-        puts Rainbow("Executing sh: \"#{input}\"").red
+        OxAiWorkers.logger.info("Executing sh: \"#{input}\"", for: self.class)
         begin
           stdout_and_stderr_s, status = Open3.capture2e(input)
           return stdout_and_stderr_s if stdout_and_stderr_s.present?
 
           status.to_s
         rescue StandardError => e
+          OxAiWorkers.logger.debug(e.message, for: self.class)
           e.message
         end
       end

data/lib/oxaiworkers/tool/file_system.rb

@@ -38,7 +38,7 @@ module OxAiWorkers
       end
 
       def list_directory(directory_path:)
-        puts Rainbow("Listing directory: #{directory_path}").magenta
+        OxAiWorkers.logger.info("Listing directory: #{directory_path}", for: self.class)
         list = Dir.entries(directory_path)
         list.delete_if { |f| f.start_with?('.') }
         if list.present?
@@ -51,7 +51,7 @@ module OxAiWorkers
       end
 
       def read_file(file_path:)
-        puts Rainbow("Reading file: #{file_path}").magenta
+        OxAiWorkers.logger.info("Reading file: #{file_path}", for: self.class)
         if File.binary?(file_path)
           "File is binary: #{file_path}"
         else
@@ -62,7 +62,7 @@ module OxAiWorkers
       end
 
       def write_to_file(file_path:, content:)
-        puts Rainbow("Writing to file: #{file_path}").magenta
+        OxAiWorkers.logger.info("Writing to file: #{file_path}", for: self.class)
         File.write(file_path, content)
         "Content was successfully written to the file: #{file_path}"
       rescue Errno::EACCES

data/lib/oxaiworkers/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OxAiWorkers
-  VERSION = '0.5.1'
+  VERSION = '0.5.3'
 end

data/locales/en.assistant.yml

@@ -4,4 +4,8 @@ en:
       sysop:
         role: "You are a software agent inside my computer"
       coder:
-        role: "You are a professional %s programmer inside my computer"
+        role: "You are a professional %s programmer inside my computer"
+      localizer:
+        role: "You are a professional localizer (translator) to the %s language inside my computer. Your task is to correctly localize files (create new ones in the required language based on the original) provided by the user."
+        source: "Use the %s language as a basis"
+        locale: "For the %s language, the correct locale is :%s"

data/locales/en.iterator.yml

@@ -2,21 +2,21 @@ en:
   oxaiworkers:
     iterator:
       inner_monologue:
-        description: "Use inner monologue to plan the response and articulate main points"
-        speech: "Text"
+        description: A function for internal monologue, allowing the AI to ponder and formulate its thoughts without user involvement. Used for intermediate reflections and recording data that do not require immediate response or action from the user.
+        speach: Text of reflections or conclusions
       outer_voice:
-        description: "Provide the user with necessary information without expecting a response"
-        text: "Text"
+        description: Inform the user of the necessary information without expecting a response.
+        text: Content of the message
       action_request:
-        description: "Ask a clarifying question or request an action with a response from the user"
-        action: "Text"
+        description: A function for interactive interaction with the user. Allows you to ask a clarifying question, request actions, or complete the current step. The function waits for the user's response and returns it.
+        action: Text of the request or action
       pack_history:
-        description: "Save facts, nuances, and actions before clearing messages"
-        text: "Listing important facts and nuances"
+        description: The function saves key facts, nuances, and actions from previous messages, including the provided response. After calling this function, all previous messages will be deleted. Use it only after all intermediate steps are completed and when the exact content of previous messages is no longer relevant.
+        text: Enumeration of important facts and nuances
+        result: Messages deleted
       monologue:
-        - "Step 1: Develop your own solution to the problem. Take initiative and make assumptions."
-        - "Step 1.1: Wrap all your work for this step in the ox_ai_workers_iterator__inner_monologue function."
-        - "Step 2: Relate your solution to the task, improve it, and call the necessary functions step by step."
-        - "Step 2.1: Interact with the user using the ox_ai_workers_iterator__outer_voice and ox_ai_workers_iterator__action_request functions during the process."
-        - "Step 3: When the solution is ready, report it using the ox_ai_workers_iterator__outer_voice function."
-        - "Step 4: Save facts, nuances, and actions using the ox_ai_workers_iterator__summarize function."
+        - Step 1. Develop your own solution to the problem, taking initiative and making assumptions.
+        - Step 2. Enclose all your developments from the previous step in the ox_ai_workers_iterator__inner_monologue function.
+        - Step 3. Call the necessary functions one after another until the desired result is achieved.
+        - Step 4. When all intermediate steps are completed and the exact content of previous messages is no longer relevant, use the ox_ai_workers_iterator__pack_history function.
+        - Step 5. When the solution is ready, notify about it and wait for the user's response.

data/locales/ru.assistant.yml

@@ -5,3 +5,7 @@ ru:
         role: Ты программный агент внутри моего компьютера
       coder:
         role: "Ты профессиональный программист на %s внутри моего компьютера"
+      localizer:
+        role: "Ты профессиональный локализатор (переводчик) на %s язык внутри моего компьютера. Твоя задача корректно локализовать файлы (создать по аналогии новые на нужном языке), которые предоставит пользователь."
+        source: "Возьми за основу %s язык"
+        locale: "%s язык имеет локаль :%s"

data/locales/ru.iterator.yml

@@ -2,21 +2,21 @@ ru:
   oxaiworkers:
     iterator:
       inner_monologue:
-        description: Используй внутренний монолог для планирования ответа и проговаривания основных тезисов
-        speach: Текст
+        description: Функция для внутреннего монолога, позволяющая ИИ обдумывать и формулировать свои мысли без участия пользователя. Используется для промежуточных размышлений и фиксации данных, которые не требуют немедленного ответа или действия от пользователя.
+        speach: Текст размышлений или выводов
       outer_voice:
-        description: Сообщить пользователю необходимую информацию без ожидания ответа
-        text: Текст
+        description: Сообщить пользователю необходимую информацию без ожидания ответа.
+        text: Содержимое сообщения
       action_request:
-        description: Задать уточняющий вопрос или попросить о действии с получением ответа от пользователя
-        action: Текст
+        description: Функция для интерактивного взаимодействия с пользователем. Позволяет задать уточняющий вопрос, запросить выполнение действий или завершить текущий шаг. Функция ожидает ответ пользователя и возвращает его.
+        action: Текст запроса или действия
       pack_history:
-        description: Сохранение фактов, нюансов и действий (в том числе что ответ был дан) перед очисткой сообщений
+        description: Функция сохраняет ключевые факты, нюансы и действия из предыдущих сообщений, включая предоставленный ответ. После вызова этой функции все предыдущие сообщения будут удалены. Используйте её только после завершения всех промежуточных шагов и когда точное содержание предыдущих сообщений больше не имеет значения.
         text: Перечисление важных фактов и нюансов
+        result: Сообщения удалены
       monologue:
-        - Шаг 1. Разработай собственное решение проблемы. Проявляй инициативу и делай предположения. 
-        - Шаг 1.1. Заключи все свои наработки для этого шага в функцию ox_ai_workers_iterator__inner_monologue.
-        - Шаг 2. Соотнеси свое решение с задачей, улучшай его и вызывай необходимые функции шаг за шагом.
-        - Шаг 2.1. Во время работы используй функции ox_ai_workers_iterator__outer_voice и ox_ai_workers_iterator__action_request.
-        - Шаг 3. Когда решение готово, сообщи о нем с помощью функции ox_ai_workers_iterator__outer_voice
-        - Шаг 4. Сохрани факты, нюансы и действия с помощью функции ox_ai_workers_iterator__summarize и предложи дальнейшие действия с помощью функции ox_ai_workers_iterator__action_request.
+        - Шаг 1. Разработай собственное решение проблемы, проявляя инициативу и делая предположения.
+        - Шаг 2. Заключи все свои наработки из предыдущего шага в функцию ox_ai_workers_iterator__inner_monologue.
+        - Шаг 3. Вызывай необходимые функции друг за другом, пока желаемый результат не будет достигнут.
+        - Шаг 4. Когда все промежуточные шаги завершены и точное содержание предыдущих сообщений больше не имеет значения, используй функцию ox_ai_workers_iterator__pack_history.
+        - Шаг 5. Когда решение готово, сообщи об этом и ожидай ответ пользователя.

data/template/my_assistant.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require 'rainbow'
+require 'colorize'
 require_relative 'tools/my_tool'
 
 class MyAssistant
@@ -11,10 +11,10 @@ class MyAssistant
       worker: init_worker(delayed: delayed, model: model),
       role: 'You are a software agent inside my computer',
       tools: [MyTool.new],
-      on_inner_monologue: ->(text:) { puts Rainbow("monologue: #{text}").yellow },
-      on_outer_voice: ->(text:) { puts Rainbow("voice: #{text}").green },
-      on_action_request: ->(text:) { puts Rainbow("action: #{text}").red },
-      on_pack_history: ->(text:) { puts Rainbow("summary: #{text}").blue }
+      on_inner_monologue: ->(text:) { puts "monologue: #{text}".colorize(:yellow) },
+      on_outer_voice: ->(text:) { puts "voice: #{text}".colorize(:green) },
+      on_action_request: ->(text:) { puts "action: #{text}".colorize(:red) },
+      on_pack_history: ->(text:) { puts "summary: #{text}".colorize(:blue) }
     )
   end
 end

data/template/start

@@ -22,6 +22,8 @@ OxAiWorkers.configure do |config|
   config.model = 'gpt-4o-mini'
 end
 
+# OxAiWorkers.logger.level = :debug
+
 # Main algorithm
 @assistant = MyAssistant.new
 @assistant.task = '2 + 2 is ?'

data/template/tools/my_tool.rb

@@ -9,7 +9,7 @@ class MyTool
   end
 
   def sh(input:)
-    puts "Executing sh: \"#{input}\""
+    OxAiWorkers.logger.info("Executing sh: \"#{input}\"", for: self.class)
     stdout_and_stderr_s, = Open3.capture2e(input)
     stdout_and_stderr_s
   end

metadata

@@ -1,31 +1,31 @@
 --- !ruby/object:Gem::Specification
 name: ox-ai-workers
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.5.3
 platform: ruby
 authors:
 - Denis Smolev
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-07-30 00:00:00.000000000 Z
+date: 2024-07-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: faraday
+  name: colorize
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1'
 - !ruby/object:Gem::Dependency
-  name: faraday-multipart
+  name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -39,7 +39,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1'
 - !ruby/object:Gem::Dependency
-  name: i18n
+  name: faraday-multipart
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -53,7 +53,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1'
 - !ruby/object:Gem::Dependency
-  name: ptools
+  name: i18n
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -67,19 +67,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1'
 - !ruby/object:Gem::Dependency
-  name: rainbow
+  name: ptools
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3'
+        version: '1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3'
+        version: '1'
 - !ruby/object:Gem::Dependency
   name: ruby-openai
   requirement: !ruby/object:Gem::Requirement
@@ -135,9 +135,11 @@ files:
 - exe/start
 - lib/ox-ai-workers.rb
 - lib/oxaiworkers/assistant/coder.rb
+- lib/oxaiworkers/assistant/localizer.rb
 - lib/oxaiworkers/assistant/module_base.rb
 - lib/oxaiworkers/assistant/sysop.rb
 - lib/oxaiworkers/compatibility.rb
+- lib/oxaiworkers/contextual_logger.rb
 - lib/oxaiworkers/delayed_request.rb
 - lib/oxaiworkers/dependency_helper.rb
 - lib/oxaiworkers/iterator.rb