flowengine 0.3.0 → 0.3.1

data/resources/models.yml

@@ -0,0 +1,25 @@
+models:
+  version: "1.0"
+  date: "Wed Mar 11 02:35:39 PDT 2026"
+  vendors:
+    anthropic: 
+      adapter: "FlowEngine::LLM::Adapters::AnthropicAdapter"
+      var: "ANTHROPIC_API_KEY"
+      top: "claude-opus-4-6"
+      default: "claude-sonnet-4-6"
+      fastest: "claude-haiku-4-5-20251001"
+    openai:
+      adapter: "FlowEngine::LLM::Adapters::OpenAIAdapter"
+      var: "OPENAI_API_KEY"
+      top: "gpt-5.4"
+      default: "gpt-5-mini"
+      fastest: "gpt-5-nano"
+    gemini:
+      adapter: "FlowEngine::LLM::Adapters::GeminiAdapter"
+      var: "GEMINI_API_KEY"
+      top: "gemini-3.1-pro-preview"
+      default: "gemini-2.5-flash"
+      fastest: "gemini-2.5-flash-lite"
+
+
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: flowengine
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Konstantin Gredeskoul
@@ -23,6 +23,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  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: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -115,22 +129,25 @@ files:
 - exe/flowengine
 - justfile
 - lib/flowengine.rb
+- lib/flowengine/clarification_result.rb
 - lib/flowengine/definition.rb
 - lib/flowengine/dsl.rb
 - lib/flowengine/dsl/flow_builder.rb
 - lib/flowengine/dsl/rule_helpers.rb
 - lib/flowengine/dsl/step_builder.rb
 - lib/flowengine/engine.rb
+- lib/flowengine/engine/state_serializer.rb
 - lib/flowengine/errors.rb
 - lib/flowengine/evaluator.rb
 - lib/flowengine/graph/mermaid_exporter.rb
 - lib/flowengine/introduction.rb
 - lib/flowengine/llm.rb
 - lib/flowengine/llm/adapter.rb
-- lib/flowengine/llm/anthropic_adapter.rb
+- lib/flowengine/llm/adapters.rb
+- lib/flowengine/llm/auto_client.rb
 - lib/flowengine/llm/client.rb
-- lib/flowengine/llm/gemini_adapter.rb
-- lib/flowengine/llm/openai_adapter.rb
+- lib/flowengine/llm/intake_prompt_builder.rb
+- lib/flowengine/llm/provider.rb
 - lib/flowengine/llm/sensitive_data_filter.rb
 - lib/flowengine/llm/system_prompt_builder.rb
 - lib/flowengine/node.rb
@@ -146,6 +163,7 @@ files:
 - lib/flowengine/validation/adapter.rb
 - lib/flowengine/validation/null_adapter.rb
 - lib/flowengine/version.rb
+- resources/models.yml
 - resources/prompts/generic-dsl-intake.j2
 - sig/flowengine.rbs
 homepage: https://github.com/kigster/flowengine

data/lib/flowengine/llm/anthropic_adapter.rb

@@ -1,40 +0,0 @@
-# frozen_string_literal: true
-
-require "ruby_llm"
-
-module FlowEngine
-  module LLM
-    # Anthropic adapter using the ruby_llm gem. Configures the API key
-    # and delegates chat calls to RubyLLM's conversation interface.
-    class AnthropicAdapter < Adapter
-      DEFAULT_MODEL = "claude-sonnet-4-20250514"
-
-      # @param api_key [String, nil] Anthropic API key; falls back to ANTHROPIC_API_KEY env var
-      # @raise [LLMError] if no API key is available
-      def initialize(api_key: nil)
-        super()
-        @api_key = api_key || ENV.fetch("ANTHROPIC_API_KEY", nil)
-        raise LLMError, "Anthropic API key not provided and ANTHROPIC_API_KEY not set" unless @api_key
-      end
-
-      # @param system_prompt [String] system instructions
-      # @param user_prompt [String] user's text
-      # @param model [String] Anthropic model identifier
-      # @return [String] response content from the LLM
-      def chat(system_prompt:, user_prompt:, model: DEFAULT_MODEL)
-        configure_ruby_llm!
-        conversation = RubyLLM.chat(model: model)
-        response = conversation.with_instructions(system_prompt).ask(user_prompt)
-        response.content
-      end
-
-      private
-
-      def configure_ruby_llm!
-        RubyLLM.configure do |config|
-          config.anthropic_api_key = @api_key
-        end
-      end
-    end
-  end
-end

data/lib/flowengine/llm/gemini_adapter.rb

@@ -1,40 +0,0 @@
-# frozen_string_literal: true
-
-require "ruby_llm"
-
-module FlowEngine
-  module LLM
-    # Google Gemini adapter using the ruby_llm gem. Configures the API key
-    # and delegates chat calls to RubyLLM's conversation interface.
-    class GeminiAdapter < Adapter
-      DEFAULT_MODEL = "gemini-2.0-flash"
-
-      # @param api_key [String, nil] Gemini API key; falls back to GEMINI_API_KEY env var
-      # @raise [LLMError] if no API key is available
-      def initialize(api_key: nil)
-        super()
-        @api_key = api_key || ENV.fetch("GEMINI_API_KEY", nil)
-        raise LLMError, "Gemini API key not provided and GEMINI_API_KEY not set" unless @api_key
-      end
-
-      # @param system_prompt [String] system instructions
-      # @param user_prompt [String] user's text
-      # @param model [String] Gemini model identifier
-      # @return [String] response content from the LLM
-      def chat(system_prompt:, user_prompt:, model: DEFAULT_MODEL)
-        configure_ruby_llm!
-        conversation = RubyLLM.chat(model: model)
-        response = conversation.with_instructions(system_prompt).ask(user_prompt)
-        response.content
-      end
-
-      private
-
-      def configure_ruby_llm!
-        RubyLLM.configure do |config|
-          config.gemini_api_key = @api_key
-        end
-      end
-    end
-  end
-end

data/lib/flowengine/llm/openai_adapter.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-require "ruby_llm"
-
-module FlowEngine
-  module LLM
-    # OpenAI adapter using the ruby_llm gem. Configures the API key
-    # and delegates chat calls to RubyLLM's conversation interface.
-    class OpenAIAdapter < Adapter
-      # @param api_key [String, nil] OpenAI API key; falls back to OPENAI_API_KEY env var
-      # @raise [LLMError] if no API key is available
-      def initialize(api_key: nil)
-        super()
-        @api_key = api_key || ENV.fetch("OPENAI_API_KEY", nil)
-        raise LLMError, "OpenAI API key not provided and OPENAI_API_KEY not set" unless @api_key
-      end
-
-      # @param system_prompt [String] system instructions
-      # @param user_prompt [String] user's text
-      # @param model [String] OpenAI model identifier
-      # @return [String] response content from the LLM
-      def chat(system_prompt:, user_prompt:, model: "gpt-4o-mini")
-        configure_ruby_llm!
-        conversation = RubyLLM.chat(model: model)
-        response = conversation.with_instructions(system_prompt).ask(user_prompt)
-        response.content
-      end
-
-      private
-
-      def configure_ruby_llm!
-        RubyLLM.configure do |config|
-          config.openai_api_key = @api_key
-        end
-      end
-    end
-  end
-end