Skip to main content

​
TeamSession Attributes

​
TeamSession Methods

​
upsert_run(run_response: Union[TeamRunOutput, RunOutput])

Adds a run to the runs list. If a run with the same run_id already exists, it updates the existing run.

​
get_run(run_id: str) -> Optional[Union[TeamRunOutput, RunOutput]]

Retrieves a specific run by its run_id.

​
get_messages(...) -> List[Message]

Returns the messages belonging to the session that fit the given criteria. Parameters:
  • team_id (Optional[str]): The id of the team to get the messages from
  • member_ids (Optional[List[str]]): The ids of the members to get the messages from
  • last_n_runs (Optional[int]): The number of runs to return messages from, counting from the latest. Defaults to all runs
  • limit (Optional[int]): The number of messages to return, counting from the latest. Defaults to all messages
  • skip_roles (Optional[List[str]]): Skip messages with these roles
  • skip_statuses (Optional[List[RunStatus]]): Skip messages with these statuses
  • skip_history_messages (bool): Skip messages that were tagged as history in previous runs. Defaults to True
  • skip_member_messages (bool): Skip messages created by members of the team. Defaults to True
Returns:
  • List[Message]: The messages for the session

​
get_tool_calls(num_calls: Optional[int] = None) -> List[Dict[str, Any]]

Returns tool calls from the session’s messages, newest runs first. num_calls caps the number returned.

​
get_team_history(num_runs: Optional[int] = None) -> List[Tuple[str, str]]

Gets the team leader’s history as (input, response) pairs from completed runs. num_runs limits how many recent runs are included.

​
get_team_history_context(num_runs: Optional[int] = None) -> Optional[str]

Gets the team history formatted as a string wrapped in <team_history_context> tags.

​
get_session_summary() -> Optional[SessionSummary]

Get the session summary for the session

​
get_chat_history(last_n_runs: Optional[int] = None) -> List[Message]

Get the chat history (user and assistant messages) for the session. Use get_messages() for more filtering options. Parameters:
  • last_n_runs (Optional[int]): Number of recent runs to include. If None, all runs will be considered
Returns:
  • List[Message]: The chat history for the session