AugusteVN.Modules.VirtualAssistant._Shared.Spa 1.0.2

AugusteVN.Modules.VirtualAssistant._Shared.Spa

Blazor components, state management, and Ollama HTTP client for the VirtualAssistant module — provides a full chat-style interface for local LLM inference.

Part of the AugusteVN Modules collection.

Overview

This is a client-side-only module with no server-side Api, Database, or Features projects. It integrates directly with a local Ollama instance via AugusteVN.Ollama.Client for real-time streaming text generation.

Extension Method

AddVirtualAssistantSharedSpa(this IServiceCollection, IConfiguration)

Registers the VirtualAssistant SPA layer:

• OllamaClientConfig — Binds configuration from appsettings.json via IOptions<OllamaClientConfig>
• HttpClient — Standard IHttpClientFactory registration
• VirtualAssistantState — Scoped reactive state provider (extends StateProvider with PersistentComponentState)
• OllamaHttpClient — Scoped Ollama API client from AugusteVN.Ollama.Client
• IVirtualAssistantClient — Scoped as VirtualAssistantHttpClient, the module's primary client abstraction

// Program.cs
builder.Services.AddVirtualAssistantSharedSpa(builder.Configuration);

Dependencies

• AugusteVN.Ollama.Client — Ollama REST API client for model listing and text generation

Services

VirtualAssistantState

Reactive state provider (StateProvider) with PersistentComponentState support for server prerendering:

Methods:

• SetSelectedResponse(GenerateResponse) — Sets both SelectedResponse and Response simultaneously

IVirtualAssistantClient

Abstraction for the VirtualAssistant HTTP operations:

VirtualAssistantHttpClient

Implementation of IVirtualAssistantClient backed by OllamaHttpClient:

• GetModelsAsync — Calls ListLocalModelsAsync on the Ollama client, caches results in state keyed by HostUrl
• GenerateResponseAsync — Streams generation via OllamaGenerateRequest, accumulates tokens into GenerateResponse.Response, captures Context and CompletedAt on completion, and appends to ResponseHistory

OllamaHttpClient

Direct Ollama REST API client from AugusteVN.Ollama.Client, registered as a scoped service.

Components

VirtualAssistantPromptForm

Full prompt submission form with:

• Host URL input with blur-triggered model list loading
• Default host URL shortcut (http://localhost:11434)
• Model selector dropdown (populated from Ollama local models)
• Prompt textarea with full-screen toggle
• Preview mode on/off switch
• FluentValidation integration
• Submit button disabled during generation or when required fields are empty

VirtualAssistantPreview

Reactive Markdown-to-HTML response preview. Listens to VirtualAssistantState changes and renders the response as:

• Edit mode — Raw Markdown in a <textarea> for editing
• Preview mode — HTML rendered via Markdown.ToHtml with Prism.js syntax highlighting

Toggles visibility based on State.IsPreviewModeOn.

VirtualAssistantStateChangeListener

Internal component that bridges INotifyPropertyChanged events from VirtualAssistantState to Blazor's rendering lifecycle. Listens for Response and IsPreviewModeOn property changes and invokes OnPreviewChanged.

VirtualAssistantPromptHistory

Renders the full response history as a scrollable list with:

• Prompt text (truncated) and completion timestamp for each response
• Click to select and view a previous response
• Copy to clipboard button (copies prompt + response)
• Download as Markdown file button (generates .md file with slugified filename)

Registration

// Program.cs
builder.Services.AddVirtualAssistantSharedSpa(builder.Configuration);

Configuration

{
  "OllamaClientConfig": {
    "BaseUrl": "http://localhost:11434"
  }
}

Installation

dotnet add package AugusteVN.Modules.VirtualAssistant._Shared.Spa

Full Documentation

See the VirtualAssistant Module README for complete documentation.