agentdex-cli 0.3.3 → 0.4.1

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,10 @@ 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('--owner <npub-or-hex>', 'Owner/operator Nostr pubkey (npub or hex) — sets kind 0 p tag for bidirectional verification')
+    .option('--owner-type <type>', 'Owner type: human, agent, org (sets owner_type tag on kind 31339)')
+    .option('--parent <npub-or-hex>', 'Parent/orchestrator agent pubkey (npub or hex)')
+    .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,15 +105,51 @@ program
             const parts = entry.split(',').map((s) => s.trim());
             return { url: parts[0], name: parts[1], description: parts[2] };
         });
+        // Resolve owner pubkey hex from --owner flag (npub or hex)
+        let ownerNpub = options.owner;
+        let ownerPubkeyHex;
+        if (ownerNpub) {
+            if (ownerNpub.startsWith('npub')) {
+                try {
+                    const decoded = nip19.decode(ownerNpub);
+                    ownerPubkeyHex = decoded.data;
+                }
+                catch {
+                    console.error(chalk.red('Invalid --owner npub'));
+                    process.exit(1);
+                }
+            }
+            else {
+                ownerPubkeyHex = ownerNpub;
+                ownerNpub = nip19.npubEncode(ownerNpub);
+            }
+        }
+        // Resolve parent pubkey hex from --parent flag
+        let parentHex;
+        if (options.parent) {
+            if (options.parent.startsWith('npub')) {
+                try {
+                    const decoded = nip19.decode(options.parent);
+                    parentHex = decoded.data;
+                }
+                catch {
+                    console.error(chalk.red('Invalid --parent npub'));
+                    process.exit(1);
+                }
+            }
+            else {
+                parentHex = options.parent;
+            }
+        }
         const event = createProfileEvent(sk, {
             name,
             description,
             capabilities,
             framework,
             model: options.model,
-            website: options.website,
-            lightning: options.lightning,
+            ownerType: options.ownerType,
             ownerX: options.ownerX,
+            parent: parentHex,
             status: 'active',
             portfolio: portfolio.length > 0 ? portfolio : undefined,
             skills: options.skill?.length > 0 ? options.skill : undefined,
@@ -176,6 +217,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 +258,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 +266,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 +312,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

@@ -7,17 +7,15 @@ export interface PortfolioItem {
     description?: string;
 }
 export interface AgentProfile {
-    name: string;
+    name?: string;
     description?: string;
     capabilities?: string[];
     framework?: string;
     model?: string;
-    website?: string;
-    avatar?: string;
-    lightning?: string;
-    human?: string;
+    ownerType?: string;
     ownerX?: string;
     status?: string;
+    parent?: string;
     messagingPolicy?: string;
     messagingMinTrust?: number;
     messagingFee?: number;
@@ -47,7 +45,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 +70,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,16 +55,14 @@ 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)
-    // included for backward compatibility and standalone profiles
-    if (profile.name)
-        tags.push(['name', profile.name]);
+    // Kind 31339 is agent-specific metadata ONLY
+    // Basic profile (name, avatar, website, nip05, lud16) lives exclusively in kind 0
     if (profile.description)
         tags.push(['description', profile.description]);
     if (profile.capabilities) {
@@ -76,16 +74,12 @@ export function createProfileEvent(sk, profile) {
         tags.push(['framework', profile.framework]);
     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
-    // Use --lightning flag to set lud16 in kind 0 during claim
-    if (profile.human)
-        tags.push(['human', profile.human]);
+    if (profile.ownerType)
+        tags.push(['owner_type', profile.ownerType]);
     if (profile.ownerX)
         tags.push(['owner_x', profile.ownerX]);
+    if (profile.parent)
+        tags.push(['parent', profile.parent]);
     if (profile.status)
         tags.push(['status', profile.status || 'active']);
     if (profile.messagingPolicy)
@@ -115,7 +109,7 @@ export function createProfileEvent(sk, profile) {
         }
     }
     const event = finalizeEvent({
-        kind: 31337,
+        kind: 31339,
         created_at: Math.floor(Date.now() / 1000),
         tags,
         content: '',
@@ -189,10 +183,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.1",
   "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,10 @@ 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('--owner <npub-or-hex>', 'Owner/operator Nostr pubkey (npub or hex) — sets kind 0 p tag for bidirectional verification')
+  .option('--owner-type <type>', 'Owner type: human, agent, org (sets owner_type tag on kind 31339)')
+  .option('--parent <npub-or-hex>', 'Parent/orchestrator agent pubkey (npub or hex)')
+  .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,15 +118,49 @@ program
         return { url: parts[0], name: parts[1], description: parts[2] };
       });
 
+      // Resolve owner pubkey hex from --owner flag (npub or hex)
+      let ownerNpub = options.owner;
+      let ownerPubkeyHex: string | undefined;
+      if (ownerNpub) {
+        if (ownerNpub.startsWith('npub')) {
+          try {
+            const decoded = nip19.decode(ownerNpub);
+            ownerPubkeyHex = decoded.data as unknown as string;
+          } catch {
+            console.error(chalk.red('Invalid --owner npub'));
+            process.exit(1);
+          }
+        } else {
+          ownerPubkeyHex = ownerNpub;
+          ownerNpub = nip19.npubEncode(ownerNpub);
+        }
+      }
+
+      // Resolve parent pubkey hex from --parent flag
+      let parentHex: string | undefined;
+      if (options.parent) {
+        if (options.parent.startsWith('npub')) {
+          try {
+            const decoded = nip19.decode(options.parent);
+            parentHex = decoded.data as unknown as string;
+          } catch {
+            console.error(chalk.red('Invalid --parent npub'));
+            process.exit(1);
+          }
+        } else {
+          parentHex = options.parent;
+        }
+      }
+
       const event = createProfileEvent(sk, {
         name,
         description,
         capabilities,
         framework,
         model: options.model,
-        website: options.website,
-        lightning: options.lightning,
+        ownerType: options.ownerType,
         ownerX: options.ownerX,
+        parent: parentHex,
         status: 'active',
         portfolio: portfolio.length > 0 ? portfolio : undefined,
         skills: options.skill?.length > 0 ? options.skill : undefined,
@@ -196,6 +235,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 +278,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 +286,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 +333,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

@@ -16,17 +16,15 @@ export interface PortfolioItem {
 }
 
 export interface AgentProfile {
-  name: string;
+  name?: string;
   description?: string;
   capabilities?: string[];
   framework?: string;
   model?: string;
-  website?: string;
-  avatar?: string;
-  lightning?: string;
-  human?: string;
+  ownerType?: string;
   ownerX?: string;
   status?: string;
+  parent?: string;
   messagingPolicy?: string;
   messagingMinTrust?: number;
   messagingFee?: number;
@@ -89,16 +87,15 @@ 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)
-  // included for backward compatibility and standalone profiles
-  if (profile.name) tags.push(['name', profile.name]);
+  // Kind 31339 is agent-specific metadata ONLY
+  // Basic profile (name, avatar, website, nip05, lud16) lives exclusively in kind 0
   if (profile.description) tags.push(['description', profile.description]);
   if (profile.capabilities) {
     for (const cap of profile.capabilities) {
@@ -107,12 +104,9 @@ export function createProfileEvent(sk: Uint8Array, profile: AgentProfile) {
   }
   if (profile.framework) tags.push(['framework', profile.framework]);
   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
-  // Use --lightning flag to set lud16 in kind 0 during claim
-  if (profile.human) tags.push(['human', profile.human]);
+  if (profile.ownerType) tags.push(['owner_type', profile.ownerType]);
   if (profile.ownerX) tags.push(['owner_x', profile.ownerX]);
+  if (profile.parent) tags.push(['parent', profile.parent]);
   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)]);
@@ -137,7 +131,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 +213,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 }),