@ue-shed/protocol 0.1.0 → 0.2.0

package/README.md

@@ -18,7 +18,8 @@ import {
 ```
 
 The root entry point includes the core capability and connection schemas plus the authoring, camera,
-companion, and editor play-session contracts. Internal source modules are not public subpaths.
+companion, editor play-session, and editor world-control contracts. Internal source modules are not
+public subpaths.
 
 The `contracts/` directory in the package contains the language-neutral JSON Schema authorities and
 conformance fixtures. These files are shipped for protocol implementors, but JavaScript consumers

package/contracts/cameras/map-tile/v1/README.md

@@ -0,0 +1,44 @@
+# Map tile capture contract v1
+
+These checked-in JSON Schemas are the language-neutral authority for generic top-down map capture.
+They are a sibling to, and do not change, `ue-shed-review-capture` v1.
+
+`plan.schema.json` describes an external Map Capture Plan. `capture-request.schema.json` and
+`capture-response.schema.json` describe a bounded editor operation named
+`ue-shed-map-tile-capture`. `manifest.schema.json` describes neutral host-published
+`ue-shed-map-tile-pyramid` evidence. All are major 1, minor 0.
+
+Rows progress from world max-X toward min-X. Columns progress from world min-Y toward max-Y. The
+orientation is explicit and versioned. A level halves units-per-pixel and doubles rows and columns;
+capture Z does not define detail. The editor renders `gutterPixels` beyond each edge at the same
+units-per-pixel and crops back to `tilePixelSize` before PNG encoding. Consumers use clamp-to-edge
+sampling inside each published tile.
+
+`captureBackend` is an optional execution hint, not part of the portable plan. Its default
+`scene_capture_tiles` behavior remains the v1 tile operation. The experimental
+`viewport_high_resolution` value requires one complete zoom level of at most 64 tiles; Unreal
+renders that level through the active Level Editor viewport's High Resolution Screenshot path and
+then cuts the resulting image into the requested tiles.
+
+The editor accepts no output path. It stages only below `Saved/UEShed/MapTileStaging`, reports every
+tile outcome and map package dirty state, and restores transient state before returning. The host
+must validate staging containment, hash artifacts, and atomically publish only a manifest whose
+state is `complete` and whose tile inventory is exhaustive. Partial and cancelled attempts remain
+diagnostic evidence and are never discoverable as completed runs.
+
+The `full_fidelity` render profile explicitly restores the active project's renderer features on
+the tiled SceneCapture. `seam_stable` keeps project lighting and post processing while disabling
+tile-local exposure, temporal accumulation, and screen-space lighting traces; it renders at 2x and
+spatially downsamples to the declared tile size. `scene_capture_defaults` is the comparison
+baseline: it leaves Unreal's SceneCapture renderer defaults unchanged while keeping the same tile
+framing, gutter, warm-up, and publication path. These distinctions apply to `scene_capture_tiles`;
+the experimental viewport backend does not use the transient SceneCapture renderer. `observation`
+remains the reduced-effects profile.
+
+The v1 editor capability requires the expected map to already be open. A headless launcher may open
+that map explicitly before connecting. Interactive hosts must refuse a map switch when dirty
+packages could be discarded. Map-session switching/restoration is deliberately outside this Remote
+Control payload rather than giving it hidden editor authority.
+
+Change this contract in authority order: JSON Schema and fixtures, conformant Effect codecs,
+UEShedCameras C++ producer with trusted UE 5.7 evidence, then consumers.

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

@@ -0,0 +1,68 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ue-shed.dev/contracts/cameras/map-tile/v1/capture-request.schema.json",
+	"title": "UE Shed bounded map tile capture request v1.0",
+	"type": "object",
+	"additionalProperties": false,
+	"required": [
+		"capture",
+		"contract",
+		"correlationId",
+		"expectedMapPath",
+		"gutterPixels",
+		"operationId",
+		"planId",
+		"runId",
+		"tilePixelSize",
+		"tiles"
+	],
+	"properties": {
+		"capture": { "$ref": "plan.schema.json#/$defs/capturePolicy" },
+		"captureBackend": {
+			"enum": ["scene_capture_tiles", "viewport_high_resolution"]
+		},
+		"contract": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["name", "version"],
+			"properties": {
+				"name": { "const": "ue-shed-map-tile-capture" },
+				"version": { "$ref": "plan.schema.json#/$defs/version" }
+			}
+		},
+		"correlationId": { "$ref": "plan.schema.json#/$defs/id" },
+		"expectedMapPath": { "type": "string", "pattern": "^/[A-Za-z0-9_./-]+$" },
+		"gutterPixels": { "type": "integer", "minimum": 0, "maximum": 32 },
+		"operationId": { "$ref": "plan.schema.json#/$defs/id" },
+		"planId": { "$ref": "plan.schema.json#/$defs/id" },
+		"runId": { "$ref": "plan.schema.json#/$defs/id" },
+		"tilePixelSize": { "type": "integer", "minimum": 64, "maximum": 4096 },
+		"tiles": {
+			"type": "array",
+			"minItems": 1,
+			"maxItems": 64,
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"required": ["key", "unitsPerPixel", "worldBounds"],
+				"properties": {
+					"key": { "$ref": "#/$defs/tileKey" },
+					"unitsPerPixel": { "type": "number", "exclusiveMinimum": 0 },
+					"worldBounds": { "$ref": "plan.schema.json#/$defs/bounds" }
+				}
+			}
+		}
+	},
+	"$defs": {
+		"tileKey": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["zoom", "row", "column"],
+			"properties": {
+				"zoom": { "type": "integer", "minimum": 0 },
+				"row": { "type": "integer", "minimum": 0 },
+				"column": { "type": "integer", "minimum": 0 }
+			}
+		}
+	}
+}

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

@@ -0,0 +1,115 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ue-shed.dev/contracts/cameras/map-tile/v1/capture-response.schema.json",
+	"title": "UE Shed bounded map tile capture response v1.0",
+	"type": "object",
+	"additionalProperties": false,
+	"required": [
+		"contract",
+		"correlationId",
+		"dirtyState",
+		"durationMs",
+		"operationId",
+		"results",
+		"status",
+		"tileCounts"
+	],
+	"properties": {
+		"actualMapPath": { "type": "string", "pattern": "^/[A-Za-z0-9_./-]+$" },
+		"contract": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["name", "version"],
+			"properties": {
+				"name": { "const": "ue-shed-map-tile-capture" },
+				"version": { "$ref": "plan.schema.json#/$defs/version" }
+			}
+		},
+		"correlationId": { "$ref": "plan.schema.json#/$defs/id" },
+		"dirtyState": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["before", "after"],
+			"properties": { "before": { "type": "boolean" }, "after": { "type": "boolean" } }
+		},
+		"durationMs": { "type": "number", "minimum": 0 },
+		"failure": { "$ref": "#/$defs/failure" },
+		"operationId": { "$ref": "plan.schema.json#/$defs/id" },
+		"results": {
+			"type": "array",
+			"maxItems": 64,
+			"items": {
+				"oneOf": [
+					{
+						"type": "object",
+						"additionalProperties": false,
+						"required": [
+							"bytes",
+							"captureDurationMs",
+							"height",
+							"key",
+							"stagedPath",
+							"status",
+							"width"
+						],
+						"properties": {
+							"bytes": { "type": "integer", "minimum": 1 },
+							"captureDurationMs": { "type": "number", "minimum": 0 },
+							"height": { "type": "integer", "minimum": 1 },
+							"key": { "$ref": "capture-request.schema.json#/$defs/tileKey" },
+							"stagedPath": { "type": "string", "minLength": 1 },
+							"status": { "const": "captured" },
+							"width": { "type": "integer", "minimum": 1 }
+						}
+					},
+					{
+						"type": "object",
+						"additionalProperties": false,
+						"required": ["failure", "key", "status"],
+						"properties": {
+							"failure": { "$ref": "#/$defs/failure" },
+							"key": { "$ref": "capture-request.schema.json#/$defs/tileKey" },
+							"status": { "const": "failed" }
+						}
+					}
+				]
+			}
+		},
+		"status": { "enum": ["completed", "partial", "cancelled", "failed"] },
+		"tileCounts": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["failed", "requested", "succeeded"],
+			"properties": {
+				"failed": { "type": "integer", "minimum": 0 },
+				"requested": { "type": "integer", "minimum": 0 },
+				"succeeded": { "type": "integer", "minimum": 0 }
+			}
+		}
+	},
+	"$defs": {
+		"failure": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["code", "message", "recovery", "retrySafe"],
+			"properties": {
+				"code": {
+					"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", "minLength": 1, "maxLength": 1024 },
+				"recovery": { "type": "string", "minLength": 1, "maxLength": 1024 },
+				"retrySafe": { "type": "boolean" }
+			}
+		}
+	}
+}

package/contracts/cameras/map-tile/v1/fixtures/capture-request-valid.json

@@ -0,0 +1,32 @@
+{
+	"capture": {
+		"dataLayers": { "mode": "unchanged" },
+		"orientation": { "pitch": -90, "roll": 0, "yaw": 0 },
+		"render": {
+			"effects": { "fog": false, "volumetricFog": false },
+			"lodDistanceScaleByZoom": [4, 2, 1],
+			"lodPolicy": "per_level_distance_scale",
+			"profile": "full_fidelity"
+		},
+		"z": 5000
+	},
+	"captureBackend": "scene_capture_tiles",
+	"contract": {
+		"name": "ue-shed-map-tile-capture",
+		"version": { "major": 1, "minor": 0 }
+	},
+	"correlationId": "fixture-correlation",
+	"expectedMapPath": "/Game/Fixture/Cameras/L_CameraLoad",
+	"gutterPixels": 2,
+	"operationId": "fixture-operation",
+	"planId": "fixture-overview",
+	"runId": "fixture-run",
+	"tilePixelSize": 256,
+	"tiles": [
+		{
+			"key": { "zoom": 0, "row": 0, "column": 0 },
+			"unitsPerPixel": 4,
+			"worldBounds": { "minX": 1024, "minY": -1024, "maxX": 2048, "maxY": 0 }
+		}
+	]
+}

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

@@ -0,0 +1,24 @@
+{
+	"actualMapPath": "/Game/Fixture/Cameras/L_CameraLoad",
+	"contract": {
+		"name": "ue-shed-map-tile-capture",
+		"version": { "major": 1, "minor": 0 }
+	},
+	"correlationId": "fixture-correlation",
+	"dirtyState": { "before": false, "after": false },
+	"durationMs": 27.5,
+	"operationId": "fixture-operation",
+	"results": [
+		{
+			"bytes": 1234,
+			"captureDurationMs": 20.25,
+			"height": 256,
+			"key": { "zoom": 0, "row": 0, "column": 0 },
+			"stagedPath": "C:/Project/Saved/UEShed/MapTileStaging/fixture-run/Z00/R000_C000.png",
+			"status": "captured",
+			"width": 256
+		}
+	],
+	"status": "completed",
+	"tileCounts": { "failed": 0, "requested": 1, "succeeded": 1 }
+}

package/contracts/cameras/map-tile/v1/fixtures/manifest-invalid-complete.json

@@ -0,0 +1,41 @@
+{
+	"addressing": {
+		"children": "z+1: (2r,2c),(2r,2c+1),(2r+1,2c),(2r+1,2c+1)",
+		"parent": "z-1: (floor(r/2),floor(c/2))",
+		"path": "Z{zoom:02}/R{row:03}_C{column:03}.png"
+	},
+	"capturePolicy": {
+		"dataLayers": { "mode": "unchanged" },
+		"orientation": { "pitch": -90, "roll": 0, "yaw": 0 },
+		"render": {
+			"effects": { "fog": false, "volumetricFog": false },
+			"lodDistanceScaleByZoom": [4, 2, 1],
+			"lodPolicy": "per_level_distance_scale",
+			"profile": "full_fidelity"
+		},
+		"z": 5000
+	},
+	"completedAt": "2026-08-12T08:00:01.000Z",
+	"contract": { "name": "ue-shed-map-tile-pyramid", "version": { "major": 1, "minor": 0 } },
+	"failures": [],
+	"grid": {
+		"orientation": { "name": "rows_max_x_to_min_x_columns_min_y_to_max_y", "version": 1 },
+		"origin": { "x": 256, "y": 0 },
+		"requestedBounds": { "minX": 0, "minY": 0, "maxX": 256, "maxY": 256 },
+		"snappedBounds": { "minX": 0, "minY": 0, "maxX": 256, "maxY": 256 }
+	},
+	"gutter": {
+		"pixels": 2,
+		"rule": "render_overdraw_then_crop",
+		"textureAddress": "clamp_to_edge"
+	},
+	"levels": [{ "columns": 1, "rows": 1, "tileWorldSize": 256, "unitsPerPixel": 1, "zoom": 0 }],
+	"planId": "fixture-overview",
+	"project": { "id": "ue-shed-fixture", "mapPath": "/Game/Fixture/Cameras/L_CameraLoad" },
+	"provenance": { "producer": "fixture-editor", "tool": "ue-shed", "toolVersion": "0.1.0" },
+	"runId": "fixture-run",
+	"startedAt": "2026-08-12T08:00:00.000Z",
+	"state": "complete",
+	"tilePixelSize": 256,
+	"tiles": []
+}

package/contracts/cameras/map-tile/v1/fixtures/manifest-invalid-grid.json

@@ -0,0 +1,44 @@
+{
+	"addressing": {
+		"children": "z+1: (2r,2c),(2r,2c+1),(2r+1,2c),(2r+1,2c+1)",
+		"parent": "z-1: (floor(r/2),floor(c/2))",
+		"path": "Z{zoom:02}/R{row:03}_C{column:03}.png"
+	},
+	"capturePolicy": {
+		"dataLayers": { "mode": "unchanged" },
+		"orientation": { "pitch": -90, "roll": 0, "yaw": 0 },
+		"render": {
+			"effects": { "fog": false, "volumetricFog": false },
+			"lodDistanceScaleByZoom": [4, 2, 1],
+			"lodPolicy": "per_level_distance_scale",
+			"profile": "full_fidelity"
+		},
+		"z": 5000
+	},
+	"completedAt": "2026-08-12T08:00:01.000Z",
+	"contract": { "name": "ue-shed-map-tile-pyramid", "version": { "major": 1, "minor": 0 } },
+	"failures": [],
+	"grid": {
+		"orientation": { "name": "rows_max_x_to_min_x_columns_min_y_to_max_y", "version": 1 },
+		"origin": { "x": 256, "y": 0 },
+		"requestedBounds": { "minX": 0, "minY": 0, "maxX": 256, "maxY": 256 },
+		"snappedBounds": { "minX": 0, "minY": 0, "maxX": 256, "maxY": 256 }
+	},
+	"gutter": {
+		"pixels": 2,
+		"rule": "render_overdraw_then_crop",
+		"textureAddress": "clamp_to_edge"
+	},
+	"levels": [
+		{ "columns": 1, "rows": 1, "tileWorldSize": 256, "unitsPerPixel": 1, "zoom": 0 },
+		{ "columns": 3, "rows": 2, "tileWorldSize": 128, "unitsPerPixel": 0.5, "zoom": 1 }
+	],
+	"planId": "fixture-overview",
+	"project": { "id": "ue-shed-fixture", "mapPath": "/Game/Fixture/Cameras/L_CameraLoad" },
+	"provenance": { "producer": "fixture-editor", "tool": "ue-shed", "toolVersion": "0.1.0" },
+	"runId": "fixture-run",
+	"startedAt": "2026-08-12T08:00:00.000Z",
+	"state": "complete",
+	"tilePixelSize": 256,
+	"tiles": []
+}

package/contracts/cameras/map-tile/v1/fixtures/manifest-valid.json

@@ -0,0 +1,60 @@
+{
+	"addressing": {
+		"children": "z+1: (2r,2c),(2r,2c+1),(2r+1,2c),(2r+1,2c+1)",
+		"parent": "z-1: (floor(r/2),floor(c/2))",
+		"path": "Z{zoom:02}/R{row:03}_C{column:03}.png"
+	},
+	"capturePolicy": {
+		"dataLayers": { "mode": "unchanged" },
+		"orientation": { "pitch": -90, "roll": 0, "yaw": 0 },
+		"render": {
+			"effects": { "fog": false, "volumetricFog": false },
+			"lodDistanceScaleByZoom": [4, 2, 1],
+			"lodPolicy": "per_level_distance_scale",
+			"profile": "full_fidelity"
+		},
+		"z": 5000
+	},
+	"completedAt": "2026-08-12T08:00:01.000Z",
+	"contract": {
+		"name": "ue-shed-map-tile-pyramid",
+		"version": { "major": 1, "minor": 0 }
+	},
+	"failures": [],
+	"grid": {
+		"orientation": {
+			"name": "rows_max_x_to_min_x_columns_min_y_to_max_y",
+			"version": 1
+		},
+		"origin": { "x": 256, "y": 0 },
+		"requestedBounds": { "minX": 0, "minY": 0, "maxX": 256, "maxY": 256 },
+		"snappedBounds": { "minX": 0, "minY": 0, "maxX": 256, "maxY": 256 }
+	},
+	"gutter": {
+		"pixels": 2,
+		"rule": "render_overdraw_then_crop",
+		"textureAddress": "clamp_to_edge"
+	},
+	"levels": [{ "columns": 1, "rows": 1, "tileWorldSize": 256, "unitsPerPixel": 1, "zoom": 0 }],
+	"planId": "fixture-overview",
+	"project": {
+		"id": "ue-shed-fixture",
+		"mapPath": "/Game/Fixture/Cameras/L_CameraLoad"
+	},
+	"provenance": { "producer": "fixture-editor", "tool": "ue-shed", "toolVersion": "0.1.0" },
+	"runId": "fixture-run",
+	"startedAt": "2026-08-12T08:00:00.000Z",
+	"state": "complete",
+	"tilePixelSize": 256,
+	"tiles": [
+		{
+			"bytes": 1234,
+			"hash": "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
+			"height": 256,
+			"key": { "zoom": 0, "row": 0, "column": 0 },
+			"relativePath": "Z00/R000_C000.png",
+			"width": 256,
+			"worldBounds": { "minX": 0, "minY": 0, "maxX": 256, "maxY": 256 }
+		}
+	]
+}

package/contracts/cameras/map-tile/v1/fixtures/plan-valid.json

@@ -0,0 +1,27 @@
+{
+	"capture": {
+		"dataLayers": { "mode": "unchanged" },
+		"orientation": { "pitch": -90, "roll": 0, "yaw": 0 },
+		"render": {
+			"effects": { "fog": false, "volumetricFog": false },
+			"lodDistanceScaleByZoom": [4, 2, 1],
+			"lodPolicy": "per_level_distance_scale",
+			"profile": "full_fidelity"
+		},
+		"z": 5000
+	},
+	"contract": {
+		"name": "ue-shed-map-capture-plan",
+		"version": { "major": 1, "minor": 0 }
+	},
+	"gutterPixels": 2,
+	"id": "fixture-overview",
+	"levels": { "coarsestUnitsPerPixel": 4, "count": 3 },
+	"output": { "imageFormat": "png", "publication": "local_immutable" },
+	"project": {
+		"id": "ue-shed-fixture",
+		"mapPath": "/Game/Fixture/Cameras/L_CameraLoad"
+	},
+	"requestedBounds": { "minX": -1500, "minY": -600, "maxX": 1100, "maxY": 1500 },
+	"tilePixelSize": 256
+}

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

@@ -0,0 +1,162 @@
+{
+	"$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)" },
+				"parent": { "const": "z-1: (floor(r/2),floor(c/2))" },
+				"path": { "const": "Z{zoom:02}/R{row:03}_C{column:03}.png" }
+			}
+		},
+		"capturePolicy": { "$ref": "plan.schema.json#/$defs/capturePolicy" },
+		"completedAt": { "$ref": "#/$defs/timestamp" },
+		"contract": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["name", "version"],
+			"properties": {
+				"name": { "const": "ue-shed-map-tile-pyramid" },
+				"version": { "$ref": "plan.schema.json#/$defs/version" }
+			}
+		},
+		"failures": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"required": ["failure", "key"],
+				"properties": {
+					"failure": { "$ref": "capture-response.schema.json#/$defs/failure" },
+					"key": { "$ref": "capture-request.schema.json#/$defs/tileKey" }
+				}
+			}
+		},
+		"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" },
+						"version": { "const": 1 }
+					}
+				},
+				"origin": {
+					"type": "object",
+					"additionalProperties": false,
+					"required": ["x", "y"],
+					"properties": { "x": { "type": "number" }, "y": { "type": "number" } }
+				},
+				"requestedBounds": { "$ref": "plan.schema.json#/$defs/bounds" },
+				"snappedBounds": { "$ref": "plan.schema.json#/$defs/bounds" }
+			}
+		},
+		"gutter": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["pixels", "rule", "textureAddress"],
+			"properties": {
+				"pixels": { "type": "integer", "minimum": 0, "maximum": 32 },
+				"rule": { "const": "render_overdraw_then_crop" },
+				"textureAddress": { "const": "clamp_to_edge" }
+			}
+		},
+		"levels": {
+			"type": "array",
+			"minItems": 1,
+			"maxItems": 24,
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"required": ["columns", "rows", "tileWorldSize", "unitsPerPixel", "zoom"],
+				"properties": {
+					"columns": { "type": "integer", "minimum": 1 },
+					"rows": { "type": "integer", "minimum": 1 },
+					"tileWorldSize": { "type": "number", "exclusiveMinimum": 0 },
+					"unitsPerPixel": { "type": "number", "exclusiveMinimum": 0 },
+					"zoom": { "type": "integer", "minimum": 0 }
+				}
+			}
+		},
+		"planId": { "$ref": "plan.schema.json#/$defs/id" },
+		"project": { "$ref": "plan.schema.json#/$defs/project" },
+		"provenance": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["producer", "tool", "toolVersion"],
+			"properties": {
+				"producer": { "type": "string", "minLength": 1, "maxLength": 1024 },
+				"tool": { "const": "ue-shed" },
+				"toolVersion": { "type": "string", "minLength": 1, "maxLength": 1024 }
+			}
+		},
+		"runId": { "$ref": "plan.schema.json#/$defs/id" },
+		"startedAt": { "$ref": "#/$defs/timestamp" },
+		"state": { "enum": ["complete", "partial", "cancelled"] },
+		"tilePixelSize": { "type": "integer", "minimum": 64, "maximum": 4096 },
+		"tiles": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"required": [
+					"bytes",
+					"hash",
+					"height",
+					"key",
+					"relativePath",
+					"width",
+					"worldBounds"
+				],
+				"properties": {
+					"bytes": { "type": "integer", "minimum": 1 },
+					"hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+					"height": { "type": "integer", "minimum": 1 },
+					"key": { "$ref": "capture-request.schema.json#/$defs/tileKey" },
+					"relativePath": {
+						"type": "string",
+						"pattern": "^Z[0-9]{2,}/R[0-9]{3,}_C[0-9]{3,}\\.png$"
+					},
+					"width": { "type": "integer", "minimum": 1 },
+					"worldBounds": { "$ref": "plan.schema.json#/$defs/bounds" }
+				}
+			}
+		}
+	},
+	"$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$"
+		}
+	}
+}