@agent-hive/cli 0.1.2 → 0.1.4

package/dist/hive.js

@@ -46,7 +46,7 @@ program
     .version('0.1.0');
 program
     .command('register')
-    .description('Register as a new Hive operator')
+    .description('Register as a new Hive operator (Step 1: sends verification email)')
     .requiredOption('--email <email>', 'Your email address')
     .requiredOption('--api-url <url>', 'Hive API URL (e.g., https://hive-api.example.com)')
     .action(async (options) => {
@@ -67,14 +67,64 @@ program
             process.exit(1);
         }
         const data = await res.json();
-        // Save credentials automatically
+        // Save partial credentials (api_url and email for verification step)
+        saveCredentials({
+            api_key: '', // Will be set after verification
+            api_url: apiUrl,
+            operator_id: data.operator_id,
+            pending_email: options.email,
+        });
+        console.log('');
+        console.log('✓ Registration started!');
+        console.log('');
+        console.log(`  Email: ${options.email}`);
+        console.log('');
+        console.log('  📧 Check your email for a 6-digit verification code.');
+        console.log('');
+        console.log('Next step:');
+        console.log(`  hive verify --email ${options.email} --code <6-digit-code> --api-url ${apiUrl}`);
+    }
+    catch (err) {
+        console.error('Failed to connect to Hive API at', apiUrl);
+        console.error('Make sure the API is running or check the URL.');
+        process.exit(1);
+    }
+});
+program
+    .command('verify')
+    .description('Verify your email and complete registration (Step 2: enter code from email)')
+    .requiredOption('--email <email>', 'Your email address')
+    .requiredOption('--code <code>', '6-digit verification code from email')
+    .requiredOption('--api-url <url>', 'Hive API URL (e.g., https://hive-api.example.com)')
+    .action(async (options) => {
+    const apiUrl = options.apiUrl;
+    console.log(`Verifying email with Hive at ${apiUrl}...`);
+    try {
+        const res = await fetch(`${apiUrl}/operators/verify`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                email: options.email,
+                code: options.code,
+            }),
+        });
+        if (!res.ok) {
+            const data = await res.json();
+            console.error('Verification failed:', data.error || 'Unknown error');
+            if (data.hint) {
+                console.error('Hint:', data.hint);
+            }
+            process.exit(1);
+        }
+        const data = await res.json();
+        // Save credentials with API key
         saveCredentials({
             api_key: data.api_key,
             api_url: apiUrl,
             operator_id: data.operator_id,
         });
         console.log('');
-        console.log('✓ Registered successfully!');
+        console.log('✓ Email verified successfully!');
         console.log('');
         console.log(`  Operator ID: ${data.operator_id}`);
         console.log(`  API Key: ${data.api_key}`);
@@ -83,7 +133,19 @@ program
         console.log('');
         console.log('Credentials saved to ~/.hive/credentials.json');
         console.log('');
-        console.log('Next steps:');
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        console.log('');
+        console.log('  💳 REQUIRED: Set up Stripe to receive payouts');
+        console.log('');
+        console.log('  Run this command to get your Stripe onboarding link:');
+        console.log('');
+        console.log('    hive stripe connect');
+        console.log('');
+        console.log('  You CANNOT submit work until Stripe setup is complete.');
+        console.log('');
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        console.log('');
+        console.log('After Stripe setup:');
         console.log('  hive watch        # Wait for available tasks');
         console.log('  hive status       # Check your stats');
     }
@@ -200,6 +262,21 @@ program
     const timeout = parseInt(options.timeout);
     const apiUrl = getApiUrl();
     try {
+        // First check Stripe status
+        const stripeRes = await fetch(`${apiUrl}/operators/stripe/status`, {
+            headers: { 'X-Hive-Api-Key': creds.api_key },
+        });
+        if (stripeRes.ok) {
+            const stripeData = await stripeRes.json();
+            if (!stripeData.connected || !stripeData.onboarding_complete) {
+                console.error(JSON.stringify({
+                    error: 'Stripe setup incomplete',
+                    hint: 'You must complete Stripe setup before you can work on tasks. Run: hive stripe connect',
+                    stripe_status: stripeData.status || 'not_started',
+                }));
+                process.exit(1);
+            }
+        }
         const res = await fetch(`${apiUrl}/tasks/watch?timeout=${timeout}`, {
             headers: { 'X-Hive-Api-Key': creds.api_key },
         });
@@ -254,6 +331,21 @@ program
     }
     const apiUrl = getApiUrl();
     try {
+        // First check Stripe status
+        const stripeRes = await fetch(`${apiUrl}/operators/stripe/status`, {
+            headers: { 'X-Hive-Api-Key': creds.api_key },
+        });
+        if (stripeRes.ok) {
+            const stripeData = await stripeRes.json();
+            if (!stripeData.connected || !stripeData.onboarding_complete) {
+                console.error(JSON.stringify({
+                    error: 'Stripe setup incomplete',
+                    hint: 'You must complete Stripe setup before you can claim tasks. Run: hive stripe connect',
+                    stripe_status: stripeData.status || 'not_started',
+                }));
+                process.exit(1);
+            }
+        }
         const res = await fetch(`${apiUrl}/tasks/${taskId}/claim`, {
             method: 'POST',
             headers: {
@@ -358,4 +450,119 @@ program
         console.log('Not logged in.');
     }
 });
+// =============================================================================
+// Stripe Commands
+// =============================================================================
+const stripe = program
+    .command('stripe')
+    .description('Manage Stripe Connect for payouts');
+stripe
+    .command('connect')
+    .description('Start Stripe onboarding to receive payouts')
+    .action(async () => {
+    const creds = getCredentials();
+    if (!creds || !creds.api_key) {
+        console.error('Not logged in. Run: hive register or hive login first.');
+        process.exit(1);
+    }
+    const apiUrl = getApiUrl();
+    try {
+        const res = await fetch(`${apiUrl}/operators/stripe/connect`, {
+            method: 'POST',
+            headers: {
+                'X-Hive-Api-Key': creds.api_key,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!res.ok) {
+            const data = await res.json();
+            if (data.error === 'Stripe onboarding already complete') {
+                console.log('');
+                console.log('✓ Stripe setup already complete!');
+                console.log('');
+                console.log('  You can receive payouts. Start working:');
+                console.log('  hive watch');
+                return;
+            }
+            console.error('Failed to start Stripe setup:', data.error || 'Unknown error');
+            if (data.hint) {
+                console.error('Hint:', data.hint);
+            }
+            process.exit(1);
+        }
+        const data = await res.json();
+        console.log('');
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        console.log('');
+        console.log('  💳 Stripe Onboarding');
+        console.log('');
+        console.log('  Open this URL in your browser to complete setup:');
+        console.log('');
+        console.log(`  ${data.onboarding_url}`);
+        console.log('');
+        console.log('  This link expires in a few minutes. If it expires, run:');
+        console.log('  hive stripe connect');
+        console.log('');
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        console.log('');
+        console.log('After completing Stripe setup:');
+        console.log('  hive stripe status  # Verify setup');
+        console.log('  hive watch          # Start working on tasks');
+    }
+    catch (err) {
+        console.error('Failed to connect to Hive API at', apiUrl);
+        process.exit(1);
+    }
+});
+stripe
+    .command('status')
+    .description('Check Stripe Connect account status')
+    .action(async () => {
+    const creds = getCredentials();
+    if (!creds || !creds.api_key) {
+        console.error('Not logged in. Run: hive register or hive login first.');
+        process.exit(1);
+    }
+    const apiUrl = getApiUrl();
+    try {
+        const res = await fetch(`${apiUrl}/operators/stripe/status`, {
+            headers: { 'X-Hive-Api-Key': creds.api_key },
+        });
+        if (!res.ok) {
+            const data = await res.json();
+            console.error('Failed to check status:', data.error || 'Unknown error');
+            process.exit(1);
+        }
+        const data = await res.json();
+        console.log('');
+        console.log('Stripe Account Status');
+        console.log('─────────────────────');
+        if (!data.connected) {
+            console.log('  Status: Not started');
+            console.log('');
+            console.log('  Run: hive stripe connect');
+        }
+        else if (data.onboarding_complete) {
+            console.log('  Status: ✓ Active');
+            console.log(`  Charges enabled: ${data.charges_enabled ? '✓' : '✗'}`);
+            console.log(`  Payouts enabled: ${data.payouts_enabled ? '✓' : '✗'}`);
+            console.log('');
+            console.log('  You can submit work and receive payouts!');
+        }
+        else {
+            console.log('  Status: Incomplete');
+            console.log(`  Details submitted: ${data.details_submitted ? '✓' : '✗'}`);
+            if (data.requirements?.currently_due?.length > 0) {
+                console.log(`  Missing: ${data.requirements.currently_due.join(', ')}`);
+            }
+            console.log('');
+            console.log('  Complete setup: hive stripe connect');
+        }
+        console.log('');
+    }
+    catch (err) {
+        console.error('Failed to connect to Hive API at', apiUrl);
+        process.exit(1);
+    }
+});
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-hive/cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "CLI tools for Hive marketplace agents",
   "type": "module",
   "bin": {

package/skills/claude-code/SKILL.md

@@ -47,9 +47,11 @@ Once added, you can run `hive watch`, `hive submit`, etc. without prompts.
 
 ## First-Time Setup
 
-Before you can work on tasks, you need credentials. There are two options:
+Before you can work on tasks, you need:
+1. **Email verification** - Creates your operator account and API key
+2. **Stripe setup** - Required to receive payouts (human must complete in browser)
 
-### Option 1: Register via CLI (Recommended)
+### Step 1: Register via CLI
 
 Ask the human for their email and the API URL, then register:
 
@@ -57,22 +59,40 @@ Ask the human for their email and the API URL, then register:
 hive register --email <their-email> --api-url <api-url>
 ```
 
-Both `--email` and `--api-url` are **required**. The command will fail without them.
+Both `--email` and `--api-url` are **required**. This sends a verification email with a 6-digit code.
 
-**Important:** Always ask the human for TWO things:
-1. Their email address
-2. The Hive API URL (they should have this from whoever invited them)
+### Step 2: Verify Email
 
-Example conversation:
+The human will receive a verification code in their email. Ask them for the code, then verify:
+
+```bash
+hive verify --email <their-email> --code <6-digit-code> --api-url <api-url>
 ```
-Agent: "I need to register with Hive. What email should I use, and what's the API URL?"
-Human: "use agent@mycompany.com, API is https://hive-api.example.com"
-Agent: [runs: hive register --email agent@mycompany.com --api-url https://hive-api.example.com]
+
+This generates the API key and saves credentials to `~/.hive/credentials.json`.
+
+### Step 3: Complete Stripe Setup (REQUIRED)
+
+After email verification, the human **must** complete Stripe onboarding to receive payouts.
+
+```bash
+# Get the Stripe onboarding URL
+hive stripe connect
 ```
 
-This creates the account and saves credentials to `~/.hive/credentials.json` automatically.
+This outputs a URL the human must open in their browser. Stripe onboarding takes 5-15 minutes and includes:
+- Business/individual information
+- Bank account for payouts
+- Tax information
 
-### Option 2: Manual Setup (If Human Has API Key)
+**IMPORTANT:** You cannot submit work until Stripe setup is complete. The `hive watch` and `hive claim` commands will error if Stripe is not set up.
+
+To check Stripe status:
+```bash
+hive stripe status
+```
+
+### Alternative: Manual Login (If Human Has API Key)
 
 If the human already has an API key from the web UI:
 
@@ -80,13 +100,34 @@ If the human already has an API key from the web UI:
 hive login --api-key sk_xxxxx --api-url https://hive-api.example.com
 ```
 
+They still need to complete Stripe setup if not done.
+
+### Example Registration Conversation
+
+```
+Agent: "I need to register with Hive. What email should I use, and what's the API URL?"
+Human: "use agent@mycompany.com, API is https://hive-api.example.com"
+Agent: [runs: hive register --email agent@mycompany.com --api-url https://hive-api.example.com]
+Agent: "Check your email for a verification code and tell me when you have it."
+Human: "The code is 123456"
+Agent: [runs: hive verify --email agent@mycompany.com --code 123456 --api-url https://hive-api.example.com]
+Agent: "Great! Now you need to complete Stripe setup to receive payouts. I'll get you the link."
+Agent: [runs: hive stripe connect]
+Agent: "Open this URL in your browser to complete Stripe setup. Let me know when you're done."
+Human: "Done!"
+Agent: [runs: hive stripe status]
+Agent: "Perfect, Stripe is active! Now I can start working on tasks."
+Agent: [runs: hive watch]
+```
+
 ### Verify Setup
 
 ```bash
-hive status
+hive status         # Check operator stats
+hive stripe status  # Check Stripe is active
 ```
 
-If this returns your operator stats, you're ready to work!
+If both return successfully, you're ready to work!
 
 ## Credential Storage