zele 0.3.16 → 0.3.20

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,74 @@ bun install -g zele
 
 ## Setup
 
+### Google accounts
+
 ```bash
 zele login
 ```
 
 Opens a browser for Google OAuth2. Repeat to add more accounts.
 
+#### Remote / headless login (for agents)
+
+`zele login` is interactive — it prints an authorization URL and waits for the redirect URL to be pasted back. In agent or headless environments, run it inside a `tmux` session so the process persists and can be driven programmatically:
+
 ```bash
-zele whoami         # show authenticated accounts
+# start login in a tmux session
+tmux new-session -d -s zele-login 'zele login'
+
+# read the authorization URL from tmux output
+tmux capture-pane -t zele-login -p
+
+# after the user completes consent in their browser, paste the redirect URL
+tmux send-keys -t zele-login 'http://localhost:...?code=...' Enter
+
+# verify login succeeded
+tmux capture-pane -t zele-login -p
+tmux kill-session -t zele-login
+```
+
+IMAP/SMTP login is non-interactive and requires no tmux wrapper.
+
+### 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 (type, capabilities)
 zele logout         # remove credentials
 ```
 
@@ -66,46 +126,59 @@ zele mail label <thread-id>
 zele mail trash-spam
 ```
 
-### Search query syntax
+All action commands accept **one or more thread IDs** and an optional `--account` flag. On Google accounts, archiving removes the `INBOX` label. On IMAP accounts, it moves the message to the server's Archive folder (`Archive`, `Archives`, `All Mail`, `[Gmail]/All Mail`, or `INBOX.Archive`).
+
+```bash
+# archive a single thread
+zele mail archive 18f3b7c9d2a1e4f0
 
-`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.
+# archive multiple threads at once
+zele mail archive 18f3b7c9d2a1e4f0 18f3b7c9d2a1e4f1 18f3b7c9d2a1e4f2
 
-| 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:
+# archive from a specific account when you have multiple
+zele mail archive 18f3b7c9d2a1e4f0 --account you@example.com
+
+# bulk archive: pipe thread IDs from a search
+zele mail search "from:noreply@github.com older_than:7d" \
+  | yq '.[].id' \
+  | xargs zele mail archive
+
+# list archived threads later
+zele mail list --filter "in:archive"
+```
+
+### Search query syntax
+
+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 +188,7 @@ zele draft send <draft-id>
 zele draft delete <draft-id>
 ```
 
-### Labels
+### Labels (Google only)
 
 ```bash
 zele label list
@@ -124,7 +197,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,10 +251,50 @@ 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.
 
+## For AI agents
+
+**Always run `zele --help` first.** The top-level help already contains every subcommand, option, and flag — there is no need to run `zele <command> --help` separately. The help output is the source of truth. Read it in full — never pipe through `head`, `tail`, or `sed` to truncate.
+
+**Never use the TUI.** Running `zele` with no subcommand launches a human-facing terminal UI for browsing email. Agents must use the CLI subcommands (`zele mail list`, `zele cal events`, etc.) which output structured YAML that can be parsed and piped.
+
+**Always run `zele whoami` before account-scoped commands.** When the user asks to check email "for a specific account" (e.g. "my work email", "my personal Gmail"), run `zele whoami` first to list connected accounts and find the exact address to pass to `--account`. Never guess the email — pick it from the `whoami` output. The output also shows account type (`google` or `imap_smtp`) and capabilities so you know which features are available.
+
+```bash
+# list connected accounts first
+zele whoami
+
+# then scope commands to the right account
+zele mail list --account user@work.com
+```
+
+**Prefer YAML parsing over regex.** Pipe command output through `yq` to extract IDs and fields reliably:
+
+```bash
+zele mail list --filter "is:unread" | yq '.[].id' | xargs zele mail archive
+```
+
 ## License
 
 ISC

package/dist/api-utils.d.ts

@@ -46,6 +46,20 @@ 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 {
+}
+declare const UnsubscribeUnavailableError_base: errore.FactoryTaggedErrorClass<"UnsubscribeUnavailableError", "No List-Unsubscribe header on thread $threadId", Error>;
+/** Returned when a thread has no List-Unsubscribe header (RFC 2369) so no
+ *  standardized unsubscribe mechanism is available. */
+export declare class UnsubscribeUnavailableError extends UnsubscribeUnavailableError_base {
+}
+declare const UnsubscribeFailedError_base: errore.FactoryTaggedErrorClass<"UnsubscribeFailedError", "Unsubscribe via $mechanism failed: $reason", Error>;
+/** Returned when the unsubscribe attempt itself failed (HTTP error, SMTP
+ *  send failure, redirect returned when RFC 8058 forbids it, etc.). */
+export declare class UnsubscribeFailedError extends UnsubscribeFailedError_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,26 @@ 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',
+}) {
+}
+/** Returned when a thread has no List-Unsubscribe header (RFC 2369) so no
+ *  standardized unsubscribe mechanism is available. */
+export class UnsubscribeUnavailableError extends errore.createTaggedError({
+    name: 'UnsubscribeUnavailableError',
+    message: 'No List-Unsubscribe header on thread $threadId',
+}) {
+}
+/** Returned when the unsubscribe attempt itself failed (HTTP error, SMTP
+ *  send failure, redirect returned when RFC 8058 forbids it, etc.). */
+export class UnsubscribeFailedError extends errore.createTaggedError({
+    name: 'UnsubscribeFailedError',
+    message: 'Unsubscribe via $mechanism failed: $reason',
+}) {
+}
 /** 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":"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"}

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[]>;