Skip to content

Turn lifecycle ​

How one message becomes a reply.

How one turn moves between the client, the Hub and the brainApp or CLIHubBrain on AMPyour messagesigned context block + messageneeds data or an app action (Hub call)checks permissions and policy, runs it or asksresultsneeds your computer (client call)tool call on the live streamtool result (run on your Mac)resultsfinal answer, claims checkedtext, approval cards, charts, files
  1. Your message reaches the Hub, with the chat, the open folder (by an id and a name, never its path), any attachments and your time zone.
  2. The context block. The Hub builds everything the brain needs to know for this turn and signs it. A forged or oversized block is refused and nothing runs.
  3. The agent works. The brain's task agent reasons and calls tools, in rounds.
  4. Hub calls. What needs credentials (an app action, an automation, a search, a schedule) goes back to the Hub, which checks your permissions, the organization's policy and Stop all, and runs it, or turns it into an approval card. A turn has a few rounds of these.
  5. Client calls. What needs your computer (read a file, run a command, take a screenshot) goes to your client on the live stream. Your client runs it, one at a time and in order, under your permission mode and the sandbox, and sends the result back.
  6. Checks. After writes in a folder, the project check runs in the same round; after a change to a screen, the agent looks at it. Before the reply goes out, the verifier checks its claims; if one doesn't hold, the agent gets one more try, continuing where it stopped.
  7. The reply streams to you as it is written: text, tool rows, approval cards, tables, charts and files. The turn ends done, stopped or failed.

Bounds ​

  • A number of tool rounds per turn, more with a folder open.
  • About five minutes per turn; past it the agent is told to stop and say what's left.
  • A tool that fails three times is blocked for the rest of the turn.
  • Long folder work keeps its tool results within the context by shortening earlier results first, oldest first.

Approval cards across turns ​

A turn that proposes a write ends on the card. Your answer starts the next turn, which resumes the proposal and runs exactly what was approved, once.

Crewdesk is built on CrewAI AMP. It is not an official CrewAI product.