@ue-shed/protocol 0.8.0 → 0.9.0

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/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": [

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/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": [

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": [

package/contracts/uasset-io/v1/README.md

@@ -40,6 +40,22 @@ the immutable inventory and checked postings without hydrating package evidence.
 and corrupt postings fail with the same typed errors as queries. Old workers reject the operation
 before accepting it.
 
+Minor version 1.5 added `level_sequence` in both `protocol` and `protocol-session`. Version 1.6
+advances its result to schema-5 with typed discrete channels. Its request carries `assetPath`.
+Decode diagnostics, projection
+coverage gaps and reference coverage gaps make the terminal outcome partial. Blueprint and
+Level Sequence reads are bounded to 64 MiB before parsing. Older workers reject the new operation
+before acceptance. Native/WASM fixture conformance checks the same sequence record fields.
+
+Minor version 1.7 advances `level_sequence` records to schema 6 and `blueprint` records to schema 2.
+Sequence records add shared section settings, the separately saved camera-cut track, scoped cut IDs,
+possessable/spawnable metadata, and string/object channels. Blueprint records add saved declarations,
+CDO overrides and construction component/template inventory. Missing fields and unsupported native
+bytes remain explicit nullable evidence or coverage gaps. The public readers request minor 1.7 and
+validate these record versions; older result shapes are rejected at the boundary. Optional `native_data`
+retains source-checked actor/component instance records separately from tagged properties in generic
+inspection and Blueprint saved objects. Unknown subclass bytes remain explicit gaps.
+
 Result frames use an explicit result kind. Generic inspection, authoring, scan, compact text,
 compact texture, Blueprint graph, and saved-world values each have a named schema; there is no
 untyped result field.
@@ -57,3 +73,11 @@ The TypeScript and Rust sides both run the complete shared fixture set. TypeScri
 `packages/protocol/src/uasset-io.test.ts`; Rust coverage is `cargo test -p uasset-io protocol`.
 Adding a result variant requires a valid fixture that both tests decode, plus an invalid fixture when
 the boundary rule needs a rejection case.
+
+### Saved translator notes
+
+Generic keyed-text values may include `dev_notes`; new producers emit it even when empty.
+StringTable entries and compact text occurrences also carry `dev_notes`. Consumers default missing
+entry/occurrence notes from older producers to `""`. This additive evidence does not change the
+source-only authoring value contract. The package decoder gates the serialized FString on
+FortniteMain custom version >= 260 and the absence of `FILTER_EDITOR_ONLY`.