codesysultra 1.0.4 → 1.0.6

package/dist/handlers/tools.js

@@ -328,5 +328,27 @@ function registerTools(server, config) {
             return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
         }
     }));
+    server.tool("get_all_tools", // Tool Name
+    "Retrieves all available CODESYS script engine APIs, modules, POU types, and implementation languages.", // Tool Description
+    {
+        projectFilePath: zod_1.z.string().describe("Path to a CODESYS project file (e.g., 'C:/Projects/MyPLC.project'). Used for context, but the tool retrieves system APIs regardless of specific project.")
+    }, (args) => __awaiter(this, void 0, void 0, function* () {
+        const { projectFilePath } = args;
+        let absPath = path.normalize(path.isAbsolute(projectFilePath) ? projectFilePath : path.join(WORKSPACE_DIR, projectFilePath));
+        console.error(`Tool call: get_all_tools: ${absPath}`);
+        try {
+            const escapedPath = absPath.replace(/\\/g, '\\\\');
+            const script = templates_1.GET_ALL_TOOLS_SCRIPT_TEMPLATE.replace("{PROJECT_FILE_PATH}", escapedPath);
+            console.error(">>> get_all_tools: PREPARED SCRIPT:", script.substring(0, 500) + "...");
+            const result = yield (0, codesys_interop_1.executeCodesysScript)(script, codesysExePath, codesysProfileName);
+            console.error(">>> get_all_tools: EXECUTION RESULT:", JSON.stringify(result));
+            const success = result.success && result.output.includes("SCRIPT_SUCCESS");
+            return { content: [{ type: "text", text: success ? result.output : `Failed to get tools. Output:\n${result.output}` }], isError: !success };
+        }
+        catch (e) {
+            console.error(`Error get_all_tools ${absPath}: ${e}`);
+            return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
+        }
+    }));
     // --- End Tools ---
 }

package/dist/templates/get_all_tools.py

@@ -0,0 +1,143 @@
+import sys, scriptengine as script_engine, os, traceback, inspect, pkgutil
+
+def get_codesys_system_api():
+    try:
+        print("\\n=== CODESYS Script Engine System API ===\\n")
+        
+        print("=== Script Engine Modules ===")
+        print("scriptengine module:")
+        for name in dir(script_engine):
+            if not name.startswith('_'):
+                try:
+                    obj = getattr(script_engine, name)
+                    obj_type = type(obj).__name__
+                    print("  %s (%s)" % (name, obj_type))
+                    
+                    if inspect.isclass(obj):
+                        try:
+                            methods = [m for m in dir(obj) if not m.startswith('_') and callable(getattr(obj, m))]
+                            if methods:
+                                print("    Available methods:")
+                                for method in sorted(methods)[:20]:
+                                    print("      - %s" % method)
+                                if len(methods) > 20:
+                                    print("      ... and %d more" % (len(methods) - 20))
+                        except Exception as e:
+                            print("    Error listing methods: %s" % e)
+                except Exception as e:
+                    print("  Error: %s" % e)
+        except Exception as e:
+            print("  Error: %s" % e)
+        
+        print("\\n=== Script Engine Functions ===")
+        script_functions = []
+        for name in dir(script_engine):
+            if not name.startswith('_') and callable(getattr(script_engine, name)):
+                script_functions.append(name)
+        
+        for func in sorted(script_functions):
+            print("  - %s()" % func)
+        
+        print("\\n=== Available Enums ===")
+        try:
+            enums = []
+            for name in dir(script_engine):
+                obj = getattr(script_engine, name)
+                if inspect.isclass(obj) and issubclass(obj, int):
+                    enums.append((name, obj))
+            
+            for enum_name, enum_obj in sorted(enums):
+                print("\\n%s:" % enum_name)
+                try:
+                    members = [(name, value) for name, value in enum_obj.__dict__.items() if not name.startswith('_')]
+                    for member_name, member_value in sorted(members, key=lambda x: x[0]):
+                        print("  %s = %s" % (member_name, member_value))
+                except Exception as e:
+                    print("  Error: %s" % e)
+        except Exception as e:
+            print("  Error listing enums: %s" % e)
+        
+        print("\\n=== Project Management ===")
+        print("script_engine.projects module functions:")
+        project_functions = []
+        for name in dir(script_engine.projects):
+            if not name.startswith('_') and callable(getattr(script_engine.projects, name)):
+                project_functions.append(name)
+        
+        for func in sorted(project_functions):
+            print("  - %s()" % func)
+        
+        print("\\n=== POU Types ===")
+        try:
+            pou_types = []
+            for name in dir(script_engine):
+                obj = getattr(script_engine, name)
+                if inspect.isclass(obj) and 'PouType' in name:
+                    pou_types.append((name, obj))
+            
+            for type_name, type_obj in pou_types:
+                print("  %s:" % type_name)
+                try:
+                    values = [(name, getattr(type_obj, name)) for name in dir(type_obj) if not name.startswith('_') and name.isupper()]
+                    for value_name, value_value in values:
+                        print("    %s = %s" % (value_name, value_value))
+                except Exception as e:
+                    print("  Error: %s" % e)
+        except Exception as e:
+            print("  Error: %s" % e)
+        
+        print("\\n=== Implementation Languages ===")
+        try:
+            impl_langs = []
+            for name in dir(script_engine):
+                obj = getattr(script_engine, name)
+                if inspect.isclass(obj) and 'ImplementationLanguage' in name:
+                    impl_langs.append((name, obj))
+            
+            for lang_name, lang_obj in impl_langs:
+                print("  %s:" % lang_name)
+                try:
+                    values = [(name, getattr(lang_obj, name)) for name in dir(lang_obj) if not name.startswith('_') and name.isupper()]
+                    for value_name, value_value in values:
+                        print("    %s = %s" % (value_name, value_value))
+                except Exception as e:
+                    print("  Error: %s" % e)
+        except Exception as e:
+            print("  Error: %s" % e)
+        
+        print("\\n=== Version Info ===")
+        try:
+            version = getattr(script_engine, '__version__', 'Unknown')
+            print("  Script Engine Version: %s" % version)
+        except Exception as e:
+            print("  Error getting version: %s" % e)
+        
+        print("\\n=== API Usage Examples ===")
+        print("Example 1: Open a project")
+        print("  project = script_engine.projects.open('C:/Projects/MyProject.project')")
+        print("")
+        print("Example 2: Create a POU")
+        print("  parent = project.get_children()[0]")
+        print("  pou = parent.create_pou(name='MyPOU', type=script_engine.PouType.Program)")
+        print("")
+        print("Example 3: Get project structure")
+        print("  def analyze(obj, indent=0):")
+        print("      print('  ' * indent + obj.get_name())")
+        print("      if hasattr(obj, 'get_children'):")
+        print("          for child in obj.get_children():")
+        print("              analyze(child, indent+1)")
+        print("  analyze(project)")
+        
+        print("\\n=== Analysis Complete ===")
+        print("SCRIPT_SUCCESS: CODESYS system API retrieved successfully.")
+        sys.exit(0)
+        
+    except Exception as e:
+        detailed_error = traceback.format_exc()
+        error_message = "Error retrieving CODESYS system API: %s\\n%s" % (e, detailed_error)
+        print(error_message)
+        print("SCRIPT_ERROR: %s" % error_message)
+        sys.exit(1)
+
+if __name__ == "__main__":
+    get_codesys_system_api()

package/dist/templates.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GET_POU_CODE_SCRIPT_TEMPLATE = exports.CREATE_METHOD_SCRIPT_TEMPLATE = exports.CREATE_PROPERTY_SCRIPT_TEMPLATE = exports.SET_POU_CODE_SCRIPT_TEMPLATE = exports.CREATE_POU_SCRIPT_TEMPLATE = exports.GET_PROJECT_STRUCTURE_SCRIPT_TEMPLATE = exports.COMPILE_PROJECT_SCRIPT_TEMPLATE = exports.SAVE_PROJECT_SCRIPT_TEMPLATE = exports.OPEN_PROJECT_SCRIPT_TEMPLATE = exports.CREATE_PROJECT_SCRIPT_TEMPLATE = exports.CHECK_STATUS_SCRIPT = exports.FIND_OBJECT_BY_PATH_PYTHON_SNIPPET = exports.ENSURE_PROJECT_OPEN_PYTHON_SNIPPET = void 0;
+exports.GET_POU_CODE_SCRIPT_TEMPLATE = exports.CREATE_METHOD_SCRIPT_TEMPLATE = exports.CREATE_PROPERTY_SCRIPT_TEMPLATE = exports.SET_POU_CODE_SCRIPT_TEMPLATE = exports.CREATE_POU_SCRIPT_TEMPLATE = exports.GET_ALL_TOOLS_SCRIPT_TEMPLATE = exports.GET_PROJECT_STRUCTURE_SCRIPT_TEMPLATE = exports.COMPILE_PROJECT_SCRIPT_TEMPLATE = exports.SAVE_PROJECT_SCRIPT_TEMPLATE = exports.OPEN_PROJECT_SCRIPT_TEMPLATE = exports.CREATE_PROJECT_SCRIPT_TEMPLATE = exports.CHECK_STATUS_SCRIPT = exports.FIND_OBJECT_BY_PATH_PYTHON_SNIPPET = exports.ENSURE_PROJECT_OPEN_PYTHON_SNIPPET = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const templatesDir = path_1.default.join(__dirname, 'templates');
@@ -35,6 +35,7 @@ exports.OPEN_PROJECT_SCRIPT_TEMPLATE = injectDependencies(readTemplate('open_pro
 exports.SAVE_PROJECT_SCRIPT_TEMPLATE = injectDependencies(readTemplate('save_project.py'));
 exports.COMPILE_PROJECT_SCRIPT_TEMPLATE = injectDependencies(readTemplate('compile_project.py'));
 exports.GET_PROJECT_STRUCTURE_SCRIPT_TEMPLATE = injectDependencies(readTemplate('get_project_structure.py'));
+exports.GET_ALL_TOOLS_SCRIPT_TEMPLATE = readTemplate('get_all_tools.py');
 exports.CREATE_POU_SCRIPT_TEMPLATE = injectDependencies(readTemplate('create_pou.py'));
 exports.SET_POU_CODE_SCRIPT_TEMPLATE = injectDependencies(readTemplate('set_pou_code.py'));
 exports.CREATE_PROPERTY_SCRIPT_TEMPLATE = injectDependencies(readTemplate('create_property.py'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codesysultra",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Model Context Protocol (MCP) server for CODESYS automation platform",
   "main": "dist/server.js",
   "bin": {