sfcc-dev-mcp 1.0.15 → 1.0.19

package/dist/core/handlers/base-handler.d.ts

@@ -1,5 +1,6 @@
 import { Logger } from '../../utils/logger.js';
 import { SFCCConfig } from '../../types/types.js';
+import { WorkspaceRootsService } from '../../config/workspace-roots.js';
 export interface HandlerContext {
     logger: Logger;
     config: SFCCConfig;
@@ -7,6 +8,7 @@ export interface HandlerContext {
         canAccessLogs: boolean;
         canAccessOCAPI: boolean;
     };
+    workspaceRootsService?: WorkspaceRootsService;
 }
 export interface ToolExecutionResult {
     content: Array<{
@@ -19,29 +21,20 @@ export interface ToolArguments {
     [key: string]: any;
 }
 /**
- * Generic tool specification interface
- * Defines the contract for declarative tool configuration
+ * Generic tool specification interface for declarative tool configuration
  */
 export interface GenericToolSpec<TArgs = ToolArguments, TResult = any> {
-    /** Optional validation function for tool arguments */
     validate?: (args: TArgs, toolName: string) => void;
-    /** Optional function to apply default values to arguments */
     defaults?: (args: TArgs) => Partial<TArgs>;
-    /** Main execution function for the tool */
     exec: (args: TArgs, context: ToolExecutionContext) => Promise<TResult>;
-    /** Function to generate log message for the tool execution */
     logMessage: (args: TArgs) => string;
 }
 /**
  * Context provided to tool execution functions
- * Allows tools to access clients and other resources
  */
 export interface ToolExecutionContext {
-    /** Handler context with configuration and capabilities */
     handlerContext: HandlerContext;
-    /** Logger instance for the handler */
     logger: any;
-    /** Additional context data that can be provided by concrete handlers */
     [key: string]: any;
 }
 export declare class HandlerError extends Error {
@@ -55,78 +48,20 @@ export declare abstract class BaseToolHandler<TToolName extends string = string>
     protected logger: Logger;
     private _isInitialized;
     constructor(context: HandlerContext, subLoggerName: string);
-    /**
-     * Abstract method to get tool configuration
-     * Each concrete handler implements this with their specific config
-     */
     protected abstract getToolConfig(): Record<TToolName, GenericToolSpec>;
-    /**
-     * Abstract method to get tool name set for O(1) lookup
-     * Each concrete handler implements this with their specific tool set
-     */
     protected abstract getToolNameSet(): Set<string>;
-    /**
-     * Abstract method to create execution context
-     * Each concrete handler can provide specialized context
-     */
     protected abstract createExecutionContext(): Promise<ToolExecutionContext>;
-    /**
-     * Check if this handler can handle the given tool
-     */
     canHandle(toolName: string): boolean;
-    /**
-     * Config-driven tool execution
-     * Handles validation, defaults, execution, and logging uniformly
-     */
     handle(toolName: string, args: ToolArguments, startTime: number): Promise<ToolExecutionResult>;
-    /**
-     * Generic tool dispatch using configuration
-     * Handles validation, defaults, and execution
-     */
     private dispatchTool;
-    /**
-     * Apply default values to arguments
-     */
     private applyDefaults;
-    /**
-     * Create validated arguments with defaults applied
-     */
-    private createValidatedArgs;
-    /**
-     * Initialize the handler (lazy initialization)
-     */
     protected initialize(): Promise<void>;
-    /**
-     * Override this method for custom initialization logic
-     */
     protected onInitialize(): Promise<void>;
-    /**
-     * Clean up resources when handler is destroyed
-     */
     dispose(): Promise<void>;
-    /**
-     * Override this method for custom cleanup logic
-     */
     protected onDispose(): Promise<void>;
-    /**
-     * Validate required arguments
-     */
     protected validateArgs(args: ToolArguments, required: string[], toolName: string): void;
-    /**
-     * Create a standardized response
-     */
     protected createResponse(data: any, stringify?: boolean): ToolExecutionResult;
-    /**
-     * Create an error response
-     */
     protected createErrorResponse(error: Error, toolName: string): ToolExecutionResult;
-    /**
-     * Execute a tool operation with standardized logging and error handling
-     */
     protected executeWithLogging(toolName: string, startTime: number, operation: () => Promise<any>, logMessage?: string): Promise<ToolExecutionResult>;
-    /**
-     * @deprecated Use executeWithLogging instead
-     */
-    protected wrap(toolName: string, startTime: number, fn: () => Promise<any>, logMessage?: string): Promise<ToolExecutionResult>;
 }
 //# sourceMappingURL=base-handler.d.ts.map

package/dist/core/handlers/base-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/base-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/base-handler.ts"],"names":[],"mappings":"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"}

package/dist/core/handlers/base-handler.js

@@ -19,61 +19,30 @@ export class BaseToolHandler {
         this.context = context;
         this.logger = Logger.getChildLogger(`Handler:${subLoggerName}`);
     }
-    /**
-     * Check if this handler can handle the given tool
-     */
     canHandle(toolName) {
         return this.getToolNameSet().has(toolName);
     }
-    /**
-     * Config-driven tool execution
-     * Handles validation, defaults, execution, and logging uniformly
-     */
     async handle(toolName, args, startTime) {
         if (!this.canHandle(toolName)) {
             throw new Error(`Unsupported tool: ${toolName}`);
         }
-        const toolConfig = this.getToolConfig();
-        const spec = toolConfig[toolName];
+        const spec = this.getToolConfig()[toolName];
         if (!spec) {
             throw new Error(`No configuration found for tool: ${toolName}`);
         }
         return this.executeWithLogging(toolName, startTime, () => this.dispatchTool(spec, args), spec.logMessage(this.applyDefaults(spec, args)));
     }
-    /**
-     * Generic tool dispatch using configuration
-     * Handles validation, defaults, and execution
-     */
     async dispatchTool(spec, args) {
         const context = await this.createExecutionContext();
-        const processedArgs = this.createValidatedArgs(spec, args, 'tool');
-        return spec.exec(processedArgs, context);
-    }
-    /**
-     * Apply default values to arguments
-     */
-    applyDefaults(spec, args) {
-        if (!spec.defaults) {
-            return args;
-        }
-        const defaults = spec.defaults(args);
-        return { ...args, ...defaults };
-    }
-    /**
-     * Create validated arguments with defaults applied
-     */
-    createValidatedArgs(spec, args, toolName) {
-        // Apply defaults first
         const processedArgs = this.applyDefaults(spec, args);
-        // Validate if validator exists
         if (spec.validate) {
-            spec.validate(processedArgs, toolName);
+            spec.validate(processedArgs, 'tool');
         }
-        return processedArgs;
+        return spec.exec(processedArgs, context);
+    }
+    applyDefaults(spec, args) {
+        return spec.defaults ? { ...args, ...spec.defaults(args) } : args;
     }
-    /**
-     * Initialize the handler (lazy initialization)
-     */
     async initialize() {
         if (this._isInitialized) {
             return;
@@ -81,28 +50,12 @@ export class BaseToolHandler {
         await this.onInitialize();
         this._isInitialized = true;
     }
-    /**
-     * Override this method for custom initialization logic
-     */
-    async onInitialize() {
-        // Default: no-op
-    }
-    /**
-     * Clean up resources when handler is destroyed
-     */
+    async onInitialize() { }
     async dispose() {
         await this.onDispose();
         this._isInitialized = false;
     }
-    /**
-     * Override this method for custom cleanup logic
-     */
-    async onDispose() {
-        // Default: no-op
-    }
-    /**
-     * Validate required arguments
-     */
+    async onDispose() { }
     validateArgs(args, required, toolName) {
         for (const field of required) {
             if (!args?.[field]) {
@@ -110,37 +63,19 @@ export class BaseToolHandler {
             }
         }
     }
-    /**
-     * Create a standardized response
-     */
     createResponse(data, stringify = true) {
         return {
-            content: [
-                { type: 'text', text: stringify ? JSON.stringify(data, null, 2) : data },
-            ],
+            content: [{ type: 'text', text: stringify ? JSON.stringify(data, null, 2) : data }],
             isError: false,
         };
     }
-    /**
-     * Create an error response
-     */
     createErrorResponse(error, toolName) {
         this.logger.error(`Error in ${toolName}:`, error);
         return {
-            content: [
-                {
-                    type: 'text',
-                    text: error instanceof HandlerError
-                        ? `Error: ${error.message}`
-                        : `Error: ${error.message}`,
-                },
-            ],
+            content: [{ type: 'text', text: `Error: ${error.message}` }],
             isError: true,
         };
     }
-    /**
-     * Execute a tool operation with standardized logging and error handling
-     */
     async executeWithLogging(toolName, startTime, operation, logMessage) {
         try {
             await this.initialize();
@@ -149,11 +84,9 @@ export class BaseToolHandler {
             }
             const result = await operation();
             this.logger.timing(toolName, startTime);
-            // Log result metadata for debugging
-            this.logger.debug(`${toolName} completed successfully`, {
+            this.logger.debug(`${toolName} completed`, {
                 resultType: typeof result,
                 resultLength: Array.isArray(result) ? result.length : undefined,
-                hasData: result != null,
             });
             return this.createResponse(result);
         }
@@ -162,11 +95,5 @@ export class BaseToolHandler {
             return this.createErrorResponse(error, toolName);
         }
     }
-    /**
-     * @deprecated Use executeWithLogging instead
-     */
-    async wrap(toolName, startTime, fn, logMessage) {
-        return this.executeWithLogging(toolName, startTime, fn, logMessage);
-    }
 }
 //# sourceMappingURL=base-handler.js.map

package/dist/core/handlers/base-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/base-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/base-handler.ts"],"names":[],"mappings":"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"}

package/dist/core/handlers/cartridge-handler.d.ts

@@ -1,18 +1,17 @@
-import { BaseToolHandler, ToolExecutionContext, GenericToolSpec, HandlerContext, ToolArguments } from './base-handler.js';
+import { GenericToolSpec, ToolArguments, HandlerContext } from './base-handler.js';
+import { AbstractClientHandler } from './abstract-client-handler.js';
+import { CartridgeGenerationClient } from '../../clients/cartridge/index.js';
 import { CartridgeToolName } from '../../tool-configs/cartridge-tool-config.js';
 /**
- * Handler for cartridge generation tools using config-driven dispatch
- * Provides automated cartridge structure creation with complete project setup
+ * Handler for cartridge generation tools using config-driven dispatch.
+ * Provides automated cartridge structure creation with complete project setup.
  */
-export declare class CartridgeToolHandler extends BaseToolHandler<CartridgeToolName> {
-    private cartridgeClient;
-    private clientFactory;
+export declare class CartridgeToolHandler extends AbstractClientHandler<CartridgeToolName, CartridgeGenerationClient> {
     constructor(context: HandlerContext, subLoggerName: string);
-    protected onInitialize(): Promise<void>;
-    protected onDispose(): Promise<void>;
-    canHandle(toolName: string): boolean;
+    protected createClient(): CartridgeGenerationClient;
+    protected getClientContextKey(): string;
+    protected getClientDisplayName(): string;
     protected getToolNameSet(): Set<CartridgeToolName>;
-    protected getToolConfig(): Record<string, GenericToolSpec<ToolArguments, any>>;
-    protected createExecutionContext(): Promise<ToolExecutionContext>;
+    protected getToolConfig(): Record<CartridgeToolName, GenericToolSpec<ToolArguments, any>>;
 }
 //# sourceMappingURL=cartridge-handler.d.ts.map

package/dist/core/handlers/cartridge-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cartridge-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/cartridge-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAG1H,OAAO,EAEL,iBAAiB,EAElB,MAAM,6CAA6C,CAAC;AAErD;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,eAAe,CAAC,iBAAiB,CAAC;IAC1E,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,aAAa,CAAgB;gBAEzB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM;cAK1C,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;cAO7B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpC,SAAS,CAAC,cAAc,IAAI,GAAG,CAAC,iBAAiB,CAAC;IAIlD,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;cAI9D,sBAAsB,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAWxE"}
+{"version":3,"file":"cartridge-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/cartridge-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAEL,iBAAiB,EAElB,MAAM,6CAA6C,CAAC;AAErD;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,qBAAqB,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;gBAC/F,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM;IAI1D,SAAS,CAAC,YAAY,IAAI,yBAAyB;IAInD,SAAS,CAAC,mBAAmB,IAAI,MAAM;IAIvC,SAAS,CAAC,oBAAoB,IAAI,MAAM;IAIxC,SAAS,CAAC,cAAc,IAAI,GAAG,CAAC,iBAAiB,CAAC;IAIlD,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,iBAAiB,EAAE,eAAe,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;CAG1F"}

package/dist/core/handlers/cartridge-handler.js

@@ -1,29 +1,21 @@
-import { BaseToolHandler } from './base-handler.js';
-import { ClientFactory } from './client-factory.js';
+import { AbstractClientHandler } from './abstract-client-handler.js';
 import { CARTRIDGE_TOOL_CONFIG, CARTRIDGE_TOOL_NAMES_SET, } from '../../tool-configs/cartridge-tool-config.js';
 /**
- * Handler for cartridge generation tools using config-driven dispatch
- * Provides automated cartridge structure creation with complete project setup
+ * Handler for cartridge generation tools using config-driven dispatch.
+ * Provides automated cartridge structure creation with complete project setup.
  */
-export class CartridgeToolHandler extends BaseToolHandler {
-    cartridgeClient = null;
-    clientFactory;
+export class CartridgeToolHandler extends AbstractClientHandler {
     constructor(context, subLoggerName) {
         super(context, subLoggerName);
-        this.clientFactory = new ClientFactory(context, this.logger);
     }
-    async onInitialize() {
-        if (!this.cartridgeClient) {
-            this.cartridgeClient = this.clientFactory.createCartridgeClient();
-            this.logger.debug('Cartridge generation client initialized');
-        }
+    createClient() {
+        return this.clientFactory.createCartridgeClient();
     }
-    async onDispose() {
-        this.cartridgeClient = null;
-        this.logger.debug('Cartridge generation client disposed');
+    getClientContextKey() {
+        return 'cartridgeClient';
     }
-    canHandle(toolName) {
-        return CARTRIDGE_TOOL_NAMES_SET.has(toolName);
+    getClientDisplayName() {
+        return 'Cartridge Generation';
     }
     getToolNameSet() {
         return CARTRIDGE_TOOL_NAMES_SET;
@@ -31,15 +23,5 @@ export class CartridgeToolHandler extends BaseToolHandler {
     getToolConfig() {
         return CARTRIDGE_TOOL_CONFIG;
     }
-    async createExecutionContext() {
-        if (!this.cartridgeClient) {
-            throw new Error('Cartridge generation client not initialized');
-        }
-        return {
-            handlerContext: this.context,
-            logger: this.logger,
-            cartridgeClient: this.cartridgeClient,
-        };
-    }
 }
 //# sourceMappingURL=cartridge-handler.js.map

package/dist/core/handlers/cartridge-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"cartridge-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/cartridge-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwE,MAAM,mBAAmB,CAAC;AAE1H,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,qBAAqB,EAErB,wBAAwB,GACzB,MAAM,6CAA6C,CAAC;AAErD;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,eAAkC;IAClE,eAAe,GAAqC,IAAI,CAAC;IACzD,aAAa,CAAgB;IAErC,YAAY,OAAuB,EAAE,aAAqB;QACxD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9B,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IAES,KAAK,CAAC,YAAY;QAC1B,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,aAAa,CAAC,qBAAqB,EAAE,CAAC;YAClE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAES,KAAK,CAAC,SAAS;QACvB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC5D,CAAC;IAED,SAAS,CAAC,QAAgB;QACxB,OAAO,wBAAwB,CAAC,GAAG,CAAC,QAA6B,CAAC,CAAC;IACrE,CAAC;IAES,cAAc;QACtB,OAAO,wBAAwB,CAAC;IAClC,CAAC;IAES,aAAa;QACrB,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAES,KAAK,CAAC,sBAAsB;QACpC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,OAAO;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"cartridge-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/cartridge-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EACL,qBAAqB,EAErB,wBAAwB,GACzB,MAAM,6CAA6C,CAAC;AAErD;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,qBAAmE;IAC3G,YAAY,OAAuB,EAAE,aAAqB;QACxD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChC,CAAC;IAES,YAAY;QACpB,OAAO,IAAI,CAAC,aAAa,CAAC,qBAAqB,EAAE,CAAC;IACpD,CAAC;IAES,mBAAmB;QAC3B,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAES,oBAAoB;QAC5B,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAES,cAAc;QACtB,OAAO,wBAAwB,CAAC;IAClC,CAAC;IAES,aAAa;QACrB,OAAO,qBAAqB,CAAC;IAC/B,CAAC;CACF"}

package/dist/core/handlers/client-factory.d.ts

@@ -2,7 +2,8 @@ import { HandlerContext } from './base-handler.js';
 import { SFCCLogClient } from '../../clients/log-client.js';
 import { OCAPIClient } from '../../clients/ocapi-client.js';
 import { OCAPICodeVersionsClient } from '../../clients/ocapi/code-versions-client.js';
-import { CartridgeGenerationClient } from '../../clients/cartridge-generation-client.js';
+import { CartridgeGenerationClient } from '../../clients/cartridge/index.js';
+import { ScriptDebuggerClient } from '../../clients/script-debugger/index.js';
 import { Logger } from '../../utils/logger.js';
 import { IFileSystemService, IPathService } from '../../services/index.js';
 /**
@@ -33,9 +34,18 @@ export declare class ClientFactory {
      * Create a Cartridge Generation Client with injected dependencies
      */
     createCartridgeClient(fileSystemService?: IFileSystemService, pathService?: IPathService): CartridgeGenerationClient;
+    /**
+     * Create a Script Debugger Client if full credentials are available
+     */
+    createScriptDebuggerClient(): ScriptDebuggerClient | null;
+    /**
+     * Check if Script Debugger access is available
+     * Requires hostname and either basic auth or client credentials
+     */
+    private hasScriptDebuggerAccess;
     /**
      * Get the required error message for a client type
      */
-    static getClientRequiredError(clientType: 'OCAPI' | 'Log'): string;
+    static getClientRequiredError(clientType: 'OCAPI' | 'Log' | 'ScriptDebugger'): string;
 }
 //# sourceMappingURL=client-factory.d.ts.map

package/dist/core/handlers/client-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-factory.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/client-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAkC,MAAM,yBAAyB,CAAC;AAE3G;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM;IAKnD;;OAEG;IACH,eAAe,IAAI,aAAa,GAAG,IAAI;IAUvC;;OAEG;IACH,iBAAiB,IAAI,WAAW,GAAG,IAAI;IAevC;;OAEG;IACH,wBAAwB,IAAI,uBAAuB,GAAG,IAAI;IAe1D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,qBAAqB,CACnB,iBAAiB,CAAC,EAAE,kBAAkB,EACtC,WAAW,CAAC,EAAE,YAAY,GACzB,yBAAyB;IAQ5B;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,UAAU,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM;CAUnE"}
+{"version":3,"file":"client-factory.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/client-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAkC,MAAM,yBAAyB,CAAC;AAE3G;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM;IAKnD;;OAEG;IACH,eAAe,IAAI,aAAa,GAAG,IAAI;IAUvC;;OAEG;IACH,iBAAiB,IAAI,WAAW,GAAG,IAAI;IAevC;;OAEG;IACH,wBAAwB,IAAI,uBAAuB,GAAG,IAAI;IAe1D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,qBAAqB,CACnB,iBAAiB,CAAC,EAAE,kBAAkB,EACtC,WAAW,CAAC,EAAE,YAAY,GACzB,yBAAyB;IAQ5B;;OAEG;IACH,0BAA0B,IAAI,oBAAoB,GAAG,IAAI;IAUzD;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAU/B;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,UAAU,EAAE,OAAO,GAAG,KAAK,GAAG,gBAAgB,GAAG,MAAM;CAYtF"}

package/dist/core/handlers/client-factory.js

@@ -1,7 +1,8 @@
 import { SFCCLogClient } from '../../clients/log-client.js';
 import { OCAPIClient } from '../../clients/ocapi-client.js';
 import { OCAPICodeVersionsClient } from '../../clients/ocapi/code-versions-client.js';
-import { CartridgeGenerationClient } from '../../clients/cartridge-generation-client.js';
+import { CartridgeGenerationClient } from '../../clients/cartridge/index.js';
+import { ScriptDebuggerClient } from '../../clients/script-debugger/index.js';
 import { FileSystemService, PathService } from '../../services/index.js';
 /**
  * Centralized client factory that handles complex initialization logic
@@ -73,6 +74,30 @@ export class ClientFactory {
         this.logger.debug('Creating Cartridge Generation Client');
         return new CartridgeGenerationClient(fileSystemService ?? new FileSystemService(), pathService ?? new PathService());
     }
+    /**
+     * Create a Script Debugger Client if full credentials are available
+     */
+    createScriptDebuggerClient() {
+        if (!this.hasScriptDebuggerAccess()) {
+            this.logger.debug('Script Debugger client not created: missing credentials');
+            return null;
+        }
+        this.logger.debug('Creating Script Debugger Client');
+        return new ScriptDebuggerClient(this.context.config, this.logger);
+    }
+    /**
+     * Check if Script Debugger access is available
+     * Requires hostname and either basic auth or client credentials
+     */
+    hasScriptDebuggerAccess() {
+        const config = this.context.config;
+        if (!config?.hostname) {
+            return false;
+        }
+        const hasBasicAuth = !!(config.username && config.password);
+        const hasClientAuth = !!(config.clientId && config.clientSecret);
+        return hasBasicAuth || hasClientAuth;
+    }
     /**
      * Get the required error message for a client type
      */
@@ -82,6 +107,8 @@ export class ClientFactory {
                 return 'OCAPI client not configured - ensure credentials are provided in full mode.';
             case 'Log':
                 return 'Log client not configured - ensure log access is enabled.';
+            case 'ScriptDebugger':
+                return 'Script Debugger client not configured - ensure SFCC credentials (hostname + username/password or clientId/clientSecret) are provided.';
             default:
                 return 'Required client not configured.';
         }

package/dist/core/handlers/client-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-factory.js","sourceRoot":"","sources":["../../../src/core/handlers/client-factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client-factory.js","sourceRoot":"","sources":["../../../src/core/handlers/client-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E,OAAO,EAAoC,iBAAiB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3G;;;GAGG;AACH,MAAM,OAAO,aAAa;IAChB,OAAO,CAAiB;IACxB,MAAM,CAAS;IAEvB,YAAY,OAAuB,EAAE,MAAc;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,eAAe;QACb,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,aAAa,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACtE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;YACrF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;YACvF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,OAAO,IAAI,WAAW,CAAC;YACrB,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,QAAS;YACxC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,QAAS;YACxC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,YAAa;YAChD,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,wBAAwB;QACtB,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;YAC/F,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,OAAO,IAAI,uBAAuB,CAAC;YACjC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,QAAS;YACxC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,QAAS;YACxC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,YAAa;YAChD,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,mBAAmB;QACzB,OAAO,CAAC,CAAC,CACP,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,cAAc;YACzC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ;YAC7B,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ;YAC7B,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAClC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,qBAAqB,CACnB,iBAAsC,EACtC,WAA0B;QAE1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,OAAO,IAAI,yBAAyB,CAClC,iBAAiB,IAAI,IAAI,iBAAiB,EAAE,EAC5C,WAAW,IAAI,IAAI,WAAW,EAAE,CACjC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,0BAA0B;QACxB,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;YAC7E,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,OAAO,IAAI,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;IAED;;;OAGG;IACK,uBAAuB;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;YAAA,OAAO,KAAK,CAAC;QAAA,CAAC;QAEtC,MAAM,YAAY,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,aAAa,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;QAEjE,OAAO,YAAY,IAAI,aAAa,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,UAA8C;QAC1E,QAAQ,UAAU,EAAE,CAAC;YACnB,KAAK,OAAO;gBACV,OAAO,6EAA6E,CAAC;YACvF,KAAK,KAAK;gBACR,OAAO,2DAA2D,CAAC;YACrE,KAAK,gBAAgB;gBACnB,OAAO,uIAAuI,CAAC;YACjJ;gBACE,OAAO,iCAAiC,CAAC;QAC7C,CAAC;IACH,CAAC;CACF"}

package/dist/core/handlers/code-version-handler.d.ts

@@ -1,18 +1,18 @@
-import { BaseToolHandler, ToolExecutionContext, GenericToolSpec, HandlerContext, ToolArguments } from './base-handler.js';
+import { GenericToolSpec, ToolArguments, HandlerContext } from './base-handler.js';
+import { AbstractClientHandler } from './abstract-client-handler.js';
+import { OCAPICodeVersionsClient } from '../../clients/ocapi/code-versions-client.js';
 import { CodeVersionToolName } from '../../tool-configs/code-version-tool-config.js';
 /**
- * Handler for code version management tools using config-driven dispatch
- * Provides code version listing, activation, and deployment management
+ * Handler for code version management tools using config-driven dispatch.
+ * Provides code version listing, activation, and deployment management.
  */
-export declare class CodeVersionToolHandler extends BaseToolHandler<CodeVersionToolName> {
-    private codeVersionsClient;
-    private clientFactory;
+export declare class CodeVersionToolHandler extends AbstractClientHandler<CodeVersionToolName, OCAPICodeVersionsClient> {
     constructor(context: HandlerContext, subLoggerName: string);
-    protected onInitialize(): Promise<void>;
-    protected onDispose(): Promise<void>;
-    canHandle(toolName: string): boolean;
+    protected createClient(): OCAPICodeVersionsClient | null;
+    protected getClientContextKey(): string;
+    protected getClientDisplayName(): string;
+    protected getClientRequiredError(): string;
     protected getToolNameSet(): Set<CodeVersionToolName>;
-    protected getToolConfig(): Record<string, GenericToolSpec<ToolArguments, any>>;
-    protected createExecutionContext(): Promise<ToolExecutionContext>;
+    protected getToolConfig(): Record<CodeVersionToolName, GenericToolSpec<ToolArguments, any>>;
 }
 //# sourceMappingURL=code-version-handler.d.ts.map

package/dist/core/handlers/code-version-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-version-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/code-version-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAG1H,OAAO,EAEL,mBAAmB,EAEpB,MAAM,gDAAgD,CAAC;AAExD;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,eAAe,CAAC,mBAAmB,CAAC;IAC9E,OAAO,CAAC,kBAAkB,CAAwC;IAClE,OAAO,CAAC,aAAa,CAAgB;gBAEzB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM;cAK1C,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;cAO7B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpC,SAAS,CAAC,cAAc,IAAI,GAAG,CAAC,mBAAmB,CAAC;IAIpD,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;cAI9D,sBAAsB,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAWxE"}
+{"version":3,"file":"code-version-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/code-version-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAEL,mBAAmB,EAEpB,MAAM,gDAAgD,CAAC;AAExD;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,qBAAqB,CAAC,mBAAmB,EAAE,uBAAuB,CAAC;gBACjG,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM;IAI1D,SAAS,CAAC,YAAY,IAAI,uBAAuB,GAAG,IAAI;IAIxD,SAAS,CAAC,mBAAmB,IAAI,MAAM;IAIvC,SAAS,CAAC,oBAAoB,IAAI,MAAM;IAIxC,SAAS,CAAC,sBAAsB,IAAI,MAAM;IAI1C,SAAS,CAAC,cAAc,IAAI,GAAG,CAAC,mBAAmB,CAAC;IAIpD,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;CAG5F"}

package/dist/core/handlers/code-version-handler.js

@@ -1,29 +1,25 @@
-import { BaseToolHandler } from './base-handler.js';
+import { AbstractClientHandler } from './abstract-client-handler.js';
 import { ClientFactory } from './client-factory.js';
 import { CODE_VERSION_TOOL_CONFIG, CODE_VERSION_TOOL_NAMES_SET, } from '../../tool-configs/code-version-tool-config.js';
 /**
- * Handler for code version management tools using config-driven dispatch
- * Provides code version listing, activation, and deployment management
+ * Handler for code version management tools using config-driven dispatch.
+ * Provides code version listing, activation, and deployment management.
  */
-export class CodeVersionToolHandler extends BaseToolHandler {
-    codeVersionsClient = null;
-    clientFactory;
+export class CodeVersionToolHandler extends AbstractClientHandler {
     constructor(context, subLoggerName) {
         super(context, subLoggerName);
-        this.clientFactory = new ClientFactory(context, this.logger);
     }
-    async onInitialize() {
-        this.codeVersionsClient = this.clientFactory.createCodeVersionsClient();
-        if (this.codeVersionsClient) {
-            this.logger.debug('Code versions client initialized');
-        }
+    createClient() {
+        return this.clientFactory.createCodeVersionsClient();
     }
-    async onDispose() {
-        this.codeVersionsClient = null;
-        this.logger.debug('Code versions client disposed');
+    getClientContextKey() {
+        return 'codeVersionsClient';
     }
-    canHandle(toolName) {
-        return CODE_VERSION_TOOL_NAMES_SET.has(toolName);
+    getClientDisplayName() {
+        return 'OCAPI (Code Versions)';
+    }
+    getClientRequiredError() {
+        return ClientFactory.getClientRequiredError('OCAPI');
     }
     getToolNameSet() {
         return CODE_VERSION_TOOL_NAMES_SET;
@@ -31,15 +27,5 @@ export class CodeVersionToolHandler extends BaseToolHandler {
     getToolConfig() {
         return CODE_VERSION_TOOL_CONFIG;
     }
-    async createExecutionContext() {
-        if (!this.codeVersionsClient) {
-            throw new Error(ClientFactory.getClientRequiredError('OCAPI'));
-        }
-        return {
-            handlerContext: this.context,
-            logger: this.logger,
-            codeVersionsClient: this.codeVersionsClient,
-        };
-    }
 }
 //# sourceMappingURL=code-version-handler.js.map

package/dist/core/handlers/code-version-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"code-version-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/code-version-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwE,MAAM,mBAAmB,CAAC;AAE1H,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,wBAAwB,EAExB,2BAA2B,GAC5B,MAAM,gDAAgD,CAAC;AAExD;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,eAAoC;IACtE,kBAAkB,GAAmC,IAAI,CAAC;IAC1D,aAAa,CAAgB;IAErC,YAAY,OAAuB,EAAE,aAAqB;QACxD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9B,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IAES,KAAK,CAAC,YAAY;QAC1B,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,aAAa,CAAC,wBAAwB,EAAE,CAAC;QACxE,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAES,KAAK,CAAC,SAAS;QACvB,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACrD,CAAC;IAED,SAAS,CAAC,QAAgB;QACxB,OAAO,2BAA2B,CAAC,GAAG,CAAC,QAA+B,CAAC,CAAC;IAC1E,CAAC;IAES,cAAc;QACtB,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAES,aAAa;QACrB,OAAO,wBAAwB,CAAC;IAClC,CAAC;IAES,KAAK,CAAC,sBAAsB;QACpC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,OAAO;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;SAC5C,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"code-version-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/code-version-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EACL,wBAAwB,EAExB,2BAA2B,GAC5B,MAAM,gDAAgD,CAAC;AAExD;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,qBAAmE;IAC7G,YAAY,OAAuB,EAAE,aAAqB;QACxD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChC,CAAC;IAES,YAAY;QACpB,OAAO,IAAI,CAAC,aAAa,CAAC,wBAAwB,EAAE,CAAC;IACvD,CAAC;IAES,mBAAmB;QAC3B,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAES,oBAAoB;QAC5B,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAES,sBAAsB;QAC9B,OAAO,aAAa,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IAES,cAAc;QACtB,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAES,aAAa;QACrB,OAAO,wBAAwB,CAAC;IAClC,CAAC;CACF"}