@salesforce/ui-bundle-template-feature-react-agentforce-conversation-client 9.9.3 → 9.10.0

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

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

@@ -64,6 +64,8 @@ export function AgentforceConversationClient({
 	styleTokens,
 	salesforceOrigin,
 	frontdoorUrl,
+	onReady,
+	onError,
 }: AgentforceConversationClientProps) {
 	const containerRef = useRef<HTMLDivElement>(null);
 	const normalizedAgentforceClientConfig = useMemo<AgentforceClientConfig>(() => {
@@ -121,6 +123,8 @@ export function AgentforceConversationClient({
 					salesforceOrigin: salesforceOrigin ?? options.salesforceOrigin,
 					frontdoorUrl: frontdoorUrl ?? options.frontdoorUrl,
 					agentforceClientConfig: normalizedAgentforceClientConfig,
+					onReady,
+					onError,
 				});
 				singleton.initialized = true;
 			} catch (err) {
@@ -175,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.3",
+  "version": "9.10.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@salesforce/webapp-template-base-sfdx-project-experimental",
-      "version": "9.9.3",
+      "version": "9.10.0",
       "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.3",
+  "version": "9.10.0",
   "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.3",
+  "version": "9.10.0",
   "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.3"
+    "@salesforce/agentforce-conversation-client": "^9.10.0"
   },
   "devDependencies": {
     "@types/react": "^19.2.7",

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

@@ -64,6 +64,8 @@ export function AgentforceConversationClient({
 	styleTokens,
 	salesforceOrigin,
 	frontdoorUrl,
+	onReady,
+	onError,
 }: AgentforceConversationClientProps) {
 	const containerRef = useRef<HTMLDivElement>(null);
 	const normalizedAgentforceClientConfig = useMemo<AgentforceClientConfig>(() => {
@@ -121,6 +123,8 @@ export function AgentforceConversationClient({
 					salesforceOrigin: salesforceOrigin ?? options.salesforceOrigin,
 					frontdoorUrl: frontdoorUrl ?? options.frontdoorUrl,
 					agentforceClientConfig: normalizedAgentforceClientConfig,
+					onReady,
+					onError,
 				});
 				singleton.initialized = true;
 			} catch (err) {
@@ -175,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;
 }