@salesforce/ui-bundle-template-feature-react-agentforce-conversation-client 9.11.0 → 9.12.1

package/README.md

@@ -9,7 +9,7 @@ Use this when a user expects to add an employee agent, Agentforce chat, conversa
 The component embeds the Agentforce chat experience using Lightning Out 2.0. Authentication is resolved automatically:
 
 - **Dev (localhost)**: fetches a `frontdoorUrl` from `/__lo/frontdoor`
-- **Prod (hosted in org)**: uses `window.location.origin` as `salesforceOrigin`
+- **Prod (hosted in org)**: uses `globalThis.SFDC_ENV?.orgUrl` as `salesforceOrigin` when available
 
 ## Step 1: Install
 
@@ -47,7 +47,7 @@ export default function AppLayout() {
 | `showHeaderIcon`   | `boolean`                | No       | Show/hide the icon in the header.                                                                 |
 | `width`            | `number \| string`       | No       | Inline width (px number or CSS string).                                                           |
 | `height`           | `number \| string`       | No       | Inline height (px number or CSS string).                                                          |
-| `styleTokens`      | `Record<string, string>` | No       | Theme tokens for chat UI styling. Merged with package defaults.                                   |
+| `styleTokens`      | `Record<string, string>` | No       | Theme tokens for chat UI styling. Passed through to the underlying SDK.                           |
 | `salesforceOrigin` | `string`                 | No       | Salesforce org origin URL. Resolved automatically if not provided.                                |
 | `frontdoorUrl`     | `string`                 | No       | Frontdoor URL for authentication. Resolved automatically in dev if not provided.                  |
 | `onReady`          | `AgentforceReadyHandler` | No       | Callback invoked when Lightning Out is ready. Receives the event detail.                          |
@@ -141,7 +141,7 @@ Both callbacks are optional. When omitted, the SDK still logs errors and readine
 This React wrapper applies a few defaults around the underlying SDK:
 
 - `showAvatar` is set to `false`.
-- A default style token set is applied, then your `styleTokens` overrides are merged on top.
+- `channel` is set to `"Vibes"`.
 - The embed is initialized once per browser window (singleton). If multiple instances mount, only the first successful initialization performs the embed.
 
 #### Available Style Tokens
@@ -160,11 +160,24 @@ Style tokens are organized by UI area:
 
 ### Prerequisites
 
-- **One of `salesforceOrigin` or `frontdoorUrl` is required** (resolved automatically by the component).
-- Use `salesforceOrigin` when your app is hosted inside a Salesforce org and already has an authenticated session.
-- Use `frontdoorUrl` when embedding the chat client outside Salesforce (e.g. localhost or an external app).
+- **The SDK requires one of `salesforceOrigin` or `frontdoorUrl`.**
+- The wrapper auto-resolves auth in common cases:
+  - **localhost**: fetches `frontdoorUrl` from `/__lo/frontdoor`
+  - **org-hosted UI Bundle**: reads `salesforceOrigin` from `globalThis.SFDC_ENV?.orgUrl`
+- If your runtime does not provide either source, pass `salesforceOrigin` or `frontdoorUrl` explicitly.
 - The org must allow `localhost:<PORT>` in **Trusted Domains for Inline Frames** (session settings) for local development.
 
+### If used outside a Salesforce web app (React app)
+
+When this package is used in an external React app (not running inside a Salesforce-hosted UI Bundle), you should pass `frontdoorUrl` explicitly so Lightning Out can start with an authenticated Salesforce session.
+
+```tsx
+<AgentforceConversationClient
+  agentId="0Xx000000000000AAA"
+  frontdoorUrl="https://your-org.my.salesforce.com/secur/frontdoor.jsp?otp=<OTP>"
+/>
+```
+
 ### Underlying SDK
 
 This component wraps `@salesforce/agentforce-conversation-client`. For lower-level usage (vanilla JS, non-React frameworks), see the [Agentforce Conversation Client SDK](https://www.npmjs.com/package/@salesforce/agentforce-conversation-client).

package/dist/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [9.12.1](https://github.com/salesforce-experience-platform-emu/webapps/compare/v9.12.0...v9.12.1) (2026-05-28)
+
+**Note:** Version bump only for package @salesforce/ui-bundle-template-base-sfdx-project
+
+
+
+
+
+## [9.12.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v9.11.0...v9.12.0) (2026-05-27)
+
+**Note:** Version bump only for package @salesforce/ui-bundle-template-base-sfdx-project
+
+
+
+
+
 ## [9.11.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v9.10.3...v9.11.0) (2026-05-27)
 
 **Note:** Version bump only for package @salesforce/ui-bundle-template-base-sfdx-project

package/dist/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@salesforce/webapp-template-base-sfdx-project-experimental",
-  "version": "9.11.0",
+  "version": "9.12.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@salesforce/webapp-template-base-sfdx-project-experimental",
-      "version": "9.11.0",
+      "version": "9.12.1",
       "license": "SEE LICENSE IN LICENSE.txt",
       "devDependencies": {
         "@lwc/eslint-plugin-lwc": "^3.3.0",

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/ui-bundle-template-base-sfdx-project",
-  "version": "9.11.0",
+  "version": "9.12.1",
   "description": "Base SFDX project template",
   "license": "SEE LICENSE IN LICENSE.txt",
   "publishConfig": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/ui-bundle-template-feature-react-agentforce-conversation-client",
-  "version": "9.11.0",
+  "version": "9.12.1",
   "description": "Embedded Agentforce conversation client feature for UI Bundles",
   "license": "SEE LICENSE IN LICENSE.txt",
   "author": "",
@@ -26,7 +26,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@salesforce/agentforce-conversation-client": "^9.11.0"
+    "@salesforce/agentforce-conversation-client": "^9.12.1"
   },
   "devDependencies": {
     "@types/react": "^19.2.7",