llm.rb 15.0.1 → 15.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ce996689c82e7a0d62a7f09ab2545d10b36462fc75cc2feeb57ce26f6523585
-  data.tar.gz: 74cf140b0fd11b077aea57bde027f0b00cf67f4e099ad35778bc5042b958469b
+  metadata.gz: b2700592b8b9fbb85694c24a0a7379a84494b0e4f2157d6302fad1552df9d684
+  data.tar.gz: 43864e55f008478a40860511f9ca138f86010695225f91f0b2a07fbcff1ed448
 SHA512:
-  metadata.gz: 4274138e7054d9db54e121dcad674f307b0e1bdbfc568ac16bb3b13181e873a77a57d19f4d2eef2479216555ba0ed9213fa7372cf051d4fa73f6fe73dae594cd
-  data.tar.gz: 12219c398f482c7f949bc9964038a2597e74a592b78023b101e96a337605c2e2fb8963f5526fbd4ca8f1ffd8b14b843e1a10334369d2f62a1e393eb409f4821d
+  metadata.gz: 464e203f6e4dc1fb2ea2aaa5bd4a2f95753d569190e63e4cd590b014aed4e369fa2f2835a4d6d95394b6988210c880e976abd5d8e8c69f015b057bb1f193609d
+  data.tar.gz: 9303d2475e2bd32dc53b65b7b9d54fa28611616a0714015bd1c0d74e8ca7cd66e6d88889b73231ed19dda38b2f2888ded08569694f23bd834a8e7c1f3fd6db35

data/CHANGELOG.md

@@ -15,6 +15,39 @@
 
 ## 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`.
+
+This release fixes a concurrency race in MCP tool calls by
+reference-counting the transport session, so overlapping tool calls
+reuse the running transport instead of racing `start`/`stop`.
+
+### Fix
+
+* **mcp: fix concurrent MCP tool call race** <br>
+  `LLM::MCP` now reference-counts its transport session: the first
+  caller starts the transport and the last caller stops it. Concurrent
+  or overlapping tool calls reuse the running transport instead of
+  racing `start`/`stop`, avoiding "MCP transport is not running" errors
+  that could occur with the `async` strategy. An externally started
+  transport is never stopped by a borrower.
+
 ## v15.0.1
 
 Changes since `v15.0.0`.

data/README.md

@@ -15,15 +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 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. All
+answers are grounded in the llm.rb source code.
 
 ## Install
 
@@ -39,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
@@ -61,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.
@@ -133,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
@@ -168,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
@@ -209,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"
@@ -235,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)
@@ -261,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)
@@ -320,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"
 
@@ -348,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"
@@ -411,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"
 
@@ -434,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"
 
@@ -509,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:)
@@ -536,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:)
@@ -574,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(
@@ -624,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))
@@ -669,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?
 
@@ -734,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"
 
@@ -758,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"],
@@ -781,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"
 
@@ -921,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/mcp.rb

@@ -87,7 +87,10 @@ class LLM::MCP
   # @return [LLM::MCP] A new MCP instance
   def initialize(stdio: nil, http: nil, timeout: 30)
     @timeout = timeout
-    if stdio && http
+    @lock = Mutex.new
+    @borrowers = 0
+    @owned = false
+    if stdio and http
       raise ArgumentError, "stdio and http are mutually exclusive"
     elsif stdio
       @command = Command.new(**stdio)
@@ -125,7 +128,10 @@ class LLM::MCP
   #  Propagates errors raised by {#start}, the block itself, or {#stop}
   # @return [void]
   def run
-    start
+    @lock.synchronize do
+      start
+      @owned = false
+    end
     yield
   ensure
     stop
@@ -182,13 +188,32 @@ class LLM::MCP
 
   attr_reader :command, :transport, :timeout
 
+  ##
+  # Borrows the transport for the duration of the block.
+  #
+  # The first borrower starts the transport, concurrent borrowers reuse
+  # it, and the last borrower stops it, so overlapping tool calls never
+  # race `start`/`stop` and trip over "MCP transport is not running".
+  # An externally started transport is never stopped by a borrower.
+  # @yield Runs while the transport is running
+  # @return [void]
   def with_session
-    return yield if transport.running?
-    session_started = true
-    start
+    @lock.synchronize do
+      @borrowers += 1
+      unless transport.running?
+        start
+        @owned = true
+      end
+    end
     yield
   ensure
-    stop if session_started
+    @lock.synchronize do
+      @borrowers -= 1
+      if @borrowers.zero? and @owned
+        @owned = false
+        stop
+      end
+    end
   end
 
   def adapt_content(content)

data/lib/llm/version.rb

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

data/llm.gemspec

@@ -40,13 +40,13 @@ DESCRIPTION
   spec.post_install_message = "\n" \
                               "Got a question about llm.rb? " \
                               "\n" \
-                              "Ask our chatbot." \
+                              "Ask the https://r.uby.dev chatbot." \
                               "\n" \
                               "It is connected to the official GitHub repository." \
                               "\n" \
                               "100% free to use." \
                               "\n" \
-                              "https://r.uby.dev" \
+                              "Built with llm.rb and DeepSeek." \
                               "\n\n"
 
   spec.add_development_dependency "webmock", "~> 3.24.0"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm.rb
 version: !ruby/object:Gem::Version
-  version: 15.0.1
+  version: 15.0.3
 platform: ruby
 authors:
 - Robert Gleeson
@@ -652,8 +652,9 @@ metadata:
   source_code_uri: https://github.com/r-uby-dev/llm
   documentation_uri: https://r.uby.dev
   changelog_uri: https://github.com/r-uby-dev/llm/blob/main/CHANGELOG.md
-post_install_message: "\nGot a question about llm.rb? \nAsk our chatbot.\nIt is connected
-  to the official GitHub repository.\n100% free to use.\nhttps://r.uby.dev\n\n"
+post_install_message: "\nGot a question about llm.rb? \nAsk the https://r.uby.dev
+  chatbot.\nIt is connected to the official GitHub repository.\n100% free to use.\nBuilt
+  with llm.rb and DeepSeek.\n\n"
 rdoc_options: []
 require_paths:
 - lib