motionmcp 1.0.1 → 2.0.0

package/dist/utils/cache.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimpleCache = void 0;
+const logger_1 = require("./logger");
+const constants_1 = require("./constants");
+class SimpleCache {
+    constructor(ttlSeconds = 300, maxSize = 1000, options = {}) {
+        this.cleanupInterval = null;
+        this.cache = new Map();
+        this.ttl = ttlSeconds * 1000;
+        this.maxSize = maxSize;
+        // Set up automatic cleanup if requested
+        if (options.autoCleanup !== false) { // Default to true for automatic cleanup
+            // Run cleanup periodically at half the TTL interval for efficiency
+            this.cleanupInterval = setInterval(() => this.cleanup(), Math.max(30000, this.ttl / 2));
+            // Allow process to exit even if interval is active
+            if (typeof this.cleanupInterval.unref === 'function') {
+                this.cleanupInterval.unref();
+            }
+        }
+    }
+    /**
+     * Destroy the cache and clean up resources
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        this.cache.clear();
+    }
+    set(key, value) {
+        // Enforce size limit - remove oldest entry if at capacity
+        if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
+            const oldestKey = this.cache.keys().next().value;
+            if (oldestKey !== undefined) {
+                this.cache.delete(oldestKey);
+                (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, 'Cache eviction - removed oldest entry', {
+                    key: oldestKey,
+                    reason: 'maxSize',
+                    currentSize: this.cache.size
+                });
+            }
+        }
+        this.cache.set(key, {
+            value,
+            expiry: Date.now() + this.ttl
+        });
+    }
+    get(key) {
+        const item = this.cache.get(key);
+        if (!item)
+            return null;
+        if (Date.now() > item.expiry) {
+            this.cache.delete(key);
+            return null;
+        }
+        // Implement LRU: move accessed item to the end of insertion order
+        // This makes it the "most recently used" item
+        this.cache.delete(key);
+        this.cache.set(key, item);
+        return item.value;
+    }
+    invalidate(pattern = null) {
+        if (!pattern) {
+            this.cache.clear();
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, 'Cache cleared', { size: 0 });
+            return;
+        }
+        // Invalidate keys matching pattern - use startsWith for precision
+        let invalidatedCount = 0;
+        for (const key of this.cache.keys()) {
+            if (key.startsWith(pattern)) {
+                this.cache.delete(key);
+                invalidatedCount++;
+            }
+        }
+        if (invalidatedCount > 0) {
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, 'Cache invalidation', {
+                pattern,
+                invalidatedCount,
+                remainingSize: this.cache.size
+            });
+        }
+    }
+    // Decorator for caching method results with error handling
+    async withCache(key, fn) {
+        const cached = this.get(key);
+        if (cached !== null) {
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, 'Cache hit', { key });
+            return cached;
+        }
+        try {
+            const result = await fn();
+            this.set(key, result);
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, 'Cache miss - storing', { key });
+            return result;
+        }
+        catch (error) {
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.ERROR, 'Cache function failed', {
+                key,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        }
+    }
+    // Utility method to get cache statistics
+    getStats() {
+        return {
+            size: this.cache.size,
+            maxSize: this.maxSize,
+            ttlSeconds: this.ttl / 1000
+        };
+    }
+    // Clean up expired entries (can be called periodically if needed)
+    cleanup() {
+        const now = Date.now();
+        let cleanedCount = 0;
+        for (const [key, item] of this.cache.entries()) {
+            if (now > item.expiry) {
+                this.cache.delete(key);
+                cleanedCount++;
+            }
+        }
+        if (cleanedCount > 0) {
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, 'Cache cleanup', {
+                cleanedCount,
+                remainingSize: this.cache.size
+            });
+        }
+    }
+}
+exports.SimpleCache = SimpleCache;
+exports.default = SimpleCache;
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

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

package/dist/utils/constants.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Shared constants and error codes for Motion MCP Server utilities
+ */
+export declare const ERROR_CODES: {
+    readonly WORKSPACE_NOT_FOUND: "WORKSPACE_NOT_FOUND";
+    readonly WORKSPACE_ACCESS_DENIED: "WORKSPACE_ACCESS_DENIED";
+    readonly NO_DEFAULT_WORKSPACE: "NO_DEFAULT_WORKSPACE";
+    readonly INVALID_PARAMETERS: "INVALID_PARAMETERS";
+    readonly MISSING_REQUIRED_PARAM: "MISSING_REQUIRED_PARAM";
+    readonly MOTION_API_ERROR: "MOTION_API_ERROR";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly RATE_LIMIT_EXCEEDED: "RATE_LIMIT_EXCEEDED";
+    readonly RETRY_EXHAUSTED: "RETRY_EXHAUSTED";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+};
+export type ErrorCode = typeof ERROR_CODES[keyof typeof ERROR_CODES];
+export declare const WORKSPACE_TYPES: {
+    readonly PERSONAL: "personal";
+    readonly TEAM: "team";
+    readonly UNKNOWN: "unknown";
+};
+export type WorkspaceType = typeof WORKSPACE_TYPES[keyof typeof WORKSPACE_TYPES];
+export declare const MCP_RESPONSE_TYPES: {
+    readonly TEXT: "text";
+    readonly JSON: "json";
+};
+export type McpResponseType = typeof MCP_RESPONSE_TYPES[keyof typeof MCP_RESPONSE_TYPES];
+export declare const DEFAULTS: {
+    readonly WORKSPACE_FALLBACK_TO_DEFAULT: true;
+    readonly WORKSPACE_VALIDATE_ACCESS: false;
+    readonly WORKSPACE_USE_CACHE: true;
+    readonly SEARCH_LIMIT: 40;
+    readonly SEARCH_SCOPE: "both" | "tasks" | "projects";
+    readonly MAX_SUGGESTIONS: 5;
+    readonly TIMEFRAME: "today" | "this_week" | "this_month";
+    readonly INCLUDE_PROJECTS: true;
+};
+export declare const RETRY_CONFIG: {
+    readonly MAX_RETRIES: 3;
+    readonly INITIAL_BACKOFF_MS: 250;
+    readonly MAX_BACKOFF_MS: 30000;
+    readonly JITTER_FACTOR: 0.2;
+    readonly BACKOFF_MULTIPLIER: 2;
+};
+export declare const CACHE_TTL: {
+    readonly WORKSPACES: 600;
+    readonly USERS: 600;
+    readonly PROJECTS: 300;
+    readonly COMMENTS: 60;
+    readonly CUSTOM_FIELDS: 600;
+    readonly RECURRING_TASKS: 300;
+    readonly SCHEDULES: 300;
+};
+export declare const CACHE_TTL_MS_MULTIPLIER = 1000;
+export declare const LIMITS: {
+    readonly COMMENT_MAX_LENGTH: 5000;
+    readonly COMMENT_DISPLAY_LENGTH: 120;
+    readonly CUSTOM_FIELD_NAME_MAX_LENGTH: 255;
+    readonly CUSTOM_FIELD_OPTIONS_MAX_COUNT: 100;
+    readonly DEFAULT_PAGE_SIZE: 50;
+    readonly MAX_PAGE_SIZE: 200;
+    readonly MAX_PAGES: 10;
+    readonly ABSOLUTE_MAX_PAGES: 50;
+    readonly MAX_SEARCH_RESULTS: 100;
+};
+export declare const LOG_LEVELS: {
+    readonly DEBUG: "debug";
+    readonly INFO: "info";
+    readonly WARN: "warn";
+    readonly ERROR: "error";
+};
+export type LogLevel = typeof LOG_LEVELS[keyof typeof LOG_LEVELS];
+export declare const NULL_UNDEFINED_POLICY: {};
+export declare function convertUndefinedToNull<T extends Record<string, any>>(obj: T): T;
+/**
+ * Creates a minimal payload by removing null, undefined, and empty values
+ * This prevents API validation errors from unexpected fields
+ * @param obj - The object to minimize
+ * @returns Clean object with only meaningful values
+ */
+export declare function createMinimalPayload<T extends Record<string, any>>(obj: T): Partial<T>;
+export declare function convertNullToUndefined<T extends Record<string, any>>(obj: T): T;
+//# sourceMappingURL=constants.d.ts.map

package/dist/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,WAAW;;;;;;;;;;;CAkBd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAGrE,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAGjF,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,OAAO,kBAAkB,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAGzF,eAAO,MAAM,QAAQ;;;;;2BAOK,MAAM,GAAG,OAAO,GAAG,UAAU;;wBAM3B,OAAO,GAAG,WAAW,GAAG,YAAY;;CAEtD,CAAC;AAGX,eAAO,MAAM,YAAY;;;;;;CAMf,CAAC;AAGX,eAAO,MAAM,SAAS;;;;;;;;CAQZ,CAAC;AAGX,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAG5C,eAAO,MAAM,MAAM;;;;;;;;;;CAYT,CAAC;AAGX,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAGlE,eAAO,MAAM,qBAAqB,IAYxB,CAAC;AAGX,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAQ/E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAyBtF;AAGD,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAQ/E"}

package/dist/utils/constants.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * Shared constants and error codes for Motion MCP Server utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NULL_UNDEFINED_POLICY = exports.LOG_LEVELS = exports.LIMITS = exports.CACHE_TTL_MS_MULTIPLIER = exports.CACHE_TTL = exports.RETRY_CONFIG = exports.DEFAULTS = exports.MCP_RESPONSE_TYPES = exports.WORKSPACE_TYPES = exports.ERROR_CODES = void 0;
+exports.convertUndefinedToNull = convertUndefinedToNull;
+exports.createMinimalPayload = createMinimalPayload;
+exports.convertNullToUndefined = convertNullToUndefined;
+// Error codes for different types of failures
+exports.ERROR_CODES = {
+    // Workspace related errors
+    WORKSPACE_NOT_FOUND: 'WORKSPACE_NOT_FOUND',
+    WORKSPACE_ACCESS_DENIED: 'WORKSPACE_ACCESS_DENIED',
+    NO_DEFAULT_WORKSPACE: 'NO_DEFAULT_WORKSPACE',
+    // Validation errors
+    INVALID_PARAMETERS: 'INVALID_PARAMETERS',
+    MISSING_REQUIRED_PARAM: 'MISSING_REQUIRED_PARAM',
+    // API related errors
+    MOTION_API_ERROR: 'MOTION_API_ERROR',
+    NETWORK_ERROR: 'NETWORK_ERROR',
+    RATE_LIMIT_EXCEEDED: 'RATE_LIMIT_EXCEEDED',
+    RETRY_EXHAUSTED: 'RETRY_EXHAUSTED',
+    // General errors
+    INTERNAL_ERROR: 'INTERNAL_ERROR'
+};
+// Workspace types
+exports.WORKSPACE_TYPES = {
+    PERSONAL: 'personal',
+    TEAM: 'team',
+    UNKNOWN: 'unknown'
+};
+// MCP response types
+exports.MCP_RESPONSE_TYPES = {
+    TEXT: 'text',
+    JSON: 'json'
+};
+// Default values for common parameters
+exports.DEFAULTS = {
+    WORKSPACE_FALLBACK_TO_DEFAULT: true,
+    WORKSPACE_VALIDATE_ACCESS: false,
+    WORKSPACE_USE_CACHE: true,
+    // Search defaults
+    SEARCH_LIMIT: 40,
+    SEARCH_SCOPE: 'both',
+    // Suggestion defaults
+    MAX_SUGGESTIONS: 5,
+    // Workload analysis defaults
+    TIMEFRAME: 'this_week',
+    INCLUDE_PROJECTS: true
+};
+// Retry configuration
+exports.RETRY_CONFIG = {
+    MAX_RETRIES: 3,
+    INITIAL_BACKOFF_MS: 250,
+    MAX_BACKOFF_MS: 30000, // 30 seconds max
+    JITTER_FACTOR: 0.2, // 20% jitter
+    BACKOFF_MULTIPLIER: 2
+};
+// Cache TTL configuration (in seconds)
+exports.CACHE_TTL = {
+    WORKSPACES: 600, // 10 minutes
+    USERS: 600, // 10 minutes
+    PROJECTS: 300, // 5 minutes
+    COMMENTS: 60, // 1 minute
+    CUSTOM_FIELDS: 600, // 10 minutes
+    RECURRING_TASKS: 300, // 5 minutes (same as projects)
+    SCHEDULES: 300 // 5 minutes (schedule data changes frequently)
+};
+// Cache TTL conversion factor
+exports.CACHE_TTL_MS_MULTIPLIER = 1000; // Convert seconds to milliseconds
+// Content limits and validation
+exports.LIMITS = {
+    COMMENT_MAX_LENGTH: 5000, // Maximum comment length in characters
+    COMMENT_DISPLAY_LENGTH: 120, // Maximum length for display before truncation
+    CUSTOM_FIELD_NAME_MAX_LENGTH: 255, // Maximum custom field name length
+    CUSTOM_FIELD_OPTIONS_MAX_COUNT: 100, // Maximum number of options for select fields
+    // Pagination limits to prevent resource exhaustion
+    DEFAULT_PAGE_SIZE: 50, // Default number of items per page
+    MAX_PAGE_SIZE: 200, // Maximum allowed page size
+    MAX_PAGES: 10, // Maximum number of pages to fetch
+    ABSOLUTE_MAX_PAGES: 50, // Absolute maximum pages to prevent infinite loops
+    MAX_SEARCH_RESULTS: 100 // Maximum search results to return
+};
+// Logging levels for MCP compliance
+exports.LOG_LEVELS = {
+    DEBUG: 'debug',
+    INFO: 'info',
+    WARN: 'warn',
+    ERROR: 'error'
+};
+// Null vs Undefined Policy
+exports.NULL_UNDEFINED_POLICY = {
+// Use undefined for:
+// - Optional parameters that weren't provided
+// - Missing object properties
+// - Function returns when item not found
+// - Uninitialized values
+// Use null for:
+// - Explicit absence of value from API
+// - Database null values
+// - Cleared/reset state (e.g., cache reset)
+// - Values that need to be explicitly sent as null to external APIs
+};
+// Helper to convert undefined to null for API compatibility
+function convertUndefinedToNull(obj) {
+    const result = { ...obj };
+    for (const key in result) {
+        if (result[key] === undefined) {
+            result[key] = null;
+        }
+    }
+    return result;
+}
+/**
+ * Creates a minimal payload by removing null, undefined, and empty values
+ * This prevents API validation errors from unexpected fields
+ * @param obj - The object to minimize
+ * @returns Clean object with only meaningful values
+ */
+function createMinimalPayload(obj) {
+    const result = {};
+    for (const key in obj) {
+        const value = obj[key];
+        // Skip null, undefined, empty strings, and empty arrays
+        if (value === null || value === undefined || value === '') {
+            continue;
+        }
+        // Skip empty arrays
+        if (Array.isArray(value) && value.length === 0) {
+            continue;
+        }
+        // Skip empty objects (but preserve objects with properties)
+        if (typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length === 0) {
+            continue;
+        }
+        result[key] = value;
+    }
+    return result;
+}
+// Helper to convert null to undefined for internal consistency
+function convertNullToUndefined(obj) {
+    const result = { ...obj };
+    for (const key in result) {
+        if (result[key] === null) {
+            delete result[key]; // This makes it undefined
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

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

package/dist/utils/errorHandling.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Error Handling Utilities - Custom error classes and MCP response formatters
+ *
+ * This module provides custom error classes and MCP-compliant error response
+ * formatting to ensure consistent error handling across all handlers.
+ */
+import { ErrorCode } from './constants';
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+interface ErrorContext {
+    [key: string]: any;
+}
+/**
+ * Base error class for Motion API related errors
+ */
+export declare class MotionApiError extends Error {
+    readonly code: ErrorCode;
+    readonly context: ErrorContext;
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext);
+}
+/**
+ * Error class for parameter validation failures
+ */
+export declare class ValidationError extends Error {
+    readonly code: ErrorCode;
+    readonly parameter: string | null;
+    readonly context: ErrorContext;
+    constructor(message: string, parameter?: string | null, context?: ErrorContext);
+}
+/**
+ * Error class for workspace-specific issues
+ */
+export declare class WorkspaceError extends Error {
+    readonly code: ErrorCode;
+    readonly context: ErrorContext;
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext);
+}
+/**
+ * Format an error for MCP protocol response
+ */
+export declare function formatMcpError(error: Error | MotionApiError, _context?: ErrorContext): CallToolResult;
+/**
+ * Format a success response for MCP protocol
+ */
+export declare function formatMcpSuccess(text: string): CallToolResult;
+/**
+ * Create a standardized error response with context
+ */
+export declare function createErrorResponse(message: string, code?: ErrorCode, context?: ErrorContext): CallToolResult;
+export {};
+//# sourceMappingURL=errorHandling.d.ts.map

package/dist/utils/errorHandling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandling.d.ts","sourceRoot":"","sources":["../../src/utils/errorHandling.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAmC,SAAS,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,UAAU,YAAY;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,OAAO,EAAE,YAAY,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,SAAwC,EAAE,OAAO,GAAE,YAAiB;CAMxG;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,SAAgB,OAAO,EAAE,YAAY,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,EAAE,OAAO,GAAE,YAAiB;CAOzF;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,OAAO,EAAE,YAAY,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,SAA2C,EAAE,OAAO,GAAE,YAAiB;CAM3G;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,cAAc,EAAE,QAAQ,GAAE,YAAiB,GAAG,cAAc,CAYzG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAS7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,SAAsC,EAC5C,OAAO,GAAE,YAAiB,GACzB,cAAc,CAGhB"}

package/dist/utils/errorHandling.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Error Handling Utilities - Custom error classes and MCP response formatters
+ *
+ * This module provides custom error classes and MCP-compliant error response
+ * formatting to ensure consistent error handling across all handlers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkspaceError = exports.ValidationError = exports.MotionApiError = void 0;
+exports.formatMcpError = formatMcpError;
+exports.formatMcpSuccess = formatMcpSuccess;
+exports.createErrorResponse = createErrorResponse;
+const constants_1 = require("./constants");
+/**
+ * Base error class for Motion API related errors
+ */
+class MotionApiError extends Error {
+    constructor(message, code = constants_1.ERROR_CODES.MOTION_API_ERROR, context = {}) {
+        super(message);
+        this.name = 'MotionApiError';
+        this.code = code;
+        this.context = context;
+    }
+}
+exports.MotionApiError = MotionApiError;
+/**
+ * Error class for parameter validation failures
+ */
+class ValidationError extends Error {
+    constructor(message, parameter = null, context = {}) {
+        super(message);
+        this.name = 'ValidationError';
+        this.code = constants_1.ERROR_CODES.INVALID_PARAMETERS;
+        this.parameter = parameter;
+        this.context = context;
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Error class for workspace-specific issues
+ */
+class WorkspaceError extends Error {
+    constructor(message, code = constants_1.ERROR_CODES.WORKSPACE_NOT_FOUND, context = {}) {
+        super(message);
+        this.name = 'WorkspaceError';
+        this.code = code;
+        this.context = context;
+    }
+}
+exports.WorkspaceError = WorkspaceError;
+/**
+ * Format an error for MCP protocol response
+ */
+function formatMcpError(error, _context = {}) {
+    const errorMessage = error.message || 'An unknown error occurred';
+    return {
+        content: [
+            {
+                type: constants_1.MCP_RESPONSE_TYPES.TEXT,
+                text: `Error: ${errorMessage}`
+            }
+        ],
+        isError: true
+    };
+}
+/**
+ * Format a success response for MCP protocol
+ */
+function formatMcpSuccess(text) {
+    return {
+        content: [
+            {
+                type: constants_1.MCP_RESPONSE_TYPES.TEXT,
+                text
+            }
+        ]
+    };
+}
+/**
+ * Create a standardized error response with context
+ */
+function createErrorResponse(message, code = constants_1.ERROR_CODES.INTERNAL_ERROR, context = {}) {
+    const error = new MotionApiError(message, code, context);
+    return formatMcpError(error, context);
+}
+//# sourceMappingURL=errorHandling.js.map

package/dist/utils/errorHandling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandling.js","sourceRoot":"","sources":["../../src/utils/errorHandling.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA2DH,wCAYC;AAKD,4CASC;AAKD,kDAOC;AA/FD,2CAAyE;AAOzE;;GAEG;AACH,MAAa,cAAe,SAAQ,KAAK;IAIvC,YAAY,OAAe,EAAE,OAAkB,uBAAW,CAAC,gBAAgB,EAAE,UAAwB,EAAE;QACrG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAVD,wCAUC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,KAAK;IAKxC,YAAY,OAAe,EAAE,YAA2B,IAAI,EAAE,UAAwB,EAAE;QACtF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,uBAAW,CAAC,kBAAkB,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAZD,0CAYC;AAED;;GAEG;AACH,MAAa,cAAe,SAAQ,KAAK;IAIvC,YAAY,OAAe,EAAE,OAAkB,uBAAW,CAAC,mBAAmB,EAAE,UAAwB,EAAE;QACxG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAVD,wCAUC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,KAA6B,EAAE,WAAyB,EAAE;IACvF,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,IAAI,2BAA2B,CAAC;IAElE,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,8BAAkB,CAAC,IAAI;gBAC7B,IAAI,EAAE,UAAU,YAAY,EAAE;aAC/B;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,8BAAkB,CAAC,IAAI;gBAC7B,IAAI;aACL;SACF;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CACjC,OAAe,EACf,OAAkB,uBAAW,CAAC,cAAc,EAC5C,UAAwB,EAAE;IAE1B,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzD,OAAO,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Central export point for Motion MCP Server utilities
+ *
+ * This module provides a single import point for all utility functions,
+ * classes, and constants used throughout the Motion MCP Server.
+ */
+export * from './constants';
+export * from './errorHandling';
+export * from './responseFormatters';
+export * from './parameterUtils';
+export { WorkspaceResolver } from './workspaceResolver';
+export { mcpLog } from './logger';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,aAAa,CAAC;AAG5B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Central export point for Motion MCP Server utilities
+ *
+ * This module provides a single import point for all utility functions,
+ * classes, and constants used throughout the Motion MCP Server.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpLog = exports.WorkspaceResolver = void 0;
+// Export all constants
+__exportStar(require("./constants"), exports);
+// Export error handling utilities
+__exportStar(require("./errorHandling"), exports);
+// Export response formatters
+__exportStar(require("./responseFormatters"), exports);
+// Export parameter utilities
+__exportStar(require("./parameterUtils"), exports);
+// Export WorkspaceResolver
+var workspaceResolver_1 = require("./workspaceResolver");
+Object.defineProperty(exports, "WorkspaceResolver", { enumerable: true, get: function () { return workspaceResolver_1.WorkspaceResolver; } });
+// Export logger
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "mcpLog", { enumerable: true, get: function () { return logger_1.mcpLog; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;AAEH,uBAAuB;AACvB,8CAA4B;AAE5B,kCAAkC;AAClC,kDAAgC;AAEhC,6BAA6B;AAC7B,uDAAqC;AAErC,6BAA6B;AAC7B,mDAAiC;AAEjC,2BAA2B;AAC3B,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAE1B,gBAAgB;AAChB,mCAAkC;AAAzB,gGAAA,MAAM,OAAA"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Centralized MCP-compliant logger
+ * Outputs structured JSON logs to stderr as required by MCP protocol
+ */
+import { LogLevel } from './constants';
+/**
+ * MCP-compliant logger that outputs to stderr in JSON format
+ * @param level - Log level (ERROR, WARN, INFO, DEBUG)
+ * @param message - Log message
+ * @param extra - Additional context data
+ */
+export declare const mcpLog: (level: LogLevel, message: string, extra?: Record<string, any>) => void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAyBvC;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,QAAQ,EAAE,SAAS,MAAM,EAAE,QAAO,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,KAAG,IAY1F,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Centralized MCP-compliant logger
+ * Outputs structured JSON logs to stderr as required by MCP protocol
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpLog = void 0;
+const SENSITIVE_FIELDS = ['apiKey', 'password', 'token', 'secret', 'authorization'];
+/**
+ * Sanitizes sensitive information from log data
+ */
+function sanitizeLogData(data) {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(data)) {
+        // Check if key contains sensitive field names
+        if (SENSITIVE_FIELDS.some(field => key.toLowerCase().includes(field))) {
+            sanitized[key] = '[REDACTED]';
+        }
+        else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            // Recursively sanitize nested objects
+            sanitized[key] = sanitizeLogData(value);
+        }
+        else {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+/**
+ * MCP-compliant logger that outputs to stderr in JSON format
+ * @param level - Log level (ERROR, WARN, INFO, DEBUG)
+ * @param message - Log message
+ * @param extra - Additional context data
+ */
+const mcpLog = (level, message, extra = {}) => {
+    const sanitizedExtra = sanitizeLogData(extra);
+    const logEntry = {
+        level,
+        msg: message,
+        time: new Date().toISOString(),
+        ...sanitizedExtra
+    };
+    // MCP servers should log to stderr in JSON format
+    console.error(JSON.stringify(logEntry));
+};
+exports.mcpLog = mcpLog;
+//# sourceMappingURL=logger.js.map