@salesforce/b2c-dx-mcp 2.0.0 → 2.1.0

package/dist/tools/diagnostics/config-inspect.js

@@ -20,12 +20,12 @@ export function createConfigInspectTool(loadServices) {
         name: 'config_inspect',
         description: 'Inspect the resolved B2C Commerce configuration the MCP server is using — instance hostname, auth, SCAPI, MRT, and other settings — along with which source (dw.json, environment variables, flags) provided each value. ' +
             'Secrets (passwords, client secrets, API keys) are redacted by default. ' +
-            'Pass projectDirectory and/or configPath to inspect the same project and dw.json-format file a CLI command would use. The output includes the effective projectDirectory and source provenance, which is useful for diagnosing why the server targets the wrong instance or cannot find a project. ' +
+            'Pass projectDirectory, configPath, and/or instanceName to inspect the same project, configuration catalog, and named instance another tool would use. The detailed source graph is supplemented by the same compact resolution provenance returned by other configuration-aware tools. ' +
             'Use this first when configuration seems wrong, auth is failing, or the server appears to be operating in the wrong directory.',
         toolsets: ['DIAGNOSTICS'],
         isGA: true,
         requiresInstance: false,
-        usesProjectContext: true,
+        usesConfigurationContext: true,
         inputSchema: {
             unmask: z
                 .boolean()

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

@@ -30,6 +30,7 @@ export function createDebugListSessionsTool(loadServices, serverContext) {
                         session_cookie: dwsid ? { name: 'dwsid', value: dwsid } : null,
                         created_at: new Date(entry.createdAt).toISOString(),
                         last_activity_at: new Date(entry.lastActivityAt).toISOString(),
+                        resolution: entry.resolution,
                     };
                 }),
             };

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

@@ -23,7 +23,7 @@ export function createDebugStartSessionTool(loadServices, serverContext) {
                 .optional()
                 .describe('Optional cartridge discovery and debugger source-mapping root. Relative paths resolve from projectDirectory. Defaults to projectDirectory.'),
         },
-        usesProjectContext: true,
+        usesConfigurationContext: true,
         async execute(args, context) {
             const registry = getRegistry(context);
             const credentials = context.services.getBasicAuthCredentials();
@@ -35,6 +35,10 @@ export function createDebugStartSessionTool(loadServices, serverContext) {
             const clientId = `b2c-dx-mcp-${randomUUID()}`;
             const projectDirectory = context.services.resolveProjectDirectory(args.projectDirectory);
             const cartridgeDir = context.services.resolveWithProjectDirectory(args.cartridgeDirectory, args.projectDirectory);
+            context.setResolvedDirectory('cartridgeDirectory', {
+                path: cartridgeDir,
+                source: args.cartridgeDirectory ? 'argument' : 'projectDirectory',
+            });
             const cartridges = findCartridges(cartridgeDir);
             const warnings = [];
             if (cartridges.length === 0) {
@@ -55,7 +59,14 @@ export function createDebugStartSessionTool(loadServices, serverContext) {
             };
             const manager = new DebugSessionManager({ hostname, username, password, clientId, cartridgeRoots: cartridges }, callbacks);
             await manager.connect();
-            const entry = registry.registerSession({ hostname, clientId, manager, sourceMapper, cartridges });
+            const entry = registry.registerSession({
+                hostname,
+                clientId,
+                manager,
+                sourceMapper,
+                cartridges,
+                resolution: structuredClone(context.resolution),
+            });
             const cartridgeMappings = {};
             for (const c of cartridges)
                 cartridgeMappings[c.name] = c.src;

package/dist/tools/diagnostics/log-watch-registry.d.ts

@@ -1,5 +1,6 @@
 import type { LogEntry, LogFile, TailLogsResult } from '@salesforce/b2c-tooling-sdk/operations/logs';
 import type { ToolExecutionContext } from '../adapter.js';
+import type { ToolResolution } from '../project-context.js';
 /** Maximum number of buffered entries before oldest are evicted. */
 export declare const DEFAULT_BUFFER_CAP = 5000;
 /**
@@ -38,6 +39,7 @@ export interface LogWatchEntry {
     createdAt: number;
     lastActivityAt: number;
     stopped: boolean;
+    resolution?: ToolResolution;
 }
 export interface RegisterWatchOptions {
     hostname: string;
@@ -45,6 +47,7 @@ export interface RegisterWatchOptions {
     tailResult: TailLogsResult;
     bufferCap?: number;
     bufferBytesCap?: number;
+    resolution?: ToolResolution;
 }
 export declare class LogWatchRegistry {
     private cleanupTimer;

package/dist/tools/diagnostics/log-watch-registry.js

@@ -194,6 +194,7 @@ export class LogWatchRegistry {
             stopped: false,
             totalEntriesSeen: 0,
             watchId,
+            resolution: opts.resolution,
         };
         this.watches.set(watchId, entry);
         return entry;

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

@@ -27,6 +27,7 @@ export function createLogsWatchListTool(loadServices, serverContext) {
                     stopped: w.stopped,
                     total_entries_seen: w.totalEntriesSeen,
                     watch_id: w.watchId,
+                    resolution: w.resolution,
                 })),
             };
         },

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

@@ -97,7 +97,12 @@ export function createLogsWatchStartTool(loadServices, serverContext, injections
             // it isn't orphaned (it would otherwise poll WebDAV until process exit).
             let entry;
             try {
-                entry = registry.registerWatch({ hostname, prefixes, tailResult });
+                entry = registry.registerWatch({
+                    hostname,
+                    prefixes,
+                    tailResult,
+                    resolution: structuredClone(context.resolution),
+                });
             }
             catch (error) {
                 await tailResult.stop().catch(() => { });

package/dist/tools/diagnostics/mrt-log-watch-registry.d.ts

@@ -1,5 +1,6 @@
 import type { MrtLogEntry, TailMrtLogsResult } from '@salesforce/b2c-tooling-sdk/operations/mrt';
 import type { ToolExecutionContext } from '../adapter.js';
+import type { ToolResolution } from '../project-context.js';
 /** Maximum number of buffered entries before oldest are evicted. */
 export declare const DEFAULT_BUFFER_CAP = 5000;
 /**
@@ -42,6 +43,7 @@ export interface MrtLogWatchEntry {
      * watch keeps its buffered entries until drained or idle-reaped.
      */
     stopped: boolean;
+    resolution?: ToolResolution;
 }
 export interface RegisterMrtWatchOptions {
     project: string;
@@ -50,6 +52,7 @@ export interface RegisterMrtWatchOptions {
     tailResult: TailMrtLogsResult;
     bufferCap?: number;
     bufferBytesCap?: number;
+    resolution?: ToolResolution;
 }
 /**
  * Stable dedup key for an MRT log watch. A developer may tail several

package/dist/tools/diagnostics/mrt-logs-watch-list.js

@@ -27,6 +27,7 @@ export function createMrtLogsWatchListTool(loadServices, serverContext) {
                     stopped: w.stopped,
                     total_entries_seen: w.totalEntriesSeen,
                     watch_id: w.watchId,
+                    resolution: w.resolution,
                 })),
             };
         },

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

@@ -113,7 +113,13 @@ export function createMrtLogsWatchStartTool(loadServices, serverContext, injecti
             // exit).
             let entry;
             try {
-                entry = registry.registerWatch({ project, environment, origin, tailResult });
+                entry = registry.registerWatch({
+                    project,
+                    environment,
+                    origin,
+                    tailResult,
+                    resolution: structuredClone(context.resolution),
+                });
             }
             catch (error) {
                 tailResult.stop();

package/dist/tools/diagnostics/session-registry.d.ts

@@ -1,6 +1,7 @@
 import type { DebugSessionManager, SourceMapper, SdapiBreakpoint, SdapiScriptThread } from '@salesforce/b2c-tooling-sdk/operations/debug';
 import type { CartridgeMapping } from '@salesforce/b2c-tooling-sdk/operations/code';
 import type { ToolExecutionContext } from '../adapter.js';
+import type { ToolResolution } from '../project-context.js';
 export interface HaltWaiter {
     resolve: (thread: SdapiScriptThread) => void;
     reject: (error: Error) => void;
@@ -17,6 +18,7 @@ export interface DebugSessionEntry {
     haltWaiters: HaltWaiter[];
     createdAt: number;
     lastActivityAt: number;
+    resolution?: ToolResolution;
 }
 export interface RegisterSessionOptions {
     hostname: string;
@@ -24,6 +26,7 @@ export interface RegisterSessionOptions {
     manager: DebugSessionManager;
     sourceMapper: SourceMapper;
     cartridges: CartridgeMapping[];
+    resolution?: ToolResolution;
 }
 export declare class DebugSessionRegistry {
     private cleanupTimer;

package/dist/tools/diagnostics/session-registry.js

@@ -64,7 +64,7 @@ export class DebugSessionRegistry {
         return [...this.sessions.values()];
     }
     registerSession(opts) {
-        const { hostname, clientId, manager, sourceMapper, cartridges } = opts;
+        const { hostname, clientId, manager, sourceMapper, cartridges, resolution } = opts;
         const existing = this.findByHostAndClientId(hostname, clientId);
         if (existing) {
             throw new Error(`A debug session already exists for ${hostname} ` +
@@ -84,6 +84,7 @@ export class DebugSessionRegistry {
             haltWaiters: [],
             createdAt: now,
             lastActivityAt: now,
+            resolution,
         };
         this.sessions.set(sessionId, entry);
         return entry;

package/dist/tools/index.d.ts

@@ -14,4 +14,3 @@ export * from './docs/index.js';
 export * from './mrt/index.js';
 export * from './pwav3/index.js';
 export * from './scapi/index.js';
-export * from './storefrontnext/index.js';

package/dist/tools/index.js

@@ -21,5 +21,4 @@ export * from './docs/index.js';
 export * from './mrt/index.js';
 export * from './pwav3/index.js';
 export * from './scapi/index.js';
-export * from './storefrontnext/index.js';
 //# sourceMappingURL=index.js.map

package/dist/tools/mrt/index.js

@@ -175,6 +175,10 @@ function createMrtBundlePushTool(loadServices, injections) {
             const ssrOnly = args.ssrOnly ? parseGlobPatterns(args.ssrOnly) : defaults.ssrOnly;
             const ssrShared = args.ssrShared ? parseGlobPatterns(args.ssrShared) : defaults.ssrShared;
             const buildDirectory = context.services.resolveWithProjectDirectory(args.buildDirectory ?? defaults.buildDirectory, args.projectDirectory);
+            context.setResolvedDirectory('buildDirectory', {
+                path: buildDirectory,
+                source: args.buildDirectory ? 'argument' : 'projectDirectory',
+            });
             // Log all computed variables before pushing bundle
             const logger = getLogger();
             logger.debug({

package/dist/tools/project-context.d.ts

@@ -1,22 +1,53 @@
-import { z } from 'zod';
+import { z, type ZodRawShape } from 'zod';
 /** Input shared by MCP tools that resolve files or configuration from a project. */
 export interface ProjectContextInput {
     /** Per-call project directory override. */
     projectDirectory?: string;
-    /** Per-call explicit dw.json-format configuration path. */
+    /** Per-call explicit primary dw.json-format configuration path. */
     configPath?: string;
+    /** Per-call named instance selection. */
+    instanceName?: string;
 }
 /** Effective project directory and the source that selected it. */
 export interface ProjectDirectoryInfo {
     path: string;
     source: 'argument' | 'config' | 'cwd';
 }
-/** Shared schema field injected into every project-aware MCP tool. */
-export declare const projectDirectoryInput: z.ZodOptional<z.ZodString>;
-/** Shared explicit dw.json path field injected into every project-aware MCP tool. */
-export declare const configPathInput: z.ZodOptional<z.ZodString>;
-/** Shared schema fields injected into every project-aware MCP tool. */
-export declare const projectContextInputSchema: {
-    projectDirectory: z.ZodOptional<z.ZodString>;
-    configPath: z.ZodOptional<z.ZodString>;
-};
+/** How the selected dw.json file entered the configuration resolver. */
+export type ConfigurationResolutionSource = 'argument' | 'globalDefault' | 'none' | 'projectDirectory' | 'projectEnvironment' | 'server';
+/** Compact selected-configuration provenance returned by project-aware tools. */
+export interface ConfigurationResolutionInfo {
+    hostname?: string;
+    instanceName?: string;
+    path?: string;
+    source: ConfigurationResolutionSource;
+}
+/** Provenance for a specialized project-relative directory. */
+export interface DirectoryResolutionInfo {
+    path: string;
+    source: 'argument' | 'projectDirectory';
+}
+/** Compact, common provenance block returned by project/config-aware tools. */
+export interface ToolResolution {
+    configuration?: ConfigurationResolutionInfo;
+    directories?: Record<string, DirectoryResolutionInfo>;
+    projectDirectory: ProjectDirectoryInfo;
+}
+/** Defaults known when MCP tool schemas are registered. */
+export interface ProjectContextDefaults {
+    projectDirectory: ProjectDirectoryInfo;
+}
+/** Whether a tool needs only a project root or full configuration selection. */
+export type ProjectContextKind = 'configuration' | 'project';
+/** Build the canonical project-directory field with the effective fallback embedded in its description. */
+export declare function createProjectDirectoryInput(defaults?: ProjectContextDefaults): z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+/** Build the canonical explicit primary dw.json field. */
+export declare function createConfigPathInput(): z.ZodOptional<z.ZodString>;
+/** Build the canonical named-instance selection field. */
+export declare function createInstanceNameInput(): z.ZodOptional<z.ZodString>;
+/** Build flat canonical schema fields for a local-project or configuration-aware tool. */
+export declare function createProjectContextInputSchema(kind: ProjectContextKind, defaults?: ProjectContextDefaults): ZodRawShape;
+/** Static field for schemas declared outside the shared adapter. */
+export declare const projectDirectoryInput: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+/** Static configuration schema for legacy/manual tool definitions. */
+export declare const projectContextInputSchema: z.ZodRawShape;

package/dist/tools/project-context.js

@@ -3,20 +3,53 @@
  * 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 path from 'node:path';
 import { z } from 'zod';
-/** Shared schema field injected into every project-aware MCP tool. */
-export const projectDirectoryInput = z
-    .string()
-    .optional()
-    .describe('Absolute project directory for this call. Overrides --project-directory / SFCC_PROJECT_DIRECTORY and the MCP process working directory. Also controls project-local configuration discovery.');
-/** Shared explicit dw.json path field injected into every project-aware MCP tool. */
-export const configPathInput = z
-    .string()
-    .optional()
-    .describe('Explicit path to a dw.json-format configuration file for this call. Overrides startup --config / SFCC_CONFIG and project .env SFCC_CONFIG. Relative paths resolve from projectDirectory.');
-/** Shared schema fields injected into every project-aware MCP tool. */
-export const projectContextInputSchema = {
-    projectDirectory: projectDirectoryInput,
-    configPath: configPathInput,
-};
+function defaultProjectContext() {
+    return { projectDirectory: { path: process.cwd(), source: 'cwd' } };
+}
+/** Build the canonical project-directory field with the effective fallback embedded in its description. */
+export function createProjectDirectoryInput(defaults = defaultProjectContext()) {
+    const fallback = defaults.projectDirectory;
+    const sourceDescription = fallback.source === 'cwd'
+        ? 'the MCP process working directory'
+        : 'the server-level --project-directory / SFCC_PROJECT_DIRECTORY value';
+    return z
+        .string()
+        .refine((value) => path.isAbsolute(value), 'projectDirectory must be an absolute path')
+        .optional()
+        .describe(`Optional absolute project root for this call. Overrides the server-level project directory. ` +
+        `When omitted, uses ${sourceDescription}: ${fallback.path}`);
+}
+/** Build the canonical explicit primary dw.json field. */
+export function createConfigPathInput() {
+    return z
+        .string()
+        .optional()
+        .describe('Optional path to a dw.json-format configuration file. Relative paths resolve from projectDirectory. ' +
+        'Selects the primary file ahead of server and project automatic selection; the shared default dw.json remains available as a fallback and for named-instance lookup.');
+}
+/** Build the canonical named-instance selection field. */
+export function createInstanceNameInput() {
+    return z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Optional named instance to select from the resolved primary and default dw.json files. The primary file is searched first. When omitted, the active/default instance is used.');
+}
+/** Build flat canonical schema fields for a local-project or configuration-aware tool. */
+export function createProjectContextInputSchema(kind, defaults = defaultProjectContext()) {
+    const project = { projectDirectory: createProjectDirectoryInput(defaults) };
+    if (kind === 'project')
+        return project;
+    return {
+        ...project,
+        configPath: createConfigPathInput(),
+        instanceName: createInstanceNameInput(),
+    };
+}
+/** Static field for schemas declared outside the shared adapter. */
+export const projectDirectoryInput = createProjectDirectoryInput();
+/** Static configuration schema for legacy/manual tool definitions. */
+export const projectContextInputSchema = createProjectContextInputSchema('configuration');
 //# sourceMappingURL=project-context.js.map

package/dist/tools/scapi/metrics-get.js

@@ -63,7 +63,7 @@ Retrieve observability metrics time-series for a B2C Commerce tenant. Returns me
         toolsets: ['SCAPI'],
         isGA: false,
         requiresInstance: false, // SCAPI uses OAuth directly
-        usesProjectContext: true,
+        usesConfigurationContext: true,
         inputSchema: {
             category: z
                 .enum(['overall', 'sales', 'ecdn', 'third-party', 'scapi', 'scapi-hooks', 'mrt', 'controller', 'ocapi'])

package/dist/tools/scapi/scapi-custom-api-generate-scaffold.d.ts

@@ -23,8 +23,12 @@ interface ScaffoldCustomApiInput extends ProjectContextInput {
     /** Short description of the API. Default: "A custom B2C Commerce API" */
     apiDescription?: string;
     /** Project root for cartridge discovery and output. Default: MCP project directory */
+    cartridgeDirectory?: string;
+    /** @deprecated Use cartridgeDirectory. */
     projectRoot?: string;
     /** Output directory override. Default: scaffold default or project root */
+    outputDirectory?: string;
+    /** @deprecated Use outputDirectory. */
     outputDir?: string;
 }
 /**

package/dist/tools/scapi/scapi-custom-api-generate-scaffold.js

@@ -22,7 +22,7 @@ const CUSTOM_API_SCAFFOLD_ID = 'custom-api';
  */
 export async function executeScaffoldCustomApi(args, services, overrides) {
     const projectDirectory = services.resolveProjectDirectory(args.projectDirectory);
-    const projectRoot = services.resolveWithProjectDirectory(args.projectRoot, args.projectDirectory);
+    const projectRoot = services.resolveWithProjectDirectory(args.cartridgeDirectory ?? args.projectRoot, args.projectDirectory);
     const getScaffold = overrides?.getScaffold ??
         (async (id, opts) => {
             const registry = createScaffoldRegistry();
@@ -96,7 +96,7 @@ export async function executeScaffoldCustomApi(args, services, overrides) {
         };
     }
     const outputDir = resolveOutputDirectory({
-        outputDir: args.outputDir,
+        outputDir: args.outputDirectory ?? args.outputDir,
         scaffold,
         projectRoot,
     });
@@ -149,7 +149,7 @@ export function createScaffoldCustomApiTool(loadServices, executeOverrides) {
         name: 'scapi_custom_api_generate_scaffold',
         description: `Generate a new custom SCAPI endpoint (OAS 3.0 schema, api.json, script.js) in an existing cartridge. \
 Required: apiName (kebab-case). Optional: cartridgeName (defaults to first cartridge found in project), apiType (shopper|admin) default to shopper, \
-apiDescription, projectRoot, outputDir.`,
+apiDescription, cartridgeDirectory, outputDirectory.`,
         toolsets: ['PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
         isGA: true,
         requiresInstance: false,
@@ -169,14 +169,34 @@ apiDescription, projectRoot, outputDir.`,
                 .optional()
                 .describe('Admin (no siteId) or shopper (siteId, customer-facing). Default: shopper'),
             apiDescription: z.string().optional().describe('Short description of the API.'),
+            cartridgeDirectory: z
+                .string()
+                .nullish()
+                .describe('Optional cartridge discovery root, resolved relative to projectDirectory. Defaults to projectDirectory.'),
             projectRoot: z
                 .string()
                 .nullish()
-                .describe('Optional cartridge discovery/output root, resolved relative to projectDirectory. Defaults to projectDirectory.'),
-            outputDir: z.string().optional().describe('Output directory override. Default: project root'),
+                .describe('Deprecated alias for cartridgeDirectory. cartridgeDirectory takes precedence.'),
+            outputDirectory: z
+                .string()
+                .optional()
+                .describe('Optional output directory. Relative paths resolve from cartridgeDirectory.'),
+            outputDir: z
+                .string()
+                .optional()
+                .describe('Deprecated alias for outputDirectory. outputDirectory takes precedence.'),
         },
-        async execute(args, { services }) {
-            return executeScaffoldCustomApi(args, services, executeOverrides);
+        async execute(args, context) {
+            const output = await executeScaffoldCustomApi(args, context.services, executeOverrides);
+            context.setResolvedDirectory('cartridgeDirectory', {
+                path: output.projectRoot,
+                source: args.cartridgeDirectory || args.projectRoot ? 'argument' : 'projectDirectory',
+            });
+            context.setResolvedDirectory('outputDirectory', {
+                path: output.outputDir,
+                source: args.outputDirectory || args.outputDir ? 'argument' : 'projectDirectory',
+            });
+            return output;
         },
         formatOutput(output) {
             if (output.error) {

package/dist/tools/scapi/scapi-custom-apis-get-status.js

@@ -94,7 +94,7 @@ CLI: b2c scapi custom status`,
         toolsets: ['PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
         isGA: true,
         requiresInstance: false,
-        usesProjectContext: true,
+        usesConfigurationContext: true,
         inputSchema: {
             status: z.enum(['active', 'not_registered']).optional().describe('Filter by status. Omit for all.'),
             groupBy: z.enum(['site', 'type']).optional().describe('Group by siteId or type (Admin/Shopper).'),

package/dist/tools/scapi/scapi-schemas-list.js

@@ -199,6 +199,7 @@ export function createScapiSchemasListTool(loadServices) {
         toolsets: ['PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
         isGA: true,
         requiresInstance: false, // SCAPI uses OAuth directly, doesn't need B2CInstance (hostname)
+        usesConfigurationContext: true,
         inputSchema: {
             apiFamily: z.string().optional().describe('API family (e.g., "checkout", "product", "custom").'),
             apiName: z.string().optional().describe('API name (e.g., "shopper-baskets", "shopper-products").'),

package/dist/utils/constants.d.ts

@@ -5,22 +5,11 @@ export declare const ALL_TOOLSETS = "ALL";
 /**
  * Available toolsets that can be enabled.
  */
-export declare const TOOLSETS: readonly ["CARTRIDGES", "DIAGNOSTICS", "MRT", "PWAV3", "SCAPI", "STOREFRONTNEXT", "STOREFRONTNEXT_DEPRECATED"];
-/**
- * Deprecated toolsets. These can only be enabled by explicitly naming them via
- * `--toolsets`; they are never auto-activated by project detection and are NOT
- * included when `--toolsets ALL` is used.
- *
- * `STOREFRONTNEXT_DEPRECATED` holds the legacy `sfnext_*` MCP tools. They are
- * superseded by the `storefront-next` and `storefront-next-figma` agent-skills
- * plugins and are not compatible with the Storefront Next 1.0 GA release. They
- * will be removed in a future release.
- */
-export declare const DEPRECATED_TOOLSETS: readonly ["STOREFRONTNEXT_DEPRECATED"];
+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", "DIAGNOSTICS", "MRT", "PWAV3", "SCAPI", "STOREFRONTNEXT", "STOREFRONTNEXT_DEPRECATED"];
+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,26 +10,7 @@ export const ALL_TOOLSETS = 'ALL';
 /**
  * Available toolsets that can be enabled.
  */
-export const TOOLSETS = [
-    'CARTRIDGES',
-    'DIAGNOSTICS',
-    'MRT',
-    'PWAV3',
-    'SCAPI',
-    'STOREFRONTNEXT',
-    'STOREFRONTNEXT_DEPRECATED',
-];
-/**
- * Deprecated toolsets. These can only be enabled by explicitly naming them via
- * `--toolsets`; they are never auto-activated by project detection and are NOT
- * included when `--toolsets ALL` is used.
- *
- * `STOREFRONTNEXT_DEPRECATED` holds the legacy `sfnext_*` MCP tools. They are
- * superseded by the `storefront-next` and `storefront-next-figma` agent-skills
- * plugins and are not compatible with the Storefront Next 1.0 GA release. They
- * will be removed in a future release.
- */
-export const DEPRECATED_TOOLSETS = ['STOREFRONTNEXT_DEPRECATED'];
+export const TOOLSETS = ['CARTRIDGES', 'DIAGNOSTICS', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'];
 /**
  * Valid toolset names including the special "ALL" value.
  */

package/oclif.manifest.json

@@ -388,7 +388,7 @@
           "type": "boolean"
         },
         "toolsets": {
-          "description": "Toolsets to enable (comma-separated). Options: all, CARTRIDGES, DIAGNOSTICS, MRT, PWAV3, SCAPI, STOREFRONTNEXT, STOREFRONTNEXT_DEPRECATED",
+          "description": "Toolsets to enable (comma-separated). Options: all, CARTRIDGES, DIAGNOSTICS, MRT, PWAV3, SCAPI, STOREFRONTNEXT",
           "env": "SFCC_TOOLSETS",
           "name": "toolsets",
           "hasDynamicHelp": false,
@@ -429,5 +429,5 @@
       "enableJsonFlag": false
     }
   },
-  "version": "2.0.0"
+  "version": "2.1.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/b2c-dx-mcp",
   "description": "MCP server for B2C Commerce developer experience tools",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "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.24.0"
+    "@salesforce/b2c-tooling-sdk": "1.24.1"
   },
   "devDependencies": {
     "@eslint/compat": "^1",
@@ -126,7 +126,7 @@
     "test": "c8 mocha --forbid-only --ignore \"test/e2e/**\" \"test/**/*.test.ts\"",
     "test:ci": "c8 mocha --forbid-only --reporter json --reporter-option output=test-results.json --ignore \"test/e2e/**\" \"test/**/*.test.ts\"",
     "test:ci:win": "c8 --check-coverage=false mocha --forbid-only --reporter json --reporter-option output=test-results.json --ignore \"test/e2e/**\" \"test/**/*.test.ts\"",
-    "test:agent": "mocha --forbid-only --reporter min --ignore \"test/e2e/**\" \"test/**/*.test.ts\"",
+    "test:agent": "pnpm run pretest && mocha --forbid-only --reporter min --ignore \"test/e2e/**\" \"test/**/*.test.ts\"",
     "test:e2e": "mocha --forbid-only \"test/e2e/**/*.test.ts\"",
     "test:e2e:ci": "mocha --forbid-only --reporter json --reporter-option output=test-results-e2e.json \"test/e2e/**/*.test.ts\"",
     "coverage": "c8 report",