from __future__ import annotations

from typing import Any, Protocol


class DocsRepositoryProtocol(Protocol):
    def list_docs(self) -> list[dict[str, object]]: ...

    def read_doc(self, path: str) -> dict[str, object]: ...

    def search(self, query: str) -> list[dict[str, object]]: ...


class InventoryRepositoryProtocol(Protocol):
    def list_types(self) -> list[str]: ...

    def read_raw(self, inventory_type: str) -> str: ...

    def read_parsed(self, inventory_type: str) -> Any: ...

    def read_item(self, inventory_type: str, item_id: str) -> dict[str, Any]: ...
