@agenticprimitives/agent-relationships 0.1.0-alpha.2

package/dist/types.d.ts

@@ -0,0 +1,96 @@
+import type { Address, Hex } from '@agenticprimitives/types';
+/**
+ * Branded bytes32 — the keccak256 hash of a relationship-type name
+ * (e.g. `HAS_MEMBER`). Use the `RELATIONSHIP_TYPE` constants in
+ * `src/constants.ts` rather than constructing literals.
+ */
+export type RelationshipType = Hex & {
+    readonly __brand: 'relationshipType';
+};
+/**
+ * Branded bytes32 — the keccak256 hash of a role name (e.g. `MEMBER`).
+ * Use the `ROLE` constants rather than constructing literals.
+ */
+export type Role = Hex & {
+    readonly __brand: 'role';
+};
+/**
+ * Edge lifecycle. Spec § 4:
+ *   PROPOSED → CONFIRMED → ACTIVE → REVOKED.
+ *
+ * - `PROPOSED` — one side has expressed intent. Has NO authority effect.
+ * - `CONFIRMED` — both sides have signed (or single-side for symmetric
+ *   types). Authority effects in force.
+ * - `ACTIVE` — alias for CONFIRMED, set when contract-level activation
+ *   conditions are met (e.g. timelock elapsed for governance edges).
+ * - `REVOKED` — terminated by either side. Authority effects removed.
+ *
+ * Numeric values match the on-chain enum (Phase 3 port).
+ */
+export declare enum EdgeStatus {
+    /** Sentinel — never assigned to a real edge. Matches Solidity enum index 0. */
+    NONE = 0,
+    PROPOSED = 1,
+    CONFIRMED = 2,
+    ACTIVE = 3,
+    REVOKED = 4
+}
+/**
+ * The trust-fabric edge primitive. An edge is uniquely identified by
+ * `(subject, object, relationshipType)`; same triple → same `edgeId`.
+ * This invariant prevents duplicate edges and enables idempotent
+ * propose-edge writes.
+ */
+export interface Edge {
+    /** Deterministic ID: `keccak256(subject || object || relationshipType)`. */
+    edgeId: Hex;
+    /** Subject Smart Agent (the "from" side). */
+    subject: Address;
+    /** Object Smart Agent (the "to" side). */
+    object: Address;
+    /** Hashed relationship type. */
+    relationshipType: RelationshipType;
+    /** Role bytes32 hashes attached to the subject side. */
+    subjectRoles: Role[];
+    /** Role bytes32 hashes attached to the object side. */
+    objectRoles: Role[];
+    /** Lifecycle status. */
+    status: EdgeStatus;
+    /** Optional metadata URI (off-chain JSON; same content-hash discipline as agent-profile). */
+    metadataUri?: string;
+    /** keccak256 of canonical metadata JSON (if `metadataUri` set). */
+    metadataHash?: Hex;
+    /** Unix-seconds timestamp the edge first entered PROPOSED. */
+    createdAt: number;
+}
+export interface ProposeEdgeInput {
+    subject: Address;
+    object: Address;
+    relationshipType: RelationshipType;
+    subjectRoles?: Role[];
+    objectRoles?: Role[];
+    metadataUri?: string;
+    metadataHash?: Hex;
+}
+export interface ConfirmEdgeInput {
+    edgeId: Hex;
+    /** Role set the confirming side attaches to its own side. */
+    selfRoles?: Role[];
+}
+export interface RevokeEdgeInput {
+    edgeId: Hex;
+    /** Optional revocation reason (off-chain — not enforced on-chain). */
+    reason?: string;
+}
+export interface SetRolesInput {
+    edgeId: Hex;
+    /** Set the subject-side role bag (the caller MUST be the subject). */
+    subjectRoles?: Role[];
+    /** Set the object-side role bag (the caller MUST be the object). */
+    objectRoles?: Role[];
+}
+export interface AgentRelationshipsClientOpts {
+    rpcUrl: string;
+    chainId: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,GAAG,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG,GAAG,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,oBAAY,UAAU;IACpB,+EAA+E;IAC/E,IAAI,IAAI;IACR,QAAQ,IAAI;IACZ,SAAS,IAAI;IACb,MAAM,IAAI;IACV,OAAO,IAAI;CACZ;AAED;;;;;GAKG;AACH,MAAM,WAAW,IAAI;IACnB,4EAA4E;IAC5E,MAAM,EAAE,GAAG,CAAC;IACZ,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,wDAAwD;IACxD,YAAY,EAAE,IAAI,EAAE,CAAC;IACrB,uDAAuD;IACvD,WAAW,EAAE,IAAI,EAAE,CAAC;IACpB,wBAAwB;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,GAAG,CAAC;IACZ,6DAA6D;IAC7D,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,GAAG,CAAC;IACZ,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,GAAG,CAAC;IACZ,sEAAsE;IACtE,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC;IACtB,oEAAoE;IACpE,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,23 @@
+/**
+ * Edge lifecycle. Spec § 4:
+ *   PROPOSED → CONFIRMED → ACTIVE → REVOKED.
+ *
+ * - `PROPOSED` — one side has expressed intent. Has NO authority effect.
+ * - `CONFIRMED` — both sides have signed (or single-side for symmetric
+ *   types). Authority effects in force.
+ * - `ACTIVE` — alias for CONFIRMED, set when contract-level activation
+ *   conditions are met (e.g. timelock elapsed for governance edges).
+ * - `REVOKED` — terminated by either side. Authority effects removed.
+ *
+ * Numeric values match the on-chain enum (Phase 3 port).
+ */
+export var EdgeStatus;
+(function (EdgeStatus) {
+    /** Sentinel — never assigned to a real edge. Matches Solidity enum index 0. */
+    EdgeStatus[EdgeStatus["NONE"] = 0] = "NONE";
+    EdgeStatus[EdgeStatus["PROPOSED"] = 1] = "PROPOSED";
+    EdgeStatus[EdgeStatus["CONFIRMED"] = 2] = "CONFIRMED";
+    EdgeStatus[EdgeStatus["ACTIVE"] = 3] = "ACTIVE";
+    EdgeStatus[EdgeStatus["REVOKED"] = 4] = "REVOKED";
+})(EdgeStatus || (EdgeStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAN,IAAY,UAOX;AAPD,WAAY,UAAU;IACpB,+EAA+E;IAC/E,2CAAQ,CAAA;IACR,mDAAY,CAAA;IACZ,qDAAa,CAAA;IACb,+CAAU,CAAA;IACV,iDAAW,CAAA;AACb,CAAC,EAPW,UAAU,KAAV,UAAU,QAOrB"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@agenticprimitives/agent-relationships",
+  "version": "0.1.0-alpha.2",
+  "description": "Agent relationships SDK: trust-fabric edge store (subject, object, relationshipType) with role taxonomy. Phase 1 ships edge-ID derivation + relationship-type constants + client skeleton; AgentRelationship.sol + RelationshipTypeRegistry.sol ports land in Phase 3. AgentAssertion + AgentRelationshipResolver deferred to v2.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentictrustlabs/agenticprimitives.git",
+    "directory": "packages/agent-relationships"
+  },
+  "homepage": "https://github.com/agentictrustlabs/agenticprimitives/tree/master/packages/agent-relationships",
+  "bugs": {
+    "url": "https://github.com/agentictrustlabs/agenticprimitives/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./taxonomy": {
+      "types": "./dist/taxonomy.d.ts",
+      "import": "./dist/taxonomy.js"
+    }
+  },
+  "files": [
+    "LICENSE",
+    "dist",
+    "spec.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@agenticprimitives/agent-account": "workspace:*",
+    "@agenticprimitives/connect-auth": "workspace:*",
+    "@agenticprimitives/types": "workspace:*",
+    "viem": "^2.50.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.0",
+    "vitest": "^2.1.0"
+  },
+  "keywords": [
+    "agent",
+    "relationships",
+    "trust-fabric",
+    "edges",
+    "roles",
+    "agentic"
+  ]
+}

package/spec.md

@@ -0,0 +1,13 @@
+# @agenticprimitives/agent-relationships — spec
+
+The full design lives in [`../../specs/216-agent-relationships.md`](../../specs/216-agent-relationships.md).
+
+Architecture decisions:
+
+- [ADR-0006](../../docs/architecture/decisions/0006-agent-naming-as-resolution-layer.md)
+  — why naming hierarchy is parent-pointer-based, NOT a
+  `NAMESPACE_CONTAINS` edge.
+- [ADR-0007](../../docs/architecture/decisions/0007-agent-identity-stack-three-packages.md)
+  — why the identity stack is three packages, not one.
+
+Do not edit a divergent copy here — edit the canonical spec.