@ai-matrx/agents 0.59.172 → 0.59.174

package/CHANGELOG.md

@@ -2,15 +2,32 @@
 
 ### Unreleased
 
+- **`ContextRulesChip` closes its compact popover on the first Escape even when a focused control has an open tooltip.** The tooltip dismissal layer previously took that key and left the popover visible. Consumer action: none.
+
 - **`useAgentSummary` looks an agent up by server search once per id per catalog (2026-10-19, Board remount law).** An agent tile that woke or remounted searched (`agx_search`) three times each time when the search found nothing; a found, missing or in-flight id is now asked once per tab, and a lookup that failed is forgotten so the next mount asks again. Consumer action: none.
 
 - **`toolPriceText` returns null for a zero-cost tool instead of "Free" (2026-10-18, law 14: no "Free").** Positive hints still read "N pts". Consumer action: none (callers already handle null).
 
-## 0.59.172
+## 0.59.174
 
 UNVERIFIED: this release has no Unreleased entry and the source comparison could not be made (the caller supplied no source comparison). Whether source changed is unknown; consumer action is unknown.
 Check the package's gitHead on npm against this version's gitHead: `git diff <previous gitHead> <this gitHead> -- apps/shared/matrx-agents/src`.
 
+## 0.59.173
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 8ff0911f9a ac6a7708d3 -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
+## 0.59.172
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 51e05980ff 8ff0911f9a -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
+## 0.59.171
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 9c0ddc1922 51e05980ff -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
 ## 0.59.170
 
 Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff e9c25acd07 9c0ddc1922 -- apps/shared/matrx-agents/src`

package/dist/catalog/react/index.cjs

@@ -49,6 +49,7 @@ __export(react_exports, {
   SearchInput: () => SearchInput,
   SidePanelHeader: () => SidePanelHeader,
   coerceVisibleTab: () => coerceVisibleTab,
+  lookUpAgentOnce: () => lookUpAgentOnce,
   orchestraDelegatesLine: () => orchestraDelegatesLine,
   orchestraDepthLine: () => orchestraDepthLine,
   orchestraLabel: () => orchestraLabel,

package/dist/catalog/react/index.d.cts

@@ -560,6 +560,7 @@ interface AgentCatalogProviderProps extends AgentCatalogUiPorts {
 }
 declare function AgentCatalogProvider({ catalog, children, ...ports }: AgentCatalogProviderProps): react.JSX.Element;
 
+declare function lookUpAgentOnce(catalog: AgentCatalog, agentId: string): Promise<void>;
 /**
  * ONE agent's catalog row — name, description, category, tags, star, access — read straight from
  * the catalog store (the ONE holder of agent identity; no host mirror). When the row is missing the
@@ -1246,4 +1247,4 @@ declare function orchestraDepthLine(badge: OrchestraBadge): string | null;
  */
 declare function orchestraDelegatesLine(badge: OrchestraBadge, limit?: number): string | null;
 
-export { type AgentCatalogLinkComponent, AgentCatalogProvider, type AgentCatalogProviderProps, type AgentCatalogRenderModelRef, type AgentCatalogUiPorts, AgentCategoriesPanel, type AgentCategoriesPanelProps, AgentDetailCard, type AgentDetailCardProps, AgentFilterBar, type AgentFilterBarProps, AgentListContent, type AgentListContentProps, type AgentListCoreOptions, AgentListDropdown, type AgentListDropdownProps, type AgentListFilter, AgentListInlinePicker, type AgentListInlinePickerProps, AgentListPanel, AgentListPanelBody, type AgentListPanelBodyProps, type AgentListPanelProps, type AgentListTabCounts, AgentListTabs, AgentMobileSubView, type AgentMobileSubViewProps, AgentRow, type AgentRowProps, AgentSortPanel, type AgentSortPanelProps, AgentTagsPanel, type AgentTagsPanelProps, CheckRow, FavoriteAgentButton, FilterChip, HOVER_GRACE_MS, type IconProps, LIST_MAX_HEIGHT, Music4Icon, OptionRow, type OrchestraBadge, PANEL_HEIGHT, PANEL_WIDTH, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, panelHeightBelow, sideThatFits, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore, useAgentSummary };
+export { type AgentCatalogLinkComponent, AgentCatalogProvider, type AgentCatalogProviderProps, type AgentCatalogRenderModelRef, type AgentCatalogUiPorts, AgentCategoriesPanel, type AgentCategoriesPanelProps, AgentDetailCard, type AgentDetailCardProps, AgentFilterBar, type AgentFilterBarProps, AgentListContent, type AgentListContentProps, type AgentListCoreOptions, AgentListDropdown, type AgentListDropdownProps, type AgentListFilter, AgentListInlinePicker, type AgentListInlinePickerProps, AgentListPanel, AgentListPanelBody, type AgentListPanelBodyProps, type AgentListPanelProps, type AgentListTabCounts, AgentListTabs, AgentMobileSubView, type AgentMobileSubViewProps, AgentRow, type AgentRowProps, AgentSortPanel, type AgentSortPanelProps, AgentTagsPanel, type AgentTagsPanelProps, CheckRow, FavoriteAgentButton, FilterChip, HOVER_GRACE_MS, type IconProps, LIST_MAX_HEIGHT, Music4Icon, OptionRow, type OrchestraBadge, PANEL_HEIGHT, PANEL_WIDTH, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, lookUpAgentOnce, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, panelHeightBelow, sideThatFits, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore, useAgentSummary };

package/dist/catalog/react/index.d.ts

@@ -560,6 +560,7 @@ interface AgentCatalogProviderProps extends AgentCatalogUiPorts {
 }
 declare function AgentCatalogProvider({ catalog, children, ...ports }: AgentCatalogProviderProps): react.JSX.Element;
 
+declare function lookUpAgentOnce(catalog: AgentCatalog, agentId: string): Promise<void>;
 /**
  * ONE agent's catalog row — name, description, category, tags, star, access — read straight from
  * the catalog store (the ONE holder of agent identity; no host mirror). When the row is missing the
@@ -1246,4 +1247,4 @@ declare function orchestraDepthLine(badge: OrchestraBadge): string | null;
  */
 declare function orchestraDelegatesLine(badge: OrchestraBadge, limit?: number): string | null;
 
-export { type AgentCatalogLinkComponent, AgentCatalogProvider, type AgentCatalogProviderProps, type AgentCatalogRenderModelRef, type AgentCatalogUiPorts, AgentCategoriesPanel, type AgentCategoriesPanelProps, AgentDetailCard, type AgentDetailCardProps, AgentFilterBar, type AgentFilterBarProps, AgentListContent, type AgentListContentProps, type AgentListCoreOptions, AgentListDropdown, type AgentListDropdownProps, type AgentListFilter, AgentListInlinePicker, type AgentListInlinePickerProps, AgentListPanel, AgentListPanelBody, type AgentListPanelBodyProps, type AgentListPanelProps, type AgentListTabCounts, AgentListTabs, AgentMobileSubView, type AgentMobileSubViewProps, AgentRow, type AgentRowProps, AgentSortPanel, type AgentSortPanelProps, AgentTagsPanel, type AgentTagsPanelProps, CheckRow, FavoriteAgentButton, FilterChip, HOVER_GRACE_MS, type IconProps, LIST_MAX_HEIGHT, Music4Icon, OptionRow, type OrchestraBadge, PANEL_HEIGHT, PANEL_WIDTH, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, panelHeightBelow, sideThatFits, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore, useAgentSummary };
+export { type AgentCatalogLinkComponent, AgentCatalogProvider, type AgentCatalogProviderProps, type AgentCatalogRenderModelRef, type AgentCatalogUiPorts, AgentCategoriesPanel, type AgentCategoriesPanelProps, AgentDetailCard, type AgentDetailCardProps, AgentFilterBar, type AgentFilterBarProps, AgentListContent, type AgentListContentProps, type AgentListCoreOptions, AgentListDropdown, type AgentListDropdownProps, type AgentListFilter, AgentListInlinePicker, type AgentListInlinePickerProps, AgentListPanel, AgentListPanelBody, type AgentListPanelBodyProps, type AgentListPanelProps, type AgentListTabCounts, AgentListTabs, AgentMobileSubView, type AgentMobileSubViewProps, AgentRow, type AgentRowProps, AgentSortPanel, type AgentSortPanelProps, AgentTagsPanel, type AgentTagsPanelProps, CheckRow, FavoriteAgentButton, FilterChip, HOVER_GRACE_MS, type IconProps, LIST_MAX_HEIGHT, Music4Icon, OptionRow, type OrchestraBadge, PANEL_HEIGHT, PANEL_WIDTH, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, lookUpAgentOnce, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, panelHeightBelow, sideThatFits, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore, useAgentSummary };

package/dist/catalog/react/index.js

@@ -2828,6 +2828,7 @@ export {
   SearchInput,
   SidePanelHeader,
   coerceVisibleTab,
+  lookUpAgentOnce,
   orchestraDelegatesLine,
   orchestraDepthLine,
   orchestraLabel,

package/dist/content-transfer/index.cjs

@@ -703,7 +703,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.172 — no longer declared in
+   * @deprecated retiring since 0.59.174 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */

package/dist/content-transfer/index.js

@@ -680,7 +680,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.172 — no longer declared in
+   * @deprecated retiring since 0.59.174 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */

package/dist/content-transfer/react/index.cjs

@@ -656,7 +656,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.172 — no longer declared in
+   * @deprecated retiring since 0.59.174 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */

package/dist/content-transfer/react/index.js

@@ -628,7 +628,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.172 — no longer declared in
+   * @deprecated retiring since 0.59.174 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */

package/dist/context/react/index.cjs

@@ -1069,6 +1069,9 @@ function ContextRulesChip({
       {
         align: "end",
         className: "w-[30rem] max-w-[calc(100vw-1rem)] overflow-hidden p-0",
+        onKeyDown: (event) => {
+          if (event.key === "Escape" && event.currentTarget.contains(event.target)) setOpen(false);
+        },
         children: body
       }
     )

package/dist/context/react/index.js

@@ -1042,6 +1042,9 @@ function ContextRulesChip({
       {
         align: "end",
         className: "w-[30rem] max-w-[calc(100vw-1rem)] overflow-hidden p-0",
+        onKeyDown: (event) => {
+          if (event.key === "Escape" && event.currentTarget.contains(event.target)) setOpen(false);
+        },
         children: body
       }
     )

package/dist/mandates/index.cjs

@@ -47,9 +47,9 @@ module.exports = __toCommonJS(mandates_exports);
 
 // mandates/keys.generated.ts
 var MANDATE_KEYS_META = {
-  aidreamRevision: "8ff0911f9a2534c2cbd9e6cb99468a9edba1d71d",
+  aidreamRevision: "a1c540b80761a8f3281af06881a9cbc146a15341",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.172",
+  packageVersion: "0.59.174",
   retireWindow: 3
 };
 var MANDATE_KEYS = {
@@ -666,7 +666,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.172 — no longer declared in
+   * @deprecated retiring since 0.59.174 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */
@@ -693,7 +693,7 @@ var MANDATE_KEYS = {
 var ALL_MANDATE_KEYS = Object.values(MANDATE_KEYS);
 var RETIRING_MANDATE_KEYS = {
   "brand_discovery.offering_roles": "0.59.0",
-  "coding_session.managed_translation_reference": "0.59.172",
+  "coding_session.managed_translation_reference": "0.59.174",
   "pdf.content_cleaner": "0.59.0",
   "sms.owner_beta": "0.59.0",
   "voice.owner_beta": "0.59.0"

package/dist/mandates/index.d.cts

@@ -6,9 +6,9 @@
  * from the IN-PROCESS mandate declarations — the same `declared_mandates()` the
  * boot sync writes to the database from. There is no hand list anywhere.
  *
- * aidream revision:   8ff0911f9a2534c2cbd9e6cb99468a9edba1d71d
+ * aidream revision:   a1c540b80761a8f3281af06881a9cbc146a15341
  * generator version:  1.0.0
- * package version:    0.59.172
+ * package version:    0.59.174
  * active keys:        606
  * retiring keys:      5
  *
@@ -19,9 +19,9 @@
  */
 /** Where this module came from — surfaced so a report can name the exact build. */
 declare const MANDATE_KEYS_META: {
-    readonly aidreamRevision: "8ff0911f9a2534c2cbd9e6cb99468a9edba1d71d";
+    readonly aidreamRevision: "a1c540b80761a8f3281af06881a9cbc146a15341";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.172";
+    readonly packageVersion: "0.59.174";
     readonly retireWindow: 3;
 };
 /** Every declared mandate key, by THE IDENTIFIER RULE. */
@@ -639,7 +639,7 @@ declare const MANDATE_KEYS: {
      */
     readonly brand_discovery__offering_roles: "brand_discovery.offering_roles";
     /**
-     * @deprecated retiring since 0.59.172 — no longer declared in
+     * @deprecated retiring since 0.59.174 — no longer declared in
      * aidream. It leaves this union once no snapshot within the last
      * 3 published versions still carries it as active.
      */
@@ -670,7 +670,7 @@ declare const ALL_MANDATE_KEYS: readonly MandateKey[];
 /** Keys still in the union but no longer declared (two-phase retire, phase 1). */
 declare const RETIRING_MANDATE_KEYS: {
     readonly "brand_discovery.offering_roles": "0.59.0";
-    readonly "coding_session.managed_translation_reference": "0.59.172";
+    readonly "coding_session.managed_translation_reference": "0.59.174";
     readonly "pdf.content_cleaner": "0.59.0";
     readonly "sms.owner_beta": "0.59.0";
     readonly "voice.owner_beta": "0.59.0";

package/dist/mandates/index.d.ts

@@ -6,9 +6,9 @@
  * from the IN-PROCESS mandate declarations — the same `declared_mandates()` the
  * boot sync writes to the database from. There is no hand list anywhere.
  *
- * aidream revision:   8ff0911f9a2534c2cbd9e6cb99468a9edba1d71d
+ * aidream revision:   a1c540b80761a8f3281af06881a9cbc146a15341
  * generator version:  1.0.0
- * package version:    0.59.172
+ * package version:    0.59.174
  * active keys:        606
  * retiring keys:      5
  *
@@ -19,9 +19,9 @@
  */
 /** Where this module came from — surfaced so a report can name the exact build. */
 declare const MANDATE_KEYS_META: {
-    readonly aidreamRevision: "8ff0911f9a2534c2cbd9e6cb99468a9edba1d71d";
+    readonly aidreamRevision: "a1c540b80761a8f3281af06881a9cbc146a15341";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.172";
+    readonly packageVersion: "0.59.174";
     readonly retireWindow: 3;
 };
 /** Every declared mandate key, by THE IDENTIFIER RULE. */
@@ -639,7 +639,7 @@ declare const MANDATE_KEYS: {
      */
     readonly brand_discovery__offering_roles: "brand_discovery.offering_roles";
     /**
-     * @deprecated retiring since 0.59.172 — no longer declared in
+     * @deprecated retiring since 0.59.174 — no longer declared in
      * aidream. It leaves this union once no snapshot within the last
      * 3 published versions still carries it as active.
      */
@@ -670,7 +670,7 @@ declare const ALL_MANDATE_KEYS: readonly MandateKey[];
 /** Keys still in the union but no longer declared (two-phase retire, phase 1). */
 declare const RETIRING_MANDATE_KEYS: {
     readonly "brand_discovery.offering_roles": "0.59.0";
-    readonly "coding_session.managed_translation_reference": "0.59.172";
+    readonly "coding_session.managed_translation_reference": "0.59.174";
     readonly "pdf.content_cleaner": "0.59.0";
     readonly "sms.owner_beta": "0.59.0";
     readonly "voice.owner_beta": "0.59.0";

package/dist/mandates/index.js

@@ -1,8 +1,8 @@
 // mandates/keys.generated.ts
 var MANDATE_KEYS_META = {
-  aidreamRevision: "8ff0911f9a2534c2cbd9e6cb99468a9edba1d71d",
+  aidreamRevision: "a1c540b80761a8f3281af06881a9cbc146a15341",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.172",
+  packageVersion: "0.59.174",
   retireWindow: 3
 };
 var MANDATE_KEYS = {
@@ -619,7 +619,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.172 — no longer declared in
+   * @deprecated retiring since 0.59.174 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */
@@ -646,7 +646,7 @@ var MANDATE_KEYS = {
 var ALL_MANDATE_KEYS = Object.values(MANDATE_KEYS);
 var RETIRING_MANDATE_KEYS = {
   "brand_discovery.offering_roles": "0.59.0",
-  "coding_session.managed_translation_reference": "0.59.172",
+  "coding_session.managed_translation_reference": "0.59.174",
   "pdf.content_cleaner": "0.59.0",
   "sms.owner_beta": "0.59.0",
   "voice.owner_beta": "0.59.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.59.172",
+  "version": "0.59.174",
   "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -540,5 +540,5 @@
     "verify:tarball": "node ./scripts/verify-tarball.mjs",
     "typegen:self-test": "node scripts/typegen/drop-guard.self-test.mjs && node scripts/typegen/check-api-types-fresh.mjs --self-test"
   },
-  "gitHead": "8ff0911f9a2534c2cbd9e6cb99468a9edba1d71d"
+  "gitHead": "a1c540b80761a8f3281af06881a9cbc146a15341"
 }