Skip to content
1 min read · 203 words

Type Alias: GuestLogEvent

ts
type GuestLogEvent = {
  seq: number;
  text: string;
  truncated: boolean;
};

Defined in: src/batteries/sandbox/types.ts:175

One log event exactly as the trusted guest bootstrap's logger posts it.

Remarks

The logger — our code inside the guest, never the snippet — stamps each event with a monotonic per-call sequence and UTF-8-truncates it to maxLogEventBytes BEFORE posting. Bounding in the guest is the load-bearing half: a host-side byte count is applied after structured clone has already materialised the string, so a single oversized console.log would be in host memory before any accounting could react.

Properties

PropertyTypeDescriptionDefined in
seqnumberMonotonic per-call sequence, authored by the bootstrap logger — never by the snippet. It is what lets the host prove delivery completeness against the declared logCount.src/batteries/sandbox/types.ts:177
textstringThe logged text, already UTF-8-truncated in the guest when it exceeded maxLogEventBytes.src/batteries/sandbox/types.ts:179
truncatedbooleantrue when this event was cut to fit maxLogEventBytes; the host renders it with the pinned sentinel suffix so a clipped line is never read as a complete one.src/batteries/sandbox/types.ts:181