---
summary: "enrichment adoption — search/series/dataframe tools surface query echoes, result totals, and empty-result guidance"
breaking: false
security: false
---

# 0.2.3 — 2026-05-30

## Changed

- **`bls_search_series`** — `total` and `catalogSize` fields moved from `output` to `enrichment`; `total` renamed to `totalFound`. A `notice` field added for empty-result guidance (broadening query or removing filters). Value and presence preserved in both `structuredContent` and `content[]`; key changed (`total` → `enrichment.totalFound`, `catalogSize` → `enrichment.catalogSize`).
- **`bls_get_series`** — `enrichment` block added with `totalObservations` (total rows across all requested series) and optional `notice` (guidance when results spill to canvas and SQL access is needed).
- **`bls_get_latest`** — `enrichment` block added with optional `notice` (guidance when one or more series failed, directing agents to `bls_search_series` to verify SeriesIDs).
- **`bls_dataframe_query`** — `enrichment` block added with optional `notice` (guidance when query results are capped by `row_limit`, directing agents to use `register_as` or increase the limit).
- **`format:unsafe` script** added as a separate command; `format` now runs without `--unsafe` flag.
- **`.mcpbignore`** — `.agents/` and `skills/` excluded from bundle.
- **`@cyanheads/mcp-ts-core`** `^0.9.13` → `^0.9.16`.