@agenticmail/enterprise 0.5.198 → 0.5.200

package/src/dashboard/pages/vault.js

@@ -1,6 +1,7 @@
 import { h, useState, useEffect, useCallback, Fragment, useApp, engineCall, getOrgId } from '../components/utils.js';
 import { I } from '../components/icons.js';
 import { Modal } from '../components/modal.js';
+import { HelpButton } from '../components/help-button.js';
 
 var PAGE_SIZE = 25;
 
@@ -522,7 +523,16 @@ export function VaultPage() {
 
       h('div', { className: 'card' },
         h('div', { className: 'card-header' },
-          h('h3', { style: { fontSize: 14, fontWeight: 600 } }, 'Secrets by Category')
+          h('h3', { style: { fontSize: 14, fontWeight: 600, display: 'flex', alignItems: 'center' } }, 'Secrets by Category', h(HelpButton, { label: 'Secrets by Category' },
+            h('p', null, 'Breakdown of stored secrets by their category. Helps you understand what types of credentials are in your vault.'),
+            h('ul', { style: { paddingLeft: 20, margin: '4px 0 8px' } },
+              h('li', null, h('strong', null, 'Deploy Credentials'), ' — Infrastructure and deployment secrets.'),
+              h('li', null, h('strong', null, 'Skill Credentials'), ' — API keys for agent tools (OpenAI, Slack, etc).'),
+              h('li', null, h('strong', null, 'Cloud Storage'), ' — AWS, GCP, and other cloud provider keys.'),
+              h('li', null, h('strong', null, 'API Keys'), ' — General-purpose API keys.'),
+              h('li', null, h('strong', null, 'Custom'), ' — User-defined secrets.')
+            )
+          ))
         ),
         h('div', { className: 'card-body' },
           Object.keys(byCategory).length === 0
@@ -563,7 +573,17 @@ export function VaultPage() {
   return h(Fragment, null,
     h('div', { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 20 } },
       h('div', null,
-        h('h1', { style: { fontSize: 20, fontWeight: 700 } }, 'Vault'),
+        h('h1', { style: { fontSize: 20, fontWeight: 700, display: 'flex', alignItems: 'center' } }, 'Vault', h(HelpButton, { label: 'Vault' },
+          h('p', null, 'Securely store and manage API keys, passwords, and credentials used by your agents. All secrets are encrypted at rest with AES-256-GCM.'),
+          h('h4', { style: { marginTop: 16, marginBottom: 8, fontSize: 14 } }, 'Key features'),
+          h('ul', { style: { paddingLeft: 20, margin: '4px 0 8px' } },
+            h('li', null, h('strong', null, 'Platform presets'), ' — Quick setup for OpenAI, Anthropic, GitHub, Stripe, and more.'),
+            h('li', null, h('strong', null, 'Key rotation'), ' — Re-encrypt secrets with fresh keys without changing the value.'),
+            h('li', null, h('strong', null, 'Full audit trail'), ' — Every read, create, delete, and rotate is logged.'),
+            h('li', null, h('strong', null, 'Auto-detection'), ' — Secrets stored as skill:<platform>:<key> are auto-detected by agent tools.')
+          ),
+          h('div', { style: { marginTop: 12, padding: 12, background: 'var(--bg-secondary, #1e293b)', borderRadius: 'var(--radius, 8px)', fontSize: 13 } }, h('strong', null, 'Tip: '), 'Rotate secrets periodically. Use "Rotate All" for bulk re-encryption after a security incident.')
+        )),
         h('p', { style: { color: 'var(--text-muted)', fontSize: 13 } }, 'Encrypted secrets management with AES-256-GCM')
       ),
       h('button', { className: 'btn btn-secondary', onClick: function() { loadSecrets(); loadStatus(); if (tab === 'audit') loadAudit(); } }, I.refresh(), ' Refresh')

package/src/dashboard/pages/workforce.js

@@ -1,6 +1,7 @@
 import { h, useState, useEffect, useCallback, Fragment, useApp, engineCall, buildAgentEmailMap, resolveAgentEmail, buildAgentDataMap, renderAgentBadge, getOrgId } from '../components/utils.js';
 import { I } from '../components/icons.js';
 import { TimezoneSelect } from '../components/timezones.js';
+import { HelpButton } from '../components/help-button.js';
 
 export function WorkforcePage() {
   const { toast } = useApp();
@@ -245,9 +246,24 @@ export function WorkforcePage() {
     { key: 'history', label: 'Clock History' },
   ];
 
+  var _h4 = { marginTop: 16, marginBottom: 8, fontSize: 14 };
+  var _ul = { paddingLeft: 20, margin: '4px 0 8px' };
+  var _tip = { marginTop: 12, padding: 12, background: 'var(--bg-secondary, #1e293b)', borderRadius: 'var(--radius, 8px)', fontSize: 13 };
+
   return h('div', { className: 'page-inner' },
     h('div', { className: 'page-header' },
-      h('h1', null, 'Workforce Management'),
+      h('h1', { style: { display: 'flex', alignItems: 'center' } }, 'Workforce Management', h(HelpButton, { label: 'Workforce Management' },
+        h('p', null, 'Manage your agents like employees — set work schedules, assign tasks, track budgets, and monitor clock-in/out history.'),
+        h('h4', { style: _h4 }, 'Key sections'),
+        h('ul', { style: _ul },
+          h('li', null, h('strong', null, 'Overview'), ' — See which agents are clocked in, off duty, or unscheduled.'),
+          h('li', null, h('strong', null, 'Schedules'), ' — Define working hours, shifts, and auto-wake rules.'),
+          h('li', null, h('strong', null, 'Task Queue'), ' — Assign and track tasks for specific agents.'),
+          h('li', null, h('strong', null, 'Budgets'), ' — Set token caps to control agent spending.'),
+          h('li', null, h('strong', null, 'Clock History'), ' — Audit trail of all clock-in/out events.')
+        ),
+        h('div', { style: _tip }, h('strong', null, 'Tip: '), 'Use schedules with auto-wake to have agents automatically start working at their scheduled time each day.')
+      )),
       h('button', { className: 'btn btn-ghost', onClick: loadData }, I.refresh(), ' Refresh')
     ),
     // Tab bar

package/dashboards/README.md

@@ -1,131 +0,0 @@
-# AgenticMail Enterprise Dashboards
-
-**Admin dashboards in every popular language.** Pick the one that matches your stack — or use the zero-code HTML version if you're not a developer.
-
-All dashboards connect to the same AgenticMail Enterprise API. They're interchangeable. Each is modular with separate files for routes, views, components, and utilities.
-
----
-
-## Quick Start
-
-| Language | Entry | Dependencies | Run Command | Files |
-|----------|-------|-------------|-------------|-------|
-| **HTML/JS** | `html/` | esbuild | `cd html && npm i && npm run dev` | 24 |
-| **PHP** | `php/index.php` | PHP 7.4+ | `php -S localhost:8080 index.php` | 16 |
-| **Python/Flask** | `python/app.py` | Flask, requests | `pip install flask requests && python app.py` | 24 |
-| **Ruby/Sinatra** | `ruby/app.rb` | Sinatra | `gem install sinatra && ruby app.rb` | 20 |
-| **Express.js** | `express/app.js` | Express | `npm i express express-session && node app.js` | 17 |
-| **Go** | `go/main.go` | None (stdlib) | `cd go && go run .` | 16 |
-| **Java** | `java/AgenticMailDashboard.java` | JDK 11+ | `javac *.java **/*.java && java AgenticMailDashboard` | 14 |
-| **C# / .NET** | `dotnet/Program.cs` | .NET 8+ | `cd dotnet && dotnet run` | 12 |
-| **Django** | `django/app.py` | Django, requests | `pip install django requests && python app.py` | 24 |
-| **Laravel** | `laravel/index.php` | PHP 8.0+ | `php -S localhost:8080 index.php` | 22 |
-| **Rails/Sinatra** | `rails/app.rb` | Sinatra | `gem install sinatra && ruby app.rb` | 20 |
-| **React** (built-in) | _Served at `/dashboard`_ | None | Comes with the enterprise server | — |
-
----
-
-## Project Structure
-
-Every dashboard follows an idiomatic modular structure for its language:
-
-```
-dashboards/<language>/
-├── entry point          # App setup, routing, config
-├── routes/              # One file per resource (agents, users, api-keys, etc.)
-├── views/ or templates/ # Page templates + reusable components
-├── utils/ or helpers/   # API client, HTML escaping, badges, time formatting
-├── middleware/           # Auth guards (where applicable)
-├── components/          # Reusable UI: modals, tables, stat cards, pagination
-└── public/ or static/   # styles.css (shared design system)
-```
-
-### Shared Design System
-
-All dashboards use `shared/styles.css` — a unified CSS design system with:
-- CSS custom properties for light/dark themes
-- Pink accent color (`#e84393`)
-- Sidebar, cards, tables, badges, buttons, forms, modals, pagination, flash messages
-- Dark mode toggle + `@media(prefers-color-scheme: dark)` support
-- Responsive sidebar (collapses at 768px)
-
-Copy `shared/styles.css` into your dashboard's `public/` or `static/` folder.
-
----
-
-## Feature Parity
-
-Every dashboard implements the full feature set:
-
-| Feature | Description |
-|---------|-------------|
-| **Login/Logout** | Email + password auth, JWT session |
-| **Dashboard** | 4 stat cards + recent audit events |
-| **Agents** | List, create (name/model/description), archive with confirm |
-| **Users** | List, create (name/email/role), role badges |
-| **API Keys** | List, create (name/scopes), revoke, show-once key banner |
-| **Audit Log** | Paginated (25/page), prev/next, total count |
-| **Settings** | Read + update (org name, model, limits, webhook), instance info |
-| **Dark Mode** | Toggle with localStorage persistence |
-| **Flash Messages** | Success/danger feedback on all actions |
-| **Responsive** | Mobile-friendly sidebar collapse |
-
----
-
-## Configuration
-
-All dashboards use one environment variable:
-
-```bash
-AGENTICMAIL_URL=https://your-company.agenticmail.io
-```
-
----
-
-## API Endpoints
-
-Every dashboard talks to the **AgenticMail Enterprise REST API**:
-
-```
-Your Dashboard  ->  REST API  ->  AgenticMail Enterprise Server
-(any language)     (JSON)        (your database)
-```
-
-| Method | Endpoint | Description |
-|--------|----------|-------------|
-| `POST` | `/auth/login` | Get JWT token |
-| `GET` | `/api/stats` | Dashboard statistics |
-| `GET` | `/api/agents` | List agents |
-| `POST` | `/api/agents` | Create agent |
-| `PATCH` | `/api/agents/:id` | Update/archive agent |
-| `GET` | `/api/users` | List users |
-| `POST` | `/api/users` | Create user |
-| `GET` | `/api/api-keys` | List API keys |
-| `POST` | `/api/api-keys` | Create API key |
-| `DELETE` | `/api/api-keys/:id` | Revoke API key |
-| `GET` | `/api/audit` | Audit log (paginated) |
-| `GET` | `/api/settings` | Organization settings |
-| `PATCH` | `/api/settings` | Update settings |
-
----
-
-## Build Your Own
-
-```bash
-# Login
-curl -X POST https://your-server/auth/login \
-  -H "Content-Type: application/json" \
-  -d '{"email":"admin@agenticmail.io","password":"..."}'
-# Returns: { "token": "eyJ...", "user": {...} }
-
-# Use the token
-curl https://your-server/api/stats \
-  -H "Authorization: Bearer eyJ..."
-# Returns: { "totalAgents": 5, "activeAgents": 3, ... }
-```
-
----
-
-## License
-
-MIT — Use these dashboards however you want.

package/dashboards/django/app.py

@@ -1,129 +0,0 @@
-"""
-AgenticMail Enterprise Dashboard — Django Edition
-
-Modular Django app. No project scaffolding needed.
-
-Setup:
-    pip install django requests
-    python app.py
-
-Or with environment variable:
-    AGENTICMAIL_URL=https://your-company.agenticmail.io python app.py
-"""
-
-import os, sys, secrets
-
-# ─── Ensure the django/ directory is on sys.path ─────────
-# This allows `from views.xxx import ...` and `from utils.xxx import ...`
-# to work when app.py is the entry point.
-APP_DIR = os.path.dirname(os.path.abspath(__file__))
-if APP_DIR not in sys.path:
-    sys.path.insert(0, APP_DIR)
-
-TEMPLATES_DIR = os.path.join(APP_DIR, 'templates')
-STATIC_DIR = os.path.join(APP_DIR, 'static')
-
-# ─── Django Configuration ─────────────────────────────────
-
-os.environ.setdefault('DJANGO_SETTINGS_MODULE', '__main__')
-
-SECRET_KEY = secrets.token_hex(32)
-DEBUG = True
-ALLOWED_HOSTS = ['*']
-ROOT_URLCONF = '__main__'
-INSTALLED_APPS = ['django.contrib.sessions', 'django.contrib.contenttypes']
-MIDDLEWARE = [
-    'django.middleware.common.CommonMiddleware',
-    'django.contrib.sessions.middleware.SessionMiddleware',
-]
-SESSION_ENGINE = 'django.contrib.sessions.backends.signed_cookies'
-SESSION_COOKIE_HTTPONLY = True
-TEMPLATES = [{
-    'BACKEND': 'django.template.backends.django.DjangoTemplates',
-    'DIRS': [TEMPLATES_DIR],
-    'APP_DIRS': False,
-    'OPTIONS': {
-        'context_processors': [],
-    },
-}]
-STATICFILES_DIRS = [STATIC_DIR]
-
-# ─── Django Setup ─────────────────────────────────────────
-
-import django
-from django.conf import settings as django_settings
-if not django_settings.configured:
-    django_settings.configure(
-        SECRET_KEY=SECRET_KEY,
-        DEBUG=DEBUG,
-        ALLOWED_HOSTS=ALLOWED_HOSTS,
-        ROOT_URLCONF=ROOT_URLCONF,
-        INSTALLED_APPS=INSTALLED_APPS,
-        MIDDLEWARE=MIDDLEWARE,
-        SESSION_ENGINE=SESSION_ENGINE,
-        SESSION_COOKIE_HTTPONLY=SESSION_COOKIE_HTTPONLY,
-        TEMPLATES=TEMPLATES,
-        STATICFILES_DIRS=STATICFILES_DIRS,
-    )
-    django.setup()
-
-# ─── URL Patterns ─────────────────────────────────────────
-
-from django.urls import path
-from views import (
-    login_view, logout_view, dashboard_view,
-    agents_view, agent_detail_view, provider_models_view,
-    users_view, api_keys_view,
-    audit_view, settings_view,
-    dlp_view, guardrails_view, journal_view,
-    messages_view, compliance_view,
-    vault_view, skills_view,
-    # New pages
-    activity_view, approvals_view, community_skills_view, domain_status_view,
-    knowledge_view, knowledge_contributions_view, skill_connections_view, workforce_view,
-)
-
-urlpatterns = [
-    path('login', login_view),
-    path('logout', logout_view),
-    path('', dashboard_view),
-    path('agents', agents_view),
-    path('agents/<str:agent_id>', agent_detail_view),
-    path('api/providers/<str:provider_id>/models', provider_models_view),
-    path('users', users_view),
-    path('api-keys', api_keys_view),
-    path('audit', audit_view),
-    path('settings', settings_view),
-    path('dlp', dlp_view),
-    path('guardrails', guardrails_view),
-    path('journal', journal_view),
-    path('messages', messages_view),
-    path('compliance', compliance_view),
-    path('vault', vault_view),
-    path('skills', skills_view),
-    # New pages
-    path('activity', activity_view),
-    path('approvals', approvals_view),
-    path('community-skills', community_skills_view),
-    path('domain-status', domain_status_view),
-    path('knowledge', knowledge_view),
-    path('knowledge-contributions', knowledge_contributions_view),
-    path('skill-connections', skill_connections_view),
-    path('workforce', workforce_view),
-]
-
-# ─── WSGI Application ────────────────────────────────────
-
-from django.core.wsgi import get_wsgi_application
-application = get_wsgi_application()
-
-# ─── Run Server ───────────────────────────────────────────
-
-if __name__ == '__main__':
-    from django.core.management import execute_from_command_line
-    API_URL = os.getenv('AGENTICMAIL_URL', 'http://localhost:3000')
-    port = os.getenv('PORT', '5002')
-    print(f'\n\U0001f3e2 AgenticMail Enterprise Dashboard (Django)')
-    print(f'   API:       {API_URL}')
-    print(f'   Dashboard: http://localhost:{port}\n')
-    execute_from_command_line(['app.py', 'runserver', f'0.0.0.0:{port}', '--noreload'])