zele 0.3.16 → 0.3.17

package/README.md

@@ -2,14 +2,14 @@
     <br/>
     <br/>
     <h3>zele</h3>
-    <p>Manage emails & calendar from your terminal. For you and your agents</p>
+    <p>Email & Calendar CLI — Gmail, IMAP/SMTP, Google Calendar. For you and your agents</p>
     <br/>
     <br/>
 </div>
 
 ## Install
 
-Multi-account Gmail and Google Calendar client with OAuth2 auth, SQLite cache, and YAML output.
+Multi-account email and calendar client supporting **Google OAuth** and **IMAP/SMTP** (Fastmail, Outlook, any provider). SQLite cache, YAML output.
 
 Requires [bun](https://bun.sh):
 
@@ -24,14 +24,53 @@ bun install -g zele
 
 ## Setup
 
+### Google accounts
+
 ```bash
 zele login
 ```
 
 Opens a browser for Google OAuth2. Repeat to add more accounts.
 
+### IMAP/SMTP accounts
+
+For non-Google providers (Fastmail, Outlook, Gmail with app passwords, any IMAP server):
+
+```bash
+# Fastmail
+zele login imap \
+  --email you@fastmail.com \
+  --imap-host imap.fastmail.com --imap-port 993 \
+  --smtp-host smtp.fastmail.com --smtp-port 465 \
+  --password "your-app-password"
+
+# Gmail (app password)
+zele login imap \
+  --email you@gmail.com \
+  --imap-host imap.gmail.com --imap-port 993 \
+  --smtp-host smtp.gmail.com --smtp-port 465 \
+  --password "your-app-password"
+
+# Outlook
+zele login imap \
+  --email you@outlook.com \
+  --imap-host outlook.office365.com --imap-port 993 \
+  --smtp-host smtp-mail.outlook.com --smtp-port 587 \
+  --password "your-password"
+
+# IMAP-only (no sending)
+zele login imap \
+  --email reader@example.com \
+  --imap-host imap.example.com --imap-port 993 \
+  --password "pass"
+```
+
+Use `--imap-user` / `--smtp-user` if the login username differs from your email. Omit `--smtp-host` for read-only access.
+
+### Account management
+
 ```bash
-zele whoami         # show authenticated accounts
+zele whoami         # show authenticated accounts (type, capabilities)
 zele logout         # remove credentials
 ```
 
@@ -68,44 +107,36 @@ zele mail trash-spam
 
 ### Search query syntax
 
-`mail search` and `mail watch --query` use [Gmail search operators](https://support.google.com/mail/answer/7190). `mail search` sends the query server-side (full Gmail support), while `mail watch --query` evaluates a subset client-side.
-
-| Operator | Example | Description |
-|---|---|---|
-| `from:` | `from:github` | Messages from a sender |
-| `to:` | `to:me@example.com` | Messages sent to a recipient |
-| `cc:` | `cc:team@example.com` | Messages where recipient was CC'd |
-| `subject:` | `subject:invoice` | Messages with words in the subject |
-| `is:unread` | `is:unread` | Unread messages |
-| `is:read` | `is:read` | Read messages |
-| `is:starred` | `is:starred` | Starred messages |
-| `has:attachment` | `has:attachment` | Messages with attachments (heuristic in watch) |
-| `-` (negate) | `-from:noreply` | Exclude matching messages |
-| `" "` (quotes) | `"exact phrase"` | Match an exact phrase |
-| `label:` | `label:work` | Messages with a specific label (search only) |
-| `in:` | `in:sent` | Messages in a folder (search only) |
-| `after:` | `after:2024/01/01` | Messages after a date (search only) |
-| `before:` | `before:2024/12/31` | Messages before a date (search only) |
-| `newer_than:` | `newer_than:7d` | Messages newer than a period (search only) |
-| `older_than:` | `older_than:1m` | Messages older than a period (search only) |
-| `filename:` | `filename:pdf` | Attachment filename (search only) |
-| `size:` / `larger:` / `smaller:` | `larger:5M` | Filter by message size (search only) |
-| `OR` | `from:a OR from:b` | Match either term (search only) |
-| `{ }` | `{from:a from:b}` | Group OR terms (search only) |
-
-Combine multiple operators to narrow results:
+For **Google accounts**, `mail search` and `mail list --filter` use [Gmail search operators](https://support.google.com/mail/answer/7190) server-side. For **IMAP accounts**, queries are translated to IMAP SEARCH criteria (a subset is supported).
+
+| Operator | Example | Google | IMAP |
+|---|---|---|---|
+| `from:` | `from:github` | yes | yes |
+| `to:` | `to:me@example.com` | yes | yes |
+| `subject:` | `subject:invoice` | yes | yes |
+| `is:unread` | `is:unread` | yes | yes |
+| `is:starred` | `is:starred` | yes | yes |
+| `has:attachment` | `has:attachment` | yes | yes |
+| `newer_than:` | `newer_than:7d` | yes | yes |
+| `older_than:` | `older_than:1m` | yes | yes |
+| `after:` | `after:2024/01/01` | yes | yes |
+| `before:` | `before:2024/12/31` | yes | yes |
+| `cc:` | `cc:team@example.com` | yes | no |
+| `-` (negate) | `-from:noreply` | yes | no |
+| `" "` (quotes) | `"exact phrase"` | yes | no |
+| `label:` | `label:work` | yes | no |
+| `in:` | `in:sent` | yes | no |
+| `filename:` | `filename:pdf` | yes | no |
+| `size:` / `larger:` / `smaller:` | `larger:5M` | yes | no |
+| `OR` / `{ }` | `from:a OR from:b` | yes | no |
 
 ```bash
 zele mail list --filter "is:unread"
-zele mail list --filter "from:github has:attachment" --folder sent
+zele mail list --filter "from:github newer_than:7d" --folder sent
 zele mail search "from:github is:unread newer_than:7d"
 zele mail watch --query "from:github has:attachment"
 ```
 
-`mail list --filter` accepts the same Gmail search operators as `mail search`, and combines with `--folder` and `--label`.
-
-Operators marked **(search only)** are handled server-side by Gmail and only available in `mail search`. Using them in `mail watch --query` prints a warning and skips the operator.
-
 ### Drafts
 
 ```bash
@@ -115,7 +146,7 @@ zele draft send <draft-id>
 zele draft delete <draft-id>
 ```
 
-### Labels
+### Labels (Google only)
 
 ```bash
 zele label list
@@ -124,7 +155,13 @@ zele label create <name>
 zele label delete <label-id>
 ```
 
-### Calendar
+### Filters (Google only)
+
+```bash
+zele mail filter list
+```
+
+### Calendar (Google only)
 
 ```bash
 zele cal list                     # list calendars
@@ -172,6 +209,24 @@ zele profile                      # show account info
 
 All commands support `--account <email>` to filter by account. Without it, commands fetch from all accounts and merge results.
 
+Google and IMAP/SMTP accounts work side by side — `mail list` merges results from both. Google-only features (labels, filters, calendar) show a helpful error when used with IMAP accounts.
+
+### Feature compatibility
+
+| Feature | Google | IMAP/SMTP |
+|---|---|---|
+| List, read, search emails | yes | yes |
+| Send, reply, forward | yes | yes (requires SMTP) |
+| Star, archive, trash, mark read | yes | yes |
+| Drafts | yes | yes |
+| Attachments | yes | yes |
+| Watch for new emails | yes | yes |
+| Date/sender/subject filters | yes | yes |
+| Labels | yes | no (IMAP uses folders) |
+| Filters | yes | no |
+| Calendar | yes | no |
+| Gmail search operators | full | subset (see table above) |
+
 ## Output
 
 All structured data is output as YAML. In TTY mode, keys are colored for readability. Pipe output to other tools for scripting.

package/dist/api-utils.d.ts

@@ -46,6 +46,10 @@ declare const ApiError_base: errore.FactoryTaggedErrorClass<"ApiError", "API cal
 /** Returned when a non-auth, non-ratelimit API call fails. */
 export declare class ApiError extends ApiError_base {
 }
+declare const UnsupportedError_base: errore.FactoryTaggedErrorClass<"UnsupportedError", "$feature is not available for $accountType accounts. $hint", Error>;
+/** Returned when a command requires a capability (e.g. gmail labels) that the account doesn't support. */
+export declare class UnsupportedError extends UnsupportedError_base {
+}
 /** Detect auth-like errors from underlying libraries (tsdav string errors, googleapis structured errors).
  *  Used inside clients to decide whether to return an AuthError.
  *  NOTE: String matching here is intentional — this is the boundary layer that converts

package/dist/api-utils.js

@@ -101,6 +101,12 @@ export class ApiError extends errore.createTaggedError({
     message: 'API call failed: $reason',
 }) {
 }
+/** Returned when a command requires a capability (e.g. gmail labels) that the account doesn't support. */
+export class UnsupportedError extends errore.createTaggedError({
+    name: 'UnsupportedError',
+    message: '$feature is not available for $accountType accounts. $hint',
+}) {
+}
 /** Detect auth-like errors from underlying libraries (tsdav string errors, googleapis structured errors).
  *  Used inside clients to decide whether to return an AuthError.
  *  NOTE: String matching here is intentional — this is the boundary layer that converts

package/dist/api-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-utils.js","sourceRoot":"","sources":["../src/api-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api-utils.js","sourceRoot":"","sources":["../src/api-utils.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,oEAAoE;AACpE,kEAAkE;AAClE,EAAE;AACF,qEAAqE;AACrE,mEAAmE;AACnE,2EAA2E;AAC3E,+CAA+C;AAE/C,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAEhC,MAAM,eAAe,GAAG,EAAE,CAAA;AAW1B;uFACuF;AACvF,MAAM,UAAU,QAAQ,CAAI,KAAQ;IAClC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAA;AACvB,CAAC;AAED;;;;sFAIsF;AACtF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAU,EACV,EAA2B,EAC3B,WAAW,GAAG,eAAe;IAE7B,MAAM,OAAO,GAAsB,EAAE,CAAA;IACrC,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,UAAU,GAAiB,IAAI,CAAA;IAEnC,KAAK,UAAU,MAAM;QACnB,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3C,MAAM,CAAC,GAAG,KAAK,EAAE,CAAA;YACjB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAA;YAClC,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;gBAC5B,UAAU,GAAG,MAAM,CAAA;gBACnB,OAAM;YACR,CAAC;YACD,OAAO,CAAC,CAAC,CAAC,GAAG,MAAyB,CAAA;QACxC,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAA;IAC3F,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAC1B,IAAI,UAAU;QAAE,OAAO,UAA6B,CAAA;IACpD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;sFACsF;AACtF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,EAAoB,EAAE,WAAW,GAAG,EAAE,EAAE,OAAO,GAAG,KAAK;IACxF,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAA;QACnB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,WAAW;gBAAE,MAAM,GAAG,CAAA;YAChE,MAAM,IAAI,GAAG,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAA;YAC/C,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAA;AAChC,CAAC;AAED,8EAA8E;AAC9E,iEAAiE;AACjE,8EAA8E;AAE9E;iFACiF;AACjF,MAAM,OAAO,SAAU,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IACtD,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,2CAA2C;CACrD,CAAC;CAAG;AAEL,gGAAgG;AAChG,MAAM,OAAO,aAAc,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IAC1D,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,qBAAqB;CAC/B,CAAC;CAAG;AAEL,6DAA6D;AAC7D,MAAM,OAAO,gBAAiB,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IAC7D,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,iCAAiC;CAC3C,CAAC;CAAG;AAEL,6EAA6E;AAC7E,MAAM,OAAO,UAAW,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IACvD,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,gCAAgC;CAC1C,CAAC;CAAG;AAEL,oFAAoF;AACpF,MAAM,OAAO,gBAAiB,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IAC7D,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,6BAA6B;CACvC,CAAC;CAAG;AAEL,2FAA2F;AAC3F,MAAM,OAAO,eAAgB,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IAC5D,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,yBAAyB;CACnC,CAAC;CAAG;AAEL,8DAA8D;AAC9D,MAAM,OAAO,QAAS,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IACrD,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,0BAA0B;CACpC,CAAC;CAAG;AAEL,0GAA0G;AAC1G,MAAM,OAAO,gBAAiB,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IAC7D,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,4DAA4D;CACtE,CAAC;CAAG;AAEL;;;6GAG6G;AAC7G,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,MAAM,CAAC,GAAG,GAAU,CAAA;IACpB,MAAM,MAAM,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAA;IAC1D,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IAC/B,IAAI,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACvD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;IACvB,OAAO,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAA;AAC7G,CAAC;AAED;8EAC8E;AAC9E,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;IACvB,OAAO,GAAG,CAAC,QAAQ,CAAC,oCAAoC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAA;AACtG,CAAC;AAGD,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,MAAM,UAAU,gBAAgB,CAAC,GAAQ;IACvC,MAAM,MAAM,GAAG,GAAG,EAAE,IAAI,IAAI,GAAG,EAAE,MAAM,IAAI,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAA;IAChE,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IAC/B,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,GAAG,EAAE,MAAM,IAAI,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE,CAAA;QACtE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAC5B;YACE,uBAAuB;YACvB,mBAAmB;YACnB,eAAe;YACf,oBAAoB;YACpB,eAAe;YACf,cAAc;SACf,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CACrB,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/auth.d.ts

@@ -1,6 +1,32 @@
 import { OAuth2Client } from 'google-auth-library';
 import { GmailClient } from './gmail-client.js';
 import { CalendarClient } from './calendar-client.js';
+import { ImapSmtpClient } from './imap-smtp-client.js';
+export type AccountType = 'google' | 'imap_smtp';
+export declare const IMAP_SMTP_APP_ID: "imap_smtp";
+export interface ImapCredentials {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    tls: boolean;
+}
+export interface SmtpCredentials {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    tls: boolean;
+}
+/** Stored in the `tokens` column for imap_smtp accounts. */
+export interface ImapSmtpCredentials {
+    imap?: ImapCredentials;
+    smtp?: SmtpCredentials;
+}
+/** Capabilities an account can have. */
+export type AccountCapability = 'gmail' | 'calendar' | 'smtp' | 'imap';
+export declare function parseCapabilities(raw: string): AccountCapability[];
+export declare function hasCapability(capabilities: string | AccountCapability[], cap: AccountCapability): boolean;
 /**
  * Create an OAuth2Client. If appId is provided, looks up the matching
  * client credentials from OAUTH_CLIENTS by client ID. Falls back to
@@ -10,6 +36,8 @@ export declare function createOAuth2Client(appId?: string): OAuth2Client;
 export interface AccountId {
     email: string;
     appId: string;
+    accountType: AccountType;
+    capabilities: AccountCapability[];
 }
 interface BrowserAuthOptions {
     openBrowser?: boolean;
@@ -25,28 +53,60 @@ export declare function login(appId?: string, options?: BrowserAuthOptions): Pro
     appId: string;
     client: GmailClient;
 } | Error>;
+export interface LoginImapOptions {
+    email: string;
+    imapHost: string;
+    imapPort?: number;
+    smtpHost?: string;
+    smtpPort?: number;
+    password?: string;
+    imapUser?: string;
+    imapPassword?: string;
+    smtpUser?: string;
+    smtpPassword?: string;
+    tls?: boolean;
+}
+/**
+ * Login with IMAP/SMTP credentials. Tests connections before saving.
+ * Returns an error value if validation or connection test fails.
+ */
+export declare function loginImap(options: LoginImapOptions): Promise<{
+    email: string;
+    appId: string;
+} | Error>;
 export declare function logout(email: string): Promise<void | Error>;
 export declare function listAccounts(): Promise<AccountId[]>;
+/** Entry returned by getClients — client is GmailClient for Google accounts, ImapSmtpClient for IMAP/SMTP. */
+export interface ClientEntry {
+    email: string;
+    appId: string;
+    accountType: AccountType;
+    capabilities: AccountCapability[];
+    client: GmailClient | ImapSmtpClient;
+}
 /**
- * Get authenticated GmailClient instances for all accounts (or filtered by email list).
+ * Get authenticated client instances for all accounts (or filtered by email list).
+ * Returns GmailClient for Google accounts and ImapSmtpClient for IMAP/SMTP accounts.
  * If no accounts are registered, throws with a helpful message.
  */
-export declare function getClients(accounts?: string[]): Promise<Array<{
-    email: string;
-    appId: string;
-    client: GmailClient;
-}>>;
+export declare function getClients(accounts?: string[]): Promise<ClientEntry[]>;
 /**
- * Get a single authenticated GmailClient. Errors if multiple accounts exist
+ * Get a single authenticated client. Errors if multiple accounts exist
  * and no --account filter was provided.
  */
-export declare function getClient(accounts?: string[]): Promise<{
+export declare function getClient(accounts?: string[]): Promise<ClientEntry>;
+/**
+ * Get a single authenticated GmailClient. Errors if account is not a Google account.
+ * Use this for commands that require Gmail-specific features.
+ */
+export declare function getGmailClient(accounts?: string[]): Promise<{
     email: string;
     appId: string;
     client: GmailClient;
 }>;
 /**
- * Get authenticated CalendarClient instances for all accounts (or filtered by email list).
+ * Get authenticated CalendarClient instances for Google accounts only.
+ * IMAP/SMTP accounts are silently skipped (calendar requires Google OAuth).
  */
 export declare function getCalendarClients(accounts?: string[]): Promise<Array<{
     email: string;
@@ -65,6 +125,8 @@ export declare function getCalendarClient(accounts?: string[]): Promise<{
 export interface AuthStatus {
     email: string;
     appId: string;
+    accountType: AccountType;
+    capabilities: AccountCapability[];
     expiresAt?: Date;
 }
 export declare function getAuthStatuses(): Promise<AuthStatus[]>;

package/dist/auth.js

@@ -15,6 +15,18 @@ import { getPrisma } from './db.js';
 import { GmailClient } from './gmail-client.js';
 import { CalendarClient } from './calendar-client.js';
 import * as errore from 'errore';
+import { AuthError, UnsupportedError } from './api-utils.js';
+import { ImapSmtpClient } from './imap-smtp-client.js';
+export const IMAP_SMTP_APP_ID = 'imap_smtp';
+export function parseCapabilities(raw) {
+    if (!raw)
+        return [];
+    return raw.split(',').map((s) => s.trim()).filter(Boolean);
+}
+export function hasCapability(capabilities, cap) {
+    const list = typeof capabilities === 'string' ? parseCapabilities(capabilities) : capabilities;
+    return list.includes(cap);
+}
 // ---------------------------------------------------------------------------
 // Known open-source Google OAuth clients (Desktop app type).
 // All support localhost + OOB redirects. All have Gmail, Calendar, Drive,
@@ -449,18 +461,21 @@ export async function login(appId, options) {
     const email = profile.emailAddress;
     // Upsert account in DB
     const prisma = await getPrisma();
+    const googleCapabilities = 'gmail,calendar,smtp';
     const upsertResult = await errore.tryAsync({
         try: () => prisma.account.upsert({
             where: { email_appId: { email, appId: resolved.clientId } },
             create: {
                 email,
                 appId: resolved.clientId,
+                accountType: 'google',
+                capabilities: googleCapabilities,
                 accountStatus: 'active',
                 tokens: JSON.stringify(tokens),
                 createdAt: new Date(),
                 updatedAt: new Date(),
             },
-            update: { tokens: JSON.stringify(tokens), updatedAt: new Date() },
+            update: { tokens: JSON.stringify(tokens), capabilities: googleCapabilities, updatedAt: new Date() },
         }),
         catch: (err) => new Error(`Failed to save account ${email}`, { cause: err }),
     });
@@ -468,6 +483,100 @@ export async function login(appId, options) {
         return upsertResult;
     return { email, appId: resolved.clientId, client };
 }
+/**
+ * Login with IMAP/SMTP credentials. Tests connections before saving.
+ * Returns an error value if validation or connection test fails.
+ */
+export async function loginImap(options) {
+    const { email, imapHost, imapPort = 993, smtpHost, smtpPort = 465, password, imapUser, imapPassword, smtpUser, smtpPassword, tls = true, } = options;
+    const imapPass = imapPassword ?? password;
+    if (!imapPass) {
+        return new Error('IMAP password is required (--password or --imap-password)');
+    }
+    const credentials = {
+        imap: {
+            host: imapHost,
+            port: imapPort,
+            user: imapUser ?? email,
+            password: imapPass,
+            tls,
+        },
+    };
+    // Test IMAP connection
+    const { ImapFlow } = await import('imapflow');
+    const testClient = new ImapFlow({
+        host: imapHost,
+        port: imapPort,
+        secure: tls,
+        auth: { user: imapUser ?? email, pass: imapPass },
+        logger: false,
+    });
+    const imapTest = await errore.tryAsync({
+        try: async () => {
+            await testClient.connect();
+            await testClient.logout();
+        },
+        catch: (err) => new AuthError({ email, reason: `IMAP connection failed: ${String(err)}` }),
+    });
+    if (imapTest instanceof Error)
+        return imapTest;
+    // Configure SMTP if provided
+    const capabilities = ['imap'];
+    if (smtpHost) {
+        const smtpPass = smtpPassword ?? password;
+        if (!smtpPass) {
+            return new Error('SMTP password is required when --smtp-host is provided (--password or --smtp-password)');
+        }
+        credentials.smtp = {
+            host: smtpHost,
+            port: smtpPort,
+            user: smtpUser ?? email,
+            password: smtpPass,
+            tls: smtpPort === 465,
+        };
+        // Test SMTP connection
+        const nodemailer = await import('nodemailer');
+        const transporter = nodemailer.default.createTransport({
+            host: smtpHost,
+            port: smtpPort,
+            secure: smtpPort === 465,
+            auth: { user: smtpUser ?? email, pass: smtpPass },
+        });
+        const smtpTest = await errore.tryAsync({
+            try: () => transporter.verify(),
+            catch: (err) => new AuthError({ email, reason: `SMTP connection failed: ${String(err)}` }),
+        });
+        if (smtpTest instanceof Error)
+            return smtpTest;
+        capabilities.push('smtp');
+    }
+    // Save to DB
+    const prisma = await getPrisma();
+    const upsertResult = await errore.tryAsync({
+        try: () => prisma.account.upsert({
+            where: { email_appId: { email, appId: IMAP_SMTP_APP_ID } },
+            create: {
+                email,
+                appId: IMAP_SMTP_APP_ID,
+                accountType: 'imap_smtp',
+                capabilities: capabilities.join(','),
+                accountStatus: 'active',
+                tokens: JSON.stringify(credentials),
+                createdAt: new Date(),
+                updatedAt: new Date(),
+            },
+            update: {
+                capabilities: capabilities.join(','),
+                tokens: JSON.stringify(credentials),
+                updatedAt: new Date(),
+            },
+        }),
+        catch: (err) => new Error(`Failed to save account ${email}`, { cause: err }),
+    });
+    if (upsertResult instanceof Error)
+        return upsertResult;
+    return { email, appId: IMAP_SMTP_APP_ID };
+}
 // ---------------------------------------------------------------------------
 // Logout: remove account from DB
 // ---------------------------------------------------------------------------
@@ -486,8 +595,13 @@ export async function logout(email) {
 // ---------------------------------------------------------------------------
 export async function listAccounts() {
     const prisma = await getPrisma();
-    const rows = await prisma.account.findMany({ select: { email: true, appId: true } });
-    return rows.map((r) => ({ email: r.email, appId: r.appId }));
+    const rows = await prisma.account.findMany({ select: { email: true, appId: true, accountType: true, capabilities: true } });
+    return rows.map((r) => ({
+        email: r.email,
+        appId: r.appId,
+        accountType: r.accountType,
+        capabilities: parseCapabilities(r.capabilities),
+    }));
 }
 // ---------------------------------------------------------------------------
 // Get authenticated clients
@@ -523,7 +637,8 @@ async function authenticateAccount(account) {
     return oauth2Client;
 }
 /**
- * Get authenticated GmailClient instances for all accounts (or filtered by email list).
+ * Get authenticated client instances for all accounts (or filtered by email list).
+ * Returns GmailClient for Google accounts and ImapSmtpClient for IMAP/SMTP accounts.
  * If no accounts are registered, throws with a helpful message.
  */
 export async function getClients(accounts) {
@@ -538,14 +653,37 @@ export async function getClients(accounts) {
         const available = allAccounts.map((a) => a.email).join(', ');
         throw new Error(`No matching accounts. Available: ${available}`);
     }
+    const prisma = await getPrisma();
     const results = await Promise.all(filtered.map(async (account) => {
+        if (account.accountType === 'imap_smtp') {
+            const row = await prisma.account.findUnique({
+                where: { email_appId: { email: account.email, appId: account.appId } },
+            });
+            if (!row)
+                throw new Error(`No account found for ${account.email}. Run: zele login`);
+            const credentials = JSON.parse(row.tokens);
+            return {
+                email: account.email,
+                appId: account.appId,
+                accountType: 'imap_smtp',
+                capabilities: account.capabilities,
+                client: new ImapSmtpClient({ credentials, account }),
+            };
+        }
+        // Google account
         const auth = await authenticateAccount(account);
-        return { email: account.email, appId: account.appId, client: new GmailClient({ auth, account }) };
+        return {
+            email: account.email,
+            appId: account.appId,
+            accountType: 'google',
+            capabilities: account.capabilities,
+            client: new GmailClient({ auth, account }),
+        };
     }));
     return results;
 }
 /**
- * Get a single authenticated GmailClient. Errors if multiple accounts exist
+ * Get a single authenticated client. Errors if multiple accounts exist
  * and no --account filter was provided.
  */
 export async function getClient(accounts) {
@@ -556,11 +694,27 @@ export async function getClient(accounts) {
     const emails = clients.map((c) => c.email).join('\n  ');
     throw new Error(`Multiple accounts matched. Specify --account:\n  ${emails}`);
 }
+/**
+ * Get a single authenticated GmailClient. Errors if account is not a Google account.
+ * Use this for commands that require Gmail-specific features.
+ */
+export async function getGmailClient(accounts) {
+    const entry = await getClient(accounts);
+    if (entry.accountType !== 'google') {
+        throw new UnsupportedError({
+            feature: 'This command',
+            accountType: 'IMAP/SMTP',
+            hint: 'It requires a Google account.',
+        });
+    }
+    return { email: entry.email, appId: entry.appId, client: entry.client };
+}
 // ---------------------------------------------------------------------------
 // Calendar client helpers
 // ---------------------------------------------------------------------------
 /**
- * Get authenticated CalendarClient instances for all accounts (or filtered by email list).
+ * Get authenticated CalendarClient instances for Google accounts only.
+ * IMAP/SMTP accounts are silently skipped (calendar requires Google OAuth).
  */
 export async function getCalendarClients(accounts) {
     const allAccounts = await listAccounts();
@@ -574,7 +728,16 @@ export async function getCalendarClients(accounts) {
         const available = allAccounts.map((a) => a.email).join(', ');
         throw new Error(`No matching accounts. Available: ${available}`);
     }
-    const results = await Promise.all(filtered.map(async (account) => {
+    // Only Google accounts support calendar
+    const googleAccounts = filtered.filter((a) => a.accountType === 'google');
+    if (googleAccounts.length === 0) {
+        throw new UnsupportedError({
+            feature: 'Calendar',
+            accountType: 'IMAP/SMTP',
+            hint: 'Calendar requires a Google account.',
+        });
+    }
+    const results = await Promise.all(googleAccounts.map(async (account) => {
         const auth = await authenticateAccount(account);
         const { token } = await auth.getAccessToken();
         if (!token)
@@ -599,11 +762,24 @@ export async function getAuthStatuses() {
     const prisma = await getPrisma();
     const rows = await prisma.account.findMany();
     return rows.map((row) => {
-        const tokens = JSON.parse(row.tokens);
+        const accountType = row.accountType;
+        const capabilities = parseCapabilities(row.capabilities);
+        if (accountType === 'google') {
+            const tokens = JSON.parse(row.tokens);
+            return {
+                email: row.email,
+                appId: row.appId,
+                accountType,
+                capabilities,
+                expiresAt: tokens.expiry_date ? new Date(tokens.expiry_date) : undefined,
+            };
+        }
+        // IMAP/SMTP — no expiry
         return {
             email: row.email,
             appId: row.appId,
-            expiresAt: tokens.expiry_date ? new Date(tokens.expiry_date) : undefined,
+            accountType,
+            capabilities,
         };
     });
 }