@salesforce/b2c-dx-mcp 1.1.3 → 1.2.0

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

@@ -0,0 +1,22 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { listDocs } from '@salesforce/b2c-tooling-sdk/docs';
+import { createToolAdapter, jsonResult } from '../adapter.js';
+export function createDocsListTool(loadServices) {
+    return createToolAdapter({
+        name: 'docs_list',
+        description: 'List every available Script API documentation entry (id + title). ' +
+            'Output is large; prefer docs_search for targeted lookups.',
+        toolsets: ['CARTRIDGES', 'DIAGNOSTICS', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
+        inputSchema: {},
+        async execute() {
+            const entries = listDocs();
+            return { count: entries.length, entries };
+        },
+        formatOutput: (output) => jsonResult(output),
+    }, loadServices);
+}
+//# sourceMappingURL=docs-list.js.map

package/dist/tools/docs/docs-read.d.ts

@@ -0,0 +1,3 @@
+import type { McpTool } from '../../utils/index.js';
+import type { Services } from '../../services.js';
+export declare function createDocsReadTool(loadServices: () => Promise<Services> | Services): McpTool;

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

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { z } from 'zod';
+import { readDocByQuery } from '@salesforce/b2c-tooling-sdk/docs';
+import { createToolAdapter, errorResult, jsonResult } from '../adapter.js';
+export function createDocsReadTool(loadServices) {
+    return createToolAdapter({
+        name: 'docs_read',
+        description: 'Read full Script API documentation (markdown) for a B2C Commerce class or module. ' +
+            'Accepts an exact id (e.g., "dw.catalog.ProductMgr") or fuzzy query — best match wins. ' +
+            'Content can be large; if you do not know the id, call docs_search first to narrow down.',
+        toolsets: ['CARTRIDGES', 'DIAGNOSTICS', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
+        inputSchema: {
+            query: z.string().min(1).describe('Exact id ("dw.catalog.ProductMgr") or fuzzy query ("ProductMgr").'),
+        },
+        async execute(args) {
+            return readDocByQuery(args.query);
+        },
+        formatOutput: (output) => output ? jsonResult(output) : errorResult('No documentation found. Try docs_search to find candidates.'),
+    }, loadServices);
+}
+//# sourceMappingURL=docs-read.js.map

package/dist/tools/docs/docs-schema-list.d.ts

@@ -0,0 +1,3 @@
+import type { McpTool } from '../../utils/index.js';
+import type { Services } from '../../services.js';
+export declare function createDocsSchemaListTool(loadServices: () => Promise<Services> | Services): McpTool;

package/dist/tools/docs/docs-schema-list.js

@@ -0,0 +1,21 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { listSchemas } from '@salesforce/b2c-tooling-sdk/docs';
+import { createToolAdapter, jsonResult } from '../adapter.js';
+export function createDocsSchemaListTool(loadServices) {
+    return createToolAdapter({
+        name: 'docs_schema_list',
+        description: 'List every available B2C Commerce XSD schema id. Use to discover schema names for docs_schema_read.',
+        toolsets: ['CARTRIDGES', 'DIAGNOSTICS', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
+        inputSchema: {},
+        async execute() {
+            const entries = listSchemas();
+            return { count: entries.length, entries };
+        },
+        formatOutput: (output) => jsonResult(output),
+    }, loadServices);
+}
+//# sourceMappingURL=docs-schema-list.js.map

package/dist/tools/docs/docs-schema-read.d.ts

@@ -0,0 +1,3 @@
+import type { McpTool } from '../../utils/index.js';
+import type { Services } from '../../services.js';
+export declare function createDocsSchemaReadTool(loadServices: () => Promise<Services> | Services): McpTool;

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

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { z } from 'zod';
+import { readSchemaByQuery } from '@salesforce/b2c-tooling-sdk/docs';
+import { createToolAdapter, errorResult, jsonResult } from '../adapter.js';
+export function createDocsSchemaReadTool(loadServices) {
+    return createToolAdapter({
+        name: 'docs_schema_read',
+        description: 'Read the contents of a bundled B2C Commerce XSD schema (raw XML). ' +
+            'Accepts an exact id or fuzzy query. Returns the schema body plus the on-disk path. ' +
+            'Schemas can be large; if you do not know the id, call docs_schema_search first.',
+        toolsets: ['CARTRIDGES', 'DIAGNOSTICS', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
+        inputSchema: {
+            query: z.string().min(1).describe('Schema name or partial match.'),
+        },
+        async execute(args) {
+            return readSchemaByQuery(args.query);
+        },
+        formatOutput: (output) => output ? jsonResult(output) : errorResult('No schema found. Try docs_schema_search to find candidates.'),
+    }, loadServices);
+}
+//# sourceMappingURL=docs-schema-read.js.map

package/dist/tools/docs/docs-schema-search.d.ts

@@ -0,0 +1,3 @@
+import type { McpTool } from '../../utils/index.js';
+import type { Services } from '../../services.js';
+export declare function createDocsSchemaSearchTool(loadServices: () => Promise<Services> | Services): McpTool;

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

@@ -0,0 +1,26 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { z } from 'zod';
+import { searchSchemas } from '@salesforce/b2c-tooling-sdk/docs';
+import { createToolAdapter, jsonResult } from '../adapter.js';
+export function createDocsSchemaSearchTool(loadServices) {
+    return createToolAdapter({
+        name: 'docs_schema_search',
+        description: 'Fuzzy-search bundled B2C Commerce XSD schemas by id (e.g., "catalog", "order", "system-objecttype"). ' +
+            'Returns matching schema ids + relevance score. Use BEFORE docs_schema_read when the exact id is unknown.',
+        toolsets: ['CARTRIDGES', 'DIAGNOSTICS', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
+        inputSchema: {
+            query: z.string().min(1).describe('Schema name or partial match (e.g., "catalog", "order").'),
+            limit: z.number().int().positive().optional().describe('Maximum number of results to return. Defaults to 20.'),
+        },
+        async execute(args) {
+            const results = searchSchemas(args.query, args.limit ?? 20);
+            return { query: args.query, results };
+        },
+        formatOutput: (output) => jsonResult(output),
+    }, loadServices);
+}
+//# sourceMappingURL=docs-schema-search.js.map

package/dist/tools/docs/docs-search.d.ts

@@ -0,0 +1,3 @@
+import type { McpTool } from '../../utils/index.js';
+import type { Services } from '../../services.js';
+export declare function createDocsSearchTool(loadServices: () => Promise<Services> | Services): McpTool;

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

@@ -0,0 +1,27 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { z } from 'zod';
+import { searchDocs } from '@salesforce/b2c-tooling-sdk/docs';
+import { createToolAdapter, jsonResult } from '../adapter.js';
+export function createDocsSearchTool(loadServices) {
+    return createToolAdapter({
+        name: 'docs_search',
+        description: 'Fuzzy-search the bundled B2C Commerce Script API documentation by class, module, or partial name ' +
+            '(e.g., "ProductMgr", "dw.catalog", "Status"). Returns matching ids + relevance score. ' +
+            'Use this BEFORE docs_read when you do not know the exact id.',
+        toolsets: ['CARTRIDGES', 'DIAGNOSTICS', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
+        inputSchema: {
+            query: z.string().min(1).describe('Search query (class name, module path, or partial match).'),
+            limit: z.number().int().positive().optional().describe('Maximum number of results to return. Defaults to 20.'),
+        },
+        async execute(args) {
+            const results = searchDocs(args.query, args.limit ?? 20);
+            return { query: args.query, results };
+        },
+        formatOutput: (output) => jsonResult(output),
+    }, loadServices);
+}
+//# sourceMappingURL=docs-search.js.map

package/dist/tools/docs/index.d.ts

@@ -0,0 +1,3 @@
+import type { McpTool } from '../../utils/index.js';
+import type { Services } from '../../services.js';
+export declare function createDocsTools(loadServices: () => Promise<Services> | Services): McpTool[];

package/dist/tools/docs/index.js

@@ -0,0 +1,22 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { createDocsListTool } from './docs-list.js';
+import { createDocsReadTool } from './docs-read.js';
+import { createDocsSchemaListTool } from './docs-schema-list.js';
+import { createDocsSchemaReadTool } from './docs-schema-read.js';
+import { createDocsSchemaSearchTool } from './docs-schema-search.js';
+import { createDocsSearchTool } from './docs-search.js';
+export function createDocsTools(loadServices) {
+    return [
+        createDocsSearchTool(loadServices),
+        createDocsReadTool(loadServices),
+        createDocsListTool(loadServices),
+        createDocsSchemaSearchTool(loadServices),
+        createDocsSchemaReadTool(loadServices),
+        createDocsSchemaListTool(loadServices),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.d.ts

@@ -10,6 +10,7 @@
 export * from './adapter.js';
 export * from './cartridges/index.js';
 export * from './diagnostics/index.js';
+export * from './docs/index.js';
 export * from './mrt/index.js';
 export * from './pwav3/index.js';
 export * from './scapi/index.js';

package/dist/tools/index.js

@@ -17,6 +17,7 @@ export * from './adapter.js';
 // Toolset exports
 export * from './cartridges/index.js';
 export * from './diagnostics/index.js';
+export * from './docs/index.js';
 export * from './mrt/index.js';
 export * from './pwav3/index.js';
 export * from './scapi/index.js';

package/dist/utils/constants.d.ts

@@ -5,11 +5,11 @@ export declare const ALL_TOOLSETS = "ALL";
 /**
  * Available toolsets that can be enabled.
  */
-export declare const TOOLSETS: readonly ["CARTRIDGES", "MRT", "PWAV3", "SCAPI", "STOREFRONTNEXT"];
+export declare const TOOLSETS: readonly ["CARTRIDGES", "DIAGNOSTICS", "MRT", "PWAV3", "SCAPI", "STOREFRONTNEXT"];
 /**
  * Valid toolset names including the special "ALL" value.
  */
-export declare const VALID_TOOLSET_NAMES: readonly ["ALL", "CARTRIDGES", "MRT", "PWAV3", "SCAPI", "STOREFRONTNEXT"];
+export declare const VALID_TOOLSET_NAMES: readonly ["ALL", "CARTRIDGES", "DIAGNOSTICS", "MRT", "PWAV3", "SCAPI", "STOREFRONTNEXT"];
 /**
  * Type representing a valid toolset name.
  */

package/dist/utils/constants.js

@@ -10,7 +10,7 @@ export const ALL_TOOLSETS = 'ALL';
 /**
  * Available toolsets that can be enabled.
  */
-export const TOOLSETS = ['CARTRIDGES', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'];
+export const TOOLSETS = ['CARTRIDGES', 'DIAGNOSTICS', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'];
 /**
  * Valid toolset names including the special "ALL" value.
  */

package/oclif.manifest.json

@@ -172,6 +172,7 @@
           "type": "option"
         },
         "cloud-origin": {
+          "char": "o",
           "description": "MRT cloud origin URL (or set mrtOrigin in dw.json; default: https://cloud.mobify.com)",
           "env": "MRT_CLOUD_ORIGIN",
           "name": "cloud-origin",
@@ -180,6 +181,7 @@
           "type": "option"
         },
         "credentials-file": {
+          "char": "c",
           "description": "Path to MRT credentials file (overrides default ~/.mobify)",
           "env": "MRT_CREDENTIALS_FILE",
           "name": "credentials-file",
@@ -385,7 +387,7 @@
           "type": "boolean"
         },
         "toolsets": {
-          "description": "Toolsets to enable (comma-separated). Options: all, CARTRIDGES, MRT, PWAV3, SCAPI, STOREFRONTNEXT",
+          "description": "Toolsets to enable (comma-separated). Options: all, CARTRIDGES, DIAGNOSTICS, MRT, PWAV3, SCAPI, STOREFRONTNEXT",
           "env": "SFCC_TOOLSETS",
           "name": "toolsets",
           "hasDynamicHelp": false,
@@ -418,5 +420,5 @@
       "enableJsonFlag": false
     }
   },
-  "version": "1.1.3"
+  "version": "1.2.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/b2c-dx-mcp",
   "description": "MCP server for B2C Commerce developer experience tools",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "author": "Salesforce",
   "license": "Apache-2.0",
   "repository": "SalesforceCommerceCloud/b2c-developer-tooling",
@@ -80,7 +80,7 @@
     "yaml": "2.8.1",
     "postcss": "8.5.6",
     "zod": "3.25.76",
-    "@salesforce/b2c-tooling-sdk": "1.11.1"
+    "@salesforce/b2c-tooling-sdk": "1.12.0"
   },
   "devDependencies": {
     "@eslint/compat": "^1",
@@ -98,10 +98,10 @@
     "eslint-config-oclif": "^6",
     "eslint-config-prettier": "^10",
     "eslint-plugin-header": "^3.1.1",
-    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-prettier": "^5.5.5",
     "mocha": "^10",
     "oclif": "^4",
-    "prettier": "^3.6.2",
+    "prettier": "^3.8.3",
     "shx": "^0.3.3",
     "sinon": "^21.0.1",
     "tsx": "^4",