# ProjectAgentSourceFile

Fields, types, and constraints for ProjectAgentSourceFile.

Canonical: https://commentary.dev/docs/reference/schemas/project-agent-source-file

Released API schema for `ProjectAgentSourceFile`.

## Fields and constraints

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `path` | string | Yes | Minimum length: 1. Maximum length: 1024. |
| `blobHash` | string | Yes | Maximum length: 128. |
| `kind` | `"file"` · `"directory"` · `"submodule"` | No |  |
| `capture` | `"retained"` · `"uncaptured"` · `"unavailable"` | Yes |  |
| `content` | string or null | Yes |  |
| `contentTruncated` | boolean | No |  |
| `base64` | string or null | No |  |
| `bytes` | integer or null | No |  |
| `sha256` | string or null | No |  |
| `binary` | boolean | No |  |
| `nextLine` | integer or null | No |  |
| `nextCursor` | string or null | Yes |  |

## Full schema

[Download this schema](/docs/reference/schemas/project-agent-source-file.json) or use the [complete OpenAPI document](/docs/reference/openapi.json) to resolve all references.

## Related reference

[Browse API endpoints](/docs/reference/api-operations).