chore: bump version to v0.2.34 [skip ci]

- ExtractToolData: unwraps content[0].text JSON + details
- GetStatusAsync: separates try/catch per step (ping, session, agents, queue)
- GetAgentsAsync: parses gateway agents[] array from sessions_list
- GetQueueAsync: extracts from cron response data.jobs
- gatewayOk no longer overridden by downstream tool errors

VERSION

@@ -1 +1 @@
-0.2.31
+0.2.34

backend/Controllers/DashboardController.cs

@@ -0,0 +1,208 @@
+using Microsoft.AspNetCore.Mvc;
+using Nexus.Api.Models;
+using Nexus.Api.Services;
+
+namespace Nexus.Api.Controllers;
+
+[ApiController]
+[Route("api/dashboard")]
+public class DashboardController(OpenClawGatewayClient gateway, ILogger<DashboardController> logger)
+    : ControllerBase
+{
+    /// <summary>
+    /// Gateway health + session_status + subagents count.
+    /// Returns HTTP 200 even when gateway is down (gatewayOk: false).
+    /// </summary>
+    [HttpGet("status")]
+    public async Task<DashboardStatus> GetStatus()
+    {
+        try
+        {
+            return await gateway.GetStatusAsync();
+        }
+        catch (Exception ex)
+        {
+            logger.LogWarning(ex, "Dashboard status check failed");
+            return new DashboardStatus(false, "Offline", 0, 0);
+        }
+    }
+
+    /// <summary>
+    /// Returns all agents with their current status.
+    /// Combines sessions_list + sub_agents_list.
+    /// </summary>
+    [HttpGet("agents")]
+    public async Task<List<DashboardAgentInfo>> GetAgents()
+    {
+        try
+        {
+            return await gateway.GetAgentsAsync();
+        }
+        catch (Exception ex)
+        {
+            logger.LogWarning(ex, "Dashboard agents fetch failed");
+            return new List<DashboardAgentInfo>();
+        }
+    }
+
+    /// <summary>
+    /// Returns the latest assistant messages (operations/feed) from the Iris session.
+    /// Filtered to role == "assistant" — those are the work feed entries.
+    /// </summary>
+    [HttpGet("operations")]
+    public async Task<List<FeedEntry>> GetOperations([FromQuery] int limit = 20)
+    {
+        try
+        {
+            var messages = await gateway.GetSessionHistoryAsync("iris", Math.Clamp(limit, 1, 100));
+            var feed = new List<FeedEntry>();
+
+            foreach (var msg in messages)
+            {
+                if (!string.Equals(msg.Role, "assistant", StringComparison.OrdinalIgnoreCase))
+                    continue;
+
+                if (string.IsNullOrWhiteSpace(msg.Content))
+                    continue;
+
+                // Parse timestamp for display-friendly "time ago"
+                var ts = ParseTimestamp(msg.Timestamp);
+                var timeAgo = FormatTimeAgo(ts);
+
+                // Extract a short agent indicator and action from content
+                var (agent, action) = ExtractAgentAction(msg.Content);
+
+                feed.Add(new FeedEntry(agent, action, msg.Timestamp, timeAgo));
+            }
+
+            return feed;
+        }
+        catch (Exception ex)
+        {
+            logger.LogWarning(ex, "Dashboard operations fetch failed");
+            return new List<FeedEntry>();
+        }
+    }
+
+    /// <summary>
+    /// Send a chat message to the Iris session.
+    /// </summary>
+    [HttpPost("chat/send")]
+    public async Task<ChatResponse> SendChat([FromBody] ChatRequest request)
+    {
+        if (string.IsNullOrWhiteSpace(request.Message))
+            return new ChatResponse(false, null, "Message is required");
+
+        try
+        {
+            var sessionKey = string.IsNullOrWhiteSpace(request.SessionKey)
+                ? "iris"
+                : request.SessionKey.Trim();
+
+            return await gateway.SendChatMessageAsync(sessionKey, request.Message.Trim());
+        }
+        catch (Exception ex)
+        {
+            logger.LogWarning(ex, "Dashboard chat send failed");
+            return new ChatResponse(false, null, "Gateway nicht erreichbar");
+        }
+    }
+
+    /// <summary>
+    /// Returns chat messages (user + assistant only, not tool messages).
+    /// </summary>
+    [HttpGet("chat/messages")]
+    public async Task<List<MessageEntry>> GetMessages(
+        [FromQuery] string? sessionKey,
+        [FromQuery] int limit = 50,
+        [FromQuery] int offset = 0)
+    {
+        try
+        {
+            var key = string.IsNullOrWhiteSpace(sessionKey) ? "iris" : sessionKey.Trim();
+            var messages = await gateway.GetSessionHistoryAsync(key, Math.Clamp(limit, 1, 200), Math.Max(0, offset));
+
+            // Filter: only user and assistant messages (exclude tool/system)
+            return messages
+                .Where(m => string.Equals(m.Role, "user", StringComparison.OrdinalIgnoreCase)
+                         || string.Equals(m.Role, "assistant", StringComparison.OrdinalIgnoreCase))
+                .ToList();
+        }
+        catch (Exception ex)
+        {
+            logger.LogWarning(ex, "Dashboard messages fetch failed");
+            return new List<MessageEntry>();
+        }
+    }
+
+    /// <summary>
+    /// Returns the cron queue / pending tasks.
+    /// </summary>
+    [HttpGet("queue")]
+    public async Task<List<QueueItem>> GetQueue()
+    {
+        try
+        {
+            return await gateway.GetQueueAsync();
+        }
+        catch (Exception ex)
+        {
+            logger.LogWarning(ex, "Dashboard queue fetch failed");
+            return new List<QueueItem>();
+        }
+    }
+
+    // ========== Helpers ==========
+
+    private static DateTimeOffset ParseTimestamp(string timestamp)
+    {
+        if (DateTimeOffset.TryParse(timestamp, null, System.Globalization.DateTimeStyles.None, out var dt))
+            return dt;
+        return DateTimeOffset.UtcNow;
+    }
+
+    private static string FormatTimeAgo(DateTimeOffset ts)
+    {
+        var diff = DateTimeOffset.UtcNow - ts;
+        if (diff.TotalMinutes < 1) return "just now";
+        if (diff.TotalMinutes < 60) return $"{(int)diff.TotalMinutes}m ago";
+        if (diff.TotalHours < 24) return $"{(int)diff.TotalHours}h ago";
+        if (diff.TotalDays < 7) return $"{(int)diff.TotalDays}d ago";
+        return ts.ToString("MMM dd");
+    }
+
+    private static (string Agent, string Action) ExtractAgentAction(string content)
+    {
+        // Take first line or first ~80 chars as the action summary
+        var firstLine = content.Split('\n', 2)[0].Trim();
+        var summary = firstLine.Length > 80 ? firstLine[..80] + "…" : firstLine;
+
+        // Try to identify which agent this came from
+        var agent = "Iris";
+        foreach (var marker in new[] { "**Agent:**", "**Agent:** ", "*Agent:* ", "Agent:" })
+        {
+            var idx = content.IndexOf(marker, StringComparison.OrdinalIgnoreCase);
+            if (idx >= 0)
+            {
+                var after = content[(idx + marker.Length)..].TrimStart();
+                var end = after.IndexOfAny(['\n', '\r', ',', '.']);
+                var found = end > 0 ? after[..end].Trim() : after.Split('\n', 2)[0].Trim();
+                if (!string.IsNullOrWhiteSpace(found) && found.Length < 30)
+                {
+                    agent = found;
+                    break;
+                }
+            }
+        }
+
+        // Try to find agent name at the start in brackets like [Agent: Iris]
+        if (agent == "Iris")
+        {
+            var bracketMatch = System.Text.RegularExpressions.Regex.Match(content, @"\[Agent:\s*([^\]]+)\]");
+            if (bracketMatch.Success)
+                agent = bracketMatch.Groups[1].Value.Trim();
+        }
+
+        return (agent, summary);
+    }
+}

backend/Models/Dashboard.cs

@@ -0,0 +1,47 @@
+namespace Nexus.Api.Models;
+
+public sealed record DashboardAgentInfo(
+    string Id,
+    string Name,
+    string Role,
+    string Model,
+    bool IsActive,
+    string? CurrentTask
+);
+
+public sealed record MessageEntry(
+    string Role,
+    string Content,
+    string Timestamp
+);
+
+public sealed record ChatRequest(
+    string Message,
+    string? SessionKey
+);
+
+public sealed record ChatResponse(
+    bool Ok,
+    string? Reply,
+    string? Error
+);
+
+public sealed record FeedEntry(
+    string Agent,
+    string Action,
+    string Timestamp,
+    string Time
+);
+
+public sealed record DashboardStatus(
+    bool GatewayOk,
+    string IrisStatus,
+    int ActiveAgents,
+    int PendingTasks
+);
+
+public sealed record QueueItem(
+    string Id,
+    string Name,
+    string Status
+);

backend/Program.cs

@@ -112,6 +112,13 @@ builder.Services.AddHttpClient("gateway", client =>
     client.Timeout = TimeSpan.FromSeconds(5);
 });
 
+builder.Services.AddHttpClient<OpenClawGatewayClient>(client =>
+{
+    client.BaseAddress = new(builder.Configuration["Integrations:OpenClaw:BaseUrl"]
+        ?? "http://127.0.0.1:18789");
+    client.Timeout = TimeSpan.FromSeconds(5);
+});
+
 // --- Application Services ---
 builder.Services.AddTransient<ModelRoutingService>();
 builder.Services.AddScoped<IAuthService, AuthService>();

backend/Services/OpenClawGatewayClient.cs

@@ -0,0 +1,298 @@
+using System.Net.Http.Headers;
+using System.Net.Http.Json;
+using System.Text.Json;
+using System.Text.Json.Nodes;
+using Nexus.Api.Models;
+
+namespace Nexus.Api.Services;
+
+public sealed class OpenClawGatewayClient(HttpClient httpClient, IConfiguration configuration)
+{
+    private static readonly JsonSerializerOptions JsonOptions = new()
+    {
+        PropertyNameCaseInsensitive = true,
+        PropertyNamingPolicy = JsonNamingPolicy.CamelCase
+    };
+
+    private string? GetPassword()
+    {
+        var password = configuration["Integrations:OpenClaw:Password"];
+        if (string.IsNullOrWhiteSpace(password))
+            password = configuration["Integrations:OpenClaw:Token"];
+        return string.IsNullOrWhiteSpace(password) ? null : password;
+    }
+
+    private void ApplyAuth(HttpRequestMessage request)
+    {
+        var password = GetPassword();
+        if (password is not null)
+            request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", password);
+    }
+
+    public async Task<JsonNode?> InvokeToolAsync(string tool, object? args = null)
+    {
+        try
+        {
+            using var request = new HttpRequestMessage(HttpMethod.Post, "/tools/invoke");
+            ApplyAuth(request);
+
+            var body = new Dictionary<string, object?> { ["tool"] = tool };
+            if (args is not null)
+                body["args"] = args;
+
+            request.Content = JsonContent.Create(body);
+
+            using var response = await httpClient.SendAsync(request);
+            if (!response.IsSuccessStatusCode)
+                return null;
+
+            var json = await response.Content.ReadAsStringAsync();
+            if (string.IsNullOrWhiteSpace(json))
+                return null;
+
+            var node = JsonNode.Parse(json);
+            // Unwrap the { ok: true, result: ... } envelope
+            if (node?["ok"]?.GetValue<bool>() == true && node["result"] is not null)
+                return node["result"];
+            return node;
+        }
+        catch
+        {
+            return null;
+        }
+    }
+
+    /// <summary>
+    /// Extracts useful data from a tool response that may embed JSON in content[0].text.
+    /// Returns the unwrapped "details" object if present, otherwise the raw result.
+    /// </summary>
+    private static JsonNode? ExtractToolData(JsonNode? result)
+    {
+        if (result is null) return null;
+        // Some tools return { details: {...}, content: [...] }
+        if (result["details"] is JsonNode details && details is not JsonValue)
+            return details;
+        // Some tools wrap in content[0].text as JSON string
+        if (result["content"] is JsonArray content && content.Count > 0)
+        {
+            var text = content[0]?["text"]?.GetValue<string>();
+            if (!string.IsNullOrWhiteSpace(text))
+            {
+                try { return JsonNode.Parse(text); }
+                catch { /* fall through */ }
+            }
+        }
+        return result;
+    }
+
+    public async Task<List<DashboardAgentInfo>> GetAgentsAsync()
+    {
+        var agents = new List<DashboardAgentInfo>();
+        var seenIds = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
+
+        // Get sessions list
+        var sessionsResult = await InvokeToolAsync("sessions_list");
+        var sessionsData = ExtractToolData(sessionsResult);
+
+        if (sessionsData is JsonObject so)
+        {
+            // sessions_list returns { agents: [...], sessions: {...} }
+            // Try agents array first (from gateway call)
+            if (so["agents"] is JsonArray agentArray)
+            {
+                foreach (var a in agentArray)
+                {
+                    if (a is null) continue;
+                    var id = a["agentId"]?.GetValue<string>() ?? "";
+                    if (string.IsNullOrWhiteSpace(id) || !seenIds.Add(id)) continue;
+                    var name = a["name"]?.GetValue<string>() ?? id;
+                    var model = "GPT-5.4"; // default, overridden if available
+                    var isActive = false;
+                    var currentTask = (string?)null;
+
+                    // Check if agent has recent sessions (active indicator)
+                    if (a["sessions"] is JsonObject sess && sess["recent"] is JsonArray recent && recent.Count > 0)
+                    {
+                        var age = recent[0]?["age"]?.GetValue<long>() ?? long.MaxValue;
+                        isActive = age < 300_000; // active if session < 5 min ago
+                        currentTask = recent[0]?["key"]?.GetValue<string>();
+                    }
+
+                    agents.Add(new DashboardAgentInfo(id, name, DeriveRole(id), model, isActive, currentTask));
+                }
+            }
+        }
+
+        // Also get subagents list
+        var subResult = await InvokeToolAsync("subagents", new { action = "list" });
+        var subData = ExtractToolData(subResult);
+
+        if (subData is JsonArray subArray)
+        {
+            foreach (var s in subArray)
+            {
+                if (s is null) continue;
+                var id = s["id"]?.GetValue<string>() ?? s["agentId"]?.GetValue<string>() ?? "";
+                if (string.IsNullOrWhiteSpace(id) || !seenIds.Add(id)) continue;
+                var name = s["name"]?.GetValue<string>() ?? id;
+                var status = s["status"]?.GetValue<string>() ?? "";
+                var isActive = status is "active" or "running";
+                var currentTask = s["task"]?.GetValue<string>() ?? s["currentTask"]?.GetValue<string>();
+
+                agents.Add(new DashboardAgentInfo(id, name, DeriveRole(id), "", isActive, currentTask));
+            }
+        }
+
+        return agents;
+    }
+
+    public async Task<List<MessageEntry>> GetSessionHistoryAsync(string sessionKey, int limit = 50, int offset = 0)
+    {
+        try
+        {
+            var result = await InvokeToolAsync("sessions_history", new { sessionKey, limit, offset });
+            if (result is null) return new List<MessageEntry>();
+
+            var messages = new List<MessageEntry>();
+            var array = result as JsonArray ?? result.AsArray();
+            if (array is null) return messages;
+
+            foreach (var msg in array)
+            {
+                if (msg is null) continue;
+                var role = msg["role"]?.GetValue<string>() ?? "";
+                var content = msg["content"]?.GetValue<string>() ?? "";
+                var timestamp = msg["timestamp"]?.GetValue<string>()
+                    ?? msg["ts"]?.GetValue<string>()
+                    ?? msg["createdAt"]?.GetValue<string>()
+                    ?? DateTimeOffset.UtcNow.ToString("o");
+
+                messages.Add(new MessageEntry(role, content, timestamp));
+            }
+
+            return messages;
+        }
+        catch
+        {
+            return new List<MessageEntry>();
+        }
+    }
+
+    public async Task<ChatResponse> SendChatMessageAsync(string sessionKey, string message)
+    {
+        try
+        {
+            var result = await InvokeToolAsync("sessions_send", new { sessionKey, message });
+            if (result is null) return new ChatResponse(false, null, "Gateway nicht erreichbar");
+
+            var ok = result["ok"]?.GetValue<bool>() ?? false;
+            var reply = result["reply"]?.GetValue<string>()
+                ?? result["response"]?.GetValue<string>()
+                ?? result["content"]?[0]?["text"]?.GetValue<string>();
+            var error = result["error"]?.GetValue<string>();
+
+            return new ChatResponse(ok, reply, error);
+        }
+        catch (Exception ex)
+        {
+            return new ChatResponse(false, null, $"Fehler: {ex.Message}");
+        }
+    }
+
+    public async Task<List<QueueItem>> GetQueueAsync()
+    {
+        try
+        {
+            var result = await InvokeToolAsync("cron", new { action = "list" });
+            var data = ExtractToolData(result);
+            if (data is null) return new List<QueueItem>();
+
+            var items = new List<QueueItem>();
+            var jobs = data["jobs"] as JsonArray ?? data.AsArray();
+            if (jobs is null) return items;
+
+            foreach (var j in jobs)
+            {
+                if (j is null) continue;
+                var id = j["id"]?.GetValue<string>() ?? "";
+                var name = j["name"]?.GetValue<string>() ?? id;
+                var status = j["state"]?["lastStatus"]?.GetValue<string>()
+                    ?? j["status"]?.GetValue<string>()
+                    ?? "unknown";
+
+                items.Add(new QueueItem(id, name, status));
+            }
+            return items;
+        }
+        catch
+        {
+            return new List<QueueItem>();
+        }
+    }
+
+    public async Task<DashboardStatus> GetStatusAsync()
+    {
+        var gatewayOk = false;
+        var irisStatus = "Offline";
+        var activeAgents = 0;
+        var pendingTasks = 0;
+
+        // Step 1: Health check (no auth needed)
+        try
+        {
+            using var pingRequest = new HttpRequestMessage(HttpMethod.Get, "/health");
+            using var pingResponse = await httpClient.SendAsync(pingRequest);
+            gatewayOk = pingResponse.IsSuccessStatusCode;
+        }
+        catch
+        {
+            // gatewayOk stays false
+        }
+
+        if (gatewayOk)
+        {
+            // Step 2: Session status
+            try
+            {
+                var sessionResult = await InvokeToolAsync("session_status");
+                if (sessionResult is not null)
+                {
+                    irisStatus = sessionResult["status"]?.GetValue<string>()
+                        ?? sessionResult["sessionKey"]?.GetValue<string>()
+                        ?? "Active";
+                }
+            }
+            catch { }
+
+            // Step 3: Active agents
+            try
+            {
+                var agents = await GetAgentsAsync();
+                activeAgents = agents.Count(a => a.IsActive);
+            }
+            catch { }
+
+            // Step 4: Queue items
+            try
+            {
+                var queue = await GetQueueAsync();
+                pendingTasks = queue.Count;
+            }
+            catch { }
+        }
+
+        return new DashboardStatus(gatewayOk, irisStatus, activeAgents, pendingTasks);
+    }
+
+    private static string DeriveRole(string agentId) => agentId.ToLowerInvariant() switch
+    {
+        "iris" => "Orchestrator",
+        "programmer" => "Developer",
+        "reviewer" => "Reviewer",
+        "architekt" => "Architect",
+        "executor" => "Executor",
+        "researcher" => "Researcher",
+        "main" => "Assistant",
+        _ => "Custom"
+    };
+}