read-file

name	read_file
description	Read text content from the agent's session workspace.
type	tool
category	file
tool	{"module":"app.skills.read_file.tool","function":"read_file","async":true}
metadata	{"author":"oniva","version":"2.0.0"}
audit-level	basic

Read File

Read text content from the agent's session workspace. Files are scoped to the current session and shared between agents in multi-agent workflows.

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

Usage

result = await read_file(file_path="analysis/results.json")

Parameters

Parameter	Type	Required	Default	Description
file_path	string	Yes	-	Relative path within workspace

Response

{
  "success": true,
  "content": "{\"score\": 0.85}",
  "size_bytes": 18
}