@agenticmail/enterprise 0.5.280 → 0.5.282

package/dist/runtime-RILCPBIB.js

@@ -0,0 +1,45 @@
+import {
+  AgentRuntime,
+  EmailChannel,
+  FollowUpScheduler,
+  SessionManager,
+  SubAgentManager,
+  ToolRegistry,
+  callLLM,
+  createAgentRuntime,
+  createNoopHooks,
+  createRuntimeHooks,
+  estimateMessageTokens,
+  estimateTokens,
+  executeTool,
+  runAgentLoop,
+  toolsToDefinitions
+} from "./chunk-KPGXRGQ4.js";
+import {
+  PROVIDER_REGISTRY,
+  listAllProviders,
+  resolveApiKeyForProvider,
+  resolveProvider
+} from "./chunk-UF3ZJMJO.js";
+import "./chunk-KFQGP6VL.js";
+export {
+  AgentRuntime,
+  EmailChannel,
+  FollowUpScheduler,
+  PROVIDER_REGISTRY,
+  SessionManager,
+  SubAgentManager,
+  ToolRegistry,
+  callLLM,
+  createAgentRuntime,
+  createNoopHooks,
+  createRuntimeHooks,
+  estimateMessageTokens,
+  estimateTokens,
+  executeTool,
+  listAllProviders,
+  resolveApiKeyForProvider,
+  resolveProvider,
+  runAgentLoop,
+  toolsToDefinitions
+};

package/dist/server-XVIBYRNU.js

@@ -0,0 +1,15 @@
+import {
+  createServer
+} from "./chunk-O3RXJSHR.js";
+import "./chunk-OF4MUWWS.js";
+import "./chunk-UF3ZJMJO.js";
+import "./chunk-3OC6RH7W.js";
+import "./chunk-2DDKGTD6.js";
+import "./chunk-YVK6F5OD.js";
+import "./chunk-MKRNEM5A.js";
+import "./chunk-DRXMYYKN.js";
+import "./chunk-6WSX7QXF.js";
+import "./chunk-KFQGP6VL.js";
+export {
+  createServer
+};

package/dist/setup-DAT4LP7A.js

@@ -0,0 +1,20 @@
+import {
+  promptCompanyInfo,
+  promptDatabase,
+  promptDeployment,
+  promptDomain,
+  promptRegistration,
+  provision,
+  runSetupWizard
+} from "./chunk-P5EGIVSM.js";
+import "./chunk-ULRBF2T7.js";
+import "./chunk-KFQGP6VL.js";
+export {
+  promptCompanyInfo,
+  promptDatabase,
+  promptDeployment,
+  promptDomain,
+  promptRegistration,
+  provision,
+  runSetupWizard
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/enterprise",
-  "version": "0.5.280",
+  "version": "0.5.282",
   "description": "AgenticMail Enterprise — cloud-hosted AI agent identity, email, auth & compliance for organizations",
   "type": "module",
   "bin": {

package/src/agent-tools/index.ts

@@ -305,6 +305,17 @@ export async function createAllTools(options?: AllToolsOptions): Promise<AnyAgen
   var visualMemoryTools = createVisualMemoryTools(options || {});
   rawTools = rawTools.concat(visualMemoryTools as any);
 
+  // Enterprise Database Access tools (real multi-DB connections via DatabaseConnectionManager)
+  if ((options as any)?.databaseManager && options?.agentId) {
+    try {
+      const { createDatabaseTools: createDbAccessTools } = await import('../database-access/agent-tools.js');
+      const dbAccessTools = createDbAccessTools((options as any).databaseManager, options.agentId);
+      rawTools = rawTools.concat(dbAccessTools as any);
+    } catch (e: any) {
+      console.warn('[tools] Failed to load database access tools:', e.message);
+    }
+  }
+
   // Enterprise tools (7 skills)
   var enterpriseTools: AnyAgentTool[] = [
     ...createDatabaseTools(options),

package/src/agent-tools/types.ts

@@ -128,6 +128,8 @@ export interface ToolCreationOptions {
   };
   /** Engine database reference for tools that need DB access */
   engineDb?: any;
+  /** Database Connection Manager for enterprise database access */
+  databaseManager?: any;
   /** Middleware configuration for cross-cutting concerns */
   middleware?: {
     audit?: {

package/src/cli-agent.ts

@@ -586,6 +586,19 @@ export async function runAgent(_args: string[]) {
     console.warn(`[agent] MCP Process Manager init failed (non-fatal): ${e.message}`);
   }
 
+  // ─── Database Connection Manager ───────────────────
+  // Enables agents to query external databases they've been granted access to
+  try {
+    const { DatabaseConnectionManager } = await import('./database-access/connection-manager.js');
+    const vault = (runtime as any).config?.vault;
+    const dbManager = new DatabaseConnectionManager({ vault });
+    await dbManager.setDb(engineDb);
+    (runtime as any).config.databaseManager = dbManager;
+    console.log(`[agent] Database Connection Manager started`);
+  } catch (e: any) {
+    console.warn(`[agent] Database Connection Manager init failed (non-fatal): ${e.message}`);
+  }
+
   await runtime.start();
   const runtimeApp = runtime.getApp();
 

package/src/dashboard/pages/database-access.js

@@ -175,9 +175,12 @@ export function DatabaseAccessPage() {
 
     // Tabs
     h('div', { style: s.tabs },
-      h('div', { style: tab === 'connections' ? s.tabActive : s.tab, onClick: function() { setTab('connections'); } }, 'Connections'),
-      h('div', { style: tab === 'agents' ? s.tabActive : s.tab, onClick: function() { setTab('agents'); } }, 'Agent Access'),
-      h('div', { style: tab === 'audit' ? s.tabActive : s.tab, onClick: function() { setTab('audit'); } }, 'Audit Log'),
+      h('div', { style: tab === 'connections' ? s.tabActive : s.tab, onClick: function() { setTab('connections'); } },
+        h('span', { style: css('display: inline-flex; align-items: center; gap: 6px;') }, h('span', { style: css('display: flex; transform: scale(0.7);') }, I.database()), 'Connections')),
+      h('div', { style: tab === 'agents' ? s.tabActive : s.tab, onClick: function() { setTab('agents'); } },
+        h('span', { style: css('display: inline-flex; align-items: center; gap: 6px;') }, h('span', { style: css('display: flex; transform: scale(0.7);') }, I.shield()), 'Agent Access')),
+      h('div', { style: tab === 'audit' ? s.tabActive : s.tab, onClick: function() { setTab('audit'); } },
+        h('span', { style: css('display: inline-flex; align-items: center; gap: 6px;') }, h('span', { style: css('display: flex; transform: scale(0.7);') }, I.audit()), 'Audit Log')),
     ),
 
     // Content
@@ -305,7 +308,45 @@ function AgentAccessTab(props) {
 
 // ─── Audit Tab ───────────────────────────────────────────────────────────────
 
+var AUDIT_PAGE_SIZE = 15;
+
 function AuditTab(props) {
+  var [search, setSearch] = useState('');
+  var [opFilter, setOpFilter] = useState('all');
+  var [statusFilter, setStatusFilter] = useState('all');
+  var [agentFilter, setAgentFilter] = useState('all');
+  var [page, setPage] = useState(0);
+  var [expanded, setExpanded] = useState(null);
+
+  // Get unique agents from audit log
+  var agents = [];
+  var agentSet = {};
+  props.auditLog.forEach(function(e) {
+    var name = e.agent_name || e.agent_id;
+    if (name && !agentSet[name]) { agentSet[name] = true; agents.push(name); }
+  });
+
+  // Filter entries
+  var filtered = props.auditLog.filter(function(e) {
+    if (opFilter !== 'all' && e.operation !== opFilter) return false;
+    if (statusFilter === 'ok' && !e.success) return false;
+    if (statusFilter === 'fail' && e.success) return false;
+    if (agentFilter !== 'all' && (e.agent_name || e.agent_id) !== agentFilter) return false;
+    if (search) {
+      var q = search.toLowerCase();
+      var haystack = ((e.query || '') + ' ' + (e.agent_name || '') + ' ' + (e.connection_name || '') + ' ' + (e.error || '')).toLowerCase();
+      if (haystack.indexOf(q) < 0) return false;
+    }
+    return true;
+  });
+
+  var totalPages = Math.max(1, Math.ceil(filtered.length / AUDIT_PAGE_SIZE));
+  if (page >= totalPages) page = totalPages - 1;
+  var paged = filtered.slice(page * AUDIT_PAGE_SIZE, (page + 1) * AUDIT_PAGE_SIZE);
+
+  // Reset page when filters change
+  var resetPage = function() { setPage(0); };
+
   if (props.auditLog.length === 0) {
     return h('div', { style: s.emptyState },
       h('div', { style: s.emptyIcon }, I.audit()),
@@ -314,37 +355,114 @@ function AuditTab(props) {
     );
   }
 
-  return h('div', { style: css('overflow-x: auto;') },
-    h('table', { style: s.auditTable },
-      h('thead', null, h('tr', null,
-        h('th', { style: s.auditTh }, 'Time'),
-        h('th', { style: s.auditTh }, 'Agent'),
-        h('th', { style: s.auditTh }, 'Database'),
-        h('th', { style: s.auditTh }, 'Op'),
-        h('th', { style: s.auditTh }, 'Query'),
-        h('th', { style: s.auditTh }, 'Rows'),
-        h('th', { style: s.auditTh }, 'Time'),
-        h('th', { style: s.auditTh }, 'Status'),
-      )),
-      h('tbody', null,
-        props.auditLog.map(function(entry) {
-          var opColor = entry.operation === 'read' ? 'var(--success)' : entry.operation === 'write' ? 'var(--warning)' : entry.operation === 'delete' ? 'var(--danger)' : 'var(--text-muted)';
-          return h('tr', { key: entry.id },
-            h('td', { style: s.auditTd }, new Date(entry.timestamp).toLocaleString()),
-            h('td', { style: s.auditTd }, entry.agent_name || entry.agent_id?.slice(0, 8)),
-            h('td', { style: s.auditTd }, entry.connection_name || entry.connection_id?.slice(0, 8)),
-            h('td', { style: Object.assign({}, s.auditTd, { fontWeight: 600, color: opColor }) }, entry.operation),
-            h('td', { style: Object.assign({}, s.auditTd, { fontFamily: 'monospace', fontSize: '11px', maxWidth: '300px', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }) }, entry.query),
-            h('td', { style: s.auditTd }, entry.rows_affected),
-            h('td', { style: s.auditTd }, entry.execution_time_ms + 'ms'),
-            h('td', { style: s.auditTd }, entry.success
-              ? h('span', { style: Object.assign({}, s.badge, s.badgeActive) }, 'OK')
-              : h('span', { style: Object.assign({}, s.badge, s.badgeError), title: entry.error }, 'FAIL')
-            ),
-          );
-        })
+  var opColor = function(op) {
+    return op === 'read' ? 'var(--success)' : op === 'write' ? 'var(--warning)' : op === 'delete' ? 'var(--danger)' : op === 'schema' ? 'var(--accent)' : 'var(--text-muted)';
+  };
+
+  var filterBar = css('display: flex; gap: 8px; margin-bottom: 16px; flex-wrap: wrap; align-items: center;');
+  var filterSelect = css('padding: 6px 10px; border-radius: 6px; border: 1px solid var(--border); background: var(--bg-secondary); color: var(--text-primary); font-size: 12px;');
+  var searchInput = css('padding: 6px 10px; border-radius: 6px; border: 1px solid var(--border); background: var(--bg-primary); color: var(--text-primary); font-size: 12px; flex: 1; min-width: 180px;');
+  var countBadge = css('font-size: 11px; color: var(--text-muted); margin-left: auto; white-space: nowrap;');
+
+  return h('div', null,
+    // Filter bar
+    h('div', { style: filterBar },
+      h('div', { style: css('display: flex; align-items: center; gap: 4px; color: var(--text-muted);') },
+        h('span', { style: css('display: flex; transform: scale(0.65);') }, I.search()),
+      ),
+      h('input', { style: searchInput, placeholder: 'Search queries, agents, databases, errors...', value: search, onInput: function(e) { setSearch(e.target.value); resetPage(); } }),
+      h('select', { style: filterSelect, value: opFilter, onChange: function(e) { setOpFilter(e.target.value); resetPage(); } },
+        h('option', { value: 'all' }, 'All Operations'),
+        h('option', { value: 'read' }, 'Read'),
+        h('option', { value: 'write' }, 'Write'),
+        h('option', { value: 'delete' }, 'Delete'),
+        h('option', { value: 'schema' }, 'Schema'),
+        h('option', { value: 'execute' }, 'Execute'),
+      ),
+      h('select', { style: filterSelect, value: statusFilter, onChange: function(e) { setStatusFilter(e.target.value); resetPage(); } },
+        h('option', { value: 'all' }, 'All Status'),
+        h('option', { value: 'ok' }, 'Success'),
+        h('option', { value: 'fail' }, 'Failed'),
+      ),
+      agents.length > 1 && h('select', { style: filterSelect, value: agentFilter, onChange: function(e) { setAgentFilter(e.target.value); resetPage(); } },
+        h('option', { value: 'all' }, 'All Agents'),
+        agents.map(function(a) { return h('option', { key: a, value: a }, a); })
+      ),
+      h('span', { style: countBadge }, filtered.length + ' of ' + props.auditLog.length + ' entries'),
+      h('button', { style: Object.assign({}, s.btn, { padding: '4px 10px', fontSize: '11px' }), onClick: props.onRefresh }, 'Refresh'),
+    ),
+
+    // Table
+    h('div', { style: css('overflow-x: auto; border: 1px solid var(--border); border-radius: 8px;') },
+      h('table', { style: s.auditTable },
+        h('thead', null, h('tr', null,
+          h('th', { style: s.auditTh }, 'Time'),
+          h('th', { style: s.auditTh }, 'Agent'),
+          h('th', { style: s.auditTh }, 'Database'),
+          h('th', { style: s.auditTh }, 'Operation'),
+          h('th', { style: s.auditTh }, 'Query'),
+          h('th', { style: s.auditTh }, 'Rows'),
+          h('th', { style: s.auditTh }, 'Latency'),
+          h('th', { style: s.auditTh }, 'Status'),
+        )),
+        h('tbody', null,
+          paged.length === 0 && h('tr', null,
+            h('td', { colSpan: 8, style: Object.assign({}, s.auditTd, { textAlign: 'center', color: 'var(--text-muted)', padding: '24px' }) }, 'No entries match your filters')
+          ),
+          paged.map(function(entry) {
+            var isExpanded = expanded === entry.id;
+            return h(Fragment, { key: entry.id },
+              h('tr', { style: css('cursor: pointer; transition: background 0.1s;'), onClick: function() { setExpanded(isExpanded ? null : entry.id); } },
+                h('td', { style: s.auditTd }, new Date(entry.timestamp).toLocaleString()),
+                h('td', { style: Object.assign({}, s.auditTd, { fontWeight: 500 }) }, entry.agent_name || (entry.agent_id ? entry.agent_id.slice(0, 8) + '...' : '—')),
+                h('td', { style: s.auditTd }, entry.connection_name || (entry.connection_id ? entry.connection_id.slice(0, 8) + '...' : '—')),
+                h('td', { style: Object.assign({}, s.auditTd, { fontWeight: 600, color: opColor(entry.operation) }) }, entry.operation),
+                h('td', { style: Object.assign({}, s.auditTd, { fontFamily: 'monospace', fontSize: '11px', maxWidth: '300px', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }) }, entry.query),
+                h('td', { style: Object.assign({}, s.auditTd, { textAlign: 'right' }) }, entry.rows_affected != null ? entry.rows_affected : '—'),
+                h('td', { style: Object.assign({}, s.auditTd, { textAlign: 'right', whiteSpace: 'nowrap' }) }, entry.execution_time_ms != null ? entry.execution_time_ms + 'ms' : '—'),
+                h('td', { style: s.auditTd }, entry.success
+                  ? h('span', { style: Object.assign({}, s.badge, s.badgeActive) }, 'OK')
+                  : h('span', { style: Object.assign({}, s.badge, s.badgeError) }, 'FAIL')
+                ),
+              ),
+              // Expanded row detail
+              isExpanded && h('tr', null,
+                h('td', { colSpan: 8, style: css('padding: 12px 16px; background: var(--bg-secondary); border-bottom: 1px solid var(--border);') },
+                  h('div', { style: css('display: grid; grid-template-columns: 1fr 1fr; gap: 12px; font-size: 12px;') },
+                    h('div', null,
+                      h('div', { style: css('font-weight: 600; margin-bottom: 4px; color: var(--text-muted);') }, 'Full Query'),
+                      h('pre', { style: css('margin: 0; padding: 8px; background: var(--bg-primary); border-radius: 6px; overflow-x: auto; font-size: 11px; white-space: pre-wrap; word-break: break-all; max-height: 200px;') }, entry.query || '—'),
+                    ),
+                    h('div', null,
+                      h('div', { style: css('font-weight: 600; margin-bottom: 4px; color: var(--text-muted);') }, 'Details'),
+                      h('div', { style: css('display: flex; flex-direction: column; gap: 4px;') },
+                        h('div', null, h('strong', null, 'Agent ID: '), entry.agent_id || '—'),
+                        h('div', null, h('strong', null, 'Connection ID: '), entry.connection_id || '—'),
+                        h('div', null, h('strong', null, 'Rows Affected: '), entry.rows_affected != null ? String(entry.rows_affected) : '—'),
+                        h('div', null, h('strong', null, 'Execution Time: '), entry.execution_time_ms != null ? entry.execution_time_ms + 'ms' : '—'),
+                        h('div', null, h('strong', null, 'IP: '), entry.ip_address || '—'),
+                        !entry.success && entry.error && h('div', { style: css('margin-top: 4px; padding: 6px 8px; background: rgba(239,68,68,0.1); border-radius: 4px; color: var(--danger);') },
+                          h('strong', null, 'Error: '), entry.error
+                        ),
+                      ),
+                    ),
+                  ),
+                ),
+              ),
+            );
+          })
+        ),
       ),
     ),
+
+    // Pagination
+    totalPages > 1 && h('div', { style: css('display: flex; align-items: center; justify-content: center; gap: 8px; margin-top: 16px;') },
+      h('button', { style: Object.assign({}, s.btn, { padding: '4px 10px', fontSize: '12px' }), disabled: page === 0, onClick: function() { setPage(0); } }, '«'),
+      h('button', { style: Object.assign({}, s.btn, { padding: '4px 10px', fontSize: '12px' }), disabled: page === 0, onClick: function() { setPage(page - 1); } }, '‹'),
+      h('span', { style: css('font-size: 12px; color: var(--text-secondary);') }, 'Page ' + (page + 1) + ' of ' + totalPages),
+      h('button', { style: Object.assign({}, s.btn, { padding: '4px 10px', fontSize: '12px' }), disabled: page >= totalPages - 1, onClick: function() { setPage(page + 1); } }, '›'),
+      h('button', { style: Object.assign({}, s.btn, { padding: '4px 10px', fontSize: '12px' }), disabled: page >= totalPages - 1, onClick: function() { setPage(totalPages - 1); } }, '»'),
+    ),
   );
 }
 
@@ -355,26 +473,63 @@ function AddConnectionModal(props) {
   var [dbType, setDbType] = useState('');
   var [form, setForm] = useState({ name: '', host: '', port: '', database: '', username: '', password: '', connectionString: '', ssl: false, description: '' });
   var [saving, setSaving] = useState(false);
+  var [testing, setTesting] = useState(false);
+  var [testResult, setTestResult] = useState(null); // { success, error, latencyMs }
 
-  var set = function(key, val) { setForm(function(f) { var n = Object.assign({}, f); n[key] = val; return n; }); };
+  var set = function(key, val) { setForm(function(f) { var n = Object.assign({}, f); n[key] = val; return n; }); setTestResult(null); };
 
   var isConnString = form.connectionString.length > 0;
 
+  var buildBody = function() {
+    var body = { type: dbType, name: form.name || (ALL_DB_TYPES.find(function(t) { return t.value === dbType; })?.label + ' Connection'), description: form.description, status: 'inactive' };
+    if (isConnString) {
+      body.connectionString = form.connectionString;
+    } else {
+      body.host = form.host;
+      body.port = form.port ? parseInt(form.port) : undefined;
+      body.database = form.database;
+      body.username = form.username;
+      body.password = form.password;
+      body.ssl = form.ssl;
+    }
+    return body;
+  };
+
+  var testConnection = async function() {
+    setTesting(true);
+    setTestResult(null);
+    try {
+      var result = await engineCall('/database/connections/test', { method: 'POST', body: JSON.stringify(buildBody()) });
+      setTestResult(result);
+    } catch (e) {
+      setTestResult({ success: false, error: e.message || 'Connection test failed' });
+    }
+    setTesting(false);
+  };
+
   var save = async function() {
+    // Test connection first if not already tested successfully
+    if (!testResult || !testResult.success) {
+      setTesting(true);
+      setTestResult(null);
+      try {
+        var result = await engineCall('/database/connections/test', { method: 'POST', body: JSON.stringify(buildBody()) });
+        setTestResult(result);
+        if (!result.success) {
+          setTesting(false);
+          return; // Don't save if test fails
+        }
+      } catch (e) {
+        setTestResult({ success: false, error: e.message || 'Connection test failed' });
+        setTesting(false);
+        return;
+      }
+      setTesting(false);
+    }
+
     setSaving(true);
     try {
-      var body = { type: dbType, name: form.name || (ALL_DB_TYPES.find(function(t) { return t.value === dbType; })?.label + ' Connection'), description: form.description, status: 'inactive' };
-      if (isConnString) {
-        body.connectionString = form.connectionString;
-      } else {
-        body.host = form.host;
-        body.port = form.port ? parseInt(form.port) : undefined;
-        body.database = form.database;
-        body.username = form.username;
-        body.password = form.password;
-        body.ssl = form.ssl;
-      }
-      await engineCall('/database/connections', { method: 'POST', body: JSON.stringify(body) });
+      await engineCall('/database/connections', { method: 'POST', body: JSON.stringify(buildBody()) });
       props.onSave();
       props.onClose();
     } catch (e) { alert('Failed: ' + e.message); }
@@ -454,9 +609,21 @@ function AddConnectionModal(props) {
           h('div', { style: s.label }, 'Description (optional)'),
           h('input', { style: s.input, placeholder: 'What is this database used for?', value: form.description, onInput: function(e) { set('description', e.target.value); } }),
         ),
+        // Connection test result
+        testResult && h('div', { style: css('padding: 8px 12px; border-radius: 6px; font-size: 12px; ' + (testResult.success
+          ? 'background: rgba(21,128,61,0.1); color: var(--success); border: 1px solid rgba(21,128,61,0.3);'
+          : 'background: rgba(239,68,68,0.1); color: var(--danger); border: 1px solid rgba(239,68,68,0.3);')) },
+          testResult.success
+            ? 'Connection successful! (' + testResult.latencyMs + 'ms)'
+            : 'Connection failed: ' + (testResult.error || 'Unknown error'),
+        ),
+
         h('div', { style: css('display: flex; justify-content: space-between; margin-top: 8px;') },
           h('button', { style: s.btn, onClick: function() { setStep(1); } }, '← Back'),
-          h('button', { style: s.btnPrimary, disabled: saving || (!isConnString && !form.host), onClick: save }, saving ? 'Saving...' : 'Add Connection'),
+          h('div', { style: css('display: flex; gap: 8px;') },
+            h('button', { style: s.btn, disabled: testing || saving || (!isConnString && !form.host), onClick: testConnection }, testing ? 'Testing...' : 'Test Connection'),
+            h('button', { style: s.btnPrimary, disabled: testing || saving || (!isConnString && !form.host), onClick: save }, saving ? 'Saving...' : testing ? 'Testing...' : 'Add Connection'),
+          ),
         ),
       ),
     ),

package/src/database-access/connection-manager.ts

@@ -534,6 +534,34 @@ export class DatabaseConnectionManager {
     }
   }
 
+  /**
+   * Test connection parameters without saving — creates a temporary connection,
+   * pings it, and immediately destroys it.
+   */
+  async testConnectionParams(params: {
+    type: string; host?: string; port?: number; database?: string;
+    username?: string; password?: string; connectionString?: string; ssl?: boolean;
+  }): Promise<{ success: boolean; latencyMs: number; error?: string }> {
+    const startMs = Date.now();
+    const driver = this.drivers.get(params.type as any);
+    if (!driver) return { success: false, latencyMs: 0, error: `No driver for database type: ${params.type}` };
+
+    let connection: any;
+    try {
+      connection = await driver.connect(
+        { type: params.type as any, host: params.host, port: params.port, database: params.database, ssl: params.ssl } as any,
+        { password: params.password, connectionString: params.connectionString },
+      );
+      const alive = await connection.ping();
+      const latencyMs = Date.now() - startMs;
+      return { success: alive, latencyMs };
+    } catch (err: any) {
+      return { success: false, latencyMs: Date.now() - startMs, error: err.message };
+    } finally {
+      try { if (connection?.close) await connection.close(); } catch {}
+    }
+  }
+
   // ─── Pool Management ───────────────────────────────────────────────────────
 
   private async getPooledConnection(connectionId: string): Promise<DatabaseConnection> {

package/src/database-access/routes.ts

@@ -88,7 +88,29 @@ export function createDatabaseAccessRoutes(manager: DatabaseConnectionManager) {
     return c.json({ ok: true });
   });
 
-  /** Test a database connection */
+  /** Test connection parameters before saving (no persistence) — must come before :id routes */
+  router.post('/connections/test', async (c) => {
+    const body = await c.req.json();
+    if (!body.type) return c.json({ error: 'type is required' }, 400);
+    const startMs = Date.now();
+    try {
+      const result = await manager.testConnectionParams({
+        type: body.type,
+        host: body.host,
+        port: body.port,
+        database: body.database,
+        username: body.username,
+        password: body.password,
+        connectionString: body.connectionString,
+        ssl: body.ssl,
+      });
+      return c.json(result);
+    } catch (e: any) {
+      return c.json({ success: false, latencyMs: Date.now() - startMs, error: e.message || 'Connection test failed' });
+    }
+  });
+
+  /** Test an existing database connection */
   router.post('/connections/:id/test', async (c) => {
     const result = await manager.testConnection(c.req.param('id'));
     return c.json(result);

package/src/runtime/index.ts

@@ -228,6 +228,10 @@ export class AgentRuntime {
     if (this.config.mcpProcessManager) {
       base.mcpProcessManager = this.config.mcpProcessManager;
     }
+    // Database Connection Manager — enterprise database access tools
+    if (this.config.databaseManager) {
+      base.databaseManager = this.config.databaseManager;
+    }
     return base;
   }
 

package/src/runtime/types.ts

@@ -140,6 +140,8 @@ export interface RuntimeConfig {
   permissionEngine?: any;
   /** MCP Process Manager for external MCP server tools */
   mcpProcessManager?: import('../engine/mcp-process-manager.js').McpProcessManager;
+  /** Database Connection Manager for enterprise database access tools */
+  databaseManager?: import('../database-access/connection-manager.js').DatabaseConnectionManager;
   /** Knowledge base engine for RAG search tools */
   knowledgeEngine?: any;
   /** Real-time agent status tracker */

package/src/server.ts

@@ -355,7 +355,7 @@ export function createServer(config: ServerConfig): ServerInstance {
                 };
               }
             } catch {}
-            const { vault: vaultRef, permissionEngine: permRef } = await import('./engine/routes.js');
+            const { vault: vaultRef, permissionEngine: permRef, databaseManager: dbMgr } = await import('./engine/routes.js');
             const runtime = createAgentRuntime({
               engineDb,
               adminDb: config.db,
@@ -367,7 +367,8 @@ export function createServer(config: ServerConfig): ServerInstance {
               agentMemoryManager: agentMemoryMgr,
               vault: vaultRef,
               permissionEngine: permRef,
-            });
+              databaseManager: dbMgr,
+            } as any);
             await runtime.start();
             const runtimeApp = runtime.getApp();
             if (runtimeApp) {
@@ -620,7 +621,7 @@ export function createServer(config: ServerConfig): ServerInstance {
                             };
                           }
                         } catch {}
-                        const { vault: vaultRef2, permissionEngine: permRef2 } = await import('./engine/routes.js');
+                        const { vault: vaultRef2, permissionEngine: permRef2, databaseManager: dbMgr2 } = await import('./engine/routes.js');
                         const runtime = createAgentRuntime({
                           engineDb,
                           adminDb: config.db,
@@ -633,7 +634,8 @@ export function createServer(config: ServerConfig): ServerInstance {
                           vault: vaultRef2,
                           permissionEngine: permRef2,
                           hierarchyManager: (await import('./engine/routes.js')).hierarchyManager ?? undefined,
-                        });
+                          databaseManager: dbMgr2,
+                        } as any);
                         await runtime.start();
                         const runtimeApp = runtime.getApp();
                         if (runtimeApp) mountRuntimeApp(runtimeApp);