@salesforce/webapp-template-feature-react-agentforce-conversation-client-experimental 1.22.1 → 1.24.0

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.
 
+# [1.24.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.23.0...v1.24.0) (2026-02-11)
+
+**Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental
+
+
+
+
+
+# [1.23.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.22.1...v1.23.0) (2026-02-11)
+
+**Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental
+
+
+
+
+
 ## [1.22.1](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.22.0...v1.22.1) (2026-02-11)
 
 **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.22.0",
+        "@salesforce/agentforce-conversation-client": "^1.23.0",
         "@salesforce/webapp-experimental": "*",
         "@tailwindcss/vite": "^4.1.17",
         "react": "^19.2.0",
@@ -1863,9 +1863,9 @@
       ]
     },
     "node_modules/@salesforce/agentforce-conversation-client": {
-      "version": "1.22.0",
-      "resolved": "https://registry.npmjs.org/@salesforce/agentforce-conversation-client/-/agentforce-conversation-client-1.22.0.tgz",
-      "integrity": "sha512-PrR6v7iaifIFNp+L7Rnj/2DHUYIz+d7AGLlJJU4zOXBGqNi1777Y4J46ILPe9lXnKBbyo6AIptnkyIOSEn3Z5w==",
+      "version": "1.23.0",
+      "resolved": "https://registry.npmjs.org/@salesforce/agentforce-conversation-client/-/agentforce-conversation-client-1.23.0.tgz",
+      "integrity": "sha512-WKiZz4N8MyOtA8OVBt6+laFbsF0O3bYK/Ke64DIMWG/j3bvNF21mOXrI3y/oTeC6Oio0/jJx/+wuuCXaYG63Rg==",
       "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

@@ -12,7 +12,7 @@
     "test": "vitest"
   },
   "dependencies": {
-    "@salesforce/agentforce-conversation-client": "^1.22.0",
+    "@salesforce/agentforce-conversation-client": "^1.23.0",
     "@salesforce/webapp-experimental": "*",
     "@tailwindcss/vite": "^4.1.17",
     "react": "^19.2.0",

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

@@ -5,7 +5,7 @@
  */
 
 import { Outlet } from "react-router";
-import AgentforceConversationClient from "./AgentforceConversationClient.tsx";
+import AgentforceConversationClient from "./components/AgentforceConversationClient";
 
 export default function AppLayout(): React.ReactElement {
 	return (

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

@@ -6,15 +6,13 @@
 
 import {
 	embedAgentforceClient,
-	type AgentforceClientConfig,
 	type EmbedAgentforceClientResult,
 } from "@salesforce/agentforce-conversation-client";
 import { useEffect, useRef } from "react";
-
-export interface ResolvedEmbedOptions {
-	salesforceOrigin?: string;
-	frontdoorUrl?: string;
-}
+import type {
+	ResolvedEmbedOptions,
+	AgentforceConversationClientProps,
+} from "../types/conversation";
 
 async function resolveEmbedOptions(): Promise<ResolvedEmbedOptions> {
 	if (window.location.hostname === "localhost") {
@@ -26,21 +24,12 @@ async function resolveEmbedOptions(): Promise<ResolvedEmbedOptions> {
 	return { salesforceOrigin: window.location.origin };
 }
 
-export interface AgentforceConversationClientProps {
-	/** Optional config from consumer. Passed through to the embed client as-is. */
-	agentforceClientConfig?: AgentforceClientConfig;
-	/** 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;
-}
-
 /**
  * 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 default function AgentforceConversationClient({
+export function AgentforceConversationClient({
 	agentforceClientConfig,
 	salesforceOrigin,
 	frontdoorUrl,
@@ -79,3 +68,5 @@ export default function AgentforceConversationClient({
 		/>
 	);
 }
+
+export default AgentforceConversationClient;

package/dist/force-app/main/default/webapplications/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/dist/force-app/main/default/webapplications/feature-react-agentforce-conversation-client/src/types/conversation.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+import type { AgentforceClientConfig } from "@salesforce/agentforce-conversation-client";
+
+export interface ResolvedEmbedOptions {
+	salesforceOrigin?: string;
+	frontdoorUrl?: string;
+}
+
+export interface AgentforceConversationClientProps {
+	/** Optional config from consumer. Passed through to the embed client as-is. */
+	agentforceClientConfig?: AgentforceClientConfig;
+	/** 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;
+}

package/dist/package.json

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

package/package.json

@@ -1,13 +1,22 @@
 {
   "name": "@salesforce/webapp-template-feature-react-agentforce-conversation-client-experimental",
-  "version": "1.22.1",
+  "version": "1.24.0",
   "description": "Embedded Agentforce conversation client feature for web applications",
   "license": "SEE LICENSE IN LICENSE.txt",
   "author": "",
   "type": "module",
-  "main": "index.js",
+  "main": "src/force-app/main/default/webapplications/feature-react-agentforce-conversation-client/src/index.ts",
+  "types": "src/force-app/main/default/webapplications/feature-react-agentforce-conversation-client/src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/force-app/main/default/webapplications/feature-react-agentforce-conversation-client/src/index.ts",
+      "import": "./src/force-app/main/default/webapplications/feature-react-agentforce-conversation-client/src/index.ts",
+      "default": "./src/force-app/main/default/webapplications/feature-react-agentforce-conversation-client/src/index.ts"
+    }
+  },
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
   "publishConfig": {
     "access": "public"
@@ -25,5 +34,5 @@
     "react-dom": "^19.2.1",
     "react-router": "^7.10.1"
   },
-  "gitHead": "b07f50207ad2ffe2f2edf124fc373731d4101f51"
+  "gitHead": "7bb4b5adf5f2071b38ecf1c7b180f87ec9f71afc"
 }

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

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+import { Outlet } from "react-router";
+import AgentforceConversationClient from "./components/AgentforceConversationClient";
+
+export default function AppLayout(): React.ReactElement {
+	return (
+		<>
+			<Outlet />
+			<AgentforceConversationClient />
+		</>
+	);
+}

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

@@ -0,0 +1,72 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+import {
+	embedAgentforceClient,
+	type EmbedAgentforceClientResult,
+} from "@salesforce/agentforce-conversation-client";
+import { useEffect, useRef } 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 };
+	}
+	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({
+	agentforceClientConfig,
+	salesforceOrigin,
+	frontdoorUrl,
+}: AgentforceConversationClientProps) {
+	const containerRef = useRef<HTMLDivElement>(null);
+	const embedResultRef = useRef<EmbedAgentforceClientResult | null>(null);
+
+	useEffect(() => {
+		const container = containerRef.current;
+		if (!container) 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);
+			}
+		});
+
+		return () => {
+			embedResultRef.current = null;
+		};
+	}, [salesforceOrigin, frontdoorUrl, agentforceClientConfig]);
+
+	return (
+		<div
+			ref={containerRef}
+			className="agentforce-conversation-client-container"
+			id="agentforce-conversation-client-container"
+		/>
+	);
+}
+
+export default AgentforceConversationClient;

package/src/force-app/main/default/webapplications/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/webapplications/feature-react-agentforce-conversation-client/src/types/conversation.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+import type { AgentforceClientConfig } from "@salesforce/agentforce-conversation-client";
+
+export interface ResolvedEmbedOptions {
+	salesforceOrigin?: string;
+	frontdoorUrl?: string;
+}
+
+export interface AgentforceConversationClientProps {
+	/** Optional config from consumer. Passed through to the embed client as-is. */
+	agentforceClientConfig?: AgentforceClientConfig;
+	/** 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;
+}