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



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

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

## Unreleased [#unreleased]

### Fixed [#fixed]

* **[Region-pinned agent](/docs/region-pinned-agent) replay snippet
  corrected to the shipped `ReplayRuntime` shapes (devharness FINDING
  100–102).** `createReplayRuntime` takes `sessionRuntime`, not
  `liveRuntime` (`ReplayRuntimeConfig` = `{ tenantId (required),
  sessionRuntime?, cacheReadMode?, clock?, eventSource? }`,
  `replay/src/runtime/types.ts:499`). `replayTurn` input is
  `{ chatId, tenantId, messageId }` — `turnId` → `messageId`, `mode` is
  not a field, and `tenantId` is required (`ReplayRuntime.ts:521`;
  `ReplayTurnInput`, `types.ts:95`). Its output is
  `{ chatId, tenantId, messageId, state, sequenceNumberRange }`
  (`ReplayRuntime.ts:573`) — there is **no** `.diff` field, so the
  cross-family parity read was rewritten to compare the returned
  `state` yourself, with a pointer to the hash-chain `verifyIntegrity`
  verdict (`{ valid, brokenAt? }`) for tamper-evidence.

* **[`@pleach/replay`](/docs/replay) eval-coupling snippet corrected
  (devharness FINDING 89).** The DI example constructed
  `new EvalSuite({ replay })`, but `EvalSuiteOptions`
  (`eval/src/index.ts`) has no `replay` field and **requires**
  `suiteId`; the real cross-wire is `suite.setReplayClient(client)`.
  Corrected to `new EvalSuite({ suiteId, runtime })` +
  `suite.setReplayClient(replay)` (the source doc comment at
  `replay/src/index.ts` was likewise corrected).

### Added [#added]

* **[`/docs/replay`](/docs/replay) — `createStrictHandleReplay`
  determinism gate.** New `@pleach/replay/strict` export (re-exported
  at the root) that walks N independent handles over the same
  `(chatId, tenantId, window)` and byte-compares the folded per-step
  state, returning `{ deterministic, steps, firstDivergenceAt? }`.
  Documented in the Status section, a new "Determinism gate"
  subsection, and the Roadmap. Sibling of `createStrictReplay` (which
  gates the `ReplayRuntime.replayTurn` surface).
* **[`/docs/replay`](/docs/replay) — `cacheKey` replay slot.**
  `@pleach/core`'s `tool.completed` / `turn.completed` events gained an
  optional `cacheKey` payload field; the `ReplayHandle` consults a wired
  `cacheBackend` for rows that carry it (per `cacheReadMode`). The "What's
  NOT" list notes core does not populate it (the `core → replay` boundary
  forbids importing `deriveContentHashKey`) — host- / `createCacheMiddleware`-
  populated.

### Changed [#changed]

* **[`/docs/replay`](/docs/replay) — `ReplayHandle` stepper documented
  as wired.** `step()` / `seek()` / `replayTurn()` no longer throw
  `NotImplementedError`; they walk the event log via
  `runtime.events.iterate` and fold through `hydrateFromEvents`. Updated
  the Status section, the `ReplayHandle` member table (all six members
  Live), the `step()`/`seek()`/`replayTurn()` behavior section, the
  determinism contract (one shared reducer → `seek(N)` == N steps == a
  full fold), the error-hierarchy note on `NotImplementedError`, and the
  "What's NOT in this package" list (now: no `StrictReplay` diff over the
  handle, no automatic cache-key derivation from rows). Mirrored the
  one-line status flip on [`/docs/eval-and-replay`](/docs/eval-and-replay).

### Added [#added-1]

* **`<StatusBadge>` reference adoption** —
  [`/docs/replay`](/docs/replay) adopts
  `<StatusBadge status="in-flight">Phase A + Phase B</StatusBadge>`
  under its Status heading as the reference adoption of the new
  first-party enterprise-shape component.

### Changed [#changed-1]

* **[`/docs/replay`](/docs/replay) error hierarchy diagram** —
  the ASCII tree rendering `ReplayError` /
  `ReplayDivergenceError` / `ReplayCacheMissError` /
  `ReplayUnknownEventError` / `NotImplementedError` is now a
  mermaid `classDiagram` with inheritance arrows and per-class
  fields. Matches the established mermaid idiom used on
  [`/docs/overview`](/docs/overview) and elsewhere.
* **Cross-docs status-flip pass** — `@pleach/replay`'s
  `ReplayRuntime` invokes the `@pleach/core/eventLog` hash-chain
  verifier (`verifyChainForChat` / `generateProof` live in
  `@pleach/core/eventLog`), with writer-side stamping in
  `@pleach/core/eventLog` behind `c9PhaseBEnabled`. Touched the
  [Replay](/docs/replay) and [Hash chain](/docs/hash-chain)
  pages.

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

### Changed [#changed-2]

* [Packages](/docs/packages) table corrected to real published
  version — `@pleach/replay 0.7.0` (was largely stale "Reserved
  · placeholder" framing).
* [@pleach/replay](/docs/replay) Phase B note now distinguishes
  the landed `replayTurn` body from the still-throwing
  `fromSnapshot` / `fork` / `multiTenantAggregate`.