@codesys/mcp-toolkit 1.5.7 → 2.0.0-alpha.0

package/dist/direct_session_command.js

@@ -1,293 +0,0 @@
-"use strict";
-/**
- * Direct Session Command Tool
- *
- * This file provides functions to directly interact with a CODESYS session
- * by writing to the command.json file and reading from the result.json file.
- *
- * This is an alternative approach to the standard session management.
- */
-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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSessionActive = isSessionActive;
-exports.executeScriptDirect = executeScriptDirect;
-exports.createProjectDirect = createProjectDirect;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const os = __importStar(require("os"));
-const uuid_1 = require("uuid");
-// Session directory and file names
-const SESSION_DIR = path.join(os.tmpdir(), 'codesys_session');
-const COMMAND_FILE = path.join(SESSION_DIR, 'command.json');
-const RESULT_FILE = path.join(SESSION_DIR, 'result.json');
-const SESSION_LOCK_FILE = path.join(SESSION_DIR, 'session.lock');
-const STATE_FILE = path.join(SESSION_DIR, 'session_state.json');
-/**
- * Check if a session is active by looking for the lock file
- * @returns True if a session appears to be active
- */
-function isSessionActive() {
-    try {
-        // Log the paths we're checking to help with debugging
-        console.error(`DIRECT_SESSION: Checking for active session...`);
-        console.error(`DIRECT_SESSION: SESSION_DIR: ${SESSION_DIR}`);
-        console.error(`DIRECT_SESSION: SESSION_LOCK_FILE: ${SESSION_LOCK_FILE}`);
-        console.error(`DIRECT_SESSION: COMMAND_FILE: ${COMMAND_FILE}`);
-        // Check if session directory exists
-        if (!fs.existsSync(SESSION_DIR)) {
-            console.error(`DIRECT_SESSION: SESSION_DIR doesn't exist: ${SESSION_DIR}`);
-            return false;
-        }
-        // Check if lock file exists
-        if (!fs.existsSync(SESSION_LOCK_FILE)) {
-            console.error(`DIRECT_SESSION: SESSION_LOCK_FILE doesn't exist: ${SESSION_LOCK_FILE}`);
-            return false;
-        }
-        // Check if command file exists
-        if (!fs.existsSync(COMMAND_FILE)) {
-            console.error(`DIRECT_SESSION: COMMAND_FILE doesn't exist: ${COMMAND_FILE}`);
-            return false;
-        }
-        // Read the lock file to check age
-        const lockFileContent = fs.readFileSync(SESSION_LOCK_FILE, 'utf8');
-        const lockTime = parseFloat(lockFileContent);
-        const currentTime = Date.now() / 1000; // convert to seconds
-        const lockAgeSeconds = currentTime - lockTime;
-        console.error(`DIRECT_SESSION: Lock file age: ${lockAgeSeconds.toFixed(1)} seconds`);
-        // If lock is too old, session might be dead
-        if (lockAgeSeconds > 30) {
-            console.error(`DIRECT_SESSION: Session lock file is too old (${lockAgeSeconds.toFixed(1)} seconds)`);
-            return false;
-        }
-        // Try to read the command file to verify it's in the expected format
-        try {
-            const commandContent = fs.readFileSync(COMMAND_FILE, 'utf8');
-            const commandData = JSON.parse(commandContent);
-            console.error(`DIRECT_SESSION: Command file status: ${commandData.status}`);
-        }
-        catch (cmdError) {
-            console.error(`DIRECT_SESSION: Error parsing command file: ${cmdError}`);
-            return false;
-        }
-        console.error(`DIRECT_SESSION: Session appears to be active`);
-        return true;
-    }
-    catch (error) {
-        console.error(`DIRECT_SESSION: Error checking session: ${error}`);
-        return false;
-    }
-}
-/**
- * Execute a script by directly writing to the command.json file
- * @param scriptContent The Python script to execute
- * @param timeoutMs Timeout in milliseconds
- * @returns Promise that resolves to the script result
- */
-function executeScriptDirect(scriptContent_1) {
-    return __awaiter(this, arguments, void 0, function* (scriptContent, timeoutMs = 60000) {
-        if (!isSessionActive()) {
-            throw new Error('No active session found');
-        }
-        // Generate a unique ID for this execution
-        const scriptId = (0, uuid_1.v4)();
-        // Create command data
-        const commandData = {
-            status: "pending",
-            command: {
-                id: scriptId,
-                type: "execute_script",
-                script: scriptContent,
-                timestamp: Date.now()
-            },
-            timestamp: Date.now()
-        };
-        console.error(`DIRECT_SESSION: Writing command to ${COMMAND_FILE}`);
-        console.error(`DIRECT_SESSION: Command data: ${JSON.stringify(commandData)}`);
-        try {
-            // Write command to file
-            fs.writeFileSync(COMMAND_FILE, JSON.stringify(commandData, null, 2));
-            console.error(`DIRECT_SESSION: Command written to file`);
-            // Verify the file was written correctly
-            try {
-                const verifyContent = fs.readFileSync(COMMAND_FILE, 'utf8');
-                console.error(`DIRECT_SESSION: Verification - Command file now contains: ${verifyContent.substring(0, 100)}...`);
-            }
-            catch (verifyErr) {
-                console.error(`DIRECT_SESSION: Verification failed - could not read command file: ${verifyErr}`);
-            }
-        }
-        catch (writeErr) {
-            console.error(`DIRECT_SESSION: ERROR writing command file: ${writeErr}`);
-            throw writeErr; // Re-throw to propagate the error
-        }
-        // Poll for result
-        return new Promise((resolve, reject) => {
-            let pollCount = 0;
-            const pollInterval = setInterval(() => {
-                pollCount++;
-                try {
-                    // Check if result file exists
-                    if (!fs.existsSync(RESULT_FILE)) {
-                        if (pollCount % 10 === 0) {
-                            console.error(`DIRECT_SESSION: Result file not found at ${RESULT_FILE} (poll ${pollCount})`);
-                        }
-                        return;
-                    }
-                    // Read result file
-                    const resultContent = fs.readFileSync(RESULT_FILE, 'utf8');
-                    try {
-                        const resultData = JSON.parse(resultContent);
-                        // Check if the result is complete and for our script
-                        if (resultData.status === 'complete' && resultData.result) {
-                            const result = resultData.result;
-                            if (result.id === scriptId) {
-                                console.error(`DIRECT_SESSION: Found result for script ${scriptId}`);
-                                // Clear interval
-                                clearInterval(pollInterval);
-                                // Resolve with the result
-                                resolve({
-                                    success: result.success,
-                                    output: result.output
-                                });
-                                return;
-                            }
-                        }
-                    }
-                    catch (parseError) {
-                        console.error(`DIRECT_SESSION: Error parsing result data: ${parseError}`);
-                    }
-                }
-                catch (error) {
-                    console.error(`DIRECT_SESSION: Error reading result file: ${error}`);
-                }
-            }, 100);
-            // Set timeout
-            setTimeout(() => {
-                clearInterval(pollInterval);
-                reject(new Error(`Script execution timed out after ${timeoutMs}ms`));
-            }, timeoutMs);
-        });
-    });
-}
-/**
- * Create a project using a session
- * @param targetProjectPath Full path to the project to create
- * @param templateProjectPath Path to the template project
- * @returns Promise that resolves when the project is created
- */
-function createProjectDirect(targetProjectPath, templateProjectPath) {
-    return __awaiter(this, void 0, void 0, function* () {
-        try {
-            if (!isSessionActive()) {
-                throw new Error('No active session found');
-            }
-            // Normalize paths for cross-platform compatibility
-            const normalizedTargetPath = targetProjectPath.replace(/\\/g, '/');
-            const normalizedTemplatePath = templateProjectPath.replace(/\\/g, '/');
-            // Create a simplified project creation script that only copies the file and doesn't try to open it
-            const simpleProjectCreationScript = `
-import sys, os, shutil, time, traceback
-
-TEMPLATE_PROJECT_PATH = '${normalizedTemplatePath}'
-PROJECT_FILE_PATH = '${normalizedTargetPath}'
-
-print("Direct project creation script")
-print("  Template: %s" % TEMPLATE_PROJECT_PATH)
-print("  Target: %s" % PROJECT_FILE_PATH)
-
-try:
-    # Ensure the target directory exists
-    target_dir = os.path.dirname(PROJECT_FILE_PATH)
-    if not os.path.exists(target_dir):
-        print("Creating target directory: %s" % target_dir)
-        os.makedirs(target_dir)
-    
-    # Check if template exists
-    if not os.path.exists(TEMPLATE_PROJECT_PATH):
-        print("ERROR: Template project not found: %s" % TEMPLATE_PROJECT_PATH)
-        print("SCRIPT_ERROR: Template project not found")
-        sys.exit(1)
-    
-    # Copy the template to the target
-    print("Copying template to target...")
-    shutil.copy2(TEMPLATE_PROJECT_PATH, PROJECT_FILE_PATH)
-    
-    # Verify the file was created
-    if os.path.exists(PROJECT_FILE_PATH):
-        print("Project file created successfully: %s" % PROJECT_FILE_PATH)
-        print("File size: %d bytes" % os.path.getsize(PROJECT_FILE_PATH))
-        print("SCRIPT_SUCCESS: Project file created successfully")
-    else:
-        print("ERROR: Failed to create project file")
-        print("SCRIPT_ERROR: Failed to create project file")
-        sys.exit(1)
-except Exception as e:
-    print("ERROR: %s" % e)
-    traceback.print_exc()
-    print("SCRIPT_ERROR: %s" % e)
-    sys.exit(1)
-`;
-            // Execute the script directly
-            const result = yield executeScriptDirect(simpleProjectCreationScript, 120000);
-            if (result.success) {
-                return {
-                    success: true,
-                    message: `Project created successfully at ${targetProjectPath}`
-                };
-            }
-            else {
-                return {
-                    success: false,
-                    message: `Failed to create project: ${result.output}`
-                };
-            }
-        }
-        catch (error) {
-            return {
-                success: false,
-                message: `Error: ${error.message}`
-            };
-        }
-    });
-}

package/dist/scriptLoader.js

@@ -1,165 +0,0 @@
-"use strict";
-/**
- * Script Loader Module
- * Centralizes loading and management of Python script templates
- *
- * This module:
- * - Loads script templates from the /scripts directory
- * - Provides script template interpolation functions
- * - Manages script parameter substitution
- */
-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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadScriptTemplate = loadScriptTemplate;
-exports.loadScriptTemplateSync = loadScriptTemplateSync;
-exports.interpolateScript = interpolateScript;
-exports.combineScripts = combineScripts;
-exports.preloadAllScriptTemplates = preloadAllScriptTemplates;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const util_1 = require("util");
-const readFileAsync = (0, util_1.promisify)(fs.readFile);
-const SCRIPTS_DIR = path.join(__dirname, 'scripts');
-// Cache for loaded scripts to avoid repeated file system access
-const scriptCache = {};
-/**
- * Loads a script template from the scripts directory
- * @param scriptName The name of the script file (without .py extension)
- * @returns The script content as a string
- */
-function loadScriptTemplate(scriptName) {
-    return __awaiter(this, void 0, void 0, function* () {
-        // Add .py extension if not provided
-        const fileName = scriptName.endsWith('.py') ? scriptName : `${scriptName}.py`;
-        const filePath = path.join(SCRIPTS_DIR, fileName);
-        // Return from cache if available
-        if (scriptCache[fileName]) {
-            return scriptCache[fileName];
-        }
-        try {
-            const content = yield readFileAsync(filePath, 'utf8');
-            // Store in cache for future use
-            scriptCache[fileName] = content;
-            return content;
-        }
-        catch (error) {
-            throw new Error(`Failed to load script template '${fileName}': ${error.message}`);
-        }
-    });
-}
-/**
- * Loads a script template synchronously (for use during startup)
- * @param scriptName The name of the script file (without .py extension)
- * @returns The script content as a string
- */
-function loadScriptTemplateSync(scriptName) {
-    // Add .py extension if not provided
-    const fileName = scriptName.endsWith('.py') ? scriptName : `${scriptName}.py`;
-    const filePath = path.join(SCRIPTS_DIR, fileName);
-    // Return from cache if available
-    if (scriptCache[fileName]) {
-        return scriptCache[fileName];
-    }
-    try {
-        const content = fs.readFileSync(filePath, 'utf8');
-        // Store in cache for future use
-        scriptCache[fileName] = content;
-        return content;
-    }
-    catch (error) {
-        throw new Error(`Failed to load script template '${fileName}': ${error.message}`);
-    }
-}
-/**
- * Interpolates parameters into a script template
- * @param template The script template string
- * @param params Object containing parameter names and values
- * @returns The script with parameter values substituted
- */
-function interpolateScript(template, params) {
-    let result = template;
-    // Replace each parameter in the template
-    for (const [key, value] of Object.entries(params)) {
-        // Get the escaped value, handling special characters
-        // Note: We've changed our approach to use forward slashes everywhere
-        // and handle the path normalization in each script instead of using r-strings
-        let escapedValue = String(value);
-        // If value has single quotes, escape them
-        if (escapedValue.includes("'")) {
-            escapedValue = escapedValue.replace(/'/g, "\\'");
-            console.error(`SCRIPT_LOADER: Escaped single quotes in value: ${escapedValue}`);
-        }
-        // Replace {PARAM_NAME} with the escaped value
-        const paramPattern = new RegExp(`\\{${key}\\}`, 'g');
-        result = result.replace(paramPattern, escapedValue);
-    }
-    return result;
-}
-/**
- * Combines multiple script fragments with proper indentation
- * @param scripts Object containing named script fragments
- * @returns Combined script content
- */
-function combineScripts(scripts) {
-    return Object.values(scripts).join('\n\n');
-}
-/**
- * Load all script templates from the scripts directory
- * This is useful during development to preload the cache
- */
-function preloadAllScriptTemplates() {
-    return __awaiter(this, void 0, void 0, function* () {
-        try {
-            const files = fs.readdirSync(SCRIPTS_DIR);
-            for (const file of files) {
-                if (file.endsWith('.py')) {
-                    yield loadScriptTemplate(file);
-                }
-            }
-        }
-        catch (error) {
-            console.error(`Failed to preload script templates: ${error.message}`);
-        }
-    });
-}

package/dist/scripts/check_status.py

@@ -1,21 +0,0 @@
-import sys, scriptengine as script_engine, os, traceback
-project_open = False; project_name = "No project open"; project_path = "N/A"; scripting_ok = False
-try:
-    scripting_ok = True; primary_project = script_engine.projects.primary
-    if primary_project:
-        project_open = True
-        try:
-            project_path = os.path.normcase(os.path.abspath(primary_project.path))
-            try:
-                 project_name = primary_project.get_name() # Might fail
-                 if not project_name: project_name = "Unnamed (path: %s)" % os.path.basename(project_path)
-            except: project_name = "Unnamed (path: %s)" % os.path.basename(project_path)
-        except Exception as e_path: project_path = "N/A (Error: %s)" % e_path; project_name = "Unnamed (Path Error)"
-    print("Project Open: %s" % project_open); print("Project Name: %s" % project_name)
-    print("Project Path: %s" % project_path); print("Scripting OK: %s" % scripting_ok)
-    print("SCRIPT_SUCCESS: Status check complete."); sys.exit(0)
-except Exception as e:
-    error_message = "Error during status check: %s" % e
-    print(error_message); print("Scripting OK: False")
-    # traceback.print_exc() # Optional traceback
-    print("SCRIPT_ERROR: %s" % error_message); sys.exit(1)

package/dist/scripts/compile_project.py

@@ -1,65 +0,0 @@
-import sys, scriptengine as script_engine, os, traceback
-
-# Import ensure_project_open function from the template
-# This will be prepended by the script loader
-def ensure_project_open(target_project_path):
-    # Function implementation will be included from ensure_project_open.py
-    pass
-
-try:
-    print("DEBUG: compile_project script: Project='%s'" % PROJECT_FILE_PATH)
-    primary_project = ensure_project_open(PROJECT_FILE_PATH)
-    project_name = os.path.basename(PROJECT_FILE_PATH)
-    target_app = None
-    app_name = "N/A"
-
-    # Try getting active application first
-    try:
-        target_app = primary_project.active_application
-        if target_app:
-            app_name = getattr(target_app, 'get_name', lambda: "Unnamed App (Active)")()
-            print("DEBUG: Found active application: %s" % app_name)
-    except Exception as active_err:
-        print("WARN: Could not get active application: %s. Searching..." % active_err)
-
-    # If no active app, search for the first one
-    if not target_app:
-        print("DEBUG: Searching for first compilable application...")
-        apps = []
-        try:
-             # Search recursively through all project objects
-             all_children = primary_project.get_children(True)
-             for child in all_children:
-                  # Check using the marker property and if build method exists
-                  if hasattr(child, 'is_application') and child.is_application and hasattr(child, 'build'):
-                       app_name_found = getattr(child, 'get_name', lambda: "Unnamed App")()
-                       print("DEBUG: Found potential application object: %s" % app_name_found)
-                       apps.append(child)
-                       break # Take the first one found
-        except Exception as find_err: print("WARN: Error finding application object: %s" % find_err)
-
-        if not apps: raise RuntimeError("No compilable application found in project '%s'" % project_name)
-        target_app = apps[0]
-        app_name = getattr(target_app, 'get_name', lambda: "Unnamed App (First Found)")()
-        print("WARN: Compiling first found application: %s" % app_name)
-
-    print("DEBUG: Calling build() on app '%s'..." % app_name)
-    if not hasattr(target_app, 'build'):
-         raise TypeError("Selected object '%s' is not an application or doesn't support build()." % app_name)
-
-    # Execute the build
-    target_app.build();
-    print("DEBUG: Build command executed for application '%s'." % app_name)
-
-    # Check messages is harder without direct access to message store from script.
-    # Rely on CODESYS UI or log output for now.
-    print("Compile Initiated For Application: %s" % app_name)
-    print("In Project: %s" % project_name)
-    print("SCRIPT_SUCCESS: Application compilation initiated.")
-    sys.exit(0)
-except Exception as e:
-    detailed_error = traceback.format_exc()
-    error_message = "Error initiating compilation for project %s: %s\\n%s" % (PROJECT_FILE_PATH, e, detailed_error)
-    print(error_message)
-    print("SCRIPT_ERROR: %s" % error_message)
-    sys.exit(1)

package/dist/scripts/create_method.py

@@ -1,80 +0,0 @@
-import sys, scriptengine as script_engine, os, traceback
-
-# Import ensure_project_open function from the template
-# This will be prepended by the script loader
-def ensure_project_open(target_project_path):
-    # Function implementation will be included from ensure_project_open.py
-    pass
-
-# Import find_object_by_path function from the template
-# This will be prepended by the script loader
-def find_object_by_path_robust(start_node, full_path, target_type_name="object"):
-    # Function implementation will be included from find_object_by_path.py
-    pass
-
-PARENT_POU_FULL_PATH = "{PARENT_POU_FULL_PATH}" # e.g., "Application/MyFB"
-METHOD_NAME = "{METHOD_NAME}"
-RETURN_TYPE = "{RETURN_TYPE}" # Can be empty string for no return type
-# Optional: Language
-# LANG_GUID_STR = "{LANG_GUID_STR}" # Example if needed
-
-try:
-    print("DEBUG: create_method script: ParentPOU='%s', Name='%s', ReturnType='%s', Project='%s'" % (PARENT_POU_FULL_PATH, METHOD_NAME, RETURN_TYPE, PROJECT_FILE_PATH))
-    primary_project = ensure_project_open(PROJECT_FILE_PATH)
-    if not PARENT_POU_FULL_PATH: raise ValueError("Parent POU full path empty.")
-    if not METHOD_NAME: raise ValueError("Method name empty.")
-    # RETURN_TYPE can be empty
-
-    # Find the parent POU object
-    parent_pou_object = find_object_by_path_robust(primary_project, PARENT_POU_FULL_PATH, "parent POU")
-    if not parent_pou_object: raise ValueError("Parent POU object not found: %s" % PARENT_POU_FULL_PATH)
-
-    parent_pou_name = getattr(parent_pou_object, 'get_name', lambda: PARENT_POU_FULL_PATH)()
-    print("DEBUG: Found Parent POU object: %s" % parent_pou_name)
-
-     # Check if parent object supports creating methods (should implement ScriptIecLanguageMemberContainer)
-    if not hasattr(parent_pou_object, 'create_method'):
-         raise TypeError("Parent object '%s' of type %s does not support create_method." % (parent_pou_name, type(parent_pou_object).__name__))
-
-    # Default language to None (usually ST)
-    lang_guid = None
-    # Use None if RETURN_TYPE is empty string, otherwise use the string
-    actual_return_type = RETURN_TYPE if RETURN_TYPE else None
-    print("DEBUG: Calling create_method: Name='%s', ReturnType=%s, Lang=%s" % (METHOD_NAME, actual_return_type, lang_guid))
-
-    # Call the create_method method ON THE PARENT POU
-    new_method_object = parent_pou_object.create_method(
-        name=METHOD_NAME,
-        return_type=actual_return_type,
-        language=lang_guid # Pass None to use default
-    )
-
-    if new_method_object:
-        new_meth_name = getattr(new_method_object, 'get_name', lambda: METHOD_NAME)()
-        print("DEBUG: Method object created: %s" % new_meth_name)
-
-        # --- SAVE THE PROJECT TO PERSIST THE NEW METHOD OBJECT ---
-        try:
-            print("DEBUG: Saving Project (after method creation)...")
-            primary_project.save()
-            print("DEBUG: Project saved successfully after method creation.")
-        except Exception as save_err:
-            print("ERROR: Failed to save Project after creating method: %s" % save_err)
-            detailed_error = traceback.format_exc()
-            error_message = "Error saving Project after creating method '%s': %s\\n%s" % (METHOD_NAME, save_err, detailed_error)
-            print(error_message); print("SCRIPT_ERROR: %s" % error_message); sys.exit(1)
-        # --- END SAVING ---
-
-        print("Method Created: %s" % new_meth_name)
-        print("Parent POU: %s" % PARENT_POU_FULL_PATH)
-        print("Return Type: %s" % (RETURN_TYPE if RETURN_TYPE else "(None)"))
-        print("SCRIPT_SUCCESS: Method created successfully.")
-        sys.exit(0)
-    else:
-         error_message = "Failed to create method '%s' under '%s'. create_method returned None." % (METHOD_NAME, parent_pou_name)
-         print(error_message); print("SCRIPT_ERROR: %s" % error_message); sys.exit(1)
-
-except Exception as e:
-    detailed_error = traceback.format_exc()
-    error_message = "Error creating method '%s' under POU '%s' in project '%s': %s\\n%s" % (METHOD_NAME, PARENT_POU_FULL_PATH, PROJECT_FILE_PATH, e, detailed_error)
-    print(error_message); print("SCRIPT_ERROR: %s" % error_message); sys.exit(1)