{ "module": "mail_intake.config", "content": { "path": "mail_intake.config", "docstring": "# Summary\n\nGlobal configuration models for Mail Intake.\n\nThis module defines the **top-level configuration object** used to control\nmail ingestion behavior across adapters, authentication providers, and\ningestion workflows.\n\nConfiguration is intentionally explicit, immutable, and free of implicit\nenvironment reads to ensure predictability and testability.", "objects": { "dataclass": { "name": "dataclass", "kind": "alias", "path": "mail_intake.config.dataclass", "signature": "", "docstring": null }, "Optional": { "name": "Optional", "kind": "alias", "path": "mail_intake.config.Optional", "signature": "", "docstring": null }, "MailIntakeConfig": { "name": "MailIntakeConfig", "kind": "class", "path": "mail_intake.config.MailIntakeConfig", "signature": "", "docstring": "Global configuration for `mail-intake`.\n\nNotes:\n **Guarantees:**\n\n - This configuration is intentionally explicit and immutable.\n - No implicit environment reads or global state.\n - Explicit configuration over implicit defaults.\n - No direct environment or filesystem access.\n - This model is safe to pass across layers and suitable for\n serialization.", "members": { "provider": { "name": "provider", "kind": "attribute", "path": "mail_intake.config.MailIntakeConfig.provider", "signature": null, "docstring": "Identifier of the mail provider to use (e.g., ``\"gmail\"``)." }, "user_id": { "name": "user_id", "kind": "attribute", "path": "mail_intake.config.MailIntakeConfig.user_id", "signature": null, "docstring": "Provider-specific user identifier. Defaults to the authenticated user." }, "readonly": { "name": "readonly", "kind": "attribute", "path": "mail_intake.config.MailIntakeConfig.readonly", "signature": null, "docstring": "Whether ingestion should operate in read-only mode." }, "credentials_path": { "name": "credentials_path", "kind": "attribute", "path": "mail_intake.config.MailIntakeConfig.credentials_path", "signature": null, "docstring": "Optional path to provider credentials configuration." }, "token_path": { "name": "token_path", "kind": "attribute", "path": "mail_intake.config.MailIntakeConfig.token_path", "signature": null, "docstring": "Optional path to persisted authentication tokens." } } } } } }