---
sidebar:
  hidden: true
title: roboto.ai.core.task
---
## Module Contents

### AgentSubtask

```python
class roboto.ai.core.task.AgentSubtask(/, **data: Any)
```

`from roboto.ai.agent_thread import AgentSubtask`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/ai/core/task.py#L56-L63)

Bases: `pydantic.BaseModel`

A lightweight checklist item under a top-level task.

**Parameters**

- **data** (`Any`)

**Attributes**

- **AgentSubtask.status** (`AgentSubtaskStatus`): Whether the sub-task is done.
- **AgentSubtask.title** (`str`): Human-readable description of the sub-task.

### AgentSubtaskStatus

```python
class roboto.ai.core.task.AgentSubtaskStatus
```

`from roboto.ai.agent_thread import AgentSubtaskStatus`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/ai/core/task.py#L27-L38)

Bases: `roboto.compat.StrEnum`

Lifecycle state of a sub-task.

Sub-tasks are never activated independently — they are implicitly active with their parent task — so they have no `in_progress` state.

**Attributes**

- **AgentSubtaskStatus.DONE** = `'done'`: Completed.
- **AgentSubtaskStatus.PENDING** = `'pending'`: Not done yet.

### AgentTask

```python
class roboto.ai.core.task.AgentTask(/, **data: Any)
```

`from roboto.ai.agent_thread import AgentTask`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/ai/core/task.py#L66-L95)

Bases: `pydantic.BaseModel`

A top-level task the agent is tracking within a thread.

**Parameters**

- **data** (`Any`)

**Attributes**

- **AgentTask.conclusion** (`str | None`) = `None`: Outcome recorded when the task was completed. `None` until then.
- **AgentTask.description** (`str | None`) = `None`: Longer description delimiting the task's scope and intent.
- **AgentTask.end** (`AgentTaskBoundary | None`) = `None`: Where the task was completed. `None` until then.
- **AgentTask.position** (`int`): Display order among the thread's top-level tasks.
- **AgentTask.start** (`AgentTaskBoundary | None`) = `None`: Where the task most recently became `in_progress`. `None` if never started.
- **AgentTask.status** (`AgentTaskStatus`): Current lifecycle state.
- **AgentTask.subtasks** (`list[AgentSubtask]`) = `None`: Ordered sub-tasks. A task cannot be completed until all of these are done.
- **AgentTask.task_id** (`int`): Thread-monotonic id, stable for the life of the thread. The model references this id to start or complete the task.
- **AgentTask.title** (`str`): Short title of the task.

### AgentTaskBoundary

```python
class roboto.ai.core.task.AgentTaskBoundary(/, **data: Any)
```

`from roboto.ai.agent_thread import AgentTaskBoundary`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/ai/core/task.py#L41-L53)

Bases: `pydantic.BaseModel`

Position in the conversation where a top-level task's active span begins or ends.

Identifies the assistant message and the content block within it whose tool call drove the transition, so callers can anchor a task to the part of the thread that worked on it.

**Parameters**

- **data** (`Any`)

**Attributes**

- **AgentTaskBoundary.content_sequence_num** (`int`): Index of the tool-call content block within that message.
- **AgentTaskBoundary.message_sequence_num** (`int`): Index of the assistant message whose tool call stamped this boundary.

### AgentTaskMinimal

```python
class roboto.ai.core.task.AgentTaskMinimal(/, **data: Any)
```

`from roboto.ai.agent_thread import AgentTaskMinimal`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/ai/core/task.py#L98-L109)

Bases: `pydantic.BaseModel`

Minimal acknowledgement returned by the task mutation tools.

The full list reaches the model through the per-turn injected context, so the mutation tools echo only the affected task's id and resulting status.

**Parameters**

- **data** (`Any`)

**Attributes**

- **AgentTaskMinimal.status** (`AgentTaskStatus`): Resulting status of the affected task.
- **AgentTaskMinimal.task_id** (`int`): Id of the affected task.

### AgentTaskStatus

```python
class roboto.ai.core.task.AgentTaskStatus
```

`from roboto.ai.agent_thread import AgentTaskStatus`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/ai/core/task.py#L14-L24)

Bases: `roboto.compat.StrEnum`

Lifecycle state of a top-level agent task.

**Attributes**

- **AgentTaskStatus.COMPLETED** = `'completed'`: Finished; carries a [`AgentTask.conclusion`](/reference/python-sdk/roboto/ai/core/task#roboto.ai.core.task.AgentTask.conclusion).
- **AgentTaskStatus.IN_PROGRESS** = `'in_progress'`: The single active task. At most one task per thread is in this state.
- **AgentTaskStatus.PENDING** = `'pending'`: Not started yet.