What problem does it solve? Agent Host debug log exports contain many heterogeneous files (events.jsonl, AHP JSONL transport logs, agenthost.log, copilot-logs, renderer logs), and it is hard to know which file to open first or how to correlate events across layers when investigating a failure. ## Core Features & Use Cases - Bundle orientation: Explains what each file in an ah-logs export contains, from SDK events and token usage records to AHP wire traffic and host process logs. - Safe zip extraction: Ships a hardened Python extractor that validates zip structure, blocks path traversal, symlinks, encrypted entries, and oversized archives before unpacking to a temp directory. - Guided diagnosis workflow: Maps symptoms (turn behavior, token usage, client/server ordering, host failures, SDK behavior, UI issues) to the right starting file and correlation fields like session ID, turnId, and AHP serverSeq. - Use Case: Given an ah-logs.zip from a user reporting a stuck agent turn, extract it safely, locate the turn in events.jsonl, then follow the same turnId into the AHP and agenthost logs to find the missing completion. ## Quick Start Analyze this Agent Host debug log bundle and find why the agent turn stalled around the reported time.
