@agenticmail/enterprise 0.3.2 → 0.4.0

package/dashboards/python/templates/skills.html

@@ -0,0 +1,89 @@
+{% extends "layout.html" %}
+
+{% block content %}
+<div class="page-header">
+  <h1>Skills</h1>
+  <p>Browse builtin skills and manage installed community skills</p>
+</div>
+
+<!-- Builtin Skills -->
+<div class="card">
+  <h3>Builtin Skills</h3>
+  {% if categories %}
+  <div style="display: grid; grid-template-columns: repeat(auto-fill, minmax(260px, 1fr)); gap: 12px;">
+    {% for category, skill_list in categories.items() %}
+    <div class="skill-card" style="border: 1px solid var(--border-color, #dee2e6); border-radius: 8px; padding: 14px;">
+      <div style="font-weight: 600; margin-bottom: 8px; text-transform: capitalize;">{{ category }}</div>
+      {% for skill in skill_list %}
+      <div style="font-size: 13px; padding: 4px 0; color: var(--text-muted);">
+        <span style="font-weight: 500; color: var(--text-color, #212529);">{{ skill.name }}</span>
+        {% if skill.description %}
+        <span style="font-size: 11px;"> &mdash; {{ skill.description }}</span>
+        {% endif %}
+      </div>
+      {% endfor %}
+    </div>
+    {% endfor %}
+  </div>
+  {% else %}
+  <div class="empty">
+    <span class="icon">No builtin skills available</span>
+  </div>
+  {% endif %}
+</div>
+
+<!-- Installed Community Skills -->
+<div class="card">
+  <h3>Installed Community Skills</h3>
+  {% if installed %}
+  <div class="table-wrap">
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Version</th>
+          <th>Status</th>
+          <th></th>
+        </tr>
+      </thead>
+      <tbody>
+        {% for s in installed %}
+        <tr>
+          <td style="font-weight: 600;">{{ s.name }}</td>
+          <td style="font-size: 12px; color: var(--text-muted);">{{ s.version or '-' }}</td>
+          <td>
+            {% if s.enabled %}
+              {{ 'enabled'|status_badge }}
+            {% else %}
+              {{ 'disabled'|status_badge }}
+            {% endif %}
+          </td>
+          <td style="display: flex; gap: 4px;">
+            {% if s.enabled %}
+            <form method="POST" action="{{ url_for('skills_bp.disable_skill') }}" style="display: inline;">
+              <input type="hidden" name="skill_id" value="{{ s.id }}">
+              <button class="btn btn-sm" type="submit">Disable</button>
+            </form>
+            {% else %}
+            <form method="POST" action="{{ url_for('skills_bp.enable_skill') }}" style="display: inline;">
+              <input type="hidden" name="skill_id" value="{{ s.id }}">
+              <button class="btn btn-sm btn-primary" type="submit">Enable</button>
+            </form>
+            {% endif %}
+            <form method="POST" action="{{ url_for('skills_bp.uninstall_skill') }}" style="display: inline;">
+              <input type="hidden" name="skill_id" value="{{ s.id }}">
+              <button class="btn btn-sm btn-danger" type="submit">Uninstall</button>
+            </form>
+          </td>
+        </tr>
+        {% endfor %}
+      </tbody>
+    </table>
+  </div>
+  {% else %}
+  <div class="empty">
+    <span class="icon">No community skills installed</span>
+  </div>
+  {% endif %}
+</div>
+{% endblock %}

package/dashboards/python/templates/users.html

@@ -0,0 +1,70 @@
+{% extends "layout.html" %}
+
+{% block content %}
+<div class="page-header">
+  <h1>Users</h1>
+  <p>Manage team members</p>
+</div>
+
+<div class="card">
+  <h3>Create User</h3>
+  <form method="POST" action="{{ url_for('users_bp.create_user') }}">
+    <div class="form-row">
+      <div class="form-group">
+        <label>Name</label>
+        <input type="text" name="name" required>
+      </div>
+      <div class="form-group">
+        <label>Email</label>
+        <input type="email" name="email" required>
+      </div>
+    </div>
+    <div class="form-row">
+      <div class="form-group">
+        <label>Role</label>
+        <select name="role">
+          <option>member</option>
+          <option>admin</option>
+          <option>owner</option>
+        </select>
+      </div>
+      <div class="form-group">
+        <label>Password</label>
+        <input type="password" name="password" required minlength="8">
+      </div>
+    </div>
+    <button class="btn btn-primary" type="submit">Create</button>
+  </form>
+</div>
+
+<div class="card">
+  {% if users %}
+  <div class="table-wrap">
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Email</th>
+          <th>Role</th>
+          <th>Last Login</th>
+        </tr>
+      </thead>
+      <tbody>
+        {% for u in users %}
+        <tr>
+          <td style="font-weight: 600;">{{ u.name }}</td>
+          <td style="color: var(--text-dim);">{{ u.email }}</td>
+          <td>{{ u.role|badge }}</td>
+          <td style="color: var(--text-muted); font-size: 12px;">{{ u.lastLoginAt|time_ago }}</td>
+        </tr>
+        {% endfor %}
+      </tbody>
+    </table>
+  </div>
+  {% else %}
+  <div class="empty">
+    <span class="icon">No users yet</span>
+  </div>
+  {% endif %}
+</div>
+{% endblock %}

package/dashboards/python/templates/vault.html

@@ -0,0 +1,73 @@
+{% extends "layout.html" %}
+
+{% block content %}
+<div class="page-header">
+  <h1>Vault</h1>
+  <p>Manage secrets and credentials</p>
+</div>
+
+<div class="card">
+  <h3>Add Secret</h3>
+  <form method="POST" action="{{ url_for('vault_bp.add_secret') }}" style="display: flex; gap: 10px; align-items: end; flex-wrap: wrap;">
+    <div class="form-group" style="flex: 1; margin: 0;">
+      <label>Name</label>
+      <input type="text" name="name" required placeholder="e.g. OPENAI_API_KEY">
+    </div>
+    <div class="form-group" style="flex: 1; margin: 0;">
+      <label>Value</label>
+      <input type="password" name="value" required placeholder="Secret value">
+    </div>
+    <div class="form-group" style="margin: 0;">
+      <label>Category</label>
+      <select name="category">
+        <option value="api_key">API Key</option>
+        <option value="deploy">Deploy</option>
+        <option value="cloud_storage">Cloud Storage</option>
+        <option value="skill_credential">Skill Credential</option>
+        <option value="custom" selected>Custom</option>
+      </select>
+    </div>
+    <button class="btn btn-primary" type="submit">Add</button>
+  </form>
+</div>
+
+<div class="card">
+  {% if secrets %}
+  <div class="table-wrap">
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Category</th>
+          <th>Created By</th>
+          <th>Created</th>
+          <th></th>
+        </tr>
+      </thead>
+      <tbody>
+        {% for s in secrets %}
+        <tr>
+          <td style="font-weight: 600; font-family: monospace;">{{ s.name }}</td>
+          <td>{{ (s.category or 'custom')|badge }}</td>
+          <td style="color: var(--text-muted); font-size: 12px;">{{ s.createdBy or s.created_by or '-' }}</td>
+          <td style="color: var(--text-muted); font-size: 12px;">{{ s.createdAt|time_ago if s.createdAt else (s.created_at|time_ago if s.created_at else '-') }}</td>
+          <td style="display: flex; gap: 4px;">
+            <form method="POST" action="{{ url_for('vault_bp.rotate_secret', id=s.id) }}" style="display: inline;">
+              <button class="btn btn-sm btn-primary" type="submit">Rotate</button>
+            </form>
+            <form method="POST" action="{{ url_for('vault_bp.delete_secret', id=s.id) }}" style="display: inline;">
+              <button class="btn btn-sm btn-danger" type="submit">Delete</button>
+            </form>
+          </td>
+        </tr>
+        {% endfor %}
+      </tbody>
+    </table>
+  </div>
+  {% else %}
+  <div class="empty">
+    <span class="icon">No secrets stored</span>
+  </div>
+  {% endif %}
+</div>
+{% endblock %}

package/dashboards/python/utils/api.py

@@ -0,0 +1,35 @@
+"""
+API client for communicating with the AgenticMail backend.
+Reads the bearer token from the Flask session automatically.
+"""
+
+import os
+import requests
+from flask import session
+
+API_URL = os.getenv('AGENTICMAIL_URL', 'http://localhost:3000')
+
+
+def api_request(method, path, body=None):
+    """Make an HTTP request to the AgenticMail API.
+
+    Args:
+        method: HTTP method (GET, POST, PATCH, DELETE, etc.)
+        path: API path, e.g. '/api/agents'
+        body: Optional JSON body (dict)
+
+    Returns:
+        Parsed JSON response as dict, or {'error': '...'} on failure.
+    """
+    headers = {'Content-Type': 'application/json'}
+    token = session.get('token')
+    if token:
+        headers['Authorization'] = f'Bearer {token}'
+    try:
+        r = requests.request(
+            method, f'{API_URL}{path}',
+            headers=headers, json=body, timeout=10,
+        )
+        return r.json()
+    except Exception as e:
+        return {'error': str(e)}

package/dashboards/python/utils/helpers.py

@@ -0,0 +1,90 @@
+"""
+Jinja2 template filters for the AgenticMail Enterprise Dashboard.
+"""
+
+from datetime import datetime, timezone
+from markupsafe import Markup
+
+
+def badge(text, badge_type=None):
+    """Render an inline badge span.
+
+    Args:
+        text: The label text inside the badge.
+        badge_type: CSS modifier class suffix (e.g. 'active', 'admin', 'danger').
+                    If None, defaults to the text value itself (lowercased).
+    """
+    cls = badge_type or text.lower() if text else 'default'
+    return Markup(f'<span class="badge badge-{cls}">{text}</span>')
+
+
+def status_badge(status):
+    """Render a status badge. Maps known statuses to appropriate badge types."""
+    mapping = {
+        'active': 'active',
+        'archived': 'archived',
+        'revoked': 'revoked',
+        'pending': 'pending',
+    }
+    cls = mapping.get(status, 'default')
+    return Markup(f'<span class="badge badge-{cls}">{status}</span>')
+
+
+def direction_badge(direction):
+    """Render a colored badge for message direction."""
+    mapping = {
+        'inbound': 'blue',
+        'outbound': 'green',
+        'internal': 'gray',
+    }
+    cls = mapping.get((direction or '').lower(), 'default')
+    label = direction or 'unknown'
+    return Markup(f'<span class="badge badge-{cls}">{label}</span>')
+
+
+def channel_badge(channel):
+    """Render a colored badge for message channel."""
+    mapping = {
+        'email': 'primary',
+        'api': 'warning',
+        'internal': 'neutral',
+        'webhook': 'info',
+    }
+    cls = mapping.get((channel or '').lower(), 'default')
+    label = channel or 'unknown'
+    return Markup(f'<span class="badge badge-{cls}">{label}</span>')
+
+
+def time_ago(iso_str):
+    """Convert an ISO 8601 timestamp string into a human-readable relative time.
+
+    Returns the original string if parsing fails.
+    """
+    if not iso_str:
+        return 'Never'
+    try:
+        # Handle ISO strings with or without timezone
+        if iso_str.endswith('Z'):
+            iso_str = iso_str[:-1] + '+00:00'
+        dt = datetime.fromisoformat(iso_str)
+        if dt.tzinfo is None:
+            dt = dt.replace(tzinfo=timezone.utc)
+        now = datetime.now(timezone.utc)
+        diff = now - dt
+        seconds = int(diff.total_seconds())
+
+        if seconds < 60:
+            return 'just now'
+        elif seconds < 3600:
+            m = seconds // 60
+            return f'{m}m ago'
+        elif seconds < 86400:
+            h = seconds // 3600
+            return f'{h}h ago'
+        elif seconds < 604800:
+            d = seconds // 86400
+            return f'{d}d ago'
+        else:
+            return dt.strftime('%b %d, %Y')
+    except Exception:
+        return iso_str

package/dashboards/rails/app.rb

@@ -0,0 +1,56 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# AgenticMail Enterprise Dashboard - Modular Sinatra App
+# Setup: gem install sinatra && ruby app.rb
+
+require 'sinatra'
+require 'net/http'
+require 'json'
+require 'uri'
+require 'time'
+
+# =============================================================================
+# Configuration
+# =============================================================================
+API_BASE = ENV.fetch('AGENTICMAIL_URL', 'http://localhost:3000')
+
+set :port, 4567
+set :bind, '0.0.0.0'
+set :sessions, true
+set :session_secret, ENV.fetch('SESSION_SECRET', SecureRandom.hex(32))
+set :views, File.join(File.dirname(__FILE__), 'views')
+set :public_folder, File.join(File.dirname(__FILE__), 'public')
+
+# =============================================================================
+# Helpers
+# =============================================================================
+require_relative 'helpers/api'
+require_relative 'helpers/auth'
+require_relative 'helpers/view'
+
+# =============================================================================
+# Before filter
+# =============================================================================
+before do
+  pass if request.path_info == '/login'
+  pass if request.path_info.start_with?('/assets')
+end
+
+# =============================================================================
+# Routes
+# =============================================================================
+require_relative 'routes/auth'
+require_relative 'routes/dashboard'
+require_relative 'routes/agents'
+require_relative 'routes/users'
+require_relative 'routes/api_keys'
+require_relative 'routes/vault'
+require_relative 'routes/skills'
+require_relative 'routes/audit'
+require_relative 'routes/settings'
+require_relative 'routes/messages'
+require_relative 'routes/guardrails'
+require_relative 'routes/journal'
+require_relative 'routes/dlp'
+require_relative 'routes/compliance'

package/dashboards/rails/helpers/api.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+# API Client helpers (like Rails service object)
+helpers do
+  def api_request(method, path, body: nil, token: nil)
+    uri = URI("#{API_BASE}#{path}")
+    http = Net::HTTP.new(uri.host, uri.port)
+    http.use_ssl = uri.scheme == 'https'
+    http.open_timeout = 5
+    http.read_timeout = 10
+
+    req = case method
+          when :get    then Net::HTTP::Get.new(uri)
+          when :post   then Net::HTTP::Post.new(uri)
+          when :patch  then Net::HTTP::Patch.new(uri)
+          when :put    then Net::HTTP::Put.new(uri)
+          when :delete then Net::HTTP::Delete.new(uri)
+          end
+
+    req['Content-Type'] = 'application/json'
+    req['Accept'] = 'application/json'
+    tk = token || session[:token]
+    req['Authorization'] = "Bearer #{tk}" if tk
+    req.body = body.to_json if body
+
+    res = http.request(req)
+    { status: res.code.to_i, body: JSON.parse(res.body) rescue res.body }
+  rescue Errno::ECONNREFUSED, Errno::ECONNRESET, Net::OpenTimeout, Net::ReadTimeout => e
+    { status: 0, body: { 'error' => "API unreachable: #{e.message}" } }
+  rescue JSON::ParserError
+    { status: 500, body: { 'error' => 'Invalid JSON from API' } }
+  end
+
+  def api_get(path)    = api_request(:get, path)
+  def api_post(path, body) = api_request(:post, path, body: body)
+  def api_put(path, body) = api_request(:put, path, body: body)
+  def api_patch(path, body) = api_request(:patch, path, body: body)
+  def api_delete(path) = api_request(:delete, path)
+end

package/dashboards/rails/helpers/auth.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+# Authentication helpers
+helpers do
+  def logged_in? = !!session[:token]
+  def current_user = session[:user] || {}
+
+  def require_auth!
+    redirect '/login' unless logged_in?
+  end
+end

package/dashboards/rails/helpers/view.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+# View helpers (Rails-style)
+helpers do
+  def active?(path)
+    return 'active' if request.path_info == path
+    return 'active' if path != '/' && request.path_info.start_with?(path)
+    ''
+  end
+
+  def time_ago(iso)
+    return 'N/A' unless iso
+    t = Time.parse(iso.to_s) rescue return(iso.to_s)
+    diff = (Time.now - t).to_i
+    case diff
+    when 0..59       then "#{diff}s ago"
+    when 60..3599    then "#{diff / 60}m ago"
+    when 3600..86399 then "#{diff / 3600}h ago"
+    else "#{diff / 86400}d ago"
+    end
+  end
+
+  def badge(text, variant = 'default')
+    "<span class=\"badge badge-#{variant}\">#{escape_html(text.to_s)}</span>"
+  end
+
+  def status_badge(status)
+    v = case status.to_s.downcase
+        when 'active', 'enabled', 'running', 'success' then 'success'
+        when 'archived', 'disabled', 'revoked'          then 'danger'
+        when 'pending', 'paused'                         then 'warning'
+        else 'default'
+        end
+    badge(status, v)
+  end
+
+  def category_badge(category)
+    colors = {
+      'deploy' => 'primary',
+      'cloud_storage' => 'info',
+      'api_key' => 'warning',
+      'skill_credential' => 'success',
+      'custom' => 'default',
+    }
+    v = colors[category.to_s] || 'default'
+    badge(category.to_s.empty? ? 'custom' : category.to_s.gsub('_', ' '), v)
+  end
+
+  def direction_badge(direction)
+    v = case direction.to_s.downcase
+        when 'inbound'  then 'blue'
+        when 'outbound' then 'success'
+        when 'internal' then 'default'
+        else 'default'
+        end
+    badge(direction.to_s.downcase.empty? ? '-' : direction, v)
+  end
+
+  def channel_badge(channel)
+    v = case channel.to_s.downcase
+        when 'email'    then 'primary'
+        when 'api'      then 'warning'
+        when 'internal' then 'default'
+        when 'webhook'  then 'info'
+        else 'default'
+        end
+    badge(channel.to_s.downcase.empty? ? '-' : channel, v)
+  end
+
+  def escape_html(s)
+    Rack::Utils.escape_html(s.to_s)
+  end
+
+  def flash_messages
+    msg = session.delete(:flash)
+    return '' unless msg
+    type = session.delete(:flash_type) || 'info'
+    "<div class=\"flash flash-#{type}\">#{escape_html(msg)}</div>"
+  end
+
+  def set_flash(msg, type = 'info')
+    session[:flash] = msg
+    session[:flash_type] = type
+  end
+
+  # Layout renderer (Rails-style)
+  def render_page(title, &block)
+    content = capture_erb(&block) if block_given?
+    erb :layout, locals: { title: title, content: content }
+  end
+
+  def capture_erb(&block)
+    block.call
+  end
+end