yera.models.workspace
Workspace module for managing conversation state and message history.
This module provides the Workspace class which serves as a container for managing message sequences and variables in an app execution context.
Symbols
Workspace
Manages message history and variable state for app execution.
The Workspace maintains a list of messages exchanged during app execution and provides a dictionary for storing arbitrary variables and context needed during execution. It provides convenience methods for adding messages of different roles (user, system, assistant).
Attributes
A list of Message objects representing the conversation history.
A dictionary for storing execution context and variables.
Methods
Workspace.__init__
__init__()Initialize an empty workspace with a distinct cache identity.
Workspace.wire_messages
wire_messages() → list[Message]Get messages in the workspace not tagged as control flow.
Returns
Messages eligible to be sent to a model provider.
Workspace.add_user_message
add_user_message(
content: str,
) → NoneAdd a user message to the workspace.
Parameters
User-authored message content.
Workspace.add_sys_message
add_sys_message(
content: str,
) → NoneAdd a system message to the workspace.
Parameters
System instruction content.
Workspace.add_assistant_message
add_assistant_message(
content: str,
thinking: str | None = None,
on_wire: bool = True,
provider_data: list[dict[str, object]] | None = None,
) → NoneAdd an assistant message to the workspace.
Parameters
Assistant response content.
Optional reasoning content retained with the message.
Whether the message should be sent in later requests.
Optional provider-specific response metadata.
Workspace.add_tool_call_message
add_tool_call_message(
content: str,
tool_id: str,
call_id: str,
tool_schema: dict,
provider_data: list[dict[str, object]] | None = None,
) → NoneAdd a tool-call message to the workspace.
Parameters
Serialized tool-call content.
Stable tool identifier.
Provider-issued call identifier.
Schema describing the invoked tool.
Optional provider-specific call metadata.
Workspace.add_tool_result_message
add_tool_result_message(
content: str,
tool_id: str,
call_id: str,
tool_schema: dict,
) → NoneAdd a tool-result message to the workspace.
Parameters
Serialized tool result.
Stable tool identifier.
Provider-issued call identifier.
Schema describing the invoked tool.