Skip to content

0.3.0

Choose a tag to compare

@github-actions github-actions released this 14 Oct 12:34
· 85 commits to development since this release

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 and CHANGELOG.md (#149, #155, #158)
  • [Host] Read applicationName from the entry-URL query parameter instead of CUSTOM_CLIENT_VARIABLES — upgrade ai-dial-chat (with pass-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_STATE message, and SAVE_ERROR for 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 isReadonly prop (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 zlib in the runtime image to address CVE-2026-85091 (#217)

Other

  • Run on the ghcr.io/epam/ai-dial-chat-bff runtime image, defaulting to the development tag — pin a tag for reproducible builds (#160, #162)
  • Bump @epam/ai-dial-* chat libraries to 1.2.0, @epam/ai-dial-ui-kit to ^0.15.4 and @epam/ai-dial-react-file-manager to ^0.3.5; add @epam/ai-dial-attachment-canvas, @epam/ai-dial-quotations and pdfjs-dist for 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.

  • Image — now chat-api plus this app's static build, amd64-only, default port 5000 (#149, #179)
  • Health check — HEALTHCHECK calls /<API_PREFIX>/health (#149)