entropic::ReadFileTool Class Reference

Tool for reading file contents with line numbering. More...

Inheritance diagram for entropic::ReadFileTool:

Collaboration diagram for entropic::ReadFileTool:

Public Member Functions
	ReadFileTool (FilesystemServer &server, const std::string &data_dir)
	Construct from server reference and data directory.
MCPAccessLevel	required_access_level () const override
	Read-only tool — requires READ access.
ServerResponse	execute (const std::string &args_json) override
	Read a file and return numbered lines as JSON.
std::string	anchor_key (const std::string &args_json) const override
	Anchor key for context deduplication.
Public Member Functions inherited from entropic::ToolBase
	ToolBase (ToolDefinition def)
	Construct with a pre-built definition.
const std::string &	name () const
	Get the tool name.
const ToolDefinition &	definition () const
	Get the full tool definition.

Additional Inherited Members
Protected Attributes inherited from entropic::ToolBase
ToolDefinition	definition_
	Tool definition.

Detailed Description

Tool for reading file contents with line numbering.

@dg_internal

Version

1.8.5

Definition at line 1305 of file filesystem.cpp.

Constructor & Destructor Documentation

ReadFileTool()

entropic::ReadFileTool::ReadFileTool ( FilesystemServer &  server, const std::string &  data_dir  )

inline

Construct from server reference and data directory.

Parameters

server	Owning filesystem server.
data_dir	Path to bundled data directory. @dg_internal

Version

1.8.5

Definition at line 1314 of file filesystem.cpp.

Member Function Documentation

anchor_key()

std::string entropic::ReadFileTool::anchor_key ( const std::string &  args_json ) const

inlineoverridevirtual

Anchor key for context deduplication.

A non-empty key is what makes MCPServerBase auto-inject the context_anchor directive for this tool.

Parameters

args_json

JSON with "path" key.

Returns

"file:{path}" anchor key. @req REQ-MCP-001 @req REQ-MCP-021

Version

1.8.5

Reimplemented from entropic::ToolBase.

Definition at line 1353 of file filesystem.cpp.

execute()

ServerResponse entropic::ReadFileTool::execute ( const std::string &  args_json )

overridevirtual

Read a file and return numbered lines as JSON.

Execute read_file: resolve, gate, read a numbered window, track.

Parameters

args_json

JSON with "path" key.

Returns

ServerResponse with file content or error. @dg_internal

Version

1.8.5

A successful read records the read in the FileAccessTracker — which is why read_file must always execute and opts out of duplicate detection. A partial (windowed) read counts as a read for read-before-write.

v2.13.0: resolved as a READ for the outside-root policy; gh#158: the read is recorded for the calling session only. v2.14.0 (gh#201): every line carries its number, and long files are paged.

Parameters

args_json

JSON with "path" and optional "offset"/"limit".

Returns

A ServerResponse with no directives whose result is the declared success object or a declared structured error. @req REQ-MCP-021

Version

2.14.0

Implements entropic::ToolBase.

Definition at line 1477 of file filesystem.cpp.

required_access_level()

MCPAccessLevel entropic::ReadFileTool::required_access_level ( ) const

inlineoverridevirtual

Read-only tool — requires READ access.

Returns

MCPAccessLevel::READ, relaxing ToolBase's WRITE default because this tool only inspects the workspace. @req REQ-MCP-011

Version

1.9.4

Reimplemented from entropic::ToolBase.

Definition at line 1328 of file filesystem.cpp.

---

The documentation for this class was generated from the following file:

• mcp/servers/filesystem.cpp