@ai-matrx/agents 0.7.0 → 0.7.1

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

@@ -19,9 +19,20 @@ import { ComponentType, ReactNode, Ref } from 'react';
  * default row carries (byte-identical to the ref shape matrx-extend
  * `src/lib/mandates.ts` and matrx-local `desktop/src/lib/mandates.ts`
  * already hand back to their hosts).
+ *
+ * 🚨 The brand is a STRING LITERAL, never `unique symbol`. This package emits
+ * `./catalog` and `./catalog/react` as two separate bundles, so each `.d.ts`
+ * carries its own copy of these declarations. A `unique symbol` brand is
+ * NOMINAL: two copies of it are unrelated types, so `createAgentCatalog()`
+ * from `./catalog` was not assignable to `<AgentCatalogProvider catalog=…>`
+ * from `./catalog/react` — the exact two-import wiring the README, the
+ * CHANGELOG and every consumer use. A literal brand is structural, so the two
+ * copies unify, while a bare `string` still cannot be passed where an
+ * `AgentId` is required (which is the whole point of branding). Any future
+ * brand in this package follows the same rule.
  */
 type AgentId = string & {
-    readonly __agentId: unique symbol;
+    readonly __agentId: "ai-matrx.agent-id";
 };
 /** `agent_type` verbatim. Only `builtin` changes how a row is grouped. */
 type AgentCatalogAgentType = "user" | "builtin";

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

@@ -19,9 +19,20 @@ import { ComponentType, ReactNode, Ref } from 'react';
  * default row carries (byte-identical to the ref shape matrx-extend
  * `src/lib/mandates.ts` and matrx-local `desktop/src/lib/mandates.ts`
  * already hand back to their hosts).
+ *
+ * 🚨 The brand is a STRING LITERAL, never `unique symbol`. This package emits
+ * `./catalog` and `./catalog/react` as two separate bundles, so each `.d.ts`
+ * carries its own copy of these declarations. A `unique symbol` brand is
+ * NOMINAL: two copies of it are unrelated types, so `createAgentCatalog()`
+ * from `./catalog` was not assignable to `<AgentCatalogProvider catalog=…>`
+ * from `./catalog/react` — the exact two-import wiring the README, the
+ * CHANGELOG and every consumer use. A literal brand is structural, so the two
+ * copies unify, while a bare `string` still cannot be passed where an
+ * `AgentId` is required (which is the whole point of branding). Any future
+ * brand in this package follows the same rule.
  */
 type AgentId = string & {
-    readonly __agentId: unique symbol;
+    readonly __agentId: "ai-matrx.agent-id";
 };
 /** `agent_type` verbatim. Only `builtin` changes how a row is grouped. */
 type AgentCatalogAgentType = "user" | "builtin";