igniter 0.5.0 → 0.5.1

data/lib/igniter.rb

@@ -1,23 +1,39 @@
 # frozen_string_literal: true
 
-require_relative "igniter/version"
-require_relative "igniter/errors"
-require_relative "igniter/type_system"
-require_relative "igniter/executor"
-require_relative "igniter/executor_registry"
-require_relative "igniter/effect"
-require_relative "igniter/effect_registry"
-require_relative "igniter/model"
-require_relative "igniter/compiler"
-require_relative "igniter/events"
-require_relative "igniter/runtime"
-require_relative "igniter/dsl"
-require_relative "igniter/extensions"
-require_relative "igniter/diagnostics"
-require_relative "igniter/contract"
+require_relative "igniter/monorepo_packages"
+
+require "igniter/core/version"
+require "igniter/core/errors"
+require "igniter/core/type_system"
+require "igniter/core/executor"
+require "igniter/core/executor_registry"
+require "igniter/core/effect"
+require "igniter/core/effect_registry"
+require "igniter/core/model"
+require "igniter/core/compiler"
+require "igniter/core/events"
+require "igniter/core/runtime"
+require "igniter/core/dsl"
+require "igniter/core/extensions"
+require "igniter/core/diagnostics"
+require "igniter/core/contract"
 
 module Igniter
   class << self
+    def use(*names)
+      require "igniter/sdk"
+
+      @sdk_capabilities ||= []
+      resolved_names = names.flatten.map(&:to_sym)
+      SDK.activate!(*resolved_names, layer: :core)
+      @sdk_capabilities |= resolved_names
+      self
+    end
+
+    def sdk_capabilities
+      @sdk_capabilities ||= []
+    end
+
     def executor_registry
       @executor_registry ||= ExecutorRegistry.new
     end
@@ -37,13 +53,13 @@ module Igniter
     end
 
     def node_cache=(cache)
-      require_relative "igniter/node_cache"
+      require "igniter/core/node_cache"
       Igniter::NodeCache.cache = cache
     end
 
     # When true, auto-creates a CoalescingLock alongside the configured node cache.
     def node_coalescing=(enabled)
-      require_relative "igniter/node_cache"
+      require "igniter/core/node_cache"
       Igniter::NodeCache.coalescing_lock = enabled ? Igniter::NodeCache::CoalescingLock.new : nil
     end
 

data/packages/igniter-agents/README.md

@@ -0,0 +1,22 @@
+# igniter-agents
+
+Local monorepo gem that owns Igniter's actor runtime and agent libraries:
+
+- `Igniter::Agent`, `Igniter::Registry`, `Igniter::Supervisor`
+- `Igniter::Agents`
+- `Igniter::AI::Agents`
+
+Primary entrypoints:
+
+- `require "igniter-agents"`
+- `require "igniter/agent"`
+- `require "igniter/supervisor"`
+- `require "igniter/registry"`
+- `require "igniter/agents"`
+- `require "igniter/ai/agents"`
+
+Docs:
+
+- [Guide](../../docs/guide/README.md)
+- [Current](../../docs/current/README.md)
+- [Dev](../../docs/dev/README.md)

data/{lib → packages/igniter-agents/lib}/igniter/agent/ref.rb

@@ -28,6 +28,7 @@ module Igniter
         mailbox.push(Message.new(type: type.to_sym, payload: payload, reply_to: reply_box))
         reply = reply_box.pop(timeout: timeout)
         raise TimeoutError, "Agent did not reply within #{timeout}s" unless reply
+        raise reply.payload[:error] if reply.payload[:error]
 
         reply.payload[:value]
       end

data/{lib → packages/igniter-agents/lib}/igniter/agent/runner.rb

@@ -65,6 +65,10 @@ module Igniter
 
         state  = @state_holder.get
         result = handler.call(state: state, payload: message.payload)
+      rescue Igniter::PendingDependencyError => e
+        send_error_reply(message, e)
+        return
+      else
 
         case result
         when Hash
@@ -89,6 +93,14 @@ module Igniter
         )
       end
 
+      def send_error_reply(message, error)
+        return unless message.reply_to
+
+        message.reply_to.push(
+          Message.new(type: :reply, payload: { error: error })
+        )
+      end
+
       # Returns seconds until the next timer fires, or nil if no timers.
       def nearest_timer_delay
         return nil if @timers.empty?

data/{lib → packages/igniter-agents/lib}/igniter/agent.rb

@@ -1,10 +1,14 @@
 # frozen_string_literal: true
 
+require "igniter/core/errors"
+require "igniter/core/runtime/agent_adapter"
+require_relative "registry"
 require_relative "agent/message"
 require_relative "agent/mailbox"
 require_relative "agent/state_holder"
 require_relative "agent/runner"
 require_relative "agent/ref"
+require_relative "runtime/registry_agent_adapter"
 
 module Igniter
   # Base class for stateful, message-driven actors.
@@ -153,3 +157,5 @@ module Igniter
     end
   end
 end
+
+Igniter::Runtime.activate_agent_adapter! if Igniter::Runtime.agent_adapter.instance_of?(Igniter::Runtime::AgentAdapter)

data/{lib → packages/igniter-agents/lib}/igniter/agents/proactive_agent.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative "../integrations/agents"
+require "igniter/agent"
 
 module Igniter
   module Agents

data/packages/igniter-agents/lib/igniter/agents.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require "igniter/agent"
+require_relative "agents/reliability/retry_agent"
+require_relative "agents/pipeline/batch_processor_agent"
+require_relative "agents/scheduling/cron_agent"
+require_relative "agents/proactive_agent"
+require_relative "agents/proactive/alert_agent"
+require_relative "agents/proactive/health_check_agent"
+require_relative "agents/observability/metrics_agent"
+
+module Igniter
+  module Agents
+    # Convenience method — list all registered generic stdlib agents.
+    #
+    # @return [Array<Class>]
+    def self.all
+      [RetryAgent, BatchProcessorAgent, CronAgent,
+       ProactiveAgent, AlertAgent, HealthCheckAgent,
+       MetricsAgent]
+    end
+  end
+end

data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/chain_agent.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 module Igniter
-  module Agents
+  module AI
+    module Agents
     # Executes a sequence of callables where each step's output becomes the
     # next step's input.
     #
@@ -22,7 +23,7 @@ module Igniter
     #   ])
     #   ref.send(:run, input: long_article, context: { target_lang: "es" })
     #   steps = ref.call(:results)
-    class ChainAgent < Igniter::Agent
+      class ChainAgent < Igniter::Agent
       # Immutable record for one completed step.
       StepResult = Struct.new(:name, :input, :output, :status, keyword_init: true)
 
@@ -122,6 +123,7 @@ module Igniter
       rescue StandardError => e
         [e.message, :error]
       end
+      end
     end
   end
 end

data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/critic_agent.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 module Igniter
-  module Agents
+  module AI
+    module Agents
     # Evaluates output quality and optionally retries generation until a score
     # threshold is met.
     #
@@ -33,7 +34,7 @@ module Igniter
     #     generator:      ->(draft:) { improve_draft(draft) },
     #     generator_args: { draft: first_draft }
     #   )
-    class CriticAgent < Igniter::Agent
+      class CriticAgent < Igniter::Agent
       # Immutable evaluation result.
       Evaluation = Struct.new(:score, :feedback, :passed, :criteria, keyword_init: true)
 
@@ -158,6 +159,7 @@ module Igniter
 
         [7.5, "Output meets basic length criteria"]
       end
+      end
     end
   end
 end

data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/evaluator_agent.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 module Igniter
-  module Agents
+  module AI
+    module Agents
     # Tracks performance metrics for named subjects (agents, services,
     # contracts), computes weighted aggregate scores, and compares subjects
     # against each other or against stored baselines.
@@ -21,7 +22,7 @@ module Igniter
     #   ref.send(:evaluate,      subject: :api)
     #   ev = ref.call(:evaluations, subject: :api).last
     #   puts ev.grade   # => "A"
-    class EvaluatorAgent < Igniter::Agent
+      class EvaluatorAgent < Igniter::Agent
       MetricRecord = Struct.new(:name, :value, :recorded_at, keyword_init: true)
       Evaluation   = Struct.new(:subject, :score, :grade, :metrics,
                                 :recorded_at, keyword_init: true)
@@ -188,6 +189,7 @@ module Igniter
           recorded_at: Time.now
         )
       end
+      end
     end
   end
 end

data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/evolution_agent.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 module Igniter
-  module Agents
+  module AI
+    module Agents
     # Mission: become better.
     #
     # An evolutionary self-improvement agent that maintains a population of
@@ -33,7 +34,7 @@ module Igniter
     #   ])
     #   3.times { ref.send(:run_generation) }
     #   best = ref.call(:best)   # => Strategy struct
-    class EvolutionAgent < Igniter::Agent
+      class EvolutionAgent < Igniter::Agent
       # An individual strategy in the population.
       Strategy = Struct.new(:id, :config, :fitness, :generation,
                             :parent_ids, :mutations, keyword_init: true)
@@ -281,6 +282,7 @@ module Igniter
           "#{k}: #{original[k].inspect} → #{mutated[k].inspect}" if original[k] != mutated[k]
         end
       end
+      end
     end
   end
 end

data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/observer_agent.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 module Igniter
-  module Agents
+  module AI
+    module Agents
     # Passive-watching agent that records observations from other agents or
     # systems, applies user-defined anomaly-detection rules, and surfaces
     # detected anomalies for inspection or alerting.
@@ -22,7 +23,7 @@ module Igniter
     #   ref.send(:observe, subject: :payments, event: :error)
     #   ref.send(:check)
     #   ref.call(:anomalies)   # => [Anomaly(...)]
-    class ObserverAgent < Igniter::Agent
+      class ObserverAgent < Igniter::Agent
       # A single recorded event.
       Observation = Struct.new(:subject, :event, :data, :observed_at, keyword_init: true)
 
@@ -179,6 +180,7 @@ module Igniter
       on :configure do |state:, payload:|
         state.merge(payload.slice(:max_observations).compact)
       end
+      end
     end
   end
 end

data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/planner_agent.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 module Igniter
-  module Agents
+  module AI
+    module Agents
     # Decomposes a goal into an ordered sequence of steps and executes them.
     #
     # Implements a lightweight ReAct-style planning loop:
@@ -39,7 +40,7 @@ module Igniter
     #   })
     #   ref.send(:run_to_completion, goal: "Build a landing page", context: { tone: :casual })
     #   puts ref.call(:status).inspect
-    class PlannerAgent < Igniter::Agent
+      class PlannerAgent < Igniter::Agent
       # Immutable step record.
       Step = Struct.new(:index, :description, :status, :result, keyword_init: true)
 
@@ -205,6 +206,7 @@ module Igniter
             .map { |l| l.sub(/\A\s*\d+[\.\)\-]\s*/, "").strip }
             .reject(&:empty?)
       end
+      end
     end
   end
 end

data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/router_agent.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 module Igniter
-  module Agents
+  module AI
+    module Agents
     # Classifies incoming tasks by intent and dispatches to registered handlers.
     #
     # Two classification modes:
@@ -25,7 +26,7 @@ module Igniter
     #   ref.send(:configure_llm, executor: MyLLMClassifier.new)
     #   ref.send(:register_route, intent: :billing, handler: BillingSkill.new)
     #   ref.send(:route, task: "charge me for the premium plan")
-    class RouterAgent < Igniter::Agent
+      class RouterAgent < Igniter::Agent
       # Returned by :routes sync query.
       RouteInfo = Struct.new(:intent, :handler_class, keyword_init: true)
 
@@ -126,6 +127,7 @@ module Igniter
         task_lower = task.to_s.downcase
         routes.keys.find { |intent| task_lower.include?(intent.to_s.downcase) }
       end
+      end
     end
   end
 end

data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/self_reflection_agent.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 module Igniter
-  module Agents
+  module AI
+    module Agents
     # Reflects on a rolling window of past action episodes, surfaces patterns
     # in failures and successes, and proposes behavioural patches.
     #
@@ -18,7 +19,7 @@ module Igniter
     #   ref.send(:reflect)
     #   status = ref.call(:status)   # => StatusInfo struct
     #   recs   = ref.call(:reflections)
-    class SelfReflectionAgent < Igniter::Agent
+      class SelfReflectionAgent < Igniter::Agent
       # Sync-query return type.
       StatusInfo = Struct.new(:episodes, :reflections, :patches_applied,
                               :last_reflected_at, keyword_init: true)
@@ -170,6 +171,7 @@ module Igniter
 
         ["Reflected on #{total} episodes. #{rate}% success rate.", insights, patch]
       end
+      end
     end
   end
 end

data/packages/igniter-agents/lib/igniter/ai/agents.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "igniter/agent"
+require_relative "agents/router_agent"
+require_relative "agents/critic_agent"
+require_relative "agents/planner_agent"
+require_relative "agents/chain_agent"
+require_relative "agents/self_reflection_agent"
+require_relative "agents/observer_agent"
+require_relative "agents/evaluator_agent"
+require_relative "agents/evolution_agent"
+
+module Igniter
+  module AI
+    module Agents
+      # Convenience method — list all built-in AI agents.
+      #
+      # @return [Array<Class>]
+      def self.all
+        [RouterAgent, CriticAgent, PlannerAgent, ChainAgent,
+         SelfReflectionAgent, ObserverAgent, EvaluatorAgent, EvolutionAgent]
+      end
+    end
+  end
+end

data/{lib → packages/igniter-agents/lib}/igniter/registry.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "igniter/core/errors"
+
 module Igniter
   # Thread-safe process registry mapping names to agent Refs.
   #

data/packages/igniter-agents/lib/igniter/runtime/registry_agent_adapter.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require "igniter/core/runtime/agent_adapter"
+
+module Igniter
+  module Runtime
+    # Default agent-node adapter backed by the local process registry.
+    #
+    # This keeps core independent from actor runtime details while still giving
+    # embedded/app usage a straightforward execution model for agent nodes.
+    class RegistryAgentAdapter < AgentAdapter
+      def call(node:, inputs:, execution: nil) # rubocop:disable Lint/UnusedMethodArgument
+        ref = fetch_ref(node)
+        return ref if ref.is_a?(Hash)
+
+        {
+          status: :succeeded,
+          output: ref.call(node.message_name, inputs, timeout: node.timeout),
+          agent_trace: success_trace(node, outcome: :replied)
+        }
+      rescue Igniter::PendingDependencyError => e
+        pending(node, e)
+      rescue Igniter::Agent::TimeoutError => e
+        failure(node, e.message, reason: :timeout)
+      end
+
+      def cast(node:, inputs:, execution: nil) # rubocop:disable Lint/UnusedMethodArgument
+        ref = fetch_ref(node)
+        return ref if ref.is_a?(Hash)
+
+        ref.send(node.message_name, inputs)
+        { status: :succeeded, output: nil, agent_trace: success_trace(node, outcome: :sent) }
+      end
+
+      private
+
+      def fetch_ref(node)
+        ref = Igniter::Registry.find(node.agent_name)
+        return failure(node, "No registered agent #{node.agent_name.inspect} is available", reason: :not_registered, registered: false, alive: false) unless ref
+        return failure(node, "Registered agent #{node.agent_name.inspect} is not alive", reason: :not_alive, registered: true, alive: false) unless ref.alive?
+
+        ref
+      end
+
+      def success_trace(node, outcome:)
+        {
+          adapter: :registry,
+          mode: node.mode,
+          via: node.agent_name,
+          message: node.message_name,
+          local: true,
+          registered: true,
+          alive: true,
+          outcome: outcome
+        }
+      end
+
+      def failure(node, message, reason:, registered: nil, alive: nil)
+        {
+          status: :failed,
+          error: { message: message },
+          agent_trace: compact_trace({
+            adapter: :registry,
+            mode: node.mode,
+            via: node.agent_name,
+            message: node.message_name,
+            local: true,
+            registered: registered,
+            alive: alive,
+            reason: reason
+          })
+        }
+      end
+
+      def pending(node, error)
+        {
+          status: :pending,
+          message: error.message,
+          deferred_result: error.deferred_result,
+          payload: error.deferred_result&.payload || {},
+          agent_trace: success_trace(node, outcome: :pending)
+        }
+      end
+
+      def compact_trace(trace)
+        trace.each_with_object({}) do |(key, value), memo|
+          memo[key] = value unless value.nil?
+        end
+      end
+    end
+
+    class << self
+      def activate_agent_adapter!
+        self.agent_adapter = RegistryAgentAdapter.new
+      end
+
+      def deactivate_agent_adapter!
+        self.agent_adapter = AgentAdapter.new
+      end
+    end
+  end
+end

data/{lib → packages/igniter-agents/lib}/igniter/supervisor.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require "igniter/core/errors"
+require_relative "agent"
+
 module Igniter
   # Supervises a group of agents and restarts them when they crash.
   #

data/packages/igniter-agents/lib/igniter-agents.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require_relative "igniter/agent"
+require_relative "igniter/registry"
+require_relative "igniter/supervisor"
+require_relative "igniter/agents"
+require_relative "igniter/ai/agents"

data/packages/igniter-ai/README.md

@@ -0,0 +1,20 @@
+# igniter-ai
+
+Local monorepo gem that owns Igniter's AI capability pack:
+
+- `Igniter::AI`
+- AI executors and skills
+- tool registry and tool-use loop support
+- LLM providers
+- transcription providers and result types
+
+Primary entrypoints:
+
+- `require "igniter-ai"`
+- `require "igniter/ai"`
+
+Docs:
+
+- [Guide](../../docs/guide/README.md)
+- [SDK guide](../../docs/guide/sdk.md)
+- [Dev](../../docs/dev/README.md)

data/{lib/igniter/integrations/llm → packages/igniter-ai/lib/igniter/ai}/config.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Igniter
-  module LLM
+  module AI
     class Config
       class OllamaConfig
         attr_accessor :base_url, :default_model, :timeout

data/{lib/igniter/integrations/llm → packages/igniter-ai/lib/igniter/ai}/context.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 module Igniter
-  module LLM
+  module AI
     # Manages a conversation message history for multi-turn LLM interactions.
     # Immutable — each operation returns a new Context.
     #
     # Usage:
-    #   ctx = Igniter::LLM::Context.empty(system: "You are a helpful assistant.")
+    #   ctx = Igniter::AI::Context.empty(system: "You are a helpful assistant.")
     #   ctx = ctx.append_user("What is Ruby?")
     #   ctx = ctx.append_assistant("Ruby is a dynamic language...")
     #   ctx.messages  # => [{role: :system, ...}, {role: :user, ...}, {role: :assistant, ...}]