LightAgent.GuiLib 0.9.26

About This Library

UserInputControl and ChatHistoryControl are UI components specifically designed for applications built on top of the LightAgent framework.

Unlike generic chat controls, these components are designed to work with the interaction model and message protocol used by LightAgent. The controls provide a ready-to-use user experience for:

• AI Assistants
• Agentic Workflows
• Tool Calling Agents
• Multi-step Reasoning Systems
• Streaming LLM Applications
• Custom LightAgent-Based Projects

The library focuses on the presentation layer and interaction experience while relying on LightAgent for orchestration, event delivery, tool execution, and conversation management.

Relationship with LightAgent

The controls are designed around the LightAgent event-driven interaction model.

Typical workflow:

        UserInputControl
                │
                ▼

     AgentUserRequestCommand

                │
                ▼

          LightAgent

                │
                ▼

    AgentOutputTextEvent
    AgentLogEvent
    AgentConversationCompletedEvent
            ...

                │
                ▼

      ChatHistoryControl

The host application is responsible for connecting LightAgent events and commands to the UI controls.

Supported LightAgent Interaction Pattern

The controls are optimized for the standard LightAgent conversation lifecycle:

User Input
    ↓
Agent Request
    ↓
Streaming Output
    ↓
Agent Progress Events
    ↓
Conversation Complete

This allows applications to deliver a real-time conversational experience with streamed responses and execution progress updates.

Event Mapping

A typical LightAgent integration maps framework events to UI operations as follows:

The exact event set depends on the LightAgent version and project implementation.

Streaming-First Design

ChatHistoryControl is designed primarily for LightAgent's streaming output model.

Typical message flow:

OpenNewAgentResponseSession()
            │
            ▼

AgentOutputTextEvent
    + "Hello"

AgentOutputTextEvent
    + ", how can I"

AgentOutputTextEvent
    + " help you today?"

            ▼

AgentConversationCompletedEvent

Instead of creating a new message for every event, streamed text is appended to the active response container, producing a smooth real-time chat experience.

Progress and Workflow Visualization

LightAgent applications often produce intermediate execution events, such as:

• Planning
• Tool Invocation
• Tool Results
• Workflow Steps
• Status Updates
• Reasoning Progress

ChatHistoryControl provides dedicated rendering support for these types of events, allowing applications to visualize agent execution progress alongside conversational responses.

Example:

User:
Generate a project report

Assistant:
Analyzing project data...

[Step] Loading project files
[Step] Extracting information
[Step] Generating summary

Report generation completed.

Responsibilities

UserInputControl

Responsible for:

• User input collection
• Send / Stop actions
• Attachment UI management
• Input state transitions
• Interaction with LightAgent request workflows

ChatHistoryControl

Responsible for:

• Rendering LightAgent conversation output
• Streaming text updates
• Progress event visualization
• User message rendering
• Conversation session management
• LightAgent-oriented message presentation

What This Library Does Not Provide

This library does not replace LightAgent.

The following capabilities remain the responsibility of the host application and the LightAgent runtime:

• Agent implementation
• LLM integration
• Tool execution
• Function calling
• Workflow orchestration
• Memory management
• Conversation persistence
• Network communication

The controls serve as the presentation layer for LightAgent-based applications and are intended to be used together with the framework's command and event protocol.

Recommended Integration

UserInputControl
        │
        ▼

AgentUserRequestCommand

        │
        ▼

LightAgent Runtime

        │
        ├── AgentOutputTextEvent
        ├── AgentLogEvent
        ├── AgentToolEvent
        └── AgentConversationCompletedEvent

        ▼

ChatHistoryControl

This integration pattern provides a complete user experience for LightAgent-powered desktop applications with minimal UI development effort.