mixle.task.trace_record module

IC-5 — the frozen trace/receipt envelope the dataset foundry (M4) mines (work-plan §5, DR-ALG M4).

Frozen top-level keys: prompt, steps, outcome, provenance; each step: tool, args, result, model, verdict. validate_trace_record enforces the names so a producer (executor/gateway/receipt) and the consumer (M4 trace miner) never drift. from_execution_trace lifts a core mixle.task.replay.ExecutionTrace into the envelope.

This module was specified (frozen) in notes/exec/contracts.md §IC-5. E7 (cross-chain provenance receipt) uses validate_trace_record to shape its lineage receipt, while from_execution_trace performs the public lossless lift from replay traces into the frozen envelope.

class TraceStepRecord[source]

Bases: TypedDict

class TraceRecord[source]

Bases: TypedDict

validate_trace_record(d)[source]

Validate the complete frozen trace-record schema.

Parameters:

d (dict[str, Any])

Return type:

None

from_execution_trace(trace, *, outcome=None, provenance=None)[source]

Lift a mixle.task.replay.ExecutionTrace into the frozen envelope (fills model/verdict as None).

Parameters:
Return type:

TraceRecord