Improve inspect output for IRB, Rails console, ERB

- Add AI::Message class (Hash subclass) with custom display
- Add AI::Items class (SimpleDelegator) wrapping API response
- Rename items to get_items to indicate API call
- Enable reasoning summaries when reasoning_effort is set
- Add to_html methods with dark terminal-style background
- TTY-aware colorization (disabled when piped/redirected)
- Add examples/16_get_items.rb demonstrating item inspection

Author: raghubetina

.gitignore

@@ -15,10 +15,6 @@ tmp/
 .bundle/
 vendor/bundle/
 
-# Development dependencies cloned locally
-amazing_print/
-openai-ruby/
-
 # Temp demo scripts
 demo2/
 

CHANGELOG.md

@@ -5,6 +5,28 @@ 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).
 
+## [0.5.0] - 2025-12-05
+
+### Breaking Changes
+
+- **Renamed `items` to `get_items`**: The method now clearly indicates it makes an API call. Returns an `AI::Items` wrapper that delegates to the underlying response while providing nice display formatting.
+
+### Added
+
+- **Reasoning summaries**: When `reasoning_effort` is set, the API now returns chain-of-thought summaries in `get_items`. These show the model's reasoning process (e.g., "Planning Ruby version search", "Confirming image tool usage").
+
+- **Improved console display**: `AI::Chat`, `AI::Message`, and `AI::Items` now display nicely in IRB and Rails console with colorized, formatted output via AmazingPrint.
+
+- **HTML output for ERB templates**: All display objects have a `to_html` method for rendering in views. Includes dark terminal-style background for readability.
+
+- **`AI::Message` class**: Messages are now `AI::Message` instances (a Hash subclass) with custom display methods.
+
+- **`AI::Items` class**: Wraps the conversation items API response with nice display methods while delegating all other methods (like `.data`, `.has_more`, etc.) to the underlying response.
+
+- **TTY-aware display**: Console output automatically detects TTY and disables colors when output is piped or redirected.
+
+- **New example**: `examples/16_get_items.rb` demonstrates inspecting conversation items including reasoning, web searches, and image generation.
+
 ## [0.4.0] - 2025-11-25
 
 ### Breaking Changes
@@ -27,7 +49,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - **Automatic conversation management**: The gem now automatically creates and manages conversations via OpenAI's Conversations API. The `conversation_id` is set after the first `generate!` call and maintained across subsequent calls.
 
-- **`items` method**: Retrieve all conversation items (messages, tool calls, reasoning) from OpenAI's API with `chat.items`.
+- **`get_items` method**: Retrieve all conversation items (messages, tool calls, reasoning) from OpenAI's API with `chat.get_items`.
 
 - **Improved test coverage**: Added integration tests for conversation continuity, file handling, and conversation items retrieval.
 

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ai-chat (0.4.0)
+    ai-chat (0.5.0)
       amazing_print (~> 1.8)
       base64 (~> 0.1, > 0.1.1)
       json (~> 2.0)