nat.atif.atif_step_extra

Typed models for NAT metadata inside ATIF Step.extra.

Classes

AtifAncestry	Validated ancestry metadata embedded in ATIF Step.extra.
AtifInvocationInfo	Invocation timing metadata embedded in ATIF Step.extra.
AtifStepExtra	Validated structure for NAT-owned ATIF Step.extra payload.

Module Contents

class AtifAncestry(/, **data: Any)

Bases: pydantic.BaseModel

Validated ancestry metadata embedded in ATIF Step.extra.

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

function_id: str = None

function_name: str = None

parent_id: str | None = None

parent_name: str | None = None

class AtifInvocationInfo(/, **data: Any)

Bases: pydantic.BaseModel

Invocation timing metadata embedded in ATIF Step.extra.

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

start_timestamp: float | None = None

end_timestamp: float | None = None

invocation_id: str | None = None

status: str | None = None

framework: str | None = None

validate_timestamp_pairing() → AtifInvocationInfo

class AtifStepExtra(/, **data: Any)

Bases: pydantic.BaseModel

Validated structure for NAT-owned ATIF Step.extra payload.

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

ancestry: AtifAncestry = None

invocation: AtifInvocationInfo | None = None

tool_ancestry: list[AtifAncestry] = None

tool_invocations: list[AtifInvocationInfo] | None = None