Changelog
Version 0.15.4
Section titled “Version 0.15.4”Highlights of this release:
- 🆕 Local Debugging Session - Debug graphs locally via a WebSocket session.
- 🆕 MCP Server - Built-in MCP server with debug tools and a WebSocket bridge.
- 🆕 GitHub Actions Mock Server - Local mock server for GitHub Actions when debugging graphs.
- 🆕 JSON Schema for .act Files - Validate graph files against a JSON schema.
- ✨ Post-Step Execution for GitHub Action Nodes - GitHub Action nodes now execute post-steps.
- 🐛 Bug Fixes - Token handling, group node validation, and job conclusion fixes.
🆕 Local Debugging Session
Section titled “🆕 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
Section titled “🆕 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
Section titled “🆕 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
Section titled “🆕 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
Section titled “✨ 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
Section titled “🐛 Bug Fixes”- Token Handling —
GITHUB_TOKENandINPUT_TOKENare now captured from the environment and handled correctly.INPUT_TOKENhas been renamed toINPUT_GITHUB_TOKENfor 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
Section titled “📦 Upgrade Notes”This release is backwards compatible. No modifications to existing graphs are required.
Version 0.14.6
Section titled “Version 0.14.6”Highlights of this release:
- 🐛 Expression Evaluation Fix - Expressions evaluating to non-string types (booleans, numbers) are now automatically converted to strings instead of returning an error.
🐛 Expression Evaluation Fix
Section titled “🐛 Expression Evaluation Fix”Previously, expressions that evaluated to non-string types (e.g., ${{ startsWith(github.ref, 'refs/tags/') }} → true, or ${{ 1 + 2 }} → 3) would fail with an error. They are now automatically converted to their string representation, so you can use boolean and numeric expressions anywhere a string value is expected.
📦 Upgrade Notes
Section titled “📦 Upgrade Notes”This release is backwards compatible. No modifications to existing graphs are required.
Version 0.14.5
Section titled “Version 0.14.5”Highlights of this release:
- 🆕 Docker Run Node - Run Docker containers directly from your workflows.
- 🆕 Steps Context - Reference outputs from previous steps in your workflow.
- ⚠️ CLI Flag Changes - CLI flags now use hyphens instead of underscores.
🆕 Docker Run Node
Section titled “🆕 Docker Run Node”New Docker Run node (core/docker-run@v1) lets you run Docker containers directly within your workflows. Configure the image, command, environment variables, and volumes — all from the visual editor.
Environment variables from the host are no longer passed into containers unless explicitly allowed, so your container runs stay isolated and predictable.
🆕 Steps Context
Section titled “🆕 Steps Context”You can now reference outputs from previous steps in your workflow using the steps context, similar to GitHub Actions’ steps.<id>.outputs.<name>. This makes it easy to pass data between nodes in multi-step workflows.
⚠️ CLI Flag Changes
Section titled “⚠️ CLI Flag Changes”CLI flags have been renamed to use hyphens (e.g., --graph-file instead of --graph_file) for consistency. If you have scripts that invoke actrun directly, update your flags accordingly.
📦 Upgrade Notes
Section titled “📦 Upgrade Notes”The CLI flag naming change is a breaking change for scripts using the old underscore-based flag names. Update any automation scripts to use the new hyphenated flag names.
Version 0.12.6
Section titled “Version 0.12.6”Highlights of this release:
- 🐛 Improved GitHub Actions Compatibility - Better detection of the GitHub Actions environment, including improved token and workspace resolution.
📦 Upgrade Notes
Section titled “📦 Upgrade Notes”This release is backwards compatible. No modifications to existing graphs are required.
Version 0.12.4
Section titled “Version 0.12.4”Highlights of this release:
- 🆕 Run Graphs from URLs - Execute graphs directly from shared URLs.
- 🆕 Dir Create Node - New node to create directories.
- 🆕 actrun.sh - Run actrun directly via bash without installing.
- ✨ Automatic GitHub Actions Setup - GitHub Actions environment is now configured automatically.
🆕 Run Graphs from URLs
Section titled “🆕 Run Graphs from URLs”You can now pass a shared graph URL directly to actrun instead of a local file path. This makes it easy to run graphs shared by others without downloading them first.
🆕 Dir Create Node
Section titled “🆕 Dir Create Node”New Dir Create node (core/dir-create@v1) creates directories as part of your workflow.
🆕 actrun.sh
Section titled “🆕 actrun.sh”A new actrun.sh script lets you run actrun directly via bash/curl without installing the CLI first — useful for quick testing or CI environments.
✨ Automatic GitHub Actions Setup
Section titled “✨ Automatic GitHub Actions Setup”When running inside a GitHub Actions workflow, actrun now automatically detects and configures the GitHub environment. No manual setup required.
📦 Upgrade Notes
Section titled “📦 Upgrade Notes”This release is backwards compatible. No modifications to existing graphs are required.
Version 0.11.2
Section titled “Version 0.11.2”Highlights of this release:
- 🆕 String Decode node - Decode Base64, Hex, UTF-16/32, and unescape HTML/URL/JSON/XML.
- ✨ Enhanced String Encode - New encoding options including UTF-16/32 and escape sequences.
- 🔐 Secrets in Group Nodes - Group nodes now properly resolve secret inputs.
🆕 String Decode Node
Section titled “🆕 String Decode Node”New String Decode node (core/string-decode@v1) decodes strings from various formats back to UTF-8.
Supported operations:
- Base16 (Hex), Base32, Base64, Base64 URL-safe
- UTF-16 LE/BE, UTF-32 LE/BE
- HTML, URL (Query/Path), JSON, XML unescape
✨ Enhanced String Encode
Section titled “✨ Enhanced String Encode”The String Encode node (core/string-encode@v1) now supports additional operations:
- UTF-16 LE/BE, UTF-32 LE/BE encoding
- HTML, URL (Query/Path), JSON, XML escape
Note: Raw byte format outputs (UTF-16, UTF-32) are not human-readable and intended for use with the String Decode node.
🔐 Secrets in Group Nodes
Section titled “🔐 Secrets in Group Nodes”Group nodes now properly resolve secret inputs. You can now pass secrets into group nodes and use them within the group’s internal workflow.
📦 Upgrade Notes
Section titled “📦 Upgrade Notes”This release is backwards compatible. No modifications to existing graphs are required.
Version 0.10.6
Section titled “Version 0.10.6”Highlights of this release:
- 🎉 First Official Release - Initial public release of Actionforge actrun CLI.