ChatController class

Main chat state controller — Sint pattern.

Wires together: QueryEngine, CompactionService, SessionMemoryService, SessionHistoryManager, MemdirService, and JSONL transcript persistence.

Inheritance

Constructors

ChatController()

Properties

compactionCount → RxInt
final
currentToolName → Rxn<String>
final
error → Rxn<String>
final
hashCode int
The hash code for this object.
no setterinherited
hookExecutor HookExecutor
Exposes the hook executor so callers can register custom hooks.
no setter
initialized bool
Checks whether the controller has already been initialized.
no setterinherited
isClosed bool
Checks whether the controller has already been closed.
no setterinherited
isDisposed bool
no setterinherited
isInitialized bool
no setter
isLoading → RxBool
final
isStreaming → RxBool
final
lastUsage → Rxn<TokenUsage>
final
listenersLength int
no setterinherited
memdirService MemdirService?
Get memdir service for memory panel access.
no setter
messages → RxList<Message>
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
sessionHistoryManager SessionHistoryManager?
Get session history manager for direct snapshot access.
no setter
sessionId → RxString
final
streamingText → RxString
final
totalInputTokens → RxInt
final
totalOutputTokens → RxInt
final

Methods

addListener(SintStateUpdate listener) → Disposer
Register a closure to be called when the object notifies its listeners.
inherited
addListenerId(Object? key, SintStateUpdate listener) → Disposer
inherited
clearConversation() → void
compactConversation() Future<bool>
Manually trigger compaction.
containsListener(SintStateUpdate listener) bool
inherited
debounce<T>(RxInterface<T> rx, void callback(T), {Duration duration = const Duration(milliseconds: 400)}) → void
Calls callback after rx stops changing for duration. Useful for search-as-you-type, form validation, etc.
inherited
deleteSession(String id) Future<bool>
Delete a saved session.
dispose() → void
inherited
ever<T>(RxInterface<T> rx, void callback(T)) → void
Calls callback every time rx changes. Auto-cancels on controller disposal.
inherited
handleInput(String text, {List<InputAttachment> attachments = const []}) Future<void>
Handle user input — dispatches slash commands or sends as a message.
initialize() Future<bool>
interval<T>(RxInterface<T> rx, void callback(T), {Duration duration = const Duration(seconds: 1)}) → void
Calls callback at most once per duration, ignoring intermediate changes. Useful for rate-limiting UI updates.
inherited
listSessions() Future<List<String>>
List all saved sessions, newest first.
loadSession(String id) Future<bool>
Load a specific session by ID.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
once<T>(RxInterface<T> rx, void callback(T)) → void
Calls callback only the first time rx changes, then cancels.
inherited
onClose() → void
Called before onDelete method. onClose might be used to dispose resources used by the controller. Like closing events, or streams before the controller is destroyed. Or dispose objects that can potentially create some memory leaks, like TextEditingControllers, AnimationControllers. Might be useful as well to persist some data on disk.
override
onDelete() → void
inherited
onInit() → void
Called immediately after the widget is allocated in memory. You might use this to initialize something for the controller.
override
onReady() → void
Called 1 frame after onInit(). It is the perfect place to enter navigation events, like snackbar, dialogs, or a new route, or async request.
inherited
onStart() → void
Called at the exact moment the widget is allocated in memory. It uses an internal "callable" type, to avoid any @overrides in subclasses. This method should be internal and is required to define the lifetime cycle of the subclass.
inherited
reconfigure() Future<void>
refresh() → void
inherited
refreshGroup(Object id) → void
inherited
removeListener(VoidCallback listener) → void
Remove a previously registered closure from the list of closures that the object notifies.
inherited
removeListenerId(Object id, VoidCallback listener) → void
inherited
reportAdd(VoidCallback disposer) → void
inherited
reportRead() → void
inherited
sendContextSignal(String contextPrompt) Future<void>
Send a context signal (silent skill/personality injection).
sendMessage(String text, {List<InputAttachment> attachments = const []}) Future<void>
toString() String
A string representation of this object.
inherited
update([List<Object>? ids, bool condition = true]) → void
Notifies listeners to update the UI.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited