@salesforce/sdk-chat 1.51.0 → 1.52.0

package/dist/mcpapps.d.ts

@@ -3,29 +3,55 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
-import type { ChatSDK, ChatMessage, ResourceRequest, ToolCall, ToolState } from "@salesforce/sdk-core";
+import type { ChatSDK, ChatMessage, ResourceRequest, ToolCall, ToolState, DisplayMode } from "@salesforce/sdk-core";
+import { JsonRpcClient } from "@salesforce/sdk-core";
 /**
  * Chat SDK implementation for Webapp and MicroFrontend surfaces using MCP Apps protocol
  * Supports: sendMessageToHost, callTool, readResource, accessToolInput, accessToolOutput,
- * accessToolMetadata (stub), onToolCanceled (stub), subscribe
+ * accessToolMetadata (stub), onToolCanceled, subscribe
+ * Extends JsonRpcClient for JSON-RPC 2.0 notification support
  */
-export declare class MCPAppsChatSDK implements ChatSDK {
-    private nextMessageId;
-    private pending;
+export declare class MCPAppsChatSDK extends JsonRpcClient implements ChatSDK {
+    private chatHostContext;
     private globals;
     private canceledCallbacks;
     private subscriptions;
     constructor();
-    private onMessage;
-    private notifySubscribers;
-    private request;
+    /**
+     * 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
+     */
+    private handleToolResult;
+    /**
+     * Handle tool input notifications from the host
+     * @param params - Tool input data from the host
+     */
+    private handleToolInput;
+    /**
+     * Handle tool cancelled notifications from the host
+     * @param params - Tool cancellation data from the host
+     */
+    private handleToolCancelled;
+    /**
+     * Request display mode change from host
+     * @param mode - The requested display mode
+     * @returns Promise with the new display mode (confirmed by host)
+     */
+    setDisplayMode(mode: DisplayMode): Promise<{
+        mode: DisplayMode;
+    }>;
     sendMessageToHost(message: ChatMessage): Promise<void>;
     callTool<T>(toolCall: ToolCall): Promise<T>;
     readResource<T>(request: ResourceRequest): Promise<T>;
     accessToolInput<T>(): ToolState<T> | null;
     accessToolOutput<T>(): ToolState<T> | null;
     accessToolMetadata<T>(): T | null;
-    onToolCanceled(callback: () => void): void;
+    onToolCanceled(callback: (reason: string) => void): () => void;
     subscribe(callback: () => void): () => void;
 }
 //# sourceMappingURL=mcpapps.d.ts.map

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,MAAM,sBAAsB,CAAC;AAqB9B;;;;GAIG;AACH,qBAAa,cAAe,YAAW,OAAO;IAC7C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,OAAO,CAGX;IACJ,OAAO,CAAC,OAAO,CAIR;IACP,OAAO,CAAC,iBAAiB,CAAsB;IAC/C,OAAO,CAAC,aAAa,CAAyB;;IAY9C,OAAO,CAAC,SAAS,CAmCf;IAEF,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,OAAO;IAUT,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,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;IAK3D,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;IAOjC,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAK1C,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;CAS3C"}
+{"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,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAarD;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,aAAc,YAAW,OAAO;IACnE,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,OAAO,CAGR;IACP,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,aAAa,CAAyB;;IA0B9C;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAchC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IASxB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAUvB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;;;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;IAUtD,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;IAKjC,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAS9D,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;CAS3C"}

package/dist/mcpapps.js

@@ -1,79 +1,104 @@
+import { JsonRpcClient } from "@salesforce/sdk-core";
 /**
  * Chat SDK implementation for Webapp and MicroFrontend surfaces using MCP Apps protocol
  * Supports: sendMessageToHost, callTool, readResource, accessToolInput, accessToolOutput,
- * accessToolMetadata (stub), onToolCanceled (stub), subscribe
+ * accessToolMetadata (stub), onToolCanceled, subscribe
+ * Extends JsonRpcClient for JSON-RPC 2.0 notification support
  */
-export class MCPAppsChatSDK {
-    nextMessageId = 1;
-    pending = new Map();
+export class MCPAppsChatSDK extends JsonRpcClient {
+    chatHostContext = {};
     globals = {};
-    canceledCallbacks = [];
+    canceledCallbacks = new Set();
     subscriptions = new Set();
     constructor() {
-        // Listen for messages from parent window
-        window.addEventListener("message", this.onMessage);
-        // Notify parent that iframe is ready
-        if (window.self !== window.top) {
-            window.parent?.postMessage({ type: "ui-lifecycle-iframe-ready" }, "*");
+        super(); // Sets up JSON-RPC message listener
+        // Register notification handler for display mode
+        this.registerNotificationHandler("ui/notifications/host-context-changed", (params) => this.handleHostContextChanged(params));
+        // Register notification handler for tool results
+        this.registerNotificationHandler("ui/notifications/tool-result", (params) => this.handleToolResult(params));
+        // Register notification handler for tool input
+        this.registerNotificationHandler("ui/notifications/tool-input", (params) => this.handleToolInput(params));
+        // Register notification handler for tool cancelled
+        this.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) {
+            // Update stored host context
+            this.chatHostContext = {
+                ...this.chatHostContext,
+                displayMode: contextUpdate.displayMode,
+            };
         }
     }
-    onMessage = (event) => {
-        const data = event.data || {};
-        // Handle render data with toolInput/toolOutput
-        if (data.type === "ui-lifecycle-iframe-render-data") {
-            const renderData = data.payload?.renderData;
-            if (renderData) {
-                if (renderData.toolInput !== undefined) {
-                    this.globals.toolInput = renderData.toolInput;
-                }
-                if (renderData.toolOutput !== undefined) {
-                    this.globals.toolOutput = renderData.toolOutput;
-                }
-            }
-            // Notify subscribers of data change
-            this.notifySubscribers();
+    /**
+     * Handle tool result notifications from the host
+     * @param params - Tool result data from the host
+     */
+    handleToolResult(params) {
+        const toolResult = params;
+        if (toolResult.content !== undefined) {
+            // Store tool output from notification
+            this.globals.toolOutput = toolResult.content;
         }
-        // Handle message responses
-        if (data.type === "ui-message-response" || data.type === "ui-message-received") {
-            const response = data;
-            const id = response.messageId;
-            const slot = id ? this.pending.get(id) : undefined;
-            if (slot && response.type === "ui-message-response") {
-                this.pending.delete(id);
-                if (response.payload?.error) {
-                    slot.reject(new Error(response.payload.error));
-                }
-                else {
-                    slot.resolve(response.payload?.response);
-                }
-                // Notify subscribers of data change
-                this.notifySubscribers();
-            }
+    }
+    /**
+     * Handle tool input notifications from the host
+     * @param params - Tool input data from the host
+     */
+    handleToolInput(params) {
+        const toolInput = params;
+        // Only store non-empty arguments - treat empty object as "no input"
+        if (toolInput.arguments !== undefined && Object.keys(toolInput.arguments).length > 0) {
+            // Store tool input from notification
+            this.globals.toolInput = toolInput.arguments;
         }
-    };
-    notifySubscribers() {
-        this.subscriptions.forEach((callback) => callback());
     }
-    request(type, payload) {
-        const id = String(this.nextMessageId++);
-        const message = { type, messageId: id, payload };
-        return new Promise((resolve, reject) => {
-            this.pending.set(id, { resolve, reject });
-            window.parent?.postMessage(message, "*");
+    /**
+     * Handle tool cancelled notifications from the host
+     * @param params - Tool cancellation data from the host
+     */
+    handleToolCancelled(params) {
+        const cancellation = params;
+        const reason = cancellation.reason ?? "";
+        // Notify all registered cancellation callbacks
+        this.canceledCallbacks.forEach((callback) => callback(reason));
+    }
+    /**
+     * Request display mode change from host
+     * @param mode - The requested display mode
+     * @returns Promise with the new display mode (confirmed by host)
+     */
+    async setDisplayMode(mode) {
+        const response = await this.request("ui/request-display-mode", {
+            displayMode: mode,
         });
+        return response;
     }
     async sendMessageToHost(message) {
-        await this.request("prompt", { prompt: message.content });
+        await this.request("ui/message", {
+            role: "user",
+            content: {
+                type: "text",
+                text: message.content,
+            },
+        });
     }
     async callTool(toolCall) {
-        const result = await this.request("tool", {
-            toolName: toolCall.toolName,
-            params: toolCall.params ?? {},
+        const result = await this.request("tools/call", {
+            name: toolCall.toolName,
+            arguments: toolCall.params ?? {},
         });
         return result;
     }
     async readResource(request) {
-        const result = await this.request("resource", { uri: request.uri });
+        const result = await this.request("resources/read", {
+            uri: request.uri,
+        });
         return result;
     }
     accessToolInput() {
@@ -89,15 +114,15 @@ export class MCPAppsChatSDK {
         return { data: output };
     }
     accessToolMetadata() {
-        // TODO: Implement once MCP Apps protocol specifies tool metadata format
-        const metadata = this.globals.toolMetadata;
-        if (!metadata)
-            return null;
-        return metadata;
+        // Stub - to be implemented later
+        return null;
     }
     onToolCanceled(callback) {
-        // TODO: Implement once MCP Apps protocol specifies cancellation event
-        this.canceledCallbacks.push(callback);
+        this.canceledCallbacks.add(callback);
+        // Return unsubscribe function
+        return () => {
+            this.canceledCallbacks.delete(callback);
+        };
     }
     subscribe(callback) {
         // Add callback to subscriptions set

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/sdk-chat",
-  "version": "1.51.0",
+  "version": "1.52.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.51.0"
+    "@salesforce/sdk-core": "^1.52.0"
   },
   "devDependencies": {
     "vitest": "^4.0.6"
@@ -34,5 +34,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "d23acb27ed4122eeb441c06003af1b8ed7819f89"
+  "gitHead": "ca188815c4810100fe2029d791105091cd78067f"
 }