@salesforce/sdk-chat 1.65.0 → 1.66.0

package/dist/index.d.ts

@@ -17,5 +17,5 @@ export interface ChatSDKOptions extends SDKOptions {
  */
 export declare function createChatSDK(options?: ChatSDKOptions): Promise<ChatSDK>;
 export { MCPAppsChatSDK } from "./mcpapps.js";
-export type { ChatMessage, ChatSDK, DisplayMode, ResourceRequest, SDKOptions, ToolCall, ToolState, } from "@salesforce/sdk-core";
+export type { HostContext, ChatMessage, ChatSDK, DeviceCapabilities, DisplayMode, ResourceRequest, SafeAreaInsets, SDKOptions, ToolCall, ToolState, } from "@salesforce/sdk-core";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAKvF;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IACjD,iEAAiE;IACjE,OAAO,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAyB9E;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,YAAY,EACX,WAAW,EACX,OAAO,EACP,WAAW,EACX,eAAe,EACf,UAAU,EACV,QAAQ,EACR,SAAS,GACT,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAKvF;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IACjD,iEAAiE;IACjE,OAAO,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAyB9E;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,YAAY,EACX,WAAW,EACX,WAAW,EACX,OAAO,EACP,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,cAAc,EACd,UAAU,EACV,QAAQ,EACR,SAAS,GACT,MAAM,sBAAsB,CAAC"}

package/dist/mcpapps.d.ts

@@ -3,7 +3,7 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
-import type { ChatSDK, ChatMessage, ResourceRequest, ToolCall, ToolState, DisplayMode } from "@salesforce/sdk-core";
+import type { ChatSDK, HostContext, ChatMessage, ResourceRequest, ToolCall, ToolState, DisplayMode } from "@salesforce/sdk-core";
 import type { McpAppsSession } from "@salesforce/sdk-core";
 /**
  * Chat SDK implementation for MCP Apps surface using the shared McpAppsSession.
@@ -17,16 +17,10 @@ import type { McpAppsSession } from "@salesforce/sdk-core";
  */
 export declare class MCPAppsChatSDK implements ChatSDK {
     private session;
-    private chatHostContext;
     private globals;
     private canceledCallbacks;
     private subscriptions;
     constructor(session: McpAppsSession);
-    /**
-     * Handle host context change notifications from the host
-     * @param params - Partial host context update from the host
-     */
-    private handleHostContextChanged;
     /**
      * Handle tool result notifications from the host
      * @param params - Tool result data from the host
@@ -56,6 +50,13 @@ export declare class MCPAppsChatSDK implements ChatSDK {
     accessToolInput<T>(): ToolState<T> | null;
     accessToolOutput<T>(): ToolState<T> | null;
     accessToolMetadata<T>(): T | null;
+    /**
+     * Get the current host context.
+     *
+     * Maps MCP Apps wire-format fields to the protocol-agnostic HostContext.
+     * Always returns an object (empty `{}` when no context has been received).
+     */
+    getHostContext(): HostContext;
     onToolCanceled(callback: (reason: string) => void): () => void;
     subscribe(callback: () => void): () => void;
     private notifySubscribers;

package/dist/mcpapps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcpapps.d.ts","sourceRoot":"","sources":["../src/mcpapps.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACX,OAAO,EACP,WAAW,EACX,eAAe,EACf,QAAQ,EACR,SAAS,EACT,WAAW,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAa3D;;;;;;;;;GASG;AACH,qBAAa,cAAe,YAAW,OAAO;IASjC,OAAO,CAAC,OAAO;IAR3B,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,OAAO,CAGR;IACP,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,aAAa,CAAyB;gBAE1B,OAAO,EAAE,cAAc;IAmB3C;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAehC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IASxB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAUvB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;;OAIG;IACG,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC;IAOjE,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtD,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ3C,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC;IAO3D,eAAe,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAMzC,gBAAgB,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAM1C,kBAAkB,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI;IAMjC,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAS9D,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAQ3C,OAAO,CAAC,iBAAiB;CAGzB"}
+{"version":3,"file":"mcpapps.d.ts","sourceRoot":"","sources":["../src/mcpapps.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACX,OAAO,EACP,WAAW,EACX,WAAW,EACX,eAAe,EACf,QAAQ,EACR,SAAS,EACT,WAAW,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;GASG;AACH,qBAAa,cAAe,YAAW,OAAO;IAQjC,OAAO,CAAC,OAAO;IAP3B,OAAO,CAAC,OAAO,CAGR;IACP,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,aAAa,CAAyB;gBAE1B,OAAO,EAAE,cAAc;IAqB3C;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IASxB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAUvB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;;OAIG;IACG,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC;IAOjE,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtD,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ3C,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC;IAO3D,eAAe,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAMzC,gBAAgB,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAM1C,kBAAkB,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI;IAMjC;;;;;OAKG;IACH,cAAc,IAAI,WAAW;IAgC7B,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAS9D,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAQ3C,OAAO,CAAC,iBAAiB;CAGzB"}

package/dist/mcpapps.js

@@ -10,32 +10,19 @@
  */
 export class MCPAppsChatSDK {
     session;
-    chatHostContext = {};
     globals = {};
     canceledCallbacks = new Set();
     subscriptions = new Set();
     constructor(session) {
         this.session = session;
         // Register notification handlers on the shared session
-        session.registerNotificationHandler("ui/notifications/host-context-changed", (params) => this.handleHostContextChanged(params));
+        // Host context merging is handled by the session itself;
+        // we only listen to notify subscribers of changes.
+        session.registerNotificationHandler("ui/notifications/host-context-changed", () => this.notifySubscribers());
         session.registerNotificationHandler("ui/notifications/tool-result", (params) => this.handleToolResult(params));
         session.registerNotificationHandler("ui/notifications/tool-input", (params) => this.handleToolInput(params));
         session.registerNotificationHandler("ui/notifications/tool-cancelled", (params) => this.handleToolCancelled(params));
     }
-    /**
-     * Handle host context change notifications from the host
-     * @param params - Partial host context update from the host
-     */
-    handleHostContextChanged(params) {
-        const contextUpdate = params;
-        if (contextUpdate.displayMode) {
-            this.chatHostContext = {
-                ...this.chatHostContext,
-                displayMode: contextUpdate.displayMode,
-            };
-        }
-        this.notifySubscribers();
-    }
     /**
      * Handle tool result notifications from the host
      * @param params - Tool result data from the host
@@ -121,6 +108,41 @@ export class MCPAppsChatSDK {
             return null;
         return toolInfo;
     }
+    /**
+     * Get the current host context.
+     *
+     * Maps MCP Apps wire-format fields to the protocol-agnostic HostContext.
+     * Always returns an object (empty `{}` when no context has been received).
+     */
+    getHostContext() {
+        const mcp = this.session.getHostContext();
+        const result = {};
+        if (mcp.theme !== undefined) {
+            result.theme = mcp.theme;
+        }
+        if (mcp.displayMode !== undefined) {
+            result.displayMode = mcp.displayMode;
+        }
+        if (mcp.containerDimensions !== undefined) {
+            const h = mcp.containerDimensions.maxHeight ?? mcp.containerDimensions.height;
+            if (h !== undefined) {
+                result.maxHeight = h;
+            }
+        }
+        if (mcp.safeAreaInsets !== undefined) {
+            result.safeArea = mcp.safeAreaInsets;
+        }
+        if (mcp.userAgent !== undefined) {
+            result.userAgent = mcp.userAgent;
+        }
+        if (mcp.locale !== undefined) {
+            result.locale = mcp.locale;
+        }
+        if (mcp.deviceCapabilities !== undefined) {
+            result.deviceCapabilities = mcp.deviceCapabilities;
+        }
+        return result;
+    }
     onToolCanceled(callback) {
         this.canceledCallbacks.add(callback);
         // Return unsubscribe function

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/sdk-chat",
-  "version": "1.65.0",
+  "version": "1.66.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,7 +26,7 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@salesforce/sdk-core": "^1.65.0"
+    "@salesforce/sdk-core": "^1.66.0"
   },
   "devDependencies": {
     "vitest": "^4.0.6"