@ue-shed/protocol 0.7.0 → 0.8.0

package/contracts/cameras/map-tile/v1/manifest.schema.json

@@ -1,102 +1,482 @@
 {
 	"$schema": "https://json-schema.org/draft/2020-12/schema",
 	"$id": "https://ue-shed.dev/contracts/cameras/map-tile/v1/manifest.schema.json",
-	"title": "UE Shed neutral map tile pyramid manifest v1.0",
-	"description": "Cross-field grid and exhaustive-completion invariants are additionally enforced by conformant producers and decoders.",
 	"type": "object",
-	"additionalProperties": false,
-	"required": [
-		"addressing",
-		"capturePolicy",
-		"completedAt",
-		"contract",
-		"failures",
-		"grid",
-		"gutter",
-		"levels",
-		"planId",
-		"project",
-		"provenance",
-		"runId",
-		"startedAt",
-		"state",
-		"tilePixelSize",
-		"tiles"
-	],
 	"properties": {
 		"addressing": {
 			"type": "object",
-			"additionalProperties": false,
-			"required": ["children", "parent", "path"],
 			"properties": {
 				"children": {
-					"const": "z+1: (2r,2c),(2r,2c+1),(2r+1,2c),(2r+1,2c+1)"
+					"type": "string",
+					"enum": ["z+1: (2r,2c),(2r,2c+1),(2r+1,2c),(2r+1,2c+1)"]
 				},
 				"parent": {
-					"const": "z-1: (floor(r/2),floor(c/2))"
+					"type": "string",
+					"enum": ["z-1: (floor(r/2),floor(c/2))"]
 				},
 				"path": {
-					"const": "Z{zoom:02}/R{row:03}_C{column:03}.png"
+					"type": "string",
+					"enum": ["Z{zoom:02}/R{row:03}_C{column:03}.png"]
 				}
-			}
+			},
+			"required": ["children", "parent", "path"],
+			"additionalProperties": false
 		},
 		"capturePolicy": {
-			"$ref": "plan.schema.json#/$defs/capturePolicy"
+			"type": "object",
+			"properties": {
+				"visibility": {
+					"type": "object",
+					"properties": {
+						"hide": {
+							"type": "array",
+							"items": {
+								"type": "object",
+								"properties": {
+									"locator": {
+										"anyOf": [
+											{
+												"type": "object",
+												"properties": {
+													"kind": {
+														"type": "string",
+														"enum": ["actor_path"]
+													},
+													"actorPath": {
+														"type": "string",
+														"allOf": [
+															{
+																"pattern": "^\\/Game\\/"
+															},
+															{
+																"maxLength": 4096
+															}
+														]
+													}
+												},
+												"required": ["kind", "actorPath"],
+												"additionalProperties": false
+											},
+											{
+												"type": "object",
+												"properties": {
+													"kind": {
+														"type": "string",
+														"enum": ["actor_guid"]
+													},
+													"actorGuid": {
+														"type": "string",
+														"allOf": [
+															{
+																"pattern": "^(?!00000000-00000000-00000000-00000000$)[0-9a-fA-F]{8}(?:-[0-9a-fA-F]{8}){3}$"
+															}
+														]
+													},
+													"lastKnownActorPath": {
+														"type": "string",
+														"allOf": [
+															{
+																"maxLength": 4096
+															}
+														]
+													}
+												},
+												"required": [
+													"kind",
+													"actorGuid",
+													"lastKnownActorPath"
+												],
+												"additionalProperties": false
+											}
+										]
+									},
+									"label": {
+										"type": "string",
+										"allOf": [
+											{
+												"maxLength": 256
+											}
+										]
+									}
+								},
+								"required": ["locator", "label"],
+								"additionalProperties": false
+							},
+							"allOf": [
+								{
+									"maxItems": 256
+								}
+							]
+						},
+						"protect": {
+							"type": "array",
+							"items": {
+								"type": "object",
+								"properties": {
+									"locator": {
+										"anyOf": [
+											{
+												"type": "object",
+												"properties": {
+													"kind": {
+														"type": "string",
+														"enum": ["actor_path"]
+													},
+													"actorPath": {
+														"type": "string",
+														"allOf": [
+															{
+																"pattern": "^\\/Game\\/"
+															},
+															{
+																"maxLength": 4096
+															}
+														]
+													}
+												},
+												"required": ["kind", "actorPath"],
+												"additionalProperties": false
+											},
+											{
+												"type": "object",
+												"properties": {
+													"kind": {
+														"type": "string",
+														"enum": ["actor_guid"]
+													},
+													"actorGuid": {
+														"type": "string",
+														"allOf": [
+															{
+																"pattern": "^(?!00000000-00000000-00000000-00000000$)[0-9a-fA-F]{8}(?:-[0-9a-fA-F]{8}){3}$"
+															}
+														]
+													},
+													"lastKnownActorPath": {
+														"type": "string",
+														"allOf": [
+															{
+																"maxLength": 4096
+															}
+														]
+													}
+												},
+												"required": [
+													"kind",
+													"actorGuid",
+													"lastKnownActorPath"
+												],
+												"additionalProperties": false
+											}
+										]
+									},
+									"label": {
+										"type": "string",
+										"allOf": [
+											{
+												"maxLength": 256
+											}
+										]
+									}
+								},
+								"required": ["locator", "label"],
+								"additionalProperties": false
+							},
+							"allOf": [
+								{
+									"maxItems": 256
+								}
+							]
+						}
+					},
+					"required": ["hide", "protect"],
+					"additionalProperties": false
+				},
+				"dataLayers": {
+					"anyOf": [
+						{
+							"type": "object",
+							"properties": {
+								"mode": {
+									"type": "string",
+									"enum": ["unchanged"]
+								}
+							},
+							"required": ["mode"],
+							"additionalProperties": false
+						},
+						{
+							"type": "object",
+							"properties": {
+								"mode": {
+									"type": "string",
+									"enum": ["explicit"]
+								},
+								"states": {
+									"type": "array",
+									"items": {
+										"type": "object",
+										"properties": {
+											"name": {
+												"type": "string",
+												"allOf": [
+													{
+														"minLength": 1
+													},
+													{
+														"maxLength": 1024
+													}
+												]
+											},
+											"state": {
+												"type": "string",
+												"enum": ["unloaded", "loaded", "activated"]
+											}
+										},
+										"required": ["name", "state"],
+										"additionalProperties": false
+									},
+									"allOf": [
+										{
+											"maxItems": 64
+										}
+									]
+								}
+							},
+							"required": ["mode", "states"],
+							"additionalProperties": false
+						}
+					]
+				},
+				"orientation": {
+					"type": "object",
+					"properties": {
+						"pitch": {
+							"type": "number",
+							"enum": [-90]
+						},
+						"roll": {
+							"type": "number",
+							"enum": [0]
+						},
+						"yaw": {
+							"type": "number",
+							"enum": [0]
+						}
+					},
+					"required": ["pitch", "roll", "yaw"],
+					"additionalProperties": false
+				},
+				"render": {
+					"type": "object",
+					"properties": {
+						"exposureEV100": {
+							"type": "number",
+							"allOf": [
+								{
+									"minimum": -20,
+									"maximum": 30
+								}
+							]
+						},
+						"effects": {
+							"type": "object",
+							"properties": {
+								"fog": {
+									"type": "boolean"
+								},
+								"volumetricFog": {
+									"type": "boolean"
+								}
+							},
+							"required": ["fog", "volumetricFog"],
+							"additionalProperties": false
+						},
+						"lodDistanceScaleByZoom": {
+							"type": "array",
+							"items": {
+								"type": "number",
+								"allOf": [
+									{
+										"minimum": 0.1,
+										"maximum": 100
+									}
+								]
+							},
+							"allOf": [
+								{
+									"minItems": 1
+								},
+								{
+									"maxItems": 24
+								}
+							]
+						},
+						"lodPolicy": {
+							"type": "string",
+							"enum": ["natural", "fixed_lod_zero", "per_level_distance_scale"]
+						},
+						"profile": {
+							"type": "string",
+							"enum": [
+								"full_fidelity",
+								"seam_stable",
+								"scene_capture_defaults",
+								"observation"
+							]
+						}
+					},
+					"required": ["effects", "lodPolicy", "profile"],
+					"additionalProperties": false
+				},
+				"z": {
+					"type": "number"
+				}
+			},
+			"required": ["dataLayers", "orientation", "render", "z"],
+			"additionalProperties": false
 		},
 		"completedAt": {
-			"$ref": "#/$defs/timestamp"
+			"type": "string",
+			"allOf": [
+				{
+					"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"
+				}
+			]
 		},
 		"contract": {
 			"type": "object",
-			"additionalProperties": false,
-			"required": ["name", "version"],
 			"properties": {
 				"name": {
-					"const": "ue-shed-map-tile-pyramid"
+					"type": "string",
+					"enum": ["ue-shed-map-tile-pyramid"]
 				},
 				"version": {
-					"$ref": "plan.schema.json#/$defs/version"
+					"type": "object",
+					"properties": {
+						"major": {
+							"type": "number",
+							"enum": [1]
+						},
+						"minor": {
+							"type": "number",
+							"enum": [0, 1, 2]
+						}
+					},
+					"required": ["major", "minor"],
+					"additionalProperties": false
 				}
-			}
+			},
+			"required": ["name", "version"],
+			"additionalProperties": false
 		},
 		"failures": {
 			"type": "array",
 			"items": {
 				"type": "object",
-				"additionalProperties": false,
-				"required": ["failure", "key"],
 				"properties": {
 					"failure": {
-						"$ref": "capture-response.schema.json#/$defs/failure"
+						"type": "object",
+						"properties": {
+							"code": {
+								"type": "string",
+								"enum": [
+									"cancelled",
+									"capture_failed",
+									"data_layer_policy_unsupported",
+									"dirty_state_changed",
+									"encoding_failed",
+									"invalid_request",
+									"map_mismatch",
+									"streaming_not_ready",
+									"write_failed"
+								]
+							},
+							"message": {
+								"type": "string",
+								"allOf": [
+									{
+										"minLength": 1
+									},
+									{
+										"maxLength": 1024
+									}
+								]
+							},
+							"recovery": {
+								"type": "string",
+								"allOf": [
+									{
+										"minLength": 1
+									},
+									{
+										"maxLength": 1024
+									}
+								]
+							},
+							"retrySafe": {
+								"type": "boolean"
+							}
+						},
+						"required": ["code", "message", "recovery", "retrySafe"],
+						"additionalProperties": false
 					},
 					"key": {
-						"$ref": "capture-request.schema.json#/$defs/tileKey"
+						"type": "object",
+						"properties": {
+							"zoom": {
+								"type": "integer",
+								"allOf": [
+									{
+										"minimum": 0
+									}
+								]
+							},
+							"row": {
+								"type": "integer",
+								"allOf": [
+									{
+										"minimum": 0
+									}
+								]
+							},
+							"column": {
+								"type": "integer",
+								"allOf": [
+									{
+										"minimum": 0
+									}
+								]
+							}
+						},
+						"required": ["zoom", "row", "column"],
+						"additionalProperties": false
 					}
-				}
+				},
+				"required": ["failure", "key"],
+				"additionalProperties": false
 			}
 		},
 		"grid": {
 			"type": "object",
-			"additionalProperties": false,
-			"required": ["orientation", "origin", "requestedBounds", "snappedBounds"],
 			"properties": {
 				"orientation": {
 					"type": "object",
-					"additionalProperties": false,
-					"required": ["name", "version"],
 					"properties": {
 						"name": {
-							"const": "rows_max_x_to_min_x_columns_min_y_to_max_y"
+							"type": "string",
+							"enum": ["rows_max_x_to_min_x_columns_min_y_to_max_y"]
 						},
 						"version": {
-							"const": 1
+							"type": "number",
+							"enum": [1]
 						}
-					}
+					},
+					"required": ["name", "version"],
+					"additionalProperties": false
 				},
 				"origin": {
 					"type": "object",
-					"additionalProperties": false,
-					"required": ["x", "y"],
 					"properties": {
 						"x": {
 							"type": "number"
@@ -104,158 +484,1428 @@
 						"y": {
 							"type": "number"
 						}
-					}
+					},
+					"required": ["x", "y"],
+					"additionalProperties": false
 				},
 				"requestedBounds": {
-					"$ref": "plan.schema.json#/$defs/bounds"
+					"type": "object",
+					"properties": {
+						"minX": {
+							"type": "number"
+						},
+						"minY": {
+							"type": "number"
+						},
+						"maxX": {
+							"type": "number"
+						},
+						"maxY": {
+							"type": "number"
+						}
+					},
+					"required": ["minX", "minY", "maxX", "maxY"],
+					"additionalProperties": false
 				},
 				"snappedBounds": {
-					"$ref": "plan.schema.json#/$defs/bounds"
+					"type": "object",
+					"properties": {
+						"minX": {
+							"type": "number"
+						},
+						"minY": {
+							"type": "number"
+						},
+						"maxX": {
+							"type": "number"
+						},
+						"maxY": {
+							"type": "number"
+						}
+					},
+					"required": ["minX", "minY", "maxX", "maxY"],
+					"additionalProperties": false
 				}
-			}
+			},
+			"required": ["orientation", "origin", "requestedBounds", "snappedBounds"],
+			"additionalProperties": false
 		},
 		"gutter": {
 			"type": "object",
-			"additionalProperties": false,
-			"required": ["pixels", "rule", "textureAddress"],
 			"properties": {
 				"pixels": {
 					"type": "integer",
-					"minimum": 0,
-					"maximum": 32
+					"allOf": [
+						{
+							"minimum": 0,
+							"maximum": 32
+						}
+					]
 				},
 				"rule": {
-					"const": "render_overdraw_then_crop"
+					"type": "string",
+					"enum": ["render_overdraw_then_crop"]
 				},
 				"textureAddress": {
-					"const": "clamp_to_edge"
+					"type": "string",
+					"enum": ["clamp_to_edge"]
 				}
-			}
+			},
+			"required": ["pixels", "rule", "textureAddress"],
+			"additionalProperties": false
 		},
 		"levels": {
 			"type": "array",
-			"minItems": 1,
-			"maxItems": 24,
 			"items": {
 				"type": "object",
-				"additionalProperties": false,
-				"required": ["columns", "rows", "tileWorldSize", "unitsPerPixel", "zoom"],
 				"properties": {
 					"columns": {
 						"type": "integer",
-						"minimum": 1
+						"allOf": [
+							{
+								"exclusiveMinimum": 0
+							}
+						]
 					},
 					"rows": {
 						"type": "integer",
-						"minimum": 1
+						"allOf": [
+							{
+								"exclusiveMinimum": 0
+							}
+						]
 					},
 					"tileWorldSize": {
 						"type": "number",
-						"exclusiveMinimum": 0
+						"allOf": [
+							{
+								"exclusiveMinimum": 0
+							}
+						]
 					},
 					"unitsPerPixel": {
 						"type": "number",
-						"exclusiveMinimum": 0
+						"allOf": [
+							{
+								"exclusiveMinimum": 0
+							}
+						]
 					},
 					"zoom": {
 						"type": "integer",
-						"minimum": 0
+						"allOf": [
+							{
+								"minimum": 0
+							}
+						]
 					}
+				},
+				"required": ["columns", "rows", "tileWorldSize", "unitsPerPixel", "zoom"],
+				"additionalProperties": false
+			},
+			"allOf": [
+				{
+					"minItems": 1
+				},
+				{
+					"maxItems": 24
 				}
-			}
+			]
 		},
 		"planId": {
-			"$ref": "plan.schema.json#/$defs/id"
+			"type": "string",
+			"allOf": [
+				{
+					"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
+				}
+			]
 		},
 		"project": {
-			"$ref": "plan.schema.json#/$defs/project"
+			"type": "object",
+			"properties": {
+				"id": {
+					"type": "string",
+					"allOf": [
+						{
+							"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
+						}
+					]
+				},
+				"mapPath": {
+					"type": "string",
+					"allOf": [
+						{
+							"pattern": "^\\/[A-Za-z0-9_./-]+$"
+						}
+					]
+				}
+			},
+			"required": ["id", "mapPath"],
+			"additionalProperties": false
 		},
 		"provenance": {
 			"type": "object",
-			"additionalProperties": false,
-			"required": ["producer", "tool", "toolVersion"],
 			"properties": {
 				"producer": {
 					"type": "string",
-					"minLength": 1,
-					"maxLength": 1024
+					"allOf": [
+						{
+							"minLength": 1
+						},
+						{
+							"maxLength": 1024
+						}
+					]
 				},
 				"tool": {
-					"const": "ue-shed"
+					"type": "string",
+					"enum": ["ue-shed"]
 				},
 				"toolVersion": {
 					"type": "string",
-					"minLength": 1,
-					"maxLength": 1024
+					"allOf": [
+						{
+							"minLength": 1
+						},
+						{
+							"maxLength": 1024
+						}
+					]
 				}
-			}
+			},
+			"required": ["producer", "tool", "toolVersion"],
+			"additionalProperties": false
 		},
 		"runId": {
-			"$ref": "plan.schema.json#/$defs/id"
+			"type": "string",
+			"allOf": [
+				{
+					"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
+				}
+			]
 		},
 		"startedAt": {
-			"$ref": "#/$defs/timestamp"
+			"type": "string",
+			"allOf": [
+				{
+					"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"
+				}
+			]
 		},
 		"state": {
+			"type": "string",
 			"enum": ["complete", "partial", "cancelled"]
 		},
 		"tilePixelSize": {
 			"type": "integer",
-			"minimum": 64,
-			"maximum": 4096
+			"allOf": [
+				{
+					"minimum": 64,
+					"maximum": 4096
+				}
+			]
 		},
 		"tiles": {
 			"type": "array",
 			"items": {
 				"type": "object",
-				"additionalProperties": false,
-				"required": [
-					"bytes",
-					"hash",
-					"height",
-					"key",
-					"relativePath",
-					"width",
-					"worldBounds"
-				],
 				"properties": {
+					"renderEvidence": {
+						"type": "object",
+						"properties": {
+							"visibilityDiagnostics": {
+								"type": "array",
+								"items": {
+									"type": "object",
+									"properties": {
+										"locator": {
+											"anyOf": [
+												{
+													"type": "object",
+													"properties": {
+														"kind": {
+															"type": "string",
+															"enum": ["actor_path"]
+														},
+														"actorPath": {
+															"type": "string",
+															"allOf": [
+																{
+																	"pattern": "^\\/Game\\/"
+																},
+																{
+																	"maxLength": 4096
+																}
+															]
+														}
+													},
+													"required": ["kind", "actorPath"],
+													"additionalProperties": false
+												},
+												{
+													"type": "object",
+													"properties": {
+														"kind": {
+															"type": "string",
+															"enum": ["actor_guid"]
+														},
+														"actorGuid": {
+															"type": "string",
+															"allOf": [
+																{
+																	"pattern": "^(?!00000000-00000000-00000000-00000000$)[0-9a-fA-F]{8}(?:-[0-9a-fA-F]{8}){3}$"
+																}
+															]
+														},
+														"lastKnownActorPath": {
+															"type": "string",
+															"allOf": [
+																{
+																	"maxLength": 4096
+																}
+															]
+														}
+													},
+													"required": [
+														"kind",
+														"actorGuid",
+														"lastKnownActorPath"
+													],
+													"additionalProperties": false
+												}
+											]
+										},
+										"status": {
+											"type": "string",
+											"enum": [
+												"resolved",
+												"missing_or_unloaded",
+												"ambiguous",
+												"unsupported"
+											]
+										},
+										"actorPath": {
+											"type": "string"
+										},
+										"message": {
+											"type": "string"
+										}
+									},
+									"required": ["locator", "status", "actorPath", "message"],
+									"additionalProperties": false
+								}
+							},
+							"editorState": {
+								"type": "object",
+								"properties": {
+									"mapPackageDirtyBefore": {
+										"type": "boolean"
+									},
+									"mapPackageDirtyAfter": {
+										"type": "boolean"
+									}
+								},
+								"required": ["mapPackageDirtyBefore", "mapPackageDirtyAfter"],
+								"additionalProperties": false
+							},
+							"camera": {
+								"type": "object",
+								"properties": {
+									"location": {
+										"type": "object",
+										"properties": {
+											"x": {
+												"type": "number"
+											},
+											"y": {
+												"type": "number"
+											},
+											"z": {
+												"type": "number"
+											}
+										},
+										"required": ["x", "y", "z"],
+										"additionalProperties": false
+									},
+									"rotation": {
+										"type": "object",
+										"properties": {
+											"pitch": {
+												"type": "number"
+											},
+											"roll": {
+												"type": "number"
+											},
+											"yaw": {
+												"type": "number"
+											}
+										},
+										"required": ["pitch", "roll", "yaw"],
+										"additionalProperties": false
+									},
+									"projection": {
+										"anyOf": [
+											{
+												"type": "object",
+												"properties": {
+													"kind": {
+														"type": "string",
+														"enum": ["perspective"]
+													},
+													"horizontalFieldOfView": {
+														"type": "number",
+														"allOf": [
+															{
+																"minimum": 5,
+																"maximum": 170
+															}
+														]
+													}
+												},
+												"required": ["kind", "horizontalFieldOfView"],
+												"additionalProperties": false
+											},
+											{
+												"type": "object",
+												"properties": {
+													"kind": {
+														"type": "string",
+														"enum": ["orthographic"]
+													},
+													"width": {
+														"type": "number",
+														"allOf": [
+															{
+																"exclusiveMinimum": 0
+															},
+															{
+																"maximum": 1000000000
+															}
+														]
+													}
+												},
+												"required": ["kind", "width"],
+												"additionalProperties": false
+											}
+										]
+									}
+								},
+								"required": ["location", "rotation", "projection"],
+								"additionalProperties": false
+							},
+							"size": {
+								"type": "object",
+								"properties": {
+									"width": {
+										"type": "integer",
+										"allOf": [
+											{
+												"minimum": 16,
+												"maximum": 16384
+											}
+										]
+									},
+									"height": {
+										"type": "integer",
+										"allOf": [
+											{
+												"minimum": 16,
+												"maximum": 16384
+											}
+										]
+									}
+								},
+								"required": ["width", "height"],
+								"additionalProperties": false
+							},
+							"policy": {
+								"type": "object",
+								"properties": {
+									"visibility": {
+										"type": "object",
+										"properties": {
+											"hide": {
+												"type": "array",
+												"items": {
+													"type": "object",
+													"properties": {
+														"locator": {
+															"anyOf": [
+																{
+																	"type": "object",
+																	"properties": {
+																		"kind": {
+																			"type": "string",
+																			"enum": ["actor_path"]
+																		},
+																		"actorPath": {
+																			"type": "string",
+																			"allOf": [
+																				{
+																					"pattern": "^\\/Game\\/"
+																				},
+																				{
+																					"maxLength": 4096
+																				}
+																			]
+																		}
+																	},
+																	"required": [
+																		"kind",
+																		"actorPath"
+																	],
+																	"additionalProperties": false
+																},
+																{
+																	"type": "object",
+																	"properties": {
+																		"kind": {
+																			"type": "string",
+																			"enum": ["actor_guid"]
+																		},
+																		"actorGuid": {
+																			"type": "string",
+																			"allOf": [
+																				{
+																					"pattern": "^(?!00000000-00000000-00000000-00000000$)[0-9a-fA-F]{8}(?:-[0-9a-fA-F]{8}){3}$"
+																				}
+																			]
+																		},
+																		"lastKnownActorPath": {
+																			"type": "string",
+																			"allOf": [
+																				{
+																					"maxLength": 4096
+																				}
+																			]
+																		}
+																	},
+																	"required": [
+																		"kind",
+																		"actorGuid",
+																		"lastKnownActorPath"
+																	],
+																	"additionalProperties": false
+																}
+															]
+														},
+														"label": {
+															"type": "string",
+															"allOf": [
+																{
+																	"maxLength": 256
+																}
+															]
+														}
+													},
+													"required": ["locator", "label"],
+													"additionalProperties": false
+												},
+												"allOf": [
+													{
+														"maxItems": 256
+													}
+												]
+											},
+											"protect": {
+												"type": "array",
+												"items": {
+													"type": "object",
+													"properties": {
+														"locator": {
+															"anyOf": [
+																{
+																	"type": "object",
+																	"properties": {
+																		"kind": {
+																			"type": "string",
+																			"enum": ["actor_path"]
+																		},
+																		"actorPath": {
+																			"type": "string",
+																			"allOf": [
+																				{
+																					"pattern": "^\\/Game\\/"
+																				},
+																				{
+																					"maxLength": 4096
+																				}
+																			]
+																		}
+																	},
+																	"required": [
+																		"kind",
+																		"actorPath"
+																	],
+																	"additionalProperties": false
+																},
+																{
+																	"type": "object",
+																	"properties": {
+																		"kind": {
+																			"type": "string",
+																			"enum": ["actor_guid"]
+																		},
+																		"actorGuid": {
+																			"type": "string",
+																			"allOf": [
+																				{
+																					"pattern": "^(?!00000000-00000000-00000000-00000000$)[0-9a-fA-F]{8}(?:-[0-9a-fA-F]{8}){3}$"
+																				}
+																			]
+																		},
+																		"lastKnownActorPath": {
+																			"type": "string",
+																			"allOf": [
+																				{
+																					"maxLength": 4096
+																				}
+																			]
+																		}
+																	},
+																	"required": [
+																		"kind",
+																		"actorGuid",
+																		"lastKnownActorPath"
+																	],
+																	"additionalProperties": false
+																}
+															]
+														},
+														"label": {
+															"type": "string",
+															"allOf": [
+																{
+																	"maxLength": 256
+																}
+															]
+														}
+													},
+													"required": ["locator", "label"],
+													"additionalProperties": false
+												},
+												"allOf": [
+													{
+														"maxItems": 256
+													}
+												]
+											}
+										},
+										"required": ["hide", "protect"],
+										"additionalProperties": false
+									},
+									"renderer": {
+										"anyOf": [
+											{
+												"type": "object",
+												"properties": {
+													"kind": {
+														"type": "string",
+														"enum": ["editor_viewport"]
+													},
+													"strategy": {
+														"type": "string",
+														"enum": ["high_resolution_screenshot"]
+													},
+													"profile": {
+														"type": "string",
+														"enum": ["lit", "observation"]
+													},
+													"vignette": {
+														"type": "string",
+														"enum": ["project", "disabled"]
+													},
+													"fog": {
+														"type": "boolean"
+													},
+													"volumetricFog": {
+														"type": "boolean"
+													}
+												},
+												"required": [
+													"kind",
+													"strategy",
+													"profile",
+													"vignette",
+													"fog",
+													"volumetricFog"
+												],
+												"additionalProperties": false
+											},
+											{
+												"type": "object",
+												"properties": {
+													"kind": {
+														"type": "string",
+														"enum": ["scene_capture"]
+													},
+													"profile": {
+														"type": "string",
+														"enum": [
+															"full_fidelity",
+															"seam_stable",
+															"scene_capture_defaults",
+															"observation"
+														]
+													},
+													"lodDistanceScale": {
+														"type": "number",
+														"allOf": [
+															{
+																"minimum": 0.1,
+																"maximum": 100
+															}
+														]
+													},
+													"fog": {
+														"type": "boolean"
+													},
+													"volumetricFog": {
+														"type": "boolean"
+													}
+												},
+												"required": [
+													"kind",
+													"profile",
+													"lodDistanceScale",
+													"fog",
+													"volumetricFog"
+												],
+												"additionalProperties": false
+											}
+										]
+									},
+									"exposure": {
+										"anyOf": [
+											{
+												"type": "object",
+												"properties": {
+													"mode": {
+														"type": "string",
+														"enum": ["project_auto"]
+													}
+												},
+												"required": ["mode"],
+												"additionalProperties": false
+											},
+											{
+												"type": "object",
+												"properties": {
+													"mode": {
+														"type": "string",
+														"enum": ["fixed_ev100"]
+													},
+													"ev100": {
+														"type": "number",
+														"allOf": [
+															{
+																"minimum": -20,
+																"maximum": 30
+															}
+														]
+													},
+													"compensation": {
+														"type": "string",
+														"enum": ["project"]
+													}
+												},
+												"required": ["mode", "ev100", "compensation"],
+												"additionalProperties": false
+											},
+											{
+												"type": "object",
+												"properties": {
+													"mode": {
+														"type": "string",
+														"enum": ["meter_once"]
+													},
+													"referenceCamera": {
+														"type": "object",
+														"properties": {
+															"location": {
+																"type": "object",
+																"properties": {
+																	"x": {
+																		"type": "number"
+																	},
+																	"y": {
+																		"type": "number"
+																	},
+																	"z": {
+																		"type": "number"
+																	}
+																},
+																"required": ["x", "y", "z"],
+																"additionalProperties": false
+															},
+															"rotation": {
+																"type": "object",
+																"properties": {
+																	"pitch": {
+																		"type": "number"
+																	},
+																	"roll": {
+																		"type": "number"
+																	},
+																	"yaw": {
+																		"type": "number"
+																	}
+																},
+																"required": [
+																	"pitch",
+																	"roll",
+																	"yaw"
+																],
+																"additionalProperties": false
+															},
+															"projection": {
+																"anyOf": [
+																	{
+																		"type": "object",
+																		"properties": {
+																			"kind": {
+																				"type": "string",
+																				"enum": [
+																					"perspective"
+																				]
+																			},
+																			"horizontalFieldOfView": {
+																				"type": "number",
+																				"allOf": [
+																					{
+																						"minimum": 5,
+																						"maximum": 170
+																					}
+																				]
+																			}
+																		},
+																		"required": [
+																			"kind",
+																			"horizontalFieldOfView"
+																		],
+																		"additionalProperties": false
+																	},
+																	{
+																		"type": "object",
+																		"properties": {
+																			"kind": {
+																				"type": "string",
+																				"enum": [
+																					"orthographic"
+																				]
+																			},
+																			"width": {
+																				"type": "number",
+																				"allOf": [
+																					{
+																						"exclusiveMinimum": 0
+																					},
+																					{
+																						"maximum": 1000000000
+																					}
+																				]
+																			}
+																		},
+																		"required": [
+																			"kind",
+																			"width"
+																		],
+																		"additionalProperties": false
+																	}
+																]
+															}
+														},
+														"required": [
+															"location",
+															"rotation",
+															"projection"
+														],
+														"additionalProperties": false
+													},
+													"referenceSize": {
+														"type": "object",
+														"properties": {
+															"width": {
+																"type": "integer",
+																"allOf": [
+																	{
+																		"minimum": 16,
+																		"maximum": 16384
+																	}
+																]
+															},
+															"height": {
+																"type": "integer",
+																"allOf": [
+																	{
+																		"minimum": 16,
+																		"maximum": 16384
+																	}
+																]
+															}
+														},
+														"required": ["width", "height"],
+														"additionalProperties": false
+													},
+													"minimumFrames": {
+														"type": "integer",
+														"allOf": [
+															{
+																"minimum": 1,
+																"maximum": 4096
+															}
+														]
+													}
+												},
+												"required": [
+													"mode",
+													"referenceCamera",
+													"referenceSize",
+													"minimumFrames"
+												],
+												"additionalProperties": false
+											}
+										]
+									},
+									"settling": {
+										"type": "object",
+										"properties": {
+											"minimumFrames": {
+												"type": "integer",
+												"allOf": [
+													{
+														"minimum": 1,
+														"maximum": 4096
+													}
+												]
+											},
+											"timeoutMs": {
+												"type": "integer",
+												"allOf": [
+													{
+														"minimum": 1000,
+														"maximum": 900000
+													}
+												]
+											},
+											"initialView": {
+												"type": "object",
+												"properties": {
+													"camera": {
+														"type": "object",
+														"properties": {
+															"location": {
+																"type": "object",
+																"properties": {
+																	"x": {
+																		"type": "number"
+																	},
+																	"y": {
+																		"type": "number"
+																	},
+																	"z": {
+																		"type": "number"
+																	}
+																},
+																"required": ["x", "y", "z"],
+																"additionalProperties": false
+															},
+															"rotation": {
+																"type": "object",
+																"properties": {
+																	"pitch": {
+																		"type": "number"
+																	},
+																	"roll": {
+																		"type": "number"
+																	},
+																	"yaw": {
+																		"type": "number"
+																	}
+																},
+																"required": [
+																	"pitch",
+																	"roll",
+																	"yaw"
+																],
+																"additionalProperties": false
+															},
+															"projection": {
+																"anyOf": [
+																	{
+																		"type": "object",
+																		"properties": {
+																			"kind": {
+																				"type": "string",
+																				"enum": [
+																					"perspective"
+																				]
+																			},
+																			"horizontalFieldOfView": {
+																				"type": "number",
+																				"allOf": [
+																					{
+																						"minimum": 5,
+																						"maximum": 170
+																					}
+																				]
+																			}
+																		},
+																		"required": [
+																			"kind",
+																			"horizontalFieldOfView"
+																		],
+																		"additionalProperties": false
+																	},
+																	{
+																		"type": "object",
+																		"properties": {
+																			"kind": {
+																				"type": "string",
+																				"enum": [
+																					"orthographic"
+																				]
+																			},
+																			"width": {
+																				"type": "number",
+																				"allOf": [
+																					{
+																						"exclusiveMinimum": 0
+																					},
+																					{
+																						"maximum": 1000000000
+																					}
+																				]
+																			}
+																		},
+																		"required": [
+																			"kind",
+																			"width"
+																		],
+																		"additionalProperties": false
+																	}
+																]
+															}
+														},
+														"required": [
+															"location",
+															"rotation",
+															"projection"
+														],
+														"additionalProperties": false
+													},
+													"size": {
+														"type": "object",
+														"properties": {
+															"width": {
+																"type": "integer",
+																"allOf": [
+																	{
+																		"minimum": 16,
+																		"maximum": 16384
+																	}
+																]
+															},
+															"height": {
+																"type": "integer",
+																"allOf": [
+																	{
+																		"minimum": 16,
+																		"maximum": 16384
+																	}
+																]
+															}
+														},
+														"required": ["width", "height"],
+														"additionalProperties": false
+													},
+													"minimumFrames": {
+														"type": "integer",
+														"allOf": [
+															{
+																"minimum": 1,
+																"maximum": 4096
+															}
+														]
+													}
+												},
+												"required": ["camera", "size", "minimumFrames"],
+												"additionalProperties": false
+											}
+										},
+										"required": ["minimumFrames", "timeoutMs"],
+										"additionalProperties": false
+									},
+									"time": {
+										"type": "string",
+										"enum": ["live_editor", "freeze_materials_and_ticks"]
+									},
+									"preparation": {
+										"type": "object",
+										"properties": {
+											"geometry": {
+												"anyOf": [
+													{
+														"type": "object",
+														"properties": {
+															"mode": {
+																"type": "string",
+																"enum": ["preserve_loading"]
+															}
+														},
+														"required": ["mode"],
+														"additionalProperties": false
+													},
+													{
+														"type": "object",
+														"properties": {
+															"mode": {
+																"type": "string",
+																"enum": ["camera_regions"]
+															},
+															"maximumRegions": {
+																"type": "integer",
+																"allOf": [
+																	{
+																		"minimum": 1,
+																		"maximum": 64
+																	}
+																]
+															},
+															"extent": {
+																"type": "object",
+																"properties": {
+																	"x": {
+																		"type": "number",
+																		"allOf": [
+																			{
+																				"minimum": 0,
+																				"maximum": 10000000
+																			}
+																		]
+																	},
+																	"y": {
+																		"type": "number",
+																		"allOf": [
+																			{
+																				"minimum": 0,
+																				"maximum": 10000000
+																			}
+																		]
+																	},
+																	"z": {
+																		"type": "number",
+																		"allOf": [
+																			{
+																				"minimum": 0,
+																				"maximum": 10000000
+																			}
+																		]
+																	}
+																},
+																"required": ["x", "y", "z"],
+																"additionalProperties": false
+															}
+														},
+														"required": [
+															"mode",
+															"maximumRegions",
+															"extent"
+														],
+														"additionalProperties": false
+													}
+												]
+											},
+											"dataLayers": {
+												"type": "array",
+												"items": {
+													"type": "object",
+													"properties": {
+														"assetPath": {
+															"type": "string",
+															"allOf": [
+																{
+																	"pattern": "^\\/[A-Za-z0-9_./-]+$"
+																},
+																{
+																	"maxLength": 1024
+																}
+															]
+														},
+														"loaded": {
+															"type": "boolean"
+														},
+														"visible": {
+															"type": "boolean"
+														}
+													},
+													"required": ["assetPath", "loaded", "visible"],
+													"additionalProperties": false
+												},
+												"allOf": [
+													{
+														"maxItems": 64
+													}
+												]
+											}
+										},
+										"required": ["geometry", "dataLayers"],
+										"additionalProperties": false
+									}
+								},
+								"required": [
+									"renderer",
+									"exposure",
+									"settling",
+									"time",
+									"preparation"
+								],
+								"additionalProperties": false
+							},
+							"exposureEV100": {
+								"anyOf": [
+									{
+										"type": "number"
+									},
+									{
+										"type": "null"
+									}
+								]
+							},
+							"preparation": {
+								"type": "object",
+								"properties": {
+									"status": {
+										"type": "string",
+										"enum": ["preserved", "ready", "partial"]
+									},
+									"regionsHeld": {
+										"type": "integer",
+										"allOf": [
+											{
+												"minimum": 0,
+												"maximum": 64
+											}
+										]
+									},
+									"dataLayersApplied": {
+										"type": "integer",
+										"allOf": [
+											{
+												"minimum": 0,
+												"maximum": 64
+											}
+										]
+									},
+									"limitations": {
+										"type": "array",
+										"items": {
+											"type": "string",
+											"allOf": [
+												{
+													"minLength": 1
+												},
+												{
+													"maxLength": 1024
+												}
+											]
+										}
+									}
+								},
+								"required": [
+									"status",
+									"regionsHeld",
+									"dataLayersApplied",
+									"limitations"
+								],
+								"additionalProperties": false
+							},
+							"settling": {
+								"type": "object",
+								"properties": {
+									"renderedFrames": {
+										"type": "integer",
+										"allOf": [
+											{
+												"minimum": 0,
+												"maximum": 1000000
+											}
+										]
+									},
+									"elapsedMs": {
+										"type": "number",
+										"allOf": [
+											{
+												"minimum": 0
+											}
+										]
+									},
+									"convergence": {
+										"type": "string",
+										"enum": ["not_assessed"]
+									}
+								},
+								"required": ["renderedFrames", "elapsedMs", "convergence"],
+								"additionalProperties": false
+							},
+							"engineVersion": {
+								"type": "string",
+								"allOf": [
+									{
+										"minLength": 1
+									},
+									{
+										"maxLength": 1024
+									}
+								]
+							},
+							"pluginVersion": {
+								"type": "string",
+								"allOf": [
+									{
+										"minLength": 1
+									},
+									{
+										"maxLength": 1024
+									}
+								]
+							}
+						},
+						"required": [
+							"editorState",
+							"camera",
+							"size",
+							"policy",
+							"exposureEV100",
+							"preparation",
+							"settling",
+							"engineVersion",
+							"pluginVersion"
+						],
+						"additionalProperties": false
+					},
 					"bytes": {
 						"type": "integer",
-						"minimum": 1
+						"allOf": [
+							{
+								"exclusiveMinimum": 0
+							}
+						]
 					},
 					"hash": {
 						"type": "string",
-						"pattern": "^sha256:[a-f0-9]{64}$"
+						"allOf": [
+							{
+								"pattern": "^sha256:[a-f0-9]{64}$"
+							}
+						]
 					},
 					"height": {
 						"type": "integer",
-						"minimum": 1
+						"allOf": [
+							{
+								"exclusiveMinimum": 0
+							}
+						]
 					},
 					"key": {
-						"$ref": "capture-request.schema.json#/$defs/tileKey"
+						"type": "object",
+						"properties": {
+							"zoom": {
+								"type": "integer",
+								"allOf": [
+									{
+										"minimum": 0
+									}
+								]
+							},
+							"row": {
+								"type": "integer",
+								"allOf": [
+									{
+										"minimum": 0
+									}
+								]
+							},
+							"column": {
+								"type": "integer",
+								"allOf": [
+									{
+										"minimum": 0
+									}
+								]
+							}
+						},
+						"required": ["zoom", "row", "column"],
+						"additionalProperties": false
 					},
 					"relativePath": {
 						"type": "string",
-						"pattern": "^Z[0-9]{2,}/R[0-9]{3,}_C[0-9]{3,}\\.png$"
+						"allOf": [
+							{
+								"pattern": "^Z\\d{2,}\\/R\\d{3,}_C\\d{3,}\\.png$"
+							}
+						]
 					},
 					"width": {
 						"type": "integer",
-						"minimum": 1
+						"allOf": [
+							{
+								"exclusiveMinimum": 0
+							}
+						]
 					},
 					"worldBounds": {
-						"$ref": "plan.schema.json#/$defs/bounds"
-					},
-					"renderEvidence": {
-						"$ref": "../../render/v1/frame-evidence.schema.json"
+						"type": "object",
+						"properties": {
+							"minX": {
+								"type": "number"
+							},
+							"minY": {
+								"type": "number"
+							},
+							"maxX": {
+								"type": "number"
+							},
+							"maxY": {
+								"type": "number"
+							}
+						},
+						"required": ["minX", "minY", "maxX", "maxY"],
+						"additionalProperties": false
 					}
-				}
+				},
+				"required": [
+					"bytes",
+					"hash",
+					"height",
+					"key",
+					"relativePath",
+					"width",
+					"worldBounds"
+				],
+				"additionalProperties": false
 			}
 		}
 	},
-	"$defs": {
-		"timestamp": {
-			"type": "string",
-			"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{3})?Z$"
-		}
-	}
+	"required": [
+		"addressing",
+		"capturePolicy",
+		"completedAt",
+		"contract",
+		"failures",
+		"grid",
+		"gutter",
+		"levels",
+		"planId",
+		"project",
+		"provenance",
+		"runId",
+		"startedAt",
+		"state",
+		"tilePixelSize",
+		"tiles"
+	],
+	"additionalProperties": false,
+	"$defs": {}
 }