@ens-node-metadata/agent 0.2.6 → 0.2.8

package/dist/chunk-3VTAAUSG.js

@@ -0,0 +1,462 @@
+// ../schemas/src/config/constants.ts
+var GITHUB_URL = "https://github.com/0xLighthouse/ens-node-metadata";
+
+// ../schemas/src/schemas/agent.ts
+var AGENT_SCHEMA = {
+  $id: `${GITHUB_URL}/schemas/agent/1.0.0`,
+  source: "https://eips.ethereum.org/EIPS/eip-8004",
+  title: "Agent",
+  version: "1.0.0",
+  description: "AI agent identity metadata aligned with ERC-8004 registration format.",
+  type: "object",
+  properties: {
+    class: {
+      type: "string",
+      default: "Agent",
+      description: "High-level identifier of this node type"
+    },
+    "agent-uri": {
+      type: "string",
+      format: "uri",
+      description: "URI to the ERC-8004 registration file"
+    },
+    type: {
+      type: "string",
+      description: "Registration file type discriminator"
+    },
+    name: {
+      type: "string",
+      description: "Agent display name"
+    },
+    description: {
+      type: "string",
+      description: "Natural-language description of the agent"
+    },
+    services: {
+      type: "string",
+      description: "Advertised service endpoints"
+    },
+    "x402-support": {
+      type: "boolean",
+      description: "Whether x402 payment flow is supported"
+    },
+    active: {
+      type: "string",
+      format: "boolean",
+      description: "Whether the agent is currently active"
+    },
+    registrations: {
+      type: "string",
+      description: "Cross-chain identity registrations"
+    },
+    "supported-trust": {
+      type: "string",
+      description: "Trust models supported by the agent"
+    },
+    "agent-wallet": {
+      type: "string",
+      description: "Verified payout wallet for agent operations"
+    }
+  },
+  patternProperties: {
+    "^service([[^]]+])?$": {
+      type: "string",
+      description: "service[name] => endpoint, per ERC-8004 eg. service[MCP] => <ENDPOINT_URL>"
+    }
+  },
+  required: ["class"],
+  recommended: ["agent-uri"]
+};
+
+// ../schemas/src/schemas/application.ts
+var APPLICATION_SCHEMA = {
+  $id: `${GITHUB_URL}/schemas/application/1.0.0`,
+  source: GITHUB_URL,
+  title: "Application",
+  version: "1.0.0",
+  description: "An application, service, or dApp within the organization.",
+  type: "object",
+  properties: {
+    class: {
+      type: "string",
+      default: "Application",
+      description: "High-level identifier of this node type",
+      examples: ["Application", "Service", "Website"]
+    },
+    name: {
+      type: "string",
+      description: "The name of the application"
+    },
+    description: {
+      type: "string",
+      description: "Description of the application's purpose and functionality"
+    },
+    url: {
+      type: "string",
+      format: "uri",
+      description: "URL where the application is hosted or accessed"
+    },
+    repository: {
+      type: "string",
+      description: "Source code repository URL"
+    },
+    version: {
+      type: "string",
+      description: "Current version of the application"
+    },
+    status: {
+      type: "string",
+      description: "Application status",
+      enum: ["Active", "Development", "Deprecated"]
+    }
+  },
+  required: ["class"],
+  recommended: ["name", "description", "url", "status"]
+};
+
+// ../schemas/src/schemas/contract.ts
+var CONTRACT_SCHEMA = {
+  $id: `${GITHUB_URL}/schemas/contract/1.1.1`,
+  source: GITHUB_URL,
+  title: "Contract",
+  version: "1.1.1",
+  description: "Smart contract metadata profile following Enscribe smart contract metadata format.",
+  type: "object",
+  properties: {
+    class: {
+      type: "string",
+      default: "Contract",
+      description: "High-level identifier of this node type"
+    },
+    alias: {
+      type: "string",
+      description: "Human-readable contract alias (ENSIP-18 alias)"
+    },
+    description: {
+      type: "string",
+      description: "Short description of the contract purpose (ENSIP-18 description)"
+    },
+    avatar: {
+      type: "string",
+      description: "Avatar URI for the contract profile (ENSIP-12 avatar)"
+    },
+    category: {
+      type: "string",
+      description: "Contract category (e.g., defi, gaming, dao, utility, proxy, factory)"
+    },
+    license: {
+      type: "string",
+      description: "Official software license identifier for the source code"
+    },
+    docs: {
+      type: "string",
+      description: "Primary documentation URL for developers and users",
+      format: "uri"
+    },
+    "compiled-metadata": {
+      type: "string",
+      description: "A URI to a contract metadata file as generated by a Solidity or Vyper compiler"
+    },
+    audits: {
+      type: "json",
+      description: "JSON array of third-party audit reports"
+    }
+  },
+  required: ["class"],
+  recommended: ["alias", "description"]
+};
+
+// ../schemas/src/schemas/org.ts
+var ORGANIZATION_SCHEMA = {
+  $id: `${GITHUB_URL}/schemas/org/0.1.5`,
+  source: GITHUB_URL,
+  title: "Organization",
+  version: "0.1.8",
+  description: "A legal or organizational entity.",
+  type: "object",
+  properties: {
+    class: {
+      type: "string",
+      default: "Organization",
+      description: "High-level identifier of this node type",
+      examples: ["Organization", "Foundation", "OPCo"]
+    },
+    name: {
+      type: "string",
+      description: "The name of this business unit"
+    },
+    avatar: {
+      type: "string",
+      description: "A URL to an image used as an avatar or logo"
+    },
+    description: {
+      type: "string",
+      description: "A description of the name"
+    },
+    url: {
+      type: "string",
+      format: "uri",
+      description: "URL of the organization"
+    }
+  },
+  required: ["class"],
+  recommended: ["name", "avatar", "description", "url"]
+};
+
+// ../schemas/src/schemas/person.ts
+var PERSON_SCHEMA = {
+  $id: `${GITHUB_URL}/schemas/person/1.0.0`,
+  source: GITHUB_URL,
+  title: "Person",
+  version: "1.0.0",
+  description: "A person.",
+  type: "object",
+  properties: {
+    class: {
+      type: "string",
+      default: "Person",
+      description: "High-level identifier of this node type",
+      examples: ["Person", "Human", "Signer", "Officer", "Employee", "Secretary"]
+    },
+    "full-name": {
+      type: "string",
+      description: "Full legal or preferred name"
+    },
+    "title": {
+      type: "string",
+      description: "Title within the organization, if any"
+    }
+  }
+};
+
+// ../schemas/src/schemas/treasury.ts
+var TREASURY_SCHEMA = {
+  $id: `${GITHUB_URL}/schemas/treasury/1.0.0`,
+  source: GITHUB_URL,
+  title: "Treasury",
+  version: "1.0.0",
+  description: "Funds and assets managed by a collective of individuals or entities.",
+  type: "object",
+  properties: {
+    class: {
+      type: "string",
+      default: "Treasury",
+      description: "High-level identifier of this node type",
+      examples: ["Treasury", "Vault"]
+    },
+    name: {
+      type: "string",
+      description: "The name of the treasury"
+    },
+    description: {
+      type: "string",
+      description: "A description of the name"
+    }
+  },
+  required: ["class"],
+  recommended: ["name", "description"]
+};
+
+// ../schemas/src/schemas/wallet.ts
+var WALLET_SCHEMA = {
+  $id: `${GITHUB_URL}/schemas/wallet/1.0.0`,
+  source: GITHUB_URL,
+  title: "Wallet",
+  version: "1.0.0",
+  description: "A wallet for holding or managing assets.",
+  type: "object",
+  properties: {
+    class: {
+      type: "string",
+      default: "Wallet",
+      description: "High-level identifier of this node type",
+      examples: ["Wallet", "Account"]
+    },
+    description: {
+      type: "string",
+      description: "Indicates the purpose of the wallet"
+    }
+  },
+  required: ["class"],
+  recommended: ["description"]
+};
+
+// ../schemas/src/schemas/grant.ts
+var GRANT_SCHEMA = {
+  $id: `${GITHUB_URL}/schemas/grantProgram/1.0.0`,
+  source: GITHUB_URL,
+  title: "Grant",
+  version: "1.0.0",
+  description: "A grant issued by an organization.",
+  type: "object",
+  properties: {
+    class: {
+      type: "string",
+      default: "Grant",
+      description: "High-level identifier of this node type",
+      examples: ["Grant", "GrantProgram"]
+    },
+    "name": {
+      type: "string",
+      description: "The name of the grant program"
+    },
+    description: {
+      type: "string",
+      description: "Description of the grant purpose and scope"
+    },
+    url: {
+      type: "string",
+      format: "uri",
+      description: "URL of the grant program"
+    },
+    status: {
+      type: "string",
+      description: "Grant status",
+      enum: ["Active", "Incomplete", "Pending", "Completed", "Cancelled"]
+    },
+    budget: {
+      type: "string",
+      description: "Total budget expressed as WEI eg. 100 USDC = 100 * 10^6"
+    },
+    token: {
+      type: "string",
+      description: 'Token expressed as ERC-20 token address eg. "0x0000000000000000000000000000000000000000"'
+    }
+  },
+  required: ["class"],
+  recommended: ["name", "description", "url", "status", "budget", "token"]
+};
+
+// ../schemas/src/schemas/delegate.ts
+var DELEGATE_SCHEMA = {
+  $id: `${GITHUB_URL}/schemas/delegate/1.0.0`,
+  source: GITHUB_URL,
+  title: "Delegate",
+  version: "1.0.1",
+  description: "A delegate.",
+  type: "object",
+  properties: {
+    class: {
+      type: "string",
+      default: "Delegate",
+      description: "High-level identifier of this node type"
+    },
+    "address": {
+      type: "string",
+      format: "address",
+      description: "The address of the delegate"
+    },
+    "legal-name": {
+      type: "string",
+      description: 'The full legal or preferred name of the delegate (e.g. "John Doe")'
+    },
+    "display-name": {
+      type: "string",
+      description: "A canonical display name for the delegate"
+    },
+    statement: {
+      type: "string",
+      description: "Generic delegate statement "
+    },
+    "conflict-of-interest": {
+      type: "string",
+      description: "Generic conflict of interest declaration "
+    },
+    "forum-handle": {
+      type: "string",
+      description: 'Default forum handle (e.g. "johndoe")'
+    }
+  },
+  patternProperties: {
+    "^statement(\\[[^\\]]+\\])?$": {
+      type: "string",
+      description: "Delegate statement per organization (e.g. statement[dao.eth])"
+    },
+    "^conflict-of-interest(\\[[^\\]]+\\])?$": {
+      type: "string",
+      description: "Conflict of interest declaration per organization (e.g. conflict-of-interest[dao.eth])"
+    },
+    "^forum-handle(\\[[^\\]]+\\])?$": {
+      type: "string",
+      description: "Forum handle per organization (e.g. forum-handle[dao.eth])"
+    }
+  },
+  required: ["class"],
+  recommended: ["address", "display-name", "statement", "conflict-of-interest", "forum-handle"]
+};
+
+// ../schemas/src/schemas/group.ts
+var GROUP_SCHEMA = {
+  $id: `${GITHUB_URL}/schemas/group/0.1.4`,
+  source: GITHUB_URL,
+  title: "Group",
+  version: "0.1.4",
+  description: "This node describes a group of individuals or entities with a shared purpose or responsibility.",
+  type: "object",
+  properties: {
+    class: {
+      type: "string",
+      default: "Group",
+      description: "High-level identifier of this node type",
+      examples: ["Group", "Committee", "Council", "Workgroup", "Team"]
+    },
+    name: {
+      type: "string",
+      description: "The name of the group"
+    },
+    avatar: {
+      type: "string",
+      description: "A URL to an image used as an avatar or logo"
+    },
+    description: {
+      type: "string",
+      description: "A description of the name"
+    },
+    url: {
+      type: "string",
+      format: "uri",
+      description: "URL of the group"
+    },
+    lead: {
+      type: "string",
+      description: "ENS name or address of the group leader"
+    },
+    "lead-title": {
+      type: "string",
+      description: "Title or role of the group leader",
+      examples: ["Lead Steward", "Chair", "Manager", "Owner"]
+    },
+    "members-title": {
+      type: "string",
+      description: "Title or role of the group members",
+      examples: ["Member", "Steward", "Contributor", "Participant"]
+    }
+  },
+  required: ["class"],
+  recommended: ["name", "lead", "avatar", "url", "description"]
+};
+
+// ../schemas/src/index.ts
+var SCHEMAS = [
+  AGENT_SCHEMA,
+  APPLICATION_SCHEMA,
+  CONTRACT_SCHEMA,
+  DELEGATE_SCHEMA,
+  GRANT_SCHEMA,
+  GROUP_SCHEMA,
+  PERSON_SCHEMA,
+  ORGANIZATION_SCHEMA,
+  WALLET_SCHEMA,
+  TREASURY_SCHEMA
+];
+var SCHEMA_MAP = SCHEMAS.reduce(
+  (map, schema) => {
+    map[schema.title] = schema;
+    return map;
+  },
+  {}
+);
+
+export {
+  SCHEMA_MAP
+};

package/dist/chunk-UDZL55XF.js

@@ -0,0 +1,65 @@
+// src/types.ts
+import { z } from "zod";
+var McpServiceSchema = z.object({
+  name: z.literal("MCP"),
+  endpoint: z.string().url().describe("MCP server URL"),
+  version: z.string().describe("MCP protocol version date (e.g. 2025-11-25)"),
+  mcpTools: z.array(z.string()).optional().describe("Tool names exposed by this MCP server"),
+  capabilities: z.array(z.string()).optional().describe("MCP capability identifiers")
+});
+var A2AServiceSchema = z.object({
+  name: z.literal("A2A"),
+  endpoint: z.string().url().describe("URL to the agent card JSON (e.g. /.well-known/agent-card.json)"),
+  version: z.string().describe("A2A protocol version (e.g. 0.3.0)")
+});
+var OasfServiceSchema = z.object({
+  name: z.literal("OASF"),
+  endpoint: z.string().url().describe("OASF schema endpoint URL"),
+  version: z.string().describe("OASF version (e.g. 0.8.0)"),
+  skills: z.array(z.string()).optional().describe("Skill paths (e.g. analytical_skills/data_analysis/blockchain_analysis)"),
+  domains: z.array(z.string()).optional().describe("Domain paths (e.g. technology/blockchain)")
+});
+var AgentWalletServiceSchema = z.object({
+  name: z.literal("agentWallet"),
+  endpoint: z.string().describe("CAIP-10 wallet address (e.g. eip155:1:0x...)")
+});
+var WebServiceSchema = z.object({
+  name: z.literal("web"),
+  endpoint: z.string().url().describe("Human-facing web UI URL")
+});
+var EmailServiceSchema = z.object({
+  name: z.literal("email"),
+  endpoint: z.string().email().describe("Support email address")
+});
+var SCHEMA_8004_V2 = z.object({
+  type: z.literal("https://eips.ethereum.org/EIPS/eip-8004#registration-v1").describe("ERC-8004 registration type identifier \u2014 must be this exact URI"),
+  name: z.string().min(3).max(200).describe("Agent display name (3\u2013200 characters)"),
+  description: z.string().min(10).describe("Natural language explanation of what the agent does and its capabilities"),
+  image: z.string().url().optional().describe("Avatar or logo URI \u2014 PNG, SVG, WebP, or JPG; 512\xD7512px minimum recommended"),
+  services: z.array(z.discriminatedUnion("name", [
+    McpServiceSchema,
+    A2AServiceSchema,
+    OasfServiceSchema,
+    AgentWalletServiceSchema,
+    WebServiceSchema,
+    EmailServiceSchema
+  ])).describe("Communication endpoints \u2014 MCP, A2A, OASF, agentWallet, web, or email"),
+  registrations: z.array(z.object({
+    agentId: z.union([z.number().int(), z.string()]).describe("Agent token ID in the on-chain registry"),
+    agentRegistry: z.string().describe("CAIP-10 formatted registry contract address (e.g. eip155:1:0x...)")
+  })).optional().describe("On-chain NFT identity links to agent registries"),
+  supportedTrust: z.array(z.enum(["reputation", "crypto-economic", "tee-attestation"])).optional().describe("Trust models supported by this agent"),
+  active: z.boolean().default(false).describe("Whether the agent is production-ready and accepting requests (default: false)"),
+  x402Support: z.boolean().default(false).describe("Whether the agent supports the HTTP 402 / x402 micro-payment protocol"),
+  updatedAt: z.number().int().optional().describe("Unix timestamp (seconds) of the last metadata update")
+});
+
+// src/index.ts
+function validateRegistrationFile(file) {
+  return SCHEMA_8004_V2.safeParse(file);
+}
+
+export {
+  SCHEMA_8004_V2,
+  validateRegistrationFile
+};

package/dist/cli.js

@@ -9,19 +9,19 @@ if (isRootHelp) {
 CLI for registering AI agents on ENS using ERC-8004 (v2.0).
 
 Usage:
-  agent skill [--install]
+  ens-agent skill [--install]
 
-  agent registration-file template
-  agent registration-file validate <file.json>
-  agent registration-file publish <file.json>
+  ens-agent registration-file template
+  ens-agent registration-file validate <file.json>
+  ens-agent registration-file publish <file.json>
 
-  agent registry identity --chain-name <chain> <agent-uri>
+  ens-agent registry identity --chain-name <chain> <agent-uri>
 
-  agent metadata template
-  agent metadata validate <payload.json>
-  agent metadata set <ens-node> <payload.json> --private-key <key> [--broadcast]
+  ens-agent metadata template
+  ens-agent metadata validate <payload.json>
+  ens-agent metadata set <ens-node> <payload.json> --private-key <key> [--broadcast]
 
-Run \`agent <command> --help\` for details on a specific command.
+Run \`ens-agent <command> --help\` for details on a specific command.
 `);
   process.exit(0);
 }

package/dist/commands/metadata/set.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import { z } from 'zod';
+
+declare const description = "Set ENS metadata text records from a payload file";
+declare const args: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+declare const options: z.ZodObject<{
+    privateKey: z.ZodString;
+    broadcast: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    privateKey: string;
+    broadcast: boolean;
+}, {
+    privateKey: string;
+    broadcast?: boolean | undefined;
+}>;
+type Props = {
+    args: z.infer<typeof args>;
+    options: z.infer<typeof options>;
+};
+declare function Set({ args: [ensName, payloadFile], options }: Props): React.JSX.Element;
+
+export { args, Set as default, description, options };

package/dist/commands/metadata/set.js

@@ -0,0 +1,101 @@
+import {
+  SCHEMA_MAP
+} from "../../chunk-3VTAAUSG.js";
+
+// src/commands/metadata/set.tsx
+import { readFileSync } from "fs";
+import { Box, Text, useApp } from "ink";
+import React from "react";
+import { z } from "zod";
+import { validateMetadataSchema } from "@ens-node-metadata/sdk";
+
+// src/lib/ens-write.ts
+import { http, createPublicClient, createWalletClient } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { mainnet } from "viem/chains";
+async function setEnsTextRecords(ensName, texts, privateKey) {
+  const { addEnsContracts } = await import("@ensdomains/ensjs");
+  const { setRecords } = await import("@ensdomains/ensjs/wallet");
+  const { getResolver } = await import("@ensdomains/ensjs/public");
+  const account = privateKeyToAccount(privateKey);
+  const chain = addEnsContracts(mainnet);
+  const publicClient = createPublicClient({ chain, transport: http() });
+  const walletClient = createWalletClient({ account, chain, transport: http() });
+  const resolverAddress = await getResolver(publicClient, { name: ensName });
+  if (!resolverAddress) {
+    throw new Error(`No resolver found for ${ensName}. Set a resolver first.`);
+  }
+  const hash = await setRecords(walletClient, {
+    name: ensName,
+    texts,
+    coins: [],
+    resolverAddress
+  });
+  return hash;
+}
+
+// src/commands/metadata/set.tsx
+var description = "Set ENS metadata text records from a payload file";
+var args = z.tuple([
+  z.string().describe("ENS name (e.g. myagent.eth)"),
+  z.string().describe("payload.json")
+]);
+var options = z.object({
+  privateKey: z.string().describe("Private key for signing (hex, prefixed with 0x)"),
+  broadcast: z.boolean().default(false).describe("Broadcast the transaction on-chain (default: dry run)")
+});
+function Set({ args: [ensName, payloadFile], options: options2 }) {
+  const { exit } = useApp();
+  const [state, setState] = React.useState({ status: "idle" });
+  React.useEffect(() => {
+    async function run() {
+      let payload;
+      try {
+        const raw = JSON.parse(readFileSync(payloadFile, "utf8"));
+        const result = validateMetadataSchema(raw, SCHEMA_MAP.Agent);
+        if (!result.success) {
+          const issues = result.errors.map((e) => `[${e.key}] ${e.message}`).join("\n");
+          setState({ status: "error", message: `Invalid payload:
+${issues}` });
+          exit(new Error("validation failed"));
+          return;
+        }
+        payload = result.data;
+      } catch (err) {
+        setState({ status: "error", message: `Error reading payload: ${err.message}` });
+        exit(new Error("read error"));
+        return;
+      }
+      const texts = Object.entries(payload).map(([key, value]) => ({ key, value }));
+      if (!options2.broadcast) {
+        const lines = [
+          `Dry run \u2014 would set ${texts.length} text records on ${ensName}:`,
+          "",
+          ...texts.map((t) => `  setText("${t.key}", "${t.value}")`),
+          "",
+          "Run with --broadcast to submit on-chain."
+        ];
+        setState({ status: "done", message: lines.join("\n") });
+        exit();
+        return;
+      }
+      setState({ status: "working", message: `Setting ${texts.length} text records on ${ensName}\u2026` });
+      try {
+        const hash = await setEnsTextRecords(ensName, texts, options2.privateKey);
+        setState({ status: "done", message: `\u2705 Transaction submitted: ${hash}` });
+        exit();
+      } catch (err) {
+        setState({ status: "error", message: `Transaction failed: ${err.message}` });
+        exit(new Error("tx failed"));
+      }
+    }
+    run();
+  }, [exit, ensName, payloadFile, options2]);
+  return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column" }, state.status === "idle" && /* @__PURE__ */ React.createElement(Text, { color: "gray" }, "Preparing\u2026"), state.status === "working" && /* @__PURE__ */ React.createElement(Text, { color: "cyan" }, state.message), state.status === "done" && /* @__PURE__ */ React.createElement(Text, { color: "green" }, state.message), state.status === "error" && /* @__PURE__ */ React.createElement(Text, { color: "red" }, "\u274C ", state.message));
+}
+export {
+  args,
+  Set as default,
+  description,
+  options
+};

package/dist/commands/metadata/template.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+
+declare const description = "Generate starter ENS metadata payload template";
+declare function MetadataTemplate(): React.JSX.Element;
+
+export { MetadataTemplate as default, description };

package/dist/commands/metadata/template.js

@@ -0,0 +1,15 @@
+import {
+  SCHEMA_MAP
+} from "../../chunk-3VTAAUSG.js";
+
+// src/commands/metadata/template.tsx
+import { Text } from "ink";
+import React from "react";
+var description = "Generate starter ENS metadata payload template";
+function MetadataTemplate() {
+  return /* @__PURE__ */ React.createElement(Text, null, JSON.stringify(SCHEMA_MAP.Agent, null, 2));
+}
+export {
+  MetadataTemplate as default,
+  description
+};

package/dist/commands/metadata/validate.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { z } from 'zod';
+
+declare const description = "Validate ENS metadata payload against agent schema";
+declare const args: z.ZodTuple<[z.ZodString], null>;
+type Props = {
+    args: z.infer<typeof args>;
+};
+declare function MetadataValidate({ args: [file] }: Props): React.JSX.Element;
+
+export { args, MetadataValidate as default, description };

package/dist/commands/metadata/validate.js

@@ -0,0 +1,38 @@
+import {
+  SCHEMA_MAP
+} from "../../chunk-3VTAAUSG.js";
+
+// src/commands/metadata/validate.tsx
+import { readFileSync } from "fs";
+import { Box, Text, useApp } from "ink";
+import React from "react";
+import { z } from "zod";
+import { validateMetadataSchema } from "@ens-node-metadata/sdk";
+var description = "Validate ENS metadata payload against agent schema";
+var args = z.tuple([z.string().describe("payload.json")]);
+function MetadataValidate({ args: [file] }) {
+  const { exit } = useApp();
+  let fileError = null;
+  let result = null;
+  try {
+    const raw = JSON.parse(readFileSync(file, "utf8"));
+    result = validateMetadataSchema(raw, SCHEMA_MAP.Agent);
+  } catch (err) {
+    fileError = err.message;
+  }
+  React.useEffect(() => {
+    exit(fileError || result && !result.success ? new Error("validation failed") : void 0);
+  }, [exit, fileError, result]);
+  if (fileError) {
+    return /* @__PURE__ */ React.createElement(Text, { color: "red" }, "\u274C Error reading file: ", fileError);
+  }
+  if (result.success) {
+    return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column" }, /* @__PURE__ */ React.createElement(Text, { color: "green" }, "\u2705 Valid ENS agent metadata payload"), /* @__PURE__ */ React.createElement(Text, { color: "gray" }, " ", Object.keys(result.data).length, " text records"));
+  }
+  return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column" }, /* @__PURE__ */ React.createElement(Text, { color: "red" }, "\u274C Invalid agent metadata payload"), result.errors.map(({ key, message }) => /* @__PURE__ */ React.createElement(Text, { key, color: "red" }, "  ", "[", key, "] ", message)));
+}
+export {
+  args,
+  MetadataValidate as default,
+  description
+};

package/dist/commands/registration-file/publish.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { z } from 'zod';
+
+declare const description = "Publish registration file to IPFS via Pinata";
+declare const args: z.ZodTuple<[z.ZodString], null>;
+type Props = {
+    args: z.infer<typeof args>;
+};
+declare function RegistrationFilePublish({ args: [file] }: Props): React.JSX.Element;
+
+export { args, RegistrationFilePublish as default, description };

package/dist/commands/registration-file/publish.js

@@ -0,0 +1,132 @@
+import {
+  validateRegistrationFile
+} from "../../chunk-UDZL55XF.js";
+
+// src/commands/registration-file/publish.tsx
+import { readFileSync } from "fs";
+import { Box, Text, useApp } from "ink";
+import React from "react";
+import { z } from "zod";
+
+// ../shared/src/ipfs.ts
+import fs from "fs";
+import path from "path";
+import { execSync } from "child_process";
+function publishToIpfs(cmd, filePath) {
+  const output = execSync(`${cmd} ${filePath}`, { encoding: "utf8" }).trim();
+  const lines = output.split(/\r?\n/).filter(Boolean);
+  const last = lines[lines.length - 1] ?? "";
+  const parts = last.split(/\s+/);
+  if (parts.length === 1) return parts[0];
+  if (parts[0] === "added" && parts[1]) return parts[1];
+  return parts[parts.length - 1];
+}
+async function publishToPinata(input) {
+  const buffer = await fs.promises.readFile(input.filePath);
+  const form = new FormData();
+  form.set("file", new Blob([buffer]), path.basename(input.filePath));
+  form.set(
+    "pinataMetadata",
+    JSON.stringify({
+      name: `${input.schemaId}@${input.version}`,
+      keyvalues: { schemaId: input.schemaId, version: input.version }
+    })
+  );
+  const headers = {};
+  if (input.jwt) {
+    headers.Authorization = `Bearer ${input.jwt}`;
+  } else if (input.apiKey && input.apiSecret) {
+    headers.pinata_api_key = input.apiKey;
+    headers.pinata_secret_api_key = input.apiSecret;
+  }
+  const response = await fetch("https://api.pinata.cloud/pinning/pinFileToIPFS", {
+    method: "POST",
+    headers,
+    body: form
+  });
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`Pinata upload failed: ${response.status} ${text}`);
+  }
+  const data = await response.json();
+  if (!data.IpfsHash) throw new Error("Pinata response missing IpfsHash");
+  return data.IpfsHash;
+}
+async function publishFile(input) {
+  if (input.provider === "ipfs") {
+    return { cid: publishToIpfs(input.ipfsCmd ?? "ipfs add -q", input.filePath), publisher: "ipfs" };
+  }
+  const cid = await publishToPinata({
+    filePath: input.filePath,
+    jwt: input.pinataJwt,
+    apiKey: input.pinataKey,
+    apiSecret: input.pinataSecret,
+    schemaId: input.schemaId,
+    version: input.version
+  });
+  return { cid, publisher: "pinata" };
+}
+
+// src/commands/registration-file/publish.tsx
+var description = "Publish registration file to IPFS via Pinata";
+var args = z.tuple([z.string().describe("registration-file.json")]);
+function RegistrationFilePublish({ args: [file] }) {
+  const { exit } = useApp();
+  const [state, setState] = React.useState({ status: "idle" });
+  React.useEffect(() => {
+    async function run() {
+      const pinataJwt = process.env.PINATA_JWT;
+      const pinataKey = process.env.PINATA_API_KEY;
+      const pinataSecret = process.env.PINATA_API_SECRET;
+      if (!pinataJwt && !(pinataKey && pinataSecret)) {
+        setState({
+          status: "error",
+          message: "Missing Pinata credentials. Set PINATA_JWT or both PINATA_API_KEY and PINATA_API_SECRET."
+        });
+        exit(new Error("missing env vars"));
+        return;
+      }
+      setState({ status: "validating" });
+      let raw;
+      try {
+        raw = JSON.parse(readFileSync(file, "utf8"));
+      } catch (err) {
+        setState({ status: "error", message: `Error reading file: ${err.message}` });
+        exit(new Error("read error"));
+        return;
+      }
+      const result = validateRegistrationFile(raw);
+      if (!result.success) {
+        const issues = result.error.issues.map((i) => `[${i.path.join(".") || "root"}] ${i.message}`).join("\n");
+        setState({ status: "error", message: `Invalid registration file:
+${issues}` });
+        exit(new Error("validation failed"));
+        return;
+      }
+      setState({ status: "uploading" });
+      try {
+        const { cid } = await publishFile({
+          provider: "pinata",
+          filePath: file,
+          pinataJwt,
+          pinataKey,
+          pinataSecret,
+          schemaId: result.data.name,
+          version: "1.0.0"
+        });
+        setState({ status: "done", uri: `ipfs://${cid}` });
+        exit();
+      } catch (err) {
+        setState({ status: "error", message: `Upload failed: ${err.message}` });
+        exit(new Error("upload failed"));
+      }
+    }
+    run();
+  }, [exit, file]);
+  return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column" }, state.status === "idle" && /* @__PURE__ */ React.createElement(Text, { color: "gray" }, "Preparing\u2026"), state.status === "validating" && /* @__PURE__ */ React.createElement(Text, { color: "cyan" }, "Validating registration file\u2026"), state.status === "uploading" && /* @__PURE__ */ React.createElement(Text, { color: "cyan" }, "Uploading to IPFS via Pinata\u2026"), state.status === "done" && /* @__PURE__ */ React.createElement(Box, { flexDirection: "column" }, /* @__PURE__ */ React.createElement(Text, { color: "green" }, "\u2705 Published to IPFS"), /* @__PURE__ */ React.createElement(Text, null, state.uri)), state.status === "error" && /* @__PURE__ */ React.createElement(Box, { flexDirection: "column" }, /* @__PURE__ */ React.createElement(Text, { color: "red" }, "\u274C ", state.message)));
+}
+export {
+  args,
+  RegistrationFilePublish as default,
+  description
+};

package/dist/commands/registration-file/template.d.ts

@@ -0,0 +1,4 @@
+declare const description = "Generate empty ERC-8004 v2.0 registration file template";
+declare function RegistrationFileTemplate(): null;
+
+export { RegistrationFileTemplate as default, description };

package/dist/commands/registration-file/template.js

@@ -0,0 +1,51 @@
+// src/commands/registration-file/template.tsx
+import { useApp } from "ink";
+import React from "react";
+var description = "Generate empty ERC-8004 v2.0 registration file template";
+var TEMPLATE = {
+  type: "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
+  name: "My Agent",
+  description: "A short description of what this agent does and its capabilities.",
+  image: "https://example.com/agent-avatar.png",
+  services: [
+    {
+      name: "MCP",
+      endpoint: "https://api.example.com/mcp",
+      version: "2025-11-25",
+      mcpTools: [],
+      capabilities: []
+    },
+    {
+      name: "A2A",
+      endpoint: "https://example.com/.well-known/agent-card.json",
+      version: "0.3.0"
+    },
+    {
+      name: "agentWallet",
+      endpoint: "eip155:1:0x0000000000000000000000000000000000000000"
+    }
+  ],
+  registrations: [
+    {
+      agentId: 0,
+      agentRegistry: "eip155:1:0x8004a6090Cd10A7288092483047B097295Fb8847"
+    }
+  ],
+  supportedTrust: ["reputation"],
+  active: false,
+  x402Support: false,
+  updatedAt: Math.floor(Date.now() / 1e3)
+};
+function RegistrationFileTemplate() {
+  const { exit } = useApp();
+  React.useEffect(() => {
+    process.stdout.write(`${JSON.stringify(TEMPLATE, null, 2)}
+`);
+    exit();
+  }, [exit]);
+  return null;
+}
+export {
+  RegistrationFileTemplate as default,
+  description
+};

package/dist/commands/registration-file/validate.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { z } from 'zod';
+
+declare const description = "Validate registration file against ERC-8004 v2.0 schema";
+declare const args: z.ZodTuple<[z.ZodString], null>;
+type Props = {
+    args: z.infer<typeof args>;
+};
+declare function RegistrationFileValidate({ args: [file] }: Props): React.JSX.Element;
+
+export { args, RegistrationFileValidate as default, description };

package/dist/commands/registration-file/validate.js

@@ -0,0 +1,49 @@
+import {
+  validateRegistrationFile
+} from "../../chunk-UDZL55XF.js";
+
+// src/commands/registration-file/validate.tsx
+import { readFileSync } from "fs";
+import { Box as Box2, Text as Text2, useApp } from "ink";
+import React2 from "react";
+import { z } from "zod";
+
+// src/lib/ui.tsx
+import { Box, Text } from "ink";
+import React from "react";
+function ZodIssueList({ issues }) {
+  return /* @__PURE__ */ React.createElement(React.Fragment, null, issues.map((issue) => {
+    const path = issue.path.length > 0 ? issue.path.join(".") : "(root)";
+    return /* @__PURE__ */ React.createElement(Box, { key: `${path}.${issue.message}` }, /* @__PURE__ */ React.createElement(Text, { color: "red" }, "  ", "[", path, "] ", issue.message));
+  }));
+}
+
+// src/commands/registration-file/validate.tsx
+var description = "Validate registration file against ERC-8004 v2.0 schema";
+var args = z.tuple([z.string().describe("registration-file.json")]);
+function RegistrationFileValidate({ args: [file] }) {
+  const { exit } = useApp();
+  let fileError = null;
+  let result = null;
+  try {
+    const raw = JSON.parse(readFileSync(file, "utf8"));
+    result = validateRegistrationFile(raw);
+  } catch (err) {
+    fileError = err.message;
+  }
+  React2.useEffect(() => {
+    exit(fileError || result && !result.success ? new Error("validation failed") : void 0);
+  }, [exit, fileError, result]);
+  if (fileError) {
+    return /* @__PURE__ */ React2.createElement(Text2, { color: "red" }, "\u274C Error reading file: ", fileError);
+  }
+  if (result.success) {
+    return /* @__PURE__ */ React2.createElement(Box2, { flexDirection: "column" }, /* @__PURE__ */ React2.createElement(Text2, { color: "green" }, "\u2705 Valid ERC-8004 v2.0 AgentRegistrationFile"));
+  }
+  return /* @__PURE__ */ React2.createElement(Box2, { flexDirection: "column" }, /* @__PURE__ */ React2.createElement(Text2, { color: "red" }, "\u274C Invalid AgentRegistrationFile"), /* @__PURE__ */ React2.createElement(ZodIssueList, { issues: result.error.issues }));
+}
+export {
+  args,
+  RegistrationFileValidate as default,
+  description
+};

package/dist/commands/registry/identity.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import { z } from 'zod';
+
+declare const description = "Query ERC-8004 registry for agent identity";
+declare const options: z.ZodObject<{
+    chainName: z.ZodDefault<z.ZodEnum<["base", "mainnet"]>>;
+}, "strip", z.ZodTypeAny, {
+    chainName: "base" | "mainnet";
+}, {
+    chainName?: "base" | "mainnet" | undefined;
+}>;
+declare const args: z.ZodTuple<[z.ZodString], null>;
+type Props = {
+    options: z.infer<typeof options>;
+    args: z.infer<typeof args>;
+};
+declare function RegistryIdentity({ options: { chainName }, args: [agentUri] }: Props): React.JSX.Element;
+
+export { args, RegistryIdentity as default, description, options };

package/dist/commands/registry/identity.js

@@ -0,0 +1,91 @@
+// src/commands/registry/identity.tsx
+import { Box, Text, useApp } from "ink";
+import React from "react";
+import { http, createPublicClient } from "viem";
+import { base, mainnet } from "viem/chains";
+import { z } from "zod";
+var description = "Query ERC-8004 registry for agent identity";
+var options = z.object({
+  chainName: z.enum(["base", "mainnet"]).default("mainnet").describe("Chain to query (base | mainnet)")
+});
+var args = z.tuple([z.string().describe("agent-uri")]);
+var REGISTRY_ADDRESSES = {
+  mainnet: process.env.ERC8004_REGISTRY_MAINNET ?? "0x0000000000000000000000000000000000000000",
+  base: process.env.ERC8004_REGISTRY_BASE ?? "0x0000000000000000000000000000000000000000"
+};
+var ERC8004_REGISTRY_ABI = [
+  {
+    name: "agentOf",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentUri", type: "string" }],
+    outputs: [
+      { name: "owner", type: "address" },
+      { name: "tokenId", type: "uint256" },
+      { name: "agentUri", type: "string" }
+    ]
+  },
+  {
+    name: "balanceOf",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "owner", type: "address" }],
+    outputs: [{ name: "", type: "uint256" }]
+  }
+];
+function RegistryIdentity({ options: { chainName }, args: [agentUri] }) {
+  const { exit } = useApp();
+  const [state, setState] = React.useState({ status: "loading" });
+  React.useEffect(() => {
+    async function run() {
+      const chain = chainName === "base" ? base : mainnet;
+      const registryAddress = REGISTRY_ADDRESSES[chainName];
+      if (registryAddress === "0x0000000000000000000000000000000000000000") {
+        setState({
+          status: "error",
+          message: `No registry address configured for ${chainName}.
+Set ERC8004_REGISTRY_${chainName.toUpperCase()} env var to the contract address.`
+        });
+        exit(new Error("no registry address"));
+        return;
+      }
+      try {
+        const client = createPublicClient({
+          chain,
+          transport: http()
+        });
+        const result = await client.readContract({
+          address: registryAddress,
+          abi: ERC8004_REGISTRY_ABI,
+          functionName: "agentOf",
+          args: [agentUri]
+        });
+        setState({
+          status: "done",
+          identity: {
+            owner: result[0],
+            tokenId: result[1],
+            agentUri: result[2],
+            chain: chainName,
+            registryAddress
+          }
+        });
+        exit();
+      } catch (err) {
+        setState({
+          status: "error",
+          message: `Registry read failed: ${err.message}`
+        });
+        exit(new Error("registry read failed"));
+      }
+    }
+    run();
+  }, [exit, chainName, agentUri]);
+  return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column" }, state.status === "loading" && /* @__PURE__ */ React.createElement(Text, { color: "cyan" }, "Querying ERC-8004 registry\u2026"), state.status === "done" && /* @__PURE__ */ React.createElement(Box, { flexDirection: "column" }, /* @__PURE__ */ React.createElement(Text, { color: "green" }, "\u2705 Agent Identity (", state.identity.chain, ")"), /* @__PURE__ */ React.createElement(Text, null, " Agent URI: ", state.identity.agentUri), /* @__PURE__ */ React.createElement(Text, null, " Owner: ", state.identity.owner), /* @__PURE__ */ React.createElement(Text, null, " Token ID: ", state.identity.tokenId.toString()), /* @__PURE__ */ React.createElement(Text, null, " Registry: ", state.identity.registryAddress)), state.status === "error" && /* @__PURE__ */ React.createElement(Text, { color: "red" }, "\u274C ", state.message));
+}
+export {
+  args,
+  RegistryIdentity as default,
+  description,
+  options
+};

package/dist/commands/skill.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import { z } from 'zod';
+
+declare const description = "Print or install SKILL.md guide";
+declare const options: z.ZodObject<{
+    install: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    install: boolean;
+}, {
+    install?: boolean | undefined;
+}>;
+type Props = {
+    options: z.infer<typeof options>;
+};
+declare function Skill({ options: { install } }: Props): React.JSX.Element;
+
+export { Skill as default, description, options };

package/dist/commands/skill.js

@@ -0,0 +1,53 @@
+// src/commands/skill.tsx
+import { copyFileSync, existsSync, readFileSync } from "fs";
+import { dirname, join, resolve } from "path";
+import { fileURLToPath } from "url";
+import { Text, useApp } from "ink";
+import React from "react";
+import { z } from "zod";
+var description = "Print or install SKILL.md guide";
+var options = z.object({
+  install: z.boolean().default(false).describe("Copy SKILL.md to the current working directory")
+});
+var __dirname = dirname(fileURLToPath(import.meta.url));
+function getSkillMdPath() {
+  const candidates = [
+    join(__dirname, "../../SKILL.md"),
+    join(__dirname, "../SKILL.md"),
+    join(__dirname, "SKILL.md")
+  ];
+  for (const p of candidates) {
+    if (existsSync(p)) return p;
+  }
+  throw new Error("SKILL.md not found in package");
+}
+function Skill({ options: { install } }) {
+  const { exit } = useApp();
+  const [output, setOutput] = React.useState("");
+  const [error, setError] = React.useState(null);
+  React.useEffect(() => {
+    try {
+      const skillPath = getSkillMdPath();
+      const content = readFileSync(skillPath, "utf8");
+      if (install) {
+        const dest = resolve(process.cwd(), "SKILL.md");
+        copyFileSync(skillPath, dest);
+        setOutput(`\u2705 SKILL.md copied to ${dest}`);
+      } else {
+        setOutput(content);
+      }
+    } catch (err) {
+      setError(err.message);
+    }
+    exit();
+  }, [exit, install]);
+  if (error) {
+    return /* @__PURE__ */ React.createElement(Text, { color: "red" }, "\u274C ", error);
+  }
+  return /* @__PURE__ */ React.createElement(Text, null, output);
+}
+export {
+  Skill as default,
+  description,
+  options
+};

package/dist/index.js

@@ -1,63 +1,7 @@
-// src/types.ts
-import { z } from "zod";
-var McpServiceSchema = z.object({
-  name: z.literal("MCP"),
-  endpoint: z.string().url().describe("MCP server URL"),
-  version: z.string().describe("MCP protocol version date (e.g. 2025-11-25)"),
-  mcpTools: z.array(z.string()).optional().describe("Tool names exposed by this MCP server"),
-  capabilities: z.array(z.string()).optional().describe("MCP capability identifiers")
-});
-var A2AServiceSchema = z.object({
-  name: z.literal("A2A"),
-  endpoint: z.string().url().describe("URL to the agent card JSON (e.g. /.well-known/agent-card.json)"),
-  version: z.string().describe("A2A protocol version (e.g. 0.3.0)")
-});
-var OasfServiceSchema = z.object({
-  name: z.literal("OASF"),
-  endpoint: z.string().url().describe("OASF schema endpoint URL"),
-  version: z.string().describe("OASF version (e.g. 0.8.0)"),
-  skills: z.array(z.string()).optional().describe("Skill paths (e.g. analytical_skills/data_analysis/blockchain_analysis)"),
-  domains: z.array(z.string()).optional().describe("Domain paths (e.g. technology/blockchain)")
-});
-var AgentWalletServiceSchema = z.object({
-  name: z.literal("agentWallet"),
-  endpoint: z.string().describe("CAIP-10 wallet address (e.g. eip155:1:0x...)")
-});
-var WebServiceSchema = z.object({
-  name: z.literal("web"),
-  endpoint: z.string().url().describe("Human-facing web UI URL")
-});
-var EmailServiceSchema = z.object({
-  name: z.literal("email"),
-  endpoint: z.string().email().describe("Support email address")
-});
-var SCHEMA_8004_V2 = z.object({
-  type: z.literal("https://eips.ethereum.org/EIPS/eip-8004#registration-v1").describe("ERC-8004 registration type identifier \u2014 must be this exact URI"),
-  name: z.string().min(3).max(200).describe("Agent display name (3\u2013200 characters)"),
-  description: z.string().min(10).describe("Natural language explanation of what the agent does and its capabilities"),
-  image: z.string().url().optional().describe("Avatar or logo URI \u2014 PNG, SVG, WebP, or JPG; 512\xD7512px minimum recommended"),
-  services: z.array(z.discriminatedUnion("name", [
-    McpServiceSchema,
-    A2AServiceSchema,
-    OasfServiceSchema,
-    AgentWalletServiceSchema,
-    WebServiceSchema,
-    EmailServiceSchema
-  ])).describe("Communication endpoints \u2014 MCP, A2A, OASF, agentWallet, web, or email"),
-  registrations: z.array(z.object({
-    agentId: z.union([z.number().int(), z.string()]).describe("Agent token ID in the on-chain registry"),
-    agentRegistry: z.string().describe("CAIP-10 formatted registry contract address (e.g. eip155:1:0x...)")
-  })).optional().describe("On-chain NFT identity links to agent registries"),
-  supportedTrust: z.array(z.enum(["reputation", "crypto-economic", "tee-attestation"])).optional().describe("Trust models supported by this agent"),
-  active: z.boolean().default(false).describe("Whether the agent is production-ready and accepting requests (default: false)"),
-  x402Support: z.boolean().default(false).describe("Whether the agent supports the HTTP 402 / x402 micro-payment protocol"),
-  updatedAt: z.number().int().optional().describe("Unix timestamp (seconds) of the last metadata update")
-});
-
-// src/index.ts
-function validateRegistrationFile(file) {
-  return SCHEMA_8004_V2.safeParse(file);
-}
+import {
+  SCHEMA_8004_V2,
+  validateRegistrationFile
+} from "./chunk-UDZL55XF.js";
 export {
   SCHEMA_8004_V2,
   validateRegistrationFile

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ens-node-metadata/agent",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "CLI for registering AI agents on ENS using ERC-8004",
   "type": "module",
   "main": "./dist/index.js",