easy_talk 3.2.0 → 3.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b77760f0bdffbb877509e133194733d397db6e5963b1484543791169db5dc840
-  data.tar.gz: 6e805469940229543c059952dc2311dd9acf7ea89ff45fde8b49b3e4d38dd85d
+  metadata.gz: f1b72ef842cb6e49f4cbc0d1eab096e737f26c118e715170c35e791ceb28a0cd
+  data.tar.gz: 800ce6db8a8d0607589250fb76a0834bc1372de11617f2746abad2c00496bc77
 SHA512:
-  metadata.gz: 5bf66646040995f9de8341e2a4e6ea63ae0c462a0f08f28779244e8eceff958e574042450a9a39cc2ef485e13d6c418e5f71296d6d8cc7e958339f432e84c572
-  data.tar.gz: 4c26c3bee7751682535f154efef1c4adb86cea08be6c6f09f9ebe08d6a2fde5604d71db884aa7f0de91787118f5bbb719028f8071ec4166ba69af7ad0d9b4ff1
+  metadata.gz: 1cb143e9d16027929bcaf119cdcc12254fd4324f2f902a493be7a55095cfce1f8d721bd44c5233fb5ef62cde19aab3017f6fdc78cb66c57ab670a304293b6fb0
+  data.tar.gz: 2968e2ab36843d8237759d9b7528cbe9a72388123b677b8c8117c27192c51d50f577df884a0a96d9cc7e308f2119e2485bcbf0b13bb5742675fb5cd1338ae31a

data/.rubocop.yml

@@ -1,7 +1,3 @@
-plugins:
-  - rubocop-rspec
-  - rubocop-rake
-
 AllCops:
   NewCops: enable
   TargetRubyVersion: 3.2
@@ -33,6 +29,8 @@ Style/StringLiterals:
 
 Metrics/ClassLength:
   Max: 240
+  Exclude:
+    - lib/easy_talk/validation_adapters/active_model_adapter.rb
 
 Metrics/MethodLength:
   Max: 60
@@ -55,6 +53,7 @@ Metrics/BlockNesting:
 Metrics/BlockLength:
   Exclude:
     - spec/**/*
+    - easy_talk.gemspec
 
 Layout/EndAlignment:
   Enabled: false
@@ -70,45 +69,6 @@ Lint/EmptyBlock:
   Exclude:
     - spec/**/*
 
-RSpec/DescribeClass:
-  Enabled: false
-
-RSpec/LeakyConstantDeclaration:
-  Enabled: false
-
-RSpec/RemoveConst:
-  Enabled: false
-
-RSpec/BeforeAfterAll:
-  Enabled: false
-
-RSpec/NestedGroups:
-  Max: 4
-
-RSpec/RepeatedDescription:
-  Enabled: false
-
-RSpec/PendingWithoutReason:
-  Enabled: false
-
-RSpec/MultipleDescribes:
-  Enabled: false
-
-RSpec/ContextWording:
-  Enabled: false
-
-RSpec/MultipleMemoizedHelpers:
-  Max: 10
-
-RSpec/ExampleLength:
-  Max: 40
-
-RSpec/MultipleExpectations:
-  Max: 10
-
-RSpec/SpecFilePathFormat:
-  Enabled: false
-
 Lint/DuplicateBranch:
   Enabled: false
 
@@ -118,3 +78,15 @@ Gemspec/DevelopmentDependencies:
 Naming/PredicateMethod:
   Exclude:
     - spec/support/schema_validation_matcher.rb
+
+Naming/BlockForwarding:
+  Enabled: false
+
+Lint/UnusedMethodArgument:
+  AllowUnusedKeywordArguments: true
+  Exclude:
+    - lib/easy_talk/configuration.rb
+    - lib/easy_talk/schema_definition.rb
+
+Style/DefWithParentheses:
+  Enabled: false

data/CHANGELOG.md

@@ -1,3 +1,108 @@
+## [3.3.1] - 2026-02-03
+
+### Added
+
+- **RubyLLM Compatibility Extension**: Seamless integration between EasyTalk models and RubyLLM's tool and structured output features (#122)
+  - New `RubyLLMCompatibility` module adds class method `to_json_schema` for `with_schema` support
+  - New `RubyLLMToolOverrides` module for classes inheriting from `RubyLLM::Tool`
+  - Overrides `description` and `params_schema` methods to use EasyTalk schema definitions
+  - Automatically included when using `EasyTalk::Model`
+  - Tools inherit from `RubyLLM::Tool` directly, gaining full access to features like `halt`, `call`, `provider_params`
+  - New example files: `examples/ruby_llm/tools_integration.rb`, `examples/ruby_llm/structured_output.rb`
+
+### Changed
+
+- **Documentation**: Updated README with improved examples and documentation
+
+## [3.3.0] - 2026-01-12
+
+### Added
+
+- **Schema Objects in additionalProperties**: Extended `additionalProperties` to support type constraints and schema objects (#160)
+  - New syntax: `additional_properties Integer, minimum: 0, maximum: 100`
+  - Three supported forms: boolean, type class, or type with constraints
+  - Generates full JSON Schema for additional properties validation
+  - New methods: `ObjectBuilder#process_additional_properties`, `ObjectBuilder#build_additional_properties_schema`
+  - Fully backwards compatible with existing boolean usage
+
+- **External $ref Support via $id**: Enhanced schema referencing with external URI support (#158)
+  - New configuration options:
+    - `base_schema_uri` - Base URI for auto-generating $id values
+    - `auto_generate_ids` - Enable automatic $id generation (default: false)
+    - `prefer_external_refs` - Use external URI in $ref when model has $id (default: false)
+  - Three-level schema ID resolution: explicit per-model → auto-generated → global
+  - Dynamic $ref templates conditionally use external URIs or local `#/$defs/ModelName` format
+  - Supports composition types (T::OneOf, T::AnyOf, T::AllOf) with external refs
+
+- **T::Tuple Type for Positional Array Validation**: New tuple type for JSON Schema tuple support (#154, #155)
+  - New syntax: `property :coords, T::Tuple[Float, Float]`
+  - Generates JSON Schema with `items` as array of schemas
+  - Supports `additional_items: false`, `true`, or a type constraint
+  - Combines with array constraints: `min_items`, `max_items`, `unique_items`
+  - ActiveModel validation for runtime type checking at each position
+  - New files: `lib/easy_talk/types/tuple.rb`, `lib/easy_talk/builders/tuple_builder.rb`
+
+- **Object-Level JSON Schema Keywords**: Support for schema-wide object constraints (#148, #151)
+  - New keywords: `patternProperties`, `minProperties`, `maxProperties`, `dependencies`, `dependentRequired`
+  - ActiveModel validators for object-level constraints via `ActiveModelSchemaValidation` module
+  - Auto-defined `count_present_properties` private method on model classes
+  - Thread-safe validator application with double-checked locking
+
+### Changed
+
+- **Format Validation Enhancements**: Improved format validation accuracy and security (#157, #156, #144)
+  - **Scope Fix**: Format and pattern validations now only apply to string values (per JSON Schema spec)
+  - **URI/URL Validation**: Uses `URI.parse()` with `.absolute?` check instead of regex
+  - **Parsing-Based Validators**: Date, DateTime, and Time formats now use parsing instead of regex
+  - **Email Validation**: Replaced ReDoS-vulnerable regex with simple linear-time pattern
+  - New validation methods: `apply_uri_format_validation`, `apply_date_format_validation`, `apply_datetime_format_validation`, `apply_time_format_validation`
+
+- **JSON Schema Equality for uniqueItems**: Implements correct JSON Schema equality semantics for array uniqueness (#152)
+  - Objects with same keys/values in different order are equal
+  - Numbers are mathematically equal (1 == 1.0)
+  - Type matters for non-numbers (true != 1, false != 0)
+  - New module: `EasyTalk::JsonSchemaEquality` with `normalize()` and `duplicates?()` methods
+  - MAX_DEPTH = 100 limit to prevent SystemStackError on deeply nested structures
+
+- **Array Presence Validation**: Required array properties now properly reject nil values (#140)
+  - New method: `apply_array_presence_validation()` for array-specific nil checks
+  - Rejects nil but allows empty arrays `[]`
+  - Aligns with JSON Schema spec: 'optional' means property can be omitted, not that nil is accepted
+
+### Fixed
+
+- **Default Additional Properties Configuration**: Fixed `default_additional_properties` config option being ignored (#142)
+  - Both `ObjectBuilder` and `SchemaDefinition` now use configured default
+  - Added schema hash duplication to prevent mutation side effects
+
+- **Property Name Validation**: Fixed validation incorrectly applying to JSON output name (`:as` constraint) instead of Ruby property name (#143)
+  - `validate_property_name()` now validates Ruby name only
+  - Allows using `:as` for JSON-LD (@type, @id), JSON Schema ($id, $ref), and other special JSON keys
+
+- **Method Redefinition Warning**: Fixed "method redefined" warning for `:property` keyword (#153)
+  - Removed `:property` from `KEYWORDS` constant since it has dedicated implementation
+
+### Internal
+
+- **Type Introspection Improvements**: Enhanced type checking capabilities (#156)
+  - New helper methods: `array_type?()`, `boolean_union_type?()`, extracted `boolean_type?()`
+  - Improved encapsulation and testability
+
+- **ValidationContext Decoupling**: Refactored validation adapter internals (#150)
+  - New plain data class `ValidationContext` for pre-computed validation values
+  - Replaces `__send__` usage with direct value passing
+  - Improved encapsulation and testability
+
+- **Code Coverage Integration**: Added SimpleCov and Codecov for test coverage tracking
+  - Local HTML reports via SimpleCov
+  - CI badge reporting via Codecov
+  - Coverage uploads on Ruby 3.4.7 builds only
+
+- **Test Infrastructure**: Comprehensive test expansion (~1800 lines of new tests)
+  - New test files: `external_ref_spec.rb`, `additional_properties_schema_spec.rb`, `tuple_validation_spec.rb`, `json_schema_equality_spec.rb`
+  - Enhanced builder test coverage
+  - Improved JSON Schema compliance testing
+
 ## [3.2.0] - 2025-12-28
 
 ### Added