OSWorld Reset Tool (Level 4)
Input
- •
modeorvalue: string (required) - "soft" or "hard"- •
soft: Clear step counter only, no state change - •
hard: Call DesktopEnv.reset() to revert environment to snapshot state
- •
Output
- •Note ID (bound to
outvariable) containing:- •
text: formatted reset result - •
format: "text" - •
metadata: reset data including:- •
success: boolean - whether reset succeeded - •
mode: string - reset mode used - •
step_counter: integer - step counter after reset (0)
- •
- •
Configuration
- •
OSWORLD_URLenvironment variable (defaults tohttp://localhost:3002) - •Or pass
osworld_urlin character config'sosworld_configsection
Common Workflow
json
{"type":"osworld-reset","mode":"hard","out":"$reset"}
{"type":"osworld-observe","out":"$obs"}
{"type":"osworld-execute","python":"pyautogui.click(100,200)","out":"$result"}
Notes
- •Soft reset: Only clears step counter. Useful for reflection without losing state.
- •Hard reset: Reverts environment to snapshot state. Critical for counterfactual replay and reflection.
- •Hard reset is the key reflection enabler - allows Jill to explore "what if" scenarios.