{"record":{"id":"0fc3773edf370a97","repo":"HKUDS/DeepTutor","slug":"knowledge-base-resolved-name-is-connected-to-a","errorCode":null,"errorMessage":"Knowledge base '{resolved_name}' is connected to an external resource and has no local files.","messagePattern":"Knowledge base '(.+?)' is connected to an external resource and has no local files\\.","errorType":"http","errorClass":"HTTPException","httpStatus":409,"severity":"error","filePath":"deeptutor/api/routers/knowledge.py","lineNumber":2310,"sourceCode":"\n    Connected KBs are external-resource pointers and intentionally have no\n    DeepTutor-managed raw directory.  File listing treats that as an empty\n    collection for backwards compatibility; endpoints that require a local\n    file receive an explicit conflict response.\n    \"\"\"\n    manager = _overridden_kb_manager()\n    if manager is not None:\n        resolved_name = _resolve_registered_kb_name(manager, kb_name)\n    else:\n        resource = resolve_kb(kb_name)\n        manager = manager_for_resource(resource)\n        resolved_name = resource.name\n\n    kb_entry = _load_kb_entry_or_404(manager, resolved_name)\n    if not supports_local_raw_files(kb_entry):\n        if allow_unsupported:\n            return None\n        raise HTTPException(\n            status_code=409,\n            detail=(\n                f\"Knowledge base '{resolved_name}' is connected to an external resource \"\n                \"and has no local files.\"\n            ),\n        )\n\n    kb_path = manager.get_knowledge_base_path(resolved_name)\n    return kb_path / \"raw\"\n\n\ndef _resolve_kb_raw_file_or_404(kb_name: str, filename: str) -> Path:\n    \"\"\"Resolve a raw KB file while preventing traversal outside raw/.\"\"\"\n    raw_dir = _resolve_kb_raw_dir(kb_name)\n    assert raw_dir is not None  # allow_unsupported=False guarantees a path\n    if not raw_dir.exists():\n        raise HTTPException(status_code=404, detail=\"File not found\")\n","sourceCodeStart":2292,"sourceCodeEnd":2328,"githubUrl":"https://github.com/HKUDS/DeepTutor/blob/3e82f130422a813cdd73c10b21a44e9325f5821a/deeptutor/api/routers/knowledge.py#L2292-L2328","documentation":"Error \"Knowledge base '{resolved_name}' is connected to an external resource and has no local files.\" thrown in HKUDS/DeepTutor.","triggerScenarios":"Thrown at deeptutor/api/routers/knowledge.py:2310 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":"3e82f130422a813cdd73c10b21a44e9325f5821a","analyzedAt":"2026-08-27T06:57:25.364Z","schemaVersion":2},"datasetVersion":"2026-08-27T08:17:20.692Z"}