@salesforce/ui-bundle-template-feature-react-agentforce-conversation-client 9.9.2 → 9.9.4

package/README.md

@@ -50,6 +50,8 @@ export default function AppLayout() {
 | `styleTokens`      | `Record<string, string>` | No       | Theme tokens for chat UI styling. Merged with package defaults.                                   |
 | `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.                          |
+| `onError`          | `AgentforceErrorHandler` | No       | Callback invoked on Lightning Out errors. Receives `{ type, detail }`.                            |
 
 ### Rendering Modes
 
@@ -114,6 +116,26 @@ Use `showHeaderIcon` to explicitly show or hide the icon in the header.
 <AgentforceConversationClient agentId="0Xx000000000000AAA" showHeaderIcon={false} />
 ```
 
+### Error and ready callbacks
+
+Use `onReady` and `onError` to react programmatically to Lightning Out lifecycle events — for example, to show a loading spinner until the agent is ready, or to report errors to an observability service.
+
+```tsx
+<AgentforceConversationClient
+  agentId="0Xx000000000000AAA"
+  onReady={(detail) => {
+    console.log("Agent chat is ready", detail);
+  }}
+  onError={(error) => {
+    // error.type: "lo.application.error" | "lo.iframe.error"
+    // error.detail: the raw error payload from Lightning Out
+    reportError(error);
+  }}
+/>
+```
+
+Both callbacks are optional. When omitted, the SDK still logs errors and readiness to the console.
+
 ### Wrapper defaults and initialization behavior
 
 This React wrapper applies a few defaults around the underlying SDK:

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.9.4](https://github.com/salesforce-experience-platform-emu/webapps/compare/v9.9.3...v9.9.4) (2026-05-26)
+
+**Note:** Version bump only for package @salesforce/ui-bundle-template-base-sfdx-project
+
+
+
+
+
+## [9.9.3](https://github.com/salesforce-experience-platform-emu/webapps/compare/v9.9.2...v9.9.3) (2026-05-25)
+
+**Note:** Version bump only for package @salesforce/ui-bundle-template-base-sfdx-project
+
+
+
+
+
 ## [9.9.2](https://github.com/salesforce-experience-platform-emu/webapps/compare/v9.9.1...v9.9.2) (2026-05-25)
 
 **Note:** Version bump only for package @salesforce/ui-bundle-template-base-sfdx-project

package/dist/force-app/main/default/uiBundles/feature-react-agentforce-conversation-client/src/components/AgentforceConversationClient.tsx

@@ -13,38 +13,6 @@ import type {
 } from "../types/conversation";
 
 const GLOBAL_HOST_ID = "agentforce-conversation-client-global-host";
-
-const DEFAULT_STYLE_TOKENS: NonNullable<AgentforceClientConfig["styleTokens"]> = {
-	containerBackground: "#fafafa",
-
-	headerBlockBackground: "#372949",
-	headerBlockTextColor: "#ffffff",
-	headerBlockIconColor: "#ffffff",
-	headerBlockBorderBottomColor: "#3b0764",
-	headerBlockFocusBorder: "#c4b5fd",
-
-	messageBlockInboundBackgroundColor: "#ffffff",
-	messageBlockInboundTextColor: "#1f2937",
-	messageBlockInboundBorder: "1px solid #e5e7eb",
-
-	messageBlockOutboundBackgroundColor: "#ede9fe",
-	messageBlockOutboundTextColor: "#1f2937",
-	messageBlockOutboundBorder: "1px solid #d8b4fe",
-
-	messageInputTextColor: "#1f2937",
-	messageInputTextBackgroundColor: "#ffffff",
-	messageInputFooterBorderColor: "#d1d5db",
-	messageInputFooterBorderFocusColor: "#9ca3af",
-	messageInputFocusShadow: "0 0 0 3px rgba(156, 163, 175, 0.25)",
-	messageInputFooterPlaceholderText: "#6b7280",
-
-	messageInputFooterSendButton: "#7e22ce",
-	messageInputFooterSendButtonHoverColor: "#6b21a8",
-	messageInputSendButtonIconColor: "#ffffff",
-	messageInputSendButtonDisabledColor: "#e5e7eb",
-	messageInputActionButtonFocusBorder: "#a855f7",
-	errorBlockBackground: "#fafafa",
-};
 const SINGLETON_KEY = "__agentforceConversationClientSingleton";
 
 interface AgentforceConversationClientSingleton {
@@ -96,6 +64,8 @@ export function AgentforceConversationClient({
 	styleTokens,
 	salesforceOrigin,
 	frontdoorUrl,
+	onReady,
+	onError,
 }: AgentforceConversationClientProps) {
 	const containerRef = useRef<HTMLDivElement>(null);
 	const normalizedAgentforceClientConfig = useMemo<AgentforceClientConfig>(() => {
@@ -111,7 +81,7 @@ export function AgentforceConversationClient({
 		return {
 			...(agentId !== undefined && { agentId }),
 			...(agentLabel !== undefined && { agentLabel }),
-			styleTokens: { ...DEFAULT_STYLE_TOKENS, ...styleTokens },
+			...(styleTokens !== undefined && { styleTokens }),
 			renderingConfig,
 			channel: "Vibes",
 		};
@@ -153,6 +123,8 @@ export function AgentforceConversationClient({
 					salesforceOrigin: salesforceOrigin ?? options.salesforceOrigin,
 					frontdoorUrl: frontdoorUrl ?? options.frontdoorUrl,
 					agentforceClientConfig: normalizedAgentforceClientConfig,
+					onReady,
+					onError,
 				});
 				singleton.initialized = true;
 			} catch (err) {
@@ -207,7 +179,7 @@ export function AgentforceConversationClient({
 			// Intentionally no cleanup:
 			// This component guarantees a single LO initialization per window.
 		};
-	}, [salesforceOrigin, frontdoorUrl, normalizedAgentforceClientConfig, inline]);
+	}, [salesforceOrigin, frontdoorUrl, normalizedAgentforceClientConfig, inline, onReady, onError]);
 
 	if (!inline) {
 		return null;

package/dist/force-app/main/default/uiBundles/feature-react-agentforce-conversation-client/src/types/conversation.ts

@@ -4,6 +4,11 @@
  * For full license text, see the LICENSE.txt file
  */
 
+import type {
+	AgentforceErrorHandler,
+	AgentforceReadyHandler,
+} from "@salesforce/agentforce-conversation-client";
+
 export interface ResolvedEmbedOptions {
 	salesforceOrigin?: string;
 	frontdoorUrl?: string;
@@ -32,4 +37,8 @@ export interface AgentforceConversationClientProps {
 	salesforceOrigin?: string;
 	/** Optional. If not provided, resolved internally in dev via /__lo/frontdoor. */
 	frontdoorUrl?: string;
+	/** Callback invoked when the Lightning Out application is ready. */
+	onReady?: AgentforceReadyHandler;
+	/** Callback invoked when a Lightning Out error occurs. */
+	onError?: AgentforceErrorHandler;
 }

package/dist/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@salesforce/webapp-template-base-sfdx-project-experimental",
-  "version": "9.9.2",
+  "version": "9.9.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@salesforce/webapp-template-base-sfdx-project-experimental",
-      "version": "9.9.2",
+      "version": "9.9.4",
       "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.9.2",
+  "version": "9.9.4",
   "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.9.2",
+  "version": "9.9.4",
   "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.9.2"
+    "@salesforce/agentforce-conversation-client": "^9.9.4"
   },
   "devDependencies": {
     "@types/react": "^19.2.7",

package/src/force-app/main/default/uiBundles/feature-react-agentforce-conversation-client/src/components/AgentforceConversationClient.tsx

@@ -13,38 +13,6 @@ import type {
 } from "../types/conversation";
 
 const GLOBAL_HOST_ID = "agentforce-conversation-client-global-host";
-
-const DEFAULT_STYLE_TOKENS: NonNullable<AgentforceClientConfig["styleTokens"]> = {
-	containerBackground: "#fafafa",
-
-	headerBlockBackground: "#372949",
-	headerBlockTextColor: "#ffffff",
-	headerBlockIconColor: "#ffffff",
-	headerBlockBorderBottomColor: "#3b0764",
-	headerBlockFocusBorder: "#c4b5fd",
-
-	messageBlockInboundBackgroundColor: "#ffffff",
-	messageBlockInboundTextColor: "#1f2937",
-	messageBlockInboundBorder: "1px solid #e5e7eb",
-
-	messageBlockOutboundBackgroundColor: "#ede9fe",
-	messageBlockOutboundTextColor: "#1f2937",
-	messageBlockOutboundBorder: "1px solid #d8b4fe",
-
-	messageInputTextColor: "#1f2937",
-	messageInputTextBackgroundColor: "#ffffff",
-	messageInputFooterBorderColor: "#d1d5db",
-	messageInputFooterBorderFocusColor: "#9ca3af",
-	messageInputFocusShadow: "0 0 0 3px rgba(156, 163, 175, 0.25)",
-	messageInputFooterPlaceholderText: "#6b7280",
-
-	messageInputFooterSendButton: "#7e22ce",
-	messageInputFooterSendButtonHoverColor: "#6b21a8",
-	messageInputSendButtonIconColor: "#ffffff",
-	messageInputSendButtonDisabledColor: "#e5e7eb",
-	messageInputActionButtonFocusBorder: "#a855f7",
-	errorBlockBackground: "#fafafa",
-};
 const SINGLETON_KEY = "__agentforceConversationClientSingleton";
 
 interface AgentforceConversationClientSingleton {
@@ -96,6 +64,8 @@ export function AgentforceConversationClient({
 	styleTokens,
 	salesforceOrigin,
 	frontdoorUrl,
+	onReady,
+	onError,
 }: AgentforceConversationClientProps) {
 	const containerRef = useRef<HTMLDivElement>(null);
 	const normalizedAgentforceClientConfig = useMemo<AgentforceClientConfig>(() => {
@@ -111,7 +81,7 @@ export function AgentforceConversationClient({
 		return {
 			...(agentId !== undefined && { agentId }),
 			...(agentLabel !== undefined && { agentLabel }),
-			styleTokens: { ...DEFAULT_STYLE_TOKENS, ...styleTokens },
+			...(styleTokens !== undefined && { styleTokens }),
 			renderingConfig,
 			channel: "Vibes",
 		};
@@ -153,6 +123,8 @@ export function AgentforceConversationClient({
 					salesforceOrigin: salesforceOrigin ?? options.salesforceOrigin,
 					frontdoorUrl: frontdoorUrl ?? options.frontdoorUrl,
 					agentforceClientConfig: normalizedAgentforceClientConfig,
+					onReady,
+					onError,
 				});
 				singleton.initialized = true;
 			} catch (err) {
@@ -207,7 +179,7 @@ export function AgentforceConversationClient({
 			// Intentionally no cleanup:
 			// This component guarantees a single LO initialization per window.
 		};
-	}, [salesforceOrigin, frontdoorUrl, normalizedAgentforceClientConfig, inline]);
+	}, [salesforceOrigin, frontdoorUrl, normalizedAgentforceClientConfig, inline, onReady, onError]);
 
 	if (!inline) {
 		return null;

package/src/force-app/main/default/uiBundles/feature-react-agentforce-conversation-client/src/types/conversation.ts

@@ -4,6 +4,11 @@
  * For full license text, see the LICENSE.txt file
  */
 
+import type {
+	AgentforceErrorHandler,
+	AgentforceReadyHandler,
+} from "@salesforce/agentforce-conversation-client";
+
 export interface ResolvedEmbedOptions {
 	salesforceOrigin?: string;
 	frontdoorUrl?: string;
@@ -32,4 +37,8 @@ export interface AgentforceConversationClientProps {
 	salesforceOrigin?: string;
 	/** Optional. If not provided, resolved internally in dev via /__lo/frontdoor. */
 	frontdoorUrl?: string;
+	/** Callback invoked when the Lightning Out application is ready. */
+	onReady?: AgentforceReadyHandler;
+	/** Callback invoked when a Lightning Out error occurs. */
+	onError?: AgentforceErrorHandler;
 }