@ue-shed/protocol 0.7.1 → 0.9.0

package/contracts/editor-world/v1/state.schema.json

@@ -0,0 +1,92 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$defs": {},
+	"type": "object",
+	"properties": {
+		"contract": {
+			"type": "object",
+			"properties": {
+				"name": {
+					"type": "string",
+					"enum": ["unreal-editor-world-control"]
+				},
+				"version": {
+					"type": "object",
+					"properties": {
+						"major": {
+							"type": "number",
+							"enum": [1]
+						},
+						"minor": {
+							"type": "number",
+							"enum": [0]
+						}
+					},
+					"required": ["major", "minor"],
+					"additionalProperties": false
+				}
+			},
+			"required": ["name", "version"],
+			"additionalProperties": false
+		},
+		"projectName": {
+			"type": "string"
+		},
+		"snapshot": {
+			"type": "object",
+			"properties": {
+				"dirtyWorldPackages": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"allOf": [
+							{
+								"minLength": 1
+							},
+							{
+								"maxLength": 1024
+							},
+							{
+								"pattern": "^\\/[A-Za-z0-9_./-]+$"
+							}
+						]
+					},
+					"allOf": [
+						{
+							"maxItems": 256
+						}
+					]
+				},
+				"mapPath": {
+					"type": "string",
+					"allOf": [
+						{
+							"minLength": 1
+						},
+						{
+							"maxLength": 1024
+						},
+						{
+							"pattern": "^\\/[A-Za-z0-9_./-]+$"
+						}
+					]
+				},
+				"playSessionActive": {
+					"type": "boolean"
+				}
+			},
+			"required": ["dirtyWorldPackages", "playSessionActive"],
+			"additionalProperties": false
+		},
+		"projectRoot": {
+			"type": "string",
+			"allOf": [
+				{
+					"minLength": 1
+				}
+			]
+		}
+	},
+	"required": ["contract", "projectName", "snapshot"],
+	"additionalProperties": false
+}

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`.