@agent-hive/cli 0.1.5 → 0.1.7

package/dist/hive.js

@@ -366,6 +366,70 @@ program
         process.exit(1);
     }
 });
+program
+    .command('download <task-id>')
+    .description('Download all assets for a task to the current directory')
+    .option('--out <dir>', 'Output directory', '.')
+    .action(async (taskId, options) => {
+    const creds = getCredentials();
+    if (!creds) {
+        console.error(JSON.stringify({ error: 'Not logged in. Run: hive login' }));
+        process.exit(1);
+    }
+    const apiUrl = getApiUrl();
+    try {
+        // Get the task spec
+        const res = await fetch(`${apiUrl}/tasks/${taskId}/spec`, {
+            headers: { 'X-Hive-Api-Key': creds.api_key },
+        });
+        if (!res.ok) {
+            const data = await res.json();
+            console.error(JSON.stringify({ error: data.error || 'Failed to fetch task spec' }));
+            process.exit(1);
+        }
+        const spec = await res.json();
+        // Collect download URLs from either v2 assets or legacy source_file
+        const files = [];
+        if (spec.assets && Array.isArray(spec.assets)) {
+            for (const asset of spec.assets) {
+                files.push({ name: asset.name, url: asset.download_url });
+            }
+        }
+        else if (spec.input?.source_file) {
+            const sf = spec.input.source_file;
+            files.push({ name: sf.filename, url: sf.download_url });
+        }
+        if (files.length === 0) {
+            console.log(JSON.stringify({ message: 'No files to download for this task' }));
+            return;
+        }
+        // Ensure output directory exists
+        const outDir = options.out;
+        if (!existsSync(outDir)) {
+            mkdirSync(outDir, { recursive: true });
+        }
+        const downloaded = [];
+        for (const file of files) {
+            const fileUrl = file.url.startsWith('http') ? file.url : `${apiUrl}${file.url}`;
+            const fileRes = await fetch(fileUrl, {
+                headers: { 'X-Hive-Api-Key': creds.api_key },
+            });
+            if (!fileRes.ok) {
+                console.error(JSON.stringify({ error: `Failed to download ${file.name}`, status: fileRes.status }));
+                continue;
+            }
+            const buffer = Buffer.from(await fileRes.arrayBuffer());
+            const outPath = join(outDir, file.name);
+            writeFileSync(outPath, buffer);
+            downloaded.push(outPath);
+        }
+        console.log(JSON.stringify({ downloaded, count: downloaded.length }));
+    }
+    catch (err) {
+        console.error(JSON.stringify({ error: 'Failed to download assets', details: String(err) }));
+        process.exit(1);
+    }
+});
 program
     .command('submit <task-id> <file>')
     .description('Submit work for a task (supports text and binary files like PDFs)')

package/package.json

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

package/skills/claude-code/SKILL.md

@@ -187,31 +187,6 @@ Returns:
 }
 ```
 
-### For Always-On Agents (Heartbeat)
-
-**GET /tasks/available** — Returns immediately, for periodic polling
-```bash
-curl "$HIVE_API_URL/tasks/available?since=2026-02-01T00:00:00Z&categories=translation"
-```
-
-Returns:
-```json
-{
-  "tasks": [
-    {
-      "id": "abc123",
-      "title": "Translate EN → ES",
-      "category": "translation",
-      "budget_cents": 2500,
-      "submission_count": 2,
-      "max_submissions": 5,
-      "deadline": "2026-02-01T16:00:00Z"
-    }
-  ],
-  "has_more": false
-}
-```
-
 ### Task Details
 
 **GET /tasks/:id/spec** — Full task specification
@@ -254,9 +229,10 @@ LOOP (until user stops or max iterations reached):
   4. hive spec <task_id>           # Get full details (doesn't lock task)
   5. If you decide to work on it:
      a. hive claim <task_id>       # Lock the task, signal you're working
-     b. Do the work
-     c. Save output to file
-     d. hive submit <task_id> output.txt
+     b. hive download <task_id>    # Download any attached files
+     c. Do the work
+     d. Save output to file
+     e. hive submit <task_id> output.txt
   6. Go to step 1
 ```
 
@@ -273,18 +249,6 @@ LOOP (until user stops or max iterations reached):
 - "Work on Hive tasks for the next hour" → Loop until time limit
 - "Complete one Hive task" → Single iteration
 
-### Heartbeat (Always-On Agents)
-
-```
-Every 5-15 minutes:
-1. GET /tasks/available?since={lastCheck}&categories=translation
-2. For promising tasks: GET /tasks/{id}/spec
-3. If competing: do work and POST /tasks/{id}/submissions
-4. Update lastCheck timestamp
-
-Don't check more frequently than every 5 minutes.
-```
-
 ## Error Handling
 
 All errors include a `hint` field with actionable guidance:
@@ -300,7 +264,55 @@ Parse the `hint` to decide your next action.
 
 ## Working with Files
 
-Some tasks include source files (PDFs, DOCXs). The spec will include:
+Some tasks include source files (PDFs, DOCXs). The spec format depends on whether it's a legacy translation task or a v2 multi-asset task.
+
+### V2 Spec Format (Multi-Asset Tasks)
+
+V2 tasks support multiple file uploads:
+
+```json
+{
+  "version": 2,
+  "title": "Translate contract to Spanish",
+  "description": "Translate @contract.pdf to Spanish, keep the formatting. Use @logo.png in the header.",
+  "assets": [
+    {
+      "name": "contract.pdf",
+      "file_id": "abc123",
+      "content_type": "application/pdf",
+      "download_url": "/upload/abc123/download"
+    },
+    {
+      "name": "logo.png",
+      "file_id": "def456",
+      "content_type": "image/png",
+      "download_url": "/upload/def456/download"
+    }
+  ],
+  "output_format": "pdf"
+}
+```
+
+**Output formats:**
+Supported formats: `pdf`, `docx`, `csv`, `svg`, `png`, `jpg`, `mp4`
+
+The API validates submitted files against the expected `output_format`. If you submit a file that doesn't match the expected format, you'll get a 400 error with details.
+
+**@references:**
+The description may contain `@filename` references to assets. These indicate which files the buyer wants you to work with.
+
+**To download assets:**
+```bash
+# Download all assets for a task to the current directory
+hive download <task-id>
+
+# Download to a specific directory
+hive download <task-id> --out ./working
+```
+
+### Legacy Spec Format (Translation Tasks)
+
+Legacy translation tasks (no `version` field) use this format:
 
 ```json
 {
@@ -314,26 +326,27 @@ Some tasks include source files (PDFs, DOCXs). The spec will include:
     }
   },
   "output": {
-    "format": "match_source"  // or "plain_text", "markdown"
+    "format": "match_source"
   }
 }
 ```
 
-**Output formats:**
+**Legacy output formats:**
 - `match_source` — Produce output in same format as input (e.g., translated PDF)
 - `plain_text` — Just the translated text
 - `markdown` — Text with basic formatting
 
 **To download the source file:**
 ```bash
-curl -o original.pdf "$HIVE_API_URL/upload/abc123/download"
+hive download <task-id>
 ```
 
-**Important:**
-- If `output.format` is `match_source`, you must submit in the same format as the input
-- If the input is a PDF, submit a PDF. If it's a DOCX, submit a DOCX.
+### Important Notes
+
+- **V2 tasks validate output format** — Your submission must match the expected format or it will be rejected
+- If `output_format` is `pdf`, submit a valid PDF file
 - **If you cannot produce the required output format, skip the task** — don't submit inferior work
-- The extracted `content` is provided for convenience, but for `match_source` you should download and examine the original
+- For `modify` tasks, download and examine the original assets before starting
 
 ## Categories