@ai-matrx/agents 0.7.0 → 0.7.1

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## 0.7.1 — 2026-09-08
+
+**0.7.0's two catalog entries did not typecheck together.** `./catalog` and
+`./catalog/react` are emitted by two separate tsup passes (only the react group
+carries the `"use client"` banner), so each `.d.ts` holds its own copy of the
+shared declarations. `AgentId` was branded with a `unique symbol`, which is
+NOMINAL — the two copies were unrelated types, and the wiring the 0.7.0
+`Consumer action` prescribes:
+
+```tsx
+<AgentCatalogProvider catalog={createAgentCatalog({ client, identity })}>
+```
+
+failed with *"Two different types with this name exist, but they are
+unrelated"* in every consumer. Every runtime canary was green; only a `tsc` in
+a real host caught it (matrx-extend, on its first compile of the adoption).
+
+### Consumer action (C28)
+
+Update to 0.7.1 and the documented wiring compiles. No source change is needed
+in a host — if you worked around this with a cast, DELETE the cast.
+
+### The fix, and the guard
+
+- `AgentId` is now branded with a string literal
+  (`string & { readonly __agentId: "ai-matrx.agent-id" }`). A literal brand is
+  structural, so the two emitted copies unify; a bare `string` still cannot be
+  passed where an `AgentId` is required, so the branding is not weakened. Any
+  future brand in this package follows the same rule — the reason is recorded
+  at the declaration.
+- `scripts/verify-tarball.mjs` grew THE TWO-ENTRY TYPE-IDENTITY CANARY: it
+  installs the packed tarball into a scratch consumer with `strict`,
+  `exactOptionalPropertyTypes`, `noUncheckedIndexedAccess` and
+  `skipLibCheck: false`, then compiles the real provider wiring plus reads that
+  cross the seam in both directions. Proven RED against the 0.7.0 brand
+  (the same "two different types" error, from the packed types) and GREEN
+  after the fix. It runs inside `pnpm check:package`, which the publish
+  workflow gates on.
+
+
 ## 0.7.0 — 2026-09-08
 
 **THE ONE AGENT PICKER moves into the package.** Two new entries — `./catalog`