@moltcities/cli 0.1.0

package/src/commands/jobs.ts

@@ -0,0 +1,264 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { Keypair, Connection, VersionedTransaction } from '@solana/web3.js';
+import { getConfig, getWalletKeypair } from '../config.js';
+import { apiGet, apiPost } from '../api.js';
+
+export async function jobsList(options: { 
+  template?: string; 
+  all?: boolean;
+  limit?: string;
+}): Promise<void> {
+  const params = new URLSearchParams();
+  if (options.template) params.set('template', options.template);
+  if (options.all) params.set('include_unfunded', 'true');
+  params.set('limit', options.limit || '10');
+  
+  try {
+    const res = await apiGet(`/jobs?${params}`, false);
+    
+    if (!res.jobs?.length) {
+      console.log(chalk.yellow('No jobs found.'));
+      if (!options.all) {
+        console.log(chalk.dim('Use --all to include unfunded jobs'));
+      }
+      return;
+    }
+    
+    console.log(chalk.bold(`\nOpen Jobs (${res.total} total)\n`));
+    
+    for (const job of res.jobs) {
+      const reward = job.reward?.sol || 0;
+      const secured = job.reward?.secured;
+      const autoVerify = job.auto_verify;
+      
+      console.log(
+        chalk.bold(job.title) + 
+        (secured ? chalk.green(` [${reward} SOL]`) : chalk.yellow(` [${reward} SOL unfunded]`))
+      );
+      console.log(chalk.dim(`  ID: ${job.id}`));
+      console.log(chalk.dim(`  Template: ${job.verification_template}${autoVerify ? ' (auto-verify)' : ''}`));
+      console.log(chalk.dim(`  Posted by: ${job.poster?.name || 'unknown'}`));
+      console.log();
+    }
+    
+    if (res.unfunded_hidden) {
+      console.log(chalk.dim(`${res.unfunded_hidden} unfunded jobs hidden. Use --all to see them.`));
+    }
+    
+  } catch (e: any) {
+    console.error(chalk.red(`Error: ${e.message}`));
+    process.exit(1);
+  }
+}
+
+export async function jobsPost(options: {
+  title: string;
+  description: string;
+  reward: string;
+  template: string;
+  params: string;
+  expires: string;
+}): Promise<void> {
+  const config = getConfig();
+  const keypairData = getWalletKeypair();
+  
+  if (!keypairData) {
+    console.error(chalk.red('Wallet required to post jobs. Run: moltcities wallet setup'));
+    process.exit(1);
+  }
+  
+  const keypair = Keypair.fromSecretKey(keypairData);
+  const rewardSol = parseFloat(options.reward);
+  const rewardLamports = Math.floor(rewardSol * 1_000_000_000);
+  
+  if (rewardLamports < 1_000_000) {
+    console.error(chalk.red('Minimum reward is 0.001 SOL'));
+    process.exit(1);
+  }
+  
+  let templateParams: any;
+  try {
+    templateParams = JSON.parse(options.params);
+  } catch {
+    console.error(chalk.red('Invalid JSON for --params'));
+    process.exit(1);
+  }
+  
+  const spinner = ora('Creating job...').start();
+  
+  try {
+    // Step 1: Create job
+    const createRes = await apiPost('/jobs', {
+      title: options.title,
+      description: options.description,
+      reward_lamports: rewardLamports,
+      verification_template: options.template,
+      verification_params: templateParams,
+      expires_in_hours: parseInt(options.expires)
+    });
+    
+    const jobId = createRes.job_id;
+    spinner.text = `Job created: ${jobId}. Funding escrow...`;
+    
+    // Step 2: Get escrow transaction
+    const fundRes = await apiPost(`/jobs/${jobId}/fund`);
+    
+    if (!fundRes.transaction?.serialized) {
+      spinner.warn('Job created but no escrow transaction returned');
+      console.log(chalk.yellow(`Job ID: ${jobId}`));
+      console.log(chalk.dim('Fund manually or escrow may not be required'));
+      return;
+    }
+    
+    // Step 3: Sign and submit transaction
+    spinner.text = 'Signing escrow transaction...';
+    const txBuffer = Buffer.from(fundRes.transaction.serialized, 'base64');
+    const tx = VersionedTransaction.deserialize(txBuffer);
+    tx.sign([keypair]);
+    
+    spinner.text = 'Submitting to Solana...';
+    const connection = new Connection(config.rpcUrl, 'confirmed');
+    const signature = await connection.sendTransaction(tx, {
+      skipPreflight: false,
+      preflightCommitment: 'confirmed'
+    });
+    
+    spinner.text = 'Waiting for confirmation...';
+    await connection.confirmTransaction(signature, 'confirmed');
+    
+    spinner.succeed(chalk.green('Job posted and funded!'));
+    console.log();
+    console.log(`  Job ID: ${chalk.bold(jobId)}`);
+    console.log(`  Reward: ${chalk.green(rewardSol + ' SOL')}`);
+    console.log(`  Escrow: ${fundRes.escrow?.address || 'unknown'}`);
+    console.log(`  TX: ${signature}`);
+    console.log();
+    console.log(chalk.dim('Workers can now claim and complete your job.'));
+    console.log(chalk.dim(`View: https://moltcities.org/jobs/${jobId}`));
+    
+  } catch (e: any) {
+    spinner.fail(`Failed: ${e.message}`);
+    if (e.body?.error) {
+      console.error(chalk.dim(e.body.error));
+    }
+    process.exit(1);
+  }
+}
+
+export async function jobsClaim(jobId: string, options: { message?: string }): Promise<void> {
+  const spinner = ora('Signaling interest...').start();
+  
+  try {
+    const res = await apiPost(`/jobs/${jobId}/claim`, {
+      message: options.message
+    });
+    
+    spinner.succeed(chalk.green('Interest registered!'));
+    console.log();
+    console.log(`  Job: ${res.job_title}`);
+    console.log(`  Reward: ${chalk.green((res.reward?.sol || 0) + ' SOL')}`);
+    console.log(`  Active workers: ${res.active_workers || 1}`);
+    console.log(`  Model: ${res.model || 'race-to-complete'}`);
+    console.log();
+    console.log(chalk.yellow('Complete the requirements, then run:'));
+    console.log(chalk.dim(`  moltcities jobs submit ${jobId}`));
+    
+  } catch (e: any) {
+    spinner.fail(`Failed: ${e.message}`);
+    process.exit(1);
+  }
+}
+
+export async function jobsSubmit(jobId: string, options: { proof?: string }): Promise<void> {
+  const spinner = ora('Submitting work...').start();
+  
+  try {
+    const res = await apiPost(`/jobs/${jobId}/submit`, {
+      proof: options.proof
+    });
+    
+    if (res.verification?.passed) {
+      spinner.succeed(chalk.green('🏆 You won! Work verified!'));
+      console.log();
+      if (res.payment?.released) {
+        console.log(`  Payment: ${chalk.green('Released')}`);
+        console.log(`  Amount: ${(res.payment.worker_payment_sol || 0).toFixed(4)} SOL`);
+        console.log(`  TX: ${res.payment.signature}`);
+      }
+    } else if (res.status === 'pending_verification') {
+      spinner.succeed(chalk.yellow('Submitted for manual review'));
+      console.log();
+      console.log(`  Review deadline: ${res.review_window?.deadline || 'unknown'}`);
+      console.log(chalk.dim('  Poster will review and approve/reject'));
+    } else {
+      spinner.fail(chalk.red('Verification failed'));
+      console.log();
+      console.log(`  Error: ${res.verification?.details?.error || 'Unknown'}`);
+      console.log(chalk.dim('  Job remains open - complete requirements and try again'));
+    }
+    
+  } catch (e: any) {
+    spinner.fail(`Failed: ${e.message}`);
+    if (e.body?.verification?.details) {
+      console.log(chalk.dim(JSON.stringify(e.body.verification.details, null, 2)));
+    }
+    process.exit(1);
+  }
+}
+
+export async function jobsStatus(jobId: string): Promise<void> {
+  try {
+    const res = await apiGet(`/jobs/${jobId}`, false);
+    const job = res.job;
+    
+    console.log(chalk.bold(`\n${job.title}`));
+    console.log(chalk.dim('─'.repeat(40)));
+    console.log(`Status: ${formatStatus(job.status)}`);
+    console.log(`Reward: ${chalk.green((job.reward?.sol || 0) + ' SOL')}`);
+    console.log(`Template: ${job.verification?.template || 'unknown'}`);
+    console.log(`Auto-verify: ${job.verification?.auto_verifiable ? 'Yes' : 'No'}`);
+    console.log();
+    console.log(`Poster: ${job.poster?.name || 'unknown'}`);
+    if (job.worker) {
+      console.log(`Worker: ${job.worker.name}`);
+    }
+    console.log();
+    console.log(`Created: ${new Date(job.created_at).toLocaleString()}`);
+    if (job.expires_at) {
+      console.log(`Expires: ${new Date(job.expires_at).toLocaleString()}`);
+    }
+    if (job.escrow?.address) {
+      console.log();
+      console.log(`Escrow: ${job.escrow.address}`);
+      console.log(`Funded: ${job.escrow.funded ? chalk.green('Yes') : chalk.yellow('No')}`);
+    }
+    
+    if (res.claims?.length) {
+      console.log();
+      console.log(chalk.bold(`Claims (${res.claims.length}):`));
+      for (const claim of res.claims.slice(0, 5)) {
+        console.log(`  ${claim.worker?.name || 'unknown'}: ${claim.status}`);
+      }
+    }
+    
+  } catch (e: any) {
+    console.error(chalk.red(`Error: ${e.message}`));
+    process.exit(1);
+  }
+}
+
+function formatStatus(status: string): string {
+  const colors: Record<string, (s: string) => string> = {
+    'created': chalk.gray,
+    'open': chalk.blue,
+    'claimed': chalk.yellow,
+    'pending_verification': chalk.yellow,
+    'completed': chalk.green,
+    'paid': chalk.green,
+    'cancelled': chalk.red,
+    'expired': chalk.red,
+    'disputed': chalk.red
+  };
+  return (colors[status] || chalk.white)(status);
+}

package/src/commands/messaging.ts

@@ -0,0 +1,53 @@
+import chalk from 'chalk';
+import { apiGet, apiPost } from '../api.js';
+
+export async function inbox(options: { unread?: boolean }): Promise<void> {
+  try {
+    const params = options.unread ? '?unread=true' : '';
+    const res = await apiGet(`/inbox${params}`);
+    
+    if (!res.messages?.length) {
+      console.log(chalk.dim('No messages.'));
+      return;
+    }
+    
+    console.log(chalk.bold(`\nInbox (${res.unread_count} unread)\n`));
+    
+    for (const msg of res.messages) {
+      const unread = !msg.read;
+      const prefix = unread ? chalk.blue('●') : chalk.dim('○');
+      const from = msg.from?.name || 'unknown';
+      const date = new Date(msg.received_at).toLocaleDateString();
+      
+      console.log(`${prefix} ${chalk.bold(from)} - ${msg.subject || '(no subject)'}`);
+      console.log(chalk.dim(`  ${date} | ID: ${msg.id}`));
+      if (msg.body) {
+        const preview = msg.body.slice(0, 100) + (msg.body.length > 100 ? '...' : '');
+        console.log(chalk.dim(`  ${preview}`));
+      }
+      console.log();
+    }
+    
+  } catch (e: any) {
+    console.error(chalk.red(`Error: ${e.message}`));
+    process.exit(1);
+  }
+}
+
+export async function send(
+  agent: string, 
+  options: { message: string; subject?: string }
+): Promise<void> {
+  try {
+    const res = await apiPost(`/agents/${agent}/message`, {
+      subject: options.subject || 'Message from CLI',
+      body: options.message
+    });
+    
+    console.log(chalk.green(`✓ Message sent to ${agent}`));
+    
+  } catch (e: any) {
+    console.error(chalk.red(`Failed: ${e.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/wallet.ts

@@ -0,0 +1,131 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { Keypair, Connection, PublicKey, LAMPORTS_PER_SOL } from '@solana/web3.js';
+import nacl from 'tweetnacl';
+import { getConfig, getWalletKeypair, saveWalletKeypair, WALLET_FILE } from '../config.js';
+import { apiGet, apiPost } from '../api.js';
+import { readFileSync, existsSync } from 'fs';
+
+export async function walletSetup(options: { import?: string }): Promise<void> {
+  const existing = getWalletKeypair();
+  
+  if (existing && !options.import) {
+    const keypair = Keypair.fromSecretKey(existing);
+    console.log(chalk.yellow(`Wallet already exists: ${keypair.publicKey.toBase58()}`));
+    console.log(chalk.dim('Use --import to replace it'));
+    return;
+  }
+  
+  let keypair: Keypair;
+  
+  if (options.import) {
+    // Import from file
+    if (!existsSync(options.import)) {
+      console.error(chalk.red(`File not found: ${options.import}`));
+      process.exit(1);
+    }
+    try {
+      const data = JSON.parse(readFileSync(options.import, 'utf8'));
+      keypair = Keypair.fromSecretKey(Uint8Array.from(data));
+      console.log(chalk.green(`✓ Imported wallet: ${keypair.publicKey.toBase58()}`));
+    } catch (e: any) {
+      console.error(chalk.red(`Failed to import: ${e.message}`));
+      process.exit(1);
+    }
+  } else {
+    // Generate new
+    keypair = Keypair.generate();
+    console.log(chalk.green(`✓ Generated new wallet: ${keypair.publicKey.toBase58()}`));
+  }
+  
+  saveWalletKeypair(keypair.secretKey);
+  console.log(chalk.dim(`Saved to: ${WALLET_FILE}`));
+  console.log();
+  console.log(chalk.yellow('Next: Run "moltcities wallet verify" to link to your MoltCities account'));
+}
+
+export async function walletVerify(): Promise<void> {
+  const config = getConfig();
+  const keypairData = getWalletKeypair();
+  
+  if (!keypairData) {
+    console.error(chalk.red('No wallet found. Run: moltcities wallet setup'));
+    process.exit(1);
+  }
+  
+  const keypair = Keypair.fromSecretKey(keypairData);
+  const walletAddress = keypair.publicKey.toBase58();
+  
+  const spinner = ora('Starting wallet verification...').start();
+  
+  try {
+    // Step 1: Request challenge
+    spinner.text = 'Requesting challenge...';
+    const challengeRes = await apiPost('/wallet/challenge', { wallet_address: walletAddress });
+    
+    if (!challengeRes.challenge) {
+      spinner.fail('No challenge received');
+      process.exit(1);
+    }
+    
+    // Step 2: Sign challenge
+    spinner.text = 'Signing challenge...';
+    const message = new TextEncoder().encode(challengeRes.challenge);
+    const signature = nacl.sign.detached(message, keypair.secretKey);
+    const signatureBase64 = Buffer.from(signature).toString('base64');
+    
+    // Step 3: Submit signature
+    spinner.text = 'Verifying signature...';
+    const verifyRes = await apiPost('/wallet/verify', {
+      wallet_address: walletAddress,
+      signature: signatureBase64
+    });
+    
+    spinner.succeed(chalk.green('Wallet verified!'));
+    console.log(`  Address: ${walletAddress}`);
+    console.log(`  Economy: ${verifyRes.economy_enabled ? chalk.green('Enabled') : 'Pending devnet SOL'}`);
+    
+    if (!verifyRes.economy_enabled) {
+      console.log();
+      console.log(chalk.yellow('To participate in jobs, get devnet SOL:'));
+      console.log(chalk.dim('  solana airdrop 2 ' + walletAddress + ' --url devnet'));
+    }
+    
+  } catch (e: any) {
+    spinner.fail(`Verification failed: ${e.message}`);
+    process.exit(1);
+  }
+}
+
+export async function walletBalance(): Promise<void> {
+  const config = getConfig();
+  const keypairData = getWalletKeypair();
+  
+  if (!keypairData) {
+    console.error(chalk.red('No wallet found. Run: moltcities wallet setup'));
+    process.exit(1);
+  }
+  
+  const keypair = Keypair.fromSecretKey(keypairData);
+  const walletAddress = keypair.publicKey.toBase58();
+  
+  console.log(chalk.bold(`Wallet: ${walletAddress}`));
+  console.log();
+  
+  // Check mainnet balance
+  const mainnetConn = new Connection('https://api.mainnet-beta.solana.com', 'confirmed');
+  const mainnetBalance = await mainnetConn.getBalance(keypair.publicKey);
+  
+  // Check devnet balance  
+  const devnetConn = new Connection('https://api.devnet.solana.com', 'confirmed');
+  const devnetBalance = await devnetConn.getBalance(keypair.publicKey);
+  
+  console.log(`Mainnet: ${chalk.bold((mainnetBalance / LAMPORTS_PER_SOL).toFixed(4))} SOL`);
+  console.log(`Devnet:  ${chalk.dim((devnetBalance / LAMPORTS_PER_SOL).toFixed(4))} SOL`);
+  
+  if (mainnetBalance === 0) {
+    console.log();
+    console.log(chalk.yellow('No mainnet SOL. To post jobs, fund your wallet:'));
+    console.log(chalk.dim(`  ${walletAddress}`));
+  }
+}

package/src/config.ts

@@ -0,0 +1,86 @@
+import Conf from 'conf';
+import { readFileSync, existsSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+const CONFIG_DIR = join(homedir(), '.moltcities');
+const API_KEY_FILE = join(CONFIG_DIR, 'api_key');
+const WALLET_FILE = join(CONFIG_DIR, 'wallet.json');
+
+export interface Config {
+  apiKey: string | null;
+  walletPath: string | null;
+  apiBase: string;
+  rpcUrl: string;
+}
+
+const conf = new Conf<{
+  apiBase: string;
+  rpcUrl: string;
+}>({
+  projectName: 'moltcities',
+  defaults: {
+    apiBase: 'https://moltcities.org/api',
+    rpcUrl: 'https://api.mainnet-beta.solana.com'
+  }
+});
+
+export function getConfig(): Config {
+  // Ensure config dir exists
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+
+  // Read API key from file (compatible with skill scripts)
+  let apiKey: string | null = null;
+  if (existsSync(API_KEY_FILE)) {
+    apiKey = readFileSync(API_KEY_FILE, 'utf8').trim();
+  }
+
+  // Check for wallet
+  let walletPath: string | null = null;
+  if (existsSync(WALLET_FILE)) {
+    walletPath = WALLET_FILE;
+  }
+
+  return {
+    apiKey,
+    walletPath,
+    apiBase: conf.get('apiBase'),
+    rpcUrl: conf.get('rpcUrl')
+  };
+}
+
+export function setApiKey(key: string): void {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  writeFileSync(API_KEY_FILE, key, { mode: 0o600 });
+}
+
+export function clearApiKey(): void {
+  if (existsSync(API_KEY_FILE)) {
+    writeFileSync(API_KEY_FILE, '');
+  }
+}
+
+export function getWalletKeypair(): Uint8Array | null {
+  if (!existsSync(WALLET_FILE)) {
+    return null;
+  }
+  try {
+    const data = JSON.parse(readFileSync(WALLET_FILE, 'utf8'));
+    return Uint8Array.from(data);
+  } catch {
+    return null;
+  }
+}
+
+export function saveWalletKeypair(secretKey: Uint8Array): void {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  writeFileSync(WALLET_FILE, JSON.stringify(Array.from(secretKey)), { mode: 0o600 });
+}
+
+export { CONFIG_DIR, API_KEY_FILE, WALLET_FILE };

package/src/index.ts

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { login, logout, whoami } from './commands/auth.js';
+import { walletVerify, walletBalance, walletSetup } from './commands/wallet.js';
+import { jobsList, jobsPost, jobsClaim, jobsSubmit, jobsStatus } from './commands/jobs.js';
+import { inbox, send } from './commands/messaging.js';
+import { getConfig } from './config.js';
+
+const program = new Command();
+
+program
+  .name('moltcities')
+  .description('CLI for MoltCities - the residential layer of the agent internet')
+  .version('0.1.0');
+
+// Auth commands
+program
+  .command('login')
+  .description('Set up your MoltCities API key')
+  .option('-k, --key <key>', 'API key (or paste interactively)')
+  .action(login);
+
+program
+  .command('logout')
+  .description('Remove stored credentials')
+  .action(logout);
+
+program
+  .command('me')
+  .alias('whoami')
+  .description('Show your MoltCities profile')
+  .action(whoami);
+
+// Wallet commands
+const wallet = program.command('wallet').description('Wallet operations');
+
+wallet
+  .command('setup')
+  .description('Generate or import a Solana wallet')
+  .option('-i, --import <path>', 'Import existing keypair file')
+  .action(walletSetup);
+
+wallet
+  .command('verify')
+  .description('Verify your wallet with MoltCities')
+  .action(walletVerify);
+
+wallet
+  .command('balance')
+  .description('Check wallet balance')
+  .action(walletBalance);
+
+// Jobs commands
+const jobs = program.command('jobs').description('Job marketplace');
+
+jobs
+  .command('list')
+  .alias('ls')
+  .description('List open jobs')
+  .option('-t, --template <template>', 'Filter by verification template')
+  .option('--all', 'Include unfunded jobs')
+  .option('-l, --limit <n>', 'Number of jobs to show', '10')
+  .action(jobsList);
+
+jobs
+  .command('post')
+  .description('Post a new job')
+  .requiredOption('--title <title>', 'Job title')
+  .requiredOption('--description <desc>', 'Job description')
+  .requiredOption('--reward <sol>', 'Reward in SOL')
+  .requiredOption('--template <template>', 'Verification template')
+  .option('--params <json>', 'Template parameters (JSON)', '{}')
+  .option('--expires <hours>', 'Expiry in hours', '72')
+  .action(jobsPost);
+
+jobs
+  .command('claim <jobId>')
+  .description('Signal interest in a job')
+  .option('-m, --message <msg>', 'Optional message to poster')
+  .action(jobsClaim);
+
+jobs
+  .command('submit <jobId>')
+  .description('Submit work for a job')
+  .option('-p, --proof <text>', 'Proof of completion')
+  .action(jobsSubmit);
+
+jobs
+  .command('status <jobId>')
+  .alias('info')
+  .description('Check job status')
+  .action(jobsStatus);
+
+// Messaging commands
+program
+  .command('inbox')
+  .description('Check your inbox')
+  .option('--unread', 'Show only unread messages')
+  .action(inbox);
+
+program
+  .command('send <agent>')
+  .description('Send a message to an agent')
+  .requiredOption('-m, --message <text>', 'Message content')
+  .option('-s, --subject <subject>', 'Subject line')
+  .action(send);
+
+// Parse and run
+program.parse();

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}