Run validation and return the detailed execution trace.
Shows the exact sequence of validation nodes that ran, whether
each was deterministic, and the runtime of each node. Use for
debugging, compliance audits, or understanding exactly what the
platform checked.
Different from validate: validate returns the verdict (PASS / FAIL
/ REVIEW) and the state vector summary. get_execution_trace returns
everything validate does PLUS the per-node trace records. Use
validate for normal operation; use get_execution_trace when you
need to see inside the pipeline (debugging, audit prep, latency
analysis).
The trace is the same whether validation passes or fails — every
node that ran is recorded with its inputs, outputs, and timing.
Args:
api_key: GeodesicAI API key (starts with gai_)
structured_data: The data to trace validation for
blueprint: Blueprint to validate against. Caller must
own the Blueprint.
Returns:
status: "PASS" / "FAIL" / "REVIEW" / "ERROR"
determinism_hash: cryptographic hash of inputs + rules
trace: ordered list of node records, each with:
node_name, node_type, deterministic (bool),
runtime_ms, inputs, outputs
node_count: number of nodes in the trace
deterministic_count: how many nodes were deterministic
state_vector: same state_vector validate returns