v0.5.1-rc.0

[github-actions[bot]]

v0.5.1-rc.0 - 2025-02-05

Bug Fixes

(cli) Avoid expected error backtrace (#960)

• Closes
  MET-801.

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

• Chores
• Updated error reporting configuration to reduce verbosity during panic
  events.

Secret leak when recovering (#965)

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

Release Notes

• New Features

• Added a deep cloning utility function to prevent unintended data
  mutations

• Introduced a new workflow management capability with a sayHello
  function

  • Enhanced replay request filtering in agent runtime

• Improvements

  • Refined runtime configuration handling
  • Improved code modularity and error handling in agent runtime

• Testing

  • Updated sync test configuration with new Redis backend
  • Added new workflow test script

---

Support union type for object node in apply tree (#969)

• Solve
  MET-790
  • Support union type or object node in apply tree

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

  • Enhanced type handling for optional and union types
  • Added support for complex GraphQL query retrieval

• Introduced new method for filtering user records with advanced
  conditions

• Tests

  • Added test case for complex object retrieval
  • Expanded test coverage for union type processing

• Improvements

  • Refined error reporting for type resolution
  • Improved handling of optional and union type definitions

Metagen papercuts (#950) - BREAKING: metagen papercuts (#950)

Solves
MET-761:

• Make generator naming consistent with the client_xx and fdk_xx format.
  Prefer shortened names of languages like the extension name of source
  files.
• Reuse a typegraph serialization across multiple generation runs in a
  single cli invocation. It currently re-serializes a typegraph if it's
  referenced twice.
• Explicit return types on QueryGraph methods for Typescript
• Support for non-record queries for Gql transport. Currently, one's
  forced to name the query/mutation section which gets reflected in the
  response name

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

Based on the comprehensive summary, here are the high-level release
notes:

• Generator Naming

  • Simplified generator names across the project
  • Updated from fdk_typescript → fdk_ts
  • Updated from fdk_python → fdk_py
  • Updated from fdk_rust → fdk_rs

• Type Management

• Transitioned from Box<Typegraph> to Arc<Typegraph> for improved
  memory management

  • Enhanced type flexibility in query and mutation methods
  • Added support for single and multiple node operations

• New Features

• Added identity and identity update functions across TypeScript,
  Python, and Rust clients

  • Improved caching mechanisms for typegraphs
  • Enhanced GraphQL transport layer with more flexible input handling

• Documentation

• Updated configuration examples and references to reflect new generator
  names

Use GraphQL-compliant response payload on error (#972)

• Use GraphQL-compliant response payload on error on all GraphQL
  endpoints

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

• Refactor
• Consolidated JSON response formatting for both success and error
  cases.
• Streamlined the handling of response structures across multiple
  service endpoints.
• Improved consistency and reliability of data returned to clients,
  ensuring structured JSON output for all interactions.
• Enhanced error handling to provide structured JSON responses across
  various services.

Better error message for missing artifacts (#973)

• Solve
  MET-821
  • Better error message for missing artifacts
  • Shared logic for artifact registration on postprocess

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

• Consolidated the artifact registration process to support bulk
  handling of primary and dependency artifacts.

• Refactor

• Streamlined registration workflows across multiple runtime
  integrations, enhancing efficiency and clarity.

• Tests

• Added comprehensive tests to ensure robust error reporting when
  dependencies are missing.

• Introduced a new test case to validate behavior for non-existent
  engine scripts.

Documentation

(sub) Polish substantial docs (#967)

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

• Documentation
  • Enhanced documentation for Substantial runtime.
  • Added new section on Backend operations.
  • Renamed existing Backend section to "Persistence and Lifecycle."
• Introduced new subsections on workflow management concepts including
  Context, Interrupts, Save, Send/Receive, and Ensure.
• Added a new section on Advanced Filters with examples for Python and
  TypeScript.
  • Corrected typographical errors for improved clarity.

---

Features

(cli) Add port option on list subcommand (#968)

remove default port and allow user specify the port directly from the
cli

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

  • Added optional port configuration for CLI command
  • Improved port specification flexibility for network operations

• Bug Fixes

  • Enhanced error handling for network requests
  • Removed hardcoded port value in favor of dynamic configuration

Worker pooling (#962)

• Solve
  MET-806

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

• Bug Fixes

  • Corrected a typographical error in a log message.
  • Enhanced error handling and reporting in various runtime components.

• Refactor

  • Improved worker management lifecycle methods.
  • Updated task delegation and worker allocation strategies.
  • Refined interrupt and workflow completion handling.
  • Enhanced configuration schema for worker settings.

• New Features

  • Introduced a more robust wait queue mechanism with timeout support.
  • Enhanced type safety for interrupt handling.

• Added new environment variables for managing Deno and substantial
  worker settings.

• Tests

  • Added a comprehensive test suite for wait queue implementation.

• Updated test configuration to ignore tests for the latest release
  version.

  • Enhanced validation logic for version handling.

• Chores

• Updated versioning across multiple configuration files and
  dependencies to reflect the transition to a release candidate version.

Wasm worker manager (#966)

• Closes
  MET-805.

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

Release Notes

• New Features

  • Added WebAssembly (WASM) worker management capabilities.
  • Introduced new type definitions for WASM runtime interactions.
  • Enhanced worker pool and worker manager functionality.

• Introduced a new WasmWorker class for managing WebAssembly workers.

• Configuration Changes

• Updated global configuration to include WASM worker-related settings.

• Replaced substantial_worker_wait_timeout_ms with more granular
  worker configuration options.

• Added new environment variables for WASM worker management:
  MIN_WASM_WORKERS and MAX_WASM_WORKERS.

• Runtime Improvements

  • Refactored runtime initialization processes.
  • Improved worker lifecycle management.

• Enhanced error handling and logging for various runtime environments.

  • Removed explicit destroy operations in some runtime components.

• Dependency Updates

  • Updated Metatype version to 0.5.1-rc.0.

• Performance Optimizations

  • Added pre-warming steps in performance tests.
  • Streamlined worker initialization and management.

• Code Quality

  • Improved code formatting and readability.
  • Simplified runtime and worker management interfaces.

---

---

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