agentic 0.1.0 → 0.2.0

data/lib/agentic/verification/verification_result.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Agentic
+  module Verification
+    # Represents the result of a verification process
+    class VerificationResult
+      # @return [String] The ID of the task that was verified
+      attr_reader :task_id
+
+      # @return [Boolean] Whether the verification passed
+      attr_reader :verified
+
+      # @return [Float] The confidence score (0.0-1.0) of the verification
+      attr_reader :confidence
+
+      # @return [Array<String>] Messages from the verification process
+      attr_reader :messages
+
+      # Initializes a new VerificationResult
+      # @param task_id [String] The ID of the task that was verified
+      # @param verified [Boolean] Whether the verification passed
+      # @param confidence [Float] The confidence score (0.0-1.0) of the verification
+      # @param messages [Array<String>] Messages from the verification process
+      def initialize(task_id:, verified:, confidence:, messages: [])
+        @task_id = task_id
+        @verified = verified
+        @confidence = confidence
+        @messages = messages
+      end
+
+      # Checks if the verification passed with high confidence
+      # @param threshold [Float] The confidence threshold
+      # @return [Boolean] Whether verification passed with confidence above the threshold
+      def verified_with_confidence?(threshold: 0.8)
+        @verified && @confidence >= threshold
+      end
+
+      # Converts the verification result to a hash
+      # @return [Hash] The verification result as a hash
+      def to_h
+        {
+          task_id: @task_id,
+          verified: @verified,
+          confidence: @confidence,
+          messages: @messages
+        }
+      end
+    end
+  end
+end

data/lib/agentic/verification/verification_strategy.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Agentic
+  module Verification
+    # Base class for verification strategies
+    class VerificationStrategy
+      # @return [Hash] Configuration options for the strategy
+      attr_reader :config
+
+      # Initializes a new VerificationStrategy
+      # @param config [Hash] Configuration options for the strategy
+      def initialize(config = {})
+        @config = config
+      end
+
+      # Verifies a task result
+      # @param task [Task] The task to verify
+      # @param result [TaskResult] The result to verify
+      # @return [VerificationResult] The verification result
+      # @raise [NotImplementedError] This method must be implemented by subclasses
+      def verify(task, result)
+        raise NotImplementedError, "Subclasses must implement verify"
+      end
+    end
+  end
+end

data/lib/agentic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Agentic
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/agentic.rb

@@ -2,8 +2,29 @@
 
 require "zeitwerk"
 loader = Zeitwerk::Loader.for_gem
+
+# Configure Zeitwerk to handle the CLI class name properly
+loader.inflector.inflect(
+  "cli" => "CLI"
+)
+
+# Configure paths that need to be eager loaded or excluded from Zeitwerk
+loader.do_not_eager_load("#{__dir__}/agentic/cli")
+
 loader.setup
 
+# Explicitly require Thor-related components to avoid Zeitwerk issues with Thor
+# Thor requires subcommands to be loaded before they're referenced
+require_relative "agentic/ui"
+require_relative "agentic/default_agent_provider"
+require_relative "agentic/cli"
+require_relative "agentic/cli/execution_observer"
+require_relative "agentic/extension"
+require_relative "agentic/capabilities"
+require_relative "agentic/agent_assembly_engine"
+require_relative "agentic/llm_assisted_composition_strategy"
+require_relative "agentic/task_output_schemas"
+
 module Agentic
   class Error < StandardError; end
 
@@ -14,15 +35,18 @@ module Agentic
   self.logger ||= Logger.new($stdout, level: :debug)
 
   class Configuration
-    attr_accessor :access_token
+    attr_accessor :access_token, :agent_store_path, :api_base_url
 
     def initialize
-      @access_token = ENV["OPENAI_ACCESS_TOKEN"]
+      @access_token = ENV["OPENAI_ACCESS_TOKEN"] || ENV["AGENTIC_API_TOKEN"] || "ollama"
+      @agent_store_path = ENV["AGENTIC_AGENT_STORE_PATH"] || File.join(Dir.home, ".agentic", "agents")
+      @api_base_url = ENV["AGENTIC_API_BASE_URL"] || ENV["OPENAI_BASE_URL"]
     end
   end
 
   class << self
     attr_writer :configuration
+    attr_reader :agent_capability_registry, :agent_assembly_engine, :agent_store
   end
 
   def self.configuration
@@ -36,4 +60,52 @@ module Agentic
   def self.client(config)
     LlmClient.new(config)
   end
+
+  # Initialize the core agent self-assembly components
+  def self.initialize_agent_assembly
+    # Create registry, store, and assembly engine if not already initialized
+    unless @agent_capability_registry
+      @agent_capability_registry = AgentCapabilityRegistry.instance
+      @agent_store = PersistentAgentStore.new(configuration.agent_store_path, @agent_capability_registry)
+      @agent_assembly_engine = AgentAssemblyEngine.new(@agent_capability_registry, @agent_store)
+
+      # Register standard capabilities
+      Capabilities.register_standard_capabilities
+
+      logger.info("Initialized agent assembly system")
+    end
+  end
+
+  # Register a capability with the system
+  # @param capability [CapabilitySpecification] The capability to register
+  # @param provider [CapabilityProvider] The provider for the capability
+  # @return [CapabilitySpecification] The registered capability
+  def self.register_capability(capability, provider)
+    initialize_agent_assembly
+    @agent_capability_registry.register(capability, provider)
+  end
+
+  # Assemble an agent for a task
+  # @param task [Task] The task to assemble an agent for
+  # @param strategy [AgentCompositionStrategy, nil] The strategy to use
+  # @param store [Boolean] Whether to use the agent store
+  # @param use_llm [Boolean] Whether to use LLM-assisted strategy if no strategy provided
+  # @return [Agent] The assembled agent
+  def self.assemble_agent(task, strategy: nil, store: true, use_llm: false)
+    initialize_agent_assembly
+
+    # Use LLM-assisted strategy if requested and no strategy provided
+    if use_llm && strategy.nil?
+      strategy = LlmAssistedCompositionStrategy.new
+    end
+
+    @agent_assembly_engine.assemble_agent(task, strategy: strategy, store: store)
+  end
+
+  # Create an LLM-assisted composition strategy
+  # @param llm_config [LlmConfig, nil] The LLM config to use
+  # @return [LlmAssistedCompositionStrategy] The strategy
+  def self.llm_assisted_strategy(llm_config = nil)
+    LlmAssistedCompositionStrategy.new(llm_config)
+  end
 end

data/plugins/README.md

@@ -0,0 +1,41 @@
+# Agentic Plugins
+
+This directory contains plugins for the Agentic framework. Plugins provide additional functionality that can be loaded by the `Agentic::Extension::PluginManager`.
+
+## Creating a Plugin
+
+A valid plugin must implement the following interface:
+
+```ruby
+class ExamplePlugin
+  # Initialize the plugin with configuration options
+  def initialize_plugin(config = {})
+    # Initialize plugin with config
+  end
+  
+  # Execute the plugin functionality
+  def call(*args)
+    # Plugin functionality
+  end
+end
+```
+
+## Loading Plugins
+
+Plugins in this directory are automatically discovered and loaded by the `PluginManager` if auto-discovery is enabled (which is the default behavior).
+
+You can also manually register plugins:
+
+```ruby
+plugin_manager = Agentic::Extension.plugin_manager
+plugin_manager.register("my_plugin", MyPlugin.new, { version: "1.0.0" })
+```
+
+## Using Plugins
+
+To use a registered plugin:
+
+```ruby
+plugin = Agentic::Extension.plugin_manager.get("my_plugin")
+plugin.call(arg1, arg2) if plugin
+```

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: agentic
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Valentino Stoll
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-08-28 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-schema
@@ -52,6 +51,132 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: tty-spinner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: tty-progressbar
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+- !ruby/object:Gem::Dependency
+  name: tty-box
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: tty-table
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+- !ruby/object:Gem::Dependency
+  name: tty-cursor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: pastel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  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'
 description: Easily build, manage, deploy, and run self-contained purpose-driven AI
   Agents.
 email:
@@ -61,24 +186,140 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".agentic.yml"
+- ".architecture/decisions/ArchitecturalFeatureBuilder.md"
+- ".architecture/decisions/ArchitectureConsiderations.md"
+- ".architecture/decisions/adr_001_observer_pattern_implementation.md"
+- ".architecture/decisions/adr_002_plan_orchestrator.md"
+- ".architecture/decisions/adr_003_plan_orchestrator_interface.md"
+- ".architecture/decisions/adrs/ADR-001-dependency-management.md"
+- ".architecture/decisions/adrs/ADR-002-system-boundaries.md"
+- ".architecture/decisions/adrs/ADR-003-content-safety.md"
+- ".architecture/decisions/adrs/ADR-004-agent-permissions.md"
+- ".architecture/decisions/adrs/ADR-005-adaptation-engine.md"
+- ".architecture/decisions/adrs/ADR-006-extension-system.md"
+- ".architecture/decisions/adrs/ADR-007-learning-system.md"
+- ".architecture/decisions/adrs/ADR-008-prompt-generation.md"
+- ".architecture/decisions/adrs/ADR-009-task-failure-handling.md"
+- ".architecture/decisions/adrs/ADR-010-task-input-handling.md"
+- ".architecture/decisions/adrs/ADR-011-task-observable-pattern.md"
+- ".architecture/decisions/adrs/ADR-012-task-output-handling.md"
+- ".architecture/decisions/adrs/ADR-013-architecture-alignment.md"
+- ".architecture/decisions/adrs/ADR-014-agent-capability-registry.md"
+- ".architecture/decisions/adrs/ADR-015-persistent-agent-store.md"
+- ".architecture/decisions/adrs/ADR-016-agent-assembly-engine.md"
+- ".architecture/decisions/adrs/ADR-017-streaming-observability.md"
+- ".architecture/decisions/capability_tools_distinction.md"
+- ".architecture/decisions/cli_command_structure.md"
+- ".architecture/implementation/agent_self_assembly_implementation.md"
+- ".architecture/implementation/agent_self_assembly_summary.md"
+- ".architecture/members.yml"
+- ".architecture/planning/self_implementation_exercise.md"
+- ".architecture/planning/session_compaction_rule.md"
+- ".architecture/planning/streaming_observability_feature.md"
+- ".architecture/principles.md"
+- ".architecture/recalibration/0-2-0.md"
+- ".architecture/recalibration/agent_self_assembly.md"
+- ".architecture/recalibration/cli_command_structure.md"
+- ".architecture/recalibration/implementation_roadmap_0-2-0.md"
+- ".architecture/recalibration/progress_tracking_0-2-0.md"
+- ".architecture/recalibration_process.md"
+- ".architecture/reviews/0-2-0.md"
+- ".architecture/reviews/cli_command_duplication.md"
+- ".architecture/templates/adr.md"
+- ".architecture/templates/implementation_roadmap.md"
+- ".architecture/templates/progress_tracking.md"
+- ".architecture/templates/recalibration_plan.md"
+- ".architecture/templates/version_comparison.md"
+- ".claude-sessions/001-task-class-architecture-implementation.md"
+- ".claude-sessions/002-plan-orchestrator-interface-review.md"
+- ".claude-sessions/architecture-governance-implementation.md"
+- ".claude-sessions/architecture-review-session.md"
+- ".claude/settings.local.json"
 - ".rspec"
 - ".rubocop.yml"
 - ".standard.yml"
+- ArchitecturalFeatureBuilder.md
+- ArchitectureConsiderations.md
 - CHANGELOG.md
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
 - LICENSE.txt
+- MAINTAINING.md
 - README.md
 - Rakefile
+- docs/agent_capabilities_api.md
+- docs/artifact_extension_points.md
+- docs/artifact_generation_architecture.md
+- docs/artifact_implementation_plan.md
+- docs/artifact_integration_points.md
+- docs/artifact_verification_strategies.md
+- docs/streaming_observability_architecture.md
 - exe/agentic
+- lefthook.yml
 - lib/agentic.rb
+- lib/agentic/adaptation_engine.rb
 - lib/agentic/agent.rb
+- lib/agentic/agent_assembly_engine.rb
+- lib/agentic/agent_capability_registry.rb
+- lib/agentic/agent_config.rb
+- lib/agentic/agent_specification.rb
+- lib/agentic/capabilities.rb
+- lib/agentic/capabilities/examples.rb
+- lib/agentic/capability_provider.rb
+- lib/agentic/capability_specification.rb
+- lib/agentic/cli.rb
+- lib/agentic/cli/agent.rb
+- lib/agentic/cli/capabilities.rb
+- lib/agentic/cli/config.rb
+- lib/agentic/cli/execution_observer.rb
+- lib/agentic/default_agent_provider.rb
+- lib/agentic/errors/llm_error.rb
+- lib/agentic/execution_plan.rb
+- lib/agentic/execution_result.rb
+- lib/agentic/expected_answer_format.rb
+- lib/agentic/extension.rb
+- lib/agentic/extension/domain_adapter.rb
+- lib/agentic/extension/plugin_manager.rb
+- lib/agentic/extension/protocol_handler.rb
 - lib/agentic/factory_methods.rb
+- lib/agentic/generation_stats.rb
+- lib/agentic/learning.rb
+- lib/agentic/learning/README.md
+- lib/agentic/learning/capability_optimizer.rb
+- lib/agentic/learning/execution_history_store.rb
+- lib/agentic/learning/pattern_recognizer.rb
+- lib/agentic/learning/strategy_optimizer.rb
+- lib/agentic/llm_assisted_composition_strategy.rb
 - lib/agentic/llm_client.rb
 - lib/agentic/llm_config.rb
+- lib/agentic/llm_response.rb
 - lib/agentic/logger.rb
+- lib/agentic/observable.rb
+- lib/agentic/persistent_agent_store.rb
+- lib/agentic/plan_execution_result.rb
+- lib/agentic/plan_orchestrator.rb
+- lib/agentic/plan_orchestrator_config.rb
+- lib/agentic/retry_config.rb
+- lib/agentic/retry_handler.rb
 - lib/agentic/structured_outputs.rb
+- lib/agentic/task.rb
+- lib/agentic/task_definition.rb
+- lib/agentic/task_execution_result.rb
+- lib/agentic/task_failure.rb
+- lib/agentic/task_output_schemas.rb
 - lib/agentic/task_planner.rb
+- lib/agentic/task_result.rb
+- lib/agentic/ui.rb
+- lib/agentic/verification/critic_framework.rb
+- lib/agentic/verification/llm_verification_strategy.rb
+- lib/agentic/verification/schema_verification_strategy.rb
+- lib/agentic/verification/verification_hub.rb
+- lib/agentic/verification/verification_result.rb
+- lib/agentic/verification/verification_strategy.rb
 - lib/agentic/version.rb
+- plugins/README.md
 - sig/agentic/builder.rbs
 homepage: https://github.com/codenamev/agentic
 licenses:
@@ -88,7 +329,6 @@ metadata:
   source_code_uri: https://github.com/codenamev/agentic
   changelog_uri: https://github.com/codenamev/agentic/tree/main/CHANGELOG.md
   allowed_push_host: https://rubygems.org
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -103,8 +343,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: An AI Agent builder and orchestrator
 test_files: []