workflow/observability

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

The workflow/observability package provides utilities for observability and debugging tools. Use it to hydrate serialized step input/output (I/O) for display and parse machine-readable names into display-friendly formats.

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

Data hydration

Name parsing

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.