@salesforce/b2c-dx-mcp 1.8.1 → 1.9.1

package/dist/tools/diagnostics/logs-get-recent.js

@@ -22,7 +22,7 @@ export function createLogsGetRecentTool(loadServices, serverContext, injections)
             prefixes: z
                 .array(z.string())
                 .optional()
-                .describe('Log prefixes to read. Defaults to ["error", "customerror"].'),
+                .describe('Log prefixes to read. Defaults to ["error", "customerror"]. Use a path like "internal/server" to read logs from a subdirectory.'),
             count: z.number().int().positive().optional().describe('Maximum number of entries to return. Defaults to 50.'),
             since: z
                 .string()

package/dist/tools/diagnostics/logs-list-files.js

@@ -18,7 +18,7 @@ export function createLogsListFilesTool(loadServices, serverContext, injections)
             prefixes: z
                 .array(z.string())
                 .optional()
-                .describe('Filter by log prefixes (e.g., ["error", "customerror"]). Returns all when omitted.'),
+                .describe('Filter by log prefixes (e.g., ["error", "customerror"]). Returns all when omitted. Use a path like "internal/server" to list logs in a subdirectory.'),
             sort_by: z.enum(['date', 'name', 'size']).optional().describe('Sort field. Defaults to "date".'),
             sort_order: z.enum(['asc', 'desc']).optional().describe('Sort order. Defaults to "desc".'),
         },

package/dist/tools/diagnostics/logs-watch-start.js

@@ -23,7 +23,7 @@ export function createLogsWatchStartTool(loadServices, serverContext, injections
             prefixes: z
                 .array(z.string())
                 .optional()
-                .describe('Log prefixes to watch. Defaults to ["error", "customerror"].'),
+                .describe('Log prefixes to watch. Defaults to ["error", "customerror"]. Use a path like "internal/server" to watch logs in a subdirectory.'),
             last_entries: z
                 .number()
                 .int()

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.8.1"
+  "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.8.1",
+  "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.20.1"
+    "@salesforce/b2c-tooling-sdk": "1.21.1"
   },
   "devDependencies": {
     "@eslint/compat": "^1",