@ue-shed/protocol 0.8.0 → 0.9.1

package/contracts/cameras/map-tile/v1/capture-operation.schema.json

@@ -317,6 +317,22 @@
 															"additionalProperties": false
 														}
 													},
+													"editorPreviews": {
+														"type": "object",
+														"properties": {
+															"revealedChildActors": {
+																"type": "integer",
+																"allOf": [
+																	{
+																		"minimum": 0,
+																		"maximum": 1000000
+																	}
+																]
+															}
+														},
+														"required": ["revealedChildActors"],
+														"additionalProperties": false
+													},
 													"editorState": {
 														"type": "object",
 														"properties": {
@@ -687,6 +703,9 @@
 																			},
 																			"volumetricFog": {
 																				"type": "boolean"
+																			},
+																			"editorPreviews": {
+																				"type": "boolean"
 																			}
 																		},
 																		"required": [
@@ -731,6 +750,9 @@
 																			},
 																			"volumetricFog": {
 																				"type": "boolean"
+																			},
+																			"editorPreviews": {
+																				"type": "boolean"
 																			}
 																		},
 																		"required": [

package/contracts/cameras/map-tile/v1/capture-response.schema.json

@@ -217,6 +217,22 @@
 											"additionalProperties": false
 										}
 									},
+									"editorPreviews": {
+										"type": "object",
+										"properties": {
+											"revealedChildActors": {
+												"type": "integer",
+												"allOf": [
+													{
+														"minimum": 0,
+														"maximum": 1000000
+													}
+												]
+											}
+										},
+										"required": ["revealedChildActors"],
+										"additionalProperties": false
+									},
 									"editorState": {
 										"type": "object",
 										"properties": {
@@ -558,6 +574,9 @@
 															},
 															"volumetricFog": {
 																"type": "boolean"
+															},
+															"editorPreviews": {
+																"type": "boolean"
 															}
 														},
 														"required": [
@@ -600,6 +619,9 @@
 															},
 															"volumetricFog": {
 																"type": "boolean"
+															},
+															"editorPreviews": {
+																"type": "boolean"
 															}
 														},
 														"required": [

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

@@ -795,6 +795,22 @@
 									"additionalProperties": false
 								}
 							},
+							"editorPreviews": {
+								"type": "object",
+								"properties": {
+									"revealedChildActors": {
+										"type": "integer",
+										"allOf": [
+											{
+												"minimum": 0,
+												"maximum": 1000000
+											}
+										]
+									}
+								},
+								"required": ["revealedChildActors"],
+								"additionalProperties": false
+							},
 							"editorState": {
 								"type": "object",
 								"properties": {
@@ -1120,6 +1136,9 @@
 													},
 													"volumetricFog": {
 														"type": "boolean"
+													},
+													"editorPreviews": {
+														"type": "boolean"
 													}
 												},
 												"required": [
@@ -1162,6 +1181,9 @@
 													},
 													"volumetricFog": {
 														"type": "boolean"
+													},
+													"editorPreviews": {
+														"type": "boolean"
 													}
 												},
 												"required": [

package/contracts/cameras/provisioning/v1/README.md

@@ -7,8 +7,20 @@ never a durable Map Review camera record.
 Each request carries an expected map and an explicit correlation to a framing candidate, a durable
 Review View, or a Map Capture Plan. A camera selects either perspective field of view or
 orthographic width through a discriminated projection. The compatibility decoder accepts the
-candidate-only and `schemaVersion: 2` perspective request shapes for already-installed clients, but
-new clients emit only `schemaVersion: 3`.
+candidate-only and `schemaVersion: 2` perspective request shapes for already-installed clients.
+New clients emit the oldest version that carries the request:
+
+- `schemaVersion: 3`: no options.
+- `schemaVersion: 4`: a camera carries authored `visibility`.
+- `schemaVersion: 5`: the request sets `editorPreviews: true`. Previews then show the child actors
+  that ChildActorComponents spawn for editor-only owners, under the same rule as the camera render
+  contract's `renderer.editorPreviews`. Version 5 also allows `visibility`.
+
+JSON Schema cannot express the version requirements; the Effect decoder and the plugin enforce
+them. A plugin echoes version 4 or 5 in its status when it honoured that request. For version 5 it
+echoes the version in failures too, and reports `editorPreviews.revealedChildActors` while the
+feed shows previews. A response to a version 5 request without the echo comes from a plugin that
+ignored the option.
 
 The editor returns the same correlation for every provisioned camera. Array index remains a live
 frame transport position, never durable identity.

package/contracts/cameras/provisioning/v1/fixtures/provision-request-editor-previews.json

@@ -0,0 +1,16 @@
+{
+	"schemaVersion": 5,
+	"expectedMapPath": "/Game/Fixture/Cameras/L_CameraLoad",
+	"previewFps": 1,
+	"editorPreviews": true,
+	"cameras": [
+		{
+			"correlation": { "type": "review_view", "reviewViewId": "spawn-volume-overview" },
+			"projection": { "type": "perspective", "fieldOfViewDegrees": 60 },
+			"location": { "x": -4000, "y": 0, "z": 600 },
+			"rotation": { "pitch": -10, "yaw": 0, "roll": 0 },
+			"width": 320,
+			"height": 180
+		}
+	]
+}

package/contracts/cameras/provisioning/v1/provision-request.schema.json

@@ -682,9 +682,12 @@
 				}
 			]
 		},
+		"editorPreviews": {
+			"type": "boolean"
+		},
 		"schemaVersion": {
 			"type": "number",
-			"enum": [3, 4]
+			"enum": [3, 4, 5]
 		}
 	},
 	"required": ["cameras", "expectedMapPath", "previewFps", "schemaVersion"],

package/contracts/cameras/render/v1/README.md

@@ -20,6 +20,12 @@ Review's separately versioned `ue-shed-review-render-stages/1.0` uses
 `ResolveReviewViewpoint(RequestJson)` and
 `InspectRenderedReview(SessionId, RequestJson)` on `UEShedCameraReviewLibrary`.
 
+Both renderer policies accept an optional `editorPreviews` boolean (absent means `false`). It
+shows child actors that ChildActorComponents spawn for editor-only owners. Plugins that support it
+advertise the `editorPreviews` capability, and frame evidence then carries
+`editorPreviews.revealedChildActors`. Earlier plugins reject the field as `invalid_policy`. Review
+capture responses and map-tile evidence embed the same renderer policy and frame evidence.
+
 Request JSON rejects unknown fields. Native semantic validation additionally rejects duplicate Data
 Layer identities, unsupported renderer/exposure combinations, effective layer hierarchy conflicts,
 world/project mismatch, contention, region overrides with preserved loading, exceeded resource

package/contracts/cameras/render/v1/begin-result.schema.json

@@ -213,6 +213,9 @@
 										},
 										"volumetricFog": {
 											"type": "boolean"
+										},
+										"editorPreviews": {
+											"type": "boolean"
 										}
 									},
 									"required": [
@@ -255,6 +258,9 @@
 										},
 										"volumetricFog": {
 											"type": "boolean"
+										},
+										"editorPreviews": {
+											"type": "boolean"
 										}
 									},
 									"required": [
@@ -739,6 +745,7 @@
 						"map_mismatch",
 						"project_mismatch",
 						"editor_busy",
+						"authoring_open",
 						"viewport_unavailable",
 						"viewport_locked",
 						"preparation_failed",

package/contracts/cameras/render/v1/capabilities.schema.json

@@ -28,6 +28,27 @@
 			"required": ["version", "maximumActorsPerList", "geometry", "viewport", "sceneCapture"],
 			"additionalProperties": false
 		},
+		"editorPreviews": {
+			"type": "object",
+			"properties": {
+				"version": {
+					"type": "number",
+					"enum": [1]
+				},
+				"subjects": {
+					"type": "string",
+					"enum": ["child_actors_of_editor_only_owners"]
+				},
+				"viewport": {
+					"type": "boolean"
+				},
+				"sceneCapture": {
+					"type": "boolean"
+				}
+			},
+			"required": ["version", "subjects", "viewport", "sceneCapture"],
+			"additionalProperties": false
+		},
 		"contract": {
 			"type": "object",
 			"properties": {

package/contracts/cameras/render/v1/end-result.schema.json

@@ -45,6 +45,7 @@
 						"map_mismatch",
 						"project_mismatch",
 						"editor_busy",
+						"authoring_open",
 						"viewport_unavailable",
 						"viewport_locked",
 						"preparation_failed",

package/contracts/cameras/render/v1/fixtures/invalid-session-editor-previews-type.json

@@ -0,0 +1,41 @@
+{
+	"contract": {
+		"name": "ue-shed-camera-render",
+		"version": {
+			"major": 1,
+			"minor": 0
+		}
+	},
+	"sessionId": "fixture-session",
+	"expectedMapPath": "/Game/Fixture/Cameras/L_CameraLoad",
+	"expectedProjectName": "UEShedFixture",
+	"policy": {
+		"renderer": {
+			"kind": "editor_viewport",
+			"strategy": "high_resolution_screenshot",
+			"profile": "lit",
+			"vignette": "project",
+			"fog": true,
+			"volumetricFog": true,
+			"editorPreviews": "child_actors"
+		},
+		"exposure": {
+			"mode": "fixed_ev100",
+			"ev100": 1,
+			"compensation": "project"
+		},
+		"settling": {
+			"minimumFrames": 4,
+			"timeoutMs": 120000
+		},
+		"time": "live_editor",
+		"preparation": {
+			"geometry": {
+				"mode": "preserve_loading"
+			},
+			"dataLayers": []
+		}
+	},
+	"leaseMs": 120000,
+	"maximumFrames": 8
+}

package/contracts/cameras/render/v1/fixtures/session-editor-previews.json

@@ -0,0 +1,41 @@
+{
+	"contract": {
+		"name": "ue-shed-camera-render",
+		"version": {
+			"major": 1,
+			"minor": 0
+		}
+	},
+	"sessionId": "fixture-session",
+	"expectedMapPath": "/Game/Fixture/Cameras/L_CameraLoad",
+	"expectedProjectName": "UEShedFixture",
+	"policy": {
+		"renderer": {
+			"kind": "editor_viewport",
+			"strategy": "high_resolution_screenshot",
+			"profile": "lit",
+			"vignette": "project",
+			"fog": true,
+			"volumetricFog": true,
+			"editorPreviews": true
+		},
+		"exposure": {
+			"mode": "fixed_ev100",
+			"ev100": 1,
+			"compensation": "project"
+		},
+		"settling": {
+			"minimumFrames": 4,
+			"timeoutMs": 120000
+		},
+		"time": "live_editor",
+		"preparation": {
+			"geometry": {
+				"mode": "preserve_loading"
+			},
+			"dataLayers": []
+		}
+	},
+	"leaseMs": 120000,
+	"maximumFrames": 8
+}

package/contracts/cameras/render/v1/fixtures/session-scene-capture-editor-previews.json

@@ -0,0 +1,40 @@
+{
+	"contract": {
+		"name": "ue-shed-camera-render",
+		"version": {
+			"major": 1,
+			"minor": 0
+		}
+	},
+	"sessionId": "fixture-session",
+	"expectedMapPath": "/Game/Fixture/Cameras/L_CameraLoad",
+	"expectedProjectName": "UEShedFixture",
+	"policy": {
+		"renderer": {
+			"kind": "scene_capture",
+			"profile": "full_fidelity",
+			"lodDistanceScale": 1,
+			"fog": true,
+			"volumetricFog": true,
+			"editorPreviews": true
+		},
+		"exposure": {
+			"mode": "fixed_ev100",
+			"ev100": 1,
+			"compensation": "project"
+		},
+		"settling": {
+			"minimumFrames": 4,
+			"timeoutMs": 120000
+		},
+		"time": "live_editor",
+		"preparation": {
+			"geometry": {
+				"mode": "preserve_loading"
+			},
+			"dataLayers": []
+		}
+	},
+	"leaseMs": 120000,
+	"maximumFrames": 8
+}

package/contracts/cameras/render/v1/frame-evidence.schema.json

@@ -76,6 +76,22 @@
 				"additionalProperties": false
 			}
 		},
+		"editorPreviews": {
+			"type": "object",
+			"properties": {
+				"revealedChildActors": {
+					"type": "integer",
+					"allOf": [
+						{
+							"minimum": 0,
+							"maximum": 1000000
+						}
+					]
+				}
+			},
+			"required": ["revealedChildActors"],
+			"additionalProperties": false
+		},
 		"editorState": {
 			"type": "object",
 			"properties": {
@@ -395,6 +411,9 @@
 								},
 								"volumetricFog": {
 									"type": "boolean"
+								},
+								"editorPreviews": {
+									"type": "boolean"
 								}
 							},
 							"required": [
@@ -437,6 +456,9 @@
 								},
 								"volumetricFog": {
 									"type": "boolean"
+								},
+								"editorPreviews": {
+									"type": "boolean"
 								}
 							},
 							"required": [

package/contracts/cameras/render/v1/frame-status.schema.json

@@ -206,6 +206,22 @@
 								"additionalProperties": false
 							}
 						},
+						"editorPreviews": {
+							"type": "object",
+							"properties": {
+								"revealedChildActors": {
+									"type": "integer",
+									"allOf": [
+										{
+											"minimum": 0,
+											"maximum": 1000000
+										}
+									]
+								}
+							},
+							"required": ["revealedChildActors"],
+							"additionalProperties": false
+						},
 						"editorState": {
 							"type": "object",
 							"properties": {
@@ -525,6 +541,9 @@
 												},
 												"volumetricFog": {
 													"type": "boolean"
+												},
+												"editorPreviews": {
+													"type": "boolean"
 												}
 											},
 											"required": [
@@ -567,6 +586,9 @@
 												},
 												"volumetricFog": {
 													"type": "boolean"
+												},
+												"editorPreviews": {
+													"type": "boolean"
 												}
 											},
 											"required": [
@@ -1185,6 +1207,7 @@
 						"map_mismatch",
 						"project_mismatch",
 						"editor_busy",
+						"authoring_open",
 						"viewport_unavailable",
 						"viewport_locked",
 						"preparation_failed",

package/contracts/cameras/render/v1/policy.schema.json

@@ -188,6 +188,9 @@
 						},
 						"volumetricFog": {
 							"type": "boolean"
+						},
+						"editorPreviews": {
+							"type": "boolean"
 						}
 					},
 					"required": ["kind", "strategy", "profile", "vignette", "fog", "volumetricFog"],
@@ -223,6 +226,9 @@
 						},
 						"volumetricFog": {
 							"type": "boolean"
+						},
+						"editorPreviews": {
+							"type": "boolean"
 						}
 					},
 					"required": ["kind", "profile", "lodDistanceScale", "fog", "volumetricFog"],

package/contracts/cameras/render/v1/review-inspection-result.schema.json

@@ -1208,6 +1208,22 @@
 										"additionalProperties": false
 									}
 								},
+								"editorPreviews": {
+									"type": "object",
+									"properties": {
+										"revealedChildActors": {
+											"type": "integer",
+											"allOf": [
+												{
+													"minimum": 0,
+													"maximum": 1000000
+												}
+											]
+										}
+									},
+									"required": ["revealedChildActors"],
+									"additionalProperties": false
+								},
 								"editorState": {
 									"type": "object",
 									"properties": {
@@ -1541,6 +1557,9 @@
 														},
 														"volumetricFog": {
 															"type": "boolean"
+														},
+														"editorPreviews": {
+															"type": "boolean"
 														}
 													},
 													"required": [
@@ -1583,6 +1602,9 @@
 														},
 														"volumetricFog": {
 															"type": "boolean"
+														},
+														"editorPreviews": {
+															"type": "boolean"
 														}
 													},
 													"required": [

package/contracts/cameras/render/v1/session-request.schema.json

@@ -255,6 +255,9 @@
 								},
 								"volumetricFog": {
 									"type": "boolean"
+								},
+								"editorPreviews": {
+									"type": "boolean"
 								}
 							},
 							"required": [
@@ -297,6 +300,9 @@
 								},
 								"volumetricFog": {
 									"type": "boolean"
+								},
+								"editorPreviews": {
+									"type": "boolean"
 								}
 							},
 							"required": [

package/contracts/cameras/review/v1/capture-response.schema.json

@@ -842,6 +842,22 @@
 								"additionalProperties": false
 							}
 						},
+						"editorPreviews": {
+							"type": "object",
+							"properties": {
+								"revealedChildActors": {
+									"type": "integer",
+									"allOf": [
+										{
+											"minimum": 0,
+											"maximum": 1000000
+										}
+									]
+								}
+							},
+							"required": ["revealedChildActors"],
+							"additionalProperties": false
+						},
 						"editorState": {
 							"type": "object",
 							"properties": {
@@ -1161,6 +1177,9 @@
 												},
 												"volumetricFog": {
 													"type": "boolean"
+												},
+												"editorPreviews": {
+													"type": "boolean"
 												}
 											},
 											"required": [
@@ -1203,6 +1222,9 @@
 												},
 												"volumetricFog": {
 													"type": "boolean"
+												},
+												"editorPreviews": {
+													"type": "boolean"
 												}
 											},
 											"required": [
@@ -1882,6 +1904,22 @@
 								"additionalProperties": false
 							}
 						},
+						"editorPreviews": {
+							"type": "object",
+							"properties": {
+								"revealedChildActors": {
+									"type": "integer",
+									"allOf": [
+										{
+											"minimum": 0,
+											"maximum": 1000000
+										}
+									]
+								}
+							},
+							"required": ["revealedChildActors"],
+							"additionalProperties": false
+						},
 						"editorState": {
 							"type": "object",
 							"properties": {
@@ -2201,6 +2239,9 @@
 												},
 												"volumetricFog": {
 													"type": "boolean"
+												},
+												"editorPreviews": {
+													"type": "boolean"
 												}
 											},
 											"required": [
@@ -2243,6 +2284,9 @@
 												},
 												"volumetricFog": {
 													"type": "boolean"
+												},
+												"editorPreviews": {
+													"type": "boolean"
 												}
 											},
 											"required": [