@salesforce/webapp-template-feature-react-agentforce-conversation-client-experimental 1.36.3 → 1.36.4

package/dist/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.36.4](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.36.3...v1.36.4) (2026-02-19)
+
+**Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental
+
+
+
+
+
 ## [1.36.3](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.36.2...v1.36.3) (2026-02-19)
 
 **Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental

package/dist/force-app/main/default/webapplications/feature-react-agentforce-conversation-client/package-lock.json

@@ -8,7 +8,7 @@
       "name": "base-react-app",
       "version": "1.0.0",
       "dependencies": {
-        "@salesforce/agentforce-conversation-client": "^1.36.2",
+        "@salesforce/agentforce-conversation-client": "^1.36.3",
         "@salesforce/sdk-data": "^1.11.2",
         "@salesforce/webapp-experimental": "*",
         "@tailwindcss/vite": "^4.1.17",
@@ -3486,9 +3486,9 @@
       ]
     },
     "node_modules/@salesforce/agentforce-conversation-client": {
-      "version": "1.36.2",
-      "resolved": "https://registry.npmjs.org/@salesforce/agentforce-conversation-client/-/agentforce-conversation-client-1.36.2.tgz",
-      "integrity": "sha512-P6RTHgjQpGjznC7lKNZVC/oi+QEXuWROS7mzYNfg00Y/pIfEpLCWpcMVoGCSkQToRfYiY7/pyGOxyWptiLxnGA==",
+      "version": "1.36.3",
+      "resolved": "https://registry.npmjs.org/@salesforce/agentforce-conversation-client/-/agentforce-conversation-client-1.36.3.tgz",
+      "integrity": "sha512-F4wLqBqptRoj46QOyUXu0qcQWx4ZGgx580k04gm5D1qGJhD1zga+ZH64aWNhlfBc/mcbfNAqVytuTzbzvHo41w==",
       "license": "SEE LICENSE IN LICENSE.txt",
       "dependencies": {
         "@lightning-out/application": "2.1.1-rc.2"

package/dist/force-app/main/default/webapplications/feature-react-agentforce-conversation-client/package.json

@@ -14,7 +14,7 @@
     "graphql:schema": "node scripts/get-graphql-schema.mjs"
   },
   "dependencies": {
-    "@salesforce/agentforce-conversation-client": "^1.36.2",
+    "@salesforce/agentforce-conversation-client": "^1.36.3",
     "@salesforce/sdk-data": "^1.11.2",
     "@salesforce/webapp-experimental": "*",
     "@tailwindcss/vite": "^4.1.17",

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

@@ -4,23 +4,46 @@
  * For full license text, see the LICENSE.txt file
  */
 
-import {
-	embedAgentforceClient,
-	type EmbedAgentforceClientResult,
-} from "@salesforce/agentforce-conversation-client";
-import { useEffect, useRef } from "react";
+import { embedAgentforceClient } from "@salesforce/agentforce-conversation-client";
+import { useEffect } from "react";
 import type {
 	ResolvedEmbedOptions,
 	AgentforceConversationClientProps,
 } from "../types/conversation";
 
-async function resolveEmbedOptions(): Promise<ResolvedEmbedOptions> {
-	if (window.location.hostname === "localhost") {
-		const res = await fetch("/__lo/frontdoor");
-		if (!res.ok) console.error("frontdoor fetch failed");
-		const { frontdoorUrl } = await res.json();
-		return { frontdoorUrl: frontdoorUrl };
+const GLOBAL_HOST_ID = "agentforce-conversation-client-global-host";
+const SINGLETON_KEY = "__agentforceConversationClientSingleton";
+
+interface AgentforceConversationClientSingleton {
+	initPromise?: Promise<void>;
+	initialized: boolean;
+}
+
+interface WindowWithAgentforceSingleton extends Window {
+	[SINGLETON_KEY]?: AgentforceConversationClientSingleton;
+}
+
+function getSingleton(): AgentforceConversationClientSingleton {
+	const win = window as WindowWithAgentforceSingleton;
+	if (!win[SINGLETON_KEY]) {
+		win[SINGLETON_KEY] = {
+			initialized: false,
+		};
 	}
+	return win[SINGLETON_KEY]!;
+}
+
+function getOrCreateGlobalHost(): HTMLDivElement {
+	let host = document.getElementById(GLOBAL_HOST_ID) as HTMLDivElement | null;
+	if (!host) {
+		host = document.createElement("div");
+		host.id = GLOBAL_HOST_ID;
+		document.body.appendChild(host);
+	}
+	return host;
+}
+
+function getDefaultEmbedOptions(): ResolvedEmbedOptions {
 	return { salesforceOrigin: window.location.origin };
 }
 
@@ -34,39 +57,71 @@ export function AgentforceConversationClient({
 	salesforceOrigin,
 	frontdoorUrl,
 }: AgentforceConversationClientProps) {
-	const containerRef = useRef<HTMLDivElement>(null);
-	const embedResultRef = useRef<EmbedAgentforceClientResult | null>(null);
-
 	useEffect(() => {
-		const container = containerRef.current;
-		if (!container) return;
+		const singleton = getSingleton();
+		if (singleton.initialized || singleton.initPromise) {
+			return;
+		}
 
-		resolveEmbedOptions().then((options) => {
-			try {
-				const result = embedAgentforceClient({
-					container,
-					salesforceOrigin: salesforceOrigin ?? options.salesforceOrigin,
-					frontdoorUrl: frontdoorUrl ?? options.frontdoorUrl,
-					agentforceClientConfig: agentforceClientConfig,
-				});
-				embedResultRef.current = result;
-			} catch (err) {
-				console.error("AgentforceConversationClient: failed to embed Agentforce client", err);
+		const initialize = (options: ResolvedEmbedOptions) => {
+			// If already initialized while this flow was in progress, no-op.
+			if (singleton.initialized) {
+				return;
 			}
-		});
+			const existingEmbed = document.querySelector('lightning-out-application[data-lo="acc"]');
+			if (existingEmbed) {
+				singleton.initialized = true;
+				return;
+			}
+			const host = getOrCreateGlobalHost();
+
+			embedAgentforceClient({
+				container: host,
+				salesforceOrigin: salesforceOrigin ?? options.salesforceOrigin,
+				frontdoorUrl: frontdoorUrl ?? options.frontdoorUrl,
+				agentforceClientConfig: agentforceClientConfig,
+			});
+			singleton.initialized = true;
+		};
+
+		const shouldFetchFrontdoor = window.location.hostname === "localhost";
+
+		if (shouldFetchFrontdoor) {
+			singleton.initPromise = fetch("/__lo/frontdoor")
+				.then(async (res) => {
+					if (!res.ok) {
+						console.error("frontdoor fetch failed");
+						return;
+					}
+					const { frontdoorUrl: resolvedFrontdoorUrl } = await res.json();
+					initialize({ frontdoorUrl: resolvedFrontdoorUrl });
+				})
+				.catch((err) => {
+					console.error("AgentforceConversationClient: failed to fetch frontdoor URL", err);
+				})
+				.finally(() => {
+					singleton.initPromise = undefined;
+				});
+		} else {
+			singleton.initPromise = Promise.resolve()
+				.then(() => {
+					initialize(getDefaultEmbedOptions());
+				})
+				.catch((err) => {
+					console.error("AgentforceConversationClient: failed to embed Agentforce client", err);
+				})
+				.finally(() => {
+					singleton.initPromise = undefined;
+				});
+		}
 
 		return () => {
-			embedResultRef.current = null;
+			// Intentionally no cleanup:
+			// This component guarantees a single LO initialization per window.
 		};
 	}, [salesforceOrigin, frontdoorUrl, agentforceClientConfig]);
 
-	return (
-		<div
-			ref={containerRef}
-			className="agentforce-conversation-client-container"
-			id="agentforce-conversation-client-container"
-		/>
-	);
+	return null;
 }
 
 export default AgentforceConversationClient;

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/webapp-template-base-sfdx-project-experimental",
-  "version": "1.36.3",
+  "version": "1.36.4",
   "description": "Base SFDX project template",
   "private": true,
   "files": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/webapp-template-feature-react-agentforce-conversation-client-experimental",
-  "version": "1.36.3",
+  "version": "1.36.4",
   "description": "Embedded Agentforce conversation client feature for web applications",
   "license": "SEE LICENSE IN LICENSE.txt",
   "author": "",
@@ -32,7 +32,7 @@
     "watch": "npx tsx ../../cli/src/index.ts watch-patches packages/template/feature/feature-react-agentforce-conversation-client packages/template/base-app/base-react-app packages/template/feature/feature-react-agentforce-conversation-client/dist"
   },
   "dependencies": {
-    "@salesforce/agentforce-conversation-client": "^1.36.3"
+    "@salesforce/agentforce-conversation-client": "^1.36.4"
   },
   "devDependencies": {
     "@types/react": "^19.2.7",
@@ -51,5 +51,5 @@
       }
     }
   },
-  "gitHead": "7eef94f53086bb08b0545f5f61d3cbfed3fe0197"
+  "gitHead": "369c2dfde825a4a360489f6a26955605f368d247"
 }

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

@@ -4,23 +4,46 @@
  * For full license text, see the LICENSE.txt file
  */
 
-import {
-	embedAgentforceClient,
-	type EmbedAgentforceClientResult,
-} from "@salesforce/agentforce-conversation-client";
-import { useEffect, useRef } from "react";
+import { embedAgentforceClient } from "@salesforce/agentforce-conversation-client";
+import { useEffect } from "react";
 import type {
 	ResolvedEmbedOptions,
 	AgentforceConversationClientProps,
 } from "../types/conversation";
 
-async function resolveEmbedOptions(): Promise<ResolvedEmbedOptions> {
-	if (window.location.hostname === "localhost") {
-		const res = await fetch("/__lo/frontdoor");
-		if (!res.ok) console.error("frontdoor fetch failed");
-		const { frontdoorUrl } = await res.json();
-		return { frontdoorUrl: frontdoorUrl };
+const GLOBAL_HOST_ID = "agentforce-conversation-client-global-host";
+const SINGLETON_KEY = "__agentforceConversationClientSingleton";
+
+interface AgentforceConversationClientSingleton {
+	initPromise?: Promise<void>;
+	initialized: boolean;
+}
+
+interface WindowWithAgentforceSingleton extends Window {
+	[SINGLETON_KEY]?: AgentforceConversationClientSingleton;
+}
+
+function getSingleton(): AgentforceConversationClientSingleton {
+	const win = window as WindowWithAgentforceSingleton;
+	if (!win[SINGLETON_KEY]) {
+		win[SINGLETON_KEY] = {
+			initialized: false,
+		};
 	}
+	return win[SINGLETON_KEY]!;
+}
+
+function getOrCreateGlobalHost(): HTMLDivElement {
+	let host = document.getElementById(GLOBAL_HOST_ID) as HTMLDivElement | null;
+	if (!host) {
+		host = document.createElement("div");
+		host.id = GLOBAL_HOST_ID;
+		document.body.appendChild(host);
+	}
+	return host;
+}
+
+function getDefaultEmbedOptions(): ResolvedEmbedOptions {
 	return { salesforceOrigin: window.location.origin };
 }
 
@@ -34,39 +57,71 @@ export function AgentforceConversationClient({
 	salesforceOrigin,
 	frontdoorUrl,
 }: AgentforceConversationClientProps) {
-	const containerRef = useRef<HTMLDivElement>(null);
-	const embedResultRef = useRef<EmbedAgentforceClientResult | null>(null);
-
 	useEffect(() => {
-		const container = containerRef.current;
-		if (!container) return;
+		const singleton = getSingleton();
+		if (singleton.initialized || singleton.initPromise) {
+			return;
+		}
 
-		resolveEmbedOptions().then((options) => {
-			try {
-				const result = embedAgentforceClient({
-					container,
-					salesforceOrigin: salesforceOrigin ?? options.salesforceOrigin,
-					frontdoorUrl: frontdoorUrl ?? options.frontdoorUrl,
-					agentforceClientConfig: agentforceClientConfig,
-				});
-				embedResultRef.current = result;
-			} catch (err) {
-				console.error("AgentforceConversationClient: failed to embed Agentforce client", err);
+		const initialize = (options: ResolvedEmbedOptions) => {
+			// If already initialized while this flow was in progress, no-op.
+			if (singleton.initialized) {
+				return;
 			}
-		});
+			const existingEmbed = document.querySelector('lightning-out-application[data-lo="acc"]');
+			if (existingEmbed) {
+				singleton.initialized = true;
+				return;
+			}
+			const host = getOrCreateGlobalHost();
+
+			embedAgentforceClient({
+				container: host,
+				salesforceOrigin: salesforceOrigin ?? options.salesforceOrigin,
+				frontdoorUrl: frontdoorUrl ?? options.frontdoorUrl,
+				agentforceClientConfig: agentforceClientConfig,
+			});
+			singleton.initialized = true;
+		};
+
+		const shouldFetchFrontdoor = window.location.hostname === "localhost";
+
+		if (shouldFetchFrontdoor) {
+			singleton.initPromise = fetch("/__lo/frontdoor")
+				.then(async (res) => {
+					if (!res.ok) {
+						console.error("frontdoor fetch failed");
+						return;
+					}
+					const { frontdoorUrl: resolvedFrontdoorUrl } = await res.json();
+					initialize({ frontdoorUrl: resolvedFrontdoorUrl });
+				})
+				.catch((err) => {
+					console.error("AgentforceConversationClient: failed to fetch frontdoor URL", err);
+				})
+				.finally(() => {
+					singleton.initPromise = undefined;
+				});
+		} else {
+			singleton.initPromise = Promise.resolve()
+				.then(() => {
+					initialize(getDefaultEmbedOptions());
+				})
+				.catch((err) => {
+					console.error("AgentforceConversationClient: failed to embed Agentforce client", err);
+				})
+				.finally(() => {
+					singleton.initPromise = undefined;
+				});
+		}
 
 		return () => {
-			embedResultRef.current = null;
+			// Intentionally no cleanup:
+			// This component guarantees a single LO initialization per window.
 		};
 	}, [salesforceOrigin, frontdoorUrl, agentforceClientConfig]);
 
-	return (
-		<div
-			ref={containerRef}
-			className="agentforce-conversation-client-container"
-			id="agentforce-conversation-client-container"
-		/>
-	);
+	return null;
 }
 
 export default AgentforceConversationClient;