@W-19151918: 🚀 Shopper Agent Experience v3.0 ( GA ) (#3259)

* fix: add refresh token to shopper agent @W-19097065 (#2999)

* fix: pass refresh token to shopper agent

* fix: add jsdocs for refresh token

* fix: add jsdocs for refresh token

* fix: refresh-token-enhancements (#3030)

* fix: passing currency based off the locale to miaw session (#3131)

* fix: disable input when agent is processing the request (#3242)

* fix: conversational context (#3258)

* fix: rename miaw event

* fix: check for conversational context

* fix: localization support - sf support languages (#3275)

* fix: localization support - sf support languages (#3284)

---------

Co-authored-by: sf-jhalak-maheshwari <jmaheshwari@salesforce.com>

Author: sf-avinash-kasipathy

packages/pwa-kit-create-app/CHANGELOG.md

@@ -1,4 +1,5 @@
-## v3.13.0-dev (Sep 04, 2025)
+## v3.13.0-dev (Sep 17, 2025)
+- This features introduces enhancements to the shopping assistant that integrates Salesforce Embedded Messaging Service with PWA Kit applications, adding comprehensive context support, localization capabilities, and improved user experience features. [#3259](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3259)
 
 ## v3.12.0 (Sep 04, 2025)
 - This feature introduces an AI-powered shopping assistant that integrates Salesforce Embedded Messaging Service with PWA Kit applications. The shopper agent provides real-time chat support, search assistance, and personalized shopping guidance directly within the e-commerce experience. [#2658](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2658)

packages/pwa-kit-create-app/assets/bootstrap/js/config/default.js.hbs

@@ -32,7 +32,9 @@ module.exports = {
             scrt2Url: '',
             salesforceOrgId: '',
             commerceOrgId: '',
-            siteId: ''
+            siteId: '',
+            enableConversationContext: 'false',
+            conversationContext: []
         },
         // Customize how your 'site' and 'locale' are displayed in the url.
         url: {

packages/pwa-kit-create-app/assets/templates/@salesforce/retail-react-app/config/default.js.hbs

@@ -32,7 +32,9 @@ module.exports = {
             scrt2Url: '',
             salesforceOrgId: '',
             commerceOrgId: '',
-            siteId: ''
+            siteId: '',
+            enableConversationContext: 'false',
+            conversationContext: []
         },
         // Customize settings for your url
         url: {

packages/template-retail-react-app/CHANGELOG.md

@@ -2,6 +2,8 @@
 - Updated search UX - prices, images, suggestions new layout [#3271](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3271)
 - Updated the UI for StoreDisplay component which displays pickup in-store information on different pages. [#3248](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3248)
 - Added warning modal for guest users when toggling between multi ship and ship to one address. [3280] (https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3280) [3302] (https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3302)
+- Enhanced the shopping assistant that integrates Salesforce Embedded Messaging Service with PWA Kit applications, adding comprehensive context support, localization capabilities, and improved user experience features. [#3259](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3259)
+- [Breaking] Removed domainUrl, locale, basetId properties as part off the ShopperAgent during initialization. [#3259](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3259)
 
 ## v8.0.0 (Sep 04, 2025)
 - Add support for environment level base paths on /mobify routes [#2892](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2892)

packages/template-retail-react-app/app/components/_app/index.jsx

@@ -366,9 +366,6 @@ const App = (props) => {
                         {commerceAgentConfiguration?.enabled === 'true' && (
                             <ShopperAgent
                                 commerceAgentConfiguration={commerceAgentConfiguration}
-                                domainUrl={`${appOrigin}${buildUrl(location.pathname)}`}
-                                locale={locale?.id}
-                                basketId={basket?.basketId}
                                 basketDoneLoading={basketQueryLastUpdateTime > 0}
                             />
                         )}

packages/template-retail-react-app/app/components/search/index.jsx

@@ -188,7 +188,8 @@ const Search = (props) => {
             if (!miawChatRef.current.hasFired && miawChatRef.current.newChatLaunched) {
                 if (
                     e.detail.conversationEntry?.sender?.role === 'Chatbot' &&
-                    searchInputRef?.current?.value
+                    searchInputRef?.current?.value &&
+                    window.embeddedservice_bootstrap?.utilAPI
                 ) {
                     miawChatRef.current.hasFired = true
                     setTimeout(() => {
@@ -208,17 +209,21 @@ const Search = (props) => {
         }
     }, [])
     const launchChat = () => {
-        window.embeddedservice_bootstrap.utilAPI
-            .launchChat()
-            .then((successMessage) => {
+        if (window.embeddedservice_bootstrap?.settings) {
+            window.embeddedservice_bootstrap.settings.disableStreamingResponses = true
+            window.embeddedservice_bootstrap.settings.enableUserInputForConversationWithBot = false
+        }
+        window.embeddedservice_bootstrap?.utilAPI
+            ?.launchChat()
+            ?.then((successMessage) => {
                 /* TODO: With the Salesforce Winter '26 release, we will be able to use the
                  * onEmbeddedMessagingFirstBotMessageSent event instead, and get rid of this logic. */
                 if (successMessage.includes('Successfully initialized the messaging client')) {
                     miawChatRef.current.hasFired = false //We want the logic in onEmbeddedMessageSent to happen once per new conversation
                     miawChatRef.current.newChatLaunched = true
                 }
             })
-            .catch((err) => {
+            ?.catch((err) => {
                 console.error('launchChat error', err)
             })
     }
@@ -232,7 +237,7 @@ const Search = (props) => {
             return
         }
 
-        if (askAgentOnSearchEnabled && window.embeddedservice_bootstrap) {
+        if (askAgentOnSearchEnabled && window.embeddedservice_bootstrap?.utilAPI) {
             // Add a 500ms delay before sending the message to ensure the experience isn't jarring to the user
             setTimeout(() => {
                 window.embeddedservice_bootstrap.utilAPI