@ai-matrx/agents 0.21.19 → 0.21.21

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 0.21.21
+
+### Added (in `./context`)
+
+- `humanizeContextKey(key)` + `CONTEXT_KEY_ACRONYMS` — the one key-to-words rule for a value no
+  page or agent labelled: split on `_` / `-` / whitespace, upper-case whole-part acronyms (ID, URL,
+  PDF, HTML, JSON, API, AI, UI, CSV, SMS, SEO, LLM, MCP, UUID, ISO), otherwise first letter up and
+  the rest down, join with spaces (`note_id` → `Note ID`). Corpus `humanize_cases`; aidream's
+  `humanize_context_key` switches to the same rule against the same cases.
+
+### Consumer action
+
+- matrx-frontend: replace the local `humanizeContextKey` in
+  `context-rules/request-context.ts` with the package export (labels then match the server's
+  receipt once aidream switches).
+
+## 0.21.20
+
+### Added (in `./context`)
+
+- `ContextReceiptRow.blocked_by` accepts `"self_check"` (RULES.md §5): the server's post-render
+  safety check stripped the value before the model call (`delivery: "off"`). New type
+  `ContextBlockedBy = "model" | "self_check"`.
+- `compareReceipt`: a value the person included that the check stripped is a `delivery` mismatch
+  tagged `reason: "self_check"` — also for server-resolved rows, whose delivery is otherwise
+  never compared. `ContextReceiptMismatch.reason?: "self_check"`.
+- Receipt-built rows (`receiptRowToResolved`, `systemRowsToResolved`, `applyReceiptToRows`) carry
+  `blockedBy`.
+- `./context/react`: such a row's tooltip and mismatch marker read "Removed by the server's safety
+  check".
+
+### Consumer action
+
+- matrx-frontend: stop coercing `blocked_by` to null; word a mismatch with
+  `reason === "self_check"` as removed by the server's safety check, not as a screen error.
+
 ## 0.21.19
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see
@@ -8,9 +44,28 @@ No source changes intended and no consumer action required.
 
 ## 0.21.18
 
-Automatic changed-only republish (docs/metadata drift since the last tag — see
-`git diff npm/matrx-agents/v0.21.17..npm/matrx-agents/v0.21.18 -- apps/shared/matrx-agents`).
-No source changes intended and no consumer action required.
+### Added (in `./context`)
+
+- `withheldKeys(rows): string[]` — keys the client holds a value for but is not sending (excluded
+  by the page, the agent or the person's rule), deduplicated. Send it as the request's
+  `context_withheld` so the receipt's `origin: "rule"` rows cover only keys withheld on this page.
+- `systemRowsToResolved(systemRows): ResolvedContextRow[]` — `compareReceipt(...).systemRows`
+  (server-seeded attachments, scope seeds…) as governable table rows: `attached_document_*` /
+  `attached_file_*` / `resource_file_*` group as "attached", the rest as "system";
+  `serverResolved`, `fromReceipt`, values from the receipt, `surfaceKey` = the row's own
+  `surface_key` (a rule saved for one goes to `_default` unless the server filed it under a page).
+  The table, chip and panel render them with the normal Include switch and Inline max.
+
+### Fixed
+
+- `buildContextWire` skips rows with no value, so receipt-built rows (`receiptRowToResolved`,
+  `systemRowsToResolved`) can never reach the wire as `{ content: undefined }`.
+
+### Consumer action
+
+- matrx-frontend: for display pass
+  `[...rows, ...systemRowsToResolved(compareReceipt(expected, latestReceipt).systemRows)]`; send
+  `context_withheld: withheldKeys(rows)` with each request.
 
 ## 0.21.17