@diskd-ai/email-client-mcp 0.1.0

package/dist/config/schema.d.ts

@@ -0,0 +1,512 @@
+/**
+ * Zod schemas for the TOML config file mounted at
+ * `/home/mcp/.config/email-client-mcp/config.toml` by the assembler
+ * (or wherever `EMAIL_CLIENT_MCP_CONFIG` points).
+ *
+ * Mirrors the per-account shape used by `diskd-ai/email-mcp` so the same
+ * vault accounts can serve both servers; adds [sdk] and [watcher]
+ * sections specific to this server.
+ */
+import { z } from "zod";
+declare const passwordAccountSchema: z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    full_name: z.ZodOptional<z.ZodString>;
+    password: z.ZodString;
+    imap: z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+        tls: z.ZodDefault<z.ZodBoolean>;
+        verify_ssl: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        host: string;
+        port: number;
+        tls: boolean;
+        verify_ssl: boolean;
+    }, {
+        host: string;
+        port: number;
+        tls?: boolean | undefined;
+        verify_ssl?: boolean | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    email: string;
+    password: string;
+    imap: {
+        host: string;
+        port: number;
+        tls: boolean;
+        verify_ssl: boolean;
+    };
+    username?: string | undefined;
+    full_name?: string | undefined;
+}, {
+    name: string;
+    email: string;
+    password: string;
+    imap: {
+        host: string;
+        port: number;
+        tls?: boolean | undefined;
+        verify_ssl?: boolean | undefined;
+    };
+    username?: string | undefined;
+    full_name?: string | undefined;
+}>;
+declare const oauthAccountSchema: z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+    full_name: z.ZodOptional<z.ZodString>;
+    oauth2: z.ZodObject<{
+        provider: z.ZodString;
+        client_id: z.ZodString;
+        client_secret: z.ZodString;
+        refresh_token: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        provider: string;
+        client_id: string;
+        client_secret: string;
+        refresh_token: string;
+    }, {
+        provider: string;
+        client_id: string;
+        client_secret: string;
+        refresh_token: string;
+    }>;
+    imap: z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+        tls: z.ZodDefault<z.ZodBoolean>;
+        verify_ssl: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        host: string;
+        port: number;
+        tls: boolean;
+        verify_ssl: boolean;
+    }, {
+        host: string;
+        port: number;
+        tls?: boolean | undefined;
+        verify_ssl?: boolean | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    email: string;
+    imap: {
+        host: string;
+        port: number;
+        tls: boolean;
+        verify_ssl: boolean;
+    };
+    oauth2: {
+        provider: string;
+        client_id: string;
+        client_secret: string;
+        refresh_token: string;
+    };
+    full_name?: string | undefined;
+}, {
+    name: string;
+    email: string;
+    imap: {
+        host: string;
+        port: number;
+        tls?: boolean | undefined;
+        verify_ssl?: boolean | undefined;
+    };
+    oauth2: {
+        provider: string;
+        client_id: string;
+        client_secret: string;
+        refresh_token: string;
+    };
+    full_name?: string | undefined;
+}>;
+export declare const accountSchema: z.ZodUnion<[z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    full_name: z.ZodOptional<z.ZodString>;
+    password: z.ZodString;
+    imap: z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+        tls: z.ZodDefault<z.ZodBoolean>;
+        verify_ssl: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        host: string;
+        port: number;
+        tls: boolean;
+        verify_ssl: boolean;
+    }, {
+        host: string;
+        port: number;
+        tls?: boolean | undefined;
+        verify_ssl?: boolean | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    email: string;
+    password: string;
+    imap: {
+        host: string;
+        port: number;
+        tls: boolean;
+        verify_ssl: boolean;
+    };
+    username?: string | undefined;
+    full_name?: string | undefined;
+}, {
+    name: string;
+    email: string;
+    password: string;
+    imap: {
+        host: string;
+        port: number;
+        tls?: boolean | undefined;
+        verify_ssl?: boolean | undefined;
+    };
+    username?: string | undefined;
+    full_name?: string | undefined;
+}>, z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+    full_name: z.ZodOptional<z.ZodString>;
+    oauth2: z.ZodObject<{
+        provider: z.ZodString;
+        client_id: z.ZodString;
+        client_secret: z.ZodString;
+        refresh_token: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        provider: string;
+        client_id: string;
+        client_secret: string;
+        refresh_token: string;
+    }, {
+        provider: string;
+        client_id: string;
+        client_secret: string;
+        refresh_token: string;
+    }>;
+    imap: z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+        tls: z.ZodDefault<z.ZodBoolean>;
+        verify_ssl: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        host: string;
+        port: number;
+        tls: boolean;
+        verify_ssl: boolean;
+    }, {
+        host: string;
+        port: number;
+        tls?: boolean | undefined;
+        verify_ssl?: boolean | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    email: string;
+    imap: {
+        host: string;
+        port: number;
+        tls: boolean;
+        verify_ssl: boolean;
+    };
+    oauth2: {
+        provider: string;
+        client_id: string;
+        client_secret: string;
+        refresh_token: string;
+    };
+    full_name?: string | undefined;
+}, {
+    name: string;
+    email: string;
+    imap: {
+        host: string;
+        port: number;
+        tls?: boolean | undefined;
+        verify_ssl?: boolean | undefined;
+    };
+    oauth2: {
+        provider: string;
+        client_id: string;
+        client_secret: string;
+        refresh_token: string;
+    };
+    full_name?: string | undefined;
+}>]>;
+export type Account = z.infer<typeof accountSchema>;
+export type PasswordAccount = z.infer<typeof passwordAccountSchema>;
+export type OAuthAccount = z.infer<typeof oauthAccountSchema>;
+export declare const isOAuthAccount: (a: Account) => a is OAuthAccount;
+declare const watcherSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    interval_ms: z.ZodDefault<z.ZodNumber>;
+    folders: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    flag_reconcile_window: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    interval_ms: number;
+    flag_reconcile_window: number;
+    folders?: string[] | undefined;
+}, {
+    enabled?: boolean | undefined;
+    interval_ms?: number | undefined;
+    folders?: string[] | undefined;
+    flag_reconcile_window?: number | undefined;
+}>;
+declare const sdkSchema: z.ZodObject<{
+    api_key: z.ZodString;
+    base_url: z.ZodOptional<z.ZodString>;
+    workspace_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    api_key: string;
+    base_url?: string | undefined;
+    workspace_id?: string | undefined;
+}, {
+    api_key: string;
+    base_url?: string | undefined;
+    workspace_id?: string | undefined;
+}>;
+export declare const configSchema: z.ZodObject<{
+    accounts: z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+        username: z.ZodOptional<z.ZodString>;
+        full_name: z.ZodOptional<z.ZodString>;
+        password: z.ZodString;
+        imap: z.ZodObject<{
+            host: z.ZodString;
+            port: z.ZodNumber;
+            tls: z.ZodDefault<z.ZodBoolean>;
+            verify_ssl: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            host: string;
+            port: number;
+            tls: boolean;
+            verify_ssl: boolean;
+        }, {
+            host: string;
+            port: number;
+            tls?: boolean | undefined;
+            verify_ssl?: boolean | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        email: string;
+        password: string;
+        imap: {
+            host: string;
+            port: number;
+            tls: boolean;
+            verify_ssl: boolean;
+        };
+        username?: string | undefined;
+        full_name?: string | undefined;
+    }, {
+        name: string;
+        email: string;
+        password: string;
+        imap: {
+            host: string;
+            port: number;
+            tls?: boolean | undefined;
+            verify_ssl?: boolean | undefined;
+        };
+        username?: string | undefined;
+        full_name?: string | undefined;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+        full_name: z.ZodOptional<z.ZodString>;
+        oauth2: z.ZodObject<{
+            provider: z.ZodString;
+            client_id: z.ZodString;
+            client_secret: z.ZodString;
+            refresh_token: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            provider: string;
+            client_id: string;
+            client_secret: string;
+            refresh_token: string;
+        }, {
+            provider: string;
+            client_id: string;
+            client_secret: string;
+            refresh_token: string;
+        }>;
+        imap: z.ZodObject<{
+            host: z.ZodString;
+            port: z.ZodNumber;
+            tls: z.ZodDefault<z.ZodBoolean>;
+            verify_ssl: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            host: string;
+            port: number;
+            tls: boolean;
+            verify_ssl: boolean;
+        }, {
+            host: string;
+            port: number;
+            tls?: boolean | undefined;
+            verify_ssl?: boolean | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        email: string;
+        imap: {
+            host: string;
+            port: number;
+            tls: boolean;
+            verify_ssl: boolean;
+        };
+        oauth2: {
+            provider: string;
+            client_id: string;
+            client_secret: string;
+            refresh_token: string;
+        };
+        full_name?: string | undefined;
+    }, {
+        name: string;
+        email: string;
+        imap: {
+            host: string;
+            port: number;
+            tls?: boolean | undefined;
+            verify_ssl?: boolean | undefined;
+        };
+        oauth2: {
+            provider: string;
+            client_id: string;
+            client_secret: string;
+            refresh_token: string;
+        };
+        full_name?: string | undefined;
+    }>]>, "many">;
+    sdk: z.ZodObject<{
+        api_key: z.ZodString;
+        base_url: z.ZodOptional<z.ZodString>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        api_key: string;
+        base_url?: string | undefined;
+        workspace_id?: string | undefined;
+    }, {
+        api_key: string;
+        base_url?: string | undefined;
+        workspace_id?: string | undefined;
+    }>;
+    watcher: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        interval_ms: z.ZodDefault<z.ZodNumber>;
+        folders: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        flag_reconcile_window: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        interval_ms: number;
+        flag_reconcile_window: number;
+        folders?: string[] | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        interval_ms?: number | undefined;
+        folders?: string[] | undefined;
+        flag_reconcile_window?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    accounts: ({
+        name: string;
+        email: string;
+        password: string;
+        imap: {
+            host: string;
+            port: number;
+            tls: boolean;
+            verify_ssl: boolean;
+        };
+        username?: string | undefined;
+        full_name?: string | undefined;
+    } | {
+        name: string;
+        email: string;
+        imap: {
+            host: string;
+            port: number;
+            tls: boolean;
+            verify_ssl: boolean;
+        };
+        oauth2: {
+            provider: string;
+            client_id: string;
+            client_secret: string;
+            refresh_token: string;
+        };
+        full_name?: string | undefined;
+    })[];
+    sdk: {
+        api_key: string;
+        base_url?: string | undefined;
+        workspace_id?: string | undefined;
+    };
+    watcher: {
+        enabled: boolean;
+        interval_ms: number;
+        flag_reconcile_window: number;
+        folders?: string[] | undefined;
+    };
+}, {
+    accounts: ({
+        name: string;
+        email: string;
+        password: string;
+        imap: {
+            host: string;
+            port: number;
+            tls?: boolean | undefined;
+            verify_ssl?: boolean | undefined;
+        };
+        username?: string | undefined;
+        full_name?: string | undefined;
+    } | {
+        name: string;
+        email: string;
+        imap: {
+            host: string;
+            port: number;
+            tls?: boolean | undefined;
+            verify_ssl?: boolean | undefined;
+        };
+        oauth2: {
+            provider: string;
+            client_id: string;
+            client_secret: string;
+            refresh_token: string;
+        };
+        full_name?: string | undefined;
+    })[];
+    sdk: {
+        api_key: string;
+        base_url?: string | undefined;
+        workspace_id?: string | undefined;
+    };
+    watcher?: {
+        enabled?: boolean | undefined;
+        interval_ms?: number | undefined;
+        folders?: string[] | undefined;
+        flag_reconcile_window?: number | undefined;
+    } | undefined;
+}>;
+export type Config = z.infer<typeof configSchema>;
+export type WatcherSettings = z.infer<typeof watcherSchema>;
+export type SdkSettings = z.infer<typeof sdkSchema>;
+/**
+ * Default config search path. Overridden by `EMAIL_CLIENT_MCP_CONFIG`.
+ * Matches the MOUNT_PATH convention used by other diskd-ai assemblers
+ * but resolves the user's home dir at startup so it works locally.
+ */
+export declare const defaultConfigPath: (homeDir: string) => string;
+export {};

package/dist/config/schema.js

@@ -0,0 +1,66 @@
+/**
+ * Zod schemas for the TOML config file mounted at
+ * `/home/mcp/.config/email-client-mcp/config.toml` by the assembler
+ * (or wherever `EMAIL_CLIENT_MCP_CONFIG` points).
+ *
+ * Mirrors the per-account shape used by `diskd-ai/email-mcp` so the same
+ * vault accounts can serve both servers; adds [sdk] and [watcher]
+ * sections specific to this server.
+ */
+import { z } from "zod";
+const imapSchema = z.object({
+    host: z.string().min(1),
+    port: z.number().int().min(1).max(65535),
+    tls: z.boolean().default(true),
+    verify_ssl: z.boolean().default(false),
+});
+const passwordAccountSchema = z.object({
+    name: z.string().min(1),
+    email: z.string().min(1),
+    username: z.string().optional(),
+    full_name: z.string().optional(),
+    password: z.string().min(1),
+    imap: imapSchema,
+});
+const oauth2Schema = z.object({
+    provider: z.string().min(1),
+    client_id: z.string().min(1),
+    client_secret: z.string().min(1),
+    refresh_token: z.string().min(1),
+});
+const oauthAccountSchema = z.object({
+    name: z.string().min(1),
+    email: z.string().min(1),
+    full_name: z.string().optional(),
+    oauth2: oauth2Schema,
+    imap: imapSchema,
+});
+export const accountSchema = z.union([passwordAccountSchema, oauthAccountSchema]);
+export const isOAuthAccount = (a) => "oauth2" in a;
+const watcherSchema = z.object({
+    enabled: z.boolean().default(true),
+    interval_ms: z.number().int().min(60_000).default(60_000),
+    folders: z.array(z.string()).optional(),
+    flag_reconcile_window: z.number().int().min(0).default(500),
+});
+const sdkSchema = z.object({
+    api_key: z.string().min(1),
+    base_url: z.string().url().optional(),
+    workspace_id: z.string().optional(),
+});
+export const configSchema = z.object({
+    accounts: z.array(accountSchema).min(1),
+    sdk: sdkSchema,
+    watcher: watcherSchema.default({
+        enabled: true,
+        interval_ms: 60_000,
+        flag_reconcile_window: 500,
+    }),
+});
+/**
+ * Default config search path. Overridden by `EMAIL_CLIENT_MCP_CONFIG`.
+ * Matches the MOUNT_PATH convention used by other diskd-ai assemblers
+ * but resolves the user's home dir at startup so it works locally.
+ */
+export const defaultConfigPath = (homeDir) => `${homeDir}/.config/email-client-mcp/config.toml`;
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9B,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACvC,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,IAAI,EAAE,UAAU;CACjB,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,UAAU;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,qBAAqB,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAKlF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAU,EAAqB,EAAE,CAAC,QAAQ,IAAI,CAAC,CAAC;AAE/E,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACzD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;CAC5D,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACrC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC;QAC7B,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,MAAM;QACnB,qBAAqB,EAAE,GAAG;KAC3B,CAAC;CACH,CAAC,CAAC;AAMH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAU,EAAE,CAC3D,GAAG,OAAO,uCAAuC,CAAC"}

package/dist/domain/errors.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Typed errors used across modules. Adapters convert raw exceptions
+ * (imapflow, fetch, fs) into one of these so the domain stays pure.
+ */
+export type ConfigError = {
+    readonly kind: "ConfigError";
+    readonly message: string;
+    readonly cause?: unknown;
+};
+export type ImapError = {
+    readonly kind: "ImapError";
+    readonly accountId: string;
+    readonly message: string;
+    readonly cause?: unknown;
+};
+export type DriveError = {
+    readonly kind: "DriveError";
+    readonly message: string;
+    readonly cause?: unknown;
+};
+export type NotFoundError = {
+    readonly kind: "NotFound";
+    readonly what: string;
+};
+export type VirtualFolderRefused = {
+    readonly kind: "VirtualFolderRefused";
+    readonly mailbox: string;
+};
+export type ToolInputError = {
+    readonly kind: "ToolInputError";
+    readonly message: string;
+};
+export type AppError = ConfigError | ImapError | DriveError | NotFoundError | VirtualFolderRefused | ToolInputError;
+export declare const configError: (message: string, cause?: unknown) => ConfigError;
+export declare const imapError: (accountId: string, message: string, cause?: unknown) => ImapError;
+export declare const driveError: (message: string, cause?: unknown) => DriveError;
+export declare const notFound: (what: string) => NotFoundError;
+export declare const virtualFolderRefused: (mailbox: string) => VirtualFolderRefused;
+export declare const toolInputError: (message: string) => ToolInputError;
+export declare const errorMessage: (e: AppError) => string;

package/dist/domain/errors.js

@@ -0,0 +1,46 @@
+/**
+ * Typed errors used across modules. Adapters convert raw exceptions
+ * (imapflow, fetch, fs) into one of these so the domain stays pure.
+ */
+export const configError = (message, cause) => ({
+    kind: "ConfigError",
+    message,
+    cause,
+});
+export const imapError = (accountId, message, cause) => ({
+    kind: "ImapError",
+    accountId,
+    message,
+    cause,
+});
+export const driveError = (message, cause) => ({
+    kind: "DriveError",
+    message,
+    cause,
+});
+export const notFound = (what) => ({ kind: "NotFound", what });
+export const virtualFolderRefused = (mailbox) => ({
+    kind: "VirtualFolderRefused",
+    mailbox,
+});
+export const toolInputError = (message) => ({
+    kind: "ToolInputError",
+    message,
+});
+export const errorMessage = (e) => {
+    switch (e.kind) {
+        case "ConfigError":
+            return `config: ${e.message}`;
+        case "ImapError":
+            return `imap[${e.accountId}]: ${e.message}`;
+        case "DriveError":
+            return `drive: ${e.message}`;
+        case "NotFound":
+            return `not found: ${e.what}`;
+        case "VirtualFolderRefused":
+            return `refusing to operate on virtual mailbox: ${e.mailbox}`;
+        case "ToolInputError":
+            return `bad tool input: ${e.message}`;
+    }
+};
+//# sourceMappingURL=errors.js.map

package/dist/domain/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/domain/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiCH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAe,EAAE,KAAe,EAAe,EAAE,CAAC,CAAC;IAC7E,IAAI,EAAE,aAAa;IACnB,OAAO;IACP,KAAK;CACN,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAiB,EAAE,OAAe,EAAE,KAAe,EAAa,EAAE,CAAC,CAAC;IAC5F,IAAI,EAAE,WAAW;IACjB,SAAS;IACT,OAAO;IACP,KAAK;CACN,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,KAAe,EAAc,EAAE,CAAC,CAAC;IAC3E,IAAI,EAAE,YAAY;IAClB,OAAO;IACP,KAAK;CACN,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAiB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAAwB,EAAE,CAAC,CAAC;IAC9E,IAAI,EAAE,sBAAsB;IAC5B,OAAO;CACR,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAe,EAAkB,EAAE,CAAC,CAAC;IAClE,IAAI,EAAE,gBAAgB;IACtB,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAW,EAAU,EAAE;IAClD,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,aAAa;YAChB,OAAO,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;QAChC,KAAK,WAAW;YACd,OAAO,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9C,KAAK,YAAY;YACf,OAAO,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;QAC/B,KAAK,UAAU;YACb,OAAO,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,KAAK,sBAAsB;YACzB,OAAO,2CAA2C,CAAC,CAAC,OAAO,EAAE,CAAC;QAChE,KAAK,gBAAgB;YACnB,OAAO,mBAAmB,CAAC,CAAC,OAAO,EAAE,CAAC;IAC1C,CAAC;AACH,CAAC,CAAC"}

package/dist/domain/result.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Result + Option ADTs. Domain returns `Result<E, T>`; adapters convert
+ * thrown exceptions into typed `Err`. Mirrors the project conventions
+ * from CODING_CONVENTIONS_TYPESCRIPT.md.
+ */
+export type Result<E, T> = {
+    readonly tag: "Ok";
+    readonly value: T;
+} | {
+    readonly tag: "Err";
+    readonly error: E;
+};
+export declare const Ok: <T>(value: T) => Result<never, T>;
+export declare const Err: <E>(error: E) => Result<E, never>;
+export declare const isOk: <E, T>(r: Result<E, T>) => r is {
+    readonly tag: "Ok";
+    readonly value: T;
+};
+export declare const isErr: <E, T>(r: Result<E, T>) => r is {
+    readonly tag: "Err";
+    readonly error: E;
+};
+export type Option<T> = {
+    readonly tag: "Some";
+    readonly value: T;
+} | {
+    readonly tag: "None";
+};
+export declare const Some: <T>(value: T) => Option<T>;
+export declare const None: Option<never>;