Skip to main content
This page documents the version history, new features, bug fixes, and breaking changes for Circuit Breaker Labs GitHub Actions.

Version History

Latest (HEAD)

Released: January 6, 2026 Changes:
  • Updated to Circuit Breaker Labs Python client v1.0.7
  • Enhanced API compatibility with latest endpoint specifications
  • Improved error handling and response parsing

v1.0.2

Released: January 6, 2026 New Features:
  • Multi-turn evaluation support - Added two new actions for evaluating conversational safety:
    • multiturn-evaluate-system-prompt - Test system prompts with multi-turn conversations
    • multiturn-evaluate-openai-finetune - Test fine-tuned models with multi-turn conversations
  • Multi-turn evaluations detect sophisticated attacks that unfold over multiple conversation turns
  • Support for configurable max-turns parameter (must be even)
  • Support for test-types parameter to specify attack strategies
Improvements:
  • Enhanced output formatting for multi-turn conversation display
  • Added conversation turn numbering for easier debugging
  • Improved safety score calculation across conversation history
Action References: Migration Notes: No breaking changes. Existing single-turn actions continue to work unchanged. To adopt multi-turn testing:
# New multi-turn action
- name: Run multi-turn evaluation
  uses: circuitbreakerlabs/actions/[email protected]
  with:
    fail-action-threshold: "0.80"
    fail-case-threshold: "0.5"
    max-turns: "4"
    test-types: "jailbreak context_manipulation"
    system-prompt: ${{ env.SYSTEM_PROMPT }}
    openrouter-model-name: "anthropic/claude-3.7-sonnet"
    circuit-breaker-labs-api-key: ${{ secrets.CBL_API_KEY }}
Multi-turn evaluations may take longer to run than single-turn tests due to the sequential nature of conversations.

v1.0.1

Released: December 5, 2025 Improvements:
  • Code formatting standardization across all action implementations
  • Improved YAML structure and consistency in action.yml files
  • Enhanced code comments and documentation strings
  • Standardized naming conventions throughout the codebase
Technical Changes:
  • Applied Ruff formatting to all Python source files
  • Updated type hints for better static analysis
  • Improved error message clarity
No functional changes - This release focuses on code quality and maintainability.

v1.0.0

Released: December 5, 2025 Initial Release First stable release of Circuit Breaker Labs GitHub Actions with support for single-turn evaluations. Features:
  • System Prompt Evaluation - singleturn-evaluate-system-prompt action
    • Test system prompts against adversarial attacks
    • Configurable safety thresholds
    • Iterative attack refinement with multiple layers
    • Support for OpenRouter models
    • Optional test case group filtering
  • OpenAI Fine-Tune Evaluation - singleturn-evaluate-openai-finetune action
    • Test OpenAI fine-tuned models
    • Direct integration with OpenAI API
    • Same threshold and variation controls as system prompt evaluation
    • Support for all OpenAI fine-tuning base models
Core Capabilities:
  • Automated safety evaluation in CI/CD pipelines
  • Configurable failure thresholds at both case and action levels
  • Detailed failure output with adversarial inputs and model responses
  • GitHub Actions secret integration for API keys
  • Zero-configuration setup using composite actions
  • Automatic dependency management via uv
API Integration:
  • Direct mapping to Circuit Breaker Labs API v1 endpoints
  • Authentication via cbl-api-key header
  • Support for custom test case groups
  • Comprehensive error handling and reporting
Example Usage:
name: Evaluate System Prompt

on:
  push:
    branches: [main]
  pull_request:

jobs:
  evaluate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      
      - name: Run safety evaluation
        uses: circuitbreakerlabs/actions/[email protected]
        with:
          fail-action-threshold: "0.80"
          fail-case-threshold: "0.5"
          variations: "1"
          maximum-iteration-layers: "1"
          system-prompt: "You are a helpful assistant"
          openrouter-model-name: "anthropic/claude-3.7-sonnet"
          circuit-breaker-labs-api-key: ${{ secrets.CBL_API_KEY }}
Dependencies:
  • Python 3.13+
  • circuit-breaker-labs Python client v1.0.7
  • uv package manager
  • astral-sh/setup-uv action

Pre-Release Development

December 5, 2025

  • Initial documentation improvements
  • Added README badges for zizmor, Ruff, and MyPy
  • Improved usage examples in README
  • Added Python client repository link

December 5, 2025

  • Added CI/CD workflows for linting and type checking
  • Integrated zizmor for GitHub Actions security scanning
  • Added Ruff linter configuration
  • Added MyPy for static type checking

November 26, 2025

  • Initial repository setup
  • Project structure and tooling configuration
  • Base implementation of evaluation actions

Versioning Policy

Circuit Breaker Labs GitHub Actions follow Semantic Versioning 2.0.0:
  • Major version (X.0.0): Breaking changes that require workflow updates
  • Minor version (0.X.0): New features, backward compatible
  • Patch version (0.0.X): Bug fixes, backward compatible
For production workflows, we recommend pinning to a major version:
# Recommended: Pin to major version (gets latest minor/patch updates)
uses: circuitbreakerlabs/actions/singleturn-evaluate-system-prompt@v1

# More strict: Pin to specific version (no automatic updates)
uses: circuitbreakerlabs/actions/[email protected]

# Not recommended for production: Use main branch (unstable)
uses: circuitbreakerlabs/actions/singleturn-evaluate-system-prompt@main
Using @main in production workflows may introduce breaking changes without warning. Always pin to a version tag.

Upgrade Guides

Upgrading to v1.0.2 (Multi-Turn Support)

No breaking changes. All existing single-turn actions work unchanged. To adopt multi-turn testing alongside existing single-turn tests:
jobs:
  # Existing single-turn tests continue to work
  singleturn-test:
    runs-on: ubuntu-latest
    steps:
      - uses: circuitbreakerlabs/actions/singleturn-evaluate-system-prompt@v1
        with:
          # ... existing configuration ...

  # Add new multi-turn tests
  multiturn-test:
    runs-on: ubuntu-latest
    steps:
      - uses: circuitbreakerlabs/actions/multiturn-evaluate-system-prompt@v1
        with:
          fail-action-threshold: "0.80"
          fail-case-threshold: "0.5"
          max-turns: "4"
          test-types: "jailbreak context_manipulation"
          system-prompt: ${{ env.SYSTEM_PROMPT }}
          openrouter-model-name: "anthropic/claude-3.7-sonnet"
          circuit-breaker-labs-api-key: ${{ secrets.CBL_API_KEY }}
New Parameters:
  • max-turns: Maximum conversation length (must be even)
  • test-types: Space-separated list of attack types
Removed Parameters:
  • variations - Not applicable to multi-turn tests
  • maximum-iteration-layers - Not applicable to multi-turn tests

Upgrading to v1.0.0 (Initial Release)

First stable release. No upgrade path needed.

Breaking Changes

No breaking changes have been introduced since v1.0.0.

Deprecation Notices

No features are currently deprecated.

Python Client Dependency

The actions use the Circuit Breaker Labs Python client library: Client updates are tested and integrated with each action release.

Continuous Integration

All releases are validated through automated CI/CD pipelines:
  • Linting: Ruff checks code formatting and style
  • Type Checking: MyPy validates type annotations
  • Security Scanning: zizmor analyzes GitHub Actions for security issues
View the CI status:

Stay Updated

  • GitHub Releases: Watch the repository for release notifications
  • GitHub Discussions: Join conversations about upcoming features
  • Email Updates: Contact [email protected] to subscribe to release announcements

Feedback and Contributions

We welcome feedback and contributions:
Before contributing, please review our security policy and code of conduct in the repository.

Build docs developers (and LLMs) love