Resume an existing conversation session by its ID. This allows you to continue a previous conversation, maintaining all conversation history. The session must have been previously created and not deleted. Args: session_id: The ID of the session
(
self,
session_id: str,
*,
on_permission_request: _PermissionHandlerFn | None = None,
model: str | None = None,
client_name: str | None = None,
reasoning_effort: ReasoningEffort | None = None,
reasoning_summary: ReasoningSummary | None = None,
context_tier: ContextTier | None = None,
tools: list[Tool] | None = None,
system_message: SystemMessageConfig | None = None,
available_tools: list[str] | ToolSet | None = None,
excluded_tools: list[str] | ToolSet | None = None,
on_user_input_request: UserInputHandler | None = None,
hooks: SessionHooks | None = None,
working_directory: str | None = None,
provider: ProviderConfig | None = None,
capi: CapiSessionOptions | None = None,
providers: list[NamedProviderConfig] | None = None,
models: list[ProviderModelConfig] | None = None,
enable_session_telemetry: bool | None = None,
enable_citations: bool | None = None,
excluded_builtin_agents: list[str] | None = None,
session_limits: SessionLimitsConfig | None = None,
skip_custom_instructions: bool | None = None,
custom_agents_local_only: bool | None = None,
coauthor_enabled: bool | None = None,
manage_schedule_enabled: bool | None = None,
model_capabilities: ModelCapabilitiesOverride | None = None,
streaming: bool | None = None,
include_sub_agent_streaming_events: bool | None = None,
mcp_servers: dict[str, MCPServerConfig] | None = None,
mcp_oauth_token_storage: Literal["persistent", "in-memory"] | None = None,
embedding_cache_storage: Literal["persistent", "in-memory"] | None = None,
custom_agents: list[CustomAgentConfig] | None = None,
default_agent: DefaultAgentConfig | dict[str, Any] | None = None,
agent: str | None = None,
config_directory: str | None = None,
enable_config_discovery: bool | None = None,
skip_embedding_retrieval: bool | None = None,
organization_custom_instructions: str | None = None,
enable_on_demand_instruction_discovery: bool | None = None,
enable_file_hooks: bool | None = None,
enable_host_git_operations: bool | None = None,
enable_session_store: bool | None = None,
enable_skills: bool | None = None,
skill_directories: list[str] | None = None,
plugin_directories: list[str] | None = None,
instruction_directories: list[str] | None = None,
disabled_skills: list[str] | None = None,
infinite_sessions: InfiniteSessionConfig | None = None,
large_output: LargeToolOutputConfig | None = None,
memory: MemoryConfiguration | None = None,
on_event: Callable[[SessionEvent], None] | None = None,
commands: list[CommandDefinition] | None = None,
on_elicitation_request: ElicitationHandler | None = None,
on_mcp_auth_request: McpAuthHandler | None = None,
enable_mcp_apps: bool = False,
on_exit_plan_mode_request: ExitPlanModeHandler | None = None,
on_auto_mode_switch_request: AutoModeSwitchHandler | None = None,
create_session_fs_handler: CreateSessionFsHandler | None = None,
github_token: str | None = None,
remote_session: RemoteSessionMode | None = None,
continue_pending_work: bool | None = None,
canvases: list[CanvasDeclaration] | None = None,
request_canvas_renderer: bool | None = None,
request_extensions: bool | None = None,
extension_sdk_path: str | None = None,
extension_info: ExtensionInfo | None = None,
canvas_handler: CanvasHandler | None = None,
open_canvases: list[OpenCanvasInstance] | None = None,
exp_assignments: dict[str, Any] | None = None,
)
| 2300 | return session |
| 2301 | |
| 2302 | async def resume_session( |
| 2303 | self, |
| 2304 | session_id: str, |
| 2305 | *, |
| 2306 | on_permission_request: _PermissionHandlerFn | None = None, |
| 2307 | model: str | None = None, |
| 2308 | client_name: str | None = None, |
| 2309 | reasoning_effort: ReasoningEffort | None = None, |
| 2310 | reasoning_summary: ReasoningSummary | None = None, |
| 2311 | context_tier: ContextTier | None = None, |
| 2312 | tools: list[Tool] | None = None, |
| 2313 | system_message: SystemMessageConfig | None = None, |
| 2314 | available_tools: list[str] | ToolSet | None = None, |
| 2315 | excluded_tools: list[str] | ToolSet | None = None, |
| 2316 | on_user_input_request: UserInputHandler | None = None, |
| 2317 | hooks: SessionHooks | None = None, |
| 2318 | working_directory: str | None = None, |
| 2319 | provider: ProviderConfig | None = None, |
| 2320 | capi: CapiSessionOptions | None = None, |
| 2321 | providers: list[NamedProviderConfig] | None = None, |
| 2322 | models: list[ProviderModelConfig] | None = None, |
| 2323 | enable_session_telemetry: bool | None = None, |
| 2324 | enable_citations: bool | None = None, |
| 2325 | excluded_builtin_agents: list[str] | None = None, |
| 2326 | session_limits: SessionLimitsConfig | None = None, |
| 2327 | skip_custom_instructions: bool | None = None, |
| 2328 | custom_agents_local_only: bool | None = None, |
| 2329 | coauthor_enabled: bool | None = None, |
| 2330 | manage_schedule_enabled: bool | None = None, |
| 2331 | model_capabilities: ModelCapabilitiesOverride | None = None, |
| 2332 | streaming: bool | None = None, |
| 2333 | include_sub_agent_streaming_events: bool | None = None, |
| 2334 | mcp_servers: dict[str, MCPServerConfig] | None = None, |
| 2335 | mcp_oauth_token_storage: Literal["persistent", "in-memory"] | None = None, |
| 2336 | embedding_cache_storage: Literal["persistent", "in-memory"] | None = None, |
| 2337 | custom_agents: list[CustomAgentConfig] | None = None, |
| 2338 | default_agent: DefaultAgentConfig | dict[str, Any] | None = None, |
| 2339 | agent: str | None = None, |
| 2340 | config_directory: str | None = None, |
| 2341 | enable_config_discovery: bool | None = None, |
| 2342 | skip_embedding_retrieval: bool | None = None, |
| 2343 | organization_custom_instructions: str | None = None, |
| 2344 | enable_on_demand_instruction_discovery: bool | None = None, |
| 2345 | enable_file_hooks: bool | None = None, |
| 2346 | enable_host_git_operations: bool | None = None, |
| 2347 | enable_session_store: bool | None = None, |
| 2348 | enable_skills: bool | None = None, |
| 2349 | skill_directories: list[str] | None = None, |
| 2350 | plugin_directories: list[str] | None = None, |
| 2351 | instruction_directories: list[str] | None = None, |
| 2352 | disabled_skills: list[str] | None = None, |
| 2353 | infinite_sessions: InfiniteSessionConfig | None = None, |
| 2354 | large_output: LargeToolOutputConfig | None = None, |
| 2355 | memory: MemoryConfiguration | None = None, |
| 2356 | on_event: Callable[[SessionEvent], None] | None = None, |
| 2357 | commands: list[CommandDefinition] | None = None, |
| 2358 | on_elicitation_request: ElicitationHandler | None = None, |
| 2359 | on_mcp_auth_request: McpAuthHandler | None = None, |