feat: add Godot Agones REST bridge

Game/tests/agones_sdk_smoke.gd

@@ -0,0 +1,33 @@
+extends SceneTree
+
+const ServerControlScript = preload("res://scripts/server_control.gd")
+const AgonesSDKScript = preload("res://scripts/agones_sdk.gd")
+const PORT := 18081
+
+
+func _init() -> void:
+	var fake_sidecar = ServerControlScript.new()
+	root.add_child(fake_sidecar)
+	if fake_sidecar.start(PORT) != OK:
+		printerr("fake sidecar failed to bind")
+		quit(1)
+		return
+	fake_sidecar.set_process_ready(true)
+	var sdk = AgonesSDKScript.new()
+	root.add_child(sdk)
+	if not sdk.configure_for_testing("http://127.0.0.1:%d" % PORT):
+		printerr("SDK test configuration failed")
+		quit(1)
+		return
+	await process_frame
+	var health_status := await sdk.health()
+	var ready_status := await sdk.mark_ready()
+	var annotation_status := await sdk.set_annotation("match", "result")
+	var shutdown_status := await sdk.shutdown()
+	if health_status != 200 or ready_status != 200 or annotation_status < 400 or shutdown_status < 400:
+		printerr("Agones SDK smoke statuses health=%d ready=%d annotation=%d shutdown=%d" % [health_status, ready_status, annotation_status, shutdown_status])
+		quit(1)
+		return
+	print("Agones SDK smoke passed")
+	fake_sidecar.stop()
+	quit(0)

Game/tests/cases/test_agones_sdk.gd

@@ -0,0 +1,19 @@
+extends "res://tests/test_case.gd"
+
+const AgonesSDKScript = preload("res://scripts/agones_sdk.gd")
+
+
+func test_sdk_requires_loopback_sidecar_url() -> void:
+	var sdk = AgonesSDKScript.new()
+	assert_true(not sdk.configure_for_testing("https://agones.example"), "remote sidecar URL is rejected")
+	assert_true(not sdk.is_available(), "rejected sidecar is unavailable")
+	assert_true(sdk.configure_for_testing("http://127.0.0.1:9358"), "loopback sidecar URL is accepted")
+	assert_true(sdk.is_available(), "accepted sidecar is available")
+	sdk.queue_free()
+
+
+func test_annotation_validation_rejects_header_injection_and_oversized_values() -> void:
+	assert_true(AgonesSDKScript.annotation_is_valid("match", "result"), "ordinary annotation is accepted")
+	assert_true(not AgonesSDKScript.annotation_is_valid("bad\nkey", "value"), "annotation key newline is rejected")
+	assert_true(not AgonesSDKScript.annotation_is_valid("key", "bad\rvalue"), "annotation value newline is rejected")
+	assert_true(not AgonesSDKScript.annotation_is_valid("key", "x".repeat(4097)), "oversized annotation is rejected")