3.4.0

⭐ Features

• add support for windows-2025 runner
• allow accessing base_ref in Kotlin-based steps

🛠️ Fixes

• do not check if .git is a dir

💣 Breaking changes

None.

📦 Dependencies

• update dependency org.jetbrains.kotlinx:kotlinx-serialization-core to v1.8.1
• update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.8.1

---

The above release notes include customer-facing changes.
If you're interested also in internal changes, please see the full change log: v3.3.0...v3.4.0

3.3.0

⭐ Features

None.

🛠️ Fixes

• allow running Kotlin-based step if multiple workflows in single file

💣 Breaking changes

• allow running Kotlin-based step if multiple workflows in single file
  • breaking only if you use the experimental feature of Kotlin-based steps

📦 Dependencies

• update kotlin monorepo to v2.1.10
• update dependency it.krzeminski:snakeyaml-engine-kmp to v3.1.1

---

The above release notes include customer-facing changes.
If you're interested also in internal changes, please see the full change log: v3.2.0...v3.3.0

3.2.0

⭐ Features

• allow setting custom step ID
• add 'type' argument to Release trigger
• allow building ActionStep outside of job
• add properties to WorkflowCall trigger
• add 'number' as input type of WorkflowDispatch

🛠️ Fixes

None.

💣 Breaking changes

Some of the above features in very rare contexts may be breaking.

📦 Dependencies

None.

---

The above release notes include customer-facing changes.
If you're interested also in internal changes, please see the full change log: v3.1.0...v3.2.0

3.1.0

⭐ Features

• allow fallback to local bindings server in consistency check job
• add prefixes to step names for fallback path

This release focuses on adding a way to mitigate the binding server's availability issues, if they ever reoccur. This opt-in feature can be used in the following way:

consistencyCheckJobConfig = DEFAULT_CONSISTENCY_CHECK_JOB_CONFIG.copy(
    useLocalBindingsServerAsFallback = true,
),

which will result in adding an alternative path to your consistency check jobs that will be triggered if the original consistency check fails on compiling the script. Enabling this option costs you nothing in terms of extra CI time, if the server is up. If the server is down, it's usually an extra half a minute to up the server and rerun the workflow script.

Example:

🛠️ Fixes

None.

💣 Breaking changes

None.

📦 Dependencies

• update dependency it.krzeminski:snakeyaml-engine-kmp to v3.1.0
• update dependency org.jetbrains.kotlinx:kotlinx-serialization-core to v1.8.0
• update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.8.0

---

The above release notes include customer-facing changes.
If you're interested also in internal changes, please see the full change log: v3.0.2...v3.1.0

3.0.2

⭐ Features

None.

🛠️ Fixes

None.

💣 Breaking changes

None.

📦 Dependencies

• update Kotlin to v2.1.0
• update it.krzeminski:snakeyaml-engine-kmp to v3.0.3

---

The above release notes include customer-facing changes.
If you're interested also in internal changes, please see the full change log: v3.0.1...v3.0.2

3.0.1

This release is mainly to deploy changes in the docs.

⭐ Features

None.

🛠️ Fixes

None.

💣 Breaking changes

None.

📦 Dependencies

• update Kotlin to 2.0.21
• update kotlinx.serialization to 1.7.3

---

The above release notes include customer-facing changes.
If you're interested also in internal changes, please see the full change log: v3.0.0...v3.0.1

3.0.0

⭐ Features

• add RepositoryDispatch.types
• make outputs accessible for all steps (thanks @Vampire!)
• support getting uses string and YAML arguments as string (thanks @Vampire!)

🛠️ Fixes

💣 Breaking changes

• remove bundled action bindings - see the migration guide: https://typesafegithub.github.io/github-workflows-kt/user-guide/migrating-to-Maven-based-bindings/
• do not return Workflow from workflow builder - from now on, use useWorkflow parameter of workflow function
• make outputs accessible for all steps - you may need to replace Step with e.g. Step<*> or a particular type

---

The above release notes include customer-facing changes.
If you're interested also in internal changes, please see the full change log: v2.3.0...v3.0.0

2.3.0

⭐ Features

• allow providing callback to use workflow object
  • the workflow function won't return the Workflow object starting from v3, and this feature provides the new API for using the Workflow domain object

🛠️ Fixes

None.

💣 Breaking changes

None.

▶️ Actions

Warning

This is the last release with bundled bindings. The next release is going to be 3.0.0, with the bundled bindings removed, together with this section of the release notes. Please switch to Maven-based bindings server, see Migrating to Maven-based bindings

• add madhead/intellij-http-client-action@v241
• update ReactiveCircus/android-emulator-runner@v2
• update julia-actions/setup-julia@v2
• update aws-actions/amazon-ecs-render-task-definition@v1

---

The above release notes include customer-facing changes.
If you're interested also in internal changes, please see the full change log: v2.2.0...v2.3.0

2.2.0

⭐ Features

None.

🛠️ Fixes

None.

💣 Breaking changes

None.

▶️ Actions

• add docker/build-push-action@v6
• update peter-evans/create-pull-request@v6
• update gradle/gradle-build-action@v3

---

The above release notes include customer-facing changes.
If you're interested also in internal changes, please see the full change log: v2.1.1...v2.2.0

2.1.1

No changes in the library itself.

An internal release, to update the docs and let you know that we're changing the URL for the action bindngs server (more context on this feature here) - please update your scripts:

- @file:Repository("https://github-workflows-kt-bindings.colman.com.br/binding/")
+ @file:Repository("https://bindings.krzeminski.it/")

The old URL (https://github-workflows-kt-bindings.colman.com.br/binding/) will still work until the end of August 2024.

Slack thread: https://kotlinlang.slack.com/archives/C02UUATR7RC/p1718314294799469

---

The above release notes include customer-facing changes.
If you're interested also in internal changes, please see the full change log: v2.1.0...v2.1.1