@codesys/mcp-toolkit 1.5.8 → 2.0.0

package/CHANGELOG.md

@@ -1,189 +1,153 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [1.5.8] - 2025-05-02
-### Fixed
-- Fixed null reference error when accessing sessionManager.getState() with --no-session flag
-- Added proper null checks for session manager in session_status, start_session, and stop_session tools
-- Improved error messages when trying to use session management tools with --no-session flag
-
-## [1.5.7] - 2025-05-02
-### Fixed
-- Added safety timeout to session scripts to prevent CODESYS UI hanging
-- Improved session detection and management to handle zombie sessions
-- Enhanced session cleanup in stop_session.py with more robust error handling
-- Added maximum session runtime (8 hours) to prevent infinite hanging
-- Improved error detection and recovery in session management scripts
-
-## [1.5.6] - 2025-05-02
-### Fixed
-- Fixed session manager null reference error in interop.ts
-- Added additional null checks for session manager
-- Improved error handling when session manager is undefined
-
-## [1.5.5] - 2025-05-02
-### Fixed
-- Added enhanced command.json file verification to debug session communication
-- Improved logging for command file operations to diagnose IPC issues
-- Added command data verification to detect potential file corruption
-
-## [1.5.4] - 2025-05-02
-### Fixed
-- Added `--no-session` flag to disable session management when CODESYS UI hangs
-- Improved session handling with better error detection and user feedback
-- Removed hardcoded session disable flag in favor of command-line option
-- Added safeguards to prevent UI blocking during session operations
-
-## [1.5.3] - 2025-05-02
-### Fixed
-- Added automatic session startup when server starts
-- Improved session detection with better diagnostics
-- Enhanced logging for session command status
-
-## [1.5.2] - 2025-05-02
-### Fixed
-- Re-enabled session management feature that was disabled for debugging
-- Fixed project path handling between scripts for more reliable project creation
-- Fixed create_pou.py and set_pou_code.py to properly handle project paths when embedded in other scripts
-
-## [1.5.1] - 2025-05-02
-### Added
-- Implemented direct session command handling for project creation
-- Added ability to communicate directly with active sessions via command.json
-- Created a simplified project creation script optimized for sessions
-- Added fallback to standard execution if direct approach fails
-
-## [1.5.0] - 2025-05-02
-### Changed
-- Temporarily disabled session management for create_project operations to ensure reliability
-- Reverted to direct script execution model for project creation operations
-- Project creation now uses a simpler, more reliable approach that works consistently
-
-## [1.4.9] - 2025-05-02
-### Fixed
-- Fixed critical issue with create_project not succeeding in persistent sessions
-- Added comprehensive debugging for project creation operations
-- Improved result file handling to prevent file access issues
-- Enhanced success detection for project file creation when opening fails
-- Fixed issue with result files not being properly written during critical operations
-- Added atomic file writing with fallback mechanisms for result files
-
-## [1.4.8] - 2025-05-02
-### Fixed
-- Fixed critical bug with project creation in persistent sessions
-- Added SKIP_OPEN option to create_project script for session compatibility
-- Improved handling of project creation in sessions to avoid "project in use" errors
-- Added better error recovery when project file exists but can't be opened in a session
-- Added helpful user messages explaining session limitations with project operations
-
-## [1.4.7] - 2025-05-02
-### Fixed
-- Fixed create_project freezing in persistent sessions
-- Added special detection and handling for project creation operations
-- Extended timeout for project creation to 120 seconds (from 60 seconds)
-- Added graceful handling of timeouts with partial success detection
-- Improved debugging and monitoring of long-running operations in sessions
-
-## [1.4.6] - 2025-05-02
-### Fixed
-- Fixed session management "hanging" issue with start_session
-- Added stdout flushing in Python scripts to ensure output is visible
-- Improved session script logging for better debugging
-- Added more detailed state information in session scripts
-
-## [1.4.5] - 2025-05-02
-### Fixed
-- Completely redesigned path handling for Windows paths
-- Removed raw string (r'...') approach for more direct path handling
-- Implemented path normalization using forward slashes for cross-platform compatibility
-- Fixed create_project script to properly handle Windows paths in IronPython environment
-
-## [1.4.4] - 2025-05-02
-### Fixed
-- Fixed "unexpected token 'C'" error in create_project script
-- Improved Windows path handling in create_project.py with better logging and error detection
-- Added additional debugging output for raw string path processing
-
-## [1.4.3] - 2025-05-02
-### Fixed
-- Fixed "Cannot import name redirect_stdout" error in session script execution
-- Replaced contextlib.redirect_stdout/redirect_stderr with direct sys.stdout/stderr assignment for IronPython 2.7 compatibility
-- Improved StringIO import handling for better Python 2/3 compatibility
-
-## [1.4.2] - 2025-05-02
-### Fixed
-- Enhanced session communication with better logging and debugging
-- Improved command file handling and error recovery
-- Fixed path handling for session files
-- Added JSON fallback parser for IronPython 2.7
-- Ensured synchronous script execution to prevent conflicts
-- Increased reliability of session status detection
-
-## [1.4.1] - 2025-05-02
-### Fixed
-- Fixed IronPython 2.7 compatibility for session management scripts
-- Replaced f-strings with str.format() method calls for IronPython compatibility
-- Added fallback import for json module (using simplejson for IronPython)
-- Improved error handling for session scripts
-- Re-enabled session management feature in codesys_interop.ts
-
-## [1.4.0] - 2025-05-02
-### Added
-- Implemented initial framework for session management
-- Added foundation for file-based IPC between Node.js and CODESYS instances
-- Created documentation structure for session management capabilities
-
-## [1.3.0] - 2025-05-02
-### Changed
-- Refactored codebase for improved reliability and maintainability
-- Enhanced error handling in Python script templates
-
-## [1.2.4] - 2025-05-02 
-### Fixed
-- Fully disabled session management to prevent operations appearing to succeed but not actually running
-- Made it clearer that the persistent session feature is not yet implemented
-
-## [1.2.3] - 2025-05-02
-### Fixed
-- Improved Windows path handling in Python scripts
-- Added better error detection and reporting for file operations
-- Enhanced debugging for file creation operations
-
-## [1.2.2] - 2025-05-02
-### Fixed
-- Fixed issue where session management appeared to work but didn't create files
-- Temporarily disabled incomplete session manager implementation
-
-## [1.2.1] - 2025-05-02
-### Fixed
-- Fixed Python script templates not being included in the npm package
-
-## [1.2.0] - 2025-05-02
-### Added
-- Session management functionality with `start_session`, `stop_session`, and `session_status` commands
-- Persistent CODESYS sessions for improved performance with multiple operations
-- Documentation for session management
-
-## [1.0.0] - 2025-04-23
-
-### Added
-- Initial release of the MCP server for CODESYS
-- Command-line interface with configuration options
-- Project management functionality:
-  - Opening existing CODESYS projects
-  - Creating new CODESYS projects
-  - Saving projects
-- POU (Program Organization Unit) management:
-  - Creating POUs (Programs, Function Blocks, Functions)
-  - Setting POU code (declaration and implementation)
-  - Creating properties and methods for Function Blocks
-- Project compilation support
-- Resources for querying:
-  - Project status
-  - Project structure
-  - POU code
-- Documentation for installation and usage
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.0.0] - 2026-11-09
+
+Rewrite. See README "Migrating from v1".
+
+### Changed
+- CODESYS runs once per session with a watcher script (file-queue IPC,
+  JSON op requests, heartbeat, hang/crash detection and restart) instead of
+  a cold `--runscript` per call.
+- ESM TypeScript on MCP SDK v2 (`@modelcontextprotocol/server`), Node 20+.
+- One tool, `codesys`, so a client that asks for approval per tool asks once.
+  Each operation is an action of it (`read_objects`, `write_object`,
+  `create_object`, `get_project_tree`, `search_code`, `compile`,
+  `list_libraries`, `add_library`, `list_tasks`, `codesys_status`, ...), and
+  actions work on the open project. `help` lists them with their arguments,
+  and `batch` runs several in one call.
+- Structured Text only; graphical objects are listed as `[non-ST]`.
+- No login or download to a controller. The online functions are used only
+  for CODESYS's own simulation.
+- Earlier development builds simulated in truST. That is gone; the options
+  `--trust-runtime`, `--mirror-dir` and `--no-sim` are accepted and ignored,
+  so existing client setups keep starting.
+
+### Added
+- CODESYS's own simulation, with nothing extra to install: `codesys_sim_start`,
+  `codesys_sim_stop`, `codesys_sim_status`, `codesys_sim_control`,
+  `codesys_sim_cycle`, `codesys_sim_read`, `codesys_sim_write`,
+  `codesys_sim_force`, `codesys_sim_unforce`. Runs on the real compiler and
+  libraries; the project is locked while it runs.
+- `get_outline`, `get_io_list`: the project's structure and interfaces, and
+  its I/O variables, from one export instead of reading every object.
+- `get_library_api`: interfaces of referenced source libraries.
+- `checkpoint`, `get_changes`, `revert_object`: change tracking against
+  snapshots, with an automatic `session-start` snapshot on open.
+- `open_sim_panel`: a live panel inside the chat (MCP App), which Claude opens
+  after opening or creating a project. It is a separate tool with its own
+  approval. Open workspace on the card expands it.
+- `open_workspace`: the same workspace in the default browser, when the user
+  asks for it, served on 127.0.0.1 with a token. Options `--viewer-port`,
+  `--no-viewer`.
+- Panel views that follow Claude's work: Code (live code with new lines
+  marked) and Review (accept or revert each changed object, with its
+  added/removed line counts; in the chat card the changes open in place).
+- `compile` checks every POU, GVL and DUT, including those no task calls (it
+  sets "link always" for the build and restores it); `deep` also generates
+  code, `clean` builds from scratch.
+- CODESYS V3.5 SP22: the toolkit passes the install's additional folder
+  (`CODESYS\AdditionalFolders\Default`, where SP22 keeps add-ons such as
+  Scripting) as `--additionalfolder`, and reads profiles from it.
+  `--codesys-additional-folder` overrides it.
+- `codesys_status` and the panel show the Scripting add-on version next to
+  the CODESYS install and compiler version. The server log says why an install
+  was picked.
+- Build properties: objects excluded from the build are marked in the tree.
+  The application's compiler defines and, with Scripting 4.2, the project
+  defines and compiler version are reported.
+- `get_devices`: the device tree and its I/O channels with their mapped
+  variables; `get_io_list` includes the device-tree mappings.
+- `read_objects` returns graphical bodies (SFC, CFC, LD, FBD) as PLCopenXML.
+- `open_project` opens `.projectarchive` files; `save_project` can write one.
+- `remove_library`. `add_library` also takes a bare title (`Util`), with an
+  optional version.
+- `get_library_api` lists compiled libraries and ones the project doesn't
+  reference, with their descriptions, from CODESYS's library browser cache.
+- A profile that isn't installed is refused at start, with the installed ones
+  listed. The `--workspace` folder is created if missing.
+- Profiles and templates are also found for programs laid out unlike
+  `CODESYS.exe`. See `docs/machine-expert-testing.md` for testing with
+  Schneider Machine Expert, which isn't supported yet.
+- Checkpoints keep graphical bodies as PLCopenXML; `revert_object` re-imports
+  a deleted graphical object instead of recreating it as empty ST.
+- Compile messages give the real column (from CODESYS's offset; its own
+  text says column 1) and the token length; the full-screen editor marks
+  lines with errors and warnings.
+- `configure_task`: create and configure tasks (kind, interval, priority,
+  event, core, watchdog) and add program calls; `list_tasks` shows the event,
+  core and watchdog. Removing a call is refused with an explanation: SP21's
+  scripting can't do it.
+- Shared session: server processes started with the same options share one
+  background owner (one CODESYS), so the panel shows the project the chat
+  works on. `--no-shared` runs in-process as before.
+  - **In the chat:** a compact card with status, what Claude is working on
+    and changes.
+  - **Full screen:** a CODESYS-style workspace with the project tree and
+    badges, editor tabs (diff against the session start), and problems and
+    review tabs.
+  - **Follow Claude** opens what Claude edits.
+  - **Selections** are sent to Claude as model context.
+  - **Panel-only tools** (`get_sim_state`, `get_workspace`, `get_object`) are
+    hidden from clients without MCP Apps support. They read a project cache
+    that the tools keep current, so the panel never calls CODESYS.
+  - **Interaction:** accept or revert Claude's change per object (a `review`
+    checkpoint the badges and diffs compare with), and **Pause Claude**, which
+    holds Claude's changing tools with a `paused_by_user` answer. User actions
+    are sent to Claude as model context. They use app-only `ui_*` tools.
+
+### Fixed
+- The server advertises the MCP Apps extension (`io.modelcontextprotocol/ui`)
+  in its capabilities. A host may otherwise treat the card tool as plain text
+  and show no card.
+- `create_project` makes a project that compiles (#4). CODESYS's shipped
+  `Standard.project` can be years old: SP22's names device 3.1.3.0 and
+  `IoStandard, 3.1.3.1`. The new copy is brought up to the running CODESYS's
+  device, compiler and libraries. Templates you pass and projects you open are
+  never updated.
+- `open_project` says when a project needs a newer compiler than the running
+  CODESYS has, and so can't compile there.
+- A start-up timeout or a crash during a call reports what the program printed.
+- A dialog CODESYS waits on during a call ends the call in about 15 seconds
+  with an error that names it. Before, the call ran into its timeout (up to 5
+  minutes).
+- A request file held for a moment by another process (antivirus, indexer) no
+  longer fails the call with `bad_request`.
+- `compile` returns errors and warnings with object, line and code (#10).
+- Non-ASCII text round-trips (UTF-8 end to end) (#9).
+- Reads work in Claude Desktop because they are tools, not resources (#6).
+- Declarations that drop or change the object header are rejected (#5).
+- Functions get their return type (#8).
+- Object kinds come from type GUIDs, so localised CODESYS works.
+- Interfaces are created without the implicit `__System.IQueryInterface` base.
+
+## [1.1.16] - 2025-05-06
+
+### Fixed
+- Reverted to v1.1.3 code base which has working POU creation functionality
+- Fixed path handling by using simpler approach from v1.1.3
+- Restored original Application object finding logic that worked in v1.1.3
+
+## [1.0.0] - 2025-04-23
+
+### Added
+- Initial release of the MCP server for CODESYS
+- Command-line interface with configuration options
+- Project management functionality:
+  - Opening existing CODESYS projects
+  - Creating new CODESYS projects
+  - Saving projects
+- POU (Program Organization Unit) management:
+  - Creating POUs (Programs, Function Blocks, Functions)
+  - Setting POU code (declaration and implementation)
+  - Creating properties and methods for Function Blocks
+- Project compilation support
+- Resources for querying:
+  - Project status
+  - Project structure
+  - POU code
+- Documentation for installation and usage

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 CODESYS MCP Server Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 CODESYS MCP Server Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.