flutter_pipwave_ai_agent 1.1.1

Pipwave AI Agent SDK provides a predesigned graphical user interface (GUI) for user to undergo the AI agent process.

1.1.1 (5th March 2026)

Added

• Session token guard — All API calls are now guarded to ensure the session token is not expired. When the token is expired, the SDK automatically invokes onRefreshAccessToken before making requests, preventing unauthorized errors.

Security

• MIME validation — Media uploads now use MIME type validation instead of file name extension to block spoofed filenames and prevent malicious file uploads.

1.1.0 (4th March 2026)

Added

• Direct agent support for dedicated agent flows

1.0.0 (23rd January 2026)

Added

• Initial public release of flutter_pipwave_ai_agent SDK
• Drop-in AI Agent chat UI presented as a modal bottom sheet via FlutterPipwaveAiAgent.instance.launchAiAgent()
• SDK initialization via initialise() method
• Orientation management with lockOrientationToPortrait() helper
• Auth/session configuration via AuthParam class supporting:
  • Session token authentication
  • User ID configuration
  • Locale and supported locales configuration
  • AI Agent name customization
  • Beta flag support
• Integration callbacks:
  • onRefreshAccessToken callback for refreshing session tokens
  • onLinkTap callback for handling links tapped in the UI
  • termsOfService callback for Terms of Service navigation
• Avatar customization via AvatarBuilder and SenderType enum
• Unread count API:
  • getUnreadCountStream() for reactive unread count updates
  • getUnreadCount() for synchronous unread count retrieval
  • resetUnreadCount() for resetting the unread counter
  • Background monitoring via startBackgroundMonitoring() and stopBackgroundMonitoring()
• Attachment support:
  • Camera capture for photos and videos
  • Gallery/media picker integration
  • File picker support
• Environment configuration:
  • Staging/production endpoint selection via --dart-define=pw_ai_agent_is_prod=true
• Error handling with PipwaveException class:
  • PipwaveException.sessionNotInitialised() for uninitialized session errors
  • PipwaveException.contextNotMounted() for context mounting errors
  • PipwaveException.wsError() for WebSocket errors
• Localization support via flutter_pipwave_localization package
• Platform-specific documentation for Android and iOS permissions