@ai-matrx/agents 0.59.169 → 0.59.171

package/CHANGELOG.md

@@ -2,13 +2,25 @@
 
 ### Unreleased
 
+- **`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.169
+## 0.59.171
 
 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.170
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff e9c25acd07 9c0ddc1922 -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
+## 0.59.169
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff cae8c2b935 e9c25acd07 -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
 ## 0.59.168
 
 Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 5535e3bb42 cae8c2b935 -- apps/shared/matrx-agents/src`

package/dist/catalog/react/index.cjs

@@ -176,6 +176,22 @@ function AgentCatalogProvider({
 // catalog/react/useAgentSummary.ts
 var import_react3 = require("react");
 var noopSubscribe = () => () => void 0;
+var looked = /* @__PURE__ */ new WeakMap();
+function lookUpAgentOnce(catalog, agentId) {
+  let byId = looked.get(catalog);
+  if (!byId) {
+    byId = /* @__PURE__ */ new Map();
+    looked.set(catalog, byId);
+  }
+  const kept = byId.get(agentId);
+  if (kept) return kept;
+  const lookup = catalog.searchServer(agentId).then(() => void 0).catch((error) => {
+    byId?.delete(agentId);
+    throw error;
+  });
+  byId.set(agentId, lookup);
+  return lookup;
+}
 function useAgentSummary(catalog, agentId) {
   const row = (0, import_react3.useSyncExternalStore)(
     catalog ? catalog.subscribe : noopSubscribe,
@@ -188,7 +204,7 @@ function useAgentSummary(catalog, agentId) {
     let cancelled = false;
     void catalog.ensureLoaded().then(() => {
       if (cancelled || catalog.getState().byId[agentId]) return;
-      return catalog.searchServer(agentId).then(() => void 0);
+      return lookUpAgentOnce(catalog, agentId);
     }).catch(() => void 0);
     return () => {
       cancelled = true;

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

@@ -564,7 +564,8 @@ declare function AgentCatalogProvider({ catalog, children, ...ports }: AgentCata
  * 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
  * catalog is loaded (its own TTL and in-flight dedupe make this safe on every mount); an id the
- * list does not carry is looked up by server search, which merges it into the catalog.
+ * list does not carry is looked up by server search, which merges it into the catalog — once per
+ * id per catalog (the Board's remount law: a woken or remounted tile asks nothing again).
  *
  * Takes the catalog explicitly so a host without `AgentCatalogProvider` (chat, workers) binds it.
  */

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

@@ -564,7 +564,8 @@ declare function AgentCatalogProvider({ catalog, children, ...ports }: AgentCata
  * 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
  * catalog is loaded (its own TTL and in-flight dedupe make this safe on every mount); an id the
- * list does not carry is looked up by server search, which merges it into the catalog.
+ * list does not carry is looked up by server search, which merges it into the catalog — once per
+ * id per catalog (the Board's remount law: a woken or remounted tile asks nothing again).
  *
  * Takes the catalog explicitly so a host without `AgentCatalogProvider` (chat, workers) binds it.
  */

package/dist/catalog/react/index.js

@@ -118,6 +118,22 @@ function AgentCatalogProvider({
 // catalog/react/useAgentSummary.ts
 import { useEffect, useSyncExternalStore as useSyncExternalStore2 } from "react";
 var noopSubscribe = () => () => void 0;
+var looked = /* @__PURE__ */ new WeakMap();
+function lookUpAgentOnce(catalog, agentId) {
+  let byId = looked.get(catalog);
+  if (!byId) {
+    byId = /* @__PURE__ */ new Map();
+    looked.set(catalog, byId);
+  }
+  const kept = byId.get(agentId);
+  if (kept) return kept;
+  const lookup = catalog.searchServer(agentId).then(() => void 0).catch((error) => {
+    byId?.delete(agentId);
+    throw error;
+  });
+  byId.set(agentId, lookup);
+  return lookup;
+}
 function useAgentSummary(catalog, agentId) {
   const row = useSyncExternalStore2(
     catalog ? catalog.subscribe : noopSubscribe,
@@ -130,7 +146,7 @@ function useAgentSummary(catalog, agentId) {
     let cancelled = false;
     void catalog.ensureLoaded().then(() => {
       if (cancelled || catalog.getState().byId[agentId]) return;
-      return catalog.searchServer(agentId).then(() => void 0);
+      return lookUpAgentOnce(catalog, agentId);
     }).catch(() => void 0);
     return () => {
       cancelled = true;

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.169 — no longer declared in
+   * @deprecated retiring since 0.59.171 — 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.169 — no longer declared in
+   * @deprecated retiring since 0.59.171 — 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.169 — no longer declared in
+   * @deprecated retiring since 0.59.171 — 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.169 — no longer declared in
+   * @deprecated retiring since 0.59.171 — 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/mandates/index.cjs

@@ -47,9 +47,9 @@ module.exports = __toCommonJS(mandates_exports);
 
 // mandates/keys.generated.ts
 var MANDATE_KEYS_META = {
-  aidreamRevision: "e9c25acd070fae3e6f85b1bce3abc175429d6d03",
+  aidreamRevision: "51e05980ffffd69bb62aac74c488fecb4b2686b3",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.169",
+  packageVersion: "0.59.171",
   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.169 — no longer declared in
+   * @deprecated retiring since 0.59.171 — 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.169",
+  "coding_session.managed_translation_reference": "0.59.171",
   "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:   e9c25acd070fae3e6f85b1bce3abc175429d6d03
+ * aidream revision:   51e05980ffffd69bb62aac74c488fecb4b2686b3
  * generator version:  1.0.0
- * package version:    0.59.169
+ * package version:    0.59.171
  * 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: "e9c25acd070fae3e6f85b1bce3abc175429d6d03";
+    readonly aidreamRevision: "51e05980ffffd69bb62aac74c488fecb4b2686b3";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.169";
+    readonly packageVersion: "0.59.171";
     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.169 — no longer declared in
+     * @deprecated retiring since 0.59.171 — 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.169";
+    readonly "coding_session.managed_translation_reference": "0.59.171";
     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:   e9c25acd070fae3e6f85b1bce3abc175429d6d03
+ * aidream revision:   51e05980ffffd69bb62aac74c488fecb4b2686b3
  * generator version:  1.0.0
- * package version:    0.59.169
+ * package version:    0.59.171
  * 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: "e9c25acd070fae3e6f85b1bce3abc175429d6d03";
+    readonly aidreamRevision: "51e05980ffffd69bb62aac74c488fecb4b2686b3";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.169";
+    readonly packageVersion: "0.59.171";
     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.169 — no longer declared in
+     * @deprecated retiring since 0.59.171 — 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.169";
+    readonly "coding_session.managed_translation_reference": "0.59.171";
     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: "e9c25acd070fae3e6f85b1bce3abc175429d6d03",
+  aidreamRevision: "51e05980ffffd69bb62aac74c488fecb4b2686b3",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.169",
+  packageVersion: "0.59.171",
   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.169 — no longer declared in
+   * @deprecated retiring since 0.59.171 — 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.169",
+  "coding_session.managed_translation_reference": "0.59.171",
   "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.169",
+  "version": "0.59.171",
   "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -492,8 +492,8 @@
     "@ai-matrx/api": "latest",
     "@ai-matrx/associations": "latest",
     "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/design-system": "latest",
     "@ai-matrx/data": "latest",
+    "@ai-matrx/design-system": "latest",
     "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest"
   },
@@ -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": "e9c25acd070fae3e6f85b1bce3abc175429d6d03"
+  "gitHead": "51e05980ffffd69bb62aac74c488fecb4b2686b3"
 }