@salesforce/b2c-dx-mcp 1.9.0 → 1.9.1

package/dist/tools/docs/docs-read.js

@@ -19,7 +19,8 @@ export function createDocsReadTool(loadServices, enabledCategories, detectedWork
             'fetched from its published URL on demand and cached locally (with a summary/headings fallback if ' +
             'the network is unavailable). If you do not know the id, call docs_search first. Long docs are ' +
             'truncated to maxLength chars; page with offset when truncated=true. The returned entry ' +
-            'includes the canonical url for citation.' +
+            'includes the canonical url for citation and relatedEntries ids for directly connected Help or ' +
+            'Developer Center articles.' +
             enabledCategoriesNote(enabledCategories),
         toolsets: ['CARTRIDGES', 'DIAGNOSTICS', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
         inputSchema: {

package/dist/tools/docs/docs-search.js

@@ -62,6 +62,12 @@ export function createDocsSearchTool(loadServices, detectedWorkspaces = [], enab
                 .positive()
                 .optional()
                 .describe(`Maximum number of results to return. Defaults to ${DEFAULT_LIMIT}.`),
+            offset: z
+                .number()
+                .int()
+                .nonnegative()
+                .optional()
+                .describe('Number of ranked results to skip (for pagination). Defaults to 0.'),
             verbose: z
                 .boolean()
                 .optional()
@@ -69,17 +75,27 @@ export function createDocsSearchTool(loadServices, detectedWorkspaces = [], enab
         },
         async execute(args) {
             const workspace = resolveWorkspace(args.workspace, detectedWorkspaces);
-            const results = searchDocs(args.query, {
-                limit: args.limit ?? DEFAULT_LIMIT,
+            const limit = args.limit ?? DEFAULT_LIMIT;
+            const offset = args.offset ?? 0;
+            // The SDK returns top-N search hits. Retrieve the complete ranked set here
+            // so MCP can report a total and provide stable offset-based pagination.
+            const ranked = searchDocs(args.query, {
+                limit: Number.MAX_SAFE_INTEGER,
                 category: args.category,
                 workspace,
                 enabledCategories,
             });
+            const results = ranked.slice(offset, offset + limit);
+            const end = offset + results.length;
+            const truncated = end < ranked.length;
             return {
                 query: args.query,
                 ...(args.category && { category: args.category }),
                 ...(workspace && { workspace }),
+                total: ranked.length,
+                offset,
                 results: results.map((r) => leanResult(r.entry, r.score, args.verbose ?? false)),
+                ...(truncated && { truncated: true, nextOffset: end }),
             };
         },
         formatOutput: (output) => jsonResult(output),

package/oclif.manifest.json

@@ -428,5 +428,5 @@
       "enableJsonFlag": false
     }
   },
-  "version": "1.9.0"
+  "version": "1.9.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/b2c-dx-mcp",
   "description": "MCP server for B2C Commerce developer experience tools",
-  "version": "1.9.0",
+  "version": "1.9.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.21.0"
+    "@salesforce/b2c-tooling-sdk": "1.21.1"
   },
   "devDependencies": {
     "@eslint/compat": "^1",