@agenticprimitives/agent-naming 0.1.0-alpha.2

package/dist/custody.js

@@ -0,0 +1,214 @@
+/**
+ * Subpath `@agenticprimitives/agent-naming/custody`.
+ *
+ * Pure encoded call builders for name-registry + resolver writes.
+ * Compose these into a custody ceremony, a direct EOA tx, an
+ * ERC-4337 UserOp, or anything else that submits a transaction.
+ * The package boundary (spec 215 § 3) prohibits importing
+ * `@agenticprimitives/account-custody` from here — these builders MUST stay
+ * pure encode-only.
+ *
+ * Each builder returns a `ContractCall` shape (`{ to, value, data }`)
+ * matching the standard "compose-then-submit" pattern used across
+ * other agenticprimitives packages.
+ *
+ * Phase 4 lands the encoders; the client (`AgentNamingClient`) layers
+ * walletClient submission on top.
+ */
+import { encodeFunctionData } from 'viem';
+import { agentNameAttributeResolverAbi, agentNameRegistryAbi, permissionlessSubregistryAbi, } from './abis';
+import { PREDICATE_ID, AGENT_KIND_ID } from './records';
+// ─── Registry writes ───────────────────────────────────────────────
+/**
+ * Build a call to register `<label>.<parent>` under the parent
+ * namespace. Caller MUST be the parent's owner OR subregistry
+ * delegate (msg.sender check on chain).
+ */
+export function buildRegisterSubnameCall(args) {
+    return {
+        to: args.registry,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: agentNameRegistryAbi,
+            functionName: 'register',
+            args: [
+                args.parentNode,
+                args.label,
+                args.newOwner,
+                args.resolver ?? '0x0000000000000000000000000000000000000000',
+                args.expiry ?? 0n,
+            ],
+        }),
+    };
+}
+/**
+ * Build a call to rotate the owner Smart Agent for a name.
+ * Caller MUST be the current owner.
+ */
+export function buildRotateNameOwnerCall(args) {
+    return {
+        to: args.registry,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: agentNameRegistryAbi,
+            functionName: 'setOwner',
+            args: [args.node, args.newOwner],
+        }),
+    };
+}
+/**
+ * Build a call to swap the resolver contract for a name.
+ * Caller MUST be the current owner.
+ */
+export function buildRotateNameResolverCall(args) {
+    return {
+        to: args.registry,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: agentNameRegistryAbi,
+            functionName: 'setResolver',
+            args: [args.node, args.newResolver],
+        }),
+    };
+}
+/**
+ * Build a call to delegate child-name issuance authority for a
+ * subtree to a subregistry contract. Setting `subregistry = address(0)`
+ * reverts to "owner-only" issuance.
+ */
+export function buildSetSubregistryCall(args) {
+    return {
+        to: args.registry,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: agentNameRegistryAbi,
+            functionName: 'setSubregistry',
+            args: [args.node, args.subregistry],
+        }),
+    };
+}
+/**
+ * Build a call to set the caller's primary name (reverse record).
+ * Caller MUST be the agent for which the primary name is being set
+ * (msg.sender == agent on chain). Setting `node = bytes32(0)` clears
+ * the primary name.
+ */
+export function buildSetPrimaryNameCall(args) {
+    return {
+        to: args.registry,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: agentNameRegistryAbi,
+            functionName: 'setPrimaryName',
+            args: [args.node],
+        }),
+    };
+}
+// ─── Resolver (record) writes ──────────────────────────────────────
+/** Build a typed `setStringAttribute(node, predicate, value)` call. */
+export function buildSetStringAttributeCall(args) {
+    return {
+        to: args.resolver,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: agentNameAttributeResolverAbi,
+            functionName: 'setStringAttribute',
+            args: [args.node, args.predicate, args.value],
+        }),
+    };
+}
+/** Build a typed `setAddressAttribute(node, predicate, value)` call. */
+export function buildSetAddressAttributeCall(args) {
+    return {
+        to: args.resolver,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: agentNameAttributeResolverAbi,
+            functionName: 'setAddressAttribute',
+            args: [args.node, args.predicate, args.value],
+        }),
+    };
+}
+/** Build a typed `setBytes32Attribute(node, predicate, value)` call. */
+export function buildSetBytes32AttributeCall(args) {
+    return {
+        to: args.resolver,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: agentNameAttributeResolverAbi,
+            functionName: 'setBytes32Attribute',
+            args: [args.node, args.predicate, args.value],
+        }),
+    };
+}
+// ─── Records bundle → array of typed-attribute calls ───────────────
+/**
+ * Translate an `AgentNameRecords` bundle into N typed-attribute
+ * calls. Caller submits them via walletClient OR composes them into
+ * a single AgentAccount.execute / CustodyPolicy ceremony.
+ *
+ * Mirrors `encodeRecords` from `agent-naming/records` but produces
+ * full `ContractCall` shapes instead of `EncodedRecord` shapes.
+ */
+export function buildRecordCalls(args) {
+    const out = [];
+    const { resolver, node, records } = args;
+    if (records.addr !== undefined) {
+        out.push(buildSetAddressAttributeCall({ resolver, node, predicate: PREDICATE_ID.addr, value: records.addr }));
+    }
+    if (records.agentKind !== undefined) {
+        out.push(buildSetBytes32AttributeCall({
+            resolver, node,
+            predicate: PREDICATE_ID.agentKind,
+            value: AGENT_KIND_ID[records.agentKind],
+        }));
+    }
+    if (records.displayName !== undefined) {
+        out.push(buildSetStringAttributeCall({ resolver, node, predicate: PREDICATE_ID.displayName, value: records.displayName }));
+    }
+    if (records.a2aEndpoint !== undefined) {
+        out.push(buildSetStringAttributeCall({ resolver, node, predicate: PREDICATE_ID.a2aEndpoint, value: records.a2aEndpoint }));
+    }
+    if (records.mcpEndpoint !== undefined) {
+        out.push(buildSetStringAttributeCall({ resolver, node, predicate: PREDICATE_ID.mcpEndpoint, value: records.mcpEndpoint }));
+    }
+    if (records.metadataUri !== undefined) {
+        out.push(buildSetStringAttributeCall({ resolver, node, predicate: PREDICATE_ID.metadataUri, value: records.metadataUri }));
+    }
+    if (records.metadataHash !== undefined) {
+        out.push(buildSetBytes32AttributeCall({ resolver, node, predicate: PREDICATE_ID.metadataHash, value: records.metadataHash }));
+    }
+    if (records.passkeyCredentialDigest !== undefined) {
+        out.push(buildSetBytes32AttributeCall({ resolver, node, predicate: PREDICATE_ID.passkeyCredentialDigest, value: records.passkeyCredentialDigest }));
+    }
+    if (records.custodyPolicy !== undefined) {
+        out.push(buildSetAddressAttributeCall({ resolver, node, predicate: PREDICATE_ID.custodyPolicy, value: records.custodyPolicy }));
+    }
+    if (records.nativeId !== undefined) {
+        out.push(buildSetStringAttributeCall({ resolver, node, predicate: PREDICATE_ID.nativeId, value: records.nativeId }));
+    }
+    return out;
+}
+// ─── PermissionlessSubregistry ─────────────────────────────────────
+/**
+ * Build a call to claim `<label>.<parent>` through a deployed
+ * PermissionlessSubregistry instance. The caller pays gas; the
+ * registered child name is owned by `newOwner` (typically the
+ * caller's own PSA OR an account they control).
+ *
+ * Anti-spam: one claim per `msg.sender` is enforced on chain; the
+ * call reverts with `AlreadyClaimed(existingNode)` if the caller
+ * has previously claimed a name through this subregistry instance.
+ */
+export function buildSubregistryRegisterCall(args) {
+    return {
+        to: args.subregistry,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: permissionlessSubregistryAbi,
+            functionName: 'register',
+            args: [args.label, args.newOwner],
+        }),
+    };
+}
+//# sourceMappingURL=custody.js.map

package/dist/custody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custody.js","sourceRoot":"","sources":["../src/custody.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,15 @@
+export declare class InvalidNameError extends Error {
+    readonly agentName: string;
+    readonly reason: string;
+    constructor(agentName: string, reason: string);
+}
+export declare class NameNotFoundError extends Error {
+    readonly agentName: string;
+    constructor(agentName: string);
+}
+export declare class UnauthorizedNameOwnerError extends Error {
+    readonly agentName: string;
+    readonly attemptedSigner?: string | undefined;
+    constructor(agentName: string, attemptedSigner?: string | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAiB,SAAQ,KAAK;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAA1C,SAAS,EAAE,MAAM,EAAW,MAAM,EAAE,MAAM;CAIhE;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAIvC;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM;IAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM;gBAApD,SAAS,EAAE,MAAM,EAAW,eAAe,CAAC,EAAE,MAAM,YAAA;CAO1E"}

package/dist/errors.js

@@ -0,0 +1,30 @@
+export class InvalidNameError extends Error {
+    agentName;
+    reason;
+    constructor(agentName, reason) {
+        super(`[agent-naming] invalid name "${agentName}": ${reason}`);
+        this.agentName = agentName;
+        this.reason = reason;
+        this.name = 'InvalidNameError';
+    }
+}
+export class NameNotFoundError extends Error {
+    agentName;
+    constructor(agentName) {
+        super(`[agent-naming] name not registered: ${agentName}`);
+        this.agentName = agentName;
+        this.name = 'NameNotFoundError';
+    }
+}
+export class UnauthorizedNameOwnerError extends Error {
+    agentName;
+    attemptedSigner;
+    constructor(agentName, attemptedSigner) {
+        super(`[agent-naming] caller is not the owner of "${agentName}"` +
+            (attemptedSigner ? ` (attempted: ${attemptedSigner})` : ''));
+        this.agentName = agentName;
+        this.attemptedSigner = attemptedSigner;
+        this.name = 'UnauthorizedNameOwnerError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACpB;IAA4B;IAAjD,YAAqB,SAAiB,EAAW,MAAc;QAC7D,KAAK,CAAC,gCAAgC,SAAS,MAAM,MAAM,EAAE,CAAC,CAAC;QAD5C,cAAS,GAAT,SAAS,CAAQ;QAAW,WAAM,GAAN,MAAM,CAAQ;QAE7D,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACrB;IAArB,YAAqB,SAAiB;QACpC,KAAK,CAAC,uCAAuC,SAAS,EAAE,CAAC,CAAC;QADvC,cAAS,GAAT,SAAS,CAAQ;QAEpC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC9B;IAA4B;IAAjD,YAAqB,SAAiB,EAAW,eAAwB;QACvE,KAAK,CACH,8CAA8C,SAAS,GAAG;YACxD,CAAC,eAAe,CAAC,CAAC,CAAC,gBAAgB,eAAe,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAC9D,CAAC;QAJiB,cAAS,GAAT,SAAS,CAAQ;QAAW,oBAAe,GAAf,eAAe,CAAS;QAKvE,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { AGENT_TLD, type AgentTld } from './constants';
+export { normalizeAgentName, isValidAgentName } from './normalize';
+export { labelhash, namehash, ZERO_NODE } from './namehash';
+export { InvalidNameError, NameNotFoundError, UnauthorizedNameOwnerError, } from './errors';
+export type { AgentKind, AgentNameRecords, RegisterSubnameInput, SetPrimaryNameInput, SetAgentRecordsInput, SetSubregistryInput, AgentNamingClientOpts, } from './types';
+export { AgentNamingClient, type WriteContext } from './client';
+export { buildRegisterSubnameCall, buildRotateNameOwnerCall, buildRotateNameResolverCall, buildSetSubregistryCall, buildSetPrimaryNameCall, buildSetStringAttributeCall, buildSetAddressAttributeCall, buildSetBytes32AttributeCall, buildRecordCalls, buildSubregistryRegisterCall, type ContractCall, } from './custody';
+export { agentNameRegistryAbi, agentNameAttributeResolverAbi, agentNameUniversalResolverAbi, ontologyTermRegistryAbi, shapeRegistryAbi, permissionlessSubregistryAbi, } from './abis';
+export { PREDICATE_ID, AGENT_KIND_ID, CLASS_AGENT_NAME, AGENT_KIND_ENUM, CAIP10_NAMESPACE_ALLOWLIST, encodeRecords, decodeRecords, type PredicateName, type EncodedRecord, type DecodeInput, } from './records';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAIhE,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,EAC5B,4BAA4B,EAC5B,gBAAgB,EAChB,4BAA4B,EAC5B,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC;AAKnB,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,QAAQ,CAAC;AAIhB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,0BAA0B,EAC1B,aAAa,EACb,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+// @agenticprimitives/agent-naming — public API.
+//
+// See:
+//   - capability.manifest.json — boundary
+//   - CLAUDE.md — doctrine
+//   - specs/215-agent-naming.md — the contract
+export { AGENT_TLD } from './constants';
+export { normalizeAgentName, isValidAgentName } from './normalize';
+export { labelhash, namehash, ZERO_NODE } from './namehash';
+export { InvalidNameError, NameNotFoundError, UnauthorizedNameOwnerError, } from './errors';
+export { AgentNamingClient } from './client';
+// Phase 4 pure call builders (subpath `@agenticprimitives/agent-naming/custody`
+// re-exported from top-level for convenience).
+export { buildRegisterSubnameCall, buildRotateNameOwnerCall, buildRotateNameResolverCall, buildSetSubregistryCall, buildSetPrimaryNameCall, buildSetStringAttributeCall, buildSetAddressAttributeCall, buildSetBytes32AttributeCall, buildRecordCalls, buildSubregistryRegisterCall, } from './custody';
+// Phase 3 contract ABIs (live at deployed addresses recorded in
+// packages/contracts/deployments-<network>.json). ADR-0009 pivot: the
+// resolver inherits the shared `AttributeStorage` + ontology stack.
+export { agentNameRegistryAbi, agentNameAttributeResolverAbi, agentNameUniversalResolverAbi, ontologyTermRegistryAbi, shapeRegistryAbi, permissionlessSubregistryAbi, } from './abis';
+// Ontology predicate ids (bytes32 mirror of AgentNamePredicates.sol) +
+// CAIP-10 helpers + typed encoder / decoder.
+export { PREDICATE_ID, AGENT_KIND_ID, CLASS_AGENT_NAME, AGENT_KIND_ENUM, CAIP10_NAMESPACE_ALLOWLIST, encodeRecords, decodeRecords, } from './records';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,OAAO;AACP,0CAA0C;AAC1C,2BAA2B;AAC3B,+CAA+C;AAE/C,OAAO,EAAE,SAAS,EAAiB,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,UAAU,CAAC;AAUlB,OAAO,EAAE,iBAAiB,EAAqB,MAAM,UAAU,CAAC;AAEhE,gFAAgF;AAChF,+CAA+C;AAC/C,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,EAC5B,4BAA4B,EAC5B,gBAAgB,EAChB,4BAA4B,GAE7B,MAAM,WAAW,CAAC;AAEnB,gEAAgE;AAChE,sEAAsE;AACtE,oEAAoE;AACpE,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,QAAQ,CAAC;AAEhB,uEAAuE;AACvE,6CAA6C;AAC7C,OAAO,EACL,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,0BAA0B,EAC1B,aAAa,EACb,aAAa,GAId,MAAM,WAAW,CAAC"}

package/dist/namehash.d.ts

@@ -0,0 +1,31 @@
+import { type Hex } from 'viem';
+/**
+ * Compute the namehash of an agent name (ENS-compatible).
+ *
+ *   namehash('')                = 0x00…00
+ *   namehash('agent')           = keccak256(namehash('') || labelhash('agent'))
+ *   namehash('alice.acme.agent')
+ *                               = keccak256(namehash('acme.agent') || labelhash('alice'))
+ *
+ * The hash is computed against the NORMALIZED name (see
+ * `normalizeAgentName`). Two strings that normalize identically
+ * produce identical namehashes.
+ *
+ * Throws `InvalidNameError` (via `normalizeAgentName`) on malformed
+ * input. Passing `''` returns `0x00…00` — the canonical "empty / root"
+ * sentinel matching the ENS convention.
+ */
+export declare function namehash(name: string): Hex;
+/**
+ * Compute the labelhash of a single label.
+ *
+ * `labelhash(label)` = keccak256(utf8Bytes(label))
+ *
+ * No normalization is applied here — the caller is expected to pass a
+ * label produced by splitting a normalized name. Pass a non-normalized
+ * label at your own risk.
+ */
+export declare function labelhash(label: string): Hex;
+/** The all-zeros 32-byte sentinel namehash (the root of the tree). */
+export declare const ZERO_NODE: Hex;
+//# sourceMappingURL=namehash.d.ts.map

package/dist/namehash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namehash.d.ts","sourceRoot":"","sources":["../src/namehash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAGlE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAW1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAE5C;AAED,sEAAsE;AACtE,eAAO,MAAM,SAAS,EAAE,GAA0E,CAAC"}

package/dist/namehash.js

@@ -0,0 +1,46 @@
+import { keccak256, encodePacked, toBytes } from 'viem';
+import { normalizeAgentName } from './normalize';
+/**
+ * Compute the namehash of an agent name (ENS-compatible).
+ *
+ *   namehash('')                = 0x00…00
+ *   namehash('agent')           = keccak256(namehash('') || labelhash('agent'))
+ *   namehash('alice.acme.agent')
+ *                               = keccak256(namehash('acme.agent') || labelhash('alice'))
+ *
+ * The hash is computed against the NORMALIZED name (see
+ * `normalizeAgentName`). Two strings that normalize identically
+ * produce identical namehashes.
+ *
+ * Throws `InvalidNameError` (via `normalizeAgentName`) on malformed
+ * input. Passing `''` returns `0x00…00` — the canonical "empty / root"
+ * sentinel matching the ENS convention.
+ */
+export function namehash(name) {
+    if (name === '')
+        return ZERO_NODE;
+    const labels = normalizeAgentName(name).split('.');
+    let node = ZERO_NODE;
+    // Walk from rightmost (TLD-side) label inward so the root anchors
+    // the recursion — same as ENS reference impl.
+    for (let i = labels.length - 1; i >= 0; i--) {
+        const lh = labelhash(labels[i]);
+        node = keccak256(encodePacked(['bytes32', 'bytes32'], [node, lh]));
+    }
+    return node;
+}
+/**
+ * Compute the labelhash of a single label.
+ *
+ * `labelhash(label)` = keccak256(utf8Bytes(label))
+ *
+ * No normalization is applied here — the caller is expected to pass a
+ * label produced by splitting a normalized name. Pass a non-normalized
+ * label at your own risk.
+ */
+export function labelhash(label) {
+    return keccak256(toBytes(label));
+}
+/** The all-zeros 32-byte sentinel namehash (the root of the tree). */
+export const ZERO_NODE = '0x0000000000000000000000000000000000000000000000000000000000000000';
+//# sourceMappingURL=namehash.js.map

package/dist/namehash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namehash.js","sourceRoot":"","sources":["../src/namehash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAY,MAAM,MAAM,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAClC,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,IAAI,GAAQ,SAAS,CAAC;IAC1B,kEAAkE;IAClE,8CAA8C;IAC9C,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;QACjC,IAAI,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,SAAS,GAAQ,oEAAoE,CAAC"}

package/dist/normalize.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Normalize an agent name to canonical form.
+ *
+ * Phase 1 normalization (US-ASCII subset; spec § 4 normalization
+ * rules; matches `smart-agent/packages/sdk/src/naming.ts:normalize`
+ * with stricter label validation):
+ *
+ *   1. NFC normalize the input.
+ *   2. Trim outer whitespace.
+ *   3. Lowercase (`String.prototype.toLowerCase` — note Turkish-i
+ *      edge case; acceptable in Phase 1 since labels are ASCII-only).
+ *   4. Split on `.`. For each label:
+ *      - Reject empty.
+ *      - Reject leading or trailing `-`.
+ *      - Reject characters outside `[a-z 0-9 -]`.
+ *      - Reject length > 63.
+ *   5. Return joined.
+ *
+ * Throws `InvalidNameError` on any rule violation. Use this BEFORE
+ * `namehash` so the namehash is computed against the canonical form.
+ */
+export declare function normalizeAgentName(name: string): string;
+/**
+ * Predicate variant — returns true / false instead of throwing.
+ * Useful for UI input validation.
+ */
+export declare function isValidAgentName(name: string): boolean;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAavD;AAyBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOtD"}

package/dist/normalize.js

@@ -0,0 +1,68 @@
+import { InvalidNameError } from './errors';
+/**
+ * Normalize an agent name to canonical form.
+ *
+ * Phase 1 normalization (US-ASCII subset; spec § 4 normalization
+ * rules; matches `smart-agent/packages/sdk/src/naming.ts:normalize`
+ * with stricter label validation):
+ *
+ *   1. NFC normalize the input.
+ *   2. Trim outer whitespace.
+ *   3. Lowercase (`String.prototype.toLowerCase` — note Turkish-i
+ *      edge case; acceptable in Phase 1 since labels are ASCII-only).
+ *   4. Split on `.`. For each label:
+ *      - Reject empty.
+ *      - Reject leading or trailing `-`.
+ *      - Reject characters outside `[a-z 0-9 -]`.
+ *      - Reject length > 63.
+ *   5. Return joined.
+ *
+ * Throws `InvalidNameError` on any rule violation. Use this BEFORE
+ * `namehash` so the namehash is computed against the canonical form.
+ */
+export function normalizeAgentName(name) {
+    if (typeof name !== 'string') {
+        throw new InvalidNameError(String(name), 'must be a string');
+    }
+    const trimmed = name.normalize('NFC').trim().toLowerCase();
+    if (trimmed.length === 0) {
+        throw new InvalidNameError(name, 'empty');
+    }
+    const labels = trimmed.split('.');
+    for (const label of labels) {
+        validateLabel(name, label);
+    }
+    return labels.join('.');
+}
+const LABEL_RE = /^[a-z0-9-]+$/;
+function validateLabel(fullName, label) {
+    if (label.length === 0) {
+        throw new InvalidNameError(fullName, 'empty label (consecutive dots or leading/trailing dot)');
+    }
+    if (label.length > 63) {
+        throw new InvalidNameError(fullName, `label "${label}" exceeds 63 chars`);
+    }
+    if (label.startsWith('-')) {
+        throw new InvalidNameError(fullName, `label "${label}" starts with hyphen`);
+    }
+    if (label.endsWith('-')) {
+        throw new InvalidNameError(fullName, `label "${label}" ends with hyphen`);
+    }
+    if (!LABEL_RE.test(label)) {
+        throw new InvalidNameError(fullName, `label "${label}" contains characters outside [a-z 0-9 -]`);
+    }
+}
+/**
+ * Predicate variant — returns true / false instead of throwing.
+ * Useful for UI input validation.
+ */
+export function isValidAgentName(name) {
+    try {
+        normalizeAgentName(name);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,QAAQ,GAAG,cAAc,CAAC;AAEhC,SAAS,aAAa,CAAC,QAAgB,EAAE,KAAa;IACpD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,wDAAwD,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,UAAU,KAAK,oBAAoB,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,UAAU,KAAK,sBAAsB,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,UAAU,KAAK,oBAAoB,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,gBAAgB,CACxB,QAAQ,EACR,UAAU,KAAK,2CAA2C,CAC3D,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/records.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Predicate ids + typed record encoders/decoders for the on-chain
+ * ontology-backed resolver (ADR-0009 / NS Phase 3 pivot).
+ *
+ * Subpath: `@agenticprimitives/agent-naming/records`.
+ *
+ * The `AgentNameAttributeResolver` (packages/contracts/src/naming/) inherits
+ * `AttributeStorage` and validates every write against the
+ * `OntologyTermRegistry`. Predicate keys are `bytes32` ids
+ * (`keccak256("atl:displayName")` etc.), not strings; this module is
+ * the canonical TS mirror of those ids — kept in lockstep with
+ * `packages/contracts/src/naming/AgentNamePredicates.sol`.
+ *
+ * Datatype binding:
+ *   - `addr`, `custodyPolicy`                 → on-chain `address`
+ *   - `agentKind`, `metadataHash`,
+ *     `passkeyCredentialDigest`              → on-chain `bytes32`
+ *   - `displayName`, `a2aEndpoint`,
+ *     `mcpEndpoint`, `metadataUri`,
+ *     `nativeId`                              → on-chain `string`
+ *
+ * The encoder routes each predicate to its typed setter; the decoder
+ * routes each predicate to its typed getter. Unknown predicates are
+ * dropped on decode (fail-closed on read); encoders refuse unknown
+ * predicates (fail-loud on write).
+ */
+import { type Hex } from 'viem';
+import type { AgentKind, AgentNameRecords } from './types';
+export declare const PREDICATE_ID: {
+    readonly addr: `0x${string}`;
+    readonly agentKind: `0x${string}`;
+    readonly displayName: `0x${string}`;
+    readonly a2aEndpoint: `0x${string}`;
+    readonly mcpEndpoint: `0x${string}`;
+    readonly metadataUri: `0x${string}`;
+    readonly metadataHash: `0x${string}`;
+    readonly passkeyCredentialDigest: `0x${string}`;
+    readonly custodyPolicy: `0x${string}`;
+    readonly nativeId: `0x${string}`;
+};
+export type PredicateName = keyof typeof PREDICATE_ID;
+export declare const AGENT_KIND_ID: Record<AgentKind, Hex>;
+/** `keccak256("atl:AgentName")` — the ShapeRegistry class id. */
+export declare const CLASS_AGENT_NAME: Hex;
+/** `keccak256("atl:AgentKindEnum")` — the enum-set id bound to `atl:agentKind`. */
+export declare const AGENT_KIND_ENUM: Hex;
+/**
+ * Phase 1 CAIP-10 namespace allowlist for `nativeId`. Strict on
+ * encode (validate-at-write), permissive on decode (forward-compat).
+ */
+export declare const CAIP10_NAMESPACE_ALLOWLIST: ReadonlySet<string>;
+/**
+ * The shape of one encoded predicate write. The consumer (Phase 4 SDK
+ * client + demos) chooses the matching `setXxxAttribute` setter
+ * by the `datatype` discriminator.
+ */
+export type EncodedRecord = {
+    predicate: Hex;
+    datatype: 'string';
+    value: string;
+} | {
+    predicate: Hex;
+    datatype: 'address';
+    value: `0x${string}`;
+} | {
+    predicate: Hex;
+    datatype: 'bytes32';
+    value: Hex;
+};
+/**
+ * Encode the typed `AgentNameRecords` bundle into per-predicate
+ * encoded-call args. Caller dispatches each to the resolver's typed
+ * `setXxxAttribute(node, predicate, value)` setter.
+ */
+export declare function encodeRecords(records: AgentNameRecords): EncodedRecord[];
+/**
+ * The shape of one decoded result the SDK reads from the resolver.
+ * The reader pre-fetches `(predicateId → typed value)` pairs via the
+ * three typed getter families on the universal resolver
+ * (`resolveString`, `resolveBytes32`, `resolveAddress`).
+ */
+export interface DecodeInput {
+    strings: Partial<Record<Hex, string>>;
+    addresses: Partial<Record<Hex, `0x${string}`>>;
+    bytes32s: Partial<Record<Hex, Hex>>;
+}
+export declare function decodeRecords(input: DecodeInput): AgentNameRecords;
+//# sourceMappingURL=records.d.ts.map

package/dist/records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../src/records.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAoB,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAa3D,eAAO,MAAM,YAAY;;;;;;;;;;;CAWf,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,YAAY,CAAC;AAItD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,GAAG,CAIhD,CAAC;AAUF,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,EAAE,GAA8B,CAAC;AAC9D,mFAAmF;AACnF,eAAO,MAAM,eAAe,EAAE,GAAkC,CAAC;AAIjE;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,CAIzD,CAAC;AAMH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,SAAS,EAAE,GAAG,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,SAAS,EAAE,GAAG,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,KAAK,MAAM,EAAE,CAAA;CAAE,GAC7D;IAAE,SAAS,EAAE,GAAG,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAiCxE;AAID;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAG,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IACvC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/C,QAAQ,EAAG,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;CACtC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,CA0BlE"}