{
  "module": "mail_intake.adapters.base",
  "content": {
    "path": "mail_intake.adapters.base",
    "docstring": "Mail provider adapter contracts for Mail Intake.\n\n---\n\n## Summary\n\nThis module defines the **provider-agnostic adapter interface** used for\nread-only mail ingestion.\n\nAdapters encapsulate all provider-specific access logic and expose a\nminimal, normalized contract to the rest of the system. No provider-specific\ntypes or semantics should leak beyond implementations of this interface.",
    "objects": {
      "ABC": {
        "name": "ABC",
        "kind": "alias",
        "path": "mail_intake.adapters.base.ABC",
        "signature": "<bound method Alias.signature of Alias('ABC', 'abc.ABC')>",
        "docstring": null
      },
      "abstractmethod": {
        "name": "abstractmethod",
        "kind": "alias",
        "path": "mail_intake.adapters.base.abstractmethod",
        "signature": "<bound method Alias.signature of Alias('abstractmethod', 'abc.abstractmethod')>",
        "docstring": null
      },
      "Iterator": {
        "name": "Iterator",
        "kind": "alias",
        "path": "mail_intake.adapters.base.Iterator",
        "signature": "<bound method Alias.signature of Alias('Iterator', 'typing.Iterator')>",
        "docstring": null
      },
      "Dict": {
        "name": "Dict",
        "kind": "alias",
        "path": "mail_intake.adapters.base.Dict",
        "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
        "docstring": null
      },
      "Any": {
        "name": "Any",
        "kind": "alias",
        "path": "mail_intake.adapters.base.Any",
        "signature": "<bound method Alias.signature of Alias('Any', 'typing.Any')>",
        "docstring": null
      },
      "MailIntakeAdapter": {
        "name": "MailIntakeAdapter",
        "kind": "class",
        "path": "mail_intake.adapters.base.MailIntakeAdapter",
        "signature": "<bound method Class.signature of Class('MailIntakeAdapter', 20, 92)>",
        "docstring": "Base adapter interface for mail providers.\n\nNotes:\n    **Guarantees:**\n\n        - discover messages matching a query\n        - retrieve full message payloads\n        - retrieve full thread payloads\n\n    **Lifecycle:**\n\n        - adapters are intentionally read-only and must not mutate provider state",
        "members": {
          "iter_message_refs": {
            "name": "iter_message_refs",
            "kind": "function",
            "path": "mail_intake.adapters.base.MailIntakeAdapter.iter_message_refs",
            "signature": "<bound method Function.signature of Function('iter_message_refs', 36, 62)>",
            "docstring": "Iterate over lightweight message references matching a query.\n\nArgs:\n    query (str):\n        Provider-specific query string used to filter messages.\n\nYields:\n    Dict[str, str]:\n        Dictionaries containing message and thread identifiers.\n\nNotes:\n    **Guarantees:**\n\n        - Implementations must yield dictionaries containing at least ``message_id`` and ``thread_id``\n\nExample:\n    Typical yield:\n\n        {\n            \"message_id\": \"...\",\n            \"thread_id\": \"...\"\n        }"
          },
          "fetch_message": {
            "name": "fetch_message",
            "kind": "function",
            "path": "mail_intake.adapters.base.MailIntakeAdapter.fetch_message",
            "signature": "<bound method Function.signature of Function('fetch_message', 64, 77)>",
            "docstring": "Fetch a full raw message by message identifier.\n\nArgs:\n    message_id (str):\n        Provider-specific message identifier.\n\nReturns:\n    Dict[str, Any]:\n        Provider-native message payload (e.g., Gmail message JSON structure)."
          },
          "fetch_thread": {
            "name": "fetch_thread",
            "kind": "function",
            "path": "mail_intake.adapters.base.MailIntakeAdapter.fetch_thread",
            "signature": "<bound method Function.signature of Function('fetch_thread', 79, 92)>",
            "docstring": "Fetch a full raw thread by thread identifier.\n\nArgs:\n    thread_id (str):\n        Provider-specific thread identifier.\n\nReturns:\n    Dict[str, Any]:\n        Provider-native thread payload."
          }
        }
      }
    }
  }
}