@salesforce/webapp-template-feature-react-agentforce-conversation-client-experimental 1.33.5 → 1.34.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -2
- package/dist/CHANGELOG.md +16 -0
- package/dist/force-app/main/default/webapplications/feature-react-agentforce-conversation-client/package-lock.json +4 -4
- package/dist/force-app/main/default/webapplications/feature-react-agentforce-conversation-client/package.json +1 -1
- package/dist/package.json +1 -1
- package/package.json +15 -4
- package/rules/embedded-agent-rule.md +2 -2
- package/skills/embedded-agent/SKILL.md +7 -12
package/README.md
CHANGED
|
@@ -11,13 +11,14 @@ The component embeds the Agentforce chat experience using Lightning Out 2.0. Aut
|
|
|
11
11
|
- **Dev (localhost)**: fetches a `frontdoorUrl` from `/__lo/frontdoor`
|
|
12
12
|
- **Prod (hosted in org)**: uses `window.location.origin` as `salesforceOrigin`
|
|
13
13
|
|
|
14
|
-
## Step 1: Install
|
|
14
|
+
## Step 1: Install
|
|
15
15
|
|
|
16
16
|
```bash
|
|
17
|
-
npm install @salesforce/agentforce-conversation-client
|
|
18
17
|
npm install @salesforce/webapp-template-feature-react-agentforce-conversation-client-experimental
|
|
19
18
|
```
|
|
20
19
|
|
|
20
|
+
This automatically installs `@salesforce/agentforce-conversation-client` (the underlying SDK) as a dependency.
|
|
21
|
+
|
|
21
22
|
## Step 2: Embed in the app layout
|
|
22
23
|
|
|
23
24
|
```tsx
|
package/dist/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,22 @@
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
|
|
5
5
|
|
|
6
|
+
# [1.34.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.33.6...v1.34.0) (2026-02-18)
|
|
7
|
+
|
|
8
|
+
**Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
## [1.33.6](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.33.5...v1.33.6) (2026-02-18)
|
|
15
|
+
|
|
16
|
+
**Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
|
|
6
22
|
## [1.33.5](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.33.4...v1.33.5) (2026-02-18)
|
|
7
23
|
|
|
8
24
|
**Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
"name": "base-react-app",
|
|
9
9
|
"version": "1.0.0",
|
|
10
10
|
"dependencies": {
|
|
11
|
-
"@salesforce/agentforce-conversation-client": "^1.33.
|
|
11
|
+
"@salesforce/agentforce-conversation-client": "^1.33.6",
|
|
12
12
|
"@salesforce/webapp-experimental": "*",
|
|
13
13
|
"@tailwindcss/vite": "^4.1.17",
|
|
14
14
|
"react": "^19.2.0",
|
|
@@ -1863,9 +1863,9 @@
|
|
|
1863
1863
|
]
|
|
1864
1864
|
},
|
|
1865
1865
|
"node_modules/@salesforce/agentforce-conversation-client": {
|
|
1866
|
-
"version": "1.33.
|
|
1867
|
-
"resolved": "https://registry.npmjs.org/@salesforce/agentforce-conversation-client/-/agentforce-conversation-client-1.33.
|
|
1868
|
-
"integrity": "sha512-
|
|
1866
|
+
"version": "1.33.6",
|
|
1867
|
+
"resolved": "https://registry.npmjs.org/@salesforce/agentforce-conversation-client/-/agentforce-conversation-client-1.33.6.tgz",
|
|
1868
|
+
"integrity": "sha512-EVe6tJ3rbAHdtcEZKammsroB3Od67TDlDkpuemIHpUBxHKiKukc04TMgGd7LiUKa3f5Lp3gp/mvax53auQG1Bg==",
|
|
1869
1869
|
"license": "SEE LICENSE IN LICENSE.txt",
|
|
1870
1870
|
"dependencies": {
|
|
1871
1871
|
"@lightning-out/application": "2.1.1-rc.2"
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
"test": "vitest"
|
|
13
13
|
},
|
|
14
14
|
"dependencies": {
|
|
15
|
-
"@salesforce/agentforce-conversation-client": "^1.33.
|
|
15
|
+
"@salesforce/agentforce-conversation-client": "^1.33.6",
|
|
16
16
|
"@salesforce/webapp-experimental": "*",
|
|
17
17
|
"@tailwindcss/vite": "^4.1.17",
|
|
18
18
|
"react": "^19.2.0",
|
package/dist/package.json
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@salesforce/webapp-template-feature-react-agentforce-conversation-client-experimental",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.34.0",
|
|
4
4
|
"description": "Embedded Agentforce conversation client feature for web applications",
|
|
5
5
|
"license": "SEE LICENSE IN LICENSE.txt",
|
|
6
6
|
"author": "",
|
|
@@ -24,12 +24,13 @@
|
|
|
24
24
|
"access": "public"
|
|
25
25
|
},
|
|
26
26
|
"scripts": {
|
|
27
|
-
"build": "npx tsx ../../cli/src/index.ts apply-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 --reset",
|
|
28
27
|
"clean": "rm -rf dist",
|
|
29
|
-
"test": "npm run build && cd dist/force-app/main/default/webapplications/feature-react-agentforce-conversation-client && npm ci && npm run build",
|
|
30
28
|
"dev": "cd dist/force-app/main/default/webapplications/feature-react-agentforce-conversation-client && npm install && npm run dev",
|
|
31
29
|
"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"
|
|
32
30
|
},
|
|
31
|
+
"dependencies": {
|
|
32
|
+
"@salesforce/agentforce-conversation-client": "^1.34.0"
|
|
33
|
+
},
|
|
33
34
|
"devDependencies": {
|
|
34
35
|
"@types/react": "^19.2.7",
|
|
35
36
|
"@types/react-dom": "^19.2.3",
|
|
@@ -37,5 +38,15 @@
|
|
|
37
38
|
"react-dom": "^19.2.1",
|
|
38
39
|
"react-router": "^7.10.1"
|
|
39
40
|
},
|
|
40
|
-
"
|
|
41
|
+
"nx": {
|
|
42
|
+
"targets": {
|
|
43
|
+
"build": {
|
|
44
|
+
"executor": "@salesforce/webapp-template-cli-experimental:apply-patches"
|
|
45
|
+
},
|
|
46
|
+
"test": {
|
|
47
|
+
"executor": "@salesforce/webapp-template-cli-experimental:build-dist-app"
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
},
|
|
51
|
+
"gitHead": "78cd04e09a42d965201f46edd5850465f7eda353"
|
|
41
52
|
}
|
|
@@ -10,8 +10,8 @@ When adding or editing the embedded Agentforce chat client in this project, foll
|
|
|
10
10
|
|
|
11
11
|
## Component and library
|
|
12
12
|
|
|
13
|
-
- Use the shared **AgentforceConversationClient** React component from
|
|
14
|
-
-
|
|
13
|
+
- Use the shared **AgentforceConversationClient** React component from `@salesforce/webapp-template-feature-react-agentforce-conversation-client-experimental`. Do not call `embedAgentforceClient` directly in application code.
|
|
14
|
+
- Install with `npm install @salesforce/webapp-template-feature-react-agentforce-conversation-client-experimental`. The underlying SDK (`@salesforce/agentforce-conversation-client`) is included automatically as a dependency.
|
|
15
15
|
|
|
16
16
|
## Authentication
|
|
17
17
|
|
|
@@ -7,27 +7,22 @@ description: Embed an Agentforce conversation client (chat UI) into a React web
|
|
|
7
7
|
|
|
8
8
|
When the user wants an embedded Agentforce chat client in a React app, follow this workflow.
|
|
9
9
|
|
|
10
|
-
## 1. Install the
|
|
10
|
+
## 1. Install the package
|
|
11
11
|
|
|
12
12
|
```bash
|
|
13
|
-
npm install @salesforce/agentforce-conversation-client
|
|
13
|
+
npm install @salesforce/webapp-template-feature-react-agentforce-conversation-client-experimental
|
|
14
14
|
```
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
This single install also brings in `@salesforce/agentforce-conversation-client` (the underlying SDK) automatically.
|
|
17
17
|
|
|
18
|
-
## 2.
|
|
19
|
-
|
|
20
|
-
- Include `@salesforce/webapp-template-feature-react-agentforce-conversation-client-experimental` in the app configuration.
|
|
21
|
-
- This feature provides **AgentforceConversationClient**.
|
|
22
|
-
|
|
23
|
-
## 3. Use the shared wrapper
|
|
18
|
+
## 2. Use the shared wrapper
|
|
24
19
|
|
|
25
20
|
Use the `AgentforceConversationClient` React component. It resolves auth automatically:
|
|
26
21
|
|
|
27
22
|
- **Dev (localhost)**: fetches `frontdoorUrl` from `/__lo/frontdoor`
|
|
28
23
|
- **Prod (hosted in org)**: uses `salesforceOrigin` from `window.location.origin`
|
|
29
24
|
|
|
30
|
-
##
|
|
25
|
+
## 3. Embed in the layout
|
|
31
26
|
|
|
32
27
|
Render `<AgentforceConversationClient />` in the app layout so the chat client loads globally. Keep it alongside the existing layout (do not replace the page shell).
|
|
33
28
|
|
|
@@ -45,7 +40,7 @@ export default function AppLayout() {
|
|
|
45
40
|
}
|
|
46
41
|
```
|
|
47
42
|
|
|
48
|
-
##
|
|
43
|
+
## 4. Configure the agent
|
|
49
44
|
|
|
50
45
|
Pass options via the `agentforceClientConfig` prop:
|
|
51
46
|
|
|
@@ -58,7 +53,7 @@ Pass options via the `agentforceClientConfig` prop:
|
|
|
58
53
|
|
|
59
54
|
See [embed-examples.md](docs/embed-examples.md) for complete examples of each mode.
|
|
60
55
|
|
|
61
|
-
##
|
|
56
|
+
## 5. Validate prerequisites
|
|
62
57
|
|
|
63
58
|
- The org must allow `localhost:<PORT>` in **Trusted Domains for Inline Frames** (session settings).
|
|
64
59
|
|