expose task control and deduplicated operations through MCP

This commit is contained in:
2026-09-29 10:26:19 +01:00
parent c1834bad1f
commit 20bbbd26bd
14 changed files with 775 additions and 12 deletions
@@ -0,0 +1,97 @@
package p.studio.app.mcp;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ObjectNode;
import p.studio.api.automation.*;
import java.nio.file.Path;
import java.util.*;
import java.util.function.Function;
/** Wire projection only; task authority, work and deduplication remain in Core. */
public final class McpTaskTools {
private McpTaskTools() {}
public static Map<String, Function<JsonNode, McpToolResult>> handlers(TaskTools tools, ObjectMapper mapper, boolean headlessAvailable) {
var handlers = new LinkedHashMap<String, Function<JsonNode, McpToolResult>>();
handlers.put("studio_control_acquire", args -> control(mapper, tools.acquire(root(args))));
handlers.put("studio_control_release", args -> control(mapper, tools.release(root(args), task(args)).toCompletableFuture().join()));
handlers.put("studio_build_start", args -> receipt(mapper, tools.build(root(args), task(args), args.path("clientRequestId").asText())));
handlers.put("studio_operation_get", args -> operation(mapper, tools.operation(root(args), task(args),
new OperationLookup(args.path("operationId").asText(null), args.path("clientRequestId").asText(null)))));
handlers.put("studio_operation_cancel", args -> McpToolResult.success(mapper, mapper.createObjectNode()
.put("operationId", args.path("operationId").asText())
.put("cancellationRequested", tools.cancel(root(args), task(args), args.path("operationId").asText()))));
if (headlessAvailable) {
handlers.put("studio_headless_advance", args -> {
if (!args.path("frames").canConvertToLong()) throw new IllegalArgumentException("frames exceeds integer range");
return receipt(mapper, tools.advance(root(args), task(args), args.path("clientRequestId").asText(), args.path("frames").longValue()));
});
for (var action : TaskTools.HeadlessAction.values()) {
handlers.put("studio_headless_" + action.name().toLowerCase(Locale.ROOT), args -> {
Map<String, Object> input = action == TaskTools.HeadlessAction.SET_INPUT ? input(args.path("input")) : Map.of();
var result = tools.headless(root(args), task(args), action, args.path("buildId").asText(null), input);
return result.capture() != null ? McpToolResult.capture(mapper, result.capture(), false)
: McpToolResult.success(mapper, mapper.valueToTree(result.values()));
});
}
}
return handlers;
}
private static Map<String, Object> input(JsonNode input) {
var normalized = new LinkedHashMap<String, Object>();
for (var name : List.of("up", "down", "left", "right", "a", "b", "x", "y", "l", "r", "start", "select", "touch"))
normalized.put(name, input.path(name).asBoolean(false));
normalized.put("touchX", input.path("touchX").asInt(0));
normalized.put("touchY", input.path("touchY").asInt(0));
return Map.copyOf(normalized);
}
private static McpToolResult control(ObjectMapper mapper, ControlResult result) {
if (!result.success()) {
var code = switch (result.status()) {
case CLEANUP_FAILED -> AutomationFailure.Code.CLEANUP_FAILED;
case CLOSED -> AutomationFailure.Code.CLOSED;
case INVALID_TASK -> AutomationFailure.Code.INVALID_TASK;
case NOT_GRANTED -> AutomationFailure.Code.NOT_GRANTED;
default -> AutomationFailure.Code.BUSY;
};
return McpToolResult.failure(mapper, new AutomationFailure(code, result.diagnostic()));
}
var value = mapper.createObjectNode().put("state", result.task() == null ? "MANUAL" : "AGENT_WORKING");
if (result.task() != null) value.put("taskId", result.task().value());
return McpToolResult.success(mapper, value);
}
private static ObjectNode identity(ObjectMapper mapper, TrackedOperation operation) {
return mapper.createObjectNode().put("operationId", operation.operation().id().value())
.put("clientRequestId", operation.clientRequestId()).put("state", operation.operation().state().name());
}
private static McpToolResult receipt(ObjectMapper mapper, TrackedOperation operation) { return McpToolResult.success(mapper, identity(mapper, operation)); }
private static McpToolResult operation(ObjectMapper mapper, TrackedOperation operation) {
var value = identity(mapper, operation);
value.put("workerTerminated", operation.workerTerminated());
value.set("progress", mapper.valueToTree(operation.progress()));
value.set("failure", mapper.valueToTree(operation.failure()));
value.putNull("result");
if (operation.buildResult() != null) {
var build = operation.buildResult();
var result = value.putObject("result").put("kind", "build").put("status", build.status().name());
result.put("buildId", operation.buildId());
result.put("manifestPath", build.manifestPath() == null ? null : build.manifestPath().toString());
result.set("emittedArtifacts", mapper.valueToTree(build.emittedArtifacts().stream().map(Path::toString).toList()));
result.set("diagnostics", mapper.valueToTree(build.diagnostics()));
var logs = result.putArray("logs");
build.logs().forEach(log -> logs.addObject().put("source", log.source().name()).put("severity", log.severity().name())
.put("message", log.message()).put("timestamp", log.timestamp().toString()));
}
CanonicalCapture capture = null;
if (operation.runtimeResult() != null) {
var runtime = operation.runtimeResult();
var result = value.putObject("result").put("kind", "runtime").put("status", runtime.kind().name())
.put("requestedFrames", runtime.requestedFrames()).put("completedFrames", runtime.completedFrames());
result.set("diagnostics", mapper.valueToTree(runtime.diagnostics()));
capture = runtime.capture();
}
return McpToolResult.successWithCapture(mapper, value, capture, operation.captureStale());
}
private static Path root(JsonNode args) { return Path.of(args.path("projectRoot").asText()); }
private static String task(JsonNode args) { return args.path("taskId").asText(); }
}