---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/dev-tools/interfaces/DevWorkspace.md
description: Mutable workspace state passed to step middleware.
---

# Interface: DevWorkspace

Defined in: [src/batteries/dev\_tools/types.ts:196](https://github.com/NHTIO/ADK/blob/master/src/src/batteries/dev_tools/types.ts#L196)

Mutable workspace state passed to step middleware.

## Properties

| Property                                                  | Modifier   | Type                                                                                                      | Description                                                                                                                                       | Defined in                                                                                                                 |
| --------------------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
|  `diagnostics`           | `public`   | [`Diagnostic`](Diagnostic.md)\[]                                                                           | Accumulated normalized diagnostics in production order.                                                                                           | [src/batteries/dev\_tools/types.ts:204](https://github.com/NHTIO/ADK/blob/master/src/src/batteries/dev_tools/types.ts#L204) |
|  `files`                       | `public`   | `Map`<`string`, `WorkspaceFile`>                                                                        | Current mutable workspace file map.                                                                                                               | [src/batteries/dev\_tools/types.ts:198](https://github.com/NHTIO/ADK/blob/master/src/src/batteries/dev_tools/types.ts#L198) |
|  `pendingDeletions` | `public`   | `Map`<`string`, `string`>                                                                               | Workspace path to on-disk path awaiting deletion; retained when a persisted file is removed from memory.                                          | [src/batteries/dev\_tools/types.ts:210](https://github.com/NHTIO/ADK/blob/master/src/src/batteries/dev_tools/types.ts#L210) |
|  `persistedPaths`     | `public`   | `Map`<`string`, `string`>                                                                               | Workspace path to its current on-disk path; acquisition seeds identity and renames re-key it so later writes use the live disk source.            | [src/batteries/dev\_tools/types.ts:208](https://github.com/NHTIO/ADK/blob/master/src/src/batteries/dev_tools/types.ts#L208) |
|  `recreated`               | `public`   | [`Set`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set)<`string`> | Paths vacated and then newly created during this execution; these summarize as additions, not modifications.                                      | [src/batteries/dev\_tools/types.ts:212](https://github.com/NHTIO/ADK/blob/master/src/src/batteries/dev_tools/types.ts#L212) |
|  `renames`                   | `public`   | `Map`<`string`, `string`>                                                                               | Destination-to-original acquisition path identity map, retained across writes for final rename reporting.                                         | [src/batteries/dev\_tools/types.ts:206](https://github.com/NHTIO/ADK/blob/master/src/src/batteries/dev_tools/types.ts#L206) |
|  `token`                       | `readonly` | [`DevWorkspaceToken`](DevWorkspaceToken.md)                                                               | Runtime-minted opaque identity unique per execution and persistence point; middleware must copy it unchanged or stale short-circuits are refused. | [src/batteries/dev\_tools/types.ts:202](https://github.com/NHTIO/ADK/blob/master/src/src/batteries/dev_tools/types.ts#L202) |
|  `unreadable`             | `public`   | [`Set`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set)<`string`> | Paths that were in the workspace but were dropped by a failed re-read; they remain on disk, are excluded from changes, and surface in the result. | [src/batteries/dev\_tools/types.ts:200](https://github.com/NHTIO/ADK/blob/master/src/src/batteries/dev_tools/types.ts#L200) |