@agenticprimitives/agent-naming 1.0.0-alpha.21 → 1.0.0-alpha.23

package/docs/api.md

@@ -3,9 +3,21 @@
 This is the human-readable guide to the public exports in
 `capability.manifest.json`. Keep it in sync with `src/index.ts`.
 
+## Typed naming (spec 346)
+
+| Export | Purpose |
+| --- | --- |
+| `AGENT_TLDS`, `AGENT_TLD_ALIASES`, `LEGACY_TLDS`, `RESERVED_LABELS` | The six canonical suffixes (`me org team svc workspace treasury registry church circle`), the `ws → workspace` alias, the untyped legacy roots, the labels no one may claim. |
+| `derivedTypeForTld`, `tldForDerivedType`, `rootClassForTld`, `rootClassForDerivedType`, `rootKindForTld` | suffix → derived type → root; the per-root `rootKind` tag (`keccak256("namespace:<Type>")`). |
+| `parseAgentName`, `formatAgentName`, `onChainNameOf`, `normalizeAgentName` | The grammar: `x.t`, `x.t@c.u`, `c.u/x.t`, dotted `x.t.c.u`, type-nodes, roots, legacy. |
+| `dnsHostForHandle`, `agentCardUrlForHost`, `a2aEndpointForHost`, `edgeA2aPathForHandle` | The §5 deployment-binding projection; the zone is always caller-supplied. |
+| `findUniqueLabel`, `childNodeOf`, `validateTypedClaim` | Forced-unique labels (spec 220 §5) and the suffix ↔ `atl:agentType` ↔ root invariant. |
+| `buildDeclareAgentTypeCalls`, `buildTypedClaimCalls` | Pure call builders for bootstrap steps 1b and 2–3 (compose into the SA's execute batch). |
+| `AgentNamingClient.resolveTyped` / `checkTypedName` / `readDerivedType` / `findUniqueLabel` / `subregistryFor` | Typed reads; require `opts.profileResolver` (+ `opts.subregistries` for claims). |
+
 ## Constants
 
-- `AGENT_TLD`: the canonical top-level label, currently `"agent"`.
+- `AGENT_TLDS`: the six typed suffixes (`me org team svc workspace treasury registry church circle`); `LEGACY_TLDS` = `impact`, `agent` (untyped, resolvable, closed to new claims after app adoption).
 - `AgentTld`: type of the canonical top-level label.
 - `ZERO_NODE`: the all-zero root node.
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agenticprimitives/agent-naming",
-  "version": "1.0.0-alpha.21",
-  "description": "Agent Naming Service SDK: hierarchical naming for Smart Agents (.agent TLD). Owns name normalization, namehash/labelhash, records schemas, and the AgentNamingClient (resolve / reverse / registry). Speaks naming-domain vocabulary only — no delegation / caveat / custody concepts.",
+  "version": "1.0.0-alpha.23",
+  "description": "Agent Naming Service SDK: typed hierarchical naming for Smart Agents (.me .org .team .svc .workspace .treasury — a suffix names the derived agent type; spec 346). Owns name grammar + normalization, namehash/labelhash, records schemas, the DNS/A2A endpoint projection, claim validation, and the AgentNamingClient (resolve / typed resolve / reverse / registry). Speaks naming-domain vocabulary only — no delegation / caveat / custody concepts.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -44,9 +44,9 @@
   },
   "peerDependencies": {
     "viem": "^2.52.2",
-    "@agenticprimitives/agent-account": "1.0.0-alpha.21",
-    "@agenticprimitives/connect-auth": "1.0.0-alpha.21",
-    "@agenticprimitives/types": "1.0.0-alpha.21"
+    "@agenticprimitives/agent-account": "1.0.0-alpha.23",
+    "@agenticprimitives/connect-auth": "1.0.0-alpha.23",
+    "@agenticprimitives/types": "1.0.0-alpha.23"
   },
   "devDependencies": {
     "@types/node": "^22.7.0",
@@ -63,7 +63,7 @@
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
-    "test:unit": "vitest run test/normalize.test.ts test/namehash.test.ts test/records.test.ts --passWithNoTests",
+    "test:unit": "vitest run test/normalize.test.ts test/namehash.test.ts test/records.test.ts test/grammar.test.ts test/dns.test.ts test/claim.test.ts test/custody.test.ts test/issuance.test.ts test/vertical.test.ts --passWithNoTests",
     "test:integration": "vitest run test/integration.test.ts --passWithNoTests",
     "test:watch": "vitest",
     "clean": "rm -rf dist"