Encoding

Every encode verb runs the same tower, the modality’s entry, the transformer blocks and the final norm, and keeps whichever surfaces the caller names from one forward:

• embeddings land one pooled row per item, past the attention pool and the projection head.
• states land one row per token each item kept, the surface rerankers and masked heads read.
• token_vectors land the token head’s unit vectors, token_width wide, on the same offsets as the states, for late-interaction reranking.

A NULL output skips its surface, naming none is refused with uform_status_invalid_argument_k, and a model without a token head refuses token_vectors with uform_status_unsupported_k. Every surface lands in the arena as outputs_scalar, and an item longer than the model’s context is truncated and counted in the stats. One verb per input form takes only the fields that form needs:

• uform_text_encode takes UTF-8 texts, a byte per token, since models are tokenizer-free.
• uform_image_encode takes JPEG, PNG or WebP files, and uform_image_encode_pixels interleaved 8-bit RGB.
• uform_video_encode takes MP4 or WebM clips.
• uform_audio_encode takes WAV, FLAC, MP3 or Opus files, and uform_audio_encode_samples mono samples at a rate.

uform_rows_view_t embeddings = {0};
uform_rows_tape_view_t states = {0};
uform_text_encode(&(uform_text_encode_t){
    .model = model, .executor = executor, .outcome = &outcome, .count = n,
    .texts = {bytes, offsets, uform_scalar_u8_k}, .embeddings = &embeddings, .states = &states,
    .arena = arena, .outputs_scalar = uform_scalar_bf16_k});