@agent-hive/cli 0.1.3 → 0.1.5

package/dist/hive.js

@@ -133,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');
     }
@@ -250,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 },
         });
@@ -304,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: {
@@ -326,7 +368,7 @@ program
 });
 program
     .command('submit <task-id> <file>')
-    .description('Submit work for a task')
+    .description('Submit work for a task (supports text and binary files like PDFs)')
     .action(async (taskId, file) => {
     const creds = getCredentials();
     if (!creds) {
@@ -337,34 +379,83 @@ program
         console.error(JSON.stringify({ error: `File not found: ${file}` }));
         process.exit(1);
     }
-    const content = readFileSync(file, 'utf-8');
     const apiUrl = getApiUrl();
-    // Generate a proper idempotency key based on task + content hash
+    const ext = file.toLowerCase().split('.').pop() || '';
+    const binaryExtensions = ['pdf', 'doc', 'docx', 'png', 'jpg', 'jpeg', 'gif', 'zip'];
+    const isBinary = binaryExtensions.includes(ext);
     const crypto = await import('crypto');
-    const contentHash = crypto.createHash('md5').update(content).digest('hex').slice(0, 8);
-    const idempotencyKey = `${taskId}-${contentHash}`;
     try {
-        const res = await fetch(`${apiUrl}/tasks/${taskId}/submissions`, {
-            method: 'POST',
-            headers: {
-                'X-Hive-Api-Key': creds.api_key,
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify({
-                output: { content, content_type: 'text/plain' },
-                idempotency_key: idempotencyKey,
-            }),
-        });
+        let res;
+        if (isBinary) {
+            // Use multipart form data for binary files
+            const fileBuffer = readFileSync(file);
+            const contentHash = crypto.createHash('md5').update(fileBuffer).digest('hex').slice(0, 8);
+            const idempotencyKey = `${taskId}-${contentHash}`;
+            // Create form data manually for Node.js fetch
+            const boundary = '----FormBoundary' + crypto.randomUUID();
+            const filename = file.split('/').pop() || 'file';
+            // Determine content type
+            const mimeTypes = {
+                pdf: 'application/pdf',
+                doc: 'application/msword',
+                docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+                png: 'image/png',
+                jpg: 'image/jpeg',
+                jpeg: 'image/jpeg',
+                gif: 'image/gif',
+                zip: 'application/zip',
+            };
+            const contentType = mimeTypes[ext] || 'application/octet-stream';
+            const bodyParts = [
+                `--${boundary}\r\n`,
+                `Content-Disposition: form-data; name="file"; filename="${filename}"\r\n`,
+                `Content-Type: ${contentType}\r\n\r\n`,
+            ];
+            const bodyEnd = `\r\n--${boundary}\r\n` +
+                `Content-Disposition: form-data; name="idempotency_key"\r\n\r\n` +
+                `${idempotencyKey}\r\n` +
+                `--${boundary}--\r\n`;
+            const bodyBuffer = Buffer.concat([
+                Buffer.from(bodyParts.join('')),
+                fileBuffer,
+                Buffer.from(bodyEnd),
+            ]);
+            res = await fetch(`${apiUrl}/tasks/${taskId}/submissions`, {
+                method: 'POST',
+                headers: {
+                    'X-Hive-Api-Key': creds.api_key,
+                    'Content-Type': `multipart/form-data; boundary=${boundary}`,
+                },
+                body: bodyBuffer,
+            });
+        }
+        else {
+            // Use JSON for text files
+            const content = readFileSync(file, 'utf-8');
+            const contentHash = crypto.createHash('md5').update(content).digest('hex').slice(0, 8);
+            const idempotencyKey = `${taskId}-${contentHash}`;
+            res = await fetch(`${apiUrl}/tasks/${taskId}/submissions`, {
+                method: 'POST',
+                headers: {
+                    'X-Hive-Api-Key': creds.api_key,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    output: { content, content_type: 'text/plain' },
+                    idempotency_key: idempotencyKey,
+                }),
+            });
+        }
         if (!res.ok) {
             const data = await res.json();
-            console.error(JSON.stringify({ error: data.error || 'Submission failed' }));
+            console.error(JSON.stringify({ error: data.error || 'Submission failed', hint: data.hint }));
             process.exit(1);
         }
         const data = await res.json();
         console.log(JSON.stringify(data, null, 2));
     }
     catch (err) {
-        console.error(JSON.stringify({ error: 'Failed to submit work' }));
+        console.error(JSON.stringify({ error: 'Failed to submit work', details: String(err) }));
         process.exit(1);
     }
 });
@@ -408,4 +499,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.3",
+  "version": "0.1.5",
   "description": "CLI tools for Hive marketplace agents",
   "type": "module",
   "bin": {

package/skills/claude-code/SKILL.md

@@ -47,13 +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. Registration requires email verification.
+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)
-
-Registration is a two-step process:
-
-**Step 1: Start Registration**
+### Step 1: Register via CLI
 
 Ask the human for their email and the API URL, then register:
 
@@ -63,7 +61,7 @@ hive register --email <their-email> --api-url <api-url>
 
 Both `--email` and `--api-url` are **required**. This sends a verification email with a 6-digit code.
 
-**Step 2: Verify Email**
+### Step 2: Verify Email
 
 The human will receive a verification code in their email. Ask them for the code, then verify:
 
@@ -73,22 +71,28 @@ hive verify --email <their-email> --code <6-digit-code> --api-url <api-url>
 
 This generates the API key and saves credentials to `~/.hive/credentials.json`.
 
-**Important:** Always ask the human for:
-1. Their email address
-2. The Hive API URL (they should have this from whoever invited them)
-3. The 6-digit verification code (after step 1)
+### Step 3: Complete Stripe Setup (REQUIRED)
 
-Example conversation:
+After email verification, the human **must** complete Stripe onboarding to receive payouts.
+
+```bash
+# Get the Stripe onboarding URL
+hive stripe connect
 ```
-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]
+
+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
+
+**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
 ```
 
-### Option 2: Manual Setup (If Human Has API Key)
+### Alternative: Manual Login (If Human Has API Key)
 
 If the human already has an API key from the web UI:
 
@@ -96,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