solidworks-mcp-server 2.1.0 → 3.0.0

package/CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.0] - 2025-01-19
+
+### Fixed
+- **Critical: Handlebars Helper Registration** - Added all necessary Handlebars helpers (eq, ne, lt, gt, lte, gte, and, or, not) to fix VBA generation tools
+- **Template Name Mismatch** - Fixed batch_export template mapping and created proper batch_export.vba template
+- **Rebuild Model API** - Updated to use correct SolidWorks API methods (ForceRebuild3, EditRebuild, Rebuild) with fallback strategies
+- **Close Model Error Handling** - Added safe error handling for title retrieval preventing COM object access errors
+- **Export File Robustness** - Enhanced export functionality with format-specific handling and retry logic
+- **Mass Properties Extraction** - Improved getMassProperties with comprehensive error handling
+
+### Added
+- batch_export.vba template for batch export operations
+- Debug scripts (debug-server.mjs, debug-wrapper.mjs, test-fixes.mjs) for troubleshooting
+- SWChecklist.md comprehensive testing checklist
+- zod-to-json-schema dependency for schema validation
+- ensureCurrentModel helper method in api.ts
+
+### Improved
+- Enhanced error handling across all API methods with multiple fallback strategies
+- Better COM object access patterns for Windows SolidWorks compatibility
+- Template compilation with proper error recovery
+- API compatibility for different SolidWorks versions
+
 ## [2.1.0] - 2025-01-11
 
 ### Added

package/README.md

@@ -1,7 +1,50 @@
-# SolidWorks MCP Server v2.0
+# SolidWorks MCP Server
+
+<div align="center">
+
+[![CI](https://github.com/vespo92/SolidworksMCP-TS/actions/workflows/ci.yml/badge.svg)](https://github.com/vespo92/SolidworksMCP-TS/actions/workflows/ci.yml)
+[![npm version](https://badge.fury.io/js/solidworks-mcp-server.svg)](https://www.npmjs.com/package/solidworks-mcp-server)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.5-blue?logo=typescript)](https://www.typescriptlang.org/)
+[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-green?logo=anthropic)](https://modelcontextprotocol.com)
+[![Node.js](https://img.shields.io/badge/Node.js-20+-green?logo=node.js)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/vespo92/SolidworksMCP-TS/pulls)
+[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/vespo92/SolidworksMCP-TS/graphs/commit-activity)
+
+</div>
 
 A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with SolidWorks CAD software, providing automated design capabilities, macro recording, design tables with SQL integration, VBA generation, and PDM configuration management.
 
+## 🎯 Quick Start
+
+### Option 1: Install from npm (Recommended)
+```bash
+# Install globally from npm registry
+npm install -g solidworks-mcp-server
+```
+
+### Option 2: Manual Installation
+```bash
+# Clone the repository
+git clone https://github.com/vespo92/SolidworksMCP-TS
+cd SolidworksMCP-TS
+npm install
+npm run build
+
+# Link globally for use with Claude Desktop
+npm link
+```
+
+### Configure Claude Desktop
+After installation, add to your Claude Desktop config and restart Claude Desktop.
+
+Then in Claude Desktop:
+```
+"Generate VBA to batch export all parts in my folder to STEP format"
+"Create a parametric design table for a configurable bracket"
+"Check for interferences in my assembly"
+```
+
 ## 🚀 Key Features
 
 ### Core Capabilities
@@ -13,7 +56,16 @@ A comprehensive Model Context Protocol (MCP) server that enables AI assistants t
 - **State Management** - Persistent resource states with auto-save
 - **Resource-Based Architecture** - Modular, extensible design pattern
 
-### New in v2.0
+### New in v2.1.0 - Comprehensive VBA Generation Suite
+⚠️ **IMPORTANT: VBA script generation features are NOT WORKING in the current iteration and require additional testing**
+- 🔧 **Part Modeling VBA** - Advanced features, patterns, sheet metal, surfaces
+- 🏗️ **Assembly Automation** - Mates, components, interference analysis
+- 📐 **Drawing Generation** - Views, dimensions, annotations, tables
+- 📁 **File & PDM Operations** - Batch processing, custom properties, vault management
+- ⚙️ **Advanced Features** - Configurations, equations, simulation setup
+- 🎯 **100+ VBA Tools** - Generate production-ready VBA without coding knowledge
+
+### Enterprise Features (v2.0)
 - 🎯 **Macro Recording System** - Record actions and export to VBA
 - 📊 **SQL-Driven Design Tables** - Connect to databases for parametric designs
 - 🗄️ **PDM Configuration** - Manage vault operations, workflows, and automation
@@ -32,12 +84,22 @@ A comprehensive Model Context Protocol (MCP) server that enables AI assistants t
 
 ## 🛠️ Installation
 
-### 1. Install from npm
+### 1. Install the MCP Server
 
+#### From npm Registry (Recommended):
 ```bash
 npm install -g solidworks-mcp-server
 ```
 
+#### Or Manual Installation:
+```bash
+git clone https://github.com/vespo92/SolidworksMCP-TS
+cd SolidworksMCP-TS
+npm install
+npm run build
+npm link  # Makes it available globally
+```
+
 ### 2. Configure Claude Desktop
 
 Add to your Claude Desktop configuration:
@@ -113,14 +175,43 @@ LOG_LEVEL=info
 "Create folder structure with permissions for project team"
 ```
 
-### Advanced VBA Generation
+### Advanced VBA Generation (v2.1.0)
+
+#### Part Modeling
+```
+"Generate VBA to create a parametric bracket with:
+- Reference planes offset by 50mm
+- Sweep feature along a 3D curve
+- Linear pattern with 5 instances
+- Sheet metal conversion with 2mm thickness"
+```
+
+#### Assembly Automation
+```
+"Generate VBA for assembly that:
+- Inserts components from a folder
+- Creates coincident and distance mates
+- Checks for interferences
+- Exports mass properties to Excel"
+```
+
+#### Batch Operations
+```
+"Generate VBA to process all files in C:\Parts that:
+- Opens each SLDPRT file
+- Updates custom properties (Part Number, Revision)
+- Exports to STEP format
+- Checks into PDM vault with comment"
+```
 
+#### Drawing Automation
 ```
-"Generate VBA script that:
-1. Opens all parts in folder
-2. Updates material to Aluminum
-3. Runs stress analysis
-4. Exports results to Excel"
+"Generate VBA to create drawings that:
+- Creates standard 3-view layout
+- Adds section view A-A
+- Dimensions all features
+- Inserts BOM table
+- Exports to PDF"
 ```
 
 ## 🔧 Available Tools
@@ -128,7 +219,7 @@ LOG_LEVEL=info
 ### Macro Tools
 - `macro_start_recording` - Begin recording operations
 - `macro_stop_recording` - End recording and save
-- `macro_export_vba` - Export macro to VBA code
+- `macro_export_vba` - Export macro to VBA code ⚠️ **NOT WORKING - Requires additional testing**
 - `macro_execute` - Run recorded macro
 
 ### Design Table Tools
@@ -156,7 +247,7 @@ All original tools remain available:
 - Modeling tools (create, modify, analyze)
 - Drawing tools (views, dimensions, annotations)
 - Export tools (STEP, IGES, STL, PDF, etc.)
-- VBA tools (generate, execute scripts)
+- VBA tools ⚠️ **NOTE: VBA script generation is NOT WORKING in the current iteration and requires additional testing**
 - Analysis tools (mass properties, interference)
 
 ## 📚 API Reference
@@ -208,7 +299,7 @@ All original tools remain available:
 ### Building from Source
 
 ```bash
-git clone https://github.com/vinnieespo/solidworks-mcp-server
+git clone https://github.com/vespo92/SolidworksMCP-TS
 cd solidworks-mcp-server
 npm install
 npm run build
@@ -306,9 +397,8 @@ We welcome contributions! Please see CONTRIBUTING.md for guidelines.
 
 ## 📞 Support
 
-- Issues: [GitHub Issues](https://github.com/vinnieespo/solidworks-mcp-server/issues)
-- Discussions: [GitHub Discussions](https://github.com/vinnieespo/solidworks-mcp-server/discussions)
-- Email: support@solidworksmcp.dev
+- Issues: [GitHub Issues](https://github.com/vespo92/SolidworksMCP-TS/issues)
+- Discussions: [GitHub Discussions](https://github.com/vespo92/SolidworksMCP-TS/discussions)
 
 ## 🚀 Roadmap
 

package/dist/application/services/command-bus.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Command Bus Implementation
+ * Handles command execution with middleware support
+ */
+import { Result, ILogger, IMiddleware } from '../../core/interfaces/core-abstractions.js';
+export interface CommandHandler<TParams = unknown, TResult = unknown> {
+    handle(params: TParams): Promise<Result<TResult>>;
+}
+export declare class CommandBus {
+    private logger;
+    private handlers;
+    private middleware;
+    constructor(logger: ILogger);
+    /**
+     * Register a command handler
+     */
+    register<TParams, TResult>(commandName: string, handler: CommandHandler<TParams, TResult>): void;
+    /**
+     * Execute a command
+     */
+    execute<TParams, TResult>(commandName: string, params: TParams): Promise<Result<TResult>>;
+    /**
+     * Add middleware
+     */
+    use(middleware: IMiddleware): void;
+    /**
+     * Apply middleware chain
+     */
+    private applyMiddleware;
+    /**
+     * Check if a handler is registered
+     */
+    hasHandler(commandName: string): boolean;
+    /**
+     * Clear all handlers
+     */
+    clear(): void;
+}
+//# sourceMappingURL=command-bus.d.ts.map

package/dist/application/services/command-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-bus.d.ts","sourceRoot":"","sources":["../../../src/application/services/command-bus.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,MAAM,EAEN,OAAO,EACP,WAAW,EACZ,MAAM,4CAA4C,CAAC;AAEpD,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAClE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;CACnD;AAED,qBAAa,UAAU;IAIT,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,UAAU,CAAqB;gBAEnB,MAAM,EAAE,OAAO;IAEnC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,EACvB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,GACxC,IAAI;IAQP;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,OAAO,EAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAiC3B;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI;IAIlC;;OAEG;YACW,eAAe;IAe7B;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/application/services/command-bus.js

@@ -0,0 +1,88 @@
+/**
+ * Command Bus Implementation
+ * Handles command execution with middleware support
+ */
+import { ResultUtil } from '../../core/interfaces/core-abstractions.js';
+export class CommandBus {
+    logger;
+    handlers = new Map();
+    middleware = [];
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Register a command handler
+     */
+    register(commandName, handler) {
+        if (this.handlers.has(commandName)) {
+            this.logger.warn(`Command handler ${commandName} is already registered`);
+        }
+        this.handlers.set(commandName, handler);
+        this.logger.debug(`Registered command handler: ${commandName}`);
+    }
+    /**
+     * Execute a command
+     */
+    async execute(commandName, params) {
+        try {
+            const handler = this.handlers.get(commandName);
+            if (!handler) {
+                return ResultUtil.fail(new Error(`No handler registered for command: ${commandName}`));
+            }
+            // Apply middleware
+            const context = { commandName, params, handler };
+            const middlewareResult = await this.applyMiddleware(context);
+            if (!ResultUtil.isSuccess(middlewareResult)) {
+                return middlewareResult;
+            }
+            // Execute the command
+            this.logger.debug(`Executing command: ${commandName}`, { params });
+            const result = await handler.handle(params);
+            if (ResultUtil.isSuccess(result)) {
+                this.logger.debug(`Command executed successfully: ${commandName}`);
+            }
+            else {
+                this.logger.warn(`Command failed: ${commandName}`, { error: result.error });
+            }
+            return result;
+        }
+        catch (error) {
+            this.logger.error(`Unexpected error executing command: ${commandName}`, error);
+            return ResultUtil.fail(error);
+        }
+    }
+    /**
+     * Add middleware
+     */
+    use(middleware) {
+        this.middleware.push(middleware);
+    }
+    /**
+     * Apply middleware chain
+     */
+    async applyMiddleware(context) {
+        let index = 0;
+        const next = async () => {
+            if (index >= this.middleware.length) {
+                return ResultUtil.ok(undefined);
+            }
+            const currentMiddleware = this.middleware[index++];
+            return currentMiddleware.execute(context, next);
+        };
+        return next();
+    }
+    /**
+     * Check if a handler is registered
+     */
+    hasHandler(commandName) {
+        return this.handlers.has(commandName);
+    }
+    /**
+     * Clear all handlers
+     */
+    clear() {
+        this.handlers.clear();
+        this.middleware = [];
+    }
+}
+//# sourceMappingURL=command-bus.js.map

package/dist/application/services/command-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-bus.js","sourceRoot":"","sources":["../../../src/application/services/command-bus.ts"],"names":[],"mappings":"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"}

package/dist/application/services/event-bus.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Event Bus Implementation
+ * Handles event publishing and subscription
+ */
+import { IEventBus, IEvent, IEventHandler, Result, ILogger } from '../../core/interfaces/core-abstractions.js';
+export declare class EventBus implements IEventBus {
+    private logger;
+    private handlers;
+    constructor(logger: ILogger);
+    /**
+     * Publish an event to all registered handlers
+     */
+    publish(event: IEvent): Promise<Result<void>>;
+    /**
+     * Subscribe to an event type
+     */
+    subscribe(eventType: string, handler: IEventHandler): void;
+    /**
+     * Unsubscribe from an event type
+     */
+    unsubscribe(eventType: string, handler: IEventHandler): void;
+    /**
+     * Clear all subscriptions
+     */
+    clear(): void;
+    /**
+     * Get the number of handlers for an event type
+     */
+    getHandlerCount(eventType: string): number;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/application/services/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../../src/application/services/event-bus.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,SAAS,EACT,MAAM,EACN,aAAa,EACb,MAAM,EAEN,OAAO,EACR,MAAM,4CAA4C,CAAC;AAEpD,qBAAa,QAAS,YAAW,SAAS;IAG5B,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,QAAQ,CAA8C;gBAE1C,MAAM,EAAE,OAAO;IAEnC;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAuCnD;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAQ1D;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAW5D;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAI3C"}

package/dist/application/services/event-bus.js

@@ -0,0 +1,83 @@
+/**
+ * Event Bus Implementation
+ * Handles event publishing and subscription
+ */
+import { ResultUtil } from '../../core/interfaces/core-abstractions.js';
+export class EventBus {
+    logger;
+    handlers = new Map();
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Publish an event to all registered handlers
+     */
+    async publish(event) {
+        try {
+            const handlers = this.handlers.get(event.type);
+            if (!handlers || handlers.size === 0) {
+                this.logger.debug(`No handlers for event type: ${event.type}`);
+                return ResultUtil.ok(undefined);
+            }
+            this.logger.debug(`Publishing event: ${event.type}`, {
+                eventId: event.id,
+                handlerCount: handlers.size
+            });
+            const promises = [];
+            for (const handler of handlers) {
+                if (handler.canHandle(event)) {
+                    promises.push(handler.handle(event));
+                }
+            }
+            const results = await Promise.allSettled(promises);
+            const failures = results.filter((result) => result.status === 'rejected');
+            if (failures.length > 0) {
+                this.logger.warn(`Some event handlers failed for: ${event.type}`, {
+                    failures: failures.map(f => f.reason)
+                });
+            }
+            return ResultUtil.ok(undefined);
+        }
+        catch (error) {
+            this.logger.error(`Failed to publish event: ${event.type}`, error);
+            return ResultUtil.fail(error);
+        }
+    }
+    /**
+     * Subscribe to an event type
+     */
+    subscribe(eventType, handler) {
+        if (!this.handlers.has(eventType)) {
+            this.handlers.set(eventType, new Set());
+        }
+        this.handlers.get(eventType).add(handler);
+        this.logger.debug(`Subscribed to event: ${eventType}`);
+    }
+    /**
+     * Unsubscribe from an event type
+     */
+    unsubscribe(eventType, handler) {
+        const handlers = this.handlers.get(eventType);
+        if (handlers) {
+            handlers.delete(handler);
+            if (handlers.size === 0) {
+                this.handlers.delete(eventType);
+            }
+            this.logger.debug(`Unsubscribed from event: ${eventType}`);
+        }
+    }
+    /**
+     * Clear all subscriptions
+     */
+    clear() {
+        this.handlers.clear();
+    }
+    /**
+     * Get the number of handlers for an event type
+     */
+    getHandlerCount(eventType) {
+        const handlers = this.handlers.get(eventType);
+        return handlers ? handlers.size : 0;
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/application/services/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../../src/application/services/event-bus.ts"],"names":[],"mappings":"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"}

package/dist/application/services/query-bus.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Query Bus Implementation
+ * Handles query execution for read operations
+ */
+import { Result, ILogger } from '../../core/interfaces/core-abstractions.js';
+export interface QueryHandler<TParams = unknown, TResult = unknown> {
+    handle(params: TParams): Promise<Result<TResult>>;
+}
+export declare class QueryBus {
+    private logger;
+    private handlers;
+    constructor(logger: ILogger);
+    /**
+     * Register a query handler
+     */
+    register<TParams, TResult>(queryName: string, handler: QueryHandler<TParams, TResult>): void;
+    /**
+     * Execute a query
+     */
+    execute<TParams, TResult>(queryName: string, params: TParams): Promise<Result<TResult>>;
+    /**
+     * Check if a handler is registered
+     */
+    hasHandler(queryName: string): boolean;
+    /**
+     * Clear all handlers
+     */
+    clear(): void;
+}
+//# sourceMappingURL=query-bus.d.ts.map

package/dist/application/services/query-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-bus.d.ts","sourceRoot":"","sources":["../../../src/application/services/query-bus.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,MAAM,EAEN,OAAO,EACR,MAAM,4CAA4C,CAAC;AAEpD,MAAM,WAAW,YAAY,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAChE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;CACnD;AAED,qBAAa,QAAQ;IAGP,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,QAAQ,CAAwC;gBAEpC,MAAM,EAAE,OAAO;IAEnC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,EACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,GACtC,IAAI;IAQP;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,OAAO,EAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAyB3B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/application/services/query-bus.js

@@ -0,0 +1,59 @@
+/**
+ * Query Bus Implementation
+ * Handles query execution for read operations
+ */
+import { ResultUtil } from '../../core/interfaces/core-abstractions.js';
+export class QueryBus {
+    logger;
+    handlers = new Map();
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Register a query handler
+     */
+    register(queryName, handler) {
+        if (this.handlers.has(queryName)) {
+            this.logger.warn(`Query handler ${queryName} is already registered`);
+        }
+        this.handlers.set(queryName, handler);
+        this.logger.debug(`Registered query handler: ${queryName}`);
+    }
+    /**
+     * Execute a query
+     */
+    async execute(queryName, params) {
+        try {
+            const handler = this.handlers.get(queryName);
+            if (!handler) {
+                return ResultUtil.fail(new Error(`No handler registered for query: ${queryName}`));
+            }
+            this.logger.debug(`Executing query: ${queryName}`, { params });
+            const result = await handler.handle(params);
+            if (ResultUtil.isSuccess(result)) {
+                this.logger.debug(`Query executed successfully: ${queryName}`);
+            }
+            else {
+                this.logger.warn(`Query failed: ${queryName}`, { error: result.error });
+            }
+            return result;
+        }
+        catch (error) {
+            this.logger.error(`Unexpected error executing query: ${queryName}`, error);
+            return ResultUtil.fail(error);
+        }
+    }
+    /**
+     * Check if a handler is registered
+     */
+    hasHandler(queryName) {
+        return this.handlers.has(queryName);
+    }
+    /**
+     * Clear all handlers
+     */
+    clear() {
+        this.handlers.clear();
+    }
+}
+//# sourceMappingURL=query-bus.js.map

package/dist/application/services/query-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-bus.js","sourceRoot":"","sources":["../../../src/application/services/query-bus.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGL,UAAU,EAEX,MAAM,4CAA4C,CAAC;AAMpD,MAAM,OAAO,QAAQ;IAGC;IAFZ,QAAQ,GAA8B,IAAI,GAAG,EAAE,CAAC;IAExD,YAAoB,MAAe;QAAf,WAAM,GAAN,MAAM,CAAS;IAAG,CAAC;IAEvC;;OAEG;IACH,QAAQ,CACN,SAAiB,EACjB,OAAuC;QAEvC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,SAAS,wBAAwB,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,SAAS,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,SAAiB,EACjB,MAAe;QAEf,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,UAAU,CAAC,IAAI,CACpB,IAAI,KAAK,CAAC,oCAAoC,SAAS,EAAE,CAAC,CAC3D,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAE5C,IAAI,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,SAAS,EAAE,CAAC,CAAC;YACjE,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAC1E,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,SAAS,EAAE,EAAE,KAAc,CAAC,CAAC;YACpF,OAAO,UAAU,CAAC,IAAI,CAAC,KAAc,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/application/services/tool-registry.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Tool Registry Service
+ * Manages and provides access to all available tools
+ */
+import { z } from 'zod';
+import { ILogger } from '../../core/interfaces/core-abstractions.js';
+export interface Tool {
+    name: string;
+    description: string;
+    inputSchema: z.ZodSchema;
+    handler: (args: any) => Promise<any> | any;
+    category?: string;
+    tags?: string[];
+}
+export declare class ToolRegistry {
+    private logger;
+    private tools;
+    private categories;
+    constructor(logger: ILogger);
+    /**
+     * Register a new tool
+     */
+    register(tool: Tool): void;
+    /**
+     * Get a tool by name
+     */
+    get(name: string): Tool | undefined;
+    /**
+     * Get all tools
+     */
+    getAll(): Tool[];
+    /**
+     * Get tools by category
+     */
+    getByCategory(category: string): Tool[];
+    /**
+     * Check if a tool exists
+     */
+    has(name: string): boolean;
+    /**
+     * Get the number of registered tools
+     */
+    count(): number;
+    /**
+     * Get all categories
+     */
+    getCategories(): string[];
+    /**
+     * Clear all tools
+     */
+    clear(): void;
+}
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/application/services/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../src/application/services/tool-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,4CAA4C,CAAC;AAErE,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC;IACzB,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,qBAAa,YAAY;IAIX,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,UAAU,CAAuC;gBAErC,MAAM,EAAE,OAAO;IAEnC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAqB1B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC;;OAEG;IACH,MAAM,IAAI,IAAI,EAAE;IAIhB;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE;IASvC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}