Flow Commands

Every flow is a sequence of commands. Each command tells the bee what to do at one step.

`fly_to`

Move the bee to a target element and display a message.

JSON

{
  "type": "fly_to",
  "target": { "kibeeId": "email-field" },
  "message": "Enter your email address here.",
  "highlight": "pulse"
}

Block until the user clicks the target element.

JSON

{
  "type": "wait_for_click",
  "target": { "kibeeId": "submit-btn" },
  "timeoutMs": 30000
}

Block until the user types into the target element.

JSON

{
  "type": "wait_for_input",
  "target": { "kibeeId": "company-name" },
  "timeoutMs": 30000
}

Display a message in the bee's tooltip without flying anywhere.

JSON

{
  "type": "speak",
  "message": "Great progress! Just one more step."
}

Show a visual highlight around a target without moving the bee.

JSON

{
  "type": "highlight",
  "target": { "kibeeId": "sidebar-menu" },
  "variant": "ring"
}

Variants: pulse (default), ring, soft.

Play a celebration animation with an optional message.

JSON

{
  "type": "celebrate",
  "message": "Workflow complete! 🎉"
}

Mark the flow as complete or abandoned.

JSON

{
  "type": "end_flow",
  "status": "completed",
  "message": "You're all set. Bookmark this path for next time."
}