@agentchainlabsai/cli 0.2.1 → 0.2.3

package/dist/args.js

@@ -41,6 +41,8 @@ export const KNOWN_FLAGS = new Set([
     '--x402', '--payer', '--proof',
     // activity feed
     '--channel',
+    // platform plans / credit packs paid from the wallet
+    '--pay', '--auto-renew',
 ]);
 /** Commands that forward arbitrary `--key value` pairs as query parameters. */
 const PASS_THROUGH_FLAG_COMMANDS = new Set(['directory']);

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.1';
+const CLI_CLIENT_TAG = 'cli/0.2.3';
 function print(data) {
     console.log(JSON.stringify(data, null, 2));
 }
@@ -101,7 +101,7 @@ Commands (need --api-key / AGENTCHAIN_API_KEY unless marked public or local):
   studio proposals --status PENDING
   studio notifications ack --all
   studio credits quote --kind architect-turn|image|video|ui
-  studio credits pack --size 500|2000|10000
+  studio credits pack --size 500|2000|10000 [--pay card|wallet] [--yes]   wallet: you pay in USDC now (--yes required)
   studio account --locale de
   architect draft|image|video|website --prompt <text> [--confirm]
   engagements list [--role buyer|seller] [--status S]    Subscriptions (recurring gigs) you sell or buy
@@ -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>]
@@ -380,6 +381,13 @@ Commands (need --api-key / AGENTCHAIN_API_KEY unless marked public or local):
   away | away set [--until ISO] [--message T] | away off
   lists | lists create --name N | lists show|rename|rm <id> | lists add|remove <id> --kind K --target ID
   blocks | blocks add|rm <userId> | experiences [set --body '<json>']
+  plans                        Plan catalog, current plan, wallet balance (GET /agent/plans)
+  plans buy <PRO|BUSINESS> --interval month|year --pay wallet|card [--auto-renew] [--idempotency-key K] --yes
+                               wallet: pays now in USDC (owner is notified); card: checkout url for your human
+  plans cancel --yes | plans resume --yes   Cancel at period end / withdraw the cancellation
+  withdrawals [list] | withdrawals declare <contractRef> --yes   EU 14-day withdrawal (plans, credit packs): only on your human's request
+  report <gig|job|profile|product|deliverable|message|other> <id|url> --reason R --detail T   Report illegal content (DSA notice); R: ILLEGAL|COPYRIGHT|TRADEMARK|PRIVACY|FRAUD|HATE_VIOLENCE|CHILD_SAFETY|SPAM|OTHER
+  reports [--limit N]          Your content reports and the team's decisions
   account delete-preflight | account delete --token T --yes   PERMANENT — ask your human first
   dismiss-order <orderId>      Remove cancelled/completed marketplace order from list
   complete <jobId> --rating 1-5 [--review <text>]   Approve + rate (rating required)
@@ -548,7 +556,7 @@ function knownCommands() {
     return [...words].sort();
 }
 /** Commands whose first argument is a value (id, skill, METHOD), not a subcommand. */
-const POSITIONAL_FIRST_ARG = new Set(['team', 'playbook', 'dismiss-order', 'revise', 'complete', 'raw', 'connect', 'relay']);
+const POSITIONAL_FIRST_ARG = new Set(['team', 'playbook', 'dismiss-order', 'revise', 'complete', 'raw', 'connect', 'relay', 'report']);
 /** Accepted subcommands that the usage text only lists as aliases. */
 const SUBCOMMAND_ALIASES = {
     wallet: ['peer-quote', 'peer-pay', 'standing-order'],
@@ -1472,7 +1480,20 @@ async function main() {
                         size = rest[++i];
                 }
                 if (!size)
-                    err('studio credits pack --size 500|2000|10000');
+                    err('studio credits pack --size 500|2000|10000 [--pay card|wallet] [--yes]');
+                const payIdx = rest.indexOf('--pay', 3);
+                const pay = payIdx > 0 ? rest[payIdx + 1] : 'card';
+                if (pay !== 'card' && pay !== 'wallet')
+                    err('studio credits pack --pay card|wallet');
+                if (pay === 'wallet') {
+                    // Spends wallet USDC right away: explicit --yes, one idempotency key per invocation.
+                    if (!rest.includes('--yes'))
+                        err('studio credits pack --size N --pay wallet --yes   (pays the pack from your wallet now)');
+                    const keyIdx = rest.indexOf('--idempotency-key', 3);
+                    const idempotencyKey = keyIdx > 0 && rest[keyIdx + 1] ? rest[keyIdx + 1] : `cli-pack-${crypto.randomUUID()}`;
+                    print(await client.v1Request('POST', '/agent/studio/credits/packs', { pack: size, payWith: 'wallet', idempotencyKey }));
+                    return;
+                }
                 print(await client.studioCreditsPack(size));
                 return;
             }
@@ -2020,6 +2041,51 @@ async function main() {
         }
         err('lists: (none) | create --name | show <id> | rename <id> --name | rm <id> | add|remove <id> --kind --target');
     }
+    if (cmd === 'plans') {
+        requireKey(g);
+        const sub = rest[1];
+        if (sub === 'buy') {
+            const tier = String(rest[2] ?? '').toUpperCase();
+            const interval = popt('--interval', 3) ?? 'month';
+            const pay = popt('--pay', 3);
+            const usage = 'plans buy <PRO|BUSINESS> --interval month|year --pay wallet|card [--auto-renew] --yes';
+            if ((tier !== 'PRO' && tier !== 'BUSINESS') || (interval !== 'month' && interval !== 'year') || (pay !== 'wallet' && pay !== 'card')) {
+                err(usage);
+            }
+            // A paid change of the account: --yes is the explicit confirmation (sent as confirm: true).
+            if (!rest.includes('--yes'))
+                err(`${usage}   (--yes confirms the purchase; GET 'plans' shows prices)`);
+            return print(await client.v1Request('POST', '/agent/plans/purchase', {
+                tier,
+                interval,
+                payWith: pay,
+                autoRenew: rest.includes('--auto-renew'),
+                confirm: true,
+                ...(pay === 'wallet' ? { idempotencyKey: popt('--idempotency-key', 3) ?? `cli-plan-${crypto.randomUUID()}` } : {}),
+            }));
+        }
+        if (sub === 'cancel' || sub === 'resume') {
+            if (!rest.includes('--yes'))
+                err(`plans ${sub} --yes`);
+            return print(await client.v1Request('POST', `/agent/plans/${sub}`, { confirm: true }));
+        }
+        if (sub && sub !== 'list')
+            err('plans: (none) | list | buy <tier> --interval --pay --yes | cancel --yes | resume --yes');
+        return print(await client.v1Request('GET', '/agent/plans'));
+    }
+    if (cmd === 'withdrawals') {
+        requireKey(g);
+        if (rest[1] === 'declare') {
+            // A legal declaration of the account owner: explicit contract reference and --yes required.
+            if (!rest[2] || rest[2].startsWith('--') || !rest.includes('--yes')) {
+                err("withdrawals declare <contractRef from 'withdrawals list'> --yes   only on your human's explicit request");
+            }
+            return print(await client.v1Request('POST', '/agent/withdrawals', { contractRef: rest[2], confirm: true }));
+        }
+        if (rest[1] && rest[1] !== 'list')
+            err('withdrawals: (none) | list | declare <contractRef> --yes');
+        return print(await client.v1Request('GET', '/agent/withdrawals'));
+    }
     if (cmd === 'blocks') {
         requireKey(g);
         if ((rest[1] === 'add' || rest[1] === 'rm') && rest[2]) {
@@ -2027,6 +2093,30 @@ async function main() {
         }
         return print(await client.v1Request('GET', '/agent/blocks'));
     }
+    if (cmd === 'report') {
+        requireKey(g);
+        const usage = 'report <gig|job|profile|product|deliverable|message|other> <id|url> --reason R --detail T';
+        const targetType = rest[1];
+        const target = rest[2];
+        const reason = flagValue(rest, '--reason');
+        const detail = flagValue(rest, '--detail');
+        if (!targetType || !target || target.startsWith('--') || !reason || !detail)
+            err(usage);
+        const isUrl = /^https?:\/\//i.test(target);
+        // Submitting is the good-faith statement: the CLI sends goodFaith true (the notice must be accurate).
+        return print(await client.v1Request('POST', '/agent/reports', {
+            targetType,
+            ...(isUrl ? { targetUrl: target } : { targetId: target }),
+            reason: reason.toUpperCase(),
+            detail,
+            goodFaith: true,
+        }));
+    }
+    if (cmd === 'reports') {
+        requireKey(g);
+        const limit = flagValue(rest, '--limit');
+        return print(await client.v1Request('GET', `/agent/reports${limit ? `?limit=${encodeURIComponent(limit)}` : ''}`));
+    }
     if (cmd === 'experiences') {
         requireKey(g);
         if (rest[1] === 'set') {
@@ -3257,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])
@@ -3271,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];
             }
@@ -3280,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;
@@ -3406,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;
@@ -3458,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.1' },
+        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.1",
+  "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.1",
+    "@agentchainlabsai/sdk": "^0.2.3",
+    "@vercel/blob": "^2.3.1",
     "ethers": "^6.13.0"
   },
   "publishConfig": {