v0.5.1-rc.5

[github-actions[bot]]

v0.5.1-rc.5 - 2025-07-18

Bug Fixes

(gate) Auth refactor (#1028) - BREAKING: auth refactor (#1028)

• Solves
  MET-885.

Migration notes

---

• The change comes with new or modified tests
• Hard-to-understand functions have explanatory comments
• End-user documentation is updated to reflect the change

Summary by CodeRabbit

• New Features

• OAuth2 authentication now supports multiple clients per provider with
  explicit client ID and redirect URI configuration.

• Introduced a secure PKCE-based token flow requiring Redis for state
  management, including new token exchange and refresh endpoints.

  • Added Redis configuration support for both sync and non-sync modes.

• Improvements

• Unified OAuth2 configuration across Python, TypeScript, and Rust SDKs
  with a single structured interface replacing provider-specific methods.

• Enhanced validation and security for OAuth2 redirect URIs and client
  identification.

  • Updated JWT token duration defaults and made them configurable.
  • Modularized Redis URL parsing and connection logic.

• Bug Fixes

• Improved error handling and validation in OAuth2 token and
  authorization flows.

• Documentation

• Updated OAuth2 authentication docs to reflect the new PKCE token flow,
  token refresh, and Redis requirements.

• Added Redis configuration and updated JWT duration defaults in
  environment variable documentation.

• Tests

• Expanded authentication tests to cover PKCE, Redis state management,
  token exchange, and refresh flows.

• Chores

  • Updated example projects to use the new OAuth2 configuration format.
  • Removed deprecated OAuth2 helper methods and related code.

(sub) Recover from broken run + race conditions (#1033)

• Broken run

1. Detect already handled schedules but interrupted before closing then
   close/skip them
2. Try to recover from schedule dups such as

 [Start Start ...] or
 [... Stop Stop] or
 [ .... Event X Event X ... ]

These dups can occur when we crash at a given timing and the underlying
event of the appointed schedule was not closed. The engine will happily
append onto the operation log, we throw by default but realistically we
can recover.
However 1. should make sure dups do not occur accross all nodes, this
should mitigate unknown unknowns (timestamp identifies schedules so it
should be safe).
WARN: Undesirable side effects cannot be ruled out if we crash before
saving the Saved results.

• Moved from setInterval to a custom blocking async interval
• Changed lease renew logic

Migration notes

• The change comes with new or modified tests
• Hard-to-understand functions have explanatory comments
• End-user documentation is updated to reflect the change

Summary by CodeRabbit

Summary by CodeRabbit

• New Features

• Added a Redis Commander service for easier Redis database management
  via a web interface.

• Introduced lease heartbeat renewal to automatically manage lease
  lifetimes.

• Added asynchronous interval control to ensure sequential execution of
  recurring tasks.

• Bug Fixes

• Improved handling of duplicate operations and run state validation to
  prevent data inconsistencies and duplicate scheduling.

  • Enhanced logic to prevent appending operations to stopped runs.

• Added run log integrity validation to detect corrupted or overlapping
  run states.

• Refactor

• Replaced and reorganized utility functions for checking run status and
  operation scheduling.

• Updated type definitions and imports for better code clarity and
  maintainability.

• Improved logging, debugging, and tracing for better observability and
  troubleshooting.

• Replaced standard intervals with controlled async intervals to avoid
  concurrency issues.

• Tests

• Added assertions to verify lease expiration and run state consistency.

• Style

  • Reformatted import statements for consistency and readability.

• Documentation

• Added comments and documentation to clarify lease handling,
  concurrency, and run integrity validation.

Prisma query batching (#1027)

Features

(gate) Idempotent request (#1031)

Migration notes

None

• The change comes with new or modified tests
• Hard-to-understand functions have explanatory comments
• End-user documentation is updated to reflect the change

Summary by CodeRabbit

• New Features

• Introduced idempotency support for GraphQL requests, enabling repeated
  requests with the same idempotency key to return cached responses for up
  to one day.

• Added a new GraphQL query nextInt that returns an incrementing
  integer.

• Provided documentation explaining how to use the idempotency key
  header to ensure safe request retries.

• Chores

• Removed an unused port and its metadata from internal configuration
  files.

(sub) Query workflow logs + timing bug fix when stressed (#1034)

• Make a separate entity for log events
• Query log by run
• Fix timing error when there are many workflows running at the same
  time but too few workers
  (MET-902)

Migration notes

• ctx.logger.*() does not return Promise anymore

• The change comes with new or modified tests
• Hard-to-understand functions have explanatory comments
• End-user documentation is updated to reflect the change

Summary by CodeRabbit

• New Features

• Added structured logging support to workflows, enabling logs with
  levels (Info, Warn, Error) to be recorded and queried for each workflow
  run.

• Workflow run results now include detailed logs, accessible via GraphQL
  queries.

• Introduced documentation on debugging workflows and accessing logs in
  real time.

• Added a stress test script and a helper client for workflow run
  management.

• Bug Fixes

• Improved deduplication of operations to prevent duplicate logs after
  crashes or incomplete saves.

• Improvements

• Logging methods (info, warn, error) are now synchronous for
  better usability.

• Enhanced error handling and validation in workflow runtime and agent
  logic.

  • Lowered the minimum polling interval for workflow status checks.

• Documentation

• Expanded documentation with detailed guides and examples for workflow
  logging and debugging.

• Tests

• Extended test coverage to verify workflow logs and blocking interval
  behavior.

• Updated existing tests to reflect new synchronous logging and log
  retrieval features.

• Style

• Various formatting and consistency improvements in code and type
  declarations.

• Chores

• Updated dependencies and configuration for improved compatibility and
  performance.

---

(sub) Detect non deterministic run (#1037)

Miscellaneous Tasks

Update deno to v2.2.4 (#923)

Bump ghjk to 0.3.1-rc.2 (#1029)

= Updates ghjk to 0.3.1-rc.2

Summary by CodeRabbit

• Chores

• Upgraded the GHJK tool and related dependencies to version v0.3.1-rc.2
  across workflows, Dockerfiles, and configuration files.

• Updated Python version to 3.9.23 and improved Docker build context
  handling for Rust projects.

• Switched to using external GHJK packages for imports and streamlined
  environment setup in CI workflows.

• Expanded and reorganized ignore and configuration files for better
  build and linting control.

• Refreshed port references, versions, build dependencies, and profiles
  in configuration files.

• Updated environment variables and deployment workflows for consistency
  and reliability.

• Added new GHJK and Deno configuration files to support workspace and
  import map management.

• Refactor

• Reformatted and improved code style across many files for consistency
  and readability, including type declarations, method signatures,
  imports, and code generation templates.

  • Updated export and import orders in various modules for clarity.

• Improved formatting in test cases and utility scripts for better
  maintainability.

• Enhanced formatting and indentation in HTML, YAML, and CSS files for
  readability.

• Documentation

• Updated contributing instructions to reflect new tool versions and
  directory names.

• Bug Fixes

• Increased the timeout threshold for Python runtime tests to reduce
  false negatives.

• Improved workflow reliability by sourcing environment activation
  scripts and updating caching strategies.

• New Features

• Added new configuration files for GHJK and Deno environments to
  support enhanced build and development workflows.

---

This discussion was created from the release v0.5.1-rc.5.