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> handlers(TaskTools tools, ObjectMapper mapper, boolean headlessAvailable) { var handlers = new LinkedHashMap>(); 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 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 input(JsonNode input) { var normalized = new LinkedHashMap(); 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(); } }