Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.31.0 (2026-06-03)

Features

• forward session: through Agent.from_h/from_json for history seeding (#295) (0b2eaa2)

0.30.0 (2026-06-03)

⚠ BREAKING CHANGES

• unlimited max_steps is now represented as nil at the agent level (set via max_steps nil), not Float::INFINITY — Riffer::Agent::Config#max_steps may be nil and is no longer normalized. Riffer::Params parameter types are typed Module (widened from Class) to honestly include Riffer::Params::Boolean, which is a Module.

Features

• Riffer::Agent::Serializer for transferable agent definitions (#293) (99134b0)

0.29.1 (2026-06-01)

Bug Fixes

• rbs: ship consumer-safe RBS signatures (#286) (ac8ce6c)

0.29.0 (2026-05-29)

⚠ BREAKING CHANGES

• move leaf types out of root Riffer namespace (#282)

• Public API reshape on Riffer::Agent. Downstream consumers must migrate the following surfaces:

Features

• add bin/ wrappers for common dev commands (#276) (6812ba2)

• add OpenRouter provider (#280) (0d615b6)

Code Refactoring

• extract Riffer::Agent::Run, eagerly resolve per-agent state (#268) (1d9e141)

• move leaf types out of root Riffer namespace (#282) (3637a53)

0.28.0 (2026-05-08)

⚠ BREAKING CHANGES

• Custom subclasses of Riffer::ToolRuntime that override around_tool_call or dispatch_tool_call must accept the new assistant_message: kwarg (or **kwargs). Existing overrides that omit it will raise ArgumentError: unknown keyword: :assistant_message.

Features

• add history mutation API to Riffer::Agent (#249) (d980daa)

• forward assistant_message to ToolRuntime hooks (#247) (3d5f935)

0.27.2 (2026-05-04)

Bug Fixes

• validate tools at the class-level resolution boundary (#242) (7abbcd6)

0.27.1 (2026-05-04)

Bug Fixes

• validate tools before sending them to providers (#240) (537e2ab)

0.27.0 (2026-05-01)

Features

• integrate MCP server tools into agent tool resolution (6c7a09a)

Bug Fixes

• close streaming HTTP connections when consumer raises (#235) (2a51a10)

0.26.0 (2026-04-29)

Features

• model-aware skills adapter selection (#232) (74a5323)

0.25.0 (2026-04-29)

⚠ BREAKING CHANGES

• Removed Riffer::Skills::Adapter#activate_tool. Set the activation tool via Riffer.config.skills.default_activate_tool, or per-agent with skills do; activate_tool MyTool; end.

• Riffer::Skills::Adapter.new now requires skill_activate_tool:. The agent wires this up; only matters if you construct an adapter yourself. Custom adapters that override initialize must call super.

Features

• class-level tool resolution; lift activation tool to global config (#230) (936c4ba)

0.24.2 (2026-04-23)

Bug Fixes

• providers: surface Bedrock stream errors and concat text blocks (#222) (d30421e)

0.24.1 (2026-04-23)

Bug Fixes

• disable gzip on Anthropic stream to avoid SSE buffering (#220) (ee2aaca)

0.24.0 (2026-04-20)

Features

• add optional message id generation (#210) (0f9e20d)

0.23.0 (2026-04-15)

Features

• add Gemini provider (#199) (d0f0823)

0.22.0 (2026-04-09)

⚠ BREAKING CHANGES

• Tool.name returns namespace/tool_name instead of namespace__tool_name.

Features

• use human-friendly / separator for tool names (#202) (8dda251)

Bug Fixes

• release 0.22.0 (#204) (860a500)

0.21.0 (2026-04-09)

Features

• amazon_bedrock: support S3 URI file sources (#190) (243e5b1)

• normalize consecutive same-role messages before provider serialization (#201) (1ac986d)

0.20.0 (2026-03-26)

Features

• add fibers tool runtime using async gem (#178) (67fd344)

Bug Fixes

• correct RDoc formatting for docs.riffer.ai (#182) (2f2fbc9)

0.19.0 (2026-03-25)

Features

• Add Azure OpenAI provider (#167) (5d34fcd)

• expose message history in eval results (#171) (c8b1aec)

• provide agent context to runners (#181) (23c9282)

0.18.0 (2026-03-13)

Features

• add support for agent skills (#151) (8847d54)

• Unify generate/stream API with multi-turn support, remove resume methods (#165) (58826df)

0.17.0 (2026-03-06)

⚠ BREAKING CHANGES

• rename tool_context to context (#159)

Features

• add experimental ToolRuntime abstraction for tool execution (#156) (0ca7563)

• add interrupt! public method for clean loop interrupts (#155) (a4cc877)

• add support for dynamic instructions (#158) (408e09c)

• auto-derive step offset on resume for max_steps enforcement (#154) (fb97dbe)

Bug Fixes

• resolve edge cases in generate/resume and streaming methods (#162) (f74d373)

Code Refactoring

• rename tool_context to context (#159) (5be7214)

0.16.1 (2026-03-03)

Bug Fixes

• use anyOf for optional enum params in strict JSON Schema (#152) (2c7fc4d)

0.16.0 (2026-02-27)

Features

• add Riffer::Boolean sentinel type for boolean params (#147) (5337cf3)

• nested params DSL and strict schema for all providers (#144) (2984855)

0.15.1 (2026-02-25)

Bug Fixes

• address claude code review issues from PR #140 (#142) (f927c0c)

0.15.0 (2026-02-25)

Features

• store structured output in assistant messages (#140) (9cdb2e2)

0.14.0 (2026-02-24)

Features

• add file attachment support for user messages (#129) (0d08eb1)

• add max_steps option to Agent (#121) (fbc0391)

• add structured output support for agents (#128) (99be155)

• add web_search option for OpenAI and Anthropic providers (#126) (7e7e793)

• interruptible callbacks via throw/catch (#119) (f5985e6)

• replace eval prompt API with semantic fields (#132) (5d99d5a)

• replace Profile/Metric eval system with EvaluatorRunner (#138) (ebf2696)

• support dynamic model selection via lambda (#127) (c59cf96)

Bug Fixes

• add –comment flag to claude code review prompt (#122) (534bd59)

• add RBS annotations to web search constants and fix test provider docs (#130) (7cebe05)

• correct Amazon Bedrock model options to use Converse API structure (#133) (3af4562)

• widen run_eval input type to accept String or messages array (#124) (f96214c)

0.13.0 (2026-02-12)

Features

• remove identifiers from evals and guardrails (#112) (7b60707)

0.12.0 (2026-02-11)

⚠ BREAKING CHANGES

• Agent#generate now returns Riffer::Agent::Response instead of String. Use response.content or response.to_s for the text.

Features

• add Claude Code Review GitHub Action (#108) (f4b281c)

• add evals primitive for LLM-as-judge evaluations (#101) (8fd7b36)

• add guardrails primitive for input/output processing (#100) (48d8bad)

• add inline RBS type annotations with Steep type checking (#103) (02ae559)

Bug Fixes

• correct RBS inline annotations and remove ivar declarations (#109) (d59076d)

Miscellaneous Chores

• set next version (#111) (faf41b9)

0.11.0 (2026-02-04)

Features

• add class methods for generate and stream to Riffer::Agent (#97) (597636a)

• Add token usage tracking in Riffer::Agent (#102) (6044914)

0.10.0 (2026-01-30)

Features

• update class name conversion to support configurable namespace separators (#96) (e7091e9)

Bug Fixes

• handle multiple tools correctly for bedrock (#95) (50ae6f6)

• update class name conversion to use double underscore format (#93) (f6ffad7)

0.9.0 (2026-01-28)

Features

• implement Riffer::Tools::Response for consistent tool result handling (#91) (df44f1f)

0.8.0 (2026-01-26)

Features

• add anthropic provider support (#89) (338674e)

• add on_message callback for real-time message emission (#87) (92e6f91)

• add timeout functionality to tools (#86) (3b7d9af)

• better docs (#84) (630580a)

0.7.0 (2026-01-21)

Features

• tool calling support (#82) (0b2676a)

0.6.1 (2026-01-16)

Bug Fixes

• remove unnecessary require statement for openai (#76) (76b76f8)

0.6.0 (2026-01-14)

Features

• aws bedrock provider (#73) (428ae90)

• reasoning support (#75) (fcee502)

0.5.1 (2026-01-10)

Bug Fixes

• update Code of Conduct URL in README (#67) (39ae1f5)

• update gem details to reflect janeapp ownership (#66) (06a008d)

• update GitHub Pages deployment action in release workflow (#68) (e2f7961)

0.5.0 (2026-01-06)

Features

• streaming via agents (#63) (b4171c2)

0.4.2 (2025-12-29)

Bug Fixes

• update README for clarity on provider usage and examples (#60) (b12835c)

0.4.1 (2025-12-29)

Bug Fixes

• add conditional check for docs job execution based on release creation (#58) (97bc6f7)

• add permissions for contents in docs job (#57) (1dd5f7a)

• suppress output during documentation generation (#53) (6b7f2d9)

• update rdoc command to target the lib directory (#56) (c319efe)

0.4.0 (2025-12-29)

Features

• add documentation generation and publishing workflow (#51) (49e3b04)

0.3.2 (2025-12-29)

Bug Fixes

• add Rubygems credentials configuration step in release workflow (#49) (dcc71e0)

0.3.1 (2025-12-29)

Bug Fixes

• update checkout action version in release workflow (#47) (c6b1361)

0.3.0 (2025-12-29)

Features

• add release and publish workflows (#35) (3eb0389)

Bug Fixes

• add manifest file to release configuration (#43) (8d46135)

• auto-publishing on new release (#38) (5a1d267)

• remove manifest file from release configuration (#41) (2f898d8)

• remove release-type configuration from release workflow (#42) (e270a6c)

• reset release manifest to empty object (#44) (26f1b6d)

• restructure release configuration and update manifest format (#45) (d07694c)

• simplify release configuration by removing unnecessary package structure (#40) (8472967)

0.2.0 (2025-12-28)

Features

• add release and publish workflows (#35) (3eb0389)

[0.1.0] - 2024-12-20

Added

• Core Framework: Foundation for building AI-powered applications and agents

• Configuration System: Global and instance-level configuration management

• Agents: Base agent class for building conversational agents

• Messages: Complete message system with support for User, Assistant, System, and Tool messages

• Providers: Pluggable provider architecture

• OpenAI Provider: Full integration with OpenAI API for text generation and streaming

• Test Provider: Built-in test provider for development and testing

• Stream Events: Streaming response support with TextDelta and TextDone events

• Zeitwerk Autoloading: Modern Ruby autoloading for clean code organization

• Comprehensive Test Suite: Full RSpec test coverage with VCR cassettes for API mocking

• StandardRB Code Style: Enforced code formatting and linting