agentdex-cli 0.3.3 → 0.4.0

package/dist/cli.js

@@ -7,6 +7,7 @@ import qrcode from 'qrcode-terminal';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
+import { nip19 } from 'nostr-tools';
 import { AgentdexClient } from './client.js';
 import { parseSecretKey, getNpub, getPubkeyHex, createProfileEvent, createKind0Event, publishToRelays, createNote, generateAndSaveKeypair } from './nostr.js';
 import { payInvoice } from './nwc.js';
@@ -65,6 +66,8 @@ program
     .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('--human <npub-or-hex>', 'Owner/operator Nostr pubkey (npub or hex) — enables bidirectional verification')
+    .option('--bot', 'Add ["bot"] tag to kind 0 profile (declares this pubkey as automated)')
     .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], [])
@@ -100,6 +103,25 @@ program
             const parts = entry.split(',').map((s) => s.trim());
             return { url: parts[0], name: parts[1], description: parts[2] };
         });
+        // Resolve owner pubkey hex from --human flag (npub or hex)
+        let humanNpub = options.human;
+        let ownerPubkeyHex;
+        if (humanNpub) {
+            if (humanNpub.startsWith('npub')) {
+                try {
+                    const decoded = nip19.decode(humanNpub);
+                    ownerPubkeyHex = decoded.data;
+                }
+                catch {
+                    console.error(chalk.red('Invalid --human npub'));
+                    process.exit(1);
+                }
+            }
+            else {
+                ownerPubkeyHex = humanNpub;
+                humanNpub = nip19.npubEncode(humanNpub);
+            }
+        }
         const event = createProfileEvent(sk, {
             name,
             description,
@@ -108,6 +130,7 @@ program
             model: options.model,
             website: options.website,
             lightning: options.lightning,
+            human: humanNpub,
             ownerX: options.ownerX,
             status: 'active',
             portfolio: portfolio.length > 0 ? portfolio : undefined,
@@ -176,6 +199,8 @@ program
                                     about: description || undefined,
                                     picture: options.avatar || undefined,
                                     lud16: options.lightning || undefined,
+                                    ownerPubkeyHex,
+                                    bot: !!options.bot,
                                 });
                                 await publishToRelays(kind0, relays);
                                 k0Spinner.succeed('Kind 0 published — visible on all Nostr clients');
@@ -215,7 +240,7 @@ program
                 console.log(chalk.gray(`  Run ${chalk.white('agentdex claim <name>')} to get ${chalk.hex('#D4A574')('<name>@agentdex.id')}`));
                 console.log('');
                 // Publish kind 0 profile (name, about, avatar, website, lud16)
-                // Kind 0 is canonical for basic profile; kind 31337 is agent-specific metadata
+                // Kind 0 is canonical for basic profile; kind 31339 is agent-specific metadata
                 const k0Spinner = ora('Publishing kind 0 profile to Nostr relays...').start();
                 try {
                     const kind0 = createKind0Event(sk, {
@@ -223,6 +248,8 @@ program
                         about: description || undefined,
                         picture: options.avatar || undefined,
                         lud16: options.lightning || undefined,
+                        ownerPubkeyHex,
+                        bot: !!options.bot,
                     });
                     await publishToRelays(kind0, relays);
                     k0Spinner.succeed('Kind 0 published — visible on all Nostr clients');
@@ -267,7 +294,7 @@ program
         const sk = resolveKey(options);
         const client = new AgentdexClient({ apiKey: options.apiKey });
         const spinner = ora(`Claiming ${name}@agentdex.id...`).start();
-        // Sign a kind 31337 event for claim authentication
+        // Sign a kind 31339 event for claim authentication
         const event = createProfileEvent(sk, {
             name,
             status: 'active',

package/dist/nostr.d.ts

@@ -47,7 +47,7 @@ export declare function getNpub(sk: Uint8Array): string;
  */
 export declare function getPubkeyHex(sk: Uint8Array): string;
 /**
- * Build and sign a kind 31337 agent profile event
+ * Build and sign a kind 31339 agent profile event
  */
 export declare function createProfileEvent(sk: Uint8Array, profile: AgentProfile): import("nostr-tools").VerifiedEvent;
 /**
@@ -72,6 +72,8 @@ export declare function createKind0Event(sk: Uint8Array, profile: {
     nip05?: string;
     picture?: string;
     lud16?: string;
+    ownerPubkeyHex?: string;
+    bot?: boolean;
 }): import("nostr-tools").VerifiedEvent;
 /**
  * Create and sign a kind 1 note tagged #agentdex

package/dist/nostr.js

@@ -55,13 +55,13 @@ export function getPubkeyHex(sk) {
     return getPublicKey(sk);
 }
 /**
- * Build and sign a kind 31337 agent profile event
+ * Build and sign a kind 31339 agent profile event
  */
 export function createProfileEvent(sk, profile) {
     const tags = [
         ['d', 'agentdex-profile'],
     ];
-    // name is optional in kind 31337 (canonical source is kind 0)
+    // name is optional in kind 31339 (canonical source is kind 0)
     // included for backward compatibility and standalone profiles
     if (profile.name)
         tags.push(['name', profile.name]);
@@ -80,7 +80,7 @@ export function createProfileEvent(sk, profile) {
         tags.push(['website', profile.website]);
     if (profile.avatar)
         tags.push(['avatar', profile.avatar]);
-    // Lightning address belongs in kind 0 (lud16), not kind 31337
+    // Lightning address belongs in kind 0 (lud16), not kind 31339
     // Use --lightning flag to set lud16 in kind 0 during claim
     if (profile.human)
         tags.push(['human', profile.human]);
@@ -115,7 +115,7 @@ export function createProfileEvent(sk, profile) {
         }
     }
     const event = finalizeEvent({
-        kind: 31337,
+        kind: 31339,
         created_at: Math.floor(Date.now() / 1000),
         tags,
         content: '',
@@ -189,10 +189,16 @@ export async function updateKind0(sk, updates, relays = DEFAULT_RELAYS) {
  * (njump, Damus, Primal) can verify the identity.
  */
 export function createKind0Event(sk, profile) {
+    const tags = [];
+    if (profile.bot)
+        tags.push(["bot"]);
+    if (profile.ownerPubkeyHex) {
+        tags.push(["p", profile.ownerPubkeyHex, "", "owner"]);
+    }
     return finalizeEvent({
         kind: 0,
         created_at: Math.floor(Date.now() / 1000),
-        tags: [],
+        tags,
         content: JSON.stringify({
             name: profile.name,
             ...(profile.about && { about: profile.about }),

package/package.json

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

package/src/cli.ts

@@ -8,6 +8,7 @@ import qrcode from 'qrcode-terminal';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
+import { nip19 } from 'nostr-tools';
 import { AgentdexClient } from './client.js';
 import { parseSecretKey, getNpub, getPubkeyHex, createProfileEvent, createKind0Event, publishToRelays, createNote, updateKind0, generateAndSaveKeypair } from './nostr.js';
 import { payInvoice } from './nwc.js';
@@ -73,6 +74,8 @@ program
   .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('--human <npub-or-hex>', 'Owner/operator Nostr pubkey (npub or hex) — enables bidirectional verification')
+  .option('--bot', 'Add ["bot"] tag to kind 0 profile (declares this pubkey as automated)')
   .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], [])
@@ -113,6 +116,24 @@ program
         return { url: parts[0], name: parts[1], description: parts[2] };
       });
 
+      // Resolve owner pubkey hex from --human flag (npub or hex)
+      let humanNpub = options.human;
+      let ownerPubkeyHex: string | undefined;
+      if (humanNpub) {
+        if (humanNpub.startsWith('npub')) {
+          try {
+            const decoded = nip19.decode(humanNpub);
+            ownerPubkeyHex = decoded.data as unknown as string;
+          } catch {
+            console.error(chalk.red('Invalid --human npub'));
+            process.exit(1);
+          }
+        } else {
+          ownerPubkeyHex = humanNpub;
+          humanNpub = nip19.npubEncode(humanNpub);
+        }
+      }
+
       const event = createProfileEvent(sk, {
         name,
         description,
@@ -121,6 +142,7 @@ program
         model: options.model,
         website: options.website,
         lightning: options.lightning,
+        human: humanNpub,
         ownerX: options.ownerX,
         status: 'active',
         portfolio: portfolio.length > 0 ? portfolio : undefined,
@@ -196,6 +218,8 @@ program
                     about: description || undefined,
                     picture: options.avatar || undefined,
                     lud16: options.lightning || undefined,
+                    ownerPubkeyHex,
+                    bot: !!options.bot,
                   });
                   await publishToRelays(kind0, relays);
                   k0Spinner.succeed('Kind 0 published — visible on all Nostr clients');
@@ -237,7 +261,7 @@ program
           console.log(chalk.gray(`  Run ${chalk.white('agentdex claim <name>')} to get ${chalk.hex('#D4A574')('<name>@agentdex.id')}`));
           console.log('');
           // Publish kind 0 profile (name, about, avatar, website, lud16)
-          // Kind 0 is canonical for basic profile; kind 31337 is agent-specific metadata
+          // Kind 0 is canonical for basic profile; kind 31339 is agent-specific metadata
           const k0Spinner = ora('Publishing kind 0 profile to Nostr relays...').start();
           try {
             const kind0 = createKind0Event(sk, {
@@ -245,6 +269,8 @@ program
               about: description || undefined,
               picture: options.avatar || undefined,
               lud16: options.lightning || undefined,
+              ownerPubkeyHex,
+              bot: !!options.bot,
             });
             await publishToRelays(kind0, relays);
             k0Spinner.succeed('Kind 0 published — visible on all Nostr clients');
@@ -290,7 +316,7 @@ program
 
       const spinner = ora(`Claiming ${name}@agentdex.id...`).start();
 
-      // Sign a kind 31337 event for claim authentication
+      // Sign a kind 31339 event for claim authentication
       const event = createProfileEvent(sk, {
         name,
         status: 'active',

package/src/nostr.ts

@@ -89,14 +89,14 @@ export function getPubkeyHex(sk: Uint8Array): string {
 }
 
 /**
- * Build and sign a kind 31337 agent profile event
+ * Build and sign a kind 31339 agent profile event
  */
 export function createProfileEvent(sk: Uint8Array, profile: AgentProfile) {
   const tags: string[][] = [
     ['d', 'agentdex-profile'],
   ];
 
-  // name is optional in kind 31337 (canonical source is kind 0)
+  // name is optional in kind 31339 (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]);
@@ -109,7 +109,7 @@ 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]);
-  // Lightning address belongs in kind 0 (lud16), not kind 31337
+  // Lightning address belongs in kind 0 (lud16), not kind 31339
   // 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]);
@@ -137,7 +137,7 @@ export function createProfileEvent(sk: Uint8Array, profile: AgentProfile) {
   }
 
   const event = finalizeEvent({
-    kind: 31337,
+    kind: 31339,
     created_at: Math.floor(Date.now() / 1000),
     tags,
     content: '',
@@ -219,11 +219,16 @@ export async function updateKind0(sk: Uint8Array, updates: { lud16?: string }, r
  * 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; lud16?: string }) {
+export function createKind0Event(sk: Uint8Array, profile: { name: string; about?: string; nip05?: string; picture?: string; lud16?: string; ownerPubkeyHex?: string; bot?: boolean }) {
+  const tags: string[][] = [];
+  if (profile.bot) tags.push(["bot"]);
+  if (profile.ownerPubkeyHex) {
+    tags.push(["p", profile.ownerPubkeyHex, "", "owner"]);
+  }
   return finalizeEvent({
     kind: 0,
     created_at: Math.floor(Date.now() / 1000),
-    tags: [],
+    tags,
     content: JSON.stringify({
       name: profile.name,
       ...(profile.about && { about: profile.about }),