Function readFile

src/tools/executors/files.ts:14–39

(args: Record<string, unknown>, context: ToolContext)

}

export async function readFile(args: Record<string, unknown>, context: ToolContext): Promise<ToolResult> {
	const filePath = resolveWorkspacePath(context.cwd, String(args.file_path ?? ""))
	const offset = Math.max(1, Number(args.offset ?? 1) || 1)
	const limitArg = args.limit === null || args.limit === undefined ? MAX_READ_LINES : Number(args.limit)
	const limit = Math.min(Math.max(1, limitArg || MAX_READ_LINES), MAX_READ_LINES)

	let content: string
	try {
		content = fs.readFileSync(filePath, "utf8")
	} catch (error) {
		return { text: `Error reading file ${filePath}: ${(error as Error).message}`, isError: true }
	}

	const allLines = content.split("\n")
	const slice = allLines.slice(offset - 1, offset - 1 + limit)
	if (slice.length === 0) {
		return { text: `File ${filePath} has ${allLines.length} lines; offset ${offset} is beyond the end.`, isError: true }
	}

	let result = withLineNumbers(slice, offset)
	const lastLineShown = offset - 1 + slice.length
	if (lastLineShown < allLines.length) {
		result += `\n\n(Showing lines ${offset}-${lastLineShown} of ${allLines.length}. Use offset/limit to read more.)`
	}
	return { text: result }
}

export async function fileWrite(args: Record<string, unknown>, context: ToolContext): Promise<ToolResult> {
	const filePath = resolveWorkspacePath(context.cwd, String(args.file_path ?? ""))