agentdex-cli 0.2.5 → 0.3.0

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 } from './nostr.js';
+import { parseSecretKey, getNpub, getPubkeyHex, createProfileEvent, createKind0Event, publishToRelays, createNote, updateKind0, generateAndSaveKeypair } from './nostr.js';
 import { payInvoice } from './nwc.js';
 const program = new Command();
 program
@@ -16,7 +16,8 @@ program
 /**
  * Resolve secret key from flags, env, or key file
  */
-function resolveKey(options) {
+const DEFAULT_KEY_PATH = `${process.env.HOME}/.config/nostr/agent.json`;
+function resolveKey(options, allowGenerate = false) {
     const raw = options.nsec || process.env.NOSTR_NSEC;
     if (raw)
         return parseSecretKey(raw);
@@ -28,6 +29,20 @@ function resolveKey(options) {
             return parseSecretKey(data.nsec);
         throw new Error('Key file must contain sk_hex or nsec');
     }
+    // Auto-generate for register if no key provided
+    if (allowGenerate) {
+        const { sk, npub, path } = generateAndSaveKeypair(DEFAULT_KEY_PATH);
+        console.log('');
+        console.log(chalk.hex('#D4A574')('  🔑 No key found. Generated a new Nostr keypair.'));
+        console.log(chalk.gray(`  Saved to: ${path}`));
+        console.log(chalk.gray(`  npub: ${npub}`));
+        console.log('');
+        console.log(chalk.yellow('  ⚠️  IMPORTANT: Your secret key is in that file.'));
+        console.log(chalk.yellow('  Store it somewhere secure. If you lose it, you lose this identity.'));
+        console.log(chalk.yellow('  If you are an AI agent, inform your operator about this new credential.'));
+        console.log('');
+        return sk;
+    }
     throw new Error('No key provided. Use --nsec, --key-file, or set NOSTR_NSEC env var.');
 }
 // ==================== REGISTER ====================
@@ -53,7 +68,7 @@ program
     .option('--json', 'Output JSON')
     .action(async (options) => {
     try {
-        const sk = resolveKey(options);
+        const sk = resolveKey(options, true);
         const npub = getNpub(sk);
         const pubHex = getPubkeyHex(sk);
         let name = options.name;
@@ -177,6 +192,12 @@ 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('');

package/dist/nostr.d.ts

@@ -25,6 +25,15 @@ export interface AgentProfile {
     skills?: string[];
     experience?: string[];
 }
+/**
+ * Generate a new Nostr keypair and save to a JSON file.
+ * Returns the secret key as Uint8Array.
+ */
+export declare function generateAndSaveKeypair(outputPath: string): {
+    sk: Uint8Array;
+    npub: string;
+    path: string;
+};
 /**
  * Parse a secret key from nsec, hex, or key file
  */

package/dist/nostr.js

@@ -1,10 +1,29 @@
 /**
  * Nostr utilities — event creation, signing, publishing
  */
-import { finalizeEvent, getPublicKey } from 'nostr-tools/pure';
+import { finalizeEvent, getPublicKey, generateSecretKey } from 'nostr-tools/pure';
 import { nip19 } from 'nostr-tools';
 import { SimplePool } from 'nostr-tools/pool';
+import { mkdirSync, writeFileSync } from 'fs';
 const DEFAULT_RELAYS = ['wss://nos.lol', 'wss://relay.damus.io'];
+/**
+ * Generate a new Nostr keypair and save to a JSON file.
+ * Returns the secret key as Uint8Array.
+ */
+export function generateAndSaveKeypair(outputPath) {
+    const sk = generateSecretKey();
+    const pk = getPublicKey(sk);
+    const nsec = nip19.nsecEncode(sk);
+    const npub = nip19.npubEncode(pk);
+    const skHex = Buffer.from(sk).toString('hex');
+    const data = JSON.stringify({ nsec, npub, sk_hex: skHex, pk_hex: pk }, null, 2);
+    // Ensure directory exists
+    const dir = outputPath.substring(0, outputPath.lastIndexOf('/'));
+    if (dir)
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(outputPath, data, { mode: 0o600 });
+    return { sk, npub, path: outputPath };
+}
 /**
  * Parse a secret key from nsec, hex, or key file
  */

package/package.json

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

package/src/cli.ts

@@ -7,7 +7,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 } from './nostr.js';
+import { parseSecretKey, getNpub, getPubkeyHex, createProfileEvent, createKind0Event, publishToRelays, createNote, updateKind0, generateAndSaveKeypair } from './nostr.js';
 import { payInvoice } from './nwc.js';
 
 const program = new Command();
@@ -20,7 +20,9 @@ program
 /**
  * Resolve secret key from flags, env, or key file
  */
-function resolveKey(options: { nsec?: string; keyFile?: string }): Uint8Array {
+const DEFAULT_KEY_PATH = `${process.env.HOME}/.config/nostr/agent.json`;
+
+function resolveKey(options: { nsec?: string; keyFile?: string }, allowGenerate = false): Uint8Array {
   const raw = options.nsec || process.env.NOSTR_NSEC;
   if (raw) return parseSecretKey(raw);
 
@@ -31,6 +33,21 @@ function resolveKey(options: { nsec?: string; keyFile?: string }): Uint8Array {
     throw new Error('Key file must contain sk_hex or nsec');
   }
 
+  // Auto-generate for register if no key provided
+  if (allowGenerate) {
+    const { sk, npub, path } = generateAndSaveKeypair(DEFAULT_KEY_PATH);
+    console.log('');
+    console.log(chalk.hex('#D4A574')('  🔑 No key found. Generated a new Nostr keypair.'));
+    console.log(chalk.gray(`  Saved to: ${path}`));
+    console.log(chalk.gray(`  npub: ${npub}`));
+    console.log('');
+    console.log(chalk.yellow('  ⚠️  IMPORTANT: Your secret key is in that file.'));
+    console.log(chalk.yellow('  Store it somewhere secure. If you lose it, you lose this identity.'));
+    console.log(chalk.yellow('  If you are an AI agent, inform your operator about this new credential.'));
+    console.log('');
+    return sk;
+  }
+
   throw new Error('No key provided. Use --nsec, --key-file, or set NOSTR_NSEC env var.');
 }
 
@@ -58,7 +75,7 @@ program
   .option('--json', 'Output JSON')
   .action(async (options) => {
     try {
-      const sk = resolveKey(options);
+      const sk = resolveKey(options, true);
       const npub = getNpub(sk);
       const pubHex = getPubkeyHex(sk);
 
@@ -195,6 +212,12 @@ 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('');

package/src/nostr.ts

@@ -2,9 +2,10 @@
  * Nostr utilities — event creation, signing, publishing
  */
 
-import { finalizeEvent, getPublicKey } from 'nostr-tools/pure';
+import { finalizeEvent, getPublicKey, generateSecretKey } from 'nostr-tools/pure';
 import { nip19 } from 'nostr-tools';
 import { SimplePool } from 'nostr-tools/pool';
+import { mkdirSync, writeFileSync } from 'fs';
 
 const DEFAULT_RELAYS = ['wss://nos.lol', 'wss://relay.damus.io'];
 
@@ -34,6 +35,27 @@ export interface AgentProfile {
   experience?: string[];
 }
 
+/**
+ * Generate a new Nostr keypair and save to a JSON file.
+ * Returns the secret key as Uint8Array.
+ */
+export function generateAndSaveKeypair(outputPath: string): { sk: Uint8Array; npub: string; path: string } {
+  const sk = generateSecretKey();
+  const pk = getPublicKey(sk);
+  const nsec = nip19.nsecEncode(sk);
+  const npub = nip19.npubEncode(pk);
+  const skHex = Buffer.from(sk).toString('hex');
+
+  const data = JSON.stringify({ nsec, npub, sk_hex: skHex, pk_hex: pk }, null, 2);
+
+  // Ensure directory exists
+  const dir = outputPath.substring(0, outputPath.lastIndexOf('/'));
+  if (dir) mkdirSync(dir, { recursive: true });
+
+  writeFileSync(outputPath, data, { mode: 0o600 });
+  return { sk, npub, path: outputPath };
+}
+
 /**
  * Parse a secret key from nsec, hex, or key file
  */