---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/sandbox/type-aliases/GuestLogEvent.md
description: One log event exactly as the trusted guest bootstrap's logger posts it.
---

# Type Alias: GuestLogEvent

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

Defined in: [src/batteries/sandbox/types.ts:175](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/types.ts#L175)

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

| Property                                    | Type      | Description                                                                                                                                                                 | Defined in                                                                                                                    |
| ------------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
|  `seq`             | `number`  | Monotonic 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](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/types.ts#L177) |
|  `text`           | `string`  | The logged text, already UTF-8-truncated in the guest when it exceeded `maxLogEventBytes`.                                                                                  | [src/batteries/sandbox/types.ts:179](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/types.ts#L179) |
|  `truncated` | `boolean` | `true` 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](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/types.ts#L181) |