llm.rb 15.0.3 → 15.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2700592b8b9fbb85694c24a0a7379a84494b0e4f2157d6302fad1552df9d684
-  data.tar.gz: 43864e55f008478a40860511f9ca138f86010695225f91f0b2a07fbcff1ed448
+  metadata.gz: 5c55a3fa1151afad5720fc33bbe60a71feed5577242e53b4e8d4e2f9962a18ed
+  data.tar.gz: 3099ef73435ed6d91b003a40e2e5c195a82a8f631418b21e7c8cbce9088a5c76
 SHA512:
-  metadata.gz: 464e203f6e4dc1fb2ea2aaa5bd4a2f95753d569190e63e4cd590b014aed4e369fa2f2835a4d6d95394b6988210c880e976abd5d8e8c69f015b057bb1f193609d
-  data.tar.gz: 9303d2475e2bd32dc53b65b7b9d54fa28611616a0714015bd1c0d74e8ca7cd66e6d88889b73231ed19dda38b2f2888ded08569694f23bd834a8e7c1f3fd6db35
+  metadata.gz: 8e0d5dd6c98355412a31dcb638081ea9f0553725cbf30aa6598eed5d16cd6d4693b5edfae8c063625ee2f5198b342e9b11850897370404267d291ddae4d747fe
+  data.tar.gz: 25102554a840fee5046804d17ff91673793603b96ab9ae246a30b7d3192a792e9bd7e384d76ce20abf2d504910330202cb2d4aef0057c7875c1ce3866ccfe177

data/CHANGELOG.md

@@ -11,10 +11,440 @@
 </p>
 
 > Changelog <br>
-> a [r.uby.dev](https://r.uby.dev) project
+> [r.uby.dev](https://r.uby.dev) project
 
 ## What's next
 
+*No unreleased changes yet. Check back after the next release.*
+
+## v15.2.0
+
+Changes since `v15.1.0`.
+
+This release renames the REPL to `LLM::Console` (with `/keep` replacing
+`/compact`) and routes every shell-out tool through a shared, bounded
+`exec` runner. It also adds `LLM::Message#created_at`, the `LLM::Tracer`
+factory methods, a `bundle` tool, per-tool `max_bytes` output limits,
+and a `-v` switch to the CLI, and refreshes the model registry.
+
+### Core
+
+* **message: add `LLM::Message#created_at`** <br>
+  [`LLM::Message#created_at`](https://r.uby.dev/api-docs/llm.rb/LLM/Message.html#created_at-instance_method)
+  returns the time the message was created, defaulting to the moment the
+  message is initialized. The timestamp is serialized into
+  [`LLM::Context#to_json`](https://r.uby.dev/api-docs/llm.rb/LLM/Context.html#to_json-instance_method)
+  as an ISO-8601 string and restored on deserialization, so it can be
+  stored alongside the rest of the conversation.
+
+### Agent
+
+* **agent: inherit the ORM model's name** <br>
+  An `acts_as_agent` (ActiveRecord) or `plugin :agent` (Sequel) model now
+  names its generated
+  [`LLM::Agent`](https://r.uby.dev/api-docs/llm.rb/LLM/Agent.html) after
+  the model class. Previously the agent was an anonymous subclass, so
+  without an explicit name it defaulted to a gibberish `#<Class:0x...>`
+  string. The wrapper now initializes the agent's name before `.agent`
+  returns, and
+  [`LLM::Agent.name`](https://r.uby.dev/api-docs/llm.rb/LLM/Agent.html#name-class_method)
+  kebab-cases a `Class` argument, so an `AdminUser` model yields an agent
+  named `admin-user`.
+
+### Cli
+
+* **cli: add a `-v` switch** <br>
+  `bin/llm.rb` gains a `-v` switch that prints the version (`llm.rb v#{LLM::VERSION}`) and exits.
+
+### Console
+
+* **console: raise `LLM::Interrupt` on the agent's thread** <br>
+  Pressing Esc to cancel now also raises `LLM::Interrupt` on the agent's
+  thread. `LLM::Agent#cancel!` alone can be a no-op at some stages of the
+  request lifecycle, so the console backs it up by interrupting the thread
+  that runs the agent.
+
+* **console: add a `/keep` command and retire `/compact`** <br>
+  The console now offers `/keep` for freeing space in the context window;
+  the `/compact` command is removed. `/keep` takes the same argument, so
+  `/keep 20%` keeps 20% of the context window. Closes
+  [issue #161](https://github.com/r-uby-dev/llm.rb/issues/161).
+
+* **console: keep the UI responsive during long streams** <br>
+  A model can emit many chunks in a single turn. The console now draws
+  at most four streamed chunks at a time, then checks for input, so the
+  UI stays responsive even when a turn produces a large amount of
+  output.
+
+* **console: persist the conversation when a turn is done** <br>
+  The console now saves the agent's state after the turn finishes,
+  rather than while the response is still streaming. State is still
+  saved every turn, but not until the turn has completed.
+
+* **console: render markdown text as typed** <br>
+  Fix a bug where [`LLM::Console::Markdown`](https://r.uby.dev/api-docs/llm.rb/LLM/Console/Markdown.html)
+  mangled the model's output: HTML could render invisible, and
+  sequences like `...` were converted to unicode glyphs. The renderer
+  now uses a custom kramdown parser that disables the HTML, smart-quote,
+  and typographic-symbol parsers, so tags and punctuation come through
+  exactly as written.
+
+* **console: fix a crash in the markdown parser** <br>
+  Fix a bug where the markdown renderer raised an error on an unclosed
+  HTML tag or a partial tag taken out of context, such as `4 < 5`. The
+  parser now emits the `<...` run literally when there is no closing
+  `>`, so the text renders instead of crashing.
+
+* **console: stop rendering bare pipes as tables** <br>
+  Fix a bug where the markdown renderer treated a lone `|foo|` in prose
+  as a table and mangled its output. A pipe line now parses as a table
+  only when a header row is followed by a delimiter row, so bare pipes
+  come through literally while real tables still render.
+
+* **console: find the worker thread when cancelling** <br>
+  Fix a bug where pressing Esc to cancel raised `LLM::Interrupt` on an
+  instance variable that does not exist, so the interrupt was a no-op and
+  a cancel could leave the turn running. The console now resolves the
+  worker thread through its `#thread` reader and interrupts it.
+
+* **console: protect the state write from cancellation** <br>
+  The console now defers `LLM::Interrupt` while it saves the agent's
+  state after a turn, so a cancel that arrives during the write cannot
+  interrupt `agent.save` mid-flight and risk a lost or corrupted session
+  file.
+
+### Tools
+
+* **tools: the command runner is now `exec`** <br>
+  The command tool that spawns a process without a shell is now
+  [`LLM::Tool::Exec`](https://r.uby.dev/api-docs/llm.rb/LLM/Tool/Exec.html),
+  with the tool name `exec` instead of the previous `shell`. This is an
+  internal refactor of the shell-out tools: `git`, `rg`, `mkdir`,
+  `ruby`, and `bundle` all route through it and inherit
+  its bounded output.
+
+* **tools: report when a command cannot be found** <br>
+  `LLM::Tool::Exec` now returns `{ok: false, error: "command 'NAME' was
+  not found on this system"}` when the requested command is missing,
+  instead of a bare `{ok: false}` result that did not tell the model why
+  the tool failed.
+
+* **tools: drop the `name:` parameter from `LLM::Tool::Exec#call`** <br>
+  `LLM::Tool::Exec#call` now takes a single `arguments:` array instead of
+  separate `name:` and `arguments:` parameters, with the command name as
+  the first element (for example `arguments: ["rg", "-m", "10", "lib"]`).
+  The `Git`, `Mkdir`, `Rg`, `Ruby`, and `Bundle` tools build their calls
+  the same way. The change was made after models were observed confusing
+  the two parameters, so a single list is simpler and more reliable.
+
+* **tools: rename `repl` as `console`** <br>
+  The interactive loop is renamed to
+  [`LLM::Console`](https://r.uby.dev/api-docs/llm.rb/LLM/Console.html),
+  which better reflects what it does. `agent.console` is the primary
+  entry point, and the require path moves from `llm/repl` to
+  `llm/console`. Backwards-compatible aliases remain: `LLM::Repl`,
+  `LLM::Agent#repl`, the ORM wrappers' `#repl`, and `LLM::Command =`
+  `LLM::Console::Command`.
+
+* **tools: `LLM::Tool::Git#call` takes an `arguments:` array** <br>
+  [`LLM::Tool::Git#call`](https://r.uby.dev/api-docs/llm.rb/LLM/Tool/Git.html)
+  now takes a single `arguments:` array in place of the previous
+  `subcommand:` parameter. The first element must be one of `log`,
+  `diff`, `commit`, `checkout`, `branch`, or `show`, validated before the
+  command is spawned; the remaining elements are forwarded to git.
+
+* **tools: `LLM::Tool::Utils` now owns command spawning** <br>
+  The shared [`LLM::Tool::Utils`](https://r.uby.dev/api-docs/llm.rb/LLM/Tool/Utils.html)
+  module now requires the `test-cmd.rb` gem (at `~> 2.7.1`) itself and
+  exposes the `spawn` and `wait` helpers, so any tool that includes
+  `Utils` gets command spawning without requiring `exec` directly. The
+  `Git`, `Mkdir`, `Rg`, `Ruby`, `Exec`, and `Bundle` tools all
+  inherit their bounded-output protections from this shared runner.
+
+* **tools: route `git`, `rg`, `mkdir`, and `ruby` through `exec`** <br>
+  `LLM::Tool::Git`, `LLM::Tool::Rg`, `LLM::Tool::Mkdir`, and
+  `LLM::Tool::Ruby` now implement their calls through the `exec` tool,
+  completing the refactor so every tool that shells out flows through
+  the shared command runner with its bounded output.
+
+* **tools: read-file returns structured lines** <br>
+  `LLM::Tool::ReadFile#call` now returns its content as structured
+  `{lineno:, content:}` lines under a `lines:` key instead of a single
+  `content:` string, and adds a `truncated:` flag. A reversed range
+  (`start: 20, stop: 2`) is swapped to read lines 2 through 20. The
+  truncation marker is kept out of the returned lines, so the model
+  does not mistake it for a real file line.
+
+* **tools: write-file appends a trailing newline by default** <br>
+  `LLM::Tool::WriteFile` now ensures written content ends with a newline,
+  adding one when the content does not already end with `\n`. It previously
+  wrote the content exactly as given. A new `newline:` parameter (default
+  `true`) controls this, so `newline: false` writes the content exactly as
+  given.
+
+* **tools: fix `edit-file` treating `before` as a regex** <br>
+  `LLM::Tool::EditFile` now escapes the `before` snippet with
+  `Regexp.escape`, so regex metacharacters are matched literally, and
+  switches to the block form of `sub` so the `after` replacement keeps
+  backslash sequences like `\1` and `\&` literal.
+
+* **tools: bound tool output with a per-tool `max_bytes`** <br>
+  Each of the `Exec`, `ReadFile`, `Rg`, `Mkdir`, `Ruby`, and
+  `Bundle` tools gains a `max_bytes` limit (default 75,000) for the
+  maximum number of bytes a tool returns to the model. `Exec` and
+  `ReadFile` add the class-level `max_bytes` accessor, which the other
+  tools inherit through `Exec`, so each tool's cap can be configured
+  independently, for example `LLM::Tool::ReadFile.max_bytes(175_000)`.
+  It does not enforce the limit by itself;
+  [`LLM::Tool::Utils#truncate`](https://r.uby.dev/api-docs/llm.rb/LLM/Tool/Utils.html#truncate-instance_method)
+  trims a string within the limit and marks the trailing content as
+  truncated, and `truncate!` returns a `[content, truncated]` tuple for
+  callers that structure truncated output themselves. `rg` also gains a
+  `max_count:` parameter that caps the number of results per file.
+
+* **tools: add a `bundle` tool** <br>
+  A new [`LLM::Tool::Bundle`](https://r.uby.dev/api-docs/llm.rb/LLM/Tool/Bundle.html)
+  tool runs a command through `bundle`. It uses the `BUNDLE_GEMFILE`
+  environment variable when set, or a `Gemfile` in the current working
+  directory otherwise. The tool takes an `arguments:` array, so the
+  model passes the bundle command and its arguments as a single list,
+  for example `arguments: ["exec", "rspec"]`.
+
+* **tools: resolve defaults through `LLM::Utils.resolve_option`** <br>
+  A tool parameter default can now be an immediate value, a Symbol resolved
+  as a method on the tool, or a Proc evaluated lazily at runtime, matching
+  how `LLM::Agent` resolves its attributes. This lets a default track a
+  value that can change between boot and runtime, such as a tool's
+  `max_bytes`.
+
+### Registry
+
+* **refresh model metadata** <br>
+  Update `data/` with current pricing, limits, and capabilities for the
+  OpenRouter, OpenAI, Bedrock, DeepInfra, DeepSeek, Google, Mistral,
+  Moonshot, Z.ai, and Alibaba registries.
+
+### Provider
+
+* **provider: retry `Net::WriteTimeout`, too** <br>
+  Requests that raise `Net::WriteTimeout` are now retried alongside the
+  other timed-out and rate-limited requests, up to the `retry_budget`,
+  matching how `Net::OpenTimeout` and `Net::ReadTimeout` are handled. The
+  console status bar also reports a write timeout as `Timed out`.
+
+* **alibaba: default to a retry budget of 8** <br>
+  An agent that runs on the Alibaba provider now defaults to a retry
+  budget of 8 instead of 5, because Alibaba (token plan) frequently rate
+  limits and times out requests that it later recovers from. An explicit
+  `retry_budget:` still overrides the default.
+
+* **deepseek: default to the `deepseek-flash` model** <br>
+  The default DeepSeek chat model is now `deepseek-flash` instead of
+  `deepseek-v4-flash`. DeepSeek resolves `deepseek-flash` to
+  `deepseek-v4.1-flash` and recommends the name in its documentation and
+  API error messages, so the default follows the current model alias
+  instead of a pinned version.
+
+### Tracer
+
+* **tracer: add `LLM::Tracer` factory methods** <br>
+  Add
+  [`LLM::Tracer.logger`](https://r.uby.dev/api-docs/llm.rb/LLM/Tracer.html#logger-class_method),
+  [`LLM::Tracer.pretty_logger`](https://r.uby.dev/api-docs/llm.rb/LLM/Tracer.html#pretty_logger-class_method),
+  and
+  [`LLM::Tracer.telemetry`](https://r.uby.dev/api-docs/llm.rb/LLM/Tracer.html#telemetry-class_method)
+  as the preferred way to build a tracer for a provider, so switching
+  between tracers means changing a factory method instead of a class name.
+  The old `LLM.logger(llm, ...)` convenience method is removed in favor
+  of `LLM::Tracer.logger(llm, ...)`.
+
+* **tracer: add `path:` support to `LLM::Tracer::PrettyLogger`** <br>
+  [`LLM::Tracer::PrettyLogger`](https://r.uby.dev/api-docs/llm.rb/LLM/Tracer/PrettyLogger.html)
+  now accepts a `path:` option to write its human-readable entries to a
+  file, matching `LLM::Tracer::Logger`. It previously only accepted `io:`.
+
+### Fix
+
+* **json: scrub invalid UTF-8 on dump** <br>
+  Fix a bug where [`LLM::JSONAdapter`](https://r.uby.dev/api-docs/llm.rb/LLM/JSONAdapter.html)
+  raised a JSON generator error when dumping a string tagged as UTF-8 that
+  carried invalid bytes. The normalize step now transcodes every string to
+  valid UTF-8, replacing invalid sequences with the replacement character,
+  so dumping works on `json ~> 3.0`. The `oj` and `yajl` adapters now run
+  the same normalization, so every backend scrubs invalid bytes before
+  serializing.
+
+* **fork: require xchan.rb `~> 0.23`** <br>
+  The `:fork` concurrency strategy now requires the `xchan.rb` gem at
+  `~> 0.23` instead of `~> 0.22`. xchan.rb 0.23.0 replaces the external
+  `lockf.rb` gem with a built-in, Fiddle-based `Chan::Lockf`, so fork
+  channels no longer carry that extra dependency. (The socket
+  length-header deadlock fix shipped earlier, in xchan.rb 0.22.0.)
+
+* **async: fix a shutdown exception on the reactor thread** <br>
+  Fix a bug where the `:async` strategy's
+  [`LLM::Function::Async::Reactor`](https://r.uby.dev/api-docs/llm.rb/LLM/Function/Async/Reactor.html)
+  raised a `TypeError` on shutdown with recent `async` and `io-event`
+  versions, because their internals tried to raise an integer as an
+  exception. The scheduler is now detached from the reactor thread
+  before it exits, which avoids that code path entirely, and teardown
+  is managed by `reactor.stop`, so the thread exits promptly instead of
+  abruptly or hanging.
+
+* **openai: prevent the loss of user messages in the completions path** <br>
+  Fix a bug where the request body was built from `params[:messages]`
+  alone when that key was present, discarding the messages built from the
+  prompt. The DeepSeek and Alibaba schema support injects the schema
+  system message into `params[:messages]`, so a request with a `schema:`
+  could be sent with the schema message only, dropping the user's
+  messages. The built messages now lead with `params[:messages]`, and the
+  key is removed before the body is assembled.
+
+## v15.1.0
+
+Changes since `v15.0.3`.
+
+This release adds the OpenRouter provider, splits provider timeouts
+into `connect_timeout` and `read_timeout`, retries timed-out requests,
+and renames `on_rate_limit` to `on_retry`. Skills now gain a
+frontmatter `model:` parameter and inherit the parent agent's model,
+while the CLI gains `-m` and `-x` switches, and the console shows retry
+progress and measures text by display width.
+
+### Provider
+
+* **add `LLM::OpenRouter` for the OpenRouter provider** <br>
+  [`LLM::OpenRouter`](https://r.uby.dev/api-docs/llm.rb/LLM/OpenRouter.html)
+  is a new provider that talks to [OpenRouter](https://openrouter.ai)
+  through its OpenAI-compatible API, contributed via
+  [PR #165](https://github.com/r-uby-dev/llm.rb/pull/165). Create an
+  instance with
+  [`LLM.openrouter`](https://r.uby.dev/api-docs/llm.rb/LLM.html#openrouter-class_method),
+  which accepts the same `key:`, `host:`, and `base_path:` options as the
+  OpenAI provider. It defaults to the `openrouter/auto` router model and
+  supports chat completions, streaming, tool calls, structured output,
+  and embeddings; image, audio, moderation, files, and vector store
+  endpoints raise `NotImplementedError`. Model metadata ships in
+  `data/openrouter.json` for the registry.
+
+* **provider: `LLM::Provider#with` accepts headers without the `headers:` keyword** <br>
+  [`LLM::Provider#with`](https://r.uby.dev/api-docs/llm.rb/LLM/Provider.html#with-instance_method)
+  now accepts headers directly as a Hash (`llm.with("User-Agent" => "llmrb/1.0")`)
+  in addition to the legacy `headers:` keyword form. Both are merged, and
+  the keyword form remains for backwards compatibility.
+
+* **providers: `model: nil` falls back to `default_model`** <br>
+  [`LLM::Provider`](https://r.uby.dev/api-docs/llm.rb/LLM/Provider.html)
+  now treats a `model: nil` payload as "use the default model" instead of
+  sending a model value that providers reject. Previously a `{model: nil}`
+  param overwrote the default and then was removed by `.compact`, leaving
+  undefined behavior where providers could reject the request.
+
+* **openai: handle `model: nil` in the Responses API** <br>
+  The OpenAI Responses API path now also falls back to the default model
+  when `model: nil`, matching the completions path.
+
+* **provider: separate `connect_timeout` and `read_timeout`** <br>
+  [`LLM::Provider`](https://r.uby.dev/api-docs/llm.rb/LLM/Provider.html)
+  now accepts a `connect_timeout:` for opening the connection (default 5
+  seconds) and a `read_timeout:` for waiting on an idle connection (default
+  600 seconds), instead of a single `timeout`. The legacy `timeout:` option
+  remains as a shorthand for `read_timeout`. The provider exposes the new
+  `#read_timeout` and `#connect_timeout` accessors.
+
+* **provider: retry timed-out requests** <br>
+  Requests that time out (`Net::OpenTimeout` or `Net::ReadTimeout`) are now
+  retried along with rate-limited requests, up to the `retry_budget`. When
+  a heavily loaded provider (for example DeepSeek) drops the connection
+  during the connect or read phase, the request is retried instead of
+  failing, and the stream is notified through `on_retry`.
+
+* **context: retry on `LLM::InsufficientQuotaError`, too** <br>
+  A request that raises
+  [`LLM::InsufficientQuotaError`](https://r.uby.dev/api-docs/llm.rb/LLM/InsufficientQuotaError.html)
+  is now retried like other rate-limited requests. The error is a subclass
+  of `LLM::RateLimitError` and can be raised at regular intervals, in
+  particular by the Alibaba provider.
+
+* **cost: return `LLM::Cost.zero` when the registry has no pricing** <br>
+  Add
+  [`LLM::Cost.zero`](https://r.uby.dev/api-docs/llm.rb/LLM/Cost.html#zero-class_method),
+  a factory for a zero-valued cost breakdown.
+  [`LLM::Context#cost`](https://r.uby.dev/api-docs/llm.rb/LLM/Context.html#cost-instance_method)
+  now returns it when the active model has no pricing in the registry (for
+  example OpenRouter's `openrouter/auto` router model), instead of crashing
+  on a nil pricing entry.
+
+### Skills
+
+* **skills: add a `model` frontmatter parameter** <br>
+  A skill's `SKILL.md` frontmatter can now declare a `model:` value, so a
+  skill's sub-agent runs on a specific model instead of the default. This
+  lets a parent agent run on one model (for example `deepseek-v4-flash`)
+  while the skill runs on another (`deepseek-v4-pro`). The `model` value is
+  not strictly portable between providers.
+
+* **skills: inherit the model of the parent agent** <br>
+  A skill's sub-agent now inherits the active model of the agent that
+  spawns it instead of falling back to the provider default. The frontmatter
+  `model:` parameter overrides it explicitly when set.
+  [`LLM::Context#model`](https://r.uby.dev/api-docs/llm.rb/LLM/Context.html#model-instance_method)
+  now falls back to the provider's default model when no model is set.
+
+### Stream
+
+* **stream: rename `on_rate_limit` to `on_retry`** <br>
+  [`LLM::Stream#on_rate_limit`](https://r.uby.dev/api-docs/llm.rb/LLM/Stream.html#on_rate_limit-instance_method)
+  is renamed to
+  [`LLM::Stream#on_retry`](https://r.uby.dev/api-docs/llm.rb/LLM/Stream.html#on_retry-instance_method),
+  which fires when a request is retried after a rate limit or a timeout,
+  and now receives the one-based retry attempt number as a second argument.
+  The old `on_rate_limit` name remains as an alias.
+
+### CLI
+
+* **cli: add a `-m` switch for choosing the model** <br>
+  `bin/llm.rb` now accepts `-m MODEL` to run the session on a model other
+  than the provider default, for example
+  `llm.rb -p deepseek -m deepseek-v4-pro`. A model unknown to the provider's
+  registry prints an error and exits.
+
+* **cli: add a `-x` switch for the read timeout** <br>
+  `bin/llm.rb` now accepts `-x SECONDS` to set the provider read timeout.
+
+* **cli: print a backtrace on fatal crashes** <br>
+  When `bin/llm.rb` hits an unexpected error, the crash message now includes
+  up to three stack lines from the backtrace, so the failure is easier to
+  locate and report than a bare diagnostic.
+
+### Console
+
+* **console: show retry progress in the status bar** <br>
+  When a request is rate limited or times out, the curses-based console status
+  bar shows a retry indicator with the error and the remaining attempts, for
+  example `🔁 Rate limited • attempt 2 of 5`.
+
+* **console: measure text width with `unicode-display_width`** <br>
+  The curses-based console now counts and slices text by display column width
+  instead of character count, so wrapping, table columns, and clipping stay
+  aligned for wide characters such as emoji. It requires the optional
+  `unicode-display_width` gem.
+
+* **console: treat `LLM::InsufficientQuotaError` as a rate limit in the status bar** <br>
+  The curses-based console status bar now shows `Rate limited` when a request
+  raises
+  [`LLM::InsufficientQuotaError`](https://r.uby.dev/api-docs/llm.rb/LLM/InsufficientQuotaError.html),
+  matching how ordinary `LLM::RateLimitError`s are shown, instead of falling
+  through to the raw class name.
+
+### Registry
+
+* **refresh model metadata** <br>
+  Update `data/*.json` with current model listings and pricing, adding
+  GPT-5.6 Sol, Terra, and Luna models to Bedrock, Grok 4.6 and Grok Imagine
+  Image 2.0 to xAI, DeepSeek V4 Flash Vision to DeepSeek, and DeepSeek V4
+  Pro 0813, Qwen3 VL, and Qwen3.8 models to DeepInfra.
+
 ## v15.0.3
 
 Changes since `v15.0.2`.
@@ -1077,7 +1507,7 @@ reliable across all six concurrency backends. The `functions` and
   `LLM.require` now accepts a second `version` parameter that is passed
   to `Kernel#gem` before loading, enabling version constraints for
   optional runtime dependencies. For example,
-  `LLM.require "test-cmd.rb", "~> 1.1"` ensures a minimum gem version
+  `LLM.require "test-cmd.rb", "~> 2.2"` ensures a minimum gem version
   is available. This is used internally by the `Git`, `Rg`, `Mkdir`,
   and `Shell` tools to enforce compatibility with the `test-cmd.rb` gem.
 
@@ -2141,7 +2571,7 @@ As always, see the changelog details for a thorough overview.
 * **Add `LLM::Agent#repl`** <br>
   Add a curses-based read-eval-print loop for `LLM::Agent` that lets
   developers interact with an agent after it has been set up or has
-  performed a task. It is similar to `binding.pry`: once you exit,
+  performed a task. It is similar to `binding.irb`: once you exit,
   you can continue with the rest of your program. It requires the
   `curses` gem.