Repository navigation
0.3.0
BREAKING CHANGES
- Replace the standalone Next.js server with a static Vite/React SPA served by
chat-api— the Docker image, all runtime env vars, the auth provider variables and the OAuth redirect URI path (/api/auth/callback/<provider>→/api/v1/auth/callback/<provider>) change; see Deployment Changes andCHANGELOG.md(#149, #155, #158) - [Host] Read
applicationNamefrom the entry-URL query parameter instead ofCUSTOM_CLIENT_VARIABLES— upgradeai-dial-chat(withpass-application-name-to-quickapps) first (#232)
Features
- Use chat skills instead of prompts in the editor (Issue #136) (#139)
- Support application credentials: open the host's credential forms from the agent details popup — needs a host advertising
applicationCredentials=true(#140, #244) - Split Agents & Toolsets into separate Toolsets and Agents rows (Issue #189, #211, #150, #210, #212) (#216)
- Redesign the Skills add-on, reuse the catalog modal for the skills picker and preview skill package files by type (CSV/xlsx, PDF, docx/pptx, images, Markdown, code) (Issue #210) (#213, #223, #247)
- Move conversation starters into Add-ons with a setup modal, removable on hover (Issue #207) (#200, #214, #234)
- Add a Knowledge base add-on row with a restyled file picker — a selected folder is added as a folder, current files are pre-checked, upload progress shows in the kit
TransferQueue(Issue #208) (#222, #227, #249, #253, #257) - Show catalog-style add-on details (header, Connect tab, toolset credentials) for skills, toolsets and agents (#227, #233, #235)
- Replace the agent Connection dialog with a Settings tab in the agent details popup — Connect via (MCP / Chat Completion) saves immediately (#244)
- Add a search field and tool count to the Tools tab of toolset details (#237)
- Add a Settings row with an Advanced Settings popup holding temperature, process files, attachments and feature toggles (Issue #209) (#194, #197, #199, #217, #224, #225, #255)
- Default the orchestrator temperature of new apps to
0.5(#220) - Require non-blank Instructions to save (Issue #203) (#219)
- Redesign the Quick App editor layout, Default model block and model picker (#168, #177, #183, #184, #188, #195)
- Redesign the sign-in, forbidden and auth-error screens (#185)
- [Host] Accept several origins in
allowedOrigin(#198) - [Host] Tell the host when the form is invalid — the new
VALIDITY_STATEmessage, andSAVE_ERRORfor a manual save blocked by validation (Issue #238) (#254)
Fixes
- Treat shared apps exactly like own apps — read-only now comes only from the host's
isReadonlyprop (Issue #208) (#256) - Save toolset and agent ids single-encoded (Issue #178) (#192)
- Persist the Quick App display version from
TRIGGER_SAVE(Issue #164) (#190) - Show the right name for an MCP-only application added as an agent instead of
unknown(#141) - Fit the editor to mobile screens — keep the scroll position when toggling a switch, wrap the Instructions toolbar, open the add-on, model and Knowledge base popups full-screen (Issue #252, #258, #259, #260)
- Patch
zlibin the runtime image to address CVE-2026-85091 (#217)
Other
- Run on the
ghcr.io/epam/ai-dial-chat-bffruntime image, defaulting to thedevelopmenttag — pin a tag for reproducible builds (#160, #162) - Bump
@epam/ai-dial-*chat libraries to1.2.0,@epam/ai-dial-ui-kitto^0.15.4and@epam/ai-dial-react-file-managerto^0.3.5; add@epam/ai-dial-attachment-canvas,@epam/ai-dial-quotationsandpdfjs-distfor skill file previews (#223, #227, #233, #241, #247) - Align Tailwind color tokens with ui-kit 2.0 (#182)
Deployment Changes
New environment variables
| Variable | Required | Default | Description |
|---|---|---|---|
CORS_ORIGIN |
Yes | — | Origin(s) allowed to call the API cross-origin; usually the same as AUTH_CALLBACK_BASE_URL |
AUTH_SESSION_SECRET |
Yes | — | 64 hex characters; AUTH_SESSION_PREV_SECRET allows zero-downtime rotation |
AUTH_CALLBACK_BASE_URL |
Yes | — | This app's own origin |
AUTH_POST_LOGOUT_REDIRECT_URI |
Yes | — | Set to the same value as CORS_ORIGIN and AUTH_CALLBACK_BASE_URL (per CHANGELOG.md) |
AUTH_SESSION_COOKIE_NAME |
No | __Host-quickapps.sess |
Session cookie name |
AUTH_TRANSACTION_COOKIE_NAME |
No | __Host-quickapps.tx |
OAuth handshake cookie name |
AUTH_LEGACY_COOKIE_NAMES |
No | — | Old next-auth cookie names to expire; avoids HTTP ERROR 431 after upgrade |
CSP_MODE |
No | report-only |
Set to enforce once there are no violation reports |
ALLOWED_CONNECT_ORIGINS |
No | none | Extra fetch/XHR origins permitted by CSP |
OVERLAY_ENABLED |
No | unset | Only when the session cookie needs SameSite=None |
API_PREFIX |
No | api |
Prefix for API and health-check routes |
OTEL_SDK_DISABLED |
No | true |
Set to false plus the OTEL_* variables to enable OpenTelemetry |
Renamed / deprecated environment variables
Caution
The old names are no longer read.
| Old variable | New variable or location | Notes |
|---|---|---|
NEXTAUTH_SECRET |
AUTH_SESSION_SECRET |
|
NEXTAUTH_URL |
AUTH_CALLBACK_BASE_URL |
CORS_ORIGIN is set separately |
THEMES_URL |
THEMES_CONFIG_URL |
Now the base URL; /config.json is appended |
ALLOWED_FRAME_ANCESTORS |
ALLOWED_IFRAME_ORIGINS |
|
QUICK_APPS_DEFAULT_MODEL |
DEFAULT_DEPLOYMENT |
|
AUTH_<PROVIDER>_ISSUER / _CLIENT_SECRET |
AUTH_<PROVIDER>_HOST / _SECRET |
Keycloak, Auth0, Azure AD secret; see CHANGELOG.md |
CODE_INTERPRETER_ENABLED, WEB_FETCH_ENABLED, ADD_ATTACHMENT_ENABLED |
CUSTOM_CLIENT_VARIABLES keys codeInterpreterEnabled, webFetchEnabled, addAttachmentEnabled |
Boolean true, not "true" |
ALLOWED_ORIGIN, DIAL_ADMIN_URL, DIAL_CHAT_URL |
CUSTOM_CLIENT_VARIABLES keys allowedOrigin, dialAdminHost, dialChatHost |
|
QUICK_APPS_APPLICATION_NAME |
applicationName entry-URL query parameter |
No env fallback |
Settings keys (CUSTOM_CLIENT_VARIABLES)
| Key | Change | Description |
|---|---|---|
allowedOrigin |
New location, accepts several values | One origin, a comma-separated list or a JSON array; unset or * accepts any origin (unsafe outside local dev) |
dialAdminHost, dialChatHost |
New location | Host origins for the visualizer connector |
codeInterpreterEnabled, webFetchEnabled, addAttachmentEnabled |
New location | Boolean (must be true, not "true"); offer the Code interpreter, Web fetch and Add attachment settings, off when unset |
applicationName |
Removed | Passed by the host as the entry-URL query parameter |
Host integration changes
Important
Upgrade ai-dial-chat first: it must send applicationName in the QuickApps entry URL, otherwise readyToSave is never sent and Save/Preview stay disabled; the admin host does not send it yet. The editor also posts VALIDITY_STATE ({ isValid }) and a SAVE_ERROR for a manual save blocked by validation — older hosts ignore them and wait for the save timeout. Application credentials need a host advertising applicationCredentials=true and handling REQUEST_APPLICATION_CREDENTIALS; older hosts just hide the action. Update every identity provider's redirect URI to /api/v1/auth/callback/<provider>.
Behavioral changes
Note
New apps default the orchestrator temperature to 0.5 (saved values are unchanged), and shared apps are no longer forced read-only.