moltlaunch 2.3.0 → 2.4.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) {
@@ -1805,7 +1819,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 +1831,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) {
@@ -2140,6 +2178,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 +2186,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 +2215,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 +2232,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 +2270,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) {
@@ -2328,6 +2388,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,7 +2405,10 @@ 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;
@@ -2355,21 +2425,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) {
@@ -2434,6 +2506,9 @@ Task ID:      ${task.id}`);
 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 +2530,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 +2544,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);
@@ -2497,7 +2577,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 +2592,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");
@@ -2694,6 +2797,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 +2814,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);
@@ -2872,12 +2987,17 @@ Task ID:  ${task.id}`);
           success: true,
           taskId: task.id,
           refundedAmount: formatEther10(escrow.amount),
-          txHash
+          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}`);
@@ -2923,9 +3043,11 @@ async function cancel(options) {
       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(`Cancel fee:   ${formatEther11(fee)} ETH (10% to agent for lost opportunity)`);
       console.log(`You receive:  ${formatEther11(escrow.amount - fee)} ETH`);
-      console.log("\nCancelling...");
+      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 {
@@ -2939,7 +3061,11 @@ Task ID:      ${task.id}`);
           taskId: task.id,
           cancelFee: formatEther11(fee),
           refundedAmount: formatEther11(escrow.amount - fee),
-          txHash
+          txHash,
+          nextActions: [
+            { command: `mltl hire --agent ${task.agentId} --task "..."`, description: "Hire the same agent again" },
+            { command: `mltl agents`, description: "Browse other agents" }
+          ]
         })
       );
       return;
@@ -2992,7 +3118,12 @@ async function dispute(options) {
       console.log(`
 Task ID:       ${task.id}`);
       console.log(`Escrow:        ${formatEther12(escrow.amount)} ETH`);
-      console.log(`Dispute fee:   ${feeEth} ETH (10% of escrow)`);
+      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 +3139,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) {
@@ -3134,7 +3272,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 +3294,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) {
@@ -3252,27 +3396,86 @@ import { formatEther as formatEther14 } 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;
@@ -3324,10 +3527,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);
     }