llm_core 0.1.7

Core abstractions for LLM (Large Language Model) interactions. Provides common interfaces, models, and utilities used by LLM backend implementations.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

0.1.7 - 2026-02-10

Added

• batchEmbed() on LLMChatRepository: explicit API for embedding multiple texts in one call. Same signature as embed(); default implementation delegates to embed(). Documented for Ollama, OpenAI, and llama.cpp backends.

0.1.6 - 2026-02-10

Fixed

• Hardened StreamToolExecutor to always synthesize a non-empty toolCallId for LLMRole.tool messages when a backend-provided LLMToolCall.id is missing or empty, preventing Tool message must have toolCallId validation errors.
• Improved tool execution error handling so that thrown tool exceptions are surfaced as tool messages rather than crashing the stream.

0.1.5 - 2026-01-26

Added

• StreamChatOptions class to encapsulate all streaming chat options and reduce parameter proliferation
• RetryConfig and RetryUtil for configurable retry logic with exponential backoff
• TimeoutConfig for flexible timeout configuration (connection, read, total, large payloads)
• LLMMetrics interface and DefaultLLMMetrics implementation for optional metrics collection
• chatResponse() method on LLMChatRepository for non-streaming complete responses
• Input validation utilities in Validation class
• ChatRepositoryBuilderBase for implementing builder patterns in repository implementations
• StreamChatOptionsMerger for merging options from multiple sources
• HTTP client utilities (HttpClientHelper) for consistent request handling
• Error handling utilities (ErrorHandlers, BackendErrorHandler) for standardized error processing
• Tool execution utilities (ToolExecutor) for managing tool calling workflows

Changed

• streamChat() now accepts optional StreamChatOptions parameter
• Improved error handling and retry logic across all backends
• Enhanced documentation

0.1.0 - 2026-01-19

Added

• Initial release
• Core abstractions for LLM interactions:
  • LLMChatRepository - Abstract interface for chat completions
  • LLMMessage - Message representation with roles and content
  • LLMResponse - Response wrapper with metadata
  • LLMChunk - Streaming response chunks
  • LLMEmbedding - Text embedding representation
• Tool calling support:
  • LLMTool - Tool definition with JSON Schema parameters
  • LLMToolCall - Tool invocation representation
  • LLMToolParam - Parameter definitions
• Exception types for error handling