M5-1: AppData Directory Listing

Description

Create list_container_appdata tool with timeout protection for large directories.

Endpoint

POST /api/v1/tools/list_container_appdata

Parameters

• container_name (string): Required
• path (string): Relative path within appdata (default: "/")
• max_depth (number): Max recursion depth (default: 0, max: 5)
• timeout_seconds (number): Operation timeout (default: 10, max: 60)

Response Includes

• File/directory entries with type, size, permissions, owner, timestamps
• MIME type detection
• Readable flag with reason if not readable
• Statistics (total entries, files/directories count, total size)
• Operation status (completed, timed_out, execution_time_ms)

Timeout Handling

• Return partial results with clear error message
• Include recommendations for alternative approaches
• Handle large directories like Plex gracefully

Estimated Effort

1.5 days