sfcc-dev-mcp 1.0.15 → 1.0.19

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

@@ -1,17 +1,11 @@
-import { BaseToolHandler, ToolExecutionContext, GenericToolSpec, ToolArguments, HandlerContext } from './base-handler.js';
+import { HandlerContext } from './base-handler.js';
+import { SimpleClientHandler } from './simple-client-handler.js';
+import { SFCCDocumentationClient } from '../../clients/docs-client.js';
 import { DocToolName } from '../../tool-configs/docs-tool-config.js';
 /**
- * Handler for SFCC documentation tools using config-driven dispatch
- * Provides access to SFCC class information, search, and documentation
+ * Handler for SFCC documentation tools
  */
-export declare class DocsToolHandler extends BaseToolHandler<DocToolName> {
-    private docsClient;
-    constructor(context: HandlerContext, subLoggerName: string);
-    protected onInitialize(): Promise<void>;
-    protected onDispose(): Promise<void>;
-    canHandle(toolName: string): boolean;
-    protected getToolNameSet(): Set<DocToolName>;
-    protected getToolConfig(): Record<string, GenericToolSpec<ToolArguments, any>>;
-    protected createExecutionContext(): Promise<ToolExecutionContext>;
+export declare class DocsToolHandler extends SimpleClientHandler<DocToolName, SFCCDocumentationClient> {
+    constructor(context: HandlerContext);
 }
 //# sourceMappingURL=docs-handler.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"docs-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/docs-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE1H,OAAO,EAAoB,WAAW,EAAsB,MAAM,wCAAwC,CAAC;AAE3G;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,eAAe,CAAC,WAAW,CAAC;IAC/D,OAAO,CAAC,UAAU,CAAwC;gBAE9C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM;cAI1C,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,WAAW,CAAC;IAI5C,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":"docs-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/docs-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAoB,WAAW,EAAsB,MAAM,wCAAwC,CAAC;AAE3G;;GAEG;AACH,qBAAa,eAAgB,SAAQ,mBAAmB,CAAC,WAAW,EAAE,uBAAuB,CAAC;gBAChF,OAAO,EAAE,cAAc;CASpC"}

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

@@ -1,43 +1,18 @@
-import { BaseToolHandler } from './base-handler.js';
+import { SimpleClientHandler } from './simple-client-handler.js';
 import { SFCCDocumentationClient } from '../../clients/docs-client.js';
 import { DOCS_TOOL_CONFIG, DOC_TOOL_NAMES_SET } from '../../tool-configs/docs-tool-config.js';
 /**
- * Handler for SFCC documentation tools using config-driven dispatch
- * Provides access to SFCC class information, search, and documentation
+ * Handler for SFCC documentation tools
  */
-export class DocsToolHandler extends BaseToolHandler {
-    docsClient = null;
-    constructor(context, subLoggerName) {
-        super(context, subLoggerName);
-    }
-    async onInitialize() {
-        if (!this.docsClient) {
-            this.docsClient = new SFCCDocumentationClient();
-            this.logger.debug('Documentation client initialized');
-        }
-    }
-    async onDispose() {
-        this.docsClient = null;
-        this.logger.debug('Documentation client disposed');
-    }
-    canHandle(toolName) {
-        return DOC_TOOL_NAMES_SET.has(toolName);
-    }
-    getToolNameSet() {
-        return DOC_TOOL_NAMES_SET;
-    }
-    getToolConfig() {
-        return DOCS_TOOL_CONFIG;
-    }
-    async createExecutionContext() {
-        if (!this.docsClient) {
-            throw new Error('Documentation client not initialized');
-        }
-        return {
-            handlerContext: this.context,
-            logger: this.logger,
-            docsClient: this.docsClient,
-        };
+export class DocsToolHandler extends SimpleClientHandler {
+    constructor(context) {
+        super(context, 'Docs', {
+            toolConfig: DOCS_TOOL_CONFIG,
+            toolNameSet: DOC_TOOL_NAMES_SET,
+            clientContextKey: 'docsClient',
+            clientDisplayName: 'Documentation',
+            createClient: () => new SFCCDocumentationClient(),
+        });
     }
 }
 //# sourceMappingURL=docs-handler.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"docs-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/docs-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwE,MAAM,mBAAmB,CAAC;AAC1H,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAe,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAE3G;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,eAA4B;IACvD,UAAU,GAAmC,IAAI,CAAC;IAE1D,YAAY,OAAuB,EAAE,aAAqB;QACxD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChC,CAAC;IAES,KAAK,CAAC,YAAY;QAC1B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,IAAI,CAAC,UAAU,GAAG,IAAI,uBAAuB,EAAE,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAES,KAAK,CAAC,SAAS;QACvB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACrD,CAAC;IAED,SAAS,CAAC,QAAgB;QACxB,OAAO,kBAAkB,CAAC,GAAG,CAAC,QAAuB,CAAC,CAAC;IACzD,CAAC;IAES,cAAc;QACtB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAES,aAAa;QACrB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAES,KAAK,CAAC,sBAAsB;QACpC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,OAAO;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"docs-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/docs-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAe,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAE3G;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,mBAAyD;IAC5F,YAAY,OAAuB;QACjC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE;YACrB,UAAU,EAAE,gBAAgB;YAC5B,WAAW,EAAE,kBAAkB;YAC/B,gBAAgB,EAAE,YAAY;YAC9B,iBAAiB,EAAE,eAAe;YAClC,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,uBAAuB,EAAE;SAClD,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,11 @@
+import { HandlerContext } from './base-handler.js';
+import { SimpleClientHandler } from './simple-client-handler.js';
+import { ISMLClient } from '../../clients/isml-client.js';
+import { ISMLToolName } from '../../tool-configs/isml-tool-config.js';
+/**
+ * Handler for ISML documentation tools
+ */
+export declare class ISMLToolHandler extends SimpleClientHandler<ISMLToolName, ISMLClient> {
+    constructor(context: HandlerContext);
+}
+//# sourceMappingURL=isml-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isml-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/isml-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAoB,YAAY,EAAuB,MAAM,wCAAwC,CAAC;AAE7G;;GAEG;AACH,qBAAa,eAAgB,SAAQ,mBAAmB,CAAC,YAAY,EAAE,UAAU,CAAC;gBACpE,OAAO,EAAE,cAAc;CASpC"}

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

@@ -0,0 +1,18 @@
+import { SimpleClientHandler } from './simple-client-handler.js';
+import { ISMLClient } from '../../clients/isml-client.js';
+import { ISML_TOOL_CONFIG, ISML_TOOL_NAMES_SET } from '../../tool-configs/isml-tool-config.js';
+/**
+ * Handler for ISML documentation tools
+ */
+export class ISMLToolHandler extends SimpleClientHandler {
+    constructor(context) {
+        super(context, 'ISML', {
+            toolConfig: ISML_TOOL_CONFIG,
+            toolNameSet: ISML_TOOL_NAMES_SET,
+            clientContextKey: 'ismlClient',
+            clientDisplayName: 'ISML',
+            createClient: () => new ISMLClient(),
+        });
+    }
+}
+//# sourceMappingURL=isml-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isml-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/isml-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAgB,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAE7G;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,mBAA6C;IAChF,YAAY,OAAuB;QACjC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE;YACrB,UAAU,EAAE,gBAAgB;YAC5B,WAAW,EAAE,mBAAmB;YAChC,gBAAgB,EAAE,YAAY;YAC9B,iBAAiB,EAAE,MAAM;YACzB,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,UAAU,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/core/handlers/job-log-handler.d.ts

@@ -1,15 +1,16 @@
-import { AbstractLogToolHandler } from './abstract-log-tool-handler.js';
-import { HandlerContext } from './base-handler.js';
-import { GenericToolSpec } from './base-handler.js';
-import { ToolArguments } from './base-handler.js';
+import { GenericToolSpec, ToolArguments, HandlerContext } from './base-handler.js';
+import { AbstractClientHandler } from './abstract-client-handler.js';
+import { SFCCLogClient } from '../../clients/logs/index.js';
 import { JobLogToolName } from '../../utils/log-tool-constants.js';
 /**
  * Handler for job-specific log tools using config-driven dispatch
- * Separates job log operations from standard log operations for better maintainability
  */
-export declare class JobLogToolHandler extends AbstractLogToolHandler<JobLogToolName> {
+export declare class JobLogToolHandler extends AbstractClientHandler<JobLogToolName, SFCCLogClient> {
     constructor(context: HandlerContext, subLoggerName: string);
-    canHandle(toolName: string): boolean;
+    protected createClient(): SFCCLogClient | null;
+    protected getClientContextKey(): string;
+    protected getClientDisplayName(): string;
+    protected getClientRequiredError(): string;
     protected getToolNameSet(): Set<JobLogToolName>;
     protected getToolConfig(): Record<string, GenericToolSpec<ToolArguments, any>>;
 }

package/dist/core/handlers/job-log-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"job-log-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/job-log-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAA0B,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAE3F;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,sBAAsB,CAAC,cAAc,CAAC;gBAC/D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM;IAI1D,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpC,SAAS,CAAC,cAAc,IAAI,GAAG,CAAC,cAAc,CAAC;IAI/C,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;CAG/E"}
+{"version":3,"file":"job-log-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/job-log-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,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAA0B,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAE3F;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,qBAAqB,CAAC,cAAc,EAAE,aAAa,CAAC;gBAC7E,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM;IAI1D,SAAS,CAAC,YAAY,IAAI,aAAa,GAAG,IAAI;IAI9C,SAAS,CAAC,mBAAmB,IAAI,MAAM;IAIvC,SAAS,CAAC,oBAAoB,IAAI,MAAM;IAIxC,SAAS,CAAC,sBAAsB,IAAI,MAAM;IAI1C,SAAS,CAAC,cAAc,IAAI,GAAG,CAAC,cAAc,CAAC;IAI/C,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;CAG/E"}

package/dist/core/handlers/job-log-handler.js

@@ -1,16 +1,25 @@
-import { AbstractLogToolHandler } from './abstract-log-tool-handler.js';
+import { AbstractClientHandler } from './abstract-client-handler.js';
+import { ClientFactory } from './client-factory.js';
 import { JOB_LOG_TOOL_CONFIG } from '../../tool-configs/job-log-tool-config.js';
 import { JOB_LOG_TOOL_NAMES_SET } from '../../utils/log-tool-constants.js';
 /**
  * Handler for job-specific log tools using config-driven dispatch
- * Separates job log operations from standard log operations for better maintainability
  */
-export class JobLogToolHandler extends AbstractLogToolHandler {
+export class JobLogToolHandler extends AbstractClientHandler {
     constructor(context, subLoggerName) {
         super(context, subLoggerName);
     }
-    canHandle(toolName) {
-        return JOB_LOG_TOOL_NAMES_SET.has(toolName);
+    createClient() {
+        return this.clientFactory.createLogClient();
+    }
+    getClientContextKey() {
+        return 'logClient';
+    }
+    getClientDisplayName() {
+        return 'Log';
+    }
+    getClientRequiredError() {
+        return ClientFactory.getClientRequiredError('Log');
     }
     getToolNameSet() {
         return JOB_LOG_TOOL_NAMES_SET;

package/dist/core/handlers/job-log-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"job-log-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/job-log-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAIxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAkB,MAAM,mCAAmC,CAAC;AAE3F;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,sBAAsC;IAC3E,YAAY,OAAuB,EAAE,aAAqB;QACxD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChC,CAAC;IAED,SAAS,CAAC,QAAgB;QACxB,OAAO,sBAAsB,CAAC,GAAG,CAAC,QAA0B,CAAC,CAAC;IAChE,CAAC;IAES,cAAc;QACtB,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAES,aAAa;QACrB,OAAO,mBAAmB,CAAC;IAC7B,CAAC;CACF"}
+{"version":3,"file":"job-log-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/job-log-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAkB,MAAM,mCAAmC,CAAC;AAE3F;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,qBAAoD;IACzF,YAAY,OAAuB,EAAE,aAAqB;QACxD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChC,CAAC;IAES,YAAY;QACpB,OAAO,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC;IAC9C,CAAC;IAES,mBAAmB;QAC3B,OAAO,WAAW,CAAC;IACrB,CAAC;IAES,oBAAoB;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAES,sBAAsB;QAC9B,OAAO,aAAa,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IAES,cAAc;QACtB,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAES,aAAa;QACrB,OAAO,mBAAmB,CAAC;IAC7B,CAAC;CACF"}

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

@@ -1,15 +1,16 @@
-import { AbstractLogToolHandler } from './abstract-log-tool-handler.js';
-import { HandlerContext } from './base-handler.js';
-import { GenericToolSpec } from './base-handler.js';
-import { ToolArguments } from './base-handler.js';
+import { GenericToolSpec, ToolArguments, HandlerContext } from './base-handler.js';
+import { AbstractClientHandler } from './abstract-client-handler.js';
+import { SFCCLogClient } from '../../clients/logs/index.js';
 import { LogToolName } from '../../utils/log-tool-constants.js';
 /**
  * Handler for standard log tools using config-driven dispatch
- * Handles log reading, searching, and analysis operations
  */
-export declare class LogToolHandler extends AbstractLogToolHandler<LogToolName> {
+export declare class LogToolHandler extends AbstractClientHandler<LogToolName, SFCCLogClient> {
     constructor(context: HandlerContext, subLoggerName: string);
-    canHandle(toolName: string): boolean;
+    protected createClient(): SFCCLogClient | null;
+    protected getClientContextKey(): string;
+    protected getClientDisplayName(): string;
+    protected getClientRequiredError(): string;
     protected getToolNameSet(): Set<LogToolName>;
     protected getToolConfig(): Record<string, GenericToolSpec<ToolArguments, any>>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"log-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/log-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAsB,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEpF;;;GAGG;AACH,qBAAa,cAAe,SAAQ,sBAAsB,CAAC,WAAW,CAAC;gBACzD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM;IAI1D,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpC,SAAS,CAAC,cAAc,IAAI,GAAG,CAAC,WAAW,CAAC;IAI5C,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;CAG/E"}
+{"version":3,"file":"log-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/log-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,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAsB,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEpF;;GAEG;AACH,qBAAa,cAAe,SAAQ,qBAAqB,CAAC,WAAW,EAAE,aAAa,CAAC;gBACvE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM;IAI1D,SAAS,CAAC,YAAY,IAAI,aAAa,GAAG,IAAI;IAI9C,SAAS,CAAC,mBAAmB,IAAI,MAAM;IAIvC,SAAS,CAAC,oBAAoB,IAAI,MAAM;IAIxC,SAAS,CAAC,sBAAsB,IAAI,MAAM;IAI1C,SAAS,CAAC,cAAc,IAAI,GAAG,CAAC,WAAW,CAAC;IAI5C,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;CAG/E"}

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

@@ -1,16 +1,25 @@
-import { AbstractLogToolHandler } from './abstract-log-tool-handler.js';
+import { AbstractClientHandler } from './abstract-client-handler.js';
+import { ClientFactory } from './client-factory.js';
 import { LOG_TOOL_CONFIG } from '../../tool-configs/log-tool-config.js';
 import { LOG_TOOL_NAMES_SET } from '../../utils/log-tool-constants.js';
 /**
  * Handler for standard log tools using config-driven dispatch
- * Handles log reading, searching, and analysis operations
  */
-export class LogToolHandler extends AbstractLogToolHandler {
+export class LogToolHandler extends AbstractClientHandler {
     constructor(context, subLoggerName) {
         super(context, subLoggerName);
     }
-    canHandle(toolName) {
-        return LOG_TOOL_NAMES_SET.has(toolName);
+    createClient() {
+        return this.clientFactory.createLogClient();
+    }
+    getClientContextKey() {
+        return 'logClient';
+    }
+    getClientDisplayName() {
+        return 'Log';
+    }
+    getClientRequiredError() {
+        return ClientFactory.getClientRequiredError('Log');
     }
     getToolNameSet() {
         return LOG_TOOL_NAMES_SET;

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

@@ -1 +1 @@
-{"version":3,"file":"log-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/log-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAIxE,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAe,MAAM,mCAAmC,CAAC;AAEpF;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,sBAAmC;IACrE,YAAY,OAAuB,EAAE,aAAqB;QACxD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChC,CAAC;IAED,SAAS,CAAC,QAAgB;QACxB,OAAO,kBAAkB,CAAC,GAAG,CAAC,QAAuB,CAAC,CAAC;IACzD,CAAC;IAES,cAAc;QACtB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAES,aAAa;QACrB,OAAO,eAAe,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"log-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/log-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAe,MAAM,mCAAmC,CAAC;AAEpF;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,qBAAiD;IACnF,YAAY,OAAuB,EAAE,aAAqB;QACxD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChC,CAAC;IAES,YAAY;QACpB,OAAO,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC;IAC9C,CAAC;IAES,mBAAmB;QAC3B,OAAO,WAAW,CAAC;IACrB,CAAC;IAES,oBAAoB;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAES,sBAAsB;QAC9B,OAAO,aAAa,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IAES,cAAc;QACtB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAES,aAAa;QACrB,OAAO,eAAe,CAAC;IACzB,CAAC;CACF"}

package/dist/core/handlers/script-debugger-handler.d.ts

@@ -0,0 +1,18 @@
+import { GenericToolSpec, ToolArguments, HandlerContext } from './base-handler.js';
+import { AbstractClientHandler } from './abstract-client-handler.js';
+import { ScriptDebuggerClient } from '../../clients/script-debugger/index.js';
+import { ScriptDebuggerToolName } from '../../tool-configs/script-debugger-tool-config.js';
+/**
+ * Handler for script debugger tools using config-driven dispatch.
+ * Provides script evaluation capabilities via the SFCC Script Debugger API.
+ */
+export declare class ScriptDebuggerToolHandler extends AbstractClientHandler<ScriptDebuggerToolName, ScriptDebuggerClient> {
+    constructor(context: HandlerContext, subLoggerName: string);
+    protected createClient(): ScriptDebuggerClient | null;
+    protected getClientContextKey(): string;
+    protected getClientDisplayName(): string;
+    protected getClientRequiredError(): string;
+    protected getToolNameSet(): Set<ScriptDebuggerToolName>;
+    protected getToolConfig(): Record<ScriptDebuggerToolName, GenericToolSpec<ToolArguments, any>>;
+}
+//# sourceMappingURL=script-debugger-handler.d.ts.map

package/dist/core/handlers/script-debugger-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-debugger-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/script-debugger-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,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAEL,sBAAsB,EAEvB,MAAM,mDAAmD,CAAC;AAE3D;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,qBAAqB,CAClE,sBAAsB,EACtB,oBAAoB,CACrB;gBACa,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM;IAI1D,SAAS,CAAC,YAAY,IAAI,oBAAoB,GAAG,IAAI;IAIrD,SAAS,CAAC,mBAAmB,IAAI,MAAM;IAIvC,SAAS,CAAC,oBAAoB,IAAI,MAAM;IAIxC,SAAS,CAAC,sBAAsB,IAAI,MAAM;IAI1C,SAAS,CAAC,cAAc,IAAI,GAAG,CAAC,sBAAsB,CAAC;IAIvD,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,sBAAsB,EAAE,eAAe,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;CAG/F"}

package/dist/core/handlers/script-debugger-handler.js

@@ -0,0 +1,31 @@
+import { AbstractClientHandler } from './abstract-client-handler.js';
+import { ClientFactory } from './client-factory.js';
+import { SCRIPT_DEBUGGER_TOOL_CONFIG, SCRIPT_DEBUGGER_TOOL_NAMES_SET, } from '../../tool-configs/script-debugger-tool-config.js';
+/**
+ * Handler for script debugger tools using config-driven dispatch.
+ * Provides script evaluation capabilities via the SFCC Script Debugger API.
+ */
+export class ScriptDebuggerToolHandler extends AbstractClientHandler {
+    constructor(context, subLoggerName) {
+        super(context, subLoggerName);
+    }
+    createClient() {
+        return this.clientFactory.createScriptDebuggerClient();
+    }
+    getClientContextKey() {
+        return 'scriptDebuggerClient';
+    }
+    getClientDisplayName() {
+        return 'Script Debugger';
+    }
+    getClientRequiredError() {
+        return ClientFactory.getClientRequiredError('ScriptDebugger');
+    }
+    getToolNameSet() {
+        return SCRIPT_DEBUGGER_TOOL_NAMES_SET;
+    }
+    getToolConfig() {
+        return SCRIPT_DEBUGGER_TOOL_CONFIG;
+    }
+}
+//# sourceMappingURL=script-debugger-handler.js.map

package/dist/core/handlers/script-debugger-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-debugger-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/script-debugger-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EACL,2BAA2B,EAE3B,8BAA8B,GAC/B,MAAM,mDAAmD,CAAC;AAE3D;;;GAGG;AACH,MAAM,OAAO,yBAA0B,SAAQ,qBAG9C;IACC,YAAY,OAAuB,EAAE,aAAqB;QACxD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChC,CAAC;IAES,YAAY;QACpB,OAAO,IAAI,CAAC,aAAa,CAAC,0BAA0B,EAAE,CAAC;IACzD,CAAC;IAES,mBAAmB;QAC3B,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAES,oBAAoB;QAC5B,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAES,sBAAsB;QAC9B,OAAO,aAAa,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAChE,CAAC;IAES,cAAc;QACtB,OAAO,8BAA8B,CAAC;IACxC,CAAC;IAES,aAAa;QACrB,OAAO,2BAA2B,CAAC;IACrC,CAAC;CACF"}

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

@@ -1,17 +1,11 @@
-import { BaseToolHandler, ToolExecutionContext, GenericToolSpec, HandlerContext, ToolArguments } from './base-handler.js';
+import { HandlerContext } from './base-handler.js';
+import { SimpleClientHandler } from './simple-client-handler.js';
+import { SFRAClient } from '../../clients/sfra-client.js';
 import { SFRAToolName } from '../../tool-configs/sfra-tool-config.js';
 /**
- * Handler for SFRA documentation tools using config-driven dispatch
- * Provides access to Storefront Reference Architecture documentation
+ * Handler for SFRA documentation tools
  */
-export declare class SFRAToolHandler extends BaseToolHandler<SFRAToolName> {
-    private sfraClient;
-    constructor(context: HandlerContext, subLoggerName: string);
-    protected onInitialize(): Promise<void>;
-    protected onDispose(): Promise<void>;
-    canHandle(toolName: string): boolean;
-    protected getToolNameSet(): Set<SFRAToolName>;
-    protected getToolConfig(): Record<string, GenericToolSpec<ToolArguments, any>>;
-    protected createExecutionContext(): Promise<ToolExecutionContext>;
+export declare class SFRAToolHandler extends SimpleClientHandler<SFRAToolName, SFRAClient> {
+    constructor(context: HandlerContext);
 }
 //# sourceMappingURL=sfra-handler.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sfra-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/sfra-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE1H,OAAO,EAEL,YAAY,EAEb,MAAM,wCAAwC,CAAC;AAEhD;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,eAAe,CAAC,YAAY,CAAC;IAChE,OAAO,CAAC,UAAU,CAA2B;gBAEjC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM;cAI1C,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,YAAY,CAAC;IAI7C,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":"sfra-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/sfra-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAEL,YAAY,EAEb,MAAM,wCAAwC,CAAC;AAEhD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,mBAAmB,CAAC,YAAY,EAAE,UAAU,CAAC;gBACpE,OAAO,EAAE,cAAc;CASpC"}

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

@@ -1,43 +1,18 @@
-import { BaseToolHandler } from './base-handler.js';
+import { SimpleClientHandler } from './simple-client-handler.js';
 import { SFRAClient } from '../../clients/sfra-client.js';
 import { SFRA_TOOL_CONFIG, SFRA_TOOL_NAMES_SET, } from '../../tool-configs/sfra-tool-config.js';
 /**
- * Handler for SFRA documentation tools using config-driven dispatch
- * Provides access to Storefront Reference Architecture documentation
+ * Handler for SFRA documentation tools
  */
-export class SFRAToolHandler extends BaseToolHandler {
-    sfraClient = null;
-    constructor(context, subLoggerName) {
-        super(context, subLoggerName);
-    }
-    async onInitialize() {
-        if (!this.sfraClient) {
-            this.sfraClient = new SFRAClient();
-            this.logger.debug('SFRA client initialized');
-        }
-    }
-    async onDispose() {
-        this.sfraClient = null;
-        this.logger.debug('SFRA client disposed');
-    }
-    canHandle(toolName) {
-        return SFRA_TOOL_NAMES_SET.has(toolName);
-    }
-    getToolNameSet() {
-        return SFRA_TOOL_NAMES_SET;
-    }
-    getToolConfig() {
-        return SFRA_TOOL_CONFIG;
-    }
-    async createExecutionContext() {
-        if (!this.sfraClient) {
-            throw new Error('SFRA client not initialized');
-        }
-        return {
-            handlerContext: this.context,
-            logger: this.logger,
-            sfraClient: this.sfraClient,
-        };
+export class SFRAToolHandler extends SimpleClientHandler {
+    constructor(context) {
+        super(context, 'SFRA', {
+            toolConfig: SFRA_TOOL_CONFIG,
+            toolNameSet: SFRA_TOOL_NAMES_SET,
+            clientContextKey: 'sfraClient',
+            clientDisplayName: 'SFRA',
+            createClient: () => new SFRAClient(),
+        });
     }
 }
 //# sourceMappingURL=sfra-handler.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"sfra-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/sfra-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwE,MAAM,mBAAmB,CAAC;AAC1H,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EACL,gBAAgB,EAEhB,mBAAmB,GACpB,MAAM,wCAAwC,CAAC;AAEhD;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,eAA6B;IACxD,UAAU,GAAsB,IAAI,CAAC;IAE7C,YAAY,OAAuB,EAAE,aAAqB;QACxD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChC,CAAC;IAES,KAAK,CAAC,YAAY;QAC1B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAES,KAAK,CAAC,SAAS;QACvB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC5C,CAAC;IAED,SAAS,CAAC,QAAgB;QACxB,OAAO,mBAAmB,CAAC,GAAG,CAAC,QAAwB,CAAC,CAAC;IAC3D,CAAC;IAES,cAAc;QACtB,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAES,aAAa;QACrB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAES,KAAK,CAAC,sBAAsB;QACpC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,OAAO;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"sfra-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/sfra-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EACL,gBAAgB,EAEhB,mBAAmB,GACpB,MAAM,wCAAwC,CAAC;AAEhD;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,mBAA6C;IAChF,YAAY,OAAuB;QACjC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE;YACrB,UAAU,EAAE,gBAAgB;YAC5B,WAAW,EAAE,mBAAmB;YAChC,gBAAgB,EAAE,YAAY;YAC9B,iBAAiB,EAAE,MAAM;YACzB,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,UAAU,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/core/handlers/simple-client-handler.d.ts

@@ -0,0 +1,41 @@
+import { BaseToolHandler, ToolExecutionContext, GenericToolSpec, ToolArguments, HandlerContext } from './base-handler.js';
+/**
+ * Configuration for creating a simple client handler
+ * Reduces boilerplate for handlers that just wrap a single client
+ */
+export interface SimpleClientConfig<TToolName extends string, TClient> {
+    /** Tool configuration mapping tool names to specs */
+    toolConfig: Record<TToolName, GenericToolSpec<ToolArguments, any>>;
+    /** Set of tool names for O(1) lookup */
+    toolNameSet: Set<TToolName>;
+    /** Key name for the client in the execution context */
+    clientContextKey: string;
+    /** Human-readable client name for logging/errors */
+    clientDisplayName: string;
+    /** Factory function to create the client */
+    createClient: () => TClient;
+}
+/**
+ * Generic handler for tools that use a single stateless client
+ * Eliminates boilerplate for simple documentation-style handlers
+ *
+ * @example
+ * const handler = createSimpleClientHandler({
+ *   toolConfig: DOCS_TOOL_CONFIG,
+ *   toolNameSet: DOC_TOOL_NAMES_SET,
+ *   clientContextKey: 'docsClient',
+ *   clientDisplayName: 'Documentation',
+ *   createClient: () => new SFCCDocumentationClient(),
+ * });
+ */
+export declare class SimpleClientHandler<TToolName extends string, TClient> extends BaseToolHandler<TToolName> {
+    private client;
+    private readonly config;
+    constructor(context: HandlerContext, subLoggerName: string, config: SimpleClientConfig<TToolName, TClient>);
+    protected onInitialize(): Promise<void>;
+    protected onDispose(): Promise<void>;
+    protected getToolNameSet(): Set<TToolName>;
+    protected getToolConfig(): Record<string, GenericToolSpec<ToolArguments, any>>;
+    protected createExecutionContext(): Promise<ToolExecutionContext>;
+}
+//# sourceMappingURL=simple-client-handler.d.ts.map

package/dist/core/handlers/simple-client-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-client-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/simple-client-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE1H;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,SAAS,SAAS,MAAM,EAAE,OAAO;IACnE,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC;IACnE,wCAAwC;IACxC,WAAW,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAC5B,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,YAAY,EAAE,MAAM,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAmB,CAAC,SAAS,SAAS,MAAM,EAAE,OAAO,CAAE,SAAQ,eAAe,CAAC,SAAS,CAAC;IACpG,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;gBAG9D,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC;cAMhC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;cAO7B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1C,SAAS,CAAC,cAAc,IAAI,GAAG,CAAC,SAAS,CAAC;IAI1C,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;cAI9D,sBAAsB,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAWxE"}

package/dist/core/handlers/simple-client-handler.js

@@ -0,0 +1,49 @@
+import { BaseToolHandler } from './base-handler.js';
+/**
+ * Generic handler for tools that use a single stateless client
+ * Eliminates boilerplate for simple documentation-style handlers
+ *
+ * @example
+ * const handler = createSimpleClientHandler({
+ *   toolConfig: DOCS_TOOL_CONFIG,
+ *   toolNameSet: DOC_TOOL_NAMES_SET,
+ *   clientContextKey: 'docsClient',
+ *   clientDisplayName: 'Documentation',
+ *   createClient: () => new SFCCDocumentationClient(),
+ * });
+ */
+export class SimpleClientHandler extends BaseToolHandler {
+    client = null;
+    config;
+    constructor(context, subLoggerName, config) {
+        super(context, subLoggerName);
+        this.config = config;
+    }
+    async onInitialize() {
+        if (!this.client) {
+            this.client = this.config.createClient();
+            this.logger.debug(`${this.config.clientDisplayName} client initialized`);
+        }
+    }
+    async onDispose() {
+        this.client = null;
+        this.logger.debug(`${this.config.clientDisplayName} client disposed`);
+    }
+    getToolNameSet() {
+        return this.config.toolNameSet;
+    }
+    getToolConfig() {
+        return this.config.toolConfig;
+    }
+    async createExecutionContext() {
+        if (!this.client) {
+            throw new Error(`${this.config.clientDisplayName} client not initialized`);
+        }
+        return {
+            handlerContext: this.context,
+            logger: this.logger,
+            [this.config.clientContextKey]: this.client,
+        };
+    }
+}
+//# sourceMappingURL=simple-client-handler.js.map

package/dist/core/handlers/simple-client-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-client-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/simple-client-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwE,MAAM,mBAAmB,CAAC;AAmB1H;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,mBAAuD,SAAQ,eAA0B;IAC5F,MAAM,GAAmB,IAAI,CAAC;IACrB,MAAM,CAAyC;IAEhE,YACE,OAAuB,EACvB,aAAqB,EACrB,MAA8C;QAE9C,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAES,KAAK,CAAC,YAAY;QAC1B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,qBAAqB,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAES,KAAK,CAAC,SAAS;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,kBAAkB,CAAC,CAAC;IACxE,CAAC;IAES,cAAc;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;IACjC,CAAC;IAES,aAAa;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;IAChC,CAAC;IAES,KAAK,CAAC,sBAAsB;QACpC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,yBAAyB,CAAC,CAAC;QAC7E,CAAC;QAED,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,OAAO;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC,MAAM;SAC5C,CAAC;IACJ,CAAC;CACF"}

package/dist/core/handlers/system-object-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 { OCAPIClient } from '../../clients/ocapi-client.js';
 import { SystemObjectToolName } from '../../tool-configs/system-object-tool-config.js';
 /**
- * Handler for system object tools using config-driven dispatch
- * Provides access to SFCC system object definitions, attributes, and site preferences
+ * Handler for system object tools using config-driven dispatch.
+ * Provides access to SFCC system object definitions, attributes, and site preferences.
  */
-export declare class SystemObjectToolHandler extends BaseToolHandler<SystemObjectToolName> {
-    private ocapiClient;
-    private clientFactory;
+export declare class SystemObjectToolHandler extends AbstractClientHandler<SystemObjectToolName, OCAPIClient> {
     constructor(context: HandlerContext, subLoggerName: string);
-    protected onInitialize(): Promise<void>;
-    protected onDispose(): Promise<void>;
-    canHandle(toolName: string): boolean;
+    protected createClient(): OCAPIClient | null;
+    protected getClientContextKey(): string;
+    protected getClientDisplayName(): string;
+    protected getClientRequiredError(): string;
     protected getToolNameSet(): Set<SystemObjectToolName>;
-    protected getToolConfig(): Record<string, GenericToolSpec<ToolArguments, any>>;
-    protected createExecutionContext(): Promise<ToolExecutionContext>;
+    protected getToolConfig(): Record<SystemObjectToolName, GenericToolSpec<ToolArguments, any>>;
 }
 //# sourceMappingURL=system-object-handler.d.ts.map

package/dist/core/handlers/system-object-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-object-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/system-object-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAG1H,OAAO,EAEL,oBAAoB,EAErB,MAAM,iDAAiD,CAAC;AAEzD;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,eAAe,CAAC,oBAAoB,CAAC;IAChF,OAAO,CAAC,WAAW,CAA4B;IAC/C,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,oBAAoB,CAAC;IAIrD,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":"system-object-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/system-object-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,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAEL,oBAAoB,EAErB,MAAM,iDAAiD,CAAC;AAEzD;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,qBAAqB,CAAC,oBAAoB,EAAE,WAAW,CAAC;gBACvF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM;IAI1D,SAAS,CAAC,YAAY,IAAI,WAAW,GAAG,IAAI;IAI5C,SAAS,CAAC,mBAAmB,IAAI,MAAM;IAIvC,SAAS,CAAC,oBAAoB,IAAI,MAAM;IAIxC,SAAS,CAAC,sBAAsB,IAAI,MAAM;IAI1C,SAAS,CAAC,cAAc,IAAI,GAAG,CAAC,oBAAoB,CAAC;IAIrD,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,oBAAoB,EAAE,eAAe,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;CAG7F"}