TaskRequestContext

Part of Tasks in the Python API reference.

Related guidance: concepts/tasks, how-to/receive-local-tasks, how-to/dispatch-local-tasks, quickstarts/effector-handler.

Runnable examples: receive_task.py, dispatch_task.py, receive_mesh_task.py, dispatch_mesh_task.py.

from picogrid_ecn_client import TaskRequestContext

Describe the local context supplied to a registered task handler.

TaskRequestContext(
    *,
    task_id: str,
    target_entity_id: UUID,
    command: str,
    source: Literal['local'] | UUID,
    mode: TaskMode,
    received_at: datetime,
)

Source · models/task.py

Fields

Name	Type	Required	Default	Constraints	Description
task_id	str	yes	—	min_length=1, max_length=128	Task correlation identifier, from 1 through 128 characters.
target_entity_id	UUID	yes	—	—	UUID of the entity targeted by the task.
command	str	yes	—	min_length=1, max_length=128	Registered command name, from 1 through 128 characters.
source	Literal[‘local’] | UUID	yes	—	—	Literal ‘local’ compatibility source or canonical source-terminal UUID.
mode	TaskMode	yes	—	—	Completion behavior requested by the sender.
received_at	datetime	yes	—	—	Timezone-aware UTC time when the task request was received locally.