motionmcp 1.0.1 → 2.0.0

package/dist/utils/sanitize.js

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * Input Sanitization Utilities
+ *
+ * Provides secure sanitization functions for user-provided content
+ * to prevent injection attacks and ensure data integrity.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeTextContent = sanitizeTextContent;
+exports.isValidSanitizedContent = isValidSanitizedContent;
+exports.sanitizeCommentContent = sanitizeCommentContent;
+exports.sanitizeDescription = sanitizeDescription;
+exports.sanitizeName = sanitizeName;
+const constants_1 = require("./constants");
+/**
+ * Sanitize user-provided text content for safe storage and transmission
+ * Removes dangerous HTML tags, script content, and other potentially harmful input
+ *
+ * @param input - The user input to sanitize
+ * @returns Sanitized string safe for storage/transmission
+ */
+function sanitizeTextContent(input) {
+    if (!input || typeof input !== 'string') {
+        return '';
+    }
+    // Trim whitespace
+    const trimmed = input.trim();
+    if (trimmed.length === 0) {
+        return '';
+    }
+    // Remove or escape potentially dangerous characters and patterns
+    let sanitized = trimmed
+        // Remove script tags and their content
+        .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
+        // Remove HTML tags but keep the content
+        .replace(/<[^>]*>/g, '')
+        // Escape remaining angle brackets
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        // Escape quotes to prevent attribute injection
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;')
+        // Escape ampersands (but do it last to avoid double-escaping)
+        .replace(/&(?!(lt|gt|quot|#39|amp);)/g, '&amp;');
+    // Limit length to prevent abuse - use consistent limit from constants
+    if (sanitized.length > constants_1.LIMITS.COMMENT_MAX_LENGTH) {
+        sanitized = sanitized.substring(0, constants_1.LIMITS.COMMENT_MAX_LENGTH);
+    }
+    return sanitized;
+}
+/**
+ * Validate that sanitized content is not empty after sanitization
+ *
+ * @param original - Original user input
+ * @param sanitized - Sanitized version
+ * @returns True if content is valid after sanitization
+ */
+function isValidSanitizedContent(original, sanitized) {
+    // If original had content but sanitized is empty, it was likely malicious
+    if (original && original.trim().length > 0 && sanitized.length === 0) {
+        return false;
+    }
+    // Must have some actual content
+    return sanitized.length > 0;
+}
+/**
+ * Sanitize and validate comment content
+ *
+ * @param content - Comment content to sanitize
+ * @returns Object with sanitized content and validation result
+ */
+function sanitizeCommentContent(content) {
+    const sanitized = sanitizeTextContent(content);
+    const isValid = isValidSanitizedContent(content, sanitized);
+    if (!isValid && content && content.trim().length > 0) {
+        return {
+            sanitized: '',
+            isValid: false,
+            error: 'Comment content contains invalid or potentially harmful content'
+        };
+    }
+    if (!isValid) {
+        return {
+            sanitized: '',
+            isValid: false,
+            error: 'Comment content cannot be empty'
+        };
+    }
+    return {
+        sanitized,
+        isValid: true
+    };
+}
+/**
+ * Sanitize task/project description content
+ * Similar to comment content but allows empty descriptions
+ *
+ * @param description - Task or project description to sanitize
+ * @returns Sanitized description or undefined if empty/invalid
+ */
+function sanitizeDescription(description) {
+    if (!description || typeof description !== 'string') {
+        return undefined;
+    }
+    const sanitized = sanitizeTextContent(description);
+    if (sanitized === '') {
+        return undefined;
+    }
+    // Check if sanitization removed significant content (potential attack)
+    if (description.trim().length > 0 && !isValidSanitizedContent(description, sanitized)) {
+        throw new Error('Description contains invalid or potentially harmful content');
+    }
+    return sanitized;
+}
+/**
+ * Sanitize task/project name content
+ * Names are required and must be non-empty after sanitization
+ *
+ * @param name - Task or project name to sanitize
+ * @returns Sanitized name
+ * @throws Error if name is empty or contains invalid content
+ */
+function sanitizeName(name) {
+    if (!name || typeof name !== 'string') {
+        throw new Error('Name is required');
+    }
+    const sanitized = sanitizeTextContent(name);
+    if (sanitized === '') {
+        throw new Error('Name cannot be empty');
+    }
+    // Check if sanitization removed significant content (potential attack)
+    if (!isValidSanitizedContent(name, sanitized)) {
+        throw new Error('Name contains invalid or potentially harmful content');
+    }
+    return sanitized;
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/utils/sanitize.js.map

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

package/dist/utils/validator.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Input Validation Service - Runtime validation for MCP requests
+ *
+ * This module provides runtime validation of incoming MCP requests
+ * against their defined schemas using AJV, ensuring type safety
+ * at runtime and preventing malformed inputs from causing errors.
+ */
+import { McpToolDefinition } from '../types/mcp';
+export declare class InputValidator {
+    private ajv;
+    private validators;
+    constructor();
+    /**
+     * Compile and cache validators for all tool definitions
+     */
+    initializeValidators(toolDefinitions: McpToolDefinition[]): void;
+    /**
+     * Validate input arguments against tool schema
+     */
+    validateInput(toolName: string, args: unknown): {
+        valid: boolean;
+        errors?: string;
+    };
+    /**
+     * Get detailed validation errors for debugging
+     */
+    getDetailedErrors(toolName: string): any[] | undefined;
+    /**
+     * Clear all cached validators
+     */
+    clearValidators(): void;
+    /**
+     * Check if a validator exists for a tool
+     */
+    hasValidator(toolName: string): boolean;
+}
+//# sourceMappingURL=validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/utils/validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,UAAU,CAAgC;;IAWlD;;OAEG;IACH,oBAAoB,CAAC,eAAe,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAOhE;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAsBnF;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,EAAE,GAAG,SAAS;IAKtD;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAGxC"}

package/dist/utils/validator.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Input Validation Service - Runtime validation for MCP requests
+ *
+ * This module provides runtime validation of incoming MCP requests
+ * against their defined schemas using AJV, ensuring type safety
+ * at runtime and preventing malformed inputs from causing errors.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InputValidator = void 0;
+const ajv_1 = __importDefault(require("ajv"));
+class InputValidator {
+    constructor() {
+        this.ajv = new ajv_1.default({
+            allErrors: true,
+            coerceTypes: true, // Automatically coerce types when safe
+            allowUnionTypes: true // Allow union types in schemas
+        });
+        this.validators = new Map();
+    }
+    /**
+     * Compile and cache validators for all tool definitions
+     */
+    initializeValidators(toolDefinitions) {
+        for (const tool of toolDefinitions) {
+            const validator = this.ajv.compile(tool.inputSchema);
+            this.validators.set(tool.name, validator);
+        }
+    }
+    /**
+     * Validate input arguments against tool schema
+     */
+    validateInput(toolName, args) {
+        const validator = this.validators.get(toolName);
+        if (!validator) {
+            return {
+                valid: false,
+                errors: `No validator found for tool: ${toolName}`
+            };
+        }
+        const valid = validator(args);
+        if (!valid) {
+            return {
+                valid: false,
+                errors: this.ajv.errorsText(validator.errors)
+            };
+        }
+        return { valid: true };
+    }
+    /**
+     * Get detailed validation errors for debugging
+     */
+    getDetailedErrors(toolName) {
+        const validator = this.validators.get(toolName);
+        return validator?.errors || undefined;
+    }
+    /**
+     * Clear all cached validators
+     */
+    clearValidators() {
+        this.validators.clear();
+    }
+    /**
+     * Check if a validator exists for a tool
+     */
+    hasValidator(toolName) {
+        return this.validators.has(toolName);
+    }
+}
+exports.InputValidator = InputValidator;
+//# sourceMappingURL=validator.js.map

package/dist/utils/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/utils/validator.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;AAEH,8CAA4C;AAG5C,MAAa,cAAc;IAIzB;QACE,IAAI,CAAC,GAAG,GAAG,IAAI,aAAG,CAAC;YACjB,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,IAAI,EAAG,uCAAuC;YAC3D,eAAe,EAAE,IAAI,CAAE,+BAA+B;SACvD,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,eAAoC;QACvD,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;YACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACrD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,QAAgB,EAAE,IAAa;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEhD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,gCAAgC,QAAQ,EAAE;aACnD,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAE9B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC;aAC9C,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,QAAgB;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChD,OAAO,SAAS,EAAE,MAAM,IAAI,SAAS,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;CACF;AArED,wCAqEC"}

package/dist/utils/workspaceResolver.d.ts

@@ -0,0 +1,40 @@
+/**
+ * WorkspaceResolver - Centralized workspace resolution logic
+ *
+ * This class handles all workspace resolution patterns used throughout
+ * the Motion MCP Server, including ID resolution, name lookups, and
+ * fallback to default workspace behavior.
+ */
+import { MotionWorkspace } from '../types/motion';
+import { MotionApiService } from '../services/motionApi';
+interface WorkspaceResolverOptions {
+    fallbackToDefault?: boolean;
+    validateAccess?: boolean;
+    useCache?: boolean;
+}
+interface WorkspaceArgs {
+    workspaceId?: string;
+    workspaceName?: string;
+}
+export declare class WorkspaceResolver {
+    private motionService;
+    constructor(motionApiService: MotionApiService);
+    /**
+     * Main workspace resolution method - handles all workspace resolution patterns
+     */
+    resolveWorkspace(args?: WorkspaceArgs, options?: WorkspaceResolverOptions): Promise<MotionWorkspace>;
+    /**
+     * Resolve workspace by ID - validates the workspace exists
+     */
+    private resolveByWorkspaceId;
+    /**
+     * Resolve workspace by name - finds matching workspace
+     */
+    private resolveByWorkspaceName;
+    /**
+     * Resolve default workspace - gets the first available workspace
+     */
+    private resolveDefaultWorkspace;
+}
+export {};
+//# sourceMappingURL=workspaceResolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceResolver.d.ts","sourceRoot":"","sources":["../../src/utils/workspaceResolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,UAAU,wBAAwB;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,aAAa;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,aAAa,CAAmB;gBAE5B,gBAAgB,EAAE,gBAAgB;IAO9C;;OAEG;IACG,gBAAgB,CACpB,IAAI,GAAE,aAAkB,EACxB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,eAAe,CAAC;IAqF3B;;OAEG;YACW,oBAAoB;IA2ClC;;OAEG;YACW,sBAAsB;IA+DpC;;OAEG;YACW,uBAAuB;CAyCtC"}

package/dist/utils/workspaceResolver.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * WorkspaceResolver - Centralized workspace resolution logic
+ *
+ * This class handles all workspace resolution patterns used throughout
+ * the Motion MCP Server, including ID resolution, name lookups, and
+ * fallback to default workspace behavior.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkspaceResolver = void 0;
+const constants_1 = require("./constants");
+const errorHandling_1 = require("./errorHandling");
+const logger_1 = require("./logger");
+class WorkspaceResolver {
+    constructor(motionApiService) {
+        if (!motionApiService) {
+            throw new Error('MotionApiService is required for WorkspaceResolver');
+        }
+        this.motionService = motionApiService;
+    }
+    /**
+     * Main workspace resolution method - handles all workspace resolution patterns
+     */
+    async resolveWorkspace(args = {}, options = {}) {
+        const { workspaceId, workspaceName } = args;
+        const { fallbackToDefault = constants_1.DEFAULTS.WORKSPACE_FALLBACK_TO_DEFAULT, validateAccess = constants_1.DEFAULTS.WORKSPACE_VALIDATE_ACCESS
+        // useCache = DEFAULTS.WORKSPACE_USE_CACHE // Will be used in future caching implementation
+         } = options;
+        (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, 'Starting workspace resolution', {
+            method: 'resolveWorkspace',
+            workspaceId,
+            workspaceName,
+            fallbackToDefault,
+            validateAccess
+        });
+        try {
+            let resolvedWorkspace = null;
+            // Case 1: Direct workspace ID provided
+            if (workspaceId) {
+                (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, 'Resolving by workspace ID', {
+                    method: 'resolveWorkspace',
+                    workspaceId
+                });
+                if (validateAccess) {
+                    resolvedWorkspace = await this.resolveByWorkspaceId(workspaceId);
+                }
+                else {
+                    // When not validating, just return the ID as-is
+                    resolvedWorkspace = {
+                        id: workspaceId,
+                        name: 'Unknown Workspace',
+                        teamId: 'unknown',
+                        type: constants_1.WORKSPACE_TYPES.UNKNOWN,
+                        labels: [],
+                        statuses: []
+                    };
+                }
+            }
+            // Case 2: Workspace name provided
+            else if (workspaceName) {
+                (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, 'Resolving by workspace name', {
+                    method: 'resolveWorkspace',
+                    workspaceName
+                });
+                resolvedWorkspace = await this.resolveByWorkspaceName(workspaceName);
+            }
+            // Case 3: Fallback to default workspace
+            else if (fallbackToDefault) {
+                (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, 'Falling back to default workspace', {
+                    method: 'resolveWorkspace'
+                });
+                resolvedWorkspace = await this.resolveDefaultWorkspace();
+            }
+            // Case 4: No workspace could be resolved
+            if (!resolvedWorkspace) {
+                throw new errorHandling_1.WorkspaceError('No workspace specified and no default workspace available', constants_1.ERROR_CODES.NO_DEFAULT_WORKSPACE, { fallbackToDefault });
+            }
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.INFO, 'Workspace resolved successfully', {
+                method: 'resolveWorkspace',
+                resolvedId: resolvedWorkspace.id,
+                resolvedName: resolvedWorkspace.name
+            });
+            return resolvedWorkspace;
+        }
+        catch (error) {
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.ERROR, 'Failed to resolve workspace', {
+                method: 'resolveWorkspace',
+                error: error instanceof Error ? error.message : 'Unknown error',
+                workspaceId,
+                workspaceName
+            });
+            throw error;
+        }
+    }
+    /**
+     * Resolve workspace by ID - validates the workspace exists
+     */
+    async resolveByWorkspaceId(workspaceId) {
+        (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, 'Fetching workspace by ID', {
+            method: 'resolveByWorkspaceId',
+            workspaceId
+        });
+        try {
+            const workspaces = await this.motionService.getWorkspaces();
+            const workspace = workspaces.find((w) => w.id === workspaceId);
+            if (!workspace) {
+                throw new errorHandling_1.WorkspaceError(`Workspace with ID "${workspaceId}" not found`, constants_1.ERROR_CODES.WORKSPACE_NOT_FOUND, { workspaceId, availableCount: workspaces.length });
+            }
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.INFO, 'Workspace found by ID', {
+                method: 'resolveByWorkspaceId',
+                workspaceId,
+                workspaceName: workspace.name
+            });
+            return workspace;
+        }
+        catch (error) {
+            if (error instanceof errorHandling_1.WorkspaceError) {
+                throw error;
+            }
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.ERROR, 'Failed to fetch workspace by ID', {
+                method: 'resolveByWorkspaceId',
+                error: error instanceof Error ? error.message : 'Unknown error'
+            });
+            throw new errorHandling_1.WorkspaceError(`Failed to validate workspace ID "${workspaceId}"`, constants_1.ERROR_CODES.WORKSPACE_ACCESS_DENIED, { workspaceId });
+        }
+    }
+    /**
+     * Resolve workspace by name - finds matching workspace
+     */
+    async resolveByWorkspaceName(workspaceName) {
+        (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, 'Fetching workspace by name', {
+            method: 'resolveByWorkspaceName',
+            workspaceName
+        });
+        try {
+            const workspaces = await this.motionService.getWorkspaces();
+            // Exact match first
+            let workspace = workspaces.find((w) => w.name === workspaceName);
+            // Case-insensitive match as fallback
+            if (!workspace) {
+                const lowerName = workspaceName.toLowerCase();
+                workspace = workspaces.find((w) => w.name.toLowerCase() === lowerName);
+            }
+            if (!workspace) {
+                // Provide helpful error with available workspace names
+                const availableNames = workspaces.map((w) => w.name).join(', ');
+                throw new errorHandling_1.WorkspaceError(`Workspace "${workspaceName}" not found. Available workspaces: ${availableNames}`, constants_1.ERROR_CODES.WORKSPACE_NOT_FOUND, {
+                    requestedName: workspaceName,
+                    availableWorkspaces: workspaces.map((w) => ({
+                        id: w.id,
+                        name: w.name
+                    }))
+                });
+            }
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.INFO, 'Workspace found by name', {
+                method: 'resolveByWorkspaceName',
+                workspaceName,
+                workspaceId: workspace.id
+            });
+            return workspace;
+        }
+        catch (error) {
+            if (error instanceof errorHandling_1.WorkspaceError) {
+                throw error;
+            }
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.ERROR, 'Failed to fetch workspace by name', {
+                method: 'resolveByWorkspaceName',
+                error: error instanceof Error ? error.message : 'Unknown error'
+            });
+            throw new errorHandling_1.WorkspaceError(`Failed to resolve workspace name "${workspaceName}"`, constants_1.ERROR_CODES.MOTION_API_ERROR, { workspaceName });
+        }
+    }
+    /**
+     * Resolve default workspace - gets the first available workspace
+     */
+    async resolveDefaultWorkspace() {
+        (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, 'Fetching default workspace', {
+            method: 'resolveDefaultWorkspace'
+        });
+        try {
+            const workspaces = await this.motionService.getWorkspaces();
+            if (!workspaces || workspaces.length === 0) {
+                throw new errorHandling_1.WorkspaceError('No workspaces available', constants_1.ERROR_CODES.NO_DEFAULT_WORKSPACE);
+            }
+            // Use the first workspace as default
+            const defaultWorkspace = workspaces[0];
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.INFO, 'Using default workspace', {
+                method: 'resolveDefaultWorkspace',
+                workspaceId: defaultWorkspace.id,
+                workspaceName: defaultWorkspace.name
+            });
+            return defaultWorkspace;
+        }
+        catch (error) {
+            if (error instanceof errorHandling_1.WorkspaceError) {
+                throw error;
+            }
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.ERROR, 'Failed to fetch default workspace', {
+                method: 'resolveDefaultWorkspace',
+                error: error instanceof Error ? error.message : 'Unknown error'
+            });
+            throw new errorHandling_1.WorkspaceError('Failed to fetch default workspace', constants_1.ERROR_CODES.MOTION_API_ERROR);
+        }
+    }
+}
+exports.WorkspaceResolver = WorkspaceResolver;
+//# sourceMappingURL=workspaceResolver.js.map

package/dist/utils/workspaceResolver.js.map

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

package/package.json

@@ -1,29 +1,53 @@
 {
   "name": "motionmcp",
-  "version": "1.0.1",
-  "description": "",
-  "main": "index.js",
+  "version": "2.0.0",
+  "description": "MCP server for Motion API integration - manage projects, tasks, and workspaces from LLMs",
+  "main": "dist/mcp-server.js",
   "bin": {
-    "motionmcp": "./src/index.js"
+    "motionmcp": "./dist/mcp-server.js"
   },
-  "scripts": {
-    "start": "node src/index.js",
-    "dev": "node src/index.js",
-    "mcp": "node src/mcp-server.js",
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "worker:dev": "wrangler dev",
-    "worker:deploy": "wrangler deploy"
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": ["mcp", "model-context-protocol", "motion", "api", "task-management", "project-management", "llm", "ai"],
+  "author": "Devon Hillard devon@digitalsanctuary.com",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/devondragon/MotionMCP.git"
+  },
+  "homepage": "https://github.com/devondragon/MotionMCP",
+  "bugs": {
+    "url": "https://github.com/devondragon/MotionMCP/issues"
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
   "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
+    "ajv": "^8.17.1",
     "axios": "^1.9.0",
-    "cors": "^2.8.5",
     "dotenv": "^16.5.0",
-    "express": "^5.1.0",
-    "winston": "^3.17.0"
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.2.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsc",
+    "mcp": "node dist/mcp-server.js",
+    "mcp:dev": "ts-node src/mcp-server.ts",
+    "watch": "tsc --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "worker:dev": "wrangler dev",
+    "worker:deploy": "wrangler deploy",
+    "prepublishOnly": "npm run type-check && npm run build"
   }
 }

package/.claude/settings.local.json

@@ -1,15 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npm init:*)",
-      "Bash(npm install:*)",
-      "Bash(mkdir:*)",
-      "Bash(git init:*)",
-      "Bash(git add:*)",
-      "WebFetch(domain:modelcontextprotocol.io)",
-      "WebFetch(domain:github.com)",
-      "Bash(chmod:*)"
-    ],
-    "deny": []
-  }
-}

package/.env.example

@@ -1,3 +0,0 @@
-MOTION_API_KEY=your_motion_api_key_here
-PORT=3000
-NODE_ENV=development