GenerationID identifies one index generation.

ViewType represents the type of aggregate view.

Status represents the state of a deletion batch.

MessageID represents a message reference from list operations.

Mode selects which signal(s) the engine runs.

Method represents how messages are deleted.

AttachmentInfo represents attachment metadata in API responses.

MessageSortField represents the field to sort messages by.

Operation represents a Gmail API operation with its quota cost.

SortField represents the field to sort aggregates by.

TimeGranularity represents the time grouping level.

Track the context received by the command

API defines the interface for Gmail operations. This interface enables mocking for tests without hitting the real API.

APIAttachment represents attachment metadata for API responses.

APIMessage represents a message for API responses.

AccountIdentity is one confirmed "me" address for one source.

AccountInfo represents an account in list responses.

AccountInfo describes an Apple Mail account resolved from Accounts4.sqlite.

AccountInfo represents a source account.

AccountInfo represents an account in list responses.

AccountReader provides read access to account-level Gmail data.

AccountSchedule defines sync schedule for a single account.

AccountStatus represents the sync status of a scheduled account.

ActionController handles business logic for actions like deletion and export, keeping domain operations out of the TUI Model.

AddAccountRequest represents a request to add an account to the config.

Address represents an email address with optional display name.

Address represents an email address with optional display name.

AggregateOptions configures an aggregate query.

============================================================================ TUI Aggregate Endpoints =================================================

AggregateRow represents a single row in an aggregate view. Used for Senders, Recipients, Domains, Labels, and Time views.

AggregateRowJSON represents a single aggregate row in JSON format.

ArchiveEntry describes a single entry in a tar.gz archive for testing.

Attachment represents a single file referenced by a message.

Attachment represents a MIME attachment for the builder.

Attachment represents a file attachment or inline part.

AttachmentEntry holds metadata and content for a PST attachment.

AttachmentFixture defines an attachment row for Parquet test data.

AttachmentInfo represents attachment metadata.

AuthMethod specifies how the IMAP client authenticates.

Backend is the minimum contract a vector store must implement.

Backend implements vector.Backend against a PostgreSQL database with the pgvector extension. The same *sql.DB also serves the main msgvault schema (me

Backend is a placeholder type so non-pgvector builds can compile against the same package surface. Methods exist only to satisfy the vector.Backend in

Backend implements vector.Backend and vector.FusingBackend against a SQLite database with the sqlite-vec extension.

Backend is the stub backend type for builds without sqlite_vec. It implements vector.Backend so that files tagged (sqlite_vec || pgvector) compile cle

BuildingSummary reports progress for an in-flight rebuild.

CLIDeletionProgress reports deletion progress to the terminal.

CLIProgress implements gmail.SyncProgressWithDate for terminal output.

CORSConfig holds CORS configuration.

ChatConfig holds chat/LLM configuration.

Checkpoint represents sync progress for resumption.

Chunk is a pre-computed embedding to persist in the index. A long message produces multiple chunks distinguished by ChunkIndex (0-based, dense, gap-fr

ChunkSpan describes one window into the preprocessed source text. CharStart / CharEnd are rune offsets (not byte offsets) into the input string passed

Client implements the Gmail API interface.

Client calls an OpenAI-compatible /v1/embeddings endpoint.

Client implements gmail.API for IMAP servers.

Client reads from macOS's iMessage chat.db and imports messages directly into the msgvault store.

Client reads from a Google Voice Takeout export and imports messages into the msgvault store.

ClientOption configures a Client.

ClientOption configures a Client.

ClientOption configures a Client.

Clock abstracts time operations for testability.

Collection is a named grouping of sources that should be treated as a single logical archive.

CollectionWithSources bundles a Collection with its member source IDs and a message-count aggregate.

ColumnMigration is a single ALTER TABLE ADD COLUMN statement used by SQLiteDialect.LegacyColumnMigrations to evolve older SQLite databases.

Config holds configuration for creating a remote store.

Config controls the dedup engine behaviour.

Config is the top-level vector-search configuration, loaded from the [vector] TOML table.

Config captures engine tuning knobs.

Config controls an embeddings Client. The zero value is not usable; callers must set Endpoint, Model, and Dimension at a minimum.

Config holds connection settings for an IMAP server.

ConfirmMode selects the prompt and validation for confirmDestructive.

Contact is a single parsed vCard entry.

ContentHashCandidate holds message metadata for raw-MIME hash scans.

ControllerTestEnv encapsulates common setup for ActionController tests.

ConversationFixture defines a conversation row for Parquet test data.

ConversationOpts configures a conversation to insert.

ConversationRow represents a conversation in the Conversations view.

CopyResult holds the summary of a subset copy operation.

DataConfig holds data storage configuration.

DeletionCall represents a single API call for sequence tracking.

DeletionContext bundles the parameters needed for staging deletions.

DeletionMockAPI is a mock Gmail API specifically designed for testing deletion scenarios with comprehensive error injection and call tracking.

Dialect abstracts database-specific SQL generation and behavior. Implementations exist for SQLite (default) and PostgreSQL (opt-in).

Dialect abstracts SQL generation differences for SQLite vs PostgreSQL.

DirExportResult contains the results of exporting attachments to a directory.