@cimulate/copilot-widget 1.22.0 → 1.23.0

package/dist/cimulate-copilot-widget.d.ts

@@ -101,6 +101,28 @@ declare interface CommonParams {
     pricebooks?: string[] | null;
 }
 
+/**
+ * One flat map from override key to custom-element tag name.
+ *
+ * `ProductTile` and `ProductCarousel` are the only keys the widget consults for
+ * its built-in product UI: register one and the widget mounts your element in
+ * place of the default tile/carousel (leave it unset and the built-in renders).
+ * Every other key is matched against a `type:"tool_results"` block's top-level
+ * `output_name` (never a field inside the arbitrary `data` payload); an unmatched
+ * block renders nothing. All of them receive the same `OverrideProps`.
+ *
+ *   { ProductTile: "cx-product-card", recentOrders: "cx-recent-orders" }
+ *
+ * Widget chrome (header, search bar, follow-up suggestions) is intentionally NOT
+ * overridable: those keys are accepted by the open index signature but have no
+ * render path, so they are silently ignored.
+ */
+declare interface ComponentOverrides {
+    ProductTile?: OverrideTagName;
+    ProductCarousel?: OverrideTagName;
+    [key: string]: OverrideTagName | undefined;
+}
+
 declare type ComponentType = "chat" | "dialog" | "modal";
 
 declare namespace copilot {
@@ -220,6 +242,9 @@ declare interface CopilotWidgetProps extends CimCopilotSdkConfig {
      * Configuration for messaging mode. Required when mode is 'messaging'.
      */
     messagingConfig?: MessagingModeConfig;
+    overrides?: ComponentOverrides;
+    overridesUrl?: string;
+    inlineOverrides?: ComponentOverrides;
     /**
      *
      * Enables features not yet released. They may require additional backend support and are subject to change.
@@ -347,12 +372,25 @@ declare interface MessagingModeConfig {
     /**
      * Shows a "Connect to a human agent" button in the messaging search bar that
      * asks the Agentforce agent to escalate the conversation to a human. Defaults
-     * to true; set to false to hide it. Requires the org's Agentforce agent to be
+     * to false; set to true to show it. Requires the org's Agentforce agent to be
      * configured with an escalation path/topic, otherwise the button is a no-op.
      */
     enableEscalationToAgent?: boolean;
 }
 
+/**
+ * A component override is the tag name of a pre-registered custom element
+ * (e.g. "product-card"). The widget creates the element via
+ * document.createElement(tagName) and assigns `OverrideProps` to its `props`
+ * setter. The element must be registered with customElements.define before the
+ * widget renders.
+ *
+ * The name must be a valid custom element name — it has to contain a hyphen and
+ * be all lowercase. Anything else (e.g. "ProductTile" or "div") is rejected with
+ * a console error and the slot renders blank.
+ */
+declare type OverrideTagName = string;
+
 declare type PromptsDisplay = "input" | "buttons" | "both";
 
 declare type PromptsExtensionConfig = Omit<PromptsExtensionState, "isInitialized" | "activePromptsId" | "userPrompt" | "promptsMessage" | "responseMessage" | "isResponseLoading" | "placeholder" | "askElseButtonLabel" | "entryType" | "params" | "promptsDisplay" | "disableAskElseButton"> & Partial<Pick<PromptsExtensionState, "placeholder" | "askElseButtonLabel" | "entryType" | "params" | "promptsDisplay" | "disableAskElseButton">>;

package/dist/cimulate-copilot-widget.es.js

@@ -6217,7 +6217,7 @@ const vk = {
   __features: se,
   routingAttributes: ce,
   enableDownloadTranscript: fe = !0,
-  enableEscalationToAgent: ne = !0,
+  enableEscalationToAgent: ne = !1,
   children: be
 }) => {
   const ke = e === "messaging", oe = B.useMemo(() => {
@@ -33601,7 +33601,10 @@ const lB = 180, cB = (e) => {
   ariaLabel: d = "Product carousel",
   children: p
 }) => {
-  const m = Array.from(p), b = m.length, y = B.useRef(null), [_, A] = B.useState(0), { width: v } = qk();
+  const m = Array.from(p).map((re, me) => ({
+    node: re,
+    key: B.isValidElement(re) && re.key != null ? re.key : `carousel-item-${me}`
+  })), b = m.length, y = B.useRef(null), [_, A] = B.useState(0), { width: v } = qk();
   B.useLayoutEffect(() => {
     y.current && A(y.current.getBoundingClientRect().width);
   }, [v, b]);
@@ -33628,10 +33631,10 @@ const lB = 180, cB = (e) => {
             className: G(e, `${z}-carousel__item-group`, {
               "carousel-row-container": !Y
             }),
-            children: m.map((re, me) => /* @__PURE__ */ x.jsx(
+            children: m.map(({ node: re, key: me }, V) => /* @__PURE__ */ x.jsx(
               ex,
               {
-                index: me,
+                index: V,
                 className: G(e, `${z}-carousel__item`),
                 children: re
               },