---
sidebar:
  label: roboto.ai.core
  order: 2
title: roboto.ai.core
---
Core AI abstractions usable by any other submodule within module roboto.ai.

## Submodules

- [roboto.ai.core.content](/docs/reference/python-sdk/roboto/ai/core/content)
- [roboto.ai.core.context](/docs/reference/python-sdk/roboto/ai/core/context)
- [roboto.ai.core.event](/docs/reference/python-sdk/roboto/ai/core/event)
- [roboto.ai.core.record](/docs/reference/python-sdk/roboto/ai/core/record)
- [roboto.ai.core.task](/docs/reference/python-sdk/roboto/ai/core/task)

## Package Contents

- [AGENT_CONTENT_MODEL_BY_TYPE](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AGENT_CONTENT_MODEL_BY_TYPE) (data): `AGENT_CONTENT_MODEL_BY_TYPE: dict[AgentContentType, type[AgentContent]]`. The model class for each JSON-serialized content type, keyed by discriminator.

- [AgentClientContextEntry](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentClientContextEntry) (class): The caller's attached viewing context, carried on their own message.

- [AgentCompressionFillerContent](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentCompressionFillerContent) (class): Filler standing in for a message the compression deletion pass emptied.

- [AgentContent](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentContent) (type alias): `type AgentContent = AgentTextContent | AgentToolUseContent | AgentToolResultContent | AgentErrorContent | AgentDeletedContent | AgentCompressionFillerContent | AgentClientContextEntry`. Type alias for all possible content types within agent messages.

- [AgentContentType](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentContentType) (class): Enumeration of different types of content within agent messages.

- [AgentDeletedContent](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentDeletedContent) (class): Tombstone for a content block removed by compression.

- [AgentErrorContent](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentErrorContent) (class): Error content within an agent message.

- [AgentErrorEvent](/reference/python-sdk/roboto/ai/core/event#roboto.ai.core.event.AgentErrorEvent) (class): Signals that message generation failed or was cancelled.

- [AgentEvent](/reference/python-sdk/roboto/ai/core/event#roboto.ai.core.event.AgentEvent) (type alias): `type AgentEvent = typing.Union[AgentStartTextEvent, AgentTextDeltaEvent, AgentTextEndEvent, AgentToolUseEvent, AgentToolResultEvent, AgentErrorEvent]`

- [AgentMessage](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentMessage) (class): A single message within an agent thread.

- [AgentMessageStatus](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentMessageStatus) (class): Enumeration of possible message generation states.

- [AgentRole](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentRole) (class): Enumeration of possible roles in an agent thread.

- [AgentStartTextEvent](/reference/python-sdk/roboto/ai/core/event#roboto.ai.core.event.AgentStartTextEvent) (class): Signals the beginning of text generation in a chat response.

- [AgentTextContent](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentTextContent) (class): Text content within an agent message.

- [AgentTextDeltaEvent](/reference/python-sdk/roboto/ai/core/event#roboto.ai.core.event.AgentTextDeltaEvent) (class): Contains incremental text content as the AI generates its response.

- [AgentTextEndEvent](/reference/python-sdk/roboto/ai/core/event#roboto.ai.core.event.AgentTextEndEvent) (class): Signals the completion of text generation in a chat response.

- [AgentThreadDelta](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentThreadDelta) (class): Incremental update to an agent thread.

- [AgentThreadRecord](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentThreadRecord) (class): Complete record of an agent thread.

- [AgentThreadStatus](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentThreadStatus) (class): Enumeration of possible agent thread states.

- [AgentToolResultContent](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentToolResultContent) (class): Tool execution result content within an agent message.

- [AgentToolResultEvent](/reference/python-sdk/roboto/ai/core/event#roboto.ai.core.event.AgentToolResultEvent) (class): Contains the result of a tool invocation.

- [AgentToolUseContent](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentToolUseContent) (class): Tool usage request content within an agent message.

- [AgentToolUseEvent](/reference/python-sdk/roboto/ai/core/event#roboto.ai.core.event.AgentToolUseEvent) (class): Signals that the AI is invoking a tool to gather information.

- [AnalysisScope](/reference/python-sdk/roboto/ai/core/context#roboto.ai.core.context.AnalysisScope) (class): The slice of data an agent is expected to analyze.

- [ClientToolSpec](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.ClientToolSpec) (class): Declarative specification for a client-side tool.

- [ClientViewingContext](/reference/python-sdk/roboto/ai/core/context#roboto.ai.core.context.ClientViewingContext) (class): What the Roboto client (e.g. the Web UI) is currently viewing when the user composed a message.

- [ModelProfileResponse](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.ModelProfileResponse) (class): Metadata about an available model profile, returned by the API.

- [synthesize_tool_result_payload()](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.synthesize_tool_result_payload) (function): Reconstruct a tool result's text or JSON output from its legacy response envelope.