llm.rb 12.0.0 → 12.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e042f679a5f682feed6726430dd1b28fd6728c9223cbd0e0499c92e8952a06e6
-  data.tar.gz: 0cb3f55e70a321bea3f1903261142bf3aa842fface494331a548f684aac520d8
+  metadata.gz: e4c7d2a7e0fd6a5b05cfdaaf2702f94f9a15d3e277739559f5cb676768fe6a9c
+  data.tar.gz: ad3081a38e1096459791ec6cffd1ae0a8550f5d4df2c6c95fd8842b78a0024f4
 SHA512:
-  metadata.gz: ba64ba9b87d1343f9d94a06b97cb6cc0ec0ca5d7a8c4b235e52c9ed489c5670848b44e0549e838b01b12be89d19005ba571a6dd9557a8f2f5f4e62a3ec018ec9
-  data.tar.gz: 81a489afa510edf608b74a3a83abc16b6d81c6f59f614df6460f638dbcf1e0a539d8d2b6b2e5a98a3772d5c9d7c7233d7b231bbf447dda7cfcf8df1861819c8d
+  metadata.gz: 0e5a58f5b22d07b05d981423414de270b1ae760c7920452e736a55709c6c1eeee941407de8a8667365ee83943deeb0554d05bec5425b7132fe907dc62f349ffa
+  data.tar.gz: fabedc3aad36ba5cbaf7b126c55ddc3cbb428aadb3b2887a40e429daf35c65ff81a4d8c903583dea27c051d89f076d9d3446736e948954a6cef26065aebfa624

data/CHANGELOG.md

@@ -13,7 +13,118 @@
 > Changelog <br>
 > a [r.uby.dev](https://r.uby.dev) project
 
-## Unreleased
+## What's next
+
+Changes since `v12.1.0`.
+
+## v12.1.0
+
+Changes since `v12.0.0`.
+
+This release adds `LLM::Agent#repl` with a curses-based
+interactive read-eval-print loop. It requires the optional
+dependency `curses` and it is probably the most notable
+feature in this release.
+
+Multiple _opt-in_ tools have been added to the `llm/tools/*.rb`
+directory. They serve as examples and as general-purpose tools
+that happen to power the repository's agents.
+
+The BSL license has been extended to grant additional free waivers
+for non-profits, charities and for companies with 50 or less
+employees.
+
+Other changes include small-ish bug fixes. <br>
+As always, see the changelog details for a thorough overview.
+
+### Add
+
+* **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,
+  you can continue with the rest of your program. It requires the
+  `curses` gem.
+
+* **Add `#tracer=` setter on Provider, Context and Agent** <br>
+  `LLM::Provider`, `LLM::Context` and `LLM::Agent` can now configure
+  the tracer after initialization via the `#tracer=` setter. It accepts
+  a subclass of `LLM::Tracer` or `nil` to disable the tracer.
+
+* **Add `LLM::Tool::Shell`** <br>
+  Add a built-in shell tool that can run a command with arguments. <br>
+  It must be required explicitly with `require "llm/tools/shell"` and
+  requires the `test-cmd.rb` gem.
+
+* **Add `LLM::Tool::ReadFile`** <br>
+  Add a built-in tool for reading the contents of a file, with optional
+  `start` and `stop` line offsets. <br>
+  It must be required explicitly with `require "llm/tools/read_file"`.
+
+* **Add `LLM::Tool::Chdir`** <br>
+  Add a built-in tool for changing the current working directory. <br>
+  It must be required explicitly with `require "llm/tools/chdir"`.
+
+* **Add `LLM::Tool::Git`** <br>
+  Add a built-in tool that can perform git actions (`log`, `diff`,
+  `show`, `commit`, `checkout`, `branch`). <br>
+  It must be required explicitly with `require "llm/tools/git"` and requires the `test-cmd.rb` gem.
+
+* **Add `LLM::Tool::Rg`** <br>
+  Add a built-in tool that wraps the `rg` (ripgrep) command for
+  recursively searching the current directory for patterns. <br>
+  It must be required explicitly with `require "llm/tools/rg"` and requires the `test-cmd.rb` gem.
+
+* **Add `LLM::Tool::SwapText`** <br>
+  Add a built-in tool that can replace an exact snippet of text in a
+  file with a new piece of text. <br>
+  It must be required explicitly with `require "llm/tools/swap_text"`.
+
+* **Add `LLM::Tool::Pwd`** <br>
+  Add a built-in tool that returns the current working directory. <br>
+  It must be required explicitly with `require "llm/tools/pwd"`.
+
+* **Add `LLM::Tool::WriteFile`** <br>
+  Add a built-in tool that can write a given string to a given file
+  path. <br>
+  It must be required explicitly with `require "llm/tools/write_file"`.
+
+* **Add `LLM::Tool::Mkdir`** <br>
+  Add a built-in tool that can create a tree of new directories. <br>
+  It must be required explicitly with `require "llm/tools/mkdir"` and
+  requires the `test-cmd.rb` gem.
+
+### Change
+
+* **Extend BSL additional use grant** <br>
+  The Business Source License additional use grant has been extended to
+  include non-profits, charities, and companies with 50 or fewer
+  employees, in addition to the existing personal, education, and
+  evaluation uses.
+
+* **Change LlamaCpp default port (8080 => 8013)** <br>
+  The default port for the LlamaCpp provider has changed from `8080` to
+  `8013` since llamacpp itself defaults to that port.
+
+* **Change LlamaCpp default model to `nil`** <br>
+  The default model for LlamaCpp is now `nil`, letting whatever model
+  is served by the llamacpp server act as the default. Previously it
+  defaulted to `qwen3`.
+
+### Fix
+
+* **Fix `LLM::Agent.tools` Symbol resolution** <br>
+  When an agent defined tools via `tools :method_name`, the resolved
+  symbol was incorrectly forwarded as `[:method_name]` (an array) to
+  `LLM::Context`. This fix copies the same pattern used by other
+  attribute resolvers (e.g., `skills`) so a single Symbol is resolved
+  through the agent instance correctly.
+
+* **Encode strings as UTF-8 in the JSON adapter** <br>
+  The `json` gem will reject BINARY-encoded strings from version 3 and
+  beyond. The `LLM::JSONAdapter.dump` method now walks serialized data
+  and encodes every string into UTF-8, using `String#scrub` to replace
+  bytes that are not valid UTF-8.
 
 ## v12.0.0
 

data/LICENSE

@@ -10,10 +10,11 @@ Licensor: Robert Gleeson
 Licensed Work: llm.rb
 
 Additional Use Grant:
-Free for personal use.
-Free for education.
-Free for evaluation, development, and testing.
-Commercial production use requires a commercial license.
+- Free for personal use
+- Free for students and their teachers
+- Free for evaluation, development, and testing
+- Free for non-profits and charities
+- Free for companies with less than or equal to 50 employees
 
 Change Date:
 Four years after the first public release of each specific version of the

data/README.md

@@ -10,7 +10,7 @@
   </a>
 </p>
 
-> A [r.uby.dev](https://r.uby.dev) project.
+> A [r.uby.dev](https://r.uby.dev/llm) project.
 
 Welcome to the canonical llm.rb repository.
 
@@ -117,6 +117,24 @@ agent = LLM::Agent.new(llm, stream: MyStream.new)
 agent.talk "Explain Ruby fibers."
 ```
 
+#### LLM::REPL
+
+The [LLM::Agent#repl](https://r.uby.dev/api-docs/llm.rb/LLM/Agent.html#repl-instance_method)
+method allows an agent to spawn a read-eval-print loop
+that can be useful during the development and operation
+of agents. It can be used to debug tool calls, confirm an
+agent has done what was expected, or improve the agent
+by asking questions about what it has done up to that point.
+
+This feature requires that the [curses](https://github.com/ruby/curses)
+library is installed and available to require.
+
+```ruby
+llm = LLM.deepseek(key: ENV["KEY"])
+agent = LLM::Agent.new(llm)
+agent.repl
+```
+
 #### LLM::MCP
 
 The Model Context Protocol (MCP) has first-class support
@@ -335,3 +353,14 @@ Each version converts to the [BSD Zero Clause](https://choosealicense.com/licens
 four years after its first public release.
 <br>
 Contact [robert@r.uby.dev](mailto:robert@r.uby.dev) for a commercial license.
+
+### Waivers
+
+Waivers are automatically granted for: <br>
+
+  * Personal use
+  * Students
+  * Teachers
+  * Evaluation, development, and testing
+  * Non-profits and charities
+  * Companies with less than or equal to 50 employees