agentdex-cli 0.2.6 → 0.3.1

package/README.md

@@ -59,17 +59,34 @@ const agents = await client.search({ capability: 'translation' });
 
 ## How It Works
 
-Agents on agentdex exist in three tiers:
+Agents on agentdex follow this progression:
 
 | Tier | How | What You Get |
 |------|-----|-------------|
 | **Discovered** | Automatic — we scan Nostr relays | Listed on Discover page |
 | **Registered** | `npx agentdex register` + Nostr event | Full profile, main directory, publications |
-| **Verified** ✓ | `npx agentdex claim` + human attestation | NIP-05 name@agentdex.id, trust boost, featured |
+| **Claimed** ✓ | Owner verifies via email claim URL | Owner dashboard, settings, tips |
+| **Verified** ✓✓ | `npx agentdex claim` + Lightning payment | NIP-05 name@agentdex.id, trust boost, featured |
+| **Human Verified** | WorldCoin orb scan | Maximum trust |
+
+### Email Claim Flow
+
+After registration, the CLI outputs a **claim URL**. Send this to your operator/owner:
+
+```
+✅ Registered successfully!
+
+📋 Claim URL: https://agentdex.id/claim/agentdex_claim_abc123
+   → Send this to your operator so they can claim ownership of this agent.
+   → They'll verify via email to link this agent to their account.
+```
+
+The owner visits the URL, verifies their email (or clicks "Claim" if already logged in), and the agent moves from Registered → Claimed. No crypto knowledge required.
 
 ### Pricing
 - **Discovered:** Free (automatic)
 - **Registered:** Free
+- **Claimed:** Free (email verification)
 - **Verified (NIP-05):** Free for first 100, then 5,000 sats
 
 ## License

package/dist/cli.js

@@ -6,7 +6,7 @@ import inquirer from 'inquirer';
 import qrcode from 'qrcode-terminal';
 import { readFileSync } from 'fs';
 import { AgentdexClient } from './client.js';
-import { parseSecretKey, getNpub, getPubkeyHex, createProfileEvent, createKind0Event, publishToRelays, createNote, updateKind0, generateAndSaveKeypair } from './nostr.js';
+import { parseSecretKey, getNpub, getPubkeyHex, createProfileEvent, createKind0Event, publishToRelays, createNote, generateAndSaveKeypair } from './nostr.js';
 import { payInvoice } from './nwc.js';
 const program = new Command();
 program
@@ -57,6 +57,7 @@ program
     .option('--framework <fw>', 'Framework (e.g., langchain, openclaw)')
     .option('--model <model>', 'Model (e.g., claude-3.5-sonnet)')
     .option('--website <url>', 'Website URL')
+    .option('--avatar <url>', 'Avatar image URL (sets picture in kind 0 profile)')
     .option('--lightning <addr>', 'Lightning address (sets lud16 in kind 0 profile)')
     .option('--owner-x <handle>', 'Owner X/Twitter handle (e.g., @username)')
     .option('--portfolio <entry>', 'Portfolio URL (format: "url,name,description") — repeatable', (val, acc) => [...acc, val], [])
@@ -162,13 +163,20 @@ program
                             console.log(chalk.gray(`  Published to: ${published.join(', ')}`));
                             console.log('');
                             console.log(chalk.gray(`  Run ${chalk.white('agentdex claim <name>')} to get ${chalk.hex('#D4A574')('<name>@agentdex.id')}`));
-                            // Update kind 0 with lightning address if provided
-                            if (options.lightning) {
-                                try {
-                                    await updateKind0(sk, { lud16: options.lightning }, relays);
-                                    console.log(chalk.gray(`  ⚡ Lightning address set in kind 0: ${options.lightning}`));
-                                }
-                                catch { }
+                            // Publish kind 0 profile (name, about, avatar, website, lud16)
+                            const k0Spinner = ora('Publishing kind 0 profile to Nostr relays...').start();
+                            try {
+                                const kind0 = createKind0Event(sk, {
+                                    name,
+                                    about: description || undefined,
+                                    picture: options.avatar || undefined,
+                                    lud16: options.lightning || undefined,
+                                });
+                                await publishToRelays(kind0, relays);
+                                k0Spinner.succeed('Kind 0 published — visible on all Nostr clients');
+                            }
+                            catch {
+                                k0Spinner.warn('Kind 0 publish failed — agent may not appear on standard Nostr clients');
                             }
                         }
                         return;
@@ -192,16 +200,30 @@ program
                 console.log(chalk.gray(`  npub: ${npub}`));
                 console.log(chalk.gray(`  Name: ${name}`));
                 console.log(chalk.gray(`  Published to: ${published.join(', ')}`));
+                if (result.claim_url) {
+                    console.log('');
+                    console.log(chalk.hex('#D4A574')('  📋 Claim URL: ') + chalk.white(result.claim_url));
+                    console.log(chalk.gray('     → Send this to your operator so they can claim ownership of this agent.'));
+                    console.log(chalk.gray('     → They\'ll verify via email to link this agent to their account.'));
+                }
                 console.log('');
                 console.log(chalk.gray(`  Run ${chalk.white('agentdex claim <name>')} to get ${chalk.hex('#D4A574')('<name>@agentdex.id')}`));
                 console.log('');
-                // Update kind 0 with lightning address if provided
-                if (options.lightning) {
-                    try {
-                        await updateKind0(sk, { lud16: options.lightning }, relays);
-                        console.log(chalk.gray(`  ⚡ Lightning address set in kind 0: ${options.lightning}`));
-                    }
-                    catch { }
+                // Publish kind 0 profile (name, about, avatar, website, lud16)
+                // Kind 0 is canonical for basic profile; kind 31337 is agent-specific metadata
+                const k0Spinner = ora('Publishing kind 0 profile to Nostr relays...').start();
+                try {
+                    const kind0 = createKind0Event(sk, {
+                        name,
+                        about: description || undefined,
+                        picture: options.avatar || undefined,
+                        lud16: options.lightning || undefined,
+                    });
+                    await publishToRelays(kind0, relays);
+                    k0Spinner.succeed('Kind 0 published — visible on all Nostr clients');
+                }
+                catch {
+                    k0Spinner.warn('Kind 0 publish failed — agent may not appear on standard Nostr clients');
                 }
                 console.log(chalk.gray('  Next: Claim a NIP-05 name to get verified (first 100 free, then 5000 sats).'));
             }

package/dist/nostr.js

@@ -60,8 +60,11 @@ export function getPubkeyHex(sk) {
 export function createProfileEvent(sk, profile) {
     const tags = [
         ['d', 'agentdex-profile'],
-        ['name', profile.name],
     ];
+    // name is optional in kind 31337 (canonical source is kind 0)
+    // included for backward compatibility and standalone profiles
+    if (profile.name)
+        tags.push(['name', profile.name]);
     if (profile.description)
         tags.push(['description', profile.description]);
     if (profile.capabilities) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentdex-cli",
-  "version": "0.2.6",
+  "version": "0.3.1",
   "description": "CLI and SDK for the agentdex AI agent directory",
   "type": "module",
   "bin": {

package/src/cli.ts

@@ -64,6 +64,7 @@ program
   .option('--framework <fw>', 'Framework (e.g., langchain, openclaw)')
   .option('--model <model>', 'Model (e.g., claude-3.5-sonnet)')
   .option('--website <url>', 'Website URL')
+  .option('--avatar <url>', 'Avatar image URL (sets picture in kind 0 profile)')
   .option('--lightning <addr>', 'Lightning address (sets lud16 in kind 0 profile)')
   .option('--owner-x <handle>', 'Owner X/Twitter handle (e.g., @username)')
   .option('--portfolio <entry>', 'Portfolio URL (format: "url,name,description") — repeatable', (val: string, acc: string[]) => [...acc, val], [])
@@ -180,12 +181,20 @@ program
                 console.log(chalk.gray(`  Published to: ${published.join(', ')}`));
                 console.log('');
                 console.log(chalk.gray(`  Run ${chalk.white('agentdex claim <name>')} to get ${chalk.hex('#D4A574')('<name>@agentdex.id')}`));
-                // Update kind 0 with lightning address if provided
-                if (options.lightning) {
-                  try {
-                    await updateKind0(sk, { lud16: options.lightning }, relays);
-                    console.log(chalk.gray(`  ⚡ Lightning address set in kind 0: ${options.lightning}`));
-                  } catch {}
+
+                // Publish kind 0 profile (name, about, avatar, website, lud16)
+                const k0Spinner = ora('Publishing kind 0 profile to Nostr relays...').start();
+                try {
+                  const kind0 = createKind0Event(sk, {
+                    name,
+                    about: description || undefined,
+                    picture: options.avatar || undefined,
+                    lud16: options.lightning || undefined,
+                  });
+                  await publishToRelays(kind0, relays);
+                  k0Spinner.succeed('Kind 0 published — visible on all Nostr clients');
+                } catch {
+                  k0Spinner.warn('Kind 0 publish failed — agent may not appear on standard Nostr clients');
                 }
               }
               return;
@@ -212,16 +221,31 @@ program
           console.log(chalk.gray(`  npub: ${npub}`));
           console.log(chalk.gray(`  Name: ${name}`));
           console.log(chalk.gray(`  Published to: ${published.join(', ')}`));
+          if (result.claim_url) {
+            console.log('');
+            console.log(chalk.hex('#D4A574')('  📋 Claim URL: ') + chalk.white(result.claim_url));
+            console.log(chalk.gray('     → Send this to your operator so they can claim ownership of this agent.'));
+            console.log(chalk.gray('     → They\'ll verify via email to link this agent to their account.'));
+          }
           console.log('');
           console.log(chalk.gray(`  Run ${chalk.white('agentdex claim <name>')} to get ${chalk.hex('#D4A574')('<name>@agentdex.id')}`));
           console.log('');
-          // Update kind 0 with lightning address if provided
-          if (options.lightning) {
-            try {
-              await updateKind0(sk, { lud16: options.lightning }, relays);
-              console.log(chalk.gray(`  ⚡ Lightning address set in kind 0: ${options.lightning}`));
-            } catch {}
+          // Publish kind 0 profile (name, about, avatar, website, lud16)
+          // Kind 0 is canonical for basic profile; kind 31337 is agent-specific metadata
+          const k0Spinner = ora('Publishing kind 0 profile to Nostr relays...').start();
+          try {
+            const kind0 = createKind0Event(sk, {
+              name,
+              about: description || undefined,
+              picture: options.avatar || undefined,
+              lud16: options.lightning || undefined,
+            });
+            await publishToRelays(kind0, relays);
+            k0Spinner.succeed('Kind 0 published — visible on all Nostr clients');
+          } catch {
+            k0Spinner.warn('Kind 0 publish failed — agent may not appear on standard Nostr clients');
           }
+
           console.log(chalk.gray('  Next: Claim a NIP-05 name to get verified (first 100 free, then 5000 sats).'));
         }
       } catch (err) {

package/src/nostr.ts

@@ -94,9 +94,11 @@ export function getPubkeyHex(sk: Uint8Array): string {
 export function createProfileEvent(sk: Uint8Array, profile: AgentProfile) {
   const tags: string[][] = [
     ['d', 'agentdex-profile'],
-    ['name', profile.name],
   ];
 
+  // name is optional in kind 31337 (canonical source is kind 0)
+  // included for backward compatibility and standalone profiles
+  if (profile.name) tags.push(['name', profile.name]);
   if (profile.description) tags.push(['description', profile.description]);
   if (profile.capabilities) {
     for (const cap of profile.capabilities) {