{"record":{"id":"f3ed171c65bf2d31","repo":"rohitg00/ai-engineering-from-scratch","slug":"tool-name-r-already-registered-pass-override-tr","errorCode":null,"errorMessage":"tool {name!r} already registered; pass override=True to replace","messagePattern":"tool (.+?) already registered; pass override=True to replace","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"phases/19-capstone-projects/21-tool-registry-schema-validation/code/main.py","lineNumber":83,"sourceCode":"\n    def __init__(self) -> None:\n        self._records: dict[str, ToolRecord] = {}\n        self._order: list[str] = []\n\n    def register(\n        self,\n        name: str,\n        schema: dict,\n        handler: Callable[..., Any],\n        description: str = \"\",\n        idempotent: bool = False,\n        timeout_ms: int = 30_000,\n        override: bool = False,\n    ) -> ToolRecord:\n        if not self._NAME_RE.match(name):\n            raise ValueError(f\"tool name {name!r} must match {self._NAME_RE.pattern}\")\n        if name in self._records and not override:\n            raise ValueError(f\"tool {name!r} already registered; pass override=True to replace\")\n        validate_schema_shape(schema)\n        rec = ToolRecord(\n            name=name, description=description, schema=schema, handler=handler,\n            idempotent=idempotent, timeout_ms=timeout_ms,\n        )\n        if name not in self._records:\n            self._order.append(name)\n        self._records[name] = rec\n        return rec\n\n    def get(self, name: str) -> ToolRecord:\n        if name not in self._records:\n            raise KeyError(f\"unknown tool {name!r}\")\n        return self._records[name]\n\n    def names(self) -> list[str]:\n        return list(self._order)\n","sourceCodeStart":65,"sourceCodeEnd":101,"githubUrl":"https://github.com/rohitg00/ai-engineering-from-scratch/blob/39ea8a1c6d0b61f071226eff7ede4d4105fed820/phases/19-capstone-projects/21-tool-registry-schema-validation/code/main.py#L65-L101","documentation":"Error \"tool {name!r} already registered; pass override=True to replace\" thrown in rohitg00/ai-engineering-from-scratch.","triggerScenarios":"Thrown at phases/19-capstone-projects/21-tool-registry-schema-validation/code/main.py:83 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"}