feat: ship agent-first mission control v0.2.57

backend/Controllers/DocsController.cs

@@ -1,23 +1,65 @@
+using Microsoft.AspNetCore.Authorization;
 using Microsoft.AspNetCore.Mvc;
+using Nexus.Api.Models;
 using Nexus.Api.Services;
 
 namespace Nexus.Api.Controllers;
 
+[Authorize(Roles = "owner")]
+[ProducesResponseType(
+    typeof(OpenClawAgentConfigurationErrorDto),
+    StatusCodes.Status403Forbidden)]
+[ProducesResponseType(
+    typeof(OpenClawAgentConfigurationErrorDto),
+    StatusCodes.Status409Conflict)]
+[ProducesResponseType(
+    typeof(OpenClawAgentConfigurationErrorDto),
+    StatusCodes.Status502BadGateway)]
+[ProducesResponseType(
+    typeof(OpenClawAgentConfigurationErrorDto),
+    StatusCodes.Status503ServiceUnavailable)]
+[ProducesResponseType(
+    typeof(OpenClawAgentConfigurationErrorDto),
+    StatusCodes.Status504GatewayTimeout)]
 [ApiController]
 [Route("api/v1/docs")]
 public class DocsController(IDocService docService) : ControllerBase
 {
     [HttpGet]
-    public IResult GetAll()
-        => Results.Ok(docService.GetAll());
+    [ProducesResponseType(typeof(IReadOnlyList<DocFileInfo>), StatusCodes.Status200OK)]
+    public Task<IResult> GetAll(
+        [FromQuery] string agentId = "iris",
+        CancellationToken cancellationToken = default)
+        => OpenClawContentReadEndpoint.ExecuteAsync(async () =>
+            Results.Ok(await docService.GetAllAsync(
+                agentId,
+                cancellationToken)));
 
     [HttpGet("{**path}")]
-    public async Task<IResult> GetFile(string path)
+    [ProducesResponseType(typeof(DocFileContent), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(ValidationProblemDetails), StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
+    public Task<IResult> GetFile(
+        string path,
+        [FromQuery] string agentId = "iris",
+        CancellationToken cancellationToken = default)
     {
         if (string.IsNullOrWhiteSpace(path))
-            return Results.BadRequest("Path required.");
+        {
+            return Task.FromResult<IResult>(
+                Results.ValidationProblem(new Dictionary<string, string[]>
+            {
+                ["path"] = ["Path is required."]
+            }));
+        }
 
-        var file = await docService.GetFileAsync(path);
-        return file is null ? Results.NotFound() : Results.Ok(file);
+        return OpenClawContentReadEndpoint.ExecuteAsync(async () =>
+        {
+            var file = await docService.GetFileAsync(
+                path,
+                agentId,
+                cancellationToken);
+            return file is null ? Results.NotFound() : Results.Ok(file);
+        });
     }
 }