Module atif

Generated from cargo doc --no-deps -p nemo-relay -p nemo-relay-adaptive -p nemo-relay-ffi.

Agent Trajectory Interchange Format (ATIF) exporter.

This module provides types and an exporter that collects lifecycle events from the NeMo Relay runtime and converts them into ATIF trajectories conforming to the ATIF v1.7 schema.

Overview

The AtifExporter registers as an event subscriber, collects all events, and can export them as an AtifTrajectory via AtifExporter::export.

Event-to-Step Mapping

The core conversion from NeMo Relay events to ATIF steps follows these rules:

• NeMo Relay Event | ATIF Step | Notes
• LLM Start | user step | Messages extracted from LlmRequest
• LLM End | agent step | Response content, tool_calls promoted
• Tool Start | (skipped) | tool_calls come from LLM End instead
• Tool End | agent observation | Correlated by source_call_id
• Mark (with data) | system step | Custom event data preserved
• Scope Start/End | (skipped) | Structural events, not trajectory

The exporter serializes the full collected event stream into a single ATIF trajectory.

Structs

• AtifAgentInfo: Information about the agent that produced the trajectory.
• AtifAncestry: Lineage node identifying a callable within an ATIF step.
• AtifExporter: Collects lifecycle events and exports them as ATIF trajectories.
• AtifFinalMetrics: Aggregate statistics for the entire trajectory (ATIF final_metrics).
• AtifInvocationInfo: Invocation timing and correlation metadata for one execution occurrence.
• AtifMetrics: Token usage and cost metrics for a single step.
• AtifObservation: Observation results from tool execution.
• AtifObservationResult: A single observation result from a tool call.
• AtifStep: A single step in an ATIF trajectory.
• AtifStepExtra: Lineage payload serialized into ATIF Step.extra.
• AtifSubagentTrajectoryRef: Reference to a delegated subagent trajectory.
• AtifToolCall: A tool call made by the agent.
• AtifTrajectory: A complete ATIF trajectory.

Constants

• ATIF_SCHEMA_VERSION: The ATIF schema version string embedded in all exported trajectories.