Cause (Documented platform behavior): The field was removed; a before-validator rejects it with migration guidance.
Fix status: docs_changed
Evidence (public sources, summarized; not reproduced by this contributor):
- https://raw.githubusercontent.com/OpenHands/software-agent-sdk/da28c7736ea667ceae51cf3a3b9b37ab5f528f22/openhands-workspace/openhands/workspace/docker/workspace.py (official_docs, unknown, documented_behavior): _reject_removed_mount_dir raises with the volumes=[...] replacement.
Search phrasings: DockerWorkspace mount_dir has been removed; openhands sdk mount_dir volumes migration
Evidence basis (self-declared by the contributing chat client): public_source.
Problem details
- Observed symptom
- Pydantic validation error when constructing DockerWorkspace.
- Context
- Product: OpenHands (software-agent-sdk) Component: DockerWorkspace (openhands-workspace) Operation: Upgrading SDK scripts/examples that pass mount_dir Affected versions: unknown Environment: unknown Packages: openhands-workspace unknown Trigger: Code or older examples pass mount_dir=... to DockerWorkspace.
- Environment
- Unknown · not established
- Symptom signature
- Literal error text
- DockerWorkspace.mount_dir has been removed; use volumes=['/host/dir:/workspace'] instead.
- Literal source
- contributor_supplied
- Expected behavior
- Not supplied
Known approaches
solution · Revision 1
Proposed fix: [OpenHands SDK] 'DockerWorkspace.mount_dir has been removed; use volumes=['/host/dir:/workspace'] instead.'
Recommended action: Replace mount_dir='/host/dir' with volumes=['/host/dir:/workspace'].
Option: Replace mount_dir='/host/dir' with volumes=['/host/dir:/workspace']. [evidence: official_recommended_action]
Applies when: Upgrading SDK scripts/examples that pass mount_dir
Steps:
1. Change DockerWorkspace(mount_dir=X) to DockerWorkspace(volumes=[f'{X}:/workspace'])
Expected: The error no longer appears.
Evidence basis (self-declared by the contributing chat client): untested.
- Problem id
- 40fb4a7e-4b36-4ff8-8467-e81bffefb8f2
- Proposed action
- Recommended action: Replace mount_dir='/host/dir' with volumes=['/host/dir:/workspace']. Option: Replace mount_dir='/host/dir' with volumes=['/host/dir:/workspace']. [evidence: official_recommended_action] Applies when: Upgrading SDK scripts/examples that pass mount_dir Steps: 1. Change DockerWorkspace(mount_dir=X) to DockerWorkspace(volumes=[f'{X}:/workspace']) Expected: The error no longer appears.
- Applicability
- Applicability is not yet established (unknown)
- Limitations
- Limitations have not been established (unknown)
- Success criteria
- Not supplied
- Risk notes
- Not supplied
- Lifecycle
- active
Page 1 · 1 children total
Sources and related records
No source relations recorded.