@agenticprimitives/agent-relationships 0.1.0-alpha.2

package/dist/client.js

@@ -0,0 +1,227 @@
+import { createPublicClient, http } from 'viem';
+import { agentRelationshipAbi } from './abis';
+import { buildAddRoleCall, buildConfirmEdgeCall, buildProposeEdgeCall, buildRemoveRoleCall, buildRevokeEdgeCall, } from './calls';
+import { computeEdgeId } from './edge-id';
+import { UnknownRelationshipTypeError } from './errors';
+const ZERO = '0x0000000000000000000000000000000000000000';
+const ZERO_NODE = '0x0000000000000000000000000000000000000000000000000000000000000000';
+export class AgentRelationshipsClient {
+    opts;
+    publicClient;
+    relationships;
+    constructor(opts) {
+        this.opts = opts;
+        if (!opts.rpcUrl)
+            throw new Error('[agent-relationships] rpcUrl required');
+        if (typeof opts.chainId !== 'number') {
+            throw new Error('[agent-relationships] chainId required');
+        }
+        if (!opts.relationships) {
+            throw new Error('[agent-relationships] relationships address required');
+        }
+        this.publicClient = createPublicClient({ transport: http(opts.rpcUrl) });
+        this.relationships = opts.relationships;
+    }
+    // ─── Reads (Phase 2 — live) ─────────────────────────────────────
+    /** Fetch a single edge by ID. Returns `null` when no such edge. */
+    async getEdge(edgeId) {
+        if (edgeId === ZERO_NODE)
+            return null;
+        const exists = await this.publicClient.readContract({
+            address: this.relationships,
+            abi: agentRelationshipAbi,
+            functionName: 'edgeExists',
+            args: [edgeId],
+        });
+        if (!exists)
+            return null;
+        const tuple = await this.publicClient.readContract({
+            address: this.relationships,
+            abi: agentRelationshipAbi,
+            functionName: 'getEdge',
+            args: [edgeId],
+        });
+        const roles = await this.publicClient.readContract({
+            address: this.relationships,
+            abi: agentRelationshipAbi,
+            functionName: 'getRoles',
+            args: [edgeId],
+        });
+        return _toEdge(tuple, roles);
+    }
+    /**
+     * List edges where `subject` appears on the subject side. Optional
+     * client-side filter by `relationshipType` and/or `status`.
+     *
+     * Order is contract-insertion order. Each edge is fetched in
+     * parallel via getEdge.
+     */
+    async listEdgesFor(subject, filter) {
+        const ids = await this.publicClient.readContract({
+            address: this.relationships,
+            abi: agentRelationshipAbi,
+            functionName: 'getEdgesBySubject',
+            args: [subject],
+        });
+        const edges = (await Promise.all(ids.map((id) => this.getEdge(id)))).filter((e) => e !== null);
+        return edges.filter((e) => {
+            if (filter?.relationshipType && e.relationshipType !== filter.relationshipType)
+                return false;
+            if (filter?.status !== undefined && e.status !== filter.status)
+                return false;
+            return true;
+        });
+    }
+    /** Same as `listEdgesFor` but on the object side. */
+    async listEdgesPointingAt(object, filter) {
+        const ids = await this.publicClient.readContract({
+            address: this.relationships,
+            abi: agentRelationshipAbi,
+            functionName: 'getEdgesByObject',
+            args: [object],
+        });
+        const edges = (await Promise.all(ids.map((id) => this.getEdge(id)))).filter((e) => e !== null);
+        return edges.filter((e) => {
+            if (filter?.relationshipType && e.relationshipType !== filter.relationshipType)
+                return false;
+            if (filter?.status !== undefined && e.status !== filter.status)
+                return false;
+            return true;
+        });
+    }
+    // ─── Writes (Phase 4 — live) ─────────────────────────────────────
+    /**
+     * Propose a new edge. The walletClient's account MUST equal
+     * `input.subject` — the contract enforces `msg.sender == subject`.
+     * Returns the propose tx hash. The edgeId can be computed
+     * off-chain via `computeEdgeId(subject, object, relationshipType)`
+     * (matches the on-chain `keccak256(abi.encodePacked(...))`
+     * derivation).
+     *
+     * For PSA-controlled proposals (subject is a Smart Agent gated by
+     * CustodyPolicy), use `buildProposeEdgeCall` directly and compose
+     * into your AgentAccount.execute / CustodyPolicy ceremony.
+     */
+    async proposeEdge(input, ctx) {
+        const call = buildProposeEdgeCall({
+            relationships: this.relationships,
+            subject: input.subject,
+            object: input.object,
+            relationshipType: input.relationshipType,
+            initialRoles: input.subjectRoles,
+            metadataURI: input.metadataUri,
+            metadataHash: input.metadataHash,
+        });
+        return await this._submit(ctx, call);
+    }
+    /**
+     * Confirm a PROPOSED edge. The walletClient's account MUST equal
+     * the object side (msg.sender == object on chain).
+     */
+    async confirmEdge(input, ctx) {
+        const call = buildConfirmEdgeCall({ relationships: this.relationships, edgeId: input.edgeId });
+        return await this._submit(ctx, call);
+    }
+    /**
+     * Revoke an edge. Either party may revoke unilaterally (contract
+     * checks `msg.sender == subject || msg.sender == object`).
+     */
+    async revokeEdge(input, ctx) {
+        const call = buildRevokeEdgeCall({ relationships: this.relationships, edgeId: input.edgeId });
+        return await this._submit(ctx, call);
+    }
+    /**
+     * Add / remove roles on an existing edge. Either party may modify
+     * the edge's role bag.
+     *
+     * Note: the on-chain `Edge` has a single role bag (no subject/object
+     * separation in storage); `SetRolesInput.subjectRoles` +
+     * `objectRoles` are coalesced into the same bag. The current set
+     * is computed via `getRoles(edgeId)` and the diff is submitted as
+     * N add / remove txs.
+     */
+    async setRoles(input, ctx) {
+        const desiredArr = [
+            ...(input.subjectRoles ?? []),
+            ...(input.objectRoles ?? []),
+        ];
+        const current = await this.publicClient.readContract({
+            address: this.relationships,
+            abi: agentRelationshipAbi,
+            functionName: 'getRoles',
+            args: [input.edgeId],
+        });
+        const desired = new Set(desiredArr.map((r) => r.toLowerCase()));
+        const existing = new Set([...current].map((r) => r.toLowerCase()));
+        const toAdd = desiredArr.filter((r) => !existing.has(r.toLowerCase()));
+        const toRemove = [...current].filter((r) => !desired.has(r.toLowerCase()));
+        const hashes = [];
+        for (const role of toAdd) {
+            hashes.push(await this._submit(ctx, buildAddRoleCall({ relationships: this.relationships, edgeId: input.edgeId, role: role })));
+        }
+        for (const role of toRemove) {
+            hashes.push(await this._submit(ctx, buildRemoveRoleCall({ relationships: this.relationships, edgeId: input.edgeId, role: role })));
+        }
+        return hashes;
+    }
+    /**
+     * Submit a single ContractCall via the bound walletClient. Uses
+     * explicit nonce fetch + retry on "replacement underpriced" to
+     * tolerate Base Sepolia's read-after-write lag.
+     */
+    async _submit(ctx, call) {
+        const { walletClient } = ctx;
+        const account = walletClient.account;
+        if (!account)
+            throw new Error('[agent-relationships] walletClient has no account');
+        let lastErr;
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                const nonce = await this.publicClient.getTransactionCount({
+                    address: account.address,
+                    blockTag: 'pending',
+                });
+                const hash = await walletClient.sendTransaction({
+                    to: call.to,
+                    value: call.value,
+                    data: call.data,
+                    nonce,
+                    account: walletClient.account,
+                    chain: walletClient.chain ?? null,
+                });
+                await this.publicClient.waitForTransactionReceipt({ hash });
+                return hash;
+            }
+            catch (err) {
+                lastErr = err;
+                const msg = err.message ?? '';
+                if (msg.includes('replacement') || msg.includes('underpriced')) {
+                    await new Promise((r) => setTimeout(r, 2000));
+                    continue;
+                }
+                throw err;
+            }
+        }
+        throw lastErr instanceof Error ? lastErr : new Error('[agent-relationships] _submit: exceeded retries');
+    }
+}
+/** Re-export for callers that want to compute edge IDs off-chain. */
+export { computeEdgeId };
+function _toEdge(t, roles) {
+    if (t.subject === ZERO || t.object_ === ZERO) {
+        throw new UnknownRelationshipTypeError(t.relationshipType);
+    }
+    return {
+        edgeId: t.edgeId,
+        subject: t.subject,
+        object: t.object_,
+        relationshipType: t.relationshipType,
+        subjectRoles: [...roles],
+        objectRoles: [],
+        status: t.status,
+        metadataUri: t.metadataURI || undefined,
+        metadataHash: t.metadataHash === ZERO_NODE ? undefined : t.metadataHash,
+        createdAt: Number(t.createdAt),
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Derive a bytes32 ID for a relationship-type name. We hash the raw
+ * UTF-8 bytes (matches Solidity `keccak256(bytes(name))`).
+ * Done at module load so the constants are static `0x...` strings.
+ */
+export declare function hashRelationshipType(name: string): `0x${string}`;
+/**
+ * Derive a bytes32 ID for a role name. Same convention as
+ * `hashRelationshipType` — distinct helper so call sites read clearly.
+ */
+export declare function hashRole(name: string): `0x${string}`;
+/**
+ * Well-known relationship types. Values are `keccak256(name)` —
+ * deterministic across deployments, so the off-chain Edge IDs always
+ * match the on-chain ones.
+ *
+ * IMPORTANT (ADR-0006): `NAMESPACE_CONTAINS` is intentionally absent.
+ * Naming hierarchy lives in agent-naming via a parent-pointer, NOT
+ * via a relationships-edge.
+ */
+export declare const RELATIONSHIP_TYPE: {
+    /** Membership: subject is a member of object (org / DAO / collective). */
+    readonly HAS_MEMBER: `0x${string}`;
+    /** Governance: subject has governance authority over object. */
+    readonly HAS_GOVERNANCE_OVER: `0x${string}`;
+    /** Validation trust: subject trusts object as a validator / verifier. */
+    readonly VALIDATION_TRUST: `0x${string}`;
+    /** Bilateral partnership / cross-recognition. */
+    readonly PARTNERSHIP: `0x${string}`;
+    /** Marker that subject acts on behalf of object. */
+    readonly OPERATES_ON_BEHALF_OF: `0x${string}`;
+    /** Recommendation: subject endorses / recommends object. */
+    readonly RECOMMENDS: `0x${string}`;
+};
+/** Well-known role labels (bytes32-hashed). */
+export declare const ROLE: {
+    /** Generic member role. */
+    readonly MEMBER: `0x${string}`;
+    /** Board / governance member. */
+    readonly BOARD_MEMBER: `0x${string}`;
+    /** Operational executor. */
+    readonly OPERATOR: `0x${string}`;
+    /** Validator / verifier. */
+    readonly VALIDATOR: `0x${string}`;
+    /** Treasurer (holds the asset account). */
+    readonly TREASURER: `0x${string}`;
+    /** Recovery contact. */
+    readonly RECOVERY_CONTACT: `0x${string}`;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAEhE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAEpD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;IAC5B,0EAA0E;;IAE1E,gEAAgE;;IAEhE,yEAAyE;;IAEzE,iDAAiD;;IAEjD,oDAAoD;;IAEpD,4DAA4D;;CAEpD,CAAC;AAEX,+CAA+C;AAC/C,eAAO,MAAM,IAAI;IACf,2BAA2B;;IAE3B,iCAAiC;;IAEjC,4BAA4B;;IAE5B,4BAA4B;;IAE5B,2CAA2C;;IAE3C,wBAAwB;;CAEhB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,55 @@
+import { keccak256, toHex } from 'viem';
+/**
+ * Derive a bytes32 ID for a relationship-type name. We hash the raw
+ * UTF-8 bytes (matches Solidity `keccak256(bytes(name))`).
+ * Done at module load so the constants are static `0x...` strings.
+ */
+export function hashRelationshipType(name) {
+    return keccak256(toHex(name));
+}
+/**
+ * Derive a bytes32 ID for a role name. Same convention as
+ * `hashRelationshipType` — distinct helper so call sites read clearly.
+ */
+export function hashRole(name) {
+    return keccak256(toHex(name));
+}
+/**
+ * Well-known relationship types. Values are `keccak256(name)` —
+ * deterministic across deployments, so the off-chain Edge IDs always
+ * match the on-chain ones.
+ *
+ * IMPORTANT (ADR-0006): `NAMESPACE_CONTAINS` is intentionally absent.
+ * Naming hierarchy lives in agent-naming via a parent-pointer, NOT
+ * via a relationships-edge.
+ */
+export const RELATIONSHIP_TYPE = {
+    /** Membership: subject is a member of object (org / DAO / collective). */
+    HAS_MEMBER: hashRelationshipType('HAS_MEMBER'),
+    /** Governance: subject has governance authority over object. */
+    HAS_GOVERNANCE_OVER: hashRelationshipType('HAS_GOVERNANCE_OVER'),
+    /** Validation trust: subject trusts object as a validator / verifier. */
+    VALIDATION_TRUST: hashRelationshipType('VALIDATION_TRUST'),
+    /** Bilateral partnership / cross-recognition. */
+    PARTNERSHIP: hashRelationshipType('PARTNERSHIP'),
+    /** Marker that subject acts on behalf of object. */
+    OPERATES_ON_BEHALF_OF: hashRelationshipType('OPERATES_ON_BEHALF_OF'),
+    /** Recommendation: subject endorses / recommends object. */
+    RECOMMENDS: hashRelationshipType('RECOMMENDS'),
+};
+/** Well-known role labels (bytes32-hashed). */
+export const ROLE = {
+    /** Generic member role. */
+    MEMBER: hashRole('MEMBER'),
+    /** Board / governance member. */
+    BOARD_MEMBER: hashRole('BOARD_MEMBER'),
+    /** Operational executor. */
+    OPERATOR: hashRole('OPERATOR'),
+    /** Validator / verifier. */
+    VALIDATOR: hashRole('VALIDATOR'),
+    /** Treasurer (holds the asset account). */
+    TREASURER: hashRole('TREASURER'),
+    /** Recovery contact. */
+    RECOVERY_CONTACT: hashRole('RECOVERY_CONTACT'),
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAExC;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,0EAA0E;IAC1E,UAAU,EAAE,oBAAoB,CAAC,YAAY,CAAC;IAC9C,gEAAgE;IAChE,mBAAmB,EAAE,oBAAoB,CAAC,qBAAqB,CAAC;IAChE,yEAAyE;IACzE,gBAAgB,EAAE,oBAAoB,CAAC,kBAAkB,CAAC;IAC1D,iDAAiD;IACjD,WAAW,EAAE,oBAAoB,CAAC,aAAa,CAAC;IAChD,oDAAoD;IACpD,qBAAqB,EAAE,oBAAoB,CAAC,uBAAuB,CAAC;IACpE,4DAA4D;IAC5D,UAAU,EAAE,oBAAoB,CAAC,YAAY,CAAC;CACtC,CAAC;AAEX,+CAA+C;AAC/C,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,2BAA2B;IAC3B,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC1B,iCAAiC;IACjC,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC;IACtC,4BAA4B;IAC5B,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC;IAC9B,4BAA4B;IAC5B,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC;IAChC,2CAA2C;IAC3C,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC;IAChC,wBAAwB;IACxB,gBAAgB,EAAE,QAAQ,CAAC,kBAAkB,CAAC;CACtC,CAAC"}

package/dist/edge-id.d.ts

@@ -0,0 +1,15 @@
+import type { Address, Hex } from '@agenticprimitives/types';
+import type { RelationshipType } from './types';
+/**
+ * Deterministic edge-ID derivation. Matches the on-chain port that
+ * will land in `packages/contracts/src/relationships/AgentRelationship.sol`
+ * (Phase 3): `keccak256(abi.encodePacked(subject, object, relType))`.
+ *
+ * Solidity `address` is a 20-byte value with no casing — we lowercase
+ * each input so two callers using different casings (and the on-chain
+ * port) produce identical IDs. We deliberately do NOT route through
+ * `viem.getAddress`, which requires either all-lowercase OR a valid
+ * EIP-55 checksum and rejects all-uppercase.
+ */
+export declare function computeEdgeId(subject: Address, object: Address, relationshipType: RelationshipType): Hex;
+//# sourceMappingURL=edge-id.d.ts.map

package/dist/edge-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-id.d.ts","sourceRoot":"","sources":["../src/edge-id.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAKhD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,OAAO,EACf,gBAAgB,EAAE,gBAAgB,GACjC,GAAG,CAcL"}

package/dist/edge-id.js

@@ -0,0 +1,34 @@
+import { keccak256, concat } from 'viem';
+import { InvalidEdgeError } from './errors';
+const ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;
+/**
+ * Deterministic edge-ID derivation. Matches the on-chain port that
+ * will land in `packages/contracts/src/relationships/AgentRelationship.sol`
+ * (Phase 3): `keccak256(abi.encodePacked(subject, object, relType))`.
+ *
+ * Solidity `address` is a 20-byte value with no casing — we lowercase
+ * each input so two callers using different casings (and the on-chain
+ * port) produce identical IDs. We deliberately do NOT route through
+ * `viem.getAddress`, which requires either all-lowercase OR a valid
+ * EIP-55 checksum and rejects all-uppercase.
+ */
+export function computeEdgeId(subject, object, relationshipType) {
+    if (!subject)
+        throw new InvalidEdgeError('subject required', 'subject');
+    if (!object)
+        throw new InvalidEdgeError('object required', 'object');
+    if (!relationshipType) {
+        throw new InvalidEdgeError('relationshipType required', 'relationshipType');
+    }
+    if (!ADDRESS_RE.test(subject))
+        throw new InvalidEdgeError(`malformed subject ${subject}`, 'subject');
+    if (!ADDRESS_RE.test(object))
+        throw new InvalidEdgeError(`malformed object ${object}`, 'object');
+    if (subject.toLowerCase() === object.toLowerCase()) {
+        throw new InvalidEdgeError('subject and object must differ — self-edges not allowed');
+    }
+    const s = subject.toLowerCase();
+    const o = object.toLowerCase();
+    return keccak256(concat([s, o, relationshipType]));
+}
+//# sourceMappingURL=edge-id.js.map

package/dist/edge-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-id.js","sourceRoot":"","sources":["../src/edge-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,UAAU,GAAG,qBAAqB,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAgB,EAChB,MAAe,EACf,gBAAkC;IAElC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,gBAAgB,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;IACxE,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IACrE,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,IAAI,gBAAgB,CAAC,2BAA2B,EAAE,kBAAkB,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,gBAAgB,CAAC,qBAAqB,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACrG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,gBAAgB,CAAC,oBAAoB,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;IACjG,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,gBAAgB,CAAC,yDAAyD,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,EAAmB,CAAC;IACjD,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAmB,CAAC;IAChD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,15 @@
+export declare class InvalidEdgeError extends Error {
+    readonly reason: string;
+    readonly field?: string | undefined;
+    constructor(reason: string, field?: string | undefined);
+}
+export declare class UnauthorizedActorError extends Error {
+    readonly actor: string;
+    readonly action: string;
+    constructor(actor: string, action: string);
+}
+export declare class UnknownRelationshipTypeError extends Error {
+    readonly typeId: string;
+    constructor(typeId: string);
+}
+//# 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,MAAM,EAAE,MAAM;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM;gBAAvC,MAAM,EAAE,MAAM,EAAW,KAAK,CAAC,EAAE,MAAM,YAAA;CAO7D;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAtC,KAAK,EAAE,MAAM,EAAW,MAAM,EAAE,MAAM;CAI5D;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAIpC"}

package/dist/errors.js

@@ -0,0 +1,30 @@
+export class InvalidEdgeError extends Error {
+    reason;
+    field;
+    constructor(reason, field) {
+        super(`[agent-relationships] invalid edge: ${reason}` +
+            (field ? ` (field: ${field})` : ''));
+        this.reason = reason;
+        this.field = field;
+        this.name = 'InvalidEdgeError';
+    }
+}
+export class UnauthorizedActorError extends Error {
+    actor;
+    action;
+    constructor(actor, action) {
+        super(`[agent-relationships] actor ${actor} not authorized for ${action}`);
+        this.actor = actor;
+        this.action = action;
+        this.name = 'UnauthorizedActorError';
+    }
+}
+export class UnknownRelationshipTypeError extends Error {
+    typeId;
+    constructor(typeId) {
+        super(`[agent-relationships] unknown relationship type ${typeId}`);
+        this.typeId = typeId;
+        this.name = 'UnknownRelationshipTypeError';
+    }
+}
+//# 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;IAAyB;IAA9C,YAAqB,MAAc,EAAW,KAAc;QAC1D,KAAK,CACH,uCAAuC,MAAM,EAAE;YAC7C,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACtC,CAAC;QAJiB,WAAM,GAAN,MAAM,CAAQ;QAAW,UAAK,GAAL,KAAK,CAAS;QAK1D,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC1B;IAAwB;IAA7C,YAAqB,KAAa,EAAW,MAAc;QACzD,KAAK,CAAC,+BAA+B,KAAK,uBAAuB,MAAM,EAAE,CAAC,CAAC;QADxD,UAAK,GAAL,KAAK,CAAQ;QAAW,WAAM,GAAN,MAAM,CAAQ;QAEzD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAChC;IAArB,YAAqB,MAAc;QACjC,KAAK,CAAC,mDAAmD,MAAM,EAAE,CAAC,CAAC;QADhD,WAAM,GAAN,MAAM,CAAQ;QAEjC,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { RELATIONSHIP_TYPE, ROLE, hashRelationshipType, hashRole, } from './constants';
+export { computeEdgeId } from './edge-id';
+export { TYPE_SEMANTICS, type RelationshipTypeSemantics, } from './taxonomy';
+export { InvalidEdgeError, UnauthorizedActorError, UnknownRelationshipTypeError, } from './errors';
+export { EdgeStatus, type RelationshipType, type Role, type Edge, type ProposeEdgeInput, type ConfirmEdgeInput, type RevokeEdgeInput, type SetRolesInput, type AgentRelationshipsClientOpts, } from './types';
+export { AgentRelationshipsClient, type WriteContext } from './client';
+export { agentRelationshipAbi, relationshipTypeRegistryAbi, } from './abis';
+export { buildProposeEdgeCall, buildConfirmEdgeCall, buildActivateEdgeCall, buildRevokeEdgeCall, buildAddRoleCall, buildRemoveRoleCall, buildSetMetadataCall, type ContractCall, } from './calls';
+//# 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":"AAQA,OAAO,EACL,iBAAiB,EACjB,IAAI,EACJ,oBAAoB,EACpB,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EACL,cAAc,EACd,KAAK,yBAAyB,GAC/B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,IAAI,EACT,KAAK,IAAI,EACT,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,4BAA4B,GAClC,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,wBAAwB,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAIvE,OAAO,EACL,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,QAAQ,CAAC;AAIhB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+// @agenticprimitives/agent-relationships — public API.
+//
+// See:
+//   - capability.manifest.json — boundary
+//   - CLAUDE.md — doctrine
+//   - specs/216-agent-relationships.md — the contract
+//   - docs/architecture/decisions/0007-agent-identity-stack-three-packages.md
+export { RELATIONSHIP_TYPE, ROLE, hashRelationshipType, hashRole, } from './constants';
+export { computeEdgeId } from './edge-id';
+export { TYPE_SEMANTICS, } from './taxonomy';
+export { InvalidEdgeError, UnauthorizedActorError, UnknownRelationshipTypeError, } from './errors';
+export { EdgeStatus, } from './types';
+export { AgentRelationshipsClient } from './client';
+// Phase 3 contract ABIs (live at deployed addresses recorded in
+// packages/contracts/deployments-<network>.json).
+export { agentRelationshipAbi, relationshipTypeRegistryAbi, } from './abis';
+// Phase 4 pure call builders. Compose into AgentAccount.execute /
+// CustodyPolicy ceremonies / ERC-4337 UserOps as needed.
+export { buildProposeEdgeCall, buildConfirmEdgeCall, buildActivateEdgeCall, buildRevokeEdgeCall, buildAddRoleCall, buildRemoveRoleCall, buildSetMetadataCall, } from './calls';
+//# 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,uDAAuD;AACvD,EAAE;AACF,OAAO;AACP,0CAA0C;AAC1C,2BAA2B;AAC3B,sDAAsD;AACtD,8EAA8E;AAE9E,OAAO,EACL,iBAAiB,EACjB,IAAI,EACJ,oBAAoB,EACpB,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EACL,cAAc,GAEf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,UAAU,GASX,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,wBAAwB,EAAqB,MAAM,UAAU,CAAC;AAEvE,gEAAgE;AAChE,kDAAkD;AAClD,OAAO,EACL,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,QAAQ,CAAC;AAEhB,kEAAkE;AAClE,yDAAyD;AACzD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GAErB,MAAM,SAAS,CAAC"}

package/dist/taxonomy.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Relationship-type taxonomy + semantics map.
+ *
+ * Subpath: `@agenticprimitives/agent-relationships/taxonomy`.
+ *
+ * Each entry describes the structural properties downstream resolvers
+ * need to know to traverse the edge graph correctly:
+ *
+ * - `hierarchical` — induces parent/child semantics (e.g. governance).
+ * - `transitive`   — `(A→B) ∧ (B→C) ⇒ (A→C)` for the purposes of
+ *                    membership inference. Use with caution.
+ * - `symmetric`    — bidirectional by definition (e.g. PARTNERSHIP);
+ *                    a single PROPOSED side activates the edge.
+ *
+ * These flags are descriptive (off-chain logic acts on them); the
+ * on-chain contract (Phase 3) enforces the two-side-confirmation
+ * rule independently for non-symmetric types.
+ */
+import { RELATIONSHIP_TYPE, ROLE, hashRelationshipType, hashRole } from './constants';
+import type { Hex } from '@agenticprimitives/types';
+export { RELATIONSHIP_TYPE, ROLE, hashRelationshipType, hashRole };
+export interface RelationshipTypeSemantics {
+    /** Canonical name (the pre-image of the bytes32 type ID). */
+    name: string;
+    /** Whether traversal induces a parent/child relationship. */
+    hierarchical: boolean;
+    /** Whether membership inference is transitive across this edge. */
+    transitive: boolean;
+    /** Whether the edge is bidirectional by definition. */
+    symmetric: boolean;
+    /** One-line documentation string. */
+    description: string;
+}
+export declare const TYPE_SEMANTICS: Readonly<Record<Hex, RelationshipTypeSemantics>>;
+//# sourceMappingURL=taxonomy.d.ts.map

package/dist/taxonomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy.d.ts","sourceRoot":"","sources":["../src/taxonomy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC;AAEnE,MAAM,WAAW,yBAAyB;IACxC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,YAAY,EAAE,OAAO,CAAC;IACtB,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,yBAAyB,CAAC,CA2C1E,CAAC"}

package/dist/taxonomy.js

@@ -0,0 +1,65 @@
+/**
+ * Relationship-type taxonomy + semantics map.
+ *
+ * Subpath: `@agenticprimitives/agent-relationships/taxonomy`.
+ *
+ * Each entry describes the structural properties downstream resolvers
+ * need to know to traverse the edge graph correctly:
+ *
+ * - `hierarchical` — induces parent/child semantics (e.g. governance).
+ * - `transitive`   — `(A→B) ∧ (B→C) ⇒ (A→C)` for the purposes of
+ *                    membership inference. Use with caution.
+ * - `symmetric`    — bidirectional by definition (e.g. PARTNERSHIP);
+ *                    a single PROPOSED side activates the edge.
+ *
+ * These flags are descriptive (off-chain logic acts on them); the
+ * on-chain contract (Phase 3) enforces the two-side-confirmation
+ * rule independently for non-symmetric types.
+ */
+import { RELATIONSHIP_TYPE, ROLE, hashRelationshipType, hashRole } from './constants';
+export { RELATIONSHIP_TYPE, ROLE, hashRelationshipType, hashRole };
+export const TYPE_SEMANTICS = Object.freeze({
+    [RELATIONSHIP_TYPE.HAS_MEMBER]: {
+        name: 'HAS_MEMBER',
+        hierarchical: false,
+        transitive: false,
+        symmetric: false,
+        description: 'Subject is a member of object (org / DAO / collective).',
+    },
+    [RELATIONSHIP_TYPE.HAS_GOVERNANCE_OVER]: {
+        name: 'HAS_GOVERNANCE_OVER',
+        hierarchical: true,
+        transitive: false,
+        symmetric: false,
+        description: 'Subject has governance authority over object.',
+    },
+    [RELATIONSHIP_TYPE.VALIDATION_TRUST]: {
+        name: 'VALIDATION_TRUST',
+        hierarchical: false,
+        transitive: false,
+        symmetric: false,
+        description: 'Subject trusts object as a validator / verifier.',
+    },
+    [RELATIONSHIP_TYPE.PARTNERSHIP]: {
+        name: 'PARTNERSHIP',
+        hierarchical: false,
+        transitive: false,
+        symmetric: true,
+        description: 'Bilateral partnership / cross-recognition.',
+    },
+    [RELATIONSHIP_TYPE.OPERATES_ON_BEHALF_OF]: {
+        name: 'OPERATES_ON_BEHALF_OF',
+        hierarchical: false,
+        transitive: false,
+        symmetric: false,
+        description: 'Subject operates on behalf of object (delegated operational authority marker).',
+    },
+    [RELATIONSHIP_TYPE.RECOMMENDS]: {
+        name: 'RECOMMENDS',
+        hierarchical: false,
+        transitive: false,
+        symmetric: false,
+        description: 'Subject endorses / recommends object.',
+    },
+});
+//# sourceMappingURL=taxonomy.js.map

package/dist/taxonomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy.js","sourceRoot":"","sources":["../src/taxonomy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGtF,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC;AAenE,MAAM,CAAC,MAAM,cAAc,GAAqD,MAAM,CAAC,MAAM,CAAC;IAC5F,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE;QAC9B,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,yDAAyD;KACvE;IACD,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,EAAE;QACvC,IAAI,EAAE,qBAAqB;QAC3B,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,+CAA+C;KAC7D;IACD,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,EAAE;QACpC,IAAI,EAAE,kBAAkB;QACxB,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,kDAAkD;KAChE;IACD,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE;QAC/B,IAAI,EAAE,aAAa;QACnB,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,4CAA4C;KAC1D;IACD,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,EAAE;QACzC,IAAI,EAAE,uBAAuB;QAC7B,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,gFAAgF;KAC9F;IACD,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE;QAC9B,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,uCAAuC;KACrD;CACF,CAAC,CAAC"}