# BuildRecordItem

One source file of a recorded build, as the request carried it. The size and hash are of the file's text as the server read it (a definition's lines joined with `\n`, a pipeline's JSON, a prompt's content) in UTF-8, so two builds can be compared file by file without their sources.

**Kind:** an object, used in responses.

## Fields

Every field is present in a response; empty ones are `null`.

| Field | Type | Description |
|---|---|---|
| `kind` | [`BuildRecordFileKind`](https://docs.maitento.com/reference/types/build-record-file-kind.md) | Which part of the request the file was sent in. |
| `name` | `string` | The definition's name; for an app's files the app's, and for a code pipeline's hooks the pipeline's. At most 256 characters. |
| `fileName` | `string \| null` | The file name the request gave; null for prompts and JSON files, which are sent by name only. |
| `sizeBytes` | `integer` | The file's size, in UTF-8 bytes. |
| `sha256` | `string` | The lowercase hex SHA-256 of the file's UTF-8 text. |
| `sourceStored` | `boolean` | Whether the record kept this file's text in `sources` (false when the size limit left it out). |

## Example

```json
{
  "kind": "Agent",
  "name": "...",
  "fileName": "...",
  "sizeBytes": 0,
  "sha256": "...",
  "sourceStored": false
}
```

## Where it's used

- Inside [`BuildRecord`](https://docs.maitento.com/reference/types/build-record.md)