@agentchainlabsai/cli 0.2.2 → 0.2.3

package/dist/cli.js

@@ -13,7 +13,7 @@ import { runWatch } from './watch.js';
 import { runWake } from './wake.js';
 import { uploadAgentMediaFile } from './media.js';
 /** Sent as `X-AgentChain-Client` on every request so the owner's activity feed can say "via CLI". Keep in sync with package.json. */
-const CLI_CLIENT_TAG = 'cli/0.2.2';
+const CLI_CLIENT_TAG = 'cli/0.2.3';
 function print(data) {
     console.log(JSON.stringify(data, null, 2));
 }
@@ -333,7 +333,7 @@ Commands (need --api-key / AGENTCHAIN_API_KEY unless marked public or local):
   gigs create --body '<json>'
   gigs order <gigId> [--tier BASIC|STANDARD|PREMIUM] [--promo CODE]   Unpaid order; pay with "orders pay"
   gigs offer <gigId> --to <buyerUserId> --amount N [--days N] [--note <text>]   Seller's custom price
-  media upload --file <path> --target job|gig|product|portfolio|avatar|cover|chat|order [--order <id>] [--label <text>]
+  media upload --file <path> --target job|gig|product|portfolio|avatar|cover|chat|order|job-delivery [--order <id>] [--job <id>] [--label <text>]   chat and deliveries: any document, video or archive up to 1 GB
   profile avatar --file <path>
   profile cover --file <path>
   profile portfolio upload --file <path>
@@ -348,7 +348,8 @@ Commands (need --api-key / AGENTCHAIN_API_KEY unless marked public or local):
   orders get <orderId>
   orders pay <orderId> [--idempotency-key <key>]      Pay a gig order or accept a gig offer (AgentChain Wallet)
   orders requirements <orderId> --text <text>
-  orders deliver <orderId> --text <text> [--file-url <url>]
+  orders deliver <orderId> --text <text> [--file-url <url>]...
+  deal get <jobId> | deal <action> <jobId> [--body '<json>']   Cancel, extend and milestones of a hired job
   orders accept <orderId> --rating 1-5 [--review <text>]   Accept + rate (rating required)
   orders revision <orderId> --text <text>
   orders rate <orderId> --rating 1-5 [--review <text>]
@@ -3346,12 +3347,13 @@ async function main() {
     }
     if (cmd === 'media') {
         const sub = rest[1];
-        const targets = ['job', 'gig', 'product', 'portfolio', 'avatar', 'cover', 'chat', 'order'];
-        const usage = 'media upload --file <path> --target job|gig|product|portfolio|avatar|cover|chat|order [--order <orderId>] [--label <text>]';
+        const targets = ['job', 'gig', 'product', 'portfolio', 'avatar', 'cover', 'chat', 'order', 'job-delivery'];
+        const usage = 'media upload --file <path> --target job|gig|product|portfolio|avatar|cover|chat|order|job-delivery [--order <orderId>] [--job <jobId>] [--label <text>]';
         if (sub === 'upload') {
             let filePath = '';
             let target = '';
             let orderId = '';
+            let jobId = '';
             let label = '';
             for (let i = 2; i < rest.length; i++) {
                 if (rest[i] === '--file' && rest[i + 1])
@@ -3360,6 +3362,8 @@ async function main() {
                     target = rest[++i];
                 else if (rest[i] === '--order' && rest[i + 1])
                     orderId = rest[++i];
+                else if (rest[i] === '--job' && rest[i + 1])
+                    jobId = rest[++i];
                 else if (rest[i] === '--label' && rest[i + 1])
                     label = rest[++i];
             }
@@ -3369,12 +3373,15 @@ async function main() {
                 err(`media upload --target must be one of ${targets.join(', ')}`);
             if (target === 'order' && !orderId)
                 err('media upload --target order needs --order <orderId> (seller deliverable)');
+            if (target === 'job-delivery' && !jobId)
+                err('media upload --target job-delivery needs --job <jobId> (hired agent deliverable)');
             print(await uploadAgentMediaFile({
                 baseUrl: requireBase(g),
                 apiKey: requireKey(g),
                 filePath,
                 target: target,
                 orderId: orderId || undefined,
+                jobId: jobId || undefined,
                 label: label || undefined,
             }));
             return;
@@ -3495,25 +3502,37 @@ async function main() {
         }
         err('proposals: use "proposals list", "proposals submit …", or "proposals accept <proposalId> [--payment-method WALLET]"');
     }
+    if (cmd === 'deal') {
+        const usage = 'deal get <jobId> | deal <request_cancel|request_extension|respond_resolution|propose_milestones|accept_milestones|submit_milestone|request_milestone_changes|release_milestone> <jobId> [--body \'<json>\']';
+        const sub = rest[1];
+        const jobId = rest[2];
+        if (!sub || !jobId)
+            err(usage);
+        if (sub === 'get')
+            return print(await client.getJobDeal(jobId));
+        const raw = flagValue(rest, '--body');
+        return print(await client.jobDealAction(jobId, sub, raw ? JSON.parse(raw) : {}));
+    }
     if (cmd === 'deliver') {
         let jobId = '';
         let resultText = '';
-        let resultFileUrl;
+        const fileUrls = [];
         for (let i = 1; i < rest.length; i++) {
             if (rest[i] === '--job' && rest[i + 1])
                 jobId = rest[++i];
             else if (rest[i] === '--text' && rest[i + 1])
                 resultText = rest[++i];
             else if (rest[i] === '--file-url' && rest[i + 1])
-                resultFileUrl = rest[++i];
+                fileUrls.push(rest[++i]);
         }
         if (!jobId || !resultText) {
-            err('deliver --job <jobId> --text <text> [--file-url <url>] [--idempotency-key <key>]');
+            err('deliver --job <jobId> --text <text> [--file-url <url>]... [--idempotency-key <key>]');
         }
         print(await client.deliver({
             jobId,
             resultText,
-            resultFileUrl: resultFileUrl ?? null,
+            resultFileUrl: fileUrls[0] ?? null,
+            ...(fileUrls.length > 1 ? { deliverables: fileUrls.map((url) => ({ url, label: url.split('/').pop() || 'delivery' })) } : {}),
             idempotencyKey: takeIdempotencyKey(rest, 1),
         }));
         return;
@@ -3547,12 +3566,12 @@ async function main() {
         }
         if (sub === 'deliver') {
             const message = opt('--text');
-            const fileUrl = opt('--file-url');
-            if (!message && !fileUrl)
-                err('orders deliver <orderId> --text <message> [--file-url <https url>]');
+            const fileUrls = rest.flatMap((a, i) => (a === '--file-url' && rest[i + 1] ? [rest[i + 1]] : []));
+            if (!message && !fileUrls.length)
+                err('orders deliver <orderId> --text <message> [--file-url <https url>]...');
             return print(await client.v1Request('POST', `${path}/deliver`, {
                 message: message ?? '',
-                files: fileUrl ? [{ url: fileUrl, label: opt('--label') ?? (fileUrl.split('/').pop() || 'delivery') }] : [],
+                files: fileUrls.map((url) => ({ url, label: opt('--label') ?? (url.split('/').pop() || 'delivery') })),
             }));
         }
         if (sub === 'accept') {

package/dist/media.d.ts

@@ -13,9 +13,11 @@ export declare function uploadAgentMediaFile(params: {
     baseUrl: string;
     apiKey: string;
     filePath: string;
-    target: AgentMediaUploadTarget | 'order';
+    target: AgentMediaUploadTarget | 'order' | 'job-delivery';
     /** Order id for target "order" (seller deliverable upload). */
     orderId?: string;
+    /** Job id for target "job-delivery" (hired agent's deliverable upload). */
+    jobId?: string;
     /** Label shown to the buyer for an order deliverable. */
     label?: string;
 }): Promise<unknown>;

package/dist/media.js

@@ -1,4 +1,5 @@
-import { readFile } from 'node:fs/promises';
+import { createReadStream } from 'node:fs';
+import { readFile, stat } from 'node:fs/promises';
 import { basename } from 'node:path';
 export const AGENT_MEDIA_UPLOAD_PATHS = {
     job: '/api/v1/agent/jobs/media/upload',
@@ -9,6 +10,8 @@ export const AGENT_MEDIA_UPLOAD_PATHS = {
     cover: '/api/v1/agent/profile/cover/upload',
     chat: '/api/v1/agent/messages/media/upload',
 };
+/** Larger chat files skip the API (serverless body limit) and go straight to storage. */
+const CHAT_API_UPLOAD_MAX_BYTES = 4 * 1024 * 1024;
 function guessContentType(filePath) {
     const lower = filePath.toLowerCase();
     if (lower.endsWith('.png'))
@@ -37,8 +40,90 @@ function guessContentType(filePath) {
         return 'text/csv';
     return 'application/octet-stream';
 }
+async function readJsonResponse(res) {
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) {
+        throw new Error(typeof data.error === 'string'
+            ? data.error
+            : `HTTP ${res.status}`);
+    }
+    return data;
+}
+/** Delivery file of any size: small via the API, large with a ticket, then the server checks it. */
+async function uploadDeliveryFile(params) {
+    const base = params.baseUrl.replace(/\/$/, '');
+    const auth = { Authorization: `Bearer ${params.apiKey}`, 'X-AgentChain-Client': 'cli/0.2.3' };
+    const json = { ...auth, 'Content-Type': 'application/json' };
+    const ids = { target: params.target, targetId: params.targetId };
+    if ((await stat(params.filePath)).size > CHAT_API_UPLOAD_MAX_BYTES) {
+        const ticket = (await readJsonResponse(await fetch(`${base}/api/v1/agent/deliverables/upload-url`, {
+            method: 'POST',
+            headers: json,
+            body: JSON.stringify({ ...ids, filename: basename(params.filePath) }),
+        })));
+        if (ticket.mode === 'direct' && ticket.pathname && ticket.clientToken) {
+            const { put } = await import('@vercel/blob/client');
+            const blob = await put(ticket.pathname, createReadStream(params.filePath), {
+                access: 'public',
+                token: ticket.clientToken,
+                contentType: ticket.contentType,
+                multipart: true,
+            });
+            return readJsonResponse(await fetch(`${base}/api/v1/agent/deliverables/complete`, {
+                method: 'POST',
+                headers: json,
+                body: JSON.stringify({ ...ids, url: blob.url, label: params.label }),
+            }));
+        }
+    }
+    const form = new FormData();
+    form.append('file', new Blob([await readFile(params.filePath)], { type: guessContentType(params.filePath) }), basename(params.filePath));
+    form.append('target', params.target);
+    form.append('targetId', params.targetId);
+    if (params.label)
+        form.append('label', params.label);
+    return readJsonResponse(await fetch(`${base}/api/v1/agent/deliverables/upload`, { method: 'POST', headers: auth, body: form }));
+}
+/** Large chat file: ask for a one-file ticket, then upload directly. Null when this server has no direct storage. */
+async function uploadChatFileDirect(params) {
+    const res = await fetch(`${params.baseUrl.replace(/\/$/, '')}/api/v1/agent/messages/media/upload-url`, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${params.apiKey}`,
+            'Content-Type': 'application/json',
+            'X-AgentChain-Client': 'cli/0.2.3',
+        },
+        body: JSON.stringify({ filename: basename(params.filePath) }),
+    });
+    const ticket = (await readJsonResponse(res));
+    if (ticket.mode !== 'direct' || !ticket.pathname || !ticket.clientToken)
+        return null;
+    const { put } = await import('@vercel/blob/client');
+    const blob = await put(ticket.pathname, createReadStream(params.filePath), {
+        access: 'public',
+        token: ticket.clientToken,
+        contentType: ticket.contentType,
+        multipart: true,
+    });
+    return { url: blob.url, contentType: ticket.contentType, filename: ticket.filename, kind: ticket.kind };
+}
 /** Multipart upload to Agent v1 media endpoints (same as MCP HTTP guidance). */
 export async function uploadAgentMediaFile(params) {
+    if (params.target === 'order' || params.target === 'job-delivery') {
+        return uploadDeliveryFile({
+            baseUrl: params.baseUrl,
+            apiKey: params.apiKey,
+            filePath: params.filePath,
+            target: params.target === 'order' ? 'order' : 'job',
+            targetId: (params.target === 'order' ? params.orderId : params.jobId) ?? '',
+            label: params.label,
+        });
+    }
+    if (params.target === 'chat' && (await stat(params.filePath)).size > CHAT_API_UPLOAD_MAX_BYTES) {
+        const direct = await uploadChatFileDirect(params);
+        if (direct)
+            return direct;
+    }
     const buffer = await readFile(params.filePath);
     const contentType = guessContentType(params.filePath);
     const form = new FormData();
@@ -46,19 +131,11 @@ export async function uploadAgentMediaFile(params) {
     form.append('file', blob, basename(params.filePath));
     if (params.label)
         form.append('label', params.label);
-    const path = params.target === 'order'
-        ? `/api/v1/agent/marketplace-orders/${encodeURIComponent(params.orderId ?? '')}/deliverables/upload`
-        : AGENT_MEDIA_UPLOAD_PATHS[params.target];
+    const path = AGENT_MEDIA_UPLOAD_PATHS[params.target];
     const res = await fetch(`${params.baseUrl.replace(/\/$/, '')}${path}`, {
         method: 'POST',
-        headers: { Authorization: `Bearer ${params.apiKey}`, 'X-AgentChain-Client': 'cli/0.2.2' },
+        headers: { Authorization: `Bearer ${params.apiKey}`, 'X-AgentChain-Client': 'cli/0.2.3' },
         body: form,
     });
-    const data = await res.json().catch(() => ({}));
-    if (!res.ok) {
-        throw new Error(typeof data.error === 'string'
-            ? data.error
-            : `HTTP ${res.status}`);
-    }
-    return data;
+    return readJsonResponse(res);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentchainlabsai/cli",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Command-line interface for the AgentChain Agent API v1 (REST, same contract as MCP).",
   "type": "module",
   "bin": {
@@ -17,7 +17,8 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@agentchainlabsai/sdk": "^0.2.2",
+    "@agentchainlabsai/sdk": "^0.2.3",
+    "@vercel/blob": "^2.3.1",
     "ethers": "^6.13.0"
   },
   "publishConfig": {