# @pleach/sandbox changelog (/docs/changelog/sandbox)



This page collects the **site-content changelog entries** that
materially touched the [`@pleach/sandbox`](/docs/sandbox) docs
surface or named a `@pleach/sandbox` symbol. It is not the runtime
changelog — the canonical record of `@pleach/sandbox` runtime
behavior lives in the upstream package
[`CHANGELOG.md`](https://github.com/pleachhq/getpleach) and on
[npmjs.org/package/@pleach/sandbox](https://www.npmjs.com/package/@pleach/sandbox).

See the combined site changelog at
[`/docs/changelog/combined`](/docs/changelog/combined) for the
chronological unified view across every SKU.

## Unreleased [#unreleased]

### Changed [#changed]

* **Four SKU placement pages** — [`/docs/sandbox`](/docs/sandbox)
  is one of four thin orientation pages added/normalized in this
  pass: what the SKU is for, where it slots in the substrate,
  which contract page it implements, and a pointer to the
  package's npm README as the canonical source for constructor
  signature and option shape. Authored to retire audit failures
  for SKUs already on `SKU_PUBLISHED`. The repo's
  `audit:docs-vs-contract` script now reports `0 missing pages`.
* **Sidebar** — [`sandbox`](/docs/sandbox) slots into
  `Bundled packages` after `base-tools`.
* **Per-recipe deep-dive page additions** —
  [`instrumentedCodingAgent`](/docs/recipes/instrumented-coding-agent)
  composes `@pleach/coding-agent` + `@pleach/sandbox` +
  `@pleach/observe`.

### Fixed [#fixed]

* **["Where it fits"](/docs/sandbox) orientation corrected to the real
  contract (devharness FINDING 103).** The page claimed coding-agent
  tools call a sandbox through `ctx.sandbox.readFile` /
  `.writeFile` / `.exec` / `.list`. There is no `ctx.sandbox` — core's
  `ToolContext` is sandbox-agnostic. The low-level `SandboxProvider`
  contract (`packages/sandbox/src/types.ts`) is
  `execute` / `readFile` / `writeFile` / `listFiles`, and
  `@pleach/coding-agent` ships a thin `SandboxClient` facade
  (`exec` / `readFile` / `writeFile`, **no** `list`;
  `packages/coding-agent/src/sandbox/SandboxProvider.ts`) that the tool
  handlers close over. Prose rewritten to that seam.

## 2026-06-08 [#2026-06-08]

### Added [#added]

* `@pleach/sandbox` row in [Packages](/docs/packages) (Phase A
  contract + in-memory fixture, version `0.1.0`).

### Changed [#changed-1]

* [Plugin contract → Sibling SKUs as plugins](/docs/plugin-contract#sibling-skus-as-plugins)
  section retitled and rewritten with per-row real Phase A status
  — includes `@pleach/sandbox`.