@ai-matrx/agents 0.20.6 → 0.21.1

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 0.21.1
+
+First published build of 0.21.0's content: the `npm/matrx-agents/v0.21.0` tag was cut without
+its mandate-key snapshot and never reached npm. Contents: see 0.21.0 below.
+
+### Consumer action
+
+- matrx-frontend: adopt `@ai-matrx/agents/context` — build the request `context` only through
+  `buildContextWire(rows)`, resolve rows with `resolveContextRow` against the person's
+  `users.user_surface_state` rows (`feature = "context_rules"`), run `compareReceipt` on the
+  `context_receipt` event, and render the composer chip / panel with `./context/react`.
+
+## 0.21.0 (not published)
+
+### Added — `./context` and `./context/react` (context value rules)
+
+Contract: common-docs `systems/scopes-context/context-delivery/RULES.md`; parity corpus
+`context/rules-corpus.json` (also run by aidream pytest against the Python twin).
+
+- `./context` (pure): `resolveContextRule`, `contextValueChars` (code points),
+  `lookupSavedRule`, `resolveContextRow`, `buildContextWire` (the only producer of a request's
+  `context`: excluded rows never ship; the envelope carries the page limit only),
+  `compareReceipt`, `formatChars`, constants `CONTEXT_RULES_FEATURE`, `DEFAULT_SURFACE_KEY`,
+  `DEFAULT_INLINE_MAX_CHARS`, `DEFAULT_INLINE_CAP`, and the `ContextReceipt` wire types.
+- `./context/react` (client): `ContextRulesTable`, `ContextRulesChip`, `ContextRulesPanelBody`,
+  `InlineMaxInput` — presentational; the host persists every `onChange`.
+
 ## 0.20.6
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/README.md

@@ -243,6 +243,23 @@ const grounded = await set.resolve();
 `./sources/react` binds it: `useSourceSet(adapter)`, `useSourceIntake(set, deps)`,
 `useSourceRecovery(set, intake, runner, options)`, `useSourcePartsSearch(client, ref, query)`.
 
+## Context value rules (`./context`, `./context/react`)
+
+Per value, a person controls two knobs: whether it reaches the model (`include`) and the size up
+to which it is inlined (`max_inline_chars`; above it the agent reads it on request).
+
+```ts
+import { resolveContextRow, buildContextWire, compareReceipt } from "@ai-matrx/agents/context";
+
+const rows = values.map((v) => resolveContextRow(v, savedRules, cap)); // what the table shows
+const context = buildContextWire(rows);                               // what the request sends
+// on the `context_receipt` event:
+const { mismatches, systemRows } = compareReceipt(rows, receipt);
+```
+
+`./context/react` renders them: `ContextRulesTable`, `ContextRulesChip`, `ContextRulesPanelBody`
+(presentational; the host persists every `onChange`).
+
 ## Runtime support
 
 The package targets modern browsers, browser-based desktop shells,
@@ -250,7 +267,7 @@ extensions, Next.js client or server modules, and Node 20+. Its one runtime
 dependencies are `@ai-matrx/data` (the shared net-resilience + credentials
 layer), `@ai-matrx/design-system` (the picker's primitives) and
 `@ai-matrx/associations` (the per-user star chokepoint); `react >= 18`
-is an optional peer needed only by `./react`, `./sources/react` and `./catalog/react`. No entry
+is an optional peer needed only by `./react`, `./sources/react`, `./catalog/react` and `./context/react`. No entry
 point performs work at import time.
 
 ## Development