Sends a chat request to the Ollama API.

Validates the ChatOps configuration and sends a POST request to the "api/chat" endpoint. Supports both streaming and non-streaming responses based on the stream field in ChatOps. Returns an Either containing an OllamaError on failure or a ChatResponse on success.

Example:

>>> let ops = defaultChatOps { chatModelName = "gemma3", messages = userMessage "What's the capital of France?" :| [] }
>>> chat ops Nothing
Either OllamaError ChatResponse

MonadIO version of chat for use in monadic contexts.

Lifts the chat function into a MonadIO context, allowing it to be used in monadic computations.

Example:

>>> import Control.Monad.IO.Class
>>> let ops = defaultChatOps { chatModelName = "gemma3", messages = userMessage "Hello!" :| [] }
>>> runReaderT (chatM ops Nothing) someContext
Either OllamaError ChatResponse

Represents a message within a chat, including its role and content.

Enumerated roles that can participate in a chat.

Creates a Message with the System role.

Example:

>>> systemMessage "You are a helpful assistant."
Message {role = System, content = "You are a helpful assistant.", images = Nothing, tool_calls = Nothing, thinking = Nothing}

Creates a Message with the User role.

Example:

>>> userMessage "What's 2+2?"
Message {role = User, content = "What's 2+2?", images = Nothing, tool_calls = Nothing, thinking = Nothing}

Creates a Message with the Assistant role.

Example:

>>> assistantMessage "2+2 equals 4."
Message {role = Assistant, content = "2+2 equals 4.", images = Nothing, tool_calls = Nothing, thinking = Nothing}

Creates a Message with the Tool role.

Example:

>>> toolMessage "Tool output: success"
Message {role = Tool, content = "Tool output: success", images = Nothing, tool_calls = Nothing, thinking = Nothing}

Constructs a Message with the specified role and content.

Creates a Message with the given Role and textual content, setting optional fields (images, tool_calls, thinking) to Nothing.

Example:

>>> genMessage User "What's the weather like?"
Message {role = User, content = "What's the weather like?", images = Nothing, tool_calls = Nothing, thinking = Nothing}

Default configuration for initiating a chat.

Provides a default ChatOps with the "gemma3" model and a sample user message ("What is 2+2?"). Can be customized by modifying fields as needed.

Example:

>>> let ops = defaultChatOps { chatModelName = "customModel", messages = userMessage "Hello!" :| [] }
>>> chat ops Nothing
Either OllamaError ChatResponse

Configuration for initiating a chat with an Ollama model.

Defines the parameters for a chat request, including the model name, messages, and optional settings for tools, response format, streaming, timeout, and model options.

Format specification for the chat output.

Since: 0.1.3.0

Configuration for the Ollama client. Used across all requests to customize behavior such as timeouts, retries, custom HTTP manager, and lifecycle hooks. -- -- @since 0.2.0.0

A default configuration pointing to localhost:11434 with 90s timeout and no hooks or retry logic.

Represents all possible errors that may occur when using the Ollama client.

Since: 0.2.0.0

Optional model tuning parameters that influence generation behavior.

Since: 0.2.0.0

Default model options for API requests.

Provides a default ModelOptions configuration with all fields set to Nothing, suitable as a starting point for customizing model parameters like temperature or token limits.

Example:

>>> let opts = defaultModelOptions { temperature = Just 0.7 }

Represents a tool that can be used in the conversation.

Since: 0.2.0.0

Represents a function that can be called by the model.

Since: 0.2.0.0

Parameters definition for a function call used in structured output or tool calls.

Since: 0.2.0.0

Output representation of a function to be called, including its name and arguments.

Since: 0.2.0.0

A single tool call returned from the model, containing the function to be invoked.

Since: 0.2.0.0