Read

Read a file from the workspace and return its content as cat -n-style numbered lines.

Schema

Param	Type	Required	Default	Notes
`file_path`	string	yes	—	Absolute or workspace-relative path.
`offset`	number	no	1	1-based line to start reading at.
`limit`	number	no	2000	Maximum lines to return.

Path goes through Workspace.Resolve first. Any path that resolves outside the workspace is rejected.
Output format: LINENO\tCONTENT\n per line — standard cat -n shape.
On success, the path is recorded in the session’s read-tracker. This is the gate that Edit and overwriting Write check.
If the target doesn’t exist or is a directory, returns an error result.
If offset exceeds total line count, returns an error result.

1  package main
2
3  import "fmt"
4
5  func main() { fmt.Println("hello") }

Single lines must be ≤ 1 MiB (bufio.Scanner token cap). Minified JS/CSS with no newlines beyond that limit returns bufio.Scanner: token too long.
Binary files with embedded NULs are not specifically detected — the scanner splits on \n and garbage may be emitted. Read is intended for text.
Offsets < 1 are treated as 1.