a2a-ruby 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c71377405a82ac9efb791ae5c4e48074f193d77c4386ea7b0aac7787f38d4d60
+  data.tar.gz: 40dae6264c406b175eda797c6748630c122e24af58c1473792805b1d423f78c1
+SHA512:
+  metadata.gz: 03b6d5477fc84375dabf6f84cc86190aa989cd34e9d11b361cf834dd745e1db5c8bd66b9f5510b85b05299ecec2e1b3f4c551ff763ae52fc75783f88a717aa21
+  data.tar.gz: 5362b66afd823baaff6f57e7bd182acb62708aa8de6ce6b4ee2e826e7642631b5b83840f7106fc2c5c24220819985c4807cd860e7aaeee82ba917564f1192fba

data/.rspec

@@ -0,0 +1,3 @@
+--require spec_helper
+--color
+--format documentation

data/.rubocop.yml

@@ -0,0 +1,137 @@
+# RuboCop configuration for A2A Ruby gem
+# Simple and practical configuration without problematic plugins
+
+AllCops:
+  TargetRubyVersion: 3.0
+  NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - 'vendor/**/*'
+    - 'tmp/**/*'
+    - 'bin/**/*'
+    - 'node_modules/**/*'
+    - 'db/schema.rb'
+    - '.git/**/*'
+    - 'spec/**/*'  # Skip all spec files to avoid RSpec plugin issues
+    - 'lib/a2a/rails/generators/templates/**/*'  # Skip ERB templates
+
+# Layout and formatting
+Layout/LineLength:
+  Max: 130  # Allow slightly longer lines for complex expressions
+  Exclude:
+    - '*.gemspec'
+
+# Style rules - be practical
+Style/Documentation:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+  EnforcedStyle: always
+
+# Metrics - be realistic for complex gem
+Metrics/BlockLength:
+  Max: 50
+  Exclude:
+    - '*.gemspec'
+    - 'config/**/*'
+    - 'lib/a2a/rails/tasks/**/*'
+
+Metrics/AbcSize:
+  Max: 50
+  Exclude:
+    - 'lib/a2a/transport/**/*'  # Transport layer can be complex
+    - 'lib/a2a/protocol/**/*'   # Protocol implementation can be complex
+
+Metrics/ClassLength:
+  Max: 300
+  Exclude:
+    - 'lib/a2a/rails/generators/**/*'
+
+Metrics/MethodLength:
+  Max: 50
+  Exclude:
+    - 'lib/a2a/transport/**/*'
+    - 'lib/a2a/protocol/**/*'
+    - 'lib/a2a/server/**/*'
+
+Metrics/CyclomaticComplexity:
+  Max: 20
+  Exclude:
+    - 'lib/a2a/transport/**/*'
+    - 'lib/a2a/protocol/**/*'
+    - 'lib/a2a/client/**/*'
+
+Metrics/PerceivedComplexity:
+  Max: 20
+  Exclude:
+    - 'lib/a2a/transport/**/*'
+    - 'lib/a2a/protocol/**/*'
+    - 'lib/a2a/client/**/*'
+
+Metrics/ModuleLength:
+  Max: 300
+  Exclude:
+    - 'lib/a2a/rails/**/*'  # Rails helpers can be longer
+
+Metrics/ParameterLists:
+  Max: 10  # Allow more parameters for complex constructors
+  Exclude:
+    - 'lib/a2a/types/**/*'  # Type constructors can have many parameters
+    - 'lib/a2a/client/**/*'  # Client classes can have many config parameters
+    - 'lib/a2a/protocol/**/*'  # Protocol classes can have many parameters
+
+# Naming rules
+Naming/FileName:
+  Exclude:
+    - 'lib/a2a-rails.rb'  # Allow this specific file name
+
+# Gemspec rules
+Gemspec/DevelopmentDependencies:
+  Enabled: false  # Allow dev dependencies in gemspec
+
+Gemspec/RequiredRubyVersion:
+  Enabled: false  # Allow different Ruby version requirements
+
+# Lint rules - be practical
+Lint/MissingSuper:
+  Enabled: false  # Many classes intentionally don't call super
+
+Lint/DuplicateBranch:
+  Enabled: false  # Sometimes duplicate branches are clearer
+
+Lint/DuplicateMethods:
+  Enabled: false  # Allow method redefinition in some cases
+
+Lint/IneffectiveAccessModifier:
+  Enabled: false  # Allow flexible access modifiers
+
+Lint/HashCompareByIdentity:
+  Enabled: false  # Allow object_id as hash keys where needed
+
+# Syntax errors must be fixed manually
+
+# Naming rules - be flexible
+Naming/AccessorMethodName:
+  Enabled: false  # Allow get_/set_ prefixes
+
+Naming/PredicatePrefix:
+  Enabled: false  # Allow has_ prefixes
+
+Naming/PredicateMethod:
+  Enabled: false  # Allow validate_ methods
+
+# Style rules - be practical
+Style/OptionalBooleanParameter:
+  Enabled: false  # Allow boolean default parameters
+
+Style/EmptyElse:
+  Enabled: false  # Sometimes empty else is clearer
+
+Style/RedundantCondition:
+  Enabled: false  # Sometimes redundant conditions are clearer
+
+# Performance rules removed - require rubocop-performance plugin

data/.simplecov

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# SimpleCov configuration for A2A Ruby SDK
+# Following a2a-python coverage patterns
+
+require "simplecov-lcov"
+
+SimpleCov.start do
+  # Output formats
+  if ENV["CI"]
+    formatter SimpleCov::Formatter::LcovFormatter
+  else
+    formatter SimpleCov::Formatter::MultiFormatter.new([
+                                                         SimpleCov::Formatter::HTMLFormatter,
+                                                         SimpleCov::Formatter::LcovFormatter
+                                                       ])
+  end
+
+  # Coverage tracking
+  enable_coverage :branch
+  primary_coverage :line
+
+  # Filters
+  add_filter "/spec/"
+  add_filter "/test/"
+  add_filter "/vendor/"
+  add_filter "/tmp/"
+  add_filter "/coverage/"
+  add_filter "/.bundle/"
+
+  # Groups (matching a2a-python structure)
+  add_group "Types", "lib/a2a/types"
+  add_group "Protocol", "lib/a2a/protocol"
+  add_group "Client", "lib/a2a/client"
+  add_group "Server", "lib/a2a/server"
+  add_group "Transport", "lib/a2a/transport"
+  add_group "Utils", "lib/a2a/utils"
+  add_group "Rails", "lib/a2a/rails"
+
+  # Coverage thresholds (will be raised as implementation progresses)
+  minimum_coverage 50
+  minimum_coverage_by_file 5
+
+  # Refuse to merge results older than 8 hours
+  merge_timeout 28_800
+end

data/.yardopts

@@ -0,0 +1,10 @@
+--markup markdown
+--markup-provider kramdown
+--output-dir doc
+--protected
+--private
+lib/**/*.rb
+-
+README.md
+CHANGELOG.md
+LICENSE.txt

data/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-09-15
+
+### Added
+- Complete A2A Protocol v0.3.0 implementation
+- JSON-RPC 2.0 client and server support
+- Agent card generation and discovery system
+- Task lifecycle management with push notifications
+- Multiple transport protocols (JSON-RPC, gRPC, HTTP+JSON)
+- Real-time streaming with Server-Sent Events
+- Authentication strategies (OAuth 2.0, JWT, API Key, mTLS)
+- Rails engine with generators and middleware
+- Comprehensive error handling and validation
+- Performance optimizations and monitoring
+- Production-ready logging and metrics
+- Type-safe protocol implementation with validation
+
+### Features
+- **Client Components**: HTTP client with streaming, authentication, middleware
+- **Server Components**: Agent DSL, request handling, middleware system
+- **Task Management**: Complete lifecycle, persistence, push notifications
+- **Transport Layer**: HTTP, SSE, optional gRPC support
+- **Rails Integration**: Engine, generators, controller helpers
+- **Configuration**: Flexible configuration system with environment support
+- **Monitoring**: Health checks, metrics collection, structured logging
+- **Testing**: Comprehensive test suite with compliance tests
+- **Documentation**: Complete API documentation and integration guides

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,128 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+team@a2a-ruby.org.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

data/CONTRIBUTING.md

@@ -0,0 +1,165 @@
+# Contributing to A2A Ruby SDK
+
+We love your input! We want to make contributing to the A2A Ruby SDK as easy and transparent as possible, whether it's:
+
+- Reporting a bug
+- Discussing the current state of the code
+- Submitting a fix
+- Proposing new features
+- Becoming a maintainer
+
+## Development Process
+
+We use GitHub to host code, to track issues and feature requests, as well as accept pull requests.
+
+1. Fork the repo and create your branch from `main`.
+2. If you've added code that should be tested, add tests.
+3. If you've changed APIs, update the documentation.
+4. Ensure the test suite passes.
+5. Make sure your code lints.
+6. Issue that pull request!
+
+## Setting Up Development Environment
+
+1. **Clone the repository:**
+   ```bash
+   git clone https://github.com/a2aproject/a2a-ruby.git
+   cd a2a-ruby
+   ```
+
+2. **Install dependencies:**
+   ```bash
+   bin/setup
+   ```
+
+3. **Run tests:**
+   ```bash
+   bundle exec rspec
+   ```
+
+4. **Run linting:**
+   ```bash
+   bundle exec rubocop
+   ```
+
+5. **Start console:**
+   ```bash
+   bin/console
+   ```
+
+## Code Style
+
+We use RuboCop to maintain consistent code style. Please ensure your code follows our style guide:
+
+```bash
+# Check style
+bundle exec rubocop
+
+# Auto-fix issues
+bundle exec rubocop -a
+```
+
+## Testing
+
+We use RSpec for testing. Please ensure:
+
+- All new features have corresponding tests
+- All tests pass before submitting PR
+- Maintain or improve code coverage
+
+```bash
+# Run all tests
+bundle exec rspec
+
+# Run specific test file
+bundle exec rspec spec/a2a/client_spec.rb
+
+# Run with coverage
+COVERAGE=true bundle exec rspec
+```
+
+## Documentation
+
+- Update relevant documentation for any API changes
+- Add YARD comments for new public methods
+- Update README.md if needed
+- Add examples for new features
+
+Generate documentation:
+```bash
+bundle exec yard doc
+```
+
+## Pull Request Process
+
+1. **Create a feature branch:**
+   ```bash
+   git checkout -b feature/amazing-feature
+   ```
+
+2. **Make your changes and commit:**
+   ```bash
+   git commit -m "Add amazing feature"
+   ```
+
+3. **Push to your fork:**
+   ```bash
+   git push origin feature/amazing-feature
+   ```
+
+4. **Create a Pull Request** with:
+   - Clear title and description
+   - Reference any related issues
+   - Include tests for new functionality
+   - Update documentation as needed
+
+## Reporting Bugs
+
+We use GitHub issues to track public bugs. Report a bug by [opening a new issue](https://github.com/a2aproject/a2a-ruby/issues).
+
+**Great Bug Reports** tend to have:
+
+- A quick summary and/or background
+- Steps to reproduce
+  - Be specific!
+  - Give sample code if you can
+- What you expected would happen
+- What actually happens
+- Notes (possibly including why you think this might be happening, or stuff you tried that didn't work)
+
+## Feature Requests
+
+We welcome feature requests! Please:
+
+1. Check if the feature already exists or is planned
+2. Open an issue with the `enhancement` label
+3. Describe the feature and its use case
+4. Discuss the implementation approach
+
+## Versioning
+
+We use [Semantic Versioning](http://semver.org/). For the versions available, see the [tags on this repository](https://github.com/a2aproject/a2a-ruby/tags).
+
+## Release Process
+
+1. Update version in `lib/a2a/version.rb`
+2. Update `CHANGELOG.md`
+3. Create a pull request
+4. After merge, create a release tag
+5. Gem is automatically published via GitHub Actions
+
+## Code of Conduct
+
+This project and everyone participating in it is governed by our [Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.
+
+## Questions?
+
+Feel free to contact the maintainers:
+- Open an issue for public discussion
+- Email: team@a2a-ruby.org
+
+Thank you for contributing! 🎉

data/Gemfile

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in a2a-ruby.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+
+group :development, :test do
+  gem "debug", platforms: %i[mri mingw x64_mingw]
+  gem "pry", "~> 0.14"
+  gem "pry-byebug", "~> 3.10"
+
+  # Environment management
+  gem "dotenv", "~> 2.8"
+end
+
+group :test do
+  gem "factory_bot", "~> 6.0"
+  gem "rspec", "~> 3.12"
+  gem "simplecov", "~> 0.22"
+  gem "simplecov-lcov", "~> 0.8"
+  gem "vcr", "~> 6.0"
+  gem "webmock", "~> 3.18"
+
+  # Performance testing
+  gem "benchmark-ips", "~> 2.12"
+  gem "memory_profiler", "~> 1.0"
+end
+
+group :development do
+  gem "rubocop", "~> 1.57"
+  gem "rubocop-performance", "~> 1.19"
+  gem "rubocop-rspec", "~> 2.25"
+
+  gem "guard", "~> 2.18"
+  gem "guard-rspec", "~> 4.7"
+  gem "yard", "~> 0.9"
+
+  # Security auditing
+  gem "bundler-audit", "~> 0.9"
+end

data/Guardfile

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+# Guard configuration for A2A Ruby SDK
+# Provides automatic testing similar to pytest watch mode
+
+guard :rspec, cmd: "bundle exec rspec" do
+  require "guard/rspec/dsl"
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+
+  # A2A-specific file patterns
+  watch(%r{^lib/a2a/(.+)\.rb$}) { |m| "spec/a2a/#{m[1]}_spec.rb" }
+  watch(%r{^lib/a2a/types/(.+)\.rb$}) { |m| "spec/a2a/types/#{m[1]}_spec.rb" }
+  watch(%r{^lib/a2a/client/(.+)\.rb$}) { |m| "spec/a2a/client/#{m[1]}_spec.rb" }
+  watch(%r{^lib/a2a/server/(.+)\.rb$}) { |m| "spec/a2a/server/#{m[1]}_spec.rb" }
+  watch(%r{^lib/a2a/protocol/(.+)\.rb$}) { |m| "spec/a2a/protocol/#{m[1]}_spec.rb" }
+  watch(%r{^lib/a2a/transport/(.+)\.rb$}) { |m| "spec/a2a/transport/#{m[1]}_spec.rb" }
+
+  # Integration tests
+  watch(%r{^lib/a2a/(.+)\.rb$}) { "spec/integration" }
+
+  # Configuration changes
+  watch("lib/a2a/configuration.rb") { "spec/a2a/configuration_spec.rb" }
+  watch("lib/a2a.rb") { "spec/a2a_spec.rb" }
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 A2A Ruby Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.