a2a.utils.task module¶

Utility functions for creating A2A Task objects.

class a2a.utils.task.HistoryLengthConfig(*args, **kwargs)¶

Bases: Protocol

Protocol for configuration arguments containing history_length field.

HasField(field_name: Literal['history_length']) → bool¶

Checks if a field is set.

This method name matches the generated Protobuf code.

history_length: int¶

class a2a.utils.task.ListTasksCursor(timestamp_ns: int | None, task_id: str)¶

Bases: object

A position in the ListTasks sort order.

Tasks are listed by (has timestamp, timestamp, id) in descending order, so tasks without a timestamp come last. A cursor names the last task of a page; the next page starts strictly after it. Because the position is carried in the token rather than looked up again, a page token stays valid when that task is later updated or deleted.

sort_key() → tuple[bool, int, str]¶: The cursor’s position as a (has timestamp, timestamp, id) key.

task_id: str¶

timestamp_ns: int | None¶

a2a.utils.task.apply_history_length(task: Task, config: HistoryLengthConfig | None) → Task¶

Applies history_length parameter on task and returns a new task object.

Parameters:

task – The original task object with complete history
config – Configuration object containing ‘history_length’ field and HasField method.

Returns:

A new task object with limited history