{"record":{"id":"ccb60bacc45a1078","repo":"rohitg00/ai-engineering-from-scratch","slug":"path-escapes-sandbox-ccb60b","errorCode":null,"errorMessage":"path escapes sandbox","messagePattern":"path escapes sandbox","errorType":"exception","errorClass":"RuntimeError","httpStatus":null,"severity":"error","filePath":"phases/19-capstone-projects/01-terminal-native-coding-agent/code/main.py","lineNumber":110,"sourceCode":"        self._hooks[event].append(fn)\n\n    def fire(self, event: str, payload: dict[str, Any]) -> dict[str, Any]:\n        for fn in self._hooks[event]:\n            payload = fn(payload) or payload\n        return payload\n\n\n# ---------------------------------------------------------------------------\n# tool surface  --  six tools, each sandboxed, each returns truncated text\n# ---------------------------------------------------------------------------\n\nTRUNCATE_BYTES = 4096\n\n\ndef tool_read_file(sandbox: str, path: str) -> str:\n    full = os.path.join(sandbox, path)\n    if not os.path.realpath(full).startswith(os.path.realpath(sandbox)):\n        raise RuntimeError(\"path escapes sandbox\")\n    with open(full, \"r\", encoding=\"utf-8\", errors=\"replace\") as fh:\n        return fh.read()[:TRUNCATE_BYTES]\n\n\ndef tool_run_shell(sandbox: str, cmd: str, timeout: int = 30) -> str:\n    proc = subprocess.run(cmd, cwd=sandbox, shell=True, capture_output=True,\n                          text=True, timeout=timeout)\n    out = (proc.stdout + proc.stderr)[:TRUNCATE_BYTES]\n    return f\"exit={proc.returncode}\\n{out}\"\n\n\nTOOLS: dict[str, Callable[..., str]] = {\n    \"read_file\": tool_read_file,\n    \"run_shell\": tool_run_shell,\n}\n\n\n# ---------------------------------------------------------------------------","sourceCodeStart":92,"sourceCodeEnd":128,"githubUrl":"https://github.com/rohitg00/ai-engineering-from-scratch/blob/39ea8a1c6d0b61f071226eff7ede4d4105fed820/phases/19-capstone-projects/01-terminal-native-coding-agent/code/main.py#L92-L128","documentation":"Error \"path escapes sandbox\" thrown in rohitg00/ai-engineering-from-scratch.","triggerScenarios":"Thrown at phases/19-capstone-projects/01-terminal-native-coding-agent/code/main.py:110 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"39ea8a1c6d0b61f071226eff7ede4d4105fed820","analyzedAt":"2026-08-26T03:13:46.626Z","schemaVersion":2},"datasetVersion":"2026-08-26T07:17:17.940Z"}