External Task Result

external_task_result

ExternalTaskResultError dataclass

ExternalTaskResultError(message)

Bases: ValueError

Raised when a handler result envelope violates the v1 result contract.

parse_external_task_result

parse_external_task_result(envelope)

Parse and validate a v1 external task result envelope.

The parser follows the server contract's additive-field policy: unknown optional fields are ignored, while required fields and known enum values are enforced so carriers can make stable retryability and failure decisions.

parse_external_task_result_artifact

parse_external_task_result_artifact(artifact)

Validate a cluster-info fixture artifact and parse its embedded example.