@fitchmultz/pi-mcp-adapter 8.0.1 → 8.0.2

package/CHANGELOG.md

@@ -7,14 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [8.0.2] - 2026-10-31
+
 ### Changed
 
-- Rewrite the README around installation and everyday use, add a discovery/call-flow diagram, and move detailed configuration, migration, and maintainer guidance into linked docs.
+- Link the READMEs to the exact runtime requirements and conformance referee details without pinning release versions in installation guidance.
+- Batch metadata-cache writes across connected servers at startup and shutdown, reducing repeated disk work while preserving on-demand updates.
+- Reuse search indexes after calls when live tool metadata is unchanged; rebuild them when descriptors change.
+- Load the native MCP client SDK on first connection instead of at startup; cached discovery remains available without it.
+- Index saved plain-text output once, then read only the requested page's sparse file window. Native UI history appends, including large events, index only the new text without rescanning the prefix. Keep exact UTF-16 totals, Unicode boundaries and private-directory checks; external edits and incomplete UTF-8 fall back to a fresh scan. The bounded in-memory index retains checkpoints, not output text.
+- Reuse unchanged metadata-cache snapshots and derived tool descriptors across session tool synchronization. Each session and branch still restores its own selections and validates configuration, trust, and server identity.
+- Load Zod and the command, panel, gateway, script and resource modules on first MCP use instead of at extension startup, so sessions that never use MCP skip them. Server initialization modules now load during session start, after cached tools and prompt commands register. Cached tool registration, schemas, commands and first-call behavior are unchanged. Internal types no longer load Zod; the published `./types` entry still exports the same values and types, including the Zod-backed UI stream schemas.
+- Update Zod to 4.6.7 in the adapter and interactive visualizer, and rebuild the bundled MCP Apps bridge with it. Zod 4.6.6 rejects arrays, sets and maps over their declared size limit before checking each element ([GHSA-mrhx-c7xc-m3w5](https://github.com/advisories/GHSA-mrhx-c7xc-m3w5)).
+
+### Fixed
+
+- Stop browser-host heartbeats when MCP App sessions complete, and tear down the app once on server or user completion.
+- Mark `mcp_search` schema alternatives as objects so providers requiring explicit object types accept them.
+- Bind cached plain-output page indexes to a SHA-256 digest of the actual file content, verified on every reuse, so a same-size in-place rewrite inside one filesystem timestamp grain can no longer serve stale checkpoints or UTF-16 totals. Verified native appends keep advancing the digest, preserving warm paging after appends; warm reads now cost one raw verification pass plus the sparse page window instead of the window alone.
+- Stream large `mcp_script` output to its spill file while the script runs instead of holding every emitted value in the Pi process, and pause the script worker while the host catches up. Previously, large finite output could exhaust the host heap and abort Pi. The returned preview, saved file, ordering and images are unchanged. Pi processes already running when the adapter updates keep returning `mcp_script` output; one that ran `mcp_script` before the update keeps the earlier in-memory handling until it restarts.
+- Prune recognized expired and future-dated metadata entries during cache saves while preserving configured servers, explicitly supplied entries, and unknown records. Keep fresh disk merges and atomic cache replacement.
 
 ## [8.0.1] - 2026-10-13
 
 ### Changed
 
+- Rewrite the README around installation and everyday use, add a discovery/call-flow diagram, and move detailed configuration, migration, and maintainer guidance into linked docs.
 - Refresh the MCP client, core, and server SDKs together to 2.3.1 in the adapter and interactive visualizer, and update smol-toml to 1.9.1. Keep native authentication, request lifetime, cancellation, streaming results and package discovery contracts.
 - Calibrate the macOS large-history test timeout for its 10,000 real disk flushes, without reducing the workload or changing persistence assertions.
 

package/README.md

@@ -6,14 +6,14 @@ Connect [Pi](https://github.com/earendil-works/pi) to MCP servers for browsers,
 
 ## Install
 
-Use Pi 1.0.0 or later and Node.js 24 or later.
+Check the [Pi and Node.js requirements](https://github.com/fitchmultz/pi-mcp-adapter/blob/main/docs/reference.md#requirements).
 
 ```bash
 pi install npm:@fitchmultz/pi-mcp-adapter
 pi
 ```
 
-Restart Pi if it was open during installation. Load only one adapter per Pi host. For pre-v5 state, read the [upgrade guide](docs/migration.md) before you restart Pi.
+Restart Pi if it was open during installation. Load only one adapter per Pi host. For legacy adapter state, read the [upgrade guide](docs/migration.md) before you restart Pi.
 
 For a Git install, run `pi install git:github.com/fitchmultz/pi-mcp-adapter`.
 
@@ -80,7 +80,7 @@ If App history cannot be saved, reload or exit discards unsaved messages. Retrie
 ## Documentation
 
 - [Reference](docs/reference.md): all settings, tool actions, SDK integration, transport behavior, and limits.
-- [Upgrade guide](docs/migration.md): API changes and pre-v5 state migration.
+- [Upgrade guide](docs/migration.md): API changes and legacy state migration.
 - [Development and releases](docs/development.md): local checks and maintainer procedures.
 - [Changelog](CHANGELOG.md) · [Report an issue](https://github.com/fitchmultz/pi-mcp-adapter/issues)