@agenticmail/enterprise 0.5.319 → 0.5.321

package/dist/agent-heartbeat-Z2QQXROL.js

@@ -0,0 +1,510 @@
+import "./chunk-KFQGP6VL.js";
+
+// src/engine/agent-heartbeat.ts
+var DEFAULT_SETTINGS = {
+  enabled: true,
+  baseIntervalMs: 5 * 6e4,
+  // 5 minutes
+  maxIntervalMs: 30 * 6e4,
+  // 30 minutes
+  dampingFactor: 0.5,
+  maxBatchSize: 5,
+  quietHoursStart: 23,
+  quietHoursEnd: 8
+};
+function createUnreadEmailCheck() {
+  return {
+    id: "unread_emails",
+    name: "Unread Emails",
+    intervalMs: 10 * 6e4,
+    // 10 minutes
+    priority: "high",
+    requiresClockIn: false,
+    // emails can be urgent outside hours
+    consecutiveNoOps: 0,
+    enabled: true,
+    check: async (ctx) => {
+      try {
+        const rows = await ctx.db.query(
+          `SELECT COUNT(*) as cnt FROM agent_memory 
+           WHERE agent_id = $1 
+           AND category = 'processed_email' 
+           AND created_at > NOW() - INTERVAL '4 hours'`,
+          [ctx.agentId]
+        );
+        const processedRecently = parseInt(rows?.[0]?.cnt || "0");
+        const lastProcessed = await ctx.db.query(
+          `SELECT MAX(created_at) as last_at FROM agent_memory 
+           WHERE agent_id = $1 AND category = 'processed_email'`,
+          [ctx.agentId]
+        );
+        const lastAt = lastProcessed?.[0]?.last_at;
+        if (ctx.isWorkHours && processedRecently === 0 && ctx.hour >= 10) {
+          return {
+            needsAction: true,
+            summary: "No emails processed in the last 4 hours during work hours. Check inbox.",
+            priority: "medium",
+            data: { lastProcessedAt: lastAt }
+          };
+        }
+        return { needsAction: false, priority: "low" };
+      } catch {
+        return { needsAction: false, priority: "low" };
+      }
+    }
+  };
+}
+function createUpcomingEventsCheck() {
+  return {
+    id: "upcoming_events",
+    name: "Upcoming Calendar Events",
+    intervalMs: 15 * 6e4,
+    // 15 minutes
+    priority: "high",
+    requiresClockIn: false,
+    consecutiveNoOps: 0,
+    enabled: true,
+    check: async (ctx) => {
+      try {
+        const twoHoursFromNow = new Date(ctx.now.getTime() + 2 * 60 * 60 * 1e3).toISOString();
+        const rows = await ctx.db.query(
+          `SELECT content FROM agent_memory 
+           WHERE agent_id = $1 
+           AND category = 'context' 
+           AND content LIKE '%meeting%' 
+           AND created_at > NOW() - INTERVAL '24 hours'
+           ORDER BY created_at DESC LIMIT 5`,
+          [ctx.agentId]
+        );
+        const upcomingMeetings = (rows || []).filter((r) => {
+          const content = r.content || "";
+          return content.includes("meeting") || content.includes("event");
+        });
+        if (upcomingMeetings.length > 0) {
+          return {
+            needsAction: true,
+            summary: `${upcomingMeetings.length} potential upcoming event(s). Agent should check Google Calendar.`,
+            priority: "high",
+            data: { count: upcomingMeetings.length }
+          };
+        }
+        return { needsAction: false, priority: "low" };
+      } catch {
+        return { needsAction: false, priority: "low" };
+      }
+    }
+  };
+}
+function createStaleSessionsCheck() {
+  return {
+    id: "stale_sessions",
+    name: "Stale Sessions",
+    intervalMs: 30 * 6e4,
+    // 30 minutes
+    priority: "medium",
+    requiresClockIn: true,
+    consecutiveNoOps: 0,
+    enabled: true,
+    check: async (ctx) => {
+      try {
+        const rows = await ctx.db.query(
+          `SELECT COUNT(*) as cnt FROM agent_sessions 
+           WHERE agent_id = $1 
+           AND status = 'active' 
+           AND updated_at < NOW() - INTERVAL '2 hours'`,
+          [ctx.agentId]
+        );
+        const staleCount = parseInt(rows?.[0]?.cnt || "0");
+        if (staleCount > 0) {
+          return {
+            needsAction: true,
+            summary: `${staleCount} stale session(s) detected (active > 2 hours with no updates). May need cleanup.`,
+            priority: "medium",
+            data: { staleCount }
+          };
+        }
+        return { needsAction: false, priority: "low" };
+      } catch {
+        return { needsAction: false, priority: "low" };
+      }
+    }
+  };
+}
+function createMemoryHealthCheck() {
+  return {
+    id: "memory_health",
+    name: "Memory Health",
+    intervalMs: 60 * 6e4,
+    // 1 hour
+    priority: "low",
+    requiresClockIn: true,
+    consecutiveNoOps: 0,
+    enabled: true,
+    check: async (ctx) => {
+      try {
+        const rows = await ctx.db.query(
+          `SELECT COUNT(*) as cnt FROM agent_memory 
+           WHERE agent_id = $1 AND created_at > NOW() - INTERVAL '24 hours'`,
+          [ctx.agentId]
+        );
+        const recentCount = parseInt(rows?.[0]?.cnt || "0");
+        if (recentCount > 200) {
+          return {
+            needsAction: true,
+            summary: `Memory flood detected: ${recentCount} memories in 24h (threshold: 200). Consider pruning.`,
+            priority: "medium",
+            data: { recentCount }
+          };
+        }
+        return { needsAction: false, priority: "low" };
+      } catch {
+        return { needsAction: false, priority: "low" };
+      }
+    }
+  };
+}
+function createUnansweredChatCheck() {
+  return {
+    id: "unanswered_chat",
+    name: "Unanswered Chat Messages",
+    intervalMs: 5 * 6e4,
+    // 5 minutes
+    priority: "high",
+    requiresClockIn: false,
+    consecutiveNoOps: 0,
+    enabled: true,
+    check: async (ctx) => {
+      try {
+        const rows = await ctx.db.query(
+          `SELECT COUNT(*) as cnt FROM agent_sessions 
+           WHERE agent_id = $1 
+           AND status = 'failed'
+           AND metadata::text LIKE '%chat%'
+           AND created_at > NOW() - INTERVAL '1 hour'`,
+          [ctx.agentId]
+        );
+        const failedChats = parseInt(rows?.[0]?.cnt || "0");
+        if (failedChats > 0) {
+          return {
+            needsAction: true,
+            summary: `${failedChats} failed chat session(s) in the last hour. Messages may be unanswered.`,
+            priority: "urgent",
+            data: { failedChats }
+          };
+        }
+        return { needsAction: false, priority: "low" };
+      } catch {
+        return { needsAction: false, priority: "low" };
+      }
+    }
+  };
+}
+function createTaskDeadlineCheck() {
+  return {
+    id: "task_deadlines",
+    name: "Task Deadlines",
+    intervalMs: 60 * 6e4,
+    // 1 hour
+    priority: "medium",
+    requiresClockIn: true,
+    consecutiveNoOps: 0,
+    enabled: true,
+    check: async (ctx) => {
+      try {
+        const rows = await ctx.db.query(
+          `SELECT COUNT(*) as cnt FROM agent_memory 
+           WHERE agent_id = $1 
+           AND category = 'context'
+           AND importance = 'high'
+           AND content LIKE '%deadline%'
+           AND created_at > NOW() - INTERVAL '48 hours'`,
+          [ctx.agentId]
+        );
+        const urgentTasks = parseInt(rows?.[0]?.cnt || "0");
+        if (urgentTasks > 0) {
+          return {
+            needsAction: true,
+            summary: `${urgentTasks} task(s) with approaching deadlines. Agent should review and prioritize.`,
+            priority: "high",
+            data: { urgentTasks }
+          };
+        }
+        return { needsAction: false, priority: "low" };
+      } catch {
+        return { needsAction: false, priority: "low" };
+      }
+    }
+  };
+}
+function createErrorRateCheck() {
+  return {
+    id: "error_rate",
+    name: "Error Rate Monitor",
+    intervalMs: 15 * 6e4,
+    // 15 minutes
+    priority: "high",
+    requiresClockIn: false,
+    // errors can happen anytime
+    consecutiveNoOps: 0,
+    enabled: true,
+    check: async (ctx) => {
+      try {
+        const totalRows = await ctx.db.query(
+          `SELECT COUNT(*) as cnt FROM agent_sessions 
+           WHERE agent_id = $1 AND created_at > NOW() - INTERVAL '1 hour'`,
+          [ctx.agentId]
+        );
+        const failedRows = await ctx.db.query(
+          `SELECT COUNT(*) as cnt FROM agent_sessions 
+           WHERE agent_id = $1 AND status = 'failed' AND created_at > NOW() - INTERVAL '1 hour'`,
+          [ctx.agentId]
+        );
+        const total = parseInt(totalRows?.[0]?.cnt || "0");
+        const failed = parseInt(failedRows?.[0]?.cnt || "0");
+        if (total >= 3 && failed / total > 0.5) {
+          return {
+            needsAction: true,
+            summary: `High error rate: ${failed}/${total} sessions failed in the last hour (${Math.round(failed / total * 100)}%). Possible infrastructure issue.`,
+            priority: "urgent",
+            data: { total, failed, rate: failed / total }
+          };
+        }
+        return { needsAction: false, priority: "low" };
+      } catch {
+        return { needsAction: false, priority: "low" };
+      }
+    }
+  };
+}
+var AgentHeartbeatManager = class {
+  config;
+  settings;
+  checks = /* @__PURE__ */ new Map();
+  tickTimer = null;
+  globalConsecutiveNoOps = 0;
+  lastActionTimestamp = 0;
+  stats = {
+    totalTicks: 0,
+    totalChecksRun: 0,
+    totalActionsTriggered: 0,
+    totalTokensSaved: 0,
+    // estimated tokens NOT spent due to no-op ticks
+    startedAt: Date.now()
+  };
+  constructor(config, settings) {
+    this.config = config;
+    this.settings = { ...DEFAULT_SETTINGS, ...settings };
+    this.registerCheck(createUnreadEmailCheck());
+    this.registerCheck(createUpcomingEventsCheck());
+    this.registerCheck(createStaleSessionsCheck());
+    this.registerCheck(createMemoryHealthCheck());
+    this.registerCheck(createUnansweredChatCheck());
+    this.registerCheck(createTaskDeadlineCheck());
+    this.registerCheck(createErrorRateCheck());
+    if (config.enabledChecks) {
+      for (const [id, enabled] of Object.entries(config.enabledChecks)) {
+        const check = this.checks.get(id);
+        if (check) check.enabled = enabled;
+      }
+    }
+  }
+  registerCheck(check) {
+    this.checks.set(check.id, check);
+  }
+  async start() {
+    if (!this.settings.enabled) {
+      console.log("[heartbeat] Disabled, skipping");
+      return;
+    }
+    console.log(`[heartbeat] Starting with ${this.checks.size} checks, base interval ${this.settings.baseIntervalMs / 1e3}s`);
+    setTimeout(() => this.tick(), 6e4);
+    this.scheduleNextTick();
+  }
+  stop() {
+    if (this.tickTimer) {
+      clearTimeout(this.tickTimer);
+      this.tickTimer = null;
+    }
+    console.log(`[heartbeat] Stopped. Stats: ${this.stats.totalTicks} ticks, ${this.stats.totalChecksRun} checks, ${this.stats.totalActionsTriggered} actions, ~${this.stats.totalTokensSaved} tokens saved`);
+  }
+  getStats() {
+    return {
+      ...this.stats,
+      uptimeMs: Date.now() - this.stats.startedAt,
+      currentIntervalMs: this.calculateInterval(),
+      globalConsecutiveNoOps: this.globalConsecutiveNoOps,
+      checks: Array.from(this.checks.values()).map((c) => ({
+        id: c.id,
+        name: c.name,
+        enabled: c.enabled,
+        lastRunAt: c.lastRunAt,
+        lastActionAt: c.lastActionAt,
+        consecutiveNoOps: c.consecutiveNoOps
+      }))
+    };
+  }
+  // ─── Core Tick Logic ────────────────────────────────
+  async tick() {
+    this.stats.totalTicks++;
+    const now = /* @__PURE__ */ new Date();
+    const tz = this.config.timezone || "UTC";
+    const localTime = new Date(now.toLocaleString("en-US", { timeZone: tz }));
+    const hour = localTime.getHours();
+    const minute = localTime.getMinutes();
+    const dayOfWeek = localTime.getDay();
+    const isWorkHours = this.isWithinWorkHours(hour, minute, dayOfWeek);
+    const isQuietHours = this.isQuietHours(hour);
+    const isClockedIn = this.config.isClockedIn();
+    const ctx = {
+      agentId: this.config.agentId,
+      orgId: this.config.orgId,
+      agentName: this.config.agentName,
+      role: this.config.role,
+      managerEmail: this.config.managerEmail,
+      timezone: tz,
+      db: this.config.db,
+      now,
+      localTime,
+      hour,
+      minute,
+      dayOfWeek,
+      isWorkHours,
+      isClockedIn
+    };
+    const actionableItems = [];
+    for (const check of this.checks.values()) {
+      if (!check.enabled) continue;
+      if (check.requiresClockIn && !isClockedIn) continue;
+      if (isQuietHours && check.priority !== "high") continue;
+      const adaptiveInterval = Math.min(
+        check.intervalMs * (1 + this.settings.dampingFactor * check.consecutiveNoOps),
+        this.settings.maxIntervalMs
+      );
+      const timeSinceLastRun = now.getTime() - (check.lastRunAt || 0);
+      if (timeSinceLastRun < adaptiveInterval) continue;
+      this.stats.totalChecksRun++;
+      check.lastRunAt = now.getTime();
+      try {
+        const result = await check.check(ctx);
+        if (result.needsAction) {
+          actionableItems.push({ check, result });
+          check.consecutiveNoOps = 0;
+          check.lastActionAt = now.getTime();
+        } else {
+          check.consecutiveNoOps++;
+          this.stats.totalTokensSaved += 500;
+        }
+      } catch (err) {
+        console.warn(`[heartbeat] Check ${check.id} error: ${err.message}`);
+        check.consecutiveNoOps++;
+      }
+    }
+    if (actionableItems.length > 0) {
+      this.globalConsecutiveNoOps = 0;
+      this.lastActionTimestamp = now.getTime();
+      this.stats.totalActionsTriggered++;
+      const priorityOrder = { urgent: 0, high: 1, medium: 2, low: 3 };
+      actionableItems.sort((a, b) => priorityOrder[a.result.priority] - priorityOrder[b.result.priority]);
+      const batch = actionableItems.slice(0, this.settings.maxBatchSize);
+      await this.dispatchBatch(batch, ctx);
+    } else {
+      this.globalConsecutiveNoOps++;
+    }
+    this.scheduleNextTick();
+  }
+  /**
+   * Calculate next tick interval using damped oscillator model:
+   *   interval = base * (1 + damping * consecutiveNoOps)
+   * 
+   * With fibonacci-like acceleration:
+   *   After 0 no-ops:  5min  (base)
+   *   After 1 no-op:   7.5min
+   *   After 2 no-ops:  10min
+   *   After 4 no-ops:  15min
+   *   After 8 no-ops:  25min
+   *   After 10 no-ops: 30min (max)
+   * 
+   * Resets to base immediately when action is detected.
+   */
+  calculateInterval() {
+    const base = this.settings.baseIntervalMs;
+    const max = this.settings.maxIntervalMs;
+    const damping = this.settings.dampingFactor;
+    const noOps = this.globalConsecutiveNoOps;
+    return Math.min(base * (1 + damping * noOps), max);
+  }
+  scheduleNextTick() {
+    if (this.tickTimer) clearTimeout(this.tickTimer);
+    const interval = this.calculateInterval();
+    this.tickTimer = setTimeout(() => this.tick(), interval);
+    this.tickTimer.unref();
+  }
+  isWithinWorkHours(hour, minute, dayOfWeek) {
+    const schedule = this.config.schedule;
+    if (!schedule) return true;
+    const isWorkday = schedule.days.includes(dayOfWeek);
+    const timeStr = `${String(hour).padStart(2, "0")}:${String(minute).padStart(2, "0")}`;
+    const isWithinHours = timeStr >= schedule.start && timeStr < schedule.end;
+    return isWorkday && isWithinHours;
+  }
+  isQuietHours(hour) {
+    const start = this.settings.quietHoursStart;
+    const end = this.settings.quietHoursEnd;
+    if (start === void 0 || end === void 0) return false;
+    if (start > end) {
+      return hour >= start || hour < end;
+    }
+    return hour >= start && hour < end;
+  }
+  /**
+   * Dispatch a batch of actionable items to the agent via one LLM session.
+   * This is the ONLY place tokens are spent.
+   */
+  async dispatchBatch(items, ctx) {
+    if (!this.config.runtime) {
+      console.warn("[heartbeat] No runtime \u2014 cannot dispatch actions");
+      return;
+    }
+    try {
+      const { guardrails } = await import("./routes-4ZUIJ4HE.js");
+      const status = await guardrails.getStatus(ctx.agentId);
+      if (status.paused || status.offDuty) {
+        console.log(`[heartbeat] Skipping action dispatch \u2014 agent is ${status.offDuty ? "off duty" : "paused"}`);
+        return;
+      }
+    } catch {
+    }
+    const summaries = items.map(
+      (item, i) => `${i + 1}. [${item.result.priority.toUpperCase()}] ${item.check.name}: ${item.result.summary}`
+    ).join("\n");
+    const prompt = `HEARTBEAT ALERT \u2014 The following ${items.length} item(s) need your attention:
+
+${summaries}
+
+For each item, take the appropriate action:
+- For unread emails: Check your inbox with gmail_search and respond to any urgent ones.
+- For upcoming events: Check google_calendar_list for the next 2 hours and prepare.
+- For stale sessions: Review and close any stuck sessions.
+- For unanswered chats: Check Google Chat and respond.
+- For error rate issues: Investigate recent failures and notify your manager if critical.
+- For task deadlines: Review google_tasks_list and prioritize.
+- For memory health: Consider pruning old or low-importance memories.
+
+Be efficient \u2014 handle what you can and note what needs human intervention.
+If something needs your manager's attention, email ${ctx.managerEmail || "your manager"}.`;
+    const systemPrompt = `You are ${ctx.agentName}, a ${ctx.role}. This is an automated heartbeat check \u2014 items flagged as needing attention. Handle them efficiently. Don't create unnecessary work \u2014 only act on what's genuinely important.`;
+    try {
+      const session = await this.config.runtime.spawnSession({
+        agentId: ctx.agentId,
+        message: prompt,
+        systemPrompt
+      });
+      console.log(`[heartbeat] \u2705 Action session ${session.id} dispatched (${items.length} items: ${items.map((i) => i.check.id).join(", ")})`);
+    } catch (err) {
+      console.error(`[heartbeat] Failed to dispatch action: ${err.message}`);
+    }
+  }
+};
+export {
+  AgentHeartbeatManager
+};

package/dist/agent-notify-OEQBCZLN.js

@@ -0,0 +1,43 @@
+import {
+  __esm
+} from "./chunk-KFQGP6VL.js";
+
+// src/engine/agent-notify.ts
+async function notifyAgent(agentId, scope, lifecycle) {
+  const port = resolveAgentPort(agentId, lifecycle);
+  if (!port) return false;
+  try {
+    const resp = await fetch(`http://127.0.0.1:${port}/reload?scope=${scope}`, {
+      method: "POST",
+      signal: AbortSignal.timeout(3e3)
+    });
+    if (resp.ok) {
+      const data = await resp.json();
+      console.log(`[notify] Agent ${agentId} reloaded: ${data.reloaded?.join(", ") || scope}`);
+      return true;
+    }
+  } catch {
+  }
+  return false;
+}
+async function notifyAllAgents(scope, lifecycle) {
+  if (!lifecycle) return;
+  const agents = lifecycle.getAllAgents().filter((a) => a.state === "running");
+  await Promise.allSettled(agents.map((a) => notifyAgent(a.id, scope, lifecycle)));
+}
+function resolveAgentPort(agentId, lifecycle) {
+  if (!lifecycle) return null;
+  const agent = lifecycle.getAgent(agentId);
+  if (!agent) return null;
+  const dep = agent.config?.deployment;
+  return dep?.port || dep?.config?.local?.port || null;
+}
+var init_agent_notify = __esm({
+  "src/engine/agent-notify.ts"() {
+  }
+});
+init_agent_notify();
+export {
+  notifyAgent,
+  notifyAllAgents
+};

package/dist/{agent-tools-263HM5QU.js → agent-tools-3W7XLUYA.js}

@@ -13735,7 +13735,7 @@ async function createAllTools(options) {
       workspaceTools = workspaceTools.concat(createMeetingLifecycleTools({ tokenProvider: tp }, options));
     }
     if (provider === "microsoft") {
-      const { createAllMicrosoftTools } = await import("./microsoft-UFLZBEAC.js");
+      const { createAllMicrosoftTools } = await import("./microsoft-VREAZ7M2.js");
       const msOpts = options?.enabledMicrosoftServices ? { ...options, enabledMicrosoftServices: options.enabledMicrosoftServices } : options;
       workspaceTools = createAllMicrosoftTools({ tokenProvider: tp }, msOpts);
     }

package/dist/agent-tools-4QK7LLNP.js

@@ -0,0 +1,9 @@
+import {
+  createDatabaseTools,
+  init_agent_tools
+} from "./chunk-3UAFHUEC.js";
+import "./chunk-KFQGP6VL.js";
+init_agent_tools();
+export {
+  createDatabaseTools
+};

package/dist/agent-tools-54VZGT6L.js

@@ -0,0 +1,9 @@
+import {
+  createDatabaseTools,
+  init_agent_tools
+} from "./chunk-PN3EGTCA.js";
+import "./chunk-KFQGP6VL.js";
+init_agent_tools();
+export {
+  createDatabaseTools
+};

package/dist/{agent-tools-AT4D276V.js → agent-tools-AYYDPO27.js}

@@ -8535,7 +8535,7 @@ function createDatabaseTools(options) {
   var entDbQuery = {
     name: "ent_db_query",
     label: "Database Query",
-    description: "Execute a read-only SQL query against a database connection.",
+    description: "Execute a read-only SQL query against a LOCAL SQLite database file. For external/cloud databases, use db_query instead.",
     category: "utility",
     risk: "medium",
     parameters: {
@@ -8688,8 +8688,8 @@ function createDatabaseTools(options) {
   };
   var entDbConnections = {
     name: "ent_db_connections",
-    label: "List Database Connections",
-    description: "List all available database connections that can be used with other database ...",
+    label: "List Local Database Files",
+    description: "List LOCAL SQLite database files found in the workspace directory. ONLY for local .db/.sqlite files on this machine. For external/cloud databases (Postgres, MySQL, Supabase, etc.) granted by your admin, use db_list_connections instead.",
     category: "utility",
     risk: "low",
     parameters: {
@@ -8728,8 +8728,8 @@ function createDatabaseTools(options) {
   };
   var entDbTables = {
     name: "ent_db_tables",
-    label: "List Tables",
-    description: "List all tables in a database connection.",
+    label: "List Local DB Tables",
+    description: "List all tables in a LOCAL SQLite database file. For external/cloud databases, use db_list_tables instead.",
     category: "utility",
     risk: "low",
     parameters: {
@@ -13677,7 +13677,7 @@ async function createAllTools(options) {
   rawTools = rawTools.concat(visualMemoryTools);
   if (options?.databaseManager && options?.agentId) {
     try {
-      const { createDatabaseTools: createDbAccessTools } = await import("./agent-tools-QGE26U6R.js");
+      const { createDatabaseTools: createDbAccessTools } = await import("./agent-tools-4QK7LLNP.js");
       const dbAccessTools = createDbAccessTools(options.databaseManager, options.agentId);
       rawTools = rawTools.concat(dbAccessTools);
     } catch (e) {
@@ -13735,7 +13735,7 @@ async function createAllTools(options) {
       workspaceTools = workspaceTools.concat(createMeetingLifecycleTools({ tokenProvider: tp }, options));
     }
     if (provider === "microsoft") {
-      const { createAllMicrosoftTools } = await import("./microsoft-HPLA5ZL5.js");
+      const { createAllMicrosoftTools } = await import("./microsoft-VREAZ7M2.js");
       const msOpts = options?.enabledMicrosoftServices ? { ...options, enabledMicrosoftServices: options.enabledMicrosoftServices } : options;
       workspaceTools = createAllMicrosoftTools({ tokenProvider: tp }, msOpts);
     }

package/dist/{agent-tools-MSTAPX2I.js → agent-tools-F2X47FKF.js}

@@ -8535,7 +8535,7 @@ function createDatabaseTools(options) {
   var entDbQuery = {
     name: "ent_db_query",
     label: "Database Query",
-    description: "Execute a read-only SQL query against a database connection.",
+    description: "Execute a read-only SQL query against a LOCAL SQLite database file. For external/cloud databases, use db_query instead.",
     category: "utility",
     risk: "medium",
     parameters: {
@@ -8688,8 +8688,8 @@ function createDatabaseTools(options) {
   };
   var entDbConnections = {
     name: "ent_db_connections",
-    label: "List Database Connections",
-    description: "List all available database connections that can be used with other database ...",
+    label: "List Local Database Files",
+    description: "List LOCAL SQLite database files found in the workspace directory. ONLY for local .db/.sqlite files on this machine. For external/cloud databases (Postgres, MySQL, Supabase, etc.) granted by your admin, use db_list_connections instead.",
     category: "utility",
     risk: "low",
     parameters: {
@@ -8728,8 +8728,8 @@ function createDatabaseTools(options) {
   };
   var entDbTables = {
     name: "ent_db_tables",
-    label: "List Tables",
-    description: "List all tables in a database connection.",
+    label: "List Local DB Tables",
+    description: "List all tables in a LOCAL SQLite database file. For external/cloud databases, use db_list_tables instead.",
     category: "utility",
     risk: "low",
     parameters: {
@@ -13677,7 +13677,7 @@ async function createAllTools(options) {
   rawTools = rawTools.concat(visualMemoryTools);
   if (options?.databaseManager && options?.agentId) {
     try {
-      const { createDatabaseTools: createDbAccessTools } = await import("./agent-tools-QGE26U6R.js");
+      const { createDatabaseTools: createDbAccessTools } = await import("./agent-tools-OAWVZBMW.js");
       const dbAccessTools = createDbAccessTools(options.databaseManager, options.agentId);
       rawTools = rawTools.concat(dbAccessTools);
     } catch (e) {
@@ -13735,7 +13735,7 @@ async function createAllTools(options) {
       workspaceTools = workspaceTools.concat(createMeetingLifecycleTools({ tokenProvider: tp }, options));
     }
     if (provider === "microsoft") {
-      const { createAllMicrosoftTools } = await import("./microsoft-YUT6EIGP.js");
+      const { createAllMicrosoftTools } = await import("./microsoft-VREAZ7M2.js");
       const msOpts = options?.enabledMicrosoftServices ? { ...options, enabledMicrosoftServices: options.enabledMicrosoftServices } : options;
       workspaceTools = createAllMicrosoftTools({ tokenProvider: tp }, msOpts);
     }