External Task Input

external_task_input

ExternalTaskInputError dataclass

ExternalTaskInputError(message)

Bases: ValueError

Raised when a leased external task input envelope violates the v1 contract.

parse_external_task_input

parse_external_task_input(envelope)

Parse and validate a v1 carrier-neutral external task input envelope.

Unknown optional fields are ignored, matching the server contract's additive field policy. Required top-level and known nested fields are enforced so an SDK carrier can fail closed before invoking user handlers.

parse_external_task_input_artifact

parse_external_task_input_artifact(artifact)

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