flowengine 0.2.1 → 0.3.1

data/lib/flowengine.rb

@@ -1,26 +1,14 @@
 # frozen_string_literal: true
 
-require_relative "flowengine/version"
-require_relative "flowengine/errors"
-require_relative "flowengine/rules/base"
-require_relative "flowengine/rules/contains"
-require_relative "flowengine/rules/equals"
-require_relative "flowengine/rules/greater_than"
-require_relative "flowengine/rules/less_than"
-require_relative "flowengine/rules/not_empty"
-require_relative "flowengine/rules/all"
-require_relative "flowengine/rules/any"
-require_relative "flowengine/evaluator"
-require_relative "flowengine/transition"
-require_relative "flowengine/node"
-require_relative "flowengine/introduction"
-require_relative "flowengine/definition"
-require_relative "flowengine/validation/adapter"
-require_relative "flowengine/validation/null_adapter"
-require_relative "flowengine/engine"
-require_relative "flowengine/dsl"
-require_relative "flowengine/graph/mermaid_exporter"
-require_relative "flowengine/llm"
+require "zeitwerk"
+
+loader = Zeitwerk::Loader.for_gem
+loader.inflector.inflect(
+  "flowengine" => "FlowEngine",
+  "llm" => "LLM",
+  "dsl" => "DSL"
+)
+loader.setup
 
 # Declarative flow definition and execution engine for wizards, intake forms, and
 # multi-step decision graphs. Separates flow logic, data schema, and UI rendering.
@@ -45,11 +33,14 @@ require_relative "flowengine/llm"
 #   engine.current_step_id # => :business_details
 #
 module FlowEngine
+  # Root directory of the flowengine gem
+  ROOT = File.expand_path("..", __dir__)
+
   # Builds an immutable {Definition} from the declarative DSL block.
   #
   # @yield context of {DSL::FlowBuilder} (start, step, and rule helpers)
   # @return [Definition] frozen flow definition with start step and nodes
-  # @raise [DefinitionError] if no start step or no steps are defined
+  # @raise [Errors::DefinitionError] if no start step or no steps are defined
   def self.define(&)
     builder = DSL::FlowBuilder.new
     builder.instance_eval(&)
@@ -61,14 +52,22 @@ module FlowEngine
   #
   # @param text [String] Ruby source containing FlowEngine.define { ... }
   # @return [Definition] the definition produced by evaluating the DSL
-  # @raise [DefinitionError] on syntax or evaluation errors
+  # @raise [Errors::DefinitionError] on syntax or evaluation errors
   def self.load_dsl(text)
     # rubocop:disable Security/Eval
     eval(text, TOPLEVEL_BINDING.dup, "(dsl)", 1)
     # rubocop:enable Security/Eval
   rescue SyntaxError => e
-    raise DefinitionError, "DSL syntax error: #{e.message}"
+    raise Errors::DefinitionError, "DSL syntax error: #{e.message}"
   rescue StandardError => e
-    raise DefinitionError, "DSL evaluation error: #{e.message}"
+    raise Errors::DefinitionError, "DSL evaluation error: #{e.message}"
+  end
+
+  # Resolves a fully-qualified constant name string to the actual constant.
+  #
+  # @param name [String] e.g. "FlowEngine::LLM::Adapters::AnthropicAdapter"
+  # @return [Class, Module]
+  def self.constantize(name)
+    name.split("::").inject(Object) { |mod, const| mod.const_get(const) }
   end
 end

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.2.1
+  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,20 +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/adapters.rb
+- lib/flowengine/llm/auto_client.rb
 - lib/flowengine/llm/client.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
@@ -144,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/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