find_ai_chat 0.4.0

Flutter SDK for the Find AI chat assistant. Drop-in widget with floating, drawer and embedded modes, SSE streaming, and signed-mode visitor auth.

Changelog

0.4.0

• Action menu on the send button: long-pressing the send button opens a floating menu of chat actions. Works in all three display modes and with showHeader: false, so the actions stay reachable when the host app hides the header. The header's ↻ button is unchanged.
• Ships one action, Eliminar conversación: asks for confirmation, then runs clearConversation() — messages and the persisted conversation id are dropped on this device only, the backend conversation is untouched. Disabled while a turn is in flight.
• actionsBuilder on FindChatWidget composes the menu. It receives the SDK defaults (already resolved against the current state) and returns the final list, so host apps can append, reorder, or drop entries; returning an empty list turns the menu off. New exported models: FindChatAction and FindChatActionConfirmation.
• The menu and its confirmation render via OverlayPortal instead of showMenu/showDialog: in floating/drawer modes the panel is inserted above the Navigator's overlay entries, so route-based popups would be painted behind the chat.

0.3.0

• Per-turn options: scope what a turn can consult (RAG documents, dataset rows, …) by passing an opaque map that travels as the options field of POST /messages. Available on FindChatWidget / FindChatController / FindChatClient.sendMessage(), plus FindChatController.setOptions() to re-scope an ongoing chat — useful when the host app navigates between screens (e.g. from one product to another). The SDK never inspects the map's contents: the app's backend builds it, so extending the contract server-side needs no SDK release. Omitted from the request body when null or empty.

0.2.2

• Add direct bubble color overrides for user and assistant messages.
• Add direct text color overrides for user and assistant message bubbles.
• Add inputHeight to customize the bottom text field height.
• Fix: vertically center the message input text.

0.2.1

• Add showHeader to FindChatWidget and the presentation views, allowing host apps to hide the built-in chat panel header.
• Add themeBuilder, an advanced styling hook that receives the SDK-resolved ThemeData and returns a modified copy.
• Fix: the message input no longer draws an extra internal border when focused.

0.2.0

• Signed mode (auth_mode: "signed" connections): new tokenProvider callback on FindChatWidget / FindChatController / FindChatClient attaches the visitor JWT as Authorization: Bearer to every request (including each SSE reconnection, so long streams survive token expiry). On 401 the client fetches a fresh token and retries once; a persistent 401 throws the new FindChatAuthException.
• Multiple conversations per visitor (signed mode): FindChatClient.listConversations() (GET /conversations), FindChatController.listConversations() / selectConversation() / startNewConversation(), and a conversationId getter for the active one.
• Fix: GET /history message ids are numeric in the backend response; parsing no longer assumes a string.

0.1.0

• Initial release: FindChatClient (HTTP + SSE against the public webchat API), FindChatController, FindChatWidget with three display modes (embedded, floating, drawer), light/dark theming and visual style (classic/gptStyle) configurable via explicit override or inherited from connection config, and FindChatSessionStore for visitor_id/conversation_id persistence.