moltlaunch 2.3.0 → 2.5.0

package/dist/index.js

@@ -1032,14 +1032,18 @@ Provide an image with: --image <path>`);
 
 // src/lib/tasks.ts
 var API_BASE = APIS.MOLTLAUNCH;
-async function createTask(agentId, clientAddress, taskDescription) {
+async function createTask(wallet2, agentId, clientAddress, taskDescription) {
+  const { signature, timestamp, nonce } = await signAction(wallet2, "create", agentId);
   const response = await fetch(`${API_BASE}/api/tasks`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({
       agentId,
       clientAddress,
-      task: taskDescription
+      task: taskDescription,
+      signature,
+      timestamp,
+      nonce
     })
   });
   if (!response.ok) {
@@ -1321,7 +1325,7 @@ Task: ${options.task}
 `);
       console.log("Creating task request...");
     }
-    const task = await createTask(agentId, wallet2.address, options.task);
+    const task = await createTask(wallet2, agentId, wallet2.address, options.task);
     if (options.json) {
       console.log(
         JSON.stringify({
@@ -1329,7 +1333,14 @@ Task: ${options.task}
           taskId: task.id,
           agentId,
           status: task.status,
-          task: task.task
+          task: task.task,
+          nextActions: [
+            { command: `mltl tasks`, description: "Check task status and quotes" },
+            { command: `mltl view --task ${task.id}`, description: "View task details" },
+            { command: `mltl message --task ${task.id} --content "..."`, description: "Add details for the agent" }
+          ],
+          flow: "[requested] \u2192 quoted \u2192 accepted \u2192 submitted \u2192 completed",
+          note: "No funds committed. The agent will quote a price. You decide whether to accept."
         })
       );
       return;
@@ -1341,9 +1352,12 @@ Task ID:  ${task.id}`);
     console.log(`Agent:    ${name} (#${agentId})`);
     console.log(`Status:   ${task.status}`);
     console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-    console.log("\nThe agent will review your request and quote a price.");
-    console.log("Check status with:");
-    console.log(`  mltl tasks
+    console.log("\nNo funds committed yet. The agent will review and quote a price.");
+    console.log("You can accept, negotiate, or walk away at no cost.\n");
+    console.log("Next steps:");
+    console.log(`  Check for quotes:  mltl tasks`);
+    console.log(`  View details:      mltl view --task ${task.id}`);
+    console.log(`  Add context:       mltl message --task ${task.id} --content "..."
 `);
   } catch (err) {
     if (options.json) {
@@ -1741,8 +1755,120 @@ async function earnings(options) {
   }
 }
 
-// src/commands/inbox.ts
+// src/commands/fees.ts
 import { formatEther as formatEther3 } from "viem";
+import { createPublicClient as createPublicClient3, createWalletClient as createWalletClient3, http as http3 } from "viem";
+import { base as base3 } from "viem/chains";
+import { privateKeyToAccount as privateKeyToAccount4 } from "viem/accounts";
+var REVENUE_MANAGER_ABI = [
+  {
+    name: "balances",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "_recipient", type: "address" }],
+    outputs: [{ name: "balance_", type: "uint256" }]
+  },
+  {
+    name: "claim",
+    type: "function",
+    stateMutability: "nonpayable",
+    inputs: [],
+    outputs: [{ name: "amount_", type: "uint256" }]
+  }
+];
+async function fees(options) {
+  const { wallet: wallet2 } = await loadOrCreateWallet();
+  const publicClient = createPublicClient3({ chain: base3, transport: http3(BASE_RPC_URL) });
+  if (!options.json) {
+    console.log("\nFlaunch Trading Fees");
+    console.log("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n");
+  }
+  try {
+    const agentId = await getAgentByOwner(wallet2.address);
+    if (!agentId || agentId <= 0n) {
+      throw new Error("No registered agent found for this wallet");
+    }
+    const balance = await publicClient.readContract({
+      address: REVENUE_MANAGER_ADDRESS,
+      abi: REVENUE_MANAGER_ABI,
+      functionName: "balances",
+      args: [wallet2.address]
+    });
+    const balanceEth = formatEther3(balance);
+    if (!options.claim) {
+      if (options.json) {
+        console.log(JSON.stringify({
+          wallet: wallet2.address,
+          agentId: agentId.toString(),
+          revenueManager: REVENUE_MANAGER_ADDRESS,
+          pendingFees: { wei: balance.toString(), eth: balanceEth }
+        }));
+        return;
+      }
+      console.log(`Wallet:           ${wallet2.address}`);
+      console.log(`Agent ID:         ${agentId.toString()}`);
+      console.log(`Revenue Manager:  ${REVENUE_MANAGER_ADDRESS}`);
+      console.log("");
+      console.log(`Pending fees:     ${balanceEth} ETH`);
+      console.log("");
+      if (balance === 0n) {
+        console.log("No fees to claim yet. Fees accumulate from token trading activity.");
+      } else {
+        console.log("Run with --claim to withdraw fees to your wallet.");
+      }
+      return;
+    }
+    if (balance === 0n) {
+      if (options.json) {
+        console.log(JSON.stringify({ error: "No fees to claim" }));
+        process.exit(1);
+      }
+      console.log("No fees to claim yet.");
+      return;
+    }
+    if (!options.json) {
+      console.log(`Claiming ${balanceEth} ETH in trading fees...`);
+    }
+    const account = privateKeyToAccount4(wallet2.privateKey);
+    const walletClient = createWalletClient3({
+      account,
+      chain: base3,
+      transport: http3(BASE_RPC_URL)
+    });
+    const txHash = await walletClient.writeContract({
+      address: REVENUE_MANAGER_ADDRESS,
+      abi: REVENUE_MANAGER_ABI,
+      functionName: "claim",
+      args: []
+    });
+    await publicClient.waitForTransactionReceipt({ hash: txHash });
+    if (options.json) {
+      console.log(JSON.stringify({
+        success: true,
+        claimed: { wei: balance.toString(), eth: balanceEth },
+        txHash
+      }));
+      return;
+    }
+    console.log("\n\u2705 Fees claimed!");
+    console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    console.log(`Amount:  ${balanceEth} ETH`);
+    console.log(`TX:      ${txHash}`);
+    console.log("");
+  } catch (err) {
+    const errorMsg = err instanceof Error ? err.message : String(err);
+    if (options.json) {
+      console.log(JSON.stringify({ error: errorMsg }));
+      process.exit(1);
+    }
+    console.error(`
+\u274C Failed: ${errorMsg}`);
+    process.exit(1);
+  }
+}
+
+// src/commands/inbox.ts
+import { formatEther as formatEther4 } from "viem";
 function formatTimestamp(ts) {
   const date = new Date(ts);
   return date.toLocaleString();
@@ -1783,7 +1909,7 @@ var STATUS_GROUPS = [
   { key: "disputed", label: "DISPUTED", emoji: "\u26A0\uFE0F", hint: "Task is disputed. Await admin resolution." }
 ];
 function renderTask(task) {
-  const priceEth = task.quotedPriceWei ? formatEther3(BigInt(task.quotedPriceWei)) : null;
+  const priceEth = task.quotedPriceWei ? formatEther4(BigInt(task.quotedPriceWei)) : null;
   console.log(`Task ID:  ${task.id}${taskCounts(task)}`);
   console.log(`Client:   ${task.clientAddress}`);
   if (priceEth) console.log(`Price:    ${priceEth} ETH`);
@@ -1805,7 +1931,11 @@ async function inbox(options) {
     const tasks2 = await getInbox(agentId);
     if (tasks2.length === 0) {
       if (options.json) {
-        console.log(JSON.stringify({ tasks: [], total: 0 }));
+        console.log(JSON.stringify({
+          tasks: [],
+          total: 0,
+          polling: { recommended: "5m", note: "No active tasks. Check less frequently." }
+        }));
         return;
       }
       console.log("No pending tasks.\n");
@@ -1813,8 +1943,28 @@ async function inbox(options) {
       console.log("Run this command periodically to check for new work.\n");
       return;
     }
+    const hasRevision = tasks2.some((t) => t.status === "revision");
+    const hasRequested = tasks2.some((t) => t.status === "requested");
+    const hasSubmitted = tasks2.some((t) => t.status === "submitted");
+    let pollingInterval = "5m";
+    let pollingNote = "Normal activity.";
+    if (hasRevision) {
+      pollingInterval = "1m";
+      pollingNote = "Revision requested \u2014 client is waiting for your rework.";
+    } else if (hasRequested) {
+      pollingInterval = "2m";
+      pollingNote = "New requests \u2014 quote promptly to win the work.";
+    } else if (hasSubmitted) {
+      pollingInterval = "5m";
+      pollingNote = "Waiting on client review. Check back periodically.";
+    }
     if (options.json) {
-      console.log(JSON.stringify({ tasks: tasks2, total: tasks2.length }));
+      console.log(JSON.stringify({
+        tasks: tasks2,
+        total: tasks2.length,
+        polling: { recommended: pollingInterval, note: pollingNote },
+        flow: "requested \u2192 quoted \u2192 accepted \u2192 submitted \u2192 completed"
+      }));
       return;
     }
     for (const group of STATUS_GROUPS) {
@@ -1842,19 +1992,19 @@ Failed to fetch inbox: ${errorMsg}`);
 }
 
 // src/commands/accept.ts
-import { formatEther as formatEther4, parseEther as parseEther2 } from "viem";
+import { formatEther as formatEther5, parseEther as parseEther2 } from "viem";
 
 // src/lib/escrow.ts
 import {
-  createPublicClient as createPublicClient3,
-  createWalletClient as createWalletClient3,
-  http as http3,
+  createPublicClient as createPublicClient4,
+  createWalletClient as createWalletClient4,
+  http as http4,
   keccak256 as keccak2562,
   toBytes as toBytes2,
   parseAbi
 } from "viem";
-import { privateKeyToAccount as privateKeyToAccount4 } from "viem/accounts";
-import { base as base3 } from "viem/chains";
+import { privateKeyToAccount as privateKeyToAccount5 } from "viem/accounts";
+import { base as base4 } from "viem/chains";
 var ESCROW_ADDRESS = process.env.ESCROW_ADDRESS || "0x5Df1ffa02c8515a0Fed7d0e5d6375FcD2c1950Ee";
 var ESCROW_ABI = parseAbi([
   // Write functions
@@ -1896,17 +2046,17 @@ function taskIdToBytes32(taskId) {
   return keccak2562(toBytes2(taskId));
 }
 function getPublicClient2() {
-  return createPublicClient3({
-    chain: base3,
-    transport: http3(BASE_RPC_URL)
+  return createPublicClient4({
+    chain: base4,
+    transport: http4(BASE_RPC_URL)
   });
 }
 function getWalletClient2(wallet2) {
-  const account = privateKeyToAccount4(wallet2.privateKey);
-  return createWalletClient3({
+  const account = privateKeyToAccount5(wallet2.privateKey);
+  return createWalletClient4({
     account,
-    chain: base3,
-    transport: http3(BASE_RPC_URL)
+    chain: base4,
+    transport: http4(BASE_RPC_URL)
   });
 }
 async function depositEscrow(wallet2, taskId, agentAddress, tokenAddress, amountWei) {
@@ -2115,7 +2265,7 @@ async function accept(options) {
     if (taskBefore.clientAddress.toLowerCase() !== wallet2.address.toLowerCase()) {
       throw new Error("Only the client who created this task can accept the quote");
     }
-    const priceEth = taskBefore.quotedPriceWei ? formatEther4(BigInt(taskBefore.quotedPriceWei)) : "0";
+    const priceEth = taskBefore.quotedPriceWei ? formatEther5(BigInt(taskBefore.quotedPriceWei)) : "0";
     const agent = await fetchAgent2(taskBefore.agentId);
     if (!agent) {
       throw new Error(`Agent #${taskBefore.agentId} not found`);
@@ -2140,6 +2290,7 @@ Task ID:  ${taskBefore.id}`);
       console.log(`Agent:    #${taskBefore.agentId} (${agent.name || "Unknown"})`);
       console.log(`Owner:    ${agentOwner}`);
       console.log(`Quote:    ${priceEth} ETH`);
+      console.log(`Balance:  ${balance} ETH`);
       if (taskBefore.quotedMessage) {
         console.log(`Message:  ${taskBefore.quotedMessage}`);
       }
@@ -2147,6 +2298,12 @@ Task ID:  ${taskBefore.id}`);
 Task:
 ${taskBefore.task}
 `);
+      console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+      console.log(`
+This will deposit ${priceEth} ETH into escrow.`);
+      console.log("Funds are locked until you approve the work or request a refund.");
+      console.log("  - Approve submitted work: funds buy back & burn agent's token");
+      console.log("  - Cancel before submission: 10% fee to agent, 90% refunded");
       console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
       console.log("\nDepositing funds into escrow...");
     }
@@ -2170,7 +2327,14 @@ ${taskBefore.task}
             txHash: escrowTxHash,
             amount: priceEth,
             tokenAddress: agentToken
-          }
+          },
+          nextActions: [
+            { command: `mltl tasks`, description: "Check task status" },
+            { command: `mltl message --task ${task.id} --content "..."`, description: "Message the agent" },
+            { command: `mltl cancel --task ${task.id}`, description: "Cancel (10% fee to agent)" }
+          ],
+          flow: "requested \u2192 quoted \u2192 [accepted] \u2192 submitted \u2192 completed",
+          note: "Funds are locked in escrow. Agent can now begin work."
         })
       );
       return;
@@ -2180,9 +2344,12 @@ ${taskBefore.task}
 Escrow:   ${priceEth} ETH deposited`);
     console.log(`Token:    ${agentToken}`);
     console.log(`TX:       ${escrowTxHash}`);
-    console.log("\nWhen you approve, funds will buyback & burn the agent's token.");
-    console.log("Check status with:");
-    console.log(`  mltl tasks
+    console.log("\nThe agent can now begin work. When they submit:");
+    console.log("  - Review & approve:  mltl approve --task " + task.id);
+    console.log("  - Request changes:   mltl revise --task " + task.id + ' --reason "..."');
+    console.log("  - Cancel (10% fee):  mltl cancel --task " + task.id);
+    console.log(`
+Flow: requested \u2192 quoted \u2192 [accepted] \u2192 submitted \u2192 completed
 `);
   } catch (err) {
     const errorMsg = err instanceof Error ? err.message : String(err);
@@ -2215,14 +2382,19 @@ async function decline(options) {
           task: {
             id: task.id,
             status: task.status
-          }
+          },
+          nextActions: [
+            { command: `mltl inbox`, description: "Check for other tasks" }
+          ],
+          note: "Declined tasks are tracked in your stats. This is normal \u2014 only accept work you can deliver."
         })
       );
       return;
     }
     console.log(`
 \u2705 Task ${task.id} declined.`);
-    console.log("\nThe client will be notified.\n");
+    console.log("\nThe client will be notified.");
+    console.log("Tip: Declining tasks you can't deliver is better than accepting and underdelivering.\n");
   } catch (err) {
     const errorMsg = err instanceof Error ? err.message : String(err);
     if (options.json) {
@@ -2236,7 +2408,7 @@ async function decline(options) {
 }
 
 // src/commands/submit.ts
-import { formatEther as formatEther5 } from "viem";
+import { formatEther as formatEther6 } from "viem";
 
 // src/lib/files.ts
 import { readFileSync, statSync } from "fs";
@@ -2328,6 +2500,13 @@ Uploading ${filePaths.length} file(s)...`);
       }
     }
     if (options.json) {
+      const nextActions = [
+        { command: `mltl view --task ${task.id}`, description: "View full task thread" },
+        { command: `mltl message --task ${task.id} --content "..."`, description: "Message the client" }
+      ];
+      if (escrowTxHash) {
+        nextActions.push({ command: `mltl claim --task ${task.id}`, description: "Claim payment after 24h timeout" });
+      }
       console.log(
         JSON.stringify({
           success: true,
@@ -2338,12 +2517,15 @@ Uploading ${filePaths.length} file(s)...`);
             quotedPriceWei: task.quotedPriceWei,
             result: task.result
           },
-          escrow: escrowTxHash ? { txHash: escrowTxHash, timeoutHours: 24 } : null
+          escrow: escrowTxHash ? { txHash: escrowTxHash, timeoutHours: 24 } : null,
+          nextActions,
+          flow: isRevision ? "requested \u2192 quoted \u2192 accepted \u2192 revision \u2192 [submitted] \u2192 completed" : "requested \u2192 quoted \u2192 accepted \u2192 [submitted] \u2192 completed",
+          note: escrowTxHash ? "24h countdown started. Client must approve, revise, or dispute within 24h \u2014 otherwise you can claim payment." : "Awaiting client review."
         })
       );
       return;
     }
-    const priceEth = task.quotedPriceWei ? formatEther5(BigInt(task.quotedPriceWei)) : "0";
+    const priceEth = task.quotedPriceWei ? formatEther6(BigInt(task.quotedPriceWei)) : "0";
     console.log(isRevision ? "\n\u2705 Revised work submitted!" : "\n\u2705 Work submitted!");
     console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
     console.log(`
@@ -2355,21 +2537,23 @@ Task ID:   ${task.id}`);
     console.log(`Price:     ${priceEth} ETH`);
     if (escrowTxHash) {
       console.log(`
-Timeout:   24 hours (auto-release if client doesn't respond)`);
+Timeout:   24 hours from now`);
+      console.log(`           Client must respond or you can auto-claim payment.`);
     }
     console.log(`
 Your result:
 ${options.result}
 `);
     console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-    console.log("\nThe client will review your work.");
+    console.log("\nWhat happens next:");
+    console.log("  - Client approves  \u2192 payment released (buyback & burn)");
+    console.log("  - Client revises   \u2192 you'll see it in your inbox");
     if (escrowTxHash) {
-      console.log("If they don't respond within 24h, you can claim payment with:");
-      console.log(`  mltl claim --task ${task.id}
-`);
-    } else {
-      console.log("Once approved, payment will be sent to your wallet.\n");
+      console.log("  - No response 24h  \u2192 claim with: mltl claim --task " + task.id);
     }
+    console.log(`
+Check status:  mltl view --task ${task.id}
+`);
   } catch (err) {
     const errorMsg = err instanceof Error ? err.message : String(err);
     if (options.json) {
@@ -2383,7 +2567,7 @@ ${options.result}
 }
 
 // src/commands/approve.ts
-import { formatEther as formatEther6 } from "viem";
+import { formatEther as formatEther7 } from "viem";
 async function fetchAgent3(agentId) {
   const res = await fetch(`${APIS.MOLTLAUNCH}/api/agents/${agentId}`);
   if (!res.ok) return null;
@@ -2408,7 +2592,7 @@ async function approve(options) {
       throw new Error("Task has no quoted price");
     }
     const priceWei = BigInt(task.quotedPriceWei);
-    const priceEth = formatEther6(priceWei);
+    const priceEth = formatEther7(priceWei);
     const agent = await fetchAgent3(task.agentId);
     if (!agent) {
       throw new Error(`Agent #${task.agentId} not found`);
@@ -2429,11 +2613,14 @@ async function approve(options) {
 Task ID:      ${task.id}`);
       console.log(`Agent:        ${agent.name || `#${task.agentId}`}`);
       console.log(`Agent Owner:  ${agentOwner}`);
-      console.log(`Escrow:       ${formatEther6(escrow.amount)} ETH (locked)`);
+      console.log(`Escrow:       ${formatEther7(escrow.amount)} ETH (locked)`);
       console.log(`
 Submitted result:
 ${task.result}
 `);
+      console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+      console.log("\nThis will release payment. This action is final and irreversible.");
+      console.log("If unsatisfied, use 'mltl revise' or 'mltl dispute' instead.");
       console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
       console.log("\nReleasing payment from escrow...");
     }
@@ -2455,7 +2642,11 @@ ${task.result}
             amount: priceEth,
             txHash,
             type: "escrow_release"
-          }
+          },
+          nextActions: [
+            { command: `mltl feedback --task ${completedTask.id} --score <0-100>`, description: "Leave a verified review (on-chain)" }
+          ],
+          flow: "requested \u2192 quoted \u2192 accepted \u2192 submitted \u2192 [completed]"
         })
       );
       return;
@@ -2465,8 +2656,9 @@ ${task.result}
     console.log(`
 Payment:  ${priceEth} ETH \u2192 ${agentOwner}`);
     console.log(`TX:       ${txHash}`);
-    console.log("\nDon't forget to leave feedback:");
-    console.log(`  mltl feedback --agent ${task.agentId} --score 90
+    console.log("\nLeave a verified review (score 0-100):");
+    console.log(`  mltl feedback --task ${completedTask.id} --score 90`);
+    console.log(`  mltl feedback --task ${completedTask.id} --score 85 --comment "Great work"
 `);
   } catch (err) {
     const errorMsg = err instanceof Error ? err.message : String(err);
@@ -2481,7 +2673,7 @@ Payment:  ${priceEth} ETH \u2192 ${agentOwner}`);
 }
 
 // src/commands/tasks.ts
-import { formatEther as formatEther7 } from "viem";
+import { formatEther as formatEther8 } from "viem";
 function formatTimestamp2(ts) {
   const date = new Date(ts);
   return date.toLocaleString();
@@ -2497,7 +2689,14 @@ async function tasks(options) {
     const allTasks = await getClientTasks(wallet2.address);
     if (allTasks.length === 0) {
       if (options.json) {
-        console.log(JSON.stringify({ tasks: [], total: 0 }));
+        console.log(JSON.stringify({
+          tasks: [],
+          total: 0,
+          nextActions: [
+            { command: `mltl agents`, description: "Browse available agents" },
+            { command: `mltl hire --agent <id> --task "..."`, description: "Request work from an agent" }
+          ]
+        }));
         return;
       }
       console.log("No tasks yet.\n");
@@ -2505,8 +2704,24 @@ async function tasks(options) {
       console.log('  mltl hire --agent <id> --task "Your task description"\n');
       return;
     }
+    const hasSubmittedReview = allTasks.some((t) => t.status === "submitted");
+    const hasQuoted = allTasks.some((t) => t.status === "quoted");
+    let pollingInterval = "5m";
+    let pollingNote = "Normal activity.";
+    if (hasSubmittedReview) {
+      pollingInterval = "1m";
+      pollingNote = "Work submitted \u2014 review and approve/revise promptly so agent can get paid.";
+    } else if (hasQuoted) {
+      pollingInterval = "2m";
+      pollingNote = "Quote received \u2014 accept to lock escrow and start work.";
+    }
     if (options.json) {
-      console.log(JSON.stringify({ tasks: allTasks, total: allTasks.length }));
+      console.log(JSON.stringify({
+        tasks: allTasks,
+        total: allTasks.length,
+        polling: { recommended: pollingInterval, note: pollingNote },
+        flow: "requested \u2192 quoted \u2192 accepted \u2192 submitted \u2192 completed"
+      }));
       return;
     }
     const needsReview = allTasks.filter((t) => t.status === "submitted");
@@ -2522,7 +2737,7 @@ async function tasks(options) {
       console.log(`\u{1F4E5} NEEDS REVIEW (${needsReview.length})`);
       console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
       for (const task of needsReview) {
-        const priceEth = task.quotedPriceWei ? formatEther7(BigInt(task.quotedPriceWei)) : "0";
+        const priceEth = task.quotedPriceWei ? formatEther8(BigInt(task.quotedPriceWei)) : "0";
         console.log(`Task ID:   ${task.id}`);
         console.log(`Agent:     #${task.agentId}`);
         console.log(`Price:     ${priceEth} ETH`);
@@ -2544,7 +2759,7 @@ ${task.result}
 \u{1F4AC} QUOTES RECEIVED (${quoted.length})`);
       console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
       for (const task of quoted) {
-        const priceEth = task.quotedPriceWei ? formatEther7(BigInt(task.quotedPriceWei)) : "0";
+        const priceEth = task.quotedPriceWei ? formatEther8(BigInt(task.quotedPriceWei)) : "0";
         console.log(`Task ID:  ${task.id}`);
         console.log(`Agent:    #${task.agentId}`);
         console.log(`Quote:    ${priceEth} ETH`);
@@ -2575,7 +2790,7 @@ ${task.result}
 \u{1F528} IN PROGRESS (${inProgress.length})`);
       console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
       for (const task of inProgress) {
-        const priceEth = task.quotedPriceWei ? formatEther7(BigInt(task.quotedPriceWei)) : "0";
+        const priceEth = task.quotedPriceWei ? formatEther8(BigInt(task.quotedPriceWei)) : "0";
         console.log(`Task ID:  ${task.id}`);
         console.log(`Agent:    #${task.agentId}`);
         console.log(`Price:    ${priceEth} ETH`);
@@ -2589,7 +2804,7 @@ ${task.result}
 \u2705 COMPLETED (${completed.length})`);
       console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
       for (const task of completed.slice(0, 5)) {
-        const priceEth = task.quotedPriceWei ? formatEther7(BigInt(task.quotedPriceWei)) : "0";
+        const priceEth = task.quotedPriceWei ? formatEther8(BigInt(task.quotedPriceWei)) : "0";
         console.log(`Task ID:   ${task.id}`);
         console.log(`Agent:     #${task.agentId}`);
         console.log(`Paid:      ${priceEth} ETH`);
@@ -2607,7 +2822,7 @@ ${task.result}
 \u{1F504} REVISION REQUESTED (${revision.length})`);
       console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
       for (const task of revision) {
-        const priceEth = task.quotedPriceWei ? formatEther7(BigInt(task.quotedPriceWei)) : "0";
+        const priceEth = task.quotedPriceWei ? formatEther8(BigInt(task.quotedPriceWei)) : "0";
         console.log(`Task ID:    ${task.id}`);
         console.log(`Agent:      #${task.agentId}`);
         console.log(`Price:      ${priceEth} ETH`);
@@ -2621,7 +2836,7 @@ ${task.result}
 \u26A0\uFE0F DISPUTED (${disputed.length})`);
       console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
       for (const task of disputed) {
-        const priceEth = task.quotedPriceWei ? formatEther7(BigInt(task.quotedPriceWei)) : "0";
+        const priceEth = task.quotedPriceWei ? formatEther8(BigInt(task.quotedPriceWei)) : "0";
         console.log(`Task ID:    ${task.id}`);
         console.log(`Agent:      #${task.agentId}`);
         console.log(`Price:      ${priceEth} ETH`);
@@ -2636,7 +2851,7 @@ ${task.result}
 \u2705 RESOLVED (${resolved.length})`);
       console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
       for (const task of resolved) {
-        const priceEth = task.quotedPriceWei ? formatEther7(BigInt(task.quotedPriceWei)) : "0";
+        const priceEth = task.quotedPriceWei ? formatEther8(BigInt(task.quotedPriceWei)) : "0";
         const winner = task.disputeResolution === "client" ? "Client (refunded)" : "Agent (buyback)";
         console.log(`Task ID:    ${task.id}`);
         console.log(`Agent:      #${task.agentId}`);
@@ -2667,7 +2882,7 @@ ${task.result}
 }
 
 // src/commands/quote.ts
-import { parseEther as parseEther3, formatEther as formatEther8 } from "viem";
+import { parseEther as parseEther3, formatEther as formatEther9 } from "viem";
 async function quote(options) {
   const { wallet: wallet2 } = await loadOrCreateWallet();
   if (!options.json) {
@@ -2680,7 +2895,7 @@ async function quote(options) {
       throw new Error(`Task is ${taskBefore.status}, cannot quote`);
     }
     const priceWei = parseEther3(options.price);
-    const priceEth = formatEther8(priceWei);
+    const priceEth = formatEther9(priceWei);
     if (!options.json) {
       console.log(`
 Task ID:  ${taskBefore.id}`);
@@ -2694,6 +2909,11 @@ ${taskBefore.task}
         console.log(`Message: ${options.message}`);
       }
       console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+      if (taskBefore.status === "quoted") {
+        console.log("\nNote: Updating your previous quote. Client has not yet accepted.");
+      }
+      console.log("\nBy quoting, you commit to delivering this work at this price.");
+      console.log("The client can accept at any time, locking funds in escrow.");
     }
     const task = await quoteTask(wallet2, options.task, priceWei.toString(), options.message);
     if (options.json) {
@@ -2706,17 +2926,24 @@ ${taskBefore.task}
             status: task.status,
             quotedPriceWei: task.quotedPriceWei,
             quotedMessage: task.quotedMessage
-          }
+          },
+          nextActions: [
+            { command: `mltl inbox`, description: "Check inbox for status updates" },
+            { command: `mltl message --task ${task.id} --content "..."`, description: "Message the client" }
+          ],
+          flow: "requested \u2192 [quoted] \u2192 accepted \u2192 submitted \u2192 completed"
         })
       );
       return;
     }
     console.log("\n\u2705 Quote submitted!");
     console.log("\nThe client will review your quote.");
-    console.log("If they accept, the task will move to 'accepted' status");
-    console.log("and you can begin work.\n");
-    console.log("Check status with:");
-    console.log(`  mltl inbox --agent ${task.agentId}
+    console.log("If they accept, funds lock in escrow and you can begin work.\n");
+    console.log("Next steps:");
+    console.log(`  Check inbox:     mltl inbox`);
+    console.log(`  Send a message:  mltl message --task ${task.id} --content "..."`);
+    console.log(`
+Flow: requested \u2192 [quoted] \u2192 accepted \u2192 submitted \u2192 completed
 `);
   } catch (err) {
     const errorMsg = err instanceof Error ? err.message : String(err);
@@ -2731,7 +2958,7 @@ ${taskBefore.task}
 }
 
 // src/commands/claim.ts
-import { formatEther as formatEther9 } from "viem";
+import { formatEther as formatEther10 } from "viem";
 async function claim(options) {
   const { wallet: wallet2 } = await loadOrCreateWallet();
   if (!options.json) {
@@ -2753,7 +2980,7 @@ async function claim(options) {
     if (escrow.status === 3 /* Disputed */) {
       throw new Error("Task is disputed. Cannot claim until dispute is resolved.");
     }
-    const priceEth = formatEther9(escrow.amount);
+    const priceEth = formatEther10(escrow.amount);
     const timedOut = await isEscrowTimedOut(options.task);
     if (!timedOut) {
       const secondsLeft = await getTimeUntilTimeout(options.task);
@@ -2830,7 +3057,7 @@ The client did not respond within 24 hours.`);
 }
 
 // src/commands/refund.ts
-import { formatEther as formatEther10 } from "viem";
+import { formatEther as formatEther11 } from "viem";
 async function refund(options) {
   const { wallet: wallet2 } = await loadOrCreateWallet();
   if (!options.json) {
@@ -2858,7 +3085,7 @@ async function refund(options) {
     if (!options.json) {
       console.log(`
 Task ID:  ${task.id}`);
-      console.log(`Escrowed: ${formatEther10(escrow.amount)} ETH`);
+      console.log(`Escrowed: ${formatEther11(escrow.amount)} ETH`);
       console.log("\nRefunding to your wallet...");
     }
     const txHash = await refundEscrow(wallet2, task.id);
@@ -2871,16 +3098,21 @@ Task ID:  ${task.id}`);
         JSON.stringify({
           success: true,
           taskId: task.id,
-          refundedAmount: formatEther10(escrow.amount),
-          txHash
+          refundedAmount: formatEther11(escrow.amount),
+          txHash,
+          nextActions: [
+            { command: `mltl hire --agent ${task.agentId} --task "..."`, description: "Hire the same agent again" },
+            { command: `mltl agents`, description: "Browse other agents" }
+          ],
+          note: "Full refund \u2014 no fees deducted. Task is closed."
         })
       );
       return;
     }
-    console.log("\n\u2705 Refund successful!");
+    console.log("\n\u2705 Refund successful! No fees deducted.");
     console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
     console.log(`
-Refunded: ${formatEther10(escrow.amount)} ETH \u2192 ${wallet2.address}`);
+Refunded: ${formatEther11(escrow.amount)} ETH \u2192 ${wallet2.address}`);
     console.log(`TX:       ${txHash}
 `);
   } catch (err) {
@@ -2896,7 +3128,7 @@ Refunded: ${formatEther10(escrow.amount)} ETH \u2192 ${wallet2.address}`);
 }
 
 // src/commands/cancel.ts
-import { formatEther as formatEther11 } from "viem";
+import { formatEther as formatEther12 } from "viem";
 async function cancel(options) {
   const { wallet: wallet2 } = await loadOrCreateWallet();
   if (!options.json) {
@@ -2922,10 +3154,12 @@ async function cancel(options) {
     if (!options.json) {
       console.log(`
 Task ID:      ${task.id}`);
-      console.log(`Escrowed:     ${formatEther11(escrow.amount)} ETH`);
-      console.log(`Cancel fee:   ${formatEther11(fee)} ETH (10% to agent)`);
-      console.log(`You receive:  ${formatEther11(escrow.amount - fee)} ETH`);
-      console.log("\nCancelling...");
+      console.log(`Escrowed:     ${formatEther12(escrow.amount)} ETH`);
+      console.log(`Cancel fee:   ${formatEther12(fee)} ETH (10% to agent for lost opportunity)`);
+      console.log(`You receive:  ${formatEther12(escrow.amount - fee)} ETH`);
+      console.log("\nNote: If the agent hasn't started yet, consider 'mltl refund' instead (no fee).");
+      console.log("Cancel is for tasks already accepted by the agent.\n");
+      console.log("Cancelling...");
     }
     const txHash = await cancelEscrow(wallet2, task.id);
     try {
@@ -2937,9 +3171,13 @@ Task ID:      ${task.id}`);
         JSON.stringify({
           success: true,
           taskId: task.id,
-          cancelFee: formatEther11(fee),
-          refundedAmount: formatEther11(escrow.amount - fee),
-          txHash
+          cancelFee: formatEther12(fee),
+          refundedAmount: formatEther12(escrow.amount - fee),
+          txHash,
+          nextActions: [
+            { command: `mltl hire --agent ${task.agentId} --task "..."`, description: "Hire the same agent again" },
+            { command: `mltl agents`, description: "Browse other agents" }
+          ]
         })
       );
       return;
@@ -2947,8 +3185,8 @@ Task ID:      ${task.id}`);
     console.log("\nTask cancelled.");
     console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
     console.log(`
-Cancel fee: ${formatEther11(fee)} ETH \u2192 agent`);
-    console.log(`Refunded:  ${formatEther11(escrow.amount - fee)} ETH \u2192 ${wallet2.address}`);
+Cancel fee: ${formatEther12(fee)} ETH \u2192 agent`);
+    console.log(`Refunded:  ${formatEther12(escrow.amount - fee)} ETH \u2192 ${wallet2.address}`);
     console.log(`TX:        ${txHash}
 `);
   } catch (err) {
@@ -2964,7 +3202,7 @@ Cancel fee: ${formatEther11(fee)} ETH \u2192 agent`);
 }
 
 // src/commands/dispute.ts
-import { formatEther as formatEther12 } from "viem";
+import { formatEther as formatEther13 } from "viem";
 async function dispute(options) {
   const { wallet: wallet2 } = await loadOrCreateWallet();
   if (!options.json) {
@@ -2987,12 +3225,17 @@ async function dispute(options) {
       throw new Error("Escrow is not in submitted state");
     }
     const feeWei = await getDisputeFee(task.id);
-    const feeEth = formatEther12(feeWei);
+    const feeEth = formatEther13(feeWei);
     if (!options.json) {
       console.log(`
 Task ID:       ${task.id}`);
-      console.log(`Escrow:        ${formatEther12(escrow.amount)} ETH`);
-      console.log(`Dispute fee:   ${feeEth} ETH (10% of escrow)`);
+      console.log(`Escrow:        ${formatEther13(escrow.amount)} ETH`);
+      console.log(`Dispute fee:   ${feeEth} ETH (10% of escrow, non-refundable if you lose)`);
+      console.log("\n\u26A0  Disputes are a last resort. Consider these alternatives first:");
+      console.log(`   Request revision:  mltl revise --task ${task.id} --reason "..."`);
+      console.log(`   Message the agent: mltl message --task ${task.id} --content "..."`);
+      console.log("\n   If you win: escrow refunded + dispute fee returned.");
+      console.log("   If you lose: agent gets paid, you lose the dispute fee.");
       console.log("\nOpening dispute...");
     }
     const txHash = await disputeEscrow(wallet2, task.id, feeWei);
@@ -3008,18 +3251,25 @@ Task ID:       ${task.id}`);
           success: true,
           taskId: task.id,
           disputeFee: feeEth,
-          txHash
+          txHash,
+          note: "Timeout frozen. Admin will review. If you win: escrow + fee returned. If you lose: agent gets paid, fee lost.",
+          nextActions: [
+            { command: `mltl message --task ${task.id} --content "..."`, description: "Add context for the admin" },
+            { command: `mltl view --task ${task.id}`, description: "View task details" }
+          ]
         })
       );
       return;
     }
-    console.log("\nDispute opened! Timeout is now frozen.");
+    console.log("\nDispute opened! 24h timeout is now frozen.");
     console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
     console.log(`
 Fee paid: ${feeEth} ETH`);
     console.log(`TX:       ${txHash}`);
     console.log("\nAn admin will review and resolve the dispute.");
-    console.log("If you win, you get your escrow + fee back.\n");
+    console.log("Add context via messages to help resolution:");
+    console.log(`  mltl message --task ${task.id} --content "..."
+`);
   } catch (err) {
     const errorMsg = err instanceof Error ? err.message : String(err);
     if (options.json) {
@@ -3033,7 +3283,7 @@ Fee paid: ${feeEth} ETH`);
 }
 
 // src/commands/resolve.ts
-import { formatEther as formatEther13 } from "viem";
+import { formatEther as formatEther14 } from "viem";
 async function resolve(options) {
   const { wallet: wallet2 } = await loadOrCreateWallet();
   if (!["client", "agent"].includes(options.winner)) {
@@ -3060,8 +3310,8 @@ async function resolve(options) {
     if (!options.json) {
       console.log(`
 Task ID:       ${task.id}`);
-      console.log(`Escrow:        ${formatEther13(escrow.amount)} ETH`);
-      console.log(`Dispute fee:   ${formatEther13(escrow.disputeFee)} ETH`);
+      console.log(`Escrow:        ${formatEther14(escrow.amount)} ETH`);
+      console.log(`Dispute fee:   ${formatEther14(escrow.disputeFee)} ETH`);
       console.log(`Resolution:    ${clientWins ? "CLIENT WINS (refund)" : "AGENT WINS (buyback)"}`);
       console.log("\nCalling resolveDispute on-chain...");
     }
@@ -3134,7 +3384,13 @@ async function revise(options) {
             agentId: task.agentId,
             status: task.status,
             revisionCount: task.revisionCount
-          }
+          },
+          nextActions: [
+            { command: `mltl message --task ${task.id} --content "..."`, description: "Add more context for the agent" },
+            { command: `mltl view --task ${task.id}`, description: "View task thread" }
+          ],
+          flow: "requested \u2192 quoted \u2192 accepted \u2192 submitted \u2192 [revision] \u2192 submitted \u2192 completed",
+          note: "Agent will rework and resubmit. No additional cost \u2014 same escrow applies."
         })
       );
       return;
@@ -3150,8 +3406,8 @@ Your feedback:
 ${options.reason}
 `);
     console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-    console.log("\nThe agent will revise and resubmit their work.");
-    console.log("You can also send messages with:");
+    console.log("\nThe agent will revise and resubmit. No additional cost.");
+    console.log("Add more context:");
     console.log(`  mltl message --task ${task.id} --content "additional details"
 `);
   } catch (err) {
@@ -3248,34 +3504,93 @@ Failed to send message: ${errorMsg}`);
 }
 
 // src/commands/view.ts
-import { formatEther as formatEther14 } from "viem";
+import { formatEther as formatEther15 } from "viem";
 function formatTimestamp4(ts) {
   return new Date(ts).toLocaleString();
 }
-function suggestedAction(task) {
+function suggestedActions(task, role) {
+  const id = task.id;
   switch (task.status) {
     case "requested":
-      return `Quote:    mltl quote --task ${task.id} --price <eth>
-Decline:  mltl decline --task ${task.id}`;
+      if (role === "agent") return `Quote:    mltl quote --task ${id} --price <eth>
+Decline:  mltl decline --task ${id}`;
+      if (role === "client") return `Waiting for agent to quote. You can add context:
+  mltl message --task ${id} --content "..."`;
+      return `Agent:  mltl quote --task ${id} --price <eth>
+Agent:  mltl decline --task ${id}`;
     case "quoted":
-      return `Message:  mltl message --task ${task.id} --content "..."`;
+      if (role === "client") return `Accept:   mltl accept --task ${id}  (deposits ETH into escrow)
+Message:  mltl message --task ${id} --content "..."`;
+      if (role === "agent") return `Waiting for client to accept your quote.
+Message:  mltl message --task ${id} --content "..."`;
+      return `Client: mltl accept --task ${id}
+Either:  mltl message --task ${id} --content "..."`;
     case "accepted":
+      if (role === "agent") return `Submit work when ready:
+  mltl submit --task ${id} --result "..." --files file1.txt,file2.pdf`;
+      if (role === "client") return `Agent is working. You can:
+  Message:  mltl message --task ${id} --content "..."
+  Cancel:   mltl cancel --task ${id}  (10% fee to agent)`;
+      return `Agent:  mltl submit --task ${id} --result "..."`;
     case "revision":
-      return `Submit:   mltl submit --task ${task.id} --result "..."`;
+      if (role === "agent") return `Revision requested. Fix and resubmit:
+  mltl submit --task ${id} --result "..." --files file1.txt`;
+      if (role === "client") return `Waiting for agent to resubmit.
+Message:  mltl message --task ${id} --content "..."`;
+      return `Agent:  mltl submit --task ${id} --result "..."`;
     case "submitted":
-      return `Message:  mltl message --task ${task.id} --content "..."`;
+      if (role === "client") return `Review the result above, then:
+  Approve:  mltl approve --task ${id}  (releases payment, final)
+  Revise:   mltl revise --task ${id} --reason "..."
+  Dispute:  mltl dispute --task ${id}  (10% fee, last resort)`;
+      if (role === "agent") return `Waiting for client review. 24h timeout protects you.
+  Claim:    mltl claim --task ${id}  (after 24h with no response)`;
+      return `Client: mltl approve --task ${id}
+Client: mltl revise --task ${id} --reason "..."`;
+    case "completed":
+      if (role === "client") return `Leave a review:
+  mltl feedback --task ${id} --score <0-100> --comment "..."`;
+      return null;
+    case "disputed":
+      return `Awaiting admin resolution.
+Add context: mltl message --task ${id} --content "..."`;
     default:
       return null;
   }
 }
+var STATUS_FLOW = {
+  requested: "[requested] \u2192 quoted \u2192 accepted \u2192 submitted \u2192 completed",
+  quoted: "requested \u2192 [quoted] \u2192 accepted \u2192 submitted \u2192 completed",
+  accepted: "requested \u2192 quoted \u2192 [accepted] \u2192 submitted \u2192 completed",
+  revision: "requested \u2192 quoted \u2192 accepted \u2192 [revision] \u2192 submitted \u2192 completed",
+  submitted: "requested \u2192 quoted \u2192 accepted \u2192 [submitted] \u2192 completed",
+  completed: "requested \u2192 quoted \u2192 accepted \u2192 submitted \u2192 [completed]",
+  declined: "requested \u2192 [declined]",
+  disputed: "requested \u2192 quoted \u2192 accepted \u2192 submitted \u2192 [disputed] \u2192 resolved",
+  resolved: "requested \u2192 quoted \u2192 accepted \u2192 submitted \u2192 disputed \u2192 [resolved]"
+};
 async function view(options) {
   try {
     const task = await getTask(options.task);
+    let role = "unknown";
+    try {
+      const wallet2 = await loadWallet();
+      if (wallet2) {
+        const addr = wallet2.address.toLowerCase();
+        if (task.clientAddress.toLowerCase() === addr) {
+          role = "client";
+        } else {
+          role = "agent";
+        }
+      }
+    } catch {
+    }
     if (options.json) {
-      console.log(JSON.stringify({ task }));
+      const flow2 = STATUS_FLOW[task.status] || null;
+      console.log(JSON.stringify({ task, role, flow: flow2 }));
       return;
     }
-    const priceEth = task.quotedPriceWei ? formatEther14(BigInt(task.quotedPriceWei)) : null;
+    const priceEth = task.quotedPriceWei ? formatEther15(BigInt(task.quotedPriceWei)) : null;
     console.log("\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
     console.log(`  Task ${task.id}`);
     console.log("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n");
@@ -3324,10 +3639,18 @@ async function view(options) {
 `);
       }
     }
-    const action = suggestedAction(task);
-    if (action) {
+    const flow = STATUS_FLOW[task.status];
+    if (flow) {
       console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-      console.log("  Next Action");
+      console.log("  Flow");
+      console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
+      console.log(flow);
+    }
+    const action = suggestedActions(task, role);
+    if (action) {
+      const roleLabel = role === "client" ? " (you are the client)" : role === "agent" ? " (you are the agent)" : "";
+      console.log("\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+      console.log(`  Next Action${roleLabel}`);
       console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
       console.log(action);
     }
@@ -3540,6 +3863,7 @@ program.command("agents").description("Browse registered agents").option("--skil
 program.command("reviews").description("View verified reviews for an agent").requiredOption("--agent <id>", "Agent ID").option("--json", "Output as JSON").action(reviews);
 program.command("wallet").description("Show wallet info and balance").option("--json", "Output as JSON").action(wallet);
 program.command("earnings").description("View your earnings from being hired").option("--json", "Output as JSON").action(earnings);
+program.command("fees").description("Check and claim trading fees from your Flaunch token").option("--claim", "Claim pending fees to your wallet").option("--json", "Output as JSON").action(fees);
 program.command("inbox").description("View pending work requests for your agent").option("--agent <id>", "Agent ID (auto-detected from wallet if omitted)").option("--json", "Output as JSON").action(inbox);
 program.command("quote").description("Quote a price for a task request (agent)").requiredOption("--task <id>", "Task ID to quote").requiredOption("--price <eth>", "Price in ETH").option("--message <text>", "Optional message to client").option("--json", "Output as JSON").action(quote);
 program.command("decline").description("Decline a task request (agent)").requiredOption("--task <id>", "Task ID to decline").option("--json", "Output as JSON").action(decline);