@salesforce/ui-bundle-template-feature-react-agentforce-conversation-client 1.117.2

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@salesforce/ui-bundle-template-feature-react-agentforce-conversation-client",
+  "version": "1.117.2",
+  "description": "Embedded Agentforce conversation client feature for UI Bundles",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "author": "",
+  "type": "module",
+  "main": "src/force-app/main/default/uiBundles/feature-react-agentforce-conversation-client/src/index.ts",
+  "types": "src/force-app/main/default/uiBundles/feature-react-agentforce-conversation-client/src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/force-app/main/default/uiBundles/feature-react-agentforce-conversation-client/src/index.ts",
+      "import": "./src/force-app/main/default/uiBundles/feature-react-agentforce-conversation-client/src/index.ts",
+      "default": "./src/force-app/main/default/uiBundles/feature-react-agentforce-conversation-client/src/index.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "rules"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@salesforce/agentforce-conversation-client": "^1.117.2"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "react": "^19.2.1",
+    "react-dom": "^19.2.1",
+    "react-router": "^7.10.1"
+  },
+  "nx": {
+    "targets": {
+      "build": {
+        "executor": "@salesforce/ui-bundle-template-cli:apply-patches"
+      },
+      "watch": {
+        "executor": "@salesforce/ui-bundle-template-cli:watch-patches"
+      },
+      "build:dist-app": {
+        "executor": "@salesforce/ui-bundle-template-cli:build-dist-app"
+      },
+      "dev": {
+        "executor": "@salesforce/ui-bundle-template-cli:dev-server"
+      }
+    }
+  }
+}

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

@@ -0,0 +1,168 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+import { embedAgentforceClient } from "@salesforce/agentforce-conversation-client";
+import type { AgentforceClientConfig } from "@salesforce/agentforce-conversation-client";
+import { useEffect, useMemo, useRef } from "react";
+import type {
+	ResolvedEmbedOptions,
+	AgentforceConversationClientProps,
+} from "../types/conversation";
+
+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 };
+}
+
+/**
+ * React wrapper that embeds the Agentforce Conversation Client (copilot/agent UI)
+ * using Lightning Out. Requires a valid Salesforce session for the given org.
+ * Config is passed through from the consumer to the embed client as-is.
+ */
+export function AgentforceConversationClient({
+	agentId,
+	inline: inlineProp,
+	headerEnabled,
+	showHeaderIcon,
+	width,
+	height,
+	styleTokens,
+	salesforceOrigin,
+	frontdoorUrl,
+}: AgentforceConversationClientProps) {
+	const containerRef = useRef<HTMLDivElement>(null);
+	const normalizedAgentforceClientConfig = useMemo<AgentforceClientConfig>(() => {
+		const renderingConfig: NonNullable<AgentforceClientConfig["renderingConfig"]> = {
+			mode: inlineProp ? "inline" : "floating",
+			...(headerEnabled !== undefined && { headerEnabled }),
+			...(showHeaderIcon !== undefined && { showHeaderIcon }),
+			...{ showAvatar: false },
+			...(width !== undefined && { width }),
+			...(height !== undefined && { height }),
+		};
+
+		return {
+			...(agentId !== undefined && { agentId }),
+			...(styleTokens !== undefined && { styleTokens }),
+			renderingConfig,
+		};
+	}, [agentId, inlineProp, headerEnabled, showHeaderIcon, width, height, styleTokens]);
+
+	const inline = normalizedAgentforceClientConfig?.renderingConfig?.mode === "inline";
+
+	useEffect(() => {
+		if (!normalizedAgentforceClientConfig?.agentId) {
+			throw new Error(
+				"AgentforceConversationClient requires agentId. " +
+					"Pass flat props only (agentId, inline, headerEnabled, showHeaderIcon, width, height, styleTokens).",
+			);
+		}
+
+		const singleton = getSingleton();
+		if (singleton.initialized || singleton.initPromise) {
+			return;
+		}
+
+		if (inline && !containerRef.current) {
+			return;
+		}
+
+		const initialize = (options: ResolvedEmbedOptions) => {
+			if (singleton.initialized) {
+				return;
+			}
+			const existingEmbed = document.querySelector('lightning-out-application[data-lo="acc"]');
+			if (existingEmbed) {
+				singleton.initialized = true;
+				return;
+			}
+			const host = inline ? containerRef.current! : getOrCreateGlobalHost();
+
+			embedAgentforceClient({
+				container: host,
+				salesforceOrigin: salesforceOrigin ?? options.salesforceOrigin,
+				frontdoorUrl: frontdoorUrl ?? options.frontdoorUrl,
+				agentforceClientConfig: normalizedAgentforceClientConfig,
+			});
+			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 () => {
+			// Intentionally no cleanup:
+			// This component guarantees a single LO initialization per window.
+		};
+	}, [salesforceOrigin, frontdoorUrl, normalizedAgentforceClientConfig, inline]);
+
+	if (!inline) {
+		return null;
+	}
+
+	return <div ref={containerRef} />;
+}
+
+export default AgentforceConversationClient;

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

@@ -0,0 +1,6 @@
+/**
+ * feature-react-agentforce-conversation-client – ACC Conversation Client
+ */
+
+export { AgentforceConversationClient } from "./components/AgentforceConversationClient";
+export type { AgentforceConversationClientProps, ResolvedEmbedOptions } from "./types/conversation";

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

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+import AgentforceConversationClient from "../components/AgentforceConversationClient";
+
+export default function TestAccPage() {
+	return (
+		<div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-12">
+			<div className="text-center">
+				<h1 className="text-4xl font-bold text-gray-900 mb-4">ACC</h1>
+				<p className="text-lg text-gray-600 mb-8">Welcome to your ACC application.</p>
+			</div>
+			<AgentforceConversationClient agentId="0Xx000000000000AAA" />
+		</div>
+	);
+}

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

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+import type { RouteObject } from "react-router";
+import AppLayout from "./__inherit__appLayout";
+import TestAccPage from "./pages/TestAccPage";
+
+export const routes: RouteObject[] = [
+	{
+		path: "/",
+		element: <AppLayout />,
+		children: [
+			{
+				path: "test-acc",
+				element: <TestAccPage />,
+				handle: { showInNavigation: true, label: "Test ACC" },
+			},
+		],
+	},
+];

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

@@ -0,0 +1,33 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+export interface ResolvedEmbedOptions {
+	salesforceOrigin?: string;
+	frontdoorUrl?: string;
+}
+
+export type StyleTokens = Record<string, string>;
+
+export interface AgentforceConversationClientProps {
+	/** Required in practice: id of the agent to load. */
+	agentId: string;
+	/** If true, renders inline. If omitted/false, renders floating. */
+	inline?: boolean;
+	/** Show/hide chat header. Defaults to true for floating; can only be set for inline mode. */
+	headerEnabled?: boolean;
+	/** Show/hide agent icon in the header. */
+	showHeaderIcon?: boolean;
+	/** Inline width. */
+	width?: string | number;
+	/** Inline height. */
+	height?: string | number;
+	/** Theme overrides for the chat UI. */
+	styleTokens?: StyleTokens;
+	/** Optional. If not provided, resolved internally (e.g. from /__lo/frontdoor in dev, window.location.origin in prod). */
+	salesforceOrigin?: string;
+	/** Optional. If not provided, resolved internally in dev via /__lo/frontdoor. */
+	frontdoorUrl?: string;
+}