---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/sandbox/interfaces/PathTranslator.md
description: >-
  Model-path boundary: normalises ergonomic paths while refusing unambiguous
  host escapes.
---

# Interface: PathTranslator

Defined in: [src/batteries/sandbox/contracts/path\_translator.ts:5](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/contracts/path_translator.ts#L5)

Model-path boundary: normalises ergonomic paths while refusing unambiguous host escapes.

## Methods

### assertNoSymlinkComponents()

```ts
assertNoSymlinkComponents(relative: string): Promise<void>;
```

Defined in: [src/batteries/sandbox/contracts/path\_translator.ts:13](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/contracts/path_translator.ts#L13)

The translator always inspects the resolved path and every parent for symlink components.

#### Parameters

| Parameter  | Type     |
| ---------- | -------- |
| `relative` | `string` |

#### Returns

`Promise`<`void`>

***

### redact()

```ts
redact(text: string): string;
```

Defined in: [src/batteries/sandbox/contracts/path\_translator.ts:11](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/contracts/path_translator.ts#L11)

Scrub root and common host identifiers from battery-generated text.

#### Parameters

| Parameter | Type     |
| --------- | -------- |
| `text`    | `string` |

#### Returns

`string`

***

### toBackendPath()

```ts
toBackendPath(relative: string): string;
```

Defined in: [src/batteries/sandbox/contracts/path\_translator.ts:9](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/contracts/path_translator.ts#L9)

Convert a validated relative path to an opaque backend locator.

#### Parameters

| Parameter  | Type     |
| ---------- | -------- |
| `relative` | `string` |

#### Returns

`string`

***

### toRelative()

```ts
toRelative(modelPath: string): Promise<string>;
```

Defined in: [src/batteries/sandbox/contracts/path\_translator.ts:7](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/contracts/path_translator.ts#L7)

Validate and convert a model path; leading separators mean the sandbox root.

#### Parameters

| Parameter   | Type     |
| ----------- | -------- |
| `modelPath` | `string` |

#### Returns

`Promise`<`string`>