agentivity_ag_ui
library
Classes
ActivityDeltaEvent
ActivitySnapshotEvent
AgAccentColors
Theme extension carrying the user-selectable accent palette.
AgAccentPalette
A named accent palette entry (id + display label + color triple).
AgentEntity
A runnable entity in the catalog (agent, team, workflow, …).
AgentEntityPort
AgentivityConnector
Connector for the Agentivity platform.
AgentRunController
REST-polling agent run controller.
AgentRunStarted
AgentRunStatus
AgentRunStreamEvent
SSE event emitted by the agent run stream.
AgFormField
Descriptor for a single form field.
AgThemeData
Unified design-token ThemeExtension for the entire Agentivity widget stack.
AgUiActivity
A single agent activity received via ActivitySnapshotEvent or
ActivityDeltaEvent — represents what the agent is currently doing
(e.g. "Searching the web…", "Reading document X…").
AgUiActivityController
Consumes ActivitySnapshotEvent and ActivityDeltaEvent from an
AgUiEvent stream and exposes the live set of agent activities.
AgUiActivityView
Displays the current agent activity from AgUiActivityController .
AgUiAssistantPanel
A self-contained AI assistant chat panel backed by AssistantController .
AgUiChatPanel
A self-contained chat panel backed by a ChatController .
AgUiComponentItem
A dynamically rendered component resolved from AgUiWidgetRegistry .
AgUiContextEntry
A single readable context entry.
AgUiContextRegistry
A registry that collects readable context entries and builds the
context list for RunAgentInput .
AgUiEvent
AG-UI standard event types.
AgUiFormPanel
Renders a single FormRequest as an interactive form.
AgUiFrontendTool
A tool that executes on the Flutter client (device/browser) rather than the backend.
AgUiFrontendToolRegistry
Registry of AgUiFrontendTool s available to the agent during a run.
AgUiGenerativeController
Processes a Stream<AgUiEvent> and maintains a live list of AgUiGenerativeItem s
for rendering by AgUiGenerativeView .
AgUiGenerativeItem
A single renderable item in a generative conversation.
AgUiGenerativeView
Renders a live conversation driven by AgUiGenerativeController .
AgUiGenericConnector
A connector for any backend that natively speaks the AG-UI protocol over SSE.
AgUiHtmlItem
Agent-generated HTML for open-ended generative UI.
AgUiInterrupt
An agent interrupt — the agent paused and needs human input before resuming.
AgUiInterruptOutcome
AgUiMarkdownBody
Renders Markdown text consistently across all AG-UI widgets.
AgUiReasoningItem
A reasoning / chain-of-thought block.
AgUiRunLifecycleController
SSE-native run lifecycle controller.
AgUiRunOutcome
Outcome carried by RunFinishedEvent when the agent uses the interrupt protocol.
AgUiRunPanel
Full run panel: input field, start/cancel button, event log, result.
AgUiRunStatusBadge
Compact status badge for an agent run.
AgUiSseChannel <T >
Generic, reconnecting SSE channel.
AgUiStateBuilder
Rebuilds whenever AgUiStateController state changes.
AgUiStateController
Tracks agent state from StateSnapshotEvent and StateDeltaEvent events.
AgUiSuccessOutcome
AgUiTextItem
A streamed or completed text message.
AgUiToolCallItem
A tool call in progress or completed.
AgUiWidgetRegistry
Maps component names to widget builders for generative UI.
AssistantChunk
A single chunk emitted by a streaming assistant response.
AssistantController
AssistantHealth
Server health/status from the assistant backend.
AssistantMessage
A single message in an assistant conversation (UI-facing model).
AssistantResult
Result from a non-streaming assistant call.
ChatAttachment
An attachment that can be sent with a chat message.
ChatController
ChatMessage
ChatThread
ChatThreadDetail
CustomEvent
FileAttachment
File referenced by a backend-assigned file ID.
FileContentPart
File referenced by a backend-assigned file ID.
FormController
FormRequest
FormResponse
FormSubmitResult
IAgentRunProvider
Generic agent run provider — implement this against any backend.
IAssistantProvider
Generic assistant provider — implement this against any backend.
IChatProvider
Generic chat provider — implement this against any backend.
IFormProvider
Generic form provider — implement this against any backend.
ImageBytesAttachment
Raw image bytes — encode as needed in the provider (e.g. to base64 data URI).
ImageUrlAttachment
Image referenced by a URL (https://) or data URI (data:image/jpeg;base64,...).
ImageUrlContentPart
Image referenced by URL or data URI (data:image/jpeg;base64,...).
LangGraphConnector
Connector for LangGraph Cloud
and self-hosted LangGraph deployments.
MessageContentPart
A single part of a mixed-content message (text, image, or file).
MessagesSnapshotEvent
RawEvent
ReasoningEncryptedValueEvent
Encrypted reasoning value for safety filtering of extended-thinking content.
ReasoningEndEvent
ReasoningMessageChunkEvent
Convenience combined chunk (alternative to REASONING_MESSAGE_START + CONTENT + END).
ReasoningMessageContentEvent
ReasoningMessageEndEvent
ReasoningMessageStartEvent
ReasoningStartEvent
ResumePayload
One resolved or cancelled response to a single AgUiInterrupt .
RunAgentInput
The payload sent to the backend to start or resume an agent run.
RunErrorEvent
RunFinishedEvent
A run completed. Check outcome for success vs interrupt.
RunStartedEvent
StateDeltaEvent
delta is a list of RFC 6902 JSON Patch operations.
StateSnapshotEvent
StepFinishedEvent
StepStartedEvent
TextContentPart
Plain text content part.
TextMessageChunkEvent
Convenience single-event alternative to START + CONTENT + END.
TextMessageContentEvent
TextMessageEndEvent
TextMessageStartEvent
ToolCallArgsDeltaEvent
Args delta — event type is TOOL_CALL_ARGS in the spec (legacy: TOOL_CALL_ARGS_DELTA).
ToolCallChunkEvent
Convenience combined chunk (start + args + end in one event).
ToolCallEndEvent
ToolCallResultEvent
Result of a tool call. content is always a string (JSON-encoded for complex results).
ToolCallStartEvent
UnknownEvent
Functions
agUiEventParser (String event , String ? id , String ? data )
→ AgUiEvent ?
Drop-in parser for AgUiSseChannel<AgUiEvent>:
apiHttpStatus (Object error )
→ int ?
Returns the HTTP status code if error is a Dio or API error.
buildAgUiMessage (String role , {String ? text , List <MessageContentPart > ? parts })
→ Map <String , dynamic >
Builds a message entry for RunAgentInput.messages supporting mixed content.
debugLogApiIssue (Object error , {required String operation , StackTrace ? stackTrace })
→ void
Logs the error in debug mode.
jsonBool (Map <String , dynamic > json , String key )
→ bool
jsonDateTime (Map <String , dynamic > json , String key )
→ DateTime ?
jsonInt (Map <String , dynamic > json , String key )
→ int ?
jsonLookup (Map <String , dynamic > json , String key )
→ dynamic
jsonMap (Map <String , dynamic > json , String key )
→ Map <String , dynamic > ?
jsonOpt (Map <String , dynamic > json , String key )
→ String ?
jsonStr (Map <String , dynamic > json , String key )
→ String
throwIfApiFailurePayload (dynamic data , {int ? httpStatus })
→ void
Throws ApiException if data indicates an API-level failure.
userFacingErrorMessage (Object error )
→ String
Returns a user-facing error message from any thrown object.