@ue-shed/protocol 0.8.0 → 0.9.0

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

@@ -44,6 +44,19 @@ a reply is lost during that host lifetime. Inspect saved data after interruption
 `setup_release` requires the owning host identity; hosts use it on graceful shutdown so reconnecting
 does not have to wait for the old lease. The public host exposes this as `close`.
 
+Reopening a saved set is optional and negotiated by the host. A host that can open sets sends
+`reopen: true` on every `setup_poll`, with `sets` (at most 256 `{ id, name, mapPath, subject,
+cameras }`) to replace its previous list; `reopen: true` without `sets` keeps the list, and a poll
+without `reopen` withdraws both. Only replies to requests carrying `reopen: true` (and the native
+panel's own reads) gain `canOpen`, `sets` filtered to the single selected actor in the current map
+(GUID subjects match the actor GUID and never fall back to a path), `selection.actorGuid`, and a
+pending `open: { id, arrangementId }`; older hosts, which decode replies strictly, keep receiving
+exactly the previous fields. `setup_open` queues one listed arrangement under its own request ID
+and shares the creation queue: one pending request, the same 30-second lease, cancellation on host
+loss or map change, and the same `outcome` acknowledgement. A host is never asked to open unless
+it negotiated reopening, so older hosts are unaffected; older plugins ignore the extra poll fields
+and never send `open`. The public `makeCameraSetupHost({ create, open, sets })` implements this.
+
 Consumers negotiate `cameras.authoring.v1` plus `arrangementPanel` before attaching this panel protocol.
 Capture-only consumers need Core+Cameras, never the menu or bridge. Render capabilities independently
 advertise authored visibility. Generic synchronization and the production recovery matrix remain

package/contracts/cameras/authoring/v1/arrangement.schema.json

@@ -1285,6 +1285,9 @@
 								},
 								"volumetricFog": {
 									"type": "boolean"
+								},
+								"editorPreviews": {
+									"type": "boolean"
 								}
 							},
 							"required": [
@@ -1327,6 +1330,9 @@
 								},
 								"volumetricFog": {
 									"type": "boolean"
+								},
+								"editorPreviews": {
+									"type": "boolean"
 								}
 							},
 							"required": [

package/contracts/cameras/authoring/v1/bridge-request.schema.json

@@ -14,6 +14,9 @@
 						"operation": {
 							"type": "string",
 							"enum": ["setup_status"]
+						},
+						"reopen": {
+							"type": "boolean"
 						}
 					},
 					"required": ["version", "operation"],
@@ -147,6 +150,44 @@
 					"required": ["version", "operation", "intent"],
 					"additionalProperties": false
 				},
+				{
+					"type": "object",
+					"properties": {
+						"version": {
+							"type": "number",
+							"enum": [1]
+						},
+						"operation": {
+							"type": "string",
+							"enum": ["setup_open"]
+						},
+						"intent": {
+							"type": "object",
+							"properties": {
+								"id": {
+									"type": "string",
+									"allOf": [
+										{
+											"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$"
+										}
+									]
+								},
+								"arrangementId": {
+									"type": "string",
+									"allOf": [
+										{
+											"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$"
+										}
+									]
+								}
+							},
+							"required": ["id", "arrangementId"],
+							"additionalProperties": false
+						}
+					},
+					"required": ["version", "operation", "intent"],
+					"additionalProperties": false
+				},
 				{
 					"type": "object",
 					"properties": {
@@ -198,6 +239,162 @@
 							},
 							"required": ["id", "error"],
 							"additionalProperties": false
+						},
+						"reopen": {
+							"type": "boolean"
+						},
+						"sets": {
+							"type": "array",
+							"items": {
+								"type": "object",
+								"properties": {
+									"id": {
+										"type": "string",
+										"allOf": [
+											{
+												"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$"
+											}
+										]
+									},
+									"name": {
+										"type": "string",
+										"allOf": [
+											{
+												"minLength": 1
+											},
+											{
+												"maxLength": 256
+											}
+										]
+									},
+									"mapPath": {
+										"type": "string",
+										"allOf": [
+											{
+												"minLength": 1
+											},
+											{
+												"maxLength": 4096
+											}
+										]
+									},
+									"subject": {
+										"anyOf": [
+											{
+												"type": "object",
+												"properties": {
+													"actorGuid": {
+														"type": "string",
+														"allOf": [
+															{
+																"pattern": "^(?!00000000-00000000-00000000-00000000$)[0-9a-fA-F]{8}(?:-[0-9a-fA-F]{8}){3}$"
+															}
+														]
+													},
+													"diagnosticLabel": {
+														"anyOf": [
+															{
+																"type": "string",
+																"allOf": [
+																	{
+																		"minLength": 1
+																	}
+																]
+															},
+															{
+																"type": "null"
+															}
+														]
+													},
+													"kind": {
+														"type": "string",
+														"enum": ["actor_guid"]
+													},
+													"lastKnownActorPath": {
+														"anyOf": [
+															{
+																"type": "string",
+																"allOf": [
+																	{
+																		"minLength": 7
+																	},
+																	{
+																		"maxLength": 4096
+																	},
+																	{
+																		"pattern": "^\\/Game\\/"
+																	}
+																]
+															},
+															{
+																"type": "null"
+															}
+														]
+													}
+												},
+												"required": ["actorGuid", "kind"],
+												"additionalProperties": false
+											},
+											{
+												"type": "object",
+												"properties": {
+													"actorPath": {
+														"type": "string",
+														"allOf": [
+															{
+																"minLength": 7
+															},
+															{
+																"maxLength": 4096
+															},
+															{
+																"pattern": "^\\/Game\\/"
+															}
+														]
+													},
+													"diagnosticLabel": {
+														"anyOf": [
+															{
+																"type": "string",
+																"allOf": [
+																	{
+																		"minLength": 1
+																	}
+																]
+															},
+															{
+																"type": "null"
+															}
+														]
+													},
+													"kind": {
+														"type": "string",
+														"enum": ["actor_path"]
+													}
+												},
+												"required": ["actorPath", "kind"],
+												"additionalProperties": false
+											}
+										]
+									},
+									"cameras": {
+										"type": "integer",
+										"allOf": [
+											{
+												"minimum": 1,
+												"maximum": 256
+											}
+										]
+									}
+								},
+								"required": ["id", "name", "mapPath", "subject", "cameras"],
+								"additionalProperties": false
+							},
+							"allOf": [
+								{
+									"maxItems": 256
+								}
+							]
 						}
 					},
 					"required": ["version", "operation", "hostId", "projectName"],
@@ -517,6 +714,9 @@
 												},
 												"volumetricFog": {
 													"type": "boolean"
+												},
+												"editorPreviews": {
+													"type": "boolean"
 												}
 											},
 											"required": [
@@ -559,6 +759,9 @@
 												},
 												"volumetricFog": {
 													"type": "boolean"
+												},
+												"editorPreviews": {
+													"type": "boolean"
 												}
 											},
 											"required": [
@@ -2381,6 +2584,9 @@
 														},
 														"volumetricFog": {
 															"type": "boolean"
+														},
+														"editorPreviews": {
+															"type": "boolean"
 														}
 													},
 													"required": [
@@ -2423,6 +2629,9 @@
 														},
 														"volumetricFog": {
 															"type": "boolean"
+														},
+														"editorPreviews": {
+															"type": "boolean"
 														}
 													},
 													"required": [
@@ -5801,6 +6010,9 @@
 																		},
 																		"volumetricFog": {
 																			"type": "boolean"
+																		},
+																		"editorPreviews": {
+																			"type": "boolean"
 																		}
 																	},
 																	"required": [
@@ -5845,6 +6057,9 @@
 																		},
 																		"volumetricFog": {
 																			"type": "boolean"
+																		},
+																		"editorPreviews": {
+																			"type": "boolean"
 																		}
 																	},
 																	"required": [

package/contracts/cameras/authoring/v1/bridge-response.schema.json

@@ -109,12 +109,194 @@
 					"required": ["id", "actorPath", "mapPath", "name", "layout"],
 					"additionalProperties": false
 				},
+				"canOpen": {
+					"type": "boolean"
+				},
+				"sets": {
+					"type": "array",
+					"items": {
+						"type": "object",
+						"properties": {
+							"id": {
+								"type": "string",
+								"allOf": [
+									{
+										"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$"
+									}
+								]
+							},
+							"name": {
+								"type": "string",
+								"allOf": [
+									{
+										"minLength": 1
+									},
+									{
+										"maxLength": 256
+									}
+								]
+							},
+							"mapPath": {
+								"type": "string",
+								"allOf": [
+									{
+										"minLength": 1
+									},
+									{
+										"maxLength": 4096
+									}
+								]
+							},
+							"subject": {
+								"anyOf": [
+									{
+										"type": "object",
+										"properties": {
+											"actorGuid": {
+												"type": "string",
+												"allOf": [
+													{
+														"pattern": "^(?!00000000-00000000-00000000-00000000$)[0-9a-fA-F]{8}(?:-[0-9a-fA-F]{8}){3}$"
+													}
+												]
+											},
+											"diagnosticLabel": {
+												"anyOf": [
+													{
+														"type": "string",
+														"allOf": [
+															{
+																"minLength": 1
+															}
+														]
+													},
+													{
+														"type": "null"
+													}
+												]
+											},
+											"kind": {
+												"type": "string",
+												"enum": ["actor_guid"]
+											},
+											"lastKnownActorPath": {
+												"anyOf": [
+													{
+														"type": "string",
+														"allOf": [
+															{
+																"minLength": 7
+															},
+															{
+																"maxLength": 4096
+															},
+															{
+																"pattern": "^\\/Game\\/"
+															}
+														]
+													},
+													{
+														"type": "null"
+													}
+												]
+											}
+										},
+										"required": ["actorGuid", "kind"],
+										"additionalProperties": false
+									},
+									{
+										"type": "object",
+										"properties": {
+											"actorPath": {
+												"type": "string",
+												"allOf": [
+													{
+														"minLength": 7
+													},
+													{
+														"maxLength": 4096
+													},
+													{
+														"pattern": "^\\/Game\\/"
+													}
+												]
+											},
+											"diagnosticLabel": {
+												"anyOf": [
+													{
+														"type": "string",
+														"allOf": [
+															{
+																"minLength": 1
+															}
+														]
+													},
+													{
+														"type": "null"
+													}
+												]
+											},
+											"kind": {
+												"type": "string",
+												"enum": ["actor_path"]
+											}
+										},
+										"required": ["actorPath", "kind"],
+										"additionalProperties": false
+									}
+								]
+							},
+							"cameras": {
+								"type": "integer",
+								"allOf": [
+									{
+										"minimum": 1,
+										"maximum": 256
+									}
+								]
+							}
+						},
+						"required": ["id", "name", "mapPath", "subject", "cameras"],
+						"additionalProperties": false
+					},
+					"allOf": [
+						{
+							"maxItems": 256
+						}
+					]
+				},
+				"open": {
+					"type": "object",
+					"properties": {
+						"id": {
+							"type": "string",
+							"allOf": [
+								{
+									"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$"
+								}
+							]
+						},
+						"arrangementId": {
+							"type": "string",
+							"allOf": [
+								{
+									"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$"
+								}
+							]
+						}
+					},
+					"required": ["id", "arrangementId"],
+					"additionalProperties": false
+				},
 				"selection": {
 					"type": "object",
 					"properties": {
 						"actorPath": {
 							"type": "string"
 						},
+						"actorGuid": {
+							"type": "string"
+						},
 						"displayName": {
 							"type": "string"
 						},
@@ -3179,6 +3361,9 @@
 																				},
 																				"volumetricFog": {
 																					"type": "boolean"
+																				},
+																				"editorPreviews": {
+																					"type": "boolean"
 																				}
 																			},
 																			"required": [
@@ -3223,6 +3408,9 @@
 																				},
 																				"volumetricFog": {
 																					"type": "boolean"
+																				},
+																				"editorPreviews": {
+																					"type": "boolean"
 																				}
 																			},
 																			"required": [
@@ -6611,6 +6799,9 @@
 												},
 												"volumetricFog": {
 													"type": "boolean"
+												},
+												"editorPreviews": {
+													"type": "boolean"
 												}
 											},
 											"required": [
@@ -6653,6 +6844,9 @@
 												},
 												"volumetricFog": {
 													"type": "boolean"
+												},
+												"editorPreviews": {
+													"type": "boolean"
 												}
 											},
 											"required": [
@@ -8475,6 +8669,9 @@
 														},
 														"volumetricFog": {
 															"type": "boolean"
+														},
+														"editorPreviews": {
+															"type": "boolean"
 														}
 													},
 													"required": [
@@ -8517,6 +8714,9 @@
 														},
 														"volumetricFog": {
 															"type": "boolean"
+														},
+														"editorPreviews": {
+															"type": "boolean"
 														}
 													},
 													"required": [

package/contracts/cameras/authoring/v1/command.schema.json

@@ -1416,6 +1416,9 @@
 										},
 										"volumetricFog": {
 											"type": "boolean"
+										},
+										"editorPreviews": {
+											"type": "boolean"
 										}
 									},
 									"required": [
@@ -1458,6 +1461,9 @@
 										},
 										"volumetricFog": {
 											"type": "boolean"
+										},
+										"editorPreviews": {
+											"type": "boolean"
 										}
 									},
 									"required": [

package/contracts/cameras/authoring/v1/document.schema.json

@@ -1300,6 +1300,9 @@
 										},
 										"volumetricFog": {
 											"type": "boolean"
+										},
+										"editorPreviews": {
+											"type": "boolean"
 										}
 									},
 									"required": [
@@ -1342,6 +1345,9 @@
 										},
 										"volumetricFog": {
 											"type": "boolean"
+										},
+										"editorPreviews": {
+											"type": "boolean"
 										}
 									},
 									"required": [
@@ -2029,6 +2035,9 @@
 													},
 													"volumetricFog": {
 														"type": "boolean"
+													},
+													"editorPreviews": {
+														"type": "boolean"
 													}
 												},
 												"required": [
@@ -2071,6 +2080,9 @@
 													},
 													"volumetricFog": {
 														"type": "boolean"
+													},
+													"editorPreviews": {
+														"type": "boolean"
 													}
 												},
 												"required": [

package/contracts/cameras/authoring/v1/panel-event.schema.json

@@ -1732,6 +1732,9 @@
 																},
 																"volumetricFog": {
 																	"type": "boolean"
+																},
+																"editorPreviews": {
+																	"type": "boolean"
 																}
 															},
 															"required": [
@@ -1774,6 +1777,9 @@
 																},
 																"volumetricFog": {
 																	"type": "boolean"
+																},
+																"editorPreviews": {
+																	"type": "boolean"
 																}
 															},
 															"required": [

package/contracts/cameras/authoring/v1/panel-state.schema.json

@@ -199,6 +199,9 @@
 								},
 								"volumetricFog": {
 									"type": "boolean"
+								},
+								"editorPreviews": {
+									"type": "boolean"
 								}
 							},
 							"required": [
@@ -241,6 +244,9 @@
 								},
 								"volumetricFog": {
 									"type": "boolean"
+								},
+								"editorPreviews": {
+									"type": "boolean"
 								}
 							},
 							"required": [
@@ -1988,6 +1994,9 @@
 										},
 										"volumetricFog": {
 											"type": "boolean"
+										},
+										"editorPreviews": {
+											"type": "boolean"
 										}
 									},
 									"required": [
@@ -2030,6 +2039,9 @@
 										},
 										"volumetricFog": {
 											"type": "boolean"
+										},
+										"editorPreviews": {
+											"type": "boolean"
 										}
 									},
 									"required": [