contextbase-plugin-gmail 0.2.6__py3-none-any.whl

contextbase_plugin_gmail-0.2.6.dist-info/METADATA

@@ -0,0 +1,13 @@
+Metadata-Version: 2.3
+Name: contextbase-plugin-gmail
+Version: 0.2.6
+Summary: Gmail plugin for ContextBase
+Author: Alizain Feerasta
+Author-email: Alizain Feerasta <alizain.feerasta@gmail.com>
+Requires-Dist: contextbase-shared-plugins==0.2.6
+Requires-Dist: dagster==1.12.14
+Requires-Dist: dagster-dlt==0.28.14
+Requires-Dist: dlt>=1.26.0
+Requires-Dist: google-api-python-client>=2.185.0
+Requires-Dist: pydantic>=2.12.0
+Requires-Python: >=3.14, <3.15

contextbase_plugin_gmail-0.2.6.dist-info/RECORD

@@ -0,0 +1,21 @@
+plugin_gmail/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plugin_gmail/binding_config.py,sha256=Gj9UfPxZPcJ5OJgRZFUOas7yOfr2YFHBEkE8xvo74w0,493
+plugin_gmail/component.py,sha256=gFuOMbGOBEDYRNwE-d_OHykbvJIg3qkLpv6ctJij1tI,9334
+plugin_gmail/defs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plugin_gmail/defs/defs.yaml,sha256=T04TfRCWlD8cEeUlUUCGfMYeSI5ggCFVF49Ws5TmmNY,48
+plugin_gmail/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plugin_gmail/models/ctx.py,sha256=PyIzp1TiuI1lLL3xfHiI_xMupP7VCkzoIL2nfZ9bm1s,4666
+plugin_gmail/models/ingress.py,sha256=DYvYQnimuiVPQZLdid0d8Hv3iq1djj8HvYxZOw_Kk-A,6493
+plugin_gmail/models/translators.py,sha256=VMFmSL2A-K9LbunljE226yJRQ4J_KPGZMOZUOVTsmaQ,14781
+plugin_gmail/models/types.py,sha256=ivgGsKdlSUaqag00IMpb3BphFbz3AGgmjjtfl4H-YbM,270
+plugin_gmail/plugin.json,sha256=3xjoHA6z4isOwN8qU3X_5UG9pjZz-aVKqrte-d4HM9E,170
+plugin_gmail/sources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plugin_gmail/sources/attachments.py,sha256=q8lF_uObn3CuLYKxk9ZkdmK1_9Bbv68RG7ZkLzTldNw,9932
+plugin_gmail/sources/backfill.py,sha256=tFLc-mdEtEpHvjKjEKpcgzk-UB2GU_ZAQ8shNuHmqXk,4122
+plugin_gmail/sources/history.py,sha256=hc3WuQoZXHfhTS8uRAtttCZaoRxxpOFBZZ6md2XpsEU,4913
+plugin_gmail/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plugin_gmail/utils/attachments.py,sha256=eWXFZ0ZR7ToRvbyXwp2VlmOyRoikiz4hahSUl9xSVU4,8110
+plugin_gmail/utils/client.py,sha256=H6a2LvJddoeDPkXKAc0fzMrf1sXBZjBAj2QVX6T1xF0,17774
+contextbase_plugin_gmail-0.2.6.dist-info/WHEEL,sha256=i9aSRDivn5iP9LaR1BLQX2GNAuriQWPsFwbbWygTX2k,81
+contextbase_plugin_gmail-0.2.6.dist-info/METADATA,sha256=CVQcJPIYyz21sxGcFraX1xsnMv7g9lrQwkmbZpTaEmM,447
+contextbase_plugin_gmail-0.2.6.dist-info/RECORD,,

contextbase_plugin_gmail-0.2.6.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.15
+Root-Is-Purelib: true
+Tag: py3-none-any

plugin_gmail/binding_config.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from shared_plugins.bindings import BaseBindingConfigModel
+
+
+class GmailBindingConfig(BaseBindingConfigModel):
+    """Gmail plugin binding configuration.
+
+    Gmail has no per-binding settings today. The empty model exists to
+    establish the parse site so that adding the first real field later is a
+    one-line change, and to replace ad hoc rejection guards with a
+    declarative unknown-keys check (inherited from ``BaseBindingConfigModel``).
+    """

plugin_gmail/component.py

@@ -0,0 +1,269 @@
+import dagster as dg
+from dagster import AssetExecutionContext
+from dagster_dlt import DagsterDltResource
+from shared_plugins.automation import non_overlapping_automation_condition
+from shared_types.dagster_binding_plan import DagsterAllPlanBinding
+from shared_plugins.bindings import (
+    parse_binding_config,
+    require_authenticated_account,
+)
+from shared_plugins.control_plane import ControlPlaneClient
+from shared_plugins.dlt import resolve_partition_binding, run_dlt_pipeline
+from shared_plugins.google_client.auth import (
+    build_google_service,
+)
+from shared_plugins.naming import (
+    dagster_asset_group_name,
+    dagster_asset_tags,
+    dagster_dlt_asset_key,
+    dagster_partition_def_name,
+    dagster_pool_name,
+    dlt_source_name,
+    plugin_id_from_module,
+)
+from shared_plugins.resources import DLT_RESOURCE
+
+from .binding_config import GmailBindingConfig
+from .sources.attachments import gmail_attachment_content_source
+from .sources.backfill import gmail_backfill_source
+from .sources.history import gmail_history_source
+from .utils.client import GmailApiClient
+
+PLUGIN_ID = plugin_id_from_module(__file__)
+BACKFILL_JOB = "backfill"
+HISTORY_JOB = "history"
+ATTACHMENT_CONTENT_JOB = "attachment_content"
+
+BACKFILL_SOURCE_NAME = dlt_source_name(PLUGIN_ID, BACKFILL_JOB)
+HISTORY_SOURCE_NAME = dlt_source_name(PLUGIN_ID, HISTORY_JOB)
+ATTACHMENT_CONTENT_SOURCE_NAME = dlt_source_name(PLUGIN_ID, ATTACHMENT_CONTENT_JOB)
+
+BACKFILL_MESSAGES_ASSET_KEY = dagster_dlt_asset_key(BACKFILL_SOURCE_NAME, "messages")
+HISTORY_EVENTS_ASSET_KEY = dagster_dlt_asset_key(HISTORY_SOURCE_NAME, "history_events")
+HISTORY_MESSAGES_ASSET_KEY = dagster_dlt_asset_key(HISTORY_SOURCE_NAME, "messages")
+
+
+def _build_backfill_specs(
+    partitions_def: dg.PartitionsDefinition,
+    automation_condition: dg.AutomationCondition,
+) -> list[dg.AssetSpec]:
+    shared = dict(
+        group_name=dagster_asset_group_name(PLUGIN_ID),
+        tags=dagster_asset_tags(PLUGIN_ID),
+        automation_condition=automation_condition,
+        partitions_def=partitions_def,
+    )
+    return [
+        dg.AssetSpec(
+            key=dagster_dlt_asset_key(BACKFILL_SOURCE_NAME, "profile"), **shared
+        ),
+        dg.AssetSpec(
+            key=dagster_dlt_asset_key(BACKFILL_SOURCE_NAME, "labels"), **shared
+        ),
+        dg.AssetSpec(key=BACKFILL_MESSAGES_ASSET_KEY, **shared),
+    ]
+
+
+def _build_history_specs(
+    partitions_def: dg.PartitionsDefinition,
+    automation_condition: dg.AutomationCondition,
+) -> list[dg.AssetSpec]:
+    shared = dict(
+        group_name=dagster_asset_group_name(PLUGIN_ID),
+        tags=dagster_asset_tags(PLUGIN_ID),
+        automation_condition=automation_condition,
+        partitions_def=partitions_def,
+    )
+    return [
+        dg.AssetSpec(
+            key=dagster_dlt_asset_key(HISTORY_SOURCE_NAME, "profile"), **shared
+        ),
+        dg.AssetSpec(
+            key=dagster_dlt_asset_key(HISTORY_SOURCE_NAME, "labels"), **shared
+        ),
+        dg.AssetSpec(key=HISTORY_EVENTS_ASSET_KEY, **shared),
+        dg.AssetSpec(
+            key=HISTORY_MESSAGES_ASSET_KEY,
+            deps=[HISTORY_EVENTS_ASSET_KEY],
+            **shared,
+        ),
+    ]
+
+
+def _build_attachment_content_specs(
+    partitions_def: dg.PartitionsDefinition,
+    automation_condition: dg.AutomationCondition,
+) -> list[dg.AssetSpec]:
+    return [
+        dg.AssetSpec(
+            key=dagster_dlt_asset_key(ATTACHMENT_CONTENT_SOURCE_NAME, "attachments"),
+            group_name=dagster_asset_group_name(PLUGIN_ID),
+            tags=dagster_asset_tags(PLUGIN_ID),
+            automation_condition=automation_condition,
+            partitions_def=partitions_def,
+            deps=[BACKFILL_MESSAGES_ASSET_KEY, HISTORY_MESSAGES_ASSET_KEY],
+        ),
+    ]
+
+
+def _build_gmail_client(
+    binding: DagsterAllPlanBinding,
+    *,
+    control_plane: ControlPlaneClient,
+) -> GmailApiClient:
+    authenticated_account = require_authenticated_account(binding)
+    return GmailApiClient(
+        service=build_google_service(
+            api_name="gmail",
+            api_version="v1",
+            auth=authenticated_account,
+            control_plane=control_plane,
+        )
+    )
+
+
+class GmailSyncComponent(dg.Component):
+    def build_defs(self, context: dg.ComponentLoadContext) -> dg.Definitions:
+        partitions_def = dg.DynamicPartitionsDefinition(
+            name=dagster_partition_def_name(PLUGIN_ID)
+        )
+        backfill_specs = _build_backfill_specs(
+            partitions_def,
+            non_overlapping_automation_condition(
+                dg.AutomationCondition.missing()
+                & ~dg.AutomationCondition.any_deps_missing()
+            ),
+        )
+        history_specs = _build_history_specs(
+            partitions_def,
+            non_overlapping_automation_condition(
+                dg.AutomationCondition.on_cron("*/15 * * * *")
+            ),
+        )
+        attachment_content_specs = _build_attachment_content_specs(
+            partitions_def,
+            non_overlapping_automation_condition(
+                dg.AutomationCondition.cron_tick_passed("*/10 * * * *")
+            ),
+        )
+
+        @dg.multi_asset(
+            specs=backfill_specs,
+            can_subset=True,
+            name="gmail_backfill",
+            pool=dagster_pool_name(PLUGIN_ID),
+        )
+        def gmail_backfill_assets(
+            context: AssetExecutionContext,
+            dlt_resource: DagsterDltResource,
+            control_plane: dg.ResourceParam[ControlPlaneClient],
+        ):
+            binding = resolve_partition_binding(
+                context=context,
+                control_plane=control_plane,
+                plugin_id=PLUGIN_ID,
+            )
+            binding_id = str(binding.binding_id)
+            parse_binding_config(binding, GmailBindingConfig)
+            client = _build_gmail_client(binding, control_plane=control_plane)
+
+            source = gmail_backfill_source(
+                binding_id,
+                client=client,
+            )
+            yield from run_dlt_pipeline(
+                context=context,
+                dlt_resource=dlt_resource,
+                source=source,
+                plugin_id=PLUGIN_ID,
+                binding_id=binding_id,
+                job_name=BACKFILL_JOB,
+            )
+
+        @dg.multi_asset(
+            specs=history_specs,
+            can_subset=True,
+            name="gmail_history",
+            pool=dagster_pool_name(PLUGIN_ID),
+        )
+        def gmail_history_assets(
+            context: AssetExecutionContext,
+            dlt_resource: DagsterDltResource,
+            control_plane: dg.ResourceParam[ControlPlaneClient],
+        ):
+            binding = resolve_partition_binding(
+                context=context,
+                control_plane=control_plane,
+                plugin_id=PLUGIN_ID,
+            )
+            binding_id = str(binding.binding_id)
+            parse_binding_config(binding, GmailBindingConfig)
+            client = _build_gmail_client(binding, control_plane=control_plane)
+
+            source = gmail_history_source(
+                binding_id,
+                client=client,
+            )
+            yield from run_dlt_pipeline(
+                context=context,
+                dlt_resource=dlt_resource,
+                source=source,
+                plugin_id=PLUGIN_ID,
+                binding_id=binding_id,
+                job_name=HISTORY_JOB,
+            )
+
+        @dg.multi_asset(
+            specs=attachment_content_specs,
+            name="gmail_attachment_content",
+            pool=dagster_pool_name(PLUGIN_ID),
+        )
+        def gmail_attachment_content_assets(
+            context: AssetExecutionContext,
+            dlt_resource: DagsterDltResource,
+            control_plane: dg.ResourceParam[ControlPlaneClient],
+        ):
+            binding = resolve_partition_binding(
+                context=context,
+                control_plane=control_plane,
+                plugin_id=PLUGIN_ID,
+            )
+            binding_id = str(binding.binding_id)
+            parse_binding_config(binding, GmailBindingConfig)
+            client = _build_gmail_client(binding, control_plane=control_plane)
+
+            source = gmail_attachment_content_source(
+                binding_id,
+                client=client,
+            )
+            yield from run_dlt_pipeline(
+                context=context,
+                dlt_resource=dlt_resource,
+                source=source,
+                plugin_id=PLUGIN_ID,
+                binding_id=binding_id,
+                job_name=ATTACHMENT_CONTENT_JOB,
+            )
+
+        automation_sensor = dg.AutomationConditionSensorDefinition(
+            name="gmail_automation_sensor",
+            target=dg.AssetSelection.assets(
+                gmail_backfill_assets,
+                gmail_history_assets,
+                gmail_attachment_content_assets,
+            ),
+            default_status=dg.DefaultSensorStatus.RUNNING,
+            minimum_interval_seconds=30,
+        )
+
+        return dg.Definitions(
+            assets=[
+                gmail_backfill_assets,
+                gmail_history_assets,
+                gmail_attachment_content_assets,
+            ],
+            sensors=[automation_sensor],
+            resources={
+                "dlt_resource": DLT_RESOURCE,
+            },
+        )

plugin_gmail/defs/defs.yaml

@@ -0,0 +1 @@
+type: plugin_gmail.component.GmailSyncComponent

plugin_gmail/models/ctx.py

@@ -0,0 +1,132 @@
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import AwareDatetime, Field, field_validator
+from shared_plugins.models import CtxModel, IdStr, NonNegativeInt, partialize
+from shared_plugins.values import load_json_value, require_non_negative_int
+
+from .ingress import GmailAttachmentIngress
+from .types import HistoryId, MessageId, ThreadId
+
+
+class ProfileRow(CtxModel):
+    email_address: str
+    messages_total: int | None = None
+    threads_total: int | None = None
+    history_id: HistoryId
+
+
+class LabelRow(CtxModel):
+    id: str
+    name: str
+    type: str | None = None
+    message_list_visibility: str | None = None
+    label_list_visibility: str | None = None
+    messages_total: int | None = None
+    messages_unread: int | None = None
+    threads_total: int | None = None
+    threads_unread: int | None = None
+    color: dict[str, str | None] | None = None
+
+
+class HistoryEventRow(CtxModel):
+    id: HistoryId
+    messages: list[dict[str, Any]] = Field(default_factory=list)
+    messages_added: list[dict[str, Any]] = Field(default_factory=list)
+    messages_deleted: list[dict[str, Any]] = Field(default_factory=list)
+    labels_added: list[dict[str, Any]] = Field(default_factory=list)
+    labels_removed: list[dict[str, Any]] = Field(default_factory=list)
+
+
+class MessageRow(CtxModel):
+    id: MessageId
+    thread_id: ThreadId
+    label_ids: list[str] = Field(default_factory=list)
+    snippet: str | None = None
+    history_id: HistoryId
+    internal_date: NonNegativeInt | None = None
+    size_estimate: NonNegativeInt | None = None
+    subject: str | None = None
+    from_address: str | None = None
+    to_addresses: str | None = None
+    cc_addresses: str | None = None
+    bcc_addresses: str | None = None
+    reply_to: str | None = None
+    message_id_header: str | None = None
+    in_reply_to: str | None = None
+    references_header: str | None = None
+    date: AwareDatetime | None = None
+    body_text: str | None = None
+    body_html: str | None = None
+    mime_type: str | None = None
+    classification_label_values: list[dict[str, Any]] = Field(default_factory=list)
+    attachment_count: NonNegativeInt = 0
+    attachments: list[dict[str, Any]] = Field(default_factory=list)
+
+
+class AttachmentRow(CtxModel):
+    message_id: MessageId
+    part_id: IdStr
+    attachment_id: str | None = None
+    filename: str | None = None
+    mime_type: str | None = None
+    size: NonNegativeInt | None = None
+    content_disposition: str | None = None
+    content_id: str | None = None
+    file_path: str
+
+
+MESSAGES_COLUMNS: dict[str, dict[str, str]] = {
+    "label_ids": {"data_type": "json"},
+    "id": {"description": "Gmail message ID. Primary key with _ctx_binding_id."},
+    "thread_id": {
+        "description": "Gmail thread ID. Group by this to get full conversations."
+    },
+    "snippet": {
+        "description": "Short plain-text preview (~200 chars). Use this instead of body_text for scanning/filtering."
+    },
+    "body_text": {
+        "description": "Full plain-text body including quoted reply chains. Replies contain all prior messages — use LEFT(body_text, N) and LIMIT. For reply-only content, look for 'On ... wrote:' or '___' separator markers."
+    },
+    "body_html": {
+        "description": 'Full HTML body. Quoted content is wrapped in <div class="gmail_quote"> or <blockquote>.'
+    },
+    "from_address": {
+        "description": "Sender as 'Display Name <email>' or bare email. Same person may appear with different display names or addresses."
+    },
+    "date": {"description": "Message date as timestamptz. Some spam has NULL dates."},
+    "subject": {
+        "description": "Subject line. Calendar invitations appear as 'Accepted:', 'Updated invitation:', etc."
+    },
+}
+
+
+MessageRowProjectionBase = partialize(
+    MessageRow,
+    name="MessageRowProjectionBase",
+)
+
+
+class AttachmentCandidateProjection(MessageRowProjectionBase):
+    id: MessageId
+    attachment_count: NonNegativeInt
+    attachments: list[GmailAttachmentIngress]
+    existing_attachment_count: NonNegativeInt = 0
+
+    @property
+    def message_id(self) -> str:
+        return self.id
+
+    @field_validator("attachment_count", "existing_attachment_count", mode="before")
+    @classmethod
+    def _validate_required_non_negative_int(cls, value: object) -> int:
+        return require_non_negative_int(value)
+
+    @field_validator("attachments", mode="before")
+    @classmethod
+    def _coerce_attachments(cls, value: object) -> object:
+        loaded = load_json_value(value)
+        if not isinstance(loaded, list):
+            raise ValueError("must be a JSON array of attachment metadata")
+        return loaded

plugin_gmail/models/ingress.py

@@ -0,0 +1,185 @@
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import Field
+from pydantic.types import NonNegativeInt as CoercedNonNegativeInt
+from shared_plugins.models import IngressModel
+
+from .types import LabelId, MessageId, NonNegativeInt, ThreadId
+
+
+class GmailMessagePartHeaderIngress(IngressModel):
+    name: str
+    value: str
+
+
+class GmailMessagePartBodyIngress(IngressModel):
+    attachment_id: str | None = Field(default=None, alias="attachmentId")
+    size: NonNegativeInt | None = None
+    data: str | None = None
+
+
+class GmailMessagePartIngress(IngressModel):
+    part_id: str | None = Field(default=None, alias="partId")
+    mime_type: str | None = Field(default=None, alias="mimeType")
+    filename: str | None = None
+    headers: list[GmailMessagePartHeaderIngress] = Field(default_factory=list)
+    body: GmailMessagePartBodyIngress | None = None
+    parts: list["GmailMessagePartIngress"] = Field(default_factory=list)
+
+
+class GmailAttachmentIngress(IngressModel):
+    part_id: str = Field(min_length=1)
+    attachment_id: str | None = None
+    inline_data_b64url: str | None = None
+    filename: str | None = None
+    mime_type: str | None = None
+    size: NonNegativeInt | None = None
+    content_disposition: str | None = None
+    content_id: str | None = None
+
+
+class _GmailMessageIngressBase(IngressModel):
+    id: MessageId
+    label_ids: list[LabelId] = Field(default_factory=list, alias="labelIds")
+    snippet: str | None = None
+    history_id: CoercedNonNegativeInt | None = Field(default=None, alias="historyId")
+    internal_date: CoercedNonNegativeInt | None = Field(
+        default=None, alias="internalDate"
+    )
+    payload: GmailMessagePartIngress | None = None
+    size_estimate: NonNegativeInt | None = Field(default=None, alias="sizeEstimate")
+    classification_label_values: list[dict[str, Any]] = Field(
+        default_factory=list,
+        alias="classificationLabelValues",
+    )
+    raw: str | None = None
+
+
+class GmailMessageIngress(_GmailMessageIngressBase):
+    history_id: CoercedNonNegativeInt = Field(alias="historyId")
+    thread_id: ThreadId = Field(alias="threadId")
+
+
+class GmailMessageAttachmentIngress(IngressModel):
+    attachment_id: str = Field(min_length=1, alias="attachmentId")
+    size: NonNegativeInt | None = None
+    data: str | None = None
+
+
+class GmailHistoryMessageIngress(_GmailMessageIngressBase):
+    thread_id: ThreadId | None = Field(default=None, alias="threadId")
+
+
+class GmailThreadIngress(IngressModel):
+    id: ThreadId
+    history_id: CoercedNonNegativeInt = Field(alias="historyId")
+    snippet: str | None = None
+    messages: list[GmailMessageIngress] = Field(default_factory=list)
+
+
+class GmailThreadListItemIngress(IngressModel):
+    id: ThreadId
+    history_id: CoercedNonNegativeInt = Field(alias="historyId")
+    snippet: str | None = None
+
+
+class GmailLabelColorIngress(IngressModel):
+    text_color: str | None = Field(default=None, alias="textColor")
+    background_color: str | None = Field(default=None, alias="backgroundColor")
+
+
+class GmailLabelIngress(IngressModel):
+    id: LabelId
+    name: str
+    type: str | None = None
+    message_list_visibility: str | None = Field(
+        default=None,
+        alias="messageListVisibility",
+    )
+    label_list_visibility: str | None = Field(default=None, alias="labelListVisibility")
+    messages_total: NonNegativeInt | None = Field(default=None, alias="messagesTotal")
+    messages_unread: NonNegativeInt | None = Field(default=None, alias="messagesUnread")
+    threads_total: NonNegativeInt | None = Field(default=None, alias="threadsTotal")
+    threads_unread: NonNegativeInt | None = Field(default=None, alias="threadsUnread")
+    color: GmailLabelColorIngress | None = None
+
+
+class GmailProfileIngress(IngressModel):
+    email_address: str = Field(alias="emailAddress")
+    messages_total: NonNegativeInt | None = Field(default=None, alias="messagesTotal")
+    threads_total: NonNegativeInt | None = Field(default=None, alias="threadsTotal")
+    history_id: CoercedNonNegativeInt = Field(alias="historyId")
+
+
+class GmailHistoryMessageAddedIngress(IngressModel):
+    message: GmailHistoryMessageIngress
+
+
+class GmailHistoryMessageDeletedIngress(IngressModel):
+    message: GmailHistoryMessageIngress
+
+
+class GmailHistoryLabelAddedIngress(IngressModel):
+    message: GmailHistoryMessageIngress
+    label_ids: list[LabelId] = Field(default_factory=list, alias="labelIds")
+
+
+class GmailHistoryLabelRemovedIngress(IngressModel):
+    message: GmailHistoryMessageIngress
+    label_ids: list[LabelId] = Field(default_factory=list, alias="labelIds")
+
+
+class GmailHistoryRecordIngress(IngressModel):
+    id: CoercedNonNegativeInt
+    messages: list[GmailHistoryMessageIngress] = Field(default_factory=list)
+    messages_added: list[GmailHistoryMessageAddedIngress] = Field(
+        default_factory=list,
+        alias="messagesAdded",
+    )
+    messages_deleted: list[GmailHistoryMessageDeletedIngress] = Field(
+        default_factory=list,
+        alias="messagesDeleted",
+    )
+    labels_added: list[GmailHistoryLabelAddedIngress] = Field(
+        default_factory=list,
+        alias="labelsAdded",
+    )
+    labels_removed: list[GmailHistoryLabelRemovedIngress] = Field(
+        default_factory=list,
+        alias="labelsRemoved",
+    )
+
+
+class GmailMessagesListItemIngress(IngressModel):
+    id: MessageId
+    thread_id: ThreadId | None = Field(default=None, alias="threadId")
+
+
+class GmailMessagesListResponseIngress(IngressModel):
+    messages: list[GmailMessagesListItemIngress] = Field(default_factory=list)
+    next_page_token: str | None = Field(default=None, alias="nextPageToken")
+    result_size_estimate: NonNegativeInt | None = Field(
+        default=None,
+        alias="resultSizeEstimate",
+    )
+
+
+class GmailThreadsListResponseIngress(IngressModel):
+    threads: list[GmailThreadListItemIngress] = Field(default_factory=list)
+    next_page_token: str | None = Field(default=None, alias="nextPageToken")
+    result_size_estimate: NonNegativeInt | None = Field(
+        default=None,
+        alias="resultSizeEstimate",
+    )
+
+
+class GmailLabelsListResponseIngress(IngressModel):
+    labels: list[GmailLabelIngress] = Field(default_factory=list)
+
+
+class GmailHistoryListResponseIngress(IngressModel):
+    history: list[GmailHistoryRecordIngress] = Field(default_factory=list)
+    next_page_token: str | None = Field(default=None, alias="nextPageToken")
+    history_id: CoercedNonNegativeInt = Field(alias="historyId")