Compare commits
1 Commits
bca3bf7677
...
agent/dex/
| Author | SHA1 | Date | |
|---|---|---|---|
|
38b7d13312 |
@@ -1,88 +0,0 @@
|
|||||||
using ControlCenter.Api.Entities;
|
|
||||||
using Microsoft.EntityFrameworkCore;
|
|
||||||
using Microsoft.EntityFrameworkCore.Metadata.Builders;
|
|
||||||
|
|
||||||
namespace ControlCenter.Api.Configurations;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// EF Core entity type configuration for the agents table.
|
|
||||||
/// Enforces snake_case naming, required fields, and index design.
|
|
||||||
/// </summary>
|
|
||||||
public class AgentConfiguration : IEntityTypeConfiguration<Agent>
|
|
||||||
{
|
|
||||||
public void Configure(EntityTypeBuilder<Agent> builder)
|
|
||||||
{
|
|
||||||
// Table name — snake_case
|
|
||||||
builder.ToTable("agents");
|
|
||||||
|
|
||||||
// Primary key
|
|
||||||
builder.HasKey(a => a.Id);
|
|
||||||
builder.Property(a => a.Id)
|
|
||||||
.HasColumnName("id")
|
|
||||||
.ValueGeneratedOnAdd();
|
|
||||||
|
|
||||||
// Status — stored as PostgreSQL enum via Npgsql
|
|
||||||
builder.Property(a => a.Status)
|
|
||||||
.HasColumnName("status")
|
|
||||||
.HasColumnType("agent_status")
|
|
||||||
.IsRequired();
|
|
||||||
|
|
||||||
// Task — nullable text
|
|
||||||
builder.Property(a => a.Task)
|
|
||||||
.HasColumnName("task")
|
|
||||||
.HasColumnType("text");
|
|
||||||
|
|
||||||
// Progress — nullable integer (0–100)
|
|
||||||
builder.Property(a => a.Progress)
|
|
||||||
.HasColumnName("progress");
|
|
||||||
|
|
||||||
// Session key — required, not null
|
|
||||||
builder.Property(a => a.SessionKey)
|
|
||||||
.HasColumnName("session_key")
|
|
||||||
.HasColumnType("text")
|
|
||||||
.IsRequired();
|
|
||||||
|
|
||||||
// Channel — required, not null
|
|
||||||
builder.Property(a => a.Channel)
|
|
||||||
.HasColumnName("channel")
|
|
||||||
.HasColumnType("text")
|
|
||||||
.IsRequired();
|
|
||||||
|
|
||||||
// Last activity — required, defaults to now()
|
|
||||||
builder.Property(a => a.LastActivity)
|
|
||||||
.HasColumnName("last_activity")
|
|
||||||
.HasColumnType("timestamptz")
|
|
||||||
.IsRequired();
|
|
||||||
|
|
||||||
// Created at — auto-set on insert
|
|
||||||
builder.Property(a => a.CreatedAt)
|
|
||||||
.HasColumnName("created_at")
|
|
||||||
.HasColumnType("timestamptz")
|
|
||||||
.IsRequired()
|
|
||||||
.HasDefaultValueSql("now()");
|
|
||||||
|
|
||||||
// Updated at — auto-set on insert and update
|
|
||||||
builder.Property(a => a.UpdatedAt)
|
|
||||||
.HasColumnName("updated_at")
|
|
||||||
.HasColumnType("timestamptz")
|
|
||||||
.IsRequired()
|
|
||||||
.HasDefaultValueSql("now()");
|
|
||||||
|
|
||||||
// Indexes
|
|
||||||
// Sessions are looked up by session_key frequently
|
|
||||||
builder.HasIndex(a => a.SessionKey)
|
|
||||||
.HasDatabaseName("ix_agents_session_key")
|
|
||||||
.IsUnique();
|
|
||||||
|
|
||||||
// Agents are filtered by channel for channel-specific queries
|
|
||||||
builder.HasIndex(a => a.Channel)
|
|
||||||
.HasDatabaseName("ix_agents_channel");
|
|
||||||
|
|
||||||
// Agents are filtered by status for fleet health monitoring
|
|
||||||
builder.HasIndex(a => a.Status)
|
|
||||||
.HasDatabaseName("ix_agents_status");
|
|
||||||
|
|
||||||
// Check constraint: progress must be 0–100 if present
|
|
||||||
builder.ToTable(t => t.HasCheckConstraint("ck_agents_progress_range", "progress IS NULL OR (progress >= 0 AND progress <= 100)"));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -6,19 +6,8 @@
|
|||||||
<ImplicitUsings>enable</ImplicitUsings>
|
<ImplicitUsings>enable</ImplicitUsings>
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
|
|
||||||
<!-- Exclude the separate ControlCenter sub-project from this project's compilation -->
|
|
||||||
<ItemGroup>
|
|
||||||
<Compile Remove="ControlCenter/**/*.cs" />
|
|
||||||
</ItemGroup>
|
|
||||||
|
|
||||||
<ItemGroup>
|
<ItemGroup>
|
||||||
<PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.14" />
|
<PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.14" />
|
||||||
<PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.4">
|
|
||||||
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
|
|
||||||
<PrivateAssets>all</PrivateAssets>
|
|
||||||
</PackageReference>
|
|
||||||
<PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="9.0.4" />
|
|
||||||
<PackageReference Include="Swashbuckle.AspNetCore" Version="10.1.7" />
|
|
||||||
</ItemGroup>
|
</ItemGroup>
|
||||||
|
|
||||||
</Project>
|
</Project>
|
||||||
@@ -1,6 +0,0 @@
|
|||||||
@ControlCenter.Api_HostAddress = http://localhost:5178
|
|
||||||
|
|
||||||
GET {{ControlCenter.Api_HostAddress}}/weatherforecast/
|
|
||||||
Accept: application/json
|
|
||||||
|
|
||||||
###
|
|
||||||
18
backend/ControlCenter/.gitignore
vendored
18
backend/ControlCenter/.gitignore
vendored
@@ -1,18 +0,0 @@
|
|||||||
## .NET
|
|
||||||
bin/
|
|
||||||
obj/
|
|
||||||
*.user
|
|
||||||
*.suo
|
|
||||||
*.cache
|
|
||||||
*.dll
|
|
||||||
*.pdb
|
|
||||||
*.xml
|
|
||||||
|
|
||||||
## IDE
|
|
||||||
.vs/
|
|
||||||
.vscode/
|
|
||||||
.idea/
|
|
||||||
|
|
||||||
## OS
|
|
||||||
.DS_Store
|
|
||||||
Thumbs.db
|
|
||||||
@@ -1,17 +0,0 @@
|
|||||||
<Project Sdk="Microsoft.NET.Sdk.Web">
|
|
||||||
|
|
||||||
<PropertyGroup>
|
|
||||||
<TargetFramework>net9.0</TargetFramework>
|
|
||||||
<Nullable>enable</Nullable>
|
|
||||||
<ImplicitUsings>enable</ImplicitUsings>
|
|
||||||
<GenerateDocumentationFile>true</GenerateDocumentationFile>
|
|
||||||
<NoWarn>CS1591</NoWarn>
|
|
||||||
<RootNamespace>ControlCenter</RootNamespace>
|
|
||||||
<AssemblyName>ControlCenter</AssemblyName>
|
|
||||||
</PropertyGroup>
|
|
||||||
|
|
||||||
<ItemGroup>
|
|
||||||
<PackageReference Include="Swashbuckle.AspNetCore" Version="10.1.7" />
|
|
||||||
</ItemGroup>
|
|
||||||
|
|
||||||
</Project>
|
|
||||||
@@ -1,71 +0,0 @@
|
|||||||
using Microsoft.AspNetCore.Mvc;
|
|
||||||
using ControlCenter.Services;
|
|
||||||
|
|
||||||
namespace ControlCenter.Controllers;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// REST API for querying agent fleet status.
|
|
||||||
/// Provides the initial data load for the Command Hub,
|
|
||||||
/// while real-time updates flow through the AgentStatus SignalR hub.
|
|
||||||
///
|
|
||||||
/// <para>API contract for Rex (Frontend):</para>
|
|
||||||
/// <list type="bullet">
|
|
||||||
/// <item><c>GET /api/agents</c> — Returns all known agents with current status</item>
|
|
||||||
/// <item><c>GET /api/agents/{agentId}</c> — Returns a specific agent's status</item>
|
|
||||||
/// </list>
|
|
||||||
/// </summary>
|
|
||||||
[ApiController]
|
|
||||||
[Route("api/[controller]")]
|
|
||||||
public class AgentsController : ControllerBase
|
|
||||||
{
|
|
||||||
private readonly ILogger<AgentsController> _logger;
|
|
||||||
private readonly GatewayEventBridgeService _bridgeService;
|
|
||||||
|
|
||||||
public AgentsController(
|
|
||||||
ILogger<AgentsController> logger,
|
|
||||||
GatewayEventBridgeService bridgeService)
|
|
||||||
{
|
|
||||||
_logger = logger;
|
|
||||||
_bridgeService = bridgeService;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Gets the current fleet status — all known agents with their latest state.
|
|
||||||
/// This is the initial load endpoint; subsequent updates arrive via SignalR.
|
|
||||||
/// </summary>
|
|
||||||
/// <returns>An array of agent card data for the entire fleet.</returns>
|
|
||||||
/// <response code="200">Returns the fleet snapshot.</response>
|
|
||||||
[HttpGet]
|
|
||||||
[ProducesResponseType(typeof(AgentCardData[]), StatusCodes.Status200OK)]
|
|
||||||
public IActionResult GetAgents()
|
|
||||||
{
|
|
||||||
var snapshot = _bridgeService.GetFleetSnapshot();
|
|
||||||
_logger.LogDebug("Fleet snapshot requested: {Count} agents", snapshot.Length);
|
|
||||||
return Ok(snapshot);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Gets the current status of a specific agent.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="agentId">The agent identifier, e.g. "otto", "dex".</param>
|
|
||||||
/// <returns>The agent's current card data.</returns>
|
|
||||||
/// <response code="200">Returns the agent's status.</response>
|
|
||||||
/// <response code="404">Agent not found in the fleet state.</response>
|
|
||||||
[HttpGet("{agentId}")]
|
|
||||||
[ProducesResponseType(typeof(AgentCardData), StatusCodes.Status200OK)]
|
|
||||||
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
||||||
public IActionResult GetAgent(string agentId)
|
|
||||||
{
|
|
||||||
var snapshot = _bridgeService.GetFleetSnapshot();
|
|
||||||
var agent = snapshot.FirstOrDefault(a =>
|
|
||||||
a.Id.Equals(agentId, StringComparison.OrdinalIgnoreCase));
|
|
||||||
|
|
||||||
if (agent is null)
|
|
||||||
{
|
|
||||||
_logger.LogWarning("Agent not found: {AgentId}", agentId);
|
|
||||||
return NotFound(new { error = $"Agent '{agentId}' not found" });
|
|
||||||
}
|
|
||||||
|
|
||||||
return Ok(agent);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,122 +0,0 @@
|
|||||||
using Microsoft.AspNetCore.Mvc;
|
|
||||||
|
|
||||||
namespace ControlCenter.Controllers;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// REST API for sending control commands to agents.
|
|
||||||
/// Provides the Command Hub's action endpoints for agent lifecycle control.
|
|
||||||
///
|
|
||||||
/// <para>API contract for Rex (Frontend):</para>
|
|
||||||
/// <list type="bullet">
|
|
||||||
/// <item><c>POST /api/command/stop/{agentId}</c> — Stop/abort an agent's active session</item>
|
|
||||||
/// <item><c>POST /api/command/restart/{agentId}</c> — Restart an agent</item>
|
|
||||||
/// <item><c>POST /api/command/steer/{agentId}</c> — Inject a message into an agent's session</item>
|
|
||||||
/// </list>
|
|
||||||
///
|
|
||||||
/// <para>Commands are forwarded to the OpenClaw Gateway via the
|
|
||||||
/// WebSocket bridge service. The Gateway handles the actual execution.</para>
|
|
||||||
/// </summary>
|
|
||||||
[ApiController]
|
|
||||||
[Route("api/[controller]")]
|
|
||||||
public class CommandController : ControllerBase
|
|
||||||
{
|
|
||||||
private readonly ILogger<CommandController> _logger;
|
|
||||||
|
|
||||||
public CommandController(ILogger<CommandController> logger)
|
|
||||||
{
|
|
||||||
_logger = logger;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Stops (aborts) an agent's active session.
|
|
||||||
/// Sends an abort command to the OpenClaw Gateway.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="agentId">The agent identifier to stop.</param>
|
|
||||||
/// <returns>Confirmation of the stop command.</returns>
|
|
||||||
/// <response code="200">Stop command sent successfully.</response>
|
|
||||||
/// <response code="404">No active session found for the agent.</response>
|
|
||||||
[HttpPost("stop/{agentId}")]
|
|
||||||
[ProducesResponseType(StatusCodes.Status200OK)]
|
|
||||||
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
||||||
public IActionResult StopAgent(string agentId)
|
|
||||||
{
|
|
||||||
_logger.LogInformation("Stop command received for agent {AgentId}", agentId);
|
|
||||||
|
|
||||||
// TODO: Forward to Gateway via bridge service
|
|
||||||
// await _bridgeService.SendRpcAsync("sessions.abort", new { sessionKey = ... });
|
|
||||||
|
|
||||||
return Ok(new
|
|
||||||
{
|
|
||||||
agentId,
|
|
||||||
command = "stop",
|
|
||||||
status = "sent",
|
|
||||||
timestamp = DateTime.UtcNow.ToString("o")
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Restarts an agent by aborting the current session and allowing
|
|
||||||
/// a new one to start on the next incoming message.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="agentId">The agent identifier to restart.</param>
|
|
||||||
/// <returns>Confirmation of the restart command.</returns>
|
|
||||||
/// <response code="200">Restart command sent successfully.</response>
|
|
||||||
[HttpPost("restart/{agentId}")]
|
|
||||||
[ProducesResponseType(StatusCodes.Status200OK)]
|
|
||||||
public IActionResult RestartAgent(string agentId)
|
|
||||||
{
|
|
||||||
_logger.LogInformation("Restart command received for agent {AgentId}", agentId);
|
|
||||||
|
|
||||||
// TODO: Forward to Gateway — abort current session + signal restart
|
|
||||||
|
|
||||||
return Ok(new
|
|
||||||
{
|
|
||||||
agentId,
|
|
||||||
command = "restart",
|
|
||||||
status = "sent",
|
|
||||||
timestamp = DateTime.UtcNow.ToString("o")
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Steers (injects a message into) an agent's active session.
|
|
||||||
/// Used by operators to redirect an agent's task mid-execution.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="agentId">The agent identifier to steer.</param>
|
|
||||||
/// <param name="request">The steering message to inject.</param>
|
|
||||||
/// <returns>Confirmation of the steer command.</returns>
|
|
||||||
/// <response code="200">Steer command sent successfully.</response>
|
|
||||||
/// <response code="400">Missing or empty message.</response>
|
|
||||||
[HttpPost("steer/{agentId}")]
|
|
||||||
[ProducesResponseType(StatusCodes.Status200OK)]
|
|
||||||
[ProducesResponseType(StatusCodes.Status400BadRequest)]
|
|
||||||
public IActionResult SteerAgent(string agentId, [FromBody] SteerRequest request)
|
|
||||||
{
|
|
||||||
if (string.IsNullOrWhiteSpace(request.Message))
|
|
||||||
{
|
|
||||||
return BadRequest(new { error = "Message is required" });
|
|
||||||
}
|
|
||||||
|
|
||||||
_logger.LogInformation("Steer command received for agent {AgentId}: {Message}",
|
|
||||||
agentId, request.Message.Length > 100
|
|
||||||
? request.Message[..100] + "..." : request.Message);
|
|
||||||
|
|
||||||
// TODO: Forward to Gateway via bridge service
|
|
||||||
// await _bridgeService.SendRpcAsync("sessions.steer", new { sessionKey = ..., message = request.Message });
|
|
||||||
|
|
||||||
return Ok(new
|
|
||||||
{
|
|
||||||
agentId,
|
|
||||||
command = "steer",
|
|
||||||
message = request.Message,
|
|
||||||
status = "sent",
|
|
||||||
timestamp = DateTime.UtcNow.ToString("o")
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Request body for the steer command.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="Message">The message to inject into the agent's session.</param>
|
|
||||||
public record SteerRequest(string Message);
|
|
||||||
@@ -1,87 +0,0 @@
|
|||||||
using Microsoft.AspNetCore.Mvc;
|
|
||||||
|
|
||||||
namespace ControlCenter.Controllers;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// REST API for querying agent session logs.
|
|
||||||
/// Provides historical message and tool call logs for a specific agent.
|
|
||||||
///
|
|
||||||
/// <para>API contract for Rex (Frontend):</para>
|
|
||||||
/// <list type="bullet">
|
|
||||||
/// <item><c>GET /api/logs/{agentId}</c> — Returns recent logs for an agent</item>
|
|
||||||
/// <item><c>GET /api/logs/{agentId}/tools</c> — Returns recent tool calls for an agent</item>
|
|
||||||
/// </list>
|
|
||||||
///
|
|
||||||
/// <para>Log data is sourced from the OpenClaw Gateway's transcript files.
|
|
||||||
/// The Gateway's <c>logs.tail</c> RPC provides the raw data, and this
|
|
||||||
/// controller formats it for the frontend.</para>
|
|
||||||
/// </summary>
|
|
||||||
[ApiController]
|
|
||||||
[Route("api/[controller]")]
|
|
||||||
public class LogsController : ControllerBase
|
|
||||||
{
|
|
||||||
private readonly ILogger<LogsController> _logger;
|
|
||||||
|
|
||||||
public LogsController(ILogger<LogsController> logger)
|
|
||||||
{
|
|
||||||
_logger = logger;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Gets recent session logs for a specific agent.
|
|
||||||
/// Returns the last N messages from the agent's active session transcript.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="agentId">The agent identifier, e.g. "otto", "dex".</param>
|
|
||||||
/// <param name="limit">Maximum number of log entries to return (default: 50, max: 200).</param>
|
|
||||||
/// <returns>An array of log entries for the agent.</returns>
|
|
||||||
/// <response code="200">Returns the agent's recent logs.</response>
|
|
||||||
/// <response code="404">No active session found for the agent.</response>
|
|
||||||
[HttpGet("{agentId}")]
|
|
||||||
[ProducesResponseType(StatusCodes.Status200OK)]
|
|
||||||
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
||||||
public IActionResult GetLogs(string agentId, [FromQuery] int limit = 50)
|
|
||||||
{
|
|
||||||
limit = Math.Clamp(limit, 1, 200);
|
|
||||||
|
|
||||||
_logger.LogDebug("Logs requested for agent {AgentId}, limit {Limit}", agentId, limit);
|
|
||||||
|
|
||||||
// TODO: Implement log retrieval by calling the Gateway's logs.tail RPC
|
|
||||||
// or reading transcript files. For now, return an empty array as the
|
|
||||||
// bridge service will provide this data when fully integrated.
|
|
||||||
return Ok(new
|
|
||||||
{
|
|
||||||
agentId,
|
|
||||||
logs = Array.Empty<object>(),
|
|
||||||
count = 0,
|
|
||||||
hasMore = false
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Gets recent tool call logs for a specific agent.
|
|
||||||
/// Returns the last N tool invocations from the agent's session.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="agentId">The agent identifier.</param>
|
|
||||||
/// <param name="limit">Maximum number of tool entries to return (default: 20, max: 100).</param>
|
|
||||||
/// <returns>An array of tool call entries for the agent.</returns>
|
|
||||||
/// <response code="200">Returns the agent's recent tool calls.</response>
|
|
||||||
/// <response code="404">No active session found for the agent.</response>
|
|
||||||
[HttpGet("{agentId}/tools")]
|
|
||||||
[ProducesResponseType(StatusCodes.Status200OK)]
|
|
||||||
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
||||||
public IActionResult GetToolLogs(string agentId, [FromQuery] int limit = 20)
|
|
||||||
{
|
|
||||||
limit = Math.Clamp(limit, 1, 100);
|
|
||||||
|
|
||||||
_logger.LogDebug("Tool logs requested for agent {AgentId}, limit {Limit}", agentId, limit);
|
|
||||||
|
|
||||||
// TODO: Implement tool log retrieval. Return empty for now.
|
|
||||||
return Ok(new
|
|
||||||
{
|
|
||||||
agentId,
|
|
||||||
tools = Array.Empty<object>(),
|
|
||||||
count = 0,
|
|
||||||
hasMore = false
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,211 +0,0 @@
|
|||||||
using Microsoft.AspNetCore.SignalR;
|
|
||||||
|
|
||||||
namespace ControlCenter.Hubs;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// SignalR hub for real-time agent status updates in the Command Hub.
|
|
||||||
///
|
|
||||||
/// <para>Usage flow:</para>
|
|
||||||
/// <list type="number">
|
|
||||||
/// <item>Client connects to <c>/hubs/agent-status</c></item>
|
|
||||||
/// <item>Client calls <see cref="JoinFleet"/> to subscribe to all agent updates</item>
|
|
||||||
/// <item>Client calls <see cref="JoinAgentGroup"/> to subscribe to a specific agent</item>
|
|
||||||
/// <item>Server pushes <see cref="IAgentStatusClient.AgentStatusChanged"/>
|
|
||||||
/// and <see cref="IAgentStatusClient.AgentTaskProgress"/> events</item>
|
|
||||||
/// <item>Client calls <see cref="GetFleetSnapshot"/> for initial state on connect</item>
|
|
||||||
/// </list>
|
|
||||||
///
|
|
||||||
/// <para>Group naming:</para>
|
|
||||||
/// <list type="bullet">
|
|
||||||
/// <item>Fleet group: <c>fleet</c> — receives all agent updates</item>
|
|
||||||
/// <item>Agent group: <c>agent:{agentId}</c> — receives updates for one agent</item>
|
|
||||||
/// </list>
|
|
||||||
///
|
|
||||||
/// <para>Typed client: <see cref="IAgentStatusClient"/> — all server-to-client
|
|
||||||
/// calls go through this interface for compile-time safety.</para>
|
|
||||||
///
|
|
||||||
/// <para>Architecture note: This hub bridges OpenClaw Gateway WebSocket events
|
|
||||||
/// to SignalR clients. A background service (<see cref="Services.GatewayEventBridgeService"/>)
|
|
||||||
/// subscribes to Gateway events and pushes them through this hub's extension methods.</para>
|
|
||||||
/// </summary>
|
|
||||||
public class AgentStatusHub : Hub<IAgentStatusClient>
|
|
||||||
{
|
|
||||||
private readonly ILogger<AgentStatusHub> _logger;
|
|
||||||
|
|
||||||
public AgentStatusHub(ILogger<AgentStatusHub> logger)
|
|
||||||
{
|
|
||||||
_logger = logger;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Broadcasts an agent status update to all connected clients.
|
|
||||||
///
|
|
||||||
/// <para>
|
|
||||||
/// Any connected client (or server-side caller) can invoke this method
|
|
||||||
/// to push a status update to every subscriber. The DTO is converted to
|
|
||||||
/// an <see cref="AgentStatusUpdate"/> record and relayed through the
|
|
||||||
/// <see cref="IAgentStatusClient.AgentStatusChanged"/> callback.
|
|
||||||
/// </para>
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="update">The agent status update DTO to broadcast.</param>
|
|
||||||
public async Task SendStatusUpdate(AgentStatusUpdateDto update)
|
|
||||||
{
|
|
||||||
_logger.LogInformation(
|
|
||||||
"Broadcasting status update for agent {AgentId}: {Status}",
|
|
||||||
update.AgentId, update.Status);
|
|
||||||
|
|
||||||
var agentUpdate = update.ToUpdate();
|
|
||||||
|
|
||||||
// Broadcast to all connected clients
|
|
||||||
await Clients.All.AgentStatusChanged(agentUpdate);
|
|
||||||
|
|
||||||
// Also push to the specific agent's group
|
|
||||||
var agentGroup = AgentGroupName(update.AgentId);
|
|
||||||
await Clients.Group(agentGroup).AgentStatusChanged(agentUpdate);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Adds the calling connection to the fleet group.
|
|
||||||
/// Once joined, the client will receive all agent status changes
|
|
||||||
/// and task progress updates across the entire fleet.
|
|
||||||
/// </summary>
|
|
||||||
public async Task JoinFleet()
|
|
||||||
{
|
|
||||||
await Groups.AddToGroupAsync(Context.ConnectionId, FleetGroupName);
|
|
||||||
_logger.LogDebug("Connection {ConnectionId} joined fleet group", Context.ConnectionId);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Removes the calling connection from the fleet group.
|
|
||||||
/// </summary>
|
|
||||||
public async Task LeaveFleet()
|
|
||||||
{
|
|
||||||
await Groups.RemoveFromGroupAsync(Context.ConnectionId, FleetGroupName);
|
|
||||||
_logger.LogDebug("Connection {ConnectionId} left fleet group", Context.ConnectionId);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Adds the calling connection to a specific agent's group.
|
|
||||||
/// Once joined, the client will receive updates only for that agent.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="agentId">The agent identifier, e.g. "otto", "dex".</param>
|
|
||||||
/// <exception cref="HubException">Thrown if agentId is null or empty.</exception>
|
|
||||||
public async Task JoinAgentGroup(string agentId)
|
|
||||||
{
|
|
||||||
if (string.IsNullOrWhiteSpace(agentId))
|
|
||||||
throw new HubException("agentId is required");
|
|
||||||
|
|
||||||
var groupName = AgentGroupName(agentId);
|
|
||||||
await Groups.AddToGroupAsync(Context.ConnectionId, groupName);
|
|
||||||
_logger.LogDebug("Connection {ConnectionId} joined agent group {GroupName}",
|
|
||||||
Context.ConnectionId, groupName);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Removes the calling connection from a specific agent's group.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="agentId">The agent identifier.</param>
|
|
||||||
public async Task LeaveAgentGroup(string agentId)
|
|
||||||
{
|
|
||||||
if (string.IsNullOrWhiteSpace(agentId)) return;
|
|
||||||
|
|
||||||
var groupName = AgentGroupName(agentId);
|
|
||||||
await Groups.RemoveFromGroupAsync(Context.ConnectionId, groupName);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Returns a snapshot of the current fleet state.
|
|
||||||
/// Called by clients on initial connection to get the full picture
|
|
||||||
/// before incremental updates begin arriving.
|
|
||||||
/// </summary>
|
|
||||||
/// <returns>An array of <see cref="AgentCardData"/> representing all known agents.</returns>
|
|
||||||
public Task<AgentCardData[]> GetFleetSnapshot()
|
|
||||||
{
|
|
||||||
// The fleet state is managed by the GatewayEventBridgeService.
|
|
||||||
// For now, return an empty array — the bridge service will push
|
|
||||||
// updates as they arrive from the Gateway.
|
|
||||||
_logger.LogDebug("Fleet snapshot requested by {ConnectionId}", Context.ConnectionId);
|
|
||||||
return Task.FromResult(Array.Empty<AgentCardData>());
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Overrides <see cref="Hub.OnDisconnectedAsync"/> to perform cleanup.
|
|
||||||
/// SignalR automatically removes disconnected connections from all groups.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="exception">Exception that caused the disconnection, if any.</param>
|
|
||||||
public override Task OnDisconnectedAsync(Exception? exception)
|
|
||||||
{
|
|
||||||
_logger.LogDebug("Connection {ConnectionId} disconnected", Context.ConnectionId);
|
|
||||||
return base.OnDisconnectedAsync(exception);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// The SignalR group name for the entire fleet (all agents).
|
|
||||||
/// </summary>
|
|
||||||
internal const string FleetGroupName = "fleet";
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Returns the SignalR group name for a specific agent.
|
|
||||||
/// Format: <c>agent:{agentId}</c> (lowercase for consistency).
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="agentId">The agent identifier.</param>
|
|
||||||
internal static string AgentGroupName(string agentId) =>
|
|
||||||
$"agent:{agentId.ToLowerInvariant()}";
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Extension methods for pushing real-time agent updates through
|
|
||||||
/// the <see cref="IHubContext{T}"/> of <see cref="AgentStatusHub"/>.
|
|
||||||
///
|
|
||||||
/// <para>These methods are intended to be called from background services
|
|
||||||
/// (e.g., <see cref="Services.GatewayEventBridgeService"/>) or other
|
|
||||||
/// server-side code that detects an agent state change.</para>
|
|
||||||
/// </summary>
|
|
||||||
public static class AgentStatusHubExtensions
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Pushes an agent status change to all clients subscribed to
|
|
||||||
/// the fleet group and the specific agent's group.
|
|
||||||
///
|
|
||||||
/// <para>Call this from any background service when an agent's
|
|
||||||
/// operational status changes (e.g., the Gateway reports a
|
|
||||||
/// session transition from "running" to "done").</para>
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="hubContext">The hub context injected via DI.</param>
|
|
||||||
/// <param name="update">The agent status update payload.</param>
|
|
||||||
/// <returns>A Task that completes when the message has been sent to all group members.</returns>
|
|
||||||
public static async Task PushAgentStatusAsync(
|
|
||||||
this IHubContext<AgentStatusHub, IAgentStatusClient> hubContext,
|
|
||||||
AgentStatusUpdate update)
|
|
||||||
{
|
|
||||||
// Broadcast to the fleet group (all subscribers)
|
|
||||||
await hubContext.Clients.Group(AgentStatusHub.FleetGroupName)
|
|
||||||
.AgentStatusChanged(update);
|
|
||||||
|
|
||||||
// Also push to the specific agent's group
|
|
||||||
var agentGroup = AgentStatusHub.AgentGroupName(update.AgentId);
|
|
||||||
await hubContext.Clients.Group(agentGroup)
|
|
||||||
.AgentStatusChanged(update);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Pushes a task progress update to all clients subscribed to
|
|
||||||
/// the fleet group and the specific agent's group.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="hubContext">The hub context injected via DI.</param>
|
|
||||||
/// <param name="progress">The task progress update payload.</param>
|
|
||||||
/// <returns>A Task that completes when the message has been sent to all group members.</returns>
|
|
||||||
public static async Task PushTaskProgressAsync(
|
|
||||||
this IHubContext<AgentStatusHub, IAgentStatusClient> hubContext,
|
|
||||||
TaskProgressUpdate progress)
|
|
||||||
{
|
|
||||||
// Broadcast to the fleet group
|
|
||||||
await hubContext.Clients.Group(AgentStatusHub.FleetGroupName)
|
|
||||||
.AgentTaskProgress(progress);
|
|
||||||
|
|
||||||
// Also push to the specific agent's group
|
|
||||||
var agentGroup = AgentStatusHub.AgentGroupName(progress.AgentId);
|
|
||||||
await hubContext.Clients.Group(agentGroup)
|
|
||||||
.AgentTaskProgress(progress);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,30 +0,0 @@
|
|||||||
namespace ControlCenter.Hubs;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Strongly-typed client interface for the AgentStatus SignalR hub.
|
|
||||||
/// Defines the methods the server can invoke on connected clients
|
|
||||||
/// to push real-time agent status and task progress updates.
|
|
||||||
///
|
|
||||||
/// <para>All server-to-client calls go through this interface for
|
|
||||||
/// compile-time safety — matching the pattern used by the
|
|
||||||
/// Extrudex PrinterHub.</para>
|
|
||||||
/// </summary>
|
|
||||||
public interface IAgentStatusClient
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Pushes an agent status change to all subscribed clients.
|
|
||||||
/// Fired whenever an agent's operational status changes
|
|
||||||
/// (e.g., idle → active, active → thinking, active → error).
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="update">The full status update payload.</param>
|
|
||||||
/// <returns>A Task that completes when the client has processed the update.</returns>
|
|
||||||
Task AgentStatusChanged(AgentStatusUpdate update);
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Pushes a task progress update to all subscribed clients.
|
|
||||||
/// Fired when an agent reports progress on its current task.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="progress">The task progress update payload.</param>
|
|
||||||
/// <returns>A Task that completes when the client has processed the update.</returns>
|
|
||||||
Task AgentTaskProgress(TaskProgressUpdate progress);
|
|
||||||
}
|
|
||||||
@@ -1,166 +0,0 @@
|
|||||||
namespace ControlCenter;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Agent operational status derived from OpenClaw Gateway session activity.
|
|
||||||
/// Maps to the frontend AgentStatus type: 'active' | 'idle' | 'thinking' | 'error'.
|
|
||||||
/// </summary>
|
|
||||||
public enum AgentStatus
|
|
||||||
{
|
|
||||||
/// <summary>Agent is currently processing a turn.</summary>
|
|
||||||
Active,
|
|
||||||
|
|
||||||
/// <summary>Agent completed its last turn; no active work.</summary>
|
|
||||||
Idle,
|
|
||||||
|
|
||||||
/// <summary>LLM call in flight; tokens streaming.</summary>
|
|
||||||
Thinking,
|
|
||||||
|
|
||||||
/// <summary>Agent encountered an unhandled error.</summary>
|
|
||||||
Error
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Extended lifecycle status including offline — not all agents have active sessions.
|
|
||||||
/// Used internally; clients only see <see cref="AgentStatus"/> (offline maps to idle).
|
|
||||||
/// </summary>
|
|
||||||
public enum AgentLifecycleStatus
|
|
||||||
{
|
|
||||||
Active,
|
|
||||||
Idle,
|
|
||||||
Thinking,
|
|
||||||
Error,
|
|
||||||
Offline
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Pushed to SignalR clients when an agent's status changes.
|
|
||||||
/// Matches the TypeScript <c>AgentStatusUpdate</c> interface from the design spec.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="AgentId">Agent identifier, e.g. "otto", "dex".</param>
|
|
||||||
/// <param name="DisplayName">Human-readable name, e.g. "Otto".</param>
|
|
||||||
/// <param name="Role">Role description, e.g. "Orchestrator Agent".</param>
|
|
||||||
/// <param name="Status">Current operational status.</param>
|
|
||||||
/// <param name="CurrentTask">Description of the current task, if any.</param>
|
|
||||||
/// <param name="SessionKey">Full session key, e.g. "agent:otto:telegram:direct:8787451565".</param>
|
|
||||||
/// <param name="Channel">Channel the agent is operating on, e.g. "telegram".</param>
|
|
||||||
/// <param name="LastActivity">ISO 8601 timestamp of last activity.</param>
|
|
||||||
/// <param name="ErrorMessage">Error message when status is 'error'.</param>
|
|
||||||
public record AgentStatusUpdate(
|
|
||||||
string AgentId,
|
|
||||||
string DisplayName,
|
|
||||||
string Role,
|
|
||||||
string Status,
|
|
||||||
string? CurrentTask,
|
|
||||||
string SessionKey,
|
|
||||||
string Channel,
|
|
||||||
string LastActivity,
|
|
||||||
string? ErrorMessage = null
|
|
||||||
);
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Pushed to SignalR clients when an agent's task progress updates.
|
|
||||||
/// Matches the TypeScript <c>TaskProgressUpdate</c> interface from the design spec.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="AgentId">Agent identifier.</param>
|
|
||||||
/// <param name="TaskDescription">Description of the current task.</param>
|
|
||||||
/// <param name="Progress">Task progress percentage (0–100), if trackable.</param>
|
|
||||||
/// <param name="Elapsed">Elapsed time string, e.g. "04m 12s".</param>
|
|
||||||
public record TaskProgressUpdate(
|
|
||||||
string AgentId,
|
|
||||||
string TaskDescription,
|
|
||||||
int? Progress,
|
|
||||||
string? Elapsed
|
|
||||||
);
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Data transfer object for broadcasting agent status updates
|
|
||||||
/// to all connected SignalR clients via the hub's SendStatusUpdate method.
|
|
||||||
///
|
|
||||||
/// <para>This DTO provides a mutable, serialization-friendly alternative to
|
|
||||||
/// <see cref="AgentStatusUpdate"/> for callers that construct updates
|
|
||||||
/// from external data sources (e.g., HTTP API payloads).</para>
|
|
||||||
/// </summary>
|
|
||||||
public class AgentStatusUpdateDto
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Agent identifier, e.g. "otto", "dex", "rex".
|
|
||||||
/// </summary>
|
|
||||||
public string AgentId { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Human-readable display name, e.g. "Otto", "Dex".
|
|
||||||
/// </summary>
|
|
||||||
public string DisplayName { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Role description, e.g. "Orchestrator Agent", "Backend Specialist".
|
|
||||||
/// </summary>
|
|
||||||
public string Role { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Current operational status of the agent as lowercase string:
|
|
||||||
/// "active", "idle", "thinking", "error".
|
|
||||||
/// </summary>
|
|
||||||
public string Status { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Description of the agent's current task, if any.
|
|
||||||
/// </summary>
|
|
||||||
public string? CurrentTask { get; set; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Full session key, e.g. "agent:otto:telegram:direct:8787451565".
|
|
||||||
/// </summary>
|
|
||||||
public string SessionKey { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Communication channel, e.g. "telegram", "discord", "slack".
|
|
||||||
/// </summary>
|
|
||||||
public string Channel { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// ISO 8601 timestamp of the agent's last activity.
|
|
||||||
/// </summary>
|
|
||||||
public string LastActivity { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Error message when the agent status is "error".
|
|
||||||
/// </summary>
|
|
||||||
public string? ErrorMessage { get; set; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Converts this DTO to an immutable <see cref="AgentStatusUpdate"/> record
|
|
||||||
/// for use with the typed SignalR client interface.
|
|
||||||
/// </summary>
|
|
||||||
/// <returns>An <see cref="AgentStatusUpdate"/> with equivalent field values.</returns>
|
|
||||||
public AgentStatusUpdate ToUpdate() => new(
|
|
||||||
AgentId,
|
|
||||||
DisplayName,
|
|
||||||
Role,
|
|
||||||
Status,
|
|
||||||
CurrentTask,
|
|
||||||
SessionKey,
|
|
||||||
Channel,
|
|
||||||
LastActivity,
|
|
||||||
ErrorMessage
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Snapshot of an agent's full card data, sent on initial connection
|
|
||||||
/// or when the fleet state is requested.
|
|
||||||
/// Matches the TypeScript <c>AgentCardData</c> interface from the design spec.
|
|
||||||
/// </summary>
|
|
||||||
public record AgentCardData(
|
|
||||||
string Id,
|
|
||||||
string DisplayName,
|
|
||||||
string Role,
|
|
||||||
string Status,
|
|
||||||
string? CurrentTask,
|
|
||||||
int? TaskProgress,
|
|
||||||
string? TaskElapsed,
|
|
||||||
string SessionKey,
|
|
||||||
string Channel,
|
|
||||||
string LastActivity,
|
|
||||||
string? ErrorMessage
|
|
||||||
);
|
|
||||||
@@ -1,72 +0,0 @@
|
|||||||
namespace ControlCenter.Models;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Defines which side of the Control Center dashboard a minion occupies.
|
|
||||||
/// </summary>
|
|
||||||
public enum MinionSide
|
|
||||||
{
|
|
||||||
/// <summary>Development side — Rex, Dex, Hex.</summary>
|
|
||||||
Dev,
|
|
||||||
|
|
||||||
/// <summary>Business side — Larry, Mel, Buzz.</summary>
|
|
||||||
Business
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Visual state of a minion sprite, derived from the agent's
|
|
||||||
/// <see cref="AgentStatus"/>. Maps Active/Idle/Thinking/Error
|
|
||||||
/// to frontend animation states.
|
|
||||||
/// </summary>
|
|
||||||
public enum MinionState
|
|
||||||
{
|
|
||||||
/// <summary>Agent is actively processing — minion shows working animation.</summary>
|
|
||||||
Active,
|
|
||||||
|
|
||||||
/// <summary>Agent is idle — minion shows idle/patrolling animation.</summary>
|
|
||||||
Idle,
|
|
||||||
|
|
||||||
/// <summary>Agent is thinking (LLM call in flight) — minion shows thinking animation.</summary>
|
|
||||||
Thinking,
|
|
||||||
|
|
||||||
/// <summary>Agent encountered an error — minion shows error/distress animation.</summary>
|
|
||||||
Error
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Static mapping entry that associates an agent ID with a minion's
|
|
||||||
/// display side and position index within that side.
|
|
||||||
///
|
|
||||||
/// <para>Position indices are zero-based within each side. The dev side
|
|
||||||
/// has Rex at 0, Dex at 1, and Hex at 2. The business side has
|
|
||||||
/// Larry at 0, Mel at 1, and Buzz at 2.</para>
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="AgentId">Agent identifier, e.g. "rex", "dex".</param>
|
|
||||||
/// <param name="Side">Which side of the dashboard the minion occupies.</param>
|
|
||||||
/// <param name="PositionIndex">Zero-based position index within the side.</param>
|
|
||||||
/// <param name="DisplayName">Human-readable name, e.g. "Rex".</param>
|
|
||||||
public record AgentMinionMapping(
|
|
||||||
string AgentId,
|
|
||||||
MinionSide Side,
|
|
||||||
int PositionIndex,
|
|
||||||
string DisplayName
|
|
||||||
);
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Real-time minion state update pushed to SignalR clients
|
|
||||||
/// when an agent's status changes. Combines the static mapping
|
|
||||||
/// (who/where) with the dynamic state (what the minion is doing).
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="AgentId">Agent identifier, e.g. "rex".</param>
|
|
||||||
/// <param name="DisplayName">Human-readable minion name, e.g. "Rex".</param>
|
|
||||||
/// <param name="Side">Which side of the dashboard — Dev or Business.</param>
|
|
||||||
/// <param name="PositionIndex">Position within the side (0-based).</param>
|
|
||||||
/// <param name="State">Current minion animation state.</param>
|
|
||||||
/// <param name="Timestamp">ISO 8601 timestamp of the state change.</param>
|
|
||||||
public record MinionStateUpdate(
|
|
||||||
string AgentId,
|
|
||||||
string DisplayName,
|
|
||||||
MinionSide Side,
|
|
||||||
int PositionIndex,
|
|
||||||
MinionState State,
|
|
||||||
string Timestamp
|
|
||||||
);
|
|
||||||
@@ -1,77 +0,0 @@
|
|||||||
using System.Reflection;
|
|
||||||
using ControlCenter.Hubs;
|
|
||||||
using ControlCenter.Services;
|
|
||||||
|
|
||||||
var builder = WebApplication.CreateBuilder(args);
|
|
||||||
|
|
||||||
// ── API Services ───────────────────────────────────────────
|
|
||||||
builder.Services.AddControllers();
|
|
||||||
builder.Services.AddEndpointsApiExplorer();
|
|
||||||
builder.Services.AddSwaggerGen(c =>
|
|
||||||
{
|
|
||||||
c.SwaggerDoc("v1", new()
|
|
||||||
{
|
|
||||||
Title = "Control Center API",
|
|
||||||
Version = "v1",
|
|
||||||
Description = "OpenClaw Control Center — Command Hub backend with SignalR real-time updates"
|
|
||||||
});
|
|
||||||
|
|
||||||
// Include XML doc comments in Swagger output
|
|
||||||
var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
|
|
||||||
var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
|
|
||||||
if (File.Exists(xmlPath))
|
|
||||||
{
|
|
||||||
c.IncludeXmlComments(xmlPath);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// ── CORS (kiosk + remote browser) ─────────────────────────
|
|
||||||
// The Control Center frontend runs on a different origin than the backend.
|
|
||||||
// SignalR requires credentials for WebSocket transport, so we use
|
|
||||||
// specific origins rather than AllowAnyOrigin.
|
|
||||||
var corsOrigins = builder.Configuration.GetSection("Cors:AllowedOrigins")
|
|
||||||
.Get<string[]>() ?? new[] { "http://localhost:4200", "http://localhost:5000" };
|
|
||||||
|
|
||||||
builder.Services.AddCors(options =>
|
|
||||||
{
|
|
||||||
options.AddDefaultPolicy(policy =>
|
|
||||||
{
|
|
||||||
policy.WithOrigins(corsOrigins)
|
|
||||||
.AllowAnyMethod()
|
|
||||||
.AllowAnyHeader()
|
|
||||||
.AllowCredentials(); // Required for SignalR WebSocket
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
// ── SignalR (real-time agent status updates) ───────────────
|
|
||||||
builder.Services.AddSignalR();
|
|
||||||
|
|
||||||
// ── Gateway Bridge Service ────────────────────────────────
|
|
||||||
// Background service that connects to the OpenClaw Gateway WebSocket
|
|
||||||
// and bridges events to the AgentStatus SignalR hub.
|
|
||||||
builder.Services.AddSingleton<GatewayEventBridgeService>();
|
|
||||||
builder.Services.AddHostedService(sp => sp.GetRequiredService<GatewayEventBridgeService>());
|
|
||||||
|
|
||||||
// ── Agent-Minion Mapper Service ────────────────────────────
|
|
||||||
// Maps agents to minion sprites/positions and publishes state
|
|
||||||
// updates through SignalR.
|
|
||||||
builder.Services.AddSingleton<AgentMinionMapperService>();
|
|
||||||
|
|
||||||
var app = builder.Build();
|
|
||||||
|
|
||||||
// ── Middleware ──────────────────────────────────────────────
|
|
||||||
if (app.Environment.IsDevelopment())
|
|
||||||
{
|
|
||||||
app.UseSwagger();
|
|
||||||
app.UseSwaggerUI();
|
|
||||||
}
|
|
||||||
|
|
||||||
app.UseCors();
|
|
||||||
app.UseAuthorization();
|
|
||||||
app.MapControllers();
|
|
||||||
|
|
||||||
// ── Hub Endpoints ───────────────────────────────────────────
|
|
||||||
// Agent status hub at /hubs/agent-status (matches the design spec)
|
|
||||||
app.MapHub<AgentStatusHub>("/hubs/agent-status");
|
|
||||||
|
|
||||||
app.Run();
|
|
||||||
@@ -1,14 +0,0 @@
|
|||||||
{
|
|
||||||
"$schema": "https://json.schemastore.org/launchsettings.json",
|
|
||||||
"profiles": {
|
|
||||||
"http": {
|
|
||||||
"commandName": "Project",
|
|
||||||
"dotnetRunMessages": true,
|
|
||||||
"launchBrowser": false,
|
|
||||||
"applicationUrl": "http://localhost:5053",
|
|
||||||
"environmentVariables": {
|
|
||||||
"ASPNETCORE_ENVIRONMENT": "Development"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,193 +0,0 @@
|
|||||||
using ControlCenter.Hubs;
|
|
||||||
using ControlCenter.Models;
|
|
||||||
using Microsoft.AspNetCore.SignalR;
|
|
||||||
|
|
||||||
namespace ControlCenter.Services;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Service that maps Linear agents to minion sprites and positions
|
|
||||||
/// in the Control Center dashboard.
|
|
||||||
///
|
|
||||||
/// <para>Static mappings define where each minion appears:</para>
|
|
||||||
/// <list type="bullet">
|
|
||||||
/// <item>Dev side: Rex (0), Dex (1), Hex (2)</item>
|
|
||||||
/// <item>Business side: Larry (0), Mel (1), Buzz (2)</item>
|
|
||||||
/// </list>
|
|
||||||
///
|
|
||||||
/// <para>Dynamic state is derived from the agent's <see cref="AgentStatus"/>:</para>
|
|
||||||
/// <list type="bullet">
|
|
||||||
/// <item><c>Active</c> → <see cref="MinionState.Active"/></item>
|
|
||||||
/// <item><c>Idle</c> → <see cref="MinionState.Idle"/></item>
|
|
||||||
/// <item><c>Thinking</c> → <see cref="MinionState.Thinking"/></item>
|
|
||||||
/// <item><c>Error</c> → <see cref="MinionState.Error"/></item>
|
|
||||||
/// </list>
|
|
||||||
///
|
|
||||||
/// <para>State updates are published through the <see cref="AgentStatusHub"/>
|
|
||||||
/// SignalR hub so that connected clients can animate minion sprites
|
|
||||||
/// in real time.</para>
|
|
||||||
/// </summary>
|
|
||||||
public class AgentMinionMapperService
|
|
||||||
{
|
|
||||||
private readonly ILogger<AgentMinionMapperService> _logger;
|
|
||||||
private readonly IHubContext<AgentStatusHub, IAgentStatusClient> _hubContext;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Static agent-to-minion mapping table. Defines which side and position
|
|
||||||
/// each agent's minion occupies on the dashboard.
|
|
||||||
/// </summary>
|
|
||||||
private static readonly Dictionary<string, AgentMinionMapping> Mappings = new()
|
|
||||||
{
|
|
||||||
// ── Dev Side ──────────────────────────────────
|
|
||||||
["rex"] = new AgentMinionMapping("rex", MinionSide.Dev, 0, "Rex"),
|
|
||||||
["dex"] = new AgentMinionMapping("dex", MinionSide.Dev, 1, "Dex"),
|
|
||||||
["hex"] = new AgentMinionMapping("hex", MinionSide.Dev, 2, "Hex"),
|
|
||||||
|
|
||||||
// ── Business Side ─────────────────────────────
|
|
||||||
["larry"] = new AgentMinionMapping("larry", MinionSide.Business, 0, "Larry"),
|
|
||||||
["mel"] = new AgentMinionMapping("mel", MinionSide.Business, 1, "Mel"),
|
|
||||||
["buzz"] = new AgentMinionMapping("buzz", MinionSide.Business, 2, "Buzz"),
|
|
||||||
};
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Maps <see cref="AgentStatus"/> string values to <see cref="MinionState"/>.
|
|
||||||
/// </summary>
|
|
||||||
private static readonly Dictionary<string, MinionState> StatusToMinionState = new()
|
|
||||||
{
|
|
||||||
["active"] = MinionState.Active,
|
|
||||||
["idle"] = MinionState.Idle,
|
|
||||||
["thinking"] = MinionState.Thinking,
|
|
||||||
["error"] = MinionState.Error,
|
|
||||||
};
|
|
||||||
|
|
||||||
public AgentMinionMapperService(
|
|
||||||
ILogger<AgentMinionMapperService> logger,
|
|
||||||
IHubContext<AgentStatusHub, IAgentStatusClient> hubContext)
|
|
||||||
{
|
|
||||||
_logger = logger;
|
|
||||||
_hubContext = hubContext;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Gets the minion mapping for a given agent ID.
|
|
||||||
/// Returns null if the agent is not mapped to a minion position.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="agentId">The agent identifier, e.g. "rex", "dex".</param>
|
|
||||||
/// <returns>The mapping record, or null if unmapped.</returns>
|
|
||||||
public AgentMinionMapping? GetMapping(string agentId)
|
|
||||||
{
|
|
||||||
return Mappings.GetValueOrDefault(agentId?.ToLowerInvariant() ?? string.Empty);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Gets all minion mappings, ordered by side then position index.
|
|
||||||
/// </summary>
|
|
||||||
/// <returns>All mappings, sorted for consistent display order.</returns>
|
|
||||||
public IReadOnlyList<AgentMinionMapping> GetAllMappings()
|
|
||||||
{
|
|
||||||
return Mappings.Values
|
|
||||||
.OrderBy(m => m.Side)
|
|
||||||
.ThenBy(m => m.PositionIndex)
|
|
||||||
.ToList();
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Converts an agent status string to a <see cref="MinionState"/>.
|
|
||||||
/// Falls back to <see cref="MinionState.Idle"/> for unrecognized statuses.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="status">Agent status string: "active", "idle", "thinking", or "error".</param>
|
|
||||||
/// <returns>The corresponding minion state.</returns>
|
|
||||||
public MinionState StatusToState(string status)
|
|
||||||
{
|
|
||||||
return StatusToMinionState.GetValueOrDefault(
|
|
||||||
status?.ToLowerInvariant() ?? string.Empty,
|
|
||||||
MinionState.Idle);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Publishes a minion state update through SignalR when an agent's
|
|
||||||
/// status changes. Only publishes for agents that have a minion mapping.
|
|
||||||
///
|
|
||||||
/// <para>This is the primary integration point: the
|
|
||||||
/// <see cref="GatewayEventBridgeService"/> calls this method
|
|
||||||
/// whenever it detects a status change from the OpenClaw Gateway.</para>
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="agentId">The agent whose status changed, e.g. "dex".</param>
|
|
||||||
/// <param name="status">The new status string: "active", "idle", "thinking", or "error".</param>
|
|
||||||
/// <returns>A task that completes when the SignalR message has been sent.</returns>
|
|
||||||
public async Task PublishMinionStateUpdateAsync(string agentId, string status)
|
|
||||||
{
|
|
||||||
var mapping = GetMapping(agentId);
|
|
||||||
if (mapping is null)
|
|
||||||
{
|
|
||||||
_logger.LogDebug("No minion mapping for agent {AgentId}; skipping state update", agentId);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
var minionState = StatusToState(status);
|
|
||||||
var update = new MinionStateUpdate(
|
|
||||||
AgentId: mapping.AgentId,
|
|
||||||
DisplayName: mapping.DisplayName,
|
|
||||||
Side: mapping.Side,
|
|
||||||
PositionIndex: mapping.PositionIndex,
|
|
||||||
State: minionState,
|
|
||||||
Timestamp: DateTime.UtcNow.ToString("o")
|
|
||||||
);
|
|
||||||
|
|
||||||
// Broadcast to the fleet group (all subscribers)
|
|
||||||
await _hubContext.Clients.Group(AgentStatusHub.FleetGroupName)
|
|
||||||
.AgentStatusChanged(ToAgentStatusUpdate(agentId, status));
|
|
||||||
|
|
||||||
// Also push to the specific agent's group
|
|
||||||
var agentGroup = AgentStatusHub.AgentGroupName(agentId);
|
|
||||||
await _hubContext.Clients.Group(agentGroup)
|
|
||||||
.AgentStatusChanged(ToAgentStatusUpdate(agentId, status));
|
|
||||||
|
|
||||||
_logger.LogInformation(
|
|
||||||
"Minion state update: {AgentId} → {State} (Side: {Side}, Position: {Index})",
|
|
||||||
agentId, minionState, mapping.Side, mapping.PositionIndex);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Gets the current minion state for all mapped agents, suitable
|
|
||||||
/// for building an initial fleet snapshot.
|
|
||||||
/// </summary>
|
|
||||||
/// <returns>All minion mappings with their current (idle) state.</returns>
|
|
||||||
public IReadOnlyList<MinionStateUpdate> GetFullMinionState()
|
|
||||||
{
|
|
||||||
return Mappings.Values
|
|
||||||
.OrderBy(m => m.Side)
|
|
||||||
.ThenBy(m => m.PositionIndex)
|
|
||||||
.Select(m => new MinionStateUpdate(
|
|
||||||
AgentId: m.AgentId,
|
|
||||||
DisplayName: m.DisplayName,
|
|
||||||
Side: m.Side,
|
|
||||||
PositionIndex: m.PositionIndex,
|
|
||||||
State: MinionState.Idle,
|
|
||||||
Timestamp: DateTime.UtcNow.ToString("o")))
|
|
||||||
.ToList();
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Converts a status string to an <see cref="AgentStatusUpdate"/>
|
|
||||||
/// for SignalR push. Uses the mapping table for display names and roles.
|
|
||||||
/// </summary>
|
|
||||||
private AgentStatusUpdate ToAgentStatusUpdate(string agentId, string status)
|
|
||||||
{
|
|
||||||
var mapping = GetMapping(agentId);
|
|
||||||
var displayName = mapping?.DisplayName ?? char.ToUpperInvariant(agentId[0]) + agentId[1..];
|
|
||||||
|
|
||||||
return new AgentStatusUpdate(
|
|
||||||
AgentId: agentId,
|
|
||||||
DisplayName: displayName,
|
|
||||||
Role: mapping is not null
|
|
||||||
? $"{mapping.Side} Agent"
|
|
||||||
: "Agent",
|
|
||||||
Status: status,
|
|
||||||
CurrentTask: null,
|
|
||||||
SessionKey: string.Empty,
|
|
||||||
Channel: string.Empty,
|
|
||||||
LastActivity: DateTime.UtcNow.ToString("o"),
|
|
||||||
ErrorMessage: status == "error" ? "Agent encountered an error" : null
|
|
||||||
);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,523 +0,0 @@
|
|||||||
using System.Collections.Concurrent;
|
|
||||||
using System.Net.WebSockets;
|
|
||||||
using System.Text;
|
|
||||||
using System.Text.Json;
|
|
||||||
using ControlCenter.Hubs;
|
|
||||||
using Microsoft.AspNetCore.SignalR;
|
|
||||||
|
|
||||||
namespace ControlCenter.Services;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Background service that connects to the OpenClaw Gateway WebSocket
|
|
||||||
/// and bridges Gateway events to the <see cref="Hubs.AgentStatusHub"/>.
|
|
||||||
///
|
|
||||||
/// <para>Architecture:</para>
|
|
||||||
/// <list type="number">
|
|
||||||
/// <item>Connects to the Gateway WS endpoint (configurable via appsettings)</item>
|
|
||||||
/// <item>Handles the v3 protocol handshake (challenge → connect → hello-ok)</item>
|
|
||||||
/// <item>Subscribes to <c>sessions.changed</c> and related events</item>
|
|
||||||
/// <item>Translates session state changes into <see cref="AgentStatusUpdate"/>
|
|
||||||
/// and <see cref="TaskProgressUpdate"/> objects</item>
|
|
||||||
/// <item>Pushes updates through the <see cref="Hubs.AgentStatusHub"/> SignalR hub</item>
|
|
||||||
/// </list>
|
|
||||||
///
|
|
||||||
/// <para>This is the server-side bridge that allows Angular clients to
|
|
||||||
/// receive real-time updates via SignalR instead of connecting directly
|
|
||||||
/// to the Gateway WebSocket.</para>
|
|
||||||
/// </summary>
|
|
||||||
public class GatewayEventBridgeService : BackgroundService
|
|
||||||
{
|
|
||||||
private readonly ILogger<GatewayEventBridgeService> _logger;
|
|
||||||
private readonly IHubContext<Hubs.AgentStatusHub, Hubs.IAgentStatusClient> _hubContext;
|
|
||||||
private readonly IConfiguration _configuration;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// In-memory fleet state — maps agent IDs to their latest card data.
|
|
||||||
/// Updated on every <c>sessions.changed</c> event from the Gateway.
|
|
||||||
/// </summary>
|
|
||||||
private readonly ConcurrentDictionary<string, AgentCardData> _fleetState = new();
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Known agent roles for display in the Command Hub.
|
|
||||||
/// Maps agent IDs to their functional descriptions.
|
|
||||||
/// </summary>
|
|
||||||
private static readonly Dictionary<string, string> AgentRoles = new()
|
|
||||||
{
|
|
||||||
["main"] = "Primary Assistant",
|
|
||||||
["otto"] = "Orchestrator Agent",
|
|
||||||
["dave"] = "Network Admin Agent",
|
|
||||||
["bob"] = "Content Writer Agent",
|
|
||||||
["stuart"] = "Image & Creative Agent",
|
|
||||||
["phil"] = "Home Automation Agent",
|
|
||||||
["carl"] = "Security Agent",
|
|
||||||
["larry"] = "Business Agent",
|
|
||||||
["mel"] = "E-Commerce Agent",
|
|
||||||
["norbert"] = "Product Agent",
|
|
||||||
["jerry"] = "Market Research Agent",
|
|
||||||
["rex"] = "Frontend Dev Agent",
|
|
||||||
["dex"] = "Backend Dev Agent",
|
|
||||||
["hex"] = "Database Agent",
|
|
||||||
["pip"] = "Raspberry Pi Agent",
|
|
||||||
["nano"] = "ESP32/Firmware Agent",
|
|
||||||
["axiom"] = "Utility Agent",
|
|
||||||
["bonnie"] = "Music Agent",
|
|
||||||
["sketch"] = "UI/UX Design Agent",
|
|
||||||
["flip"] = "Mobile Dev Agent",
|
|
||||||
["buzz"] = "SEO Agent",
|
|
||||||
["aries"] = "Companion Agent"
|
|
||||||
};
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Maps OpenClaw session status to <see cref="AgentStatus"/>.
|
|
||||||
/// </summary>
|
|
||||||
private static string MapSessionStatus(string? sessionStatus) => sessionStatus switch
|
|
||||||
{
|
|
||||||
"running" => "active",
|
|
||||||
"streaming" => "thinking",
|
|
||||||
"error" or "aborted" => "error",
|
|
||||||
"done" => "idle",
|
|
||||||
_ => "idle"
|
|
||||||
};
|
|
||||||
|
|
||||||
public GatewayEventBridgeService(
|
|
||||||
ILogger<GatewayEventBridgeService> logger,
|
|
||||||
IHubContext<Hubs.AgentStatusHub, Hubs.IAgentStatusClient> hubContext,
|
|
||||||
IConfiguration configuration)
|
|
||||||
{
|
|
||||||
_logger = logger;
|
|
||||||
_hubContext = hubContext;
|
|
||||||
_configuration = configuration;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Returns the current fleet state snapshot.
|
|
||||||
/// Used by the hub's <c>GetFleetSnapshot</c> method and by the
|
|
||||||
/// <c>AgentsController</c> REST endpoint.
|
|
||||||
/// </summary>
|
|
||||||
public AgentCardData[] GetFleetSnapshot() =>
|
|
||||||
_fleetState.Values.ToArray();
|
|
||||||
|
|
||||||
protected override async Task ExecuteAsync(CancellationToken stoppingToken)
|
|
||||||
{
|
|
||||||
_logger.LogInformation("Gateway Event Bridge service starting");
|
|
||||||
|
|
||||||
while (!stoppingToken.IsCancellationRequested)
|
|
||||||
{
|
|
||||||
try
|
|
||||||
{
|
|
||||||
await ConnectAndListenAsync(stoppingToken);
|
|
||||||
}
|
|
||||||
catch (OperationCanceledException) when (stoppingToken.IsCancellationRequested)
|
|
||||||
{
|
|
||||||
_logger.LogInformation("Gateway Event Bridge service stopping");
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
catch (Exception ex)
|
|
||||||
{
|
|
||||||
_logger.LogError(ex, "Gateway connection lost, reconnecting in 5 seconds...");
|
|
||||||
await Task.Delay(TimeSpan.FromSeconds(5), stoppingToken);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Connects to the OpenClaw Gateway WebSocket and processes events
|
|
||||||
/// until the connection is lost or cancellation is requested.
|
|
||||||
/// </summary>
|
|
||||||
private async Task ConnectAndListenAsync(CancellationToken stoppingToken)
|
|
||||||
{
|
|
||||||
var gatewayUrl = _configuration["Gateway:WebSocketUrl"]
|
|
||||||
?? "ws://localhost:3271/ws";
|
|
||||||
var authToken = _configuration["Gateway:AuthToken"] ?? string.Empty;
|
|
||||||
|
|
||||||
_logger.LogInformation("Connecting to Gateway at {Url}", gatewayUrl);
|
|
||||||
|
|
||||||
using var ws = new ClientWebSocket();
|
|
||||||
|
|
||||||
// Set auth header if available
|
|
||||||
if (!string.IsNullOrEmpty(authToken))
|
|
||||||
{
|
|
||||||
ws.Options.SetRequestHeader("Authorization", $"Bearer {authToken}");
|
|
||||||
}
|
|
||||||
|
|
||||||
await ws.ConnectAsync(new Uri(gatewayUrl), stoppingToken);
|
|
||||||
_logger.LogInformation("Connected to Gateway WebSocket");
|
|
||||||
|
|
||||||
// Start receiving messages
|
|
||||||
await ReceiveMessagesAsync(ws, stoppingToken);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Receives and processes WebSocket messages from the Gateway.
|
|
||||||
/// Handles the v3 protocol handshake and dispatches events.
|
|
||||||
/// </summary>
|
|
||||||
private async Task ReceiveMessagesAsync(ClientWebSocket ws, CancellationToken stoppingToken)
|
|
||||||
{
|
|
||||||
var buffer = new byte[8192];
|
|
||||||
var messageBuilder = new StringBuilder();
|
|
||||||
|
|
||||||
while (ws.State == WebSocketState.Open && !stoppingToken.IsCancellationRequested)
|
|
||||||
{
|
|
||||||
WebSocketReceiveResult result;
|
|
||||||
try
|
|
||||||
{
|
|
||||||
result = await ws.ReceiveAsync(buffer, stoppingToken);
|
|
||||||
}
|
|
||||||
catch (WebSocketException ex)
|
|
||||||
{
|
|
||||||
_logger.LogWarning(ex, "WebSocket receive error");
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (result.MessageType == WebSocketMessageType.Close)
|
|
||||||
{
|
|
||||||
_logger.LogInformation("Gateway WebSocket closed by server");
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
|
|
||||||
messageBuilder.Append(Encoding.UTF8.GetString(buffer, 0, result.Count));
|
|
||||||
|
|
||||||
if (result.EndOfMessage)
|
|
||||||
{
|
|
||||||
var message = messageBuilder.ToString();
|
|
||||||
messageBuilder.Clear();
|
|
||||||
await ProcessMessageAsync(ws, message, stoppingToken);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Processes a single WebSocket message from the Gateway.
|
|
||||||
/// Routes based on the message type: event, response, or challenge.
|
|
||||||
/// </summary>
|
|
||||||
private async Task ProcessMessageAsync(
|
|
||||||
ClientWebSocket ws, string message, CancellationToken stoppingToken)
|
|
||||||
{
|
|
||||||
try
|
|
||||||
{
|
|
||||||
using var doc = JsonDocument.Parse(message);
|
|
||||||
var root = doc.RootElement;
|
|
||||||
|
|
||||||
var type = root.GetProperty("type").GetString();
|
|
||||||
|
|
||||||
switch (type)
|
|
||||||
{
|
|
||||||
case "event":
|
|
||||||
await HandleGatewayEventAsync(root);
|
|
||||||
break;
|
|
||||||
|
|
||||||
case "res":
|
|
||||||
HandleGatewayResponse(root);
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Special handling for connect.challenge events
|
|
||||||
if (root.TryGetProperty("event", out var eventName) &&
|
|
||||||
eventName.GetString() == "connect.challenge")
|
|
||||||
{
|
|
||||||
await HandleConnectChallengeAsync(ws, root, stoppingToken);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
catch (JsonException ex)
|
|
||||||
{
|
|
||||||
_logger.LogWarning(ex, "Failed to parse Gateway message: {Message}",
|
|
||||||
message.Length > 200 ? message[..200] + "..." : message);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Handles the Gateway connect.challenge event by sending
|
|
||||||
/// a connect request with authentication credentials.
|
|
||||||
/// </summary>
|
|
||||||
private async Task HandleConnectChallengeAsync(
|
|
||||||
ClientWebSocket ws, JsonElement root, CancellationToken stoppingToken)
|
|
||||||
{
|
|
||||||
_logger.LogInformation("Received connect.challenge from Gateway");
|
|
||||||
|
|
||||||
var connectRequest = new
|
|
||||||
{
|
|
||||||
type = "req",
|
|
||||||
id = $"bridge-{Guid.NewGuid():N}",
|
|
||||||
method = "connect",
|
|
||||||
@params = new
|
|
||||||
{
|
|
||||||
minProtocol = 3,
|
|
||||||
maxProtocol = 3,
|
|
||||||
client = new
|
|
||||||
{
|
|
||||||
id = "control-center-backend",
|
|
||||||
version = "1.0.0",
|
|
||||||
platform = "server",
|
|
||||||
mode = "operator"
|
|
||||||
},
|
|
||||||
role = "operator",
|
|
||||||
scopes = new[] { "operator.read", "operator.write" },
|
|
||||||
auth = new
|
|
||||||
{
|
|
||||||
token = _configuration["Gateway:AuthToken"] ?? string.Empty
|
|
||||||
},
|
|
||||||
locale = "en-US",
|
|
||||||
userAgent = "control-center-backend/1.0.0"
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
var json = JsonSerializer.Serialize(connectRequest);
|
|
||||||
var bytes = Encoding.UTF8.GetBytes(json);
|
|
||||||
await ws.SendAsync(bytes, WebSocketMessageType.Text, true, stoppingToken);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Handles a Gateway event message by dispatching to the
|
|
||||||
/// appropriate handler based on event name.
|
|
||||||
/// </summary>
|
|
||||||
private async Task HandleGatewayEventAsync(JsonElement root)
|
|
||||||
{
|
|
||||||
if (!root.TryGetProperty("event", out var eventProp)) return;
|
|
||||||
var eventName = eventProp.GetString();
|
|
||||||
|
|
||||||
_logger.LogDebug("Gateway event: {Event}", eventName);
|
|
||||||
|
|
||||||
switch (eventName)
|
|
||||||
{
|
|
||||||
case "sessions.changed":
|
|
||||||
await HandleSessionsChangedAsync(root);
|
|
||||||
break;
|
|
||||||
|
|
||||||
case "session.message":
|
|
||||||
HandleSessionMessage(root);
|
|
||||||
break;
|
|
||||||
|
|
||||||
case "session.tool":
|
|
||||||
HandleSessionTool(root);
|
|
||||||
break;
|
|
||||||
|
|
||||||
case "health":
|
|
||||||
HandleHealthEvent(root);
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Handles a sessions.changed event from the Gateway.
|
|
||||||
/// Updates the fleet state and pushes status changes through SignalR.
|
|
||||||
/// </summary>
|
|
||||||
private async Task HandleSessionsChangedAsync(JsonElement root)
|
|
||||||
{
|
|
||||||
if (!root.TryGetProperty("payload", out var payload)) return;
|
|
||||||
|
|
||||||
// The payload may contain a snapshot of all sessions
|
|
||||||
if (payload.TryGetProperty("snapshot", out var snapshot) &&
|
|
||||||
snapshot.ValueKind == JsonValueKind.Array)
|
|
||||||
{
|
|
||||||
foreach (var session in snapshot.EnumerateArray())
|
|
||||||
{
|
|
||||||
var cardData = SessionToCardData(session);
|
|
||||||
if (cardData is null) continue;
|
|
||||||
|
|
||||||
_fleetState[cardData.Id] = cardData;
|
|
||||||
|
|
||||||
var update = new AgentStatusUpdate(
|
|
||||||
AgentId: cardData.Id,
|
|
||||||
DisplayName: cardData.DisplayName,
|
|
||||||
Role: cardData.Role,
|
|
||||||
Status: cardData.Status,
|
|
||||||
CurrentTask: cardData.CurrentTask,
|
|
||||||
SessionKey: cardData.SessionKey,
|
|
||||||
Channel: cardData.Channel,
|
|
||||||
LastActivity: cardData.LastActivity,
|
|
||||||
ErrorMessage: cardData.ErrorMessage
|
|
||||||
);
|
|
||||||
|
|
||||||
await _hubContext.PushAgentStatusAsync(update);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Handle individual updates/added/removed
|
|
||||||
if (payload.TryGetProperty("updated", out var updated) &&
|
|
||||||
updated.ValueKind == JsonValueKind.Array)
|
|
||||||
{
|
|
||||||
foreach (var sessionKey in updated.EnumerateArray())
|
|
||||||
{
|
|
||||||
_logger.LogDebug("Session updated: {Key}", sessionKey.GetString());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Handles a session.message event. Updates the agent's last activity
|
|
||||||
/// and pushes a status update if the status changed.
|
|
||||||
/// </summary>
|
|
||||||
private void HandleSessionMessage(JsonElement root)
|
|
||||||
{
|
|
||||||
if (!root.TryGetProperty("payload", out var payload)) return;
|
|
||||||
if (!payload.TryGetProperty("sessionKey", out var sessionKeyProp)) return;
|
|
||||||
|
|
||||||
var sessionKey = sessionKeyProp.GetString() ?? string.Empty;
|
|
||||||
var agentId = ExtractAgentId(sessionKey);
|
|
||||||
|
|
||||||
if (string.IsNullOrEmpty(agentId)) return;
|
|
||||||
|
|
||||||
// Update last activity timestamp
|
|
||||||
if (_fleetState.TryGetValue(agentId, out var existing))
|
|
||||||
{
|
|
||||||
_fleetState[agentId] = existing with
|
|
||||||
{
|
|
||||||
LastActivity = DateTime.UtcNow.ToString("o"),
|
|
||||||
Status = "active"
|
|
||||||
};
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Handles a session.tool event. Extracts tool progress information
|
|
||||||
/// and pushes a <see cref="TaskProgressUpdate"/> through SignalR.
|
|
||||||
/// </summary>
|
|
||||||
private void HandleSessionTool(JsonElement root)
|
|
||||||
{
|
|
||||||
if (!root.TryGetProperty("payload", out var payload)) return;
|
|
||||||
if (!payload.TryGetProperty("sessionKey", out var sessionKeyProp)) return;
|
|
||||||
|
|
||||||
var sessionKey = sessionKeyProp.GetString() ?? string.Empty;
|
|
||||||
var agentId = ExtractAgentId(sessionKey);
|
|
||||||
|
|
||||||
if (string.IsNullOrEmpty(agentId)) return;
|
|
||||||
|
|
||||||
var toolName = payload.TryGetProperty("toolName", out var tn) ? tn.GetString() : null;
|
|
||||||
var toolStatus = payload.TryGetProperty("status", out var ts) ? ts.GetString() : null;
|
|
||||||
|
|
||||||
if (toolName is null || toolStatus is null) return;
|
|
||||||
|
|
||||||
var progress = toolStatus switch
|
|
||||||
{
|
|
||||||
"started" => 0,
|
|
||||||
"completed" => 100,
|
|
||||||
_ => (int?)null
|
|
||||||
};
|
|
||||||
|
|
||||||
var update = new TaskProgressUpdate(
|
|
||||||
AgentId: agentId,
|
|
||||||
TaskDescription: $"{toolName} ({toolStatus})",
|
|
||||||
Progress: progress,
|
|
||||||
Elapsed: null
|
|
||||||
);
|
|
||||||
|
|
||||||
// Fire and forget — don't block the event loop
|
|
||||||
_ = _hubContext.PushTaskProgressAsync(update);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Handles a health event from the Gateway.
|
|
||||||
/// Logs the health status for diagnostics.
|
|
||||||
/// </summary>
|
|
||||||
private void HandleHealthEvent(JsonElement root)
|
|
||||||
{
|
|
||||||
if (!root.TryGetProperty("payload", out var payload)) return;
|
|
||||||
|
|
||||||
var ok = payload.TryGetProperty("ok", out var okProp) && okProp.GetBoolean();
|
|
||||||
var status = payload.TryGetProperty("status", out var s) ? s.GetString() : "unknown";
|
|
||||||
|
|
||||||
_logger.LogInformation("Gateway health: ok={Ok}, status={Status}", ok, status);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Handles a Gateway response message. Currently only logs for diagnostics.
|
|
||||||
/// </summary>
|
|
||||||
private void HandleGatewayResponse(JsonElement root)
|
|
||||||
{
|
|
||||||
if (root.TryGetProperty("ok", out var okProp) && okProp.GetBoolean())
|
|
||||||
{
|
|
||||||
_logger.LogDebug("Gateway RPC response OK");
|
|
||||||
|
|
||||||
// Check for hello-ok after connect
|
|
||||||
if (root.TryGetProperty("payload", out var payload) &&
|
|
||||||
payload.TryGetProperty("type", out var typeProp) &&
|
|
||||||
typeProp.GetString() == "hello-ok")
|
|
||||||
{
|
|
||||||
_logger.LogInformation("Gateway handshake complete (hello-ok received)");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
else if (root.TryGetProperty("error", out var error))
|
|
||||||
{
|
|
||||||
var errorMsg = error.TryGetProperty("message", out var msg)
|
|
||||||
? msg.GetString() : "unknown error";
|
|
||||||
_logger.LogWarning("Gateway RPC error: {Error}", errorMsg);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Converts a raw Gateway session JSON element into an
|
|
||||||
/// <see cref="AgentCardData"/> record.
|
|
||||||
/// </summary>
|
|
||||||
private AgentCardData? SessionToCardData(JsonElement session)
|
|
||||||
{
|
|
||||||
// Extract agent ID from session key or agentId field
|
|
||||||
string? agentId = null;
|
|
||||||
if (session.TryGetProperty("agentId", out var aid))
|
|
||||||
agentId = aid.GetString();
|
|
||||||
else if (session.TryGetProperty("key", out var key))
|
|
||||||
agentId = ExtractAgentId(key.GetString() ?? string.Empty);
|
|
||||||
|
|
||||||
if (string.IsNullOrEmpty(agentId)) return null;
|
|
||||||
|
|
||||||
var sessionKey = session.TryGetProperty("key", out var sk)
|
|
||||||
? sk.GetString() ?? string.Empty : string.Empty;
|
|
||||||
|
|
||||||
var status = session.TryGetProperty("status", out var s)
|
|
||||||
? MapSessionStatus(s.GetString()) : "idle";
|
|
||||||
|
|
||||||
var channel = ExtractChannel(session);
|
|
||||||
|
|
||||||
var lastActivity = session.TryGetProperty("updatedAt", out var ua)
|
|
||||||
? DateTimeOffset.FromUnixTimeMilliseconds(ua.GetInt64()).ToString("o")
|
|
||||||
: DateTime.UtcNow.ToString("o");
|
|
||||||
|
|
||||||
var displayName = char.ToUpperInvariant(agentId![0]) + agentId[1..];
|
|
||||||
var role = AgentRoles.GetValueOrDefault(agentId!, "Agent");
|
|
||||||
|
|
||||||
return new AgentCardData(
|
|
||||||
Id: agentId!,
|
|
||||||
DisplayName: displayName,
|
|
||||||
Role: role,
|
|
||||||
Status: status,
|
|
||||||
CurrentTask: null,
|
|
||||||
TaskProgress: null,
|
|
||||||
TaskElapsed: null,
|
|
||||||
SessionKey: sessionKey,
|
|
||||||
Channel: channel,
|
|
||||||
LastActivity: lastActivity,
|
|
||||||
ErrorMessage: status == "error" ? "Agent encountered an error" : null
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Extracts the agent ID from a session key.
|
|
||||||
/// Session key format: "agent:{agentId}:{channel}:..."
|
|
||||||
/// </summary>
|
|
||||||
private static string? ExtractAgentId(string sessionKey)
|
|
||||||
{
|
|
||||||
if (string.IsNullOrEmpty(sessionKey)) return null;
|
|
||||||
|
|
||||||
var parts = sessionKey.Split(':');
|
|
||||||
if (parts.Length >= 2 && parts[0] == "agent")
|
|
||||||
return parts[1];
|
|
||||||
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Extracts the channel from a session element.
|
|
||||||
/// </summary>
|
|
||||||
private static string ExtractChannel(JsonElement session)
|
|
||||||
{
|
|
||||||
// Try direct "channel" property
|
|
||||||
if (session.TryGetProperty("channel", out var ch))
|
|
||||||
return ch.GetString() ?? "unknown";
|
|
||||||
|
|
||||||
// Try origin.provider
|
|
||||||
if (session.TryGetProperty("origin", out var origin) &&
|
|
||||||
origin.TryGetProperty("provider", out var provider))
|
|
||||||
return provider.GetString() ?? "unknown";
|
|
||||||
|
|
||||||
return "unknown";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,19 +0,0 @@
|
|||||||
{
|
|
||||||
"Logging": {
|
|
||||||
"LogLevel": {
|
|
||||||
"Default": "Debug",
|
|
||||||
"Microsoft.AspNetCore": "Information",
|
|
||||||
"ControlCenter": "Debug"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"Gateway": {
|
|
||||||
"WebSocketUrl": "ws://localhost:3271/ws",
|
|
||||||
"AuthToken": ""
|
|
||||||
},
|
|
||||||
"Cors": {
|
|
||||||
"AllowedOrigins": [
|
|
||||||
"http://localhost:4200",
|
|
||||||
"http://localhost:5000"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,22 +0,0 @@
|
|||||||
{
|
|
||||||
"Logging": {
|
|
||||||
"LogLevel": {
|
|
||||||
"Default": "Information",
|
|
||||||
"Microsoft.AspNetCore": "Warning",
|
|
||||||
"ControlCenter": "Debug"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"AllowedHosts": "*",
|
|
||||||
|
|
||||||
"Gateway": {
|
|
||||||
"WebSocketUrl": "ws://localhost:3271/ws",
|
|
||||||
"AuthToken": ""
|
|
||||||
},
|
|
||||||
|
|
||||||
"Cors": {
|
|
||||||
"AllowedOrigins": [
|
|
||||||
"http://localhost:4200",
|
|
||||||
"http://localhost:5000"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,29 +0,0 @@
|
|||||||
using ControlCenter.Api.Configurations;
|
|
||||||
using ControlCenter.Api.Entities;
|
|
||||||
using Microsoft.EntityFrameworkCore;
|
|
||||||
|
|
||||||
namespace ControlCenter.Api.Data;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// EF Core DbContext for the Control Center database.
|
|
||||||
/// All table and column names use snake_case via explicit HasColumnName configuration.
|
|
||||||
/// </summary>
|
|
||||||
public class AppDbContext : DbContext
|
|
||||||
{
|
|
||||||
public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }
|
|
||||||
|
|
||||||
public DbSet<Agent> Agents => Set<Agent>();
|
|
||||||
|
|
||||||
protected override void OnModelCreating(ModelBuilder modelBuilder)
|
|
||||||
{
|
|
||||||
// Apply all entity type configurations from the Configurations namespace
|
|
||||||
modelBuilder.ApplyConfigurationsFromAssembly(typeof(AgentConfiguration).Assembly);
|
|
||||||
|
|
||||||
// Map the AgentStatus enum to a PostgreSQL enum type named "agent_status"
|
|
||||||
// This must be called after ApplyConfigurations to ensure the model is built
|
|
||||||
// before the enum mapping is applied.
|
|
||||||
modelBuilder.HasPostgresEnum<AgentStatus>();
|
|
||||||
|
|
||||||
base.OnModelCreating(modelBuilder);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,27 +0,0 @@
|
|||||||
using Microsoft.EntityFrameworkCore;
|
|
||||||
using ControlCenter.Api.Entities;
|
|
||||||
|
|
||||||
namespace ControlCenter.Api.Data;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Design-time factory for AppDbContext, used by EF Core tools (dotnet ef)
|
|
||||||
/// to create migrations without requiring a running application.
|
|
||||||
/// </summary>
|
|
||||||
public class AppDbContextFactory : Microsoft.EntityFrameworkCore.Design.IDesignTimeDbContextFactory<AppDbContext>
|
|
||||||
{
|
|
||||||
public AppDbContext CreateDbContext(string[] args)
|
|
||||||
{
|
|
||||||
var optionsBuilder = new DbContextOptionsBuilder<AppDbContext>();
|
|
||||||
|
|
||||||
// Connection string for design-time operations (migrations).
|
|
||||||
// In production, this comes from appsettings / environment variables.
|
|
||||||
var connectionString = "Host=localhost;Database=control_center;Username=postgres;Password=postgres";
|
|
||||||
|
|
||||||
optionsBuilder.UseNpgsql(connectionString, npgsqlOptions =>
|
|
||||||
{
|
|
||||||
npgsqlOptions.MigrationsAssembly(typeof(AppDbContext).Assembly.FullName);
|
|
||||||
});
|
|
||||||
|
|
||||||
return new AppDbContext(optionsBuilder.Options);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,75 +0,0 @@
|
|||||||
namespace ControlCenter.Api.Dtos;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Data transfer object for broadcasting agent status updates
|
|
||||||
/// to all connected SignalR clients.
|
|
||||||
/// </summary>
|
|
||||||
public class AgentStatusUpdateDto
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Agent identifier, e.g. "otto", "dex", "rex".
|
|
||||||
/// Not null — every update must identify the agent it refers to.
|
|
||||||
/// </summary>
|
|
||||||
public string AgentId { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Human-readable display name, e.g. "Otto", "Dex".
|
|
||||||
/// Not null — used by clients to render agent cards.
|
|
||||||
/// </summary>
|
|
||||||
public string DisplayName { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Role description, e.g. "Orchestrator Agent", "Backend Specialist".
|
|
||||||
/// Not null — provides context for the agent's function.
|
|
||||||
/// </summary>
|
|
||||||
public string Role { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Current operational status of the agent.
|
|
||||||
/// Maps to <see cref="Entities.AgentStatus"/> values as lowercase strings:
|
|
||||||
/// "active", "idle", "thinking", "error".
|
|
||||||
/// </summary>
|
|
||||||
public string Status { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Description of the agent's current task, if any.
|
|
||||||
/// Null when the agent is idle with no active task.
|
|
||||||
/// </summary>
|
|
||||||
public string? CurrentTask { get; set; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Task progress percentage (0–100).
|
|
||||||
/// Null when progress is not trackable for the current task.
|
|
||||||
/// </summary>
|
|
||||||
public int? TaskProgress { get; set; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Elapsed time string for the current task, e.g. "04m 12s".
|
|
||||||
/// Null when no task is active.
|
|
||||||
/// </summary>
|
|
||||||
public string? TaskElapsed { get; set; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Full session key, e.g. "agent:otto:telegram:direct:8787451565".
|
|
||||||
/// Not null — uniquely identifies the agent session.
|
|
||||||
/// </summary>
|
|
||||||
public string SessionKey { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Communication channel the agent is operating on, e.g. "telegram", "discord", "slack".
|
|
||||||
/// Not null — every agent session operates on exactly one channel.
|
|
||||||
/// </summary>
|
|
||||||
public string Channel { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// ISO 8601 timestamp of the agent's last activity.
|
|
||||||
/// Not null — used by clients to detect stale connections.
|
|
||||||
/// </summary>
|
|
||||||
public string LastActivity { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Error message when the agent status is "error".
|
|
||||||
/// Null when the agent is not in an error state.
|
|
||||||
/// </summary>
|
|
||||||
public string? ErrorMessage { get; set; }
|
|
||||||
}
|
|
||||||
@@ -1,59 +0,0 @@
|
|||||||
namespace ControlCenter.Api.Entities;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Represents an agent's current state in the Control Center.
|
|
||||||
/// Each row tracks one agent session's status, task, and activity.
|
|
||||||
/// </summary>
|
|
||||||
public class Agent
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Primary key — UUID generated on insert.
|
|
||||||
/// </summary>
|
|
||||||
public Guid Id { get; set; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Current operational status of the agent.
|
|
||||||
/// Stored as an enum in PostgreSQL via Npgsql.
|
|
||||||
/// </summary>
|
|
||||||
public AgentStatus Status { get; set; } = AgentStatus.Idle;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Description of the agent's current task, if any.
|
|
||||||
/// Nullable — not all agents have an active task.
|
|
||||||
/// </summary>
|
|
||||||
public string? Task { get; set; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Task progress percentage (0–100).
|
|
||||||
/// Nullable — progress is only meaningful when an agent has a trackable task.
|
|
||||||
/// </summary>
|
|
||||||
public int? Progress { get; set; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Full session key, e.g. "agent:otto:telegram:direct:8787451565".
|
|
||||||
/// Not null — every agent row must be associated with a session.
|
|
||||||
/// </summary>
|
|
||||||
public string SessionKey { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Communication channel the agent is operating on, e.g. "telegram", "discord", "slack".
|
|
||||||
/// Not null — every agent session operates on exactly one channel.
|
|
||||||
/// </summary>
|
|
||||||
public string Channel { get; set; } = string.Empty;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Timestamp of the agent's last activity.
|
|
||||||
/// Default: current UTC timestamp on insert.
|
|
||||||
/// </summary>
|
|
||||||
public DateTime LastActivity { get; set; } = DateTime.UtcNow;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Row creation timestamp. Set automatically on insert.
|
|
||||||
/// </summary>
|
|
||||||
public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Row last-update timestamp. Updated automatically on any modification.
|
|
||||||
/// </summary>
|
|
||||||
public DateTime UpdatedAt { get; set; } = DateTime.UtcNow;
|
|
||||||
}
|
|
||||||
@@ -1,13 +0,0 @@
|
|||||||
namespace ControlCenter.Api.Entities;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Agent operational status enum.
|
|
||||||
/// Maps to the agent_status enum type in PostgreSQL.
|
|
||||||
/// </summary>
|
|
||||||
public enum AgentStatus
|
|
||||||
{
|
|
||||||
Active = 0,
|
|
||||||
Idle = 1,
|
|
||||||
Thinking = 2,
|
|
||||||
Error = 3
|
|
||||||
}
|
|
||||||
@@ -1,4 +1,3 @@
|
|||||||
using ControlCenter.Api.Dtos;
|
|
||||||
using Microsoft.AspNetCore.SignalR;
|
using Microsoft.AspNetCore.SignalR;
|
||||||
|
|
||||||
namespace ControlCenter.Api.Hubs;
|
namespace ControlCenter.Api.Hubs;
|
||||||
@@ -7,23 +6,18 @@ namespace ControlCenter.Api.Hubs;
|
|||||||
/// SignalR hub for broadcasting agent status updates to connected clients.
|
/// SignalR hub for broadcasting agent status updates to connected clients.
|
||||||
///
|
///
|
||||||
/// <para>
|
/// <para>
|
||||||
/// Clients call <see cref="SendStatusUpdate"/> to broadcast a status change,
|
/// Clients connect to this hub at the <c>/hub</c> endpoint to receive
|
||||||
/// and the hub relays it to all connected clients via the
|
/// real-time agent state changes. A background service subscribes to
|
||||||
/// <see cref="IAgentStatusClient.AgentStatusChanged"/> callback.
|
/// OpenClaw Gateway events and pushes them through this hub.
|
||||||
/// </para>
|
|
||||||
///
|
|
||||||
/// <para>
|
|
||||||
/// Server-side code should use <see cref="AgentStatusHubExtensions.PushStatusUpdateAsync"/>
|
|
||||||
/// via <c>IHubContext<AgentStatusHub, IAgentStatusClient></c> for background-service broadcasts.
|
|
||||||
/// </para>
|
/// </para>
|
||||||
///
|
///
|
||||||
/// <para>
|
/// <para>
|
||||||
/// Architecture note: This hub bridges OpenClaw Gateway events to SignalR clients.
|
/// Architecture note: This hub bridges OpenClaw Gateway events to SignalR clients.
|
||||||
/// A background service subscribes to Gateway events and pushes them through
|
/// The full typed client interface and extension methods will be added in a
|
||||||
/// this hub's extension methods.
|
/// subsequent task (CUB-55).
|
||||||
/// </para>
|
/// </para>
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public class AgentStatusHub : Hub<IAgentStatusClient>
|
public class AgentStatusHub : Hub
|
||||||
{
|
{
|
||||||
private readonly ILogger<AgentStatusHub> _logger;
|
private readonly ILogger<AgentStatusHub> _logger;
|
||||||
|
|
||||||
@@ -37,119 +31,22 @@ public class AgentStatusHub : Hub<IAgentStatusClient>
|
|||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Broadcasts an agent status update to all connected clients.
|
/// Overrides <see cref="Hub.OnConnectedAsync"/> to log new connections.
|
||||||
///
|
|
||||||
/// <para>
|
|
||||||
/// Any connected client (or server-side caller) can invoke this method
|
|
||||||
/// to push a status update to every subscriber. The update is relayed
|
|
||||||
/// through the <see cref="IAgentStatusClient.AgentStatusChanged"/> callback.
|
|
||||||
/// </para>
|
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="update">The agent status update payload to broadcast.</param>
|
public override Task OnConnectedAsync()
|
||||||
public async Task SendStatusUpdate(AgentStatusUpdateDto update)
|
|
||||||
{
|
{
|
||||||
_logger.LogInformation(
|
_logger.LogDebug("Client connected: {ConnectionId}", Context.ConnectionId);
|
||||||
"Broadcasting status update for agent {AgentId}: {Status}",
|
return base.OnConnectedAsync();
|
||||||
update.AgentId, update.Status);
|
|
||||||
|
|
||||||
await Clients.All.AgentStatusChanged(update);
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Adds the calling connection to the fleet group.
|
/// Overrides <see cref="Hub.OnDisconnectedAsync"/> to log disconnections.
|
||||||
/// Once joined, the client will receive all agent status updates.
|
|
||||||
/// </summary>
|
|
||||||
public async Task JoinFleet()
|
|
||||||
{
|
|
||||||
await Groups.AddToGroupAsync(Context.ConnectionId, FleetGroupName);
|
|
||||||
_logger.LogDebug("Connection {ConnectionId} joined fleet group", Context.ConnectionId);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Removes the calling connection from the fleet group.
|
|
||||||
/// </summary>
|
|
||||||
public async Task LeaveFleet()
|
|
||||||
{
|
|
||||||
await Groups.RemoveFromGroupAsync(Context.ConnectionId, FleetGroupName);
|
|
||||||
_logger.LogDebug("Connection {ConnectionId} left fleet group", Context.ConnectionId);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Overrides <see cref="Hub{T}.OnDisconnectedAsync"/> to log disconnections.
|
|
||||||
/// SignalR automatically removes disconnected connections from all groups.
|
/// SignalR automatically removes disconnected connections from all groups.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="exception">Exception that caused the disconnection, if any.</param>
|
/// <param name="exception">Exception that caused the disconnection, if any.</param>
|
||||||
public override Task OnDisconnectedAsync(Exception? exception)
|
public override Task OnDisconnectedAsync(Exception? exception)
|
||||||
{
|
{
|
||||||
_logger.LogDebug("Connection {ConnectionId} disconnected", Context.ConnectionId);
|
_logger.LogDebug("Client disconnected: {ConnectionId}", Context.ConnectionId);
|
||||||
return base.OnDisconnectedAsync(exception);
|
return base.OnDisconnectedAsync(exception);
|
||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// The SignalR group name for the entire fleet (all agents).
|
|
||||||
/// </summary>
|
|
||||||
internal const string FleetGroupName = "fleet";
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Strongly-typed client interface for the AgentStatus SignalR hub.
|
|
||||||
/// Defines the methods the server can invoke on connected clients
|
|
||||||
/// to push real-time agent status updates.
|
|
||||||
/// </summary>
|
|
||||||
public interface IAgentStatusClient
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Pushes an agent status change to all subscribed clients.
|
|
||||||
/// Fired whenever an agent's operational status changes
|
|
||||||
/// (e.g., idle → active, active → thinking, active → error).
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="update">The full status update payload.</param>
|
|
||||||
/// <returns>A Task that completes when the client has processed the update.</returns>
|
|
||||||
Task AgentStatusChanged(AgentStatusUpdateDto update);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Extension methods for pushing real-time agent updates through
|
|
||||||
/// the <see cref="IHubContext{T}"/> of <see cref="AgentStatusHub"/>.
|
|
||||||
///
|
|
||||||
/// <para>
|
|
||||||
/// These methods are intended to be called from background services
|
|
||||||
/// or other server-side code that detects an agent state change,
|
|
||||||
/// using the injected <c>IHubContext<AgentStatusHub, IAgentStatusClient></c>.
|
|
||||||
/// </para>
|
|
||||||
/// </summary>
|
|
||||||
public static class AgentStatusHubExtensions
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Pushes an agent status update to all connected clients.
|
|
||||||
///
|
|
||||||
/// <para>
|
|
||||||
/// Call this from any background service when an agent's
|
|
||||||
/// operational status changes (e.g., the Gateway reports a
|
|
||||||
/// session transition from "running" to "done").
|
|
||||||
/// </para>
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="hubContext">The hub context injected via DI.</param>
|
|
||||||
/// <param name="update">The agent status update payload.</param>
|
|
||||||
/// <returns>A Task that completes when the message has been sent to all clients.</returns>
|
|
||||||
public static async Task PushStatusUpdateAsync(
|
|
||||||
this IHubContext<AgentStatusHub, IAgentStatusClient> hubContext,
|
|
||||||
AgentStatusUpdateDto update)
|
|
||||||
{
|
|
||||||
await hubContext.Clients.All.AgentStatusChanged(update);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Pushes an agent status update to clients subscribed to the fleet group.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="hubContext">The hub context injected via DI.</param>
|
|
||||||
/// <param name="update">The agent status update payload.</param>
|
|
||||||
/// <returns>A Task that completes when the message has been sent to the fleet group.</returns>
|
|
||||||
public static async Task PushStatusUpdateToFleetAsync(
|
|
||||||
this IHubContext<AgentStatusHub, IAgentStatusClient> hubContext,
|
|
||||||
AgentStatusUpdateDto update)
|
|
||||||
{
|
|
||||||
await hubContext.Clients.Group(AgentStatusHub.FleetGroupName)
|
|
||||||
.AgentStatusChanged(update);
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
@@ -1,94 +0,0 @@
|
|||||||
// <auto-generated />
|
|
||||||
using System;
|
|
||||||
using ControlCenter.Api.Data;
|
|
||||||
using Microsoft.EntityFrameworkCore;
|
|
||||||
using Microsoft.EntityFrameworkCore.Infrastructure;
|
|
||||||
using Microsoft.EntityFrameworkCore.Migrations;
|
|
||||||
using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
|
|
||||||
using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
|
|
||||||
|
|
||||||
#nullable disable
|
|
||||||
|
|
||||||
namespace ControlCenter.Api.Migrations
|
|
||||||
{
|
|
||||||
[DbContext(typeof(AppDbContext))]
|
|
||||||
[Migration("20260426101703_CreateAgentsTable")]
|
|
||||||
partial class CreateAgentsTable
|
|
||||||
{
|
|
||||||
/// <inheritdoc />
|
|
||||||
protected override void BuildTargetModel(ModelBuilder modelBuilder)
|
|
||||||
{
|
|
||||||
#pragma warning disable 612, 618
|
|
||||||
modelBuilder
|
|
||||||
.HasAnnotation("ProductVersion", "9.0.4")
|
|
||||||
.HasAnnotation("Relational:MaxIdentifierLength", 63);
|
|
||||||
|
|
||||||
NpgsqlModelBuilderExtensions.HasPostgresEnum(modelBuilder, "agent_status", new[] { "active", "idle", "thinking", "error" });
|
|
||||||
NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
|
|
||||||
|
|
||||||
modelBuilder.Entity("ControlCenter.Api.Entities.Agent", b =>
|
|
||||||
{
|
|
||||||
b.Property<Guid>("Id")
|
|
||||||
.ValueGeneratedOnAdd()
|
|
||||||
.HasColumnType("uuid")
|
|
||||||
.HasColumnName("id");
|
|
||||||
|
|
||||||
b.Property<string>("Channel")
|
|
||||||
.IsRequired()
|
|
||||||
.HasColumnType("text")
|
|
||||||
.HasColumnName("channel");
|
|
||||||
|
|
||||||
b.Property<DateTime>("CreatedAt")
|
|
||||||
.ValueGeneratedOnAdd()
|
|
||||||
.HasColumnType("timestamptz")
|
|
||||||
.HasColumnName("created_at")
|
|
||||||
.HasDefaultValueSql("now()");
|
|
||||||
|
|
||||||
b.Property<DateTime>("LastActivity")
|
|
||||||
.HasColumnType("timestamptz")
|
|
||||||
.HasColumnName("last_activity");
|
|
||||||
|
|
||||||
b.Property<int?>("Progress")
|
|
||||||
.HasColumnType("integer")
|
|
||||||
.HasColumnName("progress");
|
|
||||||
|
|
||||||
b.Property<string>("SessionKey")
|
|
||||||
.IsRequired()
|
|
||||||
.HasColumnType("text")
|
|
||||||
.HasColumnName("session_key");
|
|
||||||
|
|
||||||
b.Property<int>("Status")
|
|
||||||
.HasColumnType("agent_status")
|
|
||||||
.HasColumnName("status");
|
|
||||||
|
|
||||||
b.Property<string>("Task")
|
|
||||||
.HasColumnType("text")
|
|
||||||
.HasColumnName("task");
|
|
||||||
|
|
||||||
b.Property<DateTime>("UpdatedAt")
|
|
||||||
.ValueGeneratedOnAdd()
|
|
||||||
.HasColumnType("timestamptz")
|
|
||||||
.HasColumnName("updated_at")
|
|
||||||
.HasDefaultValueSql("now()");
|
|
||||||
|
|
||||||
b.HasKey("Id");
|
|
||||||
|
|
||||||
b.HasIndex("Channel")
|
|
||||||
.HasDatabaseName("ix_agents_channel");
|
|
||||||
|
|
||||||
b.HasIndex("SessionKey")
|
|
||||||
.IsUnique()
|
|
||||||
.HasDatabaseName("ix_agents_session_key");
|
|
||||||
|
|
||||||
b.HasIndex("Status")
|
|
||||||
.HasDatabaseName("ix_agents_status");
|
|
||||||
|
|
||||||
b.ToTable("agents", null, t =>
|
|
||||||
{
|
|
||||||
t.HasCheckConstraint("ck_agents_progress_range", "progress IS NULL OR (progress >= 0 AND progress <= 100)");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
#pragma warning restore 612, 618
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,61 +0,0 @@
|
|||||||
using System;
|
|
||||||
using Microsoft.EntityFrameworkCore.Migrations;
|
|
||||||
|
|
||||||
#nullable disable
|
|
||||||
|
|
||||||
namespace ControlCenter.Api.Migrations
|
|
||||||
{
|
|
||||||
/// <inheritdoc />
|
|
||||||
public partial class CreateAgentsTable : Migration
|
|
||||||
{
|
|
||||||
/// <inheritdoc />
|
|
||||||
protected override void Up(MigrationBuilder migrationBuilder)
|
|
||||||
{
|
|
||||||
migrationBuilder.AlterDatabase()
|
|
||||||
.Annotation("Npgsql:Enum:agent_status", "active,idle,thinking,error");
|
|
||||||
|
|
||||||
migrationBuilder.CreateTable(
|
|
||||||
name: "agents",
|
|
||||||
columns: table => new
|
|
||||||
{
|
|
||||||
id = table.Column<Guid>(type: "uuid", nullable: false),
|
|
||||||
status = table.Column<int>(type: "agent_status", nullable: false),
|
|
||||||
task = table.Column<string>(type: "text", nullable: true),
|
|
||||||
progress = table.Column<int>(type: "integer", nullable: true),
|
|
||||||
session_key = table.Column<string>(type: "text", nullable: false),
|
|
||||||
channel = table.Column<string>(type: "text", nullable: false),
|
|
||||||
last_activity = table.Column<DateTime>(type: "timestamptz", nullable: false),
|
|
||||||
created_at = table.Column<DateTime>(type: "timestamptz", nullable: false, defaultValueSql: "now()"),
|
|
||||||
updated_at = table.Column<DateTime>(type: "timestamptz", nullable: false, defaultValueSql: "now()")
|
|
||||||
},
|
|
||||||
constraints: table =>
|
|
||||||
{
|
|
||||||
table.PrimaryKey("PK_agents", x => x.id);
|
|
||||||
table.CheckConstraint("ck_agents_progress_range", "progress IS NULL OR (progress >= 0 AND progress <= 100)");
|
|
||||||
});
|
|
||||||
|
|
||||||
migrationBuilder.CreateIndex(
|
|
||||||
name: "ix_agents_channel",
|
|
||||||
table: "agents",
|
|
||||||
column: "channel");
|
|
||||||
|
|
||||||
migrationBuilder.CreateIndex(
|
|
||||||
name: "ix_agents_session_key",
|
|
||||||
table: "agents",
|
|
||||||
column: "session_key",
|
|
||||||
unique: true);
|
|
||||||
|
|
||||||
migrationBuilder.CreateIndex(
|
|
||||||
name: "ix_agents_status",
|
|
||||||
table: "agents",
|
|
||||||
column: "status");
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <inheritdoc />
|
|
||||||
protected override void Down(MigrationBuilder migrationBuilder)
|
|
||||||
{
|
|
||||||
migrationBuilder.DropTable(
|
|
||||||
name: "agents");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,91 +0,0 @@
|
|||||||
// <auto-generated />
|
|
||||||
using System;
|
|
||||||
using ControlCenter.Api.Data;
|
|
||||||
using Microsoft.EntityFrameworkCore;
|
|
||||||
using Microsoft.EntityFrameworkCore.Infrastructure;
|
|
||||||
using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
|
|
||||||
using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
|
|
||||||
|
|
||||||
#nullable disable
|
|
||||||
|
|
||||||
namespace ControlCenter.Api.Migrations
|
|
||||||
{
|
|
||||||
[DbContext(typeof(AppDbContext))]
|
|
||||||
partial class AppDbContextModelSnapshot : ModelSnapshot
|
|
||||||
{
|
|
||||||
protected override void BuildModel(ModelBuilder modelBuilder)
|
|
||||||
{
|
|
||||||
#pragma warning disable 612, 618
|
|
||||||
modelBuilder
|
|
||||||
.HasAnnotation("ProductVersion", "9.0.4")
|
|
||||||
.HasAnnotation("Relational:MaxIdentifierLength", 63);
|
|
||||||
|
|
||||||
NpgsqlModelBuilderExtensions.HasPostgresEnum(modelBuilder, "agent_status", new[] { "active", "idle", "thinking", "error" });
|
|
||||||
NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
|
|
||||||
|
|
||||||
modelBuilder.Entity("ControlCenter.Api.Entities.Agent", b =>
|
|
||||||
{
|
|
||||||
b.Property<Guid>("Id")
|
|
||||||
.ValueGeneratedOnAdd()
|
|
||||||
.HasColumnType("uuid")
|
|
||||||
.HasColumnName("id");
|
|
||||||
|
|
||||||
b.Property<string>("Channel")
|
|
||||||
.IsRequired()
|
|
||||||
.HasColumnType("text")
|
|
||||||
.HasColumnName("channel");
|
|
||||||
|
|
||||||
b.Property<DateTime>("CreatedAt")
|
|
||||||
.ValueGeneratedOnAdd()
|
|
||||||
.HasColumnType("timestamptz")
|
|
||||||
.HasColumnName("created_at")
|
|
||||||
.HasDefaultValueSql("now()");
|
|
||||||
|
|
||||||
b.Property<DateTime>("LastActivity")
|
|
||||||
.HasColumnType("timestamptz")
|
|
||||||
.HasColumnName("last_activity");
|
|
||||||
|
|
||||||
b.Property<int?>("Progress")
|
|
||||||
.HasColumnType("integer")
|
|
||||||
.HasColumnName("progress");
|
|
||||||
|
|
||||||
b.Property<string>("SessionKey")
|
|
||||||
.IsRequired()
|
|
||||||
.HasColumnType("text")
|
|
||||||
.HasColumnName("session_key");
|
|
||||||
|
|
||||||
b.Property<int>("Status")
|
|
||||||
.HasColumnType("agent_status")
|
|
||||||
.HasColumnName("status");
|
|
||||||
|
|
||||||
b.Property<string>("Task")
|
|
||||||
.HasColumnType("text")
|
|
||||||
.HasColumnName("task");
|
|
||||||
|
|
||||||
b.Property<DateTime>("UpdatedAt")
|
|
||||||
.ValueGeneratedOnAdd()
|
|
||||||
.HasColumnType("timestamptz")
|
|
||||||
.HasColumnName("updated_at")
|
|
||||||
.HasDefaultValueSql("now()");
|
|
||||||
|
|
||||||
b.HasKey("Id");
|
|
||||||
|
|
||||||
b.HasIndex("Channel")
|
|
||||||
.HasDatabaseName("ix_agents_channel");
|
|
||||||
|
|
||||||
b.HasIndex("SessionKey")
|
|
||||||
.IsUnique()
|
|
||||||
.HasDatabaseName("ix_agents_session_key");
|
|
||||||
|
|
||||||
b.HasIndex("Status")
|
|
||||||
.HasDatabaseName("ix_agents_status");
|
|
||||||
|
|
||||||
b.ToTable("agents", null, t =>
|
|
||||||
{
|
|
||||||
t.HasCheckConstraint("ck_agents_progress_range", "progress IS NULL OR (progress >= 0 AND progress <= 100)");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
#pragma warning restore 612, 618
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,19 +0,0 @@
|
|||||||
namespace ControlCenter.Api.Models;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Read-only model representing an agent's current state.
|
|
||||||
/// Used as the return type from the Agent State Repository
|
|
||||||
/// to decouple consumers from the persistence layer.
|
|
||||||
/// </summary>
|
|
||||||
public class AgentState
|
|
||||||
{
|
|
||||||
public Guid Id { get; set; }
|
|
||||||
public string Status { get; set; } = string.Empty;
|
|
||||||
public string? Task { get; set; }
|
|
||||||
public int? Progress { get; set; }
|
|
||||||
public string SessionKey { get; set; } = string.Empty;
|
|
||||||
public string Channel { get; set; } = string.Empty;
|
|
||||||
public DateTime LastActivity { get; set; }
|
|
||||||
public DateTime CreatedAt { get; set; }
|
|
||||||
public DateTime UpdatedAt { get; set; }
|
|
||||||
}
|
|
||||||
@@ -1,7 +1,4 @@
|
|||||||
using ControlCenter.Api.Data;
|
|
||||||
using ControlCenter.Api.Hubs;
|
using ControlCenter.Api.Hubs;
|
||||||
using ControlCenter.Api.Repositories;
|
|
||||||
using Microsoft.EntityFrameworkCore;
|
|
||||||
|
|
||||||
var builder = WebApplication.CreateBuilder(args);
|
var builder = WebApplication.CreateBuilder(args);
|
||||||
|
|
||||||
@@ -11,21 +8,6 @@ builder.Services.AddOpenApi();
|
|||||||
// Register SignalR for real-time agent status updates
|
// Register SignalR for real-time agent status updates
|
||||||
builder.Services.AddSignalR();
|
builder.Services.AddSignalR();
|
||||||
|
|
||||||
// Register Agent State Repository
|
|
||||||
builder.Services.AddScoped<IAgentStateRepository, AgentStateRepository>();
|
|
||||||
|
|
||||||
// Register DbContext with PostgreSQL
|
|
||||||
builder.Services.AddDbContext<AppDbContext>(options =>
|
|
||||||
{
|
|
||||||
var connectionString = builder.Configuration.GetConnectionString("DefaultConnection")
|
|
||||||
?? "Host=localhost;Database=control_center;Username=postgres;Password=postgres";
|
|
||||||
|
|
||||||
options.UseNpgsql(connectionString, npgsqlOptions =>
|
|
||||||
{
|
|
||||||
npgsqlOptions.MigrationsAssembly(typeof(AppDbContext).Assembly.FullName);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
var app = builder.Build();
|
var app = builder.Build();
|
||||||
|
|
||||||
// Configure the HTTP request pipeline.
|
// Configure the HTTP request pipeline.
|
||||||
@@ -36,7 +18,7 @@ if (app.Environment.IsDevelopment())
|
|||||||
|
|
||||||
app.UseHttpsRedirection();
|
app.UseHttpsRedirection();
|
||||||
|
|
||||||
// Map SignalR hubs
|
// Map SignalR hub endpoint
|
||||||
app.MapHub<AgentStatusHub>("/hubs/agent-status");
|
app.MapHub<AgentStatusHub>("/hub");
|
||||||
|
|
||||||
app.Run();
|
app.Run();
|
||||||
@@ -1,4 +1,4 @@
|
|||||||
{
|
{
|
||||||
"$schema": "https://json.schemastore.org/launchsettings.json",
|
"$schema": "https://json.schemastore.org/launchsettings.json",
|
||||||
"profiles": {
|
"profiles": {
|
||||||
"http": {
|
"http": {
|
||||||
|
|||||||
@@ -1,76 +0,0 @@
|
|||||||
using ControlCenter.Api.Data;
|
|
||||||
using ControlCenter.Api.Entities;
|
|
||||||
using ControlCenter.Api.Models;
|
|
||||||
using Microsoft.EntityFrameworkCore;
|
|
||||||
|
|
||||||
namespace ControlCenter.Api.Repositories;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// EF Core implementation of the Agent State Repository.
|
|
||||||
/// Maps between the persisted <see cref="Agent"/> entity and the
|
|
||||||
/// read-oriented <see cref="AgentState"/> model.
|
|
||||||
/// </summary>
|
|
||||||
public class AgentStateRepository : IAgentStateRepository
|
|
||||||
{
|
|
||||||
private readonly AppDbContext _db;
|
|
||||||
|
|
||||||
public AgentStateRepository(AppDbContext db)
|
|
||||||
{
|
|
||||||
_db = db;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <inheritdoc />
|
|
||||||
public async Task<IReadOnlyList<AgentState>> GetAllAsync(CancellationToken ct = default)
|
|
||||||
{
|
|
||||||
var agents = await _db.Agents
|
|
||||||
.AsNoTracking()
|
|
||||||
.OrderByDescending(a => a.LastActivity)
|
|
||||||
.ToListAsync(ct);
|
|
||||||
|
|
||||||
return agents.Select(ToModel).ToList();
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <inheritdoc />
|
|
||||||
public async Task<AgentState?> GetBySessionKeyAsync(string sessionKey, CancellationToken ct = default)
|
|
||||||
{
|
|
||||||
var agent = await _db.Agents
|
|
||||||
.AsNoTracking()
|
|
||||||
.FirstOrDefaultAsync(a => a.SessionKey == sessionKey, ct);
|
|
||||||
|
|
||||||
return agent is null ? null : ToModel(agent);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <inheritdoc />
|
|
||||||
public async Task<bool> UpdateStatusAsync(Guid id, string status, CancellationToken ct = default)
|
|
||||||
{
|
|
||||||
if (!Enum.TryParse<AgentStatus>(status, ignoreCase: true, out var parsedStatus))
|
|
||||||
return false;
|
|
||||||
|
|
||||||
var agent = await _db.Agents.FindAsync([id], ct);
|
|
||||||
if (agent is null)
|
|
||||||
return false;
|
|
||||||
|
|
||||||
agent.Status = parsedStatus;
|
|
||||||
agent.UpdatedAt = DateTime.UtcNow;
|
|
||||||
agent.LastActivity = DateTime.UtcNow;
|
|
||||||
|
|
||||||
await _db.SaveChangesAsync(ct);
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Maps a persisted <see cref="Agent"/> entity to a <see cref="AgentState"/> model.
|
|
||||||
/// </summary>
|
|
||||||
private static AgentState ToModel(Agent agent) => new()
|
|
||||||
{
|
|
||||||
Id = agent.Id,
|
|
||||||
Status = agent.Status.ToString(),
|
|
||||||
Task = agent.Task,
|
|
||||||
Progress = agent.Progress,
|
|
||||||
SessionKey = agent.SessionKey,
|
|
||||||
Channel = agent.Channel,
|
|
||||||
LastActivity = agent.LastActivity,
|
|
||||||
CreatedAt = agent.CreatedAt,
|
|
||||||
UpdatedAt = agent.UpdatedAt,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
@@ -1,27 +0,0 @@
|
|||||||
using ControlCenter.Api.Models;
|
|
||||||
|
|
||||||
namespace ControlCenter.Api.Repositories;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Repository interface for accessing and mutating Agent State.
|
|
||||||
/// Provides a clean abstraction over the EF Core data access layer.
|
|
||||||
/// </summary>
|
|
||||||
public interface IAgentStateRepository
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Retrieve all agent states.
|
|
||||||
/// </summary>
|
|
||||||
Task<IReadOnlyList<AgentState>> GetAllAsync(CancellationToken ct = default);
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Retrieve a single agent state by its session key.
|
|
||||||
/// Returns null if no agent is found with the given session key.
|
|
||||||
/// </summary>
|
|
||||||
Task<AgentState?> GetBySessionKeyAsync(string sessionKey, CancellationToken ct = default);
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Update the status of an agent by its primary key.
|
|
||||||
/// Returns true if the agent was found and updated, false otherwise.
|
|
||||||
/// </summary>
|
|
||||||
Task<bool> UpdateStatusAsync(Guid id, string status, CancellationToken ct = default);
|
|
||||||
}
|
|
||||||
@@ -5,8 +5,5 @@
|
|||||||
"Microsoft.AspNetCore": "Warning"
|
"Microsoft.AspNetCore": "Warning"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"AllowedHosts": "*",
|
"AllowedHosts": "*"
|
||||||
"ConnectionStrings": {
|
|
||||||
"DefaultConnection": "Host=localhost;Database=control_center;Username=postgres;Password=postgres"
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
@@ -1,8 +0,0 @@
|
|||||||
<span class="badge"
|
|
||||||
[class]="statusClass"
|
|
||||||
[class.badge--pulse]="hasPulse"
|
|
||||||
[attr.aria-label]="'Agent status: ' + displayLabel"
|
|
||||||
role="status">
|
|
||||||
<span class="badge__dot"></span>
|
|
||||||
<span class="badge__label">{{ displayLabel }}</span>
|
|
||||||
</span>
|
|
||||||
@@ -1,146 +0,0 @@
|
|||||||
// ============================================================================
|
|
||||||
// Agent Status Badge — per spec Section 7.3
|
|
||||||
// Colored pill with dot indicator and optional pulse animation.
|
|
||||||
// ============================================================================
|
|
||||||
|
|
||||||
$badge-height: 24px;
|
|
||||||
$dot-size: 8px;
|
|
||||||
$border-radius: 12px;
|
|
||||||
$font-size: 12px;
|
|
||||||
$font-weight: 500;
|
|
||||||
$padding-x: 8px;
|
|
||||||
$gap: 6px;
|
|
||||||
|
|
||||||
@use 'sass:color';
|
|
||||||
|
|
||||||
// Status color palette
|
|
||||||
$color-active: #22c55e; // green-500
|
|
||||||
$color-idle: #9ca3af; // gray-400
|
|
||||||
$color-thinking: #3b82f6; // blue-500
|
|
||||||
$color-error: #ef4444; // red-500
|
|
||||||
$color-offline: #9ca3af; // gray-400
|
|
||||||
|
|
||||||
// Background tints (12% opacity for soft pill background)
|
|
||||||
$bg-active: rgba($color-active, 0.12);
|
|
||||||
$bg-idle: rgba($color-idle, 0.12);
|
|
||||||
$bg-thinking: rgba($color-thinking, 0.12);
|
|
||||||
$bg-error: rgba($color-error, 0.12);
|
|
||||||
$bg-offline: rgba($color-offline, 0.12);
|
|
||||||
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
// Base pill
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
.badge {
|
|
||||||
display: inline-flex;
|
|
||||||
align-items: center;
|
|
||||||
height: $badge-height;
|
|
||||||
padding: 0 $padding-x;
|
|
||||||
border-radius: $border-radius;
|
|
||||||
gap: $gap;
|
|
||||||
font-size: $font-size;
|
|
||||||
font-weight: $font-weight;
|
|
||||||
line-height: 1;
|
|
||||||
white-space: nowrap;
|
|
||||||
user-select: none;
|
|
||||||
}
|
|
||||||
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
// Dot indicator
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
.badge__dot {
|
|
||||||
width: $dot-size;
|
|
||||||
height: $dot-size;
|
|
||||||
border-radius: 50%;
|
|
||||||
flex-shrink: 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
// Label text
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
.badge__label {
|
|
||||||
line-height: 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
// Status color variants
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
.badge--active {
|
|
||||||
background: $bg-active;
|
|
||||||
color: color.adjust($color-active, $lightness: -10%);
|
|
||||||
|
|
||||||
.badge__dot {
|
|
||||||
background: $color-active;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
.badge--idle {
|
|
||||||
background: $bg-idle;
|
|
||||||
color: color.adjust($color-idle, $lightness: -15%);
|
|
||||||
|
|
||||||
.badge__dot {
|
|
||||||
background: $color-idle;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
.badge--thinking {
|
|
||||||
background: $bg-thinking;
|
|
||||||
color: color.adjust($color-thinking, $lightness: -10%);
|
|
||||||
|
|
||||||
.badge__dot {
|
|
||||||
background: $color-thinking;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
.badge--error {
|
|
||||||
background: $bg-error;
|
|
||||||
color: color.adjust($color-error, $lightness: -10%);
|
|
||||||
|
|
||||||
.badge__dot {
|
|
||||||
background: $color-error;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
.badge--offline {
|
|
||||||
background: $bg-offline;
|
|
||||||
color: color.adjust($color-offline, $lightness: -15%);
|
|
||||||
|
|
||||||
.badge__dot {
|
|
||||||
background: $color-offline;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
// Pulse animation — applied when status is active, thinking, or error
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
.badge--pulse {
|
|
||||||
.badge__dot {
|
|
||||||
animation: pulse-dot 2s ease-in-out infinite;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Active: 2s pulse
|
|
||||||
.badge--active.badge--pulse .badge__dot {
|
|
||||||
animation-duration: 2s;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Thinking: 3s pulse
|
|
||||||
.badge--thinking.badge--pulse .badge__dot {
|
|
||||||
animation-duration: 3s;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Error: 0.8s pulse (fast, urgent)
|
|
||||||
.badge--error.badge--pulse .badge__dot {
|
|
||||||
animation-duration: 0.8s;
|
|
||||||
}
|
|
||||||
|
|
||||||
@keyframes pulse-dot {
|
|
||||||
0%,
|
|
||||||
100% {
|
|
||||||
opacity: 1;
|
|
||||||
transform: scale(1);
|
|
||||||
}
|
|
||||||
50% {
|
|
||||||
opacity: 0.4;
|
|
||||||
transform: scale(1.5);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,54 +0,0 @@
|
|||||||
import { ChangeDetectionStrategy, Component, input } from '@angular/core';
|
|
||||||
import { AgentStatus } from '../../models/agent.model';
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Agent Status Badge component.
|
|
||||||
* Displays a colored pill with a pulse animation indicating the agent's current status.
|
|
||||||
* Per spec Section 7.3: Agent Card Component Interface — status indicator.
|
|
||||||
*
|
|
||||||
* Color mapping:
|
|
||||||
* - Active → green
|
|
||||||
* - Idle → gray
|
|
||||||
* - Thinking → blue
|
|
||||||
* - Error → red
|
|
||||||
* - Offline → gray (no pulse)
|
|
||||||
*
|
|
||||||
* Pulse animations:
|
|
||||||
* - Active → 2s
|
|
||||||
* - Error → 0.8s
|
|
||||||
* - Thinking → 3s
|
|
||||||
* - Idle / Offline → no pulse
|
|
||||||
*/
|
|
||||||
@Component({
|
|
||||||
selector: 'app-agent-status-badge',
|
|
||||||
standalone: true,
|
|
||||||
imports: [],
|
|
||||||
templateUrl: './agent-status-badge.component.html',
|
|
||||||
styleUrl: './agent-status-badge.component.scss',
|
|
||||||
changeDetection: ChangeDetectionStrategy.OnPush,
|
|
||||||
})
|
|
||||||
export class AgentStatusBadgeComponent {
|
|
||||||
/** Current agent status — binds to the AgentStatus type from the model. */
|
|
||||||
readonly status = input.required<AgentStatus>();
|
|
||||||
|
|
||||||
/** Label text shown inside the badge. Defaults to title-cased status. */
|
|
||||||
readonly label = input<string>();
|
|
||||||
|
|
||||||
get displayLabel(): string {
|
|
||||||
return this.label() ?? this.titleCase(this.status());
|
|
||||||
}
|
|
||||||
|
|
||||||
/** CSS class driven by the current status value. */
|
|
||||||
get statusClass(): string {
|
|
||||||
return `badge--${this.status()}`;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Whether the pulse animation should be active for the current status. */
|
|
||||||
get hasPulse(): boolean {
|
|
||||||
return this.status() === 'active' || this.status() === 'thinking' || this.status() === 'error';
|
|
||||||
}
|
|
||||||
|
|
||||||
private titleCase(value: string): string {
|
|
||||||
return value.charAt(0).toUpperCase() + value.slice(1);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1 +0,0 @@
|
|||||||
export { AgentStatusBadgeComponent } from './agent-status-badge.component';
|
|
||||||
@@ -1 +0,0 @@
|
|||||||
export { AgentStatusBadgeComponent } from './agent-status-badge/agent-status-badge.component';
|
|
||||||
@@ -1,28 +0,0 @@
|
|||||||
// ============================================================================
|
|
||||||
// Hub Page — Responsive AgentCard Grid
|
|
||||||
// Desktop (≥1024px): 2×2 grid
|
|
||||||
// Mobile (<1024px): single-column stack
|
|
||||||
// ============================================================================
|
|
||||||
|
|
||||||
.hub-page {
|
|
||||||
display: grid;
|
|
||||||
grid-template-columns: 1fr;
|
|
||||||
gap: 16px;
|
|
||||||
padding: var(--cc-section-padding, 16px);
|
|
||||||
min-height: 400px;
|
|
||||||
overflow-x: hidden;
|
|
||||||
}
|
|
||||||
|
|
||||||
.hub-page__placeholder {
|
|
||||||
color: var(--cc-on-surface-variant);
|
|
||||||
font-size: 16px;
|
|
||||||
text-align: center;
|
|
||||||
padding: 24px 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Desktop / kiosk breakpoint — 2-column grid
|
|
||||||
@media (min-width: 1024px) {
|
|
||||||
.hub-page {
|
|
||||||
grid-template-columns: repeat(2, 1fr);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -9,7 +9,18 @@ import { ChangeDetectionStrategy, Component } from '@angular/core';
|
|||||||
<p class="hub-page__placeholder">Command Hub — Fleet status grid will render here</p>
|
<p class="hub-page__placeholder">Command Hub — Fleet status grid will render here</p>
|
||||||
</div>
|
</div>
|
||||||
`,
|
`,
|
||||||
styleUrl: './hub-page.component.scss',
|
styles: [`
|
||||||
|
.hub-page {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
min-height: 400px;
|
||||||
|
}
|
||||||
|
.hub-page__placeholder {
|
||||||
|
color: var(--cc-on-surface-variant);
|
||||||
|
font-size: 16px;
|
||||||
|
}
|
||||||
|
`],
|
||||||
changeDetection: ChangeDetectionStrategy.OnPush,
|
changeDetection: ChangeDetectionStrategy.OnPush,
|
||||||
})
|
})
|
||||||
export class HubPageComponent {}
|
export class HubPageComponent {}
|
||||||
@@ -48,17 +48,6 @@ html {
|
|||||||
// These are NOT part of the M3 tonal palette; they are semantic overrides.
|
// These are NOT part of the M3 tonal palette; they are semantic overrides.
|
||||||
// ---------------------------------------------------------------------------
|
// ---------------------------------------------------------------------------
|
||||||
:root {
|
:root {
|
||||||
// --- Tactical Dark Mode color palette (CUB-47) ---
|
|
||||||
--color-surface: #0F172A;
|
|
||||||
--color-surface-light: #1E293B;
|
|
||||||
--color-primary: #38BDF8;
|
|
||||||
--color-secondary: #2DD4BF;
|
|
||||||
--color-accent: #A78BFA;
|
|
||||||
--color-danger: #F87171;
|
|
||||||
--color-text-primary: #FFFFFF;
|
|
||||||
--color-text-secondary: #94A3B8;
|
|
||||||
--color-border: #334155;
|
|
||||||
|
|
||||||
// --- Status colors ---
|
// --- Status colors ---
|
||||||
--status-active: #38BDF8;
|
--status-active: #38BDF8;
|
||||||
--status-idle: #2DD4BF;
|
--status-idle: #2DD4BF;
|
||||||
@@ -101,7 +90,7 @@ html {
|
|||||||
// Global Body Styles
|
// Global Body Styles
|
||||||
// ---------------------------------------------------------------------------
|
// ---------------------------------------------------------------------------
|
||||||
body {
|
body {
|
||||||
background-color: var(--color-surface);
|
background-color: var(--cc-background);
|
||||||
color: var(--cc-on-surface);
|
color: var(--cc-on-surface);
|
||||||
font-family: 'Inter', 'Roboto', sans-serif;
|
font-family: 'Inter', 'Roboto', sans-serif;
|
||||||
margin: 0;
|
margin: 0;
|
||||||
|
|||||||
Reference in New Issue
Block a user