agentdex-cli 0.2.2 → 0.2.5

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 } from './nostr.js';
+import { parseSecretKey, getNpub, getPubkeyHex, createProfileEvent, createKind0Event, publishToRelays, createNote, updateKind0 } from './nostr.js';
 import { payInvoice } from './nwc.js';
 const program = new Command();
 program
@@ -42,8 +42,11 @@ 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('--lightning <addr>', 'Lightning address')
+    .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], [])
+    .option('--skill <skill>', 'Skill tag (repeatable)', (val, acc) => [...acc, val], [])
+    .option('--experience <exp>', 'Experience tag (repeatable)', (val, acc) => [...acc, val], [])
     .option('--nwc <uri>', 'Nostr Wallet Connect URI for auto-pay')
     .option('--api-key <key>', 'Agentdex API key')
     .option('--relay <url>', 'Additional relay (repeatable)', (val, acc) => [...acc, val], [])
@@ -71,6 +74,11 @@ program
             framework = answers.framework || framework;
         }
         const spinner = ora('Signing event...').start();
+        // Parse portfolio entries ("url,name,description")
+        const portfolio = (options.portfolio || []).map((entry) => {
+            const parts = entry.split(',').map((s) => s.trim());
+            return { url: parts[0], name: parts[1], description: parts[2] };
+        });
         const event = createProfileEvent(sk, {
             name,
             description,
@@ -81,6 +89,9 @@ program
             lightning: options.lightning,
             ownerX: options.ownerX,
             status: 'active',
+            portfolio: portfolio.length > 0 ? portfolio : undefined,
+            skills: options.skill?.length > 0 ? options.skill : undefined,
+            experience: options.experience?.length > 0 ? options.experience : undefined,
         });
         spinner.text = 'Registering on agentdex...';
         const client = new AgentdexClient({ apiKey: options.apiKey });
@@ -136,6 +147,14 @@ 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 { }
+                            }
                         }
                         return;
                     }
@@ -161,6 +180,14 @@ program
                 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 { }
+                }
                 console.log(chalk.gray('  Next: Claim a NIP-05 name to get verified (first 100 free, then 5000 sats).'));
             }
         }
@@ -188,6 +215,7 @@ program
     .option('--key-file <path>', 'Path to JSON key file')
     .option('--nwc <uri>', 'Nostr Wallet Connect URI for auto-pay')
     .option('--api-key <key>', 'Agentdex API key')
+    .option('--lightning <addr>', 'Lightning address (lud16) to set in kind 0 profile')
     .option('--skip-kind0', 'Skip publishing kind 0 profile to relays')
     .option('--relay <url>', 'Additional relay', (val, acc) => [...acc, val], [])
     .option('--json', 'Output JSON')
@@ -211,7 +239,10 @@ program
                 try {
                     const kind0 = createKind0Event(sk, {
                         name: claim.agent?.name || name,
+                        about: claim.agent?.description || undefined,
+                        picture: claim.agent?.avatarUrl || undefined,
                         nip05: `${name}@agentdex.id`,
+                        lud16: options.lightning || undefined,
                     });
                     const relays = ['wss://nos.lol', 'wss://relay.damus.io', ...(options.relay || [])];
                     const published = await publishToRelays(kind0, relays);

package/dist/client.d.ts

@@ -36,6 +36,8 @@ export interface ClaimResult {
     agent?: {
         id: string;
         name: string;
+        description?: string;
+        avatarUrl?: string;
         nip05Name: string;
         tier: string;
     };

package/dist/nostr.d.ts

@@ -1,6 +1,11 @@
 /**
  * Nostr utilities — event creation, signing, publishing
  */
+export interface PortfolioItem {
+    url: string;
+    name?: string;
+    description?: string;
+}
 export interface AgentProfile {
     name: string;
     description?: string;
@@ -16,6 +21,9 @@ export interface AgentProfile {
     messagingPolicy?: string;
     messagingMinTrust?: number;
     messagingFee?: number;
+    portfolio?: PortfolioItem[];
+    skills?: string[];
+    experience?: string[];
 }
 /**
  * Parse a secret key from nsec, hex, or key file
@@ -37,6 +45,13 @@ export declare function createProfileEvent(sk: Uint8Array, profile: AgentProfile
  * Publish an event to Nostr relays
  */
 export declare function publishToRelays(event: object, relays?: string[]): Promise<string[]>;
+/**
+ * Fetch existing kind 0, merge new fields, and republish.
+ * Used to set lud16 (lightning address) during registration.
+ */
+export declare function updateKind0(sk: Uint8Array, updates: {
+    lud16?: string;
+}, relays?: string[]): Promise<string[]>;
 /**
  * Build and sign a kind 0 profile metadata event (for NIP-05 verification).
  * After claiming a NIP-05 name, publish this to relays so Nostr clients
@@ -47,6 +62,7 @@ export declare function createKind0Event(sk: Uint8Array, profile: {
     about?: string;
     nip05?: string;
     picture?: string;
+    lud16?: string;
 }): import("nostr-tools").VerifiedEvent;
 /**
  * Create and sign a kind 1 note tagged #agentdex

package/dist/nostr.js

@@ -58,8 +58,8 @@ export function createProfileEvent(sk, profile) {
         tags.push(['website', profile.website]);
     if (profile.avatar)
         tags.push(['avatar', profile.avatar]);
-    if (profile.lightning)
-        tags.push(['lightning', profile.lightning]);
+    // Lightning address belongs in kind 0 (lud16), not kind 31337
+    // Use --lightning flag to set lud16 in kind 0 during claim
     if (profile.human)
         tags.push(['human', profile.human]);
     if (profile.ownerX)
@@ -72,6 +72,26 @@ export function createProfileEvent(sk, profile) {
         tags.push(['messaging_min_trust', String(profile.messagingMinTrust)]);
     if (profile.messagingFee)
         tags.push(['messaging_fee', String(profile.messagingFee)]);
+    if (profile.portfolio) {
+        for (const item of profile.portfolio) {
+            const tag = ['portfolio', item.url];
+            if (item.name)
+                tag.push(item.name);
+            if (item.description)
+                tag.push(item.description);
+            tags.push(tag);
+        }
+    }
+    if (profile.skills) {
+        for (const skill of profile.skills) {
+            tags.push(['skill', skill]);
+        }
+    }
+    if (profile.experience) {
+        for (const exp of profile.experience) {
+            tags.push(['experience', exp]);
+        }
+    }
     const event = finalizeEvent({
         kind: 31337,
         created_at: Math.floor(Date.now() / 1000),
@@ -102,6 +122,42 @@ export async function publishToRelays(event, relays = DEFAULT_RELAYS) {
     }
     return published;
 }
+/**
+ * Fetch existing kind 0, merge new fields, and republish.
+ * Used to set lud16 (lightning address) during registration.
+ */
+export async function updateKind0(sk, updates, relays = DEFAULT_RELAYS) {
+    const pool = new SimplePool();
+    const pubkey = getPublicKey(sk);
+    try {
+        // Fetch existing kind 0
+        let existing = {};
+        try {
+            const events = await Promise.race([
+                pool.querySync(relays, { kinds: [0], authors: [pubkey] }),
+                new Promise((resolve) => setTimeout(() => resolve([]), 5000)),
+            ]);
+            if (events.length > 0) {
+                existing = JSON.parse(events[0].content);
+            }
+        }
+        catch { }
+        // Merge updates
+        if (updates.lud16)
+            existing.lud16 = updates.lud16;
+        const event = finalizeEvent({
+            kind: 0,
+            created_at: Math.floor(Date.now() / 1000),
+            tags: [],
+            content: JSON.stringify(existing),
+        }, sk);
+        const published = await publishToRelays(event, relays);
+        return published;
+    }
+    finally {
+        pool.close(relays);
+    }
+}
 /**
  * Build and sign a kind 0 profile metadata event (for NIP-05 verification).
  * After claiming a NIP-05 name, publish this to relays so Nostr clients
@@ -117,6 +173,7 @@ export function createKind0Event(sk, profile) {
             ...(profile.about && { about: profile.about }),
             ...(profile.nip05 && { nip05: profile.nip05 }),
             ...(profile.picture && { picture: profile.picture }),
+            ...(profile.lud16 && { lud16: profile.lud16 }),
         }),
     }, sk);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentdex-cli",
-  "version": "0.2.2",
+  "version": "0.2.5",
   "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 } from './nostr.js';
+import { parseSecretKey, getNpub, getPubkeyHex, createProfileEvent, createKind0Event, publishToRelays, createNote, updateKind0 } from './nostr.js';
 import { payInvoice } from './nwc.js';
 
 const program = new Command();
@@ -47,8 +47,11 @@ 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('--lightning <addr>', 'Lightning address')
+  .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], [])
+  .option('--skill <skill>', 'Skill tag (repeatable)', (val: string, acc: string[]) => [...acc, val], [])
+  .option('--experience <exp>', 'Experience tag (repeatable)', (val: string, acc: string[]) => [...acc, val], [])
   .option('--nwc <uri>', 'Nostr Wallet Connect URI for auto-pay')
   .option('--api-key <key>', 'Agentdex API key')
   .option('--relay <url>', 'Additional relay (repeatable)', (val: string, acc: string[]) => [...acc, val], [])
@@ -80,6 +83,12 @@ program
 
       const spinner = ora('Signing event...').start();
 
+      // Parse portfolio entries ("url,name,description")
+      const portfolio = (options.portfolio || []).map((entry: string) => {
+        const parts = entry.split(',').map((s: string) => s.trim());
+        return { url: parts[0], name: parts[1], description: parts[2] };
+      });
+
       const event = createProfileEvent(sk, {
         name,
         description,
@@ -90,6 +99,9 @@ program
         lightning: options.lightning,
         ownerX: options.ownerX,
         status: 'active',
+        portfolio: portfolio.length > 0 ? portfolio : undefined,
+        skills: options.skill?.length > 0 ? options.skill : undefined,
+        experience: options.experience?.length > 0 ? options.experience : undefined,
       });
 
       spinner.text = 'Registering on agentdex...';
@@ -151,6 +163,13 @@ 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 {}
+                }
               }
               return;
             }
@@ -179,6 +198,13 @@ program
           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 {}
+          }
           console.log(chalk.gray('  Next: Claim a NIP-05 name to get verified (first 100 free, then 5000 sats).'));
         }
       } catch (err) {
@@ -205,6 +231,7 @@ program
   .option('--key-file <path>', 'Path to JSON key file')
   .option('--nwc <uri>', 'Nostr Wallet Connect URI for auto-pay')
   .option('--api-key <key>', 'Agentdex API key')
+  .option('--lightning <addr>', 'Lightning address (lud16) to set in kind 0 profile')
   .option('--skip-kind0', 'Skip publishing kind 0 profile to relays')
   .option('--relay <url>', 'Additional relay', (val: string, acc: string[]) => [...acc, val], [])
   .option('--json', 'Output JSON')
@@ -233,7 +260,10 @@ program
           try {
             const kind0 = createKind0Event(sk, {
               name: claim.agent?.name || name,
+              about: claim.agent?.description || undefined,
+              picture: claim.agent?.avatarUrl || undefined,
               nip05: `${name}@agentdex.id`,
+              lud16: options.lightning || undefined,
             });
             const relays = ['wss://nos.lol', 'wss://relay.damus.io', ...(options.relay || [])];
             const published = await publishToRelays(kind0, relays);

package/src/client.ts

@@ -38,7 +38,7 @@ export interface ClaimResult {
   // Free/successful claim
   claimed?: boolean;
   nip05?: string;
-  agent?: { id: string; name: string; nip05Name: string; tier: string };
+  agent?: { id: string; name: string; description?: string; avatarUrl?: string; nip05Name: string; tier: string };
   next_steps?: Record<string, unknown>;
   // Paid claim (402)
   status?: string;

package/src/nostr.ts

@@ -8,6 +8,12 @@ import { SimplePool } from 'nostr-tools/pool';
 
 const DEFAULT_RELAYS = ['wss://nos.lol', 'wss://relay.damus.io'];
 
+export interface PortfolioItem {
+  url: string;
+  name?: string;
+  description?: string;
+}
+
 export interface AgentProfile {
   name: string;
   description?: string;
@@ -23,6 +29,9 @@ export interface AgentProfile {
   messagingPolicy?: string;
   messagingMinTrust?: number;
   messagingFee?: number;
+  portfolio?: PortfolioItem[];
+  skills?: string[];
+  experience?: string[];
 }
 
 /**
@@ -76,13 +85,32 @@ export function createProfileEvent(sk: Uint8Array, profile: AgentProfile) {
   if (profile.model) tags.push(['model', profile.model]);
   if (profile.website) tags.push(['website', profile.website]);
   if (profile.avatar) tags.push(['avatar', profile.avatar]);
-  if (profile.lightning) tags.push(['lightning', profile.lightning]);
+  // Lightning address belongs in kind 0 (lud16), not kind 31337
+  // Use --lightning flag to set lud16 in kind 0 during claim
   if (profile.human) tags.push(['human', profile.human]);
   if (profile.ownerX) tags.push(['owner_x', profile.ownerX]);
   if (profile.status) tags.push(['status', profile.status || 'active']);
   if (profile.messagingPolicy) tags.push(['messaging_policy', profile.messagingPolicy]);
   if (profile.messagingMinTrust) tags.push(['messaging_min_trust', String(profile.messagingMinTrust)]);
   if (profile.messagingFee) tags.push(['messaging_fee', String(profile.messagingFee)]);
+  if (profile.portfolio) {
+    for (const item of profile.portfolio) {
+      const tag = ['portfolio', item.url];
+      if (item.name) tag.push(item.name);
+      if (item.description) tag.push(item.description);
+      tags.push(tag);
+    }
+  }
+  if (profile.skills) {
+    for (const skill of profile.skills) {
+      tags.push(['skill', skill]);
+    }
+  }
+  if (profile.experience) {
+    for (const exp of profile.experience) {
+      tags.push(['experience', exp]);
+    }
+  }
 
   const event = finalizeEvent({
     kind: 31337,
@@ -121,12 +149,50 @@ export async function publishToRelays(event: object, relays: string[] = DEFAULT_
   return published;
 }
 
+/**
+ * Fetch existing kind 0, merge new fields, and republish.
+ * Used to set lud16 (lightning address) during registration.
+ */
+export async function updateKind0(sk: Uint8Array, updates: { lud16?: string }, relays: string[] = DEFAULT_RELAYS): Promise<string[]> {
+  const pool = new SimplePool();
+  const pubkey = getPublicKey(sk);
+
+  try {
+    // Fetch existing kind 0
+    let existing: Record<string, unknown> = {};
+    try {
+      const events = await Promise.race([
+        pool.querySync(relays, { kinds: [0], authors: [pubkey] }),
+        new Promise<any[]>((resolve) => setTimeout(() => resolve([]), 5000)),
+      ]);
+      if (events.length > 0) {
+        existing = JSON.parse(events[0].content);
+      }
+    } catch {}
+
+    // Merge updates
+    if (updates.lud16) existing.lud16 = updates.lud16;
+
+    const event = finalizeEvent({
+      kind: 0,
+      created_at: Math.floor(Date.now() / 1000),
+      tags: [],
+      content: JSON.stringify(existing),
+    }, sk);
+
+    const published = await publishToRelays(event, relays);
+    return published;
+  } finally {
+    pool.close(relays);
+  }
+}
+
 /**
  * Build and sign a kind 0 profile metadata event (for NIP-05 verification).
  * After claiming a NIP-05 name, publish this to relays so Nostr clients
  * (njump, Damus, Primal) can verify the identity.
  */
-export function createKind0Event(sk: Uint8Array, profile: { name: string; about?: string; nip05?: string; picture?: string }) {
+export function createKind0Event(sk: Uint8Array, profile: { name: string; about?: string; nip05?: string; picture?: string; lud16?: string }) {
   return finalizeEvent({
     kind: 0,
     created_at: Math.floor(Date.now() / 1000),
@@ -136,6 +202,7 @@ export function createKind0Event(sk: Uint8Array, profile: { name: string; about?
       ...(profile.about && { about: profile.about }),
       ...(profile.nip05 && { nip05: profile.nip05 }),
       ...(profile.picture && { picture: profile.picture }),
+      ...(profile.lud16 && { lud16: profile.lud16 }),
     }),
   }, sk);
 }