@ai-matrx/agents 0.38.4 → 0.40.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.40.0
+### Catalog rows carry the agent's class pin
+
+- `AgentSummary.offeringId` — the agent's class pin (`settings.offering_id`) when the list/search read carries an `offering_id` column: a uuid, or `null` for no pin. ABSENT when the read does not carry the column (class unknown — never guessed).
+- `renderModelRef` receives `offeringId` (same three states) so a host can name the class beside the model ("Qwen3.8 27B · Matrx Lightning"). Web and native detail cards pass it.
+- Consumer action: optional — read `offeringId` in your `renderModelRef` and name the class when it is not `undefined`. Nothing changes until `agx_get_list_full` / `agx_search` return `offering_id`.
+
+### Variables carry the person's label; one humanizer
+
+- `RunInputVariable.label` — what the person called the variable ("Normal Text"); `name` stays the `{{normal_text}}` key. `variableRunLabel` returns the label first, then a reference role's ask, then the key through THE humanizer; its `formatName` argument (and `deriveRunInputs`'s) is now optional and defaults to `@ai-matrx/kit/text-case` `humanizeIdentifier`.
+- `./context` `humanizeContextKey` / `CONTEXT_KEY_ACRONYMS` are now kit's `humanizeIdentifier` / `IDENTIFIER_ACRONYMS` (transitional names, deleted once matrx-frontend imports kit). The corpus case `myValue_ID` now reads "My Value ID" (camelCase splits — the Python twin changed with it).
+- Consumer action: pass `label` through every variable definition you build; drop the `formatText` argument to `variableRunLabel`.
+
+## 0.39.0
+### Context rules: one hierarchy, a switch per level
+
+- `./context/react` adds the hierarchy (`buildContextLevels`, `placeByOrigin`, `includeChanges`, `ContextHierarchy`): rows sit under levels (a page by its section and name, "Attached", "AI Matrx") and the host's declared groups, each heading with an Include switch, its included count and chars.
+- `ContextRulesTable`, `ContextRulesChip` and `ContextRulesPanelBody` take `hierarchy` and `onSetInclude`. A level or group switch is the person's per-value include rules for every value in it, in one call (no new rule kind — the server gate and receipt are unchanged). A host master switch (`hierarchy.masters`, the page on/off) sits on its level and replaces the chip header's page switch.
+- The platform's own values read "AI Matrx", never "System".
+- Consumer action: none required; pass `hierarchy` + `onSetInclude` to get the levels and their switches.
+
 ## 0.38.4
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/catalog/index.cjs

@@ -251,7 +251,9 @@ function toAgentSummary(raw) {
     isOwner: boolOrNull(raw["is_owner"]),
     accessLevel: str(raw["access_level"]),
     sharedByEmail: str(raw["shared_by_email"]),
-    orchestra: orchestraBadge(raw["orchestra"])
+    orchestra: orchestraBadge(raw["orchestra"]),
+    // Present only when the read carries the column: absent ≠ "no pin".
+    ..."offering_id" in raw ? { offeringId: str(raw["offering_id"]) } : {}
   };
 }