@agenticmail/enterprise 0.5.11 → 0.5.13

package/src/dashboard/pages/agents.js

@@ -244,12 +244,20 @@ export function CreateAgentWizard({ onClose, onCreated, toast }) {
   const [selectedSoul, setSelectedSoul] = useState(null);
   const [previewOpen, setPreviewOpen] = useState(false);
   const [loading, setLoading] = useState(false);
+  const [showSetupGuide, setShowSetupGuide] = useState(false);
+  const [setupChecked, setSetupChecked] = useState(false);
 
   useEffect(() => {
     engineCall('/skills/by-category').then(d => setAllSkills(d.categories || {})).catch(() => {});
     engineCall('/profiles/presets').then(d => setPresets(d.presets || [])).catch(() => {});
     engineCall('/souls/by-category').then(d => { setSoulCategories(d.categories || {}); setSoulMeta(d.categoryMeta || {}); }).catch(() => {});
-    apiCall('/providers').then(function(d) { setProviders(d.providers || []); }).catch(function() {});
+    apiCall('/providers').then(function(d) {
+      var provList = d.providers || [];
+      setProviders(provList);
+      var hasConfigured = provList.some(function(p) { return p.configured; });
+      if (!hasConfigured) { setShowSetupGuide(true); }
+      setSetupChecked(true);
+    }).catch(function() { setShowSetupGuide(true); setSetupChecked(true); });
   }, []);
 
   // Fetch models when provider changes
@@ -452,6 +460,59 @@ export function CreateAgentWizard({ onClose, onCreated, toast }) {
 
   const stepIcons = ['soul', 'basics', 'skills', 'perms', 'deploy', 'review'];
 
+  // ─── Setup Guide Modal ───────────────────────────────────
+  if (showSetupGuide) {
+    return h('div', { className: 'modal-overlay', onClick: e => { if (e.target === e.currentTarget) onClose(); } },
+      h('div', { className: 'modal', style: { maxWidth: 600 } },
+        h('div', { className: 'modal-header' },
+          h('div', null,
+            h('h2', null, '⚡ Setup Required'),
+            h('p', { style: { fontSize: 12, color: 'var(--text-muted)', margin: '2px 0 0', fontWeight: 400 } }, 'Complete these steps before creating your first agent')
+          ),
+          h('button', { className: 'btn btn-ghost btn-icon', onClick: onClose }, I.x())
+        ),
+        h('div', { className: 'modal-body', style: { padding: '24px' } },
+          h('p', { style: { marginBottom: 20, color: 'var(--text-secondary)', lineHeight: 1.6 } },
+            'Your agents need an LLM provider (like Anthropic or OpenAI) to think and act. Set up at least one provider with an API key before creating agents.'
+          ),
+          h('div', { style: { display: 'flex', flexDirection: 'column', gap: 16 } },
+            h('div', { style: { padding: 16, borderRadius: 'var(--radius-lg)', border: '1px solid var(--border)', background: 'var(--bg-secondary)' } },
+              h('div', { style: { display: 'flex', alignItems: 'center', gap: 12, marginBottom: 8 } },
+                h('div', { style: { width: 28, height: 28, borderRadius: '50%', background: 'var(--accent)', color: '#fff', display: 'flex', alignItems: 'center', justifyContent: 'center', fontWeight: 700, fontSize: 14, flexShrink: 0 } }, '1'),
+                h('strong', null, 'Add an LLM Provider API Key')
+              ),
+              h('p', { style: { margin: 0, color: 'var(--text-muted)', fontSize: 13, paddingLeft: 40, lineHeight: 1.5 } },
+                'Go to Settings → LLM Providers and add your API key for at least one provider. Recommended: Anthropic (Claude) or OpenAI (GPT).'
+              )
+            ),
+            h('div', { style: { padding: 16, borderRadius: 'var(--radius-lg)', border: '1px solid var(--border)', background: 'var(--bg-secondary)' } },
+              h('div', { style: { display: 'flex', alignItems: 'center', gap: 12, marginBottom: 8 } },
+                h('div', { style: { width: 28, height: 28, borderRadius: '50%', background: 'var(--accent)', color: '#fff', display: 'flex', alignItems: 'center', justifyContent: 'center', fontWeight: 700, fontSize: 14, flexShrink: 0 } }, '2'),
+                h('strong', null, 'Configure Email Domain (Optional)')
+              ),
+              h('p', { style: { margin: 0, color: 'var(--text-muted)', fontSize: 13, paddingLeft: 40, lineHeight: 1.5 } },
+                'Set up your email domain in Settings → Domain so agents can send and receive emails as agent@yourdomain.com.'
+              )
+            ),
+            h('div', { style: { padding: 16, borderRadius: 'var(--radius-lg)', border: '1px solid var(--border)', background: 'var(--bg-secondary)' } },
+              h('div', { style: { display: 'flex', alignItems: 'center', gap: 12, marginBottom: 8 } },
+                h('div', { style: { width: 28, height: 28, borderRadius: '50%', background: 'var(--accent)', color: '#fff', display: 'flex', alignItems: 'center', justifyContent: 'center', fontWeight: 700, fontSize: 14, flexShrink: 0 } }, '3'),
+                h('strong', null, 'Set Security Policies (Optional)')
+              ),
+              h('p', { style: { margin: 0, color: 'var(--text-muted)', fontSize: 13, paddingLeft: 40, lineHeight: 1.5 } },
+                'Review Settings → Guardrails to set tool approval policies, rate limits, and data loss prevention rules.'
+              )
+            )
+          ),
+          h('div', { style: { display: 'flex', gap: 12, marginTop: 24, justifyContent: 'flex-end' } },
+            h('button', { className: 'btn btn-ghost', onClick: function() { setShowSetupGuide(false); } }, 'Skip for Now'),
+            h('a', { href: '#/settings', className: 'btn btn-primary', onClick: function() { onClose(); } }, 'Go to Settings')
+          )
+        )
+      )
+    );
+  }
+
   return h('div', { className: 'modal-overlay', onClick: e => { if (e.target === e.currentTarget) onClose(); } },
     h('div', { className: 'modal modal-xl' },
       h('div', { className: 'modal-header' },
@@ -669,14 +730,14 @@ export function CreateAgentWizard({ onClose, onCreated, toast }) {
                     value: form.provider || 'anthropic',
                     onChange: function(e) { setForm(Object.assign({}, form, { provider: e.target.value })); },
                   },
-                    providers.length > 0
+                    providers.length > 0 && providers.some(function(p) { return p.configured; })
                       ? providers.filter(function(p) { return p.configured; }).map(function(p) {
                           return h('option', { key: p.id, value: p.id }, p.name + (p.isLocal ? ' (Local)' : ''));
                         })
                       : [
-                          h('option', { value: 'anthropic' }, 'Anthropic'),
-                          h('option', { value: 'openai' }, 'OpenAI'),
-                          h('option', { value: 'google' }, 'Google'),
+                          h('option', { value: 'anthropic' }, 'Anthropic (Claude)'),
+                          h('option', { value: 'openai' }, 'OpenAI (GPT)'),
+                          h('option', { value: 'google' }, 'Google (Gemini)'),
                           h('option', { value: 'deepseek' }, 'DeepSeek'),
                           h('option', { value: 'xai' }, 'xAI (Grok)'),
                           h('option', { value: 'mistral' }, 'Mistral'),

package/src/db/postgres.ts

@@ -116,6 +116,12 @@ export class PostgresAdapter extends DatabaseAdapter {
   }
 
   async updateSettings(updates: Partial<CompanySettings>): Promise<CompanySettings> {
+    // Ensure default row exists first
+    await this.pool.query(
+      `INSERT INTO company_settings (id, name, subdomain) VALUES ('default', '', '')
+       ON CONFLICT (id) DO NOTHING`
+    );
+
     const fields: string[] = [];
     const values: any[] = [];
     let i = 1;