List the palace index or the files within a room.

Call without path (or with an empty string) to retrieve INDEX.md, the top-level routing table for the palace. Pass a relative room path (e.g. "global/networking") to list the markdown files in that room.

Read a file from the palace.

path is relative to the palace root (e.g. "global/networking/networking.md"). Returns the full file contents as a string, prefixed with [TRUSTED] or [DATA] when the security system is active.

Write content to a file within the palace.

path is relative to the palace root. The write is atomic (write to a temp file, then rename). Writes to _metrics/, sessions/, or archived/ are rejected, as are non-text file extensions.

Creates parent directories as needed.

Full-text search across the palace (or a sub-path).

Uses ripgrep (rg) if available; falls back to Python re. Returns up to 20 matches, each showing the relative file path, line number, and matched line with 1 line of context on each side.

path narrows the search to a specific room or subdirectory.

Read multiple palace files in a single call.

paths is a list of paths relative to the palace root (maximum _MAX_BATCH_PATHS entries). Returns all files joined by \n---\n, each section headed by ## <path>.

Missing files, directories, and path-traversal violations are noted inline and do not raise exceptions, so partial results are always returned for valid calls. Raises ValueError only for invalid arguments (e.g. more than _MAX_BATCH_PATHS paths).

Returns an empty string for an empty paths list.