@xapp/stentor-chat-widget 1.85.1 → 1.87.0

package/lib/ActionBar.d.ts

@@ -1,4 +1,5 @@
 /*! Copyright (c) 2021, XAPPmedia */
+import { Cta } from "./WidgetEnv";
 /**
  * Types of buttons available in the Action Bar
  */
@@ -252,6 +253,12 @@ export interface ActionBarConfig {
      * @default 768
      */
     readonly mobileBreakpoint?: number;
+    /**
+     * Call-to-action configuration for the chat button.
+     * When configured, displays a banner above the action bar prompting
+     * users to engage with chat. Only shown when chat is not open.
+     */
+    readonly cta?: Cta;
 }
 /**
  * Type guard for ActionBarChatButton

package/lib/ActionBar.js

@@ -1,5 +1,4 @@
 "use strict";
-/*! Copyright (c) 2021, XAPPmedia */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isActionBarChatButton = isActionBarChatButton;
 exports.isActionBarFormButton = isActionBarFormButton;

package/lib/ActionBar.js.map

@@ -1 +1 @@
-{"version":3,"file":"ActionBar.js","sourceRoot":"","sources":["../src/ActionBar.ts"],"names":[],"mappings":";AAAA,oCAAoC;;AAwSpC,sDAEC;AAKD,sDAEC;AAKD,8DAEC;AAKD,wDAEC;AAKD,oDAEC;AAKD,wDAEC;AAKD,sDAEC;AAKD,4DAEC;AAtDD;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAuB;IACzD,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAuB;IACzD,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CAAC,MAAuB;IAC7D,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,MAAuB;IAC1D,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,MAAuB;IACxD,OAAO,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,MAAuB;IAC1D,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAuB;IACzD,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB,CAAC,MAAuB;IAC5D,OAAO,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC;AACrC,CAAC"}
+{"version":3,"file":"ActionBar.js","sourceRoot":"","sources":["../src/ActionBar.ts"],"names":[],"mappings":";;AA+SA,sDAEC;AAKD,sDAEC;AAKD,8DAEC;AAKD,wDAEC;AAKD,oDAEC;AAKD,wDAEC;AAKD,sDAEC;AAKD,4DAEC;AAtDD;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAuB;IACzD,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAuB;IACzD,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CAAC,MAAuB;IAC7D,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,MAAuB;IAC1D,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,MAAuB;IACxD,OAAO,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,MAAuB;IAC1D,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAuB;IACzD,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB,CAAC,MAAuB;IAC5D,OAAO,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC;AACrC,CAAC"}

package/lib/UserInfo.d.ts

@@ -27,4 +27,9 @@ export interface UserInfo {
      * Display name
      */
     readonly displayName?: string;
+    /**
+     * Whether this user is an AI agent.
+     * Used to display an "AI" badge on the avatar when configured.
+     */
+    readonly isAI?: boolean;
 }

package/lib/WidgetEnv.d.ts

@@ -49,7 +49,7 @@ export interface Cta extends CtaConfig {
      */
     mobile?: MobileCtaConfig;
 }
-export type ServerType = "direct" | "websocket" | "local" | "websocketraw";
+export type ServerType = "direct" | "websocket" | "local" | "websocketraw" | "mcp";
 /**
  * @deprecated Use connection property
  */
@@ -105,6 +105,70 @@ export interface ServerConfig {
      * @default 60000
      */
     readonly backgroundSleepDelay?: number;
+    /**
+     * MCP-specific configuration
+     * Only applies to "mcp" connection type
+     */
+    readonly mcp?: MCPServerConfig;
+}
+/**
+ * Page context override for testing/development.
+ * When provided, overrides the automatically detected page context.
+ */
+export interface PageContextOverride {
+    /** Full URL to simulate (e.g., "https://example.com/pricing?ref=nav") */
+    readonly url?: string;
+    /** Path to simulate (e.g., "/pricing") */
+    readonly path?: string;
+    /** Document title to simulate (e.g., "Pricing - Example Co") */
+    readonly title?: string;
+    /** Referrer to simulate (e.g., "https://google.com") */
+    readonly referrer?: string;
+}
+export interface MCPServerConfig {
+    /**
+     * Mode determines endpoint path and authentication requirements:
+     * - homeowner: /chat/stream (unauthenticated, appId should be in serverUrl)
+     * - business_owner: /api/chat/stream (authenticated, requires authToken)
+     *
+     * For homeowner mode, the serverUrl should include the appId:
+     * e.g., "https://agent.xapp.ai/abc123"
+     *
+     * @default "homeowner"
+     */
+    readonly mode?: "homeowner" | "business_owner";
+    /**
+     * Auth token required for business_owner mode.
+     * Must be set when mode is "business_owner", will throw error if missing.
+     *
+     * SECURITY: This token grants access to the business account.
+     * Always use HTTPS in production to protect the token.
+     */
+    readonly authToken?: string;
+    /**
+     * Optional session ID for conversation continuity.
+     * If not provided, a new session will be created automatically.
+     * Session IDs are managed by the server and may be updated during conversation.
+     */
+    readonly sessionId?: string;
+    /**
+     * Enable debug mode to show tool calls in the chat.
+     * When enabled, expandable sections will appear showing tool inputs and outputs.
+     * Useful for debugging and understanding how the assistant processes requests.
+     */
+    readonly debugMode?: boolean;
+    /**
+     * Override the automatically detected page context.
+     * Useful for testing/development in Storybook or other environments
+     * where you want to simulate being on a specific page.
+     */
+    readonly pageContextOverride?: PageContextOverride;
+    /**
+     * Show an "AI" badge on the avatar for AI-generated messages.
+     * Helps distinguish AI responses from human agent messages.
+     * @default false
+     */
+    readonly showAiBadge?: boolean;
 }
 /**
  * Environment settings for the Widget

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "1.85.1",
+    "version": "1.87.0",
     "description": "Chat Widget channel for stentor",
     "types": "lib/index",
     "main": "lib/index",
@@ -19,18 +19,18 @@
         "@types/react": "^19.0.0",
         "@types/sinon": "10.0.20",
         "@types/sinon-chai": "3.2.12",
-        "@xapp/config": "0.2.3",
+        "@xapp/config": "0.3.0",
         "chai": "4.5.0",
         "mocha": "9.2.2",
         "sinon": "13.0.2",
         "sinon-chai": "3.7.0",
-        "stentor-models": "1.68.6",
+        "stentor-models": "1.69.9",
         "ts-node": "10.9.2",
         "typescript": "5.9.3"
     },
     "dependencies": {
-        "stentor-constants": "1.68.6",
-        "stentor-guards": "1.68.6"
+        "stentor-constants": "1.69.9",
+        "stentor-guards": "1.69.9"
     },
     "peerDependencies": {
         "react": "^18.0.0 || ^19.0.0",
@@ -40,5 +40,5 @@
         "build": "tsc -d true -p .",
         "clean": "rm -rf ./lib/*"
     },
-    "gitHead": "5c99ab44e56acebb675aede84a8cc5a42a37f051"
+    "gitHead": "e4e9a6ff1e817ce27c3df845376892b980d9adcc"
 }