{"record":{"id":"5295b29c7174ca7b","repo":"rohitg00/ai-engineering-from-scratch","slug":"run-requires-idle-got-self-state-value","errorCode":null,"errorMessage":"run() requires IDLE, got {self.state.value}","messagePattern":"run\\(\\) requires IDLE, got (.+?)","errorType":"exception","errorClass":"RuntimeError","httpStatus":null,"severity":"error","filePath":"phases/19-capstone-projects/20-agent-harness-loop-contract/code/main.py","lineNumber":216,"sourceCode":"    def _check_budget(self) -> PullRequest | None:\n        which = self.budget.exceeded()\n        if which is None:\n            return None\n        self._emit(\"budget.warn\", {\"limit\": which})\n        self.hooks.fire(\"on_budget_exceeded\", {\"limit\": which, \"budget\": self.budget})\n        self._reason = f\"budget_exceeded:{which}\"\n        self._prev_state = self.state\n        return self._pause(self._reason)\n\n    def _pause(self, reason: str) -> PullRequest:\n        self._emit(\"session.pause\", {\"reason\": reason})\n        self.hooks.fire(\"on_pause\", {\"reason\": reason})\n        self._transition(State.IDLE)\n        return PullRequest(reason=reason, state=self.state, payload={\"reason\": reason})\n\n    def run(self, goal: str) -> PullRequest | SessionResult:\n        if self.state != State.IDLE:\n            raise RuntimeError(f\"run() requires IDLE, got {self.state.value}\")\n        self._goal = goal\n        self.budget.started_at = time.time()\n        self._emit(\"session.start\", {\"goal\": goal})\n        return self._step()\n\n    def resume(self, payload: dict | None = None) -> PullRequest | SessionResult:\n        if self.state == State.IDLE and self._reason.startswith(\"budget_exceeded\"):\n            self.budget.turns = 0\n            self.budget.tool_calls = 0\n            self.budget.started_at = time.time()\n            self._reason = \"\"\n            prev = self._prev_state\n            self._prev_state = None\n            if not self._plan:\n                return self._begin_plan()\n            if prev == State.EXECUTING:\n                self.state = State.EXECUTING\n            else:","sourceCodeStart":198,"sourceCodeEnd":234,"githubUrl":"https://github.com/rohitg00/ai-engineering-from-scratch/blob/39ea8a1c6d0b61f071226eff7ede4d4105fed820/phases/19-capstone-projects/20-agent-harness-loop-contract/code/main.py#L198-L234","documentation":"Error \"run() requires IDLE, got {self.state.value}\" thrown in rohitg00/ai-engineering-from-scratch.","triggerScenarios":"Thrown at phases/19-capstone-projects/20-agent-harness-loop-contract/code/main.py:216 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"}