igniter 0.4.3 → 0.5.0

data/lib/igniter/tool.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Igniter
+  # Base class for AI-callable tools.
+  #
+  # Extends +Igniter::Executor+ with declarative metadata for LLM function-calling
+  # (Anthropic, OpenAI) and capability-based access guards.
+  # Shares the discovery DSL with +Igniter::Skill+ via +Tool::Discoverable+.
+  #
+  # == Defining a tool
+  #
+  #   class SearchWeb < Igniter::Tool
+  #     description "Search the internet for current information"
+  #
+  #     param :query,       type: :string,  required: true,  desc: "The search query"
+  #     param :max_results, type: :integer, default: 5,      desc: "Max results to return"
+  #
+  #     requires_capability :web_access
+  #
+  #     def call(query:, max_results: 5)
+  #       [{ title: "...", url: "...", snippet: "..." }]
+  #     end
+  #   end
+  #
+  # == Schema generation
+  #
+  #   SearchWeb.tool_name             # => "search_web"
+  #   SearchWeb.to_schema             # => { name:, description:, parameters: { ... } }
+  #   SearchWeb.to_schema(:anthropic) # => { name:, description:, input_schema: { ... } }
+  #   SearchWeb.to_schema(:openai)    # => { type: "function", function: { ... } }
+  #
+  # == Compatibility
+  #
+  # Tool inherits +Igniter::Executor+ — usable as a compute node in any Contract graph.
+  class Tool < Executor
+    # Raised when a tool or skill requires a capability the calling agent does not have.
+    # Also aliased as +Igniter::Skill::CapabilityError+.
+    class CapabilityError < Igniter::Error; end
+
+    require_relative "tool/discoverable"
+    include Discoverable
+
+    def self.inherited(subclass)
+      super
+      # Tool subclasses always start with empty params and capabilities —
+      # each concrete tool declares its own. Only the description carries forward.
+      subclass.instance_variable_set(:@tool_params, [])
+      subclass.instance_variable_set(:@required_capabilities, [].freeze)
+      subclass.instance_variable_set(:@tool_description, @tool_description)
+    end
+  end
+end

data/lib/igniter/tool_registry.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+require_relative "tool"
+require_relative "skill"
+
+module Igniter
+  # Global registry for Igniter::Tool and Igniter::Skill classes.
+  #
+  # Both Tools (atomic operations) and Skills (agentic sub-processes) share the
+  # same discovery interface and are registered the same way. The registry does
+  # not distinguish between them — from a caller's perspective both are callable
+  # units described by name, description, and a parameter schema.
+  #
+  # == Scopes
+  #
+  # Every entry belongs to one of three scopes:
+  #   :bundled   — shipped with the core library
+  #   :managed   — installed from an external registry or package manager
+  #   :workspace — local, app-specific (default)
+  #
+  # Scope does not affect capability filtering or schema generation unless you
+  # pass +scope:+ explicitly. All existing calls without +scope:+ continue to
+  # work exactly as before.
+  #
+  # == Registration
+  #
+  #   Igniter::ToolRegistry.register(SearchWeb, WriteFile, ResearchSkill)
+  #   Igniter::ToolRegistry.register(WeatherTool, scope: :bundled)
+  #
+  # == Discovery
+  #
+  #   Igniter::ToolRegistry.all
+  #   # => [SearchWeb, WriteFile, ResearchSkill, WeatherTool]
+  #
+  #   Igniter::ToolRegistry.all(scope: :bundled)
+  #   # => [WeatherTool]
+  #
+  #   Igniter::ToolRegistry.tools_for(capabilities: [:web_access])
+  #   Igniter::ToolRegistry.tools_for(capabilities: [:web_access], scope: :workspace)
+  #
+  # == Schema generation
+  #
+  #   Igniter::ToolRegistry.schemas(:anthropic)
+  #   Igniter::ToolRegistry.schemas(:openai, capabilities: [:web_access], scope: :managed)
+  module ToolRegistry
+    # Valid scope identifiers, ordered from least to most specific.
+    SCOPES = %i[bundled managed workspace].freeze
+
+    # Internal store: { tool_name_string => { klass: Class, scope: Symbol } }
+    @tools = {}
+
+    class << self
+      # Register one or more Tool or Skill subclasses.
+      #
+      # @param tool_classes [Array<Class>] Tool or Skill subclasses
+      # @param scope        [Symbol]       :bundled, :managed, or :workspace (default)
+      # @raise [ArgumentError] if a class is not discoverable or scope is invalid
+      def register(*tool_classes, scope: :workspace) # rubocop:disable Metrics/MethodLength
+        unless SCOPES.include?(scope)
+          raise ArgumentError, "Invalid scope #{scope.inspect}. Must be one of #{SCOPES.inspect}"
+        end
+
+        tool_classes.flatten.each do |klass|
+          unless discoverable?(klass)
+            raise ArgumentError,
+                  "#{klass.inspect} must be an Igniter::Tool or Igniter::Skill subclass"
+          end
+
+          @tools[klass.tool_name] = { klass: klass, scope: scope }
+        end
+        self
+      end
+
+      # Look up a tool or skill by its snake_case name.
+      # @param name [String, Symbol]
+      # @return [Class, nil]
+      def find(name)
+        @tools[name.to_s]&.fetch(:klass)
+      end
+
+      # All registered classes, optionally filtered by scope.
+      #
+      # @param scope [Symbol, nil] :bundled, :managed, :workspace, or nil for all
+      # @return [Array<Class>]
+      def all(scope: nil)
+        entries_for(scope).map { |e| e[:klass] }
+      end
+
+      # Classes whose required capabilities are fully covered by +capabilities+.
+      # Tools/skills with no required capabilities are always included.
+      #
+      # @param capabilities [Array<Symbol>]
+      # @param scope        [Symbol, nil]
+      # @return [Array<Class>]
+      def tools_for(capabilities: [], scope: nil)
+        allowed  = capabilities.map(&:to_sym).to_set
+        matching = entries_for(scope).select do |e|
+          e[:klass].required_capabilities.all? { |c| allowed.include?(c) }
+        end
+        matching.map { |e| e[:klass] }
+      end
+
+      # Generate schemas for the given provider.
+      # Optionally filter by capabilities and/or scope.
+      #
+      # @param provider      [Symbol]        :anthropic, :openai, or nil for intermediate
+      # @param capabilities  [Array<Symbol>] optional capability filter
+      # @param scope         [Symbol, nil]   optional scope filter
+      # @return [Array<Hash>]
+      def schemas(provider = nil, capabilities: nil, scope: nil)
+        list = if capabilities
+                 tools_for(capabilities: capabilities, scope: scope)
+               else
+                 all(scope: scope)
+               end
+        list.map { |klass| klass.to_schema(provider) }
+      end
+
+      # Number of registered classes (across all scopes).
+      def size = @tools.size
+
+      # True if nothing is registered.
+      def empty? = @tools.empty?
+
+      # Remove all registrations (primarily for tests).
+      def clear!
+        @tools = {}
+        self
+      end
+
+      private
+
+      def entries_for(scope)
+        scope ? @tools.values.select { |e| e[:scope] == scope } : @tools.values
+      end
+
+      # A class is discoverable if it is a Tool or Skill (includes Tool::Discoverable).
+      def discoverable?(klass)
+        klass.is_a?(Class) &&
+          (klass < Igniter::Tool || klass < Igniter::Skill)
+      end
+    end
+  end
+end

data/lib/igniter/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Igniter
-  VERSION = "0.4.3"
+  VERSION = "0.5.0"
 end

data/lib/igniter.rb

@@ -30,6 +30,23 @@ module Igniter
       @execution_store = store
     end
 
+    # TTL cache backend for compute nodes. nil = disabled (default).
+    # Set to Igniter::NodeCache::Memory.new (or a Redis-backed equivalent).
+    def node_cache
+      defined?(Igniter::NodeCache) ? Igniter::NodeCache.cache : nil
+    end
+
+    def node_cache=(cache)
+      require_relative "igniter/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"
+      Igniter::NodeCache.coalescing_lock = enabled ? Igniter::NodeCache::CoalescingLock.new : nil
+    end
+
     def register_executor(key, executor_class, **metadata)
       executor_registry.register(key, executor_class, **metadata)
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: igniter
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 0.5.0
 platform: ruby
 authors:
 - Alexander
@@ -50,17 +50,29 @@ files:
 - LICENSE.txt
 - README.md
 - docs/API_V2.md
+- docs/APPLICATION_V1.md
 - docs/ARCHITECTURE_V2.md
 - docs/BACKLOG.md
 - docs/BRANCHES_V1.md
+- docs/CAPABILITIES_V1.md
 - docs/COLLECTIONS_V1.md
+- docs/CONSENSUS_V1.md
+- docs/CONTENT_ADDRESSING_V1.md
+- docs/DATAFLOW_V1.md
 - docs/DISTRIBUTED_CONTRACTS_V1.md
 - docs/EXECUTION_MODEL_V2.md
 - docs/IGNITER_CONCEPTS.md
 - docs/LLM_V1.md
+- docs/MESH_V1.md
+- docs/NODE_CACHE_V1.md
 - docs/PATTERNS.md
+- docs/PROACTIVE_AGENTS_V1.md
 - docs/SERVER_V1.md
+- docs/SKILLS_V1.md
 - docs/STORE_ADAPTERS.md
+- docs/TEMPORAL_V1.md
+- docs/TOOLS_V1.md
+- docs/TRANSCRIPTION_V1.md
 - examples/README.md
 - examples/agents.rb
 - examples/async_store.rb
@@ -68,13 +80,21 @@ files:
 - examples/collection.rb
 - examples/collection_partial_failure.rb
 - examples/composition.rb
+- examples/consensus.rb
+- examples/dataflow.rb
 - examples/diagnostics.rb
 - examples/differential.rb
 - examples/distributed_server.rb
 - examples/distributed_workflow.rb
 - examples/effects.rb
+- examples/elocal_webhook.rb
+- examples/incremental.rb
 - examples/invariants.rb
+- examples/llm_tools.rb
 - examples/marketing_ergonomics.rb
+- examples/mesh.rb
+- examples/mesh_discovery.rb
+- examples/mesh_gossip.rb
 - examples/order_pipeline.rb
 - examples/provenance.rb
 - examples/ringcentral_routing.rb
@@ -86,6 +106,29 @@ files:
 - lib/igniter/agent/ref.rb
 - lib/igniter/agent/runner.rb
 - lib/igniter/agent/state_holder.rb
+- lib/igniter/agents.rb
+- lib/igniter/agents/ai/alert_agent.rb
+- lib/igniter/agents/ai/chain_agent.rb
+- lib/igniter/agents/ai/critic_agent.rb
+- lib/igniter/agents/ai/evaluator_agent.rb
+- lib/igniter/agents/ai/evolution_agent.rb
+- lib/igniter/agents/ai/health_check_agent.rb
+- lib/igniter/agents/ai/observer_agent.rb
+- lib/igniter/agents/ai/planner_agent.rb
+- lib/igniter/agents/ai/router_agent.rb
+- lib/igniter/agents/ai/self_reflection_agent.rb
+- lib/igniter/agents/observability/metrics_agent.rb
+- lib/igniter/agents/pipeline/batch_processor_agent.rb
+- lib/igniter/agents/proactive_agent.rb
+- lib/igniter/agents/reliability/retry_agent.rb
+- lib/igniter/agents/scheduling/cron_agent.rb
+- lib/igniter/application.rb
+- lib/igniter/application/app_config.rb
+- lib/igniter/application/autoloader.rb
+- lib/igniter/application/generator.rb
+- lib/igniter/application/scheduler.rb
+- lib/igniter/application/yml_loader.rb
+- lib/igniter/capabilities.rb
 - lib/igniter/compiler.rb
 - lib/igniter/compiler/compiled_graph.rb
 - lib/igniter/compiler/graph_compiler.rb
@@ -100,7 +143,22 @@ files:
 - lib/igniter/compiler/validators/remote_validator.rb
 - lib/igniter/compiler/validators/type_compatibility_validator.rb
 - lib/igniter/compiler/validators/uniqueness_validator.rb
+- lib/igniter/consensus.rb
+- lib/igniter/consensus/cluster.rb
+- lib/igniter/consensus/errors.rb
+- lib/igniter/consensus/executors.rb
+- lib/igniter/consensus/node.rb
+- lib/igniter/consensus/read_query.rb
+- lib/igniter/consensus/state_machine.rb
+- lib/igniter/content_addressing.rb
 - lib/igniter/contract.rb
+- lib/igniter/dataflow.rb
+- lib/igniter/dataflow/aggregate_operators.rb
+- lib/igniter/dataflow/aggregate_state.rb
+- lib/igniter/dataflow/diff.rb
+- lib/igniter/dataflow/diff_state.rb
+- lib/igniter/dataflow/incremental_collection_result.rb
+- lib/igniter/dataflow/window_filter.rb
 - lib/igniter/diagnostics.rb
 - lib/igniter/diagnostics/auditing/report/console_formatter.rb
 - lib/igniter/diagnostics/auditing/report/markdown_formatter.rb
@@ -131,19 +189,29 @@ files:
 - lib/igniter/extensions.rb
 - lib/igniter/extensions/auditing.rb
 - lib/igniter/extensions/auditing/timeline.rb
+- lib/igniter/extensions/capabilities.rb
+- lib/igniter/extensions/content_addressing.rb
+- lib/igniter/extensions/dataflow.rb
 - lib/igniter/extensions/differential.rb
 - lib/igniter/extensions/execution_report.rb
+- lib/igniter/extensions/incremental.rb
 - lib/igniter/extensions/introspection.rb
 - lib/igniter/extensions/introspection/graph_formatter.rb
 - lib/igniter/extensions/introspection/plan_formatter.rb
 - lib/igniter/extensions/introspection/runtime_formatter.rb
 - lib/igniter/extensions/invariants.rb
+- lib/igniter/extensions/mesh.rb
 - lib/igniter/extensions/provenance.rb
 - lib/igniter/extensions/reactive.rb
 - lib/igniter/extensions/reactive/engine.rb
 - lib/igniter/extensions/reactive/matcher.rb
 - lib/igniter/extensions/reactive/reaction.rb
 - lib/igniter/extensions/saga.rb
+- lib/igniter/fingerprint.rb
+- lib/igniter/incremental.rb
+- lib/igniter/incremental/formatter.rb
+- lib/igniter/incremental/result.rb
+- lib/igniter/incremental/tracker.rb
 - lib/igniter/integrations/agents.rb
 - lib/igniter/integrations/llm.rb
 - lib/igniter/integrations/llm/config.rb
@@ -153,6 +221,12 @@ files:
 - lib/igniter/integrations/llm/providers/base.rb
 - lib/igniter/integrations/llm/providers/ollama.rb
 - lib/igniter/integrations/llm/providers/openai.rb
+- lib/igniter/integrations/llm/transcription/providers/assemblyai.rb
+- lib/igniter/integrations/llm/transcription/providers/base.rb
+- lib/igniter/integrations/llm/transcription/providers/deepgram.rb
+- lib/igniter/integrations/llm/transcription/providers/openai.rb
+- lib/igniter/integrations/llm/transcription/transcriber.rb
+- lib/igniter/integrations/llm/transcription/transcript_result.rb
 - lib/igniter/integrations/rails.rb
 - lib/igniter/integrations/rails/cable_adapter.rb
 - lib/igniter/integrations/rails/contract_job.rb
@@ -161,7 +235,32 @@ files:
 - lib/igniter/integrations/rails/railtie.rb
 - lib/igniter/integrations/rails/webhook_concern.rb
 - lib/igniter/invariant.rb
+- lib/igniter/memory.rb
+- lib/igniter/memory/agent_memory.rb
+- lib/igniter/memory/episode.rb
+- lib/igniter/memory/fact.rb
+- lib/igniter/memory/memorable.rb
+- lib/igniter/memory/reflection_cycle.rb
+- lib/igniter/memory/reflection_record.rb
+- lib/igniter/memory/store.rb
+- lib/igniter/memory/stores/in_memory.rb
+- lib/igniter/memory/stores/sqlite.rb
+- lib/igniter/mesh.rb
+- lib/igniter/mesh/announcer.rb
+- lib/igniter/mesh/config.rb
+- lib/igniter/mesh/discovery.rb
+- lib/igniter/mesh/errors.rb
+- lib/igniter/mesh/gossip.rb
+- lib/igniter/mesh/peer.rb
+- lib/igniter/mesh/peer_registry.rb
+- lib/igniter/mesh/poller.rb
+- lib/igniter/mesh/router.rb
+- lib/igniter/metrics.rb
+- lib/igniter/metrics/collector.rb
+- lib/igniter/metrics/prometheus_exporter.rb
+- lib/igniter/metrics/snapshot.rb
 - lib/igniter/model.rb
+- lib/igniter/model/aggregate_node.rb
 - lib/igniter/model/await_node.rb
 - lib/igniter/model/branch_node.rb
 - lib/igniter/model/collection_node.rb
@@ -173,6 +272,7 @@ files:
 - lib/igniter/model/node.rb
 - lib/igniter/model/output_node.rb
 - lib/igniter/model/remote_node.rb
+- lib/igniter/node_cache.rb
 - lib/igniter/property_testing.rb
 - lib/igniter/property_testing/formatter.rb
 - lib/igniter/property_testing/generators.rb
@@ -185,6 +285,20 @@ files:
 - lib/igniter/provenance/node_trace.rb
 - lib/igniter/provenance/text_formatter.rb
 - lib/igniter/registry.rb
+- lib/igniter/replication.rb
+- lib/igniter/replication/bootstrapper.rb
+- lib/igniter/replication/bootstrappers/gem.rb
+- lib/igniter/replication/bootstrappers/git.rb
+- lib/igniter/replication/bootstrappers/tarball.rb
+- lib/igniter/replication/expansion_plan.rb
+- lib/igniter/replication/expansion_planner.rb
+- lib/igniter/replication/manifest.rb
+- lib/igniter/replication/network_topology.rb
+- lib/igniter/replication/node_role.rb
+- lib/igniter/replication/reflective_replication_agent.rb
+- lib/igniter/replication/replication_agent.rb
+- lib/igniter/replication/role_registry.rb
+- lib/igniter/replication/ssh_session.rb
 - lib/igniter/runtime.rb
 - lib/igniter/runtime/cache.rb
 - lib/igniter/runtime/collection_result.rb
@@ -219,13 +333,26 @@ files:
 - lib/igniter/server/handlers/event_handler.rb
 - lib/igniter/server/handlers/execute_handler.rb
 - lib/igniter/server/handlers/health_handler.rb
+- lib/igniter/server/handlers/liveness_handler.rb
+- lib/igniter/server/handlers/manifest_handler.rb
+- lib/igniter/server/handlers/metrics_handler.rb
+- lib/igniter/server/handlers/peers_handler.rb
+- lib/igniter/server/handlers/readiness_handler.rb
 - lib/igniter/server/handlers/status_handler.rb
 - lib/igniter/server/http_server.rb
 - lib/igniter/server/rack_app.rb
 - lib/igniter/server/registry.rb
 - lib/igniter/server/router.rb
+- lib/igniter/server/server_logger.rb
+- lib/igniter/skill.rb
+- lib/igniter/skill/feedback.rb
+- lib/igniter/skill/output_schema.rb
 - lib/igniter/stream_loop.rb
 - lib/igniter/supervisor.rb
+- lib/igniter/temporal.rb
+- lib/igniter/tool.rb
+- lib/igniter/tool/discoverable.rb
+- lib/igniter/tool_registry.rb
 - lib/igniter/type_system.rb
 - lib/igniter/version.rb
 - sig/igniter.rbs