FieldCure.Ai.Providers 0.7.2

FieldCure.Ai.Providers

AI provider clients for Claude, OpenAI, Gemini, Ollama, and Groq with shared models and streaming support.

Providers

Quick Start

using FieldCure.Ai.Providers.Models;
using FieldCure.Ai.Providers;

var model = new ProviderModel
{
    ProviderType = "Claude",
    ApiKey = "sk-...",
    ModelId = "claude-sonnet-4-6",
};

var provider = ProviderFactory.Create(model);

var request = new AiRequest
{
    Messages = [new ChatMessage(ChatRole.User, "Hello!")],
};

var response = await provider.CompleteAsync(request);
Console.WriteLine(response.Content);

Features

• Custom Providers — Register any OpenAI-compatible endpoint via ProviderFactory.RegisterCustomProvider with CustomProviderConfig (BaseUrl, DisplayName).
• Image Compression — ImageCompressor automatically compresses and resizes large images (JPEG, via SkiaSharp) before sending to providers, reducing token usage and API costs.
• Multimedia Tool Results — IMultiContentTool interface for tools returning structured multimedia content (images, audio, video) alongside text via ToolExecutionResult.
• Media Persistence — ChatMessage.MediaItems stores media attachments with conversation messages for save/load in .astx files.
• Thinking / Reasoning — Structured reasoning_details parsing, <think> tag streaming extraction via ThinkTagParser, and Ollama native thinking field support.

Models

Core models

• ChatMessage, ChatRole — conversation messages (with MediaItems for media persistence)
• AiRequest, AiResponse — LLM request/response
• AiResponse.IsTruncated — true when the provider stopped because it hit the max_tokens cap (Claude stop_reason=max_tokens, OpenAI finish_reason=length, Gemini MAX_TOKENS, Ollama done_reason=length). Consumers should treat the response as incomplete rather than a graceful completion.
• ProviderModel — provider configuration (renamed from ProviderPreset in v0.7.0)
• CustomProviderConfig — custom OpenAI-compatible provider registration (Id, DisplayName, BaseUrl)

Tool calling

• ToolCall, IAssistTool — function calling interface with optional confirmation
• IMultiContentTool — tools returning multimedia content alongside text
• ToolExecutionResult — combined text + media content return type

Media

• MediaContent — typed media payload (MimeType, Base64Data, FileName)
• ImageCompressor — JPEG compression and resize helper (via SkiaSharp)

Streaming

• StreamEvent — discriminated union: TextDelta, ThinkingDelta, ToolCallStart, ToolCallDelta, Usage, StreamCompleted

Adapters

• McpToolAdapter — bridges MCP tools to IAssistTool with multimedia content block support

License

MIT