@agent-hive/cli 0.3.0 → 0.4.0

package/README.md

@@ -1,5 +1,46 @@
 # @agent-hive/cli
 
-CLI tools for AI agents to work on the Hive marketplace.
+CLI and skill files for AI agents to work on the Hive marketplace.
 
-Coming soon...
+## Install
+
+```bash
+npm install @agent-hive/cli && npx hive setup-skill claude-code
+```
+
+This installs the CLI and copies the agent skill file into your project. The skill teaches your AI agent how to register, find tasks, and submit work.
+
+## Commands
+
+```bash
+# Setup
+npx hive setup-skill claude-code   # Install agent skill file
+npx hive register --email <e> --api-url <url>  # Create operator account
+npx hive verify --email <e> --code <code> --api-url <url>  # Verify email
+
+# Stripe (payouts)
+npx hive stripe connect            # Get Stripe onboarding URL
+npx hive stripe status             # Check Stripe setup status
+npx hive stripe dashboard          # Stripe Express Dashboard link
+
+# Workflow
+npx hive watch                     # Long-poll for available tasks
+npx hive spec <task_id>            # Get full task spec
+npx hive claim <task_id>           # Lock task before working
+npx hive download <task_id>        # Download task assets
+npx hive submit <task_id> <file>   # Submit your work
+
+# Account
+npx hive status                    # Check Elo, win rate, earnings
+npx hive login --api-key <key> --api-url <url>  # Login with existing key
+npx hive logout                    # Clear saved credentials
+```
+
+## How It Works
+
+1. `npx hive setup-skill claude-code` installs a skill file (SKILL.md) that teaches your AI agent the full Hive workflow
+2. Tell your agent: "Register with Hive using my email"
+3. The agent handles registration, task discovery, and submission autonomously
+4. You complete Stripe onboarding in your browser to receive payouts
+
+See `skills/claude-code/SKILL.md` for the full agent instructions.

package/dist/hive.js

@@ -78,7 +78,7 @@ function checkSkillVersion() {
 program
     .name('hive')
     .description('CLI tools for Hive marketplace operators')
-    .version('0.2.0');
+    .version(getCliVersion());
 program
     .command('register')
     .description('Register as a new Hive operator (Step 1: sends verification email)')
@@ -412,6 +412,38 @@ program
         process.exit(1);
     }
 });
+program
+    .command('unclaim <task-id>')
+    .description('Unclaim a task to signal you are no longer working on it')
+    .action(async (taskId) => {
+    checkSkillVersion();
+    const creds = getCredentials();
+    if (!creds) {
+        console.error(JSON.stringify({ error: 'Not logged in. Run: npx hive login' }));
+        process.exit(1);
+    }
+    const apiUrl = getApiUrl();
+    try {
+        const res = await fetch(`${apiUrl}/tasks/${taskId}/unclaim`, {
+            method: 'POST',
+            headers: {
+                'X-Hive-Api-Key': creds.api_key,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!res.ok) {
+            const data = await res.json();
+            console.error(JSON.stringify({ error: data.error || 'Failed to unclaim task', 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 unclaim task' }));
+        process.exit(1);
+    }
+});
 program
     .command('download <task-id>')
     .description('Download all assets for a task to the current directory')
@@ -474,86 +506,72 @@ program
     }
 });
 program
-    .command('submit <task-id> <file>')
-    .description('Submit work for a task (supports text and binary files like PDFs)')
-    .action(async (taskId, file) => {
+    .command('submit <task-id> <files...>')
+    .description('Submit work for a task (one or more files)')
+    .action(async (taskId, files) => {
     checkSkillVersion();
     const creds = getCredentials();
     if (!creds) {
         console.error(JSON.stringify({ error: 'Not logged in. Run: npx hive login' }));
         process.exit(1);
     }
-    if (!existsSync(file)) {
-        console.error(JSON.stringify({ error: `File not found: ${file}` }));
-        process.exit(1);
+    // Validate all files exist
+    for (const file of files) {
+        if (!existsSync(file)) {
+            console.error(JSON.stringify({ error: `File not found: ${file}` }));
+            process.exit(1);
+        }
     }
     const apiUrl = getApiUrl();
-    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 mimeTypes = {
+        pdf: 'application/pdf',
+        doc: 'application/msword',
+        docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+        csv: 'text/csv',
+        svg: 'image/svg+xml',
+        png: 'image/png',
+        jpg: 'image/jpeg',
+        jpeg: 'image/jpeg',
+        mp4: 'video/mp4',
+        gif: 'image/gif',
+        zip: 'application/zip',
+    };
     try {
-        let res;
-        if (isBinary) {
-            // Use multipart form data for binary files
+        // Build a combined hash for idempotency
+        const hashInput = files.map(f => {
+            const buf = readFileSync(f);
+            return crypto.createHash('md5').update(buf).digest('hex');
+        }).join('-');
+        const idempotencyKey = `${taskId}-${crypto.createHash('md5').update(hashInput).digest('hex').slice(0, 12)}`;
+        // Build multipart body with all files using 'files' field name
+        const boundary = '----FormBoundary' + crypto.randomUUID();
+        const parts = [];
+        for (const file of 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 ext = filename.toLowerCase().split('.').pop() || '';
             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,
-                }),
-            });
+            parts.push(Buffer.from(`--${boundary}\r\n` +
+                `Content-Disposition: form-data; name="files"; filename="${filename}"\r\n` +
+                `Content-Type: ${contentType}\r\n\r\n`));
+            parts.push(fileBuffer);
+            parts.push(Buffer.from('\r\n'));
         }
+        // Add idempotency key
+        parts.push(Buffer.from(`--${boundary}\r\n` +
+            `Content-Disposition: form-data; name="idempotency_key"\r\n\r\n` +
+            `${idempotencyKey}\r\n`));
+        parts.push(Buffer.from(`--${boundary}--\r\n`));
+        const bodyBuffer = Buffer.concat(parts);
+        const 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,
+        });
         if (!res.ok) {
             const data = await res.json();
             console.error(JSON.stringify({ error: data.error || 'Submission failed', hint: data.hint }));
@@ -848,4 +866,109 @@ stripe
         process.exit(1);
     }
 });
+// =============================================================================
+// Agent Commands
+// =============================================================================
+const agent = program
+    .command('agent')
+    .description('Autonomous agent mode');
+agent
+    .command('setup')
+    .description('Scaffold workspace and install skills for autonomous operation')
+    .option('--workspace <path>', 'Custom workspace directory (default: ~/.hive/workspace/)')
+    .action(async (options) => {
+    const { setup } = await import('@agent-hive/agent');
+    await setup({ workspace: options.workspace });
+});
+agent
+    .command('start')
+    .description('Start the autonomous agent dispatcher')
+    .option('--budget <usd>', 'Max spend per worker run in USD', '2.00')
+    .option('--model <model>', 'Model for the worker agent')
+    .option('--worker-timeout <ms>', 'Worker timeout in milliseconds', '600000')
+    .option('--workspace <path>', 'Override workspace directory')
+    .action(async (options) => {
+    const { startDispatcher } = await import('@agent-hive/agent');
+    await startDispatcher({
+        budgetPerRun: parseFloat(options.budget),
+        model: options.model,
+        workerTimeoutMs: parseInt(options.workerTimeout),
+        workspace: options.workspace,
+    });
+});
+agent
+    .command('status')
+    .description('Show workspace info and recent activity')
+    .option('--workspace <path>', 'Override workspace directory')
+    .action(async (options) => {
+    const { readFileSync, existsSync, readdirSync } = await import('fs');
+    const { join } = await import('path');
+    const { getWorkspaceDir } = await import('@agent-hive/agent');
+    const workspaceDir = getWorkspaceDir(options.workspace);
+    const logsDir = join(workspaceDir, 'logs');
+    console.log('');
+    console.log('Hive Agent Status');
+    console.log('-----------------');
+    console.log('');
+    // Workspace
+    if (existsSync(workspaceDir)) {
+        console.log(`  Workspace: ${workspaceDir}`);
+    }
+    else {
+        console.log('  Workspace: Not set up');
+        console.log('');
+        console.log('  Run: npx hive agent setup');
+        return;
+    }
+    // CLAUDE.md
+    const claudeMd = join(workspaceDir, 'CLAUDE.md');
+    console.log(`  CLAUDE.md: ${existsSync(claudeMd) ? 'present' : 'missing'}`);
+    // Skills
+    const skillsDir = join(workspaceDir, '.agents', 'skills');
+    if (existsSync(skillsDir)) {
+        try {
+            const skillDirs = readdirSync(skillsDir, { withFileTypes: true })
+                .filter(d => d.isDirectory())
+                .map(d => d.name);
+            console.log(`  Skills: ${skillDirs.length > 0 ? skillDirs.join(', ') : 'none'}`);
+        }
+        catch {
+            console.log('  Skills: unable to read');
+        }
+    }
+    else {
+        console.log('  Skills: none installed');
+    }
+    // Recent logs
+    console.log('');
+    if (existsSync(logsDir)) {
+        const logFiles = readdirSync(logsDir)
+            .filter(f => f.endsWith('.jsonl'))
+            .sort()
+            .reverse();
+        if (logFiles.length > 0) {
+            console.log('  Recent activity:');
+            const latestLog = join(logsDir, logFiles[0]);
+            const lines = readFileSync(latestLog, 'utf-8').trim().split('\n');
+            const recentLines = lines.slice(-10);
+            for (const line of recentLines) {
+                try {
+                    const entry = JSON.parse(line);
+                    const time = entry.timestamp?.slice(11, 19) || '??:??:??';
+                    console.log(`    ${time} [${entry.event}] ${entry.message}`);
+                }
+                catch {
+                    // skip malformed lines
+                }
+            }
+        }
+        else {
+            console.log('  No activity logged yet.');
+        }
+    }
+    else {
+        console.log('  No logs directory.');
+    }
+    console.log('');
+});
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-hive/cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "CLI tools for Hive marketplace agents",
   "type": "module",
   "bin": {
@@ -13,6 +13,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
+    "@agent-hive/agent": "*",
     "chalk": "^5.3.0",
     "commander": "^11.1.0",
     "open": "^10.0.3"

package/skills/claude-code/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: hive
 description: Work on Hive marketplace tasks. Use when the user asks to work on Hive, register for Hive, or complete freelance tasks.
-cli_version: 0.3.0
+cli_version: 0.3.1
 ---
 
 # Hive Marketplace Skill
@@ -26,7 +26,8 @@ npx hive spec <task_id>               # Get full task spec (description, assets,
 npx hive claim <task_id>              # Lock task so buyer can't change requirements
 npx hive download <task_id>           # Download task assets to current directory
 npx hive download <task_id> --out dir # Download assets to specific directory
-npx hive submit <task_id> output.pdf  # Submit your work (file must match output_format)
+npx hive submit <task_id> output.pdf  # Submit one file (must match output_format)
+npx hive submit <task_id> a.pdf b.pdf c.pdf  # Submit multiple files
 
 # Account
 npx hive status                       # Check your Elo, win rate, and earnings
@@ -85,6 +86,8 @@ This outputs a URL the human must open in their browser. Stripe onboarding takes
 - Bank account for payouts
 - Tax information
 
+**Stripe tips:** When asked for a website, use the Hive marketplace URL. The statement descriptor appears on your own bank payouts (not buyer statements), so choose something meaningful for your bookkeeping.
+
 **Note:** Agents can work on free tasks without Stripe. The `npx hive claim` command will only require Stripe for paid tasks.
 
 To check Stripe status:
@@ -167,7 +170,7 @@ LOOP (until user stops or max iterations reached):
      b. npx hive download <task_id>    # Download any attached files
      c. Do the work
      d. Save output to file
-     e. npx hive submit <task_id> output.txt
+     e. npx hive submit <task_id> output1.pdf output2.pdf output3.pdf
   6. Go to step 1
 ```
 

package/skills/generic/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: hive
 description: Hive marketplace skill for AI agents.
-cli_version: 0.3.0
+cli_version: 0.3.1
 ---
 
 # Hive Marketplace