llm.rb 15.0.2 → 15.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c86e9ccde2cc0844b5172935bc222c1adf3cda8b0f49e84730179bcc635b2d2b
-  data.tar.gz: 60c740c3dc2c20d8b1d86de55ae5ef25eb7bbe5b5b567f3766c059b37520efcc
+  metadata.gz: b2700592b8b9fbb85694c24a0a7379a84494b0e4f2157d6302fad1552df9d684
+  data.tar.gz: 43864e55f008478a40860511f9ca138f86010695225f91f0b2a07fbcff1ed448
 SHA512:
-  metadata.gz: fd1901c5bebd659b242db55ed91ea4f538832c24b4ab119b80f46ae987fc5166823fa70174d9f545c079addd90487eb379b1dfd6eeea2365d045a831b861134e
-  data.tar.gz: 5949efbaa7381fb0cab7328e64c08af4022a8b976a24b8b24901c167c67cd060f912a7054956a7942cd7cf67b3f0aa226ad5aec608bcd273bfa1aa25d3ffb5d0
+  metadata.gz: 464e203f6e4dc1fb2ea2aaa5bd4a2f95753d569190e63e4cd590b014aed4e369fa2f2835a4d6d95394b6988210c880e976abd5d8e8c69f015b057bb1f193609d
+  data.tar.gz: 9303d2475e2bd32dc53b65b7b9d54fa28611616a0714015bd1c0d74e8ca7cd66e6d88889b73231ed19dda38b2f2888ded08569694f23bd834a8e7c1f3fd6db35

data/CHANGELOG.md

@@ -15,6 +15,21 @@
 
 ## What's next
 
+## v15.0.3
+
+Changes since `v15.0.2`.
+
+This release fixes ActiveRecord `:json`/`:jsonb` serialization so tool
+call arguments round-trip as JSON objects instead of arrays of pairs.
+
+### Fix
+
+* **activerecord: serialize tool call arguments properly** <br>
+  Fix a bug where the ActiveRecord `:json`/`:jsonb` layer serialized tool
+  call arguments as an array of pairs instead of a Hash. The context is
+  now serialized through its JSON form, so tool call arguments round-trip
+  as JSON objects that providers accept.
+
 ## v15.0.2
 
 Changes since `v15.0.1`.

data/README.md

@@ -15,22 +15,16 @@
 Welcome to the canonical llm.rb repository.
 
 llm.rb is an advanced runtime for building agentic AI applications
-on CRuby. It has zero runtime dependencies by default, it supports
+on CRuby. It has zero runtime dependencies by default, supports
 concurrent and parallel tool execution and has a single coherent API
 that spans 13+ providers. Streaming, tools, guards, compaction, the
 REPL, builtin MCP/A2A support and the database integrations all build
 on the same three concepts: providers, contexts, and agents.
 
-Once you learn the fundamentals, everything else falls into place
-naturally. Some features, such as ActiveRecord support, require
-optional dependencies that are opt-in.
-
-The best way to learn about llm.rb is to ask [the official chatbot](https://r.uby.dev)
+The most effective way to learn about llm.rb is to ask [the r.uby.dev chatbot](https://r.uby.dev)
 a question. It is connected to the llm.rb GitHub repository, backed by
-ActiveRecord and uses the builtin MCP feature to connect to GitHub. If
-you want to know more then simply [ask the chatbot](https://r.uby.dev) and
-you should get an answer that is grounded in the source code. It is 100%
-free to use and powered by DeepSeek under the hood. 
+ActiveRecord and uses the builtin MCP feature to connect to GitHub. All
+answers are grounded in the llm.rb source code.
 
 ## Install
 
@@ -46,8 +40,7 @@ The
 [`LLM::Agent`](https://r.uby.dev/api-docs/llm.rb/LLM/Agent.html)
 class is the default high-level interface,
 and it is recommended for most use-cases. It manages tool execution
-automatically and
-[guards against infinite loops](https://r.uby.dev/llm/deepdive/advanced/guard),
+automatically and guards against infinite loops,
 manages conversation state, and much more.
 
 ```ruby
@@ -68,9 +61,6 @@ reasoning, tool calls, tool returns, and compaction.
 Streams can also observe message transformers, which rewrite
 outgoing messages before they reach the provider.
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/fundamentals/stream/)
-to learn more.
-
 ```ruby
 class MyStream < LLM::Stream
   # Visible assistant output.
@@ -140,7 +130,7 @@ call them on your behalf, and they're one of the most powerful features
 for extending the feature set or abilities of a model.
 
 The runtime also ships with a catalog of built-in tools for
-filesystem, search, and shell operations. <br> See the [deepdive.md](https://r.uby.dev/llm/deepdive/fundamentals/tools) to learn more.
+filesystem, search, and shell operations.
 
 ```ruby
 class ReadFile < LLM::Tool
@@ -175,8 +165,6 @@ callback hands back the subagent that ran the skill, so you can inspect
 its conversation, measure its usage, track costs or add a verification
 step (eg `subagent.talk("verify your work")`).
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/fundamentals/skills) to learn more.
-
 ##### summary.md
 
 ```markdown
@@ -216,8 +204,6 @@ with the `:fork` and `:ractor` strategies. The
 The `:fork` strategy also provides a separate process that offers
 isolation from its parent.
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/features/concurrency) to learn more.
-
 ```ruby
 require "llm"
 require "llm/tools"
@@ -242,8 +228,6 @@ the control channel, a ractor via message passing, and pending tools
 are stopped before they run. The in-flight HTTP request is closed
 too, so a turn you no longer want stops without burning tokens.
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/advanced/cancellation) to learn more.
-
 ```ruby
 llm = LLM.deepseek(key: ENV["KEY"])
 agent = LLM::Agent.new(llm)
@@ -268,8 +252,6 @@ The REPL stands out because it connects to the surrounding
 runtime and it can be extended by your code. Think of it as
 `binding.pry` but for agents.
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/features/repl) to learn more.
-
 ##### Demo
 
 [Watch in high quality on asciinema](https://asciinema.org/a/OsS8wwaasKasoDDz)
@@ -327,8 +309,6 @@ code. For database-backed persistence, ActiveRecord and Sequel
 integrations are also available. All persistence options use the same
 underlying serialization.
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/features/database) to learn more.
-
 ```ruby
 require "llm"
 
@@ -355,8 +335,6 @@ for both Rack-based / Rails-based applications. On databases
 where it is supported, such as PostgreSQL, the column can be optimized by using
 the `jsonb` type.
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/features/database) to learn more.
-
 ```ruby
 require "active_record"
 require "llm"
@@ -418,9 +396,6 @@ used with
 [`LLM::Context`](https://r.uby.dev/api-docs/llm.rb/LLM/Context.html) or
 [`LLM::Agent`](https://r.uby.dev/api-docs/llm.rb/LLM/Agent.html).
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/protocols/mcp/), and the
-[deepdive.md on persistent connections](https://r.uby.dev/llm/deepdive/features/transports) to learn more.
-
 ```ruby
 require "llm"
 
@@ -441,9 +416,6 @@ used with
 [`LLM::Context`](https://r.uby.dev/api-docs/llm.rb/LLM/Context.html) or
 [`LLM::Agent`](https://r.uby.dev/api-docs/llm.rb/LLM/Agent.html).
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/protocols/a2a/), and the
-[deepdive.md on persistent connections](https://r.uby.dev/llm/deepdive/features/transports) to learn more.
-
 ```ruby
 require "llm"
 
@@ -516,8 +488,6 @@ and implement
 The pending call arrives as `function:`. Return a value to close
 the call, or `nil` to let it run:
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/advanced/guard) to learn more.
-
 ```ruby
 class PolicyGuard < LLM::Guard
   def call(function:)
@@ -543,8 +513,6 @@ Create a subclass and implement `call(message:)` to scrub sensitive data,
 inject context, or normalize content. The transform runs automatically
 on every turn, so you never have to change your prompt code.
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/advanced/transformer) to learn more.
-
 ```ruby
 class RedactEmails < LLM::Transformer
   def call(message:)
@@ -581,8 +549,6 @@ and
 [`LLM::Stream#on_compaction_finish`](https://r.uby.dev/api-docs/llm.rb/LLM/Stream.html#on_compaction_finish)
 callbacks.
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/advanced/compaction) to learn more.
-
 ```ruby
 llm = LLM.deepseek(key: ENV["KEY"])
 agent = LLM::Agent.new(
@@ -631,8 +597,6 @@ exports spans via OTLP for OpenTelemetry in production.
 * [`LLM::Tracer::Logger`](https://r.uby.dev/api-docs/llm.rb/LLM/Tracer/Logger.html):
 structured JSON to stdout or a file.
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/reference/tracer) to learn more.
-
 ```ruby
 llm = LLM.deepseek(key: ENV["KEY"])
 agent = LLM::Agent.new(llm, tracer: LLM::Tracer::PrettyLogger.new(llm))
@@ -676,9 +640,8 @@ Each provider is constructed with a class-level factory method on
 [`LLM::Context`](https://r.uby.dev/api-docs/llm.rb/LLM/Context.html)
 or
 [`LLM::Agent`](https://r.uby.dev/api-docs/llm.rb/LLM/Agent.html). The
-same API drives every one of them, so switching models is a one-line
-change. See the [deepdive](https://r.uby.dev/llm/deepdive/fundamentals/providers)
-for a full provider reference.
+same API drives every one of them, so switching providers is a one-line
+change.
 
 #### What providers does llm.rb support?
 
@@ -741,8 +704,6 @@ modalities with the gem, sourced from [models.dev](https://models.dev).
 Reach it from any provider, context, or agent, enumerate models, or
 sort them by price.
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/reference/model_registry) to learn more.
-
 ```ruby
 require "llm"
 
@@ -765,8 +726,6 @@ is always available and the default, `net/http/persistent` pools
 connections for many requests to the same host, and `curb` wraps
 libcurl. They share one interface, so switching is a one-word change.
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/advanced/transports) to learn more.
-
 ```ruby
 llm = LLM.deepseek(
   key: ENV["KEY"],
@@ -788,8 +747,6 @@ llm.rb also includes support for OpenAI's vector store API. It
 provides a vector database as a HTTP service but we won't cover
 that here.
 
-See the [deepdive.md](https://r.uby.dev/llm/deepdive/features/embeddings) to learn more.
-
 ```ruby
 require "llm"
 
@@ -928,11 +885,11 @@ it as my primary driver for development.
 
 ## Resources
 
-If you like what you read so far, check out the [deepdive.md](https://r.uby.dev/llm/deepdive/)
-to learn more. Unfortunately it
-wasn't possible to cover every feature without the README becoming a small book.
-The [r.uby.dev](https://r.uby.dev) homepage also includes more learning material
-and resources.
+The [r.uby.dev chatbot](https://r.uby.dev) is connected
+to this very GitHub repository. It can read documentation,
+source code, issues, and pull requests. The [docs/](docs/)
+directory contains the full documentation and the chatbot
+can find the answers to your questions there.
 
 ## License
 

data/lib/llm/active_record.rb

@@ -39,7 +39,7 @@ module LLM::ActiveRecord
     def self.serialize_context(ctx, format)
       case format
       when :string then ctx.to_json
-      when :json, :jsonb then ctx.to_h
+      when :json, :jsonb then LLM.json.load(ctx.to_json)
       else raise ArgumentError, "Unknown format: #{format.inspect}"
       end
     end

data/lib/llm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LLM
-  VERSION = "15.0.2"
+  VERSION = "15.0.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm.rb
 version: !ruby/object:Gem::Version
-  version: 15.0.2
+  version: 15.0.3
 platform: ruby
 authors:
 - Robert Gleeson