Pre-1.0. These are the schemas an installed CLI validates against today (
schema_version 0.1.0). The format is documented but not frozen: the v1.0 freeze is a roadmap gate, and its v1.0 target schema is published separately and is not yet in force.run-capsule.schema.jsonRunCapsule · capsule.yamlThe top-level manifest of a Run Capsule: run id, status, command, timing, host, and references to every sub-file.model-call.schema.jsonModelCall · model-calls.jsonlOne record per LLM call, aligned with the OpenTelemetry GenAI semantic conventions.tool-call.schema.jsonToolCall · tool-calls.jsonlOne record per tool invocation: MCP-aligned, transport-agnostic, with a mutation class.environment.schema.jsonEnvironmentLock · env.lockThe environment a replay needs to reconstruct: host, runtime, hardware, allow-listed variables, locale.lineage-edge.schema.jsonLineageEdge · lineage.jsonlOne directed edge in the lineage graph between runs, assets and artifacts.replay-policy.schema.jsonReplayPolicy · replay.yamlWhat replay may do with external resources and mutating tools.replay-result.schema.jsonReplayResult · replay_result.yamlThe output manifest of a replay: mode, status, policy flags used, environment warnings, what was mocked.secret-redaction.schema.jsonRedactionProof · redaction-proof.jsonWhat secret scanning detected, where, and how it was redacted, without storing the secrets themselves.evidence-bundle.schema.jsonEvidenceBundle · manifest.json (bundle)The manifest at the root of a signed Evidence Bundle, the second of the two formats NovaFabric defines.diff-report.schema.jsonDiffReport · nova diff --output-format jsonA structural diff between two Run Capsules: environment, model calls, tool calls and outputs.
Check a capsule against them
Locally, nova validate <run-id> checks a capsule against these schemas, and nova validate --schemas also checks each tool call's arguments and result against the schemas the tool declared.
In your browser, the Run Capsule demo compiles run-capsule.schema.json with Ajv and validates a captured manifest; break the manifest and it turns red. What each file holds is described file by file in the Run Capsule docs.