---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/sandbox/tools/variables/sandboxToolDescriptions.md
description: Human-readable descriptions shared by the sandbox's workspace tools.
---

# Variable: sandboxToolDescriptions

```ts
const sandboxToolDescriptions: {
  open: string;
  save: string;
  stage: string;
};
```

Defined in: [src/batteries/sandbox/tools/index.ts:273](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/tools/index.ts#L273)

Human-readable descriptions shared by the sandbox's workspace tools.

## Type Declaration

| Name                                | Type     | Default value                                                                                                                                                             | Defined in                                                                                                                                |
| ----------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
|  `open`   | `string` | `'Read a file from disk into the turn to query, not to change. Use artifact_* tools; use stage_file to change it.'`                                                       | [src/batteries/sandbox/tools/index.ts:274](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/tools/index.ts#L274) |
|  `save`   | `string` | `'Write to a file on disk: save bytes already in this turn, produced by media verbs; you cannot author content here. This overwrites and makes a stage_file edit real.'`  | [src/batteries/sandbox/tools/index.ts:277](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/tools/index.ts#L277) |
|  `stage` | `string` | `'Change a file: use stage_file, then media verbs and save_media; mutations are in memory until saved. Use open_file to read or grep first; no artifact_* tools attach.'` | [src/batteries/sandbox/tools/index.ts:275](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/tools/index.ts#L275) |