GitHub

Utilities to hydrate serialized step I/O and parse machine-readable workflow names for display.

API reference for observability utilities from the workflow/observability package.

The observability package provides utilities for working with workflow data in observability and debugging tools — hydrating serialized step I/O for display, and parsing machine-readable names into display-friendly formats.

import { 
  hydrateResourceIO, 
  observabilityRevivers, 
  hydrateData, 
  parseStepName, 
  parseWorkflowName, 
  parseClassName, 
} from "workflow/observability";

Data Hydration

hydrateResourceIO()

Hydrate the serialized data fields of a run, step, hook, or event for display.

observabilityRevivers

Standard revivers for deserializing workflow data types (Date, Map, Set, streams, etc.).

hydrateData()

Hydrate a single serialized value (lower-level than hydrateResourceIO).

Name Parsing

parseStepName()

Parse a machine-readable step name into display-friendly components.

parseWorkflowName()

Parse a machine-readable workflow name into display-friendly components.

parseClassName()

Parse a machine-readable class ID into display-friendly components.

Encrypted Data

When a World stores encrypted data, the hydration utilities intentionally leave encrypted values untouched: hydrateData() and hydrateResourceIO() return encrypted fields as raw Uint8Array values so observability tools can detect them and decide how to render them (for example, the Workflow CLI shows an "Encrypted" placeholder). Decryption is handled by the runtime and the World implementation — see Encryption for how keys are managed.

workflow/observability