{"record":{"id":"cc4957c483ec3c01","repo":"microsoft/autogen","slug":"reference-ref-not-found-in-defs-available","errorCode":null,"errorMessage":"Reference `{ref}` not found in `$defs`. Available keys: {list(definitions.keys())}","messagePattern":"Reference `(.+?)` not found in `\\$defs`\\. Available keys: (.+?)","errorType":"exception","errorClass":"ReferenceNotFoundError","httpStatus":null,"severity":"error","filePath":"python/packages/autogen-core/src/autogen_core/utils/_json_to_pydantic.py","lineNumber":114,"sourceCode":"    \"\"\"Construct a Pydantic Field with proper typing.\"\"\"\n    field_kwargs: Dict[str, Any] = {}\n    if title is not None:\n        field_kwargs[\"title\"] = title\n    if description is not None:\n        field_kwargs[\"description\"] = description\n    return Field(default, **field_kwargs)\n\n\nclass _JSONSchemaToPydantic:\n    def __init__(self) -> None:\n        self._model_cache: Dict[str, Optional[Union[Type[BaseModel], ForwardRef]]] = {}\n\n    def _resolve_ref(self, ref: str, schema: Dict[str, Any]) -> Dict[str, Any]:\n        ref_key = ref.split(\"/\")[-1]\n        definitions = cast(dict[str, dict[str, Any]], schema.get(\"$defs\", {}))\n\n        if ref_key not in definitions:\n            raise ReferenceNotFoundError(\n                f\"Reference `{ref}` not found in `$defs`. Available keys: {list(definitions.keys())}\"\n            )\n\n        return definitions[ref_key]\n\n    def get_ref(self, ref_name: str) -> Any:\n        if ref_name not in self._model_cache:\n            raise ReferenceNotFoundError(\n                f\"Reference `{ref_name}` not found in cache. Available: {list(self._model_cache.keys())}\"\n            )\n\n        if self._model_cache[ref_name] is None:\n            return ForwardRef(ref_name)\n\n        return self._model_cache[ref_name]\n\n    def _get_item_model_name(self, array_field_name: str, parent_model_name: str) -> str:\n        \"\"\"Generate hash-based model names for array items to keep names short and unique.\"\"\"","sourceCodeStart":96,"sourceCodeEnd":132,"githubUrl":"https://github.com/microsoft/autogen/blob/027ecf0a379bcc1d09956d46d12d44a3ad9cee14/python/packages/autogen-core/src/autogen_core/utils/_json_to_pydantic.py#L96-L132","documentation":"Error \"Reference `{ref}` not found in `$defs`. Available keys: {list(definitions.keys())}\" thrown in microsoft/autogen.","triggerScenarios":"Thrown at python/packages/autogen-core/src/autogen_core/utils/_json_to_pydantic.py:114 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Add the referenced definition or fix the ref"],"exampleFix":"Ensure every $ref has a matching key in $defs","handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"027ecf0a379bcc1d09956d46d12d44a3ad9cee14","analyzedAt":"2026-08-15T03:38:00.719Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}