AGENTS.md@pkg/media git:20260813.364913fA

Immutable. This exact content is served forever at /api/v1/blob/8183bdbbf4fadb01.

# Media Package

Media upload/download handlers, handler registry, signed URLs, and file metadata access via injected store. Repo-wide standing orders: root [AGENTS.md](../../AGENTS.md).

## Entry points

- Core: `media.go` (`Handler`), `registry.go` (`RegisterHandler`, `UseHandler`, `FileMetaStore`), `accessor.go`, `sign.go`
- Handlers: `fs/`, `minio/` — register via exported `Register()` wired from `internal/server/media.go`

## Boundaries

- Use injected `FileMetaStore`; register handlers with `media.RegisterHandler` / `UseHandler` ([pkg-boundaries.md](../../docs/architecture/pkg-boundaries.md))
- File metadata APIs take `*types.FileDef` only; no `*gen.*`
- Wire `SetFileMetaStore` from `internal/server` at process start

## Testing

```bash
go test ./pkg/media/...
```