llm.rb 4.15.0 → 4.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40217f9b44b00028739994a8f6f6a278b366d7fa7f4799b86afd2b793f367084
-  data.tar.gz: cf7e6d7935cf6ab8479ac864e09ea7a4403a97345f98e30ae03de9ae941c97a0
+  metadata.gz: 793403110075dfcc650d4b0931ebcdfee74787ce1412b61318d7d749b22c3e9f
+  data.tar.gz: 469e1b635896822483e8a6ec7cebaf8c34443b90010435c4ae2d4899fd71c1b4
 SHA512:
-  metadata.gz: 3850bb93244032d3ee721c1a7bc85efd0e86f605a421960abfbab56b89b9b4c36d97efb68970759561f08f165069e4c2e213132c0bb485b3366c57bebb71e3ad
-  data.tar.gz: 2856c27c38e6d6d8d659d8a21c13b4ea514fdc0a0bd024935b2ea2f20d10eac96f324489f1c06a08c9bad6be5f97756eedc38b9f301e7a78533a8422f02cd329
+  metadata.gz: 515e571ad97704659363a764f633c9199239d0ad1e741b1239e7528cf455160a1246ba756fa16201c47f03b5185939809842eef28aaeb45123aa38c038c23232
+  data.tar.gz: 180e987e00885e15d004965e98c5b70b00481568be43c168431afaad27baed40adfb8c93a9cad10fb96210dad3e768407524422b5edf0c62b011ef57900ac742

data/CHANGELOG.md

@@ -2,8 +2,30 @@
 
 ## Unreleased
 
+Changes since `v4.16.0`.
+
+## v4.16.0
+
 Changes since `v4.15.0`.
 
+This release expands ORM support with built-in ActiveRecord persistence
+and improves compatibility with OpenAI-compatible gateways, proxies, and
+self-hosted servers that use non-standard API root paths.
+
+### Change
+
+* **Support OpenAI-compatible base paths** <br>
+  Add `base_path:` to provider configuration so OpenAI-compatible
+  endpoints can vary both host and API prefix. This supports providers,
+  proxies, and gateways that keep OpenAI request shapes but use
+  non-standard URL layouts such as DeepInfra's `/v1/openai/...`.
+
+* **Add ActiveRecord context persistence with `acts_as_llm`** <br>
+  Add a built-in ActiveRecord wrapper that mirrors the Sequel plugin
+  API so applications can persist `LLM::Context` state on records with
+  default columns, provider/context hooks, validation-backed writes,
+  and `format: :string`, `:json`, or `:jsonb` storage.
+
 ## v4.15.0
 
 Changes since `v4.14.0`.

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.15.0-green.svg?" alt="Version"></a>
+  <a href="https://github.com/llmrb/llm.rb/tags"><img src="https://img.shields.io/badge/version-4.16.0-green.svg?" alt="Version"></a>
 </p>
 
 ## About
@@ -17,9 +17,9 @@ state.
 It is built for engineers who want control over how these systems run. llm.rb
 stays close to Ruby, runs on the standard library by default, loads optional
 pieces only when needed, and remains easy to extend. It also works well in
-Rails or ActiveRecord applications, and it includes built-in Sequel plugin
-support, where a small wrapper around context persistence is enough to save
-and restore long-lived conversation state across requests, jobs, or retries.
+Rails or ActiveRecord applications, with built-in `acts_as_llm`, and includes
+built-in Sequel support through `plugin :llm`, so long-lived context state can
+be saved and restored across requests, jobs, or retries.
 
 Most LLM libraries stop at request/response APIs. Building real systems means
 stitching together streaming, tools, state, persistence, and external
@@ -87,12 +87,12 @@ same context object.
 - **MCP is built in** <br>
   Connect to MCP servers over stdio or HTTP without bolting on a separate
   integration stack.
-- **Sequel persistence is built in** <br>
-  Use `plugin :llm` to persist `LLM::Context` state on a Sequel model with
-  sensible default columns, then pass provider setup through
-  `provider:` when you need it. Use `format: :string` for text columns or
-  `format: :jsonb` when you want native PostgreSQL JSON storage with Sequel's
-  JSON typecasting support enabled.
+- **ActiveRecord and Sequel persistence are built in** <br>
+  Use `acts_as_llm` on ActiveRecord models or `plugin :llm` on Sequel models
+  to persist `LLM::Context` state with sensible default columns. Both support
+  `provider:` and `context:` hooks, plus `format: :string` for text columns
+  or `format: :jsonb` for native PostgreSQL JSON storage when ORM JSON
+  typecasting support is enabled.
 - **Persistent HTTP pooling is shared process-wide** <br>
   When enabled, separate
   [`LLM::Provider`](https://0x1eef.github.io/x/llm.rb/LLM/Provider.html)
@@ -101,6 +101,10 @@ same context object.
   [`LLM::MCP`](https://0x1eef.github.io/x/llm.rb/LLM/MCP.html)
   instances can do the same, instead of each object creating its own
   isolated per-instance transport.
+- **OpenAI-compatible gateways are supported** <br>
+  Target OpenAI-compatible services such as DeepInfra and OpenRouter, as well
+  as proxies and self-hosted servers, with `host:` and `base_path:` when they
+  preserve OpenAI request shapes but change the API root path.
 - **Provider support is broad** <br>
   Work with OpenAI, OpenAI-compatible endpoints, Anthropic, Google, DeepSeek,
   Z.ai, xAI, llama.cpp, and Ollama through the same runtime.
@@ -203,12 +207,30 @@ ctx.talk("Remember that my favorite language is Ruby")
 puts ctx.talk("What is my favorite language?").content
 ```
 
+**ActiveRecord (ORM)**
+
+See the [deepdive](https://0x1eef.github.io/x/llm.rb/file.deepdive.html) for more examples.
+
+```ruby
+require "llm"
+require "active_record"
+require "llm/active_record"
+
+class Context < ApplicationRecord
+  acts_as_llm provider: -> { { key: ENV["#{provider.upcase}_SECRET"], persistent: true } }
+end
+
+ctx = Context.create!(provider: "openai", model: "gpt-5.4-mini")
+ctx.talk("Remember that my favorite language is Ruby")
+puts ctx.talk("What is my favorite language?").content
+```
+
 ## Resources
 
 - [deepdive](https://0x1eef.github.io/x/llm.rb/file.deepdive.html) is the
   examples guide.
-- [_examples/relay](./_examples/relay) shows a real application built on top
-  of llm.rb.
+- [relay](https://github.com/llmrb/relay) shows a real application built on
+  top of llm.rb.
 - [doc site](https://0x1eef.github.io/x/llm.rb?rebuild=1) has the API docs.
 
 ## License