FlowX.AI 5.4.0 Release Notes

The features described in this section apply to FlowX SaaS deployments.
Self-managed deployments are not affected unless explicitly stated.

FlowX.AI 5.4.0 introduces initial SaaS capabilities enabling multi-tenant deployments with organization management and tenant isolation.🏢 SaaS Multi-Tenancy - Multi-tenant platform with organization isolation and provisioning

SaaS multi-tenancy

Multi-tenant SaaS capabilities enable multiple organizations to operate independently on shared infrastructure. Each organization receives dedicated resources while maintaining complete isolation from other tenants.

Multi-tenant architecture

Multiple organizations operate on shared infrastructure with complete isolation

Tenant isolation

Complete data and authentication isolation between organizations

Organization provisioning

Automatic provisioning of dedicated resources for each organization

Resource management

Each organization receives dedicated resources and project spaces

Documentation

See the complete FlowX SaaS documentation for guides and best practices.

Major FeatureSaaS

Enhanced MCP server management.📧 Email Trigger - Start processes from external email events with configurable validation rules
💬 Chat Component - Standalone chat tab for AI-powered conversational interfaces
🔧 MCP Server Improvements - Enhanced audit logging, resource management, and tool updates

Email trigger

Overview
Key Features
Configuration
Email Data Schema
Use Cases

FlowX.AI 5.4.0 introduces Email Trigger as a new Data Source type in Integration Designer, enabling processes to be started automatically when emails are received. Connect to IMAP mail servers, monitor specific mailboxes, and create process instances with the email data.

Email Triggers bridge external communication channels with FlowX.AI process automation, enabling organizations to automatically route and process incoming emails through defined business workflows.

Documentation

See the complete Email Trigger documentation for configuration guides and examples.

Data Source Settings:

Field	Description
Protocol	IMAP (currently supported)
Server Host	IMAP server hostname
Port	Connection port (993 for SSL/TLS)
Username	Email account username
Password	Email account password
SSL/TLS	Enable secure connection

Filtering Criteria:

Email Address: Monitored email address (read-only, based on authentication)
Mailbox Folder: Folder to monitor (default: Inbox)

Validation Options:

Allowed File Types: PDF, DOCUMENT, IMAGE, EXCEL, ZIP
Maximum File Size: Up to 25 MB per attachment
Maximum File Count: Limit attachments per email

All fields accept configuration parameters using ${configParam} syntax for environment-specific values.

When an email triggers a process, the following data structure is available:

{
  "emailMessage": {
    "subject": "Support Request #12345",
    "dateTime": "2026-01-15T10:30:00Z",
    "sender": "[email protected]",
    "body": "Email body content...",
    "fileAttachments": [{
      "filePath": "email-attachments/proc-123/file.pdf",
      "downloadPath": "/api/internal/files/uuid/download"
    }],
    "headerParams": {
      "Message-ID": "<[email protected]>"
    }
  }
}

Major FeatureAll Deployments

Chat component

Overview
Key Features
Configuration
Improvements

FlowX.AI 5.4.0 introduces a standalone Chat tab in web container applications, enabling AI-powered conversational interfaces within your applications. The Chat component provides a dedicated space for users to interact with AI agents through a familiar messaging interface.

The Chat component integrates with FlowX.AI’s AI platform to enable intelligent conversational experiences powered by your configured AI agents.

Documentation

See the complete Chat Component documentation for configuration guides and best practices.

AI IntegrationAll Deployments

MCP server improvements

Overview
Key Features
Bug Fixes

FlowX.AI 5.4.0 enhances MCP (Model Context Protocol) server integration with improved audit logging, exception handling, and resource management capabilities.

AI IntegrationAll Deployments

UI component enhancements and navigation improvements for web applications.🎴 Card Default Collapse State - Configure cards to load in collapsed state by default
🧭 UI Flow Breadcrumbs - Navigation breadcrumbs ui component for UI Flows with theme configuration
📊 UI Flow Sessions - Monitor and manage UI Flow sessions with audit logs and process tracking
📋 Tables in Collections - Add support for Table UI components within Collection UI elements

Card default collapse state

FlowX.AI 5.4.0 introduces a new Default collapse state property for Card components with accordion functionality, allowing you to configure cards that are collapsed when first loaded.

Overview
Configuration
Use Cases

When using Card components with the accordion feature enabled, you can now specify whether the card should be expanded or collapsed by default when the screen loads. This provides better control over the initial presentation of content and helps manage screen real estate.

Documentation

See the complete Card component documentation for configuration details.

Default collapse state options:

State	Description
Expanded	The card content is visible when the screen loads (default behavior)
Collapsed	The card content is hidden when the screen loads; users click to expand

This property is only available when the Has accordion setting is enabled on the Card component.

UI EnhancementAll Deployments

UI Flow Breadcrumbs

Overview
Key Features
Configuration

Navigation breadcrumbs UI component for UI Flows provide users with clear context of their current location within the application hierarchy. Breadcrumbs display the navigation path and enable quick navigation to parent screens.

Breadcrumbs enhance user experience by providing visual navigation context and allowing users to understand their position in the application structure.

UI EnhancementAll Deployments

UI Flow Sessions

Overview
Key Features
Use Cases

FlowX.AI 5.4.0 introduces UI Flow Sessions monitoring in the Runtime view, providing comprehensive visibility into active user sessions with UI Flows. Monitor session activity, view audit logs, track associated processes, and debug UI Flow interactions in real-time.

UI Flow Sessions enable administrators and developers to track user interactions, troubleshoot issues, and monitor the health of UI Flow-based applications.

Documentation

See the complete UI Flow Sessions documentation for detailed usage and troubleshooting guides.

Runtime ManagementAll Deployments

Tables in Collections

Overview
Key Features
Use Cases

FlowX.AI 5.4.0 introduces support for Table UI components within Collection UI elements, enabling you to display structured tabular data as items within dynamic collections. This enhancement provides greater flexibility for presenting complex data structures in a consistent, organized format.

You can now embed Table components inside Collection prototypes, allowing each collection item to display data in a structured table format with columns, rows, and table-specific features.

Table Documentation

See the complete Table component documentation for configuration details and usage examples.

Collection Documentation

Learn about Collection components and how to configure collection prototypes.

UI EnhancementAll Deployments

Backend optimizations, connector improvements, and platform stability enhancements.🔌 Connector Topic Pattern - Dedicated Kafka topic pattern for connectors
⚙️ Kafka Configuration Alignment - Unified Kafka property names across all services with backwards compatibility
⚡ Advancing Performance - Fixed advancing partition issues and improved concurrency handling

Connector topic pattern

Overview
Problem Solved
Solution

FlowX.AI 5.4.0 introduces a dedicated Kafka topic pattern variable (KAFKA_CONNECTORS_TOPIC_PATTERN) for connectors, allowing custom topic patterns without affecting other platform components like document-plugin, data-search, and cms-core.

Previous Limitations:

Shared topic pattern

Connectors used the same KAFKA_TOPIC_PATTERN as other components, limiting customization

Security concerns

Connectors could write to all topics with the pattern ai.flowx.engine.receive.*

New Configuration:

# Old configuration (shared with all components)
KAFKA_TOPIC_PATTERN: ai.flowx.engine.receive.*

# New configuration (dedicated for connectors)
KAFKA_CONNECTORS_TOPIC_PATTERN: ro.uniflow.*

Benefits:

Connectors can use custom topic patterns
Other components continue using the standard pattern
Improved security through topic isolation

InfrastructureSelf-Managed

Kafka configuration alignment

Overview
New Properties
Benefits

FlowX.AI 5.4.0 aligns Kafka configuration properties across all services (core-services and AI platform services) by introducing standardized property names while maintaining full backwards compatibility with existing configurations.

Standardized Kafka Properties:The following new environment variables are now available across all services:

Environment Variable	Description	Fallback Property
`KAFKA_BOOTSTRAP_SERVERS`	Comma-separated list of Kafka brokers	`SPRING_KAFKA_BOOTSTRAP_SERVERS`
`KAFKA_SECURITY_PROTOCOL`	Security protocol for Kafka communication	`SPRING_KAFKA_SECURITY_PROTOCOL`

The new properties take precedence over the legacy SPRING_KAFKA_* properties. If the new properties are not set, the system automatically falls back to the legacy properties, ensuring backwards compatibility.

Property alignment

Consistent property names across core-services and AI platform services

Backwards compatible

Existing configurations using SPRING_KAFKA_* properties continue to work without changes

Simplified configuration

Unified configuration approach across all FlowX.AI services

Migration flexibility

Migrate to new properties at your own pace without breaking existing deployments

This change was implemented in core-services and automatically applies to all services that use the shared Kafka configuration. No action is required for existing deployments, but you can optionally migrate to the new property names for consistency.

InfrastructureAll Deployments

Advancing performance

FlowX.AI 5.4.0 includes significant fixes and improvements to the advancing mechanism, resolving issues with stalled events and improving concurrency handling.

Stalled events fix

Fixed issue where NEW entries in advancing_partition and advancing_partition_event tables would become stalled and never processed. This occurred when multiple events were generated for the same partition during parallel processing.

Numeric overflow fix

Fixed numeric overflow error when advancing_partition_event_seq sequence exceeded Integer.MAX_VALUE. Now correctly uses getLong() instead of getInt() for sequence values.

Concurrency improvements

Fixed issue with multiple events to the same partition causing negative count_queued_events
Replaced trigger-based solution with SQL transactions for atomic updates
Improved handling of embedded subprocess completion under concurrent load

Automated test stability

Resolved data inconsistencies and business exceptions that were causing automated tests to fail consistently.

PerformanceAll Deployments

Comprehensive bug fixes across SaaS features, Designer, and backend services.🎨 Designer Fixes - UI and navigation fixes for Designer
⚙️ Backend Fixes - Backend stability and performance improvements

Designer fixes

FlowX.AI 5.4.0 resolves Designer issues to improve stability and user experience.

Navigation fixes

UI improvements

Fixed default locale display - locale now correctly shown in Version settings
Fixed substitution calls - resolved errors when starting processes or accessing UI Flows

Designer StabilityAll Deployments

Backend fixes

Backend stability and performance improvements across core services.

Process engine

Advancing & concurrency

Fixed stalled advancing events - NEW entries no longer get stuck in advancing tables
Fixed numeric overflow - resolved overflow when sequence exceeds Integer.MAX_VALUE
Fixed concurrent updates - resolved stale data errors for embedded subprocess completion
Fixed negative counter - resolved issue with count_queued_events going negative

AI platform

AI integration fixes

Fixed multi-agent streaming - streaming now works correctly for multi-agent chat
Fixed SSE event delivery - events are delivered individually as they complete

Integration Designer

Workflow & data model

Fixed file upload multipart - only file name is sent in multipart body, not full path
Fixed data model duplicates - resolved duplicate entries in mongo properties_paths

Backend StabilityAll Deployments

Additional information

Deployment information

For detailed deployment guidelines, component versions, and upgrade instructions, see the Deployment Guidelines v5.4.0.

Compatibility

Upgrade path

Upgrade from v5.3.0 - no breaking changes for standard deployments

Component compatibility

Compatible with FlowX.AI SDKs (Angular/React/iOS/Android), Designer, and Database 5.4

SaaS features

The SaaS multi-tenant features introduced in this release require additional infrastructure configuration for production deployments. Contact your FlowX.AI representative for guidance on enabling SaaS capabilities.

Release Notes

​SaaS multi-tenancy

SaaS multi-tenancy

Multi-tenant architecture

Tenant isolation

Organization provisioning

Resource management

Documentation

​Email trigger

Email trigger

Documentation

IMAP Connection

Message Start Event

Attachment handling

Validation rules

Manage triggers

Failed triggers

Customer support automation

Document processing

Request handling

Notification processing

​Chat component

Chat component

Documentation

Standalone chat tab

Message history

AI agent integration

Session management

Customizable UI

​MCP server improvements

MCP server improvements

Audit logging

Tool refresh

Resource tracking

Copy support

SSE streaming

Exception handling

​Card default collapse state

Card default collapse state

Documentation

Progressive disclosure

Optional content

Long forms

FAQ sections

​UI Flow Breadcrumbs

UI Flow Breadcrumbs

Navigation breadcrumbs UI component

Admin theme configuration

​UI Flow Sessions

UI Flow Sessions

Documentation

Session monitoring

Audit log

Process tracking

Workflow debugging

Filtering and search

Real-time status

Session monitoring

Audit and compliance

Debugging

Performance analysis

​Tables in Collections

Tables in Collections

Table Documentation

Collection Documentation

Table in collection items

Structured data display

Table features

Dynamic content

Product catalogs

Data dashboards

Report listings

Comparison views

​Connector topic pattern

Connector topic pattern

Shared topic pattern

Security concerns

​Kafka configuration alignment

Kafka configuration alignment

Property alignment

SaaS multi-tenancy

Email trigger

Chat component

MCP server improvements

Card default collapse state

UI Flow Breadcrumbs

UI Flow Sessions

Tables in Collections

Connector topic pattern

Kafka configuration alignment

Advancing performance

Designer fixes

Navigation & routing

Backend fixes

Process engine

AI platform

Integration Designer

Additional information

Deployment information

Compatibility

SaaS features