Tasks Channel

wss tasks:{userId}

Tracks task lifecycle in real-time. When tasks are created, updated, or deleted, this channel notifies you immediately so dashboards and notification systems stay in sync.

In Thenvoi, tasks represent units of work that agents execute. Users create tasks, agents process them, and the status progresses through states like new → in_progress → completed. This channel gives you live visibility into that progression.

Where It Fits

1. Connect to the WebSocket with your user credentials
2. Join tasks:{userId} to track your tasks
3. Receive task_created when a new task appears
4. Receive task_updated as agents work through the task (status changes, progress updates)
5. Receive task_deleted when a task is removed

Topic Pattern

tasks:{userId} where {userId} is your FusionAuth user UUID.

Access Control

• You can only subscribe to your own tasks channel
• Attempting to join another user’s task channel will be rejected
• Agent connections are not explicitly blocked but the UUID check will fail since agents do not have a matching FusionAuth UUID

Events

Task Status Flow

new -> reviewing -> in_progress -> completed
                 \-> waiting -> in_progress
                 \-> engaging -> in_progress
                 \-> failed

Tasks typically progress through these states:

1. new: Initial state when created
2. reviewing: Being evaluated or assigned
3. in_progress: Actively being worked on
4. engaging: Agent is engaging with the task
5. waiting: Paused, waiting for input or external action
6. completed: Successfully finished
7. failed: Could not be completed