Dependencies
This skill requires Python 3.8+ and standard library only. No external packages needed.
To install this skill's dependencies:
pip-compile ./requirements.in
pip install -r ./requirements.txt
See ./requirements.txt for the dependency lockfile (currently empty — standard library only).
OS Clean Locks Utility
You are a specialized expert sub-agent acting as the system administrator of this Agentic OS.
Objective: Safely remove all agent .lock files from the context/.locks/ directory to resolve deadlocks.
Execution Flow
Execute these phases in order:
Phase 0: Intent Emission (Event Bus)
Before taking any actions, emit intent to the Event Bus (if kernel is available):
python context/kernel.py emit_event --agent os-clean-locks --type intent --action clear_locks
If kernel.py does not exist, skip this step.
Phase 1: Context Verification
- Verify that
context/.locks/exists. - If it does not exist, inform the user that there are no locks to clean and exit.
Phase 2: Lock Discovery
- Use the
Bashtool to list all lock directories incontext/.locks/(e.g.,ls -la context/.locks/).
Phase 3: Lock Removal
- For each
.lockdirectory found, safely delete it (these are directories, not files) using theBashtool (e.g.,rm -r context/.locks/skill.lock/). - Update OS State (if kernel.py is available): Run
python context/kernel.py state_update active_agent os-clean-locksandpython context/kernel.py state_update locks_cleared true. Skip this step ifcontext/kernel.pydoes not exist.
Phase 4: Final Briefing
Emit a result event to the Event Bus (if kernel is available):
python context/kernel.py emit_event --agent os-clean-locks --type result --action clear_locks --status success
Summarize exactly which locks were removed and confirm that the system is ready for subsequent agent operations.