# @adobe/exc-app Changelog

## 1.5.11 (2026-05-14)

- [Feature] Add `appContext` to `openChat` — `OpenChatProps` now accepts `appContext?: JSONValue` to pass structured context directly to the AI panel without requiring an `APP_CONTEXT` interframe request; adds new `JSONValue` type ([ac33f834](https://github.com/Adobe-dxue/unified-shell/commit/ac33f8346aaaa8cf90a2c77d6e255df3cce09b16))
- [Type Change] Refactor `LeftNavConfig` into a discriminated union — adds `LeftNavDisabledConfig` (`{enabled: false}`) and `LeftNavEnabledConfig` interfaces; pass `{enabled: false}` to `useLeftNavButton` to remove a previously registered button (EXC-47389) ([33f32482](https://github.com/Adobe-dxue/unified-shell/commit/33f324823e482f29ddcca26d5059cb52e8efe521))
- [Type Change] Add `gqlPreview` to `BaseNetworkConfig` — shell propagates the `gql_preview` URL param to nested SPA iframes via `RuntimeConfiguration`; fixes cross-origin failure when nested frames tried to read `win.top.location` directly ([6887b342](https://github.com/Adobe-dxue/unified-shell/commit/6887b3429efcb29b9b45b684facf746422b8961b), [767a7ee1](https://github.com/Adobe-dxue/unified-shell/commit/767a7ee172192706988acbaab78601b069774ad3))
- [Type Change] Add `LABS` (`cxLabs`) to `AppIds` — moves AEP Labs to the CX product line (EXC-47665) ([5b487131](https://github.com/Adobe-dxue/unified-shell/commit/5b4871313f3fb35aaa7e1b80c432c3827e358d64))
- [Bug fix] Fix lost metrics on iframe navigation — bumps `@exc/metrics-runtime` to 1.0.6; unflushed metrics are now handed off to the parent frame's transport on `pagehide` so they survive iframe destruction during app-to-app navigation (EXC-47193) ([d6097d70](https://github.com/Adobe-dxue/unified-shell/commit/d6097d708622d89fb8780b15228ac2986cbff823))
- [Improvement] Set up error filter after metrics configure — calls `setUpErrorFilter` post-configuration to catch and suppress errors thrown by solution apps (EXC-46335) ([83e5ed55](https://github.com/Adobe-dxue/unified-shell/commit/83e5ed551e3eaf1295dd50dbead0561602c39630))

## 1.5.10 (2026-04-09)

- [Feature] Spotlight mode for AI Assistant — adds `SPOTLIGHT_MODE` to `InterFrameActionType` and new `SpotlightModeOptions` interface with `enabled`, `spotlightConfig`, `onHover`, and `onClick` callbacks (NXUI-1425) ([562b4bda](https://github.com/Adobe-dxue/unified-shell/commit/562b4bda12351ba615905b96d22258a30a20f2e3))
- [Feature] Add `aiConfig` to `RuntimeConfiguration` — exposes `applicationId` and `contextualNudge` so the runtime can access AI solution config without requesting `APP_CONTEXT` ([80177443](https://github.com/Adobe-dxue/unified-shell/commit/80177443ea20e925e0a4f722c437287926f34d77))
- [Type Change] Add `BEYOND` (Analytics Studio) and `CATALYZE` to `AIApplicationId`, add `BEYOND` to `AppParent` type (AN-443002) ([050a18ba](https://github.com/Adobe-dxue/unified-shell/commit/050a18baefe455d3f6e6375c22c80e8deb5ba433), [89c5b9ec](https://github.com/Adobe-dxue/unified-shell/commit/89c5b9ec900cc09eaa54de58b9d16a995f4c5502))
- [Bug fix] Filter error toasts with `role=alertdialog` from modal detection — prevents toast notifications from incorrectly triggering modal state (NXUI-1431) ([5d4c92fa](https://github.com/Adobe-dxue/unified-shell/commit/5d4c92fad8e14a242ed28c1e4aed17c5092d3f90))

## 1.5.9 (2026-04-02)

- [Feature] Auto open expanded AI Assistant using `openChat` — adds `Modality` enum (`FULLSCREEN`, `RAIL`), `modality` field to `AIMessagePayload` and `OpenChatProps` (EXC-46744) ([2cd9f29](https://github.com/Adobe-dxue/unified-shell/commit/2cd9f29ddd51054942d9842dad30d57645df630f))
- [Type Change] Add `TOGGLE_EXPANSION` with `isExpanded` boolean to `AIMessageEvent` for collapsed state transition before navigation (EXC-46676) ([d1b409a](https://github.com/Adobe-dxue/unified-shell/commit/d1b409afc78af5a12d91dc13dd91e68f5b02677a))
- [Feature] Add `openAIPanel` option to `ShellRedirectOptions` to open the AI Panel after shell redirect navigation (EXC-46805) ([d4a6e06](https://github.com/Adobe-dxue/unified-shell/commit/d4a6e06e43093ad0fe2ee6997bf0dd7b4d7bf663))
- [Type Change] Add `isAWSOrg` to `RuntimeConfiguration` for AEP applications ([4a52986](https://github.com/Adobe-dxue/unified-shell/commit/4a52986410755351bbf2ac2a9aaf6c05b44cb5fd))
- [Type Change] Add `env` to `FeatureFlagConfig` for current environment context ([daf436c](https://github.com/Adobe-dxue/unified-shell/commit/daf436cc8dfaed93ae8e4081ec4e472a04dc8c26))
- [Type Change] Add `STRATEGIC_IDEATION` (Catalyze) and `JOURNEY_OPTIMIZER_B2B_PRIME` (Falco) to `AppIds` (EXC-46711, SPHR-26993) ([ad1a4c6](https://github.com/Adobe-dxue/unified-shell/commit/ad1a4c6b0b0aed2f20eab4a4e03c8d9b45e9f684), [93ab68a](https://github.com/Adobe-dxue/unified-shell/commit/93ab68ad09681622169b6d8234027225c254224d))
- [Bug fix] Fix A11y skip menu focus target for AI Assistant chat input in expanded rail — no interface change (EXC-46771) ([c394bc2](https://github.com/Adobe-dxue/unified-shell/commit/c394bc2fbdcbdd6ccf06e83b7ca80e05c536d9be))
- [Improvement] Reliability: defensive null checks in metrics and util — no interface change (EXC-46335) ([cbb6868](https://github.com/Adobe-dxue/unified-shell/commit/cbb68686aefcaad3c971dc5a82a3de8120b0ed8a))

## 1.5.7, 1.5.8 (2026-03-16)

- [Feature] Hybrid mode: expand and collapse AI Assistant — adds `toggleExpansion` API, `FormFactor` enum, `SET_FORM_FACTOR`/`TOGGLE_EXPANSION` message types, and `isRightPanelExpanded` config flag (EXC-46233) ([f42e7c8](https://github.com/Adobe-dxue/unified-shell/commit/f42e7c8a811ccefb62e418ba150a74909bdbdbd5))
- [Feature] AI enablement for Experimentation Accelerator and Falco ([b30f301](https://github.com/Adobe-dxue/unified-shell/commit/b30f30134a270e5aa7c574b07fc50b9a4c6e56e7))
- [Feature] Add `DOM_SCREENSHOT` interframe action and rail navigation notification (NXUI-1073) ([31ee49f](https://github.com/Adobe-dxue/unified-shell/commit/31ee49fd394a4bfc65b87f082ff6f0232a73166e))

## 1.5.5 (2026-03-05)

- [Feature] Add LLM Optimizer to app switcher and quick access (EXC-46206) ([830bbe1](https://github.com/Adobe-dxue/unified-shell/commit/830bbe1ed7ae2c28902b784a851a765f69fbe970))
- [Feature] Implement opening NextGenUI Right Rail with a specific conversation loaded — overloads `openChat` to accept `OpenChatProps` with `conversationId`, `query`, and `shouldSubmit` ([7ac5569](https://github.com/Adobe-dxue/unified-shell/commit/7ac5569789f36c5790708b517b0133035ff6052e))
- [Feature] Add AI automation entry to AEC left nav (EXC-46490) ([4291305](https://github.com/Adobe-dxue/unified-shell/commit/429130571a7d344116138aab29230d7bcca8f18c))
- [Type Change] Falco composed app with home and people — adds `FALCO` to `AppParent` type ([f91dc8e](https://github.com/Adobe-dxue/unified-shell/commit/f91dc8e118523ef709f4fafc86446362bceecc2f))

## 1.5.4 (2026-02-12)

- [Feature] CHE2 support for GQL, XQL, and IO — extracts `BaseNetworkConfig` interface, adds `getRegionEndpoint` function, `ServiceType` enum, `bypassRegionLock` option, and regional endpoint types (EXC-45337) ([6780b9a](https://github.com/Adobe-dxue/unified-shell/commit/6780b9a5c8cd7eba4fb62feb447aa45a2899a8ac))
- [Feature] Automatically handle registered interframe actions in shell for `APP_CONTEXT` — adds `InterFrameActionType` enum and tightens interframe types to `Record<string, any>` (EXC-45538) ([a85ca9f](https://github.com/Adobe-dxue/unified-shell/commit/a85ca9f9789c8cf3c513d7c75d801d4f8ba21756))
- [Type Change] Add `success` boolean and `errorDetail` to `SettingsResponse` (EXC-38197) ([b44fdc5](https://github.com/Adobe-dxue/unified-shell/commit/b44fdc564973bfc129683de0339402460b440e69))
- [Type Change] Add `pageName` to `RuntimeConfiguration` (EXC-46035) ([8ab0c85](https://github.com/Adobe-dxue/unified-shell/commit/8ab0c856e8eb7ead9577dac58def02cadd54a8b7))
- [Type Change] Update collaborator types list and switcher with new types — adds `AGENCY` and `PLATFORM` collaborator types, adds `product` field to `Instance` (EXC-46214) ([ca0b14b](https://github.com/Adobe-dxue/unified-shell/commit/ca0b14b55f741cfe21fc0e09a3795d9f0c69455d))
- [Feature] Add Target and Workfront AI knowledge sources ([b19e00e](https://github.com/Adobe-dxue/unified-shell/commit/b19e00e5cc57e22555da36376d245c68f7b55461))
- [Feature] Add Sales Qualifier AI knowledge source ([dd7db6f](https://github.com/Adobe-dxue/unified-shell/commit/dd7db6f60b2c1595c7558fc08b1075b267759b35))
- [Feature] Add Marketo Engage AI knowledge source (EXC-46234) ([f4906f7](https://github.com/Adobe-dxue/unified-shell/commit/f4906f71bbe54a9deabdfb62bb1bfd4edbda2e58))
- [Bug fix] Fix Marketo Engage AI application id to lowercase ([1401515](https://github.com/Adobe-dxue/unified-shell/commit/140151514d02aa291bf397e3274bdbcd4a7763ad))
- [Feature] Commerce Admin UI instance switcher support (EXC-45838) ([2b43435](https://github.com/Adobe-dxue/unified-shell/commit/2b4343564df76ad6588438a610d752b1e84eb226))
- [Type Change] Updates for Pangea customer release — renames `PROJECT_PANGEA` to `UNIFIED_METRIC_CONTRACT_INSIGHTS` in `AppIds` (EXC-43872) ([a0cd6a5](https://github.com/Adobe-dxue/unified-shell/commit/a0cd6a5ca4a72ccd54a1dc37630ee36b0611bbea))