package p.studio.app.mcp; import com.fasterxml.jackson.databind.ObjectMapper; import com.fasterxml.jackson.databind.node.ObjectNode; import org.junit.jupiter.api.Test; import p.studio.api.automation.*; import java.util.*; import static org.junit.jupiter.api.Assertions.*; class McpContractTest { final ObjectMapper mapper = new ObjectMapper(); final McpToolCatalog catalog = new McpToolCatalog(mapper); @Test void everyToolHasValidExampleAuthorityAndResultEnvelope() { assertEquals(17, catalog.names().size()); for (var name : catalog.names()) { var definition = catalog.definition(name); catalog.validateArguments(name, definition.get("exampleArguments")); var result = McpToolResult.success(mapper, (ObjectNode) definition.get("exampleValue")); ContractSchema.validate(definition.get("outputSchema"), result.wire().get("structuredContent")); var failure = McpToolResult.failure(mapper, new AutomationFailure(AutomationFailure.Code.INVALID_TASK, "Revoked")); ContractSchema.validate(definition.get("outputSchema"), failure.wire().get("structuredContent")); assertTrue(Set.of("authenticated", "granted", "task").contains(definition.get("authority").asText())); assertEquals(definition.get("authority").asText().equals("task"), definition.get("inputSchema").get("properties").has("taskId")); assertFalse(catalog.descriptor(name).has("exampleArguments")); } } @Test void missingRootTaskUnexpectedFieldsAndWrongTypesAreRejected() { for (var name : catalog.names()) { ObjectNode sample = catalog.definition(name).get("exampleArguments").deepCopy(); sample.remove("projectRoot"); assertThrows(IllegalArgumentException.class, () -> catalog.validateArguments(name, sample)); sample.put("projectRoot", "relative/root"); assertThrows(IllegalArgumentException.class, () -> catalog.validateArguments(name, sample)); sample.put("projectRoot", "/project").put("shell", "forbidden"); assertThrows(IllegalArgumentException.class, () -> catalog.validateArguments(name, sample)); sample.remove("shell"); sample.put("projectRoot", 12); assertThrows(IllegalArgumentException.class, () -> catalog.validateArguments(name, sample)); if (sample.has("taskId")) { sample.put("projectRoot", "/project").remove("taskId"); assertThrows(IllegalArgumentException.class, () -> catalog.validateArguments(name, sample)); } } } @Test void lookupIsExclusiveAndFrameInputAndPaginationAreBounded() { ObjectNode lookup = catalog.definition("studio_operation_get").get("exampleArguments").deepCopy(); lookup.put("clientRequestId", "request"); assertThrows(IllegalArgumentException.class, () -> catalog.validateArguments("studio_operation_get", lookup)); lookup.remove(List.of("clientRequestId", "operationId")); assertThrows(IllegalArgumentException.class, () -> catalog.validateArguments("studio_operation_get", lookup)); lookup.put("clientRequestId", "request"); catalog.validateArguments("studio_operation_get", lookup); ObjectNode advance = catalog.definition("studio_headless_advance").get("exampleArguments").deepCopy(); advance.put("frames", -1); assertThrows(IllegalArgumentException.class, () -> catalog.validateArguments("studio_headless_advance", advance)); advance.put("frames", 1.5); assertThrows(IllegalArgumentException.class, () -> catalog.validateArguments("studio_headless_advance", advance)); ObjectNode reference = catalog.definition("studio_reference_read").get("exampleArguments").deepCopy(); reference.put("limit", 0); assertThrows(IllegalArgumentException.class, () -> catalog.validateArguments("studio_reference_read", reference)); ObjectNode input = catalog.definition("studio_headless_set_input").get("exampleArguments").deepCopy(); ((ObjectNode) input.get("input")).put("touchX", Long.MAX_VALUE); assertThrows(IllegalArgumentException.class, () -> catalog.validateArguments("studio_headless_set_input", input)); } @Test void imageBytesAndMetadataArePreservedWithoutFileTransport() throws Exception { byte[] png = Base64.getDecoder().decode("iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+a9l0AAAAASUVORK5CYII="); var capture = new CanonicalCapture("session", "build", 123, 7, 1, 1, 1, png); var wire = McpToolResult.capture(mapper, capture, true).wire(); assertArrayEquals(png, Base64.getDecoder().decode(wire.get("content").get(1).get("data").asText())); assertEquals("image/png", wire.get("content").get(1).get("mimeType").asText()); assertEquals(wire.get("structuredContent").toString(), wire.get("content").get(0).get("text").asText()); var value = wire.get("structuredContent").get("value"); assertEquals(123, value.get("logicalFrameIndex").asLong()); assertEquals(7, value.get("frameId").asLong()); assertTrue(value.get("stale").asBoolean()); assertEquals("RGBA8888", value.get("pixelFormat").asText()); } @Test void unavailableHandlersAreNotAdvertisedOrInvoked() { var registry = new McpToolRegistry(catalog, mapper, Map.of()); assertTrue(registry.descriptors().isEmpty()); assertThrows(IllegalArgumentException.class, () -> registry.call("studio_project_context", catalog.definition("studio_project_context").get("exampleArguments"))); } @Test void neutralLookupProgressAndReferencesDoNotInventUnknownValues() { assertThrows(IllegalArgumentException.class, () -> new OperationLookup(null, null)); assertThrows(IllegalArgumentException.class, () -> new OperationLookup("id", "request")); assertThrows(IllegalArgumentException.class, () -> new TrackedOperation.Progress(4L, 5L)); assertNull(new TrackedOperation.Progress(null, null).completedFrames()); assertFalse(ProjectKnowledge.Version.unknown().known()); assertNull(ProjectKnowledge.Version.unknown().value()); assertEquals(1, new ProjectKnowledge.ReferencePage("unicode", 0, 2, 1, "🎮").nextOffset()); assertThrows(IllegalArgumentException.class, () -> new ProjectKnowledge.ReferencePage("invalid", 0, 1, 1, "ab")); } }