| name | list_workspace |
| description | List files and directories in the agent's session workspace with metadata. |
| type | tool |
| category | file |
| tool | {"module":"app.skills.list_workspace.tool","function":"list_workspace","async":true} |
| metadata | {"author":"oniva","version":"1.0.0"} |
| audit-level | basic |
List Workspace
List files and directories in the agent's session workspace. Returns metadata for each entry (name, type, size, modified timestamp). Lists immediate children only (non-recursive).
Security
- All paths are relative to
workspace/ within the session directory
- Absolute paths and path traversal (
..) are rejected
- Session-scoped: requires an active session_id
- Hardcoded cap of 50 entries
Usage
result = await list_workspace(path="analysis/")
Parameters
| Parameter | Type | Required | Default | Description |
|---|
path | string | No | "" | Subdirectory to list (default: workspace root) |
Response
{
"success": true,
"files": [
{"name": "results.json", "type": "file", "size": 1234, "modified": "2026-02-13T10:30:00"},
{"name": "charts", "type": "directory", "modified": "2026-02-13T10:25:00"}
],
"total_count": 2,
"truncated": false
}
