@salesforce/b2c-dx-mcp 1.3.3 → 1.4.1

package/dist/tools/diagnostics/debug-list-sessions.js

@@ -9,26 +9,30 @@ import { getRegistry } from './session-registry.js';
 export function createDebugListSessionsTool(loadServices, serverContext) {
     return createToolAdapter({
         name: 'debug_list_sessions',
-        description: 'List active script debugger sessions with their breakpoints and any halted threads. ' +
-            'Use this to discover orphaned sessions, check whether breakpoints are armed, and poll for halted threads in the non-blocking debug workflow.',
+        description: 'List active script debugger sessions with their breakpoints, any halted threads, and the session_cookie (e.g. dwsid). ' +
+            'Use this to discover orphaned sessions, check whether breakpoints are armed, poll for halted threads in the non-blocking debug workflow, and retrieve the session cookie to pin a triggering request (Cookie: <name>=<value>) to the app server holding the session.',
         toolsets: ['CARTRIDGES', 'DIAGNOSTICS', 'SCAPI'],
         inputSchema: {},
         async execute(_args, context) {
             const registry = getRegistry(context);
             const entries = registry.listSessions();
             return {
-                sessions: entries.map((entry) => ({
-                    session_id: entry.sessionId,
-                    hostname: entry.hostname,
-                    client_id: entry.clientId,
-                    halted_threads: entry.manager
-                        .getKnownThreads()
-                        .filter((t) => t.status === 'halted')
-                        .map((t) => t.id),
-                    breakpoints: entry.breakpoints.map((bp) => projectBreakpoint(bp, entry.sourceMapper)),
-                    created_at: new Date(entry.createdAt).toISOString(),
-                    last_activity_at: new Date(entry.lastActivityAt).toISOString(),
-                })),
+                sessions: entries.map((entry) => {
+                    const dwsid = entry.manager.getSessionCookie();
+                    return {
+                        session_id: entry.sessionId,
+                        hostname: entry.hostname,
+                        client_id: entry.clientId,
+                        halted_threads: entry.manager
+                            .getKnownThreads()
+                            .filter((t) => t.status === 'halted')
+                            .map((t) => t.id),
+                        breakpoints: entry.breakpoints.map((bp) => projectBreakpoint(bp, entry.sourceMapper)),
+                        session_cookie: dwsid ? { name: 'dwsid', value: dwsid } : null,
+                        created_at: new Date(entry.createdAt).toISOString(),
+                        last_activity_at: new Date(entry.lastActivityAt).toISOString(),
+                    };
+                }),
             };
         },
         formatOutput: (output) => jsonResult(output),

package/dist/tools/diagnostics/debug-start-session.js

@@ -13,6 +13,7 @@ export function createDebugStartSessionTool(loadServices, serverContext) {
         name: 'debug_start_session',
         description: 'Start a script debugger session on a B2C Commerce instance to debug SFRA controllers, custom API scripts, hooks, jobs, or any server-side script. ' +
             'Returns a session_id for use with other debug tools, plus discovered cartridge mappings. ' +
+            'Also returns session_cookie (e.g. dwsid): to reliably hit a breakpoint on a multi-app-server instance, send the request that triggers your code (storefront page load, SCAPI/OCAPI call) with this cookie (Cookie: <name>=<value>) so it lands on the same app server holding the debug session. ' +
             'WARNING: Debug sessions halt remote request threads on the instance. Always call debug_end_session when finished. ' +
             'Requires Basic auth credentials (username/password) and the script debugger enabled in Business Manager.',
         toolsets: ['CARTRIDGES', 'DIAGNOSTICS', 'SCAPI'],
@@ -60,11 +61,16 @@ export function createDebugStartSessionTool(loadServices, serverContext) {
             const cartridgeMappings = {};
             for (const c of cartridges)
                 cartridgeMappings[c.name] = c.src;
+            const dwsid = manager.getSessionCookie();
+            if (!dwsid) {
+                warnings.push('No session cookie (dwsid) was returned by the debugger. Requests cannot be pinned to this app server; breakpoints may not be hit on multi-app-server instances.');
+            }
             return {
                 session_id: entry.sessionId,
                 hostname,
                 cartridges: cartridges.map((c) => c.name),
                 cartridge_mappings: cartridgeMappings,
+                session_cookie: dwsid ? { name: 'dwsid', value: dwsid } : null,
                 warnings,
             };
         },

package/oclif.manifest.json

@@ -420,5 +420,5 @@
       "enableJsonFlag": false
     }
   },
-  "version": "1.3.3"
+  "version": "1.4.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/b2c-dx-mcp",
   "description": "MCP server for B2C Commerce developer experience tools",
-  "version": "1.3.3",
+  "version": "1.4.1",
   "author": "Salesforce",
   "license": "Apache-2.0",
   "repository": "SalesforceCommerceCloud/b2c-developer-tooling",
@@ -80,7 +80,7 @@
     "yaml": "2.9.0",
     "postcss": "8.5.15",
     "zod": "3.25.76",
-    "@salesforce/b2c-tooling-sdk": "1.15.1"
+    "@salesforce/b2c-tooling-sdk": "1.17.0"
   },
   "devDependencies": {
     "@eslint/compat": "^1",