@agnt-id/agent0 0.1.0

package/dist/bridge.d.ts

@@ -0,0 +1,34 @@
+import type { Agent0RegistrationFile, AgntIdentityLink, AgntNameLike, AgntRecordLike, ToRegistrationFileOptions } from "./types.js";
+/**
+ * Parse an .agnt identity string into its components.
+ *
+ * The identity field is a CAIP-10-like string with an appended agent ID:
+ *   "eip155:1:0xRegistryAddress:42"
+ *
+ * @returns Parsed identity link, or null if the format is invalid
+ */
+export declare function parseIdentityLink(identity: string): AgntIdentityLink | null;
+/**
+ * Format an identity link back to the CAIP-style string.
+ */
+export declare function formatIdentityLink(link: AgntIdentityLink): string;
+/**
+ * Convert a resolved .agnt name to an ERC-8004 Agent Registration File.
+ *
+ * This produces the JSON structure that would be hosted at an agentURI
+ * for on-chain agent discovery via the ERC-8004 standard.
+ */
+export declare function toRegistrationFile(agnt: AgntNameLike, options?: ToRegistrationFileOptions): Agent0RegistrationFile;
+/**
+ * Convert an ERC-8004 registration file back to .agnt record fields.
+ * Useful for importing Agent0 agents into the .agnt naming system.
+ */
+export declare function fromRegistrationFile(file: Agent0RegistrationFile): AgntRecordLike;
+/**
+ * Resolve a .agnt name and return its ERC-8004 registration file.
+ * Requires @agnt-id/resolve to be installed.
+ */
+export declare function fromAgnt(name: string, options?: ToRegistrationFileOptions & {
+    gateway?: string;
+    chainId?: string;
+}): Promise<Agent0RegistrationFile | null>;

package/dist/bridge.js

@@ -0,0 +1,163 @@
+/**
+ * Parse an .agnt identity string into its components.
+ *
+ * The identity field is a CAIP-10-like string with an appended agent ID:
+ *   "eip155:1:0xRegistryAddress:42"
+ *
+ * @returns Parsed identity link, or null if the format is invalid
+ */
+export function parseIdentityLink(identity) {
+    // Expected format: namespace:chainRef:registryAddress:agentId
+    const parts = identity.split(":");
+    if (parts.length < 4)
+        return null;
+    const namespace = parts[0];
+    const chainRef = parts[1];
+    const registry = parts[2];
+    const agentIdStr = parts[3];
+    const agentId = Number(agentIdStr);
+    if (!Number.isFinite(agentId) || agentId < 0)
+        return null;
+    return {
+        chainId: `${namespace}:${chainRef}`,
+        registry,
+        agentId,
+    };
+}
+/**
+ * Format an identity link back to the CAIP-style string.
+ */
+export function formatIdentityLink(link) {
+    return `${link.chainId}:${link.registry}:${link.agentId}`;
+}
+/**
+ * Convert a resolved .agnt name to an ERC-8004 Agent Registration File.
+ *
+ * This produces the JSON structure that would be hosted at an agentURI
+ * for on-chain agent discovery via the ERC-8004 standard.
+ */
+export function toRegistrationFile(agnt, options = {}) {
+    const rec = agnt.records;
+    const description = rec.texts?.description ?? `AI agent registered as ${agnt.name}`;
+    const image = options.image ?? rec.texts?.avatar;
+    // Build services from .agnt record endpoints
+    const services = [];
+    if (rec.a2a) {
+        services.push({
+            name: "a2a",
+            endpoint: rec.a2a,
+            version: rec.a2aVersion,
+            skills: rec.skills,
+            domains: rec.domains,
+        });
+    }
+    if (rec.mcp) {
+        services.push({
+            name: "mcp",
+            endpoint: rec.mcp,
+            version: rec.mcpVersion,
+            skills: rec.skills,
+            domains: rec.domains,
+        });
+    }
+    if (options.extraServices) {
+        services.push(...options.extraServices);
+    }
+    // Build registrations from identity link
+    const registrations = [];
+    if (rec.identity) {
+        const link = parseIdentityLink(rec.identity);
+        if (link) {
+            registrations.push({
+                agentId: link.agentId,
+                agentRegistry: `${link.chainId}:${link.registry}`,
+            });
+        }
+    }
+    if (options.extraRegistrations) {
+        registrations.push(...options.extraRegistrations);
+    }
+    // Map .agnt trustModels to ERC-8004 supportedTrust
+    const supportedTrust = (rec.trustModels ?? []).filter((t) => [
+        "reputation",
+        "crypto-economic",
+        "tee-attestation",
+        "social-graph",
+    ].includes(t));
+    const file = {
+        type: "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
+        name: agnt.name,
+        description,
+        services,
+        registrations,
+        active: options.active ?? true,
+        x402Support: rec.x402Support,
+    };
+    if (image)
+        file.image = image;
+    if (supportedTrust.length > 0) {
+        file.supportedTrust =
+            supportedTrust;
+    }
+    return file;
+}
+/**
+ * Convert an ERC-8004 registration file back to .agnt record fields.
+ * Useful for importing Agent0 agents into the .agnt naming system.
+ */
+export function fromRegistrationFile(file) {
+    const rec = {};
+    // Extract A2A and MCP services
+    for (const svc of file.services) {
+        if (svc.name === "a2a") {
+            rec.a2a = svc.endpoint;
+            if (svc.version)
+                rec.a2aVersion = svc.version;
+            if (svc.skills?.length)
+                rec.skills = svc.skills;
+            if (svc.domains?.length)
+                rec.domains = svc.domains;
+        }
+        else if (svc.name === "mcp") {
+            rec.mcp = svc.endpoint;
+            if (svc.version)
+                rec.mcpVersion = svc.version;
+            if (!rec.skills && svc.skills?.length)
+                rec.skills = svc.skills;
+            if (!rec.domains && svc.domains?.length)
+                rec.domains = svc.domains;
+        }
+    }
+    // Map first registration to identity link
+    if (file.registrations.length > 0) {
+        const reg = file.registrations[0];
+        rec.identity = `${reg.agentRegistry}:${reg.agentId}`;
+    }
+    // Map trust models
+    if (file.supportedTrust?.length) {
+        rec.trustModels = [...file.supportedTrust];
+    }
+    if (file.x402Support != null)
+        rec.x402Support = file.x402Support;
+    if (file.image)
+        rec.texts = { avatar: file.image };
+    if (file.description) {
+        rec.texts = { ...rec.texts, description: file.description };
+    }
+    return rec;
+}
+/**
+ * Resolve a .agnt name and return its ERC-8004 registration file.
+ * Requires @agnt-id/resolve to be installed.
+ */
+export async function fromAgnt(name, options = {}) {
+    const { AgntClient } = await import("@agnt-id/resolve");
+    const client = new AgntClient({
+        gateway: options.gateway,
+        chainId: options.chainId,
+    });
+    const result = await client.resolve(name);
+    if (!result)
+        return null;
+    return toRegistrationFile(result, options);
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { formatIdentityLink, fromAgnt, fromRegistrationFile, parseIdentityLink, toRegistrationFile, } from "./bridge.js";
+export type { Agent0FeedbackFile, Agent0Registration, Agent0RegistrationFile, Agent0Service, AgntIdentityLink, AgntNameLike, AgntRecordLike, ToRegistrationFileOptions, } from "./types.js";

package/dist/index.js

@@ -0,0 +1 @@
+export { formatIdentityLink, fromAgnt, fromRegistrationFile, parseIdentityLink, toRegistrationFile, } from "./bridge.js";

package/dist/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * ERC-8004 types and .agnt bridge structures.
+ * @see https://eips.ethereum.org/EIPS/eip-8004
+ * @see https://www.8004.org/build
+ */
+/** A service entry in the ERC-8004 registration file. */
+export type Agent0Service = {
+    name: string;
+    endpoint: string;
+    version?: string;
+    skills?: string[];
+    domains?: string[];
+};
+/** An agent's registration entry across chains. */
+export type Agent0Registration = {
+    agentId: number;
+    agentRegistry: string;
+};
+/**
+ * ERC-8004 Agent Registration File — the JSON at an agentURI.
+ * @see https://eips.ethereum.org/EIPS/eip-8004#registration-v1
+ */
+export type Agent0RegistrationFile = {
+    type: "https://eips.ethereum.org/EIPS/eip-8004#registration-v1";
+    name: string;
+    description: string;
+    image?: string;
+    services: Agent0Service[];
+    x402Support?: boolean;
+    active?: boolean;
+    registrations: Agent0Registration[];
+    supportedTrust?: ("reputation" | "crypto-economic" | "tee-attestation" | "social-graph")[];
+};
+/** Feedback file for the ERC-8004 reputation registry. */
+export type Agent0FeedbackFile = {
+    agentRegistry: string;
+    agentId: number;
+    clientAddress: string;
+    createdAt: string;
+    value: number;
+    valueDecimals: number;
+    tag1: string;
+    tag2: string;
+    endpoint: string;
+    mcp?: {
+        tool?: string;
+        prompt?: string;
+        resource?: string;
+    };
+    a2a?: {
+        skills?: string[];
+        contextId?: string;
+        taskId?: string;
+    };
+    oasf?: {
+        skills?: string[];
+        domains?: string[];
+    };
+    proofOfPayment?: {
+        fromAddress: string;
+        toAddress: string;
+        chainId: number;
+        txHash: string;
+    };
+};
+/**
+ * Minimal shape of an .agnt record for bridge operations.
+ * Matches @agnt-id/resolve AgntRecord without requiring the dependency.
+ */
+export type AgntRecordLike = {
+    wallets?: Record<string, string>;
+    agentId?: string;
+    a2a?: string;
+    mcp?: string;
+    texts?: Record<string, string>;
+    identity?: string;
+    wallet?: string;
+    did?: string;
+    skills?: string[];
+    domains?: string[];
+    a2aVersion?: string;
+    mcpVersion?: string;
+    profileURI?: string;
+    x402Support?: boolean;
+    trustModels?: string[];
+};
+/** Minimal resolved .agnt name. */
+export type AgntNameLike = {
+    name: string;
+    owner: string;
+    records: AgntRecordLike;
+};
+/** The parsed identity link stored on the .agnt resolver. */
+export type AgntIdentityLink = {
+    /** CAIP-2 chain ID (e.g. "eip155:1"). */
+    chainId: string;
+    /** ERC-8004 registry contract address. */
+    registry: string;
+    /** ERC-8004 agent token ID. */
+    agentId: number;
+};
+/** Options for bridge conversion. */
+export type ToRegistrationFileOptions = {
+    /** Override active flag (default: true). */
+    active?: boolean;
+    /** Override image URL. */
+    image?: string;
+    /** Additional registrations to include. */
+    extraRegistrations?: Agent0Registration[];
+    /** Additional services to include. */
+    extraServices?: Agent0Service[];
+};

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * ERC-8004 types and .agnt bridge structures.
+ * @see https://eips.ethereum.org/EIPS/eip-8004
+ * @see https://www.8004.org/build
+ */
+export {};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@agnt-id/agent0",
+  "version": "0.1.0",
+  "description": "Bridge between .agnt names and ERC-8004 agent identities",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "tsc"
+  },
+  "keywords": [
+    "agnt",
+    "agent0",
+    "erc-8004",
+    "agent-identity",
+    "naming",
+    "bridge",
+    "ethereum",
+    "web3"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@agnt-id/resolve": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@agnt-id/resolve": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}