v0.15.4

🆕 Local Debugging Session

New --local CLI flag starts a local WebSocket session for debugging graphs without connecting to the Actionforge gateway. This enables fully offline graph debugging directly from your machine.

---

🆕 MCP Server

A built-in MCP server with debug tools and a WebSocket bridge is now included. This allows AI assistants and other MCP-compatible clients to interact with running debug sessions.

---

🆕 GitHub Actions Mock Server

When debugging a graph locally, actrun now automatically starts a local mock server that simulates the GitHub Actions environment. This lets GitHub Action nodes run correctly during local debugging without requiring an actual GitHub Actions runner.

---

🆕 JSON Schema for .act Files

Graph .act files now have an official JSON schema. A new schema command prints the JSON schema, and the validate command now validates graph files against it.

---

✨ Post-Step Execution for GitHub Action Nodes

GitHub Action nodes now properly execute post-steps, matching the behavior of real GitHub Actions runners.

---

🐛 Bug Fixes

• Token Handling — GITHUB_TOKEN and INPUT_TOKEN are now captured from the environment and handled correctly. INPUT_TOKEN has been renamed to INPUT_GITHUB_TOKEN for clarity, with backwards compatibility for the old name.
• Group Node Validation — Fixed a ghost error in the validation function when a group node has issues.
• Job Conclusion Values — Expression evaluator now uses the correct job conclusion values.

---

📦 Upgrade Notes

This release is backwards compatible. No modifications to existing graphs are required.

v0.14.6

🐛 Bug fix: Expression evaluation no longer fails for non-string results

• Expressions like ${{ true }}, ${{ 1 == 1 }}, or any expression that evaluates to a boolean or number were previously failing with an error. They now correctly return their string representation (e.g., "true", "false"), matching GitHub Actions behavior.

v0.14.5

✨ New Features

• 📁 New core/dir-create@v1 node: You can now create directories!
• 🌐 Shared URL execution: Graphs can now be executed directly from a shared URLs
• 🐚 Shell installer: Added actrun.sh script for direct bash-based installation and execution
• 🔐 GitHub attestation: Published packages now include attestation for supply chain security
• 🧾 Software Bill of Materials (SBOM): All releases now come with attested SBOM.

🚀 Improvements

• ⚙️ Automatic GitHub Actions environment: No additional setup required in order to run a GitHub Actions workflow graph locally
• 📦 Native Git integration: Replaced a few git commands with the go-git library.
• ➖ Port naming flexibility: Hyphens are now allowed in port names for group nodes
• 🔧 Context fields: Added missing context fields in PushNewExecutionState for better state management

🐛 Bug Fixes

• 🛡️ Fixed URL parameter injection vulnerability in shared graph URL handling by restricting share ID regex
• 🏃 Fixed issues with mimicking GitHub Actions environment behavior
• 📝 Fixed documentation in readme

v0.12.6

✨ New Features

• 📁 New core/dir-create@v1 node: You can now create directories!
• 🌐 Shared URL execution: Graphs can now be executed directly from a shared URLs
• 🐚 Shell installer: Added actrun.sh script for direct bash-based installation and execution
• 🔐 GitHub attestation: Published packages now include attestation for supply chain security
• 🧾 Software Bill of Materials (SBOM): All releases now come with attested SBOM.

🚀 Improvements

• ⚙️ Automatic GitHub Actions environment: No additional setup required in order to run a GitHub Actions workflow graph locally
• 📦 Native Git integration: Replaced a few git commands with the go-git library.
• ➖ Port naming flexibility: Hyphens are now allowed in port names for group nodes
• 🔧 Context fields: Added missing context fields in PushNewExecutionState for better state management

🐛 Bug Fixes

• 🛡️ Fixed URL parameter injection vulnerability in shared graph URL handling by restricting share ID regex
• 🏃 Fixed issues with mimicking GitHub Actions environment behavior
• 📝 Fixed documentation in readme

🧪 Testing

• ✅ Added a few more e2e tests

v0.11.2

✨ New Features

• 🔐 Secret management overhaul: Renamed secret node to secret-get and added new secret-set node for complete secret lifecycle management
• 🔑 SecretValue type: Secrets now return a proper SecretValue object for consistency, with support for streaming and string conversion
• 🔤 New core/string-decode node: Added string decoding capabilities alongside new options for core/string-encode
• ⚡ Execution ports: Added execution ports to core/random-stream, core/random-number, and core/stream-cache nodes
• 📏 DataStream length field: DataStreamFactory now includes a length field for stream size information

🚀 Improvements

• 🔓 Input secrets are now properly resolved in group nodes
• 🎯 Accept any value for any and unknown outputs for better flexibility
• 🏷️ Improved error messages with node labels
• 🖥️ Added error handler for new web app editor console
• 🔄 Node ID aliases added for backwards compatibility

🐛 Bug Fixes

• 🔧 Fixed node traversal info for error printer by delaying visit popping
• 🔍 Fixed nil value detection by checking if the value was actually found
• 🧪 Fixed scope handling in tests
• 🚿 Reader is now properly closed by HTTP client instance
• 📊 Fixed workflow graph after changes to core/random-stream

v0.10.6

🎉 First Official Release of actrun

v0.0.1

🎉 This is the base release of actrun that helps to build future versions of actrun.