@salesforce/b2c-dx-mcp 0.4.13 → 0.4.14

package/dist/commands/mcp.d.ts

@@ -81,7 +81,7 @@ export default class McpServerCommand extends BaseCommand<typeof McpServerComman
      * 3. dw.json file (via --config flag or auto-discovered from --project-directory)
      * 4. ~/.mobify file (for MRT API key)
      */
-    protected loadConfiguration(): ResolvedB2CConfig;
+    protected loadConfiguration(): Promise<ResolvedB2CConfig>;
     /**
      * Loads configuration and creates a new Services instance.
      *
@@ -91,7 +91,7 @@ export default class McpServerCommand extends BaseCommand<typeof McpServerComman
      *
      * @returns A new Services instance with loaded configuration
      */
-    protected loadServices(): Services;
+    protected loadServices(): Promise<Services>;
     /**
      * Main entry point - starts the MCP server.
      *

package/dist/commands/mcp.js

@@ -236,7 +236,7 @@ export default class McpServerCommand extends BaseCommand {
      * 3. dw.json file (via --config flag or auto-discovered from --project-directory)
      * 4. ~/.mobify file (for MRT API key)
      */
-    loadConfiguration() {
+    async loadConfiguration() {
         const mrt = extractMrtFlags(this.flags);
         const options = {
             ...this.getBaseConfigOptions(),
@@ -258,8 +258,8 @@ export default class McpServerCommand extends BaseCommand {
      *
      * @returns A new Services instance with loaded configuration
      */
-    loadServices() {
-        const config = this.loadConfiguration();
+    async loadServices() {
+        const config = await this.loadConfiguration();
         return Services.fromResolvedConfig(config);
     }
     /**

package/dist/registry.d.ts

@@ -14,7 +14,7 @@ export type ToolRegistry = Record<Toolset, McpTool[]>;
  * @param loadServices - Function that loads configuration and returns Services instance
  * @returns Complete tool registry
  */
-export declare function createToolRegistry(loadServices: () => Services): ToolRegistry;
+export declare function createToolRegistry(loadServices: () => Promise<Services> | Services): ToolRegistry;
 /**
  * Register tools with the MCP server based on startup flags.
  *
@@ -34,4 +34,4 @@ export declare function createToolRegistry(loadServices: () => Services): ToolRe
  * @param server - B2CDxMcpServer instance
  * @param loadServices - Function that loads configuration and returns Services instance
  */
-export declare function registerToolsets(flags: StartupFlags, server: B2CDxMcpServer, loadServices: () => Services): Promise<void>;
+export declare function registerToolsets(flags: StartupFlags, server: B2CDxMcpServer, loadServices: () => Promise<Services> | Services): Promise<void>;

package/dist/tools/adapter.d.ts

@@ -206,4 +206,4 @@ export declare function jsonResult(data: unknown, indent?: number): ToolResult;
  * }, loadServices);
  * ```
  */
-export declare function createToolAdapter<TInput, TOutput>(options: ToolAdapterOptions<TInput, TOutput>, loadServices: () => Services): McpTool;
+export declare function createToolAdapter<TInput, TOutput>(options: ToolAdapterOptions<TInput, TOutput>, loadServices: () => Promise<Services> | Services): McpTool;

package/dist/tools/adapter.js

@@ -187,7 +187,7 @@ export function createToolAdapter(options, loadServices) {
             const args = parseResult.data;
             try {
                 // 2. Load Services to get fresh configuration (re-reads config files)
-                const services = loadServices();
+                const services = await loadServices();
                 // 3. Get B2CInstance if required (loaded on each call)
                 let b2cInstance;
                 if (requiresInstance) {

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

@@ -18,5 +18,5 @@ interface CartridgeToolInjections {
  * @param injections - Optional dependency injections for testing
  * @returns Array of MCP tools
  */
-export declare function createCartridgesTools(loadServices: () => Services, injections?: CartridgeToolInjections): McpTool[];
+export declare function createCartridgesTools(loadServices: () => Promise<Services> | Services, injections?: CartridgeToolInjections): McpTool[];
 export {};

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

@@ -21,5 +21,5 @@ interface MrtToolInjections {
  * @param injections - Optional dependency injections for testing
  * @returns Array of MCP tools
  */
-export declare function createMrtTools(loadServices: () => Services, injections?: MrtToolInjections): McpTool[];
+export declare function createMrtTools(loadServices: () => Promise<Services> | Services, injections?: MrtToolInjections): McpTool[];
 export {};

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

@@ -19,4 +19,4 @@ import type { Services } from '../../services.js';
  * @param loadServices - Function that loads configuration and returns Services instance
  * @returns Array of MCP tools
  */
-export declare function createPwav3Tools(loadServices: () => Services): McpTool[];
+export declare function createPwav3Tools(loadServices: () => Promise<Services> | Services): McpTool[];

package/dist/tools/pwav3/pwa-kit-development-guidelines.d.ts

@@ -6,4 +6,4 @@ import type { Services } from '../../services.js';
  * @param loadServices - Function that loads configuration and returns Services instance
  * @returns The configured MCP tool
  */
-export declare function createDeveloperGuidelinesTool(loadServices: () => Services): McpTool;
+export declare function createDeveloperGuidelinesTool(loadServices: () => Promise<Services> | Services): McpTool;

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

@@ -14,4 +14,4 @@ import type { Services } from '../../services.js';
  * @param loadServices - Function that loads configuration and returns Services instance
  * @returns Array of MCP tools
  */
-export declare function createScapiTools(loadServices: () => Services): McpTool[];
+export declare function createScapiTools(loadServices: () => Promise<Services> | Services): McpTool[];

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

@@ -56,5 +56,5 @@ export declare function executeScaffoldCustomApi(args: ScaffoldCustomApiInput, s
  * @param loadServices - Function that returns Services (used by adapter on each call).
  * @param executeOverrides - Optional overrides for testing (getScaffold, resolveScaffoldParameters).
  */
-export declare function createScaffoldCustomApiTool(loadServices: () => Services, executeOverrides?: ScaffoldCustomApiExecuteOverrides): McpTool;
+export declare function createScaffoldCustomApiTool(loadServices: () => Promise<Services> | Services, executeOverrides?: ScaffoldCustomApiExecuteOverrides): McpTool;
 export {};

package/dist/tools/scapi/scapi-custom-apis-status.d.ts

@@ -6,4 +6,4 @@ import type { McpTool } from '../../utils/index.js';
  * Mirrors CLI: b2c scapi custom status. All flags supported; agent chooses what to use.
  * See: https://salesforcecommercecloud.github.io/b2c-developer-tooling/cli/custom-apis.html#b2c-scapi-custom-status
  */
-export declare function createScapiCustomApisStatusTool(loadServices: () => Services): McpTool;
+export declare function createScapiCustomApisStatusTool(loadServices: () => Promise<Services> | Services): McpTool;

package/dist/tools/scapi/scapi-schemas-list.d.ts

@@ -9,4 +9,4 @@ import type { McpTool } from '../../utils/index.js';
  * @param loadServices - Function that loads configuration and returns Services instance
  * @returns MCP tool for listing/fetching SCAPI schemas
  */
-export declare function createScapiSchemasListTool(loadServices: () => Services): McpTool;
+export declare function createScapiSchemasListTool(loadServices: () => Promise<Services> | Services): McpTool;

package/dist/tools/storefrontnext/figma/figma-to-component/index.d.ts

@@ -39,4 +39,4 @@ export declare function generateWorkflowResponse(figmaUrl: string, workflowFileP
  * @param loadServices - Function that loads configuration and returns Services instance
  * @returns MCP tool for workflow orchestration
  */
-export declare function createFigmaToComponentTool(loadServices: () => Services): McpTool;
+export declare function createFigmaToComponentTool(loadServices: () => Promise<Services> | Services): McpTool;

package/dist/tools/storefrontnext/figma/generate-component/index.d.ts

@@ -111,4 +111,4 @@ export declare function generateComponentRecommendation(input: GenerateComponent
  * @param loadServices - Function that loads configuration and returns Services instance
  * @returns MCP tool for component analysis and recommendation
  */
-export declare function createGenerateComponentTool(loadServices: () => Services): McpTool;
+export declare function createGenerateComponentTool(loadServices: () => Promise<Services> | Services): McpTool;

package/dist/tools/storefrontnext/figma/map-tokens/index.d.ts

@@ -58,4 +58,4 @@ export declare function mapFigmaTokensToTheme(args: MapTokensToThemeInput, works
  * @param loadServices - Function that loads configuration and returns Services instance
  * @returns MCP tool for token mapping
  */
-export declare function createMapTokensToThemeTool(loadServices: () => Services): McpTool;
+export declare function createMapTokensToThemeTool(loadServices: () => Promise<Services> | Services): McpTool;

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

@@ -27,4 +27,4 @@ import type { Services } from '../../services.js';
  * @param loadServices - Function that loads configuration and returns Services instance
  * @returns Array of MCP tools
  */
-export declare function createStorefrontNextTools(loadServices: () => Services): McpTool[];
+export declare function createStorefrontNextTools(loadServices: () => Promise<Services> | Services): McpTool[];

package/dist/tools/storefrontnext/page-designer-decorator/analyzer.js

@@ -7,6 +7,21 @@ import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 import { globSync } from 'glob';
 import { Project, InterfaceDeclaration, PropertySignature } from 'ts-morph';
+/**
+ * Lazily-initialized, reusable ts-morph Project for component analysis.
+ * Creating a new Project (~40ms) on every analyzeComponent call is expensive;
+ * reusing one with an in-memory file system avoids repeated TypeScript compiler init.
+ */
+let cachedProject;
+function getProject() {
+    if (!cachedProject) {
+        cachedProject = new Project({
+            useInMemoryFileSystem: true,
+            skipAddingFilesFromTsConfig: true,
+        });
+    }
+    return cachedProject;
+}
 // ============================================================================
 // TYPE INFERENCE
 // ============================================================================
@@ -279,43 +294,45 @@ function parseComponentFile(filePath) {
             filePath,
         };
     }
-    const project = new Project({
-        useInMemoryFileSystem: true,
-        skipAddingFilesFromTsConfig: true,
-    });
-    const sourceFile = project.createSourceFile(filePath, content);
-    const interfaces = sourceFile.getInterfaces();
-    const propsInterface = interfaces.find((i) => i.getName().includes('Props'));
-    if (!propsInterface) {
+    const project = getProject();
+    const sourceFile = project.createSourceFile(filePath, content, { overwrite: true });
+    try {
+        const interfaces = sourceFile.getInterfaces();
+        const propsInterface = interfaces.find((i) => i.getName().includes('Props'));
+        if (!propsInterface) {
+            return {
+                componentName: extractComponentName(content),
+                interfaceName: null,
+                hasDecorators: false,
+                props: [],
+                exportType: detectExportType(content),
+                filePath,
+            };
+        }
+        const props = propsInterface.getProperties().map((prop) => {
+            const name = prop.getName();
+            const type = prop.getType().getText();
+            const optional = prop.hasQuestionToken();
+            return {
+                name,
+                type,
+                optional,
+                isComplex: isComplexType(type),
+                isUIOnly: isUIOnlyProp(name),
+            };
+        });
         return {
             componentName: extractComponentName(content),
-            interfaceName: null,
+            interfaceName: propsInterface.getName(),
             hasDecorators: false,
-            props: [],
+            props,
             exportType: detectExportType(content),
             filePath,
         };
     }
-    const props = propsInterface.getProperties().map((prop) => {
-        const name = prop.getName();
-        const type = prop.getType().getText();
-        const optional = prop.hasQuestionToken();
-        return {
-            name,
-            type,
-            optional,
-            isComplex: isComplexType(type),
-            isUIOnly: isUIOnlyProp(name),
-        };
-    });
-    return {
-        componentName: extractComponentName(content),
-        interfaceName: propsInterface.getName(),
-        hasDecorators: false,
-        props,
-        exportType: detectExportType(content),
-        filePath,
-    };
+    finally {
+        project.removeSourceFile(sourceFile);
+    }
 }
 // ============================================================================
 // COMPONENT ANALYZER

package/dist/tools/storefrontnext/page-designer-decorator/index.d.ts

@@ -249,4 +249,4 @@ export type PageDesignerDecoratorInput = z.infer<typeof pageDesignerDecoratorSch
  * @param loadServices - Function that loads configuration and returns Services instance
  * @returns The configured MCP tool
  */
-export declare function createPageDesignerDecoratorTool(loadServices: () => Services): McpTool;
+export declare function createPageDesignerDecoratorTool(loadServices: () => Promise<Services> | Services): McpTool;

package/dist/tools/storefrontnext/page-designer-decorator/index.js

@@ -542,7 +542,7 @@ export function createPageDesignerDecoratorTool(loadServices) {
                 const validatedArgs = pageDesignerDecoratorSchema.parse(args);
                 // Use projectDirectory from services to ensure we search in the correct project directory
                 // This prevents searches in the home folder when MCP clients spawn servers from ~
-                const services = loadServices();
+                const services = await loadServices();
                 const workspaceRoot = services.resolveWithProjectDirectory();
                 if (validatedArgs.autoMode === undefined && !validatedArgs.conversationContext) {
                     const fullPath = resolveComponent(validatedArgs.component, workspaceRoot, validatedArgs.searchPaths);

package/dist/tools/storefrontnext/sfnext-development-guidelines.d.ts

@@ -6,4 +6,4 @@ import type { Services } from '../../services.js';
  * @param loadServices - Function that loads configuration and returns Services instance
  * @returns The configured MCP tool
  */
-export declare function createDeveloperGuidelinesTool(loadServices: () => Services): McpTool;
+export declare function createDeveloperGuidelinesTool(loadServices: () => Promise<Services> | Services): McpTool;

package/dist/tools/storefrontnext/site-theming/index.d.ts

@@ -11,4 +11,4 @@ export type { ColorEntry, ColorMapping, CollectedAnswers, ConversationContext, F
  * @param loadServices - Function that loads configuration and returns Services instance
  * @returns The configured MCP tool
  */
-export declare function createSiteThemingTool(loadServices: () => Services): McpTool;
+export declare function createSiteThemingTool(loadServices: () => Promise<Services> | Services): McpTool;

package/oclif.manifest.json

@@ -390,5 +390,5 @@
       "enableJsonFlag": false
     }
   },
-  "version": "0.4.13"
+  "version": "0.4.14"
 }

package/package.json

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