@iflow-mcp/attio-mcp 1.3.6

package/dist/handlers/tool-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-types.js","sourceRoot":"","sources":["../../src/handlers/tool-types.ts"],"names":[],"mappings":""}

package/dist/handlers/tools/config-verifier.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tool configuration verification utilities
+ *
+ * This module provides utility functions for verifying tool configurations
+ * during initialization to ensure proper registration and prevent runtime errors.
+ */
+import type { ToolConfig } from '../tool-types.js';
+export declare function verifyToolConfigsWithRequiredTools(resourceName: string, combinedConfigs: Record<string, ToolConfig>, requiredToolTypes: string[]): boolean;
+/**
+ * Verifies a specific tool in the configurations
+ *
+ * @param {string} resourceName - The name of the resource for logging
+ * @param {Object} configs - The configurations object
+ * @param {string} toolType - The specific tool type to verify
+ * @param {Object} subConfigs - Optional sub-configurations to check for the tool
+ * @returns {boolean} - Whether the tool is properly configured
+ */
+export declare function verifySpecificTool(resourceName: string, configs: Record<string, ToolConfig>, toolType: string, subConfigs?: Record<string, ToolConfig> | null): boolean;
+//# sourceMappingURL=config-verifier.d.ts.map

package/dist/handlers/tools/config-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-verifier.d.ts","sourceRoot":"","sources":["../../../src/handlers/tools/config-verifier.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,wBAAgB,kCAAkC,CAChD,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAC3C,iBAAiB,EAAE,MAAM,EAAE,GAC1B,OAAO,CAoFT;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,IAAW,GACnD,OAAO,CA8BT"}

package/dist/handlers/tools/config-verifier.js

@@ -0,0 +1,116 @@
+/**
+ * Tool configuration verification utilities
+ *
+ * This module provides utility functions for verifying tool configurations
+ * during initialization to ensure proper registration and prevent runtime errors.
+ */
+/**
+ * Verifies that required tool types are present in a tool configuration object
+ * and checks for duplicate tool names
+ *
+ * @param {string} resourceName - The name of the resource for logging (e.g., 'company', 'people')
+ * @param {Object} combinedConfigs - The combined tool configurations object
+ * @param {string[]} requiredToolTypes - Array of tool types that must be present
+ * @returns {boolean} - Whether all required tools are properly configured
+ */
+import { createScopedLogger } from '../../utils/logger.js';
+export function verifyToolConfigsWithRequiredTools(resourceName, combinedConfigs, requiredToolTypes) {
+    const debugMode = process.env.NODE_ENV === 'development' || process.env.DEBUG === 'true';
+    if (!debugMode)
+        return true;
+    const log = createScopedLogger(`${resourceName}ToolConfigs`, 'verifyToolConfigs');
+    log.info('Verifying tool configs during initialization');
+    let allPresent = true;
+    // Check for duplicate tool names
+    const toolNameMap = {};
+    // Build a map of tool names to their config types
+    for (const [configType, config] of Object.entries(combinedConfigs)) {
+        if (config && typeof config === 'object' && 'name' in config) {
+            const toolConfig = config;
+            const toolName = toolConfig.name;
+            if (!toolNameMap[toolName]) {
+                toolNameMap[toolName] = [];
+            }
+            toolNameMap[toolName].push(configType);
+        }
+    }
+    // Check for duplicates
+    const duplicates = Object.entries(toolNameMap).filter(([, configTypes]) => configTypes.length > 1);
+    if (duplicates.length > 0) {
+        log.warn('DUPLICATE TOOL NAMES DETECTED');
+        for (const [toolName, configTypes] of duplicates) {
+            log.warn('Tool name defined in multiple configs', {
+                toolName,
+                locations: configTypes,
+            });
+        }
+        // In strict mode, fail validation
+        if (process.env.STRICT_TOOL_VALIDATION === 'true') {
+            log.error('Duplicate tool names will cause MCP tool initialization failures.');
+            allPresent = false;
+        }
+    }
+    // Verify each required tool type is present
+    for (const toolType of requiredToolTypes) {
+        if (toolType in combinedConfigs) {
+            const config = combinedConfigs[toolType];
+            log.info('Found required tool', { toolType, name: config.name });
+            // Additional validation
+            if (typeof config.handler !== 'function') {
+                log.warn(`${toolType} has no handler function`);
+                allPresent = false;
+            }
+            if (typeof config.formatResult !== 'function' &&
+                toolType !== 'create' &&
+                toolType !== 'update') {
+                log.warn(`${toolType} has no formatResult function`);
+            }
+        }
+        else {
+            log.warn('MISSING required tool type', { toolType });
+            allPresent = false;
+        }
+    }
+    // Log all available tool types for debugging
+    if (debugMode) {
+        log.info('All registered tool types', {
+            types: Object.keys(combinedConfigs),
+        });
+    }
+    return allPresent;
+}
+/**
+ * Verifies a specific tool in the configurations
+ *
+ * @param {string} resourceName - The name of the resource for logging
+ * @param {Object} configs - The configurations object
+ * @param {string} toolType - The specific tool type to verify
+ * @param {Object} subConfigs - Optional sub-configurations to check for the tool
+ * @returns {boolean} - Whether the tool is properly configured
+ */
+export function verifySpecificTool(resourceName, configs, toolType, subConfigs = null) {
+    const debugMode = process.env.NODE_ENV === 'development' || process.env.DEBUG === 'true';
+    if (!debugMode)
+        return true;
+    const log = createScopedLogger(`${resourceName}ToolConfigs`, 'verifySpecificTool');
+    if (subConfigs && toolType in subConfigs) {
+        log.info('Found tool in sub-configs', { toolType });
+        // Check if the tool was properly merged into the main configs
+        if (toolType in configs) {
+            return true;
+        }
+        else {
+            log.warn('Tool exists in sub-config but not in combined config', {
+                toolType,
+            });
+            return false;
+        }
+    }
+    // Just check the main configs
+    if (toolType in configs) {
+        return true;
+    }
+    log.warn('Tool not found in configs', { toolType });
+    return false;
+}
+//# sourceMappingURL=config-verifier.js.map

package/dist/handlers/tools/config-verifier.js.map

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

package/dist/handlers/tools/dispatcher/core.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Core dispatcher module - main tool execution dispatcher with modular operation handlers
+ */
+import { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Execute a tool request and return formatted results
+ *
+ * @param request - The tool request to execute
+ * @returns Tool execution result
+ */
+export declare function executeToolRequest(request: CallToolRequest): Promise<unknown>;
+//# sourceMappingURL=core.d.ts.map

package/dist/handlers/tools/dispatcher/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tools/dispatcher/core.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAuGrE;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,eAAe,oBAmZhE"}

package/dist/handlers/tools/dispatcher/core.js

@@ -0,0 +1,322 @@
+// Import utilities
+import { initializeToolContext, logToolRequest, logToolSuccess, logToolError, logToolConfigError, } from '../../../handlers/tools/dispatcher/logging.js';
+// Import tool configurations
+import { findToolConfig } from '../../../handlers/tools/registry.js';
+import { PerformanceTimer, OperationType, getLogContext, } from '../../../utils/logger.js';
+import { sanitizeMcpResponse } from '../../../utils/json-serializer.js';
+import { createSecureToolErrorResult } from '../../../utils/secure-error-handler.js';
+// Import operation handlers
+import { handleBasicSearch, handleSearchByEmail, handleSearchByPhone, handleSearchByDomain, handleSmartSearch, } from '../../../handlers/tools/dispatcher/operations/search.js';
+import { handleAdvancedSearch } from '../../../handlers/tools/dispatcher/operations/advanced-search.js';
+import { handleDetailsOperation } from '../../../handlers/tools/dispatcher/operations/details.js';
+import { handleNotesOperation, handleCreateNoteOperation, } from '../../../handlers/tools/dispatcher/operations/notes.js';
+import { handleGetListsOperation } from '../../../handlers/tools/dispatcher/operations/lists.js';
+// Import CRUD operation handlers
+import { handleCreateOperation, handleUpdateOperation, handleUpdateAttributeOperation, handleDeleteOperation, } from '../../../handlers/tools/dispatcher/operations/crud.js';
+// Import List operation handlers (additional operations from emergency fix)
+import { handleAddRecordToListOperation, handleRemoveRecordFromListOperation, handleUpdateListEntryOperation, handleGetListDetailsOperation, handleGetListEntriesOperation, handleFilterListEntriesOperation, handleAdvancedFilterListEntriesOperation, handleFilterListEntriesByParentOperation, handleFilterListEntriesByParentIdOperation, handleGetRecordListMembershipsOperation, } from '../../../handlers/tools/dispatcher/operations/lists.js';
+// Import Batch operation handlers
+import { handleBatchUpdateOperation, handleBatchCreateOperation, handleBatchDeleteOperation, handleBatchSearchOperation, handleBatchGetDetailsOperation, } from '../../../handlers/tools/dispatcher/operations/batch.js';
+// Import Record operation handlers
+import { handleListOperation, handleGetOperation, } from '../../../handlers/tools/dispatcher/operations/records.js';
+import { handleInfoOperation, handleFieldsOperation, handleGetAttributesOperation, handleDiscoverAttributesOperation, } from '../../../handlers/tools/dispatcher/misc-operations.js';
+/**
+ * Normalize error messages by stripping tool execution prefixes
+ * This improves test compatibility and error message clarity
+ */
+import { canonicalizeResourceType } from '../../../handlers/tools/dispatcher/utils.js';
+/**
+ * Execute a tool request and return formatted results
+ *
+ * @param request - The tool request to execute
+ * @returns Tool execution result
+ */
+export async function executeToolRequest(request) {
+    const toolName = request.params.name;
+    // Initialize logging context for this tool execution
+    initializeToolContext(toolName);
+    let timer;
+    let toolType;
+    // Note: Argument normalization is handled in the request handler (Issue #344)
+    // This dispatcher expects normalized requests with proper arguments structure
+    try {
+        const toolInfo = findToolConfig(toolName);
+        if (!toolInfo) {
+            logToolConfigError(toolName, 'Tool configuration not found');
+            throw new Error(`Tool not found: ${toolName}`);
+        }
+        const { resourceType, toolConfig } = toolInfo;
+        toolType = toolInfo.toolType; // Assign to outer scope variable
+        // Start tool execution logging with performance tracking
+        timer = logToolRequest(toolType, toolName, request);
+        let result;
+        // Handle Universal and General tools first (Issue #352)
+        if (resourceType === 'UNIVERSAL') {
+            // For universal tools, use the tool's own handler directly
+            const args = request.params.arguments;
+            // Canonicalize and freeze resource_type to prevent mutation
+            if (args && 'resource_type' in args) {
+                args.resource_type = canonicalizeResourceType(args.resource_type);
+                Object.defineProperty(args, 'resource_type', {
+                    value: args.resource_type,
+                    writable: false,
+                });
+            }
+            // Universal tools have their own parameter validation and handling
+            const rawResult = await toolConfig.handler(args);
+            // If a tool already returned an MCP-shaped object, stop double-wrapping
+            const isMcpResponseLike = (value) => typeof value === 'object' &&
+                value !== null &&
+                'content' in value &&
+                'isError' in value;
+            if (isMcpResponseLike(rawResult)) {
+                const sanitized = sanitizeMcpResponse(rawResult);
+                logToolSuccess(toolName, toolType, sanitized, timer);
+                return sanitized; // skip detection/formatting, it's already MCP
+            }
+            // Format the result using the tool's formatResult if available
+            let formattedResult;
+            if (rawResult === null || rawResult === undefined) {
+                formattedResult = JSON.stringify(rawResult, null, 2);
+            }
+            else if (toolConfig.formatResult) {
+                try {
+                    // Pass full args object as first param for tools that need access to all params
+                    // (e.g., records_get_attribute_options needs args.attribute)
+                    // Fall back to resource_type/info_type for backward compatibility
+                    formattedResult = toolConfig.formatResult(rawResult, args, // Pass full args object
+                    args?.info_type);
+                }
+                catch {
+                    formattedResult = toolConfig.formatResult(rawResult);
+                }
+            }
+            else {
+                formattedResult = JSON.stringify(rawResult, null, 2);
+            }
+            // If structuredOutput is defined, return dual content for programmatic parsing
+            // content[0]: JSON string for parsing, content[1]: human-readable text
+            if (toolConfig.structuredOutput) {
+                const resourceTypeArg = args?.resource_type;
+                const structured = toolConfig.structuredOutput(rawResult, resourceTypeArg);
+                result = {
+                    content: [
+                        { type: 'text', text: JSON.stringify(structured) },
+                        { type: 'text', text: formattedResult },
+                    ],
+                    isError: false,
+                };
+            }
+            else {
+                result = {
+                    content: [{ type: 'text', text: formattedResult }],
+                    isError: false,
+                };
+            }
+        }
+        else if (resourceType === 'GENERAL') {
+            // For general tools, use the tool's own handler directly
+            const args = request.params.arguments;
+            let handlerArgs = [];
+            // Map arguments based on tool type
+            if (toolType === 'linkPersonToCompany' ||
+                toolType === 'unlinkPersonFromCompany') {
+                handlerArgs = [args?.personId, args?.companyId];
+            }
+            else if (toolType === 'getPersonCompanies') {
+                handlerArgs = [args?.personId];
+            }
+            else if (toolType === 'getCompanyTeam') {
+                handlerArgs = [args?.companyId];
+            }
+            else {
+                handlerArgs = [args];
+            }
+            const rawResult = await toolConfig.handler(...handlerArgs);
+            const formattedResult = toolConfig.formatResult?.(rawResult) ||
+                JSON.stringify(rawResult, null, 2);
+            result = {
+                content: [{ type: 'text', text: formattedResult }],
+                isError: false,
+            };
+        }
+        else if (toolType === 'search') {
+            result = await handleBasicSearch(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'searchByEmail') {
+            result = await handleSearchByEmail(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'searchByPhone') {
+            result = await handleSearchByPhone(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'searchByCompany') {
+            // Use the tool config's own handler and format the result
+            const rawResult = await toolConfig.handler(request.params.arguments);
+            const formattedResult = toolConfig.formatResult?.(rawResult) ||
+                JSON.stringify(rawResult, null, 2);
+            result = {
+                content: [{ type: 'text', text: formattedResult }],
+                isError: false,
+            };
+        }
+        else if (toolType === 'smartSearch') {
+            result = await handleSmartSearch(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'details') {
+            result = await handleDetailsOperation(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'notes') {
+            result = await handleNotesOperation(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'createNote') {
+            result = await handleCreateNoteOperation(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'getLists') {
+            result = await handleGetListsOperation(request, toolConfig);
+            // Handle CRUD operations (from emergency fix)
+        }
+        else if (toolType === 'create') {
+            result = await handleCreateOperation(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'update') {
+            result = await handleUpdateOperation(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'updateAttribute') {
+            result = await handleUpdateAttributeOperation(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'delete') {
+            result = await handleDeleteOperation(request, toolConfig, resourceType);
+            // Handle additional info operations (from emergency fix)
+        }
+        else if (toolType === 'basicInfo' ||
+            toolType === 'businessInfo' ||
+            toolType === 'contactInfo' ||
+            toolType === 'socialInfo' ||
+            toolType === 'json') {
+            result = await handleInfoOperation(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'fields') {
+            result = await handleFieldsOperation(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'getAttributes') {
+            result = await handleGetAttributesOperation(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'discoverAttributes') {
+            result = await handleDiscoverAttributesOperation(request, toolConfig);
+        }
+        else if (toolType === 'customFields') {
+            result = await handleInfoOperation(request, toolConfig, resourceType);
+            // Handle List operations (from emergency fix)
+        }
+        else if (toolType === 'addRecordToList') {
+            result = await handleAddRecordToListOperation(request, toolConfig);
+        }
+        else if (toolType === 'removeRecordFromList') {
+            result = await handleRemoveRecordFromListOperation(request, toolConfig);
+        }
+        else if (toolType === 'updateListEntry') {
+            result = await handleUpdateListEntryOperation(request, toolConfig);
+        }
+        else if (toolType === 'getListDetails') {
+            result = await handleGetListDetailsOperation(request, toolConfig);
+        }
+        else if (toolType === 'getListEntries') {
+            result = await handleGetListEntriesOperation(request, toolConfig);
+        }
+        else if (toolType === 'filterListEntries') {
+            result = await handleFilterListEntriesOperation(request, toolConfig);
+        }
+        else if (toolType === 'advancedFilterListEntries') {
+            result = await handleAdvancedFilterListEntriesOperation(request, toolConfig);
+        }
+        else if (toolType === 'filterListEntriesByParent') {
+            result = await handleFilterListEntriesByParentOperation(request, toolConfig);
+        }
+        else if (toolType === 'filterListEntriesByParentId') {
+            result = await handleFilterListEntriesByParentIdOperation(request, toolConfig);
+        }
+        else if (toolType === 'getRecordListMemberships') {
+            result = await handleGetRecordListMembershipsOperation(request, toolConfig);
+            // Handle Batch operations (from emergency fix)
+        }
+        else if (toolType === 'batchUpdate') {
+            result = await handleBatchUpdateOperation(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'batchCreate') {
+            result = await handleBatchCreateOperation(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'batchDelete') {
+            result = await handleBatchDeleteOperation(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'batchSearch') {
+            result = await handleBatchSearchOperation(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'batchGetDetails') {
+            result = await handleBatchGetDetailsOperation(request, toolConfig, resourceType);
+            // Handle other advanced search operations (from emergency fix)
+        }
+        else if (toolType === 'advancedSearch') {
+            result = await handleAdvancedSearch(request, toolConfig, resourceType);
+        }
+        else if (toolType === 'searchByDomain') {
+            result = await handleSearchByDomain(request, toolConfig, resourceType);
+            // Handle workspace member operations (Issue #684)
+        }
+        else if (toolType === 'listWorkspaceMembers' ||
+            toolType === 'searchWorkspaceMembers' ||
+            toolType === 'getWorkspaceMember') {
+            // Workspace member tools have simple handlers with formatResult
+            const rawResult = await toolConfig.handler(request.params.arguments);
+            const formattedResult = toolConfig.formatResult?.(rawResult) ||
+                JSON.stringify(rawResult, null, 2);
+            result = {
+                content: [{ type: 'text', text: formattedResult }],
+                isError: false,
+            };
+            // Handle generic record operations
+        }
+        else if (toolType === 'list') {
+            result = await handleListOperation(request, toolConfig);
+        }
+        else if (toolType === 'get') {
+            result = await handleGetOperation(request, toolConfig);
+        }
+        else {
+            // Placeholder for other operations - will be extracted to modules later
+            throw new Error(`Tool handler not implemented for tool type: ${toolType}`);
+        }
+        // Log successful execution
+        logToolSuccess(toolName, toolType, result, timer);
+        // Ensure the response is safely serializable
+        const sanitizedResult = sanitizeMcpResponse(result);
+        return sanitizedResult;
+    }
+    catch (error) {
+        // Get additional error details for better debugging
+        const errorDetails = {
+            tool: toolName,
+            errorType: error && typeof error === 'object'
+                ? error.constructor.name
+                : typeof error,
+            stack: error instanceof Error ? error.stack : undefined,
+            additionalInfo: error && typeof error === 'object' && 'details' in error
+                ? error.details
+                : undefined,
+        };
+        // Log error using enhanced structured logging
+        const finalTimer = timer
+            ? timer
+            : new PerformanceTimer('dispatcher_error_fallback', toolName, OperationType.TOOL_EXECUTION);
+        logToolError(toolName, toolType || 'unknown_type_on_error', error, finalTimer, errorDetails);
+        const { correlationId, requestId, userId } = getLogContext();
+        return createSecureToolErrorResult(error, {
+            module: 'handlers.tools.dispatcher',
+            operation: `execute:${toolName}`,
+            resourceType: toolType,
+            correlationId,
+            requestId,
+            userId,
+        });
+    }
+}
+//# sourceMappingURL=core.js.map

package/dist/handlers/tools/dispatcher/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../../src/handlers/tools/dispatcher/core.ts"],"names":[],"mappings":"AAMA,mBAAmB;AACnB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,kBAAkB,GACnB,MAAM,wCAAwC,CAAC;AAEhD,6BAA6B;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAM9D,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAE9E,4BAA4B;AAC5B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2DAA2D,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iDAAiD,CAAC;AAE1F,iCAAiC;AACjC,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,8BAA8B,EAC9B,qBAAqB,GACtB,MAAM,gDAAgD,CAAC;AAExD,4EAA4E;AAC5E,OAAO,EACL,8BAA8B,EAC9B,mCAAmC,EACnC,8BAA8B,EAC9B,6BAA6B,EAC7B,6BAA6B,EAC7B,gCAAgC,EAChC,wCAAwC,EACxC,wCAAwC,EACxC,0CAA0C,EAC1C,uCAAuC,GACxC,MAAM,iDAAiD,CAAC;AAEzD,kCAAkC;AAClC,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,iDAAiD,CAAC;AAEzD,mCAAmC;AACnC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAC5B,iCAAiC,GAClC,MAAM,gDAAgD,CAAC;AAaxD;;;GAGG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAwB;IAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;IAErC,qDAAqD;IACrD,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,KAAmC,CAAC;IACxC,IAAI,QAA4B,CAAC;IAEjC,8EAA8E;IAC9E,8EAA8E;IAE9E,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QAE1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,kBAAkB,CAAC,QAAQ,EAAE,8BAA8B,CAAC,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC;QAC9C,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,iCAAiC;QAE/D,yDAAyD;QACzD,KAAK,GAAG,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEpD,IAAI,MAAM,CAAC;QAEX,wDAAwD;QACxD,IAAI,YAAY,KAAK,WAAW,EAAE,CAAC;YACjC,2DAA2D;YAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,SAAoC,CAAC;YAEjE,4DAA4D;YAC5D,IAAI,IAAI,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;gBACpC,IAAI,CAAC,aAAa,GAAG,wBAAwB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBAClE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE;oBAC3C,KAAK,EAAE,IAAI,CAAC,aAAa;oBACzB,QAAQ,EAAE,KAAK;iBAChB,CAAC,CAAC;YACL,CAAC;YAED,mEAAmE;YACnE,MAAM,SAAS,GAAG,MAAO,UAAyB,CAAC,OAAO,CACxD,IAA+B,CAChC,CAAC;YAEF,wEAAwE;YACxE,MAAM,iBAAiB,GAAG,CACxB,KAAc,EAId,EAAE,CACF,OAAO,KAAK,KAAK,QAAQ;gBACzB,KAAK,KAAK,IAAI;gBACd,SAAS,IAAI,KAAK;gBAClB,SAAS,IAAI,KAAK,CAAC;YAErB,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;gBACjC,MAAM,SAAS,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;gBACjD,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;gBACrD,OAAO,SAAS,CAAC,CAAC,8CAA8C;YAClE,CAAC;YAED,+DAA+D;YAC/D,IAAI,eAAuB,CAAC;YAC5B,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAClD,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACvD,CAAC;iBAAM,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC;gBACnC,IAAI,CAAC;oBACH,gFAAgF;oBAChF,6DAA6D;oBAC7D,kEAAkE;oBAClE,eAAe,GAAI,UAAU,CAAC,YAAqC,CACjE,SAAS,EACT,IAAI,EAAE,wBAAwB;oBAC9B,IAAI,EAAE,SAAS,CAChB,CAAC;gBACJ,CAAC;gBAAC,MAAM,CAAC;oBACP,eAAe,GAAI,UAAU,CAAC,YAAqC,CACjE,SAAS,CACV,CAAC;gBACJ,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACvD,CAAC;YAED,+EAA+E;YAC/E,uEAAuE;YACvE,IAAI,UAAU,CAAC,gBAAgB,EAAE,CAAC;gBAChC,MAAM,eAAe,GAAG,IAAI,EAAE,aAAmC,CAAC;gBAClE,MAAM,UAAU,GAAG,UAAU,CAAC,gBAAgB,CAC5C,SAAS,EACT,eAAe,CAChB,CAAC;gBACF,MAAM,GAAG;oBACP,OAAO,EAAE;wBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE;wBAClD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE;qBACxC;oBACD,OAAO,EAAE,KAAK;iBACf,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG;oBACP,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;oBAClD,OAAO,EAAE,KAAK;iBACf,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YACtC,yDAAyD;YACzD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,SAAoC,CAAC;YACjE,IAAI,WAAW,GAAc,EAAE,CAAC;YAEhC,mCAAmC;YACnC,IACE,QAAQ,KAAK,qBAAqB;gBAClC,QAAQ,KAAK,yBAAyB,EACtC,CAAC;gBACD,WAAW,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;YAClD,CAAC;iBAAM,IAAI,QAAQ,KAAK,oBAAoB,EAAE,CAAC;gBAC7C,WAAW,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACjC,CAAC;iBAAM,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;gBACzC,WAAW,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,WAAW,GAAG,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YAED,MAAM,SAAS,GAAG,MAAO,UAAyB,CAAC,OAAO,CACxD,GAAG,WAAW,CACf,CAAC;YACF,MAAM,eAAe,GACnB,UAAU,CAAC,YAAY,EAAE,CAAC,SAAS,CAAC;gBACpC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAErC,MAAM,GAAG;gBACP,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;gBAClD,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,GAAG,MAAM,iBAAiB,CAC9B,OAAO,EACP,UAA8B,EAC9B,YAA4B,CAC7B,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;YACxC,MAAM,GAAG,MAAM,mBAAmB,CAChC,OAAO,EACP,UAA8B,EAC9B,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;YACxC,MAAM,GAAG,MAAM,mBAAmB,CAChC,OAAO,EACP,UAA8B,EAC9B,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;YAC1C,0DAA0D;YAC1D,MAAM,SAAS,GAAG,MAAO,UAAyB,CAAC,OAAO,CACxD,OAAO,CAAC,MAAM,CAAC,SAA+C,CAC/D,CAAC;YACF,MAAM,eAAe,GACnB,UAAU,CAAC,YAAY,EAAE,CAAC,SAAS,CAAC;gBACpC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACrC,MAAM,GAAG;gBACP,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;gBAClD,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YACtC,MAAM,GAAG,MAAM,iBAAiB,CAC9B,OAAO,EACP,UAA8B,EAC9B,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,GAAG,MAAM,sBAAsB,CACnC,OAAO,EACP,UAA+B,EAC/B,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YAChC,MAAM,GAAG,MAAM,oBAAoB,CACjC,OAAO,EACP,UAA6B,EAC7B,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YACrC,MAAM,GAAG,MAAM,yBAAyB,CACtC,OAAO,EACP,UAAkC,EAClC,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YACnC,MAAM,GAAG,MAAM,uBAAuB,CACpC,OAAO,EACP,UAAgC,CACjC,CAAC;YAEF,8CAA8C;QAChD,CAAC;aAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,GAAG,MAAM,qBAAqB,CAClC,OAAO,EACP,UAAwB,EACxB,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,GAAG,MAAM,qBAAqB,CAClC,OAAO,EACP,UAAwB,EACxB,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;YAC1C,MAAM,GAAG,MAAM,8BAA8B,CAC3C,OAAO,EACP,UAAwB,EACxB,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,GAAG,MAAM,qBAAqB,CAClC,OAAO,EACP,UAAwB,EACxB,YAAY,CACb,CAAC;YAEF,yDAAyD;QAC3D,CAAC;aAAM,IACL,QAAQ,KAAK,WAAW;YACxB,QAAQ,KAAK,cAAc;YAC3B,QAAQ,KAAK,aAAa;YAC1B,QAAQ,KAAK,YAAY;YACzB,QAAQ,KAAK,MAAM,EACnB,CAAC;YACD,MAAM,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;QACxE,CAAC;aAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;QAC1E,CAAC;aAAM,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;YACxC,MAAM,GAAG,MAAM,4BAA4B,CACzC,OAAO,EACP,UAAU,EACV,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,oBAAoB,EAAE,CAAC;YAC7C,MAAM,GAAG,MAAM,iCAAiC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACxE,CAAC;aAAM,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;YACvC,MAAM,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;YAEtE,8CAA8C;QAChD,CAAC;aAAM,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;YAC1C,MAAM,GAAG,MAAM,8BAA8B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACrE,CAAC;aAAM,IAAI,QAAQ,KAAK,sBAAsB,EAAE,CAAC;YAC/C,MAAM,GAAG,MAAM,mCAAmC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC1E,CAAC;aAAM,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;YAC1C,MAAM,GAAG,MAAM,8BAA8B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACrE,CAAC;aAAM,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;YACzC,MAAM,GAAG,MAAM,6BAA6B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACpE,CAAC;aAAM,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;YACzC,MAAM,GAAG,MAAM,6BAA6B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACpE,CAAC;aAAM,IAAI,QAAQ,KAAK,mBAAmB,EAAE,CAAC;YAC5C,MAAM,GAAG,MAAM,gCAAgC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACvE,CAAC;aAAM,IAAI,QAAQ,KAAK,2BAA2B,EAAE,CAAC;YACpD,MAAM,GAAG,MAAM,wCAAwC,CACrD,OAAO,EACP,UAAU,CACX,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,2BAA2B,EAAE,CAAC;YACpD,MAAM,GAAG,MAAM,wCAAwC,CACrD,OAAO,EACP,UAAU,CACX,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,6BAA6B,EAAE,CAAC;YACtD,MAAM,GAAG,MAAM,0CAA0C,CACvD,OAAO,EACP,UAAU,CACX,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,0BAA0B,EAAE,CAAC;YACnD,MAAM,GAAG,MAAM,uCAAuC,CACpD,OAAO,EACP,UAAU,CACX,CAAC;YAEF,+CAA+C;QACjD,CAAC;aAAM,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YACtC,MAAM,GAAG,MAAM,0BAA0B,CACvC,OAAO,EACP,UAAU,EACV,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YACtC,MAAM,GAAG,MAAM,0BAA0B,CACvC,OAAO,EACP,UAAU,EACV,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YACtC,MAAM,GAAG,MAAM,0BAA0B,CACvC,OAAO,EACP,UAAU,EACV,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YACtC,MAAM,GAAG,MAAM,0BAA0B,CACvC,OAAO,EACP,UAAU,EACV,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;YAC1C,MAAM,GAAG,MAAM,8BAA8B,CAC3C,OAAO,EACP,UAAU,EACV,YAAY,CACb,CAAC;YAEF,+DAA+D;QACjE,CAAC;aAAM,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;YACzC,MAAM,GAAG,MAAM,oBAAoB,CACjC,OAAO,EACP,UAAsC,EACtC,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;YACzC,MAAM,GAAG,MAAM,oBAAoB,CACjC,OAAO,EACP,UAA8B,EAC9B,YAAY,CACb,CAAC;YAEF,kDAAkD;QACpD,CAAC;aAAM,IACL,QAAQ,KAAK,sBAAsB;YACnC,QAAQ,KAAK,wBAAwB;YACrC,QAAQ,KAAK,oBAAoB,EACjC,CAAC;YACD,gEAAgE;YAChE,MAAM,SAAS,GAAG,MAAO,UAAyB,CAAC,OAAO,CACxD,OAAO,CAAC,MAAM,CAAC,SAA+C,CAC/D,CAAC;YACF,MAAM,eAAe,GACnB,UAAU,CAAC,YAAY,EAAE,CAAC,SAAS,CAAC;gBACpC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACrC,MAAM,GAAG;gBACP,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;gBAClD,OAAO,EAAE,KAAK;aACf,CAAC;YAEF,mCAAmC;QACrC,CAAC;aAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC/B,MAAM,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,UAAwB,CAAC,CAAC;QACxE,CAAC;aAAM,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC9B,MAAM,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,UAAwB,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,wEAAwE;YACxE,MAAM,IAAI,KAAK,CACb,+CAA+C,QAAQ,EAAE,CAC1D,CAAC;QACJ,CAAC;QAED,2BAA2B;QAC3B,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAElD,6CAA6C;QAC7C,MAAM,eAAe,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACpD,OAAO,eAAe,CAAC;IACzB,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,oDAAoD;QACpD,MAAM,YAAY,GAAG;YACnB,IAAI,EAAE,QAAQ;YACd,SAAS,EACP,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAChC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI;gBACxB,CAAC,CAAC,OAAO,KAAK;YAClB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YACvD,cAAc,EACZ,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK;gBACtD,CAAC,CAAE,KAA8B,CAAC,OAAO;gBACzC,CAAC,CAAC,SAAS;SAChB,CAAC;QAEF,8CAA8C;QAC9C,MAAM,UAAU,GAAG,KAAK;YACtB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,IAAI,gBAAgB,CAClB,2BAA2B,EAC3B,QAAQ,EACR,aAAa,CAAC,cAAc,CAC7B,CAAC;QAEN,YAAY,CACV,QAAQ,EACR,QAAQ,IAAI,uBAAuB,EACnC,KAAK,EACL,UAAU,EACV,YAAY,CACb,CAAC;QACF,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;QAC7D,OAAO,2BAA2B,CAAC,KAAK,EAAE;YACxC,MAAM,EAAE,2BAA2B;YACnC,SAAS,EAAE,WAAW,QAAQ,EAAE;YAChC,YAAY,EAAE,QAAQ;YACtB,aAAa;YACb,SAAS;YACT,MAAM;SACP,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/handlers/tools/dispatcher/formatting.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Response formatting utilities for tool execution
+ *
+ * Provides consistent formatting for success responses and result messages
+ */
+import { ToolErrorContext } from '../../../types/tool-types.js';
+/**
+ * Formats a company operation success response in a consistent manner
+ *
+ * @param operation - The operation type (e.g., 'create', 'update', 'delete')
+ * @param resourceType - The resource type (e.g., 'companies')
+ * @param resourceId - The ID of the affected resource
+ * @param details - Additional details to include in the response
+ * @returns Formatted success message
+ */
+export declare function formatSuccessResponse(operation: string, resourceType: string, resourceId: string, details?: ToolErrorContext): string;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/handlers/tools/dispatcher/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tools/dispatcher/formatting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,gBAAgB,GACzB,MAAM,CAeR"}

package/dist/handlers/tools/dispatcher/formatting.js

@@ -0,0 +1,25 @@
+/**
+ * Response formatting utilities for tool execution
+ *
+ * Provides consistent formatting for success responses and result messages
+ */
+/**
+ * Formats a company operation success response in a consistent manner
+ *
+ * @param operation - The operation type (e.g., 'create', 'update', 'delete')
+ * @param resourceType - The resource type (e.g., 'companies')
+ * @param resourceId - The ID of the affected resource
+ * @param details - Additional details to include in the response
+ * @returns Formatted success message
+ */
+export function formatSuccessResponse(operation, resourceType, resourceId, details) {
+    let message = `Successfully ${operation}d ${resourceType} record with ID: ${resourceId}`;
+    if (details && Object.keys(details).length > 0) {
+        const detailsText = Object.entries(details)
+            .map(([key, value]) => `${key}: ${typeof value === 'object' ? JSON.stringify(value) : value}`)
+            .join(', ');
+        message += ` (${detailsText})`;
+    }
+    return message;
+}
+//# sourceMappingURL=formatting.js.map

package/dist/handlers/tools/dispatcher/formatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.js","sourceRoot":"","sources":["../../../../src/handlers/tools/dispatcher/formatting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAiB,EACjB,YAAoB,EACpB,UAAkB,EAClB,OAA0B;IAE1B,IAAI,OAAO,GAAG,gBAAgB,SAAS,KAAK,YAAY,oBAAoB,UAAU,EAAE,CAAC;IAEzF,IAAI,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;aACxC,GAAG,CACF,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACf,GAAG,GAAG,KAAK,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CACzE;aACA,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO,IAAI,KAAK,WAAW,GAAG,CAAC;IACjC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/handlers/tools/dispatcher/logging.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Enhanced logging utilities for tool execution using structured logging
+ */
+import { ToolErrorContext } from '../../../types/tool-types.js';
+import { PerformanceTimer } from '../../../utils/logger.js';
+import { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Initialize tool execution context with correlation ID
+ */
+export declare function initializeToolContext(toolName: string): string;
+/**
+ * Create a scoped logger for tool execution
+ */
+export declare function createToolLogger(toolName: string, toolType?: string): import("../../../utils/logger.js").SecureLogger;
+/**
+ * Enhanced tool execution request logging with structured format
+ *
+ * @param toolType - The type of tool being executed (e.g., 'search', 'create', 'update')
+ * @param toolName - The name of the tool as defined in the MCP configuration
+ * @param request - The tool request data
+ * @returns PerformanceTimer for tracking execution duration
+ */
+export declare function logToolRequest(toolType: string, toolName: string, request: CallToolRequest): PerformanceTimer;
+/**
+ * Log successful tool execution
+ *
+ * @param toolName - The name of the tool
+ * @param toolType - The type of tool
+ * @param result - The execution result
+ * @param timer - Performance timer from logToolRequest
+ */
+export declare function logToolSuccess(toolName: string, toolType: string, result: unknown, timer: PerformanceTimer): void;
+/**
+ * Enhanced tool execution error logging with structured format
+ *
+ * @param toolName - The name of the tool where the error occurred
+ * @param toolType - The type of tool where the error occurred
+ * @param error - The error that was caught during execution
+ * @param timer - Performance timer from logToolRequest
+ * @param additionalInfo - Optional additional information about the execution context
+ */
+export declare function logToolError(toolName: string, toolType: string, error: unknown, timer: PerformanceTimer, additionalInfo?: ToolErrorContext): void;
+/**
+ * Log tool validation errors
+ */
+export declare function logToolValidationError(toolName: string, toolType: string, validationError: string, context?: Record<string, unknown>): void;
+/**
+ * Log tool configuration errors
+ */
+export declare function logToolConfigError(toolName: string, configError: string, context?: Record<string, unknown>): void;
+/**
+ * Log API fallback attempts during tool execution
+ */
+export declare function logToolFallback(toolName: string, toolType: string, reason: string, fallbackMethod: string): void;
+//# sourceMappingURL=logging.d.ts.map

package/dist/handlers/tools/dispatcher/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tools/dispatcher/logging.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAQL,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAQrE;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,4CAMnE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,GACvB,gBAAgB,CAkDlB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,gBAAgB,GACtB,IAAI,CA4BN;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,gBAAgB,EACvB,cAAc,GAAE,gBAAqB,GACpC,IAAI,CAmBN;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAQN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,IAAI,CAQN"}