`flowagent`: `PUT /flowai/agents/{name}` requires `details` wrapper

[donnielpage]

Symptom

Updating a FlowAgent via PUT returns:

"Bad Agent" / "must have required property 'name'"

even though the agent object includes name.

Platform behavior

The FlowAI agent PUT endpoint requires the agent body wrapped in a details key:

Right: {"details": {"name": "...", "messages": [...], "identity": {...}, ...}}
Wrong: {"name": "...", "messages": [...], ...} (sends the agent object directly without details wrapper)

The error message is misleading — it complains about a missing name property, but name is present; the platform just can't find it because it's looking inside details.

Suggested skill update

• Document the details wrapper in flowagent/SKILL.md's PUT/update section.
• Add a "common errors" note: "Bad Agent" / "must have required property 'name'" on PUT means the details wrapper is missing, not that name is actually missing.