file

A file — source code, attachment, download, or any discrete digital artifact. Base type for image. Covers repo files (GitHub, Cursor), email attachments (Mimestream), filesystem entries, and downloads.

Metadata	Value
Plural	`files`
Subtitle field	`path`

Fields

Field	Type
`filename`	`string`
`mimeType`	`string`
`size`	`integer`
`path`	`string`
`format`	`string`
`encoding`	`string`
`lineCount`	`integer`
`kind`	`string`
`sha`	`string`

Relations

Relation	Target
`attachedTo`	`message`
`repository`	`repository`

Used as a base by

Prior art

External standards this shape draws from or aligns with. See Shape design principles for how prior art informs shape design.

IANA Media Types (RFC 6838) — Our mimeType follows type/subtype syntax (text/plain, application/pdf). Canonical source for format identification.
schema.org/DigitalDocument — Our filename ≈ name; size ≈ contentSize; mimeType ≈ encodingFormat.
Git Internals (blob objects) — Our sha is a Git blob SHA-1 (40-hex). Git’s content-addressable model underlies our repo-file identity.

Skills that produce this shape

cursor — op_pull_document
github — list_documents, read_document
gmail — get_attachment