// ✅ Safe (read-only)
await run("agent info", wallet);
await run("escrow dump", wallet);
await run("discovery scan", { limit: 50 });

// ⚠️ Requires --simulate first on mainnet
if (cluster === "mainnet") {
  await run("agent register", { manifest, simulate: true });
  // Review output, then:
  await run("agent register", { manifest, confirm: true });
}

// User: "The CLI isn't working"
// Agent:
const diagnosis = await run("doctor run", { json: true });
const failed = diagnosis.checks.filter(c => c.status !== "ok");
if (failed.length > 0) {
  // Act on first failure
  const first = failed[0];
  if (first.id === "keypair") {
    return "Keypair missing. Run: synapse-sap env keypair generate";
  }
  if (first.id === "rpc-reachability") {
    return "RPC unreachable. Check RPC_URL and API key.";
  }
}

// ✅ Preferred (manifest form)
const manifest = {
  name: "TradeBot",
  description: "AI-powered Jupiter swap agent",
  capabilities: [{ id: "jupiter:swap", protocolId: "jupiter", version: "6.0" }],
  protocols: ["jupiter", "A2A"],
  x402Endpoint: "https://api.tradebot.dev/x402"
};
await run("agent register", { manifest: "/path/to/agent.json", simulate: true });

// ⚠️ Inline (ad-hoc only)
await run("agent register", {
  name: "TradeBot",
  description: "AI-powered Jupiter swap agent",
  capability: '{"id":"jupiter:swap","protocolId":"jupiter"}',
  simulate: true
});

// ✅ Machine-readable
const agents = await run("agent list", { json: true });
const active = agents.filter(a => a.status === "active");

// ❌ Don't parse human output
// "TradeBot  8xPj...  Active  8542"

// ✅ Persisted
await run("x402 call", {
  wallet: agentWallet,
  tool: "generate-image",
  args: '{"prompt":"sunset"}',
  save: "out/call.json"
});

// Later: replay or verify
await run("x402 replay", { artifact: "out/call.json" });
await run("x402 verify", { signature: "5eykt4Uu..." });

{
  "ok": true,
  "command": "agent.info",
  "data": {
    "wallet": "8xPjQvN3qZ5K7mR2wL4tY6uF9sH1cV3bD",
    "name": "TradeBot",
    "status": "active",
    "reputationScore": 8542
  },
  "warnings": [],
  "elapsedMs": 412
}

{
  "ok": false,
  "command": "agent.register",
  "error": {
    "code": "VALIDATION",
    "message": "Name exceeds 64 characters",
    "field": "name"
  },
  "elapsedMs": 12
}

const result = await run("agent info", { wallet, json: true });
if (!result.ok) {
  throw new Error(`${result.error.code}: ${result.error.message}`);
}
return result.data;

// User: "Register an agent for Jupiter swaps"

// Step 1: Check environment
const doctor = await run("doctor run", { json: true });
if (!doctor.ok) {
  return `Environment issue: ${doctor.error.message}`;
}

// Step 2: Check if agent already exists
const existing = await run("agent info", { wallet: userWallet, json: true });
if (existing.ok) {
  return `Agent already registered: ${existing.data.name}`;
}

// Step 3: Build manifest
const manifest = {
  name: "Jupiter Swap Agent",
  description: "Execute token swaps via Jupiter aggregator",
  capabilities: [{ id: "jupiter:swap", protocolId: "jupiter", version: "6.0" }],
  protocols: ["jupiter"],
  x402Endpoint: "https://api.example.com/x402"
};
await writeFile("agent.json", JSON.stringify(manifest, null, 2));

// Step 4: Simulate registration (mainnet safety)
const sim = await run("agent register", {
  manifest: "agent.json",
  simulate: true,
  json: true
});
if (!sim.ok) {
  return `Simulation failed: ${sim.error.message}`;
}

// Step 5: Ask for confirmation
const confirmed = await askUser("Proceed with registration?");
if (!confirmed) {
  return "Registration cancelled";
}

// Step 6: Execute registration
const result = await run("agent register", {
  manifest: "agent.json",
  confirm: true,
  json: true
});
if (!result.ok) {
  return `Registration failed: ${result.error.message}`;
}

return `Agent registered successfully! Wallet: ${result.data.wallet}`;