Lifecycle
This skill is activated by default at run start. The harness records start_task
and start_session automatically when a task begins. Use the tools below when
you need finer-grained control over sessions during the same task.
System Events (harness-only)
These are recorded in lifecycle_events but are not planner tools:
start_task: emitted once when the run loop begins.start_session: emitted when the harness opens the first session.
Session Management Tools
start_session: Open a new session and make it the active session. Does not close any already-open sessions.end_session: Close one session only. Usesession_idto close a specific open session, or provide a reason alone to close the active session.new_session: Open a fresh session and make it active, regardless of whether other sessions are already open. Does not close existing sessions.refresh_session: Refresh capability metadata for a specificsession_id. Use after environment resets or UI/tool changes in that session.switch_session: Change the active session to an already-opensession_id.list_sessions: List the currentactive_session_idand allopen_session_ids.
start_session and new_session echo the new session_id plus the current
open-session list in their observation. Use list_sessions whenever you need to
re-check IDs before switch_session, refresh_session, or a targeted
end_session.
Task Completion
end_task: Finish the current QA task and stop the interaction loop when enough evidence has been collected. In targeted GBQA tasks, task exit runs a final fixed-format issue-report pass, so the reason should briefly identify the reproduced bug and localization evidence.
Action Formats
start_session: short reason for opening a sessionend_session:session_idorsession_id reason, or a reason alone to end the active sessionnew_session: short reason for opening a fresh sessionrefresh_session:session_idswitch_session:session_idlist_sessions: any non-empty text (ignored)end_task: short reason for finishing the task
Best Practices
- Prefer
new_sessionwhen you want a clean exploration path without closing older sessions you may still inspect later. - Use
end_sessionwhen a session is no longer needed and should release its resources. - Use
list_sessionsbefore switching, refreshing, or closing a specific session when you are unsure of the current IDs. - Use
switch_sessionto alternate between multiple open sessions instead of reopening the environment repeatedly. - Use
refresh_sessionafter in-session resets that change available tools or UI state. - Call
end_taskonly after you have enough reproduction and localization evidence for the final issue report.