mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-09 03:30:48 +08:00
47 lines
1.2 KiB
Markdown
47 lines
1.2 KiB
Markdown
# Local Public Tools
|
|
|
|
This project exposes local atomic capabilities as shared `public` tools for all agents.
|
|
|
|
## Included P0 tools
|
|
|
|
- `run_command`
|
|
- `read_file`
|
|
- `write_file`
|
|
- `edit_file`
|
|
|
|
## Included P1/P2/P3 tools
|
|
|
|
- `list_directory`
|
|
- `move_file`
|
|
- `delete_file`
|
|
- `mkdir`
|
|
- `search_files`
|
|
- `get_cwd`
|
|
- `cd`
|
|
- `get_env`
|
|
- `set_env`
|
|
- `list_processes`
|
|
- `kill_process`
|
|
- `bailian_webparser` (DashScope WebParser compatibility tool)
|
|
|
|
## Loading path
|
|
|
|
- Files live under `runtime/tools/public/`.
|
|
- They are auto-discovered by `runtime/tools/public_registry.py` (`*_tool` factory naming).
|
|
- Final exposure is controlled in `runtime/tools/catalog.py`.
|
|
|
|
## Risk gating
|
|
|
|
- `read_file` is `risk_level=low` and visible by default.
|
|
- `run_command`, `write_file`, `edit_file` are `risk_level=high`.
|
|
- High-risk public tools are hidden unless `AIA_PUBLIC_TOOLS_ALLOW_HIGH=1`.
|
|
|
|
## Local backend adapter
|
|
|
|
- Adapter path: `runtime/tools/local_sdk/adapter.py`.
|
|
- Uses a self-implemented local backend (cross-platform) with a stable tool contract.
|
|
|
|
## Path behavior defaults
|
|
|
|
- `run_command`: when `cwd` is omitted, it runs in workspace root.
|
|
- `write_file`: absolute path is used directly; relative path is written under `data/workspace`.
|