@agenticmail/core 0.5.38 → 0.5.40

package/dist/index.d.ts

@@ -1392,6 +1392,27 @@ declare class SmsPoller {
     private pollOnce;
 }
 
+/**
+ * AgenticMail Anonymous Telemetry
+ *
+ * Collects anonymous usage counts to help improve the product.
+ * NO personal data, API keys, emails, or content is ever collected.
+ *
+ * Opt out: set AGENTICMAIL_TELEMETRY=0 or DO_NOT_TRACK=1
+ *
+ * What we collect:
+ * - Tool call counts (which tools are popular)
+ * - Package version
+ * - Anonymous install ID (random UUID, no PII)
+ * - OS platform (e.g. "darwin", "linux")
+ */
+/** Set the package version for telemetry events */
+declare function setTelemetryVersion(version: string): void;
+/** Record a tool call (fire-and-forget, never throws) */
+declare function recordToolCall(toolName: string): void;
+/** Flush remaining events on process exit */
+declare function flushTelemetry(): void;
+
 declare function debug(tag: string, message: string): void;
 declare function debugWarn(tag: string, message: string): void;
 
@@ -1640,4 +1661,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, 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, closeDatabase, createTestDatabase, debug, debugWarn, ensureDataDir, extractVerificationCode, getDatabase, isInternalEmail, isValidPhoneNumber, normalizePhoneNumber, parseEmail, parseGoogleVoiceSms, resolveConfig, sanitizeEmail, saveConfig, scanOutboundEmail, scoreEmail, 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 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, 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, 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

@@ -859,14 +859,14 @@ var StalwartAdmin = class {
     if (!isValidDomain(domain)) {
       throw new Error(`Invalid domain format: "${domain}"`);
     }
-    const { readFileSync: readFileSync4, writeFileSync: writeFileSync5 } = await import("fs");
-    const { homedir: homedir8 } = await import("os");
-    const { join: join9 } = await import("path");
-    const configPath = join9(homedir8(), ".agenticmail", "stalwart.toml");
+    const { readFileSync: readFileSync5, writeFileSync: writeFileSync6 } = await import("fs");
+    const { homedir: homedir9 } = await import("os");
+    const { join: join10 } = await import("path");
+    const configPath = join10(homedir9(), ".agenticmail", "stalwart.toml");
     try {
-      let config = readFileSync4(configPath, "utf-8");
+      let config = readFileSync5(configPath, "utf-8");
       config = config.replace(/^hostname\s*=\s*"[^"]*"/m, `hostname = "${escapeTomlString(domain)}"`);
-      writeFileSync5(configPath, config);
+      writeFileSync6(configPath, config);
       console.log(`[Stalwart] Updated hostname to "${domain}" in stalwart.toml`);
     } catch (err) {
       throw new Error(`Failed to set config server.hostname=${domain}`);
@@ -875,15 +875,15 @@ var StalwartAdmin = class {
   // --- DKIM ---
   /** Path to the host-side stalwart.toml (mounted read-only into container) */
   get configPath() {
-    const { homedir: homedir8 } = __require("os");
-    const { join: join9 } = __require("path");
-    return join9(homedir8(), ".agenticmail", "stalwart.toml");
+    const { homedir: homedir9 } = __require("os");
+    const { join: join10 } = __require("path");
+    return join10(homedir9(), ".agenticmail", "stalwart.toml");
   }
   /** Path to host-side DKIM key directory */
   get dkimDir() {
-    const { homedir: homedir8 } = __require("os");
-    const { join: join9 } = __require("path");
-    return join9(homedir8(), ".agenticmail");
+    const { homedir: homedir9 } = __require("os");
+    const { join: join10 } = __require("path");
+    return join10(homedir9(), ".agenticmail");
   }
   /**
    * Create/reuse a DKIM signing key for a domain.
@@ -984,12 +984,12 @@ var StalwartAdmin = class {
    * This bypasses the need for a PTR record on the sending IP.
    */
   async configureOutboundRelay(config) {
-    const { readFileSync: readFileSync4, writeFileSync: writeFileSync5 } = await import("fs");
-    const { homedir: homedir8 } = await import("os");
-    const { join: join9 } = await import("path");
+    const { readFileSync: readFileSync5, writeFileSync: writeFileSync6 } = await import("fs");
+    const { homedir: homedir9 } = await import("os");
+    const { join: join10 } = await import("path");
     const routeName = config.routeName ?? "gmail";
-    const tomlPath = join9(homedir8(), ".agenticmail", "stalwart.toml");
-    let toml = readFileSync4(tomlPath, "utf-8");
+    const tomlPath = join10(homedir9(), ".agenticmail", "stalwart.toml");
+    let toml = readFileSync5(tomlPath, "utf-8");
     toml = toml.replace(/\n\[queue\.route\.gmail\][\s\S]*?(?=\n\[|$)/, "");
     toml = toml.replace(/\n\[queue\.strategy\][\s\S]*?(?=\n\[|$)/, "");
     const safeRouteName = routeName.replace(/[^a-zA-Z0-9_-]/g, "");
@@ -1009,7 +1009,7 @@ auth.secret = "${escapeTomlString(config.password)}"
 route = [ { if = "is_local_domain('', rcpt_domain)", then = "'local'" },
            { else = "'${safeRouteName}'" } ]
 `;
-    writeFileSync5(tomlPath, toml, "utf-8");
+    writeFileSync6(tomlPath, toml, "utf-8");
     await this.restartContainer();
   }
 };
@@ -5208,12 +5208,12 @@ var GatewayManager = class {
       zone = await this.cfClient.createZone(domain);
     }
     const existingRecords = await this.cfClient.listDnsRecords(zone.id);
-    const { homedir: homedir8 } = await import("os");
-    const backupDir = join4(homedir8(), ".agenticmail");
+    const { homedir: homedir9 } = await import("os");
+    const backupDir = join4(homedir9(), ".agenticmail");
     const backupPath = join4(backupDir, `dns-backup-${domain}-${Date.now()}.json`);
-    const { writeFileSync: writeFileSync5, mkdirSync: mkdirSync6 } = await import("fs");
-    mkdirSync6(backupDir, { recursive: true });
-    writeFileSync5(backupPath, JSON.stringify({
+    const { writeFileSync: writeFileSync6, mkdirSync: mkdirSync7 } = await import("fs");
+    mkdirSync7(backupDir, { recursive: true });
+    writeFileSync6(backupPath, JSON.stringify({
       domain,
       zoneId: zone.id,
       backedUpAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -5901,17 +5901,122 @@ var RELAY_PRESETS = {
   }
 };
 
+// src/telemetry.ts
+import { randomUUID } from "crypto";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync3, mkdirSync as mkdirSync3, existsSync as existsSync3 } from "fs";
+import { join as join5 } from "path";
+import { homedir as homedir4 } from "os";
+import { platform as platform2 } from "process";
+var TELEMETRY_ENDPOINT = "https://agenticmail.io/api/telemetry";
+var BATCH_INTERVAL_MS = 6e4;
+var MAX_BATCH_SIZE = 100;
+var installId = null;
+var packageVersion = "unknown";
+var disabled = null;
+var batch = [];
+var flushTimer = null;
+var flushing = false;
+function isDisabled() {
+  if (disabled !== null) return disabled;
+  disabled = process.env.AGENTICMAIL_TELEMETRY === "0" || process.env.AGENTICMAIL_TELEMETRY === "false" || process.env.DO_NOT_TRACK === "1" || process.env.DO_NOT_TRACK === "true" || process.env.CI === "true";
+  return disabled;
+}
+function getInstallId() {
+  if (installId) return installId;
+  try {
+    const dir = join5(homedir4(), ".agenticmail");
+    const idFile = join5(dir, ".telemetry-id");
+    if (existsSync3(idFile)) {
+      const id = readFileSync2(idFile, "utf8").trim();
+      if (id && id.length > 10) {
+        installId = id;
+        return installId;
+      }
+    }
+    installId = randomUUID();
+    if (!existsSync3(dir)) mkdirSync3(dir, { recursive: true });
+    writeFileSync3(idFile, installId, "utf8");
+    return installId;
+  } catch {
+    installId = randomUUID();
+    return installId;
+  }
+}
+function setTelemetryVersion(version) {
+  packageVersion = version;
+}
+function recordToolCall(toolName) {
+  try {
+    if (isDisabled()) return;
+    batch.push({ tool: toolName, ts: Date.now() });
+    if (batch.length >= MAX_BATCH_SIZE) {
+      flush();
+      return;
+    }
+    if (!flushTimer) {
+      flushTimer = setTimeout(() => {
+        flushTimer = null;
+        flush();
+      }, BATCH_INTERVAL_MS);
+      if (flushTimer && typeof flushTimer === "object" && "unref" in flushTimer) {
+        flushTimer.unref();
+      }
+    }
+  } catch {
+  }
+}
+function flush() {
+  if (flushing || batch.length === 0) return;
+  flushing = true;
+  const events = batch;
+  batch = [];
+  const toolCounts = {};
+  for (const e of events) {
+    toolCounts[e.tool] = (toolCounts[e.tool] || 0) + 1;
+  }
+  const payload = {
+    id: getInstallId(),
+    v: packageVersion,
+    p: platform2,
+    tools: toolCounts,
+    n: events.length
+    // total calls in this batch
+  };
+  fetch(TELEMETRY_ENDPOINT, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(payload),
+    signal: AbortSignal.timeout(5e3)
+  }).catch(() => {
+  }).finally(() => {
+    flushing = false;
+  });
+}
+function flushTelemetry() {
+  if (flushTimer) {
+    clearTimeout(flushTimer);
+    flushTimer = null;
+  }
+  flush();
+}
+try {
+  process.on("beforeExit", flushTelemetry);
+  process.on("SIGINT", flushTelemetry);
+  process.on("SIGTERM", flushTelemetry);
+} catch {
+}
+
 // src/setup/index.ts
 import { randomBytes as randomBytes3 } from "crypto";
-import { existsSync as existsSync6, readFileSync as readFileSync3, writeFileSync as writeFileSync4, mkdirSync as mkdirSync5, chmodSync as chmodSync2 } from "fs";
-import { join as join8 } from "path";
-import { homedir as homedir7 } from "os";
+import { existsSync as existsSync7, readFileSync as readFileSync4, writeFileSync as writeFileSync5, mkdirSync as mkdirSync6, chmodSync as chmodSync2 } from "fs";
+import { join as join9 } from "path";
+import { homedir as homedir8 } from "os";
 
 // src/setup/deps.ts
 import { execFileSync } from "child_process";
-import { existsSync as existsSync3 } from "fs";
-import { join as join5 } from "path";
-import { homedir as homedir4 } from "os";
+import { existsSync as existsSync4 } from "fs";
+import { join as join6 } from "path";
+import { homedir as homedir5 } from "os";
 var DependencyChecker = class {
   async checkAll() {
     return Promise.all([
@@ -5961,8 +6066,8 @@ var DependencyChecker = class {
     }
   }
   async checkCloudflared() {
-    const binPath = join5(homedir4(), ".agenticmail", "bin", "cloudflared");
-    if (existsSync3(binPath)) {
+    const binPath = join6(homedir5(), ".agenticmail", "bin", "cloudflared");
+    if (existsSync4(binPath)) {
       let version;
       try {
         const output = execFileSync(binPath, ["--version"], { timeout: 5e3, stdio: ["ignore", "pipe", "ignore"] }).toString().trim();
@@ -5984,10 +6089,10 @@ var DependencyChecker = class {
 
 // src/setup/installer.ts
 import { execFileSync as execFileSync2, execSync, spawn as spawnChild } from "child_process";
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, symlinkSync } from "fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync4, symlinkSync } from "fs";
 import { writeFile, rename, chmod as chmod2, mkdir as mkdir2, unlink } from "fs/promises";
-import { join as join6 } from "path";
-import { homedir as homedir5, platform as platform2, arch as arch2 } from "os";
+import { join as join7 } from "path";
+import { homedir as homedir6, platform as platform3, arch as arch2 } from "os";
 function runShellWithRollingOutput(cmd, opts = {}) {
   const maxLines = opts.maxLines ?? 20;
   const timeout = opts.timeout ?? 3e5;
@@ -6097,7 +6202,7 @@ var DependencyInstaller = class {
    */
   async installDocker() {
     if (this.isDockerReady()) return;
-    const os = platform2();
+    const os = platform3();
     if (os === "darwin") {
       await this.installDockerMac();
     } else if (os === "linux") {
@@ -6163,11 +6268,11 @@ var DependencyInstaller = class {
     try {
       const composeBin = execFileSync2("which", ["docker-compose"], { timeout: 5e3, stdio: ["ignore", "pipe", "ignore"] }).toString().trim();
       if (!composeBin) return;
-      const pluginDir = join6(homedir5(), ".docker", "cli-plugins");
-      const pluginPath = join6(pluginDir, "docker-compose");
-      if (existsSync4(pluginPath)) return;
+      const pluginDir = join7(homedir6(), ".docker", "cli-plugins");
+      const pluginPath = join7(pluginDir, "docker-compose");
+      if (existsSync5(pluginPath)) return;
       try {
-        mkdirSync3(pluginDir, { recursive: true });
+        mkdirSync4(pluginDir, { recursive: true });
       } catch {
       }
       try {
@@ -6230,9 +6335,9 @@ var DependencyInstaller = class {
       return;
     }
     this.onProgress("__progress__:5:Installing Docker Engine...");
-    const tmpDir = join6(homedir5(), ".agenticmail", "tmp");
+    const tmpDir = join7(homedir6(), ".agenticmail", "tmp");
     await mkdir2(tmpDir, { recursive: true });
-    const scriptPath = join6(tmpDir, "install-docker.sh");
+    const scriptPath = join7(tmpDir, "install-docker.sh");
     const dlResult = await runShellWithRollingOutput(
       `curl -fsSL https://get.docker.com -o "${scriptPath}" && sudo sh "${scriptPath}"`,
       { timeout: 3e5 }
@@ -6300,8 +6405,8 @@ var DependencyInstaller = class {
       }
       try {
         const programFiles = process.env["ProgramFiles"] || "C:\\Program Files";
-        const dockerExe = join6(programFiles, "Docker", "Docker", "Docker Desktop.exe");
-        if (existsSync4(dockerExe)) {
+        const dockerExe = join7(programFiles, "Docker", "Docker", "Docker Desktop.exe");
+        if (existsSync5(dockerExe)) {
           execSync(`start "" "${dockerExe}"`, { timeout: 1e4, stdio: "ignore", shell: "cmd.exe" });
         }
       } catch {
@@ -6351,8 +6456,8 @@ var DependencyInstaller = class {
         this.onProgress("__progress__:70:Docker Desktop installed. Starting...");
         try {
           const programFiles = process.env["ProgramFiles"] || "C:\\Program Files";
-          const dockerExe = join6(programFiles, "Docker", "Docker", "Docker Desktop.exe");
-          if (existsSync4(dockerExe)) {
+          const dockerExe = join7(programFiles, "Docker", "Docker", "Docker Desktop.exe");
+          if (existsSync5(dockerExe)) {
             execSync(`start "" "${dockerExe}"`, { timeout: 1e4, stdio: "ignore", shell: "cmd.exe" });
           }
         } catch {
@@ -6389,12 +6494,12 @@ var DependencyInstaller = class {
    * Start the Stalwart mail server Docker container.
    */
   async startStalwart(composePath) {
-    if (!existsSync4(composePath)) {
+    if (!existsSync5(composePath)) {
       throw new Error(`docker-compose.yml not found at: ${composePath}`);
     }
     if (!this.isDockerReady()) {
       this.onProgress("Starting Docker...");
-      const os = platform2();
+      const os = platform3();
       if (os === "darwin") {
         await this.startColima();
       } else if (os === "win32") {
@@ -6412,7 +6517,7 @@ var DependencyInstaller = class {
       }
     }
     this.onProgress("__progress__:10:Pulling mail server image...");
-    if (platform2() === "darwin") this.linkComposePlugin();
+    if (platform3() === "darwin") this.linkComposePlugin();
     let composeResult = await runSilent("docker", ["compose", "-f", composePath, "up", "-d"], { timeout: 12e4 });
     if (composeResult.exitCode !== 0 && hasCommand("docker-compose")) {
       composeResult = await runSilent("docker-compose", ["-f", composePath, "up", "-d"], { timeout: 12e4 });
@@ -6447,17 +6552,17 @@ var DependencyInstaller = class {
    * Returns the path to the installed binary.
    */
   async installCloudflared() {
-    const os = platform2();
-    const binDir = join6(homedir5(), ".agenticmail", "bin");
+    const os = platform3();
+    const binDir = join7(homedir6(), ".agenticmail", "bin");
     const binName = os === "win32" ? "cloudflared.exe" : "cloudflared";
-    const binPath = join6(binDir, binName);
-    if (existsSync4(binPath)) {
+    const binPath = join7(binDir, binName);
+    if (existsSync5(binPath)) {
       return binPath;
     }
     try {
       const whichCmd = os === "win32" ? "where" : "which";
       const sysPath = execFileSync2(whichCmd, ["cloudflared"], { timeout: 5e3, stdio: ["ignore", "pipe", "ignore"] }).toString().trim().split("\n")[0];
-      if (sysPath && existsSync4(sysPath)) return sysPath;
+      if (sysPath && existsSync5(sysPath)) return sysPath;
     } catch {
     }
     this.onProgress("Downloading cloudflared...");
@@ -6480,7 +6585,7 @@ var DependencyInstaller = class {
     }
     const buffer = Buffer.from(await response.arrayBuffer());
     if (os === "darwin") {
-      const tgzPath = join6(binDir, "cloudflared.tgz");
+      const tgzPath = join7(binDir, "cloudflared.tgz");
       await writeFile(tgzPath, buffer);
       try {
         execFileSync2("tar", ["-xzf", tgzPath, "-C", binDir, "cloudflared"], { timeout: 15e3, stdio: "ignore" });
@@ -6497,7 +6602,7 @@ var DependencyInstaller = class {
       if (os !== "win32") await chmod2(tmpPath, 493);
       await rename(tmpPath, binPath);
     }
-    if (!existsSync4(binPath)) {
+    if (!existsSync5(binPath)) {
       throw new Error("cloudflared download succeeded but binary not found after extraction");
     }
     this.onProgress("cloudflared installed");
@@ -6515,21 +6620,21 @@ var DependencyInstaller = class {
 
 // src/setup/service.ts
 import { execFileSync as execFileSync3, execSync as execSync2 } from "child_process";
-import { existsSync as existsSync5, readFileSync as readFileSync2, writeFileSync as writeFileSync3, unlinkSync, mkdirSync as mkdirSync4, chmodSync } from "fs";
-import { join as join7 } from "path";
-import { homedir as homedir6, platform as platform3 } from "os";
+import { existsSync as existsSync6, readFileSync as readFileSync3, writeFileSync as writeFileSync4, unlinkSync, mkdirSync as mkdirSync5, chmodSync } from "fs";
+import { join as join8 } from "path";
+import { homedir as homedir7, platform as platform4 } from "os";
 var PLIST_LABEL = "com.agenticmail.server";
 var SYSTEMD_UNIT = "agenticmail.service";
 var ServiceManager = class {
-  os = platform3();
+  os = platform4();
   /**
    * Get the path to the service file.
    */
   getServicePath() {
     if (this.os === "darwin") {
-      return join7(homedir6(), "Library", "LaunchAgents", `${PLIST_LABEL}.plist`);
+      return join8(homedir7(), "Library", "LaunchAgents", `${PLIST_LABEL}.plist`);
     } else {
-      return join7(homedir6(), ".config", "systemd", "user", SYSTEMD_UNIT);
+      return join8(homedir7(), ".config", "systemd", "user", SYSTEMD_UNIT);
     }
   }
   /**
@@ -6549,14 +6654,14 @@ var ServiceManager = class {
   getApiEntryPath() {
     const searchDirs = [
       // Global npm install
-      join7(homedir6(), "node_modules", "agenticmail"),
+      join8(homedir7(), "node_modules", "agenticmail"),
       // npx cache / global prefix
       ...(() => {
         try {
           const prefix = execSync2("npm prefix -g", { timeout: 5e3, stdio: ["ignore", "pipe", "ignore"] }).toString().trim();
           return [
-            join7(prefix, "lib", "node_modules", "agenticmail"),
-            join7(prefix, "node_modules", "agenticmail")
+            join8(prefix, "lib", "node_modules", "agenticmail"),
+            join8(prefix, "node_modules", "agenticmail")
           ];
         } catch {
           return [];
@@ -6568,18 +6673,18 @@ var ServiceManager = class {
     ];
     for (const base of searchDirs) {
       const apiPaths = [
-        join7(base, "node_modules", "@agenticmail", "api", "dist", "index.js"),
-        join7(base, "..", "@agenticmail", "api", "dist", "index.js")
+        join8(base, "node_modules", "@agenticmail", "api", "dist", "index.js"),
+        join8(base, "..", "@agenticmail", "api", "dist", "index.js")
       ];
       for (const p of apiPaths) {
-        if (existsSync5(p)) return p;
+        if (existsSync6(p)) return p;
       }
     }
-    const dataDir = join7(homedir6(), ".agenticmail");
-    const entryCache = join7(dataDir, "api-entry.path");
-    if (existsSync5(entryCache)) {
-      const cached = readFileSync2(entryCache, "utf-8").trim();
-      if (existsSync5(cached)) return cached;
+    const dataDir = join8(homedir7(), ".agenticmail");
+    const entryCache = join8(dataDir, "api-entry.path");
+    if (existsSync6(entryCache)) {
+      const cached = readFileSync3(entryCache, "utf-8").trim();
+      if (existsSync6(cached)) return cached;
     }
     throw new Error("Could not find @agenticmail/api entry point. Run `agenticmail start` first to populate the cache.");
   }
@@ -6587,9 +6692,9 @@ var ServiceManager = class {
    * Cache the API entry path so the service can find it later.
    */
   cacheApiEntryPath(entryPath) {
-    const dataDir = join7(homedir6(), ".agenticmail");
-    if (!existsSync5(dataDir)) mkdirSync4(dataDir, { recursive: true });
-    writeFileSync3(join7(dataDir, "api-entry.path"), entryPath);
+    const dataDir = join8(homedir7(), ".agenticmail");
+    if (!existsSync6(dataDir)) mkdirSync5(dataDir, { recursive: true });
+    writeFileSync4(join8(dataDir, "api-entry.path"), entryPath);
   }
   /**
    * Get the current package version.
@@ -6597,17 +6702,17 @@ var ServiceManager = class {
   getVersion() {
     try {
       const pkgPaths = [
-        join7(homedir6(), "node_modules", "agenticmail", "package.json"),
-        join7(homedir6(), ".agenticmail", "package-version.json")
+        join8(homedir7(), "node_modules", "agenticmail", "package.json"),
+        join8(homedir7(), ".agenticmail", "package-version.json")
       ];
       try {
         const prefix = execSync2("npm prefix -g", { timeout: 5e3, stdio: ["ignore", "pipe", "ignore"] }).toString().trim();
-        pkgPaths.push(join7(prefix, "lib", "node_modules", "agenticmail", "package.json"));
+        pkgPaths.push(join8(prefix, "lib", "node_modules", "agenticmail", "package.json"));
       } catch {
       }
       for (const p of pkgPaths) {
-        if (existsSync5(p)) {
-          const pkg = JSON.parse(readFileSync2(p, "utf-8"));
+        if (existsSync6(p)) {
+          const pkg = JSON.parse(readFileSync3(p, "utf-8"));
           if (pkg.version) return pkg.version;
         }
       }
@@ -6620,9 +6725,9 @@ var ServiceManager = class {
    * This ensures AgenticMail doesn't fail on boot when Docker is still loading.
    */
   generateStartScript(nodePath, apiEntry) {
-    const scriptPath = join7(homedir6(), ".agenticmail", "bin", "start-server.sh");
-    const scriptDir = join7(homedir6(), ".agenticmail", "bin");
-    if (!existsSync5(scriptDir)) mkdirSync4(scriptDir, { recursive: true });
+    const scriptPath = join8(homedir7(), ".agenticmail", "bin", "start-server.sh");
+    const scriptDir = join8(homedir7(), ".agenticmail", "bin");
+    if (!existsSync6(scriptDir)) mkdirSync5(scriptDir, { recursive: true });
     const script = [
       "#!/bin/bash",
       "# AgenticMail auto-start script",
@@ -6673,7 +6778,7 @@ var ServiceManager = class {
       `log "Starting API server: ${nodePath} ${apiEntry}"`,
       `exec "${nodePath}" "${apiEntry}"`
     ].join("\n") + "\n";
-    writeFileSync3(scriptPath, script, { mode: 493 });
+    writeFileSync4(scriptPath, script, { mode: 493 });
     return scriptPath;
   }
   /**
@@ -6686,9 +6791,9 @@ var ServiceManager = class {
    * - Service version tracking in env vars
    */
   generatePlist(nodePath, apiEntry, configPath) {
-    const config = JSON.parse(readFileSync2(configPath, "utf-8"));
-    const logDir = join7(homedir6(), ".agenticmail", "logs");
-    if (!existsSync5(logDir)) mkdirSync4(logDir, { recursive: true });
+    const config = JSON.parse(readFileSync3(configPath, "utf-8"));
+    const logDir = join8(homedir7(), ".agenticmail", "logs");
+    if (!existsSync6(logDir)) mkdirSync5(logDir, { recursive: true });
     const version = this.getVersion();
     const startScript = this.generateStartScript(nodePath, apiEntry);
     return `<?xml version="1.0" encoding="UTF-8"?>
@@ -6709,9 +6814,9 @@ var ServiceManager = class {
   <key>EnvironmentVariables</key>
   <dict>
     <key>HOME</key>
-    <string>${homedir6()}</string>
+    <string>${homedir7()}</string>
     <key>AGENTICMAIL_DATA_DIR</key>
-    <string>${config.dataDir || join7(homedir6(), ".agenticmail")}</string>
+    <string>${config.dataDir || join8(homedir7(), ".agenticmail")}</string>
     <key>PATH</key>
     <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
     <key>AGENTICMAIL_SERVICE_VERSION</key>
@@ -6764,8 +6869,8 @@ var ServiceManager = class {
    * - Proper dependency ordering
    */
   generateSystemdUnit(nodePath, apiEntry, configPath) {
-    const config = JSON.parse(readFileSync2(configPath, "utf-8"));
-    const dataDir = config.dataDir || join7(homedir6(), ".agenticmail");
+    const config = JSON.parse(readFileSync3(configPath, "utf-8"));
+    const dataDir = config.dataDir || join8(homedir7(), ".agenticmail");
     const version = this.getVersion();
     const startScript = this.generateStartScript(nodePath, apiEntry);
     return `[Unit]
@@ -6782,7 +6887,7 @@ Restart=always
 RestartSec=15
 TimeoutStartSec=660
 LimitNOFILE=8192
-Environment=HOME=${homedir6()}
+Environment=HOME=${homedir7()}
 Environment=AGENTICMAIL_DATA_DIR=${dataDir}
 Environment=PATH=/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin
 Environment=AGENTICMAIL_SERVICE_VERSION=${version}
@@ -6795,8 +6900,8 @@ WantedBy=default.target
    * Install the auto-start service.
    */
   install() {
-    const configPath = join7(homedir6(), ".agenticmail", "config.json");
-    if (!existsSync5(configPath)) {
+    const configPath = join8(homedir7(), ".agenticmail", "config.json");
+    if (!existsSync6(configPath)) {
       return { installed: false, message: "Config not found. Run agenticmail setup first." };
     }
     const nodePath = this.getNodePath();
@@ -6808,16 +6913,16 @@ WantedBy=default.target
     }
     const servicePath = this.getServicePath();
     if (this.os === "darwin") {
-      const dir = join7(homedir6(), "Library", "LaunchAgents");
-      if (!existsSync5(dir)) mkdirSync4(dir, { recursive: true });
-      if (existsSync5(servicePath)) {
+      const dir = join8(homedir7(), "Library", "LaunchAgents");
+      if (!existsSync6(dir)) mkdirSync5(dir, { recursive: true });
+      if (existsSync6(servicePath)) {
         try {
           execFileSync3("launchctl", ["unload", servicePath], { timeout: 1e4, stdio: "ignore" });
         } catch {
         }
       }
       const plist = this.generatePlist(nodePath, apiEntry, configPath);
-      writeFileSync3(servicePath, plist);
+      writeFileSync4(servicePath, plist);
       chmodSync(servicePath, 384);
       try {
         execFileSync3("launchctl", ["load", servicePath], { timeout: 1e4, stdio: "ignore" });
@@ -6826,10 +6931,10 @@ WantedBy=default.target
       }
       return { installed: true, message: `Service installed at ${servicePath}` };
     } else if (this.os === "linux") {
-      const dir = join7(homedir6(), ".config", "systemd", "user");
-      if (!existsSync5(dir)) mkdirSync4(dir, { recursive: true });
+      const dir = join8(homedir7(), ".config", "systemd", "user");
+      if (!existsSync6(dir)) mkdirSync5(dir, { recursive: true });
       const unit = this.generateSystemdUnit(nodePath, apiEntry, configPath);
-      writeFileSync3(servicePath, unit);
+      writeFileSync4(servicePath, unit);
       chmodSync(servicePath, 384);
       try {
         execFileSync3("systemctl", ["--user", "daemon-reload"], { timeout: 1e4, stdio: "ignore" });
@@ -6852,7 +6957,7 @@ WantedBy=default.target
    */
   uninstall() {
     const servicePath = this.getServicePath();
-    if (!existsSync5(servicePath)) {
+    if (!existsSync6(servicePath)) {
       return { removed: false, message: "Service is not installed." };
     }
     if (this.os === "darwin") {
@@ -6890,7 +6995,7 @@ WantedBy=default.target
   status() {
     const servicePath = this.getServicePath();
     const plat = this.os === "darwin" ? "launchd" : this.os === "linux" ? "systemd" : "unsupported";
-    const installed = existsSync5(servicePath);
+    const installed = existsSync6(servicePath);
     let running = false;
     if (installed) {
       if (this.os === "darwin") {
@@ -6960,13 +7065,13 @@ var SetupManager = class {
    * falls back to monorepo location.
    */
   getComposePath() {
-    const standalonePath = join8(homedir7(), ".agenticmail", "docker-compose.yml");
-    if (existsSync6(standalonePath)) return standalonePath;
+    const standalonePath = join9(homedir8(), ".agenticmail", "docker-compose.yml");
+    if (existsSync7(standalonePath)) return standalonePath;
     const cwd = process.cwd();
-    const candidates = [cwd, join8(cwd, "..")];
+    const candidates = [cwd, join9(cwd, "..")];
     for (const dir of candidates) {
-      const p = join8(dir, "docker-compose.yml");
-      if (existsSync6(p)) return p;
+      const p = join9(dir, "docker-compose.yml");
+      if (existsSync7(p)) return p;
     }
     return standalonePath;
   }
@@ -6976,19 +7081,19 @@ var SetupManager = class {
    * Always regenerates Docker files to keep passwords in sync.
    */
   initConfig() {
-    const dataDir = join8(homedir7(), ".agenticmail");
-    const configPath = join8(dataDir, "config.json");
-    const envPath = join8(dataDir, ".env");
-    if (existsSync6(configPath)) {
+    const dataDir = join9(homedir8(), ".agenticmail");
+    const configPath = join9(dataDir, "config.json");
+    const envPath = join9(dataDir, ".env");
+    if (existsSync7(configPath)) {
       try {
-        const existing = JSON.parse(readFileSync3(configPath, "utf-8"));
+        const existing = JSON.parse(readFileSync4(configPath, "utf-8"));
         this.generateDockerFiles(existing);
         return { configPath, envPath, config: existing, isNew: false };
       } catch {
       }
     }
-    if (!existsSync6(dataDir)) {
-      mkdirSync5(dataDir, { recursive: true });
+    if (!existsSync7(dataDir)) {
+      mkdirSync6(dataDir, { recursive: true });
     }
     const masterKey = `mk_${randomBytes3(24).toString("hex")}`;
     const stalwartPassword = randomBytes3(16).toString("hex");
@@ -7004,7 +7109,7 @@ var SetupManager = class {
       api: { port: 3100, host: "127.0.0.1" },
       dataDir
     };
-    writeFileSync4(configPath, JSON.stringify(config, null, 2));
+    writeFileSync5(configPath, JSON.stringify(config, null, 2));
     chmodSync2(configPath, 384);
     const envContent = `# Auto-generated by agenticmail setup
 STALWART_ADMIN_USER=admin
@@ -7020,7 +7125,7 @@ SMTP_PORT=587
 IMAP_HOST=localhost
 IMAP_PORT=143
 `;
-    writeFileSync4(envPath, envContent);
+    writeFileSync5(envPath, envContent);
     chmodSync2(envPath, 384);
     this.generateDockerFiles(config);
     return { configPath, envPath, config, isNew: true };
@@ -7030,13 +7135,13 @@ IMAP_PORT=143
    * with the correct admin password from config.
    */
   generateDockerFiles(config) {
-    const dataDir = config.dataDir || join8(homedir7(), ".agenticmail");
-    if (!existsSync6(dataDir)) {
-      mkdirSync5(dataDir, { recursive: true });
+    const dataDir = config.dataDir || join9(homedir8(), ".agenticmail");
+    if (!existsSync7(dataDir)) {
+      mkdirSync6(dataDir, { recursive: true });
     }
     const password = config.stalwart?.adminPassword || "changeme";
-    const composePath = join8(dataDir, "docker-compose.yml");
-    writeFileSync4(composePath, `services:
+    const composePath = join9(dataDir, "docker-compose.yml");
+    writeFileSync5(composePath, `services:
   stalwart:
     image: stalwartlabs/stalwart:latest
     container_name: agenticmail-stalwart
@@ -7059,8 +7164,8 @@ volumes:
   stalwart-data:
 `);
     chmodSync2(composePath, 384);
-    const tomlPath = join8(dataDir, "stalwart.toml");
-    writeFileSync4(tomlPath, `# Stalwart Mail Server \u2014 AgenticMail Configuration
+    const tomlPath = join9(dataDir, "stalwart.toml");
+    writeFileSync5(tomlPath, `# Stalwart Mail Server \u2014 AgenticMail Configuration
 
 [server]
 hostname = "localhost"
@@ -7116,8 +7221,8 @@ secret = "${password}"
    * Check if config has already been initialized.
    */
   isInitialized() {
-    const configPath = join8(homedir7(), ".agenticmail", "config.json");
-    return existsSync6(configPath);
+    const configPath = join9(homedir8(), ".agenticmail", "config.json");
+    return existsSync7(configPath);
   }
 };
 export {
@@ -7156,16 +7261,19 @@ export {
   debugWarn,
   ensureDataDir,
   extractVerificationCode,
+  flushTelemetry,
   getDatabase,
   isInternalEmail,
   isValidPhoneNumber,
   normalizePhoneNumber,
   parseEmail,
   parseGoogleVoiceSms,
+  recordToolCall,
   resolveConfig,
   sanitizeEmail,
   saveConfig,
   scanOutboundEmail,
   scoreEmail,
+  setTelemetryVersion,
   startRelayBridge
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/core",
-  "version": "0.5.38",
+  "version": "0.5.40",
   "description": "Core SDK for AgenticMail — email, SMS, and phone number access for AI agents",
   "type": "module",
   "main": "dist/index.js",