Página generada desde protocols/media-object/README.md. No se edita a mano: bun run docs:gen la regenera y bun run docs:check falla si difiere.

media-object/ — Framing MediaObject / MediaUnit (r09)Copiar enlace

PropósitoCopiar enlace

Definir la representación abstracta de unidades de media que fluyen a través del media graph (r09). Este contrato es independiente del transporte y del formato de serialización.

Relación con @styx/source-sdkCopiar enlace

• ISeekableMediaSource (en @styx/source-sdk): abstracción interna del servidor para leer desde storage (Local, HTTP Range, S3, Torrent, etc.). Opera en el plano de storage.
• DeliveryTransport (este documento): frontera de delivery entre servidor y cliente. Opera en el plano de delivery.

Ambos pueden compartir implementación (ej. readAt en source → readRange en transport), pero son conceptualmente distintos: el source sabe de dónde vienen los bytes; el transport sabe cómo entregarlos al cliente.

Canonical Media Factory (CMF)Copiar enlace

Los modelos definidos aquí (MediaObject, MediaUnit, MediaPresentation) son la base para el CMF que se implementará en fases posteriores (F0.C). En F0.B.1 solo se necesita el framing mínimo para el tracer bullet del daemon Zig.