@agenticmail/core 0.6.0 → 0.7.0

package/dist/index.cjs

@@ -1469,7 +1469,16 @@ var DEFAULT_CONFIG = {
     port: 143
   },
   api: {
-    port: 3100,
+    // Default API port: 3829.
+    //
+    // We deliberately avoid 3000 (React/Express default), 3100 (Grafana
+    // Loki, also a common Express convention), 3200 (Grafana Tempo),
+    // 3300 (LMS-style apps), 4000/5000/8000/8080 (too common). 3829 sits
+    // in a quiet stretch — unassigned by IANA, and far enough from
+    // common dev tooling that a fresh `agenticmail setup` rarely
+    // collides. Users can override via the `AGENTICMAIL_API_PORT` env
+    // var or by editing `~/.agenticmail/config.json` after install.
+    port: 3829,
     host: "127.0.0.1"
   },
   masterKey: "",
@@ -3181,15 +3190,15 @@ function buildInboundSecurityAdvisory(security, attachments) {
 }
 
 // src/storage/db.ts
-var import_better_sqlite3 = __toESM(require("better-sqlite3"), 1);
+var import_node_sqlite = require("sqlite");
 var db = null;
 function getDatabase(config) {
   if (db) return db;
   ensureDataDir(config);
   const dbPath = `${config.dataDir}/agenticmail.db`;
-  db = new import_better_sqlite3.default(dbPath);
-  db.pragma("journal_mode = WAL");
-  db.pragma("foreign_keys = ON");
+  db = new import_node_sqlite.DatabaseSync(dbPath);
+  db.exec("PRAGMA journal_mode = WAL");
+  db.exec("PRAGMA foreign_keys = ON");
   runMigrations(db);
   return db;
 }
@@ -3199,6 +3208,19 @@ function closeDatabase() {
     db = null;
   }
 }
+function runTransactionally(database, fn) {
+  database.exec("BEGIN");
+  try {
+    fn();
+    database.exec("COMMIT");
+  } catch (err) {
+    try {
+      database.exec("ROLLBACK");
+    } catch {
+    }
+    throw err;
+  }
+}
 var MIGRATIONS = {
   "001_init.sql": `
 CREATE TABLE IF NOT EXISTS agents (
@@ -3459,19 +3481,18 @@ function runMigrations(database) {
   const applied = new Set(appliedStmt.all().map((r) => r.name));
   const insertStmt = database.prepare("INSERT INTO _migrations (name) VALUES (?)");
   const sortedMigrations = Object.entries(MIGRATIONS).sort(([a], [b]) => a.localeCompare(b));
-  const runMigration = database.transaction((name, sql) => {
-    database.exec(sql);
-    insertStmt.run(name);
-  });
   for (const [name, sql] of sortedMigrations) {
     if (applied.has(name)) continue;
-    runMigration(name, sql);
+    runTransactionally(database, () => {
+      database.exec(sql);
+      insertStmt.run(name);
+    });
   }
 }
 function createTestDatabase() {
-  const testDb = new import_better_sqlite3.default(":memory:");
-  testDb.pragma("journal_mode = WAL");
-  testDb.pragma("foreign_keys = ON");
+  const testDb = new import_node_sqlite.DatabaseSync(":memory:");
+  testDb.exec("PRAGMA journal_mode = WAL");
+  testDb.exec("PRAGMA foreign_keys = ON");
   for (const sql of Object.values(MIGRATIONS)) {
     testDb.exec(sql);
   }
@@ -7756,7 +7777,7 @@ var SetupManager = class {
       },
       smtp: { host: "localhost", port: 587 },
       imap: { host: "localhost", port: 143 },
-      api: { port: 3100, host: "127.0.0.1" },
+      api: { port: 3829, host: "127.0.0.1" },
       dataDir
     };
     (0, import_node_fs7.writeFileSync)(configPath, JSON.stringify(config, null, 2));
@@ -7767,7 +7788,7 @@ STALWART_ADMIN_PASSWORD=${stalwartPassword}
 STALWART_URL=http://localhost:8080
 
 AGENTICMAIL_MASTER_KEY=${masterKey}
-AGENTICMAIL_API_PORT=3100
+AGENTICMAIL_API_PORT=3829
 AGENTICMAIL_DATA_DIR=${dataDir}
 
 SMTP_HOST=localhost

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { EventEmitter } from 'node:events';
-import Database, { Database as Database$1 } from 'better-sqlite3';
+import { DatabaseSync } from 'node:sqlite';
 import { ImapFlow } from 'imapflow';
 
 interface SendMailOptions {
@@ -291,6 +291,50 @@ declare class StalwartAdmin {
     }): Promise<void>;
 }
 
+/**
+ * SQLite storage layer for AgenticMail.
+ *
+ * Migrated from `better-sqlite3` to Node's built-in `node:sqlite` module
+ * (stable since Node 22). The migration eliminates native compilation
+ * entirely — `better-sqlite3` ships pre-built binaries per
+ * NODE_MODULE_VERSION and intermittently lags new Node releases (Node
+ * 25.5.0 was a real example: prebuilds missing, node-gyp fails on the
+ * fallback compile-from-source path, fresh `npm install -g
+ * @agenticmail/cli` fails for users on bleeding-edge Node). `node:sqlite`
+ * is part of Node itself, so by definition it always matches the
+ * runtime — no prebuilds, no gyp, no binding errors.
+ *
+ * # API shape differences this file accommodates
+ *
+ *   - `new DatabaseSync(path)` instead of `new Database(path)`.
+ *   - No `db.pragma(x)` — use `db.exec("PRAGMA " + x)`.
+ *   - No `db.transaction(fn)` — wrap in BEGIN/COMMIT manually (see
+ *     `runTransactionally` below). Migrations are the only transaction
+ *     site in core right now; if more callers need transactions later
+ *     they should reuse the same helper.
+ *   - `stmt.run(...)` still returns `{ changes, lastInsertRowid }`.
+ *     One subtle gotcha: `lastInsertRowid` is a `bigint` in node:sqlite
+ *     where better-sqlite3 returned a `number`. Consumers that compare
+ *     with `===` or pass it to `Number(...)` need to be aware, but no
+ *     site inside AgenticMail today does that — all our rowids are
+ *     opaque or string-typed.
+ *   - The class type is `DatabaseSync`; we re-export it as `Database`
+ *     so consumer files can keep saying `Database` instead of plumbing
+ *     `DatabaseSync` through everywhere.
+ */
+
+/**
+ * Public type alias for the database instance. Consumers should
+ * `import { type Database } from '@agenticmail/core'` rather than
+ * importing from `node:sqlite` directly — this insulates them from any
+ * future swap (back to better-sqlite3, or to a remote driver) without
+ * a cascade of changes across the workspace.
+ */
+type Database = DatabaseSync;
+declare function getDatabase(config: AgenticMailConfig): Database;
+declare function closeDatabase(): void;
+declare function createTestDatabase(): Database;
+
 /** Predefined agent roles */
 type AgentRole = 'secretary' | 'assistant' | 'researcher' | 'writer' | 'custom';
 declare const AGENT_ROLES: readonly AgentRole[];
@@ -319,7 +363,7 @@ interface CreateAgentOptions {
 declare class AccountManager {
     private db;
     private stalwart;
-    constructor(db: Database.Database, stalwart: StalwartAdmin);
+    constructor(db: Database, stalwart: StalwartAdmin);
     create(options: CreateAgentOptions): Promise<Agent>;
     getById(id: string): Promise<Agent | null>;
     getByApiKey(apiKey: string): Promise<Agent | null>;
@@ -399,7 +443,7 @@ declare class AgentDeletionService {
     private db;
     private accountManager;
     private config;
-    constructor(db: Database.Database, accountManager: AccountManager, config: AgenticMailConfig);
+    constructor(db: Database, accountManager: AccountManager, config: AgenticMailConfig);
     archiveAndDelete(agentId: string, options?: ArchiveAndDeleteOptions): Promise<DeletionReport>;
     getReport(deletionId: string): DeletionReport | null;
     listReports(): DeletionSummary[];
@@ -615,10 +659,6 @@ declare function buildInboundSecurityAdvisory(security: {
     size?: number;
 }> | undefined): SecurityAdvisory;
 
-declare function getDatabase(config: AgenticMailConfig): Database.Database;
-declare function closeDatabase(): void;
-declare function createTestDatabase(): Database.Database;
-
 interface SearchableEmail {
     agentId: string;
     messageId: string;
@@ -630,7 +670,7 @@ interface SearchableEmail {
 }
 declare class EmailSearchIndex {
     private db;
-    constructor(db: Database.Database);
+    constructor(db: Database);
     index(email: SearchableEmail): void;
     search(agentId: string, query: string, limit?: number): SearchableEmail[];
     deleteByAgent(agentId: string): void;
@@ -658,7 +698,7 @@ interface DomainSetupResult {
 declare class DomainManager {
     private db;
     private stalwart;
-    constructor(db: Database.Database, stalwart: StalwartAdmin);
+    constructor(db: Database, stalwart: StalwartAdmin);
     setup(domain: string): Promise<DomainSetupResult>;
     private generateDnsRecords;
     get(domain: string): Promise<DomainInfo | null>;
@@ -1097,7 +1137,7 @@ interface LocalSmtpConfig {
     pass: string;
 }
 interface GatewayManagerOptions {
-    db: Database.Database;
+    db: Database;
     stalwart: StalwartAdmin;
     accountManager?: AccountManager;
     localSmtp?: LocalSmtpConfig;
@@ -1367,7 +1407,7 @@ declare function extractVerificationCode(smsBody: string): string | null;
 declare class SmsManager {
     private db;
     private initialized;
-    constructor(db: Database$1);
+    constructor(db: Database);
     private ensureTable;
     /** Get SMS config from agent metadata */
     getSmsConfig(agentId: string): SmsConfig | null;
@@ -1753,4 +1793,4 @@ declare class SetupManager {
     isInitialized(): boolean;
 }
 
-export { AGENT_ROLES, AccountManager, type AddressInfo, type Agent, AgentDeletionService, type AgentRole, AgenticMailClient, type AgenticMailClientOptions, type AgenticMailConfig, type ArchiveAndDeleteOptions, type ArchivedEmail, type Attachment, type AttachmentAdvisory, CloudflareClient, type CreateAgentOptions, DEFAULT_AGENT_NAME, DEFAULT_AGENT_ROLE, DNSConfigurator, type DeletionReport, type DeletionSummary, DependencyChecker, DependencyInstaller, type DependencyStatus, type DnsRecord, type DnsSetupResult, type DomainInfo, DomainManager, type DomainModeConfig, type DomainPurchaseResult, DomainPurchaser, type DomainSearchResult, type DomainSetupResult, type EmailEnvelope, type EmailRouteAction, type EmailRouteClass, type EmailRouteClassification, type EmailRouteInput, EmailSearchIndex, type FolderInfo, type GatewayConfig, GatewayManager, type GatewayManagerOptions, type GatewayMode, type GatewayStatus, type InboundEmail, type InboxEvent, type InboxExpungeEvent, type InboxFlagsEvent, type InboxNewEvent, InboxWatcher, type InboxWatcherOptions, type InstallProgress, type LinkAdvisory, type LocalSmtpConfig, MailReceiver, type MailReceiverOptions, MailSender, type MailSenderOptions, type MailboxInfo, type OutboundCategory, type OutboundScanInput, type OutboundScanResult, type OutboundWarning, type ParsedAttachment, type ParsedEmail, type ParsedSms, type PurchasedDomain, RELAY_PRESETS, RelayBridge, type RelayBridgeOptions, type RelayConfig, RelayGateway, type RelayProvider, type RelaySearchResult, SPAM_THRESHOLD, type SanitizeDetection, type SanitizeResult, type SearchCriteria, type SearchableEmail, type SecurityAdvisory, type SendMailOptions, type SendResult, type SendResultWithRaw, ServiceManager, type ServiceStatus, type SetupConfig, SetupManager, type SetupResult, type Severity, type SmsConfig, SmsManager, type SmsMessage, SmsPoller, type SpamCategory, type SpamResult, type SpamRuleMatch, StalwartAdmin, type StalwartAdminOptions, type StalwartPrincipal, type TunnelConfig, TunnelManager, WARNING_THRESHOLD, type WatcherOptions, buildInboundSecurityAdvisory, classifyEmailRoute, closeDatabase, createTestDatabase, debug, debugWarn, ensureDataDir, extractVerificationCode, flushTelemetry, getDatabase, isInternalEmail, isValidPhoneNumber, normalizePhoneNumber, parseEmail, parseGoogleVoiceSms, recordToolCall, resolveConfig, sanitizeEmail, saveConfig, scanOutboundEmail, scoreEmail, setTelemetryVersion, startRelayBridge };
+export { AGENT_ROLES, AccountManager, type AddressInfo, type Agent, AgentDeletionService, type AgentRole, AgenticMailClient, type AgenticMailClientOptions, type AgenticMailConfig, type ArchiveAndDeleteOptions, type ArchivedEmail, type Attachment, type AttachmentAdvisory, CloudflareClient, type CreateAgentOptions, DEFAULT_AGENT_NAME, DEFAULT_AGENT_ROLE, DNSConfigurator, type Database, type DeletionReport, type DeletionSummary, DependencyChecker, DependencyInstaller, type DependencyStatus, type DnsRecord, type DnsSetupResult, type DomainInfo, DomainManager, type DomainModeConfig, type DomainPurchaseResult, DomainPurchaser, type DomainSearchResult, type DomainSetupResult, type EmailEnvelope, type EmailRouteAction, type EmailRouteClass, type EmailRouteClassification, type EmailRouteInput, EmailSearchIndex, type FolderInfo, type GatewayConfig, GatewayManager, type GatewayManagerOptions, type GatewayMode, type GatewayStatus, type InboundEmail, type InboxEvent, type InboxExpungeEvent, type InboxFlagsEvent, type InboxNewEvent, InboxWatcher, type InboxWatcherOptions, type InstallProgress, type LinkAdvisory, type LocalSmtpConfig, MailReceiver, type MailReceiverOptions, MailSender, type MailSenderOptions, type MailboxInfo, type OutboundCategory, type OutboundScanInput, type OutboundScanResult, type OutboundWarning, type ParsedAttachment, type ParsedEmail, type ParsedSms, type PurchasedDomain, RELAY_PRESETS, RelayBridge, type RelayBridgeOptions, type RelayConfig, RelayGateway, type RelayProvider, type RelaySearchResult, SPAM_THRESHOLD, type SanitizeDetection, type SanitizeResult, type SearchCriteria, type SearchableEmail, type SecurityAdvisory, type SendMailOptions, type SendResult, type SendResultWithRaw, ServiceManager, type ServiceStatus, type SetupConfig, SetupManager, type SetupResult, type Severity, type SmsConfig, SmsManager, type SmsMessage, SmsPoller, type SpamCategory, type SpamResult, type SpamRuleMatch, StalwartAdmin, type StalwartAdminOptions, type StalwartPrincipal, type TunnelConfig, TunnelManager, WARNING_THRESHOLD, type WatcherOptions, buildInboundSecurityAdvisory, classifyEmailRoute, closeDatabase, createTestDatabase, debug, debugWarn, ensureDataDir, extractVerificationCode, flushTelemetry, getDatabase, isInternalEmail, isValidPhoneNumber, normalizePhoneNumber, parseEmail, parseGoogleVoiceSms, recordToolCall, resolveConfig, sanitizeEmail, saveConfig, scanOutboundEmail, scoreEmail, setTelemetryVersion, startRelayBridge };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from 'node:events';
-import Database, { Database as Database$1 } from 'better-sqlite3';
+import { DatabaseSync } from 'node:sqlite';
 import { ImapFlow } from 'imapflow';
 
 interface SendMailOptions {
@@ -291,6 +291,50 @@ declare class StalwartAdmin {
     }): Promise<void>;
 }
 
+/**
+ * SQLite storage layer for AgenticMail.
+ *
+ * Migrated from `better-sqlite3` to Node's built-in `node:sqlite` module
+ * (stable since Node 22). The migration eliminates native compilation
+ * entirely — `better-sqlite3` ships pre-built binaries per
+ * NODE_MODULE_VERSION and intermittently lags new Node releases (Node
+ * 25.5.0 was a real example: prebuilds missing, node-gyp fails on the
+ * fallback compile-from-source path, fresh `npm install -g
+ * @agenticmail/cli` fails for users on bleeding-edge Node). `node:sqlite`
+ * is part of Node itself, so by definition it always matches the
+ * runtime — no prebuilds, no gyp, no binding errors.
+ *
+ * # API shape differences this file accommodates
+ *
+ *   - `new DatabaseSync(path)` instead of `new Database(path)`.
+ *   - No `db.pragma(x)` — use `db.exec("PRAGMA " + x)`.
+ *   - No `db.transaction(fn)` — wrap in BEGIN/COMMIT manually (see
+ *     `runTransactionally` below). Migrations are the only transaction
+ *     site in core right now; if more callers need transactions later
+ *     they should reuse the same helper.
+ *   - `stmt.run(...)` still returns `{ changes, lastInsertRowid }`.
+ *     One subtle gotcha: `lastInsertRowid` is a `bigint` in node:sqlite
+ *     where better-sqlite3 returned a `number`. Consumers that compare
+ *     with `===` or pass it to `Number(...)` need to be aware, but no
+ *     site inside AgenticMail today does that — all our rowids are
+ *     opaque or string-typed.
+ *   - The class type is `DatabaseSync`; we re-export it as `Database`
+ *     so consumer files can keep saying `Database` instead of plumbing
+ *     `DatabaseSync` through everywhere.
+ */
+
+/**
+ * Public type alias for the database instance. Consumers should
+ * `import { type Database } from '@agenticmail/core'` rather than
+ * importing from `node:sqlite` directly — this insulates them from any
+ * future swap (back to better-sqlite3, or to a remote driver) without
+ * a cascade of changes across the workspace.
+ */
+type Database = DatabaseSync;
+declare function getDatabase(config: AgenticMailConfig): Database;
+declare function closeDatabase(): void;
+declare function createTestDatabase(): Database;
+
 /** Predefined agent roles */
 type AgentRole = 'secretary' | 'assistant' | 'researcher' | 'writer' | 'custom';
 declare const AGENT_ROLES: readonly AgentRole[];
@@ -319,7 +363,7 @@ interface CreateAgentOptions {
 declare class AccountManager {
     private db;
     private stalwart;
-    constructor(db: Database.Database, stalwart: StalwartAdmin);
+    constructor(db: Database, stalwart: StalwartAdmin);
     create(options: CreateAgentOptions): Promise<Agent>;
     getById(id: string): Promise<Agent | null>;
     getByApiKey(apiKey: string): Promise<Agent | null>;
@@ -399,7 +443,7 @@ declare class AgentDeletionService {
     private db;
     private accountManager;
     private config;
-    constructor(db: Database.Database, accountManager: AccountManager, config: AgenticMailConfig);
+    constructor(db: Database, accountManager: AccountManager, config: AgenticMailConfig);
     archiveAndDelete(agentId: string, options?: ArchiveAndDeleteOptions): Promise<DeletionReport>;
     getReport(deletionId: string): DeletionReport | null;
     listReports(): DeletionSummary[];
@@ -615,10 +659,6 @@ declare function buildInboundSecurityAdvisory(security: {
     size?: number;
 }> | undefined): SecurityAdvisory;
 
-declare function getDatabase(config: AgenticMailConfig): Database.Database;
-declare function closeDatabase(): void;
-declare function createTestDatabase(): Database.Database;
-
 interface SearchableEmail {
     agentId: string;
     messageId: string;
@@ -630,7 +670,7 @@ interface SearchableEmail {
 }
 declare class EmailSearchIndex {
     private db;
-    constructor(db: Database.Database);
+    constructor(db: Database);
     index(email: SearchableEmail): void;
     search(agentId: string, query: string, limit?: number): SearchableEmail[];
     deleteByAgent(agentId: string): void;
@@ -658,7 +698,7 @@ interface DomainSetupResult {
 declare class DomainManager {
     private db;
     private stalwart;
-    constructor(db: Database.Database, stalwart: StalwartAdmin);
+    constructor(db: Database, stalwart: StalwartAdmin);
     setup(domain: string): Promise<DomainSetupResult>;
     private generateDnsRecords;
     get(domain: string): Promise<DomainInfo | null>;
@@ -1097,7 +1137,7 @@ interface LocalSmtpConfig {
     pass: string;
 }
 interface GatewayManagerOptions {
-    db: Database.Database;
+    db: Database;
     stalwart: StalwartAdmin;
     accountManager?: AccountManager;
     localSmtp?: LocalSmtpConfig;
@@ -1367,7 +1407,7 @@ declare function extractVerificationCode(smsBody: string): string | null;
 declare class SmsManager {
     private db;
     private initialized;
-    constructor(db: Database$1);
+    constructor(db: Database);
     private ensureTable;
     /** Get SMS config from agent metadata */
     getSmsConfig(agentId: string): SmsConfig | null;
@@ -1753,4 +1793,4 @@ declare class SetupManager {
     isInitialized(): boolean;
 }
 
-export { AGENT_ROLES, AccountManager, type AddressInfo, type Agent, AgentDeletionService, type AgentRole, AgenticMailClient, type AgenticMailClientOptions, type AgenticMailConfig, type ArchiveAndDeleteOptions, type ArchivedEmail, type Attachment, type AttachmentAdvisory, CloudflareClient, type CreateAgentOptions, DEFAULT_AGENT_NAME, DEFAULT_AGENT_ROLE, DNSConfigurator, type DeletionReport, type DeletionSummary, DependencyChecker, DependencyInstaller, type DependencyStatus, type DnsRecord, type DnsSetupResult, type DomainInfo, DomainManager, type DomainModeConfig, type DomainPurchaseResult, DomainPurchaser, type DomainSearchResult, type DomainSetupResult, type EmailEnvelope, type EmailRouteAction, type EmailRouteClass, type EmailRouteClassification, type EmailRouteInput, EmailSearchIndex, type FolderInfo, type GatewayConfig, GatewayManager, type GatewayManagerOptions, type GatewayMode, type GatewayStatus, type InboundEmail, type InboxEvent, type InboxExpungeEvent, type InboxFlagsEvent, type InboxNewEvent, InboxWatcher, type InboxWatcherOptions, type InstallProgress, type LinkAdvisory, type LocalSmtpConfig, MailReceiver, type MailReceiverOptions, MailSender, type MailSenderOptions, type MailboxInfo, type OutboundCategory, type OutboundScanInput, type OutboundScanResult, type OutboundWarning, type ParsedAttachment, type ParsedEmail, type ParsedSms, type PurchasedDomain, RELAY_PRESETS, RelayBridge, type RelayBridgeOptions, type RelayConfig, RelayGateway, type RelayProvider, type RelaySearchResult, SPAM_THRESHOLD, type SanitizeDetection, type SanitizeResult, type SearchCriteria, type SearchableEmail, type SecurityAdvisory, type SendMailOptions, type SendResult, type SendResultWithRaw, ServiceManager, type ServiceStatus, type SetupConfig, SetupManager, type SetupResult, type Severity, type SmsConfig, SmsManager, type SmsMessage, SmsPoller, type SpamCategory, type SpamResult, type SpamRuleMatch, StalwartAdmin, type StalwartAdminOptions, type StalwartPrincipal, type TunnelConfig, TunnelManager, WARNING_THRESHOLD, type WatcherOptions, buildInboundSecurityAdvisory, classifyEmailRoute, closeDatabase, createTestDatabase, debug, debugWarn, ensureDataDir, extractVerificationCode, flushTelemetry, getDatabase, isInternalEmail, isValidPhoneNumber, normalizePhoneNumber, parseEmail, parseGoogleVoiceSms, recordToolCall, resolveConfig, sanitizeEmail, saveConfig, scanOutboundEmail, scoreEmail, setTelemetryVersion, startRelayBridge };
+export { AGENT_ROLES, AccountManager, type AddressInfo, type Agent, AgentDeletionService, type AgentRole, AgenticMailClient, type AgenticMailClientOptions, type AgenticMailConfig, type ArchiveAndDeleteOptions, type ArchivedEmail, type Attachment, type AttachmentAdvisory, CloudflareClient, type CreateAgentOptions, DEFAULT_AGENT_NAME, DEFAULT_AGENT_ROLE, DNSConfigurator, type Database, type DeletionReport, type DeletionSummary, DependencyChecker, DependencyInstaller, type DependencyStatus, type DnsRecord, type DnsSetupResult, type DomainInfo, DomainManager, type DomainModeConfig, type DomainPurchaseResult, DomainPurchaser, type DomainSearchResult, type DomainSetupResult, type EmailEnvelope, type EmailRouteAction, type EmailRouteClass, type EmailRouteClassification, type EmailRouteInput, EmailSearchIndex, type FolderInfo, type GatewayConfig, GatewayManager, type GatewayManagerOptions, type GatewayMode, type GatewayStatus, type InboundEmail, type InboxEvent, type InboxExpungeEvent, type InboxFlagsEvent, type InboxNewEvent, InboxWatcher, type InboxWatcherOptions, type InstallProgress, type LinkAdvisory, type LocalSmtpConfig, MailReceiver, type MailReceiverOptions, MailSender, type MailSenderOptions, type MailboxInfo, type OutboundCategory, type OutboundScanInput, type OutboundScanResult, type OutboundWarning, type ParsedAttachment, type ParsedEmail, type ParsedSms, type PurchasedDomain, RELAY_PRESETS, RelayBridge, type RelayBridgeOptions, type RelayConfig, RelayGateway, type RelayProvider, type RelaySearchResult, SPAM_THRESHOLD, type SanitizeDetection, type SanitizeResult, type SearchCriteria, type SearchableEmail, type SecurityAdvisory, type SendMailOptions, type SendResult, type SendResultWithRaw, ServiceManager, type ServiceStatus, type SetupConfig, SetupManager, type SetupResult, type Severity, type SmsConfig, SmsManager, type SmsMessage, SmsPoller, type SpamCategory, type SpamResult, type SpamRuleMatch, StalwartAdmin, type StalwartAdminOptions, type StalwartPrincipal, type TunnelConfig, TunnelManager, WARNING_THRESHOLD, type WatcherOptions, buildInboundSecurityAdvisory, classifyEmailRoute, closeDatabase, createTestDatabase, debug, debugWarn, ensureDataDir, extractVerificationCode, flushTelemetry, getDatabase, isInternalEmail, isValidPhoneNumber, normalizePhoneNumber, parseEmail, parseGoogleVoiceSms, recordToolCall, resolveConfig, sanitizeEmail, saveConfig, scanOutboundEmail, scoreEmail, setTelemetryVersion, startRelayBridge };

package/dist/index.js

@@ -715,7 +715,16 @@ var DEFAULT_CONFIG = {
     port: 143
   },
   api: {
-    port: 3100,
+    // Default API port: 3829.
+    //
+    // We deliberately avoid 3000 (React/Express default), 3100 (Grafana
+    // Loki, also a common Express convention), 3200 (Grafana Tempo),
+    // 3300 (LMS-style apps), 4000/5000/8000/8080 (too common). 3829 sits
+    // in a quiet stretch — unassigned by IANA, and far enough from
+    // common dev tooling that a fresh `agenticmail setup` rarely
+    // collides. Users can override via the `AGENTICMAIL_API_PORT` env
+    // var or by editing `~/.agenticmail/config.json` after install.
+    port: 3829,
     host: "127.0.0.1"
   },
   masterKey: "",
@@ -2424,15 +2433,15 @@ function buildInboundSecurityAdvisory(security, attachments) {
 }
 
 // src/storage/db.ts
-import Database from "better-sqlite3";
+import { DatabaseSync } from "sqlite";
 var db = null;
 function getDatabase(config) {
   if (db) return db;
   ensureDataDir(config);
   const dbPath = `${config.dataDir}/agenticmail.db`;
-  db = new Database(dbPath);
-  db.pragma("journal_mode = WAL");
-  db.pragma("foreign_keys = ON");
+  db = new DatabaseSync(dbPath);
+  db.exec("PRAGMA journal_mode = WAL");
+  db.exec("PRAGMA foreign_keys = ON");
   runMigrations(db);
   return db;
 }
@@ -2442,6 +2451,19 @@ function closeDatabase() {
     db = null;
   }
 }
+function runTransactionally(database, fn) {
+  database.exec("BEGIN");
+  try {
+    fn();
+    database.exec("COMMIT");
+  } catch (err) {
+    try {
+      database.exec("ROLLBACK");
+    } catch {
+    }
+    throw err;
+  }
+}
 var MIGRATIONS = {
   "001_init.sql": `
 CREATE TABLE IF NOT EXISTS agents (
@@ -2702,19 +2724,18 @@ function runMigrations(database) {
   const applied = new Set(appliedStmt.all().map((r) => r.name));
   const insertStmt = database.prepare("INSERT INTO _migrations (name) VALUES (?)");
   const sortedMigrations = Object.entries(MIGRATIONS).sort(([a], [b]) => a.localeCompare(b));
-  const runMigration = database.transaction((name, sql) => {
-    database.exec(sql);
-    insertStmt.run(name);
-  });
   for (const [name, sql] of sortedMigrations) {
     if (applied.has(name)) continue;
-    runMigration(name, sql);
+    runTransactionally(database, () => {
+      database.exec(sql);
+      insertStmt.run(name);
+    });
   }
 }
 function createTestDatabase() {
-  const testDb = new Database(":memory:");
-  testDb.pragma("journal_mode = WAL");
-  testDb.pragma("foreign_keys = ON");
+  const testDb = new DatabaseSync(":memory:");
+  testDb.exec("PRAGMA journal_mode = WAL");
+  testDb.exec("PRAGMA foreign_keys = ON");
   for (const sql of Object.values(MIGRATIONS)) {
     testDb.exec(sql);
   }
@@ -6997,7 +7018,7 @@ var SetupManager = class {
       },
       smtp: { host: "localhost", port: 587 },
       imap: { host: "localhost", port: 143 },
-      api: { port: 3100, host: "127.0.0.1" },
+      api: { port: 3829, host: "127.0.0.1" },
       dataDir
     };
     writeFileSync5(configPath, JSON.stringify(config, null, 2));
@@ -7008,7 +7029,7 @@ STALWART_ADMIN_PASSWORD=${stalwartPassword}
 STALWART_URL=http://localhost:8080
 
 AGENTICMAIL_MASTER_KEY=${masterKey}
-AGENTICMAIL_API_PORT=3100
+AGENTICMAIL_API_PORT=3829
 AGENTICMAIL_DATA_DIR=${dataDir}
 
 SMTP_HOST=localhost

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/core",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Core SDK for AgenticMail — email, SMS, and phone number access for AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -27,14 +27,12 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "better-sqlite3": "^11.8.0",
     "imapflow": "^1.0.170",
     "mailparser": "^3.7.2",
     "nodemailer": "^8.0.1",
     "uuid": "^11.1.0"
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
     "@types/mailparser": "^3.4.6",
     "@types/nodemailer": "^6.4.17",
     "@types/uuid": "^10.0.0",
@@ -43,7 +41,7 @@
     "vitest": "^3.0.0"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "repository": {
     "type": "git",