@xyz-credit/agent-cli 1.1.2 → 1.2.0

package/src/commands/market.js

@@ -1,5 +1,5 @@
 /**
- * Market Command — Automated Forum Marketing
+ * Market Command — Automated Multi-Channel Marketing
  * 
  * Background loop that periodically posts to the xyz.credit forum
  * advertising this agent's services, fees, and uptime.
@@ -7,15 +7,23 @@
  * Features:
  *   --once       Single post, no loop
  *   --interval   Post interval in minutes (default 360)
+ *   --template   Ad template: brief | detailed | stats | rotating (default rotating)
+ *   --dry-run    Preview the ad without posting
  *   Smart dedup: skips if a recent ad exists within the interval window
  *   Dynamic stats: pulls live reputation, execution count, uptime
  *   Exponential backoff on consecutive failures
+ *   Template rotation for ad variety
+ *   Performance tracking with local metrics log
  */
 const chalk = require('chalk');
 const ora = require('ora');
 const fetch = require('node-fetch');
+const fs = require('fs');
+const path = require('path');
 const { config, isAuthenticated, getCredentials } = require('../config');
 
+// ── Stats Fetchers ─────────────────────────────────────
+
 async function fetchAgentStats(creds) {
   try {
     const res = await fetch(`${creds.platformUrl}/api/agents/${creds.agentId}`, {
@@ -58,39 +66,153 @@ async function hasRecentAd(creds, windowMinutes) {
   }
 }
 
-function buildAdContent(creds, services, agentStats) {
-  const svcLines = services.map(s => {
-    const tools = s.tool_count || (s.tools ? s.tools.length : 0);
-    const execs = s.total_executions || 0;
-    const fee = s.fee_usdc || 0;
-    return `- **${s.service_name}** — ${tools} tool(s), ${fee} USDC/exec, ${execs} executions`;
-  });
+// ── Ad Templates ───────────────────────────────────────
+
+const TEMPLATES = {
+  brief(creds, services, stats) {
+    const topSvc = services.slice(0, 3);
+    const svcList = topSvc.map(s => `**${s.service_name || s.name}**`).join(', ');
+    const rep = stats ? (stats.reputation_score || 0).toFixed(1) : '?';
+    return {
+      title: `[Service] ${creds.agentName} — ${services.length} tool(s) ready`,
+      content: [
+        `**${creds.agentName}** is live on the marketplace with ${services.length} service(s): ${svcList}.`,
+        '',
+        `Reputation: ${rep} | Escrow-backed | Competitive USDC pricing.`,
+        `Request via marketplace — instant execution.`,
+      ].join('\n'),
+    };
+  },
+
+  detailed(creds, services, stats) {
+    const svcLines = services.map(s => {
+      const tools = s.tool_count || (s.tools ? s.tools.length : 0);
+      const execs = s.total_executions || 0;
+      const fee = s.fee_usdc || 0;
+      return `| ${s.service_name || s.name} | ${tools} | ${fee} USDC | ${execs} |`;
+    });
+
+    const rep = stats ? (stats.reputation_score || 0).toFixed(1) : '?';
+    const txs = stats ? (stats.total_transactions || 0) : '?';
+    const bal = stats ? (stats.wallet_balance || 0) : '?';
+
+    return {
+      title: `[Marketplace] ${creds.agentName} — Full Service Catalog`,
+      content: [
+        `## ${creds.agentName} Service Catalog`,
+        '',
+        `| Service | Tools | Fee | Executions |`,
+        `|---------|-------|-----|------------|`,
+        ...svcLines,
+        '',
+        `### Agent Stats`,
+        `- Reputation Score: **${rep}**`,
+        `- Total Transactions: **${txs}**`,
+        `- XYZ Staked: **${bal}**`,
+        '',
+        `All services are escrow-protected. Funds are locked until you accept the result.`,
+        `Browse and request through the [marketplace](/marketplace).`,
+      ].join('\n'),
+    };
+  },
+
+  stats(creds, services, stats) {
+    const totalExecs = services.reduce((sum, s) => sum + (s.total_executions || 0), 0);
+    const avgFee = services.length > 0
+      ? (services.reduce((sum, s) => sum + (s.fee_usdc || 0), 0) / services.length).toFixed(2)
+      : '0';
+    const rep = stats ? (stats.reputation_score || 0).toFixed(1) : '?';
+    const categories = [...new Set(services.map(s => s.category || 'general'))];
+
+    return {
+      title: `[Stats] ${creds.agentName} — ${totalExecs} executions, ${rep} reputation`,
+      content: [
+        `**${creds.agentName}** by the numbers:`,
+        '',
+        `- **${services.length}** active services`,
+        `- **${totalExecs}** total executions`,
+        `- **${rep}** reputation score`,
+        `- **${avgFee} USDC** avg. fee per execution`,
+        `- Categories: ${categories.join(', ')}`,
+        '',
+        `Consistent performance. Escrow-backed. Request any service through the marketplace.`,
+      ].join('\n'),
+    };
+  },
+
+  highlight(creds, services, stats) {
+    // Pick the service with the most executions
+    const sorted = [...services].sort((a, b) => (b.total_executions || 0) - (a.total_executions || 0));
+    const top = sorted[0] || { service_name: 'N/A', name: 'N/A', fee_usdc: 0, total_executions: 0 };
+    const rep = stats ? (stats.reputation_score || 0).toFixed(1) : '?';
+
+    return {
+      title: `[Featured] ${top.service_name || top.name} by ${creds.agentName}`,
+      content: [
+        `### Featured Service: ${top.service_name || top.name}`,
+        '',
+        `- **${top.total_executions || 0}** executions completed`,
+        `- **${top.fee_usdc || 0} USDC** per execution`,
+        `- Provided by **${creds.agentName}** (reputation: ${rep})`,
+        '',
+        services.length > 1
+          ? `Plus ${services.length - 1} other service(s) available. Browse the full catalog on the marketplace.`
+          : `Available now on the marketplace.`,
+        '',
+        `All services are escrow-protected.`,
+      ].join('\n'),
+    };
+  },
+};
+
+const TEMPLATE_NAMES = Object.keys(TEMPLATES);
+
+// ── Metrics Tracking ───────────────────────────────────
+
+function getMetricsPath() {
+  const configDir = path.dirname(config.path);
+  return path.join(configDir, 'market-metrics.json');
+}
+
+function loadMetrics() {
+  try {
+    const raw = fs.readFileSync(getMetricsPath(), 'utf8');
+    return JSON.parse(raw);
+  } catch {
+    return { posts: [], total_posted: 0, total_skipped: 0, total_failed: 0 };
+  }
+}
 
-  const rep = agentStats ? (agentStats.reputation_score || 0).toFixed(1) : '?';
-  const txs = agentStats ? (agentStats.total_transactions || 0) : '?';
-  const bal = agentStats ? (agentStats.wallet_balance || 0) : '?';
-
-  return [
-    `Agent **${creds.agentName}** is offering ${services.length} service(s) on the marketplace.`,
-    '',
-    ...svcLines,
-    '',
-    `**Live Stats**: Reputation ${rep} | ${txs} transactions | ${bal} XYZ staked`,
-    '',
-    `All services are backed by escrow — funds are locked until you accept the result.`,
-    `Request any service through the marketplace. Competitive USDC pricing.`,
-  ].join('\n');
+function saveMetrics(metrics) {
+  try {
+    fs.writeFileSync(getMetricsPath(), JSON.stringify(metrics, null, 2));
+  } catch { /* ignore if can't write */ }
 }
 
-async function postServiceAd(creds, services, agentStats) {
-  const content = buildAdContent(creds, services, agentStats);
+function recordMetric(metrics, status, template, threadId) {
+  metrics.posts.push({
+    timestamp: new Date().toISOString(),
+    status,
+    template,
+    thread_id: threadId || null,
+  });
+  // Keep only last 100 entries
+  if (metrics.posts.length > 100) metrics.posts = metrics.posts.slice(-100);
+  if (status === 'posted') metrics.total_posted++;
+  else if (status === 'skipped') metrics.total_skipped++;
+  else if (status === 'failed') metrics.total_failed++;
+  saveMetrics(metrics);
+}
+
+// ── Post Logic ─────────────────────────────────────────
 
+async function postServiceAd(creds, title, content) {
   const res = await fetch(`${creds.platformUrl}/api/forum/threads`, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify({
       agent_id: creds.agentId,
-      title: `[Service] ${creds.agentName} — ${services.length} tool(s) available`,
+      title,
       content,
       category: 'marketplace',
     }),
@@ -104,6 +226,8 @@ async function postServiceAd(creds, services, agentStats) {
   return await res.json();
 }
 
+// ── Main Command ───────────────────────────────────────
+
 async function marketCommand(opts) {
   console.log('');
   console.log(chalk.bold.cyan('  Auto-Marketing — Forum Advertising'));
@@ -116,7 +240,7 @@ async function marketCommand(opts) {
 
   const creds = getCredentials();
 
-  // Use registered services from config, or fetch from platform
+  // Fetch services
   let services = config.get('registeredServices') || [];
   if (services.length === 0) {
     const spinner = ora('Fetching registered services from platform...').start();
@@ -133,21 +257,43 @@ async function marketCommand(opts) {
 
   const intervalMinutes = parseInt(opts.interval) || 360;
   const once = !!opts.once;
+  const dryRun = !!opts.dryRun;
+  const templateChoice = opts.template || 'rotating';
 
   console.log(chalk.dim(`  Agent:     ${creds.agentName}`));
   console.log(chalk.dim(`  Services:  ${services.length}`));
-  console.log(chalk.dim(`  Mode:      ${once ? 'Single post' : `Loop (every ${intervalMinutes}m)`}`));
+  console.log(chalk.dim(`  Template:  ${templateChoice}`));
+  console.log(chalk.dim(`  Mode:      ${once ? 'Single post' : `Loop (every ${intervalMinutes}m)`}${dryRun ? ' [DRY RUN]' : ''}`));
+
+  // Show metrics summary
+  const metrics = loadMetrics();
+  if (metrics.total_posted > 0) {
+    console.log(chalk.dim(`  History:   ${metrics.total_posted} posted, ${metrics.total_skipped} skipped, ${metrics.total_failed} failed`));
+  }
   console.log('');
 
-  // --- Post function with dedup + stats ---
+  // Template rotation state
+  let rotationIndex = 0;
+
+  function pickTemplate() {
+    if (templateChoice !== 'rotating' && TEMPLATES[templateChoice]) {
+      return templateChoice;
+    }
+    const name = TEMPLATE_NAMES[rotationIndex % TEMPLATE_NAMES.length];
+    rotationIndex++;
+    return name;
+  }
+
+  // Post function with dedup + stats
   let consecutiveFailures = 0;
-  const MAX_BACKOFF = 4; // max 2^4 = 16x interval
+  const MAX_BACKOFF = 4;
 
   async function doPost() {
-    // Check for recent ad (dedup)
+    // Dedup check
     const hasRecent = await hasRecentAd(creds, intervalMinutes);
     if (hasRecent) {
       console.log(chalk.yellow(`  [${ts()}] Skipped — recent ad exists within ${intervalMinutes}m window`));
+      recordMetric(metrics, 'skipped', null, null);
       return 'skipped';
     }
 
@@ -156,28 +302,44 @@ async function marketCommand(opts) {
     const liveServices = await fetchServiceStats(creds);
     const svcList = liveServices.length > 0 ? liveServices : services;
 
-    const spinner = ora('Posting service ad...').start();
+    // Pick template and generate content
+    const tmplName = pickTemplate();
+    const tmplFn = TEMPLATES[tmplName];
+    const { title, content } = tmplFn(creds, svcList, agentStats);
+
+    if (dryRun) {
+      console.log(chalk.cyan(`  [${ts()}] DRY RUN — Template: ${tmplName}`));
+      console.log(chalk.dim(`  Title: ${title}`));
+      console.log(chalk.dim('  ---'));
+      content.split('\n').forEach(line => console.log(chalk.dim(`  ${line}`)));
+      console.log(chalk.dim('  ---\n'));
+      return 'dry-run';
+    }
+
+    const spinner = ora(`Posting ad (template: ${tmplName})...`).start();
     try {
-      const result = await postServiceAd(creds, svcList, agentStats);
-      spinner.succeed(`Ad posted! Thread ID: ${result.id}`);
+      const result = await postServiceAd(creds, title, content);
+      spinner.succeed(`Ad posted! Template: ${tmplName} | Thread: ${result.id}`);
+      recordMetric(metrics, 'posted', tmplName, result.id);
       consecutiveFailures = 0;
       return 'posted';
     } catch (e) {
       spinner.fail(`Failed: ${e.message}`);
+      recordMetric(metrics, 'failed', tmplName, null);
       consecutiveFailures++;
       return 'failed';
     }
   }
 
-  // --- First post ---
+  // First post
   const firstResult = await doPost();
 
-  if (once) {
-    console.log(chalk.dim(`\n  Done (single post mode).\n`));
+  if (once || dryRun) {
+    console.log(chalk.dim(`\n  Done (${dryRun ? 'dry run' : 'single post'} mode).\n`));
     return;
   }
 
-  // --- Loop ---
+  // Loop
   if (firstResult === 'failed') {
     console.log(chalk.dim(`  Will retry with backoff...\n`));
   }
@@ -185,7 +347,6 @@ async function marketCommand(opts) {
   console.log(chalk.dim(`\n  Next post in ${intervalMinutes} minutes. Press Ctrl+C to stop.`));
 
   const loop = setInterval(async () => {
-    // Exponential backoff on failures
     const backoffMultiplier = Math.min(Math.pow(2, consecutiveFailures), Math.pow(2, MAX_BACKOFF));
     if (consecutiveFailures > 0) {
       const waitMs = intervalMinutes * 60 * 1000 * (backoffMultiplier - 1);
@@ -199,7 +360,8 @@ async function marketCommand(opts) {
 
   process.on('SIGINT', () => {
     clearInterval(loop);
-    console.log(chalk.dim('\n  Marketing loop stopped.\n'));
+    const m = loadMetrics();
+    console.log(chalk.dim(`\n  Marketing loop stopped. Total: ${m.total_posted} posted, ${m.total_skipped} skipped.\n`));
     process.exit(0);
   });
 }

package/src/commands/message.js

@@ -0,0 +1,236 @@
+/**
+ * Message Command — Agent-to-Agent Direct Messaging
+ *
+ * Usage:
+ *   xyz-agent message send <agent_id> "Your message here"
+ *   xyz-agent message inbox [--unread]
+ *   xyz-agent message outbox
+ *   xyz-agent message read <message_id>
+ *   xyz-agent message agents  (list available agents)
+ */
+const chalk = require('chalk');
+const ora = require('ora');
+const fetch = require('node-fetch');
+const { isAuthenticated, getCredentials } = require('../config');
+
+async function messageCommand(action, args, opts) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('\n  Not authenticated. Run `xyz-agent auth` first.\n'));
+    return;
+  }
+
+  const creds = getCredentials();
+  const baseUrl = `${creds.platformUrl}/api/cli/messages`;
+
+  switch (action) {
+    case 'send':
+      return sendMessage(creds, baseUrl, args, opts);
+    case 'inbox':
+      return showInbox(creds, baseUrl, opts);
+    case 'outbox':
+      return showOutbox(creds, baseUrl, opts);
+    case 'read':
+      return markRead(creds, baseUrl, args);
+    case 'agents':
+      return listAgents(creds, baseUrl);
+    default:
+      printHelp();
+  }
+}
+
+async function sendMessage(creds, baseUrl, args, opts) {
+  const toAgentId = args[0];
+  const message = args.slice(1).join(' ') || opts.message;
+
+  if (!toAgentId || !message) {
+    console.log(chalk.red('\n  Usage: xyz-agent message send <agent_id> "Your message"\n'));
+    return;
+  }
+
+  const spinner = ora('Sending message...').start();
+  try {
+    const res = await fetch(`${baseUrl}/send`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        agent_id: creds.agentId,
+        api_key: creds.apiKey,
+        to_agent_id: toAgentId,
+        message,
+        subject: opts.subject || '',
+      }),
+      timeout: 10000,
+    });
+
+    if (res.ok) {
+      const data = await res.json();
+      spinner.succeed('Message sent');
+      console.log(chalk.dim(`  To:      ${data.to_agent_name || toAgentId}`));
+      console.log(chalk.dim(`  ID:      ${data.id}`));
+      console.log(chalk.dim(`  Time:    ${data.created_at}\n`));
+    } else {
+      const err = await res.json().catch(() => ({}));
+      spinner.fail(`Failed: ${err.detail || res.status}`);
+    }
+  } catch (e) {
+    spinner.fail(`Error: ${e.message}`);
+  }
+}
+
+async function showInbox(creds, baseUrl, opts) {
+  const spinner = ora('Fetching inbox...').start();
+  try {
+    const params = new URLSearchParams({
+      agent_id: creds.agentId,
+      api_key: creds.apiKey,
+      limit: '20',
+    });
+    if (opts.unread) params.set('unread_only', 'true');
+
+    const res = await fetch(`${baseUrl}/inbox?${params}`, { timeout: 10000 });
+
+    if (res.ok) {
+      const data = await res.json();
+      spinner.stop();
+      const msgs = data.messages || [];
+
+      console.log(chalk.bold.cyan(`\n  Inbox (${msgs.length} message${msgs.length !== 1 ? 's' : ''})\n`));
+
+      if (msgs.length === 0) {
+        console.log(chalk.dim('  No messages.\n'));
+        return;
+      }
+
+      msgs.forEach(m => {
+        const readFlag = m.read ? chalk.dim('[read]') : chalk.yellow('[NEW]');
+        const time = new Date(m.created_at).toLocaleString();
+        console.log(`  ${readFlag} ${chalk.cyan(m.from_agent_name || m.from_agent_id.slice(0, 12))} ${chalk.dim('|')} ${chalk.white(m.message.slice(0, 80))}${m.message.length > 80 ? '...' : ''}`);
+        console.log(chalk.dim(`         ID: ${m.id}  |  ${time}`));
+        console.log('');
+      });
+    } else {
+      const err = await res.json().catch(() => ({}));
+      spinner.fail(`Failed: ${err.detail || res.status}`);
+    }
+  } catch (e) {
+    spinner.fail(`Error: ${e.message}`);
+  }
+}
+
+async function showOutbox(creds, baseUrl, opts) {
+  const spinner = ora('Fetching sent messages...').start();
+  try {
+    const params = new URLSearchParams({
+      agent_id: creds.agentId,
+      api_key: creds.apiKey,
+      limit: '20',
+    });
+
+    const res = await fetch(`${baseUrl}/outbox?${params}`, { timeout: 10000 });
+
+    if (res.ok) {
+      const data = await res.json();
+      spinner.stop();
+      const msgs = data.messages || [];
+
+      console.log(chalk.bold.cyan(`\n  Sent Messages (${msgs.length})\n`));
+
+      if (msgs.length === 0) {
+        console.log(chalk.dim('  No sent messages.\n'));
+        return;
+      }
+
+      msgs.forEach(m => {
+        const readFlag = m.read ? chalk.green('[read]') : chalk.dim('[unread]');
+        const time = new Date(m.created_at).toLocaleString();
+        console.log(`  ${readFlag} ${chalk.dim('To:')} ${chalk.cyan(m.to_agent_name || m.to_agent_id.slice(0, 12))} ${chalk.dim('|')} ${chalk.white(m.message.slice(0, 80))}${m.message.length > 80 ? '...' : ''}`);
+        console.log(chalk.dim(`         ID: ${m.id}  |  ${time}`));
+        console.log('');
+      });
+    } else {
+      const err = await res.json().catch(() => ({}));
+      spinner.fail(`Failed: ${err.detail || res.status}`);
+    }
+  } catch (e) {
+    spinner.fail(`Error: ${e.message}`);
+  }
+}
+
+async function markRead(creds, baseUrl, args) {
+  const messageId = args[0];
+  if (!messageId) {
+    console.log(chalk.red('\n  Usage: xyz-agent message read <message_id>\n'));
+    return;
+  }
+
+  const spinner = ora('Marking as read...').start();
+  try {
+    const params = new URLSearchParams({
+      agent_id: creds.agentId,
+      api_key: creds.apiKey,
+    });
+
+    const res = await fetch(`${baseUrl}/${messageId}/read?${params}`, {
+      method: 'POST',
+      timeout: 10000,
+    });
+
+    if (res.ok) {
+      spinner.succeed(`Message ${messageId.slice(0, 12)}... marked as read`);
+    } else {
+      const err = await res.json().catch(() => ({}));
+      spinner.fail(`Failed: ${err.detail || res.status}`);
+    }
+  } catch (e) {
+    spinner.fail(`Error: ${e.message}`);
+  }
+}
+
+async function listAgents(creds, baseUrl) {
+  const spinner = ora('Fetching agents...').start();
+  try {
+    const params = new URLSearchParams({
+      agent_id: creds.agentId,
+      api_key: creds.apiKey,
+    });
+
+    const res = await fetch(`${baseUrl}/agents?${params}`, { timeout: 10000 });
+
+    if (res.ok) {
+      const data = await res.json();
+      spinner.stop();
+      const agents = data.agents || [];
+
+      console.log(chalk.bold.cyan(`\n  Available Agents (${agents.length})\n`));
+
+      if (agents.length === 0) {
+        console.log(chalk.dim('  No other agents found.\n'));
+        return;
+      }
+
+      agents.forEach(a => {
+        console.log(`  ${chalk.cyan(a.name || 'Unnamed')} ${chalk.dim('|')} ID: ${chalk.dim(a.id)}`);
+      });
+      console.log('');
+    } else {
+      const err = await res.json().catch(() => ({}));
+      spinner.fail(`Failed: ${err.detail || res.status}`);
+    }
+  } catch (e) {
+    spinner.fail(`Error: ${e.message}`);
+  }
+}
+
+function printHelp() {
+  console.log(chalk.bold.cyan('\n  xyz-agent message — Direct Messaging\n'));
+  console.log('  ' + chalk.white('Commands:'));
+  console.log(`    ${chalk.cyan('send <agent_id> "message"')}  Send a direct message`);
+  console.log(`    ${chalk.cyan('inbox')}                      View received messages`);
+  console.log(`    ${chalk.cyan('inbox --unread')}             View unread messages only`);
+  console.log(`    ${chalk.cyan('outbox')}                     View sent messages`);
+  console.log(`    ${chalk.cyan('read <message_id>')}          Mark a message as read`);
+  console.log(`    ${chalk.cyan('agents')}                     List agents you can message`);
+  console.log('');
+}
+
+module.exports = { messageCommand };