LlmUtils — LLM Utilities

LLM utility toolkit for Elixir: JSON extraction, defensive decoding, response parsing, and more.

Extracts JSON objects and arrays from LLM markdown responses, provides defensive JSON decoding with automated repair via json_remedy, and offers a full response parser for structured LLM output.

Installation

def deps do
[
{:llm_utils, "~> 0.1.0"}
]
end

Modules

JsonExtractor — extract JSON from LLM output

AnanthaJson.JsonExtractor.extract("""
Here is the result:
```json
{"key": "value"}

""")

=> "{"key": "value"}"

AnanthaJson.JsonExtractor.extract_array("json\\n[1, 2, 3]\\n")

=> "[1, 2, 3]"

AnanthaJson.JsonExtractor.extract_all_objects(~s({"a": 1} {"b": 2}))

=> ["{"a": 1}", "{"b": 2}"]

### JsonAdapter — defensive JSON decode
```elixir
AnanthaJson.JsonAdapter.decode(~s({"key": "value"}))
# => {:ok, %{"key" => "value"}}
AnanthaJson.JsonAdapter.decode(~s({"key": "value",}))
# => {:ok, %{"key" => "value"}}
AnanthaJson.JsonAdapter.decode!("not json")
# => ** (RuntimeError) JsonAdapter failed: ...

ResponseParser — full LLM response parsing

AnanthaJson.ResponseParser.parse(~s({"key": "value"}))
# => {:ok, %{"key" => "value"}}
AnanthaJson.ResponseParser.parse_and_extract(~s({"name": "Alice"}), "name")
# => {:ok, "Alice"}
AnanthaJson.ResponseParser.parse_first_with_key(~s({"a": 1} {"name": "Bob"}), "name")
# => {:ok, %{"name" => "Bob"}}

Dependencies