llm.rb 4.18.0 → 4.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 42357f605b8995c24722c0a2d285d98de0e99fe6f9687e2f4451339dcfbc2e87
-  data.tar.gz: 2953c742deeec6dc7c7acc9ed77f4520846a92299a4df94e415416d5c623033c
+  metadata.gz: 18c28f7b5ec05ad6f9629a6a328be4dd377a6efb43a13c2ac99dd0abf015b1f8
+  data.tar.gz: a0c03de362af927d090a6bc09b2170ddb7eb5766f26b1f8f657a37bd10d0162e
 SHA512:
-  metadata.gz: 534fad616562768b0a851142f411117634d824a92187577d6baad4427c1e0eddf7a765dbfe3b662f76ba52011d760803793473a1881b4f69b8f4c7f9fc16bdc3
-  data.tar.gz: f1d90ad7f7b71f4817fcfa494f48a4e7f189560674d7b86d618f1f4e217e2a34189e15156e71ecdcfffe81e9588315f4759a82f4ec3eaed3846a29c77a906a66
+  metadata.gz: c8255c9435bec0a7a06fb427f3a1ade4e0b5ce47f111d33f4cbf1218fce1f89f1438c71980b52c3de7542563690f08bcf54417cb7d427720248a22f8b30a12fb
+  data.tar.gz: 54aebea9a5f8ac687163d3df3c2c3d31091f8f8d6d96b5ad242199daa8fdfb8e5e17e2b626f7a682158ba9251202362fc9fddaed6c08e6eb8399c8b0509659d8

data/CHANGELOG.md

@@ -2,8 +2,39 @@
 
 ## Unreleased
 
+Changes since `v4.19.0`.
+
+## v4.19.0
+
 Changes since `v4.18.0`.
 
+This release tightens the ActiveRecord and ORM integration layer. It adds
+inline agent DSL blocks to `acts_as_agent` so agent defaults can be defined
+where the wrapper is declared, and it exposes the resolved provider through
+public `llm` methods on the ActiveRecord and Sequel wrappers.
+
+### Change
+
+* **Make ORM provider access public through `llm`** <br>
+  Expose the resolved provider on the Sequel plugin and the ActiveRecord
+  `acts_as_llm` / `acts_as_agent` wrappers through a public `llm` method.
+
+* **Allow inline agent DSL blocks in `acts_as_agent`** <br>
+  Let ActiveRecord models configure `model`, `tools`, `schema`,
+  `instructions`, and `concurrency` directly inside the `acts_as_agent`
+  declaration block.
+
+## v4.18.0
+
+Changes since `v4.17.0`.
+
+This release improves tracing and tool execution behavior across llm.rb.
+It makes provider tracers default to the provider instance, adds
+`LLM::Provider#with_tracer` for scoped overrides, restores tool tracing for
+concurrent and streamed tool execution, extends streamed tracing to MCP tools,
+and adds symbol-based ORM option hooks alongside experimental ractor tool
+concurrency.
+
 ### Change
 
 * **Make provider tracers default to the provider instance** <br>
@@ -42,17 +73,6 @@ Changes since `v4.18.0`.
   is especially useful for CPU-bound tools, while `:task`, `:fiber`, or
   `:thread` may be a better fit for I/O-bound work.
 
-## v4.18.0
-
-Changes since `v4.17.0`.
-
-This release improves tracing and tool execution behavior across llm.rb.
-It makes provider tracers default to the provider instance, adds
-`LLM::Provider#with_tracer` for scoped overrides, restores tool tracing for
-concurrent and streamed tool execution, extends streamed tracing to MCP tools,
-and adds symbol-based ORM option hooks alongside experimental ractor tool
-concurrency.
-
 ## v4.17.0
 
 Changes since `v4.16.1`.

data/README.md

@@ -4,7 +4,7 @@
 <p align="center">
   <a href="https://0x1eef.github.io/x/llm.rb?rebuild=1"><img src="https://img.shields.io/badge/docs-0x1eef.github.io-blue.svg" alt="RubyDoc"></a>
   <a href="https://opensource.org/license/0bsd"><img src="https://img.shields.io/badge/License-0BSD-orange.svg?" alt="License"></a>
-  <a href="https://github.com/llmrb/llm.rb/tags"><img src="https://img.shields.io/badge/version-4.18.0-green.svg?" alt="Version"></a>
+  <a href="https://github.com/llmrb/llm.rb/tags"><img src="https://img.shields.io/badge/version-4.19.0-green.svg?" alt="Version"></a>
 </p>
 
 ## About
@@ -254,11 +254,18 @@ require "active_record"
 require "llm/active_record"
 
 class Ticket < ApplicationRecord
-  acts_as_agent provider: -> { { key: ENV["#{provider.upcase}_SECRET"], persistent: true } }
-  model "gpt-5.4-mini"
-  instructions "You are a concise support assistant."
-  tools SearchDocs, Escalate
-  concurrency :thread
+  acts_as_agent provider: :set_provider do
+    model "gpt-5.4-mini"
+    instructions "You are a concise support assistant."
+    tools SearchDocs, Escalate
+    concurrency :thread
+  end
+
+  private
+
+  def set_provider
+    { key: ENV["#{provider.upcase}_SECRET"], persistent: true }
+  end
 end
 
 ticket = Ticket.create!(provider: "openai", model: "gpt-5.4-mini")

data/lib/llm/active_record/acts_as_agent.rb

@@ -71,18 +71,21 @@ module LLM::ActiveRecord
     # @option options [Proc, Symbol, LLM::Tracer, nil] :tracer
     #   Optional tracer, method name, or proc that resolves to one and is
     #   assigned through `llm.tracer = ...` on the resolved provider.
+    # @yield
+    #   Evaluated in the model class after the wrapper is installed, so agent
+    #   DSL methods such as `model`, `tools`, `schema`, `instructions`, and
+    #   `concurrency` can be configured inline.
     # @return [void]
-    def acts_as_agent(options = EMPTY_HASH)
+    def acts_as_agent(options = EMPTY_HASH, &block)
       options = DEFAULTS.merge(options)
       usage_columns = DEFAULT_USAGE_COLUMNS.merge(options[:usage_columns] || EMPTY_HASH)
       class_attribute :llm_agent_options, instance_accessor: false, default: DEFAULTS unless respond_to?(:llm_agent_options)
       self.llm_agent_options = options.merge(usage_columns: usage_columns.freeze).freeze
       extend Hooks
+      class_exec(&block) if block
     end
 
     module InstanceMethods
-      private
-
       ##
       # Returns the resolved provider instance for this record.
       # @return [LLM::Provider]
@@ -96,6 +99,8 @@ module LLM::ActiveRecord
         @llm
       end
 
+      private
+
       ##
       # @return [LLM::Agent]
       def ctx

data/lib/llm/active_record/acts_as_llm.rb

@@ -206,8 +206,6 @@ module LLM::ActiveRecord
         ctx.tracer
       end
 
-      private
-
       ##
       # Returns the resolved provider instance for this record.
       # @return [LLM::Provider]
@@ -221,6 +219,8 @@ module LLM::ActiveRecord
         @llm
       end
 
+      private
+
       ##
       # @return [LLM::Context]
       def ctx

data/lib/llm/sequel/plugin.rb

@@ -224,8 +224,6 @@ module LLM::Sequel
       ctx.tracer
     end
 
-    private
-
     ##
     # Returns the resolved provider instance for this record.
     # @return [LLM::Provider]
@@ -239,6 +237,8 @@ module LLM::Sequel
       @llm
     end
 
+    private
+
     ##
     # @return [LLM::Context]
     def ctx

data/lib/llm/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm.rb
 version: !ruby/object:Gem::Version
-  version: 4.18.0
+  version: 4.19.0
 platform: ruby
 authors:
 - Antar Azri