---
url: 'https://adk.nht.io/api/@nhtio/adk/batteries/interfaces/ServeIsolatedOptions.md'
description: 'Options accepted by [`serveIsolated`](https://adk.nht.io/api/@nhtio/adk/batteries/functions/serveIsolated)/[`serveIsolatedOverPort`](https://adk.nht.io/api/@nhtio/adk/batteries/functions/serveIsolatedOverPort).'
---

# Interface: ServeIsolatedOptions

Defined in: [src/batteries/isolation/serve.ts:43](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/serve.ts#L43)

Options accepted by [serveIsolated](../functions/serveIsolated.md)/[serveIsolatedOverPort](../functions/serveIsolatedOverPort.md).

## Extends

* [`IsolationObservabilityHooks`](IsolationObservabilityHooks.md)

## Properties

| Property                                                 | Type                                                                    | Description                                                                                                                                                                                                               | Inherited from                                                                                                                               | Defined in                                                                                                                                        |
| -------------------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
|  `debugPayloads?`     | `boolean`                                                               | Include payload bodies on `call:*`/`wire:*` reports (see [IsolationReport.payload](IsolationReport.md#property-payload)). Default `false` — payloads may be large/sensitive, so this is opt-in even when hooks are wired. | [`IsolationObservabilityHooks`](IsolationObservabilityHooks.md).[`debugPayloads`](IsolationObservabilityHooks.md#property-debugpayloads)     | [src/batteries/isolation/observability.ts:135](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L135) |
|  `encodables?`           | readonly { `name`: `string`; }\[]                                      | Classes to register with `@nhtio/encoder`'s custom-encodable round-trip on this side (sugar over `registerClass`; lazy — only touches the encoder peer when this array is non-empty).                                     | -                                                                                                                                            | [src/batteries/isolation/serve.ts:46](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/serve.ts#L46)                   |
|  `onAbort?`                 | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `abort:sent` — the host sent an `abort` envelope for an in-flight call.                                                                                                                                                   | [`IsolationObservabilityHooks`](IsolationObservabilityHooks.md).[`onAbort`](IsolationObservabilityHooks.md#property-onabort)                 | [src/batteries/isolation/observability.ts:128](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L128) |
|  `onCall?`                   | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `call:start` / `call:settle` — a single request/response method call.                                                                                                                                                     | [`IsolationObservabilityHooks`](IsolationObservabilityHooks.md).[`onCall`](IsolationObservabilityHooks.md#property-oncall)                   | [src/batteries/isolation/observability.ts:124](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L124) |
|  `onCodecEscalate?` | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `codec:escalate` — the codec escalated an argument past the `'raw'` tier.                                                                                                                                                 | [`IsolationObservabilityHooks`](IsolationObservabilityHooks.md).[`onCodecEscalate`](IsolationObservabilityHooks.md#property-oncodecescalate) | [src/batteries/isolation/observability.ts:132](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L132) |
|  `onCrashReport?`     | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `crash` — the transport reported an unexpected guest exit/termination.                                                                                                                                                    | [`IsolationObservabilityHooks`](IsolationObservabilityHooks.md).[`onCrashReport`](IsolationObservabilityHooks.md#property-oncrashreport)     | [src/batteries/isolation/observability.ts:120](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L120) |
|  `onDispose?`             | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `dispose:start` / `dispose:done` — graceful-then-forced teardown.                                                                                                                                                         | [`IsolationObservabilityHooks`](IsolationObservabilityHooks.md).[`onDispose`](IsolationObservabilityHooks.md#property-ondispose)             | [src/batteries/isolation/observability.ts:116](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L116) |
|  `onIsolation?`         | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | Fires on EVERY report (the firehose).                                                                                                                                                                                     | [`IsolationObservabilityHooks`](IsolationObservabilityHooks.md).[`onIsolation`](IsolationObservabilityHooks.md#property-onisolation)         | [src/batteries/isolation/observability.ts:112](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L112) |
|  `onRecycle?`             | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `recycle:start` / `recycle:done` — terminate + reconnect through the same transport.                                                                                                                                      | [`IsolationObservabilityHooks`](IsolationObservabilityHooks.md).[`onRecycle`](IsolationObservabilityHooks.md#property-onrecycle)             | [src/batteries/isolation/observability.ts:118](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L118) |
|  `onRespawnAuto?`     | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `respawn:auto` — an `autoRespawn` crash-policy verdict was consulted and acted on.                                                                                                                                        | [`IsolationObservabilityHooks`](IsolationObservabilityHooks.md).[`onRespawnAuto`](IsolationObservabilityHooks.md#property-onrespawnauto)     | [src/batteries/isolation/observability.ts:122](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L122) |
|  `onSpawn?`                 | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `spawn:start` / `spawn:ready` / `spawn:error` — guest connect lifecycle.                                                                                                                                                  | [`IsolationObservabilityHooks`](IsolationObservabilityHooks.md).[`onSpawn`](IsolationObservabilityHooks.md#property-onspawn)                 | [src/batteries/isolation/observability.ts:114](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L114) |
|  `onStream?`               | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `stream:start` / `stream:end` / `stream:error` / `stream:cancel` — a streaming method call.                                                                                                                               | [`IsolationObservabilityHooks`](IsolationObservabilityHooks.md).[`onStream`](IsolationObservabilityHooks.md#property-onstream)               | [src/batteries/isolation/observability.ts:126](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L126) |
|  `onWire?`                   | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `wire:out` / `wire:in` — every envelope crossing the wire (verbose; opt in deliberately).                                                                                                                                 | [`IsolationObservabilityHooks`](IsolationObservabilityHooks.md).[`onWire`](IsolationObservabilityHooks.md#property-onwire)                   | [src/batteries/isolation/observability.ts:130](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L130) |
