llm.rb 4.8.0 → 4.9.0

data/llm.gemspec

@@ -5,17 +5,52 @@ require_relative "lib/llm/version"
 Gem::Specification.new do |spec|
   spec.name = "llm.rb"
   spec.version = LLM::VERSION
-  spec.authors = ["Antar Azri", "0x1eef"]
-  spec.email = ["azantar@proton.me", "0x1eef@proton.me"]
+  spec.authors = ["Antar Azri", "0x1eef", "Christos Maris", "Rodrigo Serrano"]
+  spec.email = ["azantar@proton.me", "0x1eef@hardenedbsd.org"]
 
   spec.summary = <<~SUMMARY
-  llm.rb is a zero-dependency Ruby toolkit for Large Language Models that
-  includes OpenAI, Gemini, Anthropic, xAI (grok), zAI, DeepSeek, Ollama, and
-  LlamaCpp. The toolkit includes full support for chat, streaming, tool calling,
-  audio, images, files, and structured outputs.
+  llm.rb is a Ruby-centric toolkit for building real LLM-powered systems — where
+  LLMs are part of your architecture, not just API calls. It gives you explicit
+  control over contexts, tools, concurrency, and providers, so you can compose
+  reliable, production-ready workflows without hidden abstractions.
   SUMMARY
 
-  spec.description = spec.summary
+  spec.description = <<~DESCRIPTION
+  llm.rb is a Ruby-centric toolkit for building real LLM-powered systems — where
+  LLMs are part of your architecture, not just API calls. It gives you explicit
+  control over contexts, tools, concurrency, and providers, so you can compose
+  reliable, production-ready workflows without hidden abstractions.
+
+  Built for engineers who want to understand and control their LLM systems. No
+  frameworks, no hidden magic — just composable primitives for building real
+  applications, from scripts to full systems like Relay.
+
+  ## Key Features
+
+  - **Contexts are central** — Hold history, tools, schema, usage, cost, persistence, and execution state
+  - **Tool execution is explicit** — Run local, provider-native, and MCP tools sequentially or concurrently
+  - **One API across providers** — Unified interface for OpenAI, Anthropic, Google, xAI, zAI, DeepSeek, Ollama, and LlamaCpp
+  - **Thread-safe where it matters** — Providers are shareable, while contexts stay isolated and stateful
+  - **Production-ready** — Cost tracking, observability, persistence, and performance tuning built in
+  - **Stdlib-only by default** — Runs on Ruby standard library, with optional features loaded only when used
+
+  ## Capabilities
+
+  - Chat & Contexts with persistence
+  - Streaming responses
+  - Tool calling with JSON Schema validation
+  - Concurrent execution (threads, fibers, async tasks)
+  - Agents with auto-execution
+  - Structured outputs
+  - MCP (Model Context Protocol) support
+  - Multimodal inputs (text, images, audio, documents)
+  - Audio generation, transcription, translation
+  - Image generation and editing
+  - Files API for document processing
+  - Embeddings and vector stores
+  - Local model registry for capabilities, limits, and pricing
+  DESCRIPTION
+
   spec.license = "0BSD"
   spec.required_ruby_version = ">= 3.2.0"
 
@@ -23,10 +58,12 @@ Gem::Specification.new do |spec|
   spec.metadata["homepage_uri"] = "https://github.com/llmrb/llm.rb"
   spec.metadata["source_code_uri"] = "https://github.com/llmrb/llm.rb"
   spec.metadata["documentation_uri"] = "https://0x1eef.github.io/x/llm.rb"
+  spec.metadata["changelog_uri"] = "https://0x1eef.github.io/x/llm.rb/file.CHANGELOG.html"
 
   spec.files = Dir[
     "README.md", "LICENSE",
     "lib/*.rb", "lib/**/*.rb",
+    "data/*.json",
     "llm.gemspec"
   ]
   spec.require_paths = ["lib"]
@@ -44,4 +81,4 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "net-http-persistent", "~> 4.0"
   spec.add_development_dependency "opentelemetry-sdk", "~> 1.10"
   spec.add_development_dependency "logger", "~> 1.7"
-end
+end

metadata

@@ -1,11 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: llm.rb
 version: !ruby/object:Gem::Version
-  version: 4.8.0
+  version: 4.9.0
 platform: ruby
 authors:
 - Antar Azri
 - '0x1eef'
+- Christos Maris
+- Rodrigo Serrano
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
@@ -192,26 +194,65 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.7'
-description: llm.rb is a zero-dependency Ruby toolkit for Large Language Models that
-  includes OpenAI, Gemini, Anthropic, xAI (grok), zAI, DeepSeek, Ollama, and LlamaCpp.
-  The toolkit includes full support for chat, streaming, tool calling, audio, images,
-  files, and structured outputs.
+description: |
+  llm.rb is a Ruby-centric toolkit for building real LLM-powered systems — where
+  LLMs are part of your architecture, not just API calls. It gives you explicit
+  control over contexts, tools, concurrency, and providers, so you can compose
+  reliable, production-ready workflows without hidden abstractions.
+
+  Built for engineers who want to understand and control their LLM systems. No
+  frameworks, no hidden magic — just composable primitives for building real
+  applications, from scripts to full systems like Relay.
+
+  ## Key Features
+
+  - **Contexts are central** — Hold history, tools, schema, usage, cost, persistence, and execution state
+  - **Tool execution is explicit** — Run local, provider-native, and MCP tools sequentially or concurrently
+  - **One API across providers** — Unified interface for OpenAI, Anthropic, Google, xAI, zAI, DeepSeek, Ollama, and LlamaCpp
+  - **Thread-safe where it matters** — Providers are shareable, while contexts stay isolated and stateful
+  - **Production-ready** — Cost tracking, observability, persistence, and performance tuning built in
+  - **Stdlib-only by default** — Runs on Ruby standard library, with optional features loaded only when used
+
+  ## Capabilities
+
+  - Chat & Contexts with persistence
+  - Streaming responses
+  - Tool calling with JSON Schema validation
+  - Concurrent execution (threads, fibers, async tasks)
+  - Agents with auto-execution
+  - Structured outputs
+  - MCP (Model Context Protocol) support
+  - Multimodal inputs (text, images, audio, documents)
+  - Audio generation, transcription, translation
+  - Image generation and editing
+  - Files API for document processing
+  - Embeddings and vector stores
+  - Local model registry for capabilities, limits, and pricing
 email:
 - azantar@proton.me
-- 0x1eef@proton.me
+- 0x1eef@hardenedbsd.org
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
+- data/anthropic.json
+- data/deepseek.json
+- data/google.json
+- data/openai.json
+- data/xai.json
+- data/zai.json
 - lib/llm.rb
 - lib/llm/agent.rb
 - lib/llm/bot.rb
 - lib/llm/buffer.rb
 - lib/llm/client.rb
+- lib/llm/context.rb
+- lib/llm/context/deserializer.rb
 - lib/llm/contract.rb
 - lib/llm/contract/completion.rb
+- lib/llm/cost.rb
 - lib/llm/error.rb
 - lib/llm/eventhandler.rb
 - lib/llm/eventstream.rb
@@ -219,8 +260,18 @@ files:
 - lib/llm/eventstream/parser.rb
 - lib/llm/file.rb
 - lib/llm/function.rb
+- lib/llm/function/array.rb
+- lib/llm/function/fiber_group.rb
+- lib/llm/function/task_group.rb
+- lib/llm/function/thread_group.rb
 - lib/llm/function/tracing.rb
 - lib/llm/json_adapter.rb
+- lib/llm/mcp.rb
+- lib/llm/mcp/command.rb
+- lib/llm/mcp/error.rb
+- lib/llm/mcp/pipe.rb
+- lib/llm/mcp/rpc.rb
+- lib/llm/mcp/transport/stdio.rb
 - lib/llm/message.rb
 - lib/llm/mime.rb
 - lib/llm/model.rb
@@ -247,23 +298,23 @@ files:
 - lib/llm/providers/deepseek.rb
 - lib/llm/providers/deepseek/request_adapter.rb
 - lib/llm/providers/deepseek/request_adapter/completion.rb
-- lib/llm/providers/gemini.rb
-- lib/llm/providers/gemini/audio.rb
-- lib/llm/providers/gemini/error_handler.rb
-- lib/llm/providers/gemini/files.rb
-- lib/llm/providers/gemini/images.rb
-- lib/llm/providers/gemini/models.rb
-- lib/llm/providers/gemini/request_adapter.rb
-- lib/llm/providers/gemini/request_adapter/completion.rb
-- lib/llm/providers/gemini/response_adapter.rb
-- lib/llm/providers/gemini/response_adapter/completion.rb
-- lib/llm/providers/gemini/response_adapter/embedding.rb
-- lib/llm/providers/gemini/response_adapter/file.rb
-- lib/llm/providers/gemini/response_adapter/files.rb
-- lib/llm/providers/gemini/response_adapter/image.rb
-- lib/llm/providers/gemini/response_adapter/models.rb
-- lib/llm/providers/gemini/response_adapter/web_search.rb
-- lib/llm/providers/gemini/stream_parser.rb
+- lib/llm/providers/google.rb
+- lib/llm/providers/google/audio.rb
+- lib/llm/providers/google/error_handler.rb
+- lib/llm/providers/google/files.rb
+- lib/llm/providers/google/images.rb
+- lib/llm/providers/google/models.rb
+- lib/llm/providers/google/request_adapter.rb
+- lib/llm/providers/google/request_adapter/completion.rb
+- lib/llm/providers/google/response_adapter.rb
+- lib/llm/providers/google/response_adapter/completion.rb
+- lib/llm/providers/google/response_adapter/embedding.rb
+- lib/llm/providers/google/response_adapter/file.rb
+- lib/llm/providers/google/response_adapter/files.rb
+- lib/llm/providers/google/response_adapter/image.rb
+- lib/llm/providers/google/response_adapter/models.rb
+- lib/llm/providers/google/response_adapter/web_search.rb
+- lib/llm/providers/google/stream_parser.rb
 - lib/llm/providers/llamacpp.rb
 - lib/llm/providers/ollama.rb
 - lib/llm/providers/ollama/error_handler.rb
@@ -304,6 +355,7 @@ files:
 - lib/llm/providers/xai.rb
 - lib/llm/providers/xai/images.rb
 - lib/llm/providers/zai.rb
+- lib/llm/registry.rb
 - lib/llm/response.rb
 - lib/llm/schema.rb
 - lib/llm/schema/array.rb
@@ -314,11 +366,11 @@ files:
 - lib/llm/schema/null.rb
 - lib/llm/schema/number.rb
 - lib/llm/schema/object.rb
+- lib/llm/schema/parser.rb
 - lib/llm/schema/string.rb
 - lib/llm/schema/version.rb
 - lib/llm/server_tool.rb
 - lib/llm/session.rb
-- lib/llm/session/deserializer.rb
 - lib/llm/tool.rb
 - lib/llm/tool/param.rb
 - lib/llm/tracer.rb
@@ -337,6 +389,7 @@ metadata:
   homepage_uri: https://github.com/llmrb/llm.rb
   source_code_uri: https://github.com/llmrb/llm.rb
   documentation_uri: https://0x1eef.github.io/x/llm.rb
+  changelog_uri: https://0x1eef.github.io/x/llm.rb/file.CHANGELOG.html
 rdoc_options: []
 require_paths:
 - lib
@@ -353,8 +406,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: llm.rb is a zero-dependency Ruby toolkit for Large Language Models that includes
-  OpenAI, Gemini, Anthropic, xAI (grok), zAI, DeepSeek, Ollama, and LlamaCpp. The
-  toolkit includes full support for chat, streaming, tool calling, audio, images,
-  files, and structured outputs.
+summary: llm.rb is a Ruby-centric toolkit for building real LLM-powered systems —
+  where LLMs are part of your architecture, not just API calls. It gives you explicit
+  control over contexts, tools, concurrency, and providers, so you can compose reliable,
+  production-ready workflows without hidden abstractions.
 test_files: []