@ai-matrx/agents 0.7.0 → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -16,9 +16,20 @@
16
16
  * default row carries (byte-identical to the ref shape matrx-extend
17
17
  * `src/lib/mandates.ts` and matrx-local `desktop/src/lib/mandates.ts`
18
18
  * already hand back to their hosts).
19
+ *
20
+ * 🚨 The brand is a STRING LITERAL, never `unique symbol`. This package emits
21
+ * `./catalog` and `./catalog/react` as two separate bundles, so each `.d.ts`
22
+ * carries its own copy of these declarations. A `unique symbol` brand is
23
+ * NOMINAL: two copies of it are unrelated types, so `createAgentCatalog()`
24
+ * from `./catalog` was not assignable to `<AgentCatalogProvider catalog=…>`
25
+ * from `./catalog/react` — the exact two-import wiring the README, the
26
+ * CHANGELOG and every consumer use. A literal brand is structural, so the two
27
+ * copies unify, while a bare `string` still cannot be passed where an
28
+ * `AgentId` is required (which is the whole point of branding). Any future
29
+ * brand in this package follows the same rule.
19
30
  */
20
31
  type AgentId = string & {
21
- readonly __agentId: unique symbol;
32
+ readonly __agentId: "ai-matrx.agent-id";
22
33
  };
23
34
  /** Brand a raw string as an `AgentId`. */
24
35
  declare function asAgentId(value: string): AgentId;
@@ -16,9 +16,20 @@
16
16
  * default row carries (byte-identical to the ref shape matrx-extend
17
17
  * `src/lib/mandates.ts` and matrx-local `desktop/src/lib/mandates.ts`
18
18
  * already hand back to their hosts).
19
+ *
20
+ * 🚨 The brand is a STRING LITERAL, never `unique symbol`. This package emits
21
+ * `./catalog` and `./catalog/react` as two separate bundles, so each `.d.ts`
22
+ * carries its own copy of these declarations. A `unique symbol` brand is
23
+ * NOMINAL: two copies of it are unrelated types, so `createAgentCatalog()`
24
+ * from `./catalog` was not assignable to `<AgentCatalogProvider catalog=…>`
25
+ * from `./catalog/react` — the exact two-import wiring the README, the
26
+ * CHANGELOG and every consumer use. A literal brand is structural, so the two
27
+ * copies unify, while a bare `string` still cannot be passed where an
28
+ * `AgentId` is required (which is the whole point of branding). Any future
29
+ * brand in this package follows the same rule.
19
30
  */
20
31
  type AgentId = string & {
21
- readonly __agentId: unique symbol;
32
+ readonly __agentId: "ai-matrx.agent-id";
22
33
  };
23
34
  /** Brand a raw string as an `AgentId`. */
24
35
  declare function asAgentId(value: string): AgentId;