82 lines
6.2 KiB
Java
82 lines
6.2 KiB
Java
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"));
|
|
}
|
|
}
|