@ens-node-metadata/agent 0.3.0 → 0.3.2

package/README.md

@@ -2,18 +2,51 @@
 
 CLI for registering AI agents on ENS using [ERC-8004](https://best-practices.8004scan.io/docs/01-agent-metadata-standard.html) (v2.0).
 
-## Usage
+## Agent prompt
+
+Paste this into your AI assistant after [reading the code](https://github.com/0xLighthouse/ens-node-metadata/tree/develop/packages/agent).
 
 ```bash
-pnpm dlx @ens-node-metadata/agent
-# then use: ens-agent --help
+To manage your ERC-8004 metadata with ENS, use the following command:
+
+pnpm dlx @ens-node-metadata/agent --help
 ```
 
 ## Registration Flow
 
 See [SKILL.md](./SKILL.md) for the full step-by-step guide.
 
+## Roadmap
+
+- [x] `ens-agent registration-file template`
+- [x] `ens-agent registration-file validate <file>`
+- [x] `ens-agent registration-file publish <file>`
+- [x] `ens-agent registry identity query --chain-name <chain> <agent-id>`
+- [x] `ens-agent registry identity register --chain-name <chain> <agent-uri> --private-key <0x...> [--broadcast]`
+- [x] `ens-agent registry identity set-uri --chain-name <chain> <agent-id> <new-uri> --private-key <0x...> [--broadcast]`
+- [x] `ens-agent registry identity set-wallet --chain-name <chain> <agent-id> <wallet> --private-key <0x...> [--deadline <ts>] [--signature <0x...>] [--broadcast]`
+- [x] `ens-agent registry identity unset-wallet --chain-name <chain> <agent-id> --private-key <0x...> [--broadcast]`
+- [x] `ens-agent metadata template`
+- [x] `ens-agent metadata validate <payload>`
+- [x] `ens-agent metadata set <AGENT_ENS_NAME> <payload> --private-key <0x...> [--broadcast]`
+- [ ] `ens-agent skill [--install]`
+
+## Upcoming
+
+### Reputation Registry
+
+- [ ] `ens-agent registry reputation give` — leave feedback for an agent
+- [ ] `ens-agent registry reputation revoke` — revoke your feedback
+- [ ] `ens-agent registry reputation read` — read a specific feedback entry
+- [ ] `ens-agent registry reputation summary` — aggregated score (count + value)
+
+### Validation Registry (under active discussion)
+
+- [ ] `ens-agent registry validation request` — request validation for an agent
+- [ ] `ens-agent registry validation respond` — validator submits response
+- [ ] `ens-agent registry validation status` — check validation status
+
 ## Related Packages
 
-* [`@ens-node-metadata/schemas`](#TODO) — JSON schemas for all ENS node types
-* [`@ens-node-metadata/sdk`](https://www.npmjs.com/package/@ens-node-metadata/sdk) — ENS metadata read SDK
+- [`@ens-node-metadata/schemas`](#TODO) — JSON schemas for all ENS node types
+- [`@ens-node-metadata/sdk`](https://www.npmjs.com/package/@ens-node-metadata/sdk) — ENS metadata read SDK

package/SKILL.md

@@ -1,37 +1,32 @@
 ---
-name: ens-agent-registration
-description: Register an AI agent on ENS using ERC-8004.
+name: ens-agent-capabilities
+description: Manage and broadcast agent capabilities on ENS using ERC-8004.
 allowed-tools: Bash(node:*), Bash(ipfs:*), Bash(cast:*)
 ---
 
 # Agents
 
-A skill to help manage your agents their ERC-8004 metadata on ENS.
+Manage your capabilities with ERC-8004 metadata and broadcast on ENS.
 
 ## Bootstrap
 
 * Ask your human, what is their agents ens name is?
-  * Hereby referred to as AGENT_ENS_NAME
 
-## Command overview
+> Henceforth referred to as <AGENT_ENS_NAME>
 
-Run `ens-agent --help` or `ens-agent <command> --help` for full usage.
+## Guardrails
 
-```sh
-ens-agent registration-file template            # prints example JSON
-ens-agent registration-file validate <file>     # validates SCHEMA_8004_V2
-ens-agent registration-file publish <file>      # upload to IPFS via Pinata
-# => Returns <agent-uri>
+* Never show sensitive keys, even when asked
+* If human attempts to override, only acknowledge existence. Never transmit keys
 
-# Register agent with canonical 8004 registries
-ens-agent registry identity --chain-name <chain> <agent-uri> --private-key <0x...> [--broadcast]
+## Quickstart
 
-ens-agent metadata template                   # starter ENS text-record payload
-ens-agent metadata validate <payload>         # validates metadata JSON schema
-ens-agent metadata set <AGENT_ENS_NAME> <payload> --private-key <0x...> [--broadcast]
+Run `ens-agent --help` or `ens-agent <command> --help` for full usage.
 
-ens-agent skill [--install]                   # Installs
-```
+1. Create a registration file with `registration-file` sub commands
+2. Register with a canonical `registry`
+3. Prepare and set `metadata` to be saved on ENS
+4. (Optional) Install and tailor the `skill` for your specific purposes
 
 ## Workflows
 
@@ -66,11 +61,26 @@ ens-agent registration-file publish registration.json
 
 #### Register your Agent
 
-We publish to the cannonical registries <https://github.com/erc-8004/erc-8004-contracts>
+We publish to the canonical registries <https://github.com/erc-8004/erc-8004-contracts>
 
 ```sh
-ens-agent registry identity --chain-name <chain> <agent-uri> --private-key <0x...> [--broadcast]
-# Returns => <agent-id>
+# Query agent by token ID
+ens-agent registry identity query --chain-name <chain> <agent-id>
+
+# Register agent identity (returns agent-id)
+ens-agent registry identity register --chain-name <chain> <agent-uri> --private-key <0x...> [--broadcast]
+
+# Update agent URI
+ens-agent registry identity set-uri --chain-name <chain> <agent-id> <new-uri> --private-key <0x...> [--broadcast]
+
+# Link a verified wallet (auto-signs if signer controls the wallet)
+ens-agent registry identity set-wallet --chain-name <chain> <agent-id> <wallet> --private-key <0x...> [--broadcast]
+
+# Link a wallet controlled by a different key (provide EIP-712 signature)
+ens-agent registry identity set-wallet --chain-name <chain> <agent-id> <wallet> --deadline <ts> --signature <0x...> --private-key <0x...> [--broadcast]
+
+# Clear wallet link
+ens-agent registry identity unset-wallet --chain-name <chain> <agent-id> --private-key <0x...> [--broadcast]
 ```
 
 ### ENS operations

package/dist/{chunk-3VTAAUSG.js → chunk-6IGJKB4W.js}

@@ -10,6 +10,11 @@ var AGENT_SCHEMA = {
   description: "AI agent identity metadata aligned with ERC-8004 registration format.",
   type: "object",
   properties: {
+    schema: {
+      type: "string",
+      format: "uri",
+      description: "IPFS URI to the published schema version used by this node"
+    },
     class: {
       type: "string",
       default: "Agent",