a2a-ruby 1.0.0

data/lib/a2a.rb

@@ -0,0 +1,198 @@
+# frozen_string_literal: true
+
+require_relative "a2a/modules"
+require_relative "a2a/version"
+require_relative "a2a/configuration"
+require_relative "a2a/errors"
+require_relative "a2a/types"
+require_relative "a2a/plugin"
+require_relative "a2a/plugin_manager"
+require_relative "a2a/monitoring"
+
+# Core protocol components (Task 2 - Core Protocol Implementation)
+require_relative "a2a/protocol/json_rpc"
+
+# Agent card system components (Task 3 - Agent Card System Implementation)
+require_relative "a2a/protocol/capability"
+require_relative "a2a/protocol/agent_card_server"
+
+# Server components (Task 5 - Server-Side Components)
+require_relative "a2a/server/agent"
+require_relative "a2a/server/handler"
+require_relative "a2a/server/request_handler"
+require_relative "a2a/server/default_request_handler"
+require_relative "a2a/server/middleware"
+require_relative "a2a/server/task_manager"
+require_relative "a2a/server/push_notification_manager"
+require_relative "a2a/server/a2a_methods"
+
+# Transport layer components (Task 7 - Transport Layer Implementation)
+require_relative "a2a/transport/http"
+require_relative "a2a/transport/sse"
+require_relative "a2a/transport/grpc"
+
+# Client components (Task 4 - Client-Side Components)
+require_relative "a2a/client/base"
+require_relative "a2a/client/config"
+require_relative "a2a/client/http_client"
+require_relative "a2a/client/auth"
+require_relative "a2a/client/middleware"
+
+# Rails integration (Task 8 - Rails Integration) - loaded conditionally
+if defined?(Rails)
+  require_relative "a2a/rails/engine"
+  require_relative "a2a/rails/controller_helpers"
+  require_relative "a2a/rails/a2a_controller"
+end
+
+##
+# The A2A Ruby SDK
+#
+# This module provides a complete implementation of Google's Agent2Agent (A2A) Protocol
+# for Ruby applications. It supports both client and server-side A2A implementations
+# with multiple transport protocols.
+#
+# @example Basic client usage
+#   client = A2A::Client::HttpClient.new("https://agent.example.com/a2a")
+#   message = A2A::Types::Message.new(
+#     message_id: SecureRandom.uuid,
+#     role: "user",
+#     parts: [A2A::Types::TextPart.new(text: "Hello, agent!")]
+#   )
+#   response = client.send_message(message)
+#
+# @example Basic server usage
+#   class MyAgentController < ApplicationController
+#     include A2A::Server::Agent
+#
+#     a2a_skill "greeting" do |skill|
+#       skill.description = "Greet users"
+#       skill.tags = ["greeting", "conversation"]
+#     end
+#
+#     a2a_method "greet" do |params|
+#       { message: "Hello, #{params[:name]}!" }
+#     end
+#   end
+#
+module A2A
+  class << self
+    # Global configuration for the A2A SDK
+    # @return [A2A::Configuration]
+    attr_accessor :configuration
+
+    # Global plugin manager
+    # @return [A2A::PluginManager]
+    attr_accessor :plugin_manager
+
+    # Configure the A2A SDK
+    # @yield [config] Configuration block
+    # @yieldparam config [A2A::Configuration] The configuration object
+    def configure
+      self.configuration ||= Configuration.new
+      yield(configuration) if block_given?
+      configuration.validate!
+      configuration
+    end
+
+    # Configure from YAML file
+    # @param file_path [String] Path to YAML configuration file
+    # @param environment [String, nil] Environment section to load
+    # @return [A2A::Configuration]
+    def configure_from_file(file_path, environment: nil)
+      self.configuration ||= Configuration.new
+      configuration.load_from_file(file_path, environment: environment)
+      configuration.validate!
+      configuration
+    end
+
+    # Configure from environment variables only
+    # @param environment [String, nil] Environment name
+    # @return [A2A::Configuration]
+    def configure_from_env(environment: nil)
+      self.configuration = Configuration.new(environment: environment)
+      configuration.validate!
+      configuration
+    end
+
+    # Get the current configuration or create a default one
+    # @return [A2A::Configuration]
+    def config
+      self.configuration ||= Configuration.new
+    end
+
+    # Reset configuration to defaults
+    def reset_configuration!
+      self.configuration = Configuration.new
+    end
+
+    # Create a child configuration with inheritance
+    # @param **overrides [Hash] Configuration overrides
+    # @return [A2A::Configuration]
+    def child_config(**overrides)
+      config.child(**overrides)
+    end
+
+    # Get the plugin manager
+    # @return [A2A::PluginManager]
+    def plugins
+      self.plugin_manager ||= PluginManager.new(config)
+    end
+
+    # Register a plugin
+    # @param name [Symbol] Plugin name
+    # @param plugin_class [Class] Plugin class
+    # @param **options [Hash] Plugin options
+    def register_plugin(name, plugin_class, **options)
+      A2A::Plugin.register(name, plugin_class, **options)
+    end
+
+    # Load a plugin
+    # @param name [Symbol] Plugin name
+    # @param **config [Hash] Plugin configuration
+    def load_plugin(name, **config)
+      plugins.load_plugin(name, **config)
+    end
+
+    # Configure plugins from hash
+    # @param plugin_configs [Hash] Plugin configurations
+    def configure_plugins(*args)
+      plugins.configure_plugins(*args)
+    end
+
+    # Initialize monitoring system
+    # @param config [A2A::Configuration] Configuration instance
+    def initialize_monitoring!(config = self.config)
+      A2A::Monitoring.initialize!(config)
+    end
+
+    # Get monitoring metrics
+    # @return [A2A::Monitoring::MetricsCollector]
+    def metrics
+      A2A::Monitoring.metrics
+    end
+
+    # Get structured logger
+    # @return [A2A::Monitoring::StructuredLogger]
+    def logger
+      A2A::Monitoring.logger
+    end
+
+    # Record a metric
+    # @param name [String] Metric name
+    # @param value [Numeric] Metric value
+    # @param **labels [Hash] Metric labels
+    def record_metric(name, value, **labels)
+      A2A::Monitoring.record_metric(name, value, **labels)
+    end
+
+    # Time a block of code
+    # @param name [String] Timer name
+    # @param **labels [Hash] Timer labels
+    # @yield Block to time
+    # @return [Object] Block result
+    def time(name, **labels, &block)
+      A2A::Monitoring.time(name, **labels, &block)
+    end
+  end
+end

metadata

@@ -0,0 +1,437 @@
+--- !ruby/object:Gem::Specification
+name: a2a-ruby
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- A2A Ruby Team
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-09-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  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: jwt
+  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: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: redis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: puma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.57'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.57'
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.19'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.19'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.25'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.25'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: benchmark-ips
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: Complete A2A Protocol implementation for Ruby applications, enabling
+  agent-to-agent communication via JSON-RPC 2.0, gRPC, and HTTP+JSON transports
+email:
+- info@traylinx.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- ".simplecov"
+- ".yardopts"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- PUBLISHING_CHECKLIST.md
+- README.md
+- Rakefile
+- docs/agent_execution.md
+- docs/api_reference.md
+- docs/configuration.md
+- docs/events.md
+- docs/getting_started.md
+- docs/integration.md
+- docs/server_apps.md
+- docs/troubleshooting.md
+- lib/a2a-rails.rb
+- lib/a2a.rb
+- lib/a2a/client/api_methods.rb
+- lib/a2a/client/auth.rb
+- lib/a2a/client/auth/api_key.rb
+- lib/a2a/client/auth/interceptor.rb
+- lib/a2a/client/auth/jwt.rb
+- lib/a2a/client/auth/oauth2.rb
+- lib/a2a/client/base.rb
+- lib/a2a/client/config.rb
+- lib/a2a/client/connection_pool.rb
+- lib/a2a/client/http_client.rb
+- lib/a2a/client/json_rpc_handler.rb
+- lib/a2a/client/middleware.rb
+- lib/a2a/client/middleware/circuit_breaker_interceptor.rb
+- lib/a2a/client/middleware/logging_interceptor.rb
+- lib/a2a/client/middleware/rate_limit_interceptor.rb
+- lib/a2a/client/middleware/retry_interceptor.rb
+- lib/a2a/client/performance_tracker.rb
+- lib/a2a/configuration.rb
+- lib/a2a/configuration/defaults.rb
+- lib/a2a/configuration/environment_loader.rb
+- lib/a2a/configuration/file_loader.rb
+- lib/a2a/configuration/inheritance.rb
+- lib/a2a/configuration/validator.rb
+- lib/a2a/errors.rb
+- lib/a2a/modules.rb
+- lib/a2a/monitoring.rb
+- lib/a2a/monitoring/alerting.rb
+- lib/a2a/monitoring/distributed_tracing.rb
+- lib/a2a/monitoring/health_endpoints.rb
+- lib/a2a/monitoring/metrics_collector.rb
+- lib/a2a/plugin.rb
+- lib/a2a/plugin_manager.rb
+- lib/a2a/plugins/example_auth.rb
+- lib/a2a/plugins/example_middleware.rb
+- lib/a2a/plugins/example_transport.rb
+- lib/a2a/protocol/agent_card.rb
+- lib/a2a/protocol/agent_card_server.rb
+- lib/a2a/protocol/capability.rb
+- lib/a2a/protocol/json_rpc.rb
+- lib/a2a/protocol/message.rb
+- lib/a2a/protocol/task.rb
+- lib/a2a/rails/a2a_controller.rb
+- lib/a2a/rails/controller_helpers.rb
+- lib/a2a/rails/engine.rb
+- lib/a2a/rails/generators/agent_generator.rb
+- lib/a2a/rails/generators/install_generator.rb
+- lib/a2a/rails/generators/migration_generator.rb
+- lib/a2a/rails/generators/templates/add_a2a_indexes.rb
+- lib/a2a/rails/generators/templates/agent_controller.rb
+- lib/a2a/rails/generators/templates/agent_controller_spec.rb
+- lib/a2a/rails/generators/templates/agent_readme.md
+- lib/a2a/rails/generators/templates/create_a2a_push_notification_configs.rb
+- lib/a2a/rails/generators/templates/create_a2a_tasks.rb
+- lib/a2a/rails/generators/templates/example_agent_controller.rb
+- lib/a2a/rails/generators/templates/initializer.rb
+- lib/a2a/rails/generators/templates/push_notification_config_model.rb
+- lib/a2a/rails/generators/templates/task_model.rb
+- lib/a2a/rails/tasks/a2a.rake
+- lib/a2a/server/a2a_methods.rb
+- lib/a2a/server/agent.rb
+- lib/a2a/server/agent_execution/agent_executor.rb
+- lib/a2a/server/agent_execution/request_context.rb
+- lib/a2a/server/apps/rack_app.rb
+- lib/a2a/server/apps/sinatra_app.rb
+- lib/a2a/server/default_request_handler.rb
+- lib/a2a/server/events/event_consumer.rb
+- lib/a2a/server/events/event_queue.rb
+- lib/a2a/server/example_agent.rb
+- lib/a2a/server/handler.rb
+- lib/a2a/server/middleware.rb
+- lib/a2a/server/middleware/authentication_middleware.rb
+- lib/a2a/server/middleware/cors_middleware.rb
+- lib/a2a/server/middleware/logging_middleware.rb
+- lib/a2a/server/middleware/rate_limit_middleware.rb
+- lib/a2a/server/push_notification_manager.rb
+- lib/a2a/server/request_handler.rb
+- lib/a2a/server/storage.rb
+- lib/a2a/server/storage/base.rb
+- lib/a2a/server/storage/database.rb
+- lib/a2a/server/storage/memory.rb
+- lib/a2a/server/storage/redis.rb
+- lib/a2a/server/task_manager.rb
+- lib/a2a/transport/grpc.rb
+- lib/a2a/transport/http.rb
+- lib/a2a/transport/sse.rb
+- lib/a2a/types.rb
+- lib/a2a/types/agent_card.rb
+- lib/a2a/types/artifact.rb
+- lib/a2a/types/base_model.rb
+- lib/a2a/types/events.rb
+- lib/a2a/types/message.rb
+- lib/a2a/types/part.rb
+- lib/a2a/types/push_notification.rb
+- lib/a2a/types/security.rb
+- lib/a2a/types/task.rb
+- lib/a2a/utils/helpers.rb
+- lib/a2a/utils/message_buffer.rb
+- lib/a2a/utils/performance.rb
+- lib/a2a/utils/rails_detection.rb
+- lib/a2a/utils/structured_logger.rb
+- lib/a2a/utils/time_helpers.rb
+- lib/a2a/utils/validation.rb
+- lib/a2a/version.rb
+homepage: https://github.com/traylinx/a2a-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/traylinx/a2a-ruby
+  source_code_uri: https://github.com/traylinx/a2a-ruby
+  changelog_uri: https://github.com/traylinx/a2a-ruby/blob/main/CHANGELOG.md
+  documentation_uri: https://a2a-protocol.org/latest/sdk/ruby/
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: Agent2Agent (A2A) Protocol implementation for Ruby
+test_files: []