Coerce an arbitrary tool-call trace (an array of {name,args} entries or a partial Trace object) into the canonical agentsnap Trace shape. Returns the normalized trace plus a SHA-256 fingerprint hash computed over the canonical (key-sorted) JSON, so two runs can be byte-compared cheaply.

Diff two normalized agentsnap traces and surface meaningful differences. Returns same=true on a structural match, otherwise lists additions (paths only present in current), removals (paths only present in baseline), and changes (paths whose values differ). Use ignore_paths to drop noisy fields (e.g. ["fingerprint","tools[0].result_hash"]) before classification.

Sanity-check a snapshot object against the agentsnap Trace schema. Verifies required fields (version, tools, fingerprint), tool-entry shape (name + args), and surfaces actionable issues. Returns valid=true on success, otherwise a list of human-readable issues.