Returns Promise<
{
errors?: { message: string; type: "error"
| "warning" }[];
model?: { data: unknown; kind: string };
rendered: string;
renderedErr?: string;
status: "error" | "ok";
trace?: {
executed?: string;
input: string;
proposed: string;
validated: boolean;
};
},
>
An envelope whose rendered text carries the (highlighted) file
contents and whose model lists per-file outcomes.
Displays the content of one or more files.
Supports multiple files and concatenates their output. Binary mode is applied per recognized file, or consistently to all files when
--binaryis specified. Text content and errors are buffered into the envelope; binary content streams to the terminal directly with backpressure (raw bytes are not envelope text), and the binary auto-detection notice is emitted live on the err channel so it precedes the bytes it describes.